diff options
author | Rich Salz <rsalz@openssl.org> | 2017-07-05 10:58:48 -0400 |
---|---|---|
committer | Rich Salz <rsalz@openssl.org> | 2017-07-16 19:20:45 -0400 |
commit | 3ee1eac27a2e3120fbdc60e12db091c082b8de21 (patch) | |
tree | c34ee07aa725e2019dbce1f7621702eb2bb5fd69 /doc/man1/rand.pod | |
parent | e90fc053c33a2241004451cfdeecfbf3cbdeb728 (diff) |
Standardize apps use of -rand, etc.
Standardized the -rand flag and added a new one:
-rand file...
Always reads the specified files
-writerand file
Always writes to the file on exit
For apps that use a config file, the RANDFILE config parameter reads
the file at startup (to seed the RNG) and write to it on exit if
the -writerand flag isn't used.
Ensured that every app that took -rand also took -writerand, and
made sure all of that agreed with all the documentation.
Fix error reporting in write_file and -rand
Reviewed-by: Paul Dale <paul.dale@oracle.com>
(Merged from https://github.com/openssl/openssl/pull/3862)
Diffstat (limited to 'doc/man1/rand.pod')
-rw-r--r-- | doc/man1/rand.pod | 16 |
1 files changed, 11 insertions, 5 deletions
diff --git a/doc/man1/rand.pod b/doc/man1/rand.pod index 0faf6872a2..22482033fc 100644 --- a/doc/man1/rand.pod +++ b/doc/man1/rand.pod @@ -9,7 +9,8 @@ rand - generate pseudo-random bytes B<openssl rand> [B<-help>] [B<-out> I<file>] -[B<-rand> I<file(s)>] +[B<-rand file...>] +[B<-writerand file>] [B<-base64>] [B<-hex>] I<num> @@ -31,18 +32,23 @@ seeding was obtained from these sources. Print out a usage message. -=item B<-out> I<file> +=item B<-out file> Write to I<file> instead of standard output. -=item B<-rand> I<file(s)> +=item B<-rand file...> -Use specified file or files or EGD socket (see L<RAND_egd(3)>) -for seeding the random number generator. +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<;> for MS-Windows, B<,> for OpenVMS, and B<:> for all others. +=item [B<-writerand file>] + +Writes random data to the specified I<file> upon exit. +This can be used with a subsequent B<-rand> flag. + =item B<-base64> Perform base64 encoding on the output. |