2.2 (revision 4737)
|
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 definitions. get DefChunkSize Prints the estimated definition chunk size. get Timestamp Prints the size of a 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 a command line interface to the estimator API of the OTF2 library. It is based on a 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 there 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 are using everything after the first white space separator verbatim as a key, which is then printed in the output line and 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 a timestamp, enter, and leave event, and a 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