JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Solaris Studio 12.2: Debugging a Program With dbx
search filter icon
search icon

Document Information

Preface

1.  Getting Started With dbx

2.  Starting dbx

3.  Customizing dbx

4.  Viewing and Navigating To Code

5.  Controlling Program Execution

6.  Setting Breakpoints and Traces

7.  Using the Call Stack

8.  Evaluating and Displaying Data

9.  Using Runtime Checking

10.  Fixing and Continuing

11.  Debugging Multithreaded Applications

12.  Debugging Child Processes

13.  Debugging OpenMP Programs

14.  Working With Signals

15.  Debugging C++ With dbx

16.  Debugging Fortran Using dbx

17.  Debugging a Java Application With dbx

18.  Debugging at the Machine-Instruction Level

19.  Using dbx With the Korn Shell

20.  Debugging Shared Libraries

A.  Modifying a Program State

B.  Event Management

C.  Command Reference

Index

Numbers and Symbols

A

B

C

D

E

F

G

H

I

J

K

L

M

N

O

P

Q

R

S

T

U

V

W

X

C

C++
ambiguous or overloaded functions, Selecting From a List of C++ Ambiguous Function Names
backquote operator, Backquote Operator
class
declarations, looking up, Viewing Variables, Members, Types, and Classes
definition, looking up, Looking Up Definitions of Types and Classes
displaying all the data members directly defined by, Printing C++ Pointers
displaying all the data members inherited from, Printing C++ Pointers
printing the declaration of, Looking Up Definitions of Types and Classes
seeing inherited members, Looking Up Definitions of Types and Classes
viewing, Viewing Variables, Members, Types, and Classes
compiling with the -g option, Compiling with the -g Option
compiling with the -g0 option, Compiling with the -g Option
double-colon scope resolution operator, C++ Double Colon Scope Resolution Operator
exception handling, Exception Handling in dbx
function template instantiations, listing, Looking Up Definitions of Variables, Members, and Functions
inherited members, Looking Up Definitions of Types and Classes
mangled names, Linker Names
object pointer types, Printing C++ Pointers
printing, Printing C++ Pointers
setting multiple breakpoints
Setting Multiple Breaks in C++ Programs
Setting Breakpoints in Member Functions of Different Classes
template debugging, Debugging With C++ Templates
template definitions
displaying, Looking Up Definitions of Variables, Members, and Functions
fixing, Fixing C++ Template Definitions
tracing member functions, Setting a Trace
unnamed arguments, Evaluating Unnamed Arguments in C++ Programs
using dbx with, Using dbx With C++
C++ application that embeds a Java application, debugging, Debugging a C Application or C++ Application That Embeds a Java Application
C++ source files, specifying the location of, Specifying the Location of Your C Source Files or C++ Source Files
C application that embeds a Java application, debugging, Debugging a C Application or C++ Application That Embeds a Java Application
c_array_op environment variable, Setting dbx Environment Variables
C source files, specifying the location of, Specifying the Location of Your C Source Files or C++ Source Files
call command
syntax, call Command
using to call a function, Calling a Function
using to call a function explicitly, Calling a Function
using to call a procedure
Calling a Function
call Command
using to explicitly call a function instantiation or member function of a class template, call function_name(parameters) Command
call stack, Using the Call Stack
defined, Using the Call Stack
deleting
all frame filters, Hiding Stack Frames
frames, Hiding Stack Frames
finding your place on, Finding Your Place on the Stack
frame, defined, Using the Call Stack
hiding frames, Hiding Stack Frames
looking at, Looking at the Call Stack
moving
down, Moving Down the Stack
to a specific frame in, Moving to a Specific Frame
up, Moving Up the Stack
popping
Popping the Call Stack
Changing a Function Currently Being Executed
Changing a Function Presently on the Stack
pop Command
one frame of, Changing Variables After Fixing
removing the stopped in function from, Popping the Call Stack
walking
Walking the Call Stack to Navigate To Code
Walking the Stack and Returning Home
calling
a function
Calling a Function
Calling a Function
a function instantiation or a member function of a class template, call function_name(parameters) Command
a procedure, call Command
member template functions, Debugging With C++ Templates
cancel command, cancel Command
case sensitivity, Fortran, Uppercase Letters
catch blocks, Exception Handling in dbx
catch command
Catching Signals
Trapping the FPE Signal (Solaris Platforms Only)
catch Command
catch signal list, Catching Signals
catching exceptions of a specific type, intercept [-all] [-x] [-set] [typename] Command
change event, change variable
changing
a function not yet called, Changing a Function Not Yet Called
an executed function, Changing an Executed Function
default signal lists, Changing the Default Signal Lists
function currently being executed, Changing a Function Currently Being Executed
function presently on the stack, Changing a Function Presently on the Stack
variables after fixing, Changing Variables After Fixing
check command
Finding Memory Access Problems and Memory Leaks
Turning On Memory Access Checking
Turning On All Runtime Checking
check Command
checkpoints, saving a series of debugging runs as, Saving a Series of Debugging Runs as Checkpoints
child process
attaching dbx to, Attaching to Child Processes
debugging, Attaching to Child Processes
interacting with events, Interacting With Events
using runtime checking on, Using Runtime Checking on a Child Process
choosing among multiple occurrences of a symbol, Choosing Among Multiple Occurrences
class template instantiations, printing a list of
Debugging With C++ Templates
whereis name Command
classes
displaying all the data members directly defined by, Printing C++ Pointers
displaying all the data members inherited from, Printing C++ Pointers
looking up declarations of, Viewing Variables, Members, Types, and Classes
looking up definitions of, Looking Up Definitions of Types and Classes
printing the declarations of, Looking Up Definitions of Types and Classes
seeing inherited members, Looking Up Definitions of Types and Classes
viewing, Viewing Variables, Members, Types, and Classes
CLASSPATHX environment variable
Setting dbx Environment Variables
Environment Variables for Java Debugging
clear command, clear Command
clearing breakpoints, Listing and Clearing Breakpoints
code compiled without -g option, Code Compiled Without the -g Option
collector archive command, collector archive Command
collector command, collector Command
collector dbxsample command, collector dbxsample Command
collector disable command, collector disable Command
collector enable command, collector enable Command
collector heaptrace command, collector heaptrace Command
collector hw_profile command, collector hw_profile Command
collector limit command, collector limit Command
collector mpitrace command, collector mpitrace Command
collector pause command, collector pause Command
collector profile command, collector profile Command
collector resume command, collector resume Command
collector sample command, collector sample Command
collector show command, collector show Command
collector status command, collector status Command
collector store command, collector store Command
collector synctrace command, collector synctrace Command
collector tha command, collector tha Command
collector version command, collector version Command
commands
alias, Creating Your Own dbx Commands
assign
syntax, assign Command
using to assign a value to a variable
Assigning a Value to a Variable
assign Command
using to reassign correct values to global variables, Changing Variables After Fixing
using to restore a global variable, Changing Variables After Fixing
attach
Attaching dbx to a Running Process
attach Command
bcheck, bcheck Syntax
bind, Rebinding of Editing Functions
bsearch, bsearch Command
call
syntax, call Command
using to call a function, Calling a Function
using to call a procedure
Calling a Function
call Command
using to explicitly call a function instantiation or member function of a class template, call function_name(parameters) Command
cancel, cancel Command
catch
Catching Signals
Trapping the FPE Signal (Solaris Platforms Only)
catch Command
check
Finding Memory Access Problems and Memory Leaks
Turning On Memory Access Checking
Turning On All Runtime Checking
check Command
clear, clear Command
collector, collector Command
collector archive, collector archive Command
collector dbxsample, collector dbxsample Command
collector disable, collector disable Command
collector enable, collector enable Command
collector heaptrace, collector heaptrace Command
collector hw_profile, collector hw_profile Command
collector limit, collector limit Command
collector mpitrace, collector mpitrace Command
collector pause, collector pause Command
collector profile, collector profile Command
collector resume, collector resume Command
collector sample, collector sample Command
collector show, collector show Command
collector status, collector status Command
collector store, collector store Command
collector synctrace, collector synctrace Command
collector tha, collector tha Command
collector version, collector version Command
cont
Continuing After Fixing
Resuming Execution
continuing execution of your program with
Continuing Execution of a Program
Running Your Program
limitations for files compiled without debugging information, How Fix and Continue Operates
syntax, cont Command
using to continue execution after restoring a global variable, Changing Variables After Fixing
using to continue execution of your program from a different line
Continuing Execution of a Program
Changing a Function Presently on the Stack
cont at Command
dalias, dalias Command
dbx
Starting a Debugging Session
Using the Process ID
dbx Command
dbxenv
Setting dbx Environment Variables
Setting dbx Environment Variables
dbxenv Command
debug
syntax, debug Command
using to attach dbx to a running process, Attaching dbx to a Running Process
using to attach to a child process, Attaching to Child Processes
using to debug a core file, Debugging a Core File in the Same Operating Environment
delete, delete Command
detach
Detaching a Process From dbx
Detaching dbx From a Process
detach Command
dis
Types of Program Locations
Using the dis Command
dis Command
display
Monitoring Expressions
Monitoring Expressions
display Command
down
Moving Down the Stack
down Command
dump, dump Command
dump
using on OpenMP code, Using the dump Command
edit, edit Command
examine
Types of Program Locations
Using the examine or x Command
examine Command
exception
exception [-d | +d] Command
exception Command
exists, exists Command
file
Navigating To a File
Types of Program Locations
file Command
files, files Command
fix
How Fix and Continue Operates
Fixing Your Program
fix Command
fix Command
effects of, To Fix Your File
limitations for files compiled without debugging information, How Fix and Continue Operates
fixed, fixed Command
fortran_modules, fortran_modules Command
frame
Moving to a Specific Frame
frame Command
func
Navigating To Functions
Types of Program Locations
func Command
funcs, funcs Command
gdb, gdb Command
handler
Using Event Counters
handler Command
hide
Hiding Stack Frames
hide Command
ignore
Understanding Signal Events
Catching Signals
ignore Command
import, import Command
intercept
intercept [-all] [-x] [-set] [typename] Command
intercept Command
java, java Command
jclasses, jclasses Command
joff, joff Command
jon, jon Command
jpkgs, jpkgs Command
kill
Killing a Program Without Terminating the Session
Checking for Leaks
kill Command
language, language Command
line
Types of Program Locations
line Command
list, Types of Program Locations
syntax, list Command
using to print a source listing for a file or function, Printing a Source Listing
using to print the source listing for a function instantiation, list Expressions
listi
Using the listi Command
listi Command
loadobject, loadobject Command
loadobject -dumpelf, loadobject -dumpelf Command
loadobject -exclude, loadobject -exclude Command
loadobject -hide, loadobject -hide Command
loadobject -list, loadobject -list Command
loadobject -load, loadobject -load Command
loadobject -unload, loadobject -unload Command
loadobject -use, loadobject -use Command
lwp, lwp Command
lwps
Understanding LWP Information
lwps Command
mmapfile, mmapfile Command
module
Listing Debugging Information for Modules
module Command
modules
Listing Debugging Information for Modules
Listing Modules
modules Command
native, native Command
next
Stepping Through a Program
next Command
nexti
Single Stepping at the Machine-Instruction Level
nexti Command
omp_loop, omp_loop Command
omp_pr, omp_pr Command
omp_serialize, omp_serialize Command
omp_team, omp_team Command
omp_tr, omp_tr Command
pathmap
Finding Source and Object Files
To Fix Your File
pathmap Command
using to map the compile-time directory to the debug-time directory, Mapping the Compile-time Directory to the Debug-time Directory
pop
Changing the Visiting Scope
Popping the Call Stack
Changing Variables After Fixing
pop Command
syntax, pop Command
print
syntax, print Command
syntax to slice a C or C++ array, Array Slicing Syntax for C and C++
syntax to slice a Fortran array, Array Slicing Syntax for Fortran
using to dereference a pointer, Dereferencing Pointers
using to evaluate a function instantiation or a member function of a class template, print Expressions
using to evaluate a variable or expression, Printing the Value of a Variable, Expression, or Identifier
using to print the value of an expression, print Command
proc, proc Command
process control, Controlling Program Execution
prog, prog Command
quit, quit Command
regs
Using the regs Command
regs Command
replay
Saving and Restoring a Debugging Run
Saving and Restoring Using replay
replay Command
rerun, rerun Command
restore
Saving and Restoring a Debugging Run
Restoring a Saved Run
restore Command
rprint, rprint Command
rtc showmap, rtc showmap Command
rtc skippatch, rtc skippatch Command
run
Running a Program
run Command
runargs, runargs Command
save
Saving and Restoring a Debugging Run
save Command
scopes, scopes Command
search, search Command
showblock
Turning On Memory Use and Memory Leak Checking
showblock Command
showleaks
default output of, Fixing Memory Leaks
error limit for, Limiting the Number of Errors Reported
report resulting from, Possible Leaks
syntax, showleaks Command
using to ask for a leaks report, Generating a Leak Report
showmemuse
Using Memory Use Checking
showmemuse Command
source, source Command
status, status Command
step
Stepping Through a Program
Exception Handling in dbx
step Command
step to
Stepping Through Your Program
Stepping Through a Program
Native Mode Syntax
step up
Stepping Through a Program
Native Mode Syntax
stepi
Single Stepping at the Machine-Instruction Level
stepi Command
stop, stop in function Command
syntax, stop Command
using to set breakpoint at all member functions of a C++ template class, stop inclass classname Command
using to set breakpoints at all instances of a function template, stop infunction name Command
using to stop in all member functions of a C++ template class, stop inclass classname Command
stop change, Stopping Execution When Variables Change
stop inclass, Setting Breakpoints in All Member Functions of a Class
stop inmember, Setting Breakpoints in Member Functions of Different Classes
stopi
Setting Breakpoints at the Machine-Instruction Level
stopi Command
suppress
syntax, suppress Command
using to limit reporting of runtime checking errors, Running Your Program
using to list errors being suppressed in files not compiled for debugging, Default Suppressions
using to manage runtime checking errors, Using Suppression to Manage Errors
using to suppress runtime checking errors, Suppressing Errors
sync, sync Command
syncs, syncs Command
that alter the state of your program, Commands That Alter the State of the Program
thread
Viewing the Context of Another Thread
thread Command
threads
Viewing the Threads List
threads Command
trace
Setting a Trace
trace Command
tracei
Tracing at the Machine-Instruction Level
tracei Command
uncheck
Turning Off Runtime Checking
uncheck Command
undisplay
Turning Off Display (Undisplaying)
undisplay Command
unhide
Hiding Stack Frames
unhide Command
unintercept
unintercept [-all] [-x] [typename] Command
unintercept Command
unsuppress
Suppressing Errors
Default Suppressions
unsuppress Command
unwatch, unwatch Command
up
Moving Up the Stack
up Command
use, use Command
watch
Monitoring Expressions
watch Command
whatis
Looking Up Definitions of Variables, Members, and Functions
Looking Up Definitions of Types and Classes
syntax, whatis Command
using to display the definitions of templates and instances, whatis name Command
using to obtain the function name assigned by the compiler, Evaluating Unnamed Arguments in C++ Programs
when
Setting a when Breakpoint at a Line
when Command
Event Handlers
when Command
wheni, wheni Command
where
Finding Your Place on the Stack
Tracing Calls
where Command
whereami, whereami Command
whereis
Printing a List of Occurrences of a Symbol
Verifying Which Variable dbx Uses
whereis name Command
whereis Command
which
Choosing Among Multiple Occurrences
Determining Which Symbol dbx Uses
Verifying Which Variable dbx Uses
which Command
whocatches
whocatches typename Command
whocatches Command
x, Using the examine or x Command
compiling
optimized code, Compiling with the -g Option
with the -g option, Compiling a Program for Debugging
with the -g0 option, Compiling a Program for Debugging
your code for debugging, Compiling Your Code for Debugging
cond event, cond condition-expression
cont command
continuing execution of your program with
Continuing Execution of a Program
Running Your Program
limitations for files compiled without debugging information, How Fix and Continue Operates
syntax, cont Command
using to continue execution after restoring a global variable, Changing Variables After Fixing
using to continue execution of your program after fixing, Continuing After Fixing
using to continue execution of your program from a different line
Continuing Execution of a Program
Changing a Function Presently on the Stack
cont at Command
using to resume execution of a multithreaded program, Resuming Execution
continuing execution of a program, Continuing Execution of a Program
after fixing, Continuing After Fixing
at a specified line
Continuing Execution of a Program
cont at Command
controlling the speed of a trace, Controlling the Speed of a Trace
core file
debugging
Examining a Core File
Debugging a Core File
debugging mismatched, Debugging a Mismatched Core File
examining, Examining a Core File
core_lo_pathmap environment variable, Setting dbx Environment Variables
-count event specification modifier, -count n-count infinity
creating
a .dbxrc file, Creating a .dbxrc File
event handlers, Creating Event Handlers
current address, Types of Program Locations
current procedure and file, Current Procedure and File
customizing dbx, Customizing dbx