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
|