DBH Command-Line Options

The DBH command line uses the following syntax.

dbh [Options] -p:PID [Command] 

dbh [Options] ExecutableName [Command] 

dbh [Options] SymbolFileName [Command] 

dbh -? 

dbh -??  

Parameters

-p:PID

Specifies the process ID of the process whose symbols are to be loaded.

ExecutableName

Specifies the executable file whose symbols are to be loaded, including the file name extension (usually .exe or .sys). You should include a relative or absolute directory path; if no path is included, the current working directory is assumed. If the specified file is not found in this location, DBH searches for it using SymLoadModuleEx.

SymbolFileName

Specifies the symbol file whose symbols are to be loaded, including the file name extension (.pdb or .dbg). You should include a relative or absolute directory path; if no path is included, the current working directory is assumed.

Options

Any combination of the following options.

-d

Causes decorated names to be used when displaying symbols and searching for symbols. When this option is used, SYMOPT_PUBLICS_ONLY is turned on, and both SYMOPT_UNDNAME and SYMOPT_AUTO_PUBLICS are turned off. This is equivalent to issuing the command symopt +4000 followed by symopt -10002 after DBH is running.

-s:Path

Sets the symbol path to the specified Path value.

-n

Turns on noisy symbol loading. Additional information is displayed about the search for symbols. The name of each symbol file is displayed as it is loaded. If the debugger cannot load a symbol file, it displays an error message. Error messages for .pdb files are displayed in text. Error messages for .dbg files are in the form of an error code, explained in the winerror.h file. Not all of these messages are useful, but some of them may be helpful to analyze why a symbol file cannot be found or matched. If an image file is loaded solely to recover symbolic header information, this is displayed as well.

Command

Causes DBH to run, execute the specified Command, and then exit. For a list of possible commands, see DBH Commands.

-?

Displays help text for the DBH command line.

-??

Displays help text for the DBH command line, and displays a list of all DBH commands.

Additional Information

For more information about the DBH tool, see Using DBH.