Connecting KD

First connect the Windows NT computer and KD computer with a standard null-modem serial cable. On the Windows NT (target) computer, connect the cable to the highest-numbered serial port. For example, on a computer with two serial ports, connect it to COM2. On the debugger (host) computer, connect it to COM1. See the instructions below if you need to use a different port on the debugger computer.

    To connect KD
  1. Install a debug version of Windows NT (available in the Win32 DDK) on the debugger computer.
  2. For x86 platforms: copy mstools\bin\i386kd.exe from the development computer to the debugger computer; alternatively, copy the file from the CD to the debugger computer.

    For MIPS platforms: copy mstools\bin\mipskd.exe from the development computer to the debugger computer; alternatively, copy the file from the CD to the debugger computer.

    For Alpha platforms, copy MSTOOLS\BIN\ALPHAKD.EXE from the development computer to the debugger computer; alternatively, copy the file from the CD to the debugger computer.

    For Power PC platforms, copy MSTOOLS\BIN\PPCKD.EXE from the development computer to the debugger computer; alternatively, copy the file from the CD to the debugger computer.

  3. Create a batch file beginning with these lines:
    set _NT_DEBUG_PORT=COM1 
    set _NT_DEBUG_LOG_FILE_APPEND=c:\debug.log
    <kd_debugger>
    

    the last line in this batch file is platform dependent; it is the name of the debugger. The .EXE filename extension is not necessary.

  4. Run the batch file to execute KD. The KD debugging session is logged in the file specified by the _NT_DEBUG_LOG_FILE_APPEND variable. To connect the debugging cable to a port other than COM1 (on the debugging computer), use the _NT_DEBUG_PORT variable to set the desired com port.