Invoking dbXtra and dbxtra from the command line
The syntax for dbXtra and dbxtra is:
dbXtra [X11-options] [options] [objfile [corefile | processid]]
dbxtra [options] [objfile [corefile]]
The
first form of the command is used within the X Window
System Version 11 (X11).
It invokes
dbXtra(CP),
the Motif version of the debugger, which uses
various X11 and Motif objects. All X11-options are passed on to
X11. See
X(X).
You may need to set the environment variable DISPLAY in order
to run dbXtra. This variable informs your system of the address
of the X Window display you are using. See
X(X).
The second form of the command invokes
dbxtra(CP),
the curses version
of the debugger.
That version is suitable for use with most common
alphanumeric terminals as well as from within a terminal emulator
window application (such as xterm) within X windows.
The object file specified by objfile contains the executable
instructions of the program to be debugged.
If objfile is not specified,
you are prompted for the name of the file.
If this object file was compiled with the -g flag,
also included in the file are
the symbol table information needed
to identify the variables by their source names,
and the line numbers and filenames of the source code
for each executable source line.
A warning is issued if the object file
does not have this extra information.
The core file specified by corefile determines
the state of the program when it faulted.
If it is not specified, then the file named core
in the current directory is used if it exists.
If the core file does not coincide with the program being debugged, for
example, if it was created when another program had faulted, it is
ignored.
If the file .dbxtrarc exists in the current directory, then the
debugger commands in it are executed.
The debugger also checks for a .dbxtrarc in
the user's home directory
if there is not one in the current directory.
One or more of the following options may be specified in any order:
-C++-
Invoke in C++ interaction mode;
assumed by default.
Use this option
if the program being debugged was developed using C++.
It has no effect if the program was written in C.
Use of this option activates the dbXtra Options menu button C/C++,
which toggles between C and C++ interaction modes.
For further information about debugging C++ programs, see
``C++ specific debugging features''.
-C-
Invoke in C interaction mode only.
C++ information is not
read in and the dbXtra Options menu button C/C++
is not activated.
-F-
Load only one symbol table entry for each
unique definition of a structure or union or enum.
This means that if more than
one definition of an identifier, at the same scope, is present in a
program (for example, if the definition is in an include file used
by various modules), then all the definitions of the identifier are
assumed to be the same.
The use of this option results in faster load time and requires
significantly less memory for larger programs.
NOTE:
If the program
contains non-unique definitions of the same identifier at the same scope,
use of this option causes the symbol table of the debugger
to be different from that of the program.
-I dir-
By default, the debugger searches for source files
in the current directory
and in the directory where objfile is located.
The -I option adds the specified
directory dir to the search path.
Directories can also be added to the directory search path with
the use command (Source menu button: Source Path).
You can specify multiple -I options on the command line.
The order
of the directories in the search path is the same as the order
specified on the command line.
-c file-
Execute the debugging commands in the file before
reading from standard input.
These commands are read after any .dbxtrarc
files are read.
-r-
Execute objfile immediately.
If it terminates successfully, the debugger exits.
Otherwise, the reason for termination is reported
and you are offered the option of entering the debugger
or letting the program fault.
When
-r is specified and standard input is not a terminal,
the debugger reads from /dev/tty.
-s-
For dbxtra only; do not invoke the screen manager.
The debugger works in line mode only
and does not respond to any of the screen-related commands
(including screen).
-x-
Ignore xref file when initializing.
NOTE:
Unless -r is specified,
dbXtra and dbxtra prompt and wait
for a command upon invocation.
Next topic:
The dbXtra interface
Previous topic:
dbXtra and dbxtra
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003