[lttv.git] / trunk / lttng-xenomai / LinuxTraceToolkitViewer-0.8.61-xenoltt / 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
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
54bfc655	5	>Control Flow View Colors</TITLE
b1053af5	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"
54bfc655	13	TITLE="Using LTTV graphical interface"
54bfc655	14	HREF="c42.html"><LINK
b1053af5	15	REL="PREVIOUS"
b1053af5	16	TITLE="Using LTTV graphical interface"
54bfc655	17	HREF="c42.html"><LINK
	18	REL="NEXT"
	19	TITLE="Using LTTV text modules"
	20	HREF="c115.html"></HEAD
b1053af5	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
54bfc655	48	HREF="c42.html"
b1053af5	49	ACCESSKEY="P"
	50	>Prev</A
	51	></TD
	52	><TD
	53	WIDTH="80%"
	54	ALIGN="center"
	55	VALIGN="bottom"
54bfc655	56	>Chapter 3. Using LTTV graphical interface</TD
b1053af5	57	><TD
	58	WIDTH="10%"
	59	ALIGN="right"
	60	VALIGN="bottom"
	61	><A
54bfc655	62	HREF="c115.html"
b1053af5	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
54bfc655	76	NAME="ControlFlowColors"
54bfc655	77	>3.2. Control Flow View Colors</A
b1053af5	78	></H1
54bfc655	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
b1053af5	91	><P
54bfc655	92	> Here is a description of the colors used in the control flow view. Each color
54bfc655	93	represents a state of the process at a given time.
b1053af5	94	</P
b1053af5	95	><P
54bfc655	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.
b1053af5	126	</P
54bfc655	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
b1053af5	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
54bfc655	196	HREF="c42.html"
b1053af5	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
54bfc655	214	HREF="c115.html"
b1053af5	215	ACCESSKEY="N"
	216	>Next</A
	217	></TD
	218	></TR
	219	><TR
	220	><TD
	221	WIDTH="33%"
	222	ALIGN="left"
	223	VALIGN="top"
54bfc655	224	>Using LTTV graphical interface</TD
b1053af5	225	><TD
	226	WIDTH="34%"
	227	ALIGN="center"
	228	VALIGN="top"
	229	><A
54bfc655	230	HREF="c42.html"
b1053af5	231	ACCESSKEY="U"
	232	>Up</A
	233	></TD
	234	><TD
	235	WIDTH="33%"
	236	ALIGN="right"
	237	VALIGN="top"
54bfc655	238	>Using LTTV text modules</TD
b1053af5	239	></TR
	240	></TABLE
	241	></DIV
	242	></BODY
	243	></HTML
	244	>