Re: [PATCH 2/6] perf config: Document examples to get config key-value pairs in man page

From: Arnaldo Carvalho de Melo
Date: Mon Nov 14 2016 - 10:52:04 EST


Em Fri, Nov 04, 2016 at 03:44:18PM +0900, Taeung Song escreveu:
> Explain how to query particular config items in config file
> and how to get several config items from user or system config file
> using '--user' or '--system' options.

This one should be combined with the previous one, i.e. the patch that
introduces this feature, doing it myself.

- Arnaldo

> Cc: Namhyung Kim <namhyung@xxxxxxxxxx>
> Cc: Jiri Olsa <jolsa@xxxxxxxxxx>
> Cc: Wang Nan <wangnan0@xxxxxxxxxx>
> Signed-off-by: Taeung Song <treeze.taeung@xxxxxxxxx>
> ---
> tools/perf/Documentation/perf-config.txt | 18 ++++++++++++++++++
> 1 file changed, 18 insertions(+)
>
> diff --git a/tools/perf/Documentation/perf-config.txt b/tools/perf/Documentation/perf-config.txt
> index cb081ac5..1714b0c 100644
> --- a/tools/perf/Documentation/perf-config.txt
> +++ b/tools/perf/Documentation/perf-config.txt
> @@ -8,6 +8,8 @@ perf-config - Get and set variables in a configuration file.
> SYNOPSIS
> --------
> [verse]
> +'perf config' [<file-option>] [section.name ...]
> +or
> 'perf config' [<file-option>] -l | --list
>
> DESCRIPTION
> @@ -118,6 +120,22 @@ Given a $HOME/.perfconfig like this:
> children = true
> group = true
>
> +To query the record mode of call graph, do
> +
> + % perf config call-graph.record-mode
> +
> +If you want to know multiple config key/value pairs, you can do like
> +
> + % perf config report.queue-size call-graph.order report.children
> +
> +To query the config value of sort order of call graph in user config file (i.e. `~/.perfconfig`), do
> +
> + % perf config --user call-graph.sort-order
> +
> +To query the config value of buildid directory in system config file (i.e. `$(sysconf)/perfconfig`), do
> +
> + % perf config --system buildid.dir
> +
> Variables
> ~~~~~~~~~
>
> --
> 2.7.4