1ddd(1) GNU Tools ddd(1)
2
3
4
6 ddd - The Data Display Debugger
7
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
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
57 These are the most important options used when starting DDD. All
58 options 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
78 debugger that would otherwise conflict with DDD options. For
79 instance, 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
84 inferior 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
91 inferior 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
127 debugger, can be found in the DDD manual.
128
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
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.3.12 2001-01-15 ddd(1)