ddd(1) GNU Tools ddd(1)NAME
ddd, xddd - The Data Display Debugger
SYNOPSISddd [--help] [--gdb] [--dbx] [--ladebug] [--wdb]
[--xdb] [--jdb] [--pydb] [--perl] [--debugger name]
[--[r]host [username@]hostname]] [--trace]
[--version] [--configuration] [options...]
[prog[core|procID]]
but usually just
ddd program
DESCRIPTION
DDD is a graphical front-end for GDB and other command-
line debuggers. Using DDD, you can see what is going on
"inside" another program while it executes--or what
another program was doing at the moment it crashed.
DDD can do four main kinds of things (plus other things in
support of these) to help you catch bugs in the act:
Start your program, specifying anything that might
affect its behavior.
Make your program stop on specified conditions.
Examine what has happened, when your program has
stopped.
Change things in your program, so you can experiment
with correcting the effects of one bug and go on to
learn about another.
"Classical" UNIX debuggers such as the GNU debugger (GDB)
provide a command-line interface and a multitude of com
mands for these and other debugging purposes. DDD is a
comfortable graphical user interface around an inferior
GDB, DBX, Ladebug, XDB, JDB, Python debugger, or Perl
debugger.
DDD is invoked with the shell command ddd. You can open a
program to be debugged using `File->Open Program' (the
`Open Program' item in the `File' menu. You can get
online help at any time using the `Help' menu; for the
first steps, try `Help->What Now?'. Quit DDD using
`File->Exit'.
More information on DDD is contained in the DDD Manual.
You can read the text-only version in DDD (via `Help->DDD
Reference') or in Emacs (as Info file). Full-fledged
HTML, PostScript, and PDF versions are available online
DDD 3.3.1 2001-01-15 1
ddd(1) GNU Tools ddd(1)
via the DDD WWW page,
http://www.gnu.org/software/ddd/
OPTIONS
These are the most important options used when starting
DDD. All options may be abbreviated, as long as they are
unambiguous; single dashes may also be used. DDD also
understands the usual X options such as `-display' or
`-geometry'; see X(1) for details.
All arguments and options not handled by DDD are passed to
the inferior debugger. To pass an option to the inferior
debugger that conflicts with an X option, or with a DDD
option listed here, use the `--debugger' option, below.
--configuration
Show the DDD configuration settings and exit.
--dbx Run the DBX debugger as inferior debugger.
--debugger name
Invoke the inferior debugger name. This is useful
if you have several debugger versions around, or if
the inferior debugger cannot be invoked as `gdb',
`dbx', `xdb', `jdb', `pydb', or `perl' respec
tively.
This option can also be used to pass options to the
inferior debugger that would otherwise conflict
with DDD options. For instance, to pass the option
`-d directory' to XDB, use:
ddd--debugger "xdb -d directory"
If you use the `--debugger' option, be sure that
the type of inferior debugger is specified as well.
That is, use one of the options `--gdb', `--dbx',
`--xdb', `--jdb' `--pydb', or `--perl' (unless the
default setting works fine).
--gdb Run the GDB debugger as inferior debugger.
--help Give a list of frequently used options. Show
options of the inferior debugger as well.
--host [username@]hostname
Invoke the inferior debugger directly on the remote
host hostname. If username is given and the
`--login' option is not used, use username as
remote user name.
--jdb Run JDB as inferior debugger.
DDD 3.3.1 2001-01-15 2
ddd(1) GNU Tools ddd(1)--ladebug
Run Ladebug as inferior debugger.
--perl Run Perl as inferior debugger.
--pydb Run PYDB as inferior debugger.
--rhost [username@]hostname
Run the inferior debugger interactively on the
remote host hostname. If username is given and the
`--login' option is not used, use username as
remote user name.
--trace
Show the interaction between DDD and the inferior
debugger on standard error. This is useful for
debugging DDD. If `--trace' is not specified, this
information is written into `$HOME/.ddd/log', such
that you can also do a post-mortem debugging.
--version
Show the DDD version and exit.
--wdb Run the WDB debugger as inferior debugger.
--xdb Run XDB as inferior debugger.
A full list of options, including important options of the
inferior debugger, can be found in the DDD manual.
SEE ALSOX(1), gdb(1), dbx(1), wdb(1), xdb(1), perldebug(1)
`ddd' entry in info.
`gdb' entry in info.
Debugging with DDD: User's Guide and Reference Manual, by
Andreas Zeller.
Using GDB: A Guide to the GNU Source-Level Debugger, by
Richard M. Stallman and Roland H. Pesch.
Java Language Debugging, at http://java.sun.com/ (and its
mirrors) in /products/jdk/1.1/debugging/
The Python Language, at http://www.python.org/ and its
mirrors.
DDD--A Free Graphical Front-End for UNIX Debuggers, by
Andreas Zeller and Dorothea Luetkehaus, Computer Science
Report 95-07, Technische Universitaet Braunschweig, 1995.
DDD - ein Debugger mit graphischer Datendarstellung, by
DDD 3.3.1 2001-01-15 3
ddd(1) GNU Tools ddd(1)
Dorothea Luetkehaus, Diploma Thesis, Technische Universi
taet Braunschweig, 1994.
The DDD FTP site,
ftp://ftp.gnu.org/
The DDD WWW page,
http://www.gnu.org/software/ddd/
The DDD Mailing List,
ddd@gnu.org
For more information on this list, send a mail to
ddd-request@gnu.org .
COPYRIGHT
This manual page is Copyright 2001 Universitaet Passau,
Germany.
Permission is granted to make and distribute verbatim
copies of this manual page provided the copyright notice
and this permission notice are preserved on all copies.
Permission is granted to copy and distribute modified ver
sions of this manual page under the conditions for verba
tim copying, provided that the entire resulting derived
work is distributed under the terms of a permission notice
identical to this one.
Permission is granted to copy and distribute translations
of this manual page into another language, under the above
conditions for modified versions, except that this permis
sion notice may be included in translations approved by
the Free Software Foundation instead of in the original
English.
DDD 3.3.1 2001-01-15 4
