---
name: "gnutls_cipher_decrypt2"
section: "3"
platform: "linux"
package: "gnutls"
version: "3.8.13-3"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/gnutls_cipher_decrypt2"
---

# gnutls\_cipher\_decrypt2(3)

API function

## NAME

gnutls\_cipher\_decrypt2 - API function

## SYNOPSIS

**#include \<gnutls/crypto.h\>**

**int gnutls\_cipher\_decrypt2(gnutls\_cipher\_hd\_t** *handle***, const void \*** *ctext***, size\_t** *ctext\_len***, void \*** *ptext***, size\_t** *ptext\_len***);**

## ARGUMENTS

- gnutls\_cipher\_hd\_t handle

  is a **gnutls\_cipher\_hd\_t** type

- const void \* ctext

  the data to decrypt

- size\_t ctext\_len

  the length of data to decrypt

- void \* ptext

  the decrypted data

- size\_t ptext\_len

  the available length for decrypted data

## DESCRIPTION

This function will decrypt the given data using the algorithm specified by the context. For block ciphers the  *ctext\_len* 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 **gnutls\_cipher\_tag()**.

## RETURNS

Zero or a negative error code on error.

## SINCE

2\.12.0

## REPORTING BUGS

Report bugs to \<bugs@gnutls.org\>.\
 Home page: https://www.gnutls.org

## COPYRIGHT

Copyright © 2001-2023 Free Software Foundation, Inc., and others.\
 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.

## SEE ALSO

The full documentation for **gnutls** is maintained as a Texinfo manual. If the /usr/share/doc/gnutls/ directory does not contain the HTML form visit

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