DBXTOOL(1)DBXTOOL(1)NAMEdbxtool - source-level debugger GUI
SYNOPSISdbxtool [-r] [-E] [execfile] [-] [corefile | process-id ] [arguments]
[--jdkhome path] [--userdir path] [--fontsize size] [--locale lan‐
guage[:country[:variant]]] [--reload path-to-module.jar] [--help]
[--cp:p classpath] [--cp:a classpath] [--laf LaF-classname ]
DESCRIPTIONdbxtool is a graphical user interface (GUI) tool that uses the dbx
debugger for source-level debugging of programs written in C++, ANSI C,
Fortran 77, Fortran 95, and Java programming languages.
If you intend to embed dbxtool in a shell script or driver program,
consider using ss_attach (see ss_attach.1 man page) instead.
execfile is an executable file, produced by a Sun Studio compiler or
GNU compiler with the -g option which includes debugging symbols in the
execfile or its associated object files.
If you know a process-id but not the execfile, you can use the - (dash)
as the execfile and enter the process-id option to attach the process
to dbxtool.
If a corefile argument is specified, you can use dbxtool to examine the
state of the program when the core file was produced.
If you know a corefile name, but not the execfile, you can use the -
(dash) as the execfile and dbx will attempt to extract the program name
from the core file.
You can specify arguments to be passed to the program only if you spec‐
ify the -r option or the -E option.
OPTIONS-r Run execfile immediately. Parameters follow the execfile name
(including redirection). If the program terminates successfully,
dbx exits. Otherwise, if a fault occurs, dbx reports the reason
and waits for a response.
-E Parameters follow the execfile name (including redirection). If
the program terminates successfully, dbx exits. Otherwise, if a
fault occurs, dbx reports the reason and waits for a response.
--jdkhome path
Explicitly specifies the path to the JDK. If this option is not
given, the command looks for the JDK_HOME environment variable or
the JAVA_PATH environment variable to determine a path to the JDK.
If neither environment variable is set, the command looks for the
JDK in several standard locations.
--userdir path
Explicitly specifies the path to the directory where the tool
stores your settings. If this option is not given, the location
of your user directory is $HOME/.dbxtool/ceres-dev2-<operat‐
ing_system>-<processor_type>.
--fontsize size
Sets the font size, expressed in points, in the tool's user inter‐
face. If this option is not given, the font size is 11 points.
--locale language[:country[:variant]]
Uses specified locale information. --reload path-to-module.jar
Installs or reinstalls a module JAR file. --help Displays the
list of command-line options.
The following options pertain to changing the look and feel of the GUI:
--laf classname
Uses the specified UI class as the tool's look and feel.
--cp:p classpath
Prepends the specified path to the tool's classpath.
--cp:a classpath
Appends the specified path to the tool's classpath.
December 2008 DBXTOOL(1)
