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

# [NAME](#NAME)

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

# [SYNOPSIS](#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](#ARGUMENTS)

[gnutls\_x509\_trust\_list\_t list](#gnutls_x509_trust_list_t)

The list

[const gnutls\_x509\_crt\_t * clist](#const)

A list of CAs

[unsigned clist\_size](#unsigned)

The length of the CA list

[unsigned int flags](#unsigned~2)

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

# [DESCRIPTION](#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](#RETURNS)

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

# [SINCE](#SINCE)

3.0.0

# [REPORTING BUGS](#REPORTING_BUGS)

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

# [COPYRIGHT](#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](#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/](https://www.gnutls.org/manual/)

3.8.13 gnutls

---

Document: gnutls_x509_trust_list_add_cas(3) from gnutls 3.8.13-r1 (Chainguard OS)
Source: https://gitlab.com/gnutls/gnutls