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

FreeBSD Manual Pages

  
 
  

home | help
gnutls_x509_cr...extension_info(3)  gnutls  gnutls_x509_cr...extension_info(3)

NAME
       gnutls_x509_crt_get_extension_info - API	function

SYNOPSIS
       #include	<gnutls/x509.h>

       int gnutls_x509_crt_get_extension_info(gnutls_x509_crt_t	cert, unsigned
       indx, void * oid, size_t	* oid_size, unsigned int * critical);

ARGUMENTS
       gnutls_x509_crt_t cert
		   should contain a gnutls_x509_crt_t type

       unsigned	indx
		   Specifies  which  extension OID to send. Use	(0) to get the
		   first one.

       void * oid  a pointer to	a structure to hold the	OID

       size_t *	oid_size
		   initially holds the maximum size of	oid , on return	 holds
		   actual size of  oid .

       unsigned	int * critical
		   output variable with	critical flag, may be NULL.

DESCRIPTION
       This  function  will return the requested extension OID in the certifi-
       cate, and the critical flag for it.  The	extension OID will  be	stored
       as  a  string  in  the provided buffer.	Use gnutls_x509_crt_get_exten-
       sion() to extract the data.

       If the buffer provided is not long enough to hold the output, then
	oid_size is updated and	GNUTLS_E_SHORT_MEMORY_BUFFER will be returned.
       The  oid	returned will be null terminated, although
	oid_size will not account for the trailing null	 (the  latter  is  not
       true for	GnuTLS prior to	3.6.0).

RETURNS
       On  success, GNUTLS_E_SUCCESS (0) is returned, otherwise	a negative er-
       ror code	is returned.  If you have reached the last extension available
       GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE will be returned.

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_x509_cr...extension_info(3)

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

home | help