Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

gnutls_server_name_get(3) [suse man page]

gnutls_server_name_get(3)					      gnutls						 gnutls_server_name_get(3)

NAME

       gnutls_server_name_get - Used to get the server name indicator send by a client

SYNOPSIS

       #include <gnutls/gnutls.h>

       int gnutls_server_name_get(gnutls_session_t session, void * data, size_t * data_length, unsigned int * type, unsigned int indx);

ARGUMENTS

       gnutls_session_t session
		   is a gnutls_session_t structure.

       void * data will hold the data

       size_t * data_length
		   will hold the data length. Must hold the maximum size of data.

       unsigned int * type
		   will hold the server name indicator type

       unsigned int indx
		   is the index of the server_name

DESCRIPTION

       This  function  will  allow  you to get the name indication (if any), a client has sent.  The name indication may be any of the enumeration
       gnutls_server_name_type_t.

       If type is GNUTLS_NAME_DNS, then this function is to be used by servers that support virtual hosting, and the data will be  a  null  termi-
       nated UTF-8 string.

       If data has not enough size to hold the server name GNUTLS_E_SHORT_MEMORY_BUFFER is returned, and data_length will hold the required size.

       index is used to retrieve more than one server names (if sent by the client).  The first server name has an index of 0, the second 1 and so
       on.  If no name with the given index exists GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE is returned.

RETURNS

       On success, GNUTLS_E_SUCCESS (zero) is returned, otherwise an error code is returned.

REPORTING BUGS

       Report  bugs  to  <bug-gnutls@gnu.org>.	 GnuTLS  home  page:  http://www.gnu.org/software/gnutls/  General  help   using   GNU	 software:
       http://www.gnu.org/gethelp/

COPYRIGHT

       Copyright (C) 2008 Free Software Foundation.
       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 info and gnutls programs are properly installed at your  site,
       the command

	      info gnutls

       should give you access to the complete manual.

gnutls								       2.8.6						 gnutls_server_name_get(3)

Check Out this Related Man Page

gnutls_x509_crt_get_issuer_dn_oid(3)				      gnutls				      gnutls_x509_crt_get_issuer_dn_oid(3)

NAME

       gnutls_x509_crt_get_issuer_dn_oid - API function

SYNOPSIS

       #include <gnutls/x509.h>

       int gnutls_x509_crt_get_issuer_dn_oid(gnutls_x509_crt_t cert, int indx, void * oid, size_t * oid_size);

ARGUMENTS

       gnutls_x509_crt_t cert
		   should contain a gnutls_x509_crt_t structure

       int indx    This specifies which OID to return. Use (0) to get the first one.

       void * oid  a pointer to a buffer to hold the OID (may be null)

       size_t * oid_size
		   initially holds the size of	oid

DESCRIPTION

       This function will extract the OIDs of the name of the Certificate issuer specified by the given index.

       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

       GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and in that case the  buf_size will be updated  with  the  required
       size. GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE if there are no data in the current index. On success 0 is returned.

REPORTING BUGS

       Report bugs to <bug-gnutls@gnu.org>.
       General guidelines for reporting bugs: http://www.gnu.org/gethelp/
       GnuTLS home page: http://www.gnu.org/software/gnutls/

COPYRIGHT

       Copyright (C) 2012 Free Software Foundation, Inc..
       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 info and gnutls programs are properly installed at your  site,
       the command

	      info gnutls

       should give you access to the complete manual.  As an alternative you may obtain the manual from:

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

gnutls								      3.1.15				      gnutls_x509_crt_get_issuer_dn_oid(3)
Man Page