DebuggerVmcalls.c File Reference

Implementation of debugger VMCALLs. More...

#include "pch.h"

Functions
BOOLEAN	DebuggerVmcallHandler (UINT32 CoreId, UINT64 VmcallNumber, UINT64 OptionalParam1, UINT64 OptionalParam2, UINT64 OptionalParam3)
	Termination function for external-interrupts.

Detailed Description

Implementation of debugger VMCALLs.

Author

Sina Karvandi (sina@.nosp@m.hype.nosp@m.rdbg..nosp@m.org)

Version

0.2

Date

2023-01-22

Copyright

This project is released under the GNU Public License v3.

Function Documentation

DebuggerVmcallHandler()

BOOLEAN DebuggerVmcallHandler	(	UINT32	CoreId,
		UINT64	VmcallNumber,
		UINT64	OptionalParam1,
		UINT64	OptionalParam2,
		UINT64	OptionalParam3 )

Termination function for external-interrupts.

Parameters

CoreId
VmcallNumber
OptionalParam1
OptionalParam2
OptionalParam3

Returns

BOOLEAN

{
    UNREFERENCED_PARAMETER(OptionalParam3);
 
    BOOLEAN                     Result   = FALSE;
    PROCESSOR_DEBUGGING_STATE * DbgState = &g_DbgState[CoreId];
 
    switch (VmcallNumber)
    {
    case DEBUGGER_VMCALL_VM_EXIT_HALT_SYSTEM:
    {
        KdHandleBreakpointAndDebugBreakpoints(DbgState,
                                              DEBUGGEE_PAUSING_REASON_REQUEST_FROM_DEBUGGER,
                                              NULL);
        Result = TRUE;
        break;
    }
    case DEBUGGER_VMCALL_VM_EXIT_HALT_SYSTEM_AS_A_RESULT_OF_TRIGGERING_EVENT:
    {
        DEBUGGER_TRIGGERED_EVENT_DETAILS * TriggeredEventDetail = (DEBUGGER_TRIGGERED_EVENT_DETAILS *)OptionalParam1;
        PGUEST_REGS                        TempReg              = NULL;
 
        TempReg = DbgState->Regs;
 
        //
        // We won't send current vmcall registers
        // instead we send the registers provided
        // from the third parameter
        //
        DbgState->Regs = (GUEST_REGS *)OptionalParam2;
 
        KdHandleBreakpointAndDebugBreakpoints(DbgState,
                                              DEBUGGEE_PAUSING_REASON_DEBUGGEE_EVENT_TRIGGERED,
                                              TriggeredEventDetail);
 
        //
        // Restore the register
        //
        DbgState->Regs = TempReg;
 
        Result = TRUE;
        break;
    }
    case DEBUGGER_VMCALL_SIGNAL_DEBUGGER_EXECUTION_FINISHED:
    {
        KdSendCommandFinishedSignal(CoreId);
 
        Result = TRUE;
        break;
    }
    case DEBUGGER_VMCALL_SEND_MESSAGES_TO_DEBUGGER:
    {
        //
        // Kernel debugger is active, we should send the bytes over serial
        //
 
        if (OptionalParam1 != NULL64_ZERO && OptionalParam2 != NULL64_ZERO)
        {
            KdLoggingResponsePacketToDebugger(
                (CHAR *)OptionalParam1,
                (UINT32)OptionalParam2,
                OPERATION_LOG_INFO_MESSAGE);
        }
 
        Result = TRUE;
        break;
    }
    case DEBUGGER_VMCALL_SEND_GENERAL_BUFFER_TO_DEBUGGER:
    {
        //
        // Cast the buffer received to perform sending buffer and possibly
        // halt the debuggee
        //
        PDEBUGGEE_SEND_GENERAL_PACKET_FROM_DEBUGGEE_TO_DEBUGGER DebuggeeBufferRequest = (DEBUGGEE_SEND_GENERAL_PACKET_FROM_DEBUGGEE_TO_DEBUGGER *)OptionalParam1;
 
        KdResponsePacketToDebugger(DEBUGGER_REMOTE_PACKET_TYPE_DEBUGGEE_TO_DEBUGGER,
                                   DebuggeeBufferRequest->RequestedAction,
                                   (CHAR *)((UINT64)DebuggeeBufferRequest + (SIZEOF_DEBUGGEE_SEND_GENERAL_PACKET_FROM_DEBUGGEE_TO_DEBUGGER)),
                                   DebuggeeBufferRequest->LengthOfBuffer);
 
        //
        // Check if we expect a buffer and command from the debugger or the
        // request is just finished
        //
        if (DebuggeeBufferRequest->PauseDebuggeeWhenSent)
        {
            DbgState->IgnoreDisasmInNextPacket = TRUE;
 
            KdHandleBreakpointAndDebugBreakpoints(DbgState,
                                                  DEBUGGEE_PAUSING_REASON_PAUSE,
                                                  NULL);
        }
 
        Result = TRUE;
        break;
    }
    default:
        Result = FALSE;
        LogError("Err, invalid VMCALL in top-level debugger");
 
        break;
    }
 
    return Result;
}