Debugging Tools for Windows |
Click Connect to Remote Stub on the File menu to make WinDbg a smart client and connect to a process server or a KD connection server.
This command is equivalent to using the
You cannot use this command to connect to a debugging server; for that purpose, use File | Connect to Remote Session instead.
When you click Connect to Remote Stub, the Connect to Remote Stub Server dialog box appears. You can use this dialog box to enter the remote connection parameters or to browse a list of process servers and KD connection servers.
To manually specify the remote connection parameters, enter one of the following strings in the Connection string box:
tcp:server=Server,port=Socket[,password=Password][,ipversion=6]
tcp:clicon=Server,port=Socket[,password=Password][,ipversion=6]
com:port=COMPort,baud=BaudRate,channel=COMChannel[,password=Password]
spipe:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,pipe=PipeName[,password=Password]
ssl:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,port=Socket[,password=Password]
ssl:proto=Protocol,{certuser=Cert|machuser=Cert},clicon=Server,port=Socket[,password=Password]
The various parameters in the preceding options have the following possible values:
Instead of manually specifying the remote connection parameters, you can press the Browse button in the Connect to Remote Stub Server dialog box and use the Browse Remote Servers dialog box.
In the Browse Remote Servers dialog box, in the Machine text box, enter the name of the computer that the process server or KD connection server is running on. (The two initial backslashes are optional: "MyBox" and "\\MyBox" are both correct.) Then, press the Refresh button.
The Servers area lists all of the process servers and KD connection servers that are running on that computer. Select any of the listed servers and then press ENTER or click OK. (You can also double-click one of the listed servers.) The proper connection string for the process server that you selected will now appear in the Connection string box in the Connect to Remote Stub Server dialog box.
If the server is password-protected, the connection string includes Password=*. You must replace the asterisk (*) with the actual password.
After you specify the server and password, click OK to open the connection.
The list of servers in the Browse Remote Servers dialog box can also include servers that no longer exist but were shut down improperly. If you connect to one of these nonexistent servers, you will receive an error message.
The list of servers does not include debugging servers. To view those servers, use the File | Connect to Remote Session command.
For more information and for other methods of joining a remote stub session, see Activating a Smart Client and Activating a Smart Client (Kernel Mode).