.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.

.TH "gnutls_cipher_decrypt2" 3 "3.6.14" "gnutls" "gnutls"

.SH NAME

gnutls_cipher_decrypt2 \- API function

.SH SYNOPSIS

.B #include <gnutls/crypto.h>

.sp

.BI "int gnutls_cipher_decrypt2(gnutls_cipher_hd_t " handle ", const void * " ctext ", size_t " ctext_len ", void * " ptext ", size_t " ptext_len ");"

.SH ARGUMENTS

.IP "gnutls_cipher_hd_t handle" 12

is a \fBgnutls_cipher_hd_t\fP type

.IP "const void * ctext" 12

the data to decrypt

.IP "size_t ctext_len" 12

the length of data to decrypt

.IP "void * ptext" 12

the decrypted data

.IP "size_t ptext_len" 12

the available length for decrypted data

.SH "DESCRIPTION"

This function will decrypt the given data using the algorithm

specified by the context. For block ciphers the  \fIctext_len\fP must be

a multiple of the block size. For the supported ciphers the plaintext

data length will equal the ciphertext size.

Note that in AEAD ciphers, this will not check the tag. You will

need to compare the tag sent with the value returned from \fBgnutls_cipher_tag()\fP.

.SH "RETURNS"

Zero or a negative error code on error.

.SH "SINCE"

2.12.0

.SH "REPORTING BUGS"

Report bugs to <bugs@gnutls.org>.

.br

Home page: https://www.gnutls.org

.SH COPYRIGHT

Copyright \(co 2001- Free Software Foundation, Inc., and others.

.br

Copying and distribution of this file, with or without modification,

are permitted in any medium without royalty provided the copyright

notice and this notice are preserved.

.SH "SEE ALSO"

The full documentation for

.B gnutls

is maintained as a Texinfo manual.

If the /usr/share/doc/gnutls/

directory does not contain the HTML form visit

.B

.IP https://www.gnutls.org/manual/

.PP