Lines Matching full:probe
1 perf-probe(1)
6 perf-probe - Define new dynamic tracepoints
11 'perf probe' [options] --add='PROBE' [...]
13 'perf probe' [options] PROBE
15 'perf probe' [options] --del='[GROUP:]EVENT' [...]
17 'perf probe' --list[=[GROUP:]EVENT]
19 'perf probe' [options] --line='LINE'
21 'perf probe' [options] --vars='PROBEPOINT'
23 'perf probe' [options] --funcs
25 'perf probe' [options] --definition='PROBE' [...]
44 Specify module name in which perf-probe searches probe points
45 or lines. If a path of module file is passed, perf-probe
46 treat it as an offline module (this means you can add a probe on
65 Define a probe event (see PROBE SYNTAX for detail).
69 Delete probe events. This accepts glob wildcards('*', '?') and character
74 List up current probe events. This can also accept filtering patterns of
86 Show available local variables at given probe point. The argument
87 syntax is same as PROBE SYNTAX, but NO ARGs.
105 Show trace-event definition converted from given probe-event instead
131 Set the maximum number of probe points for an event. Default is 128.
151 In absence of -m/-x options, perf probe checks if the first argument after
152 the options is an absolute path name. If its an absolute path, perf probe
153 uses it as a target module/target user space binary to probe.
155 PROBE SYNTAX
157 Probe points are defined by following syntax.
173 …tion name. You can also specify a group name by 'GROUP', if omitted, set 'probe' is used for kprob…
176 …hing pattern (see LAZY MATCHING). Note that ';PTN' must be the end of the probe point definition. …
177 It is also possible to specify a probe point by the source line number or lazy matching by using 'S…
178 'ARG' specifies the arguments of this probe point, (see PROBE ARGUMENT).
183 https://sourceware.org/gdb/onlinedocs/gdb/Static-Probe-Points.html
188 In the probe syntax, '=', '@', '+', ':' and ';' are treated as a special character. You can use a b…
189 This is useful if you need to probe on a specific versioned symbols, like @GLIBC_... suffixes, or a…
193 PROBE ARGUMENT
195 Each probe argument follows below syntax.
200 …local variables (including function parameters) which can access at given probe point. '$params' i…
201 'TYPE' casts the type of this argument (optional). If omitted, perf probe automatically set the typ…
207 …r 'u' to specify only signedness and leave its size auto-detected by perf probe. Moreover, you can…
221 probe syntax, 'SRC' means the source file path, 'ALN' is start line number,
234 This provides some sort of flexibility and robustness to probe point definitions against minor code…
242 With --filter "foo* | bar*", perf probe -V shows variables which start with "foo" or "bar".
243 …With --filter "!foo* & *bar", perf probe -V shows variables which don't start with "foo" and end w…
249 ./perf probe --line schedule
251 Add a probe on schedule() function 12th line with recording cpu local variable:
253 ./perf probe schedule:12 cpu
255 ./perf probe --add='schedule:12 cpu'
259 ./perf probe schedule*
261 ./perf probe --add='schedule*'
265 ./perf probe 'schedule;update_rq_clock*'
267 ./perf probe --add='schedule;update_rq_clock*'
271 ./perf probe --del='schedule*'
275 ./perf probe -x /bin/zsh zfree or ./perf probe /bin/zsh zfree
279 ./perf probe -x /lib/libc.so.6 malloc or ./perf probe /lib/libc.so.6 malloc
283 ./perf probe --target-ns <target pid> -x /lib64/libc.so.6 malloc
285 Add a USDT probe to a target process running in a different mount namespace
287 …./perf probe --target-ns <target pid> -x /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.121-0.b13.el7_3.x86…
289 Add a probe on specific versioned symbol by backslash escape
291 ./perf probe -x /lib64/libc-2.25.so 'malloc_get_state\@GLIBC_2.2.5'
293 Add a probe in a source file using special characters by backslash escape
295 ./perf probe -x /opt/test/a.out 'foo\+bar.c:4'
300 Since perf probe depends on ftrace (tracefs) and kallsyms (/proc/kallsyms), you have to care about …
302 …allsyms requires root or privileged user to access it, the following perf probe commands also requ…
304 …nt,mode=755 /sys/kernel/tracing/`) to allow unprivileged user to run the perf probe --list command.
306 …probe to retrieve the important information from kallsyms. You also need to set to 1 (restrict non…
308 …- Since the perf probe commands read the vmlinux (for kernel) and/or the debuginfo file (including…