|
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
|