From f7d7c7ebe688113c7d1a42d6eaa25ef90e443efc Mon Sep 17 00:00:00 2001 From: Leah Neukirchen Date: Wed, 3 Jan 2018 18:59:35 +0100 Subject: use manpage as README --- README | 63 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 46 ---------------------------------------------- 2 files changed, 63 insertions(+), 46 deletions(-) create mode 100644 README delete mode 100644 README.md diff --git a/README b/README new file mode 100644 index 0000000..6276ba2 --- /dev/null +++ b/README @@ -0,0 +1,63 @@ +RDD(1) General Commands Manual RDD(1) + +NAME + rdd – random data dump + +SYNOPSIS + rdd [-i source] [-r rekeymb] [-v] + +DESCRIPTION + rdd is a high-speed, cryptographically safe random data generator using + the reference implementation of the eSTREAM Profile 1 SOSEMANUK stream + cipher. It is designed to fill crypto devices with random data. + + Random binary data is outputted to standard output. + + The options are as follows: + + -i source + Read key and IVs from source (default: /dev/urandom) + + -r rekeymb + Reload the IV every rekeymb megabytes of output (default: 4). + + -v Print a ‘.’ to standard error on every rekey. + +EXIT STATUS + The rdd utility exits 0 on success, and >0 if an error occurs. + +SEE ALSO + dd(1), random(4), random(7) + +NOTES + rdd reads 32 random bytes for the initial key and 16 bytes for every + rekeying from the random source. Setting rekeymb to -1 never rekeys. + + This implementation passed dieharder 3.31.1 "-a" and PractRand/RNG_test + 0.90 (tested up to 512 GB). + +AUTHORS + Leah Neukirchen + +LICENSE + rdd is in the public domain. + + To the extent possible under law, the creator of this work has waived all + copyright and related or neighboring rights to this work. + + http://creativecommons.org/publicdomain/zero/1.0/ + + This program includes code taken from + http://www.ecrypt.eu.org/stream/p3ciphers/sosemanuk/sosemanuk_p3source.zip + as of 2013-04-13. An error message which can never occur in rdd usage + has been #ifdef'ed out. + + © 2005 X-CRYPT project. This software is provided 'as-is', without any + express or implied warranty. In no event will the authors be held liable + for any damages arising from the use of this software. + + Permission is granted to anyone to use this software for any purpose, + including commercial applications, and to alter it and redistribute it + freely, subject to no restriction. + +Void Linux January 3, 2018 Void Linux diff --git a/README.md b/README.md deleted file mode 100644 index 75c1c92..0000000 --- a/README.md +++ /dev/null @@ -1,46 +0,0 @@ -# rdd - random data dump - -rdd is a high-speed, cryptographically safe random data generator -using the reference implementation of the eSTREAM Profile 1 SOSEMANUK -stream cipher. - -It is designed to fill crypto devices with random data. - -This implementation passed dieharder 3.31.1 "-a" and -PractRand/RNG_test 0.90 (tested up to 512 GB). - -## Usage - - rdd [-i SOURCE] [-r REKEYMB] [-v] - -i SOURCE read key and IVs from SOURCE (/dev/urandom) - -r REKEYMB reload the IV every REKEYMB megabytes of output (4) - -v print a . to stderr on every rekey - -Random binary data is outputted to stdout. Better don't put a -terminal there. -rdd reads 32 bytes for the initial key and 16 bytes for every rekeying -from the random source. Setting REKEYMB to -1 never rekeys. - -## Copyright - -### rdd.c: - -To the extent possible under law, Christian Neukirchen has waived -all copyright and related or neighboring rights to this work. - -http://creativecommons.org/publicdomain/zero/1.0/ - -### sosemanuk.[ch]: - -This program includes code taken from -http://www.ecrypt.eu.org/stream/p3ciphers/sosemanuk/sosemanuk_p3source.zip -as of 13mar2013. An error message which can never occur in rdd usage -has been #ifdef'ed out. - -(c) 2005 X-CRYPT project. This software is provided 'as-is', without -any express or implied warranty. In no event will the authors be held -liable for any damages arising from the use of this software. - -Permission is granted to anyone to use this software for any purpose, -including commercial applications, and to alter it and redistribute it -freely, subject to no restriction. -- cgit 1.4.1