In the icon bar across the top of a Context View or CPU View Graph, as shown in Figure 6-2. Choose Windows > New Context Graph to display a Context View graph, or Windows > New CPU Graph to display a CPU View graph.
The icon bar in a Context View window looks the same as in a CPU View window. For general information about using IRIXview, see Chapter 2, “Collecting Event Data.”
When you choose Help > About IRIXView, the program displays the window shown in Figure 6-3, which contains version and copyright information. To dismiss this window, click the OK button or double-click the control menu bar in the upper left hand corner.
When you choose Options > Context Graph, the program displays the window shown in Figure 6-4, which provides useful control over all active Context View graphs.
To display the kernel thread ID number in the interrupt and process buttons of all active Context View graph windows, check mark the Kthread ID box. To display process or thread priorities, check mark the Priority box. To remove the default process ID number, uncheck mark the Process ID box. The effect is immediate.
The scrolling list of this window contains a list of all interrupts and processes shown in the Context View window. By default, all items in the list are check marked. You can uncheck them all by clicking the None button, or uncheck mark individual items in the scrolling list. The All button check marks all items again. To change the display of items in the Context View graph, click the Apply button.
For events that print qual[0-3] data, especially user-defined events, choosing the Options > Data Format menu item allows you to change the output data format from decimal (default) to octal, hexadecimal, or ASCII.
When you click this icon, IRIXview displays the Display Events/States window, as shown in Figure 6-6. This window contains commands that let you change which events are displayed within the graph subwindow, and how they are treated.
To control which elements are displayed in the Context View or CPU View graph, toggle these event or state types on (or off) and click Apply. When you bring up a Display Events/States window from a CPU View graph, some of the items are grayed out. From a Context View graph, some event or state types are not displayed by default.
|Note: This is different from the Target window, which controls event logging, rather than event display; see “Target Window”.|
The following list describes the event or state types you can display:
If toggled on, system call icons are displayed.
If toggled on, virtual memory event icons are displayed.
If toggled on, signal event icons are displayed.
If toggled on, interrupt event icons (intEnt and intExit) are displayed.
If toggled on, dispatch event icons are displayed
If toggled on, user-defined event icons are displayed.
If toggled on, memory allocation event icons are displayed.
If toggled on, frame scheduler (FRS) event icons are displayed?
If toggled on, profiler event icons are displayed?
If toggled on, disk I/O event icons are displayed?
If toggled on, network event icons are displayed?
If toggled on, process event icons are displayed.
This choice is located in the Windows menu, and displays the Event Inspector window, as shown in Figure 6-7.
To use this window:
Click an event icon in an event log with the middle mouse button.
Drag the event icon to the Event Inspector window. The cursor changes to the shape of the event icon, letting you see what is being dragged.
“Drop” the icon into the Event Inspector. Information about that event appears.
(For details on what type of information is logged for an event at each mode, see Chapter 5, “Event Dictionary.”)
When you drag a new icon into the window, it overwrites the previous event's information. You can also move the cursor into the window and press the C key to clear the Event Inspector.
Click this icon to display a scrollable Legend window, showing what each event icon and stipple means. Legend windows for the Context View and CPU View are different; both are shown in Figure 6-9.
This choice is located in the Windows menu and displays a Context View graph window where you can examine event data, as shown in Figure 6-10.
The Context View is a window into the event data; in most cases, it does not show the entire event log. Instead, what is shown is a time interval. Use your window manager to resize the Context View window, if needed. You can refresh the Context View graph at any time by moving the cursor into the window and clicking the right mouse button.
The first Context View window that you display is labeled View 1. You can display up to 16 Context View windows at a time, which can be useful for looking at different portions of the same event log. Each one is numbered in the order that it is displayed; the second graph would be labeled Context View 2, and so on. When you display auxiliary windows (for example, by clicking the V icon to display the View Options window; see “View Options Window”), auxiliary windows are numbered to match the Context View from which they were invoked. For example, if you click the V icon from View 3, the resulting window is labeled View Options 3.
This choice is located in the Windows menu and displays a CPU View graph window where you can examine processor data, as shown in Figure 6-11.
The CPU View is a window into the processor data; in most cases, it does not show the entire event log. Instead, what is shown is a time interval. Use your window manager to resize the CPU View window, if needed. You can refresh the CPU View graph at any time by moving the cursor into the window and clicking the right mouse button.
The first CPU View window that you display is labeled View 1. You can display up to 16 CPU View windows at a time, which can be useful for looking at different portions of the same event log. Each one is numbered in the order that it is displayed; the second graph would be labeled CPU View 2, and so on. When you display auxiliary windows (for example, by clicking the V icon to display the View Options window; see “View Options Window”), auxiliary windows are numbered to match the CPU View from which they were invoked. For example, if you click the V icon from View 3, the resulting window is labeled View Options 3.
When you choose File > Open, IRIXview displays the Open Event File window, as shown in Figure 6-12. This window lets you open an event log created with the Save Event File window; see “Save Event File Window”.
The current working directory is displayed in the Filter and Selection fields by default. As you move to other directories, the Directories and Files subwindows automatically resize to show as much information as possible.
To use this window, follow these steps:
To search for the event log to open, use the Filter field to specify a particular directory, double-clicking names in the Directories subwindow, clicking the Filter button, or pressing the Enter key, as appropriate.
As you “filter” directories, they are listed in the Selection field, and their subdirectories and files are listed in the Directories and Files subwindows. You can continue filtering directories in this manner until the appropriate directory name is specified in the Selection field.
Once you are in the correct directory, use the Selection field to specify the particular event log to open. You can click the name in the Files subwindow or type the name in. Files are named with the syntax name.processor_number.irv.
Double-click the event log name, click the OK button, or press Enter to analyze the file and remove the Analyze Event Log window from the screen.
If the event log is successfully opened, a message like the following appears in the Main window message area:
Connected to host localhost. 4 CPUs on localhost, 4 selected CPUs TSTAMP_EV_CONFIG: Cpu 0: revision 19970320 cputype R4400- tstampfreq 47619047 Event types : -Tasks-Intr ...
Then, if a Context View graph is displayed, the event log is displayed there; see “New Context Graph Menu”. (Note that you can display the Context Graph either before or after you have opened an event log.)
These icons are located in the icon bar of the Context View or CPU View windows, which may be displayed by choosing Windows > New...Graph.
The Push icon saves the current time interval. You can later move back to this time interval with the Pop or Exchange icon. You can push up to 16 time intervals— if you push more than 16, the oldest intervals are discarded in FIFO order.
The Pop icon causes the most recently pushed time interval to be displayed.
The Exchange icon swaps the currently displayed time interval with the most recently pushed time interval. For example, find an interval that is of interest to you and save it with the Push icon. Then click the Exchange icon repeatedly to move between that interval and the current interval.
To exit IRIXview, choose File > Quit. The IRIXview main window and all its related windows are removed from the screen.
|Note: When you exit IRIXview, you are not prompted to save your event data. To save event data before exiting, see “Save Event File Window”.|
This choice is located in the File menu, and displays the Save Event File window, as shown in Figure 6-15. This window lets you save event logs that you can later with the Open Event File window; see “Open Event File Window”.
The current directory is displayed in the Filter and Selection fields. As you move to other directories, the Directories and Files subwindows are automatically resized to show as much information as possible.
To search for a save directory, use the Filter field to specify the directory name, double-clicking names in the Directories subwindow, clicking the Filter button, or pressing the Enter key, as appropriate. As you filter directories, they are listed in the Selection field, and the files they contain are listed in the subwindows. Continue filtering directories until the one you want appears in the Selection field.
Once you are in the correct directory, use the Selection field to specify the particular event log to save. Click a name in the Files subwindow or type the name.
Double-click the event log name, click the OK button, or press the Enter key to save the file and dismiss the Save Event File window from the screen.
When an event log is saved, its filename usually has an irv suffix, for example: filename.irv.
At any time, you can click the Cancel button to remove the Save Event File window from the screen, or click the Help button to display information on the window.
When you choose Windows > Scheduler Summary from the main menu of IRIXview, the Scheduler Summary window appears, as shown in Figure 6-16. This window shows status information for all processors, the run queue length, and scheduler status.
The Search Accelerator icons are located in the icon bar of the Context View or CPU View windows, which may be displayed by choosing Windows > New...Graph.
These icons find the next or previous occurrence of the currently selected event.
An event may have been selected because it was found by a previous search request, or you may have selected it with the middle mouse button (see “Selecting Event Data”).
The underlined arrows find the next (or previous) occurrence of the currently selected event in the same context, that is, in the same process, interrupt level, or idle thread context.
The middle arrows without underlines search for the next or previous occurrence of the currently selected event, regardless of context.
When you click the Search Window icon, a Search window displays, as shown in Figure 6-19. (The number 1.1 in the title indicates that this is the first search window for the corresponding first View window.)
You can search for a particular event, the next or previous event in a particular context, or the next or previous event of any type in any context. Context entries can be the context name only, the process ID (PID), or the kernel thread ID (KID). Follow these steps to use the Search window:
Specify a particular event by entering its name in the Event field, or by dragging and dropping an icon from the Legend window.
If you know its name, you can enter the event by typing its name into the Event field. You can also drag and drop icons from the (Context) Legend window into the Event field (the exceptions are the defaultUser and unknown icons). See “Selecting Event Data” for information on dragging event icons.
Leave this field blank if you are searching for any event in a particular context, or any event in any context.
You can further constrain the search for a particular event by specifying its context ID (interrupt level, process, or idle thread).
Enter the context information by typing it or by dragging the icon of interest into the field. You can also enter the information by selecting the context label from the vertical axis with the middle mouse button, then dragging the word “CONTEXT” that appears into the Context ID field.
If there are multiple contexts with the same name and only a name is entered, the program uses the first context it finds with a matching name.
If the Event field is blank, any data in the Object ID field are ignored, and the next or previous event of any type is found in the specified context.
If the Event field and the Context ID field are blank, then the next or previous event of any type in any context is found.
After you have specified the search parameters, click the appropriate arrow to perform the search.
When the next (or previous) occurrence of the event is found, the Context View graph displays the time interval in which it occurs, and indicates the occurrence that it found by placing a vertical line through it. Timing information is displayed in the Detailed Information field (see “Using the Context View Graph”).
The CPU Search window works the same way, but note that event symbols are not normally displayed in the CPU View graph window. You have to enable symbol display by check marking events in the Display Events/States window. For more information, see “Display Events/States Window”.
To search for another occurrence of the event, you can use the Search window again, or you can use the Search Accelerator icons in the Context Graph. For information on these icons, see “Search Accelerator Icons”.
|Note: You can display multiple Search windows for a graph. Each Search window is labeled sequentially. The first number represents the graph window from which you invoked the Search window, and the second number represents which Search window it is, relative to all Search windows currently displayed for this Context graph. For example, if you have two Context graphs open, the second window you opened is labeled Context View 2. Clicking the S button in this window launches the Search dialog labeled 2.1, the first search for View 2. The next Search window for Context View 2 would be labeled Search 2.2. The maximum number of Search windows for each Context View graph is 16.|
Before using this window, you need to collect system call information, not collected by default. First run irixview as superuser. In the Target window, select Syscall, and collect event data from the local host.
Choosing Windows > System Call Summary then shows system calls that occurred during the collection period, as shown in Figure 6-20.
This choice is located in the Windows menu, and displays the Target window, as shown in Figure 6-21. This window lets you do the following:
If you click and hold the left mouse button over this menu icon, you can choose the unit of time displayed in the Timeline and the Detailed Time Information field (see “Using the Context View Graph” for information on these locations). The choices are:
seconds (the default)
This icon is located in the icon bar of a Context or CPU View graph, which are displayed with the “New Graph” choices in the Windows menu.
When you click this icon, IRIXview displays the View Control window, as shown in Figure 6-24. This window contains commands that let you change how the event log is treated within the graph subwindow.
To use this window, follow these steps:
In the From and To fields, you can specify which time interval, in units of seconds or event sequence numbers, which you would like to examine.
For example, type 1 in the From field and 2.5 in the To field, and then click the Go To button to view the interval from second 1 to second 2.5. Use whole numbers to specify the range of event sequence numbers you want displayed; for example, from 0 to 25, or from 1500 to 2000.
The Left and Right Arrow buttons act like the Pan Left and Pan Right icons on the Context Graph (see “Pan Left/Pan Right Icons”), but are constrained by the Preserve (%) field.
For example, if Preserve is set to 50, the arrows move the view forward or back one-half page at a time (where a page is the width of the current time interval). However, if Preserve is set to 90, they move forward and back just 10% of the current time interval at a time. If Preserve is set to 0, they act the same as the icons on the Context Graph; if Preserve is 100, these arrows are disabled.
The Zoom In and Zoom Out buttons act like the zoom icons (see “Zoom In/Zoom Out Icons”) but are constrained by the Factor field.
For example, if Factor is set to 10, this Zoom In displays 10% of the current time interval and this Zoom Out displays 10 times the current time interval. If Factor is set to 2, they act like the zoom icons on the Context Graph (Zoom In displays half the current time interval and Zoom Out displays 2 times the current interval). But if Factor is set to less than 1, the actions of these zoom buttons are reversed.
Clicking the Display Events button causes the Display Events/States window to appear; see “Display Events/States Window”.
The capital Z (Zoom In) icon lets you focus on details; the lowercase z (Zoom Out) icon lets you focus on a bigger picture. Keyboard shortcuts are available: you can press the Z key to zoom in or the z key to zoom out.
Zoom In halves the time interval displayed, preserving the screen's midpoint. If a sub-interval is selected, the boundaries of the sub-interval become the time interval's boundaries.
For information on selecting a sub-interval, see “Selecting Event Data”.