2 * Copyright (c) 1996 Berkeley Software Design, Inc. All rights reserved.
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions
7 * 1. Redistributions of source code must retain the above copyright
8 * notice, this list of conditions and the following disclaimer.
9 * 2. Redistributions in binary form must reproduce the above copyright
10 * notice, this list of conditions and the following disclaimer in the
11 * documentation and/or other materials provided with the distribution.
12 * 3. Berkeley Software Design Inc's name may not be used to endorse or
13 * promote products derived from this software without specific prior
16 * THIS SOFTWARE IS PROVIDED BY BERKELEY SOFTWARE DESIGN INC ``AS IS'' AND
17 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19 * ARE DISCLAIMED. IN NO EVENT SHALL BERKELEY SOFTWARE DESIGN INC BE LIABLE
20 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28 * from BSDI $Id: ktr.h,v 1.10.2.7 2000/03/16 21:44:42 cp Exp $
33 * Wraparound kernel trace buffer support.
42 * Two of the trace classes (KTR_DEV and KTR_SUBSYS) are special in that
43 * they are really placeholders so that indvidual drivers and subsystems
44 * can map their internal tracing to the general class when they wish to
45 * have tracing enabled and map it to 0 when they don't.
47 #define KTR_GEN 0x00000001 /* General (TR) */
48 #define KTR_NET 0x00000002 /* Network */
49 #define KTR_DEV 0x00000004 /* Device driver */
50 #define KTR_LOCK 0x00000008 /* MP locking */
51 #define KTR_SMP 0x00000010 /* MP general */
52 #define KTR_SUBSYS 0x00000020 /* Subsystem. */
53 #define KTR_PMAP 0x00000040 /* Pmap tracing */
54 #define KTR_MALLOC 0x00000080 /* Malloc tracing */
55 #define KTR_TRAP 0x00000100 /* Trap processing */
56 #define KTR_INTR 0x00000200 /* Interrupt tracing */
57 #define KTR_SIG 0x00000400 /* Signal processing */
58 #define KTR_SPARE2 0x00000800 /* XXX Used by cxgb */
59 #define KTR_PROC 0x00001000 /* Process scheduling */
60 #define KTR_SYSC 0x00002000 /* System call */
61 #define KTR_INIT 0x00004000 /* System initialization */
62 #define KTR_SPARE3 0x00008000 /* XXX Used by cxgb */
63 #define KTR_SPARE4 0x00010000 /* XXX Used by cxgb */
64 #define KTR_EVH 0x00020000 /* Eventhandler */
65 #define KTR_VFS 0x00040000 /* VFS events */
66 #define KTR_VOP 0x00080000 /* Auto-generated vop events */
67 #define KTR_VM 0x00100000 /* The virtual memory system */
68 #define KTR_INET 0x00200000 /* IPv4 stack */
69 #define KTR_RUNQ 0x00400000 /* Run queue */
70 #define KTR_CONTENTION 0x00800000 /* Lock contention */
71 #define KTR_UMA 0x01000000 /* UMA slab allocator */
72 #define KTR_CALLOUT 0x02000000 /* Callouts and timeouts */
73 #define KTR_GEOM 0x04000000 /* GEOM I/O events */
74 #define KTR_BUSDMA 0x08000000 /* busdma(9) events */
75 #define KTR_INET6 0x10000000 /* IPv6 stack */
76 #define KTR_SCHED 0x20000000 /* Machine parsed sched info. */
77 #define KTR_BUF 0x40000000 /* Buffer cache */
78 #define KTR_PTRACE 0x80000000 /* Process debugging. */
79 #define KTR_ALL 0xffffffff
81 /* Trace classes to compile in */
84 #define KTR_COMPILE (KTR_ALL)
92 * Version number for ktr_entry struct. Increment this when you break binary
101 #include <sys/param.h>
102 #include <sys/_cpuset.h>
105 u_int64_t ktr_timestamp;
108 const char *ktr_file;
109 const char *ktr_desc;
110 struct thread *ktr_thread;
111 u_long ktr_parms[KTR_PARMS];
114 extern cpuset_t ktr_cpumask;
116 extern int ktr_entries;
117 extern int ktr_verbose;
119 extern volatile int ktr_idx;
120 extern struct ktr_entry *ktr_buf;
124 void ktr_tracepoint(u_int mask, const char *file, int line,
125 const char *format, u_long arg1, u_long arg2, u_long arg3,
126 u_long arg4, u_long arg5, u_long arg6);
128 #define CTR6(m, format, p1, p2, p3, p4, p5, p6) do { \
129 if (KTR_COMPILE & (m)) \
130 ktr_tracepoint((m), __FILE__, __LINE__, format, \
131 (u_long)(p1), (u_long)(p2), (u_long)(p3), \
132 (u_long)(p4), (u_long)(p5), (u_long)(p6)); \
134 #define CTR0(m, format) CTR6(m, format, 0, 0, 0, 0, 0, 0)
135 #define CTR1(m, format, p1) CTR6(m, format, p1, 0, 0, 0, 0, 0)
136 #define CTR2(m, format, p1, p2) CTR6(m, format, p1, p2, 0, 0, 0, 0)
137 #define CTR3(m, format, p1, p2, p3) CTR6(m, format, p1, p2, p3, 0, 0, 0)
138 #define CTR4(m, format, p1, p2, p3, p4) CTR6(m, format, p1, p2, p3, p4, 0, 0)
139 #define CTR5(m, format, p1, p2, p3, p4, p5) CTR6(m, format, p1, p2, p3, p4, p5, 0)
141 #define CTR0(m, d) (void)0
142 #define CTR1(m, d, p1) (void)0
143 #define CTR2(m, d, p1, p2) (void)0
144 #define CTR3(m, d, p1, p2, p3) (void)0
145 #define CTR4(m, d, p1, p2, p3, p4) (void)0
146 #define CTR5(m, d, p1, p2, p3, p4, p5) (void)0
147 #define CTR6(m, d, p1, p2, p3, p4, p5, p6) (void)0
150 #define TR0(d) CTR0(KTR_GEN, d)
151 #define TR1(d, p1) CTR1(KTR_GEN, d, p1)
152 #define TR2(d, p1, p2) CTR2(KTR_GEN, d, p1, p2)
153 #define TR3(d, p1, p2, p3) CTR3(KTR_GEN, d, p1, p2, p3)
154 #define TR4(d, p1, p2, p3, p4) CTR4(KTR_GEN, d, p1, p2, p3, p4)
155 #define TR5(d, p1, p2, p3, p4, p5) CTR5(KTR_GEN, d, p1, p2, p3, p4, p5)
156 #define TR6(d, p1, p2, p3, p4, p5, p6) CTR6(KTR_GEN, d, p1, p2, p3, p4, p5, p6)
159 * The event macros implement KTR graphic plotting facilities provided
160 * by src/tools/sched/schedgraph.py. Three generic types of events are
161 * supported: states, counters, and points.
163 * m is the ktr class for ktr_mask.
164 * ident is the string identifier that owns the event (ie: "thread 10001")
165 * etype is the type of event to plot (state, counter, point)
166 * edat is the event specific data (state name, counter value, point name)
167 * up to four attributes may be supplied as a name, value pair of arguments.
169 * etype and attribute names must be string constants. This minimizes the
170 * number of ktr slots required by construction the final format strings
171 * at compile time. Both must also include a colon and format specifier
172 * (ie. "prio:%d", prio). It is recommended that string arguments be
173 * contained within escaped quotes if they may contain ',' or ':' characters.
175 * The special attribute (KTR_ATTR_LINKED, ident) creates a reference to another
176 * id on the graph for easy traversal of related graph elements.
179 #define KTR_ATTR_LINKED "linkedto:\"%s\""
180 #define KTR_EFMT(egroup, ident, etype) \
181 "KTRGRAPH group:\"" egroup "\", id:\"%s\", " etype ", attributes: "
183 #define KTR_EVENT0(m, egroup, ident, etype, edat) \
184 CTR2(m, KTR_EFMT(egroup, ident, etype) "none", ident, edat)
185 #define KTR_EVENT1(m, egroup, ident, etype, edat, a0, v0) \
186 CTR3(m, KTR_EFMT(egroup, ident, etype) a0, ident, edat, (v0))
187 #define KTR_EVENT2(m, egroup, ident, etype, edat, a0, v0, a1, v1) \
188 CTR4(m, KTR_EFMT(egroup, ident, etype) a0 ", " a1, \
189 ident, edat, (v0), (v1))
190 #define KTR_EVENT3(m, egroup, ident, etype, edat, a0, v0, a1, v1, a2, v2)\
191 CTR5(m,KTR_EFMT(egroup, ident, etype) a0 ", " a1 ", " a2, \
192 ident, edat, (v0), (v1), (v2))
193 #define KTR_EVENT4(m, egroup, ident, etype, edat, \
194 a0, v0, a1, v1, a2, v2, a3, v3) \
195 CTR6(m,KTR_EFMT(egroup, ident, etype) a0 ", " a1 ", " a2 ", " a3,\
196 ident, edat, (v0), (v1), (v2), (v3))
199 * State functions graph state changes on an ident.
201 #define KTR_STATE0(m, egroup, ident, state) \
202 KTR_EVENT0(m, egroup, ident, "state:\"%s\"", state)
203 #define KTR_STATE1(m, egroup, ident, state, a0, v0) \
204 KTR_EVENT1(m, egroup, ident, "state:\"%s\"", state, a0, (v0))
205 #define KTR_STATE2(m, egroup, ident, state, a0, v0, a1, v1) \
206 KTR_EVENT2(m, egroup, ident, "state:\"%s\"", state, a0, (v0), a1, (v1))
207 #define KTR_STATE3(m, egroup, ident, state, a0, v0, a1, v1, a2, v2) \
208 KTR_EVENT3(m, egroup, ident, "state:\"%s\"", \
209 state, a0, (v0), a1, (v1), a2, (v2))
210 #define KTR_STATE4(m, egroup, ident, state, a0, v0, a1, v1, a2, v2, a3, v3)\
211 KTR_EVENT4(m, egroup, ident, "state:\"%s\"", \
212 state, a0, (v0), a1, (v1), a2, (v2), a3, (v3))
215 * Counter functions graph counter values. The counter id
216 * must not be intermixed with a state id.
218 #define KTR_COUNTER0(m, egroup, ident, counter) \
219 KTR_EVENT0(m, egroup, ident, "counter:%d", counter)
220 #define KTR_COUNTER1(m, egroup, ident, edat, a0, v0) \
221 KTR_EVENT1(m, egroup, ident, "counter:%d", counter, a0, (v0))
222 #define KTR_COUNTER2(m, egroup, ident, counter, a0, v0, a1, v1) \
223 KTR_EVENT2(m, egroup, ident, "counter:%d", counter, a0, (v0), a1, (v1))
224 #define KTR_COUNTER3(m, egroup, ident, counter, a0, v0, a1, v1, a2, v2) \
225 KTR_EVENT3(m, egroup, ident, "counter:%d", \
226 counter, a0, (v0), a1, (v1), a2, (v2))
227 #define KTR_COUNTER4(m, egroup, ident, counter, a0, v0, a1, v1, a2, v2, a3, v3)\
228 KTR_EVENT4(m, egroup, ident, "counter:%d", \
229 counter, a0, (v0), a1, (v1), a2, (v2), a3, (v3))
232 * Point functions plot points of interest on counter or state graphs.
234 #define KTR_POINT0(m, egroup, ident, point) \
235 KTR_EVENT0(m, egroup, ident, "point:\"%s\"", point)
236 #define KTR_POINT1(m, egroup, ident, point, a0, v0) \
237 KTR_EVENT1(m, egroup, ident, "point:\"%s\"", point, a0, (v0))
238 #define KTR_POINT2(m, egroup, ident, point, a0, v0, a1, v1) \
239 KTR_EVENT2(m, egroup, ident, "point:\"%s\"", point, a0, (v0), a1, (v1))
240 #define KTR_POINT3(m, egroup, ident, point, a0, v0, a1, v1, a2, v2) \
241 KTR_EVENT3(m, egroup, ident, "point:\"%s\"", point, \
242 a0, (v0), a1, (v1), a2, (v2))
243 #define KTR_POINT4(m, egroup, ident, point, a0, v0, a1, v1, a2, v2, a3, v3)\
244 KTR_EVENT4(m, egroup, ident, "point:\"%s\"", \
245 point, a0, (v0), a1, (v1), a2, (v2), a3, (v3))
248 * Start functions denote the start of a region of code or operation
249 * and should be paired with stop functions for timing of nested
252 * Specifying extra attributes with the name "key" will result in
253 * multi-part keys. For example a block device and offset pair
254 * might be used to describe a buf undergoing I/O.
256 #define KTR_START0(m, egroup, ident, key) \
257 KTR_EVENT0(m, egroup, ident, "start:0x%jX", (uintmax_t)key)
258 #define KTR_START1(m, egroup, ident, key, a0, v0) \
259 KTR_EVENT1(m, egroup, ident, "start:0x%jX", (uintmax_t)key, a0, (v0))
260 #define KTR_START2(m, egroup, ident, key, a0, v0, a1, v1) \
261 KTR_EVENT2(m, egroup, ident, "start:0x%jX", (uintmax_t)key, \
263 #define KTR_START3(m, egroup, ident, key, a0, v0, a1, v1, a2, v2)\
264 KTR_EVENT3(m, egroup, ident, "start:0x%jX", (uintmax_t)key, \
265 a0, (v0), a1, (v1), a2, (v2))
266 #define KTR_START4(m, egroup, ident, key, \
267 a0, v0, a1, v1, a2, v2, a3, v3) \
268 KTR_EVENT4(m, egroup, ident, "start:0x%jX", (uintmax_t)key, \
269 a0, (v0), a1, (v1), a2, (v2), a3, (v3))
272 * Stop functions denote the end of a region of code or operation
273 * and should be paired with start functions for timing of nested
276 #define KTR_STOP0(m, egroup, ident, key) \
277 KTR_EVENT0(m, egroup, ident, "stop:0x%jX", (uintmax_t)key)
278 #define KTR_STOP1(m, egroup, ident, key, a0, v0) \
279 KTR_EVENT1(m, egroup, ident, "stop:0x%jX", (uintmax_t)key, a0, (v0))
280 #define KTR_STOP2(m, egroup, ident, key, a0, v0, a1, v1) \
281 KTR_EVENT2(m, egroup, ident, "stop:0x%jX", (uintmax_t)key, \
283 #define KTR_STOP3(m, egroup, ident, key, a0, v0, a1, v1, a2, v2)\
284 KTR_EVENT3(m, egroup, ident, "stop:0x%jX", (uintmax_t)key, \
285 a0, (v0), a1, (v1), a2, (v2))
286 #define KTR_STOP4(m, egroup, ident, \
287 key, a0, v0, a1, v1, a2, v2, a3, v3) \
288 KTR_EVENT4(m, egroup, ident, "stop:0x%jX", (uintmax_t)key, \
289 a0, (v0), a1, (v1), a2, (v2), a3, (v3))
292 * Trace initialization events, similar to CTR with KTR_INIT, but
293 * completely ifdef'ed out if KTR_INIT isn't in KTR_COMPILE (to
294 * save string space, the compiler doesn't optimize out strings
295 * for the conditional ones above).
297 #if (KTR_COMPILE & KTR_INIT) != 0
298 #define ITR0(d) CTR0(KTR_INIT, d)
299 #define ITR1(d, p1) CTR1(KTR_INIT, d, p1)
300 #define ITR2(d, p1, p2) CTR2(KTR_INIT, d, p1, p2)
301 #define ITR3(d, p1, p2, p3) CTR3(KTR_INIT, d, p1, p2, p3)
302 #define ITR4(d, p1, p2, p3, p4) CTR4(KTR_INIT, d, p1, p2, p3, p4)
303 #define ITR5(d, p1, p2, p3, p4, p5) CTR5(KTR_INIT, d, p1, p2, p3, p4, p5)
304 #define ITR6(d, p1, p2, p3, p4, p5, p6) CTR6(KTR_INIT, d, p1, p2, p3, p4, p5, p6)
308 #define ITR2(d, p1, p2)
309 #define ITR3(d, p1, p2, p3)
310 #define ITR4(d, p1, p2, p3, p4)
311 #define ITR5(d, p1, p2, p3, p4, p5)
312 #define ITR6(d, p1, p2, p3, p4, p5, p6)
317 #endif /* !_SYS_KTR_H_ */