summaryrefslogtreecommitdiffstats
path: root/upstream/archlinux/man1/openssl-rand.1ssl
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/archlinux/man1/openssl-rand.1ssl')
-rw-r--r--upstream/archlinux/man1/openssl-rand.1ssl14
1 files changed, 11 insertions, 3 deletions
diff --git a/upstream/archlinux/man1/openssl-rand.1ssl b/upstream/archlinux/man1/openssl-rand.1ssl
index 5f4c6eea..24f413ff 100644
--- a/upstream/archlinux/man1/openssl-rand.1ssl
+++ b/upstream/archlinux/man1/openssl-rand.1ssl
@@ -55,7 +55,7 @@
.\" ========================================================================
.\"
.IX Title "OPENSSL-RAND 1ssl"
-.TH OPENSSL-RAND 1ssl 2024-01-30 3.2.1 OpenSSL
+.TH OPENSSL-RAND 1ssl 2024-04-28 3.3.0 OpenSSL
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -75,11 +75,19 @@ openssl\-rand \- generate pseudo\-random bytes
[\fB\-provider\fR \fIname\fR]
[\fB\-provider\-path\fR \fIpath\fR]
[\fB\-propquery\fR \fIpropq\fR]
-\&\fInum\fR
+\&\fInum\fR[K|M|G|T]
.SH DESCRIPTION
.IX Header "DESCRIPTION"
This command generates \fInum\fR random bytes using a cryptographically
-secure pseudo random number generator (CSPRNG).
+secure pseudo random number generator (CSPRNG). A suffix [K|M|G|T] may be
+appended to the num value to indicate the requested value be scaled as a
+multiple of KiB/MiB/GiB/TiB respectively. Note that suffixes are case
+sensitive, and that the suffixes represent binary multiples
+(K = 1024 bytes, M = 1024*1024 bytes, etc).
+.PP
+The string 'max' may be substituted for a numerical value in num, to request the
+maximum number of bytes the CSPRNG can produce per instantiation. Currently,
+this is restricted to 2^61 bytes as per NIST SP 800\-90C.
.PP
The random bytes are generated using the \fBRAND_bytes\fR\|(3) function,
which provides a security level of 256 bits, provided it managed to