kdbg.c File Reference

#include <ntoskrnl.h>
#include "kdb.h"

Include dependency graph for kdbg.c:

Go to the source code of this file.

Macros
#define	pKdD0Transition   KdD0Transition
#define	pKdD3Transition   KdD3Transition
#define	pKdSave   KdSave
#define	pKdRestore   KdRestore
#define	pKdSendPacket   KdSendPacket
#define	pKdReceivePacket   KdReceivePacket

Functions
NTSTATUS NTAPI	KdD0Transition (VOID)
NTSTATUS NTAPI	KdD3Transition (VOID)
NTSTATUS NTAPI	KdSave (_In_ BOOLEAN SleepTransition)
NTSTATUS NTAPI	KdRestore (_In_ BOOLEAN SleepTransition)
VOID NTAPI	KdSendPacket (_In_ ULONG PacketType, _In_ PSTRING MessageHeader, _In_opt_ PSTRING MessageData, _Inout_ PKD_CONTEXT Context)
KDSTATUS NTAPI	KdReceivePacket (_In_ ULONG PacketType, _Out_ PSTRING MessageHeader, _Out_ PSTRING MessageData, _Out_ PULONG DataLength, _Inout_ PKD_CONTEXT Context)

Variables
static ULONG	KdbgNextApiNumber = DbgKdContinueApi
static CONTEXT	KdbgContext
static EXCEPTION_RECORD64	KdbgExceptionRecord
static BOOLEAN	KdbgFirstChanceException
static NTSTATUS	KdbgContinueStatus = STATUS_SUCCESS

Macro Definition Documentation

pKdD0Transition

#define pKdD0Transition   KdD0Transition

pKdD3Transition

#define pKdD3Transition   KdD3Transition

pKdReceivePacket

#define pKdReceivePacket   KdReceivePacket

pKdRestore

#define pKdRestore   KdRestore

pKdSave

#define pKdSave   KdSave

pKdSendPacket

#define pKdSendPacket   KdSendPacket

Function Documentation

KdD0Transition()

NTSTATUS NTAPI KdD0Transition

(

VOID

)

Definition at line 27 of file kdbg.c.

{
    /* Call KdTerm */
    return pKdD0Transition();
}

KdD3Transition()

NTSTATUS NTAPI KdD3Transition

(

VOID

)

Definition at line 37 of file kdbg.c.

{
    /* Call KdTerm */
    return pKdD3Transition();
}

KdReceivePacket()

KDSTATUS NTAPI KdReceivePacket	(	_In_ ULONG	PacketType,
		_Out_ PSTRING	MessageHeader,
		_Out_ PSTRING	MessageData,
		_Out_ PULONG	DataLength,
		_Inout_ PKD_CONTEXT	Context
	)

Definition at line 149 of file kdbg.c.

{
    if (PacketType == PACKET_TYPE_KD_POLL_BREAKIN)
    {
        // FIXME TODO: Implement break-in for the debugger
        // and return KdPacketReceived when handled properly.
        return KdPacketTimedOut;
    }
 
    if (PacketType == PACKET_TYPE_KD_DEBUG_IO)
    {
        /* Call KdTerm */
        return pKdReceivePacket(PacketType,
                                MessageHeader,
                                MessageData,
                                DataLength,
                                Context);
    }
 
    /* Debugger-only packets */
    if (PacketType == PACKET_TYPE_KD_STATE_MANIPULATE)
    {
        PDBGKD_MANIPULATE_STATE64 ManipulateState = (PDBGKD_MANIPULATE_STATE64)MessageHeader->Buffer;
        RtlZeroMemory(MessageHeader->Buffer, MessageHeader->MaximumLength);
        if (KdbgNextApiNumber == DbgKdGetContextApi)
        {
            ManipulateState->ApiNumber = DbgKdGetContextApi;
            MessageData->Length = 0;
            MessageData->Buffer = (PCHAR)&KdbgContext;
            return KdPacketReceived;
        }
        else if (KdbgNextApiNumber == DbgKdSetContextApi)
        {
            ManipulateState->ApiNumber = DbgKdSetContextApi;
            MessageData->Length = sizeof(KdbgContext);
            MessageData->Buffer = (PCHAR)&KdbgContext;
            return KdPacketReceived;
        }
        else if (KdbgNextApiNumber != DbgKdContinueApi)
        {
            KdbPrintf("%s:%d is UNIMPLEMENTED\n", __FUNCTION__, __LINE__);
        }
        ManipulateState->ApiNumber = DbgKdContinueApi;
        ManipulateState->u.Continue.ContinueStatus = KdbgContinueStatus;
 
        /* Prepare for next time */
        KdbgNextApiNumber = DbgKdContinueApi;
        KdbgContinueStatus = STATUS_SUCCESS;
 
        return KdPacketReceived;
    }
 
    KdbPrintf("%s: PacketType %d is UNIMPLEMENTED\n", __FUNCTION__, PacketType);
    return KdPacketTimedOut;
}

KdRestore()

NTSTATUS NTAPI KdRestore

(

_In_ BOOLEAN

SleepTransition

)

Definition at line 58 of file kdbg.c.

{
    /* Call KdTerm */
    return pKdRestore(SleepTransition);
}

KdSave()

NTSTATUS NTAPI KdSave

(

_In_ BOOLEAN

SleepTransition

)

Definition at line 47 of file kdbg.c.

{
    /* Call KdTerm */
    return pKdSave(SleepTransition);
}

KdSendPacket()

VOID NTAPI KdSendPacket	(	_In_ ULONG	PacketType,
		_In_ PSTRING	MessageHeader,
		_In_opt_ PSTRING	MessageData,
		_Inout_ PKD_CONTEXT	Context
	)

Definition at line 69 of file kdbg.c.

{
    if (PacketType == PACKET_TYPE_KD_DEBUG_IO)
    {
        /* Call KdTerm */
        pKdSendPacket(PacketType, MessageHeader, MessageData, Context);
        return;
    }
 
    /* Debugger-only packets */
    if (PacketType == PACKET_TYPE_KD_STATE_CHANGE64)
    {
        PDBGKD_ANY_WAIT_STATE_CHANGE WaitStateChange = (PDBGKD_ANY_WAIT_STATE_CHANGE)MessageHeader->Buffer;
        if (WaitStateChange->NewState == DbgKdLoadSymbolsStateChange)
        {
            /* Load or unload symbols */
            PLDR_DATA_TABLE_ENTRY LdrEntry;
            if (KdbpSymFindModule((PVOID)(ULONG_PTR)WaitStateChange->u.LoadSymbols.BaseOfDll, -1, &LdrEntry))
            {
                KdbSymProcessSymbols(LdrEntry, !WaitStateChange->u.LoadSymbols.UnloadSymbols);
            }
            return;
        }
        else if (WaitStateChange->NewState == DbgKdExceptionStateChange)
        {
            KdbgNextApiNumber = DbgKdGetContextApi;
            KdbgExceptionRecord = WaitStateChange->u.Exception.ExceptionRecord;
            KdbgFirstChanceException = WaitStateChange->u.Exception.FirstChance;
            return;
        }
    }
    else if (PacketType == PACKET_TYPE_KD_STATE_MANIPULATE)
    {
        PDBGKD_MANIPULATE_STATE64 ManipulateState = (PDBGKD_MANIPULATE_STATE64)MessageHeader->Buffer;
        if (ManipulateState->ApiNumber == DbgKdGetContextApi)
        {
            KD_CONTINUE_TYPE Result;
 
            /* Check if this is an assertion failure */
            if (KdbgExceptionRecord.ExceptionCode == STATUS_ASSERTION_FAILURE)
            {
                /* Bump EIP to the instruction following the int 2C */
                KeSetContextPc(&KdbgContext, KeGetContextPc(&KdbgContext) + 2);
            }
 
            Result = KdbEnterDebuggerException(&KdbgExceptionRecord,
                                               KdbgContext.SegCs & 1,
                                               &KdbgContext,
                                               KdbgFirstChanceException);
#if 0
            /* Manually dump the stack for the user */
            KeRosDumpStackFrames(NULL, 0);
            Result = kdHandleException;
#endif
            if (Result != kdHandleException)
                KdbgContinueStatus = STATUS_SUCCESS;
            else
                KdbgContinueStatus = STATUS_UNSUCCESSFUL;
            KdbgNextApiNumber = DbgKdSetContextApi;
            return;
        }
        else if (ManipulateState->ApiNumber == DbgKdSetContextApi)
        {
            KdbgNextApiNumber = DbgKdContinueApi;
            return;
        }
    }
 
    KdbPrintf("%s: PacketType %d is UNIMPLEMENTED\n", __FUNCTION__, PacketType);
    return;
}

Variable Documentation

KdbgContext

CONTEXT KdbgContext

static

Definition at line 18 of file kdbg.c.

Referenced by KdReceivePacket(), and KdSendPacket().

KdbgContinueStatus

NTSTATUS KdbgContinueStatus = STATUS_SUCCESS

static

Definition at line 21 of file kdbg.c.

Referenced by KdReceivePacket(), and KdSendPacket().

KdbgExceptionRecord

EXCEPTION_RECORD64 KdbgExceptionRecord

static

Definition at line 19 of file kdbg.c.

Referenced by KdSendPacket().

KdbgFirstChanceException

BOOLEAN KdbgFirstChanceException

static

Definition at line 20 of file kdbg.c.

Referenced by KdSendPacket().

KdbgNextApiNumber

ULONG KdbgNextApiNumber = DbgKdContinueApi

static

Definition at line 17 of file kdbg.c.

Referenced by KdReceivePacket(), and KdSendPacket().