| 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="x32.html"><LINK |
| 15 | REL="NEXT" |
| 16 | TITLE="Control Flow View Colors" |
| 17 | HREF="x81.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="x32.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="x81.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="AEN42" |
| 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="x32.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="x81.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 | > |