lttv/doc/user/user_guide/html/c42.html

   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 >&#13;This section describes the main functionnalities that are provided by the LTTV
  85 GUI and how to use them.
  86 </P
  87 ><P
  88 >&#13;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 >&#13;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 >&#13;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 >&#13;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 >&#13;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 >&#13;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 >&#13;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 >&#13;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 >&#13;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 >&#13;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 >&#13;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 >&#13;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 >&#13;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 >&nbsp;</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 >