From 430bda373361addf16962301b3afaf1b19ee9fc8 Mon Sep 17 00:00:00 2001
From: Pádraig Brady <P@draigBrady.com>
Date: Mon, 9 Feb 2015 20:58:47 +0000
Subject: 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.
---
 doc/coreutils.texi | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

(limited to 'doc')

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 87fb3dcb7..bb652aca5 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
-- 
cgit v1.2.3-70-g09d2