1 files changed, 29 insertions, 0 deletions
diff --git a/src/rexmpp_random.h b/src/rexmpp_random.h
new file mode 100644
index 0000000..b0f1978
--- /dev/null
+++ b/src/rexmpp_random.h
@@ -0,0 +1,29 @@
+/**
+   @file rexmpp_random.h
+   @brief Random generation
+   @author defanor <defanor@uberspace.net>
+   @date 2023
+   @copyright MIT license.
+*/
+
+#ifndef REXMPP_RANDOM_H
+#define REXMPP_RANDOM_H
+
+/**
+   @brief Fills a buffer with cryptographically-secure random data.
+   @param[out] buf A buffer to write into.
+   @param[in] len The number of bytes to fill.
+
+   Uses arc4random_buf or gcry_create_nonce, depending on what is
+   available.
+*/
+void rexmpp_random_buf (void *buf, size_t len);
+
+/**
+   @brief Generates a random ASCII identifier.
+   @returns A null-terminated string, which must be freed by the
+   caller.
+*/
+char *rexmpp_random_id ();
+
+#endif