bionic (3) gnutls_x509_crt_get_key_purpose_oid.3.gz

Provided by: gnutls-doc_3.5.18-1ubuntu1.6_all bug

NAME
       gnutls_x509_crt_get_key_purpose_oid - API function


SYNOPSIS
       #include <gnutls/x509.h>

       int  gnutls_x509_crt_get_key_purpose_oid(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
                   This specifies which OID to return. Use (0) to get the first one.

       void * oid  a pointer to a buffer to hold the OID (may be null)

       size_t * oid_size
                   initially holds the size of  oid

       unsigned int * critical
                   output flag to indicate criticality of extension


DESCRIPTION
       This function will extract the key purpose OIDs of the Certificate specified by the given  index.   These
       are  stored  in  the  Extended  Key Usage extension (2.5.29.37) See the GNUTLS_KP_* definitions for human
       readable names.

       If  oid is null then only the size will be filled. The  oid returned will be  null  terminated,  although
       oid_size will not account for the trailing null.


RETURNS
       GNUTLS_E_SHORT_MEMORY_BUFFER  if  the  provided buffer is not long enough, and in that case the *oid_size
       will be updated with the required size.  On success 0 is returned.


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


       Copyright © 2001-2022 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/