DADUM(1) General Commands Manual
NAME
dadum — Tool for dumping mass data (“[da]ta-[dum]per”) by pattern to files or streams.
SYNOPSIS
| dadum | -s <size> [ { --rnd-bytes | --rnd-text [ --rnd-text-mode <rndTextMode> ] | -b <bytes> | -t <text> } ] [ -o <outputFile> [ -v ] ] [ --unit <sizeUnit> ] |
| dadum | -h | --sysinfo [ -v ] |
DESCRIPTION
This manual page documents the dadum command: The dadum command dumps random
bytes --rnd-bytes or random text --rnd-text (with the according random text
mode --rnd-text-mode) or data of recurring bytes --bytes or recurring text
--text pattern of a given size --size (and unit --unit) to a file --output-file
or STDOUT.
Depending on the executable’s flavor the command might also be named dadum-x.y.z.jar, dadum-bundle-x86_64-x.y.z.elf, dadum-bundle-x86_64-x.y.z.exe, dadum-installer-x86_64-x.y.z.msi, dadum-launcher-x.y.z.sh, dadum-launcher-x86_64-x.y.z.elf, dadum-launcher-x86_64-x.y.z.exe, dadum-native-x86_64-x.y.z.elf where x.y.z stands for the version of the dadum command. The according executable’s name will be referenced to in this manual as dadum.
OPTIONS
| -b --bytes <bytes>: | The message in bytes (e.g. "127, 128, 0x10, 0xFF") which to process. |
| -h --help: | Shows this help. |
| -o --output-file <outputFile>: | The output file which to process to. |
| --rnd-bytes: | Use random bytes for generating binary output. |
| --rnd-text: | Use random text for generating text output. |
| --rnd-text-mode <rndTextMode>: | The random text mode for generating random text output: { ASCII, ALPHABETIC, UPPER_CASE, LOWER_CASE, ALPHANUMERIC, UPPER_CASE_ALPHANUMERIC, LOWER_CASE_ALPHANUMERIC, NUMERIC, BINARY, HEXADECIMAL } |
| -s --size <size>: | The size of the data to be dumped (can be an expression such as "640 * 480", a value of ∞ or -1 will bomb your storage). |
| --sysinfo: | Shows some system information for debugging purposes |
| -t --text <text>: | The text message which to process. |
| --unit <sizeUnit>: | The memory unit to use when calculating the size: { BYTE, KILOBYTE, MEGABYTE, GIGABYTE, TERABYTE, PETABYTE, EXABYTE, ZETTABYTE, YOTTABYTE } |
| -v --verbose: | Enables the verbose mode with additional (human readable) informational output. |
EXAMPLES
Dump random binary data to a file:
- dadum -s <size> --rnd-bytes -o <outputFile> -v
Dump random text data to a file:
- dadum -s <size> --rnd-text -o <outputFile> -v
Dump random text data using specified charset to a file:
- dadum -s <size> --rnd-text --rnd-text-mode <rndTextMode> -o <outputFile> -v
Dump binary data using specified bytes (repeatedly) to a file:
- dadum -s <size> -b <bytes> -o <outputFile> -v
Dump text data using specified text (repeatedly) to a file:
- dadum -s <size> -t <text> -o <outputFile> -v
Dump random binary data to STDOUT:
- dadum -s <size> --rnd-bytes -v
Dump random text data to STDOUT:
- dadum -s <size> --rnd-text -v
Dump random text data using specified charset to STDOUT:
- dadum -s <size> --rnd-text --rnd-text-mode <rndTextMode> -v
Dump binary data using specified bytes (repeatedly) to STDOUT:
- dadum -s <size> -b <bytes> -v
Dump text data using specified text (repeatedly) to STDOUT:
- dadum -s <size> -t <text> -v
To show the help text:
- dadum -h
To print the system info:
- dadum --sysinfo
BUGS
See BitBucket issues at <https://bitbucket.org/funcodez/funcodes-dadum/issues>
AUTHOR
Siegfried Steiner steiner@refcodes.org