Browse window for procedures
To open a browse window for procedures, do one of the following:
- From the debugger, choose Browse > Procedures...
- In the command pane, use the e command with a pattern. For example, "e f*".
- In the command pane, enter browse procedures or browse procs.
- From the status bar of the debugger, open the Procedure drop-down list box, and choose "Browse procedures in program..." or "Browse procedures in current file...".
- In a browse window for source file, double click a file or right click a file and choose "Show procedures of File" from the pop-up menu.
- In the debugger source pane, right click a procedure and choose "Browse Callers" or "Browse Callees" from the pop-up menu.
When you open a browse window, it may contain all the procedures in the debugged program or a subset of all the procedures selected by certain criteria (for example, a pattern, or "callers of a procedure"). But whenever you choose a different object type and then choose Object > Procedures again, the browse window will contain all procedures.
By default, a browse window for procedures shows four attributes of a procedure. The following table lists all the attributes of a procedure which can be shown in a browse window for procedures.
Procedure attributes
|
Attribute
|
Information shown in column
|
Procedure Name
|
The name or mangled name of the procedure, depending on what kind of name is chosen.
|
BP
|
If a breakpoint is set at the prologue address of the procedure, the icon for the corresponding breakpoint type will be shown, otherwise, a green dot is shown.
|
Object File
|
The object file from which the procedure comes.
|
Source File
|
The source file from which the procedure comes.
|
Module
|
Name of the module from which the procedure comes, if any.
|
Library
|
Name of the library from which the procedure comes, if any.
|
Address
|
Address of the procedure.
|
Size
|
Size of the procedure.
|
Type
|
GI: if the procedure is an inlined non-static procedure;
SI: if the procedure is an inlined static procedure;
G: if the procedure is a not-inlined non-static procedure;
S: if the procedure is a not-inlined static procedure.
|
A procedure's information is displayed as follows:
- Grayed out if it has no source code.
- Displayed in the color for "dead code" in syntax coloring if it is an inlined procedure.
- Displayed in the color for "comment" in syntax coloring if it is a static and not fall in the above categories.
- Displayed in the normal foreground color otherwise.
The following table lists the operations when you click in the browse pane.
Mouse action
|
Description
|
Left click
|
Displays the clicked procedure in the debugger source pane. If you click in the BP column, the debugger will either insert a breakpoint at the clicked procedure if no breakpoint is there, or remove the breakpoint there if one already exists. If it sets a breakpoint at the procedure, it is at the first instruction after the prologue, if any.
|
Double left click
|
Opens an Editor window for the clicked procedure. If the clicked procedure has no source code, the debugger will issue a beep as a warning.
|
Right click
|
Opens a pop-up menu. See "Pop-up menu for procedure" below for detail.
|
Pop-up menu for a procedure
|
Menu Item
|
Description
|
Name
|
Shows normal (unmangled) names of procedures.
|
Mangled Name
|
Shows mangled names of procedures.
|
Show in Debugger
|
Loads the clicked procedure into the debugger source pane.
|
Show in Editor
|
Opens an Editor window for the clicked procedure.
|
Show in Tree Browser
|
Opens a tree browser window to show the clicked procedure's calling relationships.
|
(other options)
|
Enables or disables displaying the corresponding attribute.
|
The following table lists the operations when you click a column header in the browser pane:
Mouse action
|
Function Description
|
Left click
|
Sorts the objects according to the column (the order toggles).
|
Right click
|
Opens a pop-up menu. The menu items' functions are the same as those specified in table "Pop-up menu for procedure" above.
|
Related topics:
Copyright © 1999, Green Hills Software. All rights
reserved.