listen.cpp File Reference

.listen command More...

#include "pch.h"

Functions
VOID	CommandListenHelp ()
	help of the listen command
VOID	CommandListen (vector< CommandToken > CommandTokens, string Command)
	listen 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_IsSerialConnectedToRemoteDebugger
	Shows if the debugger was connected to remote debugger (A remote host).
BOOLEAN	g_IsSerialConnectedToRemoteDebuggee
	Shows if the debugger was connected to remote debuggee over (A remote guest).

Detailed Description

.listen command

Author

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

Version

0.1

Date

2020-08-21

Copyright

This project is released under the GNU Public License v3.

Function Documentation

CommandListen()

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

listen command handler

Parameters

CommandTokens
Command

Returns

VOID

{
    string Port;
 
    if (CommandTokens.size() >= 3)
    {
        //
        // Means that user entered invalid parameters
        //
        ShowMessages("incorrect use of the '%s'\n\n",
                     GetCaseSensitiveStringFromCommandToken(CommandTokens.at(0)).c_str());
        CommandListenHelp();
        return;
    }
 
    if (g_IsConnectedToHyperDbgLocally || g_IsConnectedToRemoteDebuggee ||
        g_IsConnectedToRemoteDebugger)
    {
        ShowMessages("you're connected to a debugger, please use '.disconnect' "
                     "command\n");
        return;
    }
 
    //
    // Check to avoid using this command in debugger-mode
    //
    if (g_IsSerialConnectedToRemoteDebuggee || g_IsSerialConnectedToRemoteDebugger)
    {
        ShowMessages("you're connected to a an instance of HyperDbg, please use "
                     "'.debug close' command\n");
        return;
    }
 
    if (CommandTokens.size() == 1)
    {
        //
        // listen on default port
        //
        ShowMessages("listening on %s ...\n", DEFAULT_PORT);
        RemoteConnectionListen(DEFAULT_PORT);
 
        return;
    }
    else if (CommandTokens.size() == 2)
    {
        Port = GetCaseSensitiveStringFromCommandToken(CommandTokens.at(1));
 
        //
        // means that probably wants to listen
        // on a specific port, let's see if the
        // port is valid or not
        //
        if (!IsNumber(Port) || stoi(Port) > 65535 || stoi(Port) < 0)
        {
            ShowMessages("incorrect port\n");
            return;
        }
 
        //
        // listen on the port
        //
        ShowMessages("listening on %s ...\n", Port.c_str());
        RemoteConnectionListen(Port.c_str());
    }
    else
    {
        ShowMessages("incorrect use of the '%s'\n\n",
                     GetCaseSensitiveStringFromCommandToken(CommandTokens.at(0)).c_str());
        CommandListenHelp();
        return;
    }
}

CommandListenHelp()

VOID CommandListenHelp

(

)

help of the listen command

Returns

VOID

{
    ShowMessages(".listen : listens for a client to connect to HyperDbg (works as "
                 "a guest server).\n\n");
 
    ShowMessages("note : \tif you don't specify port then HyperDbg uses the "
                 "default port (%s)\n",
                 DEFAULT_PORT);
 
    ShowMessages("syntax : \t.listen [Port (decimal)]\n");
 
    ShowMessages("\n");
    ShowMessages("\t\te.g : .listen\n");
    ShowMessages("\t\te.g : .listen 50000\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).