Blame doc/manpages/gnutls_crypto_register_cipher.3

Packit 549fdc
.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
Packit 549fdc
.TH "gnutls_crypto_register_cipher" 3 "3.6.2" "gnutls" "gnutls"
Packit 549fdc
.SH NAME
Packit 549fdc
gnutls_crypto_register_cipher \- API function
Packit 549fdc
.SH SYNOPSIS
Packit 549fdc
.B #include <gnutls/crypto.h>
Packit 549fdc
.sp
Packit 549fdc
.BI "int gnutls_crypto_register_cipher(gnutls_cipher_algorithm_t " algorithm ", int " priority ", gnutls_cipher_init_func " init ", gnutls_cipher_setkey_func " setkey ", gnutls_cipher_setiv_func " setiv ", gnutls_cipher_encrypt_func " encrypt ", gnutls_cipher_decrypt_func " decrypt ", gnutls_cipher_deinit_func " deinit ");"
Packit 549fdc
.SH ARGUMENTS
Packit 549fdc
.IP "gnutls_cipher_algorithm_t algorithm" 12
Packit 549fdc
is the gnutls algorithm identifier
Packit 549fdc
.IP "int priority" 12
Packit 549fdc
is the priority of the algorithm
Packit 549fdc
.IP "gnutls_cipher_init_func init" 12
Packit 549fdc
A function which initializes the cipher
Packit 549fdc
.IP "gnutls_cipher_setkey_func setkey" 12
Packit 549fdc
A function which sets the key of the cipher
Packit 549fdc
.IP "gnutls_cipher_setiv_func setiv" 12
Packit 549fdc
A function which sets the nonce/IV of the cipher (non\-AEAD)
Packit 549fdc
.IP "gnutls_cipher_encrypt_func encrypt" 12
Packit 549fdc
A function which performs encryption (non\-AEAD)
Packit 549fdc
.IP "gnutls_cipher_decrypt_func decrypt" 12
Packit 549fdc
A function which performs decryption (non\-AEAD)
Packit 549fdc
.IP "gnutls_cipher_deinit_func deinit" 12
Packit 549fdc
A function which deinitializes the cipher
Packit 549fdc
.SH "DESCRIPTION"
Packit 549fdc
This function will register a cipher algorithm to be used by
Packit 549fdc
gnutls.  Any algorithm registered will override the included
Packit 549fdc
algorithms and by convention kernel implemented algorithms have
Packit 549fdc
priority of 90 and CPU\-assisted of 80.  The algorithm with the lowest priority will be
Packit 549fdc
used by gnutls.
Packit 549fdc
Packit 549fdc
In the case the registered init or setkey functions return \fBGNUTLS_E_NEED_FALLBACK\fP,
Packit 549fdc
GnuTLS will attempt to use the next in priority registered cipher.
Packit 549fdc
Packit 549fdc
The functions which are marked as non\-AEAD they are not required when
Packit 549fdc
registering a cipher to be used with the new AEAD API introduced in
Packit 549fdc
GnuTLS 3.4.0. Internally GnuTLS uses the new AEAD API.
Packit 549fdc
.SH "RETURNS"
Packit 549fdc
\fBGNUTLS_E_SUCCESS\fP on success, otherwise a negative error code.
Packit 549fdc
.SH "SINCE"
Packit 549fdc
3.4.0
Packit 549fdc
.SH "REPORTING BUGS"
Packit 549fdc
Report bugs to <bugs@gnutls.org>.
Packit 549fdc
.br
Packit 549fdc
Home page: http://www.gnutls.org
Packit 549fdc
Packit 549fdc
.SH COPYRIGHT
Packit 549fdc
Copyright \(co 2001-2018 Free Software Foundation, Inc., and others.
Packit 549fdc
.br
Packit 549fdc
Copying and distribution of this file, with or without modification,
Packit 549fdc
are permitted in any medium without royalty provided the copyright
Packit 549fdc
notice and this notice are preserved.
Packit 549fdc
.SH "SEE ALSO"
Packit 549fdc
The full documentation for
Packit 549fdc
.B gnutls
Packit 549fdc
is maintained as a Texinfo manual.
Packit 549fdc
If the /usr/share/doc/gnutls/
Packit 549fdc
directory does not contain the HTML form visit
Packit 549fdc
.B
Packit 549fdc
.IP http://www.gnutls.org/manual/
Packit 549fdc
.PP