]>
Commit | Line | Data |
---|---|---|
bac5fb97 | 1 | |
bc0c38d1 SR |
2 | #ifndef _LINUX_KERNEL_TRACE_H |
3 | #define _LINUX_KERNEL_TRACE_H | |
4 | ||
5 | #include <linux/fs.h> | |
60063497 | 6 | #include <linux/atomic.h> |
bc0c38d1 SR |
7 | #include <linux/sched.h> |
8 | #include <linux/clocksource.h> | |
3928a8a2 | 9 | #include <linux/ring_buffer.h> |
bd8ac686 | 10 | #include <linux/mmiotrace.h> |
4e5292ea | 11 | #include <linux/tracepoint.h> |
d13744cd | 12 | #include <linux/ftrace.h> |
24f1e32c | 13 | #include <linux/hw_breakpoint.h> |
9504504c | 14 | #include <linux/trace_seq.h> |
af658dca | 15 | #include <linux/trace_events.h> |
52f5684c | 16 | #include <linux/compiler.h> |
19a7fe20 | 17 | #include <linux/trace_seq.h> |
9504504c | 18 | |
12ab74ee SR |
19 | #ifdef CONFIG_FTRACE_SYSCALLS |
20 | #include <asm/unistd.h> /* For NR_SYSCALLS */ | |
21 | #include <asm/syscall.h> /* some archs define it here */ | |
22 | #endif | |
23 | ||
72829bc3 TG |
24 | enum trace_type { |
25 | __TRACE_FIRST_TYPE = 0, | |
26 | ||
27 | TRACE_FN, | |
28 | TRACE_CTX, | |
29 | TRACE_WAKE, | |
30 | TRACE_STACK, | |
dd0e545f | 31 | TRACE_PRINT, |
48ead020 | 32 | TRACE_BPRINT, |
bd8ac686 PP |
33 | TRACE_MMIO_RW, |
34 | TRACE_MMIO_MAP, | |
9f029e83 | 35 | TRACE_BRANCH, |
287b6e68 FW |
36 | TRACE_GRAPH_RET, |
37 | TRACE_GRAPH_ENT, | |
02b67518 | 38 | TRACE_USER_STACK, |
c71a8961 | 39 | TRACE_BLK, |
09ae7234 | 40 | TRACE_BPUTS, |
72829bc3 | 41 | |
f0868d1e | 42 | __TRACE_LAST_TYPE, |
72829bc3 TG |
43 | }; |
44 | ||
bc0c38d1 | 45 | |
0a1c49db SR |
46 | #undef __field |
47 | #define __field(type, item) type item; | |
86387f7e | 48 | |
d7315094 SR |
49 | #undef __field_struct |
50 | #define __field_struct(type, item) __field(type, item) | |
86387f7e | 51 | |
d7315094 SR |
52 | #undef __field_desc |
53 | #define __field_desc(type, container, item) | |
02b67518 | 54 | |
0a1c49db SR |
55 | #undef __array |
56 | #define __array(type, item, size) type item[size]; | |
1427cdf0 | 57 | |
d7315094 SR |
58 | #undef __array_desc |
59 | #define __array_desc(type, container, item, size) | |
777e208d | 60 | |
0a1c49db SR |
61 | #undef __dynamic_array |
62 | #define __dynamic_array(type, item) type item[]; | |
777e208d | 63 | |
0a1c49db SR |
64 | #undef F_STRUCT |
65 | #define F_STRUCT(args...) args | |
74239072 | 66 | |
0a1c49db | 67 | #undef FTRACE_ENTRY |
02aa3162 JO |
68 | #define FTRACE_ENTRY(name, struct_name, id, tstruct, print, filter) \ |
69 | struct struct_name { \ | |
70 | struct trace_entry ent; \ | |
71 | tstruct \ | |
0a1c49db | 72 | } |
777e208d | 73 | |
0a1c49db | 74 | #undef FTRACE_ENTRY_DUP |
02aa3162 | 75 | #define FTRACE_ENTRY_DUP(name, name_struct, id, tstruct, printk, filter) |
1e9b51c2 | 76 | |
e59a0bff | 77 | #undef FTRACE_ENTRY_REG |
02aa3162 JO |
78 | #define FTRACE_ENTRY_REG(name, struct_name, id, tstruct, print, \ |
79 | filter, regfn) \ | |
80 | FTRACE_ENTRY(name, struct_name, id, PARAMS(tstruct), PARAMS(print), \ | |
81 | filter) | |
e59a0bff | 82 | |
0a1c49db | 83 | #include "trace_entries.h" |
36994e58 | 84 | |
0a1c49db SR |
85 | /* |
86 | * syscalls are special, and need special handling, this is why | |
87 | * they are not included in trace_entries.h | |
88 | */ | |
bed1ffca FW |
89 | struct syscall_trace_enter { |
90 | struct trace_entry ent; | |
91 | int nr; | |
92 | unsigned long args[]; | |
93 | }; | |
94 | ||
95 | struct syscall_trace_exit { | |
96 | struct trace_entry ent; | |
97 | int nr; | |
99df5a6a | 98 | long ret; |
bed1ffca FW |
99 | }; |
100 | ||
93ccae7a | 101 | struct kprobe_trace_entry_head { |
413d37d1 MH |
102 | struct trace_entry ent; |
103 | unsigned long ip; | |
413d37d1 MH |
104 | }; |
105 | ||
93ccae7a | 106 | struct kretprobe_trace_entry_head { |
413d37d1 MH |
107 | struct trace_entry ent; |
108 | unsigned long func; | |
109 | unsigned long ret_ip; | |
413d37d1 MH |
110 | }; |
111 | ||
fc5e27ae PP |
112 | /* |
113 | * trace_flag_type is an enumeration that holds different | |
114 | * states when a trace occurs. These are: | |
9244489a | 115 | * IRQS_OFF - interrupts were disabled |
9de36825 | 116 | * IRQS_NOSUPPORT - arch does not support irqs_disabled_flags |
bd9cfca9 | 117 | * NEED_RESCHED - reschedule is requested |
9244489a SR |
118 | * HARDIRQ - inside an interrupt handler |
119 | * SOFTIRQ - inside a softirq handler | |
fc5e27ae PP |
120 | */ |
121 | enum trace_flag_type { | |
122 | TRACE_FLAG_IRQS_OFF = 0x01, | |
9244489a SR |
123 | TRACE_FLAG_IRQS_NOSUPPORT = 0x02, |
124 | TRACE_FLAG_NEED_RESCHED = 0x04, | |
125 | TRACE_FLAG_HARDIRQ = 0x08, | |
126 | TRACE_FLAG_SOFTIRQ = 0x10, | |
e5137b50 | 127 | TRACE_FLAG_PREEMPT_RESCHED = 0x20, |
7e6867bf | 128 | TRACE_FLAG_NMI = 0x40, |
fc5e27ae PP |
129 | }; |
130 | ||
5bf9a1ee | 131 | #define TRACE_BUF_SIZE 1024 |
bc0c38d1 | 132 | |
2b6080f2 SR |
133 | struct trace_array; |
134 | ||
bc0c38d1 SR |
135 | /* |
136 | * The CPU trace array - it consists of thousands of trace entries | |
137 | * plus some other descriptor data: (for example which task started | |
138 | * the trace, etc.) | |
139 | */ | |
140 | struct trace_array_cpu { | |
bc0c38d1 | 141 | atomic_t disabled; |
2cadf913 | 142 | void *buffer_page; /* ring buffer spare */ |
4e3c3333 | 143 | |
438ced17 | 144 | unsigned long entries; |
bc0c38d1 SR |
145 | unsigned long saved_latency; |
146 | unsigned long critical_start; | |
147 | unsigned long critical_end; | |
148 | unsigned long critical_sequence; | |
149 | unsigned long nice; | |
150 | unsigned long policy; | |
151 | unsigned long rt_priority; | |
2f26ebd5 | 152 | unsigned long skipped_entries; |
bc0c38d1 SR |
153 | cycle_t preempt_timestamp; |
154 | pid_t pid; | |
d20b92ab | 155 | kuid_t uid; |
bc0c38d1 | 156 | char comm[TASK_COMM_LEN]; |
3fdaf80f SRRH |
157 | |
158 | bool ignore_pid; | |
bc0c38d1 SR |
159 | }; |
160 | ||
2b6080f2 | 161 | struct tracer; |
37aea98b | 162 | struct trace_option_dentry; |
2b6080f2 | 163 | |
12883efb SRRH |
164 | struct trace_buffer { |
165 | struct trace_array *tr; | |
166 | struct ring_buffer *buffer; | |
167 | struct trace_array_cpu __percpu *data; | |
168 | cycle_t time_start; | |
169 | int cpu; | |
170 | }; | |
171 | ||
9a38a885 SRRH |
172 | #define TRACE_FLAGS_MAX_SIZE 32 |
173 | ||
37aea98b SRRH |
174 | struct trace_options { |
175 | struct tracer *tracer; | |
176 | struct trace_option_dentry *topts; | |
177 | }; | |
178 | ||
49090107 | 179 | struct trace_pid_list { |
f4d34a87 SR |
180 | int pid_max; |
181 | unsigned long *pids; | |
49090107 SRRH |
182 | }; |
183 | ||
bc0c38d1 SR |
184 | /* |
185 | * The trace array - an array of per-CPU trace arrays. This is the | |
186 | * highest level data structure that individual tracers deal with. | |
187 | * They have on/off state as well: | |
188 | */ | |
189 | struct trace_array { | |
ae63b31e | 190 | struct list_head list; |
277ba044 | 191 | char *name; |
12883efb SRRH |
192 | struct trace_buffer trace_buffer; |
193 | #ifdef CONFIG_TRACER_MAX_TRACE | |
194 | /* | |
195 | * The max_buffer is used to snapshot the trace when a maximum | |
196 | * latency is reached, or when the user initiates a snapshot. | |
197 | * Some tracers will use this to store a maximum trace while | |
198 | * it continues examining live traces. | |
199 | * | |
200 | * The buffers for the max_buffer are set up the same as the trace_buffer | |
201 | * When a snapshot is taken, the buffer of the max_buffer is swapped | |
202 | * with the buffer of the trace_buffer and the buffers are reset for | |
203 | * the trace_buffer so the tracing can continue. | |
204 | */ | |
205 | struct trace_buffer max_buffer; | |
45ad21ca | 206 | bool allocated_snapshot; |
6d9b3fa5 | 207 | unsigned long max_latency; |
12883efb | 208 | #endif |
49090107 | 209 | struct trace_pid_list __rcu *filtered_pids; |
0b9b12c1 SRRH |
210 | /* |
211 | * max_lock is used to protect the swapping of buffers | |
212 | * when taking a max snapshot. The buffers themselves are | |
213 | * protected by per_cpu spinlocks. But the action of the swap | |
214 | * needs its own lock. | |
215 | * | |
216 | * This is defined as a arch_spinlock_t in order to help | |
217 | * with performance when lockdep debugging is enabled. | |
218 | * | |
219 | * It is also used in other places outside the update_max_tr | |
220 | * so it needs to be defined outside of the | |
221 | * CONFIG_TRACER_MAX_TRACE. | |
222 | */ | |
223 | arch_spinlock_t max_lock; | |
499e5470 | 224 | int buffer_disabled; |
12ab74ee SR |
225 | #ifdef CONFIG_FTRACE_SYSCALLS |
226 | int sys_refcount_enter; | |
227 | int sys_refcount_exit; | |
7f1d2f82 SRRH |
228 | struct trace_event_file __rcu *enter_syscall_files[NR_syscalls]; |
229 | struct trace_event_file __rcu *exit_syscall_files[NR_syscalls]; | |
12ab74ee | 230 | #endif |
2b6080f2 SR |
231 | int stop_count; |
232 | int clock_id; | |
37aea98b | 233 | int nr_topts; |
2b6080f2 | 234 | struct tracer *current_trace; |
983f938a | 235 | unsigned int trace_flags; |
9a38a885 | 236 | unsigned char trace_flags_index[TRACE_FLAGS_MAX_SIZE]; |
ae63b31e | 237 | unsigned int flags; |
2b6080f2 | 238 | raw_spinlock_t start_lock; |
ae63b31e | 239 | struct dentry *dir; |
2b6080f2 SR |
240 | struct dentry *options; |
241 | struct dentry *percpu_dir; | |
ae63b31e | 242 | struct dentry *event_dir; |
37aea98b | 243 | struct trace_options *topts; |
ae63b31e SR |
244 | struct list_head systems; |
245 | struct list_head events; | |
ccfe9e42 | 246 | cpumask_var_t tracing_cpumask; /* only trace on set CPUs */ |
a695cb58 | 247 | int ref; |
f20a5806 SRRH |
248 | #ifdef CONFIG_FUNCTION_TRACER |
249 | struct ftrace_ops *ops; | |
250 | /* function tracing enabled */ | |
251 | int function_enabled; | |
252 | #endif | |
bc0c38d1 SR |
253 | }; |
254 | ||
ae63b31e SR |
255 | enum { |
256 | TRACE_ARRAY_FL_GLOBAL = (1 << 0) | |
257 | }; | |
258 | ||
259 | extern struct list_head ftrace_trace_arrays; | |
260 | ||
a8227415 AL |
261 | extern struct mutex trace_types_lock; |
262 | ||
8e2e2fa4 SRRH |
263 | extern int trace_array_get(struct trace_array *tr); |
264 | extern void trace_array_put(struct trace_array *tr); | |
265 | ||
ae63b31e SR |
266 | /* |
267 | * The global tracer (top) should be the first trace array added, | |
268 | * but we check the flag anyway. | |
269 | */ | |
270 | static inline struct trace_array *top_trace_array(void) | |
271 | { | |
272 | struct trace_array *tr; | |
273 | ||
da9c3413 | 274 | if (list_empty(&ftrace_trace_arrays)) |
dc81e5e3 YY |
275 | return NULL; |
276 | ||
ae63b31e SR |
277 | tr = list_entry(ftrace_trace_arrays.prev, |
278 | typeof(*tr), list); | |
279 | WARN_ON(!(tr->flags & TRACE_ARRAY_FL_GLOBAL)); | |
280 | return tr; | |
281 | } | |
282 | ||
7104f300 SR |
283 | #define FTRACE_CMP_TYPE(var, type) \ |
284 | __builtin_types_compatible_p(typeof(var), type *) | |
285 | ||
286 | #undef IF_ASSIGN | |
287 | #define IF_ASSIGN(var, entry, etype, id) \ | |
288 | if (FTRACE_CMP_TYPE(var, etype)) { \ | |
289 | var = (typeof(var))(entry); \ | |
290 | WARN_ON(id && (entry)->type != id); \ | |
291 | break; \ | |
292 | } | |
293 | ||
294 | /* Will cause compile errors if type is not found. */ | |
295 | extern void __ftrace_bad_type(void); | |
296 | ||
297 | /* | |
298 | * The trace_assign_type is a verifier that the entry type is | |
299 | * the same as the type being assigned. To add new types simply | |
300 | * add a line with the following format: | |
301 | * | |
302 | * IF_ASSIGN(var, ent, type, id); | |
303 | * | |
304 | * Where "type" is the trace type that includes the trace_entry | |
305 | * as the "ent" item. And "id" is the trace identifier that is | |
306 | * used in the trace_type enum. | |
307 | * | |
308 | * If the type can have more than one id, then use zero. | |
309 | */ | |
310 | #define trace_assign_type(var, ent) \ | |
311 | do { \ | |
312 | IF_ASSIGN(var, ent, struct ftrace_entry, TRACE_FN); \ | |
313 | IF_ASSIGN(var, ent, struct ctx_switch_entry, 0); \ | |
7104f300 | 314 | IF_ASSIGN(var, ent, struct stack_entry, TRACE_STACK); \ |
02b67518 | 315 | IF_ASSIGN(var, ent, struct userstack_entry, TRACE_USER_STACK);\ |
7104f300 | 316 | IF_ASSIGN(var, ent, struct print_entry, TRACE_PRINT); \ |
48ead020 | 317 | IF_ASSIGN(var, ent, struct bprint_entry, TRACE_BPRINT); \ |
09ae7234 | 318 | IF_ASSIGN(var, ent, struct bputs_entry, TRACE_BPUTS); \ |
7104f300 SR |
319 | IF_ASSIGN(var, ent, struct trace_mmiotrace_rw, \ |
320 | TRACE_MMIO_RW); \ | |
321 | IF_ASSIGN(var, ent, struct trace_mmiotrace_map, \ | |
322 | TRACE_MMIO_MAP); \ | |
9f029e83 | 323 | IF_ASSIGN(var, ent, struct trace_branch, TRACE_BRANCH); \ |
287b6e68 FW |
324 | IF_ASSIGN(var, ent, struct ftrace_graph_ent_entry, \ |
325 | TRACE_GRAPH_ENT); \ | |
326 | IF_ASSIGN(var, ent, struct ftrace_graph_ret_entry, \ | |
327 | TRACE_GRAPH_RET); \ | |
7104f300 SR |
328 | __ftrace_bad_type(); \ |
329 | } while (0) | |
2c4f035f | 330 | |
adf9f195 FW |
331 | /* |
332 | * An option specific to a tracer. This is a boolean value. | |
333 | * The bit is the bit index that sets its value on the | |
334 | * flags value in struct tracer_flags. | |
335 | */ | |
336 | struct tracer_opt { | |
9de36825 IM |
337 | const char *name; /* Will appear on the trace_options file */ |
338 | u32 bit; /* Mask assigned in val field in tracer_flags */ | |
adf9f195 FW |
339 | }; |
340 | ||
341 | /* | |
342 | * The set of specific options for a tracer. Your tracer | |
343 | * have to set the initial value of the flags val. | |
344 | */ | |
345 | struct tracer_flags { | |
346 | u32 val; | |
9de36825 | 347 | struct tracer_opt *opts; |
d39cdd20 | 348 | struct tracer *trace; |
adf9f195 FW |
349 | }; |
350 | ||
351 | /* Makes more easy to define a tracer opt */ | |
352 | #define TRACER_OPT(s, b) .name = #s, .bit = b | |
353 | ||
034939b6 | 354 | |
41d9c0be SRRH |
355 | struct trace_option_dentry { |
356 | struct tracer_opt *opt; | |
357 | struct tracer_flags *flags; | |
358 | struct trace_array *tr; | |
359 | struct dentry *entry; | |
360 | }; | |
361 | ||
6eaaa5d5 | 362 | /** |
8434dc93 | 363 | * struct tracer - a specific tracer and its callbacks to interact with tracefs |
6eaaa5d5 FW |
364 | * @name: the name chosen to select it on the available_tracers file |
365 | * @init: called when one switches to this tracer (echo name > current_tracer) | |
366 | * @reset: called when one switches to another tracer | |
05a724bd CH |
367 | * @start: called when tracing is unpaused (echo 1 > tracing_on) |
368 | * @stop: called when tracing is paused (echo 0 > tracing_on) | |
6508fa76 | 369 | * @update_thresh: called when tracing_thresh is updated |
6eaaa5d5 FW |
370 | * @open: called when the trace file is opened |
371 | * @pipe_open: called when the trace_pipe file is opened | |
6eaaa5d5 | 372 | * @close: called when the trace file is released |
c521efd1 | 373 | * @pipe_close: called when the trace_pipe file is released |
6eaaa5d5 FW |
374 | * @read: override the default read callback on trace_pipe |
375 | * @splice_read: override the default splice_read callback on trace_pipe | |
376 | * @selftest: selftest to run on boot (see trace_selftest.c) | |
377 | * @print_headers: override the first lines that describe your columns | |
378 | * @print_line: callback that prints a trace | |
379 | * @set_flag: signals one of your private flags changed (trace_options file) | |
380 | * @flags: your private flags | |
bc0c38d1 SR |
381 | */ |
382 | struct tracer { | |
383 | const char *name; | |
1c80025a | 384 | int (*init)(struct trace_array *tr); |
bc0c38d1 | 385 | void (*reset)(struct trace_array *tr); |
9036990d SR |
386 | void (*start)(struct trace_array *tr); |
387 | void (*stop)(struct trace_array *tr); | |
6508fa76 | 388 | int (*update_thresh)(struct trace_array *tr); |
bc0c38d1 | 389 | void (*open)(struct trace_iterator *iter); |
107bad8b | 390 | void (*pipe_open)(struct trace_iterator *iter); |
bc0c38d1 | 391 | void (*close)(struct trace_iterator *iter); |
c521efd1 | 392 | void (*pipe_close)(struct trace_iterator *iter); |
107bad8b SR |
393 | ssize_t (*read)(struct trace_iterator *iter, |
394 | struct file *filp, char __user *ubuf, | |
395 | size_t cnt, loff_t *ppos); | |
3c56819b EGM |
396 | ssize_t (*splice_read)(struct trace_iterator *iter, |
397 | struct file *filp, | |
398 | loff_t *ppos, | |
399 | struct pipe_inode_info *pipe, | |
400 | size_t len, | |
401 | unsigned int flags); | |
60a11774 SR |
402 | #ifdef CONFIG_FTRACE_STARTUP_TEST |
403 | int (*selftest)(struct tracer *trace, | |
404 | struct trace_array *tr); | |
405 | #endif | |
8bba1bf5 | 406 | void (*print_header)(struct seq_file *m); |
2c4f035f | 407 | enum print_line_t (*print_line)(struct trace_iterator *iter); |
adf9f195 | 408 | /* If you handled the flag setting, return 0 */ |
8c1a49ae SRRH |
409 | int (*set_flag)(struct trace_array *tr, |
410 | u32 old_flags, u32 bit, int set); | |
613f04a0 | 411 | /* Return 0 if OK with change, else return non-zero */ |
bf6065b5 | 412 | int (*flag_changed)(struct trace_array *tr, |
613f04a0 | 413 | u32 mask, int set); |
bc0c38d1 | 414 | struct tracer *next; |
9de36825 | 415 | struct tracer_flags *flags; |
50512ab5 | 416 | int enabled; |
cf6ab6d9 | 417 | int ref; |
f43c738b | 418 | bool print_max; |
607e2ea1 | 419 | bool allow_instances; |
12883efb | 420 | #ifdef CONFIG_TRACER_MAX_TRACE |
f43c738b | 421 | bool use_max_tr; |
12883efb | 422 | #endif |
bc0c38d1 SR |
423 | }; |
424 | ||
f9520750 | 425 | |
e4a3f541 | 426 | /* Only current can touch trace_recursion */ |
e4a3f541 | 427 | |
edc15caf SR |
428 | /* |
429 | * For function tracing recursion: | |
430 | * The order of these bits are important. | |
431 | * | |
432 | * When function tracing occurs, the following steps are made: | |
433 | * If arch does not support a ftrace feature: | |
434 | * call internal function (uses INTERNAL bits) which calls... | |
435 | * If callback is registered to the "global" list, the list | |
436 | * function is called and recursion checks the GLOBAL bits. | |
437 | * then this function calls... | |
438 | * The function callback, which can use the FTRACE bits to | |
439 | * check for recursion. | |
440 | * | |
441 | * Now if the arch does not suppport a feature, and it calls | |
442 | * the global list function which calls the ftrace callback | |
443 | * all three of these steps will do a recursion protection. | |
444 | * There's no reason to do one if the previous caller already | |
445 | * did. The recursion that we are protecting against will | |
446 | * go through the same steps again. | |
447 | * | |
448 | * To prevent the multiple recursion checks, if a recursion | |
449 | * bit is set that is higher than the MAX bit of the current | |
450 | * check, then we know that the check was made by the previous | |
451 | * caller, and we can skip the current check. | |
452 | */ | |
e46cbf75 | 453 | enum { |
567cd4da SR |
454 | TRACE_BUFFER_BIT, |
455 | TRACE_BUFFER_NMI_BIT, | |
456 | TRACE_BUFFER_IRQ_BIT, | |
457 | TRACE_BUFFER_SIRQ_BIT, | |
458 | ||
459 | /* Start of function recursion bits */ | |
460 | TRACE_FTRACE_BIT, | |
edc15caf SR |
461 | TRACE_FTRACE_NMI_BIT, |
462 | TRACE_FTRACE_IRQ_BIT, | |
463 | TRACE_FTRACE_SIRQ_BIT, | |
e46cbf75 | 464 | |
4104d326 | 465 | /* INTERNAL_BITs must be greater than FTRACE_BITs */ |
edc15caf SR |
466 | TRACE_INTERNAL_BIT, |
467 | TRACE_INTERNAL_NMI_BIT, | |
468 | TRACE_INTERNAL_IRQ_BIT, | |
469 | TRACE_INTERNAL_SIRQ_BIT, | |
470 | ||
6224beb1 | 471 | TRACE_BRANCH_BIT, |
e4a3f541 SR |
472 | /* |
473 | * Abuse of the trace_recursion. | |
474 | * As we need a way to maintain state if we are tracing the function | |
475 | * graph in irq because we want to trace a particular function that | |
476 | * was called in irq context but we have irq tracing off. Since this | |
477 | * can only be modified by current, we can reuse trace_recursion. | |
478 | */ | |
e46cbf75 SR |
479 | TRACE_IRQ_BIT, |
480 | }; | |
e4a3f541 | 481 | |
e46cbf75 SR |
482 | #define trace_recursion_set(bit) do { (current)->trace_recursion |= (1<<(bit)); } while (0) |
483 | #define trace_recursion_clear(bit) do { (current)->trace_recursion &= ~(1<<(bit)); } while (0) | |
484 | #define trace_recursion_test(bit) ((current)->trace_recursion & (1<<(bit))) | |
e4a3f541 | 485 | |
edc15caf SR |
486 | #define TRACE_CONTEXT_BITS 4 |
487 | ||
488 | #define TRACE_FTRACE_START TRACE_FTRACE_BIT | |
489 | #define TRACE_FTRACE_MAX ((1 << (TRACE_FTRACE_START + TRACE_CONTEXT_BITS)) - 1) | |
490 | ||
edc15caf SR |
491 | #define TRACE_LIST_START TRACE_INTERNAL_BIT |
492 | #define TRACE_LIST_MAX ((1 << (TRACE_LIST_START + TRACE_CONTEXT_BITS)) - 1) | |
493 | ||
494 | #define TRACE_CONTEXT_MASK TRACE_LIST_MAX | |
495 | ||
496 | static __always_inline int trace_get_context_bit(void) | |
497 | { | |
498 | int bit; | |
499 | ||
500 | if (in_interrupt()) { | |
501 | if (in_nmi()) | |
502 | bit = 0; | |
503 | ||
504 | else if (in_irq()) | |
505 | bit = 1; | |
506 | else | |
507 | bit = 2; | |
508 | } else | |
509 | bit = 3; | |
510 | ||
511 | return bit; | |
512 | } | |
513 | ||
514 | static __always_inline int trace_test_and_set_recursion(int start, int max) | |
515 | { | |
516 | unsigned int val = current->trace_recursion; | |
517 | int bit; | |
518 | ||
519 | /* A previous recursion check was made */ | |
520 | if ((val & TRACE_CONTEXT_MASK) > max) | |
521 | return 0; | |
522 | ||
523 | bit = trace_get_context_bit() + start; | |
524 | if (unlikely(val & (1 << bit))) | |
525 | return -1; | |
526 | ||
527 | val |= 1 << bit; | |
528 | current->trace_recursion = val; | |
529 | barrier(); | |
530 | ||
531 | return bit; | |
532 | } | |
533 | ||
534 | static __always_inline void trace_clear_recursion(int bit) | |
535 | { | |
536 | unsigned int val = current->trace_recursion; | |
537 | ||
538 | if (!bit) | |
539 | return; | |
540 | ||
541 | bit = 1 << bit; | |
542 | val &= ~bit; | |
543 | ||
544 | barrier(); | |
545 | current->trace_recursion = val; | |
546 | } | |
547 | ||
6d158a81 SR |
548 | static inline struct ring_buffer_iter * |
549 | trace_buffer_iter(struct trace_iterator *iter, int cpu) | |
550 | { | |
551 | if (iter->buffer_iter && iter->buffer_iter[cpu]) | |
552 | return iter->buffer_iter[cpu]; | |
553 | return NULL; | |
554 | } | |
555 | ||
b6f11df2 | 556 | int tracer_init(struct tracer *t, struct trace_array *tr); |
9036990d | 557 | int tracing_is_enabled(void); |
12883efb SRRH |
558 | void tracing_reset(struct trace_buffer *buf, int cpu); |
559 | void tracing_reset_online_cpus(struct trace_buffer *buf); | |
9456f0fa | 560 | void tracing_reset_current(int cpu); |
873c642f | 561 | void tracing_reset_all_online_cpus(void); |
bc0c38d1 | 562 | int tracing_open_generic(struct inode *inode, struct file *filp); |
2e86421d | 563 | bool tracing_is_disabled(void); |
5452af66 | 564 | struct dentry *trace_create_file(const char *name, |
f4ae40a6 | 565 | umode_t mode, |
5452af66 FW |
566 | struct dentry *parent, |
567 | void *data, | |
568 | const struct file_operations *fops); | |
569 | ||
bc0c38d1 | 570 | struct dentry *tracing_init_dentry(void); |
d618b3e6 | 571 | |
51a763dd ACM |
572 | struct ring_buffer_event; |
573 | ||
e77405ad SR |
574 | struct ring_buffer_event * |
575 | trace_buffer_lock_reserve(struct ring_buffer *buffer, | |
576 | int type, | |
577 | unsigned long len, | |
578 | unsigned long flags, | |
579 | int pc); | |
51a763dd | 580 | |
45dcd8b8 PP |
581 | struct trace_entry *tracing_get_trace_entry(struct trace_array *tr, |
582 | struct trace_array_cpu *data); | |
c4a8e8be FW |
583 | |
584 | struct trace_entry *trace_find_next_entry(struct trace_iterator *iter, | |
585 | int *ent_cpu, u64 *ent_ts); | |
586 | ||
7ffbd48d SR |
587 | void __buffer_unlock_commit(struct ring_buffer *buffer, |
588 | struct ring_buffer_event *event); | |
589 | ||
955b61e5 JW |
590 | int trace_empty(struct trace_iterator *iter); |
591 | ||
592 | void *trace_find_next_entry_inc(struct trace_iterator *iter); | |
593 | ||
594 | void trace_init_global_iter(struct trace_iterator *iter); | |
595 | ||
596 | void tracing_iter_reset(struct trace_iterator *iter, int cpu); | |
597 | ||
6fb44b71 | 598 | void trace_function(struct trace_array *tr, |
6fb44b71 SR |
599 | unsigned long ip, |
600 | unsigned long parent_ip, | |
38697053 | 601 | unsigned long flags, int pc); |
0a772620 JO |
602 | void trace_graph_function(struct trace_array *tr, |
603 | unsigned long ip, | |
604 | unsigned long parent_ip, | |
605 | unsigned long flags, int pc); | |
7e9a49ef | 606 | void trace_latency_header(struct seq_file *m); |
62b915f1 JO |
607 | void trace_default_header(struct seq_file *m); |
608 | void print_trace_header(struct seq_file *m, struct trace_iterator *iter); | |
609 | int trace_empty(struct trace_iterator *iter); | |
bc0c38d1 | 610 | |
287b6e68 | 611 | void trace_graph_return(struct ftrace_graph_ret *trace); |
e49dc19c | 612 | int trace_graph_entry(struct ftrace_graph_ent *trace); |
1a0799a8 | 613 | void set_graph_array(struct trace_array *tr); |
1e9b51c2 | 614 | |
41bc8144 SR |
615 | void tracing_start_cmdline_record(void); |
616 | void tracing_stop_cmdline_record(void); | |
bc0c38d1 | 617 | int register_tracer(struct tracer *type); |
b5130b1e | 618 | int is_tracing_stopped(void); |
955b61e5 | 619 | |
098c879e SRRH |
620 | loff_t tracing_lseek(struct file *file, loff_t offset, int whence); |
621 | ||
955b61e5 JW |
622 | extern cpumask_var_t __read_mostly tracing_buffer_mask; |
623 | ||
624 | #define for_each_tracing_cpu(cpu) \ | |
625 | for_each_cpu(cpu, tracing_buffer_mask) | |
bc0c38d1 SR |
626 | |
627 | extern unsigned long nsecs_to_usecs(unsigned long nsecs); | |
628 | ||
0e950173 TB |
629 | extern unsigned long tracing_thresh; |
630 | ||
4e267db1 SR |
631 | /* PID filtering */ |
632 | bool trace_find_filtered_pid(struct trace_pid_list *filtered_pids, | |
633 | pid_t search_pid); | |
634 | bool trace_ignore_this_task(struct trace_pid_list *filtered_pids, | |
635 | struct task_struct *task); | |
636 | void trace_filter_add_remove_task(struct trace_pid_list *pid_list, | |
637 | struct task_struct *self, | |
638 | struct task_struct *task); | |
639 | ||
5d4a9dba | 640 | #ifdef CONFIG_TRACER_MAX_TRACE |
bc0c38d1 SR |
641 | void update_max_tr(struct trace_array *tr, struct task_struct *tsk, int cpu); |
642 | void update_max_tr_single(struct trace_array *tr, | |
643 | struct task_struct *tsk, int cpu); | |
5d4a9dba | 644 | #endif /* CONFIG_TRACER_MAX_TRACE */ |
bc0c38d1 | 645 | |
c0a0d0d3 | 646 | #ifdef CONFIG_STACKTRACE |
e77405ad | 647 | void ftrace_trace_userstack(struct ring_buffer *buffer, unsigned long flags, |
c0a0d0d3 FW |
648 | int pc); |
649 | ||
650 | void __trace_stack(struct trace_array *tr, unsigned long flags, int skip, | |
651 | int pc); | |
652 | #else | |
e1f7992e | 653 | static inline void ftrace_trace_userstack(struct ring_buffer *buffer, |
c0a0d0d3 FW |
654 | unsigned long flags, int pc) |
655 | { | |
656 | } | |
657 | ||
658 | static inline void __trace_stack(struct trace_array *tr, unsigned long flags, | |
659 | int skip, int pc) | |
660 | { | |
661 | } | |
662 | #endif /* CONFIG_STACKTRACE */ | |
53614991 | 663 | |
e309b41d | 664 | extern cycle_t ftrace_now(int cpu); |
bc0c38d1 | 665 | |
4ca53085 | 666 | extern void trace_find_cmdline(int pid, char comm[]); |
c37775d5 | 667 | extern void trace_event_follow_fork(struct trace_array *tr, bool enable); |
f7d48cbd | 668 | |
bc0c38d1 SR |
669 | #ifdef CONFIG_DYNAMIC_FTRACE |
670 | extern unsigned long ftrace_update_tot_cnt; | |
ad97772a | 671 | #endif |
d05cdb25 SR |
672 | #define DYN_FTRACE_TEST_NAME trace_selftest_dynamic_test_func |
673 | extern int DYN_FTRACE_TEST_NAME(void); | |
95950c2e SR |
674 | #define DYN_FTRACE_TEST_NAME2 trace_selftest_dynamic_test_func2 |
675 | extern int DYN_FTRACE_TEST_NAME2(void); | |
bc0c38d1 | 676 | |
55034cd6 | 677 | extern bool ring_buffer_expanded; |
020e5f85 LZ |
678 | extern bool tracing_selftest_disabled; |
679 | ||
60a11774 | 680 | #ifdef CONFIG_FTRACE_STARTUP_TEST |
60a11774 SR |
681 | extern int trace_selftest_startup_function(struct tracer *trace, |
682 | struct trace_array *tr); | |
7447dce9 FW |
683 | extern int trace_selftest_startup_function_graph(struct tracer *trace, |
684 | struct trace_array *tr); | |
60a11774 SR |
685 | extern int trace_selftest_startup_irqsoff(struct tracer *trace, |
686 | struct trace_array *tr); | |
60a11774 SR |
687 | extern int trace_selftest_startup_preemptoff(struct tracer *trace, |
688 | struct trace_array *tr); | |
60a11774 SR |
689 | extern int trace_selftest_startup_preemptirqsoff(struct tracer *trace, |
690 | struct trace_array *tr); | |
60a11774 SR |
691 | extern int trace_selftest_startup_wakeup(struct tracer *trace, |
692 | struct trace_array *tr); | |
fb1b6d8b SN |
693 | extern int trace_selftest_startup_nop(struct tracer *trace, |
694 | struct trace_array *tr); | |
60a11774 SR |
695 | extern int trace_selftest_startup_sched_switch(struct tracer *trace, |
696 | struct trace_array *tr); | |
80e5ea45 SR |
697 | extern int trace_selftest_startup_branch(struct tracer *trace, |
698 | struct trace_array *tr); | |
8f768993 SRRH |
699 | /* |
700 | * Tracer data references selftest functions that only occur | |
701 | * on boot up. These can be __init functions. Thus, when selftests | |
702 | * are enabled, then the tracers need to reference __init functions. | |
703 | */ | |
704 | #define __tracer_data __refdata | |
705 | #else | |
706 | /* Tracers are seldom changed. Optimize when selftests are disabled. */ | |
707 | #define __tracer_data __read_mostly | |
60a11774 SR |
708 | #endif /* CONFIG_FTRACE_STARTUP_TEST */ |
709 | ||
c7aafc54 | 710 | extern void *head_page(struct trace_array_cpu *data); |
cf8e3474 | 711 | extern unsigned long long ns2usecs(cycle_t nsec); |
1fd8f2a3 | 712 | extern int |
40ce74f1 | 713 | trace_vbprintk(unsigned long ip, const char *fmt, va_list args); |
48ead020 | 714 | extern int |
40ce74f1 | 715 | trace_vprintk(unsigned long ip, const char *fmt, va_list args); |
659372d3 SR |
716 | extern int |
717 | trace_array_vprintk(struct trace_array *tr, | |
718 | unsigned long ip, const char *fmt, va_list args); | |
719 | int trace_array_printk(struct trace_array *tr, | |
720 | unsigned long ip, const char *fmt, ...); | |
12883efb SRRH |
721 | int trace_array_printk_buf(struct ring_buffer *buffer, |
722 | unsigned long ip, const char *fmt, ...); | |
955b61e5 JW |
723 | void trace_printk_seq(struct trace_seq *s); |
724 | enum print_line_t print_trace_line(struct trace_iterator *iter); | |
c7aafc54 | 725 | |
8e1e1df2 BP |
726 | extern char trace_find_mark(unsigned long long duration); |
727 | ||
15e6cb36 | 728 | /* Standard output formatting function used for function return traces */ |
fb52607a | 729 | #ifdef CONFIG_FUNCTION_GRAPH_TRACER |
62b915f1 JO |
730 | |
731 | /* Flag options */ | |
732 | #define TRACE_GRAPH_PRINT_OVERRUN 0x1 | |
733 | #define TRACE_GRAPH_PRINT_CPU 0x2 | |
734 | #define TRACE_GRAPH_PRINT_OVERHEAD 0x4 | |
735 | #define TRACE_GRAPH_PRINT_PROC 0x8 | |
736 | #define TRACE_GRAPH_PRINT_DURATION 0x10 | |
737 | #define TRACE_GRAPH_PRINT_ABS_TIME 0x20 | |
ccdb5946 | 738 | #define TRACE_GRAPH_PRINT_IRQS 0x40 |
607e3a29 | 739 | #define TRACE_GRAPH_PRINT_TAIL 0x80 |
55577204 SRRH |
740 | #define TRACE_GRAPH_SLEEP_TIME 0x100 |
741 | #define TRACE_GRAPH_GRAPH_TIME 0x200 | |
6fc84ea7 SRRH |
742 | #define TRACE_GRAPH_PRINT_FILL_SHIFT 28 |
743 | #define TRACE_GRAPH_PRINT_FILL_MASK (0x3 << TRACE_GRAPH_PRINT_FILL_SHIFT) | |
62b915f1 | 744 | |
55577204 SRRH |
745 | extern void ftrace_graph_sleep_time_control(bool enable); |
746 | extern void ftrace_graph_graph_time_control(bool enable); | |
747 | ||
d7a8d9e9 JO |
748 | extern enum print_line_t |
749 | print_graph_function_flags(struct trace_iterator *iter, u32 flags); | |
750 | extern void print_graph_headers_flags(struct seq_file *s, u32 flags); | |
9d9add34 | 751 | extern void |
0706f1c4 | 752 | trace_print_graph_duration(unsigned long long duration, struct trace_seq *s); |
62b915f1 JO |
753 | extern void graph_trace_open(struct trace_iterator *iter); |
754 | extern void graph_trace_close(struct trace_iterator *iter); | |
755 | extern int __trace_graph_entry(struct trace_array *tr, | |
756 | struct ftrace_graph_ent *trace, | |
757 | unsigned long flags, int pc); | |
758 | extern void __trace_graph_return(struct trace_array *tr, | |
759 | struct ftrace_graph_ret *trace, | |
760 | unsigned long flags, int pc); | |
761 | ||
ea4e2bc4 SR |
762 | |
763 | #ifdef CONFIG_DYNAMIC_FTRACE | |
764 | /* TODO: make this variable */ | |
765 | #define FTRACE_GRAPH_MAX_FUNCS 32 | |
766 | extern int ftrace_graph_count; | |
767 | extern unsigned long ftrace_graph_funcs[FTRACE_GRAPH_MAX_FUNCS]; | |
29ad23b0 NK |
768 | extern int ftrace_graph_notrace_count; |
769 | extern unsigned long ftrace_graph_notrace_funcs[FTRACE_GRAPH_MAX_FUNCS]; | |
ea4e2bc4 SR |
770 | |
771 | static inline int ftrace_graph_addr(unsigned long addr) | |
772 | { | |
773 | int i; | |
774 | ||
9aa72b4b | 775 | if (!ftrace_graph_count) |
ea4e2bc4 SR |
776 | return 1; |
777 | ||
778 | for (i = 0; i < ftrace_graph_count; i++) { | |
e4a3f541 SR |
779 | if (addr == ftrace_graph_funcs[i]) { |
780 | /* | |
781 | * If no irqs are to be traced, but a set_graph_function | |
782 | * is set, and called by an interrupt handler, we still | |
783 | * want to trace it. | |
784 | */ | |
785 | if (in_irq()) | |
786 | trace_recursion_set(TRACE_IRQ_BIT); | |
787 | else | |
788 | trace_recursion_clear(TRACE_IRQ_BIT); | |
ea4e2bc4 | 789 | return 1; |
e4a3f541 | 790 | } |
ea4e2bc4 SR |
791 | } |
792 | ||
793 | return 0; | |
794 | } | |
29ad23b0 NK |
795 | |
796 | static inline int ftrace_graph_notrace_addr(unsigned long addr) | |
797 | { | |
798 | int i; | |
799 | ||
800 | if (!ftrace_graph_notrace_count) | |
801 | return 0; | |
802 | ||
803 | for (i = 0; i < ftrace_graph_notrace_count; i++) { | |
804 | if (addr == ftrace_graph_notrace_funcs[i]) | |
805 | return 1; | |
806 | } | |
807 | ||
808 | return 0; | |
809 | } | |
15e6cb36 | 810 | #else |
6b253930 IM |
811 | static inline int ftrace_graph_addr(unsigned long addr) |
812 | { | |
813 | return 1; | |
ea4e2bc4 | 814 | } |
29ad23b0 NK |
815 | |
816 | static inline int ftrace_graph_notrace_addr(unsigned long addr) | |
817 | { | |
818 | return 0; | |
819 | } | |
ea4e2bc4 | 820 | #endif /* CONFIG_DYNAMIC_FTRACE */ |
ea4e2bc4 | 821 | #else /* CONFIG_FUNCTION_GRAPH_TRACER */ |
15e6cb36 | 822 | static inline enum print_line_t |
d7a8d9e9 | 823 | print_graph_function_flags(struct trace_iterator *iter, u32 flags) |
15e6cb36 FW |
824 | { |
825 | return TRACE_TYPE_UNHANDLED; | |
826 | } | |
ea4e2bc4 | 827 | #endif /* CONFIG_FUNCTION_GRAPH_TRACER */ |
15e6cb36 | 828 | |
756d17ee | 829 | extern struct list_head ftrace_pids; |
804a6851 | 830 | |
1155de47 | 831 | #ifdef CONFIG_FUNCTION_TRACER |
f1ed7c74 | 832 | extern bool ftrace_filter_param __initdata; |
804a6851 SR |
833 | static inline int ftrace_trace_task(struct task_struct *task) |
834 | { | |
756d17ee | 835 | if (list_empty(&ftrace_pids)) |
804a6851 SR |
836 | return 1; |
837 | ||
838 | return test_tsk_trace_trace(task); | |
839 | } | |
e0a413f6 | 840 | extern int ftrace_is_dead(void); |
591dffda SRRH |
841 | int ftrace_create_function_files(struct trace_array *tr, |
842 | struct dentry *parent); | |
843 | void ftrace_destroy_function_files(struct trace_array *tr); | |
4104d326 SRRH |
844 | void ftrace_init_global_array_ops(struct trace_array *tr); |
845 | void ftrace_init_array_ops(struct trace_array *tr, ftrace_func_t func); | |
846 | void ftrace_reset_array_ops(struct trace_array *tr); | |
7eea4fce | 847 | int using_ftrace_ops_list_func(void); |
1155de47 PM |
848 | #else |
849 | static inline int ftrace_trace_task(struct task_struct *task) | |
850 | { | |
851 | return 1; | |
852 | } | |
e0a413f6 | 853 | static inline int ftrace_is_dead(void) { return 0; } |
591dffda SRRH |
854 | static inline int |
855 | ftrace_create_function_files(struct trace_array *tr, | |
856 | struct dentry *parent) | |
857 | { | |
858 | return 0; | |
859 | } | |
860 | static inline void ftrace_destroy_function_files(struct trace_array *tr) { } | |
4104d326 SRRH |
861 | static inline __init void |
862 | ftrace_init_global_array_ops(struct trace_array *tr) { } | |
863 | static inline void ftrace_reset_array_ops(struct trace_array *tr) { } | |
864 | /* ftace_func_t type is not defined, use macro instead of static inline */ | |
865 | #define ftrace_init_array_ops(tr, func) do { } while (0) | |
591dffda SRRH |
866 | #endif /* CONFIG_FUNCTION_TRACER */ |
867 | ||
868 | #if defined(CONFIG_FUNCTION_TRACER) && defined(CONFIG_DYNAMIC_FTRACE) | |
869 | void ftrace_create_filter_files(struct ftrace_ops *ops, | |
870 | struct dentry *parent); | |
871 | void ftrace_destroy_filter_files(struct ftrace_ops *ops); | |
872 | #else | |
873 | /* | |
874 | * The ops parameter passed in is usually undefined. | |
875 | * This must be a macro. | |
876 | */ | |
877 | #define ftrace_create_filter_files(ops, parent) do { } while (0) | |
878 | #define ftrace_destroy_filter_files(ops) do { } while (0) | |
879 | #endif /* CONFIG_FUNCTION_TRACER && CONFIG_DYNAMIC_FTRACE */ | |
804a6851 | 880 | |
c6650b2e | 881 | bool ftrace_event_is_function(struct trace_event_call *call); |
ced39002 | 882 | |
b63f39ea | 883 | /* |
884 | * struct trace_parser - servers for reading the user input separated by spaces | |
885 | * @cont: set if the input is not complete - no final space char was found | |
886 | * @buffer: holds the parsed user input | |
1537a363 | 887 | * @idx: user input length |
b63f39ea | 888 | * @size: buffer size |
889 | */ | |
890 | struct trace_parser { | |
891 | bool cont; | |
892 | char *buffer; | |
893 | unsigned idx; | |
894 | unsigned size; | |
895 | }; | |
896 | ||
897 | static inline bool trace_parser_loaded(struct trace_parser *parser) | |
898 | { | |
899 | return (parser->idx != 0); | |
900 | } | |
901 | ||
902 | static inline bool trace_parser_cont(struct trace_parser *parser) | |
903 | { | |
904 | return parser->cont; | |
905 | } | |
906 | ||
907 | static inline void trace_parser_clear(struct trace_parser *parser) | |
908 | { | |
909 | parser->cont = false; | |
910 | parser->idx = 0; | |
911 | } | |
912 | ||
913 | extern int trace_parser_get_init(struct trace_parser *parser, int size); | |
914 | extern void trace_parser_put(struct trace_parser *parser); | |
915 | extern int trace_get_user(struct trace_parser *parser, const char __user *ubuf, | |
916 | size_t cnt, loff_t *ppos); | |
917 | ||
729358da SRRH |
918 | /* |
919 | * Only create function graph options if function graph is configured. | |
920 | */ | |
921 | #ifdef CONFIG_FUNCTION_GRAPH_TRACER | |
922 | # define FGRAPH_FLAGS \ | |
729358da | 923 | C(DISPLAY_GRAPH, "display-graph"), |
729358da SRRH |
924 | #else |
925 | # define FGRAPH_FLAGS | |
729358da SRRH |
926 | #endif |
927 | ||
4ee4301c SRRH |
928 | #ifdef CONFIG_BRANCH_TRACER |
929 | # define BRANCH_FLAGS \ | |
930 | C(BRANCH, "branch"), | |
931 | #else | |
932 | # define BRANCH_FLAGS | |
933 | #endif | |
934 | ||
8179e8a1 SRRH |
935 | #ifdef CONFIG_FUNCTION_TRACER |
936 | # define FUNCTION_FLAGS \ | |
937 | C(FUNCTION, "function-trace"), | |
938 | # define FUNCTION_DEFAULT_FLAGS TRACE_ITER_FUNCTION | |
939 | #else | |
940 | # define FUNCTION_FLAGS | |
941 | # define FUNCTION_DEFAULT_FLAGS 0UL | |
942 | #endif | |
943 | ||
73dddbb5 SRRH |
944 | #ifdef CONFIG_STACKTRACE |
945 | # define STACK_FLAGS \ | |
946 | C(STACKTRACE, "stacktrace"), | |
947 | #else | |
948 | # define STACK_FLAGS | |
949 | #endif | |
950 | ||
4fcdae83 SR |
951 | /* |
952 | * trace_iterator_flags is an enumeration that defines bit | |
953 | * positions into trace_flags that controls the output. | |
954 | * | |
955 | * NOTE: These bits must match the trace_options array in | |
a3418a36 | 956 | * trace.c (this macro guarantees it). |
4fcdae83 | 957 | */ |
a3418a36 SRRH |
958 | #define TRACE_FLAGS \ |
959 | C(PRINT_PARENT, "print-parent"), \ | |
960 | C(SYM_OFFSET, "sym-offset"), \ | |
961 | C(SYM_ADDR, "sym-addr"), \ | |
962 | C(VERBOSE, "verbose"), \ | |
963 | C(RAW, "raw"), \ | |
964 | C(HEX, "hex"), \ | |
965 | C(BIN, "bin"), \ | |
966 | C(BLOCK, "block"), \ | |
a3418a36 | 967 | C(PRINTK, "trace_printk"), \ |
a3418a36 SRRH |
968 | C(ANNOTATE, "annotate"), \ |
969 | C(USERSTACKTRACE, "userstacktrace"), \ | |
970 | C(SYM_USEROBJ, "sym-userobj"), \ | |
971 | C(PRINTK_MSGONLY, "printk-msg-only"), \ | |
972 | C(CONTEXT_INFO, "context-info"), /* Print pid/cpu/time */ \ | |
973 | C(LATENCY_FMT, "latency-format"), \ | |
a3418a36 SRRH |
974 | C(RECORD_CMD, "record-cmd"), \ |
975 | C(OVERWRITE, "overwrite"), \ | |
976 | C(STOP_ON_FREE, "disable_on_free"), \ | |
977 | C(IRQ_INFO, "irq-info"), \ | |
978 | C(MARKERS, "markers"), \ | |
c37775d5 | 979 | C(EVENT_FORK, "event-fork"), \ |
8179e8a1 | 980 | FUNCTION_FLAGS \ |
4ee4301c | 981 | FGRAPH_FLAGS \ |
73dddbb5 | 982 | STACK_FLAGS \ |
4ee4301c | 983 | BRANCH_FLAGS |
ce3fed62 | 984 | |
a3418a36 SRRH |
985 | /* |
986 | * By defining C, we can make TRACE_FLAGS a list of bit names | |
987 | * that will define the bits for the flag masks. | |
988 | */ | |
989 | #undef C | |
990 | #define C(a, b) TRACE_ITER_##a##_BIT | |
991 | ||
b5e87c05 SRRH |
992 | enum trace_iterator_bits { |
993 | TRACE_FLAGS | |
994 | /* Make sure we don't go more than we have bits for */ | |
995 | TRACE_ITER_LAST_BIT | |
996 | }; | |
a3418a36 SRRH |
997 | |
998 | /* | |
999 | * By redefining C, we can make TRACE_FLAGS a list of masks that | |
1000 | * use the bits as defined above. | |
1001 | */ | |
1002 | #undef C | |
1003 | #define C(a, b) TRACE_ITER_##a = (1 << TRACE_ITER_##a##_BIT) | |
1004 | ||
1005 | enum trace_iterator_flags { TRACE_FLAGS }; | |
4e655519 | 1006 | |
15e6cb36 FW |
1007 | /* |
1008 | * TRACE_ITER_SYM_MASK masks the options in trace_flags that | |
1009 | * control the output of kernel symbols. | |
1010 | */ | |
1011 | #define TRACE_ITER_SYM_MASK \ | |
1012 | (TRACE_ITER_PRINT_PARENT|TRACE_ITER_SYM_OFFSET|TRACE_ITER_SYM_ADDR) | |
1013 | ||
43a15386 FW |
1014 | extern struct tracer nop_trace; |
1015 | ||
2ed84eeb | 1016 | #ifdef CONFIG_BRANCH_TRACER |
9f029e83 SR |
1017 | extern int enable_branch_tracing(struct trace_array *tr); |
1018 | extern void disable_branch_tracing(void); | |
1019 | static inline int trace_branch_enable(struct trace_array *tr) | |
52f232cb | 1020 | { |
983f938a | 1021 | if (tr->trace_flags & TRACE_ITER_BRANCH) |
9f029e83 | 1022 | return enable_branch_tracing(tr); |
52f232cb SR |
1023 | return 0; |
1024 | } | |
9f029e83 | 1025 | static inline void trace_branch_disable(void) |
52f232cb SR |
1026 | { |
1027 | /* due to races, always disable */ | |
9f029e83 | 1028 | disable_branch_tracing(); |
52f232cb SR |
1029 | } |
1030 | #else | |
9f029e83 | 1031 | static inline int trace_branch_enable(struct trace_array *tr) |
52f232cb SR |
1032 | { |
1033 | return 0; | |
1034 | } | |
9f029e83 | 1035 | static inline void trace_branch_disable(void) |
52f232cb SR |
1036 | { |
1037 | } | |
2ed84eeb | 1038 | #endif /* CONFIG_BRANCH_TRACER */ |
52f232cb | 1039 | |
1852fcce SR |
1040 | /* set ring buffers to default size if not already done so */ |
1041 | int tracing_update_buffers(void); | |
1042 | ||
cf027f64 TZ |
1043 | struct ftrace_event_field { |
1044 | struct list_head link; | |
92edca07 SR |
1045 | const char *name; |
1046 | const char *type; | |
aa38e9fc | 1047 | int filter_type; |
cf027f64 TZ |
1048 | int offset; |
1049 | int size; | |
a118e4d1 | 1050 | int is_signed; |
cf027f64 TZ |
1051 | }; |
1052 | ||
30e673b2 | 1053 | struct event_filter { |
c9c53ca0 SR |
1054 | int n_preds; /* Number assigned */ |
1055 | int a_preds; /* allocated */ | |
74e9e58c | 1056 | struct filter_pred *preds; |
61e9dea2 | 1057 | struct filter_pred *root; |
8b372562 | 1058 | char *filter_string; |
30e673b2 TZ |
1059 | }; |
1060 | ||
cfb180f3 TZ |
1061 | struct event_subsystem { |
1062 | struct list_head list; | |
1063 | const char *name; | |
1f9963cb | 1064 | struct event_filter *filter; |
e9dbfae5 | 1065 | int ref_count; |
cfb180f3 TZ |
1066 | }; |
1067 | ||
7967b3e0 | 1068 | struct trace_subsystem_dir { |
ae63b31e SR |
1069 | struct list_head list; |
1070 | struct event_subsystem *subsystem; | |
1071 | struct trace_array *tr; | |
1072 | struct dentry *entry; | |
1073 | int ref_count; | |
1074 | int nr_events; | |
1075 | }; | |
1076 | ||
65da9a0a SRRH |
1077 | extern int call_filter_check_discard(struct trace_event_call *call, void *rec, |
1078 | struct ring_buffer *buffer, | |
1079 | struct ring_buffer_event *event); | |
fa66ddb8 | 1080 | |
fa66ddb8 SRRH |
1081 | void trace_buffer_unlock_commit_regs(struct trace_array *tr, |
1082 | struct ring_buffer *buffer, | |
1083 | struct ring_buffer_event *event, | |
1084 | unsigned long flags, int pc, | |
1085 | struct pt_regs *regs); | |
33fddff2 SRRH |
1086 | |
1087 | static inline void trace_buffer_unlock_commit(struct trace_array *tr, | |
1088 | struct ring_buffer *buffer, | |
1089 | struct ring_buffer_event *event, | |
1090 | unsigned long flags, int pc) | |
1091 | { | |
1092 | trace_buffer_unlock_commit_regs(tr, buffer, event, flags, pc, NULL); | |
1093 | } | |
1094 | ||
0fc1b09f SRRH |
1095 | DECLARE_PER_CPU(struct ring_buffer_event *, trace_buffered_event); |
1096 | DECLARE_PER_CPU(int, trace_buffered_event_cnt); | |
1097 | void trace_buffered_event_disable(void); | |
1098 | void trace_buffered_event_enable(void); | |
1099 | ||
1100 | static inline void | |
1101 | __trace_event_discard_commit(struct ring_buffer *buffer, | |
1102 | struct ring_buffer_event *event) | |
1103 | { | |
1104 | if (this_cpu_read(trace_buffered_event) == event) { | |
1105 | /* Simply release the temp buffer */ | |
1106 | this_cpu_dec(trace_buffered_event_cnt); | |
1107 | return; | |
1108 | } | |
1109 | ring_buffer_discard_commit(buffer, event); | |
1110 | } | |
1111 | ||
dad56ee7 SRRH |
1112 | /* |
1113 | * Helper function for event_trigger_unlock_commit{_regs}(). | |
1114 | * If there are event triggers attached to this event that requires | |
1115 | * filtering against its fields, then they wil be called as the | |
1116 | * entry already holds the field information of the current event. | |
1117 | * | |
1118 | * It also checks if the event should be discarded or not. | |
1119 | * It is to be discarded if the event is soft disabled and the | |
1120 | * event was only recorded to process triggers, or if the event | |
1121 | * filter is active and this event did not match the filters. | |
1122 | * | |
1123 | * Returns true if the event is discarded, false otherwise. | |
1124 | */ | |
1125 | static inline bool | |
1126 | __event_trigger_test_discard(struct trace_event_file *file, | |
1127 | struct ring_buffer *buffer, | |
1128 | struct ring_buffer_event *event, | |
1129 | void *entry, | |
1130 | enum event_trigger_type *tt) | |
1131 | { | |
1132 | unsigned long eflags = file->flags; | |
1133 | ||
1134 | if (eflags & EVENT_FILE_FL_TRIGGER_COND) | |
1135 | *tt = event_triggers_call(file, entry); | |
1136 | ||
9cbb1506 SRRH |
1137 | if (test_bit(EVENT_FILE_FL_SOFT_DISABLED_BIT, &file->flags) || |
1138 | (unlikely(file->flags & EVENT_FILE_FL_FILTERED) && | |
1139 | !filter_match_preds(file->filter, entry))) { | |
0fc1b09f | 1140 | __trace_event_discard_commit(buffer, event); |
9cbb1506 SRRH |
1141 | return true; |
1142 | } | |
dad56ee7 | 1143 | |
9cbb1506 | 1144 | return false; |
dad56ee7 SRRH |
1145 | } |
1146 | ||
1147 | /** | |
1148 | * event_trigger_unlock_commit - handle triggers and finish event commit | |
1149 | * @file: The file pointer assoctiated to the event | |
1150 | * @buffer: The ring buffer that the event is being written to | |
1151 | * @event: The event meta data in the ring buffer | |
1152 | * @entry: The event itself | |
1153 | * @irq_flags: The state of the interrupts at the start of the event | |
1154 | * @pc: The state of the preempt count at the start of the event. | |
1155 | * | |
1156 | * This is a helper function to handle triggers that require data | |
1157 | * from the event itself. It also tests the event against filters and | |
1158 | * if the event is soft disabled and should be discarded. | |
1159 | */ | |
1160 | static inline void | |
1161 | event_trigger_unlock_commit(struct trace_event_file *file, | |
1162 | struct ring_buffer *buffer, | |
1163 | struct ring_buffer_event *event, | |
1164 | void *entry, unsigned long irq_flags, int pc) | |
1165 | { | |
1166 | enum event_trigger_type tt = ETT_NONE; | |
1167 | ||
1168 | if (!__event_trigger_test_discard(file, buffer, event, entry, &tt)) | |
1169 | trace_buffer_unlock_commit(file->tr, buffer, event, irq_flags, pc); | |
1170 | ||
1171 | if (tt) | |
1172 | event_triggers_post_call(file, tt, entry); | |
1173 | } | |
1174 | ||
1175 | /** | |
1176 | * event_trigger_unlock_commit_regs - handle triggers and finish event commit | |
1177 | * @file: The file pointer assoctiated to the event | |
1178 | * @buffer: The ring buffer that the event is being written to | |
1179 | * @event: The event meta data in the ring buffer | |
1180 | * @entry: The event itself | |
1181 | * @irq_flags: The state of the interrupts at the start of the event | |
1182 | * @pc: The state of the preempt count at the start of the event. | |
1183 | * | |
1184 | * This is a helper function to handle triggers that require data | |
1185 | * from the event itself. It also tests the event against filters and | |
1186 | * if the event is soft disabled and should be discarded. | |
1187 | * | |
1188 | * Same as event_trigger_unlock_commit() but calls | |
1189 | * trace_buffer_unlock_commit_regs() instead of trace_buffer_unlock_commit(). | |
1190 | */ | |
1191 | static inline void | |
1192 | event_trigger_unlock_commit_regs(struct trace_event_file *file, | |
1193 | struct ring_buffer *buffer, | |
1194 | struct ring_buffer_event *event, | |
1195 | void *entry, unsigned long irq_flags, int pc, | |
1196 | struct pt_regs *regs) | |
1197 | { | |
1198 | enum event_trigger_type tt = ETT_NONE; | |
1199 | ||
1200 | if (!__event_trigger_test_discard(file, buffer, event, entry, &tt)) | |
1201 | trace_buffer_unlock_commit_regs(file->tr, buffer, event, | |
1202 | irq_flags, pc, regs); | |
1203 | ||
1204 | if (tt) | |
1205 | event_triggers_post_call(file, tt, entry); | |
1206 | } | |
1207 | ||
61e9dea2 SR |
1208 | #define FILTER_PRED_INVALID ((unsigned short)-1) |
1209 | #define FILTER_PRED_IS_RIGHT (1 << 15) | |
43cd4145 | 1210 | #define FILTER_PRED_FOLD (1 << 15) |
61e9dea2 | 1211 | |
bf93f9ed SR |
1212 | /* |
1213 | * The max preds is the size of unsigned short with | |
1214 | * two flags at the MSBs. One bit is used for both the IS_RIGHT | |
1215 | * and FOLD flags. The other is reserved. | |
1216 | * | |
1217 | * 2^14 preds is way more than enough. | |
1218 | */ | |
1219 | #define MAX_FILTER_PRED 16384 | |
4a3d27e9 | 1220 | |
7ce7e424 | 1221 | struct filter_pred; |
1889d209 | 1222 | struct regex; |
7ce7e424 | 1223 | |
58d9a597 | 1224 | typedef int (*filter_pred_fn_t) (struct filter_pred *pred, void *event); |
7ce7e424 | 1225 | |
1889d209 FW |
1226 | typedef int (*regex_match_func)(char *str, struct regex *r, int len); |
1227 | ||
3f6fe06d | 1228 | enum regex_type { |
b0f1a59a | 1229 | MATCH_FULL = 0, |
3f6fe06d FW |
1230 | MATCH_FRONT_ONLY, |
1231 | MATCH_MIDDLE_ONLY, | |
1232 | MATCH_END_ONLY, | |
1233 | }; | |
1234 | ||
1889d209 FW |
1235 | struct regex { |
1236 | char pattern[MAX_FILTER_STR_VAL]; | |
1237 | int len; | |
1238 | int field_len; | |
1239 | regex_match_func match; | |
1240 | }; | |
1241 | ||
7ce7e424 | 1242 | struct filter_pred { |
1889d209 FW |
1243 | filter_pred_fn_t fn; |
1244 | u64 val; | |
1245 | struct regex regex; | |
61aaef55 | 1246 | unsigned short *ops; |
1d0e78e3 | 1247 | struct ftrace_event_field *field; |
1889d209 FW |
1248 | int offset; |
1249 | int not; | |
1250 | int op; | |
61e9dea2 SR |
1251 | unsigned short index; |
1252 | unsigned short parent; | |
1253 | unsigned short left; | |
1254 | unsigned short right; | |
7ce7e424 TZ |
1255 | }; |
1256 | ||
4ef56902 TZ |
1257 | static inline bool is_string_field(struct ftrace_event_field *field) |
1258 | { | |
1259 | return field->filter_type == FILTER_DYN_STRING || | |
1260 | field->filter_type == FILTER_STATIC_STRING || | |
1261 | field->filter_type == FILTER_PTR_STRING; | |
1262 | } | |
1263 | ||
1264 | static inline bool is_function_field(struct ftrace_event_field *field) | |
1265 | { | |
1266 | return field->filter_type == FILTER_TRACE_FN; | |
1267 | } | |
1268 | ||
3f6fe06d FW |
1269 | extern enum regex_type |
1270 | filter_parse_regex(char *buff, int len, char **search, int *not); | |
7f1d2f82 | 1271 | extern void print_event_filter(struct trace_event_file *file, |
4bda2d51 | 1272 | struct trace_seq *s); |
7f1d2f82 | 1273 | extern int apply_event_filter(struct trace_event_file *file, |
8b372562 | 1274 | char *filter_string); |
7967b3e0 | 1275 | extern int apply_subsystem_event_filter(struct trace_subsystem_dir *dir, |
8b372562 TZ |
1276 | char *filter_string); |
1277 | extern void print_subsystem_event_filter(struct event_subsystem *system, | |
ac1adc55 | 1278 | struct trace_seq *s); |
aa38e9fc | 1279 | extern int filter_assign_type(const char *type); |
2425bcb9 | 1280 | extern int create_event_filter(struct trace_event_call *call, |
bac5fb97 TZ |
1281 | char *filter_str, bool set_str, |
1282 | struct event_filter **filterp); | |
1283 | extern void free_event_filter(struct event_filter *filter); | |
7ce7e424 | 1284 | |
b3a8c6fd | 1285 | struct ftrace_event_field * |
2425bcb9 | 1286 | trace_find_event_field(struct trace_event_call *call, char *name); |
2e33af02 | 1287 | |
e870e9a1 | 1288 | extern void trace_event_enable_cmd_record(bool enable); |
277ba044 | 1289 | extern int event_trace_add_tracer(struct dentry *parent, struct trace_array *tr); |
0c8916c3 | 1290 | extern int event_trace_del_tracer(struct trace_array *tr); |
e870e9a1 | 1291 | |
7f1d2f82 SRRH |
1292 | extern struct trace_event_file *find_event_file(struct trace_array *tr, |
1293 | const char *system, | |
1294 | const char *event); | |
7862ad18 | 1295 | |
85f2b082 TZ |
1296 | static inline void *event_file_data(struct file *filp) |
1297 | { | |
1298 | return ACCESS_ONCE(file_inode(filp)->i_private); | |
1299 | } | |
1300 | ||
20c8928a | 1301 | extern struct mutex event_mutex; |
a59fd602 | 1302 | extern struct list_head ftrace_events; |
ac199db0 | 1303 | |
85f2b082 | 1304 | extern const struct file_operations event_trigger_fops; |
7ef224d1 TZ |
1305 | extern const struct file_operations event_hist_fops; |
1306 | ||
1307 | #ifdef CONFIG_HIST_TRIGGERS | |
1308 | extern int register_trigger_hist_cmd(void); | |
d0bad49b | 1309 | extern int register_trigger_hist_enable_disable_cmds(void); |
7ef224d1 TZ |
1310 | #else |
1311 | static inline int register_trigger_hist_cmd(void) { return 0; } | |
d0bad49b | 1312 | static inline int register_trigger_hist_enable_disable_cmds(void) { return 0; } |
7ef224d1 | 1313 | #endif |
85f2b082 TZ |
1314 | |
1315 | extern int register_trigger_cmds(void); | |
1316 | extern void clear_event_triggers(struct trace_array *tr); | |
1317 | ||
1318 | struct event_trigger_data { | |
1319 | unsigned long count; | |
1320 | int ref; | |
1321 | struct event_trigger_ops *ops; | |
1322 | struct event_command *cmd_ops; | |
d8a30f20 | 1323 | struct event_filter __rcu *filter; |
85f2b082 TZ |
1324 | char *filter_str; |
1325 | void *private_data; | |
104f2810 | 1326 | bool paused; |
db1388b4 | 1327 | bool paused_tmp; |
85f2b082 | 1328 | struct list_head list; |
db1388b4 TZ |
1329 | char *name; |
1330 | struct list_head named_list; | |
1331 | struct event_trigger_data *named_data; | |
85f2b082 TZ |
1332 | }; |
1333 | ||
d0bad49b TZ |
1334 | /* Avoid typos */ |
1335 | #define ENABLE_EVENT_STR "enable_event" | |
1336 | #define DISABLE_EVENT_STR "disable_event" | |
1337 | #define ENABLE_HIST_STR "enable_hist" | |
1338 | #define DISABLE_HIST_STR "disable_hist" | |
1339 | ||
1340 | struct enable_trigger_data { | |
1341 | struct trace_event_file *file; | |
1342 | bool enable; | |
1343 | bool hist; | |
1344 | }; | |
1345 | ||
1346 | extern int event_enable_trigger_print(struct seq_file *m, | |
1347 | struct event_trigger_ops *ops, | |
1348 | struct event_trigger_data *data); | |
1349 | extern void event_enable_trigger_free(struct event_trigger_ops *ops, | |
1350 | struct event_trigger_data *data); | |
1351 | extern int event_enable_trigger_func(struct event_command *cmd_ops, | |
1352 | struct trace_event_file *file, | |
1353 | char *glob, char *cmd, char *param); | |
1354 | extern int event_enable_register_trigger(char *glob, | |
1355 | struct event_trigger_ops *ops, | |
1356 | struct event_trigger_data *data, | |
1357 | struct trace_event_file *file); | |
1358 | extern void event_enable_unregister_trigger(char *glob, | |
1359 | struct event_trigger_ops *ops, | |
1360 | struct event_trigger_data *test, | |
1361 | struct trace_event_file *file); | |
ab4bf008 TZ |
1362 | extern void trigger_data_free(struct event_trigger_data *data); |
1363 | extern int event_trigger_init(struct event_trigger_ops *ops, | |
1364 | struct event_trigger_data *data); | |
1365 | extern int trace_event_trigger_enable_disable(struct trace_event_file *file, | |
1366 | int trigger_enable); | |
1367 | extern void update_cond_flag(struct trace_event_file *file); | |
1368 | extern void unregister_trigger(char *glob, struct event_trigger_ops *ops, | |
1369 | struct event_trigger_data *test, | |
1370 | struct trace_event_file *file); | |
1371 | extern int set_trigger_filter(char *filter_str, | |
1372 | struct event_trigger_data *trigger_data, | |
1373 | struct trace_event_file *file); | |
db1388b4 TZ |
1374 | extern struct event_trigger_data *find_named_trigger(const char *name); |
1375 | extern bool is_named_trigger(struct event_trigger_data *test); | |
1376 | extern int save_named_trigger(const char *name, | |
1377 | struct event_trigger_data *data); | |
1378 | extern void del_named_trigger(struct event_trigger_data *data); | |
1379 | extern void pause_named_trigger(struct event_trigger_data *data); | |
1380 | extern void unpause_named_trigger(struct event_trigger_data *data); | |
1381 | extern void set_named_trigger_data(struct event_trigger_data *data, | |
1382 | struct event_trigger_data *named_data); | |
ab4bf008 | 1383 | extern int register_event_command(struct event_command *cmd); |
d0bad49b TZ |
1384 | extern int unregister_event_command(struct event_command *cmd); |
1385 | extern int register_trigger_hist_enable_disable_cmds(void); | |
ab4bf008 | 1386 | |
85f2b082 TZ |
1387 | /** |
1388 | * struct event_trigger_ops - callbacks for trace event triggers | |
1389 | * | |
1390 | * The methods in this structure provide per-event trigger hooks for | |
1391 | * various trigger operations. | |
1392 | * | |
1393 | * All the methods below, except for @init() and @free(), must be | |
1394 | * implemented. | |
1395 | * | |
1396 | * @func: The trigger 'probe' function called when the triggering | |
1397 | * event occurs. The data passed into this callback is the data | |
1398 | * that was supplied to the event_command @reg() function that | |
c4a59230 TZ |
1399 | * registered the trigger (see struct event_command) along with |
1400 | * the trace record, rec. | |
85f2b082 TZ |
1401 | * |
1402 | * @init: An optional initialization function called for the trigger | |
1403 | * when the trigger is registered (via the event_command reg() | |
1404 | * function). This can be used to perform per-trigger | |
1405 | * initialization such as incrementing a per-trigger reference | |
1406 | * count, for instance. This is usually implemented by the | |
1407 | * generic utility function @event_trigger_init() (see | |
1408 | * trace_event_triggers.c). | |
1409 | * | |
1410 | * @free: An optional de-initialization function called for the | |
1411 | * trigger when the trigger is unregistered (via the | |
1412 | * event_command @reg() function). This can be used to perform | |
1413 | * per-trigger de-initialization such as decrementing a | |
1414 | * per-trigger reference count and freeing corresponding trigger | |
1415 | * data, for instance. This is usually implemented by the | |
1416 | * generic utility function @event_trigger_free() (see | |
1417 | * trace_event_triggers.c). | |
1418 | * | |
1419 | * @print: The callback function invoked to have the trigger print | |
1420 | * itself. This is usually implemented by a wrapper function | |
1421 | * that calls the generic utility function @event_trigger_print() | |
1422 | * (see trace_event_triggers.c). | |
1423 | */ | |
1424 | struct event_trigger_ops { | |
c4a59230 TZ |
1425 | void (*func)(struct event_trigger_data *data, |
1426 | void *rec); | |
85f2b082 TZ |
1427 | int (*init)(struct event_trigger_ops *ops, |
1428 | struct event_trigger_data *data); | |
1429 | void (*free)(struct event_trigger_ops *ops, | |
1430 | struct event_trigger_data *data); | |
1431 | int (*print)(struct seq_file *m, | |
1432 | struct event_trigger_ops *ops, | |
1433 | struct event_trigger_data *data); | |
1434 | }; | |
1435 | ||
1436 | /** | |
1437 | * struct event_command - callbacks and data members for event commands | |
1438 | * | |
1439 | * Event commands are invoked by users by writing the command name | |
1440 | * into the 'trigger' file associated with a trace event. The | |
1441 | * parameters associated with a specific invocation of an event | |
1442 | * command are used to create an event trigger instance, which is | |
1443 | * added to the list of trigger instances associated with that trace | |
1444 | * event. When the event is hit, the set of triggers associated with | |
1445 | * that event is invoked. | |
1446 | * | |
1447 | * The data members in this structure provide per-event command data | |
1448 | * for various event commands. | |
1449 | * | |
1450 | * All the data members below, except for @post_trigger, must be set | |
1451 | * for each event command. | |
1452 | * | |
1453 | * @name: The unique name that identifies the event command. This is | |
1454 | * the name used when setting triggers via trigger files. | |
1455 | * | |
1456 | * @trigger_type: A unique id that identifies the event command | |
1457 | * 'type'. This value has two purposes, the first to ensure that | |
1458 | * only one trigger of the same type can be set at a given time | |
1459 | * for a particular event e.g. it doesn't make sense to have both | |
1460 | * a traceon and traceoff trigger attached to a single event at | |
1461 | * the same time, so traceon and traceoff have the same type | |
1462 | * though they have different names. The @trigger_type value is | |
1463 | * also used as a bit value for deferring the actual trigger | |
1464 | * action until after the current event is finished. Some | |
1465 | * commands need to do this if they themselves log to the trace | |
1466 | * buffer (see the @post_trigger() member below). @trigger_type | |
1467 | * values are defined by adding new values to the trigger_type | |
af658dca | 1468 | * enum in include/linux/trace_events.h. |
85f2b082 | 1469 | * |
353206f5 | 1470 | * @flags: See the enum event_command_flags below. |
a5863dae | 1471 | * |
a88e1cfb TZ |
1472 | * All the methods below, except for @set_filter() and @unreg_all(), |
1473 | * must be implemented. | |
85f2b082 TZ |
1474 | * |
1475 | * @func: The callback function responsible for parsing and | |
1476 | * registering the trigger written to the 'trigger' file by the | |
1477 | * user. It allocates the trigger instance and registers it with | |
1478 | * the appropriate trace event. It makes use of the other | |
1479 | * event_command callback functions to orchestrate this, and is | |
1480 | * usually implemented by the generic utility function | |
1481 | * @event_trigger_callback() (see trace_event_triggers.c). | |
1482 | * | |
1483 | * @reg: Adds the trigger to the list of triggers associated with the | |
1484 | * event, and enables the event trigger itself, after | |
1485 | * initializing it (via the event_trigger_ops @init() function). | |
1486 | * This is also where commands can use the @trigger_type value to | |
1487 | * make the decision as to whether or not multiple instances of | |
1488 | * the trigger should be allowed. This is usually implemented by | |
1489 | * the generic utility function @register_trigger() (see | |
1490 | * trace_event_triggers.c). | |
1491 | * | |
1492 | * @unreg: Removes the trigger from the list of triggers associated | |
1493 | * with the event, and disables the event trigger itself, after | |
1494 | * initializing it (via the event_trigger_ops @free() function). | |
1495 | * This is usually implemented by the generic utility function | |
1496 | * @unregister_trigger() (see trace_event_triggers.c). | |
1497 | * | |
a88e1cfb TZ |
1498 | * @unreg_all: An optional function called to remove all the triggers |
1499 | * from the list of triggers associated with the event. Called | |
1500 | * when a trigger file is opened in truncate mode. | |
1501 | * | |
85f2b082 TZ |
1502 | * @set_filter: An optional function called to parse and set a filter |
1503 | * for the trigger. If no @set_filter() method is set for the | |
1504 | * event command, filters set by the user for the command will be | |
1505 | * ignored. This is usually implemented by the generic utility | |
1506 | * function @set_trigger_filter() (see trace_event_triggers.c). | |
1507 | * | |
1508 | * @get_trigger_ops: The callback function invoked to retrieve the | |
1509 | * event_trigger_ops implementation associated with the command. | |
1510 | */ | |
1511 | struct event_command { | |
1512 | struct list_head list; | |
1513 | char *name; | |
1514 | enum event_trigger_type trigger_type; | |
353206f5 | 1515 | int flags; |
85f2b082 | 1516 | int (*func)(struct event_command *cmd_ops, |
7f1d2f82 | 1517 | struct trace_event_file *file, |
85f2b082 TZ |
1518 | char *glob, char *cmd, char *params); |
1519 | int (*reg)(char *glob, | |
1520 | struct event_trigger_ops *ops, | |
1521 | struct event_trigger_data *data, | |
7f1d2f82 | 1522 | struct trace_event_file *file); |
85f2b082 TZ |
1523 | void (*unreg)(char *glob, |
1524 | struct event_trigger_ops *ops, | |
1525 | struct event_trigger_data *data, | |
7f1d2f82 | 1526 | struct trace_event_file *file); |
a88e1cfb | 1527 | void (*unreg_all)(struct trace_event_file *file); |
85f2b082 TZ |
1528 | int (*set_filter)(char *filter_str, |
1529 | struct event_trigger_data *data, | |
7f1d2f82 | 1530 | struct trace_event_file *file); |
85f2b082 TZ |
1531 | struct event_trigger_ops *(*get_trigger_ops)(char *cmd, char *param); |
1532 | }; | |
1533 | ||
353206f5 SRRH |
1534 | /** |
1535 | * enum event_command_flags - flags for struct event_command | |
1536 | * | |
1537 | * @POST_TRIGGER: A flag that says whether or not this command needs | |
1538 | * to have its action delayed until after the current event has | |
1539 | * been closed. Some triggers need to avoid being invoked while | |
1540 | * an event is currently in the process of being logged, since | |
1541 | * the trigger may itself log data into the trace buffer. Thus | |
1542 | * we make sure the current event is committed before invoking | |
1543 | * those triggers. To do that, the trigger invocation is split | |
1544 | * in two - the first part checks the filter using the current | |
1545 | * trace record; if a command has the @post_trigger flag set, it | |
1546 | * sets a bit for itself in the return value, otherwise it | |
1547 | * directly invokes the trigger. Once all commands have been | |
1548 | * either invoked or set their return flag, the current record is | |
1549 | * either committed or discarded. At that point, if any commands | |
1550 | * have deferred their triggers, those commands are finally | |
1551 | * invoked following the close of the current event. In other | |
1552 | * words, if the event_trigger_ops @func() probe implementation | |
1553 | * itself logs to the trace buffer, this flag should be set, | |
1554 | * otherwise it can be left unspecified. | |
1555 | * | |
1556 | * @NEEDS_REC: A flag that says whether or not this command needs | |
1557 | * access to the trace record in order to perform its function, | |
1558 | * regardless of whether or not it has a filter associated with | |
1559 | * it (filters make a trigger require access to the trace record | |
1560 | * but are not always present). | |
1561 | */ | |
1562 | enum event_command_flags { | |
1563 | EVENT_CMD_FL_POST_TRIGGER = 1, | |
1564 | EVENT_CMD_FL_NEEDS_REC = 2, | |
1565 | }; | |
1566 | ||
1567 | static inline bool event_command_post_trigger(struct event_command *cmd_ops) | |
1568 | { | |
1569 | return cmd_ops->flags & EVENT_CMD_FL_POST_TRIGGER; | |
1570 | } | |
1571 | ||
1572 | static inline bool event_command_needs_rec(struct event_command *cmd_ops) | |
1573 | { | |
1574 | return cmd_ops->flags & EVENT_CMD_FL_NEEDS_REC; | |
1575 | } | |
1576 | ||
7f1d2f82 | 1577 | extern int trace_event_enable_disable(struct trace_event_file *file, |
85f2b082 | 1578 | int enable, int soft_disable); |
93e31ffb | 1579 | extern int tracing_alloc_snapshot(void); |
85f2b082 | 1580 | |
e9fb2b6d SR |
1581 | extern const char *__start___trace_bprintk_fmt[]; |
1582 | extern const char *__stop___trace_bprintk_fmt[]; | |
1583 | ||
102c9323 SRRH |
1584 | extern const char *__start___tracepoint_str[]; |
1585 | extern const char *__stop___tracepoint_str[]; | |
1586 | ||
b9f9108c | 1587 | void trace_printk_control(bool enabled); |
07d777fe | 1588 | void trace_printk_init_buffers(void); |
81698831 | 1589 | void trace_printk_start_comm(void); |
613f04a0 | 1590 | int trace_keep_overwrite(struct tracer *tracer, u32 mask, int set); |
2b6080f2 | 1591 | int set_tracer_flag(struct trace_array *tr, unsigned int mask, int enabled); |
07d777fe | 1592 | |
ca268da6 SRRH |
1593 | /* |
1594 | * Normal trace_printk() and friends allocates special buffers | |
1595 | * to do the manipulation, as well as saves the print formats | |
1596 | * into sections to display. But the trace infrastructure wants | |
1597 | * to use these without the added overhead at the price of being | |
1598 | * a bit slower (used mainly for warnings, where we don't care | |
1599 | * about performance). The internal_trace_puts() is for such | |
1600 | * a purpose. | |
1601 | */ | |
1602 | #define internal_trace_puts(str) __trace_puts(_THIS_IP_, str, strlen(str)) | |
1603 | ||
4e5292ea | 1604 | #undef FTRACE_ENTRY |
02aa3162 | 1605 | #define FTRACE_ENTRY(call, struct_name, id, tstruct, print, filter) \ |
2425bcb9 | 1606 | extern struct trace_event_call \ |
52f5684c | 1607 | __aligned(4) event_##call; |
4e5292ea | 1608 | #undef FTRACE_ENTRY_DUP |
02aa3162 JO |
1609 | #define FTRACE_ENTRY_DUP(call, struct_name, id, tstruct, print, filter) \ |
1610 | FTRACE_ENTRY(call, struct_name, id, PARAMS(tstruct), PARAMS(print), \ | |
1611 | filter) | |
4e5292ea | 1612 | #include "trace_entries.h" |
e1112b4d | 1613 | |
6e48b550 | 1614 | #if defined(CONFIG_PERF_EVENTS) && defined(CONFIG_FUNCTION_TRACER) |
2425bcb9 | 1615 | int perf_ftrace_event_register(struct trace_event_call *call, |
ced39002 JO |
1616 | enum trace_reg type, void *data); |
1617 | #else | |
1618 | #define perf_ftrace_event_register NULL | |
6e48b550 | 1619 | #endif |
ced39002 | 1620 | |
5f893b26 SRRH |
1621 | #ifdef CONFIG_FTRACE_SYSCALLS |
1622 | void init_ftrace_syscalls(void); | |
dbfeaa7a | 1623 | const char *get_syscall_name(int syscall); |
5f893b26 SRRH |
1624 | #else |
1625 | static inline void init_ftrace_syscalls(void) { } | |
dbfeaa7a TZ |
1626 | static inline const char *get_syscall_name(int syscall) |
1627 | { | |
1628 | return NULL; | |
1629 | } | |
5f893b26 SRRH |
1630 | #endif |
1631 | ||
1632 | #ifdef CONFIG_EVENT_TRACING | |
1633 | void trace_event_init(void); | |
0c564a53 | 1634 | void trace_event_enum_update(struct trace_enum_map **map, int len); |
5f893b26 SRRH |
1635 | #else |
1636 | static inline void __init trace_event_init(void) { } | |
cc9e4bde | 1637 | static inline void trace_event_enum_update(struct trace_enum_map **map, int len) { } |
5f893b26 SRRH |
1638 | #endif |
1639 | ||
0daa2302 | 1640 | extern struct trace_iterator *tracepoint_print_iter; |
5f893b26 | 1641 | |
bc0c38d1 | 1642 | #endif /* _LINUX_KERNEL_TRACE_H */ |