|Important||This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here.|
Symbols, Debugging, Options Dialog Box
To access the Symbols page, click the Tools menu and select Options. In the Options dialog box, expand the Debugging node and select Symbols. This page allows you to set the following general debugging options.
The following potential security threats must be taken into account when using Source Server: Arbitrary commands can be embedded in the application's PDB file, so make sure you put only the ones you want to execute in the srcsrv.ini file. Any attempt to execute a command not in the srcsvr.ini file will cause a confirmation dialog box to appear. For more information, see.No validation is done on command parameters, so be careful with trusted commands. For example, if you trusted cmd.exe, a malicious user might specify parameters that would make the command dangerous.
- Symbol file (.pdb) locations:
A list of locations where the debugger will look for symbol files. Locations can include directories, URLs, shares, and symbol server locations. (C/C++ users, see DBG Files for more information.)
This list should contain only known and trusted locations. Loading symbols from untrusted locations can have harmful effects, as described in the Security Note above.
- Folder icon button
Click this button to create a new location in the list.
- "X" icon button
Select a location in the list and click this button to remove the directory from the list.
- Up-arrow icon button
When a directory is selected in the list, click this button to move up the list.
- Down-arrow icon button
When a directory is selected in the list, click this button to move down the list.
- Cache symbols from symbols server to this directory
You can use a local directory to increase debugger performance when using symbols from a server. This directory will hold symbols for system software obtained from a symbols server. Caching symbols will increase disk usage. Caching is especially useful if you are using a symbol server over the internet. Note that if you are debugging a program on a remote machine the cache directory refers to a directory on the remote machine.
This button allows you to browse and select the directory to use for the preceding item.
- Search the above locations only when symbols are loaded manually.
When selected, the debugger loads symbols from the listed locations only when you do a manual symbol load. Default locations, including the .EXE location, are still searched automatically. If this setting is not selected, the debugger searches the listed locations every time a module is loaded.
- Load symbols using the updated settings when the dialog is closed.
Checking this box causes symbols to be loaded with the updated settings as soon as the dialog box is closed.