mirror of
https://github.com/reactos/reactos.git
synced 2025-08-05 16:32:59 +00:00
10bbe664b7
- Simplify RtlpCheckForActiveDebugger: Remove the BOOLEAN parameter as we would always pass it FALSE. Always return FALSE false from kernel mode for simplicity. - Fix a critical flaw in our exception support: RtlRaiseException and RtlRaiseStatus were implemented in C on x86. This lead to unpredictable register corruption because the compiler could not know that it had to preserve non-volatile registers before calling RtlCaptureContext as the saved context is later used to restore the caller in case the exception is handled and execution is continued. This made the functions unsafe to return from as any non-volatile register could be corrupted. Implement them in assembly for x86 to safely capture the context using only EBP and ESP. The C versions of those routines are still used and shared for the other architectures we support -- needs to be determined if this is safe and correct for those architectures. - The ntdll exception Wine exposed this issue, and all tests now pass. The remaining failures on the build server are caused by missing or incomplete debug register support in KVM/QEMU. Run the test in another VM or on real hardware and all the tests will pass. - Implement Debug Prompt (DbgPrompt) support for KD and KDBG. The KDBG implementation reads the prompt from keyboard or serial depending on the mode so that sysreg and rosdbg can support it too. - Properly implement RtlAssert using DbgPrompt to prompt for the action to take instead of always doing a breakpoint. The new implementation is disabled until sysreg can support this. Also move RtlAssert to its own file as it has nothing to do with the error routines (nor does it belong in exception.c). - Note that DbgPrompt was already used in PspCatchCriticalBreak, and this would have resulted in a silent hang as BREAKPOINT_PROMPT wasn't handled at all by KDBG. - Implement KiRaiseAssertion (10 lines of code with the trap macros) and thus support NT_ASSERT. Add partial support for it to KDBG to print out a warning and the address of the failure, but don't do anything else. Also add NT_ASSERT to the DDK headers so that we can use it, but don't use it yet as the ARM method of performing this has not been decided nor implemented. - KiTrap3 doesn't set STATUS_SUCCESS but BREAKPOINT_BREAK. They have the same numerical value but very different meaning -- BREAKPOINT_BREAK means that the exception is a software breakpoint and not a debug service call. Fix some comments to document that this is what is checked for. - Fix inverted and broken logic in KdpReport. It would never pass second chance exceptions to the debugger, didn't respect the stop-on-exception flag properly and would always fail to handle some special exceptions in both first and second chance instead of just failing to handle it in first chance. Clean up, reformat and document what is going on. - The DebugPrint and DebugPrompt support routines only perform a 2D interrupt on x86; use more portable comments. - Add Alex to the programmer section of x86's kdsup.c -- he wrote KdpGetStateChange, KdpSetContextState and the code that was previously in KdpRead/WriteControlSpace. - Add my name to the parts of KD where I have made significant work on getting KD/WinDbg support up and running. - KD debugging is now quite functional and stable. Some bugs and stubs remain to be flushed out, but overall KD is now much better and easier to use than KDBG. svn path=/trunk/; revision=43705
380 lines
12 KiB
C
380 lines
12 KiB
C
/*
|
|
* COPYRIGHT: See COPYING in the top level directory
|
|
* PROJECT: ReactOS Run-Time Library
|
|
* PURPOSE: User-mode exception support for IA-32
|
|
* FILE: lib/rtl/i386/exception.c
|
|
* PROGRAMERS: Alex Ionescu (alex@relsoft.net)
|
|
* Casper S. Hornstrup (chorns@users.sourceforge.net)
|
|
*/
|
|
|
|
/* INCLUDES *****************************************************************/
|
|
|
|
#include <rtl.h>
|
|
#define NDEBUG
|
|
#include <debug.h>
|
|
|
|
/* PUBLIC FUNCTIONS **********************************************************/
|
|
|
|
/*
|
|
* @implemented
|
|
*/
|
|
VOID
|
|
NTAPI
|
|
RtlGetCallersAddress(OUT PVOID *CallersAddress,
|
|
OUT PVOID *CallersCaller)
|
|
{
|
|
USHORT FrameCount;
|
|
PVOID BackTrace[2];
|
|
PULONG BackTraceHash = NULL;
|
|
|
|
/* Get the tow back trace address */
|
|
FrameCount = RtlCaptureStackBackTrace(2, 2, &BackTrace[0],BackTraceHash);
|
|
|
|
/* Only if user want it */
|
|
if (*CallersAddress != NULL)
|
|
{
|
|
/* only when first frames exist */
|
|
if (FrameCount >= 1)
|
|
{
|
|
*CallersAddress = BackTrace[0];
|
|
}
|
|
else
|
|
{
|
|
*CallersAddress = NULL;
|
|
}
|
|
}
|
|
|
|
/* Only if user want it */
|
|
if (*CallersCaller != NULL)
|
|
{
|
|
/* only when second frames exist */
|
|
if (FrameCount >= 2)
|
|
{
|
|
*CallersCaller = BackTrace[1];
|
|
}
|
|
else
|
|
{
|
|
*CallersCaller = NULL;
|
|
}
|
|
}
|
|
}
|
|
|
|
/*
|
|
* @implemented
|
|
*/
|
|
BOOLEAN
|
|
NTAPI
|
|
RtlDispatchException(IN PEXCEPTION_RECORD ExceptionRecord,
|
|
IN PCONTEXT Context)
|
|
{
|
|
PEXCEPTION_REGISTRATION_RECORD RegistrationFrame, NestedFrame = NULL;
|
|
DISPATCHER_CONTEXT DispatcherContext;
|
|
EXCEPTION_RECORD ExceptionRecord2;
|
|
EXCEPTION_DISPOSITION Disposition;
|
|
ULONG_PTR StackLow, StackHigh;
|
|
ULONG_PTR RegistrationFrameEnd;
|
|
|
|
/* Perform vectored exception handling if we are in user mode */
|
|
if (RtlpGetMode() != KernelMode)
|
|
{
|
|
/* Call any registered vectored handlers */
|
|
if (RtlCallVectoredExceptionHandlers(ExceptionRecord, Context))
|
|
{
|
|
/* Exception handled, continue execution */
|
|
return TRUE;
|
|
}
|
|
}
|
|
|
|
/* Get the current stack limits and registration frame */
|
|
RtlpGetStackLimits(&StackLow, &StackHigh);
|
|
RegistrationFrame = RtlpGetExceptionList();
|
|
|
|
/* Now loop every frame */
|
|
while (RegistrationFrame != EXCEPTION_CHAIN_END)
|
|
{
|
|
/* Find out where it ends */
|
|
RegistrationFrameEnd = (ULONG_PTR)RegistrationFrame +
|
|
sizeof(EXCEPTION_REGISTRATION_RECORD);
|
|
|
|
/* Make sure the registration frame is located within the stack */
|
|
if ((RegistrationFrameEnd > StackHigh) ||
|
|
((ULONG_PTR)RegistrationFrame < StackLow) ||
|
|
((ULONG_PTR)RegistrationFrame & 0x3))
|
|
{
|
|
/* Check if this happened in the DPC Stack */
|
|
if (RtlpHandleDpcStackException(RegistrationFrame,
|
|
RegistrationFrameEnd,
|
|
&StackLow,
|
|
&StackHigh))
|
|
{
|
|
/* Use DPC Stack Limits and restart */
|
|
continue;
|
|
}
|
|
|
|
/* Set invalid stack and return false */
|
|
ExceptionRecord->ExceptionFlags |= EXCEPTION_STACK_INVALID;
|
|
return FALSE;
|
|
}
|
|
|
|
/* Check if logging is enabled */
|
|
RtlpCheckLogException(ExceptionRecord,
|
|
Context,
|
|
RegistrationFrame,
|
|
sizeof(*RegistrationFrame));
|
|
|
|
/* Call the handler */
|
|
Disposition = RtlpExecuteHandlerForException(ExceptionRecord,
|
|
RegistrationFrame,
|
|
Context,
|
|
&DispatcherContext,
|
|
RegistrationFrame->
|
|
Handler);
|
|
|
|
/* Check if this is a nested frame */
|
|
if (RegistrationFrame == NestedFrame)
|
|
{
|
|
/* Mask out the flag and the nested frame */
|
|
ExceptionRecord->ExceptionFlags &= ~EXCEPTION_NESTED_CALL;
|
|
NestedFrame = NULL;
|
|
}
|
|
|
|
/* Handle the dispositions */
|
|
switch (Disposition)
|
|
{
|
|
/* Continue searching */
|
|
case ExceptionContinueExecution:
|
|
|
|
/* Check if it was non-continuable */
|
|
if (ExceptionRecord->ExceptionFlags & EXCEPTION_NONCONTINUABLE)
|
|
{
|
|
/* Set up the exception record */
|
|
ExceptionRecord2.ExceptionRecord = ExceptionRecord;
|
|
ExceptionRecord2.ExceptionCode =
|
|
STATUS_NONCONTINUABLE_EXCEPTION;
|
|
ExceptionRecord2.ExceptionFlags = EXCEPTION_NONCONTINUABLE;
|
|
ExceptionRecord2.NumberParameters = 0;
|
|
|
|
/* Raise the exception */
|
|
RtlRaiseException(&ExceptionRecord2);
|
|
}
|
|
else
|
|
{
|
|
/* Return to caller */
|
|
return TRUE;
|
|
}
|
|
|
|
/* Continue searching */
|
|
case ExceptionContinueSearch:
|
|
break;
|
|
|
|
/* Nested exception */
|
|
case ExceptionNestedException:
|
|
|
|
/* Turn the nested flag on */
|
|
ExceptionRecord->ExceptionFlags |= EXCEPTION_NESTED_CALL;
|
|
|
|
/* Update the current nested frame */
|
|
if (DispatcherContext.RegistrationPointer > NestedFrame)
|
|
{
|
|
/* Get the frame from the dispatcher context */
|
|
NestedFrame = DispatcherContext.RegistrationPointer;
|
|
}
|
|
break;
|
|
|
|
/* Anything else */
|
|
default:
|
|
|
|
/* Set up the exception record */
|
|
ExceptionRecord2.ExceptionRecord = ExceptionRecord;
|
|
ExceptionRecord2.ExceptionCode = STATUS_INVALID_DISPOSITION;
|
|
ExceptionRecord2.ExceptionFlags = EXCEPTION_NONCONTINUABLE;
|
|
ExceptionRecord2.NumberParameters = 0;
|
|
|
|
/* Raise the exception */
|
|
RtlRaiseException(&ExceptionRecord2);
|
|
break;
|
|
}
|
|
|
|
/* Go to the next frame */
|
|
RegistrationFrame = RegistrationFrame->Next;
|
|
}
|
|
|
|
/* Unhandled, return false */
|
|
return FALSE;
|
|
}
|
|
|
|
/*
|
|
* @implemented
|
|
*/
|
|
VOID
|
|
NTAPI
|
|
RtlUnwind(IN PVOID TargetFrame OPTIONAL,
|
|
IN PVOID TargetIp OPTIONAL,
|
|
IN PEXCEPTION_RECORD ExceptionRecord OPTIONAL,
|
|
IN PVOID ReturnValue)
|
|
{
|
|
PEXCEPTION_REGISTRATION_RECORD RegistrationFrame, OldFrame;
|
|
DISPATCHER_CONTEXT DispatcherContext;
|
|
EXCEPTION_RECORD ExceptionRecord2, ExceptionRecord3;
|
|
EXCEPTION_DISPOSITION Disposition;
|
|
ULONG_PTR StackLow, StackHigh;
|
|
ULONG_PTR RegistrationFrameEnd;
|
|
CONTEXT LocalContext;
|
|
PCONTEXT Context;
|
|
|
|
/* Get the current stack limits */
|
|
RtlpGetStackLimits(&StackLow, &StackHigh);
|
|
|
|
/* Check if we don't have an exception record */
|
|
if (!ExceptionRecord)
|
|
{
|
|
/* Overwrite the argument */
|
|
ExceptionRecord = &ExceptionRecord3;
|
|
|
|
/* Setup a local one */
|
|
ExceptionRecord3.ExceptionFlags = 0;
|
|
ExceptionRecord3.ExceptionCode = STATUS_UNWIND;
|
|
ExceptionRecord3.ExceptionRecord = NULL;
|
|
ExceptionRecord3.ExceptionAddress = _ReturnAddress();
|
|
ExceptionRecord3.NumberParameters = 0;
|
|
}
|
|
|
|
/* Check if we have a frame */
|
|
if (TargetFrame)
|
|
{
|
|
/* Set it as unwinding */
|
|
ExceptionRecord->ExceptionFlags |= EXCEPTION_UNWINDING;
|
|
}
|
|
else
|
|
{
|
|
/* Set the Exit Unwind flag as well */
|
|
ExceptionRecord->ExceptionFlags |= (EXCEPTION_UNWINDING |
|
|
EXCEPTION_EXIT_UNWIND);
|
|
}
|
|
|
|
/* Now capture the context */
|
|
Context = &LocalContext;
|
|
LocalContext.ContextFlags = CONTEXT_INTEGER |
|
|
CONTEXT_CONTROL |
|
|
CONTEXT_SEGMENTS;
|
|
RtlpCaptureContext(Context);
|
|
|
|
/* Pop the current arguments off */
|
|
Context->Esp += sizeof(TargetFrame) +
|
|
sizeof(TargetIp) +
|
|
sizeof(ExceptionRecord) +
|
|
sizeof(ReturnValue);
|
|
|
|
/* Set the new value for EAX */
|
|
Context->Eax = (ULONG)ReturnValue;
|
|
|
|
/* Get the current frame */
|
|
RegistrationFrame = RtlpGetExceptionList();
|
|
|
|
/* Now loop every frame */
|
|
while (RegistrationFrame != EXCEPTION_CHAIN_END)
|
|
{
|
|
/* If this is the target */
|
|
if (RegistrationFrame == TargetFrame) ZwContinue(Context, FALSE);
|
|
|
|
/* Check if the frame is too low */
|
|
if ((TargetFrame) &&
|
|
((ULONG_PTR)TargetFrame < (ULONG_PTR)RegistrationFrame))
|
|
{
|
|
/* Create an invalid unwind exception */
|
|
ExceptionRecord2.ExceptionCode = STATUS_INVALID_UNWIND_TARGET;
|
|
ExceptionRecord2.ExceptionFlags = EXCEPTION_NONCONTINUABLE;
|
|
ExceptionRecord2.ExceptionRecord = ExceptionRecord;
|
|
ExceptionRecord2.NumberParameters = 0;
|
|
|
|
/* Raise the exception */
|
|
RtlRaiseException(&ExceptionRecord2);
|
|
}
|
|
|
|
/* Find out where it ends */
|
|
RegistrationFrameEnd = (ULONG_PTR)RegistrationFrame +
|
|
sizeof(EXCEPTION_REGISTRATION_RECORD);
|
|
|
|
/* Make sure the registration frame is located within the stack */
|
|
if ((RegistrationFrameEnd > StackHigh) ||
|
|
((ULONG_PTR)RegistrationFrame < StackLow) ||
|
|
((ULONG_PTR)RegistrationFrame & 0x3))
|
|
{
|
|
/* Check if this happened in the DPC Stack */
|
|
if (RtlpHandleDpcStackException(RegistrationFrame,
|
|
RegistrationFrameEnd,
|
|
&StackLow,
|
|
&StackHigh))
|
|
{
|
|
/* Use DPC Stack Limits and restart */
|
|
continue;
|
|
}
|
|
|
|
/* Create an invalid stack exception */
|
|
ExceptionRecord2.ExceptionCode = STATUS_BAD_STACK;
|
|
ExceptionRecord2.ExceptionFlags = EXCEPTION_NONCONTINUABLE;
|
|
ExceptionRecord2.ExceptionRecord = ExceptionRecord;
|
|
ExceptionRecord2.NumberParameters = 0;
|
|
|
|
/* Raise the exception */
|
|
RtlRaiseException(&ExceptionRecord2);
|
|
}
|
|
else
|
|
{
|
|
/* Call the handler */
|
|
Disposition = RtlpExecuteHandlerForUnwind(ExceptionRecord,
|
|
RegistrationFrame,
|
|
Context,
|
|
&DispatcherContext,
|
|
RegistrationFrame->
|
|
Handler);
|
|
switch(Disposition)
|
|
{
|
|
/* Continue searching */
|
|
case ExceptionContinueSearch:
|
|
break;
|
|
|
|
/* Collission */
|
|
case ExceptionCollidedUnwind :
|
|
|
|
/* Get the original frame */
|
|
RegistrationFrame = DispatcherContext.RegistrationPointer;
|
|
break;
|
|
|
|
/* Anything else */
|
|
default:
|
|
|
|
/* Set up the exception record */
|
|
ExceptionRecord2.ExceptionRecord = ExceptionRecord;
|
|
ExceptionRecord2.ExceptionCode = STATUS_INVALID_DISPOSITION;
|
|
ExceptionRecord2.ExceptionFlags = EXCEPTION_NONCONTINUABLE;
|
|
ExceptionRecord2.NumberParameters = 0;
|
|
|
|
/* Raise the exception */
|
|
RtlRaiseException(&ExceptionRecord2);
|
|
break;
|
|
}
|
|
|
|
/* Go to the next frame */
|
|
OldFrame = RegistrationFrame;
|
|
RegistrationFrame = RegistrationFrame->Next;
|
|
|
|
/* Remove this handler */
|
|
RtlpSetExceptionList(OldFrame);
|
|
}
|
|
}
|
|
|
|
/* Check if we reached the end */
|
|
if (TargetFrame == EXCEPTION_CHAIN_END)
|
|
{
|
|
/* Unwind completed, so we don't exit */
|
|
ZwContinue(Context, FALSE);
|
|
}
|
|
else
|
|
{
|
|
/* This is an exit_unwind or the frame wasn't present in the list */
|
|
ZwRaiseException(ExceptionRecord, Context, FALSE);
|
|
}
|
|
}
|
|
|
|
/* EOF */
|