1 files changed, 36 insertions, 0 deletions
diff --git a/doc/functions/gnutls_server_name_get b/doc/functions/gnutls_server_name_get
new file mode 100644
index 0000000..6d830dc
--- /dev/null
+++ b/doc/functions/gnutls_server_name_get
@@ -0,0 +1,36 @@
+
+
+
+
+@deftypefun {int} {gnutls_server_name_get} (gnutls_session_t @var{session}, void * @var{data}, size_t * @var{data_length}, unsigned int * @var{type}, unsigned int @var{indx})
+@var{session}: is a @code{gnutls_session_t}  type.
+
+@var{data}: will hold the data
+
+@var{data_length}: will hold the data length. Must hold the maximum size of data.
+
+@var{type}: will hold the server name indicator type
+
+@var{indx}: is the index of the server_name
+
+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  @code{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
+terminated IDNA ACE string (prior to GnuTLS 3.4.0 it was a UTF-8 string).
+
+If  @code{data} has not enough size to hold the server name
+GNUTLS_E_SHORT_MEMORY_BUFFER is returned, and  @code{data_length} will
+hold the required size.
+
+ @code{indx} 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.
+
+@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS}  (0) is returned, on UTF-8
+decoding error @code{GNUTLS_E_IDNA_ERROR}  is returned, otherwise a negative
+error code is returned.
+@end deftypefun