The Linux Kernel Mailing List
 help / color / mirror / Atom feed
From: Taeung Song <treeze.taeung@gmail.com>
To: Arnaldo Carvalho de Melo <acme@kernel.org>
Cc: linux-kernel@vger.kernel.org, Ingo Molnar <mingo@redhat.com>,
	Taeung Song <treeze.taeung@gmail.com>,
	Namhyung Kim <namhyung@kernel.org>, Jiri Olsa <jolsa@redhat.com>
Subject: [PATCH v10 05/22] perf config: Document 'buildid.dir' variable in man page
Date: Mon,  9 Nov 2015 11:32:58 +0900	[thread overview]
Message-ID: <1447036395-18911-6-git-send-email-treeze.taeung@gmail.com> (raw)
In-Reply-To: <1447036395-18911-1-git-send-email-treeze.taeung@gmail.com>

Explain 'buildid.dir' variable.

Cc: Namhyung Kim <namhyung@kernel.org>
Cc: Jiri Olsa <jolsa@redhat.com>
Signed-off-by: Taeung Song <treeze.taeung@gmail.com>
---
 tools/perf/Documentation/perf-config.txt | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/tools/perf/Documentation/perf-config.txt b/tools/perf/Documentation/perf-config.txt
index 32eac14..ee98fca 100644
--- a/tools/perf/Documentation/perf-config.txt
+++ b/tools/perf/Documentation/perf-config.txt
@@ -151,6 +151,21 @@ tui.*, gtk.*::
 	By setting value, TUI or GTK can be enabled or not. But it is needed
 	that perf detects the required library for them during build.
 
+buildid.*::
+	buildid.dir::
+		Each executable and shared library in modern distributions comes with a
+		content based identifier that, if available, will be inserted in a
+		'perf.data' file header to, at analysis time find what is needed to do
+		symbol resolution, code annotation, etc.
+
+		The recording tools also stores a hard link or copy in a per-user
+		directory, $HOME/.debug/, of binaries, shared libraries, /proc/kallsyms
+		and /proc/kcore files to be used at analysis time.
+
+		The buildid.dir variable can be used to either change this directory
+		cache location, or to disable it altogether. If you want to disable it,
+		set buildid.dir to /dev/null. The default is $HOME/.debug
+
 SEE ALSO
 --------
 linkperf:perf[1]
-- 
1.9.1


  parent reply	other threads:[~2015-11-09  2:36 UTC|newest]

Thread overview: 25+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2015-11-09  2:32 [PATCH v10 00/22] perf tools: Add 'perf-config' command Taeung Song
2015-11-09  2:32 ` [PATCH v10 01/22] " Taeung Song
2015-11-09 13:58   ` Arnaldo Carvalho de Melo
2015-11-09 14:02     ` Arnaldo Carvalho de Melo
2015-11-09  2:32 ` [PATCH v10 02/22] perf tools: Add perf-config document Taeung Song
2015-11-09  2:32 ` [PATCH v10 03/22] perf config: Document variables for 'color' section in man page Taeung Song
2015-11-09  2:32 ` [PATCH v10 04/22] perf config: Document variables for 'tui' and 'gtk' sections " Taeung Song
2015-11-09  2:32 ` Taeung Song [this message]
2015-11-09  2:32 ` [PATCH v10 06/22] perf config: Document variables for 'annotate' section " Taeung Song
2015-11-09  2:33 ` [PATCH v10 07/22] perf config: Document variables for 'help' " Taeung Song
2015-11-09  2:33 ` [PATCH v10 08/22] perf config: Document 'hist.percentage' variable " Taeung Song
2015-11-09  2:33 ` [PATCH v10 09/22] perf config: Document 'ui.show-headers' " Taeung Song
2015-11-09  2:33 ` [PATCH v10 10/22] perf config: Document variables for 'call-graph' section " Taeung Song
2015-11-09  2:33 ` [PATCH v10 11/22] perf config: Document variables for 'report' " Taeung Song
2015-11-09  2:33 ` [PATCH v10 12/22] perf config: Document 'top.chidren' variable " Taeung Song
2015-11-09  2:33 ` [PATCH v10 13/22] perf config: Document 'man.viewer' " Taeung Song
2015-11-09  2:33 ` [PATCH v10 14/22] perf config: Document 'pager.<subcommand>' variables " Taeung Song
2015-11-09  2:33 ` [PATCH v10 15/22] perf config: Document 'kmem.default' variable " Taeung Song
2015-11-09  2:33 ` [PATCH v10 16/22] perf config: Add '--system' and '--user' options to select which config file is used Taeung Song
2015-11-09  2:33 ` [PATCH v10 17/22] perf config: Collect configs to handle config variables Taeung Song
2015-11-09  2:33 ` [PATCH v10 18/22] perf config: Add 'list-all' option to perf-config Taeung Song
2015-11-09  2:33 ` [PATCH v10 19/22] perf config: Add 'get' functionaliy Taeung Song
2015-11-09  2:33 ` [PATCH v10 20/22] perf config: Add 'set' feature Taeung Song
2015-11-09  2:33 ` [PATCH v10 21/22] perf config: normalize a value depending on default type of it Taeung Song
2015-11-09  2:33 ` [PATCH v10 22/22] perf config: Add a option 'remove' to perf-config Taeung Song

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=1447036395-18911-6-git-send-email-treeze.taeung@gmail.com \
    --to=treeze.taeung@gmail.com \
    --cc=acme@kernel.org \
    --cc=jolsa@redhat.com \
    --cc=linux-kernel@vger.kernel.org \
    --cc=mingo@redhat.com \
    --cc=namhyung@kernel.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox