steppings.h File Reference

headers for stepping instructions More...

Go to the source code of this file.

Functions
BOOLEAN	SteppingInstrumentationStepIn ()
	Perform Instrumentation Step-in.
BOOLEAN	SteppingRegularStepIn ()
	Perform Regular Step-in.
BOOLEAN	SteppingStepOver ()
	Perform Step-over.
BOOLEAN	SteppingInstrumentationStepInForTracking ()
	Perform Instrumentation Step-in for Tracking.
BOOLEAN	SteppingStepOverForGu (BOOLEAN LastInstruction)
	Perform Step-over for GU.

Detailed Description

headers for stepping instructions

Author

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

Version

0.11

Date

2024-09-06

Copyright

This project is released under the GNU Public License v3.

Function Documentation

SteppingInstrumentationStepIn()

BOOLEAN SteppingInstrumentationStepIn

(

)

Perform Instrumentation Step-in.

Returns

BOOLEAN

{
    DEBUGGER_REMOTE_STEPPING_REQUEST RequestFormat;
 
    //
    // Check if we're in VMI mode
    //
    if (g_ActiveProcessDebuggingState.IsActive)
    {
        ShowMessages("the instrumentation step-in is only supported in Debugger Mode\n");
        return FALSE;
    }
 
    //
    // Set type of step
    //
    RequestFormat = DEBUGGER_REMOTE_STEPPING_REQUEST_INSTRUMENTATION_STEP_IN;
 
    return KdSendStepPacketToDebuggee(RequestFormat);
}

SteppingInstrumentationStepInForTracking()

BOOLEAN SteppingInstrumentationStepInForTracking

(

)

Perform Instrumentation Step-in for Tracking.

Returns

BOOLEAN

{
    DEBUGGER_REMOTE_STEPPING_REQUEST RequestFormat;
 
    //
    // Check if we're in VMI mode
    //
    if (g_ActiveProcessDebuggingState.IsActive)
    {
        ShowMessages("the instrumentation step-in is only supported in Debugger Mode\n");
        return FALSE;
    }
 
    //
    // Set type of step
    //
    RequestFormat = DEBUGGER_REMOTE_STEPPING_REQUEST_INSTRUMENTATION_STEP_IN_FOR_TRACKING;
 
    return KdSendStepPacketToDebuggee(RequestFormat);
}

SteppingRegularStepIn()

BOOLEAN SteppingRegularStepIn

(

)

Perform Regular Step-in.

Returns

BOOLEAN

{
    DEBUGGER_REMOTE_STEPPING_REQUEST RequestFormat;
 
    //
    // Set type of step
    //
    RequestFormat = DEBUGGER_REMOTE_STEPPING_REQUEST_STEP_IN;
 
    if (g_IsSerialConnectedToRemoteDebuggee)
    {
        //
        // It's stepping over serial connection in kernel debugger
        //
        return KdSendStepPacketToDebuggee(RequestFormat);
    }
    else if (g_ActiveProcessDebuggingState.IsActive && g_ActiveProcessDebuggingState.IsPaused)
    {
        //
        // It's stepping over user debugger
        //
        return UdSendStepPacketToDebuggee(g_ActiveProcessDebuggingState.ProcessDebuggingToken,
                                          g_ActiveProcessDebuggingState.ThreadId,
                                          RequestFormat);
    }
    else
    {
        return FALSE;
    }
}

SteppingStepOver()

BOOLEAN SteppingStepOver

(

)

Perform Step-over.

Returns

BOOLEAN

{
    DEBUGGER_REMOTE_STEPPING_REQUEST RequestFormat;
 
    //
    // Set type of step
    //
    RequestFormat = DEBUGGER_REMOTE_STEPPING_REQUEST_STEP_OVER;
 
    if (g_IsSerialConnectedToRemoteDebuggee)
    {
        //
        // It's stepping over serial connection in kernel debugger
        //
        return KdSendStepPacketToDebuggee(RequestFormat);
    }
    else if (g_ActiveProcessDebuggingState.IsActive && g_ActiveProcessDebuggingState.IsPaused)
    {
        //
        // It's stepping over user debugger
        //
        return UdSendStepPacketToDebuggee(g_ActiveProcessDebuggingState.ProcessDebuggingToken,
                                          g_ActiveProcessDebuggingState.ThreadId,
                                          RequestFormat);
    }
    else
    {
        return FALSE;
    }
}

SteppingStepOverForGu()

BOOLEAN SteppingStepOverForGu

(

BOOLEAN

LastInstruction

)

Perform Step-over for GU.

Parameters

LastInstruction

Returns

BOOLEAN

{
    DEBUGGER_REMOTE_STEPPING_REQUEST RequestFormat;
 
    //
    // Set type of step
    //
    if (!LastInstruction)
    {
        RequestFormat = DEBUGGER_REMOTE_STEPPING_REQUEST_STEP_OVER_FOR_GU;
    }
    else
    {
        RequestFormat = DEBUGGER_REMOTE_STEPPING_REQUEST_STEP_OVER_FOR_GU_LAST_INSTRUCTION;
    }
 
    if (g_IsSerialConnectedToRemoteDebuggee)
    {
        //
        // It's stepping over serial connection in kernel debugger
        //
        return KdSendStepPacketToDebuggee(RequestFormat);
    }
    else if (g_ActiveProcessDebuggingState.IsActive && g_ActiveProcessDebuggingState.IsPaused)
    {
        //
        // It's stepping over user debugger
        //
        return UdSendStepPacketToDebuggee(g_ActiveProcessDebuggingState.ProcessDebuggingToken,
                                          g_ActiveProcessDebuggingState.ThreadId,
                                          RequestFormat);
    }
    else
    {
        //
        // The target is not paused, or not a valid context
        //
        return FALSE;
    }
}