NAME

       ddd - The Data Display Debugger

SYNOPSIS

       ddd    [--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 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,

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

       --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.

       --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 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,

         ftp://ftp.gnu.org/gnu/ddd

       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  and © 2001-2004 Free Software
       Foundation, Inc.

       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 versions of this manual page under the conditions
       for verbatim 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 permission notice may be  included  in
       translations approved by the Free Software Foundation instead of in the original English.