aboutsummaryrefslogtreecommitdiffstats
path: root/include/linux/marker.h
diff options
context:
space:
mode:
authorMathieu Desnoyers <mathieu.desnoyers@polymtl.ca>2008-02-13 18:03:37 -0500
committerLinus Torvalds <torvalds@woody.linux-foundation.org>2008-02-13 19:21:20 -0500
commitfb40bd78b0f91b274879cf5db8facd1e04b6052e (patch)
tree2347ccb5ad07f58ab5a4eb41174bb7b54d5f0c5b /include/linux/marker.h
parent9170d2f6e1dc4d79650fbf492d1cd45291c66504 (diff)
Linux Kernel Markers: support multiple probes
RCU style multiple probes support for the Linux Kernel Markers. Common case (one probe) is still fast and does not require dynamic allocation or a supplementary pointer dereference on the fast path. - Move preempt disable from the marker site to the callback. Since we now have an internal callback, move the preempt disable/enable to the callback instead of the marker site. Since the callback change is done asynchronously (passing from a handler that supports arguments to a handler that does not setup the arguments is no arguments are passed), we can safely update it even if it is outside the preempt disable section. - Move probe arm to probe connection. Now, a connected probe is automatically armed. Remove MARK_MAX_FORMAT_LEN, unused. This patch modifies the Linux Kernel Markers API : it removes the probe "arm/disarm" and changes the probe function prototype : it now expects a va_list * instead of a "...". If we want to have more than one probe connected to a marker at a given time (LTTng, or blktrace, ssytemtap) then we need this patch. Without it, connecting a second probe handler to a marker will fail. It allow us, for instance, to do interesting combinations : Do standard tracing with LTTng and, eventually, to compute statistics with SystemTAP, or to have a special trigger on an event that would call a systemtap script which would stop flight recorder tracing. Signed-off-by: Mathieu Desnoyers <mathieu.desnoyers@polymtl.ca> Cc: Christoph Hellwig <hch@infradead.org> Cc: Mike Mason <mmlnx@us.ibm.com> Cc: Dipankar Sarma <dipankar@in.ibm.com> Cc: David Smith <dsmith@redhat.com> Cc: "Paul E. McKenney" <paulmck@us.ibm.com> Cc: "Frank Ch. Eigler" <fche@redhat.com> Cc: Steven Rostedt <rostedt@goodmis.org> Signed-off-by: Andrew Morton <akpm@linux-foundation.org> Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
Diffstat (limited to 'include/linux/marker.h')
-rw-r--r--include/linux/marker.h59
1 files changed, 36 insertions, 23 deletions
diff --git a/include/linux/marker.h b/include/linux/marker.h
index 5f36cf946bcb..b5f95637f289 100644
--- a/include/linux/marker.h
+++ b/include/linux/marker.h
@@ -19,16 +19,23 @@ struct marker;
19 19
20/** 20/**
21 * marker_probe_func - Type of a marker probe function 21 * marker_probe_func - Type of a marker probe function
22 * @mdata: pointer of type struct marker 22 * @probe_private: probe private data
23 * @private_data: caller site private data 23 * @call_private: call site private data
24 * @fmt: format string 24 * @fmt: format string
25 * @...: variable argument list 25 * @args: variable argument list pointer. Use a pointer to overcome C's
26 * inability to pass this around as a pointer in a portable manner in
27 * the callee otherwise.
26 * 28 *
27 * Type of marker probe functions. They receive the mdata and need to parse the 29 * Type of marker probe functions. They receive the mdata and need to parse the
28 * format string to recover the variable argument list. 30 * format string to recover the variable argument list.
29 */ 31 */
30typedef void marker_probe_func(const struct marker *mdata, 32typedef void marker_probe_func(void *probe_private, void *call_private,
31 void *private_data, const char *fmt, ...); 33 const char *fmt, va_list *args);
34
35struct marker_probe_closure {
36 marker_probe_func *func; /* Callback */
37 void *probe_private; /* Private probe data */
38};
32 39
33struct marker { 40struct marker {
34 const char *name; /* Marker name */ 41 const char *name; /* Marker name */
@@ -36,8 +43,11 @@ struct marker {
36 * variable argument list. 43 * variable argument list.
37 */ 44 */
38 char state; /* Marker state. */ 45 char state; /* Marker state. */
39 marker_probe_func *call;/* Probe handler function pointer */ 46 char ptype; /* probe type : 0 : single, 1 : multi */
40 void *private; /* Private probe data */ 47 void (*call)(const struct marker *mdata, /* Probe wrapper */
48 void *call_private, const char *fmt, ...);
49 struct marker_probe_closure single;
50 struct marker_probe_closure *multi;
41} __attribute__((aligned(8))); 51} __attribute__((aligned(8)));
42 52
43#ifdef CONFIG_MARKERS 53#ifdef CONFIG_MARKERS
@@ -49,7 +59,7 @@ struct marker {
49 * not add unwanted padding between the beginning of the section and the 59 * not add unwanted padding between the beginning of the section and the
50 * structure. Force alignment to the same alignment as the section start. 60 * structure. Force alignment to the same alignment as the section start.
51 */ 61 */
52#define __trace_mark(name, call_data, format, args...) \ 62#define __trace_mark(name, call_private, format, args...) \
53 do { \ 63 do { \
54 static const char __mstrtab_name_##name[] \ 64 static const char __mstrtab_name_##name[] \
55 __attribute__((section("__markers_strings"))) \ 65 __attribute__((section("__markers_strings"))) \
@@ -60,24 +70,23 @@ struct marker {
60 static struct marker __mark_##name \ 70 static struct marker __mark_##name \
61 __attribute__((section("__markers"), aligned(8))) = \ 71 __attribute__((section("__markers"), aligned(8))) = \
62 { __mstrtab_name_##name, __mstrtab_format_##name, \ 72 { __mstrtab_name_##name, __mstrtab_format_##name, \
63 0, __mark_empty_function, NULL }; \ 73 0, 0, marker_probe_cb, \
74 { __mark_empty_function, NULL}, NULL }; \
64 __mark_check_format(format, ## args); \ 75 __mark_check_format(format, ## args); \
65 if (unlikely(__mark_##name.state)) { \ 76 if (unlikely(__mark_##name.state)) { \
66 preempt_disable(); \
67 (*__mark_##name.call) \ 77 (*__mark_##name.call) \
68 (&__mark_##name, call_data, \ 78 (&__mark_##name, call_private, \
69 format, ## args); \ 79 format, ## args); \
70 preempt_enable(); \
71 } \ 80 } \
72 } while (0) 81 } while (0)
73 82
74extern void marker_update_probe_range(struct marker *begin, 83extern void marker_update_probe_range(struct marker *begin,
75 struct marker *end, struct module *probe_module, int *refcount); 84 struct marker *end);
76#else /* !CONFIG_MARKERS */ 85#else /* !CONFIG_MARKERS */
77#define __trace_mark(name, call_data, format, args...) \ 86#define __trace_mark(name, call_private, format, args...) \
78 __mark_check_format(format, ## args) 87 __mark_check_format(format, ## args)
79static inline void marker_update_probe_range(struct marker *begin, 88static inline void marker_update_probe_range(struct marker *begin,
80 struct marker *end, struct module *probe_module, int *refcount) 89 struct marker *end)
81{ } 90{ }
82#endif /* CONFIG_MARKERS */ 91#endif /* CONFIG_MARKERS */
83 92
@@ -92,8 +101,6 @@ static inline void marker_update_probe_range(struct marker *begin,
92#define trace_mark(name, format, args...) \ 101#define trace_mark(name, format, args...) \
93 __trace_mark(name, NULL, format, ## args) 102 __trace_mark(name, NULL, format, ## args)
94 103
95#define MARK_MAX_FORMAT_LEN 1024
96
97/** 104/**
98 * MARK_NOARGS - Format string for a marker with no argument. 105 * MARK_NOARGS - Format string for a marker with no argument.
99 */ 106 */
@@ -106,24 +113,30 @@ static inline void __printf(1, 2) __mark_check_format(const char *fmt, ...)
106 113
107extern marker_probe_func __mark_empty_function; 114extern marker_probe_func __mark_empty_function;
108 115
116extern void marker_probe_cb(const struct marker *mdata,
117 void *call_private, const char *fmt, ...);
118extern void marker_probe_cb_noarg(const struct marker *mdata,
119 void *call_private, const char *fmt, ...);
120
109/* 121/*
110 * Connect a probe to a marker. 122 * Connect a probe to a marker.
111 * private data pointer must be a valid allocated memory address, or NULL. 123 * private data pointer must be a valid allocated memory address, or NULL.
112 */ 124 */
113extern int marker_probe_register(const char *name, const char *format, 125extern int marker_probe_register(const char *name, const char *format,
114 marker_probe_func *probe, void *private); 126 marker_probe_func *probe, void *probe_private);
115 127
116/* 128/*
117 * Returns the private data given to marker_probe_register. 129 * Returns the private data given to marker_probe_register.
118 */ 130 */
119extern void *marker_probe_unregister(const char *name); 131extern int marker_probe_unregister(const char *name,
132 marker_probe_func *probe, void *probe_private);
120/* 133/*
121 * Unregister a marker by providing the registered private data. 134 * Unregister a marker by providing the registered private data.
122 */ 135 */
123extern void *marker_probe_unregister_private_data(void *private); 136extern int marker_probe_unregister_private_data(marker_probe_func *probe,
137 void *probe_private);
124 138
125extern int marker_arm(const char *name); 139extern void *marker_get_private_data(const char *name, marker_probe_func *probe,
126extern int marker_disarm(const char *name); 140 int num);
127extern void *marker_get_private_data(const char *name);
128 141
129#endif 142#endif