Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
gnutls_certificate_get_x509_crt(3)  gnutls  gnutls_certificate_get_x509_crt(3)

NAME
       gnutls_certificate_get_x509_crt - API function

SYNOPSIS
       #include	<gnutls/gnutls.h>

       int    gnutls_certificate_get_x509_crt(gnutls_certificate_credentials_t
       res,  unsigned  index,  gnutls_x509_crt_t  **  crt_list,	  unsigned   *
       crt_list_size);

ARGUMENTS
       gnutls_certificate_credentials_t	res
		   is a	gnutls_certificate_credentials_t type.

       unsigned	index
		   The index of	the certificate	list to	obtain.

       gnutls_x509_crt_t ** crt_list
		   Where to store the certificate list.

       unsigned	* crt_list_size
		   Will	hold the number	of certificates.

DESCRIPTION
       Obtains	a X.509	certificate list that has been stored in  res with one
       of   gnutls_certificate_set_x509_key(),	 gnutls_certificate_set_key(),
       gnutls_certificate_set_x509_key_file(),		       gnutls_certifi-
       cate_set_x509_key_file2(),  gnutls_certificate_set_x509_key_mem(),   or
       gnutls_certificate_set_x509_key_mem2().	Each  certificate  in  the re-
       turned	 certificate	 list	  must	   be	  deallocated	  with
       gnutls_x509_crt_deinit(),  and  the  list  itself  must	be  freed with
       gnutls_free().

       The    index   matches	the   return	value	 of    gnutls_certifi-
       cate_set_x509_key()  and	 friends  functions,  when the GNUTLS_CERTIFI-
       CATE_API_V2 flag	is set.

       If  there  is  no  certificate  with  the  given	 index,	  GNUTLS_E_RE-
       QUESTED_DATA_NOT_AVAILABLE  is  returned.  If  the certificate with the
       given index is not a X.509 certificate, GNUTLS_E_INVALID_REQUEST	is re-
       turned. The returned certificates must be deinitialized after use,  and
       the  crt_list pointer must be freed using gnutls_free().

RETURNS
       GNUTLS_E_SUCCESS	(0) on success,	or a negative error code.

SINCE
       3.4.0

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

COPYRIGHT
       Copyright (C) 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  no-
       tice and	this notice are	preserved.

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

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

gnutls				     3.8.9  gnutls_certificate_get_x509_crt(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gnutls_certificate_get_x509_crt&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help