Miscellaneous options

The following options are available for use in user-defined configurations but do not appear in the debugger's default configuration:

• ``Debug command''

• ``Exec command''

Debug command

Debug Command is available only in user-defined configurations. The configuration specifying this option must also associate a command string with the option. See ``Configuration''. The command string can contain any valid command-line debugger command as well as some special ``Command variables''. When the option is selected, the Command Variables are expanded, and the resulting string is passed to the command-line debugger for execution. The results are displayed in a popup window.

Command variables

Several special variables are maintained by the debugger for use in the ``Debug command'' and ``Exec command'' options. These variables may be used anywhere within a Debug Command or Exec Command command string. Their values are expanded and substituted within the command string before the string is passed to the command-line debugger or shell for execution. There is no way for the user to explicitly set the values of these variables. The Command Variables currently defined are:

$FILE

Evaluates to the name of the source file currently displayed in the ``Source pane'' associated with the window from which the command was invoked.

$LINE

Evaluates to the current line number of the source file currently displayed in the ``Source pane'' associated with the window from which the command was invoked.

$SELECTION

Evaluates to the text of the current selection in the ``Command pane'', ``Disassembly pane'', ``Registers pane'', ``Source pane'', or Secondary Source panes.

Exec command

Exec Command is available only in user-defined configurations. The configuration specifying this option must also associate a command string with the option. See ``Configuration''. The command string can contain any valid shell command as well as some special ``Command variables''. When the option is selected, the Command Variables are expanded, and the resulting string is passed to the shell for execution.