From cc3b5fe459d277ee46277bc26301249f57855470 Mon Sep 17 00:00:00 2001 From: Garrett D'Amore Date: Sun, 24 Nov 2024 08:53:12 -0800 Subject: 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. --- docs/man/nng_socket_get.3.adoc | 13 ------------- 1 file changed, 13 deletions(-) (limited to 'docs/man/nng_socket_get.3.adoc') 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. -- cgit v1.2.3-70-g09d2