xlcb Graphical Browser:
User Manual


Contents


Invocation Syntax

The graphical version of LCB, xlcb, is invoked with a single argument, naming the lightweight corefile to be used as input:
     xlcb <lightweight-corefile-name> &
For example:
     xlcb vector_manipulation.lcb &

Overview Graph View

The initial window that comes up is the Overview Graph. It presents the calling structure of the program as a tree, or call graph. Each node in the graph represents a routine in the call stack of one or more processes, with each node colored according to the number of active processes associated with it at the time of program termination. The node colored in red indicates the location of the culprit process.

To get more information on a routine, select its corresponding node by clicking on it. When selected, the node is highlighted (it shows up as white in the pictures below) and the message area displays the number of processes active in the corresponding routine.

A Color Key window also appears within the Overview Graph view when xlcb starts up. It provides the legend for the node colors, and its message field displays the executable name, culprit process identifier, the reason for failure and the location of failure. You can show or hide this window at will via the Options menu.

Click here to see the names of the different areas in the Overview Graph view.


Call Graph View

By clicking the Call Graph button at the bottom of the Overview Graph view, you can change to a more detailed representation of the program's calling structure. This view gives a zoomed-in version of the call graph, where each node displays the routine name.

The Call Graph view shown below includes a Routine Detail window, which supplies process id number and last recorded source location for each process that was executing in the selected routine. This window appears when a node is selected for the first time in the Call Graph and Overview Graph views. You can hide or show this window at will via the Options menu.


Culprit Only View

By clicking the Culprit Only button at the bottom of the Overview Graph view, you see the display of the call stack of just the culprit process.


Find Routine Dialog

By clicking the Find Routine... button at the bottom of the Overview Graph view, you get an alphabetic list of all routines represented in the current view. You can then select any routine in the list, and the corresponding node in the current view will be highlighted.


Summary of xlcb Functions


Parallel Tools at OSU home page
Parallel Tools Consortium home page

This document was last updated 2 Aug. '95.

For further information, contact ptools-questions@nero.net.