BCDEdit Operation to Control Debugging

BCDEdit /bootdebug

This command enables or disables the boot debugger for the specified boot entry. Although this command works for any entry, it is only effective for boot applications.

Syntax

bcdedit /bootdebug [<id>] { ON | OFF }

Parameter

<id>Specifies the identifier of the entry to be modified. For information about identifiers, run "bcdedit /? ID".

Example

The following command enables boot debugging for the Windows operating system loader of the current operating system boot entry: bcdedit /bootdebug ON The following command disables boot debugging for the Windows boot manager: bcdedit /bootdebug {bootmgr} OFF

BCDEdit /dbgsettings

This command sets or displays the global debugger settings for the system. This command does not enable or disable the debugger for any particular boot entry. To enable or disable the debugger for a particular boot entry, use "bcdedit /debug < identifier> ON". For information about identifiers, run "bcdedit /? ID". To set an individual global debugger setting, use "bcdedit /set {dbgsettings} <type> <value>". For information about valid types, run "bcdedit /? TYPES".

Syntax

bcdedit /dbgsettings [ <debugtype> [DEBUGPORT:<comport>] [BAUDRATE:<baud>] [CHANNEL:<channel>] [TARGETNAME:<targetname>] [HOSTIP:<ip>] [PORT:<port>] [KEY:<key>] [nodhcp] [newkey] /start <startpolicy> /noumex ]

Parameter

<debugtype>Specifies the type of debugger. <debugtype> can be one of SERIAL, 1394, USB, NET or LOCAL. <comport>For SERIAL debugging, specifies the serial port to use as the debugging port. This is an optional setting. <baud>For SERIAL debugging, specifies the baud rate to be used for debugging. This is an optional setting. <channel>For 1394 debugging, specifies the 1394 channel to be used for debugging. <targetname>For universal serial bus (USB) debugging, specifies the USB target name to be used for debugging. <ip>For network debugging, specifies the IPv4 address of the host debugger. <port>For network debugging, specifies the port to communicate with on the host debugger. Should be 49152 or higher. <key>For network debugging, specifies the key with which to encrypt the connection. [0-9] and [a-z] allowed only. nodhcpFor network debugging prevents use of DHCP to obtain the target IP address. newkeyFor network debugging specifies that a new encryption key should be generated for the connection. /start <startpolicy> For all debugger types, this specifies the debugger start policy. <startpolicy> can be one of the following: ACTIVE AUTOENABLE DISABLE. If not specified, ACTIVE is the default. /noumexIf specified, this causes the kernel debugger to ignore any user-mode exceptions.

Example

The following command displays the current global debugger settings: bcdedit /dbgsettings The following command sets the global debugger settings to serial debugging over com1 at 115,200 baud: bcdedit /dbgsettings SERIAL DEBUGPORT:1 BAUDRATE:115200 The following command sets the global debugger settings to 1394 debugging using channel 23: bcdedit /dbgsettings 1394 CHANNEL:23 The following command sets the global debugger settings to USB debugging using target name DEBUGGING: bcdedit /dbgsettings USB TARGETNAME:DEBUGGING The following command sets the global debugger settings to network debugging with a debugger host at 192.168.1.2 communicating on port 50000: bcdedit /dbgsettings NET HOSTIP:192.168.1.2 PORT:50000 The following command sets the global debugger settings to local debugging: bcdedit /dbgsettings LOCAL

BCDEdit /debug

This command enables or disables the kernel debugger for the specified boot entry.

Syntax

bcdedit /debug [<id>] { ON | OFF }

Parameter

<id>Specifies the identifier of the entry to be modified. Only Windows boot loader entries may be specified. If not specified, {current} is used. For more information about identifiers, run "bcdedit /? ID".

Example

The following command enables kernel debugging for the current Windows operating system boot entry: bcdedit /debug ON The following command disables kernel debugging for the specified operating system entry: bcdedit /debug {cbd971bf-b7b8-4885-951a-fa03044f5d71} OFF

Sources and References

• https://docs.microsoft.com/en-us/windows-hardware/drivers/devtest/bcd-boot-options-reference
• https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/bcdedit
• https://docs.microsoft.com/en-us/windows-hardware/manufacture/desktop/bcdedit-command-line-options
• https://docs.microsoft.com/en-us/windows-hardware/drivers/devtest/bcdedit--set
• https://atomicit.ca/kb/articles/how-to-fix-windows-7810-boot-problem-with-bcdedit/
• https://neosmart.net/wiki/bcdedit/#BCDEdit_on_Windows_8