perf top: Add --children option

The --children option is for showing accumulated overhead (period)
value as well as self overhead.  It should be used with one of -g or
--call-graph option.

Signed-off-by: Namhyung Kim <namhyung@kernel.org>
Tested-by: Arun Sharma <asharma@fb.com>
Tested-by: Rodrigo Campos <rodrigo@sdfg.com.ar>
Cc: Frederic Weisbecker <fweisbec@gmail.com>
Link: http://lkml.kernel.org/r/1401335910-16832-21-git-send-email-namhyung@kernel.org
Signed-off-by: Jiri Olsa <jolsa@kernel.org>

1 files changed, 7 insertions, 1 deletions

diff --git a/tools/perf/Documentation/perf-top.txt b/tools/perf/Documentation/perf-top.txt
index dcfa54c851e9..180ae02137a5 100644
--- a/tools/perf/Documentation/perf-top.txt
+++ b/tools/perf/Documentation/perf-top.txt
@@ -119,7 +119,7 @@ Default is to monitor all CPUS.
 --fields=::
         Specify output field - multiple keys can be specified in CSV format.
         Following fields are available:
-        overhead, overhead_sys, overhead_us, sample and period.
+        overhead, overhead_sys, overhead_us, overhead_children, sample and period.
         Also it can contain any sort key(s).
 
         By default, every sort keys not specified in --field will be appended
@@ -161,6 +161,12 @@ Default is to monitor all CPUS.
         Setup and enable call-graph (stack chain/backtrace) recording,
         implies -g.
 
+--children::
+        Accumulate callchain of children to parent entry so that then can
+        show up in the output.  The output will have a new "Children" column
+        and will be sorted on the data.  It requires -g/--call-graph option
+        enabled.
+
 --max-stack::
         Set the stack depth limit when parsing the callchain, anything
         beyond the specified depth will be ignored. This is a trade-off