NAG Fortran Compiler, Release 7.2: <CODE>dbx90</CODE> Commands

Navigation: Previous Up Next

## 3.4 `dbx90` Commands

alias | List command aliases.
alias name text | Create a new alias name with the replacement value text. The replacement text is not limited to a single word but may contain spaces.
assign var = expr | Assign the value of expr to variable var. The variable can be scalar, an array (including an array section), a scalar component, or an element of an array component, but cannot be of derived type. The value must be a scalar expression (see “Expressions” for more details).
cont | Continue execution from where it was stopped (either by a breakpoint or an interrupt).
delete n | Delete breakpoint number n.
delete all | Delete all breakpoints.
display | List the expressions to be displayed after each breakpoint is reached.
display expr | Add expr to the list of expressions to display after each breakpoint. Expr may also be an array section.
dump | Display all local variables and their values.
down [n] | Move the focus down (i.e. to the procedure called by the current procedure). If n is present, move down n levels.
help [topic] | Display a brief help message on the specified topic, or on using dbx90 generally.
history | List the history command buffer. Old commands can be executed with: !! repeat last command, ! n repeat command n in the history buffer, and ! -n repeat the nth last command.
history n | Set the size of the history command buffer to n commands. The default size of the history command buffer is 20.
if expr | This is actually a suffix to the breakpoint (‘stop’) commands not an independent command. It prevents the triggering of the breakpoint until the expression expr (a scalar expression) is `.TRUE.` (or non-zero).
list [line1[,line2]] | Display the next 10 lines of the program, display line line1 of the current file or display lines line1 to line2 of the current file.
next [n] | Execute the next n lines (default 1) of the current (or parent) procedure. Any procedure reference in these lines will be executed in its entirety unless a breakpoint is contained therein.
print expr [,expr]... | Display the value of expr, which can be a scalar expression, array section, derived type component,or a variable of any data type. Several expressions may be given separated by commas.
quit | Exit from dbx90, immediately terminating any program being debugged.
raw dbx-command | Pass dbx-command directly to “dbx”. This is not recommended for normal use.
rerun [command-line] | Begin a new execution of the program, passing command-line to it (if present) or the command-line from the previous run or rerun command if not.
run [command-line] | Begin a new execution of the program, passing command-line to it (if present) or blank command line if not.
scope [name] | Display the current procedure name or set the focus to the specified procedure name.
status | List the breakpoints which are currently set.
step [n] | Execute the next n lines (default 1) of the program, counting lines in referenced procedures (i.e. step into procedure references).
stop name | Set a breakpoint which triggers when variable name is accessed. Note that name cannot be ‘`at`’ or ‘`in`’. This command is not available on Solaris or HP-UX.
stop at lineno | Set a breakpoint at line lineno of the file containing the current procedure.
stop in name | Set a breakpoint at the beginning of procedure name. Note that this breakpoint occurs at the beginning of procedure initialisation, not at the first executable statement. If there is no procedure called ‘`MAIN`’, the main program can be specified using that name.
undisplay expr | Remove expr from the “display” list.
up [n] | Move the focus up (i.e. to the caller of the current procedure). If n is present, move up n levels.
whatis name | Describe how name would be explicitly declared.
where | Display the stack of active procedures with their dummy argument names.
which name | Display the fully qualified form of name which can be used for access from another scope.