i.cpp File Reference

i command More...

#include "pch.h"

Functions
VOID	CommandIHelp ()
	help of the i command
VOID	CommandI (vector< CommandToken > CommandTokens, string Command)
	handler of i command

Variables
BOOLEAN	g_IsSerialConnectedToRemoteDebuggee
	Shows if the debugger was connected to remote debuggee over (A remote guest).
BOOLEAN	g_IsInstrumentingInstructions
	Shows whether the user is running 't', 'p', or 'i' command.
ACTIVE_DEBUGGING_PROCESS	g_ActiveProcessDebuggingState
	State of active debugging thread.

Detailed Description

i command

Author

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

Version

0.1

Date

2021-03-19

Copyright

This project is released under the GNU Public License v3.

Function Documentation

CommandI()

VOID CommandI	(	vector< CommandToken >	CommandTokens,
		string	Command )

handler of i command

Parameters

CommandTokens
Command

Returns

VOID

{
    UINT32 StepCount;
 
    //
    // Validate the commands
    //
    if (CommandTokens.size() != 1 && CommandTokens.size() != 2)
    {
        ShowMessages("incorrect use of the '%s'\n\n",
                     GetCaseSensitiveStringFromCommandToken(CommandTokens.at(0)).c_str());
        CommandIHelp();
        return;
    }
 
    //
    // Check if we're in VMI mode
    //
    if (g_ActiveProcessDebuggingState.IsActive)
    {
        ShowMessages("the instrumentation step-in is only supported in Debugger Mode\n");
        return;
    }
 
    //
    // Check if the command has a counter parameter
    //
    if (CommandTokens.size() == 2)
    {
        if (!ConvertTokenToUInt32(CommandTokens.at(1), &StepCount))
        {
            ShowMessages("please specify a correct hex value for [count]\n\n");
            CommandIHelp();
            return;
        }
    }
    else
    {
        StepCount = 1;
    }
 
    //
    // Check if the remote serial debuggee or user debugger are paused or not
    //
    if (g_IsSerialConnectedToRemoteDebuggee)
    {
        //
        // Indicate that we're instrumenting
        //
        g_IsInstrumentingInstructions = TRUE;
 
        for (SIZE_T i = 0; i < StepCount; i++)
        {
            //
            // For logging purpose
            //
            // ShowMessages("percentage : %f %% (%x)\n", 100.0 * (i /
            //   (float)StepCount), i);
            //
 
            //
            // It's stepping over serial connection in kernel debugger
            //
            SteppingInstrumentationStepIn();
 
            if (CompareLowerCaseStrings(CommandTokens.at(0), "ir"))
            {
                //
                // Show registers
                //
                HyperDbgRegisterShowAll();
 
                if (i != StepCount - 1)
                {
                    ShowMessages("\n");
                }
            }
 
            //
            // Check if user pressed CTRL+C
            //
            if (!g_IsInstrumentingInstructions)
            {
                break;
            }
        }
 
        //
        // We're not instrumenting instructions anymore
        //
        g_IsInstrumentingInstructions = FALSE;
    }
    else
    {
        ShowMessages("err, stepping (i) is not valid in the current context, you "
                     "should connect to a debuggee\n");
    }
}

CommandIHelp()

VOID CommandIHelp

(

)

help of the i command

Returns

VOID

{
    ShowMessages(
        "i : executes a single instruction (step-in) and guarantees that no "
        "other instruction is executed other than the displayed instruction "
        "including user to the kernel (syscalls) and kernel to the user "
        "(sysrets) and exceptions and page-faults and optionally displays all "
        "registers and flags' resulting values.\n\n");
 
    ShowMessages("syntax : \ti\n");
    ShowMessages("syntax : \ti [Count (hex)]\n");
    ShowMessages("syntax : \tir\n");
    ShowMessages("syntax : \tir [Count (hex)]\n");
 
    ShowMessages("\n");
    ShowMessages("\t\te.g : i\n");
    ShowMessages("\t\te.g : ir\n");
    ShowMessages("\t\te.g : ir 1f\n");
}

Variable Documentation

g_ActiveProcessDebuggingState

ACTIVE_DEBUGGING_PROCESS g_ActiveProcessDebuggingState

extern

State of active debugging thread.

{0};

g_IsInstrumentingInstructions

BOOLEAN g_IsInstrumentingInstructions

extern

Shows whether the user is running 't', 'p', or 'i' command.

g_IsSerialConnectedToRemoteDebuggee

BOOLEAN g_IsSerialConnectedToRemoteDebuggee

extern

Shows if the debugger was connected to remote debuggee over (A remote guest).