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

From: Taeung Song
Date: Mon Nov 14 2016 - 11:30:56 EST




On 11/15/2016 12:51 AM, Arnaldo Carvalho de Melo wrote:
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.


I got it! :)
I'll combine getting functionality and examples getting config info as a patch.

Thanks,
Taeung


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