exercise-sut-start - Man Page

Show this help message and exit.

Be quiet.

Print debugging information.

Name of the host to run the command on.

Name of the user to use for logging into the remote host over SSH. The default user name is 'root'.

Path to the private SSH key that should be used for logging into the remote host. By default the key is automatically found from standard paths like '~/.ssh'.

SSH connect timeout in seconds, default is 8.

Applicable only to 'wult' and 'ndl' tools. Number of datapoints to collect per measurement. Default is 100000.

String to prepend to the report ID.

String to append to the report ID.

Applicable only to the 'wult' and 'ndl' tools. Comma-separated list of CPU numbers to measure with.

Comma-separated list of requestable C-states to measure with.

Comma-separated list of package C-states to measure with.

Comma-separated list of turbo configurations to measure with. Supported values are "on" and "off".

Comma-separated list of frequencies to be measured with. For more information, see '--min-freq' and '--max-freq' options of the 'pepc pstates config' command. Special value 'unl' can be used to measure with unlocked frequency (minimum frequency set to smallest supported value, and maximum frequency set to highest supported value.

Comma-separated list of package uncore frequencies to measure with. For more information, see '--min-uncore-freq' and '--max-uncore-freq' options of the 'pepc pstates config' command. Special value 'unl' can be used to measure with unlocked frequency (minimum frequency set to smallest supported value, and maximum frequency set to highest supported value.

Name of the CPU frequency governor to measure with.

Comma-separated list of PCIe ASPM configurations to measure with. Supported values are "on" and "off".

Comma-separated list of C1 demotion configurations to measure with. Supported values are "on" and "off".

Comma-separated list of C1 undemotion configurations to measure with. Supported values are "on" and "off".

Comma-separated list of C1E autopromote configurations to measure with. Supported values are "on" and "off".

Comma-separated list of C-state prewake configurations to measure with. Supported values are "on" and "off".

Comma-separated list of EPP configurations to measure with. See 'pepc pstates config --epp' for more information.

Comma-separated list of EPB configurations to measure with. See 'pepc pstates config --epb' for more information.

Set SUT settings to default values before starting measurements. The default values are: online all CPUs, enable all C-states, disable C1 demotion, disable C1 undemotion, disable C1E autopromotion, disable C-state prewake, enable turbo, unlock CPU frequency, unlock uncore frequency, set EPP policy to 'balance_performance', set EPB policy to 'balance-performance'.

Applicable only to 'wult' and 'ndl' tools. Run the 'deploy' command before starting the measurements.

Applicable only to 'wult' and 'ndl' tools. Comma-separated list of device IDs to run the tools with.

Applicable to 'wult', 'ndl' 'stats-collect'tools. Comma-separated list of statistics to collect.

Applicable only to 'stats-collect' tool. The command to that 'stats-collect' should run.

Stop if any of the steps fail, instead of continuing (default).

When changing settings, such as CPU or uncore frequency, change them only for the measured CPU. Some settings have scope larger than "CPU", for example C-states limit scope may be "package", uncore frequency scope may be "die". In these cases, change only the package/die that inlcudes the measured CPU. By default the settings are applied to all CPUs, packages, dies. Note, this options does not exclude I/O dies, use '--skip-io-dies' for that.

Skip I/O dies when changing die-scope settings, such as uncore frequency. Even though I/O dies do not have CPUs, by default they are configured the same way as compute dies.

Path to the tool to run. Default is 'wult'.

By default C-states deeper than measured C-state are disabled and other C-states are enabled. This option will disable all C-states, excluding the measured C-state.

Comma-separated list of always enabled C-states.

Applicable to 'wult' and 'ndl' tools. Use filters to exclude datapoints with zero residency of measured C-state.

Additional options to use for running the tool. The string "__reportid__" will be replaced with generated report ID.

Path to directory to store the results at. Default is <toolname-date-time>.

Do not run any commands, only print them.

A moniker is an abbreviation for a setting. The 'exercise-sut' uses monikers to create directory names and report IDs for collected results. Use this option to list monikers assosiated with each settings, if any, and exit.