Commit cd0a9c51 authored by Ravi Bangoria's avatar Ravi Bangoria Committed by Arnaldo Carvalho de Melo

perf annotate: Fix perf config option description

perf config annotate options says it works only with TUI, which is wrong.
Most of the TUI options are applicable to stdio2 as well. So remove that
generic line and add individual line with each option stating which
browsers supports that option. Also, annotate.show_nr_samples config is
missing in Documentation. Describe it.
Signed-off-by: default avatarRavi Bangoria <ravi.bangoria@linux.ibm.com>
Cc: Adrian Hunter <adrian.hunter@intel.com>
Cc: Alexey Budankov <alexey.budankov@linux.intel.com>
Cc: Changbin Du <changbin.du@intel.com>
Cc: Ian Rogers <irogers@google.com>
Cc: Jin Yao <yao.jin@linux.intel.com>
Cc: Jiri Olsa <jolsa@kernel.org>
Cc: Leo Yan <leo.yan@linaro.org>
Cc: Namhyung Kim <namhyung@kernel.org>
Cc: Song Liu <songliubraving@fb.com>
Cc: Taeung Song <treeze.taeung@gmail.com>
Cc: Thomas Richter <tmricht@linux.ibm.com>
Cc: Yisheng Xie <xieyisheng1@huawei.com>
Link: http://lore.kernel.org/lkml/20200213064306.160480-8-ravi.bangoria@linux.ibm.comSigned-off-by: default avatarArnaldo Carvalho de Melo <acme@redhat.com>
parent 812b0f52
...@@ -239,7 +239,6 @@ buildid.*:: ...@@ -239,7 +239,6 @@ buildid.*::
set buildid.dir to /dev/null. The default is $HOME/.debug set buildid.dir to /dev/null. The default is $HOME/.debug
annotate.*:: annotate.*::
These options work only for TUI.
These are in control of addresses, jump function, source code These are in control of addresses, jump function, source code
in lines of assembly code from a specific program. in lines of assembly code from a specific program.
...@@ -269,6 +268,8 @@ annotate.*:: ...@@ -269,6 +268,8 @@ annotate.*::
│ mov (%rdi),%rdx │ mov (%rdi),%rdx
│ return n; │ return n;
This option works with tui, stdio2 browsers.
annotate.use_offset:: annotate.use_offset::
Basing on a first address of a loaded function, offset can be used. Basing on a first address of a loaded function, offset can be used.
Instead of using original addresses of assembly code, Instead of using original addresses of assembly code,
...@@ -287,6 +288,8 @@ annotate.*:: ...@@ -287,6 +288,8 @@ annotate.*::
368:│ mov 0x8(%r14),%rdi 368:│ mov 0x8(%r14),%rdi
This option works with tui, stdio2 browsers.
annotate.jump_arrows:: annotate.jump_arrows::
There can be jump instruction among assembly code. There can be jump instruction among assembly code.
Depending on a boolean value of jump_arrows, Depending on a boolean value of jump_arrows,
...@@ -306,6 +309,8 @@ annotate.*:: ...@@ -306,6 +309,8 @@ annotate.*::
│1330: mov %r15,%r10 │1330: mov %r15,%r10
│1333: cmp %r15,%r14 │1333: cmp %r15,%r14
This option works with tui browser.
annotate.show_linenr:: annotate.show_linenr::
When showing source code if this option is 'true', When showing source code if this option is 'true',
line numbers are printed as below. line numbers are printed as below.
...@@ -325,6 +330,8 @@ annotate.*:: ...@@ -325,6 +330,8 @@ annotate.*::
│ array++; │ array++;
│ } │ }
This option works with tui, stdio2 browsers.
annotate.show_nr_jumps:: annotate.show_nr_jumps::
Let's see a part of assembly code. Let's see a part of assembly code.
...@@ -335,6 +342,8 @@ annotate.*:: ...@@ -335,6 +342,8 @@ annotate.*::
│1 1382: movb $0x1,-0x270(%rbp) │1 1382: movb $0x1,-0x270(%rbp)
This option works with tui, stdio2 browsers.
annotate.show_total_period:: annotate.show_total_period::
To compare two records on an instruction base, with this option To compare two records on an instruction base, with this option
provided, display total number of samples that belong to a line provided, display total number of samples that belong to a line
...@@ -348,11 +357,30 @@ annotate.*:: ...@@ -348,11 +357,30 @@ annotate.*::
99.93 │ mov %eax,%eax 99.93 │ mov %eax,%eax
This option works with tui, stdio2, stdio browsers.
annotate.show_nr_samples::
By default perf annotate shows percentage of samples. This option
can be used to print absolute number of samples. Ex, when set as
false:
Percent│
74.03 │ mov %fs:0x28,%rax
When set as true:
Samples│
6 │ mov %fs:0x28,%rax
This option works with tui, stdio2, stdio browsers.
annotate.offset_level:: annotate.offset_level::
Default is '1', meaning just jump targets will have offsets show right beside Default is '1', meaning just jump targets will have offsets show right beside
the instruction. When set to '2' 'call' instructions will also have its offsets the instruction. When set to '2' 'call' instructions will also have its offsets
shown, 3 or higher will show offsets for all instructions. shown, 3 or higher will show offsets for all instructions.
This option works with tui, stdio2 browsers.
hist.*:: hist.*::
hist.percentage:: hist.percentage::
This option control the way to calculate overhead of filtered entries - This option control the way to calculate overhead of filtered entries -
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment