The Design and Implementation of the FreeBSD Operating System, Second Edition
Now available: The Design and Implementation of the FreeBSD Operating System (Second Edition)


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]

FreeBSD/Linux Kernel Cross Reference
sys/sys/ktr.h

Version: -  FREEBSD  -  FREEBSD-13-STABLE  -  FREEBSD-13-0  -  FREEBSD-12-STABLE  -  FREEBSD-12-0  -  FREEBSD-11-STABLE  -  FREEBSD-11-0  -  FREEBSD-10-STABLE  -  FREEBSD-10-0  -  FREEBSD-9-STABLE  -  FREEBSD-9-0  -  FREEBSD-8-STABLE  -  FREEBSD-8-0  -  FREEBSD-7-STABLE  -  FREEBSD-7-0  -  FREEBSD-6-STABLE  -  FREEBSD-6-0  -  FREEBSD-5-STABLE  -  FREEBSD-5-0  -  FREEBSD-4-STABLE  -  FREEBSD-3-STABLE  -  FREEBSD22  -  l41  -  OPENBSD  -  linux-2.6  -  MK84  -  PLAN9  -  xnu-8792 
SearchContext: -  none  -  3  -  10 

    1 /*-
    2  * Copyright (c) 1996 Berkeley Software Design, Inc. All rights reserved.
    3  *
    4  * Redistribution and use in source and binary forms, with or without
    5  * modification, are permitted provided that the following conditions
    6  * are met:
    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
   14  *    written permission.
   15  *
   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
   26  * SUCH DAMAGE.
   27  *
   28  *      from BSDI $Id: ktr.h,v 1.10.2.7 2000/03/16 21:44:42 cp Exp $
   29  * $FreeBSD: releng/10.2/sys/sys/ktr.h 284343 2015-06-13 16:15:43Z jhb $
   30  */
   31 
   32 /*
   33  *      Wraparound kernel trace buffer support.
   34  */
   35 
   36 #ifndef _SYS_KTR_H_
   37 #define _SYS_KTR_H_
   38 
   39 /*
   40  * Trace classes
   41  *
   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.
   46  */
   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
   80 
   81 /* Trace classes to compile in */
   82 #ifdef KTR
   83 #ifndef KTR_COMPILE
   84 #define KTR_COMPILE     (KTR_ALL)
   85 #endif
   86 #else   /* !KTR */
   87 #undef KTR_COMPILE
   88 #define KTR_COMPILE 0
   89 #endif  /* KTR */
   90 
   91 /*
   92  * Version number for ktr_entry struct.  Increment this when you break binary
   93  * compatibility.
   94  */
   95 #define KTR_VERSION     2
   96 
   97 #define KTR_PARMS       6
   98 
   99 #ifndef LOCORE
  100 
  101 #include <sys/param.h>
  102 #include <sys/_cpuset.h>
  103 
  104 struct ktr_entry {
  105         u_int64_t ktr_timestamp;
  106         int     ktr_cpu;
  107         int     ktr_line;
  108         const   char *ktr_file;
  109         const   char *ktr_desc;
  110         struct  thread *ktr_thread;
  111         u_long  ktr_parms[KTR_PARMS];
  112 };
  113 
  114 extern cpuset_t ktr_cpumask;
  115 extern int ktr_mask;
  116 extern int ktr_entries;
  117 extern int ktr_verbose;
  118 
  119 extern volatile int ktr_idx;
  120 extern struct ktr_entry *ktr_buf;
  121 
  122 #ifdef KTR
  123 
  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);
  127 
  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));          \
  133         } while(0)
  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)
  140 #else   /* KTR */
  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
  148 #endif  /* KTR */
  149 
  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)
  157 
  158 /*
  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.
  162  *
  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.
  168  *
  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.
  174  *
  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.
  177  */
  178 
  179 #define KTR_ATTR_LINKED "linkedto:\"%s\""
  180 #define KTR_EFMT(egroup, ident, etype)                                  \
  181             "KTRGRAPH group:\"" egroup "\", id:\"%s\", " etype ", attributes: "
  182 
  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))
  197 
  198 /*
  199  * State functions graph state changes on an ident.
  200  */
  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))
  213 
  214 /*
  215  * Counter functions graph counter values.  The counter id
  216  * must not be intermixed with a state id. 
  217  */
  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))
  230 
  231 /*
  232  * Point functions plot points of interest on counter or state graphs.
  233  */
  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))
  246 
  247 /*
  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
  250  * sequences.
  251  *
  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.
  255  */
  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,     \
  262             a0, (v0), a1, (v1))
  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))
  270 
  271 /*
  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
  274  * sequences.
  275  */
  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,      \
  282             a0, (v0), a1, (v1))
  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))
  290 
  291 /*
  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).
  296  */
  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)
  305 #else
  306 #define ITR0(d)
  307 #define ITR1(d, p1)
  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)
  313 #endif
  314 
  315 #endif /* !LOCORE */
  316 
  317 #endif /* !_SYS_KTR_H_ */

Cache object: c5f8b64f974189b73e483d9f50d90a84


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]


This page is part of the FreeBSD/Linux Linux Kernel Cross-Reference, and was automatically generated using a modified version of the LXR engine.