util funcs reorg

1 files changed, 37 insertions, 0 deletions

diff --git a/docs/reference/src/util/nng_free.md b/docs/reference/src/util/nng_free.md
new file mode 100644
index 00000000..e93e91e6
--- /dev/null
+++ b/docs/reference/src/util/nng_free.md
@@ -0,0 +1,37 @@
+# nng_free
+
+## NAME
+
+nng_free --- free memory
+
+## SYNOPSIS
+
+```c
+#include <nng/nng.h>
+
+void nng_free(void *ptr, size_t size);
+```
+
+## DESCRIPTION
+
+The `nng_free()` function deallocates a memory region of size _size_,
+that was previously allocated by [`nng_alloc()`][nng_alloc] or
+[`nng_recv()`](../socket/nng_recv.md) with the `NNG_FLAG_ALLOC` flag.
+
+> [!IMPORTANT]
+> It is very important that _size_ match the allocation size
+> used to allocate the memory.
+
+> [!IMPORTANT]
+> Do not attempt to use this function to deallocate memory
+> obtained by a call to the system `malloc()` or `calloc()` functions,
+> or the C++ `new` operator.
+> Doing so may result in unpredictable
+> behavior, including corruption of application memory.
+
+## SEE ALSO
+
+[nng_alloc][nng_alloc],
+[nng_recv](../socket/nng_recv.md)
+
+{{#include ../refs.md}}