|
Packit Service |
4684c1 |
.\" DO NOT MODIFY THIS FILE! It was generated by gdoc.
|
|
Packit Service |
4684c1 |
.TH "gnutls_server_name_get" 3 "3.6.14" "gnutls" "gnutls"
|
|
Packit Service |
4684c1 |
.SH NAME
|
|
Packit Service |
4684c1 |
gnutls_server_name_get \- API function
|
|
Packit Service |
4684c1 |
.SH SYNOPSIS
|
|
Packit Service |
4684c1 |
.B #include <gnutls/gnutls.h>
|
|
Packit Service |
4684c1 |
.sp
|
|
Packit Service |
4684c1 |
.BI "int gnutls_server_name_get(gnutls_session_t " session ", void * " data ", size_t * " data_length ", unsigned int * " type ", unsigned int " indx ");"
|
|
Packit Service |
4684c1 |
.SH ARGUMENTS
|
|
Packit Service |
4684c1 |
.IP "gnutls_session_t session" 12
|
|
Packit Service |
4684c1 |
is a \fBgnutls_session_t\fP type.
|
|
Packit Service |
4684c1 |
.IP "void * data" 12
|
|
Packit Service |
4684c1 |
will hold the data
|
|
Packit Service |
4684c1 |
.IP "size_t * data_length" 12
|
|
Packit Service |
4684c1 |
will hold the data length. Must hold the maximum size of data.
|
|
Packit Service |
4684c1 |
.IP "unsigned int * type" 12
|
|
Packit Service |
4684c1 |
will hold the server name indicator type
|
|
Packit Service |
4684c1 |
.IP "unsigned int indx" 12
|
|
Packit Service |
4684c1 |
is the index of the server_name
|
|
Packit Service |
4684c1 |
.SH "DESCRIPTION"
|
|
Packit Service |
4684c1 |
This function will allow you to get the name indication (if any), a
|
|
Packit Service |
4684c1 |
client has sent. The name indication may be any of the enumeration
|
|
Packit Service |
4684c1 |
gnutls_server_name_type_t.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
If \fItype\fP is GNUTLS_NAME_DNS, then this function is to be used by
|
|
Packit Service |
4684c1 |
servers that support virtual hosting, and the data will be a null
|
|
Packit Service |
4684c1 |
terminated IDNA ACE string (prior to GnuTLS 3.4.0 it was a UTF\-8 string).
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
If \fIdata\fP has not enough size to hold the server name
|
|
Packit Service |
4684c1 |
GNUTLS_E_SHORT_MEMORY_BUFFER is returned, and \fIdata_length\fP will
|
|
Packit Service |
4684c1 |
hold the required size.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
\fIindx\fP is used to retrieve more than one server names (if sent by
|
|
Packit Service |
4684c1 |
the client). The first server name has an index of 0, the second 1
|
|
Packit Service |
4684c1 |
and so on. If no name with the given index exists
|
|
Packit Service |
4684c1 |
GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE is returned.
|
|
Packit Service |
4684c1 |
.SH "RETURNS"
|
|
Packit Service |
4684c1 |
On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, on UTF\-8
|
|
Packit Service |
4684c1 |
decoding error \fBGNUTLS_E_IDNA_ERROR\fP is returned, otherwise a negative
|
|
Packit Service |
4684c1 |
error code is returned.
|
|
Packit Service |
4684c1 |
.SH "REPORTING BUGS"
|
|
Packit Service |
4684c1 |
Report bugs to <bugs@gnutls.org>.
|
|
Packit Service |
4684c1 |
.br
|
|
Packit Service |
4684c1 |
Home page: https://www.gnutls.org
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
.SH COPYRIGHT
|
|
Packit Service |
4684c1 |
Copyright \(co 2001- Free Software Foundation, Inc., and others.
|
|
Packit Service |
4684c1 |
.br
|
|
Packit Service |
4684c1 |
Copying and distribution of this file, with or without modification,
|
|
Packit Service |
4684c1 |
are permitted in any medium without royalty provided the copyright
|
|
Packit Service |
4684c1 |
notice and this notice are preserved.
|
|
Packit Service |
4684c1 |
.SH "SEE ALSO"
|
|
Packit Service |
4684c1 |
The full documentation for
|
|
Packit Service |
4684c1 |
.B gnutls
|
|
Packit Service |
4684c1 |
is maintained as a Texinfo manual.
|
|
Packit Service |
4684c1 |
If the /usr/share/doc/gnutls/
|
|
Packit Service |
4684c1 |
directory does not contain the HTML form visit
|
|
Packit Service |
4684c1 |
.B
|
|
Packit Service |
4684c1 |
.IP https://www.gnutls.org/manual/
|
|
Packit Service |
4684c1 |
.PP
|