1 files changed, 25 insertions, 0 deletions
diff --git a/docs/ref/api/util/nng_random.md b/docs/ref/api/util/nng_random.md
new file mode 100644
index 00000000..160752ab
--- /dev/null
+++ b/docs/ref/api/util/nng_random.md
@@ -0,0 +1,25 @@
+# nng_random
+
+## NAME
+
+nng_random --- get random number
+
+## SYNOPSIS
+
+```c
+#include <nng/nng.h>
+
+uint32_t nng_random(void);
+```
+
+## DESCRIPTION
+
+The `nng_random` returns a random number.
+The value returned is suitable for use with cryptographic functions such as
+key generation.
+The value is obtained using platform-specific cryptographically strong random
+number facilities when available.
+
+## RETURN VALUES
+
+Returns a random 32-bit value.