---
name: "gnutls_x509_trust_list_add_cas"
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_x509_trust_list_add_cas"
---

# gnutls\_x509\_trust\_list\_add\_cas(3)

API function

## NAME

gnutls\_x509\_trust\_list\_add\_cas - API function

## SYNOPSIS

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

**int gnutls\_x509\_trust\_list\_add\_cas(gnutls\_x509\_trust\_list\_t** *list***, const gnutls\_x509\_crt\_t \*** *clist***, unsigned** *clist\_size***, unsigned int** *flags***);**

## ARGUMENTS

- gnutls\_x509\_trust\_list\_t list

  The list

- const gnutls\_x509\_crt\_t \* clist

  A list of CAs

- unsigned clist\_size

  The length of the CA list

- unsigned int flags

  flags from **gnutls\_trust\_list\_flags\_t**

## DESCRIPTION

This function will add the given certificate authorities to the trusted list. The CAs in  *clist* must not be deinitialized during the lifetime of  *list* .

If the flag **GNUTLS\_TL\_NO\_DUPLICATES** is specified, then this function will ensure that no duplicates will be present in the final trust list.

If the flag **GNUTLS\_TL\_NO\_DUPLICATE\_KEY** is specified, then this function will ensure that no certificates with the same key are present in the final trust list.

If either **GNUTLS\_TL\_NO\_DUPLICATE\_KEY** or **GNUTLS\_TL\_NO\_DUPLICATES** are given, **gnutls\_x509\_trust\_list\_deinit()** must be called with parameter\
  *all* being 1.

## RETURNS

The number of added elements is returned; that includes duplicate entries.

## SINCE

3\.0.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/