diff options
| author | Namhyung Kim <namhyung@gmail.com> | 2012-01-29 03:55:56 -0500 |
|---|---|---|
| committer | Arnaldo Carvalho de Melo <acme@redhat.com> | 2012-01-30 15:30:48 -0500 |
| commit | d1eec3ecaef083affaf3210246b01b6e80d3a44e (patch) | |
| tree | 7f8f6559ad9fe3fb872bbd7f61c8361b10621ce0 | |
| parent | 008953dc6a3164b7ec2be2684a8fad1e636d5648 (diff) | |
perf lock: Document lock info subcommand
The commit 26242d859c9be ("perf lock: Add "info" subcommand for dumping
misc information") added the subcommand but missed documentation. Add
it. Also update stale 'trace' subcommand to 'script'.
Cc: Hitoshi Mitake <mitake@dcl.info.waseda.ac.jp>
Cc: Ingo Molnar <mingo@elte.hu>
Cc: Paul Mackerras <paulus@samba.org>
Cc: Peter Zijlstra <a.p.zijlstra@chello.nl>
Link: http://lkml.kernel.org/r/1327827356-8786-5-git-send-email-namhyung@gmail.com
Signed-off-by: Namhyung Kim <namhyung@gmail.com>
Signed-off-by: Arnaldo Carvalho de Melo <acme@redhat.com>
| -rw-r--r-- | tools/perf/Documentation/perf-lock.txt | 20 | ||||
| -rw-r--r-- | tools/perf/builtin-lock.c | 4 |
2 files changed, 19 insertions, 5 deletions
diff --git a/tools/perf/Documentation/perf-lock.txt b/tools/perf/Documentation/perf-lock.txt index d6b2a4f2108b..c7f5f55634ac 100644 --- a/tools/perf/Documentation/perf-lock.txt +++ b/tools/perf/Documentation/perf-lock.txt | |||
| @@ -8,7 +8,7 @@ perf-lock - Analyze lock events | |||
| 8 | SYNOPSIS | 8 | SYNOPSIS |
| 9 | -------- | 9 | -------- |
| 10 | [verse] | 10 | [verse] |
| 11 | 'perf lock' {record|report|trace} | 11 | 'perf lock' {record|report|script|info} |
| 12 | 12 | ||
| 13 | DESCRIPTION | 13 | DESCRIPTION |
| 14 | ----------- | 14 | ----------- |
| @@ -20,10 +20,13 @@ and statistics with this 'perf lock' command. | |||
| 20 | produces the file "perf.data" which contains tracing | 20 | produces the file "perf.data" which contains tracing |
| 21 | results of lock events. | 21 | results of lock events. |
| 22 | 22 | ||
| 23 | 'perf lock trace' shows raw lock events. | ||
| 24 | |||
| 25 | 'perf lock report' reports statistical data. | 23 | 'perf lock report' reports statistical data. |
| 26 | 24 | ||
| 25 | 'perf lock script' shows raw lock events. | ||
| 26 | |||
| 27 | 'perf lock info' shows metadata like threads or addresses | ||
| 28 | of lock instances. | ||
| 29 | |||
| 27 | COMMON OPTIONS | 30 | COMMON OPTIONS |
| 28 | -------------- | 31 | -------------- |
| 29 | 32 | ||
| @@ -47,6 +50,17 @@ REPORT OPTIONS | |||
| 47 | Sorting key. Possible values: acquired (default), contended, | 50 | Sorting key. Possible values: acquired (default), contended, |
| 48 | wait_total, wait_max, wait_min. | 51 | wait_total, wait_max, wait_min. |
| 49 | 52 | ||
| 53 | INFO OPTIONS | ||
| 54 | ------------ | ||
| 55 | |||
| 56 | -t:: | ||
| 57 | --threads:: | ||
| 58 | dump thread list in perf.data | ||
| 59 | |||
| 60 | -m:: | ||
| 61 | --map:: | ||
| 62 | dump map of lock instances (address:name table) | ||
| 63 | |||
| 50 | SEE ALSO | 64 | SEE ALSO |
| 51 | -------- | 65 | -------- |
| 52 | linkperf:perf[1] | 66 | linkperf:perf[1] |
diff --git a/tools/perf/builtin-lock.c b/tools/perf/builtin-lock.c index 2296c391d0f5..12c814838993 100644 --- a/tools/perf/builtin-lock.c +++ b/tools/perf/builtin-lock.c | |||
| @@ -922,12 +922,12 @@ static const struct option info_options[] = { | |||
| 922 | OPT_BOOLEAN('t', "threads", &info_threads, | 922 | OPT_BOOLEAN('t', "threads", &info_threads, |
| 923 | "dump thread list in perf.data"), | 923 | "dump thread list in perf.data"), |
| 924 | OPT_BOOLEAN('m', "map", &info_map, | 924 | OPT_BOOLEAN('m', "map", &info_map, |
| 925 | "map of lock instances (name:address table)"), | 925 | "map of lock instances (address:name table)"), |
| 926 | OPT_END() | 926 | OPT_END() |
| 927 | }; | 927 | }; |
| 928 | 928 | ||
| 929 | static const char * const lock_usage[] = { | 929 | static const char * const lock_usage[] = { |
| 930 | "perf lock [<options>] {record|trace|report}", | 930 | "perf lock [<options>] {record|report|script|info}", |
| 931 | NULL | 931 | NULL |
| 932 | }; | 932 | }; |
| 933 | 933 | ||
