ftrace.h 8.16 KB
Newer Older
1
2
3
4
#ifndef _LINUX_FTRACE_H
#define _LINUX_FTRACE_H

#include <linux/linkage.h>
5
#include <linux/fs.h>
6
#include <linux/ktime.h>
7
8
#include <linux/init.h>
#include <linux/types.h>
9
#include <linux/kallsyms.h>
10

11
#ifdef CONFIG_FUNCTION_TRACER
Ingo Molnar's avatar
Ingo Molnar committed
12

13
14
15
16
17
18
extern int ftrace_enabled;
extern int
ftrace_enable_sysctl(struct ctl_table *table, int write,
		     struct file *filp, void __user *buffer, size_t *lenp,
		     loff_t *ppos);

19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
typedef void (*ftrace_func_t)(unsigned long ip, unsigned long parent_ip);

struct ftrace_ops {
	ftrace_func_t	  func;
	struct ftrace_ops *next;
};

/*
 * The ftrace_ops must be a static and should also
 * be read_mostly.  These functions do modify read_mostly variables
 * so use them sparely. Never free an ftrace_op or modify the
 * next pointer after it has been registered. Even after unregistering
 * it, the next pointer may still be used internally.
 */
int register_ftrace_function(struct ftrace_ops *ops);
int unregister_ftrace_function(struct ftrace_ops *ops);
void clear_ftrace_function(void);

extern void ftrace_stub(unsigned long a0, unsigned long a1);

39
#else /* !CONFIG_FUNCTION_TRACER */
40
41
42
# define register_ftrace_function(ops) do { } while (0)
# define unregister_ftrace_function(ops) do { } while (0)
# define clear_ftrace_function(ops) do { } while (0)
43
static inline void ftrace_kill(void) { }
44
#endif /* CONFIG_FUNCTION_TRACER */
45

46
47
#ifdef CONFIG_DYNAMIC_FTRACE

48
enum {
49
50
51
52
	FTRACE_FL_FREE		= (1 << 0),
	FTRACE_FL_FAILED	= (1 << 1),
	FTRACE_FL_FILTER	= (1 << 2),
	FTRACE_FL_ENABLED	= (1 << 3),
53
	FTRACE_FL_NOTRACE	= (1 << 4),
54
	FTRACE_FL_CONVERTED	= (1 << 5),
55
	FTRACE_FL_FROZEN	= (1 << 6),
56
57
};

58
struct dyn_ftrace {
Steven Rostedt's avatar
Steven Rostedt committed
59
60
61
	struct list_head	list;
	unsigned long		ip; /* address of mcount call-site */
	unsigned long		flags;
62
63
};

Steven Rostedt's avatar
Steven Rostedt committed
64
int ftrace_force_update(void);
65
void ftrace_set_filter(unsigned char *buf, int len, int reset);
Steven Rostedt's avatar
Steven Rostedt committed
66

67
/* defined in arch */
68
69
70
extern int ftrace_ip_converted(unsigned long ip);
extern unsigned char *ftrace_nop_replace(void);
extern unsigned char *ftrace_call_replace(unsigned long ip, unsigned long addr);
71
72
73
74
75
extern int ftrace_dyn_arch_init(void *data);
extern int ftrace_update_ftrace_func(ftrace_func_t func);
extern void ftrace_caller(void);
extern void ftrace_call(void);
extern void mcount_call(void);
76

77
78
79
/* May be defined in arch */
extern int ftrace_arch_read_dyn_info(char *buf, int size);

80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
/**
 * ftrace_modify_code - modify code segment
 * @ip: the address of the code segment
 * @old_code: the contents of what is expected to be there
 * @new_code: the code to patch in
 *
 * This is a very sensitive operation and great care needs
 * to be taken by the arch.  The operation should carefully
 * read the location, check to see if what is read is indeed
 * what we expect it to be, and then on success of the compare,
 * it should write to the location.
 *
 * Return must be:
 *  0 on success
 *  -EFAULT on error reading the location
 *  -EINVAL on a failed compare of the contents
 *  -EPERM  on error writing to the location
 * Any other value will be considered a failure.
 */
extern int ftrace_modify_code(unsigned long ip, unsigned char *old_code,
			      unsigned char *new_code);

102
103
extern int skip_trace(unsigned long ip);

104
105
106
107
extern void ftrace_release(void *start, unsigned long size);

extern void ftrace_disable_daemon(void);
extern void ftrace_enable_daemon(void);
108

Steven Rostedt's avatar
Steven Rostedt committed
109
#else
110
# define skip_trace(ip)				({ 0; })
Ingo Molnar's avatar
Ingo Molnar committed
111
112
# define ftrace_force_update()			({ 0; })
# define ftrace_set_filter(buf, len, reset)	do { } while (0)
113
114
# define ftrace_disable_daemon()		do { } while (0)
# define ftrace_enable_daemon()			do { } while (0)
115
static inline void ftrace_release(void *start, unsigned long size) { }
116
#endif /* CONFIG_DYNAMIC_FTRACE */
117

Ingo Molnar's avatar
Ingo Molnar committed
118
119
120
/* totally disable ftrace - can not re-enable after this */
void ftrace_kill(void);

Ingo Molnar's avatar
Ingo Molnar committed
121
122
static inline void tracer_disable(void)
{
123
#ifdef CONFIG_FUNCTION_TRACER
Ingo Molnar's avatar
Ingo Molnar committed
124
125
126
127
	ftrace_enabled = 0;
#endif
}

128
129
/*
 * Ftrace disable/restore without lock. Some synchronization mechanism
130
 * must be used to prevent ftrace_enabled to be changed between
131
132
 * disable/restore.
 */
133
134
static inline int __ftrace_enabled_save(void)
{
135
#ifdef CONFIG_FUNCTION_TRACER
136
137
138
139
140
141
142
143
144
145
	int saved_ftrace_enabled = ftrace_enabled;
	ftrace_enabled = 0;
	return saved_ftrace_enabled;
#else
	return 0;
#endif
}

static inline void __ftrace_enabled_restore(int enabled)
{
146
#ifdef CONFIG_FUNCTION_TRACER
147
148
149
150
	ftrace_enabled = enabled;
#endif
}

151
152
153
154
155
156
157
158
#ifdef CONFIG_FRAME_POINTER
/* TODO: need to fix this for ARM */
# define CALLER_ADDR0 ((unsigned long)__builtin_return_address(0))
# define CALLER_ADDR1 ((unsigned long)__builtin_return_address(1))
# define CALLER_ADDR2 ((unsigned long)__builtin_return_address(2))
# define CALLER_ADDR3 ((unsigned long)__builtin_return_address(3))
# define CALLER_ADDR4 ((unsigned long)__builtin_return_address(4))
# define CALLER_ADDR5 ((unsigned long)__builtin_return_address(5))
Ingo Molnar's avatar
Ingo Molnar committed
159
# define CALLER_ADDR6 ((unsigned long)__builtin_return_address(6))
160
161
162
163
164
165
166
#else
# define CALLER_ADDR0 ((unsigned long)__builtin_return_address(0))
# define CALLER_ADDR1 0UL
# define CALLER_ADDR2 0UL
# define CALLER_ADDR3 0UL
# define CALLER_ADDR4 0UL
# define CALLER_ADDR5 0UL
Ingo Molnar's avatar
Ingo Molnar committed
167
# define CALLER_ADDR6 0UL
168
169
#endif

170
#ifdef CONFIG_IRQSOFF_TRACER
Ingo Molnar's avatar
Ingo Molnar committed
171
172
  extern void time_hardirqs_on(unsigned long a0, unsigned long a1);
  extern void time_hardirqs_off(unsigned long a0, unsigned long a1);
173
174
175
176
177
#else
# define time_hardirqs_on(a0, a1)		do { } while (0)
# define time_hardirqs_off(a0, a1)		do { } while (0)
#endif

178
#ifdef CONFIG_PREEMPT_TRACER
Ingo Molnar's avatar
Ingo Molnar committed
179
180
  extern void trace_preempt_on(unsigned long a0, unsigned long a1);
  extern void trace_preempt_off(unsigned long a0, unsigned long a1);
181
182
183
184
185
#else
# define trace_preempt_on(a0, a1)		do { } while (0)
# define trace_preempt_off(a0, a1)		do { } while (0)
#endif

Ingo Molnar's avatar
Ingo Molnar committed
186
#ifdef CONFIG_TRACING
187
188
extern int ftrace_dump_on_oops;

Ingo Molnar's avatar
Ingo Molnar committed
189
190
extern void
ftrace_special(unsigned long arg1, unsigned long arg2, unsigned long arg3);
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208

/**
 * ftrace_printk - printf formatting in the ftrace buffer
 * @fmt: the printf format for printing
 *
 * Note: __ftrace_printk is an internal function for ftrace_printk and
 *       the @ip is passed in via the ftrace_printk macro.
 *
 * This function allows a kernel developer to debug fast path sections
 * that printk is not appropriate for. By scattering in various
 * printk like tracing in the code, a developer can quickly see
 * where problems are occurring.
 *
 * This is intended as a debugging tool for the developer only.
 * Please refrain from leaving ftrace_printks scattered around in
 * your code.
 */
# define ftrace_printk(fmt...) __ftrace_printk(_THIS_IP_, fmt)
209
210
211
extern int
__ftrace_printk(unsigned long ip, const char *fmt, ...)
	__attribute__ ((format (printf, 2, 3)));
212
extern void ftrace_dump(void);
Ingo Molnar's avatar
Ingo Molnar committed
213
214
215
#else
static inline void
ftrace_special(unsigned long arg1, unsigned long arg2, unsigned long arg3) { }
216
static inline int
Ingo Molnar's avatar
Ingo Molnar committed
217
218
219
220
ftrace_printk(const char *fmt, ...) __attribute__ ((format (printf, 1, 0)));

static inline int
ftrace_printk(const char *fmt, ...)
221
222
223
{
	return 0;
}
224
static inline void ftrace_dump(void) { }
Ingo Molnar's avatar
Ingo Molnar committed
225
226
#endif

227
228
#ifdef CONFIG_FTRACE_MCOUNT_RECORD
extern void ftrace_init(void);
229
extern void ftrace_init_module(unsigned long *start, unsigned long *end);
230
231
#else
static inline void ftrace_init(void) { }
232
233
static inline void
ftrace_init_module(unsigned long *start, unsigned long *end) { }
234
235
#endif

236

237
238
239
240
241
/*
 * Structure which defines the trace of an initcall.
 * You don't have to fill the func field since it is
 * only used internally by the tracer.
 */
242
243
struct boot_trace {
	pid_t			caller;
244
	char			func[KSYM_NAME_LEN];
245
	int			result;
246
	unsigned long long	duration;		/* usecs */
247
248
	ktime_t			calltime;
	ktime_t			rettime;
249
250
251
};

#ifdef CONFIG_BOOT_TRACER
252
/* Append the trace on the ring-buffer */
253
extern void trace_boot(struct boot_trace *it, initcall_t fn);
254
255
256
257

/* Tells the tracer that smp_pre_initcall is finished.
 * So we can start the tracing
 */
258
extern void start_boot_trace(void);
259
260
261
262
263
264
265
266
267
268

/* Resume the tracing of other necessary events
 * such as sched switches
 */
extern void enable_boot_trace(void);

/* Suspend this tracing. Actually, only sched_switches tracing have
 * to be suspended. Initcalls doesn't need it.)
 */
extern void disable_boot_trace(void);
269
#else
270
static inline void trace_boot(struct boot_trace *it, initcall_t fn) { }
271
static inline void start_boot_trace(void) { }
272
273
static inline void enable_boot_trace(void) { }
static inline void disable_boot_trace(void) { }
274
275
276
277
#endif



278
#endif /* _LINUX_FTRACE_H */