Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
gnutls_x509_crt_get_subject_alt_namegnututls_x509_crt_get_subject_alt_name2(3)

NAME
       gnutls_x509_crt_get_subject_alt_name2 - API function

SYNOPSIS
       #include	<gnutls/x509.h>

       int  gnutls_x509_crt_get_subject_alt_name2(gnutls_x509_crt_t  cert, un-
       signed 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-2017 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

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

gnutls				    3.gnutls_x509_crt_get_subject_alt_name2(3)

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | RETURNS | REPORTING BUGS | COPYRIGHT | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=gnutls_x509_crt_get_subject_alt_name2&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help