linux/tools/perf/Documentation
Stephane Eranian bcc84ec65a perf record: Add ability to name registers to record
This patch modifies the -I/--int-regs option to enablepassing the name
of the registers to sample on interrupt. Registers can be specified by
their symbolic names. For instance on x86, --intr-regs=ax,si.

The motivation is to reduce the size of the perf.data file and the
overhead of sampling by only collecting the registers useful to a
specific analysis. For instance, for value profiling, sampling only the
registers used to passed arguements to functions.

With no parameter, the --intr-regs still records all possible registers
based on the architecture.

To name registers, it is necessary to use the long form of the option,
i.e., --intr-regs:

  $ perf record --intr-regs=si,di,r8,r9 .....

To record any possible registers:

  $ perf record -I .....
  $ perf report --intr-regs ...

To display the register, one can use perf report -D

To list the available registers:

  $ perf record --intr-regs=\?
  available registers: AX BX CX DX SI DI BP SP IP FLAGS CS SS R8 R9 R10 R11 R12 R13 R14 R15

Signed-off-by: Stephane Eranian <eranian@google.com>
Tested-by: Arnaldo Carvalho de Melo <acme@redhat.com>
Cc: Adrian Hunter <adrian.hunter@intel.com>
Cc: Andi Kleen <ak@linux.intel.com>
Cc: David Ahern <dsahern@gmail.com>
Cc: Jiri Olsa <jolsa@redhat.com>
Cc: Kan Liang <kan.liang@intel.com>
Cc: Namhyung Kim <namhyung@kernel.org>
Cc: Peter Zijlstra <peterz@infradead.org>
Link: http://lkml.kernel.org/r/1441039273-16260-4-git-send-email-eranian@google.com
Signed-off-by: Arnaldo Carvalho de Melo <acme@redhat.com>
2015-08-31 18:01:33 -03:00
..
Build.txt
Makefile
android.txt
asciidoc.conf
callchain-overhead-calculation.txt
examples.txt
intel-bts.txt perf tools: Add Intel BTS support 2015-08-21 11:34:10 -03:00
intel-pt.txt perf tools: Update Intel PT documentation 2015-08-24 17:51:09 -03:00
itrace.txt perf tools: Put itrace options into an asciidoc include 2015-08-21 11:40:44 -03:00
jit-interface.txt
manpage-1.72.xsl
manpage-base.xsl
manpage-bold-literal.xsl
manpage-normal.xsl
manpage-suppress-sp.xsl
perf-annotate.txt
perf-archive.txt
perf-bench.txt
perf-buildid-cache.txt
perf-buildid-list.txt
perf-data.txt
perf-diff.txt
perf-evlist.txt
perf-help.txt
perf-inject.txt perf tools: Put itrace options into an asciidoc include 2015-08-21 11:40:44 -03:00
perf-kmem.txt
perf-kvm.txt
perf-list.txt
perf-lock.txt
perf-mem.txt
perf-probe.txt
perf-record.txt perf record: Add ability to name registers to record 2015-08-31 18:01:33 -03:00
perf-report.txt perf tools: Put itrace options into an asciidoc include 2015-08-21 11:40:44 -03:00
perf-sched.txt
perf-script-perl.txt
perf-script-python.txt
perf-script.txt perf script: Enable printing of interrupted machine state 2015-08-31 17:51:07 -03:00
perf-stat.txt
perf-test.txt
perf-timechart.txt
perf-top.txt perf top: Add branch annotation code to top 2015-08-06 16:39:22 -03:00
perf-trace.txt
perf.txt
perfconfig.example