genRandom

Name

genRandom - generate (psudo-)random data using the various random number sources.

Description

genRandom generates (psudo-)random data using one of the following (pseudo-)random number sources:

1. ikmachine
   An infinite key (with respact to the plaintext) encryption machine.
2. jc1
   A Go implementation of the JC1 pseudo random byte generator by John C. Craig.
3. uberjc1
   A stack of 4 JC1 generators connected in series.

The generated output can be one of the following formats:

• a stream of random bytes
• a stream of ASCII '0' and '1' characters
• a stream of hexidecimal encoded bytes
• a series of X,Y coordinatges within a rectangle of a given size.

Usage:

  genRandom [command]```

Available Commands:

Global Flags:

      --config string       config file to use
      --count string        starting block count.
                            The count can be a number or a fraction such as "1/2", "2/3", or "3/4".  If
                            it is a fraction, then the starting block count is calculated by multiply-
                            ing the maximal blocks generated by the ikmachine by the fraction.  Sup-
                            plying a count will overide the  stored count in the configuration file, 
                            allowing for a repeatable stream of psuedo-random data by giving the same
                            secret key and starting block number.
  -h, --help                help for genRandom
  -o, --outputFile string   Name of the file containing the generated pseudo-random data. (default "-")
  -s, --source string       the source of the random data.  The sources available are:
                            	1. ikmachine - an infinite key (with respact to the plaintext) encryption
                            	               machine.
                            	2. jc1       - a Go implementation of the JC1 pseudo random byte 
                            	               generator by John C. Craig.
                            	3. uberjc1   - a stack of 4 JC1 generators connected in series.
  -v, --version             version for genRandom

Use "genRandom [command] --help" for more information about a command.

Commands:

binary

Generate a stream of (psudo)random ASCII '0' and '1' characters.

Usage:

  genRandom binary [flags]

Flags:

      --blocks=N string   Write N blocks. (default "1")
      --bs=BYTES string   Write up to BYTES bytes at a time.
                          N and BYTES may be followed by the following multiplicative suffixes: c=1,
                          w=2, b=512, K=1000, KB=1024, M=1000*1000, MB=1024*1024, G=1000*1000*1000,
                          GB=1024*1024*1024, and so on for T, P, E, Z, Y. (default "512")
  -h, --help              help for binary

completion

See each sub-command's help for details on how to use the generated script.

Usage:

  genRandom completion [command]

Available Commands:

Flags:

  -h, --help   help for completion

Use "genRandom completion [command] --help" for more information about a command.

data

Generate a stream of (psudo-)random bytes.

Usage:

  genRandom data [flags]

Flags:

      --blocks=N string   Write N blocks. (default "1")
      --bs=BYTES string   Write up to BYTES bytes at a time.
                          N and BYTES may be followed by the following multiplicative suffixes: c=1,
                          w=2, b=512, K=1000, KB=1024, M=1000*1000, MB=1024*1024, G=1000*1000*1000,
                          GB=1024*1024*1024, and so on for T, P, E, Z, Y. (default "512")
  -h, --help              help for data

help

Help provides help for any command in the application. Simply type genRandom help [path to command] for full details.

Usage:

  genRandom help [command] [flags]

Flags:

  -h, --help   help for help

hex

Generate a stream of (psudo)random hexadecimal encoded bytes.

Usage:

  genRandom hex [flags]

Flags:

      --blocks=N string   Write N blocks. (default "1")
      --bs=BYTES string   Write up to BYTES bytes at a time.
                          N and BYTES may be followed by the following multiplicative suffixes: c=1,
                          w=2, b=512, K=1000, KB=1024, M=1000*1000, MB=1024*1024, G=1000*1000*1000,
                          GB=1024*1024*1024, and so on for T, P, E, Z, Y. (default "512")
  -h, --help              help for hex

points

Generate a stream of (psudo)random hexadecimal encoded bytes.

Usage:

  genRandom hex [flags]

Flags:

      --blocks=N string   Write N blocks. (default "1")
      --bs=BYTES string   Write up to BYTES bytes at a time.
                          N and BYTES may be followed by the following multiplicative suffixes: c=1,
                          w=2, b=512, K=1000, KB=1024, M=1000*1000, MB=1024*1024, G=1000*1000*1000,
                          GB=1024*1024*1024, and so on for T, P, E, Z, Y. (default "512")
  -h, --help              help for hex

version

Display version and detailed build information for genRandom.

Usage:

  genRandom version [flags]

Flags:

  -h, --help   help for version

Notes

N and BYTES may be followed by the following multiplicative suffixes: c=1, w=2, b=512, kB=1000, K=1024, MB=1000*1000, M=1024*1024, GB=1000*1000*1000, G=1024*1024*1024, and so on for T, P, E, Z, Y.

The count can be a number (possibly followed by a multiplicative suffixes) or a fraction such as "1/2", "2/3", or "3/4". If it is a fraction, then the starting block count is calculated by multiplying the maximal blocks generated by the tntEngine by the fraction. Supplying a count will overide the stored count in the .genRand file, allowing for a repeatable stream of psuedo random data by giving the same secret key and starting block number.