Go to the first, previous, next, last section, table of contents.


Debugger commands

Only indispensable commands of dbx are supported in the current version. Generally, the effect of a command is the same as that of dbx. There are, however, slight differences: Commands step and next execute the next statement, but not the next line; therefore, if there are multiple statements in one line, one should issue such commands several times to proceed the next line. The debugger reads in `.dbxinit', which allows the same aliases as is used in dbx.

step
Executes the next statement; if the next statement contains a function call, then enters the function.
next
Executes the next statement.
finish
Enter the debug-mode again after finishing the execuction of the current function. This is useful when an unnecessary step has been executed.
cont
quit
Exits from the debug-mode and continues execution.
up [n]
Move up the call stack one level. Move up the call stack n levels if n is specified.
down [n]
Move down the call stack one level. Move down the call stack n levels if n is specified.
frame [n]
Print the current stack frame with no argument. n specifies the stack frame number to be selected. Here the stack frame number is a number at the top of lines displayed by executing where.
list [startline]
list function
Displays ten lines in a source file from startline, the current line if the startline is not specified, or from the top line of current target function.
print expr
Displays expr.
func function
Set the target function to function.
stop at sourceline [if cond]
stop in function
Set a break-point at the sourceline-th line of the source file, or at the top of the target function. Break-points are removed whenever the relevant function is redefined. When if statements are repeatedly encountered, Asir enters debug-mode only when the corresponding cond parts are evaluated to a non-zero value.
trace expr at sourceline [if cond]
trace expr in function
These are similar to stop. trace simply displays the value of expr and without entering the debug-mode.
delete n
Remove the break point specified by a number n, which can be known by the status command.
status
Displays a list of the break-points.
where
Displays the calling sequence of functions from the top level through the current level.
alias alias command
Create an alias alias for command

The debugger command print can take almost all expressions as its argument. The ordinary usage is to print the values of (programming) variables. However, the following usage is worth to remember.


Go to the first, previous, next, last section, table of contents.