1ddd(1)                             GNU Tools                            ddd(1)
2
3
4

NAME

6       ddd - The Data Display Debugger
7

SYNOPSIS

9       ddd    [--help] [--gdb] [--dbx] [--ladebug] [--wdb] [--xdb] [--jdb]
10              [--pydb] [--perl] [--debugger name] [--[r]host [[username@]host‐
11              name]] [--trace] [--version] [--configuration] [options...]
12              [prog[core|procID]]
13
14       but usually just
15
16       ddd    program
17

DESCRIPTION

19       DDD is a graphical front-end for GDB and other command-line  debuggers.
20       Using  DDD, you can see what is going on “inside” another program while
21       it executes—or what another program was doing at the moment it crashed.
22
23       DDD can do four main kinds of things (plus other things in  support  of
24       these) to help you catch bugs in the act:
25
26       • Start  your program, specifying anything that might affect its behav‐
27         ior.
28
29       • Make your program stop on specified conditions.
30
31       • Examine what has happened, when your program has stopped.
32
33       • Change things in your program, so you can experiment with  correcting
34         the effects of one bug and go on to learn about another.
35
36       “Classical”  UNIX  debuggers  such  as the GNU debugger (GDB) provide a
37       command-line interface and a multitude of commands for these and  other
38       debugging  purposes.   DDD  is  a  comfortable graphical user interface
39       around an inferior GDB, DBX, Ladebug, XDB,  JDB,  Python  debugger,  or
40       Perl debugger.
41
42       DDD  is  invoked with the shell command ddd.  You can open a program to
43       be debugged using `File→Open Program' (the `Open Program' item  in  the
44       `File'  menu.   You  can  get  online help at any time using the `Help'
45       menu; for the first  steps,  try  `Help→What  Now?'.   Quit  DDD  using
46       `File→Exit'.
47
48       More  information  on DDD is contained in the DDD Manual.  You can read
49       the text-only version in DDD (via `Help→DDD Reference') or in Emacs (as
50       Info file).  Full-fledged HTML, PostScript, and PDF versions are avail‐
51       able online via the DDD WWW page,
52
53         http://www.gnu.org/software/ddd/
54
55

OPTIONS

57       These are the most important options used when starting DDD.   All  op‐
58       tions  may  be  abbreviated,  as  long  as they are unambiguous; single
59       dashes may also be used.  DDD also understands the usual X options such
60       as `-display' or `-geometry'; see X(1) for details.
61
62       All arguments and options not handled by DDD are passed to the inferior
63       debugger.  To pass an option to the inferior  debugger  that  conflicts
64       with  an  X option, or with a DDD option listed here, use the `--debug‐
65       ger' option, below.
66
67       --configuration
68              Show the DDD configuration settings and exit.
69
70       --dbx  Run the DBX debugger as inferior debugger.
71
72       --debugger name
73              Invoke the inferior debugger name.  This is useful if  you  have
74              several  debugger  versions  around, or if the inferior debugger
75              cannot be invoked as `gdb',  `dbx',  `xdb',  `jdb',  `pydb',  or
76              `perl' respectively.
77              This option can also be used to pass options to the inferior de‐
78              bugger that would otherwise conflict with DDD options.  For  in‐
79              stance, to pass the option `-d directory' to XDB, use:
80
81                ddd --debugger "xdb -d directory"
82
83              If you use the `--debugger' option, be sure that the type of in‐
84              ferior debugger is specified as well.  That is, use one  of  the
85              options `--gdb', `--dbx', `--xdb', `--jdb' `--pydb', or `--perl'
86              (unless the default setting works fine).
87
88       --gdb  Run the GDB debugger as inferior debugger.
89
90       --help Give a list of frequently used options.  Show options of the in‐
91              ferior debugger as well.
92
93       --host [username@]hostname
94              Invoke  the  inferior debugger directly on the remote host host‐
95              name.  If username is given and  the  `--login'  option  is  not
96              used, use username as remote user name.
97
98       --jdb  Run JDB as inferior debugger.
99
100       --ladebug
101              Run Ladebug as inferior debugger.
102
103       --perl Run Perl as inferior debugger.
104
105       --pydb Run PYDB as inferior debugger.
106
107       --rhost [username@]hostname
108              Run the inferior debugger interactively on the remote host host‐
109              name.  If username is given and  the  `--login'  option  is  not
110              used, use username as remote user name.
111
112       --trace
113              Show  the  interaction  between DDD and the inferior debugger on
114              standard error.  This is useful for debugging DDD.  If `--trace'
115              is   not   specified,   this   information   is   written   into
116              `$HOME/.ddd/log', such that you can also do a post-mortem debug‐
117              ging.
118
119       --version
120              Show the DDD version and exit.
121
122       --wdb  Run the WDB debugger as inferior debugger.
123
124       --xdb  Run XDB as inferior debugger.
125
126       A full list of options, including important options of the inferior de‐
127       bugger, can be found in the DDD manual.
128

SEE ALSO

130       X(1), gdb(1), dbx(1), wdb(1), xdb(1), perldebug(1)
131
132       `ddd' entry in info.
133
134       `gdb' entry in info.
135
136       Debugging with DDD: User's  Guide  and  Reference  Manual,  by  Andreas
137       Zeller.
138
139       Using  GDB:  A  Guide  to  the GNU Source-Level Debugger, by Richard M.
140       Stallman and Roland H. Pesch.
141
142       Java Language Debugging, at http://java.sun.com/ (and its  mirrors)  in
143       /products/jdk/1.1/debugging/
144
145       The Python Language, at http://www.python.org/ and its mirrors.
146
147       DDD—A  Free  Graphical  Front-End for UNIX Debuggers, by Andreas Zeller
148       and Dorothea Luetkehaus, Computer Science Report 95-07, Technische Uni‐
149       versitaet Braunschweig, 1995.
150
151       DDD  –  ein  Debugger  mit  graphischer  Datendarstellung,  by Dorothea
152       Luetkehaus, Diploma Thesis, Technische Universitaet Braunschweig, 1994.
153
154       The DDD FTP site,
155
156         ftp://ftp.gnu.org/gnu/ddd
157
158
159       The DDD WWW page,
160
161         http://www.gnu.org/software/ddd/
162
163
164       The DDD Mailing List,
165
166          ddd@gnu.org
167
168       For more information on this list, send a mail to
169
170          ddd-request@gnu.org .
171
172

COPYRIGHT

174       This manual page is Copyright © 2001 Universitaet Passau, Germany and ©
175       2001-2004 Free Software Foundation, Inc.
176
177       Permission  is  granted  to make and distribute verbatim copies of this
178       manual page provided the copyright notice and  this  permission  notice
179       are preserved on all copies.
180
181       Permission  is granted to copy and distribute modified versions of this
182       manual page under the conditions for verbatim  copying,  provided  that
183       the  entire  resulting derived work is distributed under the terms of a
184       permission notice identical to this one.
185
186       Permission is granted to copy and distribute translations of this  man‐
187       ual page into another language, under the above conditions for modified
188       versions, except that this permission notice may be included in  trans‐
189       lations  approved  by  the  Free  Software Foundation instead of in the
190       original English.
191
192
193
194DDD 3.4.0                         2001-01-15                            ddd(1)