<?xml version="1.0" ?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>rand</title> <meta http-equiv="content-type" content="text/html; charset=utf-8" /> <link rev="made" href="mailto:root@localhost" /> </head> <body style="background-color: white"> <ul id="index"> <li><a href="#NAME">NAME</a></li> <li><a href="#SYNOPSIS">SYNOPSIS</a></li> <li><a href="#DESCRIPTION">DESCRIPTION</a></li> <li><a href="#OPTIONS">OPTIONS</a></li> <li><a href="#NOTES">NOTES</a></li> <li><a href="#SEE-ALSO">SEE ALSO</a></li> <li><a href="#COPYRIGHT">COPYRIGHT</a></li> </ul> <h1 id="NAME">NAME</h1> <p>openssl-rand, rand - generate pseudo-random bytes</p> <h1 id="SYNOPSIS">SYNOPSIS</h1> <p><b>openssl rand</b> [<b>-help</b>] [<b>-out</b> <i>file</i>] [<b>-rand file...</b>] [<b>-writerand file</b>] [<b>-base64</b>] [<b>-hex</b>] <i>num</i></p> <h1 id="DESCRIPTION">DESCRIPTION</h1> <p>This command generates <i>num</i> random bytes using a cryptographically secure pseudo random number generator (CSPRNG).</p> <p>The random bytes are generated using the <a href="../man3/RAND_bytes.html">RAND_bytes(3)</a> function, which provides a security level of 256 bits, provided it managed to seed itself successfully from a trusted operating system entropy source. Otherwise, the command will fail with a nonzero error code. For more details, see <a href="../man3/RAND_bytes.html">RAND_bytes(3)</a>, <a href="../man7/RAND.html">RAND(7)</a>, and <a href="../man7/RAND_DRBG.html">RAND_DRBG(7)</a>.</p> <h1 id="OPTIONS">OPTIONS</h1> <dl> <dt id="help"><b>-help</b></dt> <dd> <p>Print out a usage message.</p> </dd> <dt id="out-file"><b>-out file</b></dt> <dd> <p>Write to <i>file</i> instead of standard output.</p> </dd> <dt id="rand-file"><b>-rand file...</b></dt> <dd> <p>A file or files containing random data used to seed the random number generator. Multiple files can be specified separated by an OS-dependent character. The separator is <b>;</b> for MS-Windows, <b>,</b> for OpenVMS, and <b>:</b> for all others. Explicitly specifying a seed file is in general not necessary, see the <a href="#NOTES">"NOTES"</a> section for more information.</p> </dd> <dt id="writerand-file">[<b>-writerand file</b>]</dt> <dd> <p>Writes random data to the specified <i>file</i> upon exit. This can be used with a subsequent <b>-rand</b> flag.</p> </dd> <dt id="base64"><b>-base64</b></dt> <dd> <p>Perform base64 encoding on the output.</p> </dd> <dt id="hex"><b>-hex</b></dt> <dd> <p>Show the output as a hex string.</p> </dd> </dl> <h1 id="NOTES">NOTES</h1> <p>Prior to OpenSSL 1.1.1, it was common for applications to store information about the state of the random-number generator in a file that was loaded at startup and rewritten upon exit. On modern operating systems, this is generally no longer necessary as OpenSSL will seed itself from a trusted entropy source provided by the operating system. The <b>-rand</b> and <b>-writerand</b> flags are still supported for special platforms or circumstances that might require them.</p> <p>It is generally an error to use the same seed file more than once and every use of <b>-rand</b> should be paired with <b>-writerand</b>.</p> <h1 id="SEE-ALSO">SEE ALSO</h1> <p><a href="../man3/RAND_bytes.html">RAND_bytes(3)</a>, <a href="../man7/RAND.html">RAND(7)</a>, <a href="../man7/RAND_DRBG.html">RAND_DRBG(7)</a></p> <h1 id="COPYRIGHT">COPYRIGHT</h1> <p>Copyright 2000-2020 The OpenSSL Project Authors. All Rights Reserved.</p> <p>Licensed under the OpenSSL license (the "License"). You may not use this file except in compliance with the License. You can obtain a copy in the file LICENSE in the source distribution or at <a href="https://www.openssl.org/source/license.html">https://www.openssl.org/source/license.html</a>.</p> </body> </html>
Name | Type | Size | Permission | Actions |
---|---|---|---|---|
CA.pl.html | File | 9.34 KB | 0644 |
|
asn1parse.html | File | 8.22 KB | 0644 |
|
c_rehash.html | File | 5.68 KB | 0644 |
|
ca.html | File | 30.91 KB | 0644 |
|
ciphers.html | File | 35.11 KB | 0644 |
|
cms.html | File | 29.84 KB | 0644 |
|
crl.html | File | 4.7 KB | 0644 |
|
crl2pkcs7.html | File | 4.21 KB | 0644 |
|
dgst.html | File | 8.82 KB | 0644 |
|
dhparam.html | File | 6.21 KB | 0644 |
|
dsa.html | File | 7.03 KB | 0644 |
|
dsaparam.html | File | 4.9 KB | 0644 |
|
ec.html | File | 7.88 KB | 0644 |
|
ecparam.html | File | 7.13 KB | 0644 |
|
enc.html | File | 16.6 KB | 0644 |
|
engine.html | File | 4.27 KB | 0644 |
|
errstr.html | File | 1.88 KB | 0644 |
|
gendsa.html | File | 4.03 KB | 0644 |
|
genpkey.html | File | 13.78 KB | 0644 |
|
genrsa.html | File | 5.15 KB | 0644 |
|
list.html | File | 3.4 KB | 0644 |
|
nseq.html | File | 3.26 KB | 0644 |
|
ocsp.html | File | 20.86 KB | 0644 |
|
openssl-asn1parse.html | File | 8.22 KB | 0644 |
|
openssl-c_rehash.html | File | 5.68 KB | 0644 |
|
openssl-ca.html | File | 30.91 KB | 0644 |
|
openssl-ciphers.html | File | 35.11 KB | 0644 |
|
openssl-cms.html | File | 29.84 KB | 0644 |
|
openssl-crl.html | File | 4.7 KB | 0644 |
|
openssl-crl2pkcs7.html | File | 4.21 KB | 0644 |
|
openssl-dgst.html | File | 8.82 KB | 0644 |
|
openssl-dhparam.html | File | 6.21 KB | 0644 |
|
openssl-dsa.html | File | 7.03 KB | 0644 |
|
openssl-dsaparam.html | File | 4.9 KB | 0644 |
|
openssl-ec.html | File | 7.88 KB | 0644 |
|
openssl-ecparam.html | File | 7.13 KB | 0644 |
|
openssl-enc.html | File | 16.6 KB | 0644 |
|
openssl-engine.html | File | 4.27 KB | 0644 |
|
openssl-errstr.html | File | 1.88 KB | 0644 |
|
openssl-gendsa.html | File | 4.03 KB | 0644 |
|
openssl-genpkey.html | File | 13.78 KB | 0644 |
|
openssl-genrsa.html | File | 5.15 KB | 0644 |
|
openssl-list.html | File | 3.4 KB | 0644 |
|
openssl-nseq.html | File | 3.26 KB | 0644 |
|
openssl-ocsp.html | File | 20.86 KB | 0644 |
|
openssl-passwd.html | File | 4.26 KB | 0644 |
|
openssl-pkcs12.html | File | 15.5 KB | 0644 |
|
openssl-pkcs7.html | File | 4.21 KB | 0644 |
|
openssl-pkcs8.html | File | 13.2 KB | 0644 |
|
openssl-pkey.html | File | 6.19 KB | 0644 |
|
openssl-pkeyparam.html | File | 3.38 KB | 0644 |
|
openssl-pkeyutl.html | File | 13.81 KB | 0644 |
|
openssl-prime.html | File | 2.31 KB | 0644 |
|
openssl-rand.html | File | 3.86 KB | 0644 |
|
openssl-rehash.html | File | 5.68 KB | 0644 |
|
openssl-req.html | File | 28.08 KB | 0644 |
|
openssl-rsa.html | File | 7.74 KB | 0644 |
|
openssl-rsautl.html | File | 7.86 KB | 0644 |
|
openssl-s_client.html | File | 34.65 KB | 0644 |
|
openssl-s_server.html | File | 32.71 KB | 0644 |
|
openssl-s_time.html | File | 9.5 KB | 0644 |
|
openssl-sess_id.html | File | 5.98 KB | 0644 |
|
openssl-smime.html | File | 20.73 KB | 0644 |
|
openssl-speed.html | File | 3.96 KB | 0644 |
|
openssl-spkac.html | File | 5.62 KB | 0644 |
|
openssl-srp.html | File | 2.69 KB | 0644 |
|
openssl-storeutl.html | File | 4.63 KB | 0644 |
|
openssl-ts.html | File | 26.59 KB | 0644 |
|
openssl-tsget.html | File | 8.28 KB | 0644 |
|
openssl-verify.html | File | 31.84 KB | 0644 |
|
openssl-version.html | File | 2.34 KB | 0644 |
|
openssl-x509.html | File | 36.53 KB | 0644 |
|
openssl.html | File | 21.01 KB | 0644 |
|
passwd.html | File | 4.26 KB | 0644 |
|
pkcs12.html | File | 15.5 KB | 0644 |
|
pkcs7.html | File | 4.21 KB | 0644 |
|
pkcs8.html | File | 13.2 KB | 0644 |
|
pkey.html | File | 6.19 KB | 0644 |
|
pkeyparam.html | File | 3.38 KB | 0644 |
|
pkeyutl.html | File | 13.81 KB | 0644 |
|
prime.html | File | 2.31 KB | 0644 |
|
rand.html | File | 3.86 KB | 0644 |
|
rehash.html | File | 5.68 KB | 0644 |
|
req.html | File | 28.08 KB | 0644 |
|
rsa.html | File | 7.74 KB | 0644 |
|
rsautl.html | File | 7.86 KB | 0644 |
|
s_client.html | File | 34.65 KB | 0644 |
|
s_server.html | File | 32.71 KB | 0644 |
|
s_time.html | File | 9.5 KB | 0644 |
|
sess_id.html | File | 5.98 KB | 0644 |
|
smime.html | File | 20.73 KB | 0644 |
|
speed.html | File | 3.96 KB | 0644 |
|
spkac.html | File | 5.62 KB | 0644 |
|
srp.html | File | 2.69 KB | 0644 |
|
storeutl.html | File | 4.63 KB | 0644 |
|
ts.html | File | 26.59 KB | 0644 |
|
tsget.html | File | 8.28 KB | 0644 |
|
verify.html | File | 31.84 KB | 0644 |
|
version.html | File | 2.34 KB | 0644 |
|
x509.html | File | 36.53 KB | 0644 |
|