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

FreeBSD Manual Pages

  
 
  

home | help
gnutls_x509_crq_get_subject_alt_namegnugnutls_x509_crq_get_subject_alt_name(3)

NAME
       gnutls_x509_crq_get_subject_alt_name - API function

SYNOPSIS
       #include	<gnutls/x509.h>

       int   gnutls_x509_crq_get_subject_alt_name(gnutls_x509_crq_t  crq,  un-
       signed int seq, void * ret, size_t * ret_size, unsigned int * ret_type,
       unsigned	int * critical);

ARGUMENTS
       gnutls_x509_crq_t crq
		   should contain a gnutls_x509_crq_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 alternative name will	be copied to

       size_t *	ret_size
		   holds the size of ret.

       unsigned	int * ret_type
		   holds the gnutls_x509_subject_alt_name_t name type

       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_crq_get_subject_alt_name()
       except  for  the	 fact  that it will return the type of the alternative
       name in	ret_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  ret_size is not large enough to hold the value.  In that
       case  ret_size will be updated with the required	size.  If the certifi-
       cate  request  does not have an Alternative name	with the specified se-
       quence number then GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE	is returned.

SINCE
       2.8.0

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.5gnutls_x509_crq_get_subject_alt_name(3)

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | RETURNS | SINCE | 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_crq_get_subject_alt_name&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help