From ff66ec5f43547abc78b22ebcdfad32e2775bc9cb Mon Sep 17 00:00:00 2001 From: Garrett D'Amore Date: Sun, 17 Nov 2024 13:34:58 -0800 Subject: tcp/tls: Remove support for local interface address in dialer URLs This was an undocumented capability provided for libnanomsg. The correct way to obtain the same functionality is to use `NNG_OPT_LOCADDR`. --- docs/ref/migrate/nanomsg.md | 7 +++++++ docs/ref/migrate/nng1.md | 8 ++++++++ 2 files changed, 15 insertions(+) (limited to 'docs/ref') diff --git a/docs/ref/migrate/nanomsg.md b/docs/ref/migrate/nanomsg.md index bb668121..66add9b2 100644 --- a/docs/ref/migrate/nanomsg.md +++ b/docs/ref/migrate/nanomsg.md @@ -121,4 +121,11 @@ There are some exceptions. Be aware that the numeric values are _not_ the same. | `EMFILE` | [`NNG_ENOFILES`] | | `ENOSPC` | [`NNG_ENOSPC`] | +## Local Addresses for Dialing + +The ability to specify the source address in the UROL,to use when +using `nn_dial` inside the URL is not present in NNG. The correct +way to specify the local address is using the `NNG_OPT_LOCADDR` option on the +dialer before starting to dial. + {{#include ../xref.md}} diff --git a/docs/ref/migrate/nng1.md b/docs/ref/migrate/nng1.md index 7bafb8f5..d3440fe4 100644 --- a/docs/ref/migrate/nng1.md +++ b/docs/ref/migrate/nng1.md @@ -60,6 +60,14 @@ Support for very old TLS versions 1.0 and 1.1 is removed. Further, the `NNG_TLS_1_0` and `NNG_TLS_1_1` constants are also removed. Applications should use `NNG_TLS_1_2` or even `NNG_TLS_1_3` instead. +## Support for Local Addresses in Dial URLs Removed + +NNG 1.x had an undocumented ability to specify the local address to bind +to when dialing, by using the local address in front of the destination +address separated by a semicolon. This was provided for legacy libnanomsg +compatilibility, and is no longer offered. The correct way to specify a +local address is by setting `NNG_OPT_LOCADDR` on the dialer. + ## Option Functions The previously deprecated `nng_pipe_getopt_xxx` family of functions is removed. -- cgit v1.2.3-70-g09d2