perf top: Add --fields option to specify output fields
authorNamhyung Kim <namhyung@kernel.org>
Tue, 4 Mar 2014 02:01:41 +0000 (11:01 +0900)
committerJiri Olsa <jolsa@kernel.org>
Wed, 21 May 2014 09:45:36 +0000 (11:45 +0200)
The --fields option is to allow user setup output field in any order.
It can receive any sort keys and following (hpp) fields:

  overhead, overhead_sys, overhead_us, sample and period

If guest profiling is enabled, overhead_guest_{sys,us} will be
available too.

More more information, please see previous patch "perf report:
Add -F option to specify output fields"

Signed-off-by: Namhyung Kim <namhyung@kernel.org>
Link: http://lkml.kernel.org/r/1400480762-22852-15-git-send-email-namhyung@kernel.org
Signed-off-by: Jiri Olsa <jolsa@kernel.org>
tools/perf/Documentation/perf-top.txt
tools/perf/builtin-top.c

index df863288752a60994a047cfd5d77639678405fc5..dcfa54c851e9d6ee1dcd1b0ffed15a6863ee881e 100644 (file)
@@ -116,6 +116,15 @@ Default is to monitor all CPUS.
        local_weight, abort, in_tx, transaction, overhead, sample, period.
        Please see description of --sort in the perf-report man page.
 
+--fields=::
+       Specify output field - multiple keys can be specified in CSV format.
+       Following fields are available:
+       overhead, overhead_sys, overhead_us, sample and period.
+       Also it can contain any sort key(s).
+
+       By default, every sort keys not specified in --field will be appended
+       automatically.
+
 -n::
 --show-nr-samples::
        Show a column with the number of samples.
index 280945bab66d3c7ef3c493a1efb9af5c649721ee..5b389ce4cd15d03b656185f83d58f10aca94fd81 100644 (file)
@@ -1085,6 +1085,8 @@ int cmd_top(int argc, const char **argv, const char *prefix __maybe_unused)
        OPT_STRING('s', "sort", &sort_order, "key[,key2...]",
                   "sort by key(s): pid, comm, dso, symbol, parent, cpu, srcline, ..."
                   " Please refer the man page for the complete list."),
+       OPT_STRING(0, "fields", &field_order, "key[,keys...]",
+                  "output field(s): overhead, period, sample plus all of sort keys"),
        OPT_BOOLEAN('n', "show-nr-samples", &symbol_conf.show_nr_samples,
                    "Show a column with the number of samples"),
        OPT_CALLBACK_NOOPT('g', NULL, &top.record_opts,
@@ -1138,17 +1140,18 @@ int cmd_top(int argc, const char **argv, const char *prefix __maybe_unused)
                usage_with_options(top_usage, options);
 
        sort__mode = SORT_MODE__TOP;
+       /* display thread wants entries to be collapsed in a different tree */
+       sort__need_collapse = 1;
 
        if (setup_sorting() < 0) {
-               parse_options_usage(top_usage, options, "s", 1);
+               if (sort_order)
+                       parse_options_usage(top_usage, options, "s", 1);
+               if (field_order)
+                       parse_options_usage(sort_order ? NULL : top_usage,
+                                           options, "fields", 0);
                goto out_delete_evlist;
        }
 
-       /* display thread wants entries to be collapsed in a different tree */
-       sort__need_collapse = 1;
-
-       perf_hpp__init();
-
        if (top.use_stdio)
                use_browser = 0;
        else if (top.use_tui)