diff options
| -rw-r--r-- | tools/perf/Documentation/perf-stat.txt | 34 |
1 files changed, 27 insertions, 7 deletions
diff --git a/tools/perf/Documentation/perf-stat.txt b/tools/perf/Documentation/perf-stat.txt index c405bcad6ac7..c469ba56c076 100644 --- a/tools/perf/Documentation/perf-stat.txt +++ b/tools/perf/Documentation/perf-stat.txt | |||
| @@ -8,8 +8,8 @@ perf-stat - Run a command and gather performance counter statistics | |||
| 8 | SYNOPSIS | 8 | SYNOPSIS |
| 9 | -------- | 9 | -------- |
| 10 | [verse] | 10 | [verse] |
| 11 | 'perf stat' [-e <EVENT> | --event=EVENT] [-S] [-a] <command> | 11 | 'perf stat' [-e <EVENT> | --event=EVENT] [-a] <command> |
| 12 | 'perf stat' [-e <EVENT> | --event=EVENT] [-S] [-a] -- <command> [<options>] | 12 | 'perf stat' [-e <EVENT> | --event=EVENT] [-a] -- <command> [<options>] |
| 13 | 13 | ||
| 14 | DESCRIPTION | 14 | DESCRIPTION |
| 15 | ----------- | 15 | ----------- |
| @@ -35,21 +35,33 @@ OPTIONS | |||
| 35 | child tasks do not inherit counters | 35 | child tasks do not inherit counters |
| 36 | -p:: | 36 | -p:: |
| 37 | --pid=<pid>:: | 37 | --pid=<pid>:: |
| 38 | stat events on existing pid | 38 | stat events on existing process id |
| 39 | |||
| 40 | -t:: | ||
| 41 | --tid=<tid>:: | ||
| 42 | stat events on existing thread id | ||
| 43 | |||
| 39 | 44 | ||
| 40 | -a:: | 45 | -a:: |
| 41 | system-wide collection | 46 | --all-cpus:: |
| 47 | system-wide collection from all CPUs | ||
| 42 | 48 | ||
| 43 | -c:: | 49 | -c:: |
| 44 | scale counter values | 50 | --scale:: |
| 51 | scale/normalize counter values | ||
| 52 | |||
| 53 | -r:: | ||
| 54 | --repeat=<n>:: | ||
| 55 | repeat command and print average + stddev (max: 100) | ||
| 45 | 56 | ||
| 46 | -B:: | 57 | -B:: |
| 58 | --big-num:: | ||
| 47 | print large numbers with thousands' separators according to locale | 59 | print large numbers with thousands' separators according to locale |
| 48 | 60 | ||
| 49 | -C:: | 61 | -C:: |
| 50 | --cpu=:: | 62 | --cpu=:: |
| 51 | Count only on the list of cpus provided. Multiple CPUs can be provided as a | 63 | Count only on the list of CPUs provided. Multiple CPUs can be provided as a |
| 52 | comma-sperated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2. | 64 | comma-separated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2. |
| 53 | In per-thread mode, this option is ignored. The -a option is still necessary | 65 | In per-thread mode, this option is ignored. The -a option is still necessary |
| 54 | to activate system-wide monitoring. Default is to count on all CPUs. | 66 | to activate system-wide monitoring. Default is to count on all CPUs. |
| 55 | 67 | ||
| @@ -58,6 +70,14 @@ to activate system-wide monitoring. Default is to count on all CPUs. | |||
| 58 | Do not aggregate counts across all monitored CPUs in system-wide mode (-a). | 70 | Do not aggregate counts across all monitored CPUs in system-wide mode (-a). |
| 59 | This option is only valid in system-wide mode. | 71 | This option is only valid in system-wide mode. |
| 60 | 72 | ||
| 73 | -n:: | ||
| 74 | --null:: | ||
| 75 | null run - don't start any counters | ||
| 76 | |||
| 77 | -v:: | ||
| 78 | --verbose:: | ||
| 79 | be more verbose (show counter open errors, etc) | ||
| 80 | |||
| 61 | EXAMPLES | 81 | EXAMPLES |
| 62 | -------- | 82 | -------- |
| 63 | 83 | ||
