blob: ab39990cc43f821b5b224b94babce01788a2b4a3 [file] [log] [blame]
Mike Frysinger9849ed42010-07-20 03:13:35 -04001/*
2 * Ftrace header. For implementation details beyond the random comments
3 * scattered below, see: Documentation/trace/ftrace-design.txt
4 */
5
Arnaldo Carvalho de Melo16444a82008-05-12 21:20:42 +02006#ifndef _LINUX_FTRACE_H
7#define _LINUX_FTRACE_H
8
Frederic Weisbecker00126932009-03-05 01:49:22 +01009#include <linux/trace_clock.h>
Frederic Weisbecker56010202008-10-02 13:26:05 +020010#include <linux/kallsyms.h>
Frederic Weisbecker00126932009-03-05 01:49:22 +010011#include <linux/linkage.h>
Steven Rostedtea4e2bc2008-12-03 15:36:57 -050012#include <linux/bitops.h>
Steven Rostedta1e2e312011-08-09 12:50:46 -040013#include <linux/ptrace.h>
Frederic Weisbecker00126932009-03-05 01:49:22 +010014#include <linux/ktime.h>
Frederic Weisbecker21a8c462008-12-04 23:51:23 +010015#include <linux/sched.h>
Frederic Weisbecker00126932009-03-05 01:49:22 +010016#include <linux/types.h>
17#include <linux/init.h>
18#include <linux/fs.h>
Arnaldo Carvalho de Melo16444a82008-05-12 21:20:42 +020019
Uwe Kleine-Koenigc79a61f2009-02-27 21:30:03 +010020#include <asm/ftrace.h>
21
Steven Rostedt2f5f6ad2011-08-08 16:57:47 -040022/*
23 * If the arch supports passing the variable contents of
24 * function_trace_op as the third parameter back from the
25 * mcount call, then the arch should define this as 1.
26 */
27#ifndef ARCH_SUPPORTS_FTRACE_OPS
28#define ARCH_SUPPORTS_FTRACE_OPS 0
29#endif
30
Steven Rostedtccf36722012-06-05 09:44:25 -040031/*
32 * If the arch's mcount caller does not support all of ftrace's
33 * features, then it must call an indirect function that
34 * does. Or at least does enough to prevent any unwelcomed side effects.
35 */
36#if !defined(CONFIG_HAVE_FUNCTION_TRACE_MCOUNT_TEST) || \
37 !ARCH_SUPPORTS_FTRACE_OPS
38# define FTRACE_FORCE_LIST_FUNC 1
39#else
40# define FTRACE_FORCE_LIST_FUNC 0
41#endif
42
43
Paul Gortmakerde477252011-05-26 13:46:22 -040044struct module;
Steven Rostedt04da85b2011-07-11 10:12:59 -040045struct ftrace_hash;
46
Steven Rostedt606576c2008-10-06 19:06:12 -040047#ifdef CONFIG_FUNCTION_TRACER
Ingo Molnar3e1932a2008-10-02 17:45:47 +020048
Steven Rostedtb0fc4942008-05-12 21:20:43 +020049extern int ftrace_enabled;
50extern int
51ftrace_enable_sysctl(struct ctl_table *table, int write,
Alexey Dobriyan8d65af72009-09-23 15:57:19 -070052 void __user *buffer, size_t *lenp,
Steven Rostedtb0fc4942008-05-12 21:20:43 +020053 loff_t *ppos);
54
Steven Rostedt2f5f6ad2011-08-08 16:57:47 -040055struct ftrace_ops;
56
57typedef void (*ftrace_func_t)(unsigned long ip, unsigned long parent_ip,
Steven Rostedta1e2e312011-08-09 12:50:46 -040058 struct ftrace_ops *op, struct pt_regs *regs);
Arnaldo Carvalho de Melo16444a82008-05-12 21:20:42 +020059
Jiri Olsae2484912012-02-15 15:51:48 +010060/*
61 * FTRACE_OPS_FL_* bits denote the state of ftrace_ops struct and are
62 * set in the flags member.
63 *
64 * ENABLED - set/unset when ftrace_ops is registered/unregistered
65 * GLOBAL - set manualy by ftrace_ops user to denote the ftrace_ops
66 * is part of the global tracers sharing the same filter
67 * via set_ftrace_* debugfs files.
68 * DYNAMIC - set when ftrace_ops is registered to denote dynamically
69 * allocated ftrace_ops which need special care
70 * CONTROL - set manualy by ftrace_ops user to denote the ftrace_ops
71 * could be controled by following calls:
72 * ftrace_function_local_enable
73 * ftrace_function_local_disable
Steven Rostedt08f6fba2012-04-30 16:20:23 -040074 * SAVE_REGS - The ftrace_ops wants regs saved at each function called
75 * and passed to the callback. If this flag is set, but the
76 * architecture does not support passing regs
77 * (ARCH_SUPPORTS_FTRACE_SAVE_REGS is not defined), then the
78 * ftrace_ops will fail to register, unless the next flag
79 * is set.
80 * SAVE_REGS_IF_SUPPORTED - This is the same as SAVE_REGS, but if the
81 * handler can handle an arch that does not save regs
82 * (the handler tests if regs == NULL), then it can set
83 * this flag instead. It will not fail registering the ftrace_ops
84 * but, the regs field will be NULL if the arch does not support
85 * passing regs to the handler.
86 * Note, if this flag is set, the SAVE_REGS flag will automatically
87 * get set upon registering the ftrace_ops, if the arch supports it.
Jiri Olsae2484912012-02-15 15:51:48 +010088 */
Steven Rostedtb8489142011-05-04 09:27:52 -040089enum {
Steven Rostedt08f6fba2012-04-30 16:20:23 -040090 FTRACE_OPS_FL_ENABLED = 1 << 0,
91 FTRACE_OPS_FL_GLOBAL = 1 << 1,
92 FTRACE_OPS_FL_DYNAMIC = 1 << 2,
93 FTRACE_OPS_FL_CONTROL = 1 << 3,
94 FTRACE_OPS_FL_SAVE_REGS = 1 << 4,
95 FTRACE_OPS_FL_SAVE_REGS_IF_SUPPORTED = 1 << 5,
Steven Rostedtb8489142011-05-04 09:27:52 -040096};
97
Arnaldo Carvalho de Melo16444a82008-05-12 21:20:42 +020098struct ftrace_ops {
Steven Rostedtf45948e2011-05-02 12:29:25 -040099 ftrace_func_t func;
100 struct ftrace_ops *next;
Steven Rostedtb8489142011-05-04 09:27:52 -0400101 unsigned long flags;
Jiri Olsae2484912012-02-15 15:51:48 +0100102 int __percpu *disabled;
Steven Rostedtf45948e2011-05-02 12:29:25 -0400103#ifdef CONFIG_DYNAMIC_FTRACE
104 struct ftrace_hash *notrace_hash;
105 struct ftrace_hash *filter_hash;
106#endif
Arnaldo Carvalho de Melo16444a82008-05-12 21:20:42 +0200107};
108
Steven Rostedt60a7ecf2008-11-05 16:05:44 -0500109extern int function_trace_stop;
110
Frederic Weisbeckere7d37372008-11-16 06:02:06 +0100111/*
112 * Type of the current tracing.
113 */
114enum ftrace_tracing_type_t {
115 FTRACE_TYPE_ENTER = 0, /* Hook the call of the function */
116 FTRACE_TYPE_RETURN, /* Hook the return of the function */
117};
118
119/* Current tracing type, default is FTRACE_TYPE_ENTER */
120extern enum ftrace_tracing_type_t ftrace_tracing_type;
121
Steven Rostedt60a7ecf2008-11-05 16:05:44 -0500122/**
123 * ftrace_stop - stop function tracer.
124 *
125 * A quick way to stop the function tracer. Note this an on off switch,
126 * it is not something that is recursive like preempt_disable.
127 * This does not disable the calling of mcount, it only stops the
128 * calling of functions from mcount.
129 */
130static inline void ftrace_stop(void)
131{
132 function_trace_stop = 1;
133}
134
135/**
136 * ftrace_start - start the function tracer.
137 *
138 * This function is the inverse of ftrace_stop. This does not enable
139 * the function tracing if the function tracer is disabled. This only
140 * sets the function tracer flag to continue calling the functions
141 * from mcount.
142 */
143static inline void ftrace_start(void)
144{
145 function_trace_stop = 0;
146}
147
Arnaldo Carvalho de Melo16444a82008-05-12 21:20:42 +0200148/*
149 * The ftrace_ops must be a static and should also
150 * be read_mostly. These functions do modify read_mostly variables
151 * so use them sparely. Never free an ftrace_op or modify the
152 * next pointer after it has been registered. Even after unregistering
153 * it, the next pointer may still be used internally.
154 */
155int register_ftrace_function(struct ftrace_ops *ops);
156int unregister_ftrace_function(struct ftrace_ops *ops);
157void clear_ftrace_function(void);
158
Jiri Olsae2484912012-02-15 15:51:48 +0100159/**
160 * ftrace_function_local_enable - enable controlled ftrace_ops on current cpu
161 *
162 * This function enables tracing on current cpu by decreasing
163 * the per cpu control variable.
164 * It must be called with preemption disabled and only on ftrace_ops
165 * registered with FTRACE_OPS_FL_CONTROL. If called without preemption
166 * disabled, this_cpu_ptr will complain when CONFIG_DEBUG_PREEMPT is enabled.
167 */
168static inline void ftrace_function_local_enable(struct ftrace_ops *ops)
169{
170 if (WARN_ON_ONCE(!(ops->flags & FTRACE_OPS_FL_CONTROL)))
171 return;
172
173 (*this_cpu_ptr(ops->disabled))--;
174}
175
176/**
177 * ftrace_function_local_disable - enable controlled ftrace_ops on current cpu
178 *
179 * This function enables tracing on current cpu by decreasing
180 * the per cpu control variable.
181 * It must be called with preemption disabled and only on ftrace_ops
182 * registered with FTRACE_OPS_FL_CONTROL. If called without preemption
183 * disabled, this_cpu_ptr will complain when CONFIG_DEBUG_PREEMPT is enabled.
184 */
185static inline void ftrace_function_local_disable(struct ftrace_ops *ops)
186{
187 if (WARN_ON_ONCE(!(ops->flags & FTRACE_OPS_FL_CONTROL)))
188 return;
189
190 (*this_cpu_ptr(ops->disabled))++;
191}
192
193/**
194 * ftrace_function_local_disabled - returns ftrace_ops disabled value
195 * on current cpu
196 *
197 * This function returns value of ftrace_ops::disabled on current cpu.
198 * It must be called with preemption disabled and only on ftrace_ops
199 * registered with FTRACE_OPS_FL_CONTROL. If called without preemption
200 * disabled, this_cpu_ptr will complain when CONFIG_DEBUG_PREEMPT is enabled.
201 */
202static inline int ftrace_function_local_disabled(struct ftrace_ops *ops)
203{
204 WARN_ON_ONCE(!(ops->flags & FTRACE_OPS_FL_CONTROL));
205 return *this_cpu_ptr(ops->disabled);
206}
207
Steven Rostedta1e2e312011-08-09 12:50:46 -0400208extern void ftrace_stub(unsigned long a0, unsigned long a1,
209 struct ftrace_ops *op, struct pt_regs *regs);
Arnaldo Carvalho de Melo16444a82008-05-12 21:20:42 +0200210
Steven Rostedt606576c2008-10-06 19:06:12 -0400211#else /* !CONFIG_FUNCTION_TRACER */
Steven Rostedt4dbf6bc2010-05-04 11:24:01 -0400212/*
213 * (un)register_ftrace_function must be a macro since the ops parameter
214 * must not be evaluated.
215 */
216#define register_ftrace_function(ops) ({ 0; })
217#define unregister_ftrace_function(ops) ({ 0; })
218static inline void clear_ftrace_function(void) { }
Steven Rostedt81adbdc2008-10-23 09:33:02 -0400219static inline void ftrace_kill(void) { }
Steven Rostedt60a7ecf2008-11-05 16:05:44 -0500220static inline void ftrace_stop(void) { }
221static inline void ftrace_start(void) { }
Steven Rostedt606576c2008-10-06 19:06:12 -0400222#endif /* CONFIG_FUNCTION_TRACER */
Steven Rostedt352ad252008-05-12 21:20:42 +0200223
Steven Rostedtf38f1d22008-12-16 23:06:40 -0500224#ifdef CONFIG_STACK_TRACER
225extern int stack_tracer_enabled;
226int
227stack_trace_sysctl(struct ctl_table *table, int write,
Alexey Dobriyan8d65af72009-09-23 15:57:19 -0700228 void __user *buffer, size_t *lenp,
Steven Rostedtf38f1d22008-12-16 23:06:40 -0500229 loff_t *ppos);
230#endif
231
Steven Rostedtf6180772009-02-14 00:40:25 -0500232struct ftrace_func_command {
233 struct list_head list;
234 char *name;
Steven Rostedt43dd61c2011-07-07 11:09:22 -0400235 int (*func)(struct ftrace_hash *hash,
236 char *func, char *cmd,
Steven Rostedtf6180772009-02-14 00:40:25 -0500237 char *params, int enable);
238};
239
Steven Rostedt3d083392008-05-12 21:20:42 +0200240#ifdef CONFIG_DYNAMIC_FTRACE
Steven Rostedt31e88902008-11-14 16:21:19 -0800241
Steven Rostedt000ab692009-02-17 13:35:06 -0500242int ftrace_arch_code_modify_prepare(void);
243int ftrace_arch_code_modify_post_process(void);
244
Steven Rostedtc88fd862011-08-16 09:53:39 -0400245void ftrace_bug(int err, unsigned long ip);
246
Steven Rostedt809dcf22009-02-16 23:06:01 -0500247struct seq_file;
248
Steven Rostedtb6887d72009-02-17 12:32:04 -0500249struct ftrace_probe_ops {
Steven Rostedt59df055f2009-02-14 15:29:06 -0500250 void (*func)(unsigned long ip,
251 unsigned long parent_ip,
252 void **data);
253 int (*callback)(unsigned long ip, void **data);
254 void (*free)(void **data);
Steven Rostedt809dcf22009-02-16 23:06:01 -0500255 int (*print)(struct seq_file *m,
256 unsigned long ip,
Steven Rostedtb6887d72009-02-17 12:32:04 -0500257 struct ftrace_probe_ops *ops,
Steven Rostedt809dcf22009-02-16 23:06:01 -0500258 void *data);
Steven Rostedt59df055f2009-02-14 15:29:06 -0500259};
260
261extern int
Steven Rostedtb6887d72009-02-17 12:32:04 -0500262register_ftrace_function_probe(char *glob, struct ftrace_probe_ops *ops,
Steven Rostedt59df055f2009-02-14 15:29:06 -0500263 void *data);
264extern void
Steven Rostedtb6887d72009-02-17 12:32:04 -0500265unregister_ftrace_function_probe(char *glob, struct ftrace_probe_ops *ops,
Steven Rostedt59df055f2009-02-14 15:29:06 -0500266 void *data);
267extern void
Steven Rostedtb6887d72009-02-17 12:32:04 -0500268unregister_ftrace_function_probe_func(char *glob, struct ftrace_probe_ops *ops);
269extern void unregister_ftrace_function_probe_all(char *glob);
Steven Rostedt59df055f2009-02-14 15:29:06 -0500270
Masami Hiramatsu2cfa1972010-02-02 16:49:11 -0500271extern int ftrace_text_reserved(void *start, void *end);
272
Steven Rostedt08f6fba2012-04-30 16:20:23 -0400273/*
274 * The dyn_ftrace record's flags field is split into two parts.
275 * the first part which is '0-FTRACE_REF_MAX' is a counter of
276 * the number of callbacks that have registered the function that
277 * the dyn_ftrace descriptor represents.
278 *
279 * The second part is a mask:
280 * ENABLED - the function is being traced
281 * REGS - the record wants the function to save regs
282 * REGS_EN - the function is set up to save regs.
283 *
284 * When a new ftrace_ops is registered and wants a function to save
285 * pt_regs, the rec->flag REGS is set. When the function has been
286 * set up to save regs, the REG_EN flag is set. Once a function
287 * starts saving regs it will do so until all ftrace_ops are removed
288 * from tracing that function.
289 */
Steven Rostedt3c1720f2008-05-12 21:20:43 +0200290enum {
Steven Rostedt08f6fba2012-04-30 16:20:23 -0400291 FTRACE_FL_ENABLED = (1UL << 29),
292 FTRACE_FL_REGS = (1UL << 30),
293 FTRACE_FL_REGS_EN = (1UL << 31)
Steven Rostedt3c1720f2008-05-12 21:20:43 +0200294};
295
Steven Rostedt08f6fba2012-04-30 16:20:23 -0400296#define FTRACE_FL_MASK (0x7UL << 29)
297#define FTRACE_REF_MAX ((1UL << 29) - 1)
Steven Rostedted926f92011-05-03 13:25:24 -0400298
Steven Rostedt3d083392008-05-12 21:20:42 +0200299struct dyn_ftrace {
Lai Jiangshanee000b72009-03-24 13:38:06 +0800300 union {
301 unsigned long ip; /* address of mcount call-site */
302 struct dyn_ftrace *freelist;
303 };
Steven Rostedt85ae32a2011-12-16 16:30:31 -0500304 unsigned long flags;
Lai Jiangshanee000b72009-03-24 13:38:06 +0800305 struct dyn_arch_ftrace arch;
Steven Rostedt3d083392008-05-12 21:20:42 +0200306};
307
Steven Rostedte1c08bd2008-05-12 21:20:44 +0200308int ftrace_force_update(void);
Jiri Olsaac483c42012-01-02 10:04:14 +0100309int ftrace_set_filter(struct ftrace_ops *ops, unsigned char *buf,
Steven Rostedt936e0742011-05-05 22:54:01 -0400310 int len, int reset);
Jiri Olsaac483c42012-01-02 10:04:14 +0100311int ftrace_set_notrace(struct ftrace_ops *ops, unsigned char *buf,
Steven Rostedt936e0742011-05-05 22:54:01 -0400312 int len, int reset);
313void ftrace_set_global_filter(unsigned char *buf, int len, int reset);
314void ftrace_set_global_notrace(unsigned char *buf, int len, int reset);
Jiri Olsa5500fa52012-02-15 15:51:54 +0100315void ftrace_free_filter(struct ftrace_ops *ops);
Steven Rostedte1c08bd2008-05-12 21:20:44 +0200316
Steven Rostedtf6180772009-02-14 00:40:25 -0500317int register_ftrace_command(struct ftrace_func_command *cmd);
318int unregister_ftrace_command(struct ftrace_func_command *cmd);
319
Steven Rostedtc88fd862011-08-16 09:53:39 -0400320enum {
321 FTRACE_UPDATE_CALLS = (1 << 0),
322 FTRACE_DISABLE_CALLS = (1 << 1),
323 FTRACE_UPDATE_TRACE_FUNC = (1 << 2),
324 FTRACE_START_FUNC_RET = (1 << 3),
325 FTRACE_STOP_FUNC_RET = (1 << 4),
326};
327
Steven Rostedt08f6fba2012-04-30 16:20:23 -0400328/*
329 * The FTRACE_UPDATE_* enum is used to pass information back
330 * from the ftrace_update_record() and ftrace_test_record()
331 * functions. These are called by the code update routines
332 * to find out what is to be done for a given function.
333 *
334 * IGNORE - The function is already what we want it to be
335 * MAKE_CALL - Start tracing the function
336 * MODIFY_CALL - Stop saving regs for the function
337 * MODIFY_CALL_REGS - Start saving regs for the function
338 * MAKE_NOP - Stop tracing the function
339 */
Steven Rostedtc88fd862011-08-16 09:53:39 -0400340enum {
341 FTRACE_UPDATE_IGNORE,
342 FTRACE_UPDATE_MAKE_CALL,
Steven Rostedt08f6fba2012-04-30 16:20:23 -0400343 FTRACE_UPDATE_MODIFY_CALL,
344 FTRACE_UPDATE_MODIFY_CALL_REGS,
Steven Rostedtc88fd862011-08-16 09:53:39 -0400345 FTRACE_UPDATE_MAKE_NOP,
346};
347
Steven Rostedtfc13cb02011-12-19 14:41:25 -0500348enum {
349 FTRACE_ITER_FILTER = (1 << 0),
350 FTRACE_ITER_NOTRACE = (1 << 1),
351 FTRACE_ITER_PRINTALL = (1 << 2),
Steven Rostedt69a30832011-12-19 15:21:16 -0500352 FTRACE_ITER_DO_HASH = (1 << 3),
353 FTRACE_ITER_HASH = (1 << 4),
354 FTRACE_ITER_ENABLED = (1 << 5),
Steven Rostedtfc13cb02011-12-19 14:41:25 -0500355};
356
Steven Rostedtc88fd862011-08-16 09:53:39 -0400357void arch_ftrace_update_code(int command);
358
359struct ftrace_rec_iter;
360
361struct ftrace_rec_iter *ftrace_rec_iter_start(void);
362struct ftrace_rec_iter *ftrace_rec_iter_next(struct ftrace_rec_iter *iter);
363struct dyn_ftrace *ftrace_rec_iter_record(struct ftrace_rec_iter *iter);
364
Steven Rostedt08d636b2011-08-16 09:57:10 -0400365#define for_ftrace_rec_iter(iter) \
366 for (iter = ftrace_rec_iter_start(); \
367 iter; \
368 iter = ftrace_rec_iter_next(iter))
369
370
Steven Rostedtc88fd862011-08-16 09:53:39 -0400371int ftrace_update_record(struct dyn_ftrace *rec, int enable);
372int ftrace_test_record(struct dyn_ftrace *rec, int enable);
373void ftrace_run_stop_machine(int command);
Steven Rostedtf0cf9732012-04-25 14:39:54 -0400374unsigned long ftrace_location(unsigned long ip);
Steven Rostedtc88fd862011-08-16 09:53:39 -0400375
376extern ftrace_func_t ftrace_trace_function;
377
Steven Rostedtfc13cb02011-12-19 14:41:25 -0500378int ftrace_regex_open(struct ftrace_ops *ops, int flag,
379 struct inode *inode, struct file *file);
380ssize_t ftrace_filter_write(struct file *file, const char __user *ubuf,
381 size_t cnt, loff_t *ppos);
382ssize_t ftrace_notrace_write(struct file *file, const char __user *ubuf,
383 size_t cnt, loff_t *ppos);
384loff_t ftrace_regex_lseek(struct file *file, loff_t offset, int origin);
385int ftrace_regex_release(struct inode *inode, struct file *file);
386
Steven Rostedt2a85a372011-12-19 21:57:44 -0500387void __init
388ftrace_set_early_filter(struct ftrace_ops *ops, char *buf, int enable);
389
Steven Rostedt3d083392008-05-12 21:20:42 +0200390/* defined in arch */
Steven Rostedt3c1720f2008-05-12 21:20:43 +0200391extern int ftrace_ip_converted(unsigned long ip);
Steven Rostedtd61f82d2008-05-12 21:20:43 +0200392extern int ftrace_dyn_arch_init(void *data);
Steven Rostedte4f5d542012-04-27 09:13:18 -0400393extern void ftrace_replace_code(int enable);
Steven Rostedtd61f82d2008-05-12 21:20:43 +0200394extern int ftrace_update_ftrace_func(ftrace_func_t func);
395extern void ftrace_caller(void);
Steven Rostedt08f6fba2012-04-30 16:20:23 -0400396extern void ftrace_regs_caller(void);
Steven Rostedtd61f82d2008-05-12 21:20:43 +0200397extern void ftrace_call(void);
Steven Rostedt08f6fba2012-04-30 16:20:23 -0400398extern void ftrace_regs_call(void);
Steven Rostedtd61f82d2008-05-12 21:20:43 +0200399extern void mcount_call(void);
Shaohua Lif0001202009-01-09 11:29:42 +0800400
Steven Rostedt8ed3e2c2012-04-26 14:59:43 -0400401void ftrace_modify_all_code(int command);
402
Shaohua Lif0001202009-01-09 11:29:42 +0800403#ifndef FTRACE_ADDR
404#define FTRACE_ADDR ((unsigned long)ftrace_caller)
405#endif
Steven Rostedt08f6fba2012-04-30 16:20:23 -0400406
407#ifndef FTRACE_REGS_ADDR
408#ifdef ARCH_SUPPORTS_FTRACE_SAVE_REGS
409# define FTRACE_REGS_ADDR ((unsigned long)ftrace_regs_caller)
410#else
411# define FTRACE_REGS_ADDR FTRACE_ADDR
412#endif
413#endif
414
Frederic Weisbeckerfb526072008-11-25 21:07:04 +0100415#ifdef CONFIG_FUNCTION_GRAPH_TRACER
416extern void ftrace_graph_caller(void);
Steven Rostedt5a45cfe2008-11-26 00:16:24 -0500417extern int ftrace_enable_ftrace_graph_caller(void);
418extern int ftrace_disable_ftrace_graph_caller(void);
419#else
420static inline int ftrace_enable_ftrace_graph_caller(void) { return 0; }
421static inline int ftrace_disable_ftrace_graph_caller(void) { return 0; }
Frederic Weisbeckere7d37372008-11-16 06:02:06 +0100422#endif
Steven Rostedtad90c0e2008-05-27 20:48:37 -0400423
Steven Rostedt593eb8a2008-10-23 09:32:59 -0400424/**
Wenji Huang57794a92009-02-06 17:33:27 +0800425 * ftrace_make_nop - convert code into nop
Steven Rostedt31e88902008-11-14 16:21:19 -0800426 * @mod: module structure if called by module load initialization
427 * @rec: the mcount call site record
428 * @addr: the address that the call site should be calling
Steven Rostedt593eb8a2008-10-23 09:32:59 -0400429 *
430 * This is a very sensitive operation and great care needs
431 * to be taken by the arch. The operation should carefully
432 * read the location, check to see if what is read is indeed
433 * what we expect it to be, and then on success of the compare,
434 * it should write to the location.
435 *
Steven Rostedt31e88902008-11-14 16:21:19 -0800436 * The code segment at @rec->ip should be a caller to @addr
437 *
Steven Rostedt593eb8a2008-10-23 09:32:59 -0400438 * Return must be:
439 * 0 on success
440 * -EFAULT on error reading the location
441 * -EINVAL on a failed compare of the contents
442 * -EPERM on error writing to the location
443 * Any other value will be considered a failure.
444 */
Steven Rostedt31e88902008-11-14 16:21:19 -0800445extern int ftrace_make_nop(struct module *mod,
446 struct dyn_ftrace *rec, unsigned long addr);
447
448/**
449 * ftrace_make_call - convert a nop call site into a call to addr
450 * @rec: the mcount call site record
451 * @addr: the address that the call site should call
452 *
453 * This is a very sensitive operation and great care needs
454 * to be taken by the arch. The operation should carefully
455 * read the location, check to see if what is read is indeed
456 * what we expect it to be, and then on success of the compare,
457 * it should write to the location.
458 *
459 * The code segment at @rec->ip should be a nop
460 *
461 * Return must be:
462 * 0 on success
463 * -EFAULT on error reading the location
464 * -EINVAL on a failed compare of the contents
465 * -EPERM on error writing to the location
466 * Any other value will be considered a failure.
467 */
468extern int ftrace_make_call(struct dyn_ftrace *rec, unsigned long addr);
469
Steven Rostedt08f6fba2012-04-30 16:20:23 -0400470#ifdef ARCH_SUPPORTS_FTRACE_SAVE_REGS
471/**
472 * ftrace_modify_call - convert from one addr to another (no nop)
473 * @rec: the mcount call site record
474 * @old_addr: the address expected to be currently called to
475 * @addr: the address to change to
476 *
477 * This is a very sensitive operation and great care needs
478 * to be taken by the arch. The operation should carefully
479 * read the location, check to see if what is read is indeed
480 * what we expect it to be, and then on success of the compare,
481 * it should write to the location.
482 *
483 * The code segment at @rec->ip should be a caller to @old_addr
484 *
485 * Return must be:
486 * 0 on success
487 * -EFAULT on error reading the location
488 * -EINVAL on a failed compare of the contents
489 * -EPERM on error writing to the location
490 * Any other value will be considered a failure.
491 */
492extern int ftrace_modify_call(struct dyn_ftrace *rec, unsigned long old_addr,
493 unsigned long addr);
494#else
495/* Should never be called */
496static inline int ftrace_modify_call(struct dyn_ftrace *rec, unsigned long old_addr,
497 unsigned long addr)
498{
499 return -EINVAL;
500}
501#endif
502
Steven Rostedt31e88902008-11-14 16:21:19 -0800503/* May be defined in arch */
504extern int ftrace_arch_read_dyn_info(char *buf, int size);
Steven Rostedt593eb8a2008-10-23 09:32:59 -0400505
Abhishek Sagarecea6562008-06-21 23:47:53 +0530506extern int skip_trace(unsigned long ip);
507
Steven Rostedtc0719e52008-09-06 01:06:03 -0400508extern void ftrace_disable_daemon(void);
509extern void ftrace_enable_daemon(void);
Steven Rostedte1c08bd2008-05-12 21:20:44 +0200510#else
Steven Rostedt4dbf6bc2010-05-04 11:24:01 -0400511static inline int skip_trace(unsigned long ip) { return 0; }
512static inline int ftrace_force_update(void) { return 0; }
Steven Rostedt4dbf6bc2010-05-04 11:24:01 -0400513static inline void ftrace_disable_daemon(void) { }
514static inline void ftrace_enable_daemon(void) { }
jolsa@redhat.come7247a12009-10-07 19:00:35 +0200515static inline void ftrace_release_mod(struct module *mod) {}
Steven Rostedtf6180772009-02-14 00:40:25 -0500516static inline int register_ftrace_command(struct ftrace_func_command *cmd)
517{
Ingo Molnar97d0bb82009-02-17 11:47:39 +0100518 return -EINVAL;
Steven Rostedtf6180772009-02-14 00:40:25 -0500519}
520static inline int unregister_ftrace_command(char *cmd_name)
521{
Ingo Molnar97d0bb82009-02-17 11:47:39 +0100522 return -EINVAL;
Steven Rostedtf6180772009-02-14 00:40:25 -0500523}
Masami Hiramatsu2cfa1972010-02-02 16:49:11 -0500524static inline int ftrace_text_reserved(void *start, void *end)
525{
526 return 0;
527}
Steven Rostedtfc13cb02011-12-19 14:41:25 -0500528
529/*
530 * Again users of functions that have ftrace_ops may not
531 * have them defined when ftrace is not enabled, but these
532 * functions may still be called. Use a macro instead of inline.
533 */
534#define ftrace_regex_open(ops, flag, inod, file) ({ -ENODEV; })
Steven Rostedt96de37b2012-01-07 17:26:49 -0500535#define ftrace_set_early_filter(ops, buf, enable) do { } while (0)
Jiri Olsa5500fa52012-02-15 15:51:54 +0100536#define ftrace_set_filter(ops, buf, len, reset) ({ -ENODEV; })
537#define ftrace_set_notrace(ops, buf, len, reset) ({ -ENODEV; })
538#define ftrace_free_filter(ops) do { } while (0)
Steven Rostedtfc13cb02011-12-19 14:41:25 -0500539
540static inline ssize_t ftrace_filter_write(struct file *file, const char __user *ubuf,
541 size_t cnt, loff_t *ppos) { return -ENODEV; }
542static inline ssize_t ftrace_notrace_write(struct file *file, const char __user *ubuf,
543 size_t cnt, loff_t *ppos) { return -ENODEV; }
544static inline loff_t ftrace_regex_lseek(struct file *file, loff_t offset, int origin)
545{
546 return -ENODEV;
547}
548static inline int
549ftrace_regex_release(struct inode *inode, struct file *file) { return -ENODEV; }
Abhishek Sagarecea6562008-06-21 23:47:53 +0530550#endif /* CONFIG_DYNAMIC_FTRACE */
Steven Rostedt352ad252008-05-12 21:20:42 +0200551
Ingo Molnaraeaee8a2008-05-12 21:20:49 +0200552/* totally disable ftrace - can not re-enable after this */
553void ftrace_kill(void);
554
Ingo Molnarf43fdad2008-05-12 21:20:43 +0200555static inline void tracer_disable(void)
556{
Steven Rostedt606576c2008-10-06 19:06:12 -0400557#ifdef CONFIG_FUNCTION_TRACER
Ingo Molnarf43fdad2008-05-12 21:20:43 +0200558 ftrace_enabled = 0;
559#endif
560}
561
Huang Ying37002732008-08-18 16:24:56 +0800562/*
563 * Ftrace disable/restore without lock. Some synchronization mechanism
Huang Ying9bdeb7b2008-08-15 00:40:25 -0700564 * must be used to prevent ftrace_enabled to be changed between
Huang Ying37002732008-08-18 16:24:56 +0800565 * disable/restore.
566 */
Huang Ying9bdeb7b2008-08-15 00:40:25 -0700567static inline int __ftrace_enabled_save(void)
568{
Steven Rostedt606576c2008-10-06 19:06:12 -0400569#ifdef CONFIG_FUNCTION_TRACER
Huang Ying9bdeb7b2008-08-15 00:40:25 -0700570 int saved_ftrace_enabled = ftrace_enabled;
571 ftrace_enabled = 0;
572 return saved_ftrace_enabled;
573#else
574 return 0;
575#endif
576}
577
578static inline void __ftrace_enabled_restore(int enabled)
579{
Steven Rostedt606576c2008-10-06 19:06:12 -0400580#ifdef CONFIG_FUNCTION_TRACER
Huang Ying9bdeb7b2008-08-15 00:40:25 -0700581 ftrace_enabled = enabled;
582#endif
583}
584
Uwe Kleine-Koenigc79a61f2009-02-27 21:30:03 +0100585#ifndef HAVE_ARCH_CALLER_ADDR
586# ifdef CONFIG_FRAME_POINTER
587# define CALLER_ADDR0 ((unsigned long)__builtin_return_address(0))
588# define CALLER_ADDR1 ((unsigned long)__builtin_return_address(1))
589# define CALLER_ADDR2 ((unsigned long)__builtin_return_address(2))
590# define CALLER_ADDR3 ((unsigned long)__builtin_return_address(3))
591# define CALLER_ADDR4 ((unsigned long)__builtin_return_address(4))
592# define CALLER_ADDR5 ((unsigned long)__builtin_return_address(5))
593# define CALLER_ADDR6 ((unsigned long)__builtin_return_address(6))
594# else
595# define CALLER_ADDR0 ((unsigned long)__builtin_return_address(0))
596# define CALLER_ADDR1 0UL
597# define CALLER_ADDR2 0UL
598# define CALLER_ADDR3 0UL
599# define CALLER_ADDR4 0UL
600# define CALLER_ADDR5 0UL
601# define CALLER_ADDR6 0UL
602# endif
603#endif /* ifndef HAVE_ARCH_CALLER_ADDR */
Steven Rostedt352ad252008-05-12 21:20:42 +0200604
Steven Rostedt81d68a92008-05-12 21:20:42 +0200605#ifdef CONFIG_IRQSOFF_TRACER
Ingo Molnar489f1392008-02-25 13:38:05 +0100606 extern void time_hardirqs_on(unsigned long a0, unsigned long a1);
607 extern void time_hardirqs_off(unsigned long a0, unsigned long a1);
Steven Rostedt81d68a92008-05-12 21:20:42 +0200608#else
Steven Rostedt4dbf6bc2010-05-04 11:24:01 -0400609 static inline void time_hardirqs_on(unsigned long a0, unsigned long a1) { }
610 static inline void time_hardirqs_off(unsigned long a0, unsigned long a1) { }
Steven Rostedt81d68a92008-05-12 21:20:42 +0200611#endif
612
Steven Rostedt6cd8a4b2008-05-12 21:20:42 +0200613#ifdef CONFIG_PREEMPT_TRACER
Ingo Molnar489f1392008-02-25 13:38:05 +0100614 extern void trace_preempt_on(unsigned long a0, unsigned long a1);
615 extern void trace_preempt_off(unsigned long a0, unsigned long a1);
Steven Rostedt6cd8a4b2008-05-12 21:20:42 +0200616#else
Minho Banb02ee9a2012-05-07 11:36:00 +0900617/*
618 * Use defines instead of static inlines because some arches will make code out
619 * of the CALLER_ADDR, when we really want these to be a real nop.
620 */
621# define trace_preempt_on(a0, a1) do { } while (0)
622# define trace_preempt_off(a0, a1) do { } while (0)
Steven Rostedt6cd8a4b2008-05-12 21:20:42 +0200623#endif
624
Steven Rostedt68bf21a2008-08-14 15:45:08 -0400625#ifdef CONFIG_FTRACE_MCOUNT_RECORD
626extern void ftrace_init(void);
627#else
628static inline void ftrace_init(void) { }
629#endif
630
Frederic Weisbecker71566a02008-10-31 12:57:20 +0100631/*
Frederic Weisbecker287b6e62008-11-26 00:57:25 +0100632 * Structure that defines an entry function trace.
633 */
634struct ftrace_graph_ent {
635 unsigned long func; /* Current function */
636 int depth;
637};
Steven Rostedtdd0e5452008-08-01 12:26:41 -0400638
Frederic Weisbecker71566a02008-10-31 12:57:20 +0100639/*
Frederic Weisbeckercaf4b322008-11-11 07:03:45 +0100640 * Structure that defines a return function trace.
641 */
Frederic Weisbeckerfb526072008-11-25 21:07:04 +0100642struct ftrace_graph_ret {
Frederic Weisbeckercaf4b322008-11-11 07:03:45 +0100643 unsigned long func; /* Current function */
644 unsigned long long calltime;
645 unsigned long long rettime;
Frederic Weisbecker02310222008-11-17 03:22:41 +0100646 /* Number of functions that overran the depth limit for current task */
647 unsigned long overrun;
Frederic Weisbecker287b6e62008-11-26 00:57:25 +0100648 int depth;
Frederic Weisbeckercaf4b322008-11-11 07:03:45 +0100649};
650
Jiri Olsa62b915f2010-04-02 19:01:22 +0200651/* Type of the callback handlers for tracing function graph*/
652typedef void (*trace_func_graph_ret_t)(struct ftrace_graph_ret *); /* return */
653typedef int (*trace_func_graph_ent_t)(struct ftrace_graph_ent *); /* entry */
654
Frederic Weisbeckerfb526072008-11-25 21:07:04 +0100655#ifdef CONFIG_FUNCTION_GRAPH_TRACER
Frederic Weisbecker8b96f012008-12-06 03:40:00 +0100656
Steven Rostedt5ac9f622009-03-25 20:55:00 -0400657/* for init task */
Tetsuo Handaf876d342009-04-08 14:05:43 +0900658#define INIT_FTRACE_GRAPH .ret_stack = NULL,
Steven Rostedt5ac9f622009-03-25 20:55:00 -0400659
Frederic Weisbecker8b96f012008-12-06 03:40:00 +0100660/*
Steven Rostedt712406a2009-02-09 10:54:03 -0800661 * Stack of return addresses for functions
662 * of a thread.
663 * Used in struct thread_info
664 */
665struct ftrace_ret_stack {
666 unsigned long ret;
667 unsigned long func;
668 unsigned long long calltime;
Steven Rostedta2a16d62009-03-24 23:17:58 -0400669 unsigned long long subtime;
Steven Rostedt71e308a2009-06-18 12:45:08 -0400670 unsigned long fp;
Steven Rostedt712406a2009-02-09 10:54:03 -0800671};
672
673/*
674 * Primary handler of a function return.
675 * It relays on ftrace_return_to_handler.
676 * Defined in entry_32/64.S
677 */
678extern void return_to_handler(void);
679
680extern int
Steven Rostedt71e308a2009-06-18 12:45:08 -0400681ftrace_push_return_trace(unsigned long ret, unsigned long func, int *depth,
682 unsigned long frame_pointer);
Steven Rostedt712406a2009-02-09 10:54:03 -0800683
684/*
Frederic Weisbecker8b96f012008-12-06 03:40:00 +0100685 * Sometimes we don't want to trace a function with the function
686 * graph tracer but we want them to keep traced by the usual function
687 * tracer if the function graph tracer is not configured.
688 */
689#define __notrace_funcgraph notrace
690
Frederic Weisbeckerbcbc4f22008-12-09 23:54:20 +0100691/*
692 * We want to which function is an entrypoint of a hardirq.
693 * That will help us to put a signal on output.
694 */
695#define __irq_entry __attribute__((__section__(".irqentry.text")))
696
697/* Limits of hardirq entrypoints */
698extern char __irqentry_text_start[];
699extern char __irqentry_text_end[];
700
Frederic Weisbeckerf201ae22008-11-23 06:22:56 +0100701#define FTRACE_RETFUNC_DEPTH 50
702#define FTRACE_RETSTACK_ALLOC_SIZE 32
Frederic Weisbecker287b6e62008-11-26 00:57:25 +0100703extern int register_ftrace_graph(trace_func_graph_ret_t retfunc,
704 trace_func_graph_ent_t entryfunc);
Frederic Weisbeckerf201ae22008-11-23 06:22:56 +0100705
Steven Rostedt14a866c2008-12-02 23:50:02 -0500706extern void ftrace_graph_stop(void);
707
Frederic Weisbecker287b6e62008-11-26 00:57:25 +0100708/* The current handlers in use */
709extern trace_func_graph_ret_t ftrace_graph_return;
710extern trace_func_graph_ent_t ftrace_graph_entry;
711
Frederic Weisbeckerfb526072008-11-25 21:07:04 +0100712extern void unregister_ftrace_graph(void);
Frederic Weisbeckerf201ae22008-11-23 06:22:56 +0100713
Frederic Weisbeckerfb526072008-11-25 21:07:04 +0100714extern void ftrace_graph_init_task(struct task_struct *t);
715extern void ftrace_graph_exit_task(struct task_struct *t);
Steven Rostedt868baf02011-02-10 21:26:13 -0500716extern void ftrace_graph_init_idle_task(struct task_struct *t, int cpu);
Frederic Weisbecker21a8c462008-12-04 23:51:23 +0100717
718static inline int task_curr_ret_stack(struct task_struct *t)
719{
720 return t->curr_ret_stack;
721}
Frederic Weisbecker380c4b12008-12-06 03:43:41 +0100722
723static inline void pause_graph_tracing(void)
724{
725 atomic_inc(&current->tracing_graph_pause);
726}
727
728static inline void unpause_graph_tracing(void)
729{
730 atomic_dec(&current->tracing_graph_pause);
731}
Steven Rostedt5ac9f622009-03-25 20:55:00 -0400732#else /* !CONFIG_FUNCTION_GRAPH_TRACER */
Frederic Weisbecker8b96f012008-12-06 03:40:00 +0100733
734#define __notrace_funcgraph
Frederic Weisbeckerbcbc4f22008-12-09 23:54:20 +0100735#define __irq_entry
Steven Rostedt5ac9f622009-03-25 20:55:00 -0400736#define INIT_FTRACE_GRAPH
Frederic Weisbecker8b96f012008-12-06 03:40:00 +0100737
Frederic Weisbeckerfb526072008-11-25 21:07:04 +0100738static inline void ftrace_graph_init_task(struct task_struct *t) { }
739static inline void ftrace_graph_exit_task(struct task_struct *t) { }
Steven Rostedt868baf02011-02-10 21:26:13 -0500740static inline void ftrace_graph_init_idle_task(struct task_struct *t, int cpu) { }
Frederic Weisbecker21a8c462008-12-04 23:51:23 +0100741
Jiri Olsa62b915f2010-04-02 19:01:22 +0200742static inline int register_ftrace_graph(trace_func_graph_ret_t retfunc,
743 trace_func_graph_ent_t entryfunc)
744{
745 return -1;
746}
747static inline void unregister_ftrace_graph(void) { }
748
Frederic Weisbecker21a8c462008-12-04 23:51:23 +0100749static inline int task_curr_ret_stack(struct task_struct *tsk)
750{
751 return -1;
752}
Frederic Weisbecker380c4b12008-12-06 03:43:41 +0100753
754static inline void pause_graph_tracing(void) { }
755static inline void unpause_graph_tracing(void) { }
Steven Rostedt5ac9f622009-03-25 20:55:00 -0400756#endif /* CONFIG_FUNCTION_GRAPH_TRACER */
Frederic Weisbeckercaf4b322008-11-11 07:03:45 +0100757
Steven Rostedtea4e2bc2008-12-03 15:36:57 -0500758#ifdef CONFIG_TRACING
Steven Rostedtea4e2bc2008-12-03 15:36:57 -0500759
760/* flags for current->trace */
761enum {
762 TSK_TRACE_FL_TRACE_BIT = 0,
763 TSK_TRACE_FL_GRAPH_BIT = 1,
764};
765enum {
766 TSK_TRACE_FL_TRACE = 1 << TSK_TRACE_FL_TRACE_BIT,
767 TSK_TRACE_FL_GRAPH = 1 << TSK_TRACE_FL_GRAPH_BIT,
768};
769
770static inline void set_tsk_trace_trace(struct task_struct *tsk)
771{
772 set_bit(TSK_TRACE_FL_TRACE_BIT, &tsk->trace);
773}
774
775static inline void clear_tsk_trace_trace(struct task_struct *tsk)
776{
777 clear_bit(TSK_TRACE_FL_TRACE_BIT, &tsk->trace);
778}
779
780static inline int test_tsk_trace_trace(struct task_struct *tsk)
781{
782 return tsk->trace & TSK_TRACE_FL_TRACE;
783}
784
785static inline void set_tsk_trace_graph(struct task_struct *tsk)
786{
787 set_bit(TSK_TRACE_FL_GRAPH_BIT, &tsk->trace);
788}
789
790static inline void clear_tsk_trace_graph(struct task_struct *tsk)
791{
792 clear_bit(TSK_TRACE_FL_GRAPH_BIT, &tsk->trace);
793}
794
795static inline int test_tsk_trace_graph(struct task_struct *tsk)
796{
797 return tsk->trace & TSK_TRACE_FL_GRAPH;
798}
799
Frederic Weisbeckercecbca92010-04-18 19:08:41 +0200800enum ftrace_dump_mode;
801
802extern enum ftrace_dump_mode ftrace_dump_on_oops;
Ingo Molnar526211b2009-03-05 10:28:45 +0100803
Steven Rostedt261842b2009-04-16 21:41:52 -0400804#ifdef CONFIG_PREEMPT
805#define INIT_TRACE_RECURSION .trace_recursion = 0,
806#endif
807
Steven Rostedtea4e2bc2008-12-03 15:36:57 -0500808#endif /* CONFIG_TRACING */
809
Steven Rostedt261842b2009-04-16 21:41:52 -0400810#ifndef INIT_TRACE_RECURSION
811#define INIT_TRACE_RECURSION
812#endif
Markus Metzgerb1818742009-01-19 10:31:01 +0100813
Mike Frysingere7b8e672010-01-26 04:40:03 -0500814#ifdef CONFIG_FTRACE_SYSCALLS
815
816unsigned long arch_syscall_addr(int nr);
817
818#endif /* CONFIG_FTRACE_SYSCALLS */
819
Arnaldo Carvalho de Melo16444a82008-05-12 21:20:42 +0200820#endif /* _LINUX_FTRACE_H */