.debug [action (remote | prepare | close)] [type (serial | namedpipe)] [baud rate (decimal value)] address
This command prepares debuggee for a remote connection or connects to a remote debuggee.
[action (remote | prepare | close)]
If you specify
remote then it means that you want to connect to a debuggee or if you specify
prepared then it means that you want to prepare the current machine to be debugged as debuggee and
close means to close all the connections to the debuggee.
[type (serial | namedpipe)]
If you want to use a serial port as the connection, you should choose
serial, and if you want to connect to a named pipe, then you should specify
namedpipe. Please note that
namedpipe cannot be used in debuggee, and it can be used only in the debugger.
[baud rate (decimal value)]
This value shows the baud rate of the device. (See Remarks for more information)
COM port address or named pipe address. (See Remarks for more information)
If you want to have a kernel debug connection, first, you should run the following command in a debugger (host). As you can see, you can change the
com3to your COM port that is connected to the debuggee.
HyperDbg> .debug remote serial 115200 com3
If you want to use a named pipe instead of a COM port, you can execute the following command in the debugger (Host).
HyperDbg> .debug remote namedpipe \\\\.\\pipe\\HyperDbgPipe
After you tell the debugger to listen on a COM port or a named pipe, now you can run the following command in the debuggee.
HyperDbg> .debug prepare serial 115200 com2
If you want to disconnect from the debuggee, then you should run the following command.
HyperDbg> .debug close
See here to see the design of the kernel debugger connectin.
The following values are valid baud rates for serial connections.
The following COM ports are valid for debugging.