bootcfg debug

bootcfg /debug

new in WS2003

---

Modifies the debug settings for a specified OS entry.

Syntax

 bootcfg /debug {ON  OFF  EDIT} [/port {COM1  COM2  COM3  COM4}]  [/baud {9600  19200  38400  57600  115200}] /id   OSEntryLineNum   

Options

{ON OFF EDIT}

ON/OFF enables/disables remote debugging by adding /debug switch to OS entry specified by OSEntryLineNum while EDIT lets you modify the port or baud rate settings

/port {COM1 COM2 COM3 COM4}

Indicates which COM port should be used for debugging (omit if OFF is specified)

/baud {9600 19200 38400 57600 115200}

Indicates the baud rate that should be used for debugging (omit if OFF is specified)

Examples

Enable debugging on COM2 at 115200 baud for OS entry 2 in boot.ini file:

  bootcfg /debug ON /port COM2 /baud 115200 /id 2  SUCCESS: Changed the OS entry switches for line "2" in the BOOT.INI file. 

Verify the result:

  bootcfg  Boot Loader Settings -------------------- timeout:30 default:multi(0)disk(0)rdisk(0)partition(1)\WINDOWS Boot Entries ------------ Boot entry ID:    1 OS Friendly Name: WS2003, Enterprise Path:             multi(0)disk(0)rdisk(0)partition(1)\WINDOWS OS Load Options:  /fastdetect /noguiboot Boot entry ID:    2 OS Friendly Name: WS2003 Enterprise Path:             multi(0)disk(0)rdisk(0)partition(1)\WINDOWS OS Load Options:  /fastdetect /noguiboot /debug /debugport=com2 /baudrate=115200 

Change that to COM1 instead:

  bootcfg /debug EDIT /port COM1 /baud 115200 /id 2  SUCCESS: Changed the OS entry switches for line "2" in the BOOT.INI file. 

Verify:

  bootcfg  Boot Loader Settings -------------------- timeout:30 default:multi(0)disk(0)rdisk(0)partition(1)\WINDOWS Boot Entries ------------ Boot entry ID:    1 OS Friendly Name: WS2003, Enterprise Path:             multi(0)disk(0)rdisk(0)partition(1)\WINDOWS OS Load Options:  /fastdetect /noguiboot Boot entry ID:    2 OS Friendly Name: WS2003 Enterprise Path:             multi(0)disk(0)rdisk(0)partition(1)\WINDOWS OS Load Options:  /fastdetect /noguiboot /debug /debugport=COM1  /baudrate=115200 

Notes

Use bootcfg /dbg1394 if IEEE 1394 debugging is required instead.

See Also

bootcfg , Recovery Console