probe-event.h 4.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140
  1. #ifndef _PROBE_EVENT_H
  2. #define _PROBE_EVENT_H
  3. #include <stdbool.h>
  4. #include "strlist.h"
  5. #include "strfilter.h"
  6. extern bool probe_event_dry_run;
  7. /* kprobe-tracer and uprobe-tracer tracing point */
  8. struct probe_trace_point {
  9. char *symbol; /* Base symbol */
  10. char *module; /* Module name */
  11. unsigned long offset; /* Offset from symbol */
  12. bool retprobe; /* Return probe flag */
  13. };
  14. /* probe-tracer tracing argument referencing offset */
  15. struct probe_trace_arg_ref {
  16. struct probe_trace_arg_ref *next; /* Next reference */
  17. long offset; /* Offset value */
  18. };
  19. /* kprobe-tracer and uprobe-tracer tracing argument */
  20. struct probe_trace_arg {
  21. char *name; /* Argument name */
  22. char *value; /* Base value */
  23. char *type; /* Type name */
  24. struct probe_trace_arg_ref *ref; /* Referencing offset */
  25. };
  26. /* kprobe-tracer and uprobe-tracer tracing event (point + arg) */
  27. struct probe_trace_event {
  28. char *event; /* Event name */
  29. char *group; /* Group name */
  30. struct probe_trace_point point; /* Trace point */
  31. int nargs; /* Number of args */
  32. bool uprobes; /* uprobes only */
  33. struct probe_trace_arg *args; /* Arguments */
  34. };
  35. /* Perf probe probing point */
  36. struct perf_probe_point {
  37. char *file; /* File path */
  38. char *function; /* Function name */
  39. int line; /* Line number */
  40. bool retprobe; /* Return probe flag */
  41. char *lazy_line; /* Lazy matching pattern */
  42. unsigned long offset; /* Offset from function entry */
  43. };
  44. /* Perf probe probing argument field chain */
  45. struct perf_probe_arg_field {
  46. struct perf_probe_arg_field *next; /* Next field */
  47. char *name; /* Name of the field */
  48. long index; /* Array index number */
  49. bool ref; /* Referencing flag */
  50. };
  51. /* Perf probe probing argument */
  52. struct perf_probe_arg {
  53. char *name; /* Argument name */
  54. char *var; /* Variable name */
  55. char *type; /* Type name */
  56. struct perf_probe_arg_field *field; /* Structure fields */
  57. };
  58. /* Perf probe probing event (point + arg) */
  59. struct perf_probe_event {
  60. char *event; /* Event name */
  61. char *group; /* Group name */
  62. struct perf_probe_point point; /* Probe point */
  63. int nargs; /* Number of arguments */
  64. bool uprobes;
  65. struct perf_probe_arg *args; /* Arguments */
  66. };
  67. /* Line number container */
  68. struct line_node {
  69. struct list_head list;
  70. int line;
  71. };
  72. /* Line range */
  73. struct line_range {
  74. char *file; /* File name */
  75. char *function; /* Function name */
  76. int start; /* Start line number */
  77. int end; /* End line number */
  78. int offset; /* Start line offset */
  79. char *path; /* Real path name */
  80. char *comp_dir; /* Compile directory */
  81. struct list_head line_list; /* Visible lines */
  82. };
  83. /* List of variables */
  84. struct variable_list {
  85. struct probe_trace_point point; /* Actual probepoint */
  86. struct strlist *vars; /* Available variables */
  87. };
  88. /* Command string to events */
  89. extern int parse_perf_probe_command(const char *cmd,
  90. struct perf_probe_event *pev);
  91. /* Events to command string */
  92. extern char *synthesize_perf_probe_command(struct perf_probe_event *pev);
  93. extern char *synthesize_probe_trace_command(struct probe_trace_event *tev);
  94. extern int synthesize_perf_probe_arg(struct perf_probe_arg *pa, char *buf,
  95. size_t len);
  96. /* Check the perf_probe_event needs debuginfo */
  97. extern bool perf_probe_event_need_dwarf(struct perf_probe_event *pev);
  98. /* Release event contents */
  99. extern void clear_perf_probe_event(struct perf_probe_event *pev);
  100. /* Command string to line-range */
  101. extern int parse_line_range_desc(const char *cmd, struct line_range *lr);
  102. /* Internal use: Return kernel/module path */
  103. extern const char *kernel_get_module_path(const char *module);
  104. extern int add_perf_probe_events(struct perf_probe_event *pevs, int npevs,
  105. int max_probe_points, const char *module,
  106. bool force_add);
  107. extern int del_perf_probe_events(struct strlist *dellist);
  108. extern int show_perf_probe_events(void);
  109. extern int show_line_range(struct line_range *lr, const char *module);
  110. extern int show_available_vars(struct perf_probe_event *pevs, int npevs,
  111. int max_probe_points, const char *module,
  112. struct strfilter *filter, bool externs);
  113. extern int show_available_funcs(const char *module, struct strfilter *filter,
  114. bool user);
  115. /* Maximum index number of event-name postfix */
  116. #define MAX_EVENT_INDEX 1024
  117. #endif /*_PROBE_EVENT_H */