.settings (Set Debug Settings)

The .settings command sets, modifies, displays, loads and saves settings in the Debugger.Settings namespace.

.settings set  namespace.setting=value
.settings set namespace.setting+=value 
.settings save [file path] 
.settings load file path
.settings list [namespace][-v]
.settings help   

Parameters

.settings set parameters

namespace.setting=value
Sets or modifies a setting. When specifying file paths use slash escaping, for example C:\\Symbols\\.

Examples:

.settings set Display.PreferDMLOutput=false

.settings set Sources.DisplaySourceLines=true

.settings set Symbols.Sympath="C:\\Symbols\\"

namespace.setting+=value
Specifies that the new value will be appended to (rather than replace) the previous value.

Example:

.settings set Extensions.ExtensionSearchPath+=";C:\\MyExtension\\"

.setting save parameters

file path
Saves all of the values in the Debugger.Settings namespace to the specified XML file.

none
If a file path is not provided, the settings will be saved to the last file that was loaded or saved to. If a previous file does not exist, a file named config.xml will be created in the directory that the debugger executable was loaded from.

.setting load parameters

file path
Loads all the settings from an XML settings file. Loading settings will change only the settings that are defined in that file. Any previously loaded or changed settings that do not appear in that file will not be modified. This file will be treated as your default save path until the next save or load operation.

.setting list parameters

namespace
List all settings in the given namespace and their values.

-v
The –v flag causes a description of the setting to be displayed.

.setting help parameters

None
Lists all of the settings in the Debugger namespace and their description.

Namespace
Lists all settings in the given namespace and their description.

Environment

Modes

user mode, kernel mode

Targets

live, crash dump

Platforms

all

Additional Information

On launch, the debugger will load all the settings from config.xml in the directory the debugger executable is in. Throughout your debugging session you can modify settings using the previous settings command (like .sympath or .prefer_dml) or the new .settings commands. You can use ‘.settings save’ to save your settings to your settings configuration file. You can use the following command to enable AutoSave.

.settings set AutoSaveSettings=true

When auto save is enabled, the settings in the Debugger.Settings namespace will be automatically saved when exiting the debugger.

Remarks

You can exchange debug xml settings files with others to duplicate their debug settings.