status.cpp File Reference

.status command More...

#include "pch.h"

Functions
VOID	CommandStatusHelp ()
	help of the .status command
VOID	CommandStatus (vector< string > SplitCommand, string Command)
	.status and status command handler

Variables
BOOLEAN	g_IsConnectedToHyperDbgLocally
	Shows whether the user is allowed to use 'load' command to load modules locally in VMI (virtual machine introspection) mode.
BOOLEAN	g_IsConnectedToRemoteDebuggee
	Shows whether the current debugger is the host and connected to a remote debuggee (guest)
BOOLEAN	g_IsConnectedToRemoteDebugger
	Shows whether the current system is a guest (debuggee) and a remote debugger is connected to this system.
BOOLEAN	g_IsSerialConnectedToRemoteDebuggee
	Shows if the debugger was connected to remote debuggee over (A remote guest)
BOOLEAN	g_IsSerialConnectedToRemoteDebugger
	Shows if the debugger was connected to remote debugger (A remote host)
string	g_ServerPort
	In debugger (not debuggee), we save the port of server debuggee in this variable to use it later e.g, in signature.
string	g_ServerIp
	In debugger (not debuggee), we save the port of server debuggee in this variable to use it later e.g, in signature.

Detailed Description

.status command

Author

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

Version

0.1

Date

2020-08-23

Copyright

This project is released under the GNU Public License v3.

Function Documentation

CommandStatus()

VOID CommandStatus	(	vector< string >	SplitCommand,
		string	Command )

.status and status command handler

Parameters

SplitCommand
Command

Returns

VOID

{
    if (SplitCommand.size() != 1)
    {
        ShowMessages("incorrect use of the '.status'\n\n");
        CommandStatusHelp();
    }
 
    if (g_IsSerialConnectedToRemoteDebuggee)
    {
        //
        // Connected to a remote debugger (serial port)
        //
        ShowMessages("remote debugging - debugger ('debugger mode')\n");
    }
    else if (g_IsSerialConnectedToRemoteDebugger)
    {
        //
        // Connected to a remote debuggee (serial port)
        //
        ShowMessages("remote debugging - debuggee ('debugger mode')\n");
    }
    else if (g_IsConnectedToRemoteDebuggee)
    {
        //
        // Connected to a remote debuggee
        //
        ShowMessages("remote debugging ('vmi mode'), ip : %s:%s \n",
                     g_ServerIp.c_str(),
                     g_ServerPort.c_str());
    }
    else if (g_IsConnectedToHyperDbgLocally)
    {
        //
        // Connected to a local system
        //
        ShowMessages("local debugging ('vmi mode')\n");
    }
    else if (g_IsConnectedToRemoteDebugger)
    {
        //
        // It's computer connect to a remote machine (this
        // message shouldn't be showed)
        //
        ShowMessages("a remote debugger connected to this system in ('vmi "
                     "mode'), ip : %s:%s \n",
                     g_ServerIp.c_str(),
                     g_ServerPort.c_str());
    }
    else
    {
        //
        // we never should see this message
        //
        ShowMessages("err, you're not connected to any instance of HyperDbg\n");
    }
}

CommandStatusHelp()

VOID CommandStatusHelp

(

)

help of the .status command

Returns

VOID

{
    ShowMessages(".status | status : gets the status of current debugger in local "
                 "system (if you connected to a remote system then '.status' "
                 "shows the state of current debugger, while 'status' shows the "
                 "state of remote debuggee).\n\n");
 
    ShowMessages("syntax : \t.status\n");
    ShowMessages("syntax : \tstatus\n");
}

Variable Documentation

g_IsConnectedToHyperDbgLocally

BOOLEAN g_IsConnectedToHyperDbgLocally

extern

Shows whether the user is allowed to use 'load' command to load modules locally in VMI (virtual machine introspection) mode.

g_IsConnectedToRemoteDebuggee

BOOLEAN g_IsConnectedToRemoteDebuggee

extern

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

g_IsConnectedToRemoteDebugger

BOOLEAN g_IsConnectedToRemoteDebugger

extern

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

g_IsSerialConnectedToRemoteDebuggee

BOOLEAN g_IsSerialConnectedToRemoteDebuggee

extern

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

g_IsSerialConnectedToRemoteDebugger

BOOLEAN g_IsSerialConnectedToRemoteDebugger

extern

Shows if the debugger was connected to remote debugger (A remote host)

g_ServerIp

string g_ServerIp

extern

In debugger (not debuggee), we save the port of server debuggee in this variable to use it later e.g, in signature.

g_ServerPort

string g_ServerPort

extern

In debugger (not debuggee), we save the port of server debuggee in this variable to use it later e.g, in signature.