pause.cpp File Reference

pause command More...

#include "pch.h"

Functions
VOID	CommandPauseHelp ()
	help of the pause command
VOID	CommandPauseRequest ()
	request to pause
VOID	CommandPause (vector< CommandToken > CommandTokens, string Command)
	pause command handler

Variables
BOOLEAN	g_BreakPrintingOutput
	Shows whether the pause command or CTRL+C or CTRL+Break is executed or not.
BOOLEAN	g_IsConnectedToRemoteDebuggee
	Shows whether the current debugger is the host and connected to a remote debuggee (guest).
ACTIVE_DEBUGGING_PROCESS	g_ActiveProcessDebuggingState
	State of active debugging thread.

Detailed Description

pause command

Author

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

Version

0.1

Date

2020-07-25

Copyright

This project is released under the GNU Public License v3.

Function Documentation

CommandPause()

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

pause command handler

Parameters

CommandTokens
Command

Returns

VOID

{
    if (CommandTokens.size() != 1)
    {
        ShowMessages("incorrect use of the '%s'\n\n",
                     GetCaseSensitiveStringFromCommandToken(CommandTokens.at(0)).c_str());
        CommandPauseHelp();
        return;
    }
 
    //
    // request to pause
    //
    CommandPauseRequest();
}

CommandPauseHelp()

VOID CommandPauseHelp

(

)

help of the pause command

Returns

VOID

{
    ShowMessages("pause : pauses the kernel events.\n\n");
 
    ShowMessages("syntax : \tpause \n");
}

CommandPauseRequest()

VOID CommandPauseRequest

(

)

request to pause

Returns

VOID

{
    //
    // Set the g_BreakPrintingOutput to TRUE
    //
    g_BreakPrintingOutput = TRUE;
    ShowMessages("pausing...\n");
 
    //
    // If it's a remote debugger then we send the remote debuggee a 'g'
    //
    if (g_IsConnectedToRemoteDebuggee)
    {
        RemoteConnectionSendCommand("pause", (UINT32)strlen("pause") + 1);
    }
    else if (g_ActiveProcessDebuggingState.IsActive && UdPauseProcess(g_ActiveProcessDebuggingState.ProcessDebuggingToken))
    {
        ShowMessages("please keep interacting with the process until all the threads are intercepted "
                     "and halted; you can run the 'g' command to continue the debuggee\n");
    }
}

Variable Documentation

g_ActiveProcessDebuggingState

ACTIVE_DEBUGGING_PROCESS g_ActiveProcessDebuggingState

extern

State of active debugging thread.

{0};

g_BreakPrintingOutput

BOOLEAN g_BreakPrintingOutput

extern

Shows whether the pause command or CTRL+C or CTRL+Break is executed or not.

g_IsConnectedToRemoteDebuggee

BOOLEAN g_IsConnectedToRemoteDebuggee

extern

Shows whether the current debugger is the host and connected to a remote debuggee (guest).