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




NAME

       gnutls_x509_crt_get_subject_alt_name2 - API function


SYNOPSIS

       #include <gnutls/x509.h>

       gnutls_x509_crt_get_subject_alt_name2(3)    cert,
       unsigned int seq, void  *  san,  size_t  *  san_size,  unsigned  int  *
       san_type, unsigned int * critical);


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 * san  is the place where the alternative name will be copied to

       size_t * san_size
                   holds the size of ret.

       unsigned int * san_type
                   holds  the  type  of   the   alternative   name   (one   of
                   gnutls_x509_subject_alt_name_t).

       unsigned int * critical
                   will  be  non-zero  if  the extension is marked as critical
                   (may be null)


DESCRIPTION

       This function will return the alternative names, contained in the given
       certificate.  It  is the same as gnutls_x509_crt_get_subject_alt_name()
       except for the fact that it will return the  type  of  the  alternative
       name in  san_type even if the function fails for some reason (i.e.  the
       buffer provided is not enough).


RETURNS

       the alternative subject name type on success,  one  of  the  enumerated
       gnutls_x509_subject_alt_name_t.   It  will  return  GNUTLS_E_SHORT_MEM-
       ORY_BUFFER if  san_size is not large enough to hold the value.  In that
       case  san_size will be updated with the required size.  If the certifi-
       cate does not have an Alternative name with the specified sequence num-
       ber then GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE is returned.


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_subject_alt_name2(3)

gnutls 3.4.11 - Generated Thu Apr 21 06:27:10 CDT 2016
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.