kdmain.c File Reference

#include <ntoskrnl.h>
#include <debug.h>

Include dependency graph for kdmain.c:

Go to the source code of this file.

Classes
struct	KD_COMPONENT_DATA

Macros
#define	NDEBUG
#define	MAX_KD_COMPONENT_TABLE_ENTRIES   128

Functions
VOID NTAPI	PspDumpThreads (BOOLEAN SystemThreads)
ULONG NTAPI	KdpServiceDispatcher (ULONG Service, PVOID Buffer1, ULONG Buffer1Length, KPROCESSOR_MODE PreviousMode)
BOOLEAN NTAPI	KdpEnterDebuggerException (IN PKTRAP_FRAME TrapFrame, IN PKEXCEPTION_FRAME ExceptionFrame, IN PEXCEPTION_RECORD ExceptionRecord, IN PCONTEXT Context, IN KPROCESSOR_MODE PreviousMode, IN BOOLEAN SecondChance)
BOOLEAN NTAPI	KdIsThisAKdTrap (IN PEXCEPTION_RECORD ExceptionRecord, IN PCONTEXT Context, IN KPROCESSOR_MODE PreviousMode)
VOID NTAPI	KdUpdateDataBlock (VOID)
BOOLEAN NTAPI	KdRefreshDebuggerNotPresent (VOID)
NTSTATUS NTAPI	KdDisableDebugger (VOID)
NTSTATUS NTAPI	KdEnableDebuggerWithLock (IN BOOLEAN NeedLock)
NTSTATUS NTAPI	KdEnableDebugger (VOID)
BOOLEAN NTAPI	KdPollBreakIn (VOID)
NTSTATUS NTAPI	KdPowerTransition (ULONG PowerState)
NTSTATUS NTAPI	KdChangeOption (IN KD_OPTION Option, IN ULONG InBufferLength OPTIONAL, IN PVOID InBuffer, IN ULONG OutBufferLength OPTIONAL, OUT PVOID OutBuffer, OUT PULONG OutBufferRequiredLength OPTIONAL)
NTSTATUS NTAPI	NtQueryDebugFilterState (IN ULONG ComponentId, IN ULONG Level)
NTSTATUS NTAPI	NtSetDebugFilterState (IN ULONG ComponentId, IN ULONG Level, IN BOOLEAN State)
NTSTATUS NTAPI	KdSystemDebugControl (IN SYSDBG_COMMAND Command, IN PVOID InputBuffer, IN ULONG InputBufferLength, OUT PVOID OutputBuffer, IN ULONG OutputBufferLength, IN OUT PULONG ReturnLength, IN KPROCESSOR_MODE PreviousMode)

Variables
BOOLEAN	KdDebuggerEnabled = FALSE
BOOLEAN	KdEnteredDebugger = FALSE
BOOLEAN	KdDebuggerNotPresent = TRUE
BOOLEAN	KdBreakAfterSymbolLoad = FALSE
BOOLEAN	KdPitchDebugger = TRUE
BOOLEAN	KdIgnoreUmExceptions = FALSE
KD_CONTEXT	KdpContext
ULONG	Kd_WIN2000_Mask
LONG	KdpTimeSlipPending
KDDEBUGGER_DATA64	KdDebuggerDataBlock
KD_COMPONENT_DATA	KdpComponentTable [MAX_KD_COMPONENT_TABLE_ENTRIES]
ULONG	KdComponentTableEntries = 0
ULONG	Kd_DEFAULT_MASK = 1 << DPFLTR_ERROR_LEVEL
PKDEBUG_ROUTINE	KiDebugRoutine = KdpEnterDebuggerException

Macro Definition Documentation

MAX_KD_COMPONENT_TABLE_ENTRIES

#define MAX_KD_COMPONENT_TABLE_ENTRIES   128

Definition at line 33 of file kdmain.c.

NDEBUG

#define NDEBUG

Definition at line 11 of file kdmain.c.

Function Documentation

KdChangeOption()

NTSTATUS NTAPI KdChangeOption	(	IN KD_OPTION	Option,
		IN ULONG InBufferLength	OPTIONAL,
		IN PVOID	InBuffer,
		IN ULONG OutBufferLength	OPTIONAL,
		OUT PVOID	OutBuffer,
		OUT PULONG OutBufferRequiredLength	OPTIONAL
	)

Definition at line 373 of file kdmain.c.

{
    UNIMPLEMENTED;
    return STATUS_NOT_IMPLEMENTED;
}

KdDisableDebugger()

NTSTATUS NTAPI KdDisableDebugger

(

VOID

)

Definition at line 295 of file kdmain.c.

{
    KIRQL OldIrql;

    /* Raise IRQL */
    KeRaiseIrql(DISPATCH_LEVEL, &OldIrql);

    /* TODO: Disable any breakpoints */

    /* Disable the Debugger */
    KdDebuggerEnabled = FALSE;
    SharedUserData->KdDebuggerEnabled = FALSE;

    /* Lower the IRQL */
    KeLowerIrql(OldIrql);

    /* Return success */
    return STATUS_SUCCESS;
}

Referenced by PcipGetFunctionLimits().

KdEnableDebugger()

NTSTATUS NTAPI KdEnableDebugger

(

VOID

)

Definition at line 327 of file kdmain.c.

{
    KIRQL OldIrql;

    /* Raise IRQL */
    KeRaiseIrql(DISPATCH_LEVEL, &OldIrql);

    /* TODO: Re-enable any breakpoints */

    /* Enable the Debugger */
    KdDebuggerEnabled = TRUE;
    SharedUserData->KdDebuggerEnabled = TRUE;

    /* Lower the IRQL */
    KeLowerIrql(OldIrql);

    /* Return success */
    return STATUS_SUCCESS;
}

Referenced by KdpStub(), and PcipGetFunctionLimits().

KdEnableDebuggerWithLock()

NTSTATUS NTAPI KdEnableDebuggerWithLock

(

IN BOOLEAN

NeedLock

)

Definition at line 317 of file kdmain.c.

{
    return STATUS_ACCESS_DENIED;
}

KdIsThisAKdTrap()

BOOLEAN NTAPI KdIsThisAKdTrap	(	IN PEXCEPTION_RECORD	ExceptionRecord,
		IN PCONTEXT	Context,
		IN KPROCESSOR_MODE	PreviousMode
	)

Definition at line 261 of file kdmain.c.

{
    /* KDBG has its own mechanism for ignoring user mode exceptions */
    return FALSE;
}

KdpEnterDebuggerException()

BOOLEAN NTAPI KdpEnterDebuggerException	(	IN PKTRAP_FRAME	TrapFrame,
		IN PKEXCEPTION_FRAME	ExceptionFrame,
		IN PEXCEPTION_RECORD	ExceptionRecord,
		IN PCONTEXT	Context,
		IN KPROCESSOR_MODE	PreviousMode,
		IN BOOLEAN	SecondChance
	)

Definition at line 125 of file kdmain.c.

{
    KD_CONTINUE_TYPE Return = kdHandleException;
    ULONG ExceptionCommand = ExceptionRecord->ExceptionInformation[0];

    /* Check if this was a breakpoint due to DbgPrint or Load/UnloadSymbols */
    if ((ExceptionRecord->ExceptionCode == STATUS_BREAKPOINT) &&
        (ExceptionRecord->NumberParameters > 0) &&
        ((ExceptionCommand == BREAKPOINT_LOAD_SYMBOLS) ||
         (ExceptionCommand == BREAKPOINT_UNLOAD_SYMBOLS) ||
         (ExceptionCommand == BREAKPOINT_COMMAND_STRING) ||
         (ExceptionCommand == BREAKPOINT_PRINT) ||
         (ExceptionCommand == BREAKPOINT_PROMPT)))
    {
        /* Check if this is a debug print */
        if (ExceptionCommand == BREAKPOINT_PRINT)
        {
            /* Print the string */
            KdpServiceDispatcher(BREAKPOINT_PRINT,
                                 (PVOID)ExceptionRecord->ExceptionInformation[1],
                                 ExceptionRecord->ExceptionInformation[2],
                                 PreviousMode);

            /* Return success */
            KeSetContextReturnRegister(Context, STATUS_SUCCESS);
        }
#ifdef KDBG
        else if (ExceptionCommand == BREAKPOINT_LOAD_SYMBOLS)
        {
            PKD_SYMBOLS_INFO SymbolsInfo;
            KD_SYMBOLS_INFO CapturedSymbolsInfo;
            PLDR_DATA_TABLE_ENTRY LdrEntry;

            SymbolsInfo = (PKD_SYMBOLS_INFO)ExceptionRecord->ExceptionInformation[2];
            if (PreviousMode != KernelMode)
            {
                _SEH2_TRY
                {
                    ProbeForRead(SymbolsInfo,
                                 sizeof(*SymbolsInfo),
                                 1);
                    RtlCopyMemory(&CapturedSymbolsInfo,
                                  SymbolsInfo,
                                  sizeof(*SymbolsInfo));
                    SymbolsInfo = &CapturedSymbolsInfo;
                }
                _SEH2_EXCEPT(EXCEPTION_EXECUTE_HANDLER)
                {
                    SymbolsInfo = NULL;
                }
                _SEH2_END;
            }

            if (SymbolsInfo != NULL)
            {
                /* Load symbols. Currently implemented only for KDBG! */
                if (KdbpSymFindModule(SymbolsInfo->BaseOfDll, NULL, -1, &LdrEntry))
                {
                    KdbSymProcessSymbols(LdrEntry);
                }
            }
        }
        else if (ExceptionCommand == BREAKPOINT_PROMPT)
        {
            ULONG ReturnValue;
            LPSTR OutString;
            USHORT OutStringLength;

            /* Get the response string  and length */
            OutString = (LPSTR)Context->Ebx;
            OutStringLength = (USHORT)Context->Edi;

            /* Call KDBG */
            ReturnValue = KdpPrompt((LPSTR)ExceptionRecord->
                                    ExceptionInformation[1],
                                    (USHORT)ExceptionRecord->
                                    ExceptionInformation[2],
                                    OutString,
                                    OutStringLength,
                                    PreviousMode,
                                    TrapFrame,
                                    ExceptionFrame);

            /* Return the number of characters that we received */
            Context->Eax = ReturnValue;
        }
#endif

        /* This we can handle: simply bump the Program Counter */
        KeSetContextPc(Context, KeGetContextPc(Context) + KD_BREAKPOINT_SIZE);
        return TRUE;
    }

#ifdef KDBG
    /* Check if this is an assertion failure */
    if (ExceptionRecord->ExceptionCode == STATUS_ASSERTION_FAILURE)
    {
        /* Bump EIP to the instruction following the int 2C */
        Context->Eip += 2;
    }
#endif

    /* Get out of here if the Debugger isn't connected */
    if (KdDebuggerNotPresent) return FALSE;

#ifdef KDBG
    /* Call KDBG if available */
    Return = KdbEnterDebuggerException(ExceptionRecord,
                                       PreviousMode,
                                       Context,
                                       TrapFrame,
                                       !SecondChance);
#else /* not KDBG */
    if (WrapperInitRoutine)
    {
        /* Call GDB */
        Return = WrapperTable.KdpExceptionRoutine(ExceptionRecord,
                                                  Context,
                                                  TrapFrame);
    }
#endif /* not KDBG */

    /* Debugger didn't handle it, please handle! */
    if (Return == kdHandleException) return FALSE;

    /* Debugger handled it */
    return TRUE;
}

KdPollBreakIn()

BOOLEAN NTAPI KdPollBreakIn

(

VOID

)

Definition at line 352 of file kdmain.c.

{
    return FALSE;
}

Referenced by KdInitSystem(), KeUpdateSystemTime(), KiInitializeSystem(), KiSystemStartup(), and KiSystemStartupReal().

KdPowerTransition()

NTSTATUS NTAPI KdPowerTransition

(

ULONG

PowerState

)

Definition at line 362 of file kdmain.c.

{
    UNIMPLEMENTED;
    return STATUS_NOT_IMPLEMENTED;
}

KdpServiceDispatcher()

ULONG NTAPI KdpServiceDispatcher	(	ULONG	Service,
		PVOID	Buffer1,
		ULONG	Buffer1Length,
		KPROCESSOR_MODE	PreviousMode
	)

Definition at line 43 of file kdmain.c.

{
    ULONG Result = 0;

    switch (Service)
    {
        case BREAKPOINT_PRINT: /* DbgPrint */
            Result = KdpPrintString(Buffer1, Buffer1Length, PreviousMode);
            break;

#if DBG
        case ' soR': /* ROS-INTERNAL */
        {
            switch ((ULONG_PTR)Buffer1)
            {
                case DumpAllThreads:
                    PspDumpThreads(TRUE);
                    break;

                case DumpUserThreads:
                    PspDumpThreads(FALSE);
                    break;

                case KdSpare3:
                    MmDumpArmPfnDatabase(FALSE);
                    break;

                default:
                    break;
            }
            break;
        }

#if defined(_M_IX86) && !defined(_WINKD_) // See ke/i386/traphdlr.c
        /* Register a debug callback */
        case 'CsoR':
        {
            switch (Buffer1Length)
            {
                case ID_Win32PreServiceHook:
                    KeWin32PreServiceHook = Buffer1;
                    break;

                case ID_Win32PostServiceHook:
                    KeWin32PostServiceHook = Buffer1;
                    break;

            }
            break;
        }
#endif

        /* Special  case for stack frame dumps */
        case 'DsoR':
        {
            KeRosDumpStackFrames((PULONG)Buffer1, Buffer1Length);
            break;
        }

#if defined(KDBG)
        /* Register KDBG CLI callback */
        case 'RbdK':
        {
            Result = KdbRegisterCliCallback(Buffer1, Buffer1Length);
            break;
        }
#endif /* KDBG */
#endif /* DBG */
        default:
            DPRINT1("Invalid debug service call!\n");
            HalDisplayString("Invalid debug service call!\r\n");
            break;
    }

    return Result;
}

Referenced by KdpEnterDebuggerException(), and KdSystemDebugControl().

KdRefreshDebuggerNotPresent()

BOOLEAN NTAPI KdRefreshDebuggerNotPresent

(

VOID

)

Definition at line 282 of file kdmain.c.

{
    UNIMPLEMENTED;

    /* Just return whatever was set previously -- FIXME! */
    return KdDebuggerNotPresent;
}

KdSystemDebugControl()

NTSTATUS NTAPI KdSystemDebugControl	(	IN SYSDBG_COMMAND	Command,
		IN PVOID	InputBuffer,
		IN ULONG	InputBufferLength,
		OUT PVOID	OutputBuffer,
		IN ULONG	OutputBufferLength,
		IN OUT PULONG	ReturnLength,
		IN KPROCESSOR_MODE	PreviousMode
	)

Definition at line 474 of file kdmain.c.

{
    /* HACK */
    return KdpServiceDispatcher(Command,
                                InputBuffer,
                                InputBufferLength,
                                PreviousMode);
}

Referenced by DriverEntry(), i8042KbdInterruptService(), KdRosDumpStackFrames(), KdRosSetDebugCallback(), and NtSystemDebugControl().

KdUpdateDataBlock()

VOID NTAPI KdUpdateDataBlock

(

VOID

)

Definition at line 273 of file kdmain.c.

{
}

NtQueryDebugFilterState()

NTSTATUS NTAPI NtQueryDebugFilterState	(	IN ULONG	ComponentId,
		IN ULONG	Level
	)

Definition at line 387 of file kdmain.c.

{
    ULONG i;

    /* Convert Level to mask if it isn't already one */
    if (Level < 32)
        Level = 1 << Level;

    /* Check if it is not the default component */
    if (ComponentId != MAXULONG)
    {
        /* No, search for an existing entry in the table */
        for (i = 0; i < KdComponentTableEntries; i++)
        {
            /* Check if it is the right component */
            if (ComponentId == KdpComponentTable[i].ComponentId)
            {
                /* Check if mask are matching */
                return (Level & KdpComponentTable[i].Level) ? TRUE : FALSE;
            }
        }
    }

    /* Entry not found in the table, use default mask */
    return (Level & Kd_DEFAULT_MASK) ? TRUE : FALSE;
}

Referenced by DbgQueryDebugFilterState(), and vDbgPrintExWithPrefixInternal().

NtSetDebugFilterState()

NTSTATUS NTAPI NtSetDebugFilterState	(	IN ULONG	ComponentId,
		IN ULONG	Level,
		IN BOOLEAN	State
	)

Definition at line 417 of file kdmain.c.

{
    ULONG i;

    /* Convert Level to mask if it isn't already one */
    if (Level < 32)
        Level = 1 << Level;
    Level &= ~DPFLTR_MASK;

    /* Check if it is the default component */
    if (ComponentId == MAXULONG)
    {
        /* Yes, modify the default mask */
        if (State)
            Kd_DEFAULT_MASK |= Level;
        else
            Kd_DEFAULT_MASK &= ~Level;

        return STATUS_SUCCESS;
    }

    /* Search for an existing entry */
    for (i = 0; i < KdComponentTableEntries; i++ )
    {
        if (ComponentId == KdpComponentTable[i].ComponentId)
            break;
    }

    /* Check if we have found an existing entry */
    if (i == KdComponentTableEntries)
    {
        /* Check if we have enough space in the table */
        if (i == MAX_KD_COMPONENT_TABLE_ENTRIES)
            return STATUS_INVALID_PARAMETER_1;

        /* Add a new entry */
        ++KdComponentTableEntries;
        KdpComponentTable[i].ComponentId = ComponentId;
        KdpComponentTable[i].Level = Kd_DEFAULT_MASK;
    }

    /* Update entry table */
    if (State)
        KdpComponentTable[i].Level |= Level;
    else
        KdpComponentTable[i].Level &= ~Level;

    return STATUS_SUCCESS;
}

Referenced by DbgSetDebugFilterState(), and KdbpCmdFilter().

PspDumpThreads()

VOID NTAPI PspDumpThreads

(

BOOLEAN

SystemThreads

)

Referenced by KdpServiceDispatcher().

Variable Documentation

Kd_DEFAULT_MASK

ULONG Kd_DEFAULT_MASK = 1 << DPFLTR_ERROR_LEVEL

Definition at line 37 of file kdmain.c.

Referenced by NtQueryDebugFilterState(), and NtSetDebugFilterState().

Kd_WIN2000_Mask

ULONG Kd_WIN2000_Mask

Definition at line 23 of file kdmain.c.

KdBreakAfterSymbolLoad

BOOLEAN KdBreakAfterSymbolLoad = FALSE

Definition at line 19 of file kdmain.c.

KdComponentTableEntries

ULONG KdComponentTableEntries = 0

Definition at line 35 of file kdmain.c.

Referenced by NtQueryDebugFilterState(), and NtSetDebugFilterState().

KdDebuggerDataBlock

KDDEBUGGER_DATA64 KdDebuggerDataBlock

Definition at line 25 of file kdmain.c.

KdDebuggerEnabled

BOOLEAN KdDebuggerEnabled = FALSE

Definition at line 16 of file kdmain.c.

Referenced by KdDisableDebugger(), KdDisableDebuggerWithLock(), KdEnableDebugger(), KdInitSystem(), KdpGdbStubInit(), KdpGetDebugMode(), KdPollBreakIn(), KdpPollBreakInWithPortLock(), KdpStub(), KeBugCheckWithTf(), KeEnterKernelDebugger(), KeUpdateRunTime(), KeUpdateSystemTime(), MmLoadSystemImage(), ObpCloseHandle(), PspCatchCriticalBreak(), and PspExitThread().

KdDebuggerNotPresent

BOOLEAN KdDebuggerNotPresent = TRUE

Definition at line 18 of file kdmain.c.

Referenced by KdInitSystem(), KdpCommandString(), KdpEnterDebuggerException(), KdpGetDebugMode(), KdpPrint(), KdpSendWaitContinue(), KdpSymbol(), KdRefreshDebuggerNotPresent(), KeBugCheckWithTf(), MmLoadSystemImage(), and PspCatchCriticalBreak().

KdEnteredDebugger

BOOLEAN KdEnteredDebugger = FALSE

Definition at line 17 of file kdmain.c.

KdIgnoreUmExceptions

BOOLEAN KdIgnoreUmExceptions = FALSE

Definition at line 21 of file kdmain.c.

KdpComponentTable

KD_COMPONENT_DATA KdpComponentTable[MAX_KD_COMPONENT_TABLE_ENTRIES]

Definition at line 34 of file kdmain.c.

Referenced by NtQueryDebugFilterState(), and NtSetDebugFilterState().

KdpContext

KD_CONTEXT KdpContext

Definition at line 22 of file kdmain.c.

KdPitchDebugger

BOOLEAN KdPitchDebugger = TRUE

Definition at line 20 of file kdmain.c.

KdpTimeSlipPending

LONG KdpTimeSlipPending

Definition at line 24 of file kdmain.c.

KiDebugRoutine

PKDEBUG_ROUTINE KiDebugRoutine = KdpEnterDebuggerException

Definition at line 489 of file kdmain.c.