Blame doc/functions/gnutls_server_name_set

Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
@deftypefun {int} {gnutls_server_name_set} (gnutls_session_t @var{session}, gnutls_server_name_type_t @var{type}, const void * @var{name}, size_t @var{name_length})
Packit Service 4684c1
@var{session}: is a @code{gnutls_session_t}  type.
Packit Service 4684c1
Packit Service 4684c1
@var{type}: specifies the indicator type
Packit Service 4684c1
Packit Service 4684c1
@var{name}: is a string that contains the server name.
Packit Service 4684c1
Packit Service 4684c1
@var{name_length}: holds the length of name excluding the terminating null byte
Packit Service 4684c1
Packit Service 4684c1
This function is to be used by clients that want to inform (via a
Packit Service 4684c1
TLS extension mechanism) the server of the name they connected to.
Packit Service 4684c1
This should be used by clients that connect to servers that do
Packit Service 4684c1
virtual hosting.
Packit Service 4684c1
Packit Service 4684c1
The value of  @code{name} depends on the  @code{type} type.  In case of
Packit Service 4684c1
@code{GNUTLS_NAME_DNS} , a UTF-8 null-terminated domain name string,
Packit Service 4684c1
without the trailing dot, is expected.
Packit Service 4684c1
Packit Service 4684c1
IPv4 or IPv6 addresses are not permitted to be set by this function.
Packit Service 4684c1
If the function is called with a name of  @code{name_length} zero it will clear
Packit Service 4684c1
all server names set.
Packit Service 4684c1
Packit Service 4684c1
@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS}  (0) is returned,
Packit Service 4684c1
otherwise a negative error code is returned.
Packit Service 4684c1
@end deftypefun