seivot man page

seivot ā€” benchmark backup application (obnam)


seivot [--benchmark-fsck] [--no-benchmark-fsck] [--config=FILE] [--dump-config] [--dump-setting-names] [--generate-manpage=TEMPLATE] [-h] [--help] [--help-all] [--list-config-files] [--version] [--no-default-configs] [--description=TEXT] [--drop-caches] [--no-drop-caches] [--dump-memory-profile=METHOD] [--encrypt-with=KEYID] [--file-size=SIZE] [--generations=COUNT] [--incremental-data=SIZE] [--initial-data=SIZE] [--larch-branch=LARCH-BRANCH] [--log=FILE] [--log-keep=N] [--log-level=LEVEL] [--log-max=SIZE] [--log-mode=MODE] [--memory-dump-interval=SECONDS] [--obnam-branch=OBNAM-BRANCH] [--obnam-config=FILE] [--obnam-profile=NAMEPATTERN] [--output=FILE] [--profile-name=PROFILE-NAME] [--program=PROGRAM] [--sftp-delay=SFTP-DELAY] [--use-existing=DIR] [--use-sftp-repository] [--no-use-sftp-repository] [--use-sftp-root] [--no-use-sftp-root] [--verify] [--no-verify] [FILE]...


seivot benchmarks a backup application. It has been written primarily for obnam(1), but could be extended for other backup applications.

seivot generates some live data using genbackupdata(1), and then runs the backup application. It then generates some more live data, and runs a second backup generation, etc. It stores the measurements in an output file. See seivots-summary(1) for a tool to show data from such files in a tabular fashion. (seivot does not itself show the tabular data, because one is rarely interested in the output from just one run, and instead wants to contrast it with other runs).



benchmark fsck?


opposite of --benchmark-fsck


free-form description of this backup run


clear Linux kernel cache before running commands (will ask for sudo pasword


opposite of --drop-caches


encrypt backups with KEYID


size of files to create


fill in manual page TEMPLATE


total number of generations to measure (5)

-h, --help

show this help message and exit


add SIZE live data for additional generations (1024)


size of initial live data (1024)


bzr branch from which to use larch (default is installed larch)


bzr branch from which to run obnam (default is installed obnam)


use FILE as an Obnam configuration file


store Python profiling output in files named after NAMEPATTERN (no profiling, unless set); %(foo)s in pattern gets filled in, where foo is op (for backup/restore/etc), gen, or order (cumulative/time)


write output to FILE, instead of standard output


name of backup use-case profile name (for documentation purposes only)


program to benchmark (obnam)


add an artificial delay (in milliseconds) to all SFTP transfers


use exiting DIR for initial generation


access backup repository over the network via sftp


opposite of --use-sftp-repository


access backup repository over the network via sftp


opposite of --use-sftp-root


verify restored data


opposite of --verify


show program's version number and exit

Configuration files and settings


add FILE to config files


write out the entire current configuration


write out all names of settings and quit


show all options


list all possible config files


clear list of configuration files to read



write log entries to FILE (default is to not write log files at all); use "syslog" to log to system log, "stderr" to log to the standard error output, or "none" to disable logging


keep last N logs (10)


log at LEVEL, one of debug, info, warning, error, critical, fatal (default: debug)


rotate logs larger than SIZE, zero for never (default: 0)


set permissions of new log files to MODE (octal; default 0600)



make memory profiling dumps using METHOD, which is one of: none, simple, or meliae (default: simple)


make memory profiling dumps at least SECONDS apart


To run a simple benchmark:

seivot --initial-data=10G --incremental-data=1G

See Also

seivots-summary(1), obnam(1).

Referenced By