From d3fbede455b02915bf7bcf673ff18bcdcfb2b4c7 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Wed, 3 Dec 2014 11:18:18 +0100 Subject: info manual MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- info/krandom.texinfo | 59 ++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 57 insertions(+), 2 deletions(-) (limited to 'info/krandom.texinfo') diff --git a/info/krandom.texinfo b/info/krandom.texinfo index aab77e6..add03ce 100644 --- a/info/krandom.texinfo +++ b/info/krandom.texinfo @@ -61,14 +61,69 @@ Texts. A copy of the license is included in the section entitled @node Overview @chapter Overview -TODO +@command{krandom} is a tunable userspace pseudorandom number generator +based on the Keccak hash-algorithm. + +With @command{krandom} default parameters it is about twice as fast +as Linux's @file{/dev/urandom}, but it's performance can be tuned +both up and down. + +@command{krandom} creates a Keccak sponge and initialises its state +@footnote{(25 @command{int_fast64_t}:s)} with random data from +@file{/dev/urandom}. This simulate it absorption phase of Keccak +from a random message. It then performance the squeezing phase +continuously until the standard output pipe breaks, that is, +when the program it pipes into exits or closes standard input. + +On a more technical level, @command{krandom} will pause automatically +if the other program does not read its input, and resume when it does. +This is because the pipe will become full and block writting for +@command{krandom}. @node Invoking @chapter Invoking -TODO +@command{krandom} recognises the following options: + +@table @option +@item -h +@itemx --help +Display a summary of options. + +@item -v +@itemx --verbose +Print extra information. + +@item -R +@itemx --bitrate +@itemx --rate RATE +Change the rate. + +@item -C +@itemx --capacity CAPACITY +Change the capacity. + +@item -N +@itemx -O +@itemx --output-size +@itemx --output SIZE +Change the output size. +This is the size of a squeezed block, +the total output is unlimited. + +@item -S +@itemx -B +@itemx --state-size +@itemx --state SIZE +Change the state size. + +@item -W +@itemx --word-size +@itemx --word SIZE +Change the word size. +@end table -- cgit v1.2.3-70-g09d2