---
name: "gnutls_certificate_set_x509_trust_file"
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_certificate_set_x509_trust_file"
---

# gnutls\_certificate\_set\_x509\_trust\_file(3)

API function

## NAME

gnutls\_certificate\_set\_x509\_trust\_file - API function

## SYNOPSIS

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

**int gnutls\_certificate\_set\_x509\_trust\_file(gnutls\_certificate\_credentials\_t** *cred***, const char \*** *cafile***, gnutls\_x509\_crt\_fmt\_t** *type***);**

## ARGUMENTS

- gnutls\_certificate\_credentials\_t cred

  is a **gnutls\_certificate\_credentials\_t** type.

- const char \* cafile

  is a file containing the list of trusted CAs (DER or PEM list)

- gnutls\_x509\_crt\_fmt\_t type

  is PEM or DER

## DESCRIPTION

This function adds the trusted CAs in order to verify client or server certificates. In case of a client this is not required to be called if the certificates are not verified using **gnutls\_certificate\_verify\_peers2()**.  This function may be called multiple times.

In case of a server the names of the CAs set here will be sent to the client if a certificate request is sent. This can be disabled using **gnutls\_certificate\_send\_x509\_rdn\_sequence()**.

This function can also accept URLs. In that case it will import all certificates that are marked as trusted. Note that the supported URLs are the ones indicated by **gnutls\_url\_is\_supported()**.

## RETURNS

the number of certificates processed

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