.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH OTFAUX "1" "March 2024" "otfaux 1.12.5" "User Commands"
.SH NAME
otfaux \- Append snapshots and statistics to an OTF trace
.SH DESCRIPTION
.IP
otfaux \- Append snapshots and statistics to an existing OTF trace
.IP
at given 'break' time stamps.
.IP
Syntax: otfaux [options] <input file name>
.IP
options:
.TP
\fB\-h\fR, \fB\-\-help\fR
show this help message
.TP
\fB\-V\fR
show OTF version
.TP
\fB\-b\fR <size>
buffer size for read and write operations
.TP
\fB\-n\fR <n>
number of breaks (distributed regularly)
if \fB\-p\fR and \fB\-t\fR are not set, the default for \fB\-n\fR is 200
breaks
.TP
\fB\-p\fR <p>
create break every 'p' ticks
(if both, \fB\-n\fR and \fB\-p\fR are specified the one producing
more breaks wins)
.TP
\fB\-t\fR <t>
define (additional) break at given time stamp
.TP
\fB\-F\fR
force overwrite old snapshots and statistics
.TP
\fB\-R\fR
delete existing snapshots and statistics only
.TP
\fB\-f\fR <n>
max number of filehandles output
.TP
\fB\-\-funcgroups\fR
create functiongroup summaries instead of
function summaries
.TP
\fB\-\-filegroups\fR
create file group summaries instead of file
summaries
.TP
\fB\-v\fR
verbose mode, print break time stamps
.TP
\fB\-a\fR
show advancing progress during operation
.HP
\fB\-o\fR <namestub> makes a copy of the input trace
.TP
\fB\-\-thumbnail\-procs\fR <n>
upper bound for the number of processes in the
thumbnail
.TP
\fB\-\-thumbnail\-samples\fR <n>
upper bound for the number of sampling points in the
thumbnail
.TP
\fB\-\-inline\-snapshots\fR
produces inline snapshots
(requires the \fB\-o\fR option)
.TP
\fB\-\-match\-messages\fR
attach receive time information to send events
(requires the \fB\-o\fR option)
.TP
\fB\-\-snapshots\fR
write snapshots and a thumbnail but NO statistics
(default mode)
.TP
\fB\-\-thumbnail\fR
write ONLY a thumbnail
.TP
\fB\-\-statistics\fR
write ONLY statistics but NO snapshots or a thumbnail
.TP
\fB\-\-all\fR
write snapshots, a thumbnail, and statistics
.TP
\fB\-s\fR a[,b]*
regard given streams only when computing statistics.
expects a single token or comma separated list.
this implies the '\-\-statistics' option!
.TP
\fB\-l\fR
list existing stream tokens