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

FreeBSD Manual Pages

  
 
  

home | help 
gnutls_x509_crt..._extension_info(3) gnutls gnutls_x509_crt..._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  ac-
		 tual 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 certificate,
     and the critical flag for it.  The extension OID will be stored as a string
     in the provided buffer.  Use gnutls_x509_crt_get_extension() 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 error
     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  notice  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.13 gnutls_x509_crt..._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+15.1.quarterly>

home | help