ddd - The Data Display Debugger

       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.

DDD 3.3.12                                         2001-01-15                                             ddd(1)

       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  graphicaluserinterface 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→OpenProgram' (the `OpenProgram' item in the `File' menu.  You can get online help  at  any  time  using  the
       `Help' menu; for the first steps, try `Help→WhatNow?'.  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→DDDReference') 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/

       ddd - The Data Display Debugger

       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.

       --debuggername
              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 `-ddirectory' to XDB, use:

                ddd--debugger"xdb-ddirectory"

              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.

X(1), gdb(1), dbx(1), wdb(1), xdb(1), perldebug(1)

       `ddd' entry in info.

       `gdb' entry in info.

       DebuggingwithDDD:User'sGuideandReferenceManual, by Andreas Zeller.

       UsingGDB:AGuidetotheGNUSource-LevelDebugger, by Richard M. Stallman and Roland H. Pesch.

       JavaLanguageDebugging, at http://java.sun.com/ (and its mirrors) in /products/jdk/1.1/debugging/ThePythonLanguage, at http://www.python.org/ and its mirrors.

       DDD—AFreeGraphicalFront-EndforUNIXDebuggers, by Andreas Zeller and  Dorothea  Luetkehaus,  Computer
       Science Report 95-07, Technische Universitaet Braunschweig, 1995.

       DDD–einDebuggermitgraphischerDatendarstellung, by Dorothea Luetkehaus, Diploma Thesis, Technische
       Universitaet Braunschweig, 1994.

       The DDD FTPsite,ftp://ftp.gnu.org/gnu/ddd

       The DDD WWWpage,http://www.gnu.org/software/ddd/

       The DDD MailingList,ddd@gnu.org

       For more information on this list, send a mail to

          ddd-request@gnu.org .

ddd    [--help]  [--gdb]  [--dbx] [--ladebug] [--wdb] [--xdb] [--jdb] [--pydb] [--perl] [--debuggername]
              [--[r]host   [[username@]hostname]]   [--trace]   [--version]    [--configuration]    [options...]
              [prog[core|procID]]

       but usually just

       dddprogram