Command-Line Options
Running the measurement analysis sample with the
-h
option yields the following usage message:usage: tcc_measurement_analysis_sample hist | monitor
Command | Description |
---|---|
hist | Show histogram from data collected by measurement library |
monitor | Monitor measurements collected by measurement library |
See
tcc_measurement_analysis_sample <command> --help(-h)
to get information about the specific command.Usage message for
hist
command:usage: tcc_measurement_analysis_sample hist [<measurement_instances>] [-dump-file] [-time-units] [-nn cpu] -- <app> [<args>]
Usage message for
monitor
command:usage: tcc_measurement_analysis_sample monitor [<measurement_instances>] [-deadline-only] [-dump-file] [-time-units] [-nn cpu] -- <app> [<args>]
Argument | Description |
---|---|
measurement_instances | Optional. Specify the measurement_instances inside the profiled application to use to collect the measurement history.
This argument can be omitted if environment variable TCC_MEASUREMENTS_BUFFERS is specified (TCC_MEASUREMENTS_BUFFERS serves the same purpose). This argument overrides TCC_MEASUREMENTS_BUFFERS environment variable. Format: <measurement_instance_name>:<buffer_size>[,<measurement_instance_name>:<buffer_size> …], where the measurement instances name is the measurement name passed to __itt_string_handle_create() in the profiled application, and the buffer size is the number of cycle iterations to store internally for building the histogram. Specifying too high a value will require lots of memory for the profiled application. Example: “ Cycle:1000,Sensor:1000 ”NOTE: If the buffer size defined in the measurement_instances argument does not match the total number of measurements (that is, only N last samples are collected), the full data statistics (average, maximum, and minimum) may not match the histogram statistics. |
app | Required. Specify the path to the profiled application
(example: ./tcc_multiple_measurements_sample) . |
args | Optional. Command-line arguments for the application being profiled. |
Option | Description |
---|---|
-dump-file file | Optional. Specify the history dump file path from the profiled
application. The file contains measurements collected by the measurement library during application run. This option can be omitted if environment variable TCC_MEASUREMENTS_DUMP_FILE is specified (TCC_MEASUREMENTS_DUMP_FILE serves the same purpose). This option overrides TCC_MEASUREMENTS_DUMP_FILE environment variable. The dump file is used to create the histogram. The file format
is implicitly defined; do not change it manually. If the -dump-file
option is unset, the sample uses TCC_MEASUREMENTS_DUMP_FILE environment
variable. If the TCC_MEASUREMENTS_DUMP_FILE environment variable is
unset, a local file is created with the name <application name>.hist . |
-time-units units | Optional. Specify time units displayed in the output:
This option overrides TCC_MEASUREMENTS_TIME_UNIT environment variable. |
-nn cpu | Optional. Run noisy neighbor (stress-ng) on cpu id, for example, -nn 3. |
-deadline-only | Optional. Print only the values exceeding the deadline. |
-h, --help | Optional. Print command-line help. |