(ddd.info)Options
2.1.2 DDD Options
-----------------
You can further control how DDD starts up using the following options.
All options may be abbreviated, as long as they are unambiguous; single
dashes `-' instead of double dashes `--' may also be used. Almost all
options control a specific DDD resource or resource class (Note:
Customizing).
`--attach-windows'
Attach the source and data windows to the debugger console,
creating one single big DDD window. This is the default setting.
Giving this option is equivalent to setting the DDD `Separate'
resource class to `off'. Note: Window Layout, for details.
`--attach-source-window'
Attach only the source window to the debugger console.
Giving this option is equivalent to setting the DDD
`separateSourceWindow' resource to `off'. Note: Window Layout,
for details.
`--attach-data-window'
Attach only the source window to the debugger console.
Giving this option is equivalent to setting the DDD
`separateDataWindow' resource to `off'. Note: Window Layout,
for details.
`--automatic-debugger'
Determine the inferior debugger automatically from the given
arguments.
Giving this option is equivalent to setting the DDD `autoDebugger'
resource to `on'. Note: Customizing Debugger Interaction, for
details.
`--button-tips'
Enable button tips.
Giving this option is equivalent to setting the DDD `buttonTips'
resource to `on'. Note: Customizing Help, for details.
`--configuration'
Print the DDD configuration settings on standard output and exit.
Giving this option is equivalent to setting the DDD
`showConfiguration' resource to `on'. Note: Diagnostics, for
details.
`--check-configuration'
Check the DDD environment (in particular, the X configuration),
report any possible problem causes and exit.
Giving this option is equivalent to setting the DDD
`checkConfiguration' resource to `on'. Note: Diagnostics, for
details.
`--data-window'
Open the data window upon start-up.
Giving this option is equivalent to setting the DDD
`openDataWindow' resource to `on'. Note: Toggling Windows, for
details.
`--dbx'
Run DBX as inferior debugger.
Giving this option is equivalent to setting the DDD `debugger'
resource to `dbx'. Note: Customizing Debugger Interaction, for
details.
`--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 under its usual name (i.e. `gdb', `wdb', `dbx',
`xdb', `jdb', `pydb', or `perl').
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).
Giving this option is equivalent to setting the DDD
`debuggerCommand' resource to NAME. Note: Customizing Debugger
Interaction, for details.
`--debugger-console'
Open the debugger console upon start-up.
Giving this option is equivalent to setting the DDD
`openDebuggerConsole' resource to `on'. Note: Toggling Windows,
for details.
`--disassemble'
Disassemble the source code. See also the `--no-disassemble'
option, below.
Giving this option is equivalent to setting the DDD `disassemble'
resource to `on'. Note: Customizing Source, for details.
`--exec-window'
Run the debugged program in a specially created execution window.
This is useful for programs that have special terminal
requirements not provided by the debugger window, as raw keyboard
processing or terminal control sequences. Note: Using the
Execution Window, for details.
Giving this option is equivalent to setting the DDD
`separateExecWindow' resource to `on'. Note: Customizing the
Execution Window, for details.
`--font FONTNAME'
`-fn FONTNAME'
Use FONTNAME as default font.
Giving this option is equivalent to setting the DDD `defaultFont'
resource to `fontname'. Note: Customizing Fonts, for details.
`--fonts'
Show the font definitions used by DDD on standard output.
Giving this option is equivalent to setting the DDD `showFonts'
resource to `on'. Note: Diagnostics, for details.
`--fontsize SIZE'
Set the default font size to SIZE (in 1/10 points). To make DDD
use 12-point fonts, say `--fontsize 120'.
Giving this option is equivalent to setting the DDD `FontSize'
resource class to `size'. Note: Customizing Fonts, for details.
`--fullname'
`-f'
Enable the TTY interface, taking additional debugger commands from
standard input and forwarding debugger output on standard output.
Current positions are issued in GDB `-fullname' format suitable
for debugger front-ends. By default, both the debugger console
and source window are disabled. Note: TTY mode, for a
discussion.
Giving this option is equivalent to setting the DDD `TTYMode'
resource class to `on'. Note: TTY mode, for details.
`--gdb'
Run GDB as inferior debugger.
Giving this option is equivalent to setting the DDD `debugger'
resource to `gdb'. Note: Customizing Debugger Interaction, for
details.
`--glyphs'
Display the current execution position and breakpoints as glyphs.
See also the `--no-glyphs' option, below.
Giving this option is equivalent to setting the DDD
`displayGlyphs' resource to `on'. Note: Customizing Source, for
details.
`--help'
`-h'
`-?'
Give a list of frequently used options. Show options of the
inferior debugger as well.
Giving this option is equivalent to setting the DDD
`showInvocation' resource to `on'. Note: Diagnostics, for
details.
`--host HOSTNAME'
`--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. Note: Remote Debugger, for
details.
Giving this option is equivalent to setting the DDD `debuggerHost'
resource to HOSTNAME. Note: Remote Debugger, for details.
`--jdb'
Run JDB as inferior debugger.
Giving this option is equivalent to setting the DDD `debugger'
resource to `jdb'. Note: Customizing Debugger Interaction, for
details.
`--ladebug'
Run Ladebug as inferior debugger.
Giving this option is equivalent to setting the DDD `debugger'
resource to `ladebug'. Note: Customizing Debugger Interaction,
for details.
`--lesstif-hacks'
Equivalent to `--lesstif-version 999'. Deprecated.
Giving this option is equivalent to setting the DDD
`lessTifVersion' resource to `999'. Note: LessTif, for details.
`--lesstif-version VERSION'
Enable some hacks to make DDD run properly with LessTif. Note:
LessTif, for a discussion.
Giving this option is equivalent to setting the DDD
`lessTifVersion' resource to VERSION. Note: LessTif, for
details.
`--license'
Print the DDD license on standard output and exit.
Giving this option is equivalent to setting the DDD `showLicense'
resource to ON. Note: Diagnostics, for details.
`--login USERNAME'
`-l USERNAME'
Use USERNAME as remote user name. Note: Remote Debugger, for
details.
Giving this option is equivalent to setting the DDD
`debuggerHostLogin' resource to USERNAME. Note: Remote
Debugger, for details.
`--maintenance'
Enable the top-level `Maintenance' menu with options for debugging
DDD. Note: Maintenance Menu, for details.
Giving this option is equivalent to setting the DDD `maintenance'
resource to ON. Note: Maintenance Menu, for details.
`--manual'
Print the DDD manual on standard output and exit.
Giving this option is equivalent to setting the DDD `showManual'
resource to ON. Note: Diagnostics, for details.
`--news'
Print the DDD news on standard output and exit.
Giving this option is equivalent to setting the DDD `showNews'
resource to ON. Note: Diagnostics, for details.
`--no-button-tips'
Disable button tips.
Giving this option is equivalent to setting the DDD `buttonTips'
resource to `off'. Note: Customizing Help, for details.
`--no-data-window'
Do not open the data window upon start-up.
Giving this option is equivalent to setting the DDD
`openDataWindow' resource to `off'. Note: Toggling Windows, for
details.
`--no-debugger-console'
Do not open the debugger console upon start-up.
Giving this option is equivalent to setting the DDD
`openDebuggerConsole' resource to `off'. Note: Toggling
Windows, for details.
`--no-disassemble'
Do not disassemble the source code.
Giving this option is equivalent to setting the DDD `disassemble'
resource to `off'. Note: Customizing Source, for details.
`--no-exec-window'
Do not run the debugged program in a specially created execution
window; use the debugger console instead. Useful for programs
that have little terminal input/output, or for remote debugging.
Note: Using the Execution Window, for details.
Giving this option is equivalent to setting the DDD
`separateExecWindow' resource to `off'. Note: Customizing the
Execution Window, for details.
`--no-glyphs'
Do not use glyphs; display the current execution position and
breakpoints as text characters.
Giving this option is equivalent to setting the DDD
`displayGlyphs' resource to `off'. Note: Customizing Source,
for details.
`--no-lesstif-hacks'
Equivalent to `--lesstif-version 1000'. Deprecated.
Giving this option is equivalent to setting the DDD
`lessTifVersion' resource to `1000'. Note: LessTif, for details.
`--no-maintenance'
Do not enable the top-level `Maintenance' menu with options for
debugging DDD. This is the default. Note: Maintenance Menu,
for details.
Giving this option is equivalent to setting the DDD `maintenance'
resource to OFF. Note: Maintenance Menu, for details.
`--no-source-window'
Do not open the source window upon start-up.
Giving this option is equivalent to setting the DDD
`openSourceWindow' resource to `off'. Note: Toggling Windows,
for details.
`--no-value-tips'
Disable value tips.
Giving this option is equivalent to setting the DDD `valueTips'
resource to `off'. Note: Value Tips, for details.
`--nw'
Do not use the X window interface. Start the inferior debugger on
the local host.
`--perl'
Run Perl as inferior debugger.
Giving this option is equivalent to setting the DDD `debugger'
resource to `perl'. Note: Customizing Debugger Interaction, for
details.
`--pydb'
Run `pydb' as inferior debugger.
Giving this option is equivalent to setting the DDD `debugger'
resource to `pydb'. Note: Customizing Debugger Interaction, for
details.
`--panned-graph-editor'
Use an Athena panner to scroll the data window. Most people prefer
panners on scroll bars, since panners allow two-dimensional
scrolling. However, the panner is off by default, since some
M*tif implementations do not work well with Athena widgets. Note:
Display Resources, for details; see also
`--scrolled-graph-editor', below.
Giving this option is equivalent to setting the DDD
`pannedGraphEditor' resource to `on'. Note: Display Resources,
for details.
`--play-log LOG-FILE'
Recapitulate a previous DDD session.
ddd --play-log LOG-FILE
invokes DDD as inferior debugger, simulating the inferior debugger
given in LOG-FILE (see below). This is useful for debugging DDD.
Giving this option is equivalent to setting the DDD `playLog'
resource to `on'. Note: Customizing Debugger Interaction, for
details.
`--PLAY LOG-FILE'
Simulate an inferior debugger. LOG-FILE is a `~/.ddd/log' file as
generated by some previous DDD session (Note: Logging). When a
command is entered, scan LOG-FILE for this command and re-issue
the logged reply; if the command is not found, do nothing. This
is used by the `--play' option.
`--rhost HOSTNAME'
`--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. Note: Remote Debugger,
for details.
Giving this option is equivalent to setting the DDD
`debuggerRHost' resource to HOSTNAME. Note: Remote Debugger,
for details.
`--scrolled-graph-editor'
Use M*tif scroll bars to scroll the data window. This is the
default in most DDD configurations. Note: Display Resources,
for details; see also `--panned-graph-editor', above.
Giving this option is equivalent to setting the DDD
`pannedGraphEditor' resource to `off'. Note: Display Resources,
for details.
`--separate-windows'
`--separate'
Separate the console, source and data windows. See also the
`--attach' options, above.
Giving this option is equivalent to setting the DDD `Separate'
resource class to `off'. Note: Window Layout, for details.
`--session SESSION'
Load SESSION upon start-up. Note: Resuming Sessions, for
details.
Giving this option is equivalent to setting the DDD `session'
resource to SESSION. Note: Resuming Sessions, for details.
`--source-window'
Open the source window upon start-up.
Giving this option is equivalent to setting the DDD
`openSourceWindow' resource to `on'. Note: Toggling Windows,
for details.
`--status-at-bottom'
Place the status line at the bottom of the source window.
Giving this option is equivalent to setting the DDD
`statusAtBottom' resource to `on'. Note: Window Layout, for
details.
`--status-at-top'
Place the status line at the top of the source window.
Giving this option is equivalent to setting the DDD
`statusAtBottom' resource to `off'. Note: Window Layout, for
details.
`--sync-debugger'
Do not process X events while the debugger is busy. This may
result in slightly better performance on single-processor systems.
Giving this option is equivalent to setting the DDD
`synchronousDebugger' resource to `on'. Note: Customizing
Debugger Interaction, for details.
`--toolbars-at-bottom'
Place the toolbars at the bottom of the respective window.
Giving this option is equivalent to setting the DDD
`toolbarsAtBottom' resource to `on'. Note: Window Layout, for
details.
`--toolbars-at-top'
Place the toolbars at the top of the respective window.
Giving this option is equivalent to setting the DDD
`toolbarsAtBottom' resource to `off'. Note: Window Layout, for
details.
`--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 `~/.ddd/log'
(`~' stands for your home directory), such that you can also do a
post-mortem debugging. Note: Logging, for details about logging.
Giving this option is equivalent to setting the DDD `trace'
resource to ON. Note: Diagnostics, for details.
`--tty'
`-t'
Enable TTY interface, taking additional debugger commands from
standard input and forwarding debugger output on standard output.
Current positions are issued in a format readable for humans. By
default, the debugger console is disabled.
Giving this option is equivalent to setting the DDD `ttyMode'
resource to `on'. Note: TTY mode, for details.
`--value-tips'
Enable value tips.
Giving this option is equivalent to setting the DDD `valueTips'
resource to `on'. Note: Value Tips, for details.
`--version'
`-v'
Print the DDD version on standard output and exit.
Giving this option is equivalent to setting the DDD `showVersion'
resource to `on'. Note: Diagnostics, for details.
`--vsl-library LIBRARY'
Load the VSL library LIBRARY instead of using the DDD built-in
library. This is useful for customizing display shapes and fonts.
Giving this option is equivalent to setting the DDD `vslLibrary'
resource to LIBRARY. Note: VSL Resources, for details.
`--vsl-path PATH'
Search VSL libraries in PATH (a colon-separated directory list).
Giving this option is equivalent to setting the DDD `vslPath'
resource to PATH. Note: VSL Resources, for details.
`--vsl-help'
Show a list of further options controlling the VSL interpreter.
These options are intended for debugging purposes and are subject
to change without further notice.
`--wdb'
Run WDB as inferior debugger.
Giving this option is equivalent to setting the DDD `debugger'
resource to `wdb'. Note: Customizing Debugger Interaction, for
details.
`--xdb'
Run XDB as inferior debugger.
Giving this option is equivalent to setting the DDD `debugger'
resource to `xdb'. Note: Customizing Debugger Interaction, for
details.
automatically generated by info2www version 1.2.2.9