Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]
Groups > linux.kernel > #1279492
| From | Taeung Song <treeze.taeung@gmail.com> |
|---|---|
| Newsgroups | linux.kernel |
| Subject | Re: [PATCH v11 10/24] perf config: Document variables for 'call-graph' section in man page |
| Date | 2015-11-30 02:50 +0100 |
| Message-ID | <qAlLj-5ll-5@gated-at.bofh.it> (permalink) |
| References | <qvTkC-f2-7@gated-at.bofh.it> <qvTkE-f2-67@gated-at.bofh.it> <qw18t-59k-1@gated-at.bofh.it> |
| Organization | linux.* mail to news gateway |
Hi, Namhyung > On Nov 18, 2015, at 11:51 AM, Namhyung Kim <namhyung@kernel.org> wrote: > > On Tue, Nov 17, 2015 at 10:53:30PM +0900, Taeung Song wrote: >> Explain 'call-graph' section and its variables. >> >> 'record-mode', 'dump-size', 'print-type', 'order', >> 'sort-key', 'threshold' and 'print-limit'. >> >> Cc: Namhyung Kim <namhyung@kernel.org> >> Cc: Jiri Olsa <jolsa@redhat.com> >> Signed-off-by: Taeung Song <treeze.taeung@gmail.com> >> --- >> tools/perf/Documentation/perf-config.txt | 65 ++++++++++++++++++++++++++++++++ >> 1 file changed, 65 insertions(+) >> >> diff --git a/tools/perf/Documentation/perf-config.txt b/tools/perf/Documentation/perf-config.txt >> index 7d386d4..dc659d6 100644 >> --- a/tools/perf/Documentation/perf-config.txt >> +++ b/tools/perf/Documentation/perf-config.txt >> @@ -285,6 +285,71 @@ ui.*:: >> There're columns as header 'Overhead', 'Children', 'Shared Object', 'Symbol', 'self'. >> If this option is false, they are hiden. This option is only applied to TUI. >> >> +call-graph.*:: >> + When sub-commands 'top' and 'report' work with -g/—-children >> + there're options in control of call-graph. >> + >> + call-graph.record-mode:: >> + The record-mode can be 'fp' (frame pointer) and 'dwarf'. > > Also 'lbr' can be used, but it only work for recent intel cpus. > > >> + The value of 'dwarf' is effective only if perf detect needed library >> + (libunwind or a recent version of libdw). Also it doesn't *require* >> + the dump-size option since it can use the default value of 8192 if >> + missing. > > I think the last sentence can be omitted. > > >> + >> + call-graph.dump-size:: >> + The size of stack to dump in order to do post-unwinding. Default is 8192 (byte). >> + When using dwarf into record-mode this option should have a value. > > This contradicts the above, it'll use the default size if omitted. > > >> + >> + call-graph.print-type:: >> + The print-types can be graph (graph absolute), fractal (graph relative), flat. >> + This option controls a way to show overhead for each callchain entry. >> + Suppose a following example. >> + >> + Overhead Symbols >> + ........ ....... >> + 40.00% foo >> + | >> + --- foo >> + | >> + |--50.00%-- bar >> + | main >> + | >> + --50.00%-- baz >> + main > > ^ > it needs one more whitespace > I checked this patch file and whitespace and tab characters on it. But I think the lacking whitespace because of mail client. After 'make install’ I checked it but there is no lack of whitespace. Are there different problems that I missed ? Thanks, Taeung > >> + >> + This output is a 'fractal' format. The 'foo' came from 'bar' and 'baz' exactly >> + half and half so 'fractal' shows 50.00% for each >> + (meaning that it assumes 100% total overhead of 'foo'). >> + >> + The 'graph' uses absolute overhead value of 'foo' as total so each of >> + 'bar' and 'baz' callchain will have 20.00% of overhead. >> + >> + call-graph.order:: >> + This option controls print order of callchains. The default is >> + 'callee' which means callee is printed at top and then followed by its >> + caller and so on. The 'caller' prints it in reverse order. >> + >> + If this option is not set and report.children or top.children is >> + set to true (or the equivalent command line option is given), >> + the default value of this option is changed to 'caller' for the >> + execution of 'perf report' or 'perf top'. Other commands will >> + still default to 'callee'. >> + >> + call-graph.sort-key:: >> + The callchains are merged if they contain same information. >> + The sort-key option determines a way to compare the callchains. >> + A value of 'sort-key' can be 'function' or 'address'. >> + The default is 'function'. >> + >> + call-graph.threshold:: >> + When there're many callchains it'd print tons of lines. So perf omits >> + small callchains under a certain overhead (threshold) and this option >> + control the threashold. Default is 0.5 (%). > > s/threashold/threshold/ > > Also it'd be better to mention that the overhead is calculated by > value depends on call-graph.print-type. > > >> + >> + call-graph.print-limit:: >> + This is another way to control the number of callchains printed for a >> + single entry. Default is 0 which means no limitation. > > This is a maximum number of lines of callchain printed for a single > histogram entry. > > Thanks, > Namhyung > > >> + >> SEE ALSO >> -------- >> linkperf:perf[1] >> -- >> 1.9.1 -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
Back to linux.kernel | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread
[PATCH v11 01/24] perf tools: Add 'perf-config' command Taeung Song <treeze.taeung@gmail.com> - 2015-11-17 19:40 +0100
[PATCH v11 22/24] perf config: Add 'set' feature Taeung Song <treeze.taeung@gmail.com> - 2015-11-17 19:40 +0100
[PATCH v11 14/24] perf config: Document 'pager.<subcommand>' variables in man page Taeung Song <treeze.taeung@gmail.com> - 2015-11-17 19:40 +0100
Re: [PATCH v11 14/24] perf config: Document 'pager.<subcommand>' variables in man page Namhyung Kim <namhyung@kernel.org> - 2015-11-18 06:10 +0100
[PATCH v11 19/24] perf config: Add a option 'skel' to perf-config Taeung Song <treeze.taeung@gmail.com> - 2015-11-17 19:40 +0100
[PATCH v11 13/24] perf config: Document 'man.viewer' variable in man page Taeung Song <treeze.taeung@gmail.com> - 2015-11-17 19:40 +0100
Re: [PATCH v11 13/24] perf config: Document 'man.viewer' variable in man page Namhyung Kim <namhyung@kernel.org> - 2015-11-18 06:00 +0100
[PATCH v11 07/24] perf config: Document variables for 'help' section in man page Taeung Song <treeze.taeung@gmail.com> - 2015-11-17 19:40 +0100
Re: [PATCH v11 07/24] perf config: Document variables for 'help' section in man page Namhyung Kim <namhyung@kernel.org> - 2015-11-18 01:50 +0100
[PATCH v11 08/24] perf config: Document 'hist.percentage' variable in man page Taeung Song <treeze.taeung@gmail.com> - 2015-11-17 19:40 +0100
Re: [PATCH v11 08/24] perf config: Document 'hist.percentage' variable in man page Namhyung Kim <namhyung@kernel.org> - 2015-11-18 02:00 +0100
[PATCH v11 18/24] perf config: Add 'list-all' option to perf-config Taeung Song <treeze.taeung@gmail.com> - 2015-11-17 19:40 +0100
[PATCH v11 17/24] perf config: Collect configs to handle config variables Taeung Song <treeze.taeung@gmail.com> - 2015-11-17 19:40 +0100
Re: [PATCH v11 17/24] perf config: Collect configs to handle config variables Namhyung Kim <namhyung@kernel.org> - 2015-11-18 06:20 +0100
[PATCH v11 16/24] perf config: Add '--system' and '--user' options to select which config file is used Taeung Song <treeze.taeung@gmail.com> - 2015-11-17 19:40 +0100
Re: [PATCH v11 16/24] perf config: Add '--system' and '--user' options to select which config file is used Namhyung Kim <namhyung@kernel.org> - 2015-11-18 06:20 +0100
[PATCH v11 12/24] perf config: Document 'top.chidren' variable in man page Taeung Song <treeze.taeung@gmail.com> - 2015-11-17 19:40 +0100
Re: [PATCH v11 12/24] perf config: Document 'top.chidren' variable in man page Namhyung Kim <namhyung@kernel.org> - 2015-11-18 04:10 +0100
[PATCH v11 11/24] perf config: Document variables for 'report' section in man page Taeung Song <treeze.taeung@gmail.com> - 2015-11-17 19:40 +0100
Re: [PATCH v11 11/24] perf config: Document variables for 'report' section in man page Namhyung Kim <namhyung@kernel.org> - 2015-11-18 04:10 +0100
[PATCH v11 24/24] perf config: Add a option 'remove' to perf-config Taeung Song <treeze.taeung@gmail.com> - 2015-11-17 19:40 +0100
[PATCH v11 23/24] perf config: normalize a value depending on default type of it Taeung Song <treeze.taeung@gmail.com> - 2015-11-17 19:40 +0100
[PATCH v11 04/24] perf config: Document variables for 'tui' and 'gtk' sections in man page Taeung Song <treeze.taeung@gmail.com> - 2015-11-17 19:40 +0100
Re: [PATCH v11 04/24] perf config: Document variables for 'tui' and 'gtk' sections in man page Namhyung Kim <namhyung@kernel.org> - 2015-11-18 01:10 +0100
[PATCH v11 06/24] perf config: Document variables for 'annotate' section in man page Taeung Song <treeze.taeung@gmail.com> - 2015-11-17 19:40 +0100
Re: [PATCH v11 06/24] perf config: Document variables for 'annotate' section in man page Namhyung Kim <namhyung@kernel.org> - 2015-11-18 01:30 +0100
[PATCH v11 10/24] perf config: Document variables for 'call-graph' section in man page Taeung Song <treeze.taeung@gmail.com> - 2015-11-17 19:40 +0100
Re: [PATCH v11 10/24] perf config: Document variables for 'call-graph' section in man page Namhyung Kim <namhyung@kernel.org> - 2015-11-18 04:00 +0100
Re: [PATCH v11 10/24] perf config: Document variables for 'call-graph' section in man page Taeung Song <treeze.taeung@gmail.com> - 2015-11-30 02:50 +0100
Re: [PATCH v11 10/24] perf config: Document variables for 'call-graph' section in man page Namhyung Kim <namhyung@kernel.org> - 2015-11-30 06:10 +0100
[PATCH v11 20/24] perf config: Add --verbose option for showing config description Taeung Song <treeze.taeung@gmail.com> - 2015-11-17 19:40 +0100
[PATCH v11 03/24] perf config: Document variables for 'color' section in man page Taeung Song <treeze.taeung@gmail.com> - 2015-11-17 19:50 +0100
Re: [PATCH v11 03/24] perf config: Document variables for 'color' section in man page Namhyung Kim <namhyung@kernel.org> - 2015-11-18 00:50 +0100
[PATCH v11 02/24] perf tools: Add perf-config document Taeung Song <treeze.taeung@gmail.com> - 2015-11-17 19:50 +0100
Re: [PATCH v11 02/24] perf tools: Add perf-config document Namhyung Kim <namhyung@kernel.org> - 2015-11-18 00:20 +0100
Re: [PATCH v11 02/24] perf tools: Add perf-config document Arnaldo Carvalho de Melo <acme@kernel.org> - 2015-11-19 20:30 +0100
[PATCH v11 RESEND 02/24] perf tools: Add perf-config document Taeung Song <treeze.taeung@gmail.com> - 2015-11-22 11:20 +0100
Re: [PATCH v11 RESEND 02/24] perf tools: Add perf-config document Arnaldo Carvalho de Melo <arnaldo.melo@gmail.com> - 2015-11-23 15:20 +0100
[tip:perf/core] perf config: Add initial man page tip-bot for Taeung Song <tipbot@zytor.com> - 2015-11-26 09:30 +0100
Re: [PATCH v11 02/24] perf tools: Add perf-config document Taeung Song <treeze.taeung@gmail.com> - 2015-11-22 11:20 +0100
[PATCH v11 09/24] perf config: Document 'ui.show-headers' variable in man page Taeung Song <treeze.taeung@gmail.com> - 2015-11-17 19:50 +0100
Re: [PATCH v11 09/24] perf config: Document 'ui.show-headers' variable in man page Namhyung Kim <namhyung@kernel.org> - 2015-11-18 02:10 +0100
[PATCH v11 05/24] perf config: Document 'buildid.dir' variable in man page Taeung Song <treeze.taeung@gmail.com> - 2015-11-17 19:50 +0100
Re: [PATCH v11 05/24] perf config: Document 'buildid.dir' variable in man page Namhyung Kim <namhyung@kernel.org> - 2015-11-18 01:10 +0100
Re: [PATCH v11 01/24] perf tools: Add 'perf-config' command Namhyung Kim <namhyung@gmail.com> - 2015-11-17 23:40 +0100
[tip:perf/core] perf tools: Add 'perf config' command tip-bot for Taeung Song <tipbot@zytor.com> - 2015-11-26 09:30 +0100
csiph-web