perf-probe.txt 2.5 KB
Newer Older
M
Masami Hiramatsu 已提交
1 2 3 4 5 6 7 8 9 10
perf-probe(1)
=============

NAME
----
perf-probe - Define new dynamic tracepoints

SYNOPSIS
--------
[verse]
11
'perf probe' [options] --add='PROBE' [...]
12
or
13 14 15 16 17
'perf probe' [options] PROBE
or
'perf probe' [options] --del='[GROUP:]EVENT' [...]
or
'perf probe' --list
18 19
or
'perf probe' --line='FUNC[:RLN[+NUM|:RLN2]]|SRC:ALN[+NUM|:ALN2]'
M
Masami Hiramatsu 已提交
20 21 22 23 24 25 26 27 28 29 30

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::
31
--vmlinux=PATH::
M
Masami Hiramatsu 已提交
32 33 34 35 36 37
	Specify vmlinux path which has debuginfo (Dwarf binary).

-v::
--verbose::
        Be more verbose (show parsed arguments, etc).

38
-a::
39 40 41 42 43 44 45 46 47 48
--add=::
	Define a probe event (see PROBE SYNTAX for detail).

-d::
--del=::
	Delete a probe event.

-l::
--list::
	List up current probe events.
M
Masami Hiramatsu 已提交
49

50 51 52 53 54
-L::
--line=::
	Show source code lines which can be probed. This needs an argument
	which specifies a range of the source code.

M
Masami Hiramatsu 已提交
55 56 57 58
PROBE SYNTAX
------------
Probe points are defined by following syntax.

59
 "[EVENT=]FUNC[+OFFS|:RLN|%return][@SRC]|SRC:ALN [ARG ...]"
M
Masami Hiramatsu 已提交
60

61
'EVENT' specifies the name of new event, if omitted, it will be set the name of the probed function. Currently, event group name is set as 'probe'.
62 63
'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.
M
Masami Hiramatsu 已提交
64 65
'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).

66 67 68 69 70 71 72 73 74 75 76 77 78
LINE SYNTAX
-----------
Line range is descripted by following syntax.

 "FUNC[:RLN[+NUM|:RLN2]]|SRC:ALN[+NUM|:ALN2]"

FUNC specifies the function name of showing lines. 'RLN' is the start line
number from function entry line, and 'RLN2' is the end line number. As same as
probe syntax, 'SRC' means the source file path, 'ALN' is start line number,
and 'ALN2' is end line number in the file. It is also possible to specify how
many lines to show by using 'NUM'.
So, "source.c:100-120" shows lines between 100th to l20th in source.c file. And "func:10+20" shows 20 lines from 10th line of func function.

M
Masami Hiramatsu 已提交
79 80 81
SEE ALSO
--------
linkperf:perf-trace[1], linkperf:perf-record[1]