VOID
KdPortRestore (
VOID
)
/*++
Routine Description:
This routine restores the state of the serial port after the kernel
debugger has been active.
N.B. This routine performs no function on the Jazz system.
Arguments:
None.
Return Value:
None.
--*/
{
DEBUG_PARAMETERS ComParams;
if (HalpSavedComPort != KdCurrentComPort ||
HalpSavedBaudRate != KdCurrentBaudRate) {
ComParams.CommunicationPort = HalpSavedComPort;
ComParams.BaudRate = HalpSavedBaudRate;
KdPortInitialize(&ComParams, NULL, TRUE);
}
}
BOOLEAN
KdInitSystem(
IN PLOADER_PARAMETER_BLOCK LoaderBlock OPTIONAL,
BOOLEAN StopInDebugger
)
/*++
Routine Description:
This routine initializes the portable kernel debugger.
Arguments:
LoaderBlock - Supplies a pointer to the LOADER_PARAMETER_BLOCK passed
in from the OS Loader.
StopInDebugger - Supplies a boolean value that determines whether a
debug message and breakpoint are generated.
Return Value:
None.
--*/
{
ULONG Index;
BOOLEAN Initialize;
PCHAR Options;
PCHAR BaudOption;
PCHAR PortOption;
//
// If kernel debugger is already initialized, then return.
//
if (KdDebuggerEnabled != FALSE) {
return TRUE;
}
KiDebugRoutine = KdpStub;
//
// Determine whether or not the debugger should be enabled.
//
// Note that if LoaderBlock == NULL, then KdInitSystem was called
// from BugCheck code. For this case the debugger is always enabled
// to report the bugcheck if possible.
//
if (LoaderBlock != NULL) {
KdpNtosImageBase = CONTAINING_RECORD(
(LoaderBlock->LoadOrderListHead.Flink),
LDR_DATA_TABLE_ENTRY,
InLoadOrderLinks)->DllBase;
//
// Initialize the debugger data block list when called at startup time.
//
InitializeListHead(&KdpDebuggerDataListHead);
//
// Fill in and register the debugger's debugger data block.
// Most fields are already initialized, some fields will not be
// filled in until later.
//
KdDebuggerDataBlock.KernBase = (ULONG_PTR) KdpNtosImageBase;
KdDebuggerDataBlock.KeUserCallbackDispatcher = (ULONG_PTR) KeUserCallbackDispatcher;
KdRegisterDebuggerDataBlock(KDBG_TAG,
&KdDebuggerDataBlock.Header,
sizeof(KdDebuggerDataBlock));
if (LoaderBlock->LoadOptions != NULL) {
Options = LoaderBlock->LoadOptions;
_strupr(Options);
//
// If any of the port option, baud option, or debug is specified,
// then enable the debugger unless it is explictly disabled.
//
Initialize = TRUE;
PortOption = strstr(Options, PORT_OPTION);
BaudOption = strstr(Options, BAUD_OPTION);
if ((PortOption == NULL) && (BaudOption == NULL)) {
if (strstr(Options, "DEBUG") == NULL) {
Initialize = FALSE;
}
} else {
if (PortOption) {
PortOption = strstr(PortOption, "COM");
if (PortOption) {
KdDebugParameters.CommunicationPort =
atol(PortOption + 3);
}
}
if (BaudOption) {
BaudOption += strlen(BAUD_OPTION);
while (*BaudOption == ' ') {
BaudOption++;
}
if (*BaudOption != '\0') {
KdDebugParameters.BaudRate = atol(BaudOption + 1);
}
}
}
//
// If the debugger is explicitly disabled, then set to NODEBUG.
//
if (strstr(Options, "NODEBUG")) {
Initialize = FALSE;
KdPitchDebugger = TRUE;
}
if (strstr(Options, "CRASHDEBUG")) {
Initialize = FALSE;
KdPitchDebugger = FALSE;
}
} else {
//
// If the load options are not specified, then set to NODEBUG.
//
KdPitchDebugger = TRUE;
Initialize = FALSE;
}
} else {
Initialize = TRUE;
}
if ((KdPortInitialize(&KdDebugParameters, LoaderBlock, Initialize) == FALSE) ||
(Initialize == FALSE)) {
return(TRUE);
}
//
// Set address of kernel debugger trap routine.
//
KiDebugRoutine = KdpTrap;
if (!KdpDebuggerStructuresInitialized) {
KiDebugSwitchRoutine = KdpSwitchProcessor;
KdpBreakpointInstruction = KDP_BREAKPOINT_VALUE;
KdpOweBreakpoint = FALSE;
//
// Initialize the breakpoint table.
//
for (Index = 0; Index < BREAKPOINT_TABLE_SIZE; Index += 1) {
KdpBreakpointTable[Index].Flags = 0;
KdpBreakpointTable[Index].Address = NULL;
KdpBreakpointTable[Index].DirectoryTableBase = 0L;
}
//
// Initialize TimeSlip
//
KeInitializeDpc(&KdpTimeSlipDpc, KdpTimeSlipDpcRoutine, NULL);
KeInitializeTimer(&KdpTimeSlipTimer);
ExInitializeWorkItem(&KdpTimeSlipWorkItem, KdpTimeSlipWork, NULL);
KdpDebuggerStructuresInitialized = TRUE ;
}
//
// Initialize timer facility - HACKHACK
//
KeQueryPerformanceCounter(&KdPerformanceCounterRate);
KdTimerStart.HighPart = 0L;
KdTimerStart.LowPart = 0L;
//
// Initialize ID for NEXT packet to send and Expect ID of next incoming
// packet.
//
KdpNextPacketIdToSend = INITIAL_PACKET_ID | SYNC_PACKET_ID;
KdpPacketIdExpected = INITIAL_PACKET_ID;
//
// Mark debugger enabled.
//
KdPitchDebugger = FALSE;
KdDebuggerEnabled = TRUE;
SharedUserData->KdDebuggerEnabled = TRUE;
//
// If requested, stop in the kernel debugger.
//
if (StopInDebugger) {
DbgBreakPoint();
}
return TRUE;
}