Debugging Tools for Windows

BCDEdit /dbgsettings

/dbgsettings 选项设置或显示计算机当前的全局调试设置。启用或禁用内核调试器,使用BCDEdit /debug选项。

bcdedit /dbgsettings [ debugtype [DEBUGPORT:port] [BAUDRATE:baud] [CHANNEL:channel] [TARGETNAME:targetname] /start startpolicy /noemux ]

参数

debugtype
指定调试连接的类型。主控机和目标机之间的调试连接可以是串口、IEEE 1394(火线)或者USB 2.0。
debugtype 参数
Serial DEBUGPORT:port, BAUDRATE:baud
1394 CHANNEL:channel
USB TARGETNAME:targetname

当使用BCDEdit来设置调试连接参数时,必须指定debugtype 。例如,下面在全局调试设置中设定使用串口,并指定COM2为通信端口。

bcdedit /dbgsettings serial DEBUGPORT:2

DEBUGPORT:port
指定当debugtypeSerial 的时候作为调试端口的串口。这是一个可选设置,默认端口为1(COM 1)。当修改DEBUGPORT 参数时debugtype 必须设置为Serial
BAUDRATE:baud
指定当debugtypeSerial时使用的波特率。这个参数是可选的。合法值的波特率为9600,19200,38400,57600和115200。默认是115200 bps。
CHANNEL:channel
指定当debugtype1394时使用的频道号。channel的值必须是0到62之间的10进制整数,并且必须和主控机上设置的一样。这个频道值和所使用的物理的1394端口没有关系。默认的channel是0。
TARGETNAME:targetname
debugtypeUSB时用于指定一个名字字符串。

该字符串可以为任意值。

/start startpolicy
对于所有调试器类型,该选项都指定调试器的启动策略。下表显示了startpolicy的各种选择项。
startpolicy 描述
ACTIVE 指定内核调试器被激活。
AUTOENABLE 指定当发生异常或者其他临界条件时,调试器被自动启用。在这之前调试器都是激活但禁用的。
DISABLE. 指定当输入kdbgctrl来清空启用块(enable block)时启用调试器。在此之前调试器都是激活但禁用的。

如果启动策略没有指定,则默认为ACTIVE。

/noumex
指定内核调试器跳过用户模式异常。默认情况下,内核调试器会因为特定的用户模式异常而中断下来,例如STATUS_BREAKPOINT 和STATUS_SINGLE_STEP 。/noumex 只在没有用户模式调试器附加到该进程上时起作用。

注释

/dbgsettings 用于配置全局调试设置,但是并不启用调试。必须使用/debug 选项来为指定 引导入口启用调试。如果某个引导入口没有自己的调试设置,则会使用全局调试设置。要覆盖全局设置,必须使用BCDEdit /set命令来指定引导入口ID和调试参数。

全局设置的默认值是使用COM1和串口通信,波特率为115200。

/dbgsetting 参数 默认值            
debugtype Serial
DEBUGPORT: port 1
BAUDRATE:rate 115200

示例

下面的示例设置全局调试设置。使用串口COM 2进行通信,波特率为115200。

bcdedit /dbgsettings serial debugport:2 baudrate:115200

下例中,第一条命令设置为使用USB 2.0调试,并且目标名为myVistaTarget 。第二条命令为当前系统启用调试器。

bcdedit /dbgsettings usb targetname:myVistaTarget

bcdedit /debug ON

Build machine: CAPEBUILD