c43f9d1e61
Update Documentation/perf-probe.txt accoding to recent syntax changes. Signed-off-by: Masami Hiramatsu <mhiramat@redhat.com> Acked-by: Frederic Weisbecker <fweisbec@gmail.com> Cc: Steven Rostedt <rostedt@goodmis.org> Cc: Jim Keniston <jkenisto@us.ibm.com> Cc: Ananth N Mavinakayanahalli <ananth@in.ibm.com> Cc: Christoph Hellwig <hch@infradead.org> Cc: Frank Ch. Eigler <fche@redhat.com> Cc: Jason Baron <jbaron@redhat.com> Cc: K.Prasad <prasad@linux.vnet.ibm.com> Cc: Peter Zijlstra <peterz@infradead.org> Cc: Srikar Dronamraju <srikar@linux.vnet.ibm.com> LKML-Reference: <20091104001212.3454.19415.stgit@harusame> Signed-off-by: Ingo Molnar <mingo@elte.hu>
50 lines
1.5 KiB
Plaintext
50 lines
1.5 KiB
Plaintext
perf-probe(1)
|
|
=============
|
|
|
|
NAME
|
|
----
|
|
perf-probe - Define new dynamic tracepoints
|
|
|
|
SYNOPSIS
|
|
--------
|
|
[verse]
|
|
'perf probe' [options] --add 'PROBE' [--add 'PROBE' ...]
|
|
or
|
|
'perf probe' [options] 'PROBE' ['PROBE' ...]
|
|
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
This command defines dynamic tracepoint events, by symbol and registers
|
|
without debuginfo, or by C expressions (C line numbers, C function names,
|
|
and C local variables) with debuginfo.
|
|
|
|
|
|
OPTIONS
|
|
-------
|
|
-k::
|
|
--vmlinux=PATH::
|
|
Specify vmlinux path which has debuginfo (Dwarf binary).
|
|
|
|
-v::
|
|
--verbose::
|
|
Be more verbose (show parsed arguments, etc).
|
|
|
|
-a::
|
|
--add::
|
|
Define a probe point (see PROBE SYNTAX for detail)
|
|
|
|
PROBE SYNTAX
|
|
------------
|
|
Probe points are defined by following syntax.
|
|
|
|
"FUNC[+OFFS|:RLN|%return][@SRC]|SRC:ALN [ARG ...]"
|
|
|
|
'FUNC' specifies a probed function name, and it may have one of the following options; '+OFFS' is the offset from function entry address in bytes, 'RLN' is the relative-line number from function entry line, and '%return' means that it probes function return. In addition, 'SRC' specifies a source file which has that function.
|
|
It is also possible to specify a probe point by the source line number by using 'SRC:ALN' syntax, where 'SRC' is the source file path and 'ALN' is the line number.
|
|
'ARG' specifies the arguments of this probe point. You can use the name of local variable, or kprobe-tracer argument format (e.g. $retval, %ax, etc).
|
|
|
|
SEE ALSO
|
|
--------
|
|
linkperf:perf-trace[1], linkperf:perf-record[1]
|