i386bug.c File Reference

#include <freeldr.h>
#include <debug.h>

Include dependency graph for i386bug.c:

Go to the source code of this file.

Classes
struct	_FRAME

Macros
#define	SCREEN_ATTR   0x1F

Typedefs
typedef struct _FRAME	FRAME

Functions
static void	i386PrintText (CHAR *pszText)
static void	PrintTextV (const CHAR *Format, va_list args)
static void	PrintText (const CHAR *Format,...)
static void	i386PrintFrames (PKTRAP_FRAME TrapFrame)
void NTAPI	i386PrintExceptionText (ULONG TrapIndex, PKTRAP_FRAME TrapFrame, PKSPECIAL_REGISTERS Special)
VOID	FrLdrBugCheckWithMessage (ULONG BugCode, PCHAR File, ULONG Line, PSTR Format,...)
void NTAPI	FrLdrBugCheckEx (ULONG BugCode, PCHAR File, ULONG Line)
void NTAPI	FrLdrBugCheck (ULONG BugCode)

Variables
static const CHAR *	i386ExceptionDescriptionText []
static ULONG	i386_ScreenPosX = 0
static ULONG	i386_ScreenPosY = 0

Macro Definition Documentation

SCREEN_ATTR

#define SCREEN_ATTR   0x1F

Definition at line 35 of file i386bug.c.

Typedef Documentation

FRAME

typedef struct _FRAME FRAME

Function Documentation

FrLdrBugCheck()

void NTAPI FrLdrBugCheck

(

ULONG

BugCode

)

Definition at line 260 of file i386bug.c.

{
    FrLdrBugCheckEx(BugCode, 0, 0);
}

FrLdrBugCheckEx()

void NTAPI FrLdrBugCheckEx	(	ULONG	BugCode,
		PCHAR	File,
		ULONG	Line
	)

Definition at line 231 of file i386bug.c.

{
    MachVideoHideShowTextCursor(FALSE);
    MachVideoClearScreen(SCREEN_ATTR);
    i386_ScreenPosX = 0;
    i386_ScreenPosY = 0;
 
    PrintText("A problem has been detected and FreeLoader boot has been aborted.\n\n");
 
    PrintText("%ld: %s\n\n", BugCode, BugCodeStrings[BugCode]);
 
    if (File)
    {
        PrintText("Location: %s:%ld\n\n", File, Line);
    }
 
    PrintText("Bug Information:\n    %p\n    %p\n    %p\n    %p\n    %p\n\n",
              BugCheckInfo[0], BugCheckInfo[1], BugCheckInfo[2], BugCheckInfo[3], BugCheckInfo[4]);
 
    _disable();
    __halt();
    for (;;);
}

Referenced by FrLdrBugCheck().

FrLdrBugCheckWithMessage()

VOID FrLdrBugCheckWithMessage	(	ULONG	BugCode,
		PCHAR	File,
		ULONG	Line,
		PSTR	Format,
			...
	)

Definition at line 197 of file i386bug.c.

{
    va_list argptr;
 
    MachVideoHideShowTextCursor(FALSE);
    MachVideoClearScreen(SCREEN_ATTR);
    i386_ScreenPosX = 0;
    i386_ScreenPosY = 0;
 
    PrintText("A problem has been detected and FreeLoader boot has been aborted.\n\n");
 
    PrintText("%ld: %s\n\n", BugCode, BugCodeStrings[BugCode]);
 
    if (File)
    {
        PrintText("Location: %s:%ld\n\n", File, Line);
    }
 
    va_start(argptr, Format);
    PrintTextV(Format, argptr);
    va_end(argptr);
 
    _disable();
    __halt();
    for (;;);
}

i386PrintExceptionText()

void NTAPI i386PrintExceptionText	(	ULONG	TrapIndex,
		PKTRAP_FRAME	TrapFrame,
		PKSPECIAL_REGISTERS	Special
	)

Definition at line 109 of file i386bug.c.

{
    PUCHAR InstructionPointer;
 
    MachVideoHideShowTextCursor(FALSE);
    MachVideoClearScreen(SCREEN_ATTR);
    i386_ScreenPosX = 0;
    i386_ScreenPosY = 0;
 
    PrintText("An error occured in " VERSION "\n"
              "Report this error on the ReactOS Bug Tracker: https://jira.reactos.org\n\n"
              "0x%02lx: %s\n\n", TrapIndex, i386ExceptionDescriptionText[TrapIndex]);
 
#ifdef _M_IX86
    PrintText("EAX: %.8lx        ESP: %.8lx        CR0: %.8lx        DR0: %.8lx\n",
              TrapFrame->Eax, TrapFrame->HardwareEsp, Special->Cr0, TrapFrame->Dr0);
    PrintText("EBX: %.8lx        EBP: %.8lx        CR1: ????????        DR1: %.8lx\n",
              TrapFrame->Ebx, TrapFrame->Ebp, TrapFrame->Dr1);
    PrintText("ECX: %.8lx        ESI: %.8lx        CR2: %.8lx        DR2: %.8lx\n",
              TrapFrame->Ecx, TrapFrame->Esi, Special->Cr2, TrapFrame->Dr2);
    PrintText("EDX: %.8lx        EDI: %.8lx        CR3: %.8lx        DR3: %.8lx\n",
              TrapFrame->Edx, TrapFrame->Edi, Special->Cr3, TrapFrame->Dr3);
    PrintText("%*s CR4: %.8lx        DR6: %.8lx\n",
              41, "", Special->Cr4, TrapFrame->Dr6);
    PrintText("%*s DR7: %.8lx\n",
              62, "", TrapFrame->Dr7);
 
    /* NOTE: Segment registers are intrinsically 16 bits. Even if the x86
     * KTRAP_FRAME structure stores them as ULONG, only their lower 16 bits
     * are initialized. We thus cast them to USHORT before display. */
    PrintText(" CS: %.4lx            EIP: %.8lx\n",
              (USHORT)TrapFrame->SegCs, TrapFrame->Eip);
    PrintText(" DS: %.4lx     ERROR CODE: %.8lx\n",
              (USHORT)TrapFrame->SegDs, TrapFrame->ErrCode);
    PrintText(" ES: %.4lx         EFLAGS: %.8lx\n",
              (USHORT)TrapFrame->SegEs, TrapFrame->EFlags);
    PrintText(" FS: %.4lx      GDTR Base: %.8lx Limit: %.4x\n",
           // " FS: %.4lx           GDTR: Base %.8lx Limit %.4x\n"
              (USHORT)TrapFrame->SegFs, Special->Gdtr.Base, Special->Gdtr.Limit);
    PrintText(" GS: %.4lx      IDTR Base: %.8lx Limit: %.4x\n",
           // " GS: %.4lx           IDTR: Base %.8lx Limit %.4x\n",
              (USHORT)TrapFrame->SegGs, Special->Idtr.Base, Special->Idtr.Limit);
    PrintText(" SS: %.4lx           LDTR: %.4lx TR: %.4lx\n\n",
              (USHORT)TrapFrame->HardwareSegSs, Special->Ldtr, Special->Tr);
#else
    PrintText("RAX: %.8lx        R8:  %.8lx        R12: %.8lx        RSI: %.8lx\n",
              TrapFrame->Rax, TrapFrame->R8, 0, TrapFrame->Rsi);
    PrintText("RBX: %.8lx        R9:  %.8lx        R13: %.8lx        RDI: %.8lx\n",
              TrapFrame->Rbx, TrapFrame->R9, 0, TrapFrame->Rdi);
    PrintText("RCX: %.8lx        R10: %.8lx        R14: %.8lx        RBP: %.8lx\n",
              TrapFrame->Rcx, TrapFrame->R10, 0, TrapFrame->Rbp);
    PrintText("RDX: %.8lx        R11: %.8lx        R15: %.8lx        RSP: %.8lx\n",
              TrapFrame->Rdx, TrapFrame->R11, 0, TrapFrame->Rsp);
 
    PrintText(" CS: %.4lx            RIP: %.8lx\n",
              TrapFrame->SegCs, TrapFrame->Rip);
    PrintText(" DS: %.4lx     ERROR CODE: %.8lx\n",
              TrapFrame->SegDs, TrapFrame->ErrorCode);
    PrintText(" ES: %.4lx         EFLAGS: %.8lx\n",
              TrapFrame->SegEs, TrapFrame->EFlags);
    PrintText(" FS: %.4lx      GDTR Base: %.8lx Limit: %.4x\n",
              TrapFrame->SegFs, Special->Gdtr.Base, Special->Gdtr.Limit);
    PrintText(" GS: %.4lx      IDTR Base: %.8lx Limit: %.4x\n",
              TrapFrame->SegGs, Special->Idtr.Base, Special->Idtr.Limit);
    PrintText(" SS: %.4lx           LDTR: %.4lx TR: %.4lx\n\n",
              TrapFrame->SegSs, Special->Ldtr, Special->Tr);
#endif
 
    /* Display the stack frames */
    i386PrintFrames(TrapFrame);
 
#ifdef _M_IX86
    InstructionPointer = (PUCHAR)TrapFrame->Eip;
#else
    InstructionPointer = (PUCHAR)TrapFrame->Rip;
#endif
    /* Adjust IP for #BP (INT 03) or #OF to point to the offending instruction */
    if ((TrapIndex == 3) || (TrapIndex == 4))
        InstructionPointer--;
 
    PrintText("\nInstruction stream: %.2x %.2x %.2x %.2x %.2x %.2x %.2x %.2x\n",
              InstructionPointer[0], InstructionPointer[1],
              InstructionPointer[2], InstructionPointer[3],
              InstructionPointer[4], InstructionPointer[5],
              InstructionPointer[6], InstructionPointer[7]);
}

i386PrintFrames()

static void i386PrintFrames ( PKTRAP_FRAME  TrapFrame )

static

Definition at line 89 of file i386bug.c.

{
    FRAME* Frame;
 
    PrintText("Frames:\n");
    for (Frame =
#ifdef _M_IX86
            (FRAME*)TrapFrame->Ebp;
#else
            (FRAME*)TrapFrame->TrapFrame;
#endif
         Frame != NULL && (ULONG_PTR)Frame < STACKADDR;
         Frame = Frame->Next)
    {
        PrintText("%p  ", Frame->Address);
    }
}

Referenced by i386PrintExceptionText().

i386PrintText()

static void i386PrintText ( CHAR *  pszText )

static

Definition at line 42 of file i386bug.c.

{
    ULONG Width, Unused;
 
    MachVideoGetDisplaySize(&Width, &Unused, &Unused);
 
    for (; *pszText != ANSI_NULL; ++pszText)
    {
        if (*pszText == '\n')
        {
            i386_ScreenPosX = 0;
            ++i386_ScreenPosY;
            continue;
        }
 
        MachVideoPutChar(*pszText, SCREEN_ATTR, i386_ScreenPosX, i386_ScreenPosY);
        if (++i386_ScreenPosX >= Width)
        {
            i386_ScreenPosX = 0;
            ++i386_ScreenPosY;
        }
    // FIXME: Implement vertical screen scrolling if we are at the end of the screen.
    }
}

Referenced by PrintTextV().

PrintText()

static void PrintText ( const CHAR *  Format,   ...  )

static

Definition at line 79 of file i386bug.c.

{
    va_list argptr;
 
    va_start(argptr, Format);
    PrintTextV(Format, argptr);
    va_end(argptr);
}

Referenced by FrLdrBugCheckEx(), FrLdrBugCheckWithMessage(), i386PrintExceptionText(), and i386PrintFrames().

PrintTextV()

static void PrintTextV ( const CHAR *  Format, va_list  args  )

static

Definition at line 68 of file i386bug.c.

{
    CHAR Buffer[512];
 
    _vsnprintf(Buffer, sizeof(Buffer), Format, args);
    Buffer[sizeof(Buffer) - 1] = ANSI_NULL;
 
    i386PrintText(Buffer);
}

Referenced by FrLdrBugCheckWithMessage(), and PrintText().

Variable Documentation

i386_ScreenPosX

ULONG i386_ScreenPosX = 0

static

Definition at line 38 of file i386bug.c.

Referenced by FrLdrBugCheckEx(), FrLdrBugCheckWithMessage(), i386PrintExceptionText(), and i386PrintText().

i386_ScreenPosY

ULONG i386_ScreenPosY = 0

static

Definition at line 39 of file i386bug.c.

Referenced by FrLdrBugCheckEx(), FrLdrBugCheckWithMessage(), i386PrintExceptionText(), and i386PrintText().

i386ExceptionDescriptionText

const CHAR* i386ExceptionDescriptionText[]

static

Initial value:

=
{
    "Exception 00: DIVIDE BY ZERO",
    "Exception 01: DEBUG EXCEPTION",
    "Exception 02: NON-MASKABLE INTERRUPT EXCEPTION",
    "Exception 03: BREAKPOINT (INT 3)",
    "Exception 04: OVERFLOW",
    "Exception 05: BOUND EXCEPTION",
    "Exception 06: INVALID OPCODE",
    "Exception 07: FPU NOT AVAILABLE",
    "Exception 08: DOUBLE FAULT",
    "Exception 09: COPROCESSOR SEGMENT OVERRUN",
    "Exception 0A: INVALID TSS",
    "Exception 0B: SEGMENT NOT PRESENT",
    "Exception 0C: STACK EXCEPTION",
    "Exception 0D: GENERAL PROTECTION FAULT",
    "Exception 0E: PAGE FAULT",
    "Exception 0F: Reserved",
    "Exception 10: COPROCESSOR ERROR",
    "Exception 11: ALIGNMENT CHECK",
    "Exception 12: MACHINE CHECK"
}

Definition at line 12 of file i386bug.c.

Referenced by i386PrintExceptionText().