KDbgCtrl Command-Line Options

The KDbgCtrl command line uses the following syntax:

kdbgctrl [-e|-d|-c] [-ea|-da|-ca] [-eu|-du|-cu] [-eb|-db|-cb] [-sdb Size | -cdb] 

kdbgctrl -cx 

kdbgctrl -td ProcessID File 

kdbgctrl -sd {active|automatic|full|kernel|mini}

kdbgctrl -? 

Parameters

-e
Enables Full Kernel Debugging.

-d
Disables Full Kernel Debugging.

-c
Checks whether Full Kernel Debugging is enabled. Displays true if Full Kernel Debugging is enabled, and displays false if Full Kernel Debugging is disabled.

-ea
Enables Automatic Kernel Debugging.

-da
Disables Automatic Kernel Debugging.

-ca
Checks whether Automatic Kernel Debugging is enabled. Displays true if Automatic Kernel Debugging is enabled, and displays false if Automatic Kernel Debugging is disabled.

-eu
Enables User-Mode Error Handling.

-du
Disables User-Mode Error Handling.

-cu
Checks whether User-Mode Error Handling is enabled. Displays true if User-Mode Error Handling is enabled, and displays false if User-Mode Error Handling is disabled.

-eb
Enables blocking of kernel debugging.

-db
Disables blocking of kernel debugging

-cb
Checks whether kernel debugging is blocked. Displays true if kernel debugging is blocked, and displays false if kernel debugging is not blocked.

-sdb Size
Sets the size of the DbgPrint buffer. If Size is prefixed with 0x it will be interpreted as a hexadecimal number. If it is prefixed with 0 (zero), it will be interpreted as octal. Otherwise, it will be interpreted as decimal.

-cdb
Displays the current size, in bytes, of the DbgPrint buffer.

-cx
Determines the current Full Kernel Debugging setting and returns an appropriate value. This option cannot be combined with other options, and it does not display any output. It is designed for use in a batch file where the return value of the KDbgCtrl program can be tested. Possible return values are as follows:

Value Meaning

0x10001

Full Kernel Debugging is enabled.

0x10002

Full Kernel Debugging is disabled.

Any other value

An error occurred. KDbgCtrl was unable to determine the current status of Full Kernel Debugging.

-td ProcessID File
Obtains a kernel triage dump file. Enter the process ID and a name for the dump file.

-sd {active|automatic|full|kernel|mini}
Sets the dump type to be collected in the event of a system crash and reloads the crash dump stack. See Varieties of Kernel-Mode Dump Files for more info on dump types.

-?
Displays command-line help for KDbgCtrl.

Additional Information

For a description of all the KDbgCtrl settings, see Using KDbgCtrl.