---
name: "gnutls_pkcs7_verify"
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_pkcs7_verify"
---

# gnutls\_pkcs7\_verify(3)

API function

## NAME

gnutls\_pkcs7\_verify - API function

## SYNOPSIS

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

**int gnutls\_pkcs7\_verify(gnutls\_pkcs7\_t** *pkcs7***, gnutls\_x509\_trust\_list\_t** *tl***, gnutls\_typed\_vdata\_st \*** *vdata***, unsigned int** *vdata\_size***, unsigned** *idx***, const gnutls\_datum\_t \*** *data***, unsigned** *flags***);**

## ARGUMENTS

- gnutls\_pkcs7\_t pkcs7

  should contain a **gnutls\_pkcs7\_t** type

- gnutls\_x509\_trust\_list\_t tl

  A list of trusted certificates

- gnutls\_typed\_vdata\_st \* vdata

  an array of typed data

- unsigned int vdata\_size

  the number of data elements

- unsigned idx

  the index of the signature info to check

- const gnutls\_datum\_t \* data

  The data to be verified or **NULL**

- unsigned flags

  Zero or an OR list of **gnutls\_certificate\_verify\_flags**

## DESCRIPTION

This function will verify the provided data against the signature present in the SignedData of the PKCS **7** structure. If the data provided are NULL then the data in the encapsulatedContent field will be used instead.

## RETURNS

On success, **GNUTLS\_E\_SUCCESS** (0) is returned, otherwise a negative error value. A verification error results to a **GNUTLS\_E\_PK\_SIG\_VERIFY\_FAILED** and the lack of encapsulated data to verify to a **GNUTLS\_E\_REQUESTED\_DATA\_NOT\_AVAILABLE**.

## SINCE

3\.4.2

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