perf report: Update documentation for sort keys
Add description of sort keys to the perf-report document and also add missing cpu and srcline keys to the command line help string. Signed-off-by: Namhyung Kim <namhyung@kernel.org> Acked-by: Jiri Olsa <jolsa@redhat.com> Cc: David Ahern <dsahern@gmail.com> Cc: Ingo Molnar <mingo@kernel.org> Cc: Jiri Olsa <jolsa@redhat.com> Cc: Paul Mackerras <paulus@samba.org> Cc: Peter Zijlstra <a.p.zijlstra@chello.nl> Cc: Stephane Eranian <eranian@google.com> Link: http://lkml.kernel.org/r/1356599507-14226-11-git-send-email-namhyung@kernel.org Signed-off-by: Arnaldo Carvalho de Melo <acme@redhat.com>hifive-unleashed-5.1
parent
fc5871ed0d
commit
9811360ec8
|
@ -57,11 +57,44 @@ OPTIONS
|
||||||
|
|
||||||
-s::
|
-s::
|
||||||
--sort=::
|
--sort=::
|
||||||
Sort by key(s): pid, comm, dso, symbol, parent, srcline.
|
Sort histogram entries by given key(s) - multiple keys can be specified
|
||||||
|
in CSV format. Following sort keys are available:
|
||||||
|
pid, comm, dso, symbol, parent, cpu, srcline.
|
||||||
|
|
||||||
|
Each key has following meaning:
|
||||||
|
|
||||||
|
- comm: command (name) of the task which can be read via /proc/<pid>/comm
|
||||||
|
- pid: command and tid of the task
|
||||||
|
- dso: name of library or module executed at the time of sample
|
||||||
|
- symbol: name of function executed at the time of sample
|
||||||
|
- parent: name of function matched to the parent regex filter. Unmatched
|
||||||
|
entries are displayed as "[other]".
|
||||||
|
- cpu: cpu number the task ran at the time of sample
|
||||||
|
- srcline: filename and line number executed at the time of sample. The
|
||||||
|
DWARF debuggin info must be provided.
|
||||||
|
|
||||||
|
By default, comm, dso and symbol keys are used.
|
||||||
|
(i.e. --sort comm,dso,symbol)
|
||||||
|
|
||||||
|
If --branch-stack option is used, following sort keys are also
|
||||||
|
available:
|
||||||
|
dso_from, dso_to, symbol_from, symbol_to, mispredict.
|
||||||
|
|
||||||
|
- dso_from: name of library or module branched from
|
||||||
|
- dso_to: name of library or module branched to
|
||||||
|
- symbol_from: name of function branched from
|
||||||
|
- symbol_to: name of function branched to
|
||||||
|
- mispredict: "N" for predicted branch, "Y" for mispredicted branch
|
||||||
|
|
||||||
|
And default sort keys are changed to comm, dso_from, symbol_from, dso_to
|
||||||
|
and symbol_to, see '--branch-stack'.
|
||||||
|
|
||||||
-p::
|
-p::
|
||||||
--parent=<regex>::
|
--parent=<regex>::
|
||||||
regex filter to identify parent, see: '--sort parent'
|
A regex filter to identify parent. The parent is a caller of this
|
||||||
|
function and searched through the callchain, thus it requires callchain
|
||||||
|
information recorded. The pattern is in the exteneded regex format and
|
||||||
|
defaults to "\^sys_|^do_page_fault", see '--sort parent'.
|
||||||
|
|
||||||
-x::
|
-x::
|
||||||
--exclude-other::
|
--exclude-other::
|
||||||
|
@ -74,7 +107,6 @@ OPTIONS
|
||||||
|
|
||||||
-t::
|
-t::
|
||||||
--field-separator=::
|
--field-separator=::
|
||||||
|
|
||||||
Use a special separator character and don't pad with spaces, replacing
|
Use a special separator character and don't pad with spaces, replacing
|
||||||
all occurrences of this separator in symbol names (and other output)
|
all occurrences of this separator in symbol names (and other output)
|
||||||
with a '.' character, that thus it's the only non valid separator.
|
with a '.' character, that thus it's the only non valid separator.
|
||||||
|
|
|
@ -595,8 +595,8 @@ int cmd_report(int argc, const char **argv, const char *prefix __maybe_unused)
|
||||||
OPT_BOOLEAN(0, "stdio", &report.use_stdio,
|
OPT_BOOLEAN(0, "stdio", &report.use_stdio,
|
||||||
"Use the stdio interface"),
|
"Use the stdio interface"),
|
||||||
OPT_STRING('s', "sort", &sort_order, "key[,key2...]",
|
OPT_STRING('s', "sort", &sort_order, "key[,key2...]",
|
||||||
"sort by key(s): pid, comm, dso, symbol, parent, dso_to,"
|
"sort by key(s): pid, comm, dso, symbol, parent, cpu, srcline,"
|
||||||
" dso_from, symbol_to, symbol_from, mispredict"),
|
" dso_to, dso_from, symbol_to, symbol_from, mispredict"),
|
||||||
OPT_BOOLEAN(0, "showcpuutilization", &symbol_conf.show_cpu_utilization,
|
OPT_BOOLEAN(0, "showcpuutilization", &symbol_conf.show_cpu_utilization,
|
||||||
"Show sample percentage for different cpu modes"),
|
"Show sample percentage for different cpu modes"),
|
||||||
OPT_STRING('p', "parent", &parent_pattern, "regex",
|
OPT_STRING('p', "parent", &parent_pattern, "regex",
|
||||||
|
|
Loading…
Reference in New Issue