ReactOS 0.4.15-dev-7788-g1ad9096
debug.h
Go to the documentation of this file.
1/*
2 * FreeLoader
3 * Copyright (C) 1998-2003 Brian Palmer <brianp@sginet.com>
4 *
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
9 *
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
14 *
15 * You should have received a copy of the GNU General Public License along
16 * with this program; if not, write to the Free Software Foundation, Inc.,
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
18 */
19
20#ifndef __DEBUG_H
21#define __DEBUG_H
22
23#define DPRINT_NONE 0 // No debug print
24#define DPRINT_WARNING 1 // debugger messages and other misc stuff
25#define DPRINT_MEMORY 2 // memory management messages
26#define DPRINT_FILESYSTEM 3 // file system messages
27#define DPRINT_INIFILE 4 // .ini file messages
28#define DPRINT_UI 5 // user interface messages
29#define DPRINT_DISK 6 // disk messages
30#define DPRINT_CACHE 7 // cache messages
31#define DPRINT_REGISTRY 8 // registry messages
32#define DPRINT_REACTOS 9 // ReactOS messages
33#define DPRINT_LINUX 10 // Linux messages
34#define DPRINT_HWDETECT 11 // hardware detection messages
35#define DPRINT_WINDOWS 12 // messages from Windows loader
36#define DPRINT_PELOADER 13 // messages from PE images loader
37#define DPRINT_SCSIPORT 14 // messages from SCSI miniport
38#define DPRINT_HEAP 15 // messages in a bottle
39#define DBG_CHANNELS_COUNT 16
40
41#if DBG
42
43 VOID DebugInit(IN ULONG_PTR FrLdrSectionId);
44 ULONG DbgPrint(const char *Format, ...);
45 VOID DbgPrint2(ULONG Mask, ULONG Level, const char *File, ULONG Line, char *Format, ...);
46 VOID DebugDumpBuffer(ULONG Mask, PVOID Buffer, ULONG Length);
49
50 #define ERR_LEVEL 0x1
51 #define FIXME_LEVEL 0x2
52 #define WARN_LEVEL 0x4
53 #define TRACE_LEVEL 0x8
54
55 #define MAX_LEVEL ERR_LEVEL | FIXME_LEVEL | WARN_LEVEL | TRACE_LEVEL
56
57 #define DBG_DEFAULT_CHANNEL(ch) static int DbgDefaultChannel = DPRINT_##ch
58
59 #define ERR_CH(ch, fmt, ...) DbgPrint2(DPRINT_##ch, ERR_LEVEL, __FILE__, __LINE__, fmt, ##__VA_ARGS__)
60 #define FIXME_CH(ch, fmt, ...) DbgPrint2(DPRINT_##ch, FIXME_LEVEL, __FILE__, __LINE__, fmt, ##__VA_ARGS__)
61 #define WARN_CH(ch, fmt, ...) DbgPrint2(DPRINT_##ch, WARN_LEVEL, __FILE__, __LINE__, fmt, ##__VA_ARGS__)
62 #define TRACE_CH(ch, fmt, ...) DbgPrint2(DPRINT_##ch, TRACE_LEVEL, __FILE__, __LINE__, fmt, ##__VA_ARGS__)
63
64 #define ERR(fmt, ...) DbgPrint2(DbgDefaultChannel, ERR_LEVEL, __FILE__, __LINE__, fmt, ##__VA_ARGS__)
65 #define FIXME(fmt, ...) DbgPrint2(DbgDefaultChannel, FIXME_LEVEL, __FILE__, __LINE__, fmt, ##__VA_ARGS__)
66 #define WARN(fmt, ...) DbgPrint2(DbgDefaultChannel, WARN_LEVEL, __FILE__, __LINE__, fmt, ##__VA_ARGS__)
67 #define TRACE(fmt, ...) DbgPrint2(DbgDefaultChannel, TRACE_LEVEL, __FILE__, __LINE__, fmt, ##__VA_ARGS__)
68
69 #define UNIMPLEMENTED DbgPrint("(%s:%d) WARNING: %s is UNIMPLEMENTED!\n", __FILE__, __LINE__, __FUNCTION__);
70
71 #define BugCheck(fmt, ...) do { DbgPrint("(%s:%d) Fatal Error in %s: " fmt, __FILE__, __LINE__, __FUNCTION__, ##__VA_ARGS__); for (;;); } while (0)
72 #define DbgDumpBuffer(mask, buf, len) DebugDumpBuffer(mask, buf, len)
73
74#ifdef __i386__
75
76 // Debugging support functions:
77 //
78 // BREAKPOINT() - Inserts an "int 3" instruction
79 // INSTRUCTION_BREAKPOINTX(x) - Enters exception handler right before instruction at address "x" is executed
80 // MEMORY_READWRITE_BREAKPOINTX(x) - Enters exception handler when a read or write occurs at address "x"
81 // MEMORY_WRITE_BREAKPOINTX(x) - Enters exception handler when a write occurs at address "x"
82 //
83 // You may have as many BREAKPOINT()'s as you like but you may only
84 // have up to four of any of the others.
85#define BREAKPOINT() __asm__ ("int $3");
86void INSTRUCTION_BREAKPOINT1(unsigned long addr);
87void MEMORY_READWRITE_BREAKPOINT1(unsigned long addr);
88void MEMORY_WRITE_BREAKPOINT1(unsigned long addr);
89void INSTRUCTION_BREAKPOINT2(unsigned long addr);
90void MEMORY_READWRITE_BREAKPOINT2(unsigned long addr);
91void MEMORY_WRITE_BREAKPOINT2(unsigned long addr);
92void INSTRUCTION_BREAKPOINT3(unsigned long addr);
93void MEMORY_READWRITE_BREAKPOINT3(unsigned long addr);
94void MEMORY_WRITE_BREAKPOINT3(unsigned long addr);
95void INSTRUCTION_BREAKPOINT4(unsigned long addr);
96void MEMORY_READWRITE_BREAKPOINT4(unsigned long addr);
97void MEMORY_WRITE_BREAKPOINT4(unsigned long addr);
98
99#endif // defined __i386__
100
101#else
102
103 #define DBG_DEFAULT_CHANNEL(ch)
104
105 #define ERR_CH(ch, fmt, ...)
106 #define FIXME_CH(ch, fmt, ...)
107 #define WARN_CH(ch, fmt, ...)
108 #define TRACE_CH(ch, fmt, ...)
109
110 #define ERR(fmt, ...)
111 #define FIXME(fmt, ...)
112 #define WARN(fmt, ...)
113 #define TRACE(fmt, ...)
114
115 #define UNIMPLEMENTED
116
117 #define DebugInit(FrLdrSectionId)
118 #define BugCheck(fmt, ...)
119 #define DbgDumpBuffer(mask, buf, len)
120 #define DebugDisableScreenPort()
121 #define DbgParseDebugChannels(val)
122
123#endif // DBG
124
125void
126NTAPI
127FrLdrBugCheck(ULONG BugCode);
128
129VOID
131 ULONG BugCode,
132 PCHAR File,
133 ULONG Line,
134 PSTR Format,
135 ...);
136
137/* Bugcheck codes */
139{
144#ifdef UEFIBOOT
145 EXIT_BOOTSERVICES_FAILURE,
146#endif
147};
148
149extern char *BugCodeStrings[];
150extern ULONG_PTR BugCheckInfo[5];
151
152#endif // defined __DEBUG_H
_FRLDR_BUGCHECK_CODES
Definition: debug.h:139
@ TEST_BUGCHECK
Definition: debug.h:140
@ MEMORY_INIT_FAILURE
Definition: debug.h:143
@ FREELDR_IMAGE_CORRUPTION
Definition: debug.h:142
@ MISSING_HARDWARE_REQUIREMENTS
Definition: debug.h:141
ULONG_PTR BugCheckInfo[5]
Definition: debug.c:531
void NTAPI FrLdrBugCheck(ULONG BugCode)
Definition: i386bug.c:260
#define DebugInit(FrLdrSectionId)
Definition: debug.h:117
char * BugCodeStrings[]
Definition: debug.c:520
#define DbgParseDebugChannels(val)
Definition: debug.h:121
VOID FrLdrBugCheckWithMessage(ULONG BugCode, PCHAR File, ULONG Line, PSTR Format,...)
Definition: debug.c:28
#define DebugDisableScreenPort()
Definition: debug.h:120
Definition: bufpool.h:45
Definition: File.h:16
unsigned int Mask
Definition: fpcontrol.c:82
GLenum const GLvoid * addr
Definition: glext.h:9621
#define DbgPrint
Definition: hal.h:12
_In_ ULONG _In_ ULONG _In_ ULONG Length
Definition: ntddpcm.h:102
Definition: ncftp.h:79
char * PSTR
Definition: typedefs.h:51
#define NTAPI
Definition: typedefs.h:36
uint32_t ULONG_PTR
Definition: typedefs.h:65
#define IN
Definition: typedefs.h:39
uint32_t ULONG
Definition: typedefs.h:59
char * PCHAR
Definition: typedefs.h:51
_Must_inspect_result_ _In_ WDFKEY _In_ PCUNICODE_STRING _Out_opt_ PUSHORT _Inout_opt_ PUNICODE_STRING Value
Definition: wdfregistry.h:413
_IRQL_requires_same_ typedef _In_ ULONG _In_ UCHAR Level
Definition: wmitypes.h:56