Commit 6fe8c26d authored by Namhyung Kim's avatar Namhyung Kim Committed by Jiri Olsa
Browse files

perf top: Add --fields option to specify output fields 



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: default avatarNamhyung Kim <namhyung@kernel.org>
Link: http://lkml.kernel.org/r/1400480762-22852-15-git-send-email-namhyung@kernel.org


Signed-off-by: default avatarJiri Olsa <jolsa@kernel.org>
parent c0f1527b

tools/perf/Documentation/perf-top.txt

+9 −0
Original line number Diff line number Diff line
@@ -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.

tools/perf/builtin-top.c

+9 −6
Original line number Diff line number Diff line
@@ -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) {

		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)

CRA Git | Maintained and supported by SUSTech CRA and CCSE