randpup.git

randpup - ngram text generator kernel module
============================================
randpup generates random text based on supplied samples using a
cryptographically secure ngram text generator.  randpup can be built either as a
character device kernel module (where text is generated by reading /dev/randpup)
or as a userspace program (where text is generated by running `randpup').

randpup was inspired by uwurandom, written by valadaptive and available at
<https://github.com/valadaptive/uwurandom>.

requirements
------------
randpup requires the linux kernel headers in order to build the kernel module.
linux kernel headers are not required when building only the userspace program.

installation
------------
randpup comes with a Makefile and a config.mk file for building.  edit the
config.mk file to match your local setup (`randpup' is installed into the
/usr/local namespace by default; you may need to modify your $PATH environment
variable).

randpup can be built and installed with the following command (run as root):

    make install

configuration
-------------
the tables used by randpup in ngram text generation and other text generation
are generated by the ngram.py file.  editing the text samples will generate
different tables, resulting in different typical text output.  the default
sample is designed to imitate a dog speaking.