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.