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,
13       gnutls_cipher_setkey_func    setkey,    gnutls_cipher_aead_encrypt_func
14       aead_encrypt,       gnutls_cipher_aead_decrypt_func       aead_decrypt,
15       gnutls_cipher_deinit_func 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

RETURNS

54       GNUTLS_E_SUCCESS on success, otherwise a negative error code.
55

SINCE

57       3.4.0
58

REPORTING BUGS

60       Report bugs to <bugs@gnutls.org>.
61       Home page: https://www.gnutls.org
62
63

65       Copyright © 2001-2020 Free Software Foundation, Inc., and others.
66       Copying and distribution of this file, with  or  without  modification,
67       are  permitted  in  any  medium  without royalty provided the copyright
68       notice and this notice are preserved.
69

SEE ALSO

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