![Srikar Dronamraju](/assets/img/avatar_default.png)
- Enhances perf to probe user space executables and libraries. - Enhances -F/--funcs option of "perf probe" to list possible probe points in an executable file or library. - Documents userspace probing support in perf. [ Probing a function in the executable using function name ] perf probe -x /bin/zsh zfree [ Probing a library function using function name ] perf probe -x /lib64/libc.so.6 malloc [ list probe-able functions in an executable ] perf probe -F -x /bin/zsh [ list probe-able functions in an library] perf probe -F -x /lib/libc.so.6 Signed-off-by: Srikar Dronamraju <srikar@linux.vnet.ibm.com> Cc: Ananth N Mavinakayanahalli <ananth@in.ibm.com> Cc: Andi Kleen <andi@firstfloor.org> Cc: Andrew Morton <akpm@linux-foundation.org> Cc: Anton Arapov <anton@redhat.com> Cc: Christoph Hellwig <hch@infradead.org> Cc: Ingo Molnar <mingo@elte.hu> Cc: Jim Keniston <jkenisto@linux.vnet.ibm.com> Cc: Linus Torvalds <torvalds@linux-foundation.org> Cc: Linux-mm <linux-mm@kvack.org> Cc: Masami Hiramatsu <masami.hiramatsu.pt@hitachi.com> Cc: Oleg Nesterov <oleg@redhat.com> Cc: Peter Zijlstra <peterz@infradead.org> Cc: Steven Rostedt <rostedt@goodmis.org> Cc: Thomas Gleixner <tglx@linutronix.de> Link: http://lkml.kernel.org/r/20120416120909.30661.99781.sendpatchset@srdronam.in.ibm.com Signed-off-by: Arnaldo Carvalho de Melo <acme@redhat.com>
141 lines
4.3 KiB
C
141 lines
4.3 KiB
C
#ifndef _PROBE_EVENT_H
|
|
#define _PROBE_EVENT_H
|
|
|
|
#include <stdbool.h>
|
|
#include "strlist.h"
|
|
#include "strfilter.h"
|
|
|
|
extern bool probe_event_dry_run;
|
|
|
|
/* kprobe-tracer and uprobe-tracer tracing point */
|
|
struct probe_trace_point {
|
|
char *symbol; /* Base symbol */
|
|
char *module; /* Module name */
|
|
unsigned long offset; /* Offset from symbol */
|
|
bool retprobe; /* Return probe flag */
|
|
};
|
|
|
|
/* probe-tracer tracing argument referencing offset */
|
|
struct probe_trace_arg_ref {
|
|
struct probe_trace_arg_ref *next; /* Next reference */
|
|
long offset; /* Offset value */
|
|
};
|
|
|
|
/* kprobe-tracer and uprobe-tracer tracing argument */
|
|
struct probe_trace_arg {
|
|
char *name; /* Argument name */
|
|
char *value; /* Base value */
|
|
char *type; /* Type name */
|
|
struct probe_trace_arg_ref *ref; /* Referencing offset */
|
|
};
|
|
|
|
/* kprobe-tracer and uprobe-tracer tracing event (point + arg) */
|
|
struct probe_trace_event {
|
|
char *event; /* Event name */
|
|
char *group; /* Group name */
|
|
struct probe_trace_point point; /* Trace point */
|
|
int nargs; /* Number of args */
|
|
bool uprobes; /* uprobes only */
|
|
struct probe_trace_arg *args; /* Arguments */
|
|
};
|
|
|
|
/* Perf probe probing point */
|
|
struct perf_probe_point {
|
|
char *file; /* File path */
|
|
char *function; /* Function name */
|
|
int line; /* Line number */
|
|
bool retprobe; /* Return probe flag */
|
|
char *lazy_line; /* Lazy matching pattern */
|
|
unsigned long offset; /* Offset from function entry */
|
|
};
|
|
|
|
/* Perf probe probing argument field chain */
|
|
struct perf_probe_arg_field {
|
|
struct perf_probe_arg_field *next; /* Next field */
|
|
char *name; /* Name of the field */
|
|
long index; /* Array index number */
|
|
bool ref; /* Referencing flag */
|
|
};
|
|
|
|
/* Perf probe probing argument */
|
|
struct perf_probe_arg {
|
|
char *name; /* Argument name */
|
|
char *var; /* Variable name */
|
|
char *type; /* Type name */
|
|
struct perf_probe_arg_field *field; /* Structure fields */
|
|
};
|
|
|
|
/* Perf probe probing event (point + arg) */
|
|
struct perf_probe_event {
|
|
char *event; /* Event name */
|
|
char *group; /* Group name */
|
|
struct perf_probe_point point; /* Probe point */
|
|
int nargs; /* Number of arguments */
|
|
bool uprobes;
|
|
struct perf_probe_arg *args; /* Arguments */
|
|
};
|
|
|
|
|
|
/* Line number container */
|
|
struct line_node {
|
|
struct list_head list;
|
|
int line;
|
|
};
|
|
|
|
/* Line range */
|
|
struct line_range {
|
|
char *file; /* File name */
|
|
char *function; /* Function name */
|
|
int start; /* Start line number */
|
|
int end; /* End line number */
|
|
int offset; /* Start line offset */
|
|
char *path; /* Real path name */
|
|
char *comp_dir; /* Compile directory */
|
|
struct list_head line_list; /* Visible lines */
|
|
};
|
|
|
|
/* List of variables */
|
|
struct variable_list {
|
|
struct probe_trace_point point; /* Actual probepoint */
|
|
struct strlist *vars; /* Available variables */
|
|
};
|
|
|
|
/* Command string to events */
|
|
extern int parse_perf_probe_command(const char *cmd,
|
|
struct perf_probe_event *pev);
|
|
|
|
/* Events to command string */
|
|
extern char *synthesize_perf_probe_command(struct perf_probe_event *pev);
|
|
extern char *synthesize_probe_trace_command(struct probe_trace_event *tev);
|
|
extern int synthesize_perf_probe_arg(struct perf_probe_arg *pa, char *buf,
|
|
size_t len);
|
|
|
|
/* Check the perf_probe_event needs debuginfo */
|
|
extern bool perf_probe_event_need_dwarf(struct perf_probe_event *pev);
|
|
|
|
/* Release event contents */
|
|
extern void clear_perf_probe_event(struct perf_probe_event *pev);
|
|
|
|
/* Command string to line-range */
|
|
extern int parse_line_range_desc(const char *cmd, struct line_range *lr);
|
|
|
|
/* Internal use: Return kernel/module path */
|
|
extern const char *kernel_get_module_path(const char *module);
|
|
|
|
extern int add_perf_probe_events(struct perf_probe_event *pevs, int npevs,
|
|
int max_probe_points, const char *module,
|
|
bool force_add);
|
|
extern int del_perf_probe_events(struct strlist *dellist);
|
|
extern int show_perf_probe_events(void);
|
|
extern int show_line_range(struct line_range *lr, const char *module);
|
|
extern int show_available_vars(struct perf_probe_event *pevs, int npevs,
|
|
int max_probe_points, const char *module,
|
|
struct strfilter *filter, bool externs);
|
|
extern int show_available_funcs(const char *module, struct strfilter *filter,
|
|
bool user);
|
|
|
|
/* Maximum index number of event-name postfix */
|
|
#define MAX_EVENT_INDEX 1024
|
|
|
|
#endif /*_PROBE_EVENT_H */
|