diff options
Diffstat (limited to 'tools/perf/Documentation/perf-probe.txt')
-rw-r--r-- | tools/perf/Documentation/perf-probe.txt | 19 |
1 files changed, 18 insertions, 1 deletions
diff --git a/tools/perf/Documentation/perf-probe.txt b/tools/perf/Documentation/perf-probe.txt index 2780d9ce48bf..b715cb71592b 100644 --- a/tools/perf/Documentation/perf-probe.txt +++ b/tools/perf/Documentation/perf-probe.txt | |||
@@ -77,7 +77,8 @@ OPTIONS | |||
77 | 77 | ||
78 | -F:: | 78 | -F:: |
79 | --funcs:: | 79 | --funcs:: |
80 | Show available functions in given module or kernel. | 80 | Show available functions in given module or kernel. With -x/--exec, |
81 | can also list functions in a user space executable / shared library. | ||
81 | 82 | ||
82 | --filter=FILTER:: | 83 | --filter=FILTER:: |
83 | (Only for --vars and --funcs) Set filter. FILTER is a combination of glob | 84 | (Only for --vars and --funcs) Set filter. FILTER is a combination of glob |
@@ -98,6 +99,15 @@ OPTIONS | |||
98 | --max-probes:: | 99 | --max-probes:: |
99 | Set the maximum number of probe points for an event. Default is 128. | 100 | Set the maximum number of probe points for an event. Default is 128. |
100 | 101 | ||
102 | -x:: | ||
103 | --exec=PATH:: | ||
104 | Specify path to the executable or shared library file for user | ||
105 | space tracing. Can also be used with --funcs option. | ||
106 | |||
107 | In absence of -m/-x options, perf probe checks if the first argument after | ||
108 | the options is an absolute path name. If its an absolute path, perf probe | ||
109 | uses it as a target module/target user space binary to probe. | ||
110 | |||
101 | PROBE SYNTAX | 111 | PROBE SYNTAX |
102 | ------------ | 112 | ------------ |
103 | Probe points are defined by following syntax. | 113 | Probe points are defined by following syntax. |
@@ -182,6 +192,13 @@ Delete all probes on schedule(). | |||
182 | 192 | ||
183 | ./perf probe --del='schedule*' | 193 | ./perf probe --del='schedule*' |
184 | 194 | ||
195 | Add probes at zfree() function on /bin/zsh | ||
196 | |||
197 | ./perf probe -x /bin/zsh zfree or ./perf probe /bin/zsh zfree | ||
198 | |||
199 | Add probes at malloc() function on libc | ||
200 | |||
201 | ./perf probe -x /lib/libc.so.6 malloc or ./perf probe /lib/libc.so.6 malloc | ||
185 | 202 | ||
186 | SEE ALSO | 203 | SEE ALSO |
187 | -------- | 204 | -------- |