mmiotrace: remove left-over marker cruft
[deliverable/linux.git] / kernel / trace / trace.h
... / ...
CommitLineData
1#ifndef _LINUX_KERNEL_TRACE_H
2#define _LINUX_KERNEL_TRACE_H
3
4#include <linux/fs.h>
5#include <asm/atomic.h>
6#include <linux/sched.h>
7#include <linux/clocksource.h>
8#include <linux/mmiotrace.h>
9
10enum trace_type {
11 __TRACE_FIRST_TYPE = 0,
12
13 TRACE_FN,
14 TRACE_CTX,
15 TRACE_WAKE,
16 TRACE_CONT,
17 TRACE_STACK,
18 TRACE_PRINT,
19 TRACE_SPECIAL,
20 TRACE_MMIO_RW,
21 TRACE_MMIO_MAP,
22
23 __TRACE_LAST_TYPE
24};
25
26/*
27 * Function trace entry - function address and parent function addres:
28 */
29struct ftrace_entry {
30 unsigned long ip;
31 unsigned long parent_ip;
32};
33
34/*
35 * Context switch trace entry - which task (and prio) we switched from/to:
36 */
37struct ctx_switch_entry {
38 unsigned int prev_pid;
39 unsigned char prev_prio;
40 unsigned char prev_state;
41 unsigned int next_pid;
42 unsigned char next_prio;
43 unsigned char next_state;
44 unsigned int next_cpu;
45};
46
47/*
48 * Special (free-form) trace entry:
49 */
50struct special_entry {
51 unsigned long arg1;
52 unsigned long arg2;
53 unsigned long arg3;
54};
55
56/*
57 * Stack-trace entry:
58 */
59
60#define FTRACE_STACK_ENTRIES 8
61
62struct stack_entry {
63 unsigned long caller[FTRACE_STACK_ENTRIES];
64};
65
66/*
67 * ftrace_printk entry:
68 */
69struct print_entry {
70 unsigned long ip;
71 char buf[];
72};
73
74/*
75 * trace_flag_type is an enumeration that holds different
76 * states when a trace occurs. These are:
77 * IRQS_OFF - interrupts were disabled
78 * NEED_RESCED - reschedule is requested
79 * HARDIRQ - inside an interrupt handler
80 * SOFTIRQ - inside a softirq handler
81 * CONT - multiple entries hold the trace item
82 */
83enum trace_flag_type {
84 TRACE_FLAG_IRQS_OFF = 0x01,
85 TRACE_FLAG_NEED_RESCHED = 0x02,
86 TRACE_FLAG_HARDIRQ = 0x04,
87 TRACE_FLAG_SOFTIRQ = 0x08,
88 TRACE_FLAG_CONT = 0x10,
89};
90
91/*
92 * The trace field - the most basic unit of tracing. This is what
93 * is printed in the end as a single line in the trace output, such as:
94 *
95 * bash-15816 [01] 235.197585: idle_cpu <- irq_enter
96 */
97struct trace_field {
98 char cpu;
99 char flags;
100 char preempt_count;
101 int pid;
102 cycle_t t;
103 union {
104 struct ftrace_entry fn;
105 struct ctx_switch_entry ctx;
106 struct special_entry special;
107 struct stack_entry stack;
108 struct print_entry print;
109 struct mmiotrace_rw mmiorw;
110 struct mmiotrace_map mmiomap;
111 };
112};
113
114struct trace_field_cont {
115 char buf[sizeof(struct trace_field)];
116};
117
118struct trace_entry {
119 char type;
120 union {
121 struct trace_field field;
122 struct trace_field_cont cont;
123 };
124};
125
126#define TRACE_ENTRY_SIZE sizeof(struct trace_entry)
127
128/*
129 * The CPU trace array - it consists of thousands of trace entries
130 * plus some other descriptor data: (for example which task started
131 * the trace, etc.)
132 */
133struct trace_array_cpu {
134 struct list_head trace_pages;
135 atomic_t disabled;
136 raw_spinlock_t lock;
137 struct lock_class_key lock_key;
138
139 /* these fields get copied into max-trace: */
140 unsigned trace_head_idx;
141 unsigned trace_tail_idx;
142 void *trace_head; /* producer */
143 void *trace_tail; /* consumer */
144 unsigned long trace_idx;
145 unsigned long overrun;
146 unsigned long saved_latency;
147 unsigned long critical_start;
148 unsigned long critical_end;
149 unsigned long critical_sequence;
150 unsigned long nice;
151 unsigned long policy;
152 unsigned long rt_priority;
153 cycle_t preempt_timestamp;
154 pid_t pid;
155 uid_t uid;
156 char comm[TASK_COMM_LEN];
157};
158
159struct trace_iterator;
160
161/*
162 * The trace array - an array of per-CPU trace arrays. This is the
163 * highest level data structure that individual tracers deal with.
164 * They have on/off state as well:
165 */
166struct trace_array {
167 unsigned long entries;
168 long ctrl;
169 int cpu;
170 cycle_t time_start;
171 struct task_struct *waiter;
172 struct trace_array_cpu *data[NR_CPUS];
173};
174
175/*
176 * A specific tracer, represented by methods that operate on a trace array:
177 */
178struct tracer {
179 const char *name;
180 void (*init)(struct trace_array *tr);
181 void (*reset)(struct trace_array *tr);
182 void (*open)(struct trace_iterator *iter);
183 void (*pipe_open)(struct trace_iterator *iter);
184 void (*close)(struct trace_iterator *iter);
185 void (*start)(struct trace_iterator *iter);
186 void (*stop)(struct trace_iterator *iter);
187 ssize_t (*read)(struct trace_iterator *iter,
188 struct file *filp, char __user *ubuf,
189 size_t cnt, loff_t *ppos);
190 void (*ctrl_update)(struct trace_array *tr);
191#ifdef CONFIG_FTRACE_STARTUP_TEST
192 int (*selftest)(struct tracer *trace,
193 struct trace_array *tr);
194#endif
195 int (*print_line)(struct trace_iterator *iter);
196 struct tracer *next;
197 int print_max;
198};
199
200struct trace_seq {
201 unsigned char buffer[PAGE_SIZE];
202 unsigned int len;
203 unsigned int readpos;
204};
205
206/*
207 * Trace iterator - used by printout routines who present trace
208 * results to users and which routines might sleep, etc:
209 */
210struct trace_iterator {
211 struct trace_array *tr;
212 struct tracer *trace;
213 void *private;
214 long last_overrun[NR_CPUS];
215 long overrun[NR_CPUS];
216
217 /* The below is zeroed out in pipe_read */
218 struct trace_seq seq;
219 struct trace_entry *ent;
220 int cpu;
221
222 struct trace_entry *prev_ent;
223 int prev_cpu;
224
225 unsigned long iter_flags;
226 loff_t pos;
227 unsigned long next_idx[NR_CPUS];
228 struct list_head *next_page[NR_CPUS];
229 unsigned next_page_idx[NR_CPUS];
230 long idx;
231};
232
233void trace_wake_up(void);
234void tracing_reset(struct trace_array_cpu *data);
235int tracing_open_generic(struct inode *inode, struct file *filp);
236struct dentry *tracing_init_dentry(void);
237void init_tracer_sysprof_debugfs(struct dentry *d_tracer);
238
239struct trace_entry *tracing_get_trace_entry(struct trace_array *tr,
240 struct trace_array_cpu *data);
241void tracing_generic_entry_update(struct trace_entry *entry,
242 unsigned long flags);
243
244void ftrace(struct trace_array *tr,
245 struct trace_array_cpu *data,
246 unsigned long ip,
247 unsigned long parent_ip,
248 unsigned long flags);
249void tracing_sched_switch_trace(struct trace_array *tr,
250 struct trace_array_cpu *data,
251 struct task_struct *prev,
252 struct task_struct *next,
253 unsigned long flags);
254void tracing_record_cmdline(struct task_struct *tsk);
255
256void tracing_sched_wakeup_trace(struct trace_array *tr,
257 struct trace_array_cpu *data,
258 struct task_struct *wakee,
259 struct task_struct *cur,
260 unsigned long flags);
261void trace_special(struct trace_array *tr,
262 struct trace_array_cpu *data,
263 unsigned long arg1,
264 unsigned long arg2,
265 unsigned long arg3);
266void trace_function(struct trace_array *tr,
267 struct trace_array_cpu *data,
268 unsigned long ip,
269 unsigned long parent_ip,
270 unsigned long flags);
271
272void tracing_start_cmdline_record(void);
273void tracing_stop_cmdline_record(void);
274int register_tracer(struct tracer *type);
275void unregister_tracer(struct tracer *type);
276
277extern unsigned long nsecs_to_usecs(unsigned long nsecs);
278
279extern unsigned long tracing_max_latency;
280extern unsigned long tracing_thresh;
281
282void update_max_tr(struct trace_array *tr, struct task_struct *tsk, int cpu);
283void update_max_tr_single(struct trace_array *tr,
284 struct task_struct *tsk, int cpu);
285
286extern cycle_t ftrace_now(int cpu);
287
288#ifdef CONFIG_FTRACE
289void tracing_start_function_trace(void);
290void tracing_stop_function_trace(void);
291#else
292# define tracing_start_function_trace() do { } while (0)
293# define tracing_stop_function_trace() do { } while (0)
294#endif
295
296#ifdef CONFIG_CONTEXT_SWITCH_TRACER
297typedef void
298(*tracer_switch_func_t)(void *private,
299 void *__rq,
300 struct task_struct *prev,
301 struct task_struct *next);
302
303struct tracer_switch_ops {
304 tracer_switch_func_t func;
305 void *private;
306 struct tracer_switch_ops *next;
307};
308
309#endif /* CONFIG_CONTEXT_SWITCH_TRACER */
310
311#ifdef CONFIG_DYNAMIC_FTRACE
312extern unsigned long ftrace_update_tot_cnt;
313#define DYN_FTRACE_TEST_NAME trace_selftest_dynamic_test_func
314extern int DYN_FTRACE_TEST_NAME(void);
315#endif
316
317#ifdef CONFIG_FTRACE_STARTUP_TEST
318#ifdef CONFIG_FTRACE
319extern int trace_selftest_startup_function(struct tracer *trace,
320 struct trace_array *tr);
321#endif
322#ifdef CONFIG_IRQSOFF_TRACER
323extern int trace_selftest_startup_irqsoff(struct tracer *trace,
324 struct trace_array *tr);
325#endif
326#ifdef CONFIG_PREEMPT_TRACER
327extern int trace_selftest_startup_preemptoff(struct tracer *trace,
328 struct trace_array *tr);
329#endif
330#if defined(CONFIG_IRQSOFF_TRACER) && defined(CONFIG_PREEMPT_TRACER)
331extern int trace_selftest_startup_preemptirqsoff(struct tracer *trace,
332 struct trace_array *tr);
333#endif
334#ifdef CONFIG_SCHED_TRACER
335extern int trace_selftest_startup_wakeup(struct tracer *trace,
336 struct trace_array *tr);
337#endif
338#ifdef CONFIG_CONTEXT_SWITCH_TRACER
339extern int trace_selftest_startup_sched_switch(struct tracer *trace,
340 struct trace_array *tr);
341#endif
342#ifdef CONFIG_SYSPROF_TRACER
343extern int trace_selftest_startup_sysprof(struct tracer *trace,
344 struct trace_array *tr);
345#endif
346#endif /* CONFIG_FTRACE_STARTUP_TEST */
347
348extern void *head_page(struct trace_array_cpu *data);
349extern int trace_seq_printf(struct trace_seq *s, const char *fmt, ...);
350extern void trace_seq_print_cont(struct trace_seq *s,
351 struct trace_iterator *iter);
352extern ssize_t trace_seq_to_user(struct trace_seq *s, char __user *ubuf,
353 size_t cnt);
354extern long ns2usecs(cycle_t nsec);
355extern int trace_vprintk(unsigned long ip, const char *fmt, va_list args);
356
357extern unsigned long trace_flags;
358
359/*
360 * trace_iterator_flags is an enumeration that defines bit
361 * positions into trace_flags that controls the output.
362 *
363 * NOTE: These bits must match the trace_options array in
364 * trace.c.
365 */
366enum trace_iterator_flags {
367 TRACE_ITER_PRINT_PARENT = 0x01,
368 TRACE_ITER_SYM_OFFSET = 0x02,
369 TRACE_ITER_SYM_ADDR = 0x04,
370 TRACE_ITER_VERBOSE = 0x08,
371 TRACE_ITER_RAW = 0x10,
372 TRACE_ITER_HEX = 0x20,
373 TRACE_ITER_BIN = 0x40,
374 TRACE_ITER_BLOCK = 0x80,
375 TRACE_ITER_STACKTRACE = 0x100,
376 TRACE_ITER_SCHED_TREE = 0x200,
377 TRACE_ITER_PRINTK = 0x400,
378};
379
380#endif /* _LINUX_KERNEL_TRACE_H */
This page took 0.023948 seconds and 5 git commands to generate.