aboutsummaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authorMattias Andrée <maandree@kth.se>2021-02-22 17:21:00 +0100
committerMattias Andrée <maandree@kth.se>2021-02-22 17:21:00 +0100
commit11f472ebf60f147789f47372b440337b6544bc28 (patch)
tree417a334a1ca70f9ed4ff28d7a67278e14e6e26cb /README
parentchange license + misc (diff)
downloadkrandom-11f472ebf60f147789f47372b440337b6544bc28.tar.gz
krandom-11f472ebf60f147789f47372b440337b6544bc28.tar.bz2
krandom-11f472ebf60f147789f47372b440337b6544bc28.tar.xz
Update README and remove info manual
Signed-off-by: Mattias Andrée <maandree@kth.se>
Diffstat (limited to '')
-rw-r--r--README53
1 files changed, 40 insertions, 13 deletions
diff --git a/README b/README
index e781cbf..75ea60f 100644
--- a/README
+++ b/README
@@ -1,18 +1,45 @@
-Keccak-based userspace pseudorandom number generator.
+NAME
+ krandom - Keccak-based userspace pseudorandom number generator
-With the default parameters, krandom is about twice
-as fast as Linux's /dev/urandom. And it's tunable!
+SYNOPSIS
+ krandom [-C capacity] [-N output-size] [-R rate] [-S state-size] [-W word-size] [-v]
+DESCRIPTION
+ krandom create a Keccak sponge with a random state
+ and continually squeezes it to generate pseudorandom
+ binary data.
-Can krandom be used as an entropy-generator?
+ Like yes(1), krandom will automatically pause soon
+ after the other end of the standard output pipe stops
+ reading and will terminate with no process reading
+ at the other end of the standard output pipe anymore.
- Basically, no. The only less effective way
- to generate entropy is to print /dev/urandom.
- Good ways to generate entropy include:
- Typing randomly in the terminal
- Moving the rat pointer around erratically
- Run ping
- Listen to music
- Watch videos
- Run ponysay (surprisingly effective)
+ With the default parameters, krandom is about twice
+ as fast as Linux's /dev/urandom. And it's tunable!
+OPTIONS
+ -C capacity
+ Select Keccak capacity.
+
+ -R rate
+ Select Keccak rate.
+
+ -N output-size
+ Select Keccak output size. This is the size
+ of a squeezed block, the total output is
+ unlimited.
+
+ -S state-size
+ Select Keccak state size.
+
+ -W state-size
+ Select Keccak word size.
+
+ -v
+ Print extra informatio.
+
+NOTES
+ krandom is a terrible entropy-generator. Good ways
+ to generate entropy include: typing randomly in the
+ terminal, moving the rat pointer around erratically,
+ running ping, listening to music, and watching videos.