NAME
XIPD - Invoke XIPD, the graphical front end for the Interac-
tive Parallel Debugger (IPD).
SYNTAX
xipd [session_name] [-user account_name]
[-host paragon_name] [-[no]login] [-[no]debug]
[-[no]analysis] [-[no]symbols]
[-core] [-coreDir directory]
[-delay seconds] [X Toolkit parameters]
ARGUMENTS
session_name
The name of a previously-saved XIPD session. If
the session file exists, XIPD uses the contents to
pre-initialize certain aspects of XIPD. If the
file does not exist, session_name is assumed to be
the name of the Paragon system that XIPD should be
used with.
-user account_name
The login account name to use for starting a new
session on a Paragon system. Use this option when
you are not restoring a session and you want to
specify a login account name.
-host paragon_name
The name of the Paragon system on which XIPD is
being used. Use this option when you are not res-
toring a session.
-[no]login
[Do not] display the login panel. The default is
-login.
-[no]debug
[Do not] create interface elements specific for
debugging applications (like setting breakpoints
or stepping execution). The default is -debug.
-[no]analysis
[Do not] create interface elements specific for
instrumenting programs for performance analysis.
The default is -analysis.
-[no]symbols
[Do not] use symbol shapes to represent node
status. The default is -symbols.
-core Causes XIPD to go directly to the Core Analysis
dialog instead of the Load Application dialog.
-coreDir directory
Causes XIPD to go directly to the Core Analysis
dialog and load the contents of the specified core
directory.
-delay seconds
Establishes the time-out period for XIPD to wait
for a response from IPD. This is rarely needed and
typically only used when debugging applications
that can deadlock when the step command is issued.
After the given whole number of seconds (the
default is 60), XIPD interrupts IPD if IPD has not
responded to the XIPD command.
X Toolkit parameters
The standard parameters supported by the X Toolkit
(refer to the X Toolkit Intrinsics Programming
Manual).
DESCRIPTION
XIPD provides a graphical front end to the Interactive
Parallel Debugger (IPD). XIPD graphically displays the
status of parallel programs. XIPD also supports performance
monitoring by assisting in selecting code to be instrumented
for analysis by prof, gprof, and ParaGraph.The XIPD main
window provides the following features:
Title Bar Lists the title of the tool.
Menu Bar Provides a set of pulldown menus to access all the
features of XIPD.
Work Area Provides an area for the display of dialogs, node
status, routine lists, and program execution con-
trols.
Button Panel
Contains push buttons that control the functions
of XIPD.
RESOURCES
You can configure XIPD by using an X resource file. You can
make the resource entries in your .Xdefaults file (which
resides in your home directory) or in a file named XIpd
(located either in your home directory or in a directory
specified by the XAPPLRESDIR environment variable). The
entries in the .Xdefaults file take precedence over the XIpd
file entries.
Along with the resources corresponding to the standard X
toolkit command line options, the following XIPD application
resources are provided to configure XIPD:
XIpd.appForeground
A color name that defines the default foreground
color for interface elements. This resource and
XIpd*foreground should be the same.
XIpd.appBackground
A color name that defines the default background
color for interface elements. This resource and
XIpd*background should be the same.
XIpd*foreground
A color name that defines the default foreground
color for all XIPD interface elements.
XIpd*background
A color name that defines the default background
color for all XIPD interface elements.
XIpd.unloadedStatusForeground
A color name that defines the foreground color for
unloaded nodes in the mesh.
XIpd.initializedStatusForeground
A color name that defines the foreground color for
loaded but not yet executing nodes in the mesh.
XIpd.activeStatusForeground
A color name that defines the foreground color for
nodes selected for load or for executing nodes.
XIpd.breakpointStatusForeground
A color name that defines the foreground color for
nodes in the mesh at a break point.
XIpd.stoppedStatusForeground
A color name that defines the foreground color for
nodes in the mesh that are stopped.
XIpd.blockedStatusForeground
A color name that defines the foreground color for
nodes in the mesh that are blocked waiting for a
message.
XIpd.terminatedStatusForeground
A color name that defines the foreground color for
nodes in the mesh that have terminated execution.
XIpd.unloadedStatusStipple
A stipple name that defines the stippling pattern
used when drawing an unloaded status node.
XIpd.initializedStatusStipple
A stipple name that defines the stippling pattern
used when drawing an initialized status node.
XIpd.activeStatusStipple
A stipple name that defines the stippling pattern
used when drawing an active status node.
XIpd.breakpointStatusStipple
A stipple name that defines the stippling pattern
used when drawing a break point status node.
XIpd.stoppedStatusStipple
A stipple name that defines the stippling pattern
used when drawing a stopped status node.
XIpd.blockedStatusStipple
A stipple name that defines the stippling pattern
used when drawing a blocked status node.
XIpd.terminatedStatusStipple
A stipple name that defines the stippling pattern
used when drawing a terminated status node.
XIpd.brightColor
A color name that defines the color for the bright
part of the mesh lines drawn behind the nodes. The
mesh is drawn with XIpd.normColor and
XIpd.darkColor as well.
XIpd.normColor
A color name that defines the normal color for the
mesh lines drawn behind the nodes. The mesh is
drawn with XIpd.brightColor and XIpd.darkColor as
well.
XIpd.darkColor
A color name that defines the color for the dark
(shadow) part of the mesh drawn lines behind the
nodes. The mesh is drawn with XIpd.brightColor and
XIpd.normColor as well.
XIpd.sourceForeground
A color name that defines the color used for
rendering the program text in the source code win-
dow.
XIpd.sourceBackground
A color name that defines the color used for the
background of the program text in the source code
window.
XIpd.breakpointForeground
A color name that defines the color used for the
break point icons. The Preferences dialog sets
this the same color as break point status.
XIpd.monitorpointForeground
A color name that defines the color used for the
monitor point icons. The Preferences dialog sets
this the same color as unloaded status.
XIpd.activeForeground
A color name that defines the color used for
active code icons. The Preferences dialog sets
this the same color as active status.
XIpd.generalFontName
A font name that defines the font used to render
most of XIPD's text.
XIpd.codeWindowFontName
A font name that defines the font used to render
the text in a source code window. This should be a
fixed width font.
XIpd.outputFontName
A font name that defines the font used to render
the text in windows that display output either IPD
(like the pending send queue) or within the con-
sole input/output panel. This should be a fixed
width font.
XIpd.monospaceFontName
A font name that defines the font for displaying
highlighted routine names in the main panel's rou-
tine list.
XIpd.monospaceDimFontName
A font name that defines the font for displaying
non-highlighted (dimmed) routine names in the main
window's routine list.
XIpd.showSymbols
A boolean (True / False) value. If this resource
is True, XIPD uses symbols as well as color to
display the status of nodes in the viewpoint
panel. If False, XIPD uses filled circles.
XIpd.nodeHeight
An integer that defines the height, in pixels,
that XIPD draws nodes (this and XIpd.nodeWidth
should be set to the same value).
XIpd.nodeWidth
An integer that defines the width, in pixels, that
XIPD draws nodes (this and XIpd.nodeHeight should
be set to the same value).
XIpd.geometry
A geometry string that controls the initial size
and placement of XIPD.
ENVIRONMENT VARIABLES
NX_DFLT_PART
Name of the default partition that XIPD selects
automatically within the mesh configuration dia-
log. If not defined (or invalid), XIPD selects the
.compute partition.
XAPPLRESDIR
XIPD looks in this directory for the resource file
XIpd when you modify XIPD resource settings
through the Preferences dialog. If not defined,
XIPD looks in your home directory.
XIPDHOME
Alternative home directory for XIPD session files.
If not defined, XIPD stores the session files in
your home directory.
FILES
XIPD uses the following files:
XIpd Application defaults file for XIPD. This file
defines resources that control the appearance and
configuration parameters of XIPD.
xipd.hlp Online help text for XIPD.
SEE ALSO
paraide, xprof, xgprof, paragraph, spv
Paragon(tm) System Application Tools User's Guide
Acknowledgement and Disclaimer