[lttv.git] / trunk / lttv / doc / user / user_guide / html / c42.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Using LTTV graphical interface</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="Linux Trace Toolkit Viewer User Guide"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="Running the executable with basic libraries"
HREF="x32.html"><LINK
REL="NEXT"
TITLE="Control Flow View Colors"
HREF="x81.html"></HEAD
><BODY
CLASS="chapter"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>Linux Trace Toolkit Viewer User Guide</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="x32.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="x81.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="chapter"
><H1
><A
NAME="AEN42"
></A
>Chapter 3. Using LTTV graphical interface</H1
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="mainwindow"
>3.1. LTTV main window</A
></H1
><P
>&#13;This section describes the main functionnalities that are provided by the LTTV
GUI and how to use them.
</P
><P
>&#13;By default, when the lttv GUI starts with all the graphical modules loaded,
it loads the statistics viewer, the control flow viewer, and the detailed event
list inside a tab. Other viewers can be added later to this tab by interacting
with the main window. Let's describe the operations available on the window :
</P
><DIV
CLASS="mediaobject"
><P
><IMG
SRC="lttv-numbered-5.png"
ALIGN="center"><DIV
CLASS="caption"
><P
>Linux Trace Toolkit Viewer GUI</P
></DIV
></P
></DIV
><P
></P
><OL
TYPE="1"
><LI
><P
>&#13;This toolbar allows you to navigate through the basic functionnalities of LTTV.
The first button opens a new window and the second one, a new tab. You can leave
your mouse over the buttons to read the information provided by the tooltips.
</P
></LI
><LI
><P
>&#13;This notebook, containing different tabs, lets you select the "Trace Set" you
want to interact with. A trace set is an aggregation of traces, synchronised in
time. You may also want to use one tab per viewer by simply cloning the traceset
to a new tab. This way, you can have vertically stacked viewers in one tab, as
well as different viewers, independant from the time interval. Note that once
the Trace Set cloning is done, each trace set becomes completely independant.
For Traceset cloning, see the File Menu.
</P
></LI
><LI
><P
>&#13;These buttons let you control the computation in progress on a trace. As
sometimes the computation may last for a while, you may want to stop it, restart
it from the beginning or simply to continue from where you stopped. This is
exactly what those three buttons offer you.
</P
></LI
><LI
><P
>&#13;Buttons on the right side of the last spacer are semantically different from the
others. While the other buttons at the left side of the bar are built in the
lttv program and let you operate the basic functionnalities, the buttons at the
right side let you add a viewer to the active Tab. They belong to the
viewers themselves. The number of buttons that appears there should directly
depend on the number of viewer's modules loaded.
</P
></LI
><LI
><P
>&#13;This is a tree representing the multiple statistics available for the current
traceset. This is shown by the guistatistics viewer.
</P
></LI
><LI
><P
>&#13;This is the Y axis of the guicontrolflow viewer. It shows the process list of
the traced system. You may notice that it grows : it dynamically adds
process when they appear in the trace.
</P
></LI
><LI
><P
>&#13;This is a (missing) time bar for the X axis. Maybe will it be used for viewer
specific buttons eventually. Work in progress.
</P
></LI
><LI
><P
>&#13;The is the current time selected. The concept of current event and current time
selected is synchronised in a Tab for all the viewers. The control flow viewer
shows it a vertical white dotted line. You move this marker by clicking on the
background of the process state graph. This graph shows evolution of each
process's state through time. The meaning of the colors will be explained later.
</P
></LI
><LI
><P
>&#13;This is the details event list. It shown the detailed information about each
event of the trace. It is synchronised with the current time and current event,
so selecting an event changes other viewer's current time and reciprocally.
</P
></LI
><LI
><P
>&#13;You can enter the values of start time and end time you wish to see on the
screen here. It also supports pasting time as text input, simply by clicking of
the "Time Frame", "start" or "end:" fields. A valid entry consists of any
digital input separated by any quantity of non digital characters. For example :
"I start at 356247.124626 and stop at 724524.453455" would be a valid input
for the "Time Frame" field.
</P
></LI
><LI
><P
>&#13;This horizontal scrollbar modifies the window of time shown by all the viewers
in the tab. It is linked with the fields below it (described at number 10 and
12). Another way to modify the time shown is to use the zoom buttons of the
toolbar (yes, the ones that looks like magnifying glasses).
</P
></LI
><LI
><P
>&#13;This field works just like the "Time Frame" field. It modifies the current time
selected by the viewers. For example, changing its value will change the current
event selected by the detailed events list and the current time selected by the
control flow viewer.
</P
></LI
></OL
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="x32.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="x81.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Running the executable with basic libraries</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Control Flow View Colors</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
Commit	Line	Data
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"
54bfc655	14	HREF="x32.html"><LINK
b1053af5	15	REL="NEXT"
b1053af5	16	TITLE="Control Flow View Colors"
54bfc655	17	HREF="x81.html"></HEAD
b1053af5	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
54bfc655	45	HREF="x32.html"
b1053af5	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
54bfc655	59	HREF="x81.html"
b1053af5	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
54bfc655	72	NAME="AEN42"
b1053af5	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
54bfc655	225	HREF="x32.html"
b1053af5	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
54bfc655	243	HREF="x81.html"
b1053af5	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	>