dwww Home | Manual pages | Find package

gnutls_x509_crt_get_subject_algnutlsgx509scrt(get_subject_alt_othername_oid(3)

NAME
       gnutls_x509_crt_get_subject_alt_othername_oid - API function

SYNOPSIS
       #include <gnutls/x509.h>

       int     gnutls_x509_crt_get_subject_alt_othername_oid(gnutls_x509_crt_t
       cert, unsigned int seq, void * oid, size_t * oid_size);

ARGUMENTS
       gnutls_x509_crt_t cert
                   should contain a gnutls_x509_crt_t type

       unsigned int seq
                   specifies the sequence number of the alt name  (0  for  the
                   first one, 1 for the second etc.)

       void * oid  is the place where the otherName OID will be copied to

       size_t * oid_size
                   holds the size of ret.

DESCRIPTION
       This  function will extract the type OID of an otherName Subject Alter-
       native Name, contained in the given certificate, and return the type as
       an enumerated element.

       This  function is only useful if gnutls_x509_crt_get_subject_alt_name()
       returned GNUTLS_SAN_OTHERNAME.

       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
       the alternative subject name type on success,  one  of  the  enumerated
       gnutls_x509_subject_alt_name_t.  For supported OIDs, it will return one
       of the virtual (GNUTLS_SAN_OTHERNAME_*) types,  e.g.  GNUTLS_SAN_OTHER-
       NAME_XMPP,  and  GNUTLS_SAN_OTHERNAME for unknown OIDs.  It will return
       GNUTLS_E_SHORT_MEMORY_BUFFER if
        ian_size is not large enough to hold the value.  In that case
        ian_size will be updated with the required size.  If  the  certificate
       does  not  have  an Alternative name with the specified sequence number
       and with the otherName type then  GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE
       is returned.

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

COPYRIGHT
       Copyright © 2001- 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/share/doc/gnutls/ directory does not contain the HTML  form
       visit

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

gnutls                        gnutls_x5093crt_get_subject_alt_othername_oid(3)

Generated by dwww version 1.14 on Sun Dec 29 18:25:51 CET 2024.