debug.h

Go to the documentation of this file.

/*
 *  FreeLoader
 *  Copyright (C) 1998-2003  Brian Palmer  <brianp@sginet.com>
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2 of the License, or
 *  (at your option) any later version.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License along
 *  with this program; if not, write to the Free Software Foundation, Inc.,
 *  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 */
 
#ifndef __DEBUG_H
#define __DEBUG_H
 
#define DPRINT_NONE         0   // No debug print
#define DPRINT_WARNING      1   // debugger messages and other misc stuff
#define DPRINT_MEMORY       2   // memory management messages
#define DPRINT_FILESYSTEM   3   // file system messages
#define DPRINT_INIFILE      4   // .ini file messages
#define DPRINT_UI           5   // user interface messages
#define DPRINT_DISK         6   // disk messages
#define DPRINT_CACHE        7   // cache messages
#define DPRINT_REGISTRY     8   // registry messages
#define DPRINT_REACTOS      9   // ReactOS messages
#define DPRINT_LINUX        10  // Linux messages
#define DPRINT_HWDETECT     11  // hardware detection messages
#define DPRINT_WINDOWS      12  // messages from Windows loader
#define DPRINT_PELOADER     13  // messages from PE images loader
#define DPRINT_SCSIPORT     14  // messages from SCSI miniport
#define DPRINT_HEAP         15  // messages in a bottle
#define DBG_CHANNELS_COUNT  16
 
#if DBG
 
    VOID
    DebugInit(
        _In_ PCSTR DebugString);
 
    ULONG   DbgPrint(const char *Format, ...);
    VOID    DbgPrint2(ULONG Mask, ULONG Level, const char *File, ULONG Line, char *Format, ...);
    VOID    DebugDumpBuffer(ULONG Mask, PVOID Buffer, ULONG Length);
    VOID    DebugDisableScreenPort(VOID);
    VOID    DbgParseDebugChannels(PCHAR Value);
 
    #define ERR_LEVEL      0x1
    #define FIXME_LEVEL    0x2
    #define WARN_LEVEL     0x4
    #define TRACE_LEVEL    0x8
 
    #define MAX_LEVEL ERR_LEVEL | FIXME_LEVEL | WARN_LEVEL | TRACE_LEVEL
 
    #define DBG_DEFAULT_CHANNEL(ch) static int DbgDefaultChannel = DPRINT_##ch
 
    #define ERR_CH(ch, fmt, ...)    DbgPrint2(DPRINT_##ch, ERR_LEVEL, __FILE__, __LINE__, fmt, ##__VA_ARGS__)
    #define FIXME_CH(ch, fmt, ...)  DbgPrint2(DPRINT_##ch, FIXME_LEVEL, __FILE__, __LINE__, fmt, ##__VA_ARGS__)
    #define WARN_CH(ch, fmt, ...)   DbgPrint2(DPRINT_##ch, WARN_LEVEL, __FILE__, __LINE__, fmt, ##__VA_ARGS__)
    #define TRACE_CH(ch, fmt, ...)  DbgPrint2(DPRINT_##ch, TRACE_LEVEL, __FILE__, __LINE__, fmt, ##__VA_ARGS__)
 
    #define ERR(fmt, ...)    DbgPrint2(DbgDefaultChannel, ERR_LEVEL, __FILE__, __LINE__, fmt, ##__VA_ARGS__)
    #define FIXME(fmt, ...)  DbgPrint2(DbgDefaultChannel, FIXME_LEVEL, __FILE__, __LINE__, fmt, ##__VA_ARGS__)
    #define WARN(fmt, ...)   DbgPrint2(DbgDefaultChannel, WARN_LEVEL, __FILE__, __LINE__, fmt, ##__VA_ARGS__)
    #define TRACE(fmt, ...)  DbgPrint2(DbgDefaultChannel, TRACE_LEVEL, __FILE__, __LINE__, fmt, ##__VA_ARGS__)
 
    #define UNIMPLEMENTED DbgPrint("(%s:%d) WARNING: %s is UNIMPLEMENTED!\n", __FILE__, __LINE__, __FUNCTION__);
 
    #define BugCheck(fmt, ...)              do { DbgPrint("(%s:%d) Fatal Error in %s: " fmt, __FILE__, __LINE__, __FUNCTION__, ##__VA_ARGS__); for (;;); } while (0)
    #define DbgDumpBuffer(mask, buf, len)    DebugDumpBuffer(mask, buf, len)
 
#ifdef __i386__
 
    // Debugging support functions:
    //
    // BREAKPOINT() - Inserts an "int 3" instruction
    // INSTRUCTION_BREAKPOINTX(x) - Enters exception handler right before instruction at address "x" is executed
    // MEMORY_READWRITE_BREAKPOINTX(x) - Enters exception handler when a read or write occurs at address "x"
    // MEMORY_WRITE_BREAKPOINTX(x) - Enters exception handler when a write occurs at address "x"
    //
    // You may have as many BREAKPOINT()'s as you like but you may only
    // have up to four of any of the others.
#define    BREAKPOINT()                __debugbreak()
void    INSTRUCTION_BREAKPOINT1(unsigned long addr);
void    MEMORY_READWRITE_BREAKPOINT1(unsigned long addr);
void    MEMORY_WRITE_BREAKPOINT1(unsigned long addr);
void    INSTRUCTION_BREAKPOINT2(unsigned long addr);
void    MEMORY_READWRITE_BREAKPOINT2(unsigned long addr);
void    MEMORY_WRITE_BREAKPOINT2(unsigned long addr);
void    INSTRUCTION_BREAKPOINT3(unsigned long addr);
void    MEMORY_READWRITE_BREAKPOINT3(unsigned long addr);
void    MEMORY_WRITE_BREAKPOINT3(unsigned long addr);
void    INSTRUCTION_BREAKPOINT4(unsigned long addr);
void    MEMORY_READWRITE_BREAKPOINT4(unsigned long addr);
void    MEMORY_WRITE_BREAKPOINT4(unsigned long addr);
 
#endif // defined __i386__
 
#else
 
    #define DBG_DEFAULT_CHANNEL(ch)
 
    #define ERR_CH(ch, fmt, ...)
    #define FIXME_CH(ch, fmt, ...)
    #define WARN_CH(ch, fmt, ...)
    #define TRACE_CH(ch, fmt, ...)
 
    #define ERR(fmt, ...)
    #define FIXME(fmt, ...)
    #define WARN(fmt, ...)
    #define TRACE(fmt, ...)
 
    #define UNIMPLEMENTED
 
    #define DebugInit(DebugString)
    #define BugCheck(fmt, ...)
    #define DbgDumpBuffer(mask, buf, len)
    #define DebugDisableScreenPort()
    #define DbgParseDebugChannels(val)
 
#endif // DBG
 
DECLSPEC_NORETURN
void
NTAPI
FrLdrBugCheck(ULONG BugCode);
 
DECLSPEC_NORETURN
VOID
FrLdrBugCheckWithMessage(
    ULONG BugCode,
    PCHAR File,
    ULONG Line,
    PSTR Format,
    ...);
 
/* Bugcheck codes */
enum _FRLDR_BUGCHECK_CODES
{
    TEST_BUGCHECK,
    MISSING_HARDWARE_REQUIREMENTS,
    FREELDR_IMAGE_CORRUPTION,
    MEMORY_INIT_FAILURE,
#ifdef UEFIBOOT
    EXIT_BOOTSERVICES_FAILURE,
#endif
};
 
extern char *BugCodeStrings[];
extern ULONG_PTR BugCheckInfo[5];
 
#endif // defined __DEBUG_H