ReactOS 0.4.16-dev-833-g4bc97ad
Macros | Functions | Variables
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.

53{
54 NTSTATUS Status;
55 ULONG Command;
56 RTL_OSVERSIONINFOEXW verInfo;
57 UNICODE_STRING fnName;
58 BOOLEAN IsNT52SP1OrHigher;
59 BOOLEAN IsVistaOrHigher;
60 BOOLEAN IsDebuggerActive;
61
62 /* Test for OS version: KdSystemDebugControl()
63 * exists only on NT 5.2 SP1 and higher */
64 verInfo.dwOSVersionInfoSize = sizeof(verInfo);
65 Status = RtlGetVersion((PRTL_OSVERSIONINFOW)&verInfo);
66 if (skip(NT_SUCCESS(Status), "RtlGetVersion() returned 0x%08lx\n", Status))
67 return;
68
69 // IsWindowsVersionOrGreater(5, 2, 1);
70 IsNT52SP1OrHigher =
71 (verInfo.dwMajorVersion > 5) ||
72 (verInfo.dwMajorVersion == 5 && verInfo.dwMinorVersion > 2) ||
73 (verInfo.dwMajorVersion == 5 && verInfo.dwMinorVersion == 2 && verInfo.wServicePackMajor >= 1);
74
75 if (skip(IsNT52SP1OrHigher, "KdSystemDebugControl() only exists on NT 5.2 SP1 and higher\n"))
76 return;
77
78 // IsWindowsVersionOrGreater(6, 0, 0);
79 IsVistaOrHigher = (verInfo.dwMajorVersion >= 6);
80
81
82 /* Load the Kd routines at runtime */
83
84 /* Note: KdRefreshDebuggerNotPresent() is NT 5.2+ */
85 RtlInitUnicodeString(&fnName, L"KdRefreshDebuggerNotPresent");
86 pKdRefreshDebuggerNotPresent = MmGetSystemRoutineAddress(&fnName);
87 ok(!!pKdRefreshDebuggerNotPresent,
88 "KdRefreshDebuggerNotPresent() unavailable but OS is NT 5.2 SP1 or higher?\n");
89
90 RtlInitUnicodeString(&fnName, L"KdSystemDebugControl");
91 pKdSystemDebugControl = MmGetSystemRoutineAddress(&fnName);
92 if (skip(!!pKdSystemDebugControl, "KdSystemDebugControl() unavailable but OS is NT 5.2 SP1 or higher?\n"))
93 return;
94
95
96 /* Check whether the kernel debugger is present or not */
97 IsDebuggerActive = (pKdRefreshDebuggerNotPresent
98 ? !pKdRefreshDebuggerNotPresent()
99 : (/*KD_DEBUGGER_ENABLED &&*/ !KD_DEBUGGER_NOT_PRESENT));
100
101 trace("Debugger is %s\n", IsDebuggerActive ? "active" : "inactive");
102
103 /* Unsupported commands */
104 for (Command = 0; Command <= 6; ++Command)
105 {
106 Status = TestSystemDebugControl((SYSDBG_COMMAND)Command);
107 if (!IsVistaOrHigher || IsDebuggerActive)
108 ok_eq_hex_test(Command, Status, STATUS_INVALID_INFO_CLASS);
109 else
110 ok_eq_hex_test(Command, Status, STATUS_DEBUGGER_INACTIVE);
111 }
112
113 /*
114 * Supported commands:
115 *
116 * SysDbgQueryVersion = 7,
117 * SysDbgReadVirtual = 8,
118 * SysDbgWriteVirtual = 9,
119 * SysDbgReadPhysical = 10,
120 * SysDbgWritePhysical = 11,
121 * SysDbgReadControlSpace = 12,
122 * SysDbgWriteControlSpace = 13,
123 * SysDbgReadIoSpace = 14,
124 * SysDbgWriteIoSpace = 15,
125 * SysDbgReadMsr = 16,
126 * SysDbgWriteMsr = 17,
127 * SysDbgReadBusData = 18,
128 * SysDbgWriteBusData = 19,
129 * SysDbgCheckLowMemory = 20
130 */
131 for (Command = 7; Command <= 20; ++Command)
132 {
133 Status = TestSystemDebugControl((SYSDBG_COMMAND)Command);
134 if (!IsVistaOrHigher || IsDebuggerActive)
135 ok_neq_hex_test(Command, Status, STATUS_INVALID_INFO_CLASS); // Status must be != STATUS_INVALID_INFO_CLASS
136 else
137 ok_eq_hex_test(Command, Status, STATUS_DEBUGGER_INACTIVE);
138 }
139
140 /* Unsupported commands */
141 for (Command = 21; Command <= 40; ++Command)
142 {
143 Status = TestSystemDebugControl((SYSDBG_COMMAND)Command);
144 if (!IsVistaOrHigher || IsDebuggerActive)
145 ok_eq_hex_test(Command, Status, STATUS_INVALID_INFO_CLASS);
146 else
147 ok_eq_hex_test(Command, Status, STATUS_DEBUGGER_INACTIVE);
148 }
149}
ok_eq_hex_test
#define ok_eq_hex_test(testid, value, expected)
Definition: KdSystemDebugControl.c:14
TestSystemDebugControl
static NTSTATUS TestSystemDebugControl(_In_ SYSDBG_COMMAND Command)
Definition: KdSystemDebugControl.c:40
ok_neq_hex_test
#define ok_neq_hex_test(testid, value, expected)
Definition: KdSystemDebugControl.c:20
BOOLEAN
unsigned char BOOLEAN
Definition: ProcessorBind.h:185
trace
#define trace
Definition: atltest.h:70
ok
#define ok(value,...)
Definition: atltest.h:57
skip
#define skip(...)
Definition: atltest.h:64
NTSTATUS
LONG NTSTATUS
Definition: precomp.h:26
NT_SUCCESS
#define NT_SUCCESS(StatCode)
Definition: apphelp.c:33
RtlGetVersion
NTSTATUS NTAPI RtlGetVersion(IN OUT PRTL_OSVERSIONINFOW lpVersionInformation)
Definition: version.c:182
Status
Status
Definition: gdiplustypes.h:25
STATUS_DEBUGGER_INACTIVE
#define STATUS_DEBUGGER_INACTIVE
Definition: debugger.c:30
SYSDBG_COMMAND
enum _SYSDBG_COMMAND SYSDBG_COMMAND
RtlInitUnicodeString
NTSYSAPI VOID NTAPI RtlInitUnicodeString(PUNICODE_STRING DestinationString, PCWSTR SourceString)
STATUS_INVALID_INFO_CLASS
#define STATUS_INVALID_INFO_CLASS
Definition: ntstatus.h:240
L
#define L(x)
Definition: ntvdm.h:50
Command
Definition: shell.h:41
_OSVERSIONINFOEXW
Definition: rtltypes.h:268
_OSVERSIONINFOEXW::dwMajorVersion
ULONG dwMajorVersion
Definition: rtltypes.h:270
_OSVERSIONINFOEXW::dwMinorVersion
ULONG dwMinorVersion
Definition: rtltypes.h:271
_OSVERSIONINFOEXW::dwOSVersionInfoSize
ULONG dwOSVersionInfoSize
Definition: rtltypes.h:269
_OSVERSIONINFOEXW::wServicePackMajor
USHORT wServicePackMajor
Definition: rtltypes.h:275
_OSVERSIONINFOW
Definition: rtltypes.h:245
_UNICODE_STRING
Definition: env_spec_w32.h:368
MmGetSystemRoutineAddress
PVOID NTAPI MmGetSystemRoutineAddress(IN PUNICODE_STRING SystemRoutineName)
Definition: sysldr.c:3615
ULONG
uint32_t ULONG
Definition: typedefs.h:59
KD_DEBUGGER_NOT_PRESENT
#define KD_DEBUGGER_NOT_PRESENT
Definition: kdfuncs.h:133

◆ TestSystemDebugControl()

static NTSTATUS TestSystemDebugControl ( _In_ SYSDBG_COMMAND  Command)
static

Definition at line 40 of file KdSystemDebugControl.c.

42{
43 return pKdSystemDebugControl(Command,
44 NULL, // _In_ PVOID InputBuffer,
45 0, // _In_ ULONG InputBufferLength,
46 NULL, // _Out_ PVOID OutputBuffer,
47 0, // _In_ ULONG OutputBufferLength,
48 NULL,
49 KernelMode);
50}
NULL
#define NULL
Definition: types.h:112
KernelMode
#define KernelMode
Definition: asm.h:38

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().