KdSystemDebugControl.c File Reference

#include <kmt_test.h>
#include <ndk/kdfuncs.h>

Include dependency graph for KdSystemDebugControl.c:

Go to the source code of this file.

Macros
#define	ok_eq_print_test(testid, value, expected, spec)    ok((value) == (expected), "In test %lu: " #value " = " spec ", expected " spec "\n", testid, value, expected)
#define	ok_eq_hex_test(testid, value, expected)    ok_eq_print_test(testid, value, expected, "0x%08lx")
#define	ok_neq_print_test(testid, value, expected, spec)    ok((value) != (expected), "In test %lu: " #value " = " spec ", expected != " spec "\n", testid, value, expected)
#define	ok_neq_hex_test(testid, value, expected)    ok_neq_print_test(testid, value, expected, "0x%08lx")

Functions
	BOOLEAN (NTAPI *pKdRefreshDebuggerNotPresent)(VOID)
	NTSTATUS (NTAPI *pKdSystemDebugControl)(_In_ SYSDBG_COMMAND Command
static NTSTATUS	TestSystemDebugControl (_In_ SYSDBG_COMMAND Command)
	START_TEST (KdSystemDebugControl)

Variables
_In_ PVOID	InputBuffer
_In_ PVOID _In_ ULONG	InputBufferLength
_In_ PVOID _In_ ULONG _Out_ PVOID	OutputBuffer
_In_ PVOID _In_ ULONG _Out_ PVOID _In_ ULONG	OutputBufferLength
_In_ PVOID _In_ ULONG _Out_ PVOID _In_ ULONG _Inout_ PULONG	ReturnLength
_In_ PVOID _In_ ULONG _Out_ PVOID _In_ ULONG _Inout_ PULONG _In_ KPROCESSOR_MODE	PreviousMode

Macro Definition Documentation

ok_eq_hex_test

#define ok_eq_hex_test	(		testid,
			value,
			expected
	)		ok_eq_print_test(testid, value, expected, "0x%08lx")

Definition at line 14 of file KdSystemDebugControl.c.

ok_eq_print_test

#define ok_eq_print_test	(		testid,
			value,
			expected,
			spec
	)		ok((value) == (expected), "In test %lu: " #value " = " spec ", expected " spec "\n", testid, value, expected)

Definition at line 11 of file KdSystemDebugControl.c.

ok_neq_hex_test

#define ok_neq_hex_test	(		testid,
			value,
			expected
	)		ok_neq_print_test(testid, value, expected, "0x%08lx")

Definition at line 20 of file KdSystemDebugControl.c.

ok_neq_print_test

#define ok_neq_print_test	(		testid,
			value,
			expected,
			spec
	)		ok((value) != (expected), "In test %lu: " #value " = " spec ", expected != " spec "\n", testid, value, expected)

Definition at line 17 of file KdSystemDebugControl.c.

Function Documentation

BOOLEAN()

BOOLEAN

(

NTAPI *

pKdRefreshDebuggerNotPresent

)

NTSTATUS()

NTSTATUS

(

NTAPI *

pKdSystemDebugControl

)

START_TEST()

START_TEST

(

KdSystemDebugControl

)

Definition at line 52 of file KdSystemDebugControl.c.

{
    NTSTATUS Status;
    ULONG Command;
    RTL_OSVERSIONINFOEXW verInfo;
    UNICODE_STRING fnName;
    BOOLEAN IsNT52SP1OrHigher;
    BOOLEAN IsVistaOrHigher;
    BOOLEAN IsDebuggerActive;
 
    /* Test for OS version: KdSystemDebugControl()
     * exists only on NT 5.2 SP1 and higher */
    verInfo.dwOSVersionInfoSize = sizeof(verInfo);
    Status = RtlGetVersion((PRTL_OSVERSIONINFOW)&verInfo);
    if (skip(NT_SUCCESS(Status), "RtlGetVersion() returned 0x%08lx\n", Status))
        return;
 
    // IsWindowsVersionOrGreater(5, 2, 1);
    IsNT52SP1OrHigher =
        (verInfo.dwMajorVersion > 5) ||
        (verInfo.dwMajorVersion == 5 && verInfo.dwMinorVersion > 2) ||
        (verInfo.dwMajorVersion == 5 && verInfo.dwMinorVersion == 2 && verInfo.wServicePackMajor >= 1);
 
    if (skip(IsNT52SP1OrHigher, "KdSystemDebugControl() only exists on NT 5.2 SP1 and higher\n"))
        return;
 
    // IsWindowsVersionOrGreater(6, 0, 0);
    IsVistaOrHigher = (verInfo.dwMajorVersion >= 6);
 
 
    /* Load the Kd routines at runtime */
 
    /* Note: KdRefreshDebuggerNotPresent() is NT 5.2+ */
    RtlInitUnicodeString(&fnName, L"KdRefreshDebuggerNotPresent");
    pKdRefreshDebuggerNotPresent = MmGetSystemRoutineAddress(&fnName);
    ok(!!pKdRefreshDebuggerNotPresent,
       "KdRefreshDebuggerNotPresent() unavailable but OS is NT 5.2 SP1 or higher?\n");
 
    RtlInitUnicodeString(&fnName, L"KdSystemDebugControl");
    pKdSystemDebugControl = MmGetSystemRoutineAddress(&fnName);
    if (skip(!!pKdSystemDebugControl, "KdSystemDebugControl() unavailable but OS is NT 5.2 SP1 or higher?\n"))
        return;
 
 
    /* Check whether the kernel debugger is present or not */
    IsDebuggerActive = (pKdRefreshDebuggerNotPresent
                     ? !pKdRefreshDebuggerNotPresent()
                     : (/*KD_DEBUGGER_ENABLED &&*/ !KD_DEBUGGER_NOT_PRESENT));
 
    trace("Debugger is %s\n", IsDebuggerActive ? "active" : "inactive");
 
    /* Unsupported commands */
    for (Command = 0; Command <= 6; ++Command)
    {
        Status = TestSystemDebugControl((SYSDBG_COMMAND)Command);
        if (!IsVistaOrHigher || IsDebuggerActive)
            ok_eq_hex_test(Command, Status, STATUS_INVALID_INFO_CLASS);
        else
            ok_eq_hex_test(Command, Status, STATUS_DEBUGGER_INACTIVE);
    }
 
    /*
     * Supported commands:
     *
     * SysDbgQueryVersion = 7,
     * SysDbgReadVirtual  = 8,
     * SysDbgWriteVirtual = 9,
     * SysDbgReadPhysical  = 10,
     * SysDbgWritePhysical = 11,
     * SysDbgReadControlSpace  = 12,
     * SysDbgWriteControlSpace = 13,
     * SysDbgReadIoSpace  = 14,
     * SysDbgWriteIoSpace = 15,
     * SysDbgReadMsr  = 16,
     * SysDbgWriteMsr = 17,
     * SysDbgReadBusData  = 18,
     * SysDbgWriteBusData = 19,
     * SysDbgCheckLowMemory = 20
     */
    for (Command = 7; Command <= 20; ++Command)
    {
        Status = TestSystemDebugControl((SYSDBG_COMMAND)Command);
        if (!IsVistaOrHigher || IsDebuggerActive)
            ok_neq_hex_test(Command, Status, STATUS_INVALID_INFO_CLASS); // Status must be != STATUS_INVALID_INFO_CLASS
        else
            ok_eq_hex_test(Command, Status, STATUS_DEBUGGER_INACTIVE);
    }
 
    /* Unsupported commands */
    for (Command = 21; Command <= 40; ++Command)
    {
        Status = TestSystemDebugControl((SYSDBG_COMMAND)Command);
        if (!IsVistaOrHigher || IsDebuggerActive)
            ok_eq_hex_test(Command, Status, STATUS_INVALID_INFO_CLASS);
        else
            ok_eq_hex_test(Command, Status, STATUS_DEBUGGER_INACTIVE);
    }
}

TestSystemDebugControl()

static NTSTATUS TestSystemDebugControl ( _In_ SYSDBG_COMMAND  Command )

static

Definition at line 40 of file KdSystemDebugControl.c.

{
    return pKdSystemDebugControl(Command,
                                 NULL, // _In_ PVOID InputBuffer,
                                 0,    // _In_ ULONG InputBufferLength,
                                 NULL, // _Out_ PVOID OutputBuffer,
                                 0,    // _In_ ULONG OutputBufferLength,
                                 NULL,
                                 KernelMode);
}

Referenced by START_TEST().

Variable Documentation

InputBuffer

_In_ PVOID InputBuffer

Definition at line 30 of file KdSystemDebugControl.c.

InputBufferLength

_In_ PVOID _In_ ULONG InputBufferLength

Definition at line 31 of file KdSystemDebugControl.c.

OutputBuffer

_In_ PVOID _In_ ULONG _Out_ PVOID OutputBuffer

Definition at line 32 of file KdSystemDebugControl.c.

OutputBufferLength

_In_ PVOID _In_ ULONG _Out_ PVOID _In_ ULONG OutputBufferLength

Definition at line 33 of file KdSystemDebugControl.c.

PreviousMode

_In_ PVOID _In_ ULONG _Out_ PVOID _In_ ULONG _Inout_ PULONG _In_ KPROCESSOR_MODE PreviousMode

Definition at line 35 of file KdSystemDebugControl.c.

Referenced by _IRQL_requires_max_(), DbgkOpenProcessDebugPort(), DefaultQueryInfoBufferCheck(), DefaultSetInfoBufferCheck(), ExpRaiseHardError(), IopCheckBackupRestorePrivilege(), IopDeviceFsIoControl(), IopFinalizeAsynchronousIo(), IopPerformSynchronousRequest(), IopQueryName(), IopQueryNameInternal(), IopUnloadDriver(), KdbEnterDebuggerException(), KdpCommandString(), KdpPrint(), KdpPrintFromUser(), KdpPrompt(), KdpStub(), KdpSymbol(), KdpTrap(), KdSystemDebugControl(), KeContextToTrapFrame(), KeFlushQueueApc(), KiApcInterrupt(), KiContinue(), KiDispatchException(), KiRaiseException(), KiSoftwareInterruptHandler(), LpcpCopyRequestData(), LpcpCreatePort(), LpcRequestPort(), LpcRequestWaitReplyPort(), MiAccessCheck(), MiDoMappedCopy(), MiDoPoolCopy(), MiQueryMemoryBasicInformation(), MiQueryMemorySectionName(), MmCopyVirtualMemory(), MmCreateArm3Section(), NpCreateClientEnd(), NpCreateExistingNamedPipe(), NtAcceptConnectPort(), NtAddAtom(), NtAdjustGroupsToken(), NtAdjustPrivilegesToken(), NtAlertResumeThread(), NtAlertThread(), NtAllocateLocallyUniqueId(), NtAllocateUuids(), NtAllocateVirtualMemory(), NtAssignProcessToJobObject(), NtCancelIoFile(), NtCancelTimer(), NtCloseObjectAuditAlarm(), NtCompareTokens(), NtCompleteConnectPort(), NtCreateDebugObject(), NtCreateDirectoryObject(), NtCreateEvent(), NtCreateEventPair(), NtCreateIoCompletion(), NtCreateJobObject(), NtCreateKey(), NtCreateMutant(), NtCreatePagingFile(), NtCreateProcessEx(), NtCreateProfile(), NtCreateSection(), NtCreateSemaphore(), NtCreateSymbolicLinkObject(), NtCreateTimer(), NtCreateToken(), NtDebugActiveProcess(), NtDebugContinue(), NtDelayExecution(), NtDeleteValueKey(), NtDisplayString(), NtDuplicateObject(), NtDuplicateToken(), NtEnumerateKey(), NtEnumerateValueKey(), NtExtendSection(), NtFilterToken(), NtFindAtom(), NtFlushBuffersFile(), NtFlushVirtualMemory(), NtFreeVirtualMemory(), NtGetContextThread(), NtGetWriteWatch(), NtImpersonateAnonymousToken(), NtImpersonateClientOfPort(), NtImpersonateThread(), NtIsProcessInJob(), NtLoadDriver(), NtLoadKeyEx(), NtLockFile(), NtLockProductActivationKeys(), NtLockVirtualMemory(), NtMakePermanentObject(), NtMapViewOfSection(), NtNotifyChangeDirectoryFile(), NtOpenDirectoryObject(), NtOpenEvent(), NtOpenEventPair(), NtOpenIoCompletion(), NtOpenJobObject(), NtOpenKey(), NtOpenMutant(), NtOpenProcess(), NtOpenProcessTokenEx(), NtOpenSection(), NtOpenSemaphore(), NtOpenSymbolicLinkObject(), NtOpenThread(), NtOpenThreadTokenEx(), NtOpenTimer(), NtPowerInformation(), NtPrivilegeCheck(), NtPrivilegedServiceAuditAlarm(), NtProtectVirtualMemory(), NtPulseEvent(), NtQueryDirectoryFile(), NtQueryDirectoryObject(), NtQueryEvent(), NtQueryInformationAtom(), NtQueryInformationFile(), NtQueryInformationJobObject(), NtQueryInformationProcess(), NtQueryInformationThread(), NtQueryInformationToken(), NtQueryIntervalProfile(), NtQueryIoCompletion(), NtQueryKey(), NtQueryMutant(), NtQueryObject(), NtQueryOpenSubKeys(), NtQueryPerformanceCounter(), NtQuerySection(), NtQuerySecurityObject(), NtQuerySemaphore(), NtQuerySymbolicLinkObject(), NtQuerySystemEnvironmentValue(), NtQuerySystemInformation(), NtQuerySystemTime(), NtQueryTimer(), NtQueryTimerResolution(), NtQueryValueKey(), NtQueryVirtualMemory(), NtQueryVolumeInformationFile(), NtRaiseHardError(), NtReadFile(), NtReadVirtualMemory(), NtReleaseMutant(), NtReleaseSemaphore(), NtRemoveIoCompletion(), NtRemoveProcessDebug(), NtReplyPort(), NtReplyWaitReceivePortEx(), NtRequestPort(), NtRequestWaitReplyPort(), NtResetEvent(), NtResetWriteWatch(), NtResumeProcess(), NtResumeThread(), NtSaveKeyEx(), NtSaveMergedKeys(), NtSecureConnectPort(), NtSetContextThread(), NtSetDefaultHardErrorPort(), NtSetEvent(), NtSetHighEventPair(), NtSetHighWaitLowEventPair(), NtSetInformationDebugObject(), NtSetInformationFile(), NtSetInformationJobObject(), NtSetInformationObject(), NtSetInformationProcess(), NtSetInformationThread(), NtSetInformationToken(), NtSetLowEventPair(), NtSetLowWaitHighEventPair(), NtSetSecurityObject(), NtSetSystemEnvironmentValue(), NtSetSystemInformation(), NtSetSystemPowerState(), NtSetSystemTime(), NtSetThreadExecutionState(), NtSetTimer(), NtSetTimerResolution(), NtSetValueKey(), NtSetVolumeInformationFile(), NtSignalAndWaitForSingleObject(), NtStartProfile(), NtStopProfile(), NtSuspendProcess(), NtSuspendThread(), NtSystemDebugControl(), NtTerminateJobObject(), NtUnloadKey2(), NtUnlockFile(), NtUnlockVirtualMemory(), NtUnmapViewOfSection(), NtWaitForDebugEvent(), NtWaitForMultipleObjects(), NtWaitForSingleObject(), NtWaitHighEventPair(), NtWaitLowEventPair(), NtWriteFile(), NtWriteVirtualMemory(), ObDuplicateObject(), ObInsertObject(), ObpAllocateObject(), ObpValidateAttributes(), ObSetHandleAttributes(), OpenRemoteDatabase(), PsGetContextThread(), PspCreateProcess(), PspCreateThread(), PspSetPrimaryToken(), PspSetQuotaLimits(), PsSetContextThread(), QSI_DEF(), SeCaptureLuidAndAttributesArray(), SeCaptureObjectTypeList(), SeCaptureSidAndAttributesArray(), SeCheckAuditPrivilege(), SeCheckPrivilegedObject(), SeCopyClientToken(), SepAccessCheck(), SepCreateToken(), SepDuplicateToken(), SepImpersonateAnonymousToken(), SepOpenThreadToken(), SepPerformTokenFiltering(), SepPrivilegeCheck(), SePrivilegeCheck(), SePrivilegePolicyCheck(), SepSinglePrivilegeCheck(), SeReleaseLuidAndAttributesArray(), SeReleaseObjectTypeList(), SeSinglePrivilegeCheck(), SSI_DEF(), WmipOpenGuidForEvents(), and WmipRegisterGuids().

ReturnLength

_In_ ENLISTMENT_INFORMATION_CLASS _In_ ULONG _Out_opt_ PULONG ReturnLength

Definition at line 34 of file KdSystemDebugControl.c.

Referenced by AcpiExGetProtocolBufferLength(), AdjustTokenGroups(), AdjustTokenPrivileges(), BuildDesktopNameList(), BuildWindowStationNameList(), CmpQueryKeyName(), CreateProcessAsUserCommon(), CreateRemoteThread(), DefaultQueryInfoBufferCheck(), ExGetPoolTagInfo(), ExpQueryModuleInformation(), FltpGetObjectName(), GetCallerLuid(), GetLogicalProcessorInformation(), GetLongPathNameW(), GetPrivateObjectSecurity(), GetShortPathNameW(), GetSystemDirectoryW(), GetSystemTimes(), GetSystemWindowsDirectoryW(), GetTListInfo(), GetTokenInformation(), HeapQueryInformation(), ImpersonateLoggedOnUser(), IoGetDeviceProperty(), IopParseDevice(), IopQueryName(), IopQueryNameInternal(), IoQueryFileDosDeviceName(), IsGlobalDeviceMap(), IsGlobalSymbolicLink(), KdpTrap(), KdSystemDebugControl(), KeI386VdmInitialize(), KeQueryIntervalProfile(), KiInitMachineDependent(), KsecGatherEntropyData(), ListDirectory(), LpcpCopyRequestData(), MiQueryMemoryBasicInformation(), MiQueryMemorySectionName(), MmGetFileNameForFileObject(), NtAdjustGroupsToken(), NtAdjustPrivilegesToken(), NtQueryDirectoryObject(), NtQueryEvent(), NtQueryInformationAtom(), NtQueryInformationJobObject(), NtQueryInformationProcess(), NtQueryInformationThread(), NtQueryInformationToken(), NtQuerySemaphore(), NtQuerySystemEnvironmentValue(), NtQuerySystemInformation(), NtQueryTimer(), NtQueryVirtualMemory(), NtReadRequestData(), NtSetInformationDebugObject(), NtSystemDebugControl(), NtWriteRequestData(), ObjectBasicInformationTests(), ObQueryNameString(), ObQueryTypeInfo(), PrintProcess(), PrintThreads(), PspQueryDescriptorThread(), QueryDosDeviceW(), QueryNameProc(), RawQueryFsAttributeInfo(), RtlAcquirePrivilege(), RtlAdjustPrivilege(), RtlDefaultNpAcl(), RtlFormatMessage(), RtlFormatMessageEx(), RtlGetSetBootStatusData(), RtlIsDosDeviceName_Ustr(), RtlpSysVolTakeOwnership(), RtlQueryHeapInformation(), RtlQuerySecurityObject(), RtlRemovePrivileges(), SeDefaultObjectMethod(), SeInitializeProcessAuditName(), SepCleanupLUIDDeviceMapDirectory(), SHCreateSessionKey(), START_TEST(), StorPortGetBusData(), StorPortSetBusDataByOffset(), Test_Flags(), test_GetSystemTimes(), Test_KernelDebugger(), Test_ProcessWx86Information(), test_query_basic(), test_query_cache(), test_query_cpu(), test_query_data_alignment(), test_query_handle(), test_query_handle_ex(), test_query_interrupt(), test_query_kerndebug(), test_query_module(), test_query_performance(), test_query_process(), test_query_process_basic(), test_query_process_handlecount(), test_query_process_image_file_name(), test_query_process_io(), test_query_process_priority(), test_query_process_times(), test_query_process_vm(), test_query_process_wow64(), test_query_procperf(), test_query_regquota(), test_query_timeofday(), Test_TimeAdjustment(), and VfdQueryImage().