[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 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.
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

The dbx Symbolic Debug Program Overview.

The dbx command.


[ Previous | Next | Contents | Glossary | Home | Search ]