Your company here, and a link to your site. Click to find out more.

ddd - Man Page

The Data Display Debugger



[--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 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:

“Classical” UNIX debuggers such as the GNU debugger (GDB) provide a command-line interface and a multitude of commands 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 via the DDD WWW page,



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.


Show the DDD configuration settings and exit.


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' respectively.
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).


Run the GDB debugger as inferior debugger.


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.


Run JDB as inferior debugger.


Run Ladebug as inferior debugger.


Run Perl as inferior debugger.


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.


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.


Show the DDD version and exit.


Run the WDB debugger as inferior debugger.


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 Also

X(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 Dorothea Luetkehaus, Diploma Thesis, Technische Universitaet Braunschweig, 1994.

The DDD FTP site,


The DDD WWW page,


The DDD Mailing List,


For more information on this list, send a mail to

  ddd-request@gnu.org .


2001-01-15 DDD 3.4.0 GNU Tools