Provided by: genbackupdata_1.6-1_all 
NAME
genbackupdata - generate backup test data
SYNOPSIS
genbackupdata [--chunk-size=SIZE] [--config=FILE] [-c=SIZE] [--create=SIZE] [--depth=DEPTH]
[--dump-config] [--dump-memory-profile=METHOD] [--dump-setting-names] [--file-size=SIZE]
[--generate-manpage=TEMPLATE] [-h] [--help] [--list-config-files] [--log=FILE] [--log-keep=N]
[--log-level=LEVEL] [--log-max=SIZE] [--max-files=MAX-FILES] [--no-default-configs] [--output=FILE]
[--quiet] [--seed=SEED] [--version] [FILE]...
DESCRIPTION
genbackupdata generates test data sets for performance testing of backup software. It creates a
directory tree filled with files of different sizes. The total size and the distribution of sizes
between small and big are configurable. The program can also modify an existing directory tree by
creating new files, and deleting, renaming, or modifying existing files. This can be used to generate
test data for successive generations of backups.
The program is deterministic: with a given set of parameters (and a given pre-existing directory tree),
it always creates the same output. This way, it is possible to reproduce backup tests exactly, without
having to distribute the potentially very large test sets.
The data set consists of plain files and directories. Files are either small text files or big binary
files. Text files contain the "lorem ipsum" stanza, binary files contain randomly generated byte
streams. The percentage of file data that is small text or big binary files can be set, as can the sizes
of the respective file types.
Files and directories are named "fileXXXX" or "dirXXXX", where "XXXX" is a successive integer, separate
successions for files and directories. There is an upper limit to how many files a directory may
contain. After the file limit is reached, a new sub-directory is created. The first set of files go
into the root directory of the test set.
You have to give one of the options --create, --delete, --rename, or --modify for the program to do
anything. You can, however, give more than one of them, if DIR already exists. (Giving the same option
more than once means that only the last instance is counted.) (DIR) is created if it doesn't exist
already.
OPTIONS
--chunk-size=SIZE
generate data in chunks of this size (default: 16384)
--config=FILE
add FILE to config files
-c, --create=SIZE
how much data to create (default: 0)
--depth=DEPTH
depth of directory tree (default: 3)
--dump-config
write out the entire current configuration
--dump-memory-profile=METHOD
make memory profiling dumps using METHOD, which is one of: none, simple, meliae, or heapy
(default: simple)
--dump-setting-names
write out all names of settings and quit
--file-size=SIZE
size of one file (default: 16384)
--generate-manpage=TEMPLATE
fill in manual page TEMPLATE
-h, --help
show this help message and exit
--list-config-files
list all possible config files
--log=FILE
write log entries to FILE (default is to not write log files at all)
--log-keep=N
keep last N logs (10)
--log-level=LEVEL
log at LEVEL, one of debug, info, warning, error, critical, fatal (default: debug)
--log-max=SIZE
rotate logs larger than SIZE, zero for never (default: 0)
--max-files=MAX-FILES
max files/dirs per dir (default: 128)
--no-default-configs
clear list of configuration files to read
--output=FILE
write output to FILE, instead of standard output
--quiet
do not report progress
--seed=SEED
seed for random number generator (default: 0)
--version
show program's version number and exit
EXAMPLES
Create data for the first generation of a backup:
genbackupdata --create=10G testdir
Modify an existing set of backup data to create a new generation:
genbackupdata -c 5% -d 2% -m 5% -r 0.5% testdir
The above command can be run for each new generation.
GENBACKUPDATA(1)