NAME

       nng_tls_config_server_name - configure remote server name

SYNOPSIS

           #include <nng/nng.h>
           #include <nng/supplemental/tls/tls.h>

           int nng_tls_config_server_name(nng_tls_config *cfg, const char *name);

DESCRIPTION

       The nng_tls_config_server_name() function configures the remote server name to be used by a client when
       connection to a server. The supplied name is used when comparing the identity in the server’s
       certificate. Furthermore, when Server Name Indication (SNI) is used, the name may be sent to the server
       as a hint to tell it which of several possible certificates should be used.

           Tip

           This function is only useful in configuring client behavior.

RETURN VALUES

       This function returns 0 on success, and non-zero otherwise.

ERRORS

       NNG_ENOMEM
           Insufficient memory is available.

       NNG_EBUSY
           The configuration cfg is already in use, and cannot be modified.

SEE ALSO

       nng_strerror(3), nng_tls_config_alloc(3tls), nng_tls_config_auth_mode(3tls), nng(7)

                                                   2025-04-20                   NNG_TLS_CONFIG_SERVER_NAME(3tls)