doompanning/docs/man/nng_tls_config.5.adoc
oxmox 17f68cf8fe Squashed 'external/nng/' content from commit 169221da
git-subtree-dir: external/nng
git-subtree-split: 169221da8d53b2ca4fda76f894bee8505887a7c6
2023-02-03 21:18:59 +01:00

56 lines
1.8 KiB
Text

= nng_tls_config(5)
//
// Copyright 2020 Staysail Systems, Inc. <info@staysail.tech>
// Copyright 2019 Devolutions <devolutions.net>
//
// This document is supplied under the terms of the MIT License, a
// copy of which should be located in the distribution where this
// file was obtained (LICENSE.txt). A copy of the license may also be
// found online at https://opensource.org/licenses/MIT.
//
== NAME
nng_tls_config - TLS configuration object
== SYNOPSIS
[source, c]
----
#include <nng/supplemental/tls/tls.h>
typedef struct nng_tls_config nng_tls_config;
----
== DESCRIPTION
An `nng_tls_config` represents a single ((TLS configuration)) object, which
can be used to configure TLS servers and clients.
Configuration data includes details such as certificate chains used for
validation of remote peers, local key and certificate material, server
names, and so forth.
Additionally, a configuration can be used either in client mode, or in
server mode.
Configuration objects may be shared, and are reference counted.
However once a configuration is used, it enters a read-only state that
precludes further modifications to the configuration.
Messages are allocated using the
xref:nng_tls_config_alloc.3tls.adoc[`nng_tls_config_alloc()`]
function, and are deallocated using the
xref:nng_tls_config_free.3tls.adoc[`nng_tls_config_free()`]
function.
== SEE ALSO
[.text-left]
xref:nng_tls_config_alloc.3tls.adoc[nng_tls_config_alloc(3tls)],
xref:nng_tls_config_auth_mode.3tls.adoc[nng_tls_config_auth_mode(3tls)],
xref:nng_tls_config_ca_chain.3tls.adoc[nng_tls_config_ca_chain(3tls)],
xref:nng_tls_config_own_cert.3tls.adoc[nng_tls_config_own_cert(3tls)],
xref:nng_tls_config_free.3tls.adoc[nng_tls_config_free(3tls)],
xref:nng_tls_config_hold.3tls.adoc[nng_tls_config_hold(3tls)],
xref:nng_tls_config_server_name.3tls.adoc[nng_tls_config_server_name(3tls)],
xref:nng.7.adoc[nng(7)]