NAME

dde − HP Distributed Debugging Environment

SYNOPSIS

dde [−do "cmd_list"] X_options
    { [−wd pathname] [−input pathname]
      [−output pathname [−ao]]
      [−errors pathname [−ae]] program_invocation
    | −attach process_id [−force]
    | core_file object_program_pathname } ]
 

DESCRIPTION

The dde command invokes the HP Distributed Debugging Environment, the high level debugger for the HP OSF/1 Technology Release. For complete information about this debugger and its commands, consult the HP Distributed Debugging Environment Reference for HP OSF/1 TR 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. 

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.) 

−wd pathname Set the working directory of the target program to the specified pathname. 
 

−input pathname Read the target program’s standard input from pathname. 

−output pathname [−ao]
Direct target program’s standard output to pathname.  With -ao, appends the target program’s standard output to pathname. 

−errors pathname [−ae]
Redirect target program’s error output to pathname.  With -ae, appends the target program’s 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 and any arguments specified by the pathname. This specification must be last on the dde command line. 

−attach process_id  [−force]
Attach to a running process identified by an operating system dependent process identifier. On UNIX based systems, the process_id is the process number. With −force, forcibly attach to the specified process. If the process is already the target of another debugger, detach that debugger and take control. 

core_file object_program_pathname
Inspect a core file produced by the aborted program. core_file specifies the pathname of the core file and object_program_pathname specifies the pathname of the program object module that aborted. 

RUNNING THE USER INTERFACE REMOTELY

You can run the debugger on one machine and display the interface on another using X Window System resources. To display the interface remotely, the fonts used by the interface must be available on the remote machine. 
 
If the debugger is installed on the remote machine, the fonts will be available. If the debugger is not installed on the remote machine, make the fonts available by invoking MakeFonts from the remote system. 
 
To invoke MakeFonts, log on to the machine that will display the interface and enter
 
source/usr/dde/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
 
/usr/dde/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/dde
 
You must have write access rights to the font directory.
 
To display the interface remotely, 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.