dbgctrl.c File Reference

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

Include dependency graph for dbgctrl.c:

Go to the source code of this file.

Macros
#define	NDEBUG

Functions
VOID NTAPI	ExpDebuggerWorker (IN PVOID Context)
NTSTATUS NTAPI	NtSystemDebugControl (SYSDBG_COMMAND ControlCode, PVOID InputBuffer, ULONG InputBufferLength, PVOID OutputBuffer, ULONG OutputBufferLength, PULONG ReturnLength)

Variables
WORK_QUEUE_ITEM	ExpDebuggerWorkItem
WINKD_WORKER_STATE	ExpDebuggerWork
PEPROCESS	ExpDebuggerProcessAttach
PEPROCESS	ExpDebuggerProcessKill
ULONG_PTR	ExpDebuggerPageIn

Macro Definition Documentation

NDEBUG

#define NDEBUG

Definition at line 12 of file dbgctrl.c.

Function Documentation

ExpDebuggerWorker()

VOID NTAPI ExpDebuggerWorker

(

IN PVOID

Context

)

Definition at line 52 of file dbgctrl.c.

{
    PEPROCESS ProcessToAttach, ProcessToKill;
    ULONG_PTR PageInAddress;
    PEPROCESS Process;
    KAPC_STATE ApcState;
 
    UNREFERENCED_PARAMETER(Context);
 
    /* Be sure we were started in an initialized state */
    ASSERTMSG("ExpDebuggerWorker being entered in non-initialized state!\n",
              ExpDebuggerWork == WinKdWorkerInitialized);
    if (ExpDebuggerWork != WinKdWorkerInitialized)
    {
        /* An error happened, so get a chance to restart proper */
        ExpDebuggerWork = WinKdWorkerReady;
        return;
    }
 
    /* Get the processes to be attached or killed, and the address to page in */
    ProcessToAttach = ExpDebuggerProcessAttach;
    ProcessToKill   = ExpDebuggerProcessKill;
    PageInAddress   = ExpDebuggerPageIn;
 
    /* Reset the state machine to its ready state */
    ExpDebuggerProcessAttach = NULL;
    ExpDebuggerProcessKill   = NULL;
    ExpDebuggerPageIn = (ULONG_PTR)NULL;
    ExpDebuggerWork = WinKdWorkerReady;
 
    /* Default to the current process if we don't find the process to be attached or killed */
    Process = NULL;
 
    /* Check if we need to attach or kill some process */
    if (ProcessToAttach != NULL || ProcessToKill != NULL)
    {
        /* Find the process in the list */
        Process = PsGetNextProcess(Process);
        while (Process)
        {
            /* Is this the process we want to attach to? */
            if (Process == ProcessToAttach)
            {
                /* Yes, attach ourselves to it */
                KeStackAttachProcess(&Process->Pcb, &ApcState);
                break;
            }
            /* Or is this the process we want to kill? */
            else if (Process == ProcessToKill)
            {
                /* Yes, kill and dereference it, then return */
                PsTerminateProcess(Process, DBG_TERMINATE_PROCESS);
                ObDereferenceObject(Process);
                return;
            }
 
            /* Get the next process */
            Process = PsGetNextProcess(Process);
        }
 
        /* We either have found a process, or we default to the current process */
    }
 
    /* If we have an address to page in... */
    if (PageInAddress)
    {
        /* ... try to do it by attempting to read at this address */
        _SEH2_TRY
        {
            ProbeForReadUchar(PageInAddress);
        }
        _SEH2_EXCEPT(EXCEPTION_EXECUTE_HANDLER)
        {
            DPRINT1("Failed to page in address 0x%p, Status 0x%08lx\n", PageInAddress, _SEH2_GetExceptionCode());
        }
        _SEH2_END;
    }
 
    /* Break into the process (or the current one if Process == NULL) */
    DbgBreakPointWithStatus(DBG_STATUS_WORKER);
 
    /* If we are attached to a process, not the current one... */
    if (Process)
    {
        /* ... we can detach from the process */
        KeUnstackDetachProcess(&ApcState);
        /* Dereference the process which was referenced for us by PsGetNextProcess */
        ObDereferenceObject(Process);
    }
}

Referenced by ExpWorkerThreadBalanceManager().

NtSystemDebugControl()

NTSTATUS NTAPI NtSystemDebugControl	(	SYSDBG_COMMAND	ControlCode,
		PVOID	InputBuffer,
		ULONG	InputBufferLength,
		PVOID	OutputBuffer,
		ULONG	OutputBufferLength,
		PULONG	ReturnLength
	)

Definition at line 182 of file dbgctrl.c.

{
    switch (ControlCode)
    {
        case SysDbgQueryModuleInformation:
        case SysDbgQueryTraceInformation:
        case SysDbgSetTracepoint:
        case SysDbgSetSpecialCall:
        case SysDbgClearSpecialCalls:
        case SysDbgQuerySpecialCalls:
        case SysDbgQueryVersion:
        case SysDbgReadVirtual:
        case SysDbgWriteVirtual:
        case SysDbgReadPhysical:
        case SysDbgWritePhysical:
        case SysDbgReadControlSpace:
        case SysDbgWriteControlSpace:
        case SysDbgReadIoSpace:
        case SysDbgWriteIoSpace:
        case SysDbgReadMsr:
        case SysDbgWriteMsr:
        case SysDbgReadBusData:
        case SysDbgWriteBusData:
        case SysDbgCheckLowMemory:
        case SysDbgGetTriageDump:
            return STATUS_NOT_IMPLEMENTED;
        case SysDbgBreakPoint:
        case SysDbgEnableKernelDebugger:
        case SysDbgDisableKernelDebugger:
        case SysDbgGetAutoKdEnable:
        case SysDbgSetAutoKdEnable:
        case SysDbgGetPrintBufferSize:
        case SysDbgSetPrintBufferSize:
        case SysDbgGetKdUmExceptionEnable:
        case SysDbgSetKdUmExceptionEnable:
        case SysDbgGetKdBlockEnable:
        case SysDbgSetKdBlockEnable:
            return KdSystemDebugControl(
                ControlCode,
                InputBuffer, InputBufferLength,
                OutputBuffer, OutputBufferLength,
                ReturnLength, KeGetPreviousMode());
        default:
            return STATUS_INVALID_INFO_CLASS;
    }
}

Variable Documentation

ExpDebuggerPageIn

ULONG_PTR ExpDebuggerPageIn

Definition at line 28 of file dbgctrl.c.

Referenced by ExpDebuggerWorker().

ExpDebuggerProcessAttach

PEPROCESS ExpDebuggerProcessAttach

Definition at line 26 of file dbgctrl.c.

Referenced by ExpDebuggerWorker().

ExpDebuggerProcessKill

PEPROCESS ExpDebuggerProcessKill

Definition at line 27 of file dbgctrl.c.

Referenced by ExpDebuggerWorker().

ExpDebuggerWork

WINKD_WORKER_STATE ExpDebuggerWork

Definition at line 25 of file dbgctrl.c.

Referenced by ExpDebuggerWorker(), and ExpWorkerThreadBalanceManager().

ExpDebuggerWorkItem

WORK_QUEUE_ITEM ExpDebuggerWorkItem

Definition at line 20 of file dbgctrl.c.

Referenced by ExpWorkerThreadBalanceManager().