1gnutls_crypto_register_aead_cipher(3)gnutlsgnutls_crypto_register_aead_cipher(3)
2
3
4

NAME

6       gnutls_crypto_register_aead_cipher - API function
7

SYNOPSIS

9       #include <gnutls/crypto.h>
10
11       int  gnutls_crypto_register_aead_cipher(gnutls_cipher_algorithm_t algo‐
12       rithm,   int   priority,   gnutls_cipher_init_func   init,   gnutls_ci‐
13       pher_setkey_func  setkey, gnutls_cipher_aead_encrypt_func aead_encrypt,
14       gnutls_cipher_aead_decrypt_func aead_decrypt, gnutls_cipher_deinit_func
15       deinit);
16

ARGUMENTS

18       gnutls_cipher_algorithm_t algorithm
19                   is the gnutls AEAD cipher identifier
20
21       int priority
22                   is the priority of the algorithm
23
24       gnutls_cipher_init_func init
25                   A function which initializes the cipher
26
27       gnutls_cipher_setkey_func setkey
28                   A function which sets the key of the cipher
29
30       gnutls_cipher_aead_encrypt_func aead_encrypt
31                   Perform the AEAD encryption
32
33       gnutls_cipher_aead_decrypt_func aead_decrypt
34                   Perform the AEAD decryption
35
36       gnutls_cipher_deinit_func deinit
37                   A function which deinitializes the cipher
38

DESCRIPTION

40       This  function  will  register a cipher algorithm to be used by gnutls.
41       Any algorithm registered will override the included algorithms  and  by
42       convention  kernel  implemented  algorithms  have  priority  of  90 and
43       CPU-assisted of 80.  The algorithm with the  lowest  priority  will  be
44       used by gnutls.
45
46       In   the   case   the   registered  init  or  setkey  functions  return
47       GNUTLS_E_NEED_FALLBACK, GnuTLS will attempt to use the next in priority
48       registered cipher.
49
50       The  functions registered will be used with the new AEAD API introduced
51       in GnuTLS 3.4.0. Internally GnuTLS uses the new AEAD API.
52

DEPRECATED

54       since 3.7.0 it is no longer possible to override cipher implementation
55

RETURNS

57       GNUTLS_E_SUCCESS on success, otherwise a negative error code.
58

SINCE

60       3.4.0
61

REPORTING BUGS

63       Report bugs to <bugs@gnutls.org>.
64       Home page: https://www.gnutls.org
65
66

68       Copyright © 2001- Free Software Foundation, Inc., and others.
69       Copying and distribution of this file, with  or  without  modification,
70       are  permitted in any medium without royalty provided the copyright no‐
71       tice and this notice are preserved.
72

SEE ALSO

74       The full documentation for gnutls is maintained as  a  Texinfo  manual.
75       If  the /usr/share/doc/gnutls/ directory does not contain the HTML form
76       visit
77
78       https://www.gnutls.org/manual/
79
80gnutls                               3.7.6gnutls_crypto_register_aead_cipher(3)
Impressum