JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Solaris Studio 12.3: Debugging a Program With dbx     Oracle Solaris Studio 12.3 Information Library
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.  Macros

D.  Command Reference

assign Command

Native Mode Syntax

Java Mode Syntax

attach Command

Syntax

To Attach to a Running Java Process

bsearch Command

Syntax

call Command

Native Mode Syntax

Java Mode Syntax

cancel Command

Syntax

catch Command

Syntax

check Command

Syntax

clear Command

Syntax

collector Command

Syntax

collector archive Command

Syntax

collector dbxsample Command

Syntax

collector disable Command

Syntax

collector enable Command

Syntax

collector heaptrace Command

Syntax

collector hw_profile Command

Syntax

collector limit Command

Syntax

collector mpitrace Command

Syntax

collector pause Command

Syntax

collector profile Command

Syntax

collector resume Command

Syntax

collector sample Command

Syntax

collector show Command

Syntax

collector status Command

Syntax

collector store Command

Syntax

collector synctrace Command

Syntax

collector tha Command

Syntax

collector version Command

Syntax

cont Command

Syntax

dalias Command

Syntax

dbx Command

Native Mode Syntax

Java Mode Syntax

Options

dbxenv Command

Syntax

debug Command

Native Mode Syntax

Java Mode Syntax

Options

delete Command

Syntax

detach Command

Native Mode Syntax

Java Mode Syntax

dis Command

Syntax

Options

display Command

Native Mode Syntax

Java Mode Syntax

down Command

Syntax

dump Command

Syntax

edit Command

Syntax

examine Command

Syntax

exception Command

Syntax

exists Command

Syntax

file Command

Syntax

files Command

Native Mode Syntax

Java Mode Syntax

fix Command

Syntax

fixed Command

Syntax

fortran_modules Command

Syntax

frame Command

Syntax

func Command

Native Mode Syntax

Java Mode Syntax

funcs Command

Syntax

gdb Command

Syntax

handler Command

Syntax

hide Command

Syntax

ignore Command

Syntax

import Command

Syntax

intercept Command

Syntax

java Command

Syntax

jclasses Command

Syntax

joff Command

Syntax

jon Command

Syntax

jpkgs Command

Syntax

kill Command

Syntax

language Command

Syntax

line Command

Syntax

Examples

list Command

Syntax

Options

Examples

listi Command

loadobject Command

Syntax

loadobject -dumpelf Command

Syntax

loadobject -exclude Command

Syntax

loadobject -hide Command

Syntax

loadobject -list Command

Syntax

loadobject -load Command

Syntax

loadobject -unload Command

Syntax

loadobject -use Command

Syntax

lwp Command

Syntax

lwps Command

Syntax

macro Command

Syntax

mmapfile Command

Syntax

Example

module Command

Syntax

modules Command

Syntax

native Command

Syntax

next Command

Native Mode Syntax

Java Mode Syntax

nexti Command

Syntax

omp_loop Command

Syntax

omp_pr Command

Syntax

omp_serialize Command

Syntax

omp_team Command

Syntax

omp_tr Command

Syntax

pathmap Command

Syntax

Examples

pop Command

Syntax

print Command

Native Mode Syntax

Java Mode Syntax

proc Command

Syntax

prog Command

Syntax

quit Command

Syntax

regs Command

Syntax

Example (SPARC platform)

replay Command

Syntax

rerun Command

Syntax

restore Command

Syntax

rprint Command

Syntax

rtc showmap Command

Syntax

rtc skippatch Command

Syntax

run Command

Native Mode Syntax

Java Mode Syntax

runargs Command

Syntax

save Command

Syntax

scopes Command

Syntax

search Command

Syntax

showblock Command

Syntax

showleaks Command

Syntax

showmemuse Command

Syntax

source Command

Syntax

status Command

Syntax

Example

step Command

Native Mode Syntax

Java Mode Syntax

stepi Command

Syntax

stop Command

Syntax

Native Mode Syntax

Java Mode Syntax

stopi Command

Syntax

suppress Command

Syntax

sync Command

Syntax

syncs Command

Syntax

thread Command

Native Mode Syntax

Java Mode Syntax

threads Command

Native Mode Syntax

Java Mode Syntax

trace Command

Syntax

Native Mode Syntax

Java Mode Syntax

tracei Command

Syntax

uncheck Command

Syntax

undisplay Command

Native Mode Syntax

Java Mode Syntax

unhide Command

Syntax

unintercept Command

Syntax

unsuppress Command

Syntax

unwatch Command

Syntax

up Command

Syntax

use Command

watch Command

Syntax

whatis Command

Native Mode Syntax

Java Mode Syntax

when Command

Syntax

Native Mode Syntax

Java Mode Syntax

wheni Command

Syntax

where Command

Native Mode Syntax

Java Mode Syntax

whereami Command

Syntax

whereis Command

Syntax

which Command

Syntax

whocatches Command

Syntax

Index

collector Command

The collector command collects performance data for analysis by the Performance Analyzer. It is valid only in native mode.

Syntax

collector command_list

Specify one or more of the collector commands

collector archive options

Specify the mode for archiving an experiment when it terminates (see collector archive Command).

collector dbxsample options

Control the collection of samples when dbx stops the target process (see collector dbxsample Command).

collector disable

Stop data collection and close the current experiment (see collector disable Command).

collector enable

Enable the collector and open a new experiment (see collector enable Command).

collector heaptrace options

Enable or disable collection of heap tracing data (see collector heaptrace Command)

collector hwprofile options

Specify hardware counter profiling settings (see collector hw_profile Command).

collector limit options

Limit the amount of profiling data recorded (see collector limit Command).

collector mpitrace options

Enables or disables collection of MPI tracing data (see collector mpitrace Command).

collector pause

Stop collecting performance data but leave experiment open (see collector pause Command).

collector profile options

Specify settings for collecting callstack profiling data (see collector profile Command).

collector resume

Start performance data collection after pause (see collector resume Command).

collector sample options

Specify sampling settings (see collector sample Command

collector show options

Show current collector settings (see collector show Command).

collector status

Inquire status about current experiment (see collector status Command).

collector store options

Experiment file control and settings (see collector store Command).

collector synctrace options

Specify settings for collecting thread synchronization wait tracing data (see collector synctrace Command).

collector tha options

Specify settings for collecting thread analyzer data (see collector tha Command.

collector version

Report the version of libcollector.so that would be used to collect data (see collector version Command).

where:

options are the settings that can be specified with each command.

To start collecting data, type either collector enable.

To turn off data collection, type collector disable.

collector archive Command

The collector archive command specifies the archiving mode to be used when the experiment terminates.

Syntax

collector archive on|off|copy

By default, normal archiving is used. For no archiving, specify off. To copy loadobjects into the experiment for portability, specify copy.

collector dbxsample Command

The collector dbxsample command specifies whether or not to record a sample when the process is stopped by dbx.

Syntax

collector dbxsample on|off

By default, a sample is collected when the process is stopped by dbx. To not collect a sample at this time, specify off.

collector disable Command

The collector disable command causes the data collection to stop and the current experiment to be closed.

Syntax

collector disable

collector enable Command

The collector enable command enables the collector and opens a new experiment.

Syntax

collector enable

collector heaptrace Command

The collector heaptrace command specifies options for collecting heap tracing (memory allocation) data.

Syntax

collector heaptrace on|off

By default, heap tracing data is not collected. To collect this data, specify on.

collector hw_profile Command

The collector hw_profile command specifies options for collecting hardware-counter overflow profiling data.

Syntax

collector hwprofile on|off

By default, hardware-counter overflow profile data is not collected. To collect this data, specify on.

collector hwprofile list

Print out the list of available counters.

collector hwprofile counter name interval [name2 interval2]

Specify hardware counter names and intervals.

where:

name is the name of a hardware counter.

interval is the collection interval in milliseconds.

name2 is the name of a second hardware counter.

interval2 is the collection interval in milliseconds.

Hardware counters are system-specific, so the choice of counters available to you depends on the system you are using. Many systems do not support hardware-counter overflow profiling. On these machines, the feature is disabled.

collector limit Command

The collector limit command specifies the experiment file size limit.

Syntax

collector limit value | unlimited | none

where:

value, in megabytes, limits the amount of profiling data recorded, and must be a positive number.When the limit is reached, no more profiling data is recorded but the experiment remains open and sample points continue to be recorded. By default, there is no limit on the amount of data recorded.

If you have set a limit, specify unlimited or none to remove the limit.

collector mpitrace Command

The collector mpitrace command specifies options for collecting MPI tracing data.

Syntax

collector mpitrace on|off

By default, MPI tracing data is not collected. To collect this data, specify on.

collector pause Command

The collector pause command causes the data collection to stop but leaves the current experiment open. Sample points are not recorded while the Collector is paused. A sample is generated prior to a pause, and another sample is generated immediately following a resum. Data collection can be resumed with the collector resume command (see collector resume Command).

Syntax

collector pause

collector profile Command

The collector profile command specifies options for collecting profile data.

Syntax

collector profile on|off

Specify profile data collection mode.

collector profile timer interval

Specify profile timer period, fixed or floating point, with an optional trailing m for milliseconds or u for microseconds.

collector resume Command

The collector resume command causes the data collection to resume after a pause created by the collector pause command (see collector pause Command).

Syntax

collector resume

collector sample Command

The collector sample command specifies the sampling mode and the sampling interval.

Syntax

collector sample periodic|manual

Specify sampling mode.

collector sample period seconds

Specify sampling interval in seconds.

collector sample record [name]

Record a sample with an optional name.

where:

seconds is the length of the sampling interval.

name is the name of the sample.

collector show Command

The collector show command shows the settings of one or more categories of options.

Syntax

collector show

Show all settings.

collector show all

Show all settings.

collector show archive

Show archive setting.

collector show profile

Show call stack profiling settings.

collector show synctrace

Show thread synchronization wait tracing settings.

collector show hwprofile

Show hardware counter data settings.

collector show heaptrace

Show heap tracing data settings.

collector show limit

Show experiment size limits.

collector show mpitrace

Show MPI trace data settings.

collector show sample

Show sample settings.

collector show store

Show store settings.

collector show tha

Show thread analyzer data settings.

collector status Command

The collector status command inquires about the status of the current experiment.

Syntax

collector status

collector store Command

The collector store command specifies the directory and file name where an experiment is stored.

Syntax

collector store directory pathname

Specify directory where experiment is stored.

collector store filename filename

Specify experiment file name.

collector store group string

Specify experiment group name.

where:

pathname is the pathname of the directory where an experiment is to be stored.

filename is the name of the experiment file

string is the name of an experiment group.

collector synctrace Command

The collector synctrace command specifies options for collecting synchronization wait tracing data.

Syntax

collector synctrace on|off

By default, thread synchronization wait tracing data is not collected. To collect this data, specify on.

collector synctrace threshold microseconds

Specify threshold in microseconds. The default value is 1000.

collector synctrace threshold calibrate

Threshold value will be calculated automatically.

where:

microseconds is the threshold below which synchronization wait events are discarded.

collector tha Command

Syntax

collector tha on|off

By default, thread analyzer data is not collected. To collect this data, specify on.

collector version Command

The collector version command reports the version of libcollector.so that would be used to collect data.

Syntax

collector version