2 * Kprobes-based tracing events
4 * Created by Masami Hiramatsu <mhiramat@redhat.com>
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License version 2 as
8 * published by the Free Software Foundation.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program; if not, write to the Free Software
17 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
20 #include <linux/module.h>
21 #include <linux/uaccess.h>
22 #include <linux/kprobes.h>
23 #include <linux/seq_file.h>
24 #include <linux/slab.h>
25 #include <linux/smp.h>
26 #include <linux/debugfs.h>
27 #include <linux/types.h>
28 #include <linux/string.h>
29 #include <linux/ctype.h>
30 #include <linux/ptrace.h>
31 #include <linux/perf_event.h>
32 #include <linux/stringify.h>
33 #include <linux/limits.h>
34 #include <asm/bitsperlong.h>
37 #include "trace_output.h"
39 #define MAX_TRACE_ARGS 128
40 #define MAX_ARGSTR_LEN 63
41 #define MAX_EVENT_NAME_LEN 64
42 #define MAX_STRING_SIZE PATH_MAX
43 #define KPROBE_EVENT_SYSTEM "kprobes"
45 /* Reserved field names */
46 #define FIELD_STRING_IP "__probe_ip"
47 #define FIELD_STRING_RETIP "__probe_ret_ip"
48 #define FIELD_STRING_FUNC "__probe_func"
50 const char *reserved_field_names[] = {
53 "common_preempt_count",
61 /* Printing function type */
62 typedef int (*print_type_func_t)(struct trace_seq *, const char *, void *,
64 #define PRINT_TYPE_FUNC_NAME(type) print_type_##type
65 #define PRINT_TYPE_FMT_NAME(type) print_type_format_##type
67 /* Printing in basic type function template */
68 #define DEFINE_BASIC_PRINT_TYPE_FUNC(type, fmt, cast) \
69 static __kprobes int PRINT_TYPE_FUNC_NAME(type)(struct trace_seq *s, \
71 void *data, void *ent)\
73 return trace_seq_printf(s, " %s=" fmt, name, (cast)*(type *)data);\
75 static const char PRINT_TYPE_FMT_NAME(type)[] = fmt;
77 DEFINE_BASIC_PRINT_TYPE_FUNC(u8, "%x", unsigned int)
78 DEFINE_BASIC_PRINT_TYPE_FUNC(u16, "%x", unsigned int)
79 DEFINE_BASIC_PRINT_TYPE_FUNC(u32, "%lx", unsigned long)
80 DEFINE_BASIC_PRINT_TYPE_FUNC(u64, "%llx", unsigned long long)
81 DEFINE_BASIC_PRINT_TYPE_FUNC(s8, "%d", int)
82 DEFINE_BASIC_PRINT_TYPE_FUNC(s16, "%d", int)
83 DEFINE_BASIC_PRINT_TYPE_FUNC(s32, "%ld", long)
84 DEFINE_BASIC_PRINT_TYPE_FUNC(s64, "%lld", long long)
86 /* data_rloc: data relative location, compatible with u32 */
87 #define make_data_rloc(len, roffs) \
88 (((u32)(len) << 16) | ((u32)(roffs) & 0xffff))
89 #define get_rloc_len(dl) ((u32)(dl) >> 16)
90 #define get_rloc_offs(dl) ((u32)(dl) & 0xffff)
92 static inline void *get_rloc_data(u32 *dl)
94 return (u8 *)dl + get_rloc_offs(*dl);
97 /* For data_loc conversion */
98 static inline void *get_loc_data(u32 *dl, void *ent)
100 return (u8 *)ent + get_rloc_offs(*dl);
104 * Convert data_rloc to data_loc:
105 * data_rloc stores the offset from data_rloc itself, but data_loc
106 * stores the offset from event entry.
108 #define convert_rloc_to_loc(dl, offs) ((u32)(dl) + (offs))
110 /* For defining macros, define string/string_size types */
112 typedef u32 string_size;
114 /* Print type function for string type */
115 static __kprobes int PRINT_TYPE_FUNC_NAME(string)(struct trace_seq *s,
117 void *data, void *ent)
119 int len = *(u32 *)data >> 16;
122 return trace_seq_printf(s, " %s=(fault)", name);
124 return trace_seq_printf(s, " %s=\"%s\"", name,
125 (const char *)get_loc_data(data, ent));
127 static const char PRINT_TYPE_FMT_NAME(string)[] = "\\\"%s\\\"";
129 /* Data fetch function type */
130 typedef void (*fetch_func_t)(struct pt_regs *, void *, void *);
137 static __kprobes void call_fetch(struct fetch_param *fprm,
138 struct pt_regs *regs, void *dest)
140 return fprm->fn(regs, fprm->data, dest);
143 #define FETCH_FUNC_NAME(method, type) fetch_##method##_##type
145 * Define macro for basic types - we don't need to define s* types, because
146 * we have to care only about bitwidth at recording time.
148 #define DEFINE_BASIC_FETCH_FUNCS(method) \
149 DEFINE_FETCH_##method(u8) \
150 DEFINE_FETCH_##method(u16) \
151 DEFINE_FETCH_##method(u32) \
152 DEFINE_FETCH_##method(u64)
154 #define CHECK_FETCH_FUNCS(method, fn) \
155 (((FETCH_FUNC_NAME(method, u8) == fn) || \
156 (FETCH_FUNC_NAME(method, u16) == fn) || \
157 (FETCH_FUNC_NAME(method, u32) == fn) || \
158 (FETCH_FUNC_NAME(method, u64) == fn) || \
159 (FETCH_FUNC_NAME(method, string) == fn) || \
160 (FETCH_FUNC_NAME(method, string_size) == fn)) \
163 /* Data fetch function templates */
164 #define DEFINE_FETCH_reg(type) \
165 static __kprobes void FETCH_FUNC_NAME(reg, type)(struct pt_regs *regs, \
166 void *offset, void *dest) \
168 *(type *)dest = (type)regs_get_register(regs, \
169 (unsigned int)((unsigned long)offset)); \
171 DEFINE_BASIC_FETCH_FUNCS(reg)
172 /* No string on the register */
173 #define fetch_reg_string NULL
174 #define fetch_reg_string_size NULL
176 #define DEFINE_FETCH_stack(type) \
177 static __kprobes void FETCH_FUNC_NAME(stack, type)(struct pt_regs *regs,\
178 void *offset, void *dest) \
180 *(type *)dest = (type)regs_get_kernel_stack_nth(regs, \
181 (unsigned int)((unsigned long)offset)); \
183 DEFINE_BASIC_FETCH_FUNCS(stack)
184 /* No string on the stack entry */
185 #define fetch_stack_string NULL
186 #define fetch_stack_string_size NULL
188 #define DEFINE_FETCH_retval(type) \
189 static __kprobes void FETCH_FUNC_NAME(retval, type)(struct pt_regs *regs,\
190 void *dummy, void *dest) \
192 *(type *)dest = (type)regs_return_value(regs); \
194 DEFINE_BASIC_FETCH_FUNCS(retval)
195 /* No string on the retval */
196 #define fetch_retval_string NULL
197 #define fetch_retval_string_size NULL
199 #define DEFINE_FETCH_memory(type) \
200 static __kprobes void FETCH_FUNC_NAME(memory, type)(struct pt_regs *regs,\
201 void *addr, void *dest) \
204 if (probe_kernel_address(addr, retval)) \
207 *(type *)dest = retval; \
209 DEFINE_BASIC_FETCH_FUNCS(memory)
211 * Fetch a null-terminated string. Caller MUST set *(u32 *)dest with max
212 * length and relative data location.
214 static __kprobes void FETCH_FUNC_NAME(memory, string)(struct pt_regs *regs,
215 void *addr, void *dest)
218 int maxlen = get_rloc_len(*(u32 *)dest);
219 u8 *dst = get_rloc_data(dest);
221 mm_segment_t old_fs = get_fs();
225 * Try to get string again, since the string can be changed while
231 ret = __copy_from_user_inatomic(dst++, src++, 1);
232 while (dst[-1] && ret == 0 && src - (u8 *)addr < maxlen);
237 if (ret < 0) { /* Failed to fetch string */
238 ((u8 *)get_rloc_data(dest))[0] = '\0';
239 *(u32 *)dest = make_data_rloc(0, get_rloc_offs(*(u32 *)dest));
241 *(u32 *)dest = make_data_rloc(src - (u8 *)addr,
242 get_rloc_offs(*(u32 *)dest));
244 /* Return the length of string -- including null terminal byte */
245 static __kprobes void FETCH_FUNC_NAME(memory, string_size)(struct pt_regs *regs,
246 void *addr, void *dest)
250 mm_segment_t old_fs = get_fs();
255 ret = __copy_from_user_inatomic(&c, (u8 *)addr + len, 1);
257 } while (c && ret == 0 && len < MAX_STRING_SIZE);
261 if (ret < 0) /* Failed to check the length */
267 /* Memory fetching by symbol */
268 struct symbol_cache {
274 static unsigned long update_symbol_cache(struct symbol_cache *sc)
276 sc->addr = (unsigned long)kallsyms_lookup_name(sc->symbol);
278 sc->addr += sc->offset;
282 static void free_symbol_cache(struct symbol_cache *sc)
288 static struct symbol_cache *alloc_symbol_cache(const char *sym, long offset)
290 struct symbol_cache *sc;
292 if (!sym || strlen(sym) == 0)
294 sc = kzalloc(sizeof(struct symbol_cache), GFP_KERNEL);
298 sc->symbol = kstrdup(sym, GFP_KERNEL);
305 update_symbol_cache(sc);
309 #define DEFINE_FETCH_symbol(type) \
310 static __kprobes void FETCH_FUNC_NAME(symbol, type)(struct pt_regs *regs,\
311 void *data, void *dest) \
313 struct symbol_cache *sc = data; \
315 fetch_memory_##type(regs, (void *)sc->addr, dest); \
319 DEFINE_BASIC_FETCH_FUNCS(symbol)
320 DEFINE_FETCH_symbol(string)
321 DEFINE_FETCH_symbol(string_size)
323 /* Dereference memory access function */
324 struct deref_fetch_param {
325 struct fetch_param orig;
329 #define DEFINE_FETCH_deref(type) \
330 static __kprobes void FETCH_FUNC_NAME(deref, type)(struct pt_regs *regs,\
331 void *data, void *dest) \
333 struct deref_fetch_param *dprm = data; \
334 unsigned long addr; \
335 call_fetch(&dprm->orig, regs, &addr); \
337 addr += dprm->offset; \
338 fetch_memory_##type(regs, (void *)addr, dest); \
342 DEFINE_BASIC_FETCH_FUNCS(deref)
343 DEFINE_FETCH_deref(string)
344 DEFINE_FETCH_deref(string_size)
346 static __kprobes void update_deref_fetch_param(struct deref_fetch_param *data)
348 if (CHECK_FETCH_FUNCS(deref, data->orig.fn))
349 update_deref_fetch_param(data->orig.data);
350 else if (CHECK_FETCH_FUNCS(symbol, data->orig.fn))
351 update_symbol_cache(data->orig.data);
354 static __kprobes void free_deref_fetch_param(struct deref_fetch_param *data)
356 if (CHECK_FETCH_FUNCS(deref, data->orig.fn))
357 free_deref_fetch_param(data->orig.data);
358 else if (CHECK_FETCH_FUNCS(symbol, data->orig.fn))
359 free_symbol_cache(data->orig.data);
363 /* Bitfield fetch function */
364 struct bitfield_fetch_param {
365 struct fetch_param orig;
366 unsigned char hi_shift;
367 unsigned char low_shift;
370 #define DEFINE_FETCH_bitfield(type) \
371 static __kprobes void FETCH_FUNC_NAME(bitfield, type)(struct pt_regs *regs,\
372 void *data, void *dest) \
374 struct bitfield_fetch_param *bprm = data; \
376 call_fetch(&bprm->orig, regs, &buf); \
378 buf <<= bprm->hi_shift; \
379 buf >>= bprm->low_shift; \
381 *(type *)dest = buf; \
383 DEFINE_BASIC_FETCH_FUNCS(bitfield)
384 #define fetch_bitfield_string NULL
385 #define fetch_bitfield_string_size NULL
387 static __kprobes void
388 update_bitfield_fetch_param(struct bitfield_fetch_param *data)
391 * Don't check the bitfield itself, because this must be the
392 * last fetch function.
394 if (CHECK_FETCH_FUNCS(deref, data->orig.fn))
395 update_deref_fetch_param(data->orig.data);
396 else if (CHECK_FETCH_FUNCS(symbol, data->orig.fn))
397 update_symbol_cache(data->orig.data);
400 static __kprobes void
401 free_bitfield_fetch_param(struct bitfield_fetch_param *data)
404 * Don't check the bitfield itself, because this must be the
405 * last fetch function.
407 if (CHECK_FETCH_FUNCS(deref, data->orig.fn))
408 free_deref_fetch_param(data->orig.data);
409 else if (CHECK_FETCH_FUNCS(symbol, data->orig.fn))
410 free_symbol_cache(data->orig.data);
414 /* Default (unsigned long) fetch type */
415 #define __DEFAULT_FETCH_TYPE(t) u##t
416 #define _DEFAULT_FETCH_TYPE(t) __DEFAULT_FETCH_TYPE(t)
417 #define DEFAULT_FETCH_TYPE _DEFAULT_FETCH_TYPE(BITS_PER_LONG)
418 #define DEFAULT_FETCH_TYPE_STR __stringify(DEFAULT_FETCH_TYPE)
432 #define ASSIGN_FETCH_FUNC(method, type) \
433 [FETCH_MTD_##method] = FETCH_FUNC_NAME(method, type)
435 #define __ASSIGN_FETCH_TYPE(_name, ptype, ftype, _size, sign, _fmttype) \
439 .print = PRINT_TYPE_FUNC_NAME(ptype), \
440 .fmt = PRINT_TYPE_FMT_NAME(ptype), \
441 .fmttype = _fmttype, \
443 ASSIGN_FETCH_FUNC(reg, ftype), \
444 ASSIGN_FETCH_FUNC(stack, ftype), \
445 ASSIGN_FETCH_FUNC(retval, ftype), \
446 ASSIGN_FETCH_FUNC(memory, ftype), \
447 ASSIGN_FETCH_FUNC(symbol, ftype), \
448 ASSIGN_FETCH_FUNC(deref, ftype), \
449 ASSIGN_FETCH_FUNC(bitfield, ftype), \
453 #define ASSIGN_FETCH_TYPE(ptype, ftype, sign) \
454 __ASSIGN_FETCH_TYPE(#ptype, ptype, ftype, sizeof(ftype), sign, #ptype)
456 #define FETCH_TYPE_STRING 0
457 #define FETCH_TYPE_STRSIZE 1
459 /* Fetch type information table */
460 static const struct fetch_type {
461 const char *name; /* Name of type */
462 size_t size; /* Byte size of type */
463 int is_signed; /* Signed flag */
464 print_type_func_t print; /* Print functions */
465 const char *fmt; /* Fromat string */
466 const char *fmttype; /* Name in format file */
467 /* Fetch functions */
468 fetch_func_t fetch[FETCH_MTD_END];
469 } fetch_type_table[] = {
471 [FETCH_TYPE_STRING] = __ASSIGN_FETCH_TYPE("string", string, string,
472 sizeof(u32), 1, "__data_loc char[]"),
473 [FETCH_TYPE_STRSIZE] = __ASSIGN_FETCH_TYPE("string_size", u32,
474 string_size, sizeof(u32), 0, "u32"),
476 ASSIGN_FETCH_TYPE(u8, u8, 0),
477 ASSIGN_FETCH_TYPE(u16, u16, 0),
478 ASSIGN_FETCH_TYPE(u32, u32, 0),
479 ASSIGN_FETCH_TYPE(u64, u64, 0),
480 ASSIGN_FETCH_TYPE(s8, u8, 1),
481 ASSIGN_FETCH_TYPE(s16, u16, 1),
482 ASSIGN_FETCH_TYPE(s32, u32, 1),
483 ASSIGN_FETCH_TYPE(s64, u64, 1),
486 static const struct fetch_type *find_fetch_type(const char *type)
491 type = DEFAULT_FETCH_TYPE_STR;
493 /* Special case: bitfield */
496 type = strchr(type, '/');
500 if (strict_strtoul(type, 0, &bs))
504 return find_fetch_type("u8");
506 return find_fetch_type("u16");
508 return find_fetch_type("u32");
510 return find_fetch_type("u64");
516 for (i = 0; i < ARRAY_SIZE(fetch_type_table); i++)
517 if (strcmp(type, fetch_type_table[i].name) == 0)
518 return &fetch_type_table[i];
523 /* Special function : only accept unsigned long */
524 static __kprobes void fetch_stack_address(struct pt_regs *regs,
525 void *dummy, void *dest)
527 *(unsigned long *)dest = kernel_stack_pointer(regs);
530 static fetch_func_t get_fetch_size_function(const struct fetch_type *type,
531 fetch_func_t orig_fn)
535 if (type != &fetch_type_table[FETCH_TYPE_STRING])
536 return NULL; /* Only string type needs size function */
537 for (i = 0; i < FETCH_MTD_END; i++)
538 if (type->fetch[i] == orig_fn)
539 return fetch_type_table[FETCH_TYPE_STRSIZE].fetch[i];
541 WARN_ON(1); /* This should not happen */
546 * Kprobe event core functions
550 struct fetch_param fetch;
551 struct fetch_param fetch_size;
552 unsigned int offset; /* Offset from argument entry */
553 const char *name; /* Name of this argument */
554 const char *comm; /* Command of this argument */
555 const struct fetch_type *type; /* Type of this argument */
558 /* Flags for trace_probe */
559 #define TP_FLAG_TRACE 1
560 #define TP_FLAG_PROFILE 2
561 #define TP_FLAG_REGISTERED 4
564 struct list_head list;
565 struct kretprobe rp; /* Use rp.kp for kprobe use */
567 unsigned int flags; /* For TP_FLAG_* */
568 const char *symbol; /* symbol name */
569 struct ftrace_event_class class;
570 struct ftrace_event_call call;
571 ssize_t size; /* trace entry size */
572 unsigned int nr_args;
573 struct probe_arg args[];
576 #define SIZEOF_TRACE_PROBE(n) \
577 (offsetof(struct trace_probe, args) + \
578 (sizeof(struct probe_arg) * (n)))
581 static __kprobes int trace_probe_is_return(struct trace_probe *tp)
583 return tp->rp.handler != NULL;
586 static __kprobes const char *trace_probe_symbol(struct trace_probe *tp)
588 return tp->symbol ? tp->symbol : "unknown";
591 static __kprobes unsigned long trace_probe_offset(struct trace_probe *tp)
593 return tp->rp.kp.offset;
596 static __kprobes bool trace_probe_is_enabled(struct trace_probe *tp)
598 return !!(tp->flags & (TP_FLAG_TRACE | TP_FLAG_PROFILE));
601 static __kprobes bool trace_probe_is_registered(struct trace_probe *tp)
603 return !!(tp->flags & TP_FLAG_REGISTERED);
606 static __kprobes bool trace_probe_has_gone(struct trace_probe *tp)
608 return !!(kprobe_gone(&tp->rp.kp));
611 static __kprobes bool trace_probe_within_module(struct trace_probe *tp,
614 int len = strlen(mod->name);
615 const char *name = trace_probe_symbol(tp);
616 return strncmp(mod->name, name, len) == 0 && name[len] == ':';
619 static __kprobes bool trace_probe_is_on_module(struct trace_probe *tp)
621 return !!strchr(trace_probe_symbol(tp), ':');
624 static int register_probe_event(struct trace_probe *tp);
625 static void unregister_probe_event(struct trace_probe *tp);
627 static DEFINE_MUTEX(probe_lock);
628 static LIST_HEAD(probe_list);
630 static int kprobe_dispatcher(struct kprobe *kp, struct pt_regs *regs);
631 static int kretprobe_dispatcher(struct kretprobe_instance *ri,
632 struct pt_regs *regs);
634 /* Check the name is good for event/group/fields */
635 static int is_good_name(const char *name)
637 if (!isalpha(*name) && *name != '_')
639 while (*++name != '\0') {
640 if (!isalpha(*name) && !isdigit(*name) && *name != '_')
647 * Allocate new trace_probe and initialize it (including kprobes).
649 static struct trace_probe *alloc_trace_probe(const char *group,
654 int nargs, int is_return)
656 struct trace_probe *tp;
659 tp = kzalloc(SIZEOF_TRACE_PROBE(nargs), GFP_KERNEL);
664 tp->symbol = kstrdup(symbol, GFP_KERNEL);
667 tp->rp.kp.symbol_name = tp->symbol;
668 tp->rp.kp.offset = offs;
670 tp->rp.kp.addr = addr;
673 tp->rp.handler = kretprobe_dispatcher;
675 tp->rp.kp.pre_handler = kprobe_dispatcher;
677 if (!event || !is_good_name(event)) {
682 tp->call.class = &tp->class;
683 tp->call.name = kstrdup(event, GFP_KERNEL);
687 if (!group || !is_good_name(group)) {
692 tp->class.system = kstrdup(group, GFP_KERNEL);
693 if (!tp->class.system)
696 INIT_LIST_HEAD(&tp->list);
699 kfree(tp->call.name);
705 static void update_probe_arg(struct probe_arg *arg)
707 if (CHECK_FETCH_FUNCS(bitfield, arg->fetch.fn))
708 update_bitfield_fetch_param(arg->fetch.data);
709 else if (CHECK_FETCH_FUNCS(deref, arg->fetch.fn))
710 update_deref_fetch_param(arg->fetch.data);
711 else if (CHECK_FETCH_FUNCS(symbol, arg->fetch.fn))
712 update_symbol_cache(arg->fetch.data);
715 static void free_probe_arg(struct probe_arg *arg)
717 if (CHECK_FETCH_FUNCS(bitfield, arg->fetch.fn))
718 free_bitfield_fetch_param(arg->fetch.data);
719 else if (CHECK_FETCH_FUNCS(deref, arg->fetch.fn))
720 free_deref_fetch_param(arg->fetch.data);
721 else if (CHECK_FETCH_FUNCS(symbol, arg->fetch.fn))
722 free_symbol_cache(arg->fetch.data);
727 static void free_trace_probe(struct trace_probe *tp)
731 for (i = 0; i < tp->nr_args; i++)
732 free_probe_arg(&tp->args[i]);
734 kfree(tp->call.class->system);
735 kfree(tp->call.name);
740 static struct trace_probe *find_trace_probe(const char *event,
743 struct trace_probe *tp;
745 list_for_each_entry(tp, &probe_list, list)
746 if (strcmp(tp->call.name, event) == 0 &&
747 strcmp(tp->call.class->system, group) == 0)
752 /* Enable trace_probe - @flag must be TP_FLAG_TRACE or TP_FLAG_PROFILE */
753 static int enable_trace_probe(struct trace_probe *tp, int flag)
758 if (trace_probe_is_enabled(tp) && trace_probe_is_registered(tp) &&
759 !trace_probe_has_gone(tp)) {
760 if (trace_probe_is_return(tp))
761 ret = enable_kretprobe(&tp->rp);
763 ret = enable_kprobe(&tp->rp.kp);
769 /* Disable trace_probe - @flag must be TP_FLAG_TRACE or TP_FLAG_PROFILE */
770 static void disable_trace_probe(struct trace_probe *tp, int flag)
773 if (!trace_probe_is_enabled(tp) && trace_probe_is_registered(tp)) {
774 if (trace_probe_is_return(tp))
775 disable_kretprobe(&tp->rp);
777 disable_kprobe(&tp->rp.kp);
781 /* Internal register function - just handle k*probes and flags */
782 static int __register_trace_probe(struct trace_probe *tp)
786 if (trace_probe_is_registered(tp))
789 for (i = 0; i < tp->nr_args; i++)
790 update_probe_arg(&tp->args[i]);
792 /* Set/clear disabled flag according to tp->flag */
793 if (trace_probe_is_enabled(tp))
794 tp->rp.kp.flags &= ~KPROBE_FLAG_DISABLED;
796 tp->rp.kp.flags |= KPROBE_FLAG_DISABLED;
798 if (trace_probe_is_return(tp))
799 ret = register_kretprobe(&tp->rp);
801 ret = register_kprobe(&tp->rp.kp);
804 tp->flags |= TP_FLAG_REGISTERED;
806 pr_warning("Could not insert probe at %s+%lu: %d\n",
807 trace_probe_symbol(tp), trace_probe_offset(tp), ret);
808 if (ret == -ENOENT && trace_probe_is_on_module(tp)) {
809 pr_warning("This probe might be able to register after"
810 "target module is loaded. Continue.\n");
812 } else if (ret == -EILSEQ) {
813 pr_warning("Probing address(0x%p) is not an "
814 "instruction boundary.\n",
823 /* Internal unregister function - just handle k*probes and flags */
824 static void __unregister_trace_probe(struct trace_probe *tp)
826 if (trace_probe_is_registered(tp)) {
827 if (trace_probe_is_return(tp))
828 unregister_kretprobe(&tp->rp);
830 unregister_kprobe(&tp->rp.kp);
831 tp->flags &= ~TP_FLAG_REGISTERED;
832 /* Cleanup kprobe for reuse */
833 if (tp->rp.kp.symbol_name)
834 tp->rp.kp.addr = NULL;
838 /* Unregister a trace_probe and probe_event: call with locking probe_lock */
839 static int unregister_trace_probe(struct trace_probe *tp)
841 /* Enabled event can not be unregistered */
842 if (trace_probe_is_enabled(tp))
845 __unregister_trace_probe(tp);
847 unregister_probe_event(tp);
852 /* Register a trace_probe and probe_event */
853 static int register_trace_probe(struct trace_probe *tp)
855 struct trace_probe *old_tp;
858 mutex_lock(&probe_lock);
860 /* Delete old (same name) event if exist */
861 old_tp = find_trace_probe(tp->call.name, tp->call.class->system);
863 ret = unregister_trace_probe(old_tp);
866 free_trace_probe(old_tp);
869 /* Register new event */
870 ret = register_probe_event(tp);
872 pr_warning("Failed to register probe event(%d)\n", ret);
876 /* Register k*probe */
877 ret = __register_trace_probe(tp);
879 unregister_probe_event(tp);
881 list_add_tail(&tp->list, &probe_list);
884 mutex_unlock(&probe_lock);
888 /* Module notifier call back, checking event on the module */
889 static int trace_probe_module_callback(struct notifier_block *nb,
890 unsigned long val, void *data)
892 struct module *mod = data;
893 struct trace_probe *tp;
896 if (val != MODULE_STATE_COMING)
899 /* Update probes on coming module */
900 mutex_lock(&probe_lock);
901 list_for_each_entry(tp, &probe_list, list) {
902 if (trace_probe_within_module(tp, mod)) {
903 /* Don't need to check busy - this should have gone. */
904 __unregister_trace_probe(tp);
905 ret = __register_trace_probe(tp);
907 pr_warning("Failed to re-register probe %s on"
909 tp->call.name, mod->name, ret);
912 mutex_unlock(&probe_lock);
917 static struct notifier_block trace_probe_module_nb = {
918 .notifier_call = trace_probe_module_callback,
919 .priority = 1 /* Invoked after kprobe module callback */
922 /* Split symbol and offset. */
923 static int split_symbol_offset(char *symbol, unsigned long *offset)
931 tmp = strchr(symbol, '+');
933 /* skip sign because strict_strtol doesn't accept '+' */
934 ret = strict_strtoul(tmp + 1, 0, offset);
943 #define PARAM_MAX_ARGS 16
944 #define PARAM_MAX_STACK (THREAD_SIZE / sizeof(unsigned long))
946 static int parse_probe_vars(char *arg, const struct fetch_type *t,
947 struct fetch_param *f, int is_return)
952 if (strcmp(arg, "retval") == 0) {
954 f->fn = t->fetch[FETCH_MTD_retval];
957 } else if (strncmp(arg, "stack", 5) == 0) {
958 if (arg[5] == '\0') {
959 if (strcmp(t->name, DEFAULT_FETCH_TYPE_STR) == 0)
960 f->fn = fetch_stack_address;
963 } else if (isdigit(arg[5])) {
964 ret = strict_strtoul(arg + 5, 10, ¶m);
965 if (ret || param > PARAM_MAX_STACK)
968 f->fn = t->fetch[FETCH_MTD_stack];
969 f->data = (void *)param;
978 /* Recursive argument parser */
979 static int __parse_probe_arg(char *arg, const struct fetch_type *t,
980 struct fetch_param *f, int is_return)
989 ret = parse_probe_vars(arg + 1, t, f, is_return);
991 case '%': /* named register */
992 ret = regs_query_register_offset(arg + 1);
994 f->fn = t->fetch[FETCH_MTD_reg];
995 f->data = (void *)(unsigned long)ret;
999 case '@': /* memory or symbol */
1000 if (isdigit(arg[1])) {
1001 ret = strict_strtoul(arg + 1, 0, ¶m);
1004 f->fn = t->fetch[FETCH_MTD_memory];
1005 f->data = (void *)param;
1007 ret = split_symbol_offset(arg + 1, &offset);
1010 f->data = alloc_symbol_cache(arg + 1, offset);
1012 f->fn = t->fetch[FETCH_MTD_symbol];
1015 case '+': /* deref memory */
1016 arg++; /* Skip '+', because strict_strtol() rejects it. */
1018 tmp = strchr(arg, '(');
1022 ret = strict_strtol(arg, 0, &offset);
1026 tmp = strrchr(arg, ')');
1028 struct deref_fetch_param *dprm;
1029 const struct fetch_type *t2 = find_fetch_type(NULL);
1031 dprm = kzalloc(sizeof(struct deref_fetch_param),
1035 dprm->offset = offset;
1036 ret = __parse_probe_arg(arg, t2, &dprm->orig,
1041 f->fn = t->fetch[FETCH_MTD_deref];
1042 f->data = (void *)dprm;
1047 if (!ret && !f->fn) { /* Parsed, but do not find fetch method */
1048 pr_info("%s type has no corresponding fetch method.\n",
1055 #define BYTES_TO_BITS(nb) ((BITS_PER_LONG * (nb)) / sizeof(long))
1057 /* Bitfield type needs to be parsed into a fetch function */
1058 static int __parse_bitfield_probe_arg(const char *bf,
1059 const struct fetch_type *t,
1060 struct fetch_param *f)
1062 struct bitfield_fetch_param *bprm;
1063 unsigned long bw, bo;
1069 bprm = kzalloc(sizeof(*bprm), GFP_KERNEL);
1073 f->fn = t->fetch[FETCH_MTD_bitfield];
1074 f->data = (void *)bprm;
1076 bw = simple_strtoul(bf + 1, &tail, 0); /* Use simple one */
1077 if (bw == 0 || *tail != '@')
1081 bo = simple_strtoul(bf, &tail, 0);
1082 if (tail == bf || *tail != '/')
1085 bprm->hi_shift = BYTES_TO_BITS(t->size) - (bw + bo);
1086 bprm->low_shift = bprm->hi_shift + bo;
1087 return (BYTES_TO_BITS(t->size) < (bw + bo)) ? -EINVAL : 0;
1090 /* String length checking wrapper */
1091 static int parse_probe_arg(char *arg, struct trace_probe *tp,
1092 struct probe_arg *parg, int is_return)
1097 if (strlen(arg) > MAX_ARGSTR_LEN) {
1098 pr_info("Argument is too long.: %s\n", arg);
1101 parg->comm = kstrdup(arg, GFP_KERNEL);
1103 pr_info("Failed to allocate memory for command '%s'.\n", arg);
1106 t = strchr(parg->comm, ':');
1108 arg[t - parg->comm] = '\0';
1111 parg->type = find_fetch_type(t);
1113 pr_info("Unsupported type: %s\n", t);
1116 parg->offset = tp->size;
1117 tp->size += parg->type->size;
1118 ret = __parse_probe_arg(arg, parg->type, &parg->fetch, is_return);
1119 if (ret >= 0 && t != NULL)
1120 ret = __parse_bitfield_probe_arg(t, parg->type, &parg->fetch);
1122 parg->fetch_size.fn = get_fetch_size_function(parg->type,
1124 parg->fetch_size.data = parg->fetch.data;
1129 /* Return 1 if name is reserved or already used by another argument */
1130 static int conflict_field_name(const char *name,
1131 struct probe_arg *args, int narg)
1134 for (i = 0; i < ARRAY_SIZE(reserved_field_names); i++)
1135 if (strcmp(reserved_field_names[i], name) == 0)
1137 for (i = 0; i < narg; i++)
1138 if (strcmp(args[i].name, name) == 0)
1143 static int create_trace_probe(int argc, char **argv)
1147 * - Add kprobe: p[:[GRP/]EVENT] [MOD:]KSYM[+OFFS]|KADDR [FETCHARGS]
1148 * - Add kretprobe: r[:[GRP/]EVENT] [MOD:]KSYM[+0] [FETCHARGS]
1150 * $retval : fetch return value
1151 * $stack : fetch stack address
1152 * $stackN : fetch Nth of stack (N:0-)
1153 * @ADDR : fetch memory at ADDR (ADDR should be in kernel)
1154 * @SYM[+|-offs] : fetch memory at SYM +|- offs (SYM is a data symbol)
1155 * %REG : fetch register REG
1156 * Dereferencing memory fetch:
1157 * +|-offs(ARG) : fetch memory at ARG +|- offs address.
1158 * Alias name of args:
1159 * NAME=FETCHARG : set NAME as alias of FETCHARG.
1161 * FETCHARG:TYPE : use TYPE instead of unsigned long.
1163 struct trace_probe *tp;
1165 int is_return = 0, is_delete = 0;
1166 char *symbol = NULL, *event = NULL, *group = NULL;
1168 unsigned long offset = 0;
1170 char buf[MAX_EVENT_NAME_LEN];
1172 /* argc must be >= 1 */
1173 if (argv[0][0] == 'p')
1175 else if (argv[0][0] == 'r')
1177 else if (argv[0][0] == '-')
1180 pr_info("Probe definition must be started with 'p', 'r' or"
1185 if (argv[0][1] == ':') {
1186 event = &argv[0][2];
1187 if (strchr(event, '/')) {
1189 event = strchr(group, '/') + 1;
1191 if (strlen(group) == 0) {
1192 pr_info("Group name is not specified\n");
1196 if (strlen(event) == 0) {
1197 pr_info("Event name is not specified\n");
1202 group = KPROBE_EVENT_SYSTEM;
1206 pr_info("Delete command needs an event name.\n");
1209 mutex_lock(&probe_lock);
1210 tp = find_trace_probe(event, group);
1212 mutex_unlock(&probe_lock);
1213 pr_info("Event %s/%s doesn't exist.\n", group, event);
1216 /* delete an event */
1217 ret = unregister_trace_probe(tp);
1219 free_trace_probe(tp);
1220 mutex_unlock(&probe_lock);
1225 pr_info("Probe point is not specified.\n");
1229 /* try to parse an address. if that fails, try to read the
1230 * input as a symbol. */
1231 if (!strict_strtoul(argv[1], 0, (unsigned long *)&addr)) {
1233 pr_info("Return probe point must be a symbol.\n");
1237 /* a symbol specified */
1239 /* TODO: support .init module functions */
1240 ret = split_symbol_offset(symbol, &offset);
1242 pr_info("Failed to parse either an address or a symbol.\n");
1245 if (offset && is_return) {
1246 pr_info("Return probe must be used without offset.\n");
1250 argc -= 2; argv += 2;
1254 /* Make a new event name */
1256 snprintf(buf, MAX_EVENT_NAME_LEN, "%c_%s_%ld",
1257 is_return ? 'r' : 'p', symbol, offset);
1259 snprintf(buf, MAX_EVENT_NAME_LEN, "%c_0x%p",
1260 is_return ? 'r' : 'p', addr);
1263 tp = alloc_trace_probe(group, event, addr, symbol, offset, argc,
1266 pr_info("Failed to allocate trace_probe.(%d)\n",
1271 /* parse arguments */
1273 for (i = 0; i < argc && i < MAX_TRACE_ARGS; i++) {
1274 /* Increment count for freeing args in error case */
1277 /* Parse argument name */
1278 arg = strchr(argv[i], '=');
1281 tp->args[i].name = kstrdup(argv[i], GFP_KERNEL);
1284 /* If argument name is omitted, set "argN" */
1285 snprintf(buf, MAX_EVENT_NAME_LEN, "arg%d", i + 1);
1286 tp->args[i].name = kstrdup(buf, GFP_KERNEL);
1289 if (!tp->args[i].name) {
1290 pr_info("Failed to allocate argument[%d] name.\n", i);
1295 if (!is_good_name(tp->args[i].name)) {
1296 pr_info("Invalid argument[%d] name: %s\n",
1297 i, tp->args[i].name);
1302 if (conflict_field_name(tp->args[i].name, tp->args, i)) {
1303 pr_info("Argument[%d] name '%s' conflicts with "
1304 "another field.\n", i, argv[i]);
1309 /* Parse fetch argument */
1310 ret = parse_probe_arg(arg, tp, &tp->args[i], is_return);
1312 pr_info("Parse error at argument[%d]. (%d)\n", i, ret);
1317 ret = register_trace_probe(tp);
1323 free_trace_probe(tp);
1327 static int release_all_trace_probes(void)
1329 struct trace_probe *tp;
1332 mutex_lock(&probe_lock);
1333 /* Ensure no probe is in use. */
1334 list_for_each_entry(tp, &probe_list, list)
1335 if (trace_probe_is_enabled(tp)) {
1339 /* TODO: Use batch unregistration */
1340 while (!list_empty(&probe_list)) {
1341 tp = list_entry(probe_list.next, struct trace_probe, list);
1342 unregister_trace_probe(tp);
1343 free_trace_probe(tp);
1347 mutex_unlock(&probe_lock);
1352 /* Probes listing interfaces */
1353 static void *probes_seq_start(struct seq_file *m, loff_t *pos)
1355 mutex_lock(&probe_lock);
1356 return seq_list_start(&probe_list, *pos);
1359 static void *probes_seq_next(struct seq_file *m, void *v, loff_t *pos)
1361 return seq_list_next(v, &probe_list, pos);
1364 static void probes_seq_stop(struct seq_file *m, void *v)
1366 mutex_unlock(&probe_lock);
1369 static int probes_seq_show(struct seq_file *m, void *v)
1371 struct trace_probe *tp = v;
1374 seq_printf(m, "%c", trace_probe_is_return(tp) ? 'r' : 'p');
1375 seq_printf(m, ":%s/%s", tp->call.class->system, tp->call.name);
1378 seq_printf(m, " 0x%p", tp->rp.kp.addr);
1379 else if (tp->rp.kp.offset)
1380 seq_printf(m, " %s+%u", trace_probe_symbol(tp),
1383 seq_printf(m, " %s", trace_probe_symbol(tp));
1385 for (i = 0; i < tp->nr_args; i++)
1386 seq_printf(m, " %s=%s", tp->args[i].name, tp->args[i].comm);
1387 seq_printf(m, "\n");
1392 static const struct seq_operations probes_seq_op = {
1393 .start = probes_seq_start,
1394 .next = probes_seq_next,
1395 .stop = probes_seq_stop,
1396 .show = probes_seq_show
1399 static int probes_open(struct inode *inode, struct file *file)
1403 if ((file->f_mode & FMODE_WRITE) && (file->f_flags & O_TRUNC)) {
1404 ret = release_all_trace_probes();
1409 return seq_open(file, &probes_seq_op);
1412 static int command_trace_probe(const char *buf)
1415 int argc = 0, ret = 0;
1417 argv = argv_split(GFP_KERNEL, buf, &argc);
1422 ret = create_trace_probe(argc, argv);
1428 #define WRITE_BUFSIZE 4096
1430 static ssize_t probes_write(struct file *file, const char __user *buffer,
1431 size_t count, loff_t *ppos)
1438 kbuf = kmalloc(WRITE_BUFSIZE, GFP_KERNEL);
1443 while (done < count) {
1444 size = count - done;
1445 if (size >= WRITE_BUFSIZE)
1446 size = WRITE_BUFSIZE - 1;
1447 if (copy_from_user(kbuf, buffer + done, size)) {
1452 tmp = strchr(kbuf, '\n');
1455 size = tmp - kbuf + 1;
1456 } else if (done + size < count) {
1457 pr_warning("Line length is too long: "
1458 "Should be less than %d.", WRITE_BUFSIZE);
1463 /* Remove comments */
1464 tmp = strchr(kbuf, '#');
1468 ret = command_trace_probe(kbuf);
1478 static const struct file_operations kprobe_events_ops = {
1479 .owner = THIS_MODULE,
1480 .open = probes_open,
1482 .llseek = seq_lseek,
1483 .release = seq_release,
1484 .write = probes_write,
1487 /* Probes profiling interfaces */
1488 static int probes_profile_seq_show(struct seq_file *m, void *v)
1490 struct trace_probe *tp = v;
1492 seq_printf(m, " %-44s %15lu %15lu\n", tp->call.name, tp->nhit,
1498 static const struct seq_operations profile_seq_op = {
1499 .start = probes_seq_start,
1500 .next = probes_seq_next,
1501 .stop = probes_seq_stop,
1502 .show = probes_profile_seq_show
1505 static int profile_open(struct inode *inode, struct file *file)
1507 return seq_open(file, &profile_seq_op);
1510 static const struct file_operations kprobe_profile_ops = {
1511 .owner = THIS_MODULE,
1512 .open = profile_open,
1514 .llseek = seq_lseek,
1515 .release = seq_release,
1518 /* Sum up total data length for dynamic arraies (strings) */
1519 static __kprobes int __get_data_size(struct trace_probe *tp,
1520 struct pt_regs *regs)
1525 for (i = 0; i < tp->nr_args; i++)
1526 if (unlikely(tp->args[i].fetch_size.fn)) {
1527 call_fetch(&tp->args[i].fetch_size, regs, &len);
1534 /* Store the value of each argument */
1535 static __kprobes void store_trace_args(int ent_size, struct trace_probe *tp,
1536 struct pt_regs *regs,
1537 u8 *data, int maxlen)
1541 u32 *dl; /* Data (relative) location */
1543 for (i = 0; i < tp->nr_args; i++) {
1544 if (unlikely(tp->args[i].fetch_size.fn)) {
1546 * First, we set the relative location and
1547 * maximum data length to *dl
1549 dl = (u32 *)(data + tp->args[i].offset);
1550 *dl = make_data_rloc(maxlen, end - tp->args[i].offset);
1551 /* Then try to fetch string or dynamic array data */
1552 call_fetch(&tp->args[i].fetch, regs, dl);
1553 /* Reduce maximum length */
1554 end += get_rloc_len(*dl);
1555 maxlen -= get_rloc_len(*dl);
1556 /* Trick here, convert data_rloc to data_loc */
1557 *dl = convert_rloc_to_loc(*dl,
1558 ent_size + tp->args[i].offset);
1560 /* Just fetching data normally */
1561 call_fetch(&tp->args[i].fetch, regs,
1562 data + tp->args[i].offset);
1566 /* Kprobe handler */
1567 static __kprobes void kprobe_trace_func(struct kprobe *kp, struct pt_regs *regs)
1569 struct trace_probe *tp = container_of(kp, struct trace_probe, rp.kp);
1570 struct kprobe_trace_entry_head *entry;
1571 struct ring_buffer_event *event;
1572 struct ring_buffer *buffer;
1573 int size, dsize, pc;
1574 unsigned long irq_flags;
1575 struct ftrace_event_call *call = &tp->call;
1579 local_save_flags(irq_flags);
1580 pc = preempt_count();
1582 dsize = __get_data_size(tp, regs);
1583 size = sizeof(*entry) + tp->size + dsize;
1585 event = trace_current_buffer_lock_reserve(&buffer, call->event.type,
1586 size, irq_flags, pc);
1590 entry = ring_buffer_event_data(event);
1591 entry->ip = (unsigned long)kp->addr;
1592 store_trace_args(sizeof(*entry), tp, regs, (u8 *)&entry[1], dsize);
1594 if (!filter_current_check_discard(buffer, call, entry, event))
1595 trace_nowake_buffer_unlock_commit_regs(buffer, event,
1596 irq_flags, pc, regs);
1599 /* Kretprobe handler */
1600 static __kprobes void kretprobe_trace_func(struct kretprobe_instance *ri,
1601 struct pt_regs *regs)
1603 struct trace_probe *tp = container_of(ri->rp, struct trace_probe, rp);
1604 struct kretprobe_trace_entry_head *entry;
1605 struct ring_buffer_event *event;
1606 struct ring_buffer *buffer;
1607 int size, pc, dsize;
1608 unsigned long irq_flags;
1609 struct ftrace_event_call *call = &tp->call;
1611 local_save_flags(irq_flags);
1612 pc = preempt_count();
1614 dsize = __get_data_size(tp, regs);
1615 size = sizeof(*entry) + tp->size + dsize;
1617 event = trace_current_buffer_lock_reserve(&buffer, call->event.type,
1618 size, irq_flags, pc);
1622 entry = ring_buffer_event_data(event);
1623 entry->func = (unsigned long)tp->rp.kp.addr;
1624 entry->ret_ip = (unsigned long)ri->ret_addr;
1625 store_trace_args(sizeof(*entry), tp, regs, (u8 *)&entry[1], dsize);
1627 if (!filter_current_check_discard(buffer, call, entry, event))
1628 trace_nowake_buffer_unlock_commit_regs(buffer, event,
1629 irq_flags, pc, regs);
1632 /* Event entry printers */
1634 print_kprobe_event(struct trace_iterator *iter, int flags,
1635 struct trace_event *event)
1637 struct kprobe_trace_entry_head *field;
1638 struct trace_seq *s = &iter->seq;
1639 struct trace_probe *tp;
1643 field = (struct kprobe_trace_entry_head *)iter->ent;
1644 tp = container_of(event, struct trace_probe, call.event);
1646 if (!trace_seq_printf(s, "%s: (", tp->call.name))
1649 if (!seq_print_ip_sym(s, field->ip, flags | TRACE_ITER_SYM_OFFSET))
1652 if (!trace_seq_puts(s, ")"))
1655 data = (u8 *)&field[1];
1656 for (i = 0; i < tp->nr_args; i++)
1657 if (!tp->args[i].type->print(s, tp->args[i].name,
1658 data + tp->args[i].offset, field))
1661 if (!trace_seq_puts(s, "\n"))
1664 return TRACE_TYPE_HANDLED;
1666 return TRACE_TYPE_PARTIAL_LINE;
1670 print_kretprobe_event(struct trace_iterator *iter, int flags,
1671 struct trace_event *event)
1673 struct kretprobe_trace_entry_head *field;
1674 struct trace_seq *s = &iter->seq;
1675 struct trace_probe *tp;
1679 field = (struct kretprobe_trace_entry_head *)iter->ent;
1680 tp = container_of(event, struct trace_probe, call.event);
1682 if (!trace_seq_printf(s, "%s: (", tp->call.name))
1685 if (!seq_print_ip_sym(s, field->ret_ip, flags | TRACE_ITER_SYM_OFFSET))
1688 if (!trace_seq_puts(s, " <- "))
1691 if (!seq_print_ip_sym(s, field->func, flags & ~TRACE_ITER_SYM_OFFSET))
1694 if (!trace_seq_puts(s, ")"))
1697 data = (u8 *)&field[1];
1698 for (i = 0; i < tp->nr_args; i++)
1699 if (!tp->args[i].type->print(s, tp->args[i].name,
1700 data + tp->args[i].offset, field))
1703 if (!trace_seq_puts(s, "\n"))
1706 return TRACE_TYPE_HANDLED;
1708 return TRACE_TYPE_PARTIAL_LINE;
1712 #define DEFINE_FIELD(type, item, name, is_signed) \
1714 ret = trace_define_field(event_call, #type, name, \
1715 offsetof(typeof(field), item), \
1716 sizeof(field.item), is_signed, \
1722 static int kprobe_event_define_fields(struct ftrace_event_call *event_call)
1725 struct kprobe_trace_entry_head field;
1726 struct trace_probe *tp = (struct trace_probe *)event_call->data;
1728 DEFINE_FIELD(unsigned long, ip, FIELD_STRING_IP, 0);
1729 /* Set argument names as fields */
1730 for (i = 0; i < tp->nr_args; i++) {
1731 ret = trace_define_field(event_call, tp->args[i].type->fmttype,
1733 sizeof(field) + tp->args[i].offset,
1734 tp->args[i].type->size,
1735 tp->args[i].type->is_signed,
1743 static int kretprobe_event_define_fields(struct ftrace_event_call *event_call)
1746 struct kretprobe_trace_entry_head field;
1747 struct trace_probe *tp = (struct trace_probe *)event_call->data;
1749 DEFINE_FIELD(unsigned long, func, FIELD_STRING_FUNC, 0);
1750 DEFINE_FIELD(unsigned long, ret_ip, FIELD_STRING_RETIP, 0);
1751 /* Set argument names as fields */
1752 for (i = 0; i < tp->nr_args; i++) {
1753 ret = trace_define_field(event_call, tp->args[i].type->fmttype,
1755 sizeof(field) + tp->args[i].offset,
1756 tp->args[i].type->size,
1757 tp->args[i].type->is_signed,
1765 static int __set_print_fmt(struct trace_probe *tp, char *buf, int len)
1770 const char *fmt, *arg;
1772 if (!trace_probe_is_return(tp)) {
1774 arg = "REC->" FIELD_STRING_IP;
1776 fmt = "(%lx <- %lx)";
1777 arg = "REC->" FIELD_STRING_FUNC ", REC->" FIELD_STRING_RETIP;
1780 /* When len=0, we just calculate the needed length */
1781 #define LEN_OR_ZERO (len ? len - pos : 0)
1783 pos += snprintf(buf + pos, LEN_OR_ZERO, "\"%s", fmt);
1785 for (i = 0; i < tp->nr_args; i++) {
1786 pos += snprintf(buf + pos, LEN_OR_ZERO, " %s=%s",
1787 tp->args[i].name, tp->args[i].type->fmt);
1790 pos += snprintf(buf + pos, LEN_OR_ZERO, "\", %s", arg);
1792 for (i = 0; i < tp->nr_args; i++) {
1793 if (strcmp(tp->args[i].type->name, "string") == 0)
1794 pos += snprintf(buf + pos, LEN_OR_ZERO,
1798 pos += snprintf(buf + pos, LEN_OR_ZERO, ", REC->%s",
1804 /* return the length of print_fmt */
1808 static int set_print_fmt(struct trace_probe *tp)
1813 /* First: called with 0 length to calculate the needed length */
1814 len = __set_print_fmt(tp, NULL, 0);
1815 print_fmt = kmalloc(len + 1, GFP_KERNEL);
1819 /* Second: actually write the @print_fmt */
1820 __set_print_fmt(tp, print_fmt, len + 1);
1821 tp->call.print_fmt = print_fmt;
1826 #ifdef CONFIG_PERF_EVENTS
1828 /* Kprobe profile handler */
1829 static __kprobes void kprobe_perf_func(struct kprobe *kp,
1830 struct pt_regs *regs)
1832 struct trace_probe *tp = container_of(kp, struct trace_probe, rp.kp);
1833 struct ftrace_event_call *call = &tp->call;
1834 struct kprobe_trace_entry_head *entry;
1835 struct hlist_head *head;
1836 int size, __size, dsize;
1839 dsize = __get_data_size(tp, regs);
1840 __size = sizeof(*entry) + tp->size + dsize;
1841 size = ALIGN(__size + sizeof(u32), sizeof(u64));
1842 size -= sizeof(u32);
1843 if (WARN_ONCE(size > PERF_MAX_TRACE_SIZE,
1844 "profile buffer not large enough"))
1847 entry = perf_trace_buf_prepare(size, call->event.type, regs, &rctx);
1851 entry->ip = (unsigned long)kp->addr;
1852 memset(&entry[1], 0, dsize);
1853 store_trace_args(sizeof(*entry), tp, regs, (u8 *)&entry[1], dsize);
1855 head = this_cpu_ptr(call->perf_events);
1856 perf_trace_buf_submit(entry, size, rctx, entry->ip, 1, regs, head);
1859 /* Kretprobe profile handler */
1860 static __kprobes void kretprobe_perf_func(struct kretprobe_instance *ri,
1861 struct pt_regs *regs)
1863 struct trace_probe *tp = container_of(ri->rp, struct trace_probe, rp);
1864 struct ftrace_event_call *call = &tp->call;
1865 struct kretprobe_trace_entry_head *entry;
1866 struct hlist_head *head;
1867 int size, __size, dsize;
1870 dsize = __get_data_size(tp, regs);
1871 __size = sizeof(*entry) + tp->size + dsize;
1872 size = ALIGN(__size + sizeof(u32), sizeof(u64));
1873 size -= sizeof(u32);
1874 if (WARN_ONCE(size > PERF_MAX_TRACE_SIZE,
1875 "profile buffer not large enough"))
1878 entry = perf_trace_buf_prepare(size, call->event.type, regs, &rctx);
1882 entry->func = (unsigned long)tp->rp.kp.addr;
1883 entry->ret_ip = (unsigned long)ri->ret_addr;
1884 store_trace_args(sizeof(*entry), tp, regs, (u8 *)&entry[1], dsize);
1886 head = this_cpu_ptr(call->perf_events);
1887 perf_trace_buf_submit(entry, size, rctx, entry->ret_ip, 1, regs, head);
1889 #endif /* CONFIG_PERF_EVENTS */
1892 int kprobe_register(struct ftrace_event_call *event, enum trace_reg type)
1894 struct trace_probe *tp = (struct trace_probe *)event->data;
1897 case TRACE_REG_REGISTER:
1898 return enable_trace_probe(tp, TP_FLAG_TRACE);
1899 case TRACE_REG_UNREGISTER:
1900 disable_trace_probe(tp, TP_FLAG_TRACE);
1903 #ifdef CONFIG_PERF_EVENTS
1904 case TRACE_REG_PERF_REGISTER:
1905 return enable_trace_probe(tp, TP_FLAG_PROFILE);
1906 case TRACE_REG_PERF_UNREGISTER:
1907 disable_trace_probe(tp, TP_FLAG_PROFILE);
1915 int kprobe_dispatcher(struct kprobe *kp, struct pt_regs *regs)
1917 struct trace_probe *tp = container_of(kp, struct trace_probe, rp.kp);
1919 if (tp->flags & TP_FLAG_TRACE)
1920 kprobe_trace_func(kp, regs);
1921 #ifdef CONFIG_PERF_EVENTS
1922 if (tp->flags & TP_FLAG_PROFILE)
1923 kprobe_perf_func(kp, regs);
1925 return 0; /* We don't tweek kernel, so just return 0 */
1929 int kretprobe_dispatcher(struct kretprobe_instance *ri, struct pt_regs *regs)
1931 struct trace_probe *tp = container_of(ri->rp, struct trace_probe, rp);
1933 if (tp->flags & TP_FLAG_TRACE)
1934 kretprobe_trace_func(ri, regs);
1935 #ifdef CONFIG_PERF_EVENTS
1936 if (tp->flags & TP_FLAG_PROFILE)
1937 kretprobe_perf_func(ri, regs);
1939 return 0; /* We don't tweek kernel, so just return 0 */
1942 static struct trace_event_functions kretprobe_funcs = {
1943 .trace = print_kretprobe_event
1946 static struct trace_event_functions kprobe_funcs = {
1947 .trace = print_kprobe_event
1950 static int register_probe_event(struct trace_probe *tp)
1952 struct ftrace_event_call *call = &tp->call;
1955 /* Initialize ftrace_event_call */
1956 INIT_LIST_HEAD(&call->class->fields);
1957 if (trace_probe_is_return(tp)) {
1958 call->event.funcs = &kretprobe_funcs;
1959 call->class->define_fields = kretprobe_event_define_fields;
1961 call->event.funcs = &kprobe_funcs;
1962 call->class->define_fields = kprobe_event_define_fields;
1964 if (set_print_fmt(tp) < 0)
1966 ret = register_ftrace_event(&call->event);
1968 kfree(call->print_fmt);
1972 call->class->reg = kprobe_register;
1974 ret = trace_add_event_call(call);
1976 pr_info("Failed to register kprobe event: %s\n", call->name);
1977 kfree(call->print_fmt);
1978 unregister_ftrace_event(&call->event);
1983 static void unregister_probe_event(struct trace_probe *tp)
1985 /* tp->event is unregistered in trace_remove_event_call() */
1986 trace_remove_event_call(&tp->call);
1987 kfree(tp->call.print_fmt);
1990 /* Make a debugfs interface for controlling probe points */
1991 static __init int init_kprobe_trace(void)
1993 struct dentry *d_tracer;
1994 struct dentry *entry;
1996 if (register_module_notifier(&trace_probe_module_nb))
1999 d_tracer = tracing_init_dentry();
2003 entry = debugfs_create_file("kprobe_events", 0644, d_tracer,
2004 NULL, &kprobe_events_ops);
2006 /* Event list interface */
2008 pr_warning("Could not create debugfs "
2009 "'kprobe_events' entry\n");
2011 /* Profile interface */
2012 entry = debugfs_create_file("kprobe_profile", 0444, d_tracer,
2013 NULL, &kprobe_profile_ops);
2016 pr_warning("Could not create debugfs "
2017 "'kprobe_profile' entry\n");
2020 fs_initcall(init_kprobe_trace);
2023 #ifdef CONFIG_FTRACE_STARTUP_TEST
2026 * The "__used" keeps gcc from removing the function symbol
2027 * from the kallsyms table.
2029 static __used int kprobe_trace_selftest_target(int a1, int a2, int a3,
2030 int a4, int a5, int a6)
2032 return a1 + a2 + a3 + a4 + a5 + a6;
2035 static __init int kprobe_trace_self_tests_init(void)
2038 int (*target)(int, int, int, int, int, int);
2039 struct trace_probe *tp;
2041 target = kprobe_trace_selftest_target;
2043 pr_info("Testing kprobe tracing: ");
2045 ret = command_trace_probe("p:testprobe kprobe_trace_selftest_target "
2046 "$stack $stack0 +0($stack)");
2047 if (WARN_ON_ONCE(ret)) {
2048 pr_warning("error on probing function entry.\n");
2051 /* Enable trace point */
2052 tp = find_trace_probe("testprobe", KPROBE_EVENT_SYSTEM);
2053 if (WARN_ON_ONCE(tp == NULL)) {
2054 pr_warning("error on getting new probe.\n");
2057 enable_trace_probe(tp, TP_FLAG_TRACE);
2060 ret = command_trace_probe("r:testprobe2 kprobe_trace_selftest_target "
2062 if (WARN_ON_ONCE(ret)) {
2063 pr_warning("error on probing function return.\n");
2066 /* Enable trace point */
2067 tp = find_trace_probe("testprobe2", KPROBE_EVENT_SYSTEM);
2068 if (WARN_ON_ONCE(tp == NULL)) {
2069 pr_warning("error on getting new probe.\n");
2072 enable_trace_probe(tp, TP_FLAG_TRACE);
2078 ret = target(1, 2, 3, 4, 5, 6);
2080 /* Disable trace points before removing it */
2081 tp = find_trace_probe("testprobe", KPROBE_EVENT_SYSTEM);
2082 if (WARN_ON_ONCE(tp == NULL)) {
2083 pr_warning("error on getting test probe.\n");
2086 disable_trace_probe(tp, TP_FLAG_TRACE);
2088 tp = find_trace_probe("testprobe2", KPROBE_EVENT_SYSTEM);
2089 if (WARN_ON_ONCE(tp == NULL)) {
2090 pr_warning("error on getting 2nd test probe.\n");
2093 disable_trace_probe(tp, TP_FLAG_TRACE);
2095 ret = command_trace_probe("-:testprobe");
2096 if (WARN_ON_ONCE(ret)) {
2097 pr_warning("error on deleting a probe.\n");
2101 ret = command_trace_probe("-:testprobe2");
2102 if (WARN_ON_ONCE(ret)) {
2103 pr_warning("error on deleting a probe.\n");
2108 release_all_trace_probes();
2110 * Wait for the optimizer work to finish. Otherwise it might fiddle
2111 * with probes in already freed __init text.
2113 wait_for_kprobe_optimizer();
2115 pr_cont("NG: Some tests are failed. Please check them.\n");
2121 late_initcall(kprobe_trace_self_tests_init);