[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

5.2 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.


[ << ] [ < ] [ Up ] [ > ] [ >> ]

This document was generated on December 15, 2017 using texi2html 5.0.