Index

Numbers and Symbols

-count event specification modifier-count n, -count infinity Modifier

-disable event specification modifier-disable Modifier

-g compiler optionCompiling a Program for Debugging

-hidden event specification modifier-hidden Modifier

-if event specification modifier-if Modifier

-in event specification modifier-in Modifier

-instr event specification modifier-instr Modifier

-lwp event specification modifier-lwp Modifier

-perm event specification modifier-perm Modifier

-resumeone event specification modifier

-resumeone Modifier

Filters and Multithreading

-temp event specification modifier-temp Modifier

-thread event specification modifier-thread Modifier

.dbxrc fileUsing the dbx Initialization File

creatingCreating a .dbxrc File

sampleInitialization File Sample

use at dbx startup

Using the dbx Initialization File

dbx Startup Sequence

:: (double-colon) C++ operatorC++ Double-Colon Scope Resolution Operator

A

access checkingUsing Access Checking

access eventaccess Event Specification

address

currentTypes of Program Locations

display formatUsing Formats

examining contents atExamining the Contents of Memory

examplesUsing Addresses

examples of usingExamples of Using an Address

adi assign command

native mode syntaxadi assign Command

adi examine command

native mode syntaxadi examine Command

adjusting default dbx settingsCustomizing dbx

alias commandCreating Your Own dbx Commands

AMD64 registersAMD64 Register Information

ancillary objectsAncillary Files (Oracle Solaris Only)

array_bounds_check dbxenv variabledbx Environment Variables

arrays

bounds, exceedingDebugging Segmentation Faults

evaluating

Evaluating Arrays

Evaluating Arrays

FortranWorking With Arrays

Fortran allocatableFortran Allocatable Arrays

slicing

Using Slices

Evaluating Arrays

syntax for C and C++Array Slicing Syntax for C and C++

syntax for FortranArray Slicing Syntax for Fortran

striding

Using Strides

Evaluating Arrays

assembly language debuggingExamining the Contents of Memory

assign command

syntaxassign Command

using to assign a value to a variable

assign Command

Assigning a Value to a Variable

assigning a value to a variable

assign Command

Assigning a Value to a Variable

at eventat Event Specification

attach command

attach Command

Attaching dbx to a Running Process

Changing the Visiting Scope

attach eventattach Event Specification

attached process, using runtime checking onUsing Runtime Checking on an Attached Process

attaching

dbx to a new process while debugging an existing processAttaching dbx to a Running Process

dbx to a running child processAttaching to Child Processes

dbx to a running Java processTo Attach to a Running Java Process

dbx to a running process

Attaching dbx to a Running Process

Using the Process ID

when dbx is not already runningAttaching dbx to a Running Process

B

backquote operatorBackquote Operator

bcheck commandbcheck Syntax

examplesbcheck Examples

syntaxbcheck Syntax

bind commandRebinding of Editing Functions

block local operatorBlock Local Operator

breakpoints

clearingListing and Deleting Breakpoints

defined

Setting Breakpoints and Traces

Setting Breakpoints

deleting, using handler IDDeleting Specific Breakpoints Using Handler ID Numbers

disablingEnabling and Disabling Breakpoints

enablingEnabling and Disabling Breakpoints

enabling after event occursEnabling a Breakpoint After an Event Occurs

event efficiencyEfficiency Considerations

event specificationsBreakpoint Event Specifications

filtersSetting Filters on Breakpoints

using return value of a function callQualifying Breakpoints With Conditional Filters

In FunctionSetting a Breakpoint in a Function

In ObjectSetting Breakpoints in Objects

listing

Listing Breakpoints and Traces

Listing and Deleting Breakpoints

multiple, setting in nonmember functionsSetting Multiple Breakpoints in Nonmember Functions

On Value ChangeStopping Execution When Variables Change

overviewSetting Breakpoints

setting

at a line

Setting a Breakpoint at a Line of Source Code

Setting Breakpoints

at a member function of a template class or at a template functionstop in Command

at all instances of a function templatestop infunction Command

at an addressSetting a Breakpoint at an Address

at class template instantiations

stop inclass Command

Debugging With C++ Templates

at function template instantiations

stop inclass Command

Debugging With C++ Templates

filters onSetting Filters on Breakpoints

in a function

Setting a Breakpoint in a Function

Setting Breakpoints

in all member functions of a classSetting Breakpoints in All Member Functions of a Class

in an explicitly loaded librarySetting a Breakpoint in an Explicitly Loaded Library

in dynamically loaded librariesSetting Breakpoints in Dynamically Loaded Libraries

in member functions of different classesSetting Breakpoints in Member Functions of Different Classes

in native (JNI) codeSetting Breakpoints in Native (JNI) Code

in objectsSetting Breakpoints in Objects

in shared librariesSetting Breakpoints in Shared Libraries

machine levelSetting Breakpoints at the Machine-Instruction Level

multiple breaks in C++ codeSetting Breakpoints in Member Functions of Different Classes

on Java methodsSetting Breakpoints on Java Methods

with filters that contain function callsFilters and Multithreading

stop typeSetting Breakpoints

determining when to setNavigating To Code

trace typeSetting Breakpoints

when typeSetting Breakpoints

setting at a lineExecuting dbx Commands at a Line

bsearch commandbsearch Command

C

C

debugging application that embeds a Java applicationDebugging a C Application or C++ Application That Embeds a Java Application

source files, specifying the location ofSpecifying the Location of Your C Source Files or C++ Source Files

C++

ambiguous or overloaded functionsSelecting From a List of C++ Ambiguous Function Names

backquote operatorBackquote Operator

class

declarations, looking upViewing Variables, Members, Types, and Classes

definition, looking upLooking Up Definitions of Types and Classes

displaying all the data members directly defined byPrinting C++ Pointers

displaying all the data members inherited fromPrinting C++ Pointers

printing the declaration ofLooking Up Definitions of Types and Classes

seeing inherited membersLooking Up Definitions of Types and Classes

viewingViewing Variables, Members, Types, and Classes

compiling with the -g optionCompiling With the g Option

compiling with the -g0 optionCompiling With the g Option

debugging application that embeds a Java applicationDebugging a C Application or C++ Application That Embeds a Java Application

double-colon scope resolution operatorC++ Double-Colon Scope Resolution Operator

exception handlingException Handling in dbx

function template instantiations, listingLooking Up Definitions of Variables, Members, and Functions

inherited membersLooking Up Definitions of Types and Classes

mangled namesLinker Names

object pointer typesPrinting C++ Pointers

printingPrinting C++ Pointers

setting multiple breakpoints

Setting Breakpoints in Member Functions of Different Classes

Setting Multiple Breakpoints in C++ Programs

source files, specifying the location ofSpecifying the Location of Your C Source Files or C++ Source Files

template debuggingDebugging With C++ Templates

template definitions

displayingLooking Up Definitions of Variables, Members, and Functions

tracing member functionsSetting a Trace

unnamed argumentsEvaluating Unnamed Arguments in C++ Programs

using dbx withUsing dbx With C++

call safetyCall Safety

call stackUsing the Call Stack

deleting

all frame filtersHiding Stack Frames

framesHiding Stack Frames

finding your place onFinding Your Place on the Stack

frame, definedUsing the Call Stack

hiding framesHiding Stack Frames

looking atLooking at the Call Stack

moving

downMoving Down the Stack

to a specific frame inMoving to a Specific Frame

upMoving Up the Stack

popping

pop Command

Popping the Call Stack

removing the stopped-in function fromPopping the Call Stack

walking

Walking the Stack and Returning Home

Walking the Call Stack to Navigate To Code

call command

safetyCall Safety

syntaxcall Command

using to call a functionCalling a Function

using to call a function explicitlyCalling a Function

using to call a procedure

call Command

Calling a Function

using to explicitly call a function instantiation or member function of a class templatecall Command

calling

function

Calling a Function

Calling a Function

function instantiation or member function of a class templatecall Command

member template functionsDebugging With C++ Templates

procedurecall Command

cancel commandcancel Command

catch blocksException Handling in dbx

catch signal listCatching Signals

catch command

catch Command

Trapping the FPE Signal (Oracle Solaris Only)

Catching Signals

catching exceptions of a specific typeintercept Command

change eventchange Event Specification

changing

default signal listsChanging the Default Signal Lists

check command

check Command

Enabling All Runtime Checking

Enabling Memory Access Checking

Finding Memory Access Problems and Memory Leaks

–access optionaccess Option

–all optionall Option

combining leaksCombining Leaks

–leaks optionleaks Option

–memuse optionmemuse Option

checkpoints, saving a series of debugging runs asSaving a Series of Debugging Runs as Checkpoints

child process

attaching dbx toAttaching to Child Processes

debuggingAttaching to Child Processes

interacting with eventsInteracting With Events

using runtime checking onUsing Runtime Checking on a Child Process

choosing among multiple occurrences of a symbolChoosing Among Multiple Occurrences

class template instantiations, printing a list ofDebugging With C++ Templates

class template instantiations, printing a list ofwhereis Command

classes

displaying all the data members directly defined byPrinting C++ Pointers

displaying all the data members inherited fromPrinting C++ Pointers

looking up declarations ofViewing Variables, Members, Types, and Classes

looking up definitions ofLooking Up Definitions of Types and Classes

printing the declarations ofLooking Up Definitions of Types and Classes

seeing inherited membersLooking Up Definitions of Types and Classes

viewingViewing Variables, Members, Types, and Classes

CLASSPATHX dbxenv variable

Environment Variables for Java Debugging

dbx Environment Variables

clear commandclear Command

clearing breakpointsListing and Deleting Breakpoints

collector hwprofile commandcollector hwprofile Command

collector archive commandcollector archive Command

collector dbxsample commandcollector dbxsample Command

collector disable commandcollector disable Command

collector enable commandcollector enable Command

collector heaptrace commandcollector heaptrace Command

collector limit commandcollector limit Command

collector pause commandcollector pause Command

collector profile commandcollector profile Command

collector resume commandcollector resume Command

collector sample commandcollector sample Command

collector show commandcollector show Command

collector status commandcollector status Command

collector store commandcollector store Command

collector synctrace commandcollector synctrace Command

collector tha commandcollector tha Command

collector version commandcollector version Command

collector commandcollector Command

commandsCommand Reference

dbxenvSetting dbxenv Variables

debug

using to attach to a child processAttaching to Child Processes

handling exceptionsCommands for Handling Exceptions

killChecking for Leaks

print

using to dereference a pointerDereferencing Pointers

process controlControlling Program Execution

setting startup propertiesSetting Startup Properties

stop

using to set breakpoint at all member functions of a C++ template classstop inclass Command

that alter the state of your programCommands That Alter the State of the Program

threadViewing the Context of Another Thread

whenEvent Handlers

compiling

code for debuggingCompiling Your Code for Debugging

optimized codeCompiling With the g Option

with the –g0 optionCompiling a Program for Debugging

with the –g optionCompiling a Program for Debugging

cond eventcond Event Specification

cont command

continuing execution of your program with

Running Your Program

Continuing Execution of a Program

syntaxcont Command

using to continue execution of your program from a different line

cont at Command

Continuing Execution of a Program

using to resume execution of a multithreaded programResuming Execution

continuing execution of a programContinuing Execution of a Program

at a specified line

cont at Command

Continuing Execution of a Program

core file

core file truncationIf Your Core File Is Truncated

debugging

Debugging a Core File

Examining a Core File

debugging mismatchedDebugging a Mismatched Core File

examiningExamining a Core File

using debug command to debug a core fileDebugging a Core File in the Same Operating Environment

core_lo_pathmap dbxenv variabledbx Environment Variables

count

usingUsing Count

creating

a .dbxrc fileCreating a .dbxrc File

event handlersCreating Event Handlers

creating a separate debug fileHow to Create a Separate Debug File

current addressTypes of Program Locations

current procedure and fileCurrent Procedure and File

customizing dbxCustomizing dbx

D

dalias commanddalias Command

data change event specificationsData Change Event Specifications

data member, printingLooking Up Definitions of Variables, Members, and Functions

dbx

attaching to a processAttaching dbx to a Running Process

customizingCustomizing dbx

detaching a process fromDetaching a Process From dbx

detaching from a processDetaching dbx From a Process

quitting

Quitting Debugging

Quitting dbx

starting

Starting a Debugging Session

Starting dbx or dbxtool and Loading Your Program

startup optionsOptions

with core file nameDebugging a Core File

with process ID onlyUsing the Process ID

dbx dbxenv variables

output_pretty_print_fallbackdbx Environment Variables

output_pretty_print_modedbx Environment Variables

dbx command

dbx Command

Using the Process ID

Starting a Debugging Session

dbx commands

at the machine-instruction levelUsing dbx at the Machine-Instruction Level

creating your ownCreating Your Own dbx Commands

differences between Korn shell andUsing dbx With the Korn Shell

Java expression evaluation inJava Expression Evaluation in dbx Commands

process controlControlling Program Execution

setting startup propertiesSetting Startup Properties

static and dynamic information used by when debugging Java codeStatic and Dynamic Information Used by dbx Commands

that alter the state of your programCommands That Alter the State of the Program

using in Java modeUsing dbx Commands in Java Mode

valid only in Java modeCommands Valid Only in Java Mode

with different syntax in Java modeCommands With Different Syntax in Java Mode

with identical syntax and functionality in Java mode and native modeCommands With Identical Syntax and Functionality in Java Mode and Native Mode

dbx modes for debugging Java codeSpecifying 64-bit JVM Software

switching from Java or JNI to native modeSwitching From Java or JNI Mode to Native Mode

switching modes when you interrupt executionSwitching Modes When You Interrupt Execution

dbx online helpAccessing dbx Online Help

dbxenv variabledbx Environment Variables

dbxenv command

dbxenv Command

Setting dbxenv Variables

Setting dbx Environment Variables

dbxenv variables

Setting dbxenv Variables

Setting dbxenv Variables

descriptions ofdbx Environment Variables

follow_fork_modeFollowing the fork Function

for Java debuggingEnvironment Variables for Java Debugging

Korn shell, anddbxenv Variables and the Korn Shell

settingSetting dbxenv Variables

setting with the dbxenv commandSetting dbxenv Variables

dbxrc file, use at dbx startupUsing the dbx Initialization File

dbxrc file, use at dbx startupdbx Startup Sequence

dbxtool

Starting a Debugging Session

Starting a Debugging Session

Getting Started With dbx

debug commandChanging the Visiting Scope

syntaxdebug Command

using to attach dbx to a running processAttaching dbx to a Running Process

using to attach to a child processAttaching to Child Processes

using to debug a core fileDebugging a Core File in the Same Operating Environment

debug_file_directory dbxenv variabledbx Environment Variables

debugging

assembly languageExamining the Contents of Memory

child processesAttaching to Child Processes

code compiled without -g optionCode Compiled Without the -g Option

core file

Debugging a Core File

Examining a Core File

creating a separate debug fileHow to Create a Separate Debug File

machine-instruction level

Stepping and Tracing at Machine-Instruction Level

Debugging at the Machine-Instruction Level

mismatched core fileDebugging a Mismatched Core File

multithreaded programsDebugging Multithreaded Applications

optimized codeDebugging Optimized Code

replaying a saved debugging runSaving and Restoring Using replay

saving a runSaving and Restoring a Debugging Run

using a separate debug fileUsing a Separate Debug File

ancillary objectsAncillary Files (Oracle Solaris Only)

debugging application that embeds a Java application

CDebugging a C Application or C++ Application That Embeds a Java Application

C++Debugging a C Application or C++ Application That Embeds a Java Application

debugging information

reading in

Listing Debugging Information for Modules

Listing Debugging Information for Modules

debugging run

saved

replayingSaving and Restoring Using replay

restoringRestoring a Saved Run

savingSaving and Restoring a Debugging Run

declarations, looking up (displaying)Viewing Variables, Members, Types, and Classes

delete commanddelete Command

deleting

all call stack frame filtersHiding Stack Frames

call stack framesHiding Stack Frames

specific breakpoints using handler IDsDeleting Specific Breakpoints Using Handler ID Numbers

dereferencing a pointerDereferencing Pointers

detach command

detach Command

Detaching a Process From dbx

detach eventdetach Event Specification

detaching

a process from dbx

Detaching dbx From a Process

Detaching a Process From dbx

a process from dbx and leaving it in a stopped stateDetaching dbx From a Process

determining

at symbol dbx usesDetermining Which Symbol dbx Uses

cause of floating-point exception (FPE)Determining the Cause of the Exception

granularity of source line steppingControlling Single Stepping Behavior

location of floating-point exception (FPE)Determining Where the Exception Occurred

number of instructions executedDetermining the Number of Instructions Executed by a Source Line

number of lines executedDetermining the Number of Lines Executed

where your program is crashingExamining a Core File

dis command

dis Command

Using the dis Command

Types of Program Locations

disabling

runtime checkingDisabling Runtime Checking

disassembler_version dbxenv variabledbx Environment Variables

display command

display Command

Monitoring Expressions

Monitoring Expressions

displaying

all the data members directly defined by a classPrinting C++ Pointers

all the data members inherited from a base classPrinting C++ Pointers

declarationsViewing Variables, Members, Types, and Classes

definitions of templates and instances

whatis Command

Debugging With C++ Templates

inherited membersLooking Up Definitions of Types and Classes

source code for function template instantiationsDebugging With C++ Templates

stack traceDisplaying and Reading a Stack Trace

symbols, occurrences ofPrinting a List of Occurrences of a Symbol

template definitionsLooking Up Definitions of Variables, Members, and Functions

type of an exceptionexception Command

unnamed function argumentEvaluating Unnamed Arguments in C++ Programs

variable typeLooking Up Definitions of Variables, Members, and Functions

variables and expressionsMonitoring Expressions

dlclose event

valid variablesVariable Valid for dlopen and dlclose Events

dlopen eventdlopen and dlclose Event Specification

valid variablesVariable Valid for dlopen and dlclose Events

down command

down Command

Moving Down the Stack

Changing the Visiting Scope

dump commanddump Command

using on OpenMP codeUsing the dump Command

dynamic linkerDynamic Linker

E

edit commandedit Command

enabling

a breakpoint after an event occursEnabling a Breakpoint After an Event Occurs

memory access checking

Enabling All Runtime Checking

Enabling Memory Access Checking

Finding Memory Access Problems and Memory Leaks

memory leak checking

Enabling All Runtime Checking

Enabling Memory Use and Memory Leak Checking

Finding Memory Access Problems and Memory Leaks

memory use checking

Enabling All Runtime Checking

Enabling Memory Use and Memory Leak Checking

Finding Memory Access Problems and Memory Leaks

error suppression

Suppression of Last Error

Suppressing Errors

defaultDefault Suppressions

examplesSuppressing Error Examples

scopeTypes of Suppression

typesTypes of Suppression

establishing a new mapping from directory to directory

Finding Source and Object Files

Mapping the Compile-Time Directory to the Debug-Time Directory

evaluating

arrays

Evaluating Arrays

Evaluating Arrays

function instantiation or member function of a class templateprint Expressions

unnamed function argumentEvaluating Unnamed Arguments in C++ Programs

event counters

Using Event Counters

Using Event Counters

event handler

hiding-hidden Modifier

retaining across debugging sessions-perm Modifier

event handlers

creatingCreating Event Handlers

manipulatingManipulating Event Handlers

setting, examplesEvent Handler Examples

event management

Event Management

Event Management

event specification modifiers, descriptions ofEvent Specification Modifiers

event specifications

Setting Event Specifications

Creating Event Handlers

Event Handlers

for breakpoint eventsBreakpoint Event Specifications

for data change eventsData Change Event Specifications

for execution progress eventsExecution Progress Event Specifications

for OpenMP codeUsing Events

for synchronizationSynchronization Events

otherOther Events

for other types of eventsOther Event Specifications

for synchronizationSynchronization Events

for system eventsSystem Event Specifications

for thread trackingTracked Thread Event Specifications

keywords, definedSetting Event Specifications

machine-instruction levelSetting Breakpoints at the Machine-Instruction Level

modifiersEvent Specification Modifiers

settingSetting Event Specifications

using predefined variablesUsing Predefined Variables

event-specific variablesVariables Valid for when Command

event_safety dbxenv variabledbx Environment Variables

events

ambiguityParsing and Ambiguity

child process interaction withInteracting With Events

parsingParsing and Ambiguity

examine command

examine Command

Using the examine or x Command

Types of Program Locations

examining the contents of memoryExamining the Contents of Memory

exception handlingException Handling in dbx

examplesExamples of Exception Handling

exception command

exception Command

exception Command

exceptions

floating point, determining cause ofDetermining the Cause of the Exception

floating point, determining location ofDetermining Where the Exception Occurred

in Fortran programs, locatingLocating Exceptions

of a specific type, catchingintercept Command

removing types from intercept listunintercept Command

reporting where type would be caughtwhocatches Command

type of, displayingexception Command

exec function, followingFollowing the exec Function

executables

separate debugging informationDebugging Information in Object Files and Executables

execution progress event specificationsExecution Progress Event Specifications

exists commandexists Command

exit eventexit Event Specification

valid variablesVariable Valid for exit Event

experiments

limiting the size ofSyntax

expressions

displayingMonitoring Expressions

Fortran

complexShowing Complex Expressions

intervalShowing Interval Expressions

monitoring changesMonitoring Expressions

monitoring the value ofMonitoring Expressions

printing the value of

print Command

Printing the Value of a Variable, Expression, or Identifier

stop the display ofStop the Display (Undisplaying)

F

fault eventfault Event Specification

fflush(stdout), after dbx callsCalling a Function

field type

displayingLooking Up Definitions of Variables, Members, and Functions

printingLooking Up Definitions of Variables, Members, and Functions

file command

file Command

Changing the Visiting Scope

Types of Program Locations

Navigating To a File

files

finding

Finding Source and Object Files

Mapping the Compile-Time Directory to the Debug-Time Directory

location ofFinding Source and Object Files

navigating toNavigating To a File

qualifying nameQualifying Symbols With Scope Resolution Operators

files commandfiles Command

filter_max_length dbxenv variabledbx Environment Variables

finding

object filesMapping the Compile-Time Directory to the Debug-Time Directory

place on the call stackFinding Your Place on the Stack

source files

Finding Source and Object Files

Mapping the Compile-Time Directory to the Debug-Time Directory

fix and continue

using with runtime checkingUsing Fix and Continue With Runtime Checking

fix command

fix Command

fix Command

fix_verbose dbxenv variabledbx Environment Variables

fixed commandfixed Command

fixing

programfix Command

floating-point exception (FPE)

catchingCatch Floating-Point Exceptions

determining cause ofDetermining the Cause of the Exception

determining location ofDetermining Where the Exception Occurred

follow_fork_inherit dbxenv variabledbx Environment Variables

follow_fork_inherit dbxenv variableInteracting With Events

follow_fork_mode dbxenv variabledbx Environment Variables

follow_fork_mode dbxenv variable

Following the fork Function

Using Runtime Checking on a Child Process

follow_fork_mode_inner dbxenv variabledbx Environment Variables

fork function, followingFollowing the fork Function

Fortran

allocatable arraysFortran Allocatable Arrays

allocatable scalar typeAllocatable Scalar Type

array slicing syntax forArray Slicing Syntax for Fortran

case sensitivityUppercase Letters

complex expressionsShowing Complex Expressions

derived typesViewing Fortran Derived Types

interval expressionsShowing Interval Expressions

intrinsic functionsShowing Intrinsic Functions

logical operatorsShowing Logical Operators

Object OrientedObject Oriented Fortran

sample dbx sessionSample dbx Session

structuresViewing Fortran Derived Types

fortran_modules commandfortran_modules Command

FPE signal, trappingTrapping the FPE Signal (Oracle Solaris Only)

frame, definedUsing the Call Stack

frame command

frame Command

Moving to a Specific Frame

Changing the Visiting Scope

func command

func Command

Changing the Visiting Scope

Types of Program Locations

Navigating To Functions

funcs commandfuncs Command

function argument, unnamed

Evaluating Unnamed Arguments in C++ Programs

Evaluating Unnamed Arguments in C++ Programs

function template instantiations

displaying the source code forDebugging With C++ Templates

printing a list of

whereis Command

Debugging With C++ Templates

printing the values ofDebugging With C++ Templates

functions

ambiguous or overloadedSelecting From a List of C++ Ambiguous Function Names

calling

Calling a Function

Calling a Function

inlined, in optimized codeInlined Functions

instantiation

callingcall Command

evaluatingprint Expressions

printing source listing forlist Expressions

intrinsic, FortranShowing Intrinsic Functions

looking up definitions ofLooking Up Definitions of Variables, Members, and Functions

member of a class template, callingcall Command

member of class template, evaluatingprint Expressions

navigating toNavigating To Functions

obtaining names assigned by the compilerEvaluating Unnamed Arguments in C++ Programs

qualifying nameQualifying Symbols With Scope Resolution Operators

setting breakpoints inSetting a Breakpoint in a Function

setting breakpoints in C++ codeSetting Breakpoints in All Member Functions of a Class

G

gdb commandgdb Command

H

handler id, definedCreating Event Handlers

handler command

handler Command

Using Event Counters

handlersEvent Handlers

creating

Creating Event Handlers

Event Handlers

enabling while within a functionEnabling a Handler While Within a Function

hide command

hide Command

Hiding Stack Frames

hiding call stack framesHiding Stack Frames

I

ignore signal listCatching Signals

ignore command

ignore Command

Catching Signals

Intercepting and Cancelling the SIGINT Signal

import commandimport Command

In Function breakpointSetting a Breakpoint in a Function

In Object breakpointSetting Breakpoints in Objects

in eventin Event Specification

inclass eventinclass Event Specification

infile eventinfile Event Specification

infunction eventinfunction Event Specification

inherited members

displayingLooking Up Definitions of Types and Classes

seeingLooking Up Definitions of Types and Classes

inmember eventinmember Event Specification

inmethod event

inmember Event Specification

inmember Event Specification

inobject eventinobject Event Specification

input_case_sensitive dbxenv variabledbx Environment Variables

input_case_sensitive environment variableUppercase Letters

input_case_sensitive environment variableUppercase Letters

instances, displaying the definitions of

whatis Command

Debugging With C++ Templates

Intel registersx86 Register Information

intercept command

intercept Command

intercept Command

invocation optionsOptions

J

JAR file, debuggingDebugging a JAR File

Java applications

attaching dbx toAttaching dbx to a Running Java Application

specifying custom wrappers forSpecifying a Custom Wrapper for Your Java Application

starting to debugStarting to Debug a Java Application

that require 64-bit librariesAttaching dbx to a Running Java Application

types you can debug with dbxStarting to Debug a Java Application

with wrappers, debuggingDebugging a Java Application That Has a Wrapper

Java class file, debuggingDebugging a Class File

Java code

capabilities of dbx withCapabilities of dbx With Java Code

dbx modes for debuggingSpecifying 64-bit JVM Software

limitations of dbx withLimitations of dbx With Java Code

static and dynamic information used by dbx commandsStatic and Dynamic Information Used by dbx Commands

using dbx withUsing dbx With Java Code

Java debugging, environment variables forEnvironment Variables for Java Debugging

Java modedbx Modes for Debugging Java Code

dbx commands valid only inCommands Valid Only in Java Mode

different syntax than dbx commandsCommands With Different Syntax in Java Mode

identical syntax and functionality for dbx commandsCommands With Identical Syntax and Functionality in Java Mode and Native Mode

switching from Java or JNI to native modeSwitching From Java or JNI Mode to Native Mode

using dbx commands inUsing dbx Commands in Java Mode

Java source files, specifying the location ofSpecifying the Location of Your Java Source Files

java commandjava Command

JAVASRCPATH dbxenv variable

Environment Variables for Java Debugging

dbx Environment Variables

jclasses commandjclasses Command

jdbx_mode dbxenv variable

Environment Variables for Java Debugging

dbx Environment Variables

joff commandjoff Command

jon commandjon Command

jpkgs commandjpkgs Command

JVM software

customizing startup ofCustomizing Startup of the JVM Software

passing run arguments to

Passing Run Arguments to the JVM Software

Passing Arguments to the JVM Software

specifying 64-bitSpecifying 64-bit JVM Software

specifying a path name forSpecifying a Path Name for the JVM Software

jvm_invocation dbxenv variable

Environment Variables for Java Debugging

dbx Environment Variables

K

key bindings for editors, displaying or modifyingRebinding of Editing Functions

kill command

kill Command

Checking for Leaks

Killing a Program Without Terminating the Session

killing

programKilling a Program Without Terminating the Session

Korn shell

differences from dbxUsing dbx With the Korn Shell

extensionsExtensions to ksh-88

features not implementedksh-88 Features Not Implemented

renamed commandsRenamed Commands

L

language commandlanguage Command

language_mode dbxenv variabledbx Environment Variables

lastrites eventlastrites Event Specification

LD_AUDITAttached Process on a System Running Oracle Solaris

LD_PRELOADAttached Process on a System Running Linux

leak checkingEnabling Memory Use and Memory Leak Checking

libraries

dynamically loaded, setting breakpoints inSetting Breakpoints in Dynamically Loaded Libraries

shared, compiling for dbxShared Libraries Require the -g Option for Full dbx Support

librtc.so, preloadingAttached Process on a System Running Linux

librtld_db.soLink Map

libthread_db.soUnderstanding Multithreaded Debugging

limiting the experiment sizeSyntax

line command

line Command

Types of Program Locations

link mapLink Map

linker namesLinker Names

list command

Changing the Visiting Scope

Types of Program Locations

syntaxlist Command

using to print a source listing for a file or functionPrinting a Source Listing

using to print the source listing for a function instantiationlist Expressions

listi command

listi Command

Using the listi Command

listing

all program modules that contain debugging informationListing Modules

breakpoints

Listing Breakpoints and Traces

Listing and Deleting Breakpoints

C++ function template instantiationsLooking Up Definitions of Variables, Members, and Functions

debugging information for modulesListing Debugging Information for Modules

names of all program modulesListing Modules

names of modules containing debugging information that have already been read into dbxListing Modules

signals currently being ignoredCatching Signals

signals currently being trappedCatching Signals

tracesListing Breakpoints and Traces

load object, definedDynamic Linker

loading your programStarting dbx or dbxtool and Loading Your Program

loadobject command

–dumpelf flagloadobject -dumpelf Command

–exclude flagloadobject -exclude Command

–hide flagloadobject -hide Command

–list flagloadobject -list Command

–load flagloadobject -load Command

–unload flagloadobject -unload Command

–use flagloadobject -use Command

loadobject commandloadobject Command

looking up

definitions of membersLooking Up Definitions of Variables, Members, and Functions

definitions of classesLooking Up Definitions of Types and Classes

definitions of functionsLooking Up Definitions of Variables, Members, and Functions

definitions of typesLooking Up Definitions of Types and Classes

definitions of variablesLooking Up Definitions of Variables, Members, and Functions

this pointerLooking Up Definitions of Variables, Members, and Functions

lwp commandlwp Command

lwp_exit eventlwp_exit Event Specification

LWPs (lightweight processes)Understanding Multithreaded Debugging

information displayed forUnderstanding LWP Information

showing information aboutUnderstanding LWP Information

statesThread and LWP States

lwps command

lwps Command

Understanding LWP Information

M

machine-instruction level

address, setting breakpoint atSetting a Breakpoint at an Address

AMD64 registersAMD64 Register Information

debuggingDebugging at the Machine-Instruction Level

Intel registersx86 Register Information

printing the value of all the registersUsing the regs Command

setting breakpoint at addressSetting Breakpoints at the Machine-Instruction Level

single steppingSingle-Stepping at the Machine-Instruction Level

SPARC registersSPARC Register Information

tracingTracing at the Machine-Instruction Level

using dbxUsing dbx at the Machine-Instruction Level

macro

compiler and compiler optionsCompiler and Compiler Options

definition method

Compiler and Compiler Options

Macro Definitions

limitationsLimitations

skimmingSkimming Errors

tradeoffs in functionalityTradeoffs in Functionality

definitionsMacro Definitions

expansionAdditional Uses of Macro Expansion

skimmingSkimming Errors

macro command

macro Command

Additional Uses of Macro Expansion

macro_expand dbxenv variabledbx Environment Variables

macro_expand dbxenv variableAdditional Uses of Macro Expansion

macro_source dbxenv variabledbx Environment Variables

macro_source dbxenv variableMacro Definitions

manipulating event handlersManipulating Event Handlers

member functions

printingLooking Up Definitions of Variables, Members, and Functions

setting multiple breakpoints inSetting Multiple Breakpoints in C++ Programs

tracingSetting a Trace

member template functionsDebugging With C++ Templates

members

declarations, looking upViewing Variables, Members, Types, and Classes

looking up declarations ofViewing Variables, Members, Types, and Classes

looking up definitions ofLooking Up Definitions of Variables, Members, and Functions

viewingViewing Variables, Members, Types, and Classes

memory

address display formatsUsing Formats

display modesExamining the Contents of Memory

examining contents at addressExamining the Contents of Memory

statesUsing Access Checking

memory access

checking

enablingFinding Memory Access Problems and Memory Leaks

error reportUnderstanding the Memory Access Error Report

errors

Access Errors

Memory Access Errors

memory access checkingUsing Access Checking

enabling

Enabling All Runtime Checking

Enabling Memory Access Checking

memory leak

checkingChecking for Leaks

enablingFinding Memory Access Problems and Memory Leaks

errors

Memory Leak Errors

Detecting Memory Leak Errors

fixingFixing Memory Leaks

reportUnderstanding the Memory Leak Report

memory leak checkingUsing Memory Leak Checking

enabling

Enabling All Runtime Checking

Enabling Memory Use and Memory Leak Checking

memory use checkingUsing Memory Use Checking

enabling

Enabling All Runtime Checking

Enabling Memory Use and Memory Leak Checking

Finding Memory Access Problems and Memory Leaks

mmapfile commandmmapfile Command

module command

module Command

Listing Debugging Information for Modules

modules

all program, listingListing Modules

containing debugging information that have already been read into dbx, listingListing Modules

containing debugging information, listingListing Modules

current, printing the name ofListing Debugging Information for Modules

listing debugging information forListing Debugging Information for Modules

modules command

modules Command

Listing Modules

Listing Debugging Information for Modules

monitoring the value of an expressionMonitoring Expressions

moving

down the call stackMoving Down the Stack

to a specific frame in the call stackMoving to a Specific Frame

up the call stackMoving Up the Stack

mt_resume_one dbxenv variabledbx Environment Variables

mt_scalable dbxenv variabledbx Environment Variables

mt_sync_tracking dbxenv variabledbx Environment Variables

multithreaded programs, debuggingDebugging Multithreaded Applications

N

native commandnative Command

navigating

through functions by walking the call stackWalking the Call Stack to Navigate To Code

to a fileNavigating To a File

to functionsNavigating To Functions

next command

next Command

Stepping Through a Program

next eventnext Event Specification

nexti command

nexti Command

Single-Stepping at the Machine-Instruction Level

O

object files

findingMapping the Compile-Time Directory to the Debug-Time Directory

loadingObject File Loading

separate debugging informationDebugging Information in Object Files and Executables

object pointer typesPrinting C++ Pointers

obtaining the function name assigned by the compilerEvaluating Unnamed Arguments in C++ Programs

omp_atomic eventomp_atomic Event Specification

omp_barrier eventomp_barrier Event Specification

omp_critical eventomp_critical Event Specification

omp_flush eventomp_flush Event Specification

omp_loop commandomp_loop Command

omp_master eventomp_master Event Specification

omp_ordered eventomp_ordered Event Specification

omp_pr commandomp_pr Command

omp_serialize commandomp_serialize Command

omp_single eventomp_single Event Specification

omp_task eventomp_task Event Specification

omp_taskwait eventomp_taskwait Event Specification

omp_team commandomp_team Command

omp_tr commandomp_tr Command

online help, accessingAccessing dbx Online Help

OpenMP application programming interfaceDebugging OpenMP Programs

OpenMP code

dbx functionality available fordbx Functionality Available for OpenMP Code

events for, otherOther Events

events for, synchronizationSynchronization Events

execution sequence ofExecution Sequence of OpenMP Code

printing a description of the current loopPrinting Region and Thread Information

printing a description of the current parallel regionPrinting Region and Thread Information

printing a description of the current task regionPrinting Region and Thread Information

printing all the threads on the current teaPrinting Region and Thread Information

printing shared, private, and thread private variables inPrinting Variables and Expressions

serializing the execution of the next encountered parallel regionSerializing the Execution of a Parallel Region

single-stepping inSingle-Stepping Into a Parallel Region

transformation by compilersHow Compilers Transform OpenMP Code

using stack traces withUsing Stack Traces

using the dump command onUsing the dump Command

operators

backquoteBackquote Operator

block localBlock Local Operator

C++ double colon scope resolutionC++ Double-Colon Scope Resolution Operator

optimized code

about parameters and variablesParameters and Variables

compilingCompiling With the g Option

debuggingDebugging Optimized Code

inlined functionsInlined Functions

output_auto_flush dbxenv variabledbx Environment Variables

output_base dbxenv variabledbx Environment Variables

output_class_prefix dbxenv variabledbx Environment Variables

output_data_member_only dbxenv variabledbx Environment Variables

output_dynamic_type dbxenv variabledbx Environment Variables

output_dynamic_type dbxenv variableexception Command

output_dynamic_type environment variablePrinting C++ Pointers

output_inherited_members dbxenv variabledbx Environment Variables

output_list_size dbxenv variabledbx Environment Variables

output_log_file_name dbxenv variabledbx Environment Variables

output_max_object_size dbxenv variabledbx Environment Variables

output_max_string_length dbxenv variabledbx Environment Variables

output_no_literal dbxenv variabledbx Environment Variables

output_pretty_print dbxenv variabledbx Environment Variables

output_pretty_print environment variableUsing Pretty-Printing

output_pretty_print_mode environment variableUsing Pretty-Printing

output_short_file_name dbxenv variabledbx Environment Variables

overload_function dbxenv variabledbx Environment Variables

overload_operator dbxenv variabledbx Environment Variables

P

pathmap commandFinding Source and Object Files

skimmingUsing the pathmap Command to Improve Skimming

syntaxpathmap Command

using to map the compile-time directory to the debug-time directoryMapping the Compile-Time Directory to the Debug-Time Directory

pointers

dereferencingDereferencing Pointers

printingPointer to Fortran Derived Type

pop command

syntaxpop Command

using to change the current stack frameChanging the Visiting Scope

using to pop frames from the call stackpop Command

using to remove frames from the call stackPopping the Call Stack

pop_auto_destruct dbxenv variabledbx Environment Variables

popping

the call stack

pop Command

Popping the Call Stack

predefined variables for event specificationUsing Predefined Variables

preloading

librtc.soAttached Process on a System Running Linux

rtcaudit.soAttached Process on a System Running Oracle Solaris

pretty-printingUsing Pretty-Printing

call-basedCall-Based Pretty-Printing

failuresPossible Failures

function considerationsPretty-Printing Function Considerations

filtersPython Pretty-Print Filters

invokingInvoking Pretty-Printing

Python

Using Python

Python Pretty-Print Filters

APIPython Pretty-Print API Documentation

Python DocsPython Pretty-Print API Documentation

print command

syntaxprint Command

syntax to slice a C or C++ arrayArray Slicing Syntax for C and C++

syntax to slice a Fortran arrayArray Slicing Syntax for Fortran

using to dereference a pointerDereferencing Pointers

using to evaluate a function instantiation or a member function of a class templateprint Expressions

using to evaluate a variable or expressionPrinting the Value of a Variable, Expression, or Identifier

using to print the value of an expressionprint Command

printing

all the threads on the current teamPrinting Region and Thread Information

arraysEvaluating Arrays

data memberLooking Up Definitions of Variables, Members, and Functions

declaration of a type or C++ classLooking Up Definitions of Types and Classes

description of the current loopPrinting Region and Thread Information

description of the current parallel regionPrinting Region and Thread Information

description of the current task regionPrinting Region and Thread Information

field typeLooking Up Definitions of Variables, Members, and Functions

list of all class and function template instantiationsDebugging With C++ Templates

list of all class and function template instantiationswhereis Command

list of all known threadsViewing the Threads List

list of occurrences of a symbolPrinting a List of Occurrences of a Symbol

list of threads normally not printed (zombies)Viewing the Threads List

member functionsLooking Up Definitions of Variables, Members, and Functions

name of the current moduleListing Debugging Information for Modules

pointerPointer to Fortran Derived Type

shared, private, and thread private variables in OpenMP codePrinting Variables and Expressions

source listingPrinting a Source Listing

source listing for the specified function instantiationlist Expressions

tvalue of a variable or expressionPrinting the Value of a Variable, Expression, or Identifier

value of all the machine-level registersUsing the regs Command

value of an expressionprint Command

values of function template instantiationsDebugging With C++ Templates

variable typeLooking Up Definitions of Variables, Members, and Functions

proc commandproc Command

proc_exclusive_attach dbxenv variabledbx Environment Variables

proc_gone eventproc_gone Event Specification

valid variablesVariable Valid for proc_gone Events

procedure linkage tablesProcedure Linkage Tables

procedure, callingcall Command

process

attached, using runtime checking onUsing Runtime Checking on an Attached Process

attaching dbx using process IDUsing the Process ID

child

attaching dbx toAttaching to Child Processes

using runtime checking onUsing Runtime Checking on a Child Process

detaching from dbx

Detaching dbx From a Process

Detaching a Process From dbx

detaching from dbx and leaving in a stopped stateDetaching dbx From a Process

running, attaching dbx to

Attaching dbx to a Running Process

Attaching dbx to a Running Process

stopping executionStopping a Process Execution

stopping with Ctrl+CUsing Ctrl+C to Stop a Process

process control commands, definitionControlling Program Execution

prog commandprog Command

prog_new eventprog_new Event Specification

program

continuing execution ofContinuing Execution of a Program

at a specified linecont at Command

fixingfix Command

killing

Killing a Program Without Terminating the Session

Killing a Program Without Terminating the Session

multithreaded

debuggingDebugging Multithreaded Applications

resuming execution ofResuming Execution

runningRunning a Program

under dbx, impacts ofImpacts of Running a Program Under dbx

with runtime checking enabledRunning Your Program

single-stepping throughControlling Single Stepping Behavior

status, checkingChecking Program Status

stepping throughStepping Through a Program

stopping execution

if a conditional statement evaluates to trueStopping Execution on a Condition

if the value of a specified variable has changedStopping Execution When Variables Change

strippedCompletely Stripped Programs

python-docs

commandPython Pretty-Print API Documentation

python-docs commandpython-docs Command

Q

qualifying symbol namesQualifying Symbols With Scope Resolution Operators

quit commandquit Command

quitting a dbx sessionQuitting Debugging

quitting dbxQuitting dbx

R

reading a stack traceDisplaying and Reading a Stack Trace

reading in

debugging information

Listing Debugging Information for Modules

Listing Debugging Information for Modules

registers

AMD64 architectureAMD64 Register Information

Intel architecturex86 Register Information

printing the value ofUsing the regs Command

SPARC architectureSPARC Register Information

regs command

regs Command

Using the regs Command

removing

exception types from intercept listunintercept Command

stopped-in function from the call stackPopping the Call Stack

replay command

replay Command

Saving and Restoring Using replay

Saving and Restoring a Debugging Run

replaying a saved debugging runSaving and Restoring Using replay

reporting where an exception type would be caughtwhocatches Command

rerun commandrerun Command

resetting application files for replayResetting Application Files for replay

restore command

restore Command

Restoring a Saved Run

Saving and Restoring a Debugging Run

restoring a saved debugging runRestoring a Saved Run

resuming

execution of a multithreaded programResuming Execution

returns event

returns Event Specification

returns Event Specification

rprint

commandrprint Command

rtc showmap commandrtc showmap Command

rtc skippatch commandrtc skippatch Command

skipping instrumentationPerformance Improves When Sufficient Patch Area Is Available Within 8 MB of All Existing Code (SPARC Platforms Only).

rtc_auto_continue dbxenv variabledbx Environment Variables

rtc_auto_continue dbxenv variableEnabling Batch Mode Directly From dbx

rtc_auto_continue environment variableRunning Your Program

rtc_auto_suppress dbxenv variabledbx Environment Variables

rtc_auto_suppress dbx variableSuppression of Last Error

rtc_biu_at_exit dbxenv variabledbx Environment Variables

rtc_biu_at_exit dbxenv variablesUsing Memory Use Checking

rtc_error_limit dbxenv variabledbx Environment Variables

rtc_error_limit dbxenv variableLimiting the Number of Errors Reported

rtc_error_log_file_name dbxenv variabledbx Environment Variables

rtc_error_log_file_name dbxenv variableEnabling Batch Mode Directly From dbx

rtc_error_log_file_name environment variableRunning Your Program

rtc_error_stack dbxenv variabledbx Environment Variables

rtc_inherit dbxenv variabledbx Environment Variables

rtc_mel_at_exit dbxenv variabledbx Environment Variables

rtcaudit.so, preloadingAttached Process on a System Running Oracle Solaris

rtldDynamic Linker

run command

run Command

Running a Program

run_autostart dbxenv variabledbx Environment Variables

run_io dbxenv variabledbx Environment Variables

run_pty dbxenv variabledbx Environment Variables

run_quick dbxenv variabledbx Environment Variables

run_savetty dbxenv variabledbx Environment Variables

run_setpgrp dbxenv variabledbx Environment Variables

runargs commandrunargs Command

running a program

Running a Program

Running Your Program in dbx

in dbx without arguments

Running a Program

Running Your Program in dbx

with runtime checking enabledRunning Your Program

runtime checking

access checkingUsing Access Checking

application programming interfaceRuntime Checking Application Programming Interface

attached processUsing Runtime Checking on an Attached Process

child processUsing Runtime Checking on a Child Process

disablingDisabling Runtime Checking

error suppressionSuppressing Errors

errorsRuntime Checking Errors

fixing memory leaksFixing Memory Leaks

limitationsRuntime Checking Limitations

memory access

checkingUsing Access Checking

error reportUnderstanding the Memory Access Error Report

errors

Access Errors

Memory Access Errors

memory leak

checking

Checking for Leaks

Using Memory Leak Checking

error reportUnderstanding the Memory Leak Report

errors

Memory Leak Errors

Detecting Memory Leak Errors

memory use checkingUsing Memory Use Checking

possible leaksPossible Leaks

requirementsRuntime Checking Requirements

suppressing errorsSuppressing Errors

defaultDefault Suppressions

examplesSuppressing Error Examples

suppression of last errorSuppression of Last Error

troubleshooting tipsTroubleshooting Tips

types of error suppressionTypes of Suppression

using fix and continue withUsing Fix and Continue With Runtime Checking

using in batch modeUsing Runtime Checking in Batch Mode

directly from dbxEnabling Batch Mode Directly From dbx

when to useWhen to Use Runtime Checking

S

sample .dbxrc fileInitialization File Sample

save command

save Command

Using the save Command

Saving and Restoring a Debugging Run

saving

debugging run to a file

Saving a Series of Debugging Runs as Checkpoints

Saving and Restoring a Debugging Run

series of debugging runs as checkpointsSaving a Series of Debugging Runs as Checkpoints

scopeProgram Scope

changing the visitingChanging the Visiting Scope

current

Variables That Reflect the Current Scope

Navigating To Code

lookup rules, relaxingRelaxing the Scope Lookup Rules

visitingVisiting Scope

changingChanging the Visiting Scope

components ofComponents of the Visiting Scope

scope resolution operatorsQualifying Symbols With Scope Resolution Operators

scope resolution search pathScope Resolution Search Path

scope-look-aside dbxenv variableRelaxing the Scope Lookup Rules

scope_global_enums dbxenv variabledbx Environment Variables

scope_look_aside dbxenv variabledbx Environment Variables

scopes commandscopes Command

search commandsearch Command

segmentation fault

finding line number ofUsing dbx to Locate Problems

Fortran, causesDebugging Segmentation Faults

generatingUsing dbx to Locate Problems

separate debugging information

executablesDebugging Information in Object Files and Executables

object filesDebugging Information in Object Files and Executables

session, dbx

quittingQuitting Debugging

startingStarting a Debugging Session

session_log_file_name dbxenv variabledbx Environment Variables

setting

a traceSetting a Trace

breakpoints

at a member function of a template class or at a template functionstop in Command

at all instances of a function templatestop infunction Command

in all member functions a classSetting Breakpoints in All Member Functions of a Class

in dynamically loaded librariesSetting Breakpoints in Dynamically Loaded Libraries

in member functions of different classesSetting Breakpoints in Member Functions of Different Classes

in native (JNI) codeSetting Breakpoints in Native (JNI) Code

in objectsSetting Breakpoints in Objects

on Java methodsSetting Breakpoints on Java Methods

when breakpoint at a lineExecuting dbx Commands at a Line

with filters that contain function callsFilters and Multithreading

dbxenv variables with the dbxenv commandSetting dbxenv Variables

filters on breakpointsSetting Filters on Breakpoints

multiple breakpoints in nonmember functionsSetting Multiple Breakpoints in Nonmember Functions

shared libraries

compiling for dbxShared Libraries Require the -g Option for Full dbx Support

setting breakpoints inSetting Breakpoints in Shared Libraries

shared objects

.init sectionsStartup Sequence and .init Sections

startup sequenceStartup Sequence and .init Sections

show_static_members dbxenv on | off variabledbx Environment Variables

showblock command

showblock Command

Enabling Memory Use and Memory Leak Checking

showleaks command

combining leaksCombining Leaks

default output ofFixing Memory Leaks

error limit forLimiting the Number of Errors Reported

report resulting fromPossible Leaks

syntaxshowleaks Command

using to ask for a leaks reportGenerating a Leak Report

showmemuse command

showmemuse Command

Using Memory Use Checking

sig eventsig Event Specification

valid variablesVariables Valid for sig Event

signals

cancellingUnderstanding Signal Events

catchingCatching Signals

changing default listsChanging the Default Signal Lists

forwardingUnderstanding Signal Events

FPE, trappingTrapping the FPE Signal (Oracle Solaris Only)

handling automaticallyAutomatically Handling Signals

ignoringCatching Signals

listing those currently being ignoredCatching Signals

listing those currently being trappedCatching Signals

names that dbx acceptsCatching Signals

sending in a programSending a Signal to a Program

single stepping

through a programControlling Single Stepping Behavior

single-stepping

at the machine-instruction levelSingle-Stepping at the Machine-Instruction Level

skimming

errorsSkimming Errors

improving by using pathmap commandUsing the pathmap Command to Improve Skimming

slicing

arraysUsing Slices

C and C++ arraysArray Slicing Syntax for C and C++

Fortran arraysArray Slicing Syntax for Fortran

source files

finding

Finding Source and Object Files

Mapping the Compile-Time Directory to the Debug-Time Directory

specifying the location of

CSpecifying the Location of Your C Source Files or C++ Source Files

C++Specifying the Location of Your C Source Files or C++ Source Files

Java source filesSpecifying the Location of Your Java Source Files

source listing, printingPrinting a Source Listing

source commandsource Command

SPARC registersSPARC Register Information

specifying a path for class files that use custom class loadersSpecifying a Path for Class Files That Use Custom Class Loaders

stack frame, definedUsing the Call Stack

stack traceTracing Calls

displayingDisplaying and Reading a Stack Trace

example

Displaying and Reading a Stack Trace

Displaying and Reading a Stack Trace

FortranTracing Calls

readingDisplaying and Reading a Stack Trace

using on OpenMP codeUsing Stack Traces

stack-find-source environment variableChanging the Visiting Scope

stack_find_source dbxenv variabledbx Environment Variables

stack_max_size dbxenv variabledbx Environment Variables

stack_verbose dbxenv variabledbx Environment Variables

starting dbxStarting dbx or dbxtool and Loading Your Program

starting dbxtoolStarting dbx or dbxtool and Loading Your Program

startup optionsOptions

status commandstatus Command

step to command

Native Mode Syntax

Stepping Through a Program

Stepping Through Your Program

step up command

Native Mode Syntax

Stepping Through a Program

step command

step Command

Exception Handling in dbx

Stepping Through a Program

step eventstep Event Specification

step_abflow dbxenv variabledbx Environment Variables

step_events dbxenv variabledbx Environment Variables

step_events environment variableEfficiency Considerations

step_granularity dbxenv variabledbx Environment Variables

step_granularity environment variableControlling Single Stepping Behavior

stepi command

stepi Command

Single-Stepping at the Machine-Instruction Level

stepping into a functionStepping Into a Specific or Last Function

stepping through a program

Stepping Through a Program

Stepping Through Your Program

stop

display of a particular variable or expressionStop the Display (Undisplaying)

display of all currently monitored variablesStop the Display (Undisplaying)

stop access command

Native Mode Syntax

Stopping Execution When an Address Is Accessed

stop at command

Native Mode Syntax

Setting a Breakpoint at a Line of Source Code

stop change command

Native Mode Syntax

Stopping Execution When Variables Change

stop cond command

Native Mode Syntax

Stopping Execution on a Condition

stop in command

Native Mode Syntax

Setting a Breakpoint in a Function

stop inclass command

Native Mode Syntax

Setting Breakpoints in All Member Functions of a Class

stop infile commandNative Mode Syntax

stop inmember command

Native Mode Syntax

Native Mode Syntax

Setting Breakpoints in Member Functions of Different Classes

stop inobject command

Native Mode Syntax

Setting Breakpoints in Objects

stop commandstop in Command

syntaxstop Command

using to set breakpoint at all member functions of a C++ template classstop inclass Command

using to set breakpoints at all instances of a function templatestop infunction Command

using to stop in all member functions of a C++ template classstop inclass Command

stop eventstop Event Specification

stopi command

stopi Command

Setting Breakpoints at the Machine-Instruction Level

stopping

in all member functions of a template classstop inclass Command

process executionStopping a Process Execution

process with Ctrl+CUsing Ctrl+C to Stop a Process

program execution

if a conditional statement evaluates to trueStopping Execution on a Condition

if the value of a specified variable has changedStopping Execution When Variables Change

striding across slices of arraysUsing Strides

stripped programsCompletely Stripped Programs

suppress command

syntaxsuppress Command

using to limit reporting of runtime checking errorsRunning Your Program

using to list errors being suppressed in files not compiled for debuggingDefault Suppressions

using to manage runtime checking errorsUsing Suppression to Manage Errors

using to suppress runtime checking errorsSuppressing Errors

suppress_startup_message dbxenv variabledbx Environment Variables

suppression of last errorSuppression of Last Error

symbol names, qualifying scopeQualifying Symbols With Scope Resolution Operators

symbol_info_compression dbxenv variabledbx Environment Variables

symbols

choosing among multiple occurrences ofChoosing Among Multiple Occurrences

determining which dbx usesDetermining Which Symbol dbx Uses

printing a list of occurrencesPrinting a List of Occurrences of a Symbol

sync commandsync Command

sync eventsync Event Specification

syncrtld eventsyncrtld Event Specification

syncs commandsyncs Command

sysin eventsysin Event Specification

valid variablesVariables Valid for sysin and sysout Events

sysout eventsysout Event Specification

valid variablesVariables Valid for sysin and sysout Events

system event specificationsSystem Event Specifications

T

templates

classDebugging With C++ Templates

stopping in all member functions ofstop inclass Command

displaying the definitions of

whatis Command

Debugging With C++ Templates

functionDebugging With C++ Templates

instantiationsDebugging With C++ Templates

printing a list of

whereis Command

Debugging With C++ Templates

looking up declarations ofLooking Up Definitions of Types and Classes

thr_create event

thr_create [thread-ID] Event Specification

Understanding Thread Creation Activity

valid variablesVariables Valid for thr_create Event

thr_exit event

thr_exit Event Specification

Understanding Thread Creation Activity

thread creation, understandingUnderstanding Thread Creation Activity

thread command

thread Command

Viewing the Context of Another Thread

threads

current, displayingViewing the Context of Another Thread

information displayed forThread Information

list, viewingViewing the Threads List

other, switching viewing context toViewing the Context of Another Thread

printing list of all knownViewing the Threads List

printing list of normally not printed (zombies)Viewing the Threads List

resuming only the first in which a breakpoint was hitFilters and Multithreading

statesThread and LWP States

switching to by thread IDViewing the Context of Another Thread

threads command

threads Command

Viewing the Threads List

throw eventthrow Event Specification

timer eventtimer Event Specification

trace output, directing to a fileDirecting Trace Output to a File

trace command

trace Command

Setting a Trace

trace_speed dbxenv variabledbx Environment Variables

trace_speed environment variableControlling the Speed of a Trace

tracei command

tracei Command

Tracing at the Machine-Instruction Level

traces

controlling speed ofControlling the Speed of a Trace

implementingImplementing a Simple Trace

listing

Listing Breakpoints and Traces

Listing Breakpoints and Traces

settingSetting a Trace

traces at the machine-instruction levelTracing at the Machine-Instruction Level

trip countersUsing Event Counters

troubleshooting tips, runtime checkingTroubleshooting Tips

types

declarations, looking upViewing Variables, Members, Types, and Classes

derived, FortranViewing Fortran Derived Types

looking up declarations ofViewing Variables, Members, Types, and Classes

looking up definitions ofLooking Up Definitions of Types and Classes

printing the declaration ofLooking Up Definitions of Types and Classes

viewingViewing Variables, Members, Types, and Classes

U

uncheck command

uncheck Command

Disabling Runtime Checking

undisplay command

undisplay Command

Stop the Display (Undisplaying)

Stop the Display (Undisplaying)

unhide command

unhide Command

Hiding Stack Frames

unintercept command

unintercept Command

unintercept Command

unsuppress command

unsuppress Command

Default Suppressions

Suppressing Errors

unwatch commandunwatch Command

up command

up Command

Moving Up the Stack

Changing the Visiting Scope

use commanduse Command

V

variable type, displayingLooking Up Definitions of Variables, Members, and Functions

variables

assigning values to

assign Command

Assigning a Value to a Variable

declarations, looking upViewing Variables, Members, Types, and Classes

determining which dbx is evaluatingVerifying Which Variable dbx Uses

displaying functions and files in which definedVerifying Which Variable dbx Uses

event specific

Variables Valid for when Command and Specific Events

Variables Valid for when Command

examiningExamining Variables

looking up declarations ofViewing Variables, Members, Types, and Classes

looking up definitions ofLooking Up Definitions of Variables, Members, and Functions

monitoring changesMonitoring Expressions

outside of scopeVariables Outside the Scope of the Current Function

printing the value ofPrinting the Value of a Variable, Expression, or Identifier

qualifying namesQualifying Symbols With Scope Resolution Operators

stop the display ofStop the Display (Undisplaying)

viewingViewing Variables, Members, Types, and Classes