DDE(1) Aegis DDE(1)
NAME
dde - HP Distributed Debugging Environment
SYNOPSIS
dde [-do "cmd_list"] [-nwp] [-ui ui_type] [X_options]
[ [-on target_machine] [-target_type target_type]
{ [-wd pathname] [-input pathname] [-output pathname [-ao]]
[-errors pathname [-ae]] program_invocation
| -attach process_id [-force] } ]
FORMAT
dde [-do "cmd_list"] [-nwp] [-ui ui_type] [X_options]
or
dde [-do "cmd_list"] [-nwp] [-ui ui_type] [X_options]
[ [-on target_machine] [-target_type target_type]
{ [-wd pathname] [-input pathname] [-output pathname [-ao]]
[-errors pathname [-ae]] program_invocation
-attach process_id [-force] } ]
DESCRIPTION
The dde command invokes the HP Distributed Debugging Environment, the
standard debugger for the Domain/OS operating system at SR10. You can
invoke the debugger by entering the dde command without options, or with
the options described below. If you specify a target program as a command
argument, the debugger loads and activates the target program. If you do
not specify a target program, then you can activate the target program
from the debugger using the debug command. For complete information
about this debugger and its commands, consult the HP Distributed
Debugging Environment Reference (011024-A01) or invoke the debugger's own
help command for online assistance.
OPTIONS
-do "cmd_list" Execute cmd_list (a list of debugger commands) before
executing any startup files or debugging the program.
-nwp Do not create a separate target program window. This
option is valid only when ui_type is "apollo."
-ui ui_type Create the user interface specified by ui_type. The
default is "motif" on HP 68k-based machines. To use the
Display Manager interface, specify "apollo" as the
ui_type. On HP Prism-based machines, the default is
"apollo."
X_options Execute any standard X command line options. Valid X
command line options include: -background, -foreground,
-display, -synchronous, and -reverse. (See The X Window
System Programming and Applications, D. A. Young.) This
option is valid only when ui_type is "motif."
-on target_machine
Debug the program or process on the specified target
machine, where target_machine is a workstation name or
workstation ID. If the option is omitted, the host machine
(the machine running the debugger) is used.
-target_type target_type
Use the specified target manager for debugging on the
target machine; The target_type may be "m68k" or "prism."
For example, "m68k" specifies an HP 68K-based workstation
running Domain/OS.
-wd pathname Set the working directory of the target program to the
specified pathname. Not necessary when debugging on a
local machine. When debugging on a remote machine, the
user's default login directory is used.
-input pathname
Read target program's standard input from pathname.
-output pathname [-ao]
Direct target program's standard output to pathname. With
-ao, append output to pathname.
-errors pathname [-ae]
Direct target program's error output to pathname. With
-ae, append error output to pathname. To redirect error
output and standard output to the same file, use the same
pathname on both options or use "&1" as an argument to the
-errors option.
program_invocation
Invoke the program program_invocation (the pathname of an
executable image, plus any arguments) for debugging. This
specification must be last on the dde command line.
-attach process_id
Attach to a running process identified by the UNIX
process_id (pid). Use the /bin/ps or /com/pst -un
commands to get the pid of a process.
-force Forcibly attach to the specified process. If the process
is already the target of another debugger, detach that
debugger and take control.
RUNNING THE USER INTERFACE REMOTELY
With the OSF/Motif interface, you can run the debugger on one machine and
display the interface on another using X Window System resources. To
display the interface on a remote machine, enter xhost local_system at
the shell prompt on the remote machine, where local_system is the name of
the system that will run the debugger. At the shell prompt on the local
machine, enter dde -display remote_system:0 where remote_system is the
name of the machine that will display the interface.
The fonts used by the interface must be available on the remote machine.
The fonts will be available if HP/DDE V.2.0 is installed on the remote
machine. If HP/DDE V.2.0 is not installed on the remote machine, make the
fonts available by invoking MakeFonts from the remote system. You must
have write access to the remote system to install the fonts using
MakeFonts.
To invoke MakeFonts, log on to the machine that will display the
interface and enter source/sys/debug/ui/motif_fonts/MakeFonts at the
shell prompt, where source is the name of a machine that has the debugger
installed.
When MakeFonts prompts for the pathname of the source machine, enter
source. Enter /sys/debug/ui/motif_fonts when the script asks for the
pathname of the font source directory. When the script asks for the
destination pathname for the font directory, enter
/usr/lib/X11/fonts/misc.