Developer Guide

  • 2021.2
  • 06/11/2021
  • Public
Contents

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:
  • “ns” for nanoseconds
  • “us” for microseconds
  • “clk” for CPU clock cycles (default)
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.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.