4.1.10 WinDbg as a remote.exe Server

Use remote.exe to access the Command window of WinDbg across a network. This allows an establishment of a kernel debugging session between a host and target, which must be connected by a serial cable. This allows for the kernel debugging from a remote machine that is connected to the host through a named pipe interface. Using this method, you can only use WinDbg’s Command-window interface on the remote machine. Input and output normally permitted on the hosts Command window can be used by the remotely connected machine.

Set up a remote.exe session as follows:

1. In the Command window of WinDbg on the host machine run

   remote pipename
    

   where pipename is the name you choose for the pipe.

2. In a Windows NT command prompt on the remote machine, run

   remote /c hostname pipename
    

   where hostname is the machine name of the host that is running WinDbg.

You now have access from the remote machine to the host’s Command window.

The syntax for the remote command in the host’s Command window is:

remote [pipename | STOP]
 

Parameters:

pipename

The name that you want to use for the remote server pipe.

STOP

Ends a currently active remote server.

If you do not specify any parameters to remote, the command displays its connection status and the name of the client.