aboutsummaryrefslogtreecommitdiff
path: root/docs/man/nng_socket_get.3.adoc
diff options
context:
space:
mode:
authorGarrett D'Amore <garrett@damore.org>2024-11-24 08:53:12 -0800
committerGarrett D'Amore <garrett@damore.org>2024-11-24 08:58:30 -0800
commitcc3b5fe459d277ee46277bc26301249f57855470 (patch)
tree6a8b55a5a3b5cc4328f605965950446fb46695fa /docs/man/nng_socket_get.3.adoc
parent895ea654581ef9928e554366fbd93f613a049017 (diff)
downloadnng-cc3b5fe459d277ee46277bc26301249f57855470.tar.gz
nng-cc3b5fe459d277ee46277bc26301249f57855470.tar.bz2
nng-cc3b5fe459d277ee46277bc26301249f57855470.zip
socket: remove unused nng_socket_get_ptr and nng_socket_set_ptr.
We will be removing these pointer based functions more generally as we we have type-specific accessors instead. We also removed the context versions of these functions, which were not previously documented.
Diffstat (limited to 'docs/man/nng_socket_get.3.adoc')
-rw-r--r--docs/man/nng_socket_get.3.adoc13
1 files changed, 0 insertions, 13 deletions
diff --git a/docs/man/nng_socket_get.3.adoc b/docs/man/nng_socket_get.3.adoc
index cca1dc5a..f510eb39 100644
--- a/docs/man/nng_socket_get.3.adoc
+++ b/docs/man/nng_socket_get.3.adoc
@@ -29,8 +29,6 @@ int nng_socket_get_uint64(nng_socket s, const char *opt, uint64_t *u64p);
int nng_socket_get_string(nng_socket s, const char *opt, char **strp);
-int nng_socket_get_ptr(nng_socket s, const char *opt, void **ptr);
-
int nng_socket_get_ms(nng_socket s, const char *opt, nng_duration *durp);
int nng_socket_get_addr(nng_socket s, const char *opt, nng_sockaddr *addrp);
@@ -47,11 +45,6 @@ A number of them are documented in xref:nng_options.5.adoc[nng_options(5)].
Additionally protocol-specific options are documented with the protocols themselves.
-IMPORTANT: Access to transport options via this function is deprecated, and may be
-removed from a future release. Applications should instead make use of
-xref:nng_dialer_get.3.adoc[nng_dialer_get] or
-xref:nng_listener_get.3.adoc[nng_listener_get] for specific dialers or listeners.
-
=== Forms
In all of these forms, the option _opt_ is retrieved from the socket _s_.
@@ -74,12 +67,6 @@ This function is used to retrieve time xref:nng_duration.5.adoc[durations]
(The special value ((`NNG_DURATION_INFINITE`)) means an infinite amount of time, and
the special value ((`NNG_DURATION_DEFAULT`)) means a context-specific default.)
-`nng_socket_get_ptr()`::
-This function is used to retrieve a pointer, _ptr_, to structured data.
-The data referenced by _ptr_ is generally managed using other functions.
-Note that this form is somewhat special in that the object is generally
-not copied, but instead the *pointer* to the object is copied.
-
`nng_socket_get_size()`::
This function is used to retrieve a size into the pointer _zp_,
typically for buffer sizes, message maximum sizes, and similar options.