summaryrefslogtreecommitdiff
path: root/docs/ref/str/nng_stream_dialer_free.adoc
diff options
context:
space:
mode:
Diffstat (limited to 'docs/ref/str/nng_stream_dialer_free.adoc')
-rw-r--r--docs/ref/str/nng_stream_dialer_free.adoc24
1 files changed, 24 insertions, 0 deletions
diff --git a/docs/ref/str/nng_stream_dialer_free.adoc b/docs/ref/str/nng_stream_dialer_free.adoc
new file mode 100644
index 00000000..ecebb3d7
--- /dev/null
+++ b/docs/ref/str/nng_stream_dialer_free.adoc
@@ -0,0 +1,24 @@
+## nng_stream_dialer_free
+
+Free byte stream dialer.
+
+### Synopsis
+
+```c
+#include <nng/nng.h>
+
+void nng_stream_dialer_free(nng_stream_dialer *d);
+```
+
+### Description
+
+The `nng_stream_dialer_free` function closes the supplied byte stream dialer _d_, and frees the underlying resources associated with it.
+
+If any xref:nng_stream_dialer_dial.adoc[dial] operations using _d_ are in progress, they will be terminated with an `NNG_ECLOSED` error condition.
+
+WARNING: It is important that the application ensure that no further accesses are made to _d_, as the memory backing it will be reclaimed for other uses.
+
+### See Also
+
+xref:nng_stream_dialer_alloc.adoc[nng_stream_dialer_alloc],
+xref:nng_stream_dialer_close.adoc[nng_stream_dialer_close]