b1053af5 |
1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> |
2 | <HTML |
3 | ><HEAD |
4 | ><TITLE |
5 | >Using LTTV graphical interface</TITLE |
6 | ><META |
7 | NAME="GENERATOR" |
8 | CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK |
9 | REL="HOME" |
10 | TITLE="Linux Trace Toolkit Viewer User Guide" |
11 | HREF="index.html"><LINK |
12 | REL="PREVIOUS" |
13 | TITLE="Running the executable with basic libraries" |
14 | HREF="x81.html"><LINK |
15 | REL="NEXT" |
16 | TITLE="Control Flow View Colors" |
17 | HREF="x130.html"></HEAD |
18 | ><BODY |
19 | CLASS="chapter" |
20 | BGCOLOR="#FFFFFF" |
21 | TEXT="#000000" |
22 | LINK="#0000FF" |
23 | VLINK="#840084" |
24 | ALINK="#0000FF" |
25 | ><DIV |
26 | CLASS="NAVHEADER" |
27 | ><TABLE |
28 | SUMMARY="Header navigation table" |
29 | WIDTH="100%" |
30 | BORDER="0" |
31 | CELLPADDING="0" |
32 | CELLSPACING="0" |
33 | ><TR |
34 | ><TH |
35 | COLSPAN="3" |
36 | ALIGN="center" |
37 | >Linux Trace Toolkit Viewer User Guide</TH |
38 | ></TR |
39 | ><TR |
40 | ><TD |
41 | WIDTH="10%" |
42 | ALIGN="left" |
43 | VALIGN="bottom" |
44 | ><A |
45 | HREF="x81.html" |
46 | ACCESSKEY="P" |
47 | >Prev</A |
48 | ></TD |
49 | ><TD |
50 | WIDTH="80%" |
51 | ALIGN="center" |
52 | VALIGN="bottom" |
53 | ></TD |
54 | ><TD |
55 | WIDTH="10%" |
56 | ALIGN="right" |
57 | VALIGN="bottom" |
58 | ><A |
59 | HREF="x130.html" |
60 | ACCESSKEY="N" |
61 | >Next</A |
62 | ></TD |
63 | ></TR |
64 | ></TABLE |
65 | ><HR |
66 | ALIGN="LEFT" |
67 | WIDTH="100%"></DIV |
68 | ><DIV |
69 | CLASS="chapter" |
70 | ><H1 |
71 | ><A |
72 | NAME="AEN91" |
73 | ></A |
74 | >Chapter 3. Using LTTV graphical interface</H1 |
75 | ><DIV |
76 | CLASS="sect1" |
77 | ><H1 |
78 | CLASS="sect1" |
79 | ><A |
80 | NAME="mainwindow" |
81 | >3.1. LTTV main window</A |
82 | ></H1 |
83 | ><P |
84 | > This section describes the main functionnalities that are provided by the LTTV |
85 | GUI and how to use them. |
86 | </P |
87 | ><P |
88 | > By default, when the lttv GUI starts with all the graphical modules loaded, |
89 | it loads the statistics viewer, the control flow viewer, and the detailed event |
90 | list inside a tab. Other viewers can be added later to this tab by interacting |
91 | with the main window. Let's describe the operations available on the window : |
92 | </P |
93 | ><DIV |
94 | CLASS="mediaobject" |
95 | ><P |
96 | ><IMG |
97 | SRC="lttv-numbered-5.png" |
98 | ALIGN="center"><DIV |
99 | CLASS="caption" |
100 | ><P |
101 | >Linux Trace Toolkit Viewer GUI</P |
102 | ></DIV |
103 | ></P |
104 | ></DIV |
105 | ><P |
106 | ></P |
107 | ><OL |
108 | TYPE="1" |
109 | ><LI |
110 | ><P |
111 | > This toolbar allows you to navigate through the basic functionnalities of LTTV. |
112 | The first button opens a new window and the second one, a new tab. You can leave |
113 | your mouse over the buttons to read the information provided by the tooltips. |
114 | </P |
115 | ></LI |
116 | ><LI |
117 | ><P |
118 | > This notebook, containing different tabs, lets you select the "Trace Set" you |
119 | want to interact with. A trace set is an aggregation of traces, synchronised in |
120 | time. You may also want to use one tab per viewer by simply cloning the traceset |
121 | to a new tab. This way, you can have vertically stacked viewers in one tab, as |
122 | well as different viewers, independant from the time interval. Note that once |
123 | the Trace Set cloning is done, each trace set becomes completely independant. |
124 | For Traceset cloning, see the File Menu. |
125 | </P |
126 | ></LI |
127 | ><LI |
128 | ><P |
129 | > These buttons let you control the computation in progress on a trace. As |
130 | sometimes the computation may last for a while, you may want to stop it, restart |
131 | it from the beginning or simply to continue from where you stopped. This is |
132 | exactly what those three buttons offer you. |
133 | </P |
134 | ></LI |
135 | ><LI |
136 | ><P |
137 | > Buttons on the right side of the last spacer are semantically different from the |
138 | others. While the other buttons at the left side of the bar are built in the |
139 | lttv program and let you operate the basic functionnalities, the buttons at the |
140 | right side let you add a viewer to the active Tab. They belong to the |
141 | viewers themselves. The number of buttons that appears there should directly |
142 | depend on the number of viewer's modules loaded. |
143 | </P |
144 | ></LI |
145 | ><LI |
146 | ><P |
147 | > This is a tree representing the multiple statistics available for the current |
148 | traceset. This is shown by the guistatistics viewer. |
149 | </P |
150 | ></LI |
151 | ><LI |
152 | ><P |
153 | > This is the Y axis of the guicontrolflow viewer. It shows the process list of |
154 | the traced system. You may notice that it grows : it dynamically adds |
155 | process when they appear in the trace. |
156 | </P |
157 | ></LI |
158 | ><LI |
159 | ><P |
160 | > This is a (missing) time bar for the X axis. Maybe will it be used for viewer |
161 | specific buttons eventually. Work in progress. |
162 | </P |
163 | ></LI |
164 | ><LI |
165 | ><P |
166 | > The is the current time selected. The concept of current event and current time |
167 | selected is synchronised in a Tab for all the viewers. The control flow viewer |
168 | shows it a vertical white dotted line. You move this marker by clicking on the |
169 | background of the process state graph. This graph shows evolution of each |
170 | process's state through time. The meaning of the colors will be explained later. |
171 | </P |
172 | ></LI |
173 | ><LI |
174 | ><P |
175 | > This is the details event list. It shown the detailed information about each |
176 | event of the trace. It is synchronised with the current time and current event, |
177 | so selecting an event changes other viewer's current time and reciprocally. |
178 | </P |
179 | ></LI |
180 | ><LI |
181 | ><P |
182 | > You can enter the values of start time and end time you wish to see on the |
183 | screen here. It also supports pasting time as text input, simply by clicking of |
184 | the "Time Frame", "start" or "end:" fields. A valid entry consists of any |
185 | digital input separated by any quantity of non digital characters. For example : |
186 | "I start at 356247.124626 and stop at 724524.453455" would be a valid input |
187 | for the "Time Frame" field. |
188 | </P |
189 | ></LI |
190 | ><LI |
191 | ><P |
192 | > This horizontal scrollbar modifies the window of time shown by all the viewers |
193 | in the tab. It is linked with the fields below it (described at number 10 and |
194 | 12). Another way to modify the time shown is to use the zoom buttons of the |
195 | toolbar (yes, the ones that looks like magnifying glasses). |
196 | </P |
197 | ></LI |
198 | ><LI |
199 | ><P |
200 | > This field works just like the "Time Frame" field. It modifies the current time |
201 | selected by the viewers. For example, changing its value will change the current |
202 | event selected by the detailed events list and the current time selected by the |
203 | control flow viewer. |
204 | </P |
205 | ></LI |
206 | ></OL |
207 | ></DIV |
208 | ></DIV |
209 | ><DIV |
210 | CLASS="NAVFOOTER" |
211 | ><HR |
212 | ALIGN="LEFT" |
213 | WIDTH="100%"><TABLE |
214 | SUMMARY="Footer navigation table" |
215 | WIDTH="100%" |
216 | BORDER="0" |
217 | CELLPADDING="0" |
218 | CELLSPACING="0" |
219 | ><TR |
220 | ><TD |
221 | WIDTH="33%" |
222 | ALIGN="left" |
223 | VALIGN="top" |
224 | ><A |
225 | HREF="x81.html" |
226 | ACCESSKEY="P" |
227 | >Prev</A |
228 | ></TD |
229 | ><TD |
230 | WIDTH="34%" |
231 | ALIGN="center" |
232 | VALIGN="top" |
233 | ><A |
234 | HREF="index.html" |
235 | ACCESSKEY="H" |
236 | >Home</A |
237 | ></TD |
238 | ><TD |
239 | WIDTH="33%" |
240 | ALIGN="right" |
241 | VALIGN="top" |
242 | ><A |
243 | HREF="x130.html" |
244 | ACCESSKEY="N" |
245 | >Next</A |
246 | ></TD |
247 | ></TR |
248 | ><TR |
249 | ><TD |
250 | WIDTH="33%" |
251 | ALIGN="left" |
252 | VALIGN="top" |
253 | >Running the executable with basic libraries</TD |
254 | ><TD |
255 | WIDTH="34%" |
256 | ALIGN="center" |
257 | VALIGN="top" |
258 | > </TD |
259 | ><TD |
260 | WIDTH="33%" |
261 | ALIGN="right" |
262 | VALIGN="top" |
263 | >Control Flow View Colors</TD |
264 | ></TR |
265 | ></TABLE |
266 | ></DIV |
267 | ></BODY |
268 | ></HTML |
269 | > |