From 11f472ebf60f147789f47372b440337b6544bc28 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Mon, 22 Feb 2021 17:21:00 +0100 Subject: Update README and remove info manual MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- README | 53 ++++++++++++++++++++++++++++++++++++++++------------- 1 file changed, 40 insertions(+), 13 deletions(-) (limited to 'README') 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. -- cgit v1.2.3-70-g09d2