xref: /onnv-gate/usr/src/common/openssl/doc/apps/rand.pod (revision 2175:b0b2f052a486)
1*2175Sjp161948=pod
2*2175Sjp161948
3*2175Sjp161948=head1 NAME
4*2175Sjp161948
5*2175Sjp161948rand - generate pseudo-random bytes
6*2175Sjp161948
7*2175Sjp161948=head1 SYNOPSIS
8*2175Sjp161948
9*2175Sjp161948B<openssl rand>
10*2175Sjp161948[B<-out> I<file>]
11*2175Sjp161948[B<-rand> I<file(s)>]
12*2175Sjp161948[B<-base64>]
13*2175Sjp161948I<num>
14*2175Sjp161948
15*2175Sjp161948=head1 DESCRIPTION
16*2175Sjp161948
17*2175Sjp161948The B<rand> command outputs I<num> pseudo-random bytes after seeding
18*2175Sjp161948the random number generator once.  As in other B<openssl> command
19*2175Sjp161948line tools, PRNG seeding uses the file I<$HOME/>B<.rnd> or B<.rnd>
20*2175Sjp161948in addition to the files given in the B<-rand> option.  A new
21*2175Sjp161948I<$HOME>/B<.rnd> or B<.rnd> file will be written back if enough
22*2175Sjp161948seeding was obtained from these sources.
23*2175Sjp161948
24*2175Sjp161948=head1 OPTIONS
25*2175Sjp161948
26*2175Sjp161948=over 4
27*2175Sjp161948
28*2175Sjp161948=item B<-out> I<file>
29*2175Sjp161948
30*2175Sjp161948Write to I<file> instead of standard output.
31*2175Sjp161948
32*2175Sjp161948=item B<-rand> I<file(s)>
33*2175Sjp161948
34*2175Sjp161948Use specified file or files or EGD socket (see L<RAND_egd(3)|RAND_egd(3)>)
35*2175Sjp161948for seeding the random number generator.
36*2175Sjp161948Multiple files can be specified separated by a OS-dependent character.
37*2175Sjp161948The separator is B<;> for MS-Windows, B<,> for OpenVMS, and B<:> for
38*2175Sjp161948all others.
39*2175Sjp161948
40*2175Sjp161948=item B<-base64>
41*2175Sjp161948
42*2175Sjp161948Perform base64 encoding on the output.
43*2175Sjp161948
44*2175Sjp161948=back
45*2175Sjp161948
46*2175Sjp161948=head1 SEE ALSO
47*2175Sjp161948
48*2175Sjp161948L<RAND_bytes(3)|RAND_bytes(3)>
49*2175Sjp161948
50*2175Sjp161948=cut
51