exercise-sut - Man Page

Synopsis

exercise-sut [-h] [-q] [-d] [--version] [--force-color] {start,report} ...

Description

exercise-sut - Run a test tool or benchmark to collect testdata.

Options

-h

Show this help message and exit.

-q

Be quiet.

-d

Print debugging information.

--version

Print version and exit.

--force-color

Force coloring of the text output.

Commands

exercise-sut start

Start collecting testdata.

exercise-sut report

Generate reports.

COMMAND 'exercise-sut start'

usage: exercise-sut start [-h] [-q] [-d] [-H HOSTNAME] [-U USERNAME] [-K PRIVKEY] [-T TIMEOUT] [--datapoints DATAPOINTS] [--reportid-prefix REPORTID_PREFIX] [--reportid-suffix REPORTID_SUFFIX] [--stats STATS] [--cpunums CPUNUMS]
                         [--cstates CSTATES] [--pcstates PCSTATES] [--only-one-cstate] [--cstates-always-enable CSTATES_ALWAYS_ENABLE] [--freqs FREQS] [--uncore-freqs UNCORE_FREQS] [--governor GOVERNOR] [--aspm ASPM]
                         [--c1-demotion C1_DEMOTION] [--c1-undemotion C1_UNDEMOTION] [--c1e-autopromote C1E_AUTOPROMOTE] [--cstate-prewake CSTATE_PREWAKE] [--state-reset] [--deploy] [--devids DEVIDS] [--stop-on-failure]
                         [--only-measured-cpu] [--toolpath TOOLPATH] [--toolopts TOOLOPTS] [--outdir OUTDIR] [--dry-run] [--list-monikers]

Run a test tool or benchmark to collect testdata.

OPTIONS 'exercise-sut start'

-h

Show this help message and exit.

-q

Be quiet.

-d

Print debugging information.

-H HOSTNAME, --host HOSTNAME

Name of the host to run the command on.

-U USERNAME, --username USERNAME

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

-K PRIVKEY, --priv-key PRIVKEY

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'.

-T TIMEOUT, --timeout TIMEOUT

SSH connect timeout in seconds, default is 8.

--datapoints DATAPOINTS, -c DATAPOINTS

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

--reportid-prefix REPORTID_PREFIX

String to prepend to the report ID (nothing, by default).

--reportid-suffix REPORTID_SUFFIX

String to append to the report ID (nothing, by default).

--stats STATS

Applicaple only for the 'wult', 'ndl' and 'benchmark' tools. Comma-separated list of statistics to collect.

--cpunums CPUNUMS

Applicable only for the 'wult' and 'ndl' tools. Comma-separated list of CPU numbers to measure with. No CPU number is passed by default.

--cstates CSTATES

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

--pcstates PCSTATES

Comma-separated list of package C-states to measure with. Default is "don't care".

--only-one-cstate

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.

--cstates-always-enable CSTATES_ALWAYS_ENABLE

Comma-separated list of always enabled C-states. Default is 'None'.

--freqs FREQS

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.

--uncore-freqs UNCORE_FREQS

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.

--governor GOVERNOR

Name of the CPU frequency governor to measure with.

--aspm ASPM

Comma-separated list of PCIe ASPM configurations to measure with. The default is "don't care". Supported values are "on" and "off".

--c1-demotion C1_DEMOTION

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

--c1-undemotion C1_UNDEMOTION

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

--c1e-autopromote C1E_AUTOPROMOTE

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

--cstate-prewake CSTATE_PREWAKE

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

--state-reset

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, unlock CPU frequency, unlock uncore frequency, set EPP policy to 'balance_performance', set EPB policy to 'balance-performance'.

--deploy

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

--devids DEVIDS

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

--stop-on-failure

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

--only-measured-cpu

Change settings, for example CPU frequency and C-state limits, only for the measured CPU. By default settings are applied to all CPUs.

--toolpath TOOLPATH

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

--toolopts TOOLOPTS

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

--outdir OUTDIR, -o OUTDIR

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

--dry-run

Do not run any commands, only print them.

--list-monikers

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.

COMMAND 'exercise-sut report'

usage: exercise-sut report [-h] [-q] [-d] [--diffs DIFFS] [--include INCLUDE] [--exclude EXCLUDE] [--jobs JOBS] [--toolpath TOOLPATH] [--toolopts TOOLOPTS] [--outdir OUTDIR] [--stop-on-failure] [--dry-run] [--list-monikers]
                          [respaths ...]

Generate reports from collected data.

respaths

One or multiple paths to be searched for test results.

OPTIONS 'exercise-sut report'

-h

Show this help message and exit.

-q

Be quiet.

-d

Print debugging information.

--diffs DIFFS

Collected data is stored in directories, and each directory name is constructed from multiple monikers separated by dashes, e.g. 'hrt-c6-uf_max-autoc1e_off'. This option can be used to create diff reports by including multiple results in one report. Comma-separated list of monikers to select results to include in the diff report. If this option is not provided, reports with single result are generated.

--include INCLUDE

Comma-separated list of monikers that must be found from the result path name.

--exclude EXCLUDE

Comma-separated list of monikers that must not be found from the result path name.

--jobs JOBS, -j JOBS

Number of threads to use for generating reports with.

--toolpath TOOLPATH

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

--toolopts TOOLOPTS

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

--outdir OUTDIR, -o OUTDIR

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

--stop-on-failure

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

--dry-run

Do not run any commands, only print them.

--list-monikers

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.

Authors

Artem Bityutskiy
dedekind1@gmail.com

Distribution

The latest version of wult may be downloaded from https://github.com/intel/wult

Info

2023-05-09 wult Generated Python Manual