[lttv.git] / tags / lttv-0.11.3-23102008 / doc / user / user_guide / html / x81.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Control Flow View Colors</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="UP"
TITLE="Using LTTV graphical interface"
HREF="c42.html"><LINK
REL="PREVIOUS"
TITLE="Using LTTV graphical interface"
HREF="c42.html"><LINK
REL="NEXT"
TITLE="Using LTTV text modules"
HREF="c115.html"></HEAD
><BODY
CLASS="sect1"
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="c42.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 3. Using LTTV graphical interface</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="c115.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="ControlFlowColors"
>3.2. Control Flow View Colors</A
></H1
><DIV
CLASS="mediaobject"
><P
><IMG
SRC="lttv-color-list.png"
ALIGN="center"><DIV
CLASS="caption"
><P
>Control Flow View Color Legend</P
></DIV
></P
></DIV
><P
>&#13;Here is a description of the colors used in the control flow view. Each color
represents a state of the process at a given time.
</P
><P
></P
><UL
><LI
><P
>&#13;White : this color is used for process from which state is not known. It may
happen when you seek quickly at a far time in the trace just after it has been
launched. At that moment, the precomputed state information is incomplete. The
"unknown" state is used to identify this. Note that the viewer gets refreshed
once the precomputation ends.
</P
></LI
><LI
><P
>&#13;Green : This color is only used for process when they are running in user mode.
That includes execution of all the source code of an executable as well as the
libraries it uses.
</P
></LI
><LI
><P
>&#13;Pale blue : A process is doing a system call to the kernel, and the mode is
switched from process limited rights to super user mode. Only code from the
kernel (including modules) should be run in that state.
</P
></LI
><LI
><P
>&#13;Yellow : The kernel is running a trap that services a fault. The most frequent
trap is the memory page fault trap : it is called every time a page is missing
from physical memory.
</P
></LI
><LI
><P
>&#13;Orange : IRQ servicing routine is running. It interrupts the currently running
process. As the IRQ does not change the currently running process (on some
architectures it uses the same stack as the process), the IRQ state is shown in
the state of the process. IRQ can be nested : a higher priority interrupt can
interrupt a lower priority interrupt.
</P
></LI
><LI
><P
>&#13;Pink : SoftIRQ handler is running. A SoftIRQ is normally triggered by an
interrupt that whishes to have some work done very soon, but not "now". This is
especially useful, for example, to have the longest part of the network stack
traversal done : a too long computation in the interrupt handler would increase
the latency of the system. Therefore, doing the long part of the computation in
a softirq that will be run just after the IRQ handler exits will permits to do
this work while interrupts are enabled, without increasing the system latency.
</P
></LI
><LI
><P
>&#13;Dark red : A process in that state is waiting for an input/output operation to
complete before it can continue its execution.
</P
></LI
><LI
><P
>&#13;Dark yellow : A process is ready to run, but waiting to get the CPU (a schedule
in event).
</P
></LI
><LI
><P
>&#13;Dark purple : A process in zombie state. This state happens when a process
exits and then waits for the parent to wait for it (wait() or waitpid()).
</P
></LI
><LI
><P
>&#13;Dark green : A process has just been created by its parent and is waiting for
first scheduling.
</P
></LI
><LI
><P
>&#13;Magenta : The process has exited, but still has the control of the CPU. It may
happend if it has some tasks to do in the exit system call.
</P
></LI
></UL
></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="c42.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="c115.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Using LTTV graphical interface</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="c42.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Using LTTV text modules</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
Commit	Line	Data
13ab9fcb	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	>Control Flow View Colors</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="UP"
	13	TITLE="Using LTTV graphical interface"
	14	HREF="c42.html"><LINK
	15	REL="PREVIOUS"
	16	TITLE="Using LTTV graphical interface"
	17	HREF="c42.html"><LINK
	18	REL="NEXT"
	19	TITLE="Using LTTV text modules"
	20	HREF="c115.html"></HEAD
	21	><BODY
	22	CLASS="sect1"
	23	BGCOLOR="#FFFFFF"
	24	TEXT="#000000"
	25	LINK="#0000FF"
	26	VLINK="#840084"
	27	ALINK="#0000FF"
	28	><DIV
	29	CLASS="NAVHEADER"
	30	><TABLE
	31	SUMMARY="Header navigation table"
	32	WIDTH="100%"
	33	BORDER="0"
	34	CELLPADDING="0"
	35	CELLSPACING="0"
	36	><TR
	37	><TH
	38	COLSPAN="3"
	39	ALIGN="center"
	40	>Linux Trace Toolkit Viewer User Guide</TH
	41	></TR
	42	><TR
	43	><TD
	44	WIDTH="10%"
	45	ALIGN="left"
	46	VALIGN="bottom"
	47	><A
	48	HREF="c42.html"
	49	ACCESSKEY="P"
	50	>Prev</A
	51	></TD
	52	><TD
	53	WIDTH="80%"
	54	ALIGN="center"
	55	VALIGN="bottom"
	56	>Chapter 3. Using LTTV graphical interface</TD
	57	><TD
	58	WIDTH="10%"
	59	ALIGN="right"
	60	VALIGN="bottom"
	61	><A
	62	HREF="c115.html"
	63	ACCESSKEY="N"
	64	>Next</A
65	></TD
66	></TR
67	></TABLE
68	><HR
69	ALIGN="LEFT"
70	WIDTH="100%"></DIV
71	><DIV
72	CLASS="sect1"
73	><H1
74	CLASS="sect1"
75	><A
76	NAME="ControlFlowColors"
77	>3.2. Control Flow View Colors</A
78	></H1
79	><DIV
80	CLASS="mediaobject"
81	><P
82	><IMG
83	SRC="lttv-color-list.png"
84	ALIGN="center"><DIV
85	CLASS="caption"
86	><P
87	>Control Flow View Color Legend</P
88	></DIV
89	></P
90	></DIV
91	><P
92	> Here is a description of the colors used in the control flow view. Each color
93	represents a state of the process at a given time.
94	</P
95	><P
96	></P
97	><UL
98	><LI
99	><P
100	> White : this color is used for process from which state is not known. It may
101	happen when you seek quickly at a far time in the trace just after it has been
102	launched. At that moment, the precomputed state information is incomplete. The
103	"unknown" state is used to identify this. Note that the viewer gets refreshed
104	once the precomputation ends.
105	</P
106	></LI
107	><LI
108	><P
109	> Green : This color is only used for process when they are running in user mode.
110	That includes execution of all the source code of an executable as well as the
111	libraries it uses.
112	</P
113	></LI
114	><LI
115	><P
116	> Pale blue : A process is doing a system call to the kernel, and the mode is
117	switched from process limited rights to super user mode. Only code from the
118	kernel (including modules) should be run in that state.
119	</P
120	></LI
121	><LI
122	><P
123	> Yellow : The kernel is running a trap that services a fault. The most frequent
124	trap is the memory page fault trap : it is called every time a page is missing
125	from physical memory.
126	</P
127	></LI
128	><LI
129	><P
130	> Orange : IRQ servicing routine is running. It interrupts the currently running
131	process. As the IRQ does not change the currently running process (on some
132	architectures it uses the same stack as the process), the IRQ state is shown in
133	the state of the process. IRQ can be nested : a higher priority interrupt can
134	interrupt a lower priority interrupt.
135	</P
136	></LI
137	><LI
138	><P
139	> Pink : SoftIRQ handler is running. A SoftIRQ is normally triggered by an
140	interrupt that whishes to have some work done very soon, but not "now". This is
141	especially useful, for example, to have the longest part of the network stack
142	traversal done : a too long computation in the interrupt handler would increase
143	the latency of the system. Therefore, doing the long part of the computation in
144	a softirq that will be run just after the IRQ handler exits will permits to do
145	this work while interrupts are enabled, without increasing the system latency.
146	</P
147	></LI
148	><LI
149	><P
150	> Dark red : A process in that state is waiting for an input/output operation to
151	complete before it can continue its execution.
152	</P
153	></LI
154	><LI
155	><P
156	> Dark yellow : A process is ready to run, but waiting to get the CPU (a schedule
157	in event).
158	</P
159	></LI
160	><LI
161	><P
162	> Dark purple : A process in zombie state. This state happens when a process
163	exits and then waits for the parent to wait for it (wait() or waitpid()).
164	</P
165	></LI
166	><LI
167	><P
168	> Dark green : A process has just been created by its parent and is waiting for
169	first scheduling.
170	</P
171	></LI
172	><LI
173	><P
174	> Magenta : The process has exited, but still has the control of the CPU. It may
175	happend if it has some tasks to do in the exit system call.
176	</P
177	></LI
178	></UL
179	></DIV
180	><DIV
181	CLASS="NAVFOOTER"
182	><HR
183	ALIGN="LEFT"
184	WIDTH="100%"><TABLE
185	SUMMARY="Footer navigation table"
186	WIDTH="100%"
187	BORDER="0"
188	CELLPADDING="0"
189	CELLSPACING="0"
190	><TR
191	><TD
192	WIDTH="33%"
193	ALIGN="left"
194	VALIGN="top"
195	><A
196	HREF="c42.html"
197	ACCESSKEY="P"
198	>Prev</A
199	></TD
200	><TD
201	WIDTH="34%"
202	ALIGN="center"
203	VALIGN="top"
204	><A
205	HREF="index.html"
206	ACCESSKEY="H"
207	>Home</A
208	></TD
209	><TD
210	WIDTH="33%"
211	ALIGN="right"
212	VALIGN="top"
213	><A
214	HREF="c115.html"
215	ACCESSKEY="N"
216	>Next</A
217	></TD
218	></TR
219	><TR
220	><TD
221	WIDTH="33%"
222	ALIGN="left"
223	VALIGN="top"
224	>Using LTTV graphical interface</TD
225	><TD
226	WIDTH="34%"
227	ALIGN="center"
228	VALIGN="top"
229	><A
230	HREF="c42.html"
231	ACCESSKEY="U"
232	>Up</A
233	></TD
234	><TD
235	WIDTH="33%"
236	ALIGN="right"
237	VALIGN="top"
238	>Using LTTV text modules</TD
239	></TR
240	></TABLE
241	></DIV
242	></BODY
243	></HTML
244	>