tfnoisegen/README

50 lines
1.4 KiB
Plaintext

Threefish cipher based raw PRN/noise generator.
PURPOSE
This PRNG is shortened, 32 bit integer version of Threefish-256 block cipher.
It is technically a 128 bit block cipher with 256 bit key.
It's purpose is to generate fillers fast, for use in file or disk shredders.
It is not meant to be secure, i.e. collision/bias free, but it is good at
generating random noise equal to average output of /dev/urandom, yet much faster.
Typical performance on Athlon 5000+, x86-32 is about 170M/sec.
Included tfrand program generates random noise to stdout.
USAGE
Build example:
make tfrand
Test it:
./tfrand >rng.out
Measure performance (install tfcrypt first):
./tfrand | tfcrypt -V.5 -P - /dev/null
Use libtfng.a library in your code, see headers for function references:
tfe.h: STREAM reference.
tfprng.h: PRNG reference.
When building together with code which uses tfcipher library, please put
both tfcipher and tfnoisegen code in separate locations, and do not include
headers which are used privately by both implementations! Only public headers
and libtfng.a library externals are guaranteed to be namespace clean.
File names and private headers definitions are mostly same.
WARNING
Do NOT use it as cipher! It's just a random block generator.
You have been warned.
ORIGIN
This code is derived from tfcipher library.
LICENSE
Public domain -- free to reuse and adapt.
AUTHOR
Andrey Rys <rys@lynxlynx.ru>, 17Mar2019.