1SEIVOTS-SUMMARY(1) General Commands Manual SEIVOTS-SUMMARY(1)
2
3
4
6 seivots-summary - summarize seivot output files
7
9 seivots-summary [--config=FILE] [--dump-config] [--dump-setting-names]
10 [--generate-manpage=TEMPLATE] [-h] [--help] [--help-all]
11 [--list-config-files] [--version] [--no-default-configs]
12 [--dump-memory-profile=METHOD] [--log=FILE] [--log-keep=N]
13 [--log-level=LEVEL] [--log-max=SIZE] [--log-mode=MODE]
14 [--memory-dump-interval=SECONDS] [--output=FILE] [FILE]...
15
17 seivots-summary reads some benchmark result files created by sum‐
18 main(1), and produces summaries of them in tabular form, making it easy
19 to compare results from different benchmark runs.
20
22 --generate-manpage=TEMPLATE
23 fill in manual page TEMPLATE
24
25 -h, --help
26 show this help message and exit
27
28 --output=FILE
29 write output to FILE, instead of standard output
30
31 --version
32 show program's version number and exit
33
34 Configuration files and settings
35 --config=FILE
36 add FILE to config files
37
38 --dump-config
39 write out the entire current configuration
40
41 --dump-setting-names
42 write out all names of settings and quit
43
44 --help-all
45 show all options
46
47 --list-config-files
48 list all possible config files
49
50 --no-default-configs
51 clear list of configuration files to read
52
53 Logging
54 --log=FILE
55 write log entries to FILE (default is to not write log files at
56 all); use "syslog" to log to system log, "stderr" to log to the
57 standard error output, or "none" to disable logging
58
59 --log-keep=N
60 keep last N logs (10)
61
62 --log-level=LEVEL
63 log at LEVEL, one of debug, info, warning, error, critical, fa‐
64 tal (default: debug)
65
66 --log-max=SIZE
67 rotate logs larger than SIZE, zero for never (default: 0)
68
69 --log-mode=MODE
70 set permissions of new log files to MODE (octal; default 0600)
71
72 Peformance
73 --dump-memory-profile=METHOD
74 make memory profiling dumps using METHOD, which is one of: none,
75 simple, or meliae (default: simple)
76
77 --memory-dump-interval=SECONDS
78 make memory profiling dumps at least SECONDS apart
79
81 To summarize all benchmark files:
82
83 seivots-summary $HOME/obnam/benchmarks/*/*.seivot | less -S
84
86 seivot(1), obnam(1).
87
88
89
90 SEIVOTS-SUMMARY(1)