 |
1.5.1 (revision 4026)
|
|
1.5.1 (revision 4026)
|
A call to oft2-estimator has the following syntax:
Usage: otf2-estimator [OPTION]...
This tool estimates the size of OTF2 events.
It will open a prompt to type in commands.
Options:
-V, --version Print version information.
-h, --help Print this help information.
Commands:
list definitions Lists all known definition names.
list events Lists all known event names.
list types Lists all known type names.
set <DEFINITION> <NUMBER> Specifies the number of definitions of a
type of defintions.
get Timestamp Prints the size an timestamp.
get AttributeList [TYPES...] Prints the estimated size for an attribute
list with the given number of entries and
types.
get <EVENT> [ARGS...] Prints the estimated size of records for
<EVENT>.
exit Exits the tool.
This tool provides an command line interface to the estimator API of the OTF2
library. It is based on an stream based protocol. Commands are send to the
standard input stream of the program and the result is written to the standard
output stream of the program. All definition and event names are in the
canonical CamelCase form. Numbers are printed in decimal. The TYPES are in
ALL_CAPS. See the output of the appropriate list commands. Arguments are
separated with an arbitrary number of white space. The get commands use
everything after the first white space separator verbatim as an key, which is
then printed as the result appended with the estimated size.
Here is a simple example. We have at most 4 region definitions and one metric
definition. We want to know the size of an timestamp, enter and leave event,
and an metric event with 4 values.
cat <<EOC | otf2-estimator
set Region 4
set Metric 1
get Timestamp
get Enter
get Leave
get Metric 4
exit
EOC
Timestamp 9
Enter 3
Leave 3
Metric 4 44