[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

General Programming Concepts: Writing and Debugging Programs


List of dbx Subcommands

The dbx debug program provides subcommands for performing the following task categories:

Setting and Deleting Breakpoints


clear Removes all stops at a given source line.
cleari Removes all breakpoints at an address.
delete Removes the traces and stops corresponding to the specified numbers.
status Displays the currently active trace and stop subcommands.
stop Stops execution of the application program.

Running Your Program


cont Continues running the program from the current breakpoint until the program finishes or another breakpoint is encountered.
detach Exits the debug program, but continues running the application.
down Moves a function down the stack.
goto Causes the specified source line to be the next line run.
gotoi Changes program counter addresses.
next Runs the application program up to the next source line.
nexti Runs the application program up to the next source instruction.
rerun Begins running an application.
return Continues running the application program until a return to the specified procedure is reached.
run Begins running an application.
skip Continues execution from the current stopping point.
step Runs one source line.
stepi Runs one source instruction.
up Move a function up the stack.

Tracing Program Execution


trace Prints tracing information.
tracei Turns on tracing.
where Displays a list of all active procedures and functions.

Ending Program Execution


quit Quits the dbx debug program.

Displaying the Source File


edit Invokes an editor on the specified file.
file Changes the current source file to the specified file.
func Changes the current function to the specified function or procedure.
list Displays lines of the current source file.
listi Lists instructions from the application.
move Changes the next line to be displayed.
/ (Search) Searches forward in the current source file for a pattern.
? (Search) Searches backward in the current source file for a pattern.
use Sets the list of directories to be searched when looking for a file.

Printing and Modifying Variables, Expressions, and Types


assign Assigns a value to a variable.
case Changes the way in which dbx interprets symbols.
dump Displays the names and values of variables in the specified procedure.
print Prints the value of an expression or runs a procedure and prints the return code.
set Assigns a value to a nonprogram variable.
unset Deletes a nonprogram variable.
whatis Displays the declaration of application program components.
whereis Displays the full qualifications of all the symbols whose names match the specified identifier.
which Displays the full qualification of the specified identifier.

Thread Debugging


attribute Displays information about all or selected attributes objects.
condition Displays information about all or selected condition variables.
mutex Displays information about all or selected mutexes.
thread Displays and controls threads.

Multiprocess Debugging


multproc Enables or disables multiprocess debugging.

Procedure Calling


call Runs the object code associated with the named procedure or function.
print Prints the value of an expression or runs a procedure and prints the return code.

Signal Handling


catch Starts trapping a signal before that signal is sent to the application program.
ignore Stops trapping a signal before that signal is sent to the application program.

Machine-Level Debugging


display memory Displays the contents of memory.
gotoi Changes program counter addresses.
map Displays address maps and loader information for the application program.
nexti Runs the application program up to the next machine instruction.
registers Displays the values of all general-purpose registers, system-control registers, floating-point registers, and the current instruction register.
stepi Runs one source instruction.
stopi Sets a stop at a specified location.
tracei Turns on tracing.

Debugging Environment Control


alias Displays and assigns aliases for dbx subcommands.
help Displays help information for dbx subcommands or topics.
prompt Changes the dbx prompt to the specified string.
screen Opens an Xwindow for dbx command output.
sh Passes a command to the shell for execution.
source Reads dbx commands from a file.
unalias Removes an alias.

Related Information

dbx Symbolic Debug Program Overview


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]