diff options
| author | Garrett D'Amore <garrett@damore.org> | 2024-11-09 15:24:43 -0800 |
|---|---|---|
| committer | Garrett D'Amore <garrett@damore.org> | 2024-11-09 16:27:45 -0800 |
| commit | 0058b766b91f08b34dcef3c7bb55b216099f3f66 (patch) | |
| tree | 5ac1fa105d707018cdfa9f5244da5837a8c31601 /docs/man | |
| parent | 150d80c2c62ce3693dbbd0256c16337879c7d825 (diff) | |
| download | nng-0058b766b91f08b34dcef3c7bb55b216099f3f66.tar.gz nng-0058b766b91f08b34dcef3c7bb55b216099f3f66.tar.bz2 nng-0058b766b91f08b34dcef3c7bb55b216099f3f66.zip | |
TLS configuration changed to use discret _set_tls and _get_tls functions.
This is simpler, and more reliable than using socket options.
Diffstat (limited to 'docs/man')
| -rw-r--r-- | docs/man/nng_tls.7.adoc | 1 | ||||
| -rw-r--r-- | docs/man/nng_tls_options.5.adoc | 25 | ||||
| -rw-r--r-- | docs/man/nng_ws.7.adoc | 18 |
3 files changed, 21 insertions, 23 deletions
diff --git a/docs/man/nng_tls.7.adoc b/docs/man/nng_tls.7.adoc index 73a63a9f..a4b39f48 100644 --- a/docs/man/nng_tls.7.adoc +++ b/docs/man/nng_tls.7.adoc @@ -107,7 +107,6 @@ Note that setting these must be done before the transport is started. * xref:nng_options.5.adoc#NNG_OPT_REMADDR[`NNG_OPT_REMADDR`] * xref:nng_tcp_options.5.adoc#NNG_OPT_TCP_KEEPALIVE[`NNG_OPT_TCP_KEEPALIVE`] * xref:nng_tcp_options.5.adoc#NNG_OPT_TCP_NODELAY[`NNG_OPT_TCP_NODELAY`] -* xref:nng_tls_options.5.adoc#NNG_OPT_TLS_CONFIG[`NNG_OPT_TLS_CONFIG`] * xref:nng_tls_options.5.adoc#NNG_OPT_TLS_VERIFIED[`NNG_OPT_TLS_VERIFIED_`] * xref:nng_tls_options.5.adoc#NNG_OPT_TLS_PEER_CN[`NNG_OPT_TLS_PEER_CN`] * xref:nng_tls_options.5.adoc#NNG_OPT_TLS_PEER_ALT_NAMES[`NNG_OPT_TLS_PEER_ALT_NAMES`] diff --git a/docs/man/nng_tls_options.5.adoc b/docs/man/nng_tls_options.5.adoc index cf2a99cf..5921246f 100644 --- a/docs/man/nng_tls_options.5.adoc +++ b/docs/man/nng_tls_options.5.adoc @@ -20,7 +20,6 @@ nng_tls_options - TLS-specific options ---- #include <nng/nng.h> -#define NNG_OPT_TLS_CONFIG "tls-config" #define NNG_OPT_TLS_VERIFIED "tls-verified" #define NNG_OPT_TLS_PEER_CN "tls-peer-cn" #define NNG_OPT_TLS_PEER_ALT_NAMES "tls-peer-alt-names" @@ -43,18 +42,18 @@ description of the option. === TLS Options -[[NNG_OPT_TLS_CONFIG]]((`NNG_OPT_TLS_CONFIG`)):: -(`nng_tls_config *`) -This option references the underlying -xref:nng_tls_config.5.adoc[TLS configuration object]. -A hold is placed on the underlying -configuration object before returning it. -+ -NOTE: The caller should release the hold with -xref:nng_tls_config_free.3tls.adoc[`nng_tls_config_free()`] when it no -longer needs the TLS configuration object. -+ -TIP: Use this option when more advanced TLS configuration is required. +// [[NNG_OPT_TLS_CONFIG]]((`NNG_OPT_TLS_CONFIG`)):: +// (`nng_tls_config *`) +// This option references the underlying +// xref:nng_tls_config.5.adoc[TLS configuration object]. +// A hold is placed on the underlying +// configuration object before returning it. +// + +// NOTE: The caller should release the hold with +// xref:nng_tls_config_free.3tls.adoc[`nng_tls_config_free()`] when it no +// longer needs the TLS configuration object. +// + +// TIP: Use this option when more advanced TLS configuration is required. [[NNG_OPT_TLS_VERIFIED]]((`NNG_OPT_TLS_VERIFIED`)):: (`bool`) diff --git a/docs/man/nng_ws.7.adoc b/docs/man/nng_ws.7.adoc index 07c6cd14..938b16a9 100644 --- a/docs/man/nng_ws.7.adoc +++ b/docs/man/nng_ws.7.adoc @@ -145,17 +145,17 @@ When set, the stream will send TEXT frames instead of BINARY frames. NOTE: NNG does not check the frame data, and will attempt to send whatever the client requests. Peers that are compliant with RFC 6455 will discard TEXT frames (and break the connection) if they do not contain valid UTF-8. -((`NNG_OPT_TLS_CONFIG`)):: +// ((`NNG_OPT_TLS_CONFIG`)):: -(`nng_tls_config *`) The underlying TLS -configuration object for `wss://` endpoints. -A hold is placed on the underlying -configuration object before returning it. -The caller should release the object with -xref:nng_tls_config_free.3tls.adoc[`nng_tls_config_free()`] when it no -longer needs the TLS configuration. +// (`nng_tls_config *`) The underlying TLS +// configuration object for `wss://` endpoints. +// A hold is placed on the underlying +// configuration object before returning it. +// The caller should release the object with +// xref:nng_tls_config_free.3tls.adoc[`nng_tls_config_free()`] when it no +// longer needs the TLS configuration. -TIP: Use this option when advanced TLS configuration is required. +// TIP: Use this option when advanced TLS configuration is required. `NNG_OPT_TLS_VERIFIED`:: (`bool`) Whether the remote peer has been properly verified using TLS |
