From: Pádraig Brady <P@draigBrady.com>
Date: Mon, 9 Feb 2015 20:58:47 +0000 (+0000)
Subject: doc: give an example of using a seed for random operations
X-Git-Tag: v8.24~125
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=430bda373361addf16962301b3afaf1b19ee9fc8;p=thirdparty%2Fcoreutils.git

doc: give an example of using a seed for random operations

* doc/coreutils.texi (Random sources):  Give an example using openssl,
generating a reproducible arbitrary amount of randomly distributed
data, given a seed value.
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 87fb3dcb79..bb652aca5f 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -1240,6 +1240,21 @@ operating system.
 To reproduce the results of an earlier invocation of a command, you
 can save some random data into a file and then use that file as the
 random source in earlier and later invocations of the command.
+@cindex random seed
+Rather than depending on a file, one can generate a reproducible
+arbitrary amount of pseudo-random data given a seed value, using
+for example:
+
+@example
+get_seeded_random()
+@{
+  seed="$1"
+  openssl enc -aes-256-ctr -pass pass:"$seed" -nosalt \
+    </dev/zero 2>/dev/null
+@}
+
+shuf -i1-100 --random-source=<(get_seeded_random 42)
+@end example
 
 @node Target directory
 @section Target directory