projects / thirdparty / openssl.git / blame
| Commit | Line | Data |
|---|---|---|
| 55f7d65d BM |
1 | =pod |
| 2 | ||
| 3 | =head1 NAME | |
| 4 | ||
| 5 | rand - generate pseudo-random bytes | |
| 6 | ||
| 7 | =head1 SYNOPSIS | |
| 8 | ||
| 9 | B<openssl rand> | |
| 10 | [B<-out> I<file>] | |
| 41918458 | 11 | [B<-rand> I<file(s)>] |
| 55f7d65d BM |
12 | [B<-base64>] |
| 13 | I<num> | |
| 14 | ||
| 15 | =head1 DESCRIPTION | |
| 16 | ||
| 17 | The B<rand> command outputs I<num> pseudo-random bytes after seeding | |
| 18 | the random number generater once. As in other B<openssl> command | |
| 19 | line tools, PRNG seeding uses the file I<$HOME/>B<.rnd> or B<.rnd> | |
| 20 | in addition to the files given in the B<-rand> option. A new | |
| 21 | I<$HOME>/B<.rnd> or B<.rnd> file will be written back if enough | |
| 22 | seeding was obtained from these sources. | |
| 23 | ||
| 24 | =head1 OPTIONS | |
| 25 | ||
| 26 | =over 4 | |
| 27 | ||
| 28 | =item B<-out> I<file> | |
| 29 | ||
| 30 | Write to I<file> instead of standard output. | |
| 31 | ||
| 32 | =item B<-rand> I<file(s)> | |
| 33 | ||
| 34 | Use specified file or files or EGD socket (see L<RAND_egd(3)|RAND_egd(3)>) | |
| 35 | for seeding the random number generator. | |
| 36 | Multiple files can be specified separated by a OS-dependent character. | |
| b87ef946 | 37 | The separator is B<;> for MS-Windows, B<,> for OpenVMS, and B<:> for |
| 55f7d65d BM |
38 | all others. |
| 39 | ||
| 40 | =item B<-base64> | |
| 41 | ||
| 42 | Perform base64 encoding on the output. | |
| 43 | ||
| 44 | =back | |
| 45 | ||
| afbd0746 BM |
46 | =head1 SEE ALSO |
| 47 | ||
| 48 | L<RAND_bytes(3)|RAND_bytes(3)> | |
| 49 | ||
| 55f7d65d | 50 | =cut |