doompanning/docs/man/nng_tls_config.5.adoc
oxmox 7063e2102e Squashed 'external/nng/' content from commit 29b73962
git-subtree-dir: external/nng
git-subtree-split: 29b73962b939a6fbbf6ea8d5d7680bb06d0eeb99
2024-12-18 18:29:29 +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)]