1/*	$NetBSD: kerndebug.h,v 1.3 2005/12/11 12:19:02 christos Exp $	*/
2
3/*
4 * Copyright 1997
5 * Digital Equipment Corporation. All rights reserved.
6 *
7 * This software is furnished under license and may be used and
8 * copied only in accordance with the following terms and conditions.
9 * Subject to these conditions, you may download, copy, install,
10 * use, modify and distribute this software in source and/or binary
11 * form. No title or ownership is transferred hereby.
12 *
13 * 1) Any source code used, modified or distributed must reproduce
14 *    and retain this copyright notice and list of conditions as
15 *    they appear in the source file.
16 *
17 * 2) No right is granted to use any trade name, trademark, or logo of
18 *    Digital Equipment Corporation. Neither the "Digital Equipment
19 *    Corporation" name nor any trademark or logo of Digital Equipment
20 *    Corporation may be used to endorse or promote products derived
21 *    from this software without the prior written permission of
22 *    Digital Equipment Corporation.
23 *
24 * 3) This software is provided "AS-IS" and any express or implied
25 *    warranties, including but not limited to, any implied warranties
26 *    of merchantability, fitness for a particular purpose, or
27 *    non-infringement are disclaimed. In no event shall DIGITAL be
28 *    liable for any damages whatsoever, and in particular, DIGITAL
29 *    shall not be liable for special, indirect, consequential, or
30 *    incidental damages or damages for lost profits, loss of
31 *    revenue or loss of use, whether such damages arise in contract,
32 *    negligence, tort, under statute, in equity, at law or otherwise,
33 *    even if advised of the possibility of such damage.
34 */
35
36/*
37**++
38**  FACILITY:
39**
40**	kerndebug.h
41**
42**
43**  ABSTRACT:
44**
45**      This  header provides generic debugging capabilities using printf.
46**      All debugging can be compiled out by not defining the
47**      KERNEL_DEBUG macro. In addition the amount of debug output is
48**      defined by individual variables controlled by each subsystem
49**      using this utility. Finally note that the two middle bytes of
50**      the kern debug flags (bits 16 to 23) are free for individual
51**      subsystems to use as they please (eg. define switches for
52**      individual functions etc).
53**
54**  AUTHORS:
55**
56**      John Court
57**
58**  CREATION DATE:      2-Feb-1992
59**
60**  MODIFICATION HISTORY:
61**
62**--
63*/
64#ifndef _KERNDEBUG_H_
65#define _KERNDEBUG_H_
66
67#define KERN_DEBUG_INFO		0x00000001
68#define KERN_DEBUG_WARNING      0x00000002
69#define KERN_DEBUG_ERROR        0x00000010
70#define KERN_DEBUG_SMP          0x00000020
71#define KERN_DEBUG_PANIC	0x40000000
72#define KERN_REAL_PANIC		0x80000000
73#define KERN_DEBUG_ALL          KERN_DEBUG_INFO | KERN_DEBUG_WARNING | \
74				KERN_DEBUG_ERROR | KERN_DEBUG_PANIC
75/*
76** Define the type for debugging flag subsystem variables
77*/
78typedef unsigned int Kern_Debug_Flags;
79/*
80** Set up source line location macro for extra debugging and panics
81*/
82#ifdef  __FILE__
83#define KERN_DEBUG_LOC ":%s:%d:=\n\t",__FILE__,__LINE__
84#else
85#define KERN_DEBUG_LOC ":__FILE__ not supported :=\n\t"
86#endif
87
88/*
89** This is real nasty in that it requires several printf's but is
90** unavoidable due to the differences between
91** preprocessors supporting standard ANSI C and others.
92**
93** NOTE: The format of calls to this macro must be
94**
95**       KERN_DEBUG((Kern_Debug_Flags)CntrlVar, KERN_DEBUG_xxxx,
96**                  (normal printf arguments));
97**
98**       pay special attention to the extra set of () around the
99**       final argument.
100**
101*/
102#ifdef KERNEL_DEBUG
103#define KERN_DEBUG(CntrlVar,Level,Output) \
104{ \
105	if ( (CntrlVar) & (Level) ) \
106	{ \
107		if ( (CntrlVar) & (Level) & KERN_DEBUG_PANIC ) \
108		{ \
109		      printf ("KERNEL:DEBUG PANIC"); \
110		      printf (KERN_DEBUG_LOC); \
111		      printf Output; \
112		      panic("KERN_DEBUG Panicking"); \
113		} \
114		else \
115	        { \
116		      printf Output; \
117		} \
118	} \
119}
120#else  /* else KERNEL_DEBUG not defined */
121#define KERN_DEBUG(CntrlVar,Level,Output)
122#endif /* end else KERNEL_DEBUG not defined */
123
124#endif /* _KERNDEBUG_H_ */
125
126
127
128
129
130
131
132
133