manpagez: man pages & more
man gnutls_x509_crt_get_extension_info(3)
Home | html | info | man
gnutls_x509_crt_get_extension_info(3)



NAME

       gnutls_x509_crt_get_extension_info - API function


SYNOPSIS

       #include <gnutls/x509.h>

       gnutls_x509_crt_get_extension_info(3) 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
       error code is returned.  If you have reached the last extension  avail-
       able GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE will be returned.


REPORTING BUGS

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



COPYRIGHT

       Copyright (C) 2001-2018 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

       http://www.gnutls.org/manual/




gnutls                               gnutls_x509_crt_get_extension_info(3)

gnutls 3.6.5 - Generated Sun Jan 20 15:29:46 CST 2019
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.