i386bug.c File Reference

#include <freeldr.h>
#include <reactos/buildno.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)
DECLSPEC_NORETURN VOID	FrLdrBugCheckWithMessage (ULONG BugCode, PCHAR File, ULONG Line, PSTR Format,...)
static DECLSPEC_NORETURN void	FrLdrBugCheckEx (ULONG BugCode, PCHAR File, ULONG Line)
DECLSPEC_NORETURN 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 36 of file i386bug.c.

Typedef Documentation

FRAME

typedef struct _FRAME FRAME

Function Documentation

FrLdrBugCheck()

DECLSPEC_NORETURN void NTAPI FrLdrBugCheck

(

ULONG

BugCode

)

Definition at line 267 of file i386bug.c.

{
    FrLdrBugCheckEx(BugCode, 0, 0);
}

FrLdrBugCheckEx()

static DECLSPEC_NORETURN void FrLdrBugCheckEx ( ULONG  BugCode, PCHAR  File, ULONG  Line  )

static

Definition at line 237 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()

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

Definition at line 202 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 110 of file i386bug.c.

{
    PUCHAR InstructionPointer;
 
    MachVideoHideShowTextCursor(FALSE);
    MachVideoClearScreen(SCREEN_ATTR);
    i386_ScreenPosX = 0;
    i386_ScreenPosY = 0;
 
    PrintText("FreeLdr " KERNEL_VERSION_STR " " KERNEL_VERSION_BUILD_STR "\n"
              "Report this error on the ReactOS Bug Tracker: https://jira.reactos.org\n\n"
              "0x%02lx: Exception %02X: %s\n\n",
              TrapIndex,
              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 90 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 43 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 80 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 69 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 39 of file i386bug.c.

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

i386_ScreenPosY

ULONG i386_ScreenPosY = 0

static

Definition at line 40 of file i386bug.c.

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

i386ExceptionDescriptionText

const CHAR* i386ExceptionDescriptionText[]

static

Initial value:

=
{
    "DIVIDE BY ZERO",
    "DEBUG EXCEPTION",
    "NON-MASKABLE INTERRUPT EXCEPTION",
    "BREAKPOINT (INT 3)",
    "OVERFLOW",
    "BOUND EXCEPTION",
    "INVALID OPCODE",
    "FPU NOT AVAILABLE",
    "DOUBLE FAULT",
    "COPROCESSOR SEGMENT OVERRUN",
    "INVALID TSS",
    "SEGMENT NOT PRESENT",
    "STACK EXCEPTION",
    "GENERAL PROTECTION FAULT",
    "PAGE FAULT",
    "Reserved",
    "COPROCESSOR ERROR",
    "ALIGNMENT CHECK",
    "MACHINE CHECK"
}

Definition at line 13 of file i386bug.c.

Referenced by i386PrintExceptionText().