From: Bodo Möller <bodo@openssl.org>
Date: Wed, 1 Mar 2000 07:57:25 +0000 (+0000)
Subject: Document the 'rand' application.
X-Git-Tag: OpenSSL_0_9_5a-beta1~133
X-Git-Url: https://git.openssl.org/gitweb/?p=openssl.git;a=commitdiff_plain;h=55f7d65db088b7ba78dbf54daee771b130157d6b

Document the 'rand' application.
---

diff --git a/CHANGES b/CHANGES
index b1b4ee1166..2ce2d74800 100644
--- a/CHANGES
+++ b/CHANGES
@@ -4,6 +4,9 @@
 
  Changes between 0.9.5 and 0.9.6  [XX XXX 2000]
 
+  *) New 'rand' application for creating pseudo-random output.
+     [Bodo Moeller]
+
   *) Added configuration support for Linux/IA64
      [Rolf Haberrecker <rolf@suse.de>]
 
diff --git a/apps/app_rand.c b/apps/app_rand.c
index 26289e4349..64531df812 100644
--- a/apps/app_rand.c
+++ b/apps/app_rand.c
@@ -176,7 +176,7 @@ long app_RAND_load_files(char *name)
 		name=p+1;
 		if (*n == '\0') break;
 
-        egd=RAND_egd(n);
+		egd=RAND_egd(n);
 		if (egd > 0) tot+=egd;
 		tot+=RAND_load_file(n,1024L*1024L);
 		if (last) break;
diff --git a/doc/apps/rand.pod b/doc/apps/rand.pod
new file mode 100644
index 0000000000..4babf4e5ad
--- /dev/null
+++ b/doc/apps/rand.pod
@@ -0,0 +1,46 @@
+=pod
+
+=head1 NAME
+
+rand - generate pseudo-random bytes
+
+=head1 SYNOPSIS
+
+B<openssl rand>
+[B<-out> I<file>]
+[B<-rand> I<file(s)>
+[B<-base64>]
+I<num>
+
+=head1 DESCRIPTION
+
+The B<rand> command outputs I<num> pseudo-random bytes after seeding
+the random number generater once.  As in other B<openssl> command
+line tools, PRNG seeding uses the file I<$HOME/>B<.rnd> or B<.rnd>
+in addition to the files given in the B<-rand> option.  A new
+I<$HOME>/B<.rnd> or B<.rnd> file will be written back if enough
+seeding was obtained from these sources.
+
+=head1 OPTIONS
+
+=over 4
+
+=item B<-out> I<file>
+
+Write to I<file> instead of standard output.
+
+=item B<-rand> I<file(s)>
+
+Use specified file or files or EGD socket (see L<RAND_egd(3)|RAND_egd(3)>)
+for seeding the random number generator.
+Multiple files can be specified separated by a OS-dependent character.
+The separator is B<;> for MS-Windows, B<,> for OpenVSM, and B<:> for
+all others.
+
+=item B<-base64>
+
+Perform base64 encoding on the output.
+
+=back
+
+=cut