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




NAME

       gnutls_x509_crt_get_issuer_alt_othername_oid - API function


SYNOPSIS

       #include <gnutls/x509.h>

       gnutls_x509_crt_get_issuer_alt_othername_oid(3)
       cert, unsigned int seq, void * ret, size_t * ret_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 * ret  is the place where the otherName OID will be copied to

       size_t * ret_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.

       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.

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


RETURNS

       the alternative issuer 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
        ret_size is not large enough to hold the value.  In that case
        ret_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.


SINCE

       2.10.0


REPORTING BUGS

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



COPYRIGHT

       Copyright (C) 2001-2016 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_issuer_alt_othername_oid(3)

gnutls 3.4.11 - Generated Thu Apr 21 05:50:56 CDT 2016
© manpagez.com 2000-2025
Individual documents may contain additional copyright information.