[OpenSPARC-T2-SAM] / sam-t2 / devtools / v8plus / html / python / lib / profile.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<link rel="STYLESHEET" href="lib.css" type='text/css' />
<link rel="SHORTCUT ICON" href="../icons/pyfav.png" type="image/png" />
<link rel='start' href='../index.html' title='Python Documentation Index' />
<link rel="first" href="lib.html" title='Python Library Reference' />
<link rel='contents' href='contents.html' title="Contents" />
<link rel='index' href='genindex.html' title='Index' />
<link rel='last' href='about.html' title='About this document...' />
<link rel='help' href='about.html' title='About this document...' />
<link rel="next" href="internet.html" />
<link rel="prev" href="module-pdb.html" />
<link rel="parent" href="lib.html" />
<link rel="next" href="node450.html" />
<meta name='aesop' content='information' />
<title>10. The Python Profiler </title>
</head>
<body>
<DIV CLASS="navigation">
<div id='top-navigation-panel' xml:id='top-navigation-panel'>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="9.2 How It Works"
  href="debugger-hooks.html"><img src='../icons/previous.png'
  border='0' height='32'  alt='Previous Page' width='32' /></A></td>
<td class='online-navigation'><a rel="parent" title="Python Library Reference"
  href="lib.html"><img src='../icons/up.png'
  border='0' height='32'  alt='Up One Level' width='32' /></A></td>
<td class='online-navigation'><a rel="next" title="10.1 Introduction to the"
  href="node450.html"><img src='../icons/next.png'
  border='0' height='32'  alt='Next Page' width='32' /></A></td>
<td align="center" width="100%">Python Library Reference</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
  href="contents.html"><img src='../icons/contents.png'
  border='0' height='32'  alt='Contents' width='32' /></A></td>
<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
  border='0' height='32'  alt='Module Index' width='32' /></a></td>
<td class='online-navigation'><a rel="index" title="Index"
  href="genindex.html"><img src='../icons/index.png'
  border='0' height='32'  alt='Index' width='32' /></A></td>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="debugger-hooks.html">9.2 How It Works</A>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="lib.html">Python Library Reference</A>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="node450.html">10.1 Introduction to the</A>
</div>
<hr /></div>
</DIV>
<!--End of Navigation Panel-->

<H1><A NAME="SECTION0012000000000000000000"></A><A NAME="profile"></A>
<BR>
10. The Python Profiler 
</H1>

<P>

<P>
Copyright &#169; 1994, by InfoSeek Corporation, all rights reserved.
<a id='l2h-3105' xml:id='l2h-3105'></a>

<P>
Written by James Roskind.<A NAME="tex2html50"
  HREF="#foot46120"><SUP>10.1</SUP></A>
<P>
Permission to use, copy, modify, and distribute this Python software
and its associated documentation for any purpose (subject to the
restriction in the following sentence) without fee is hereby granted,
provided that the above copyright notice appears in all copies, and
that both that copyright notice and this permission notice appear in
supporting documentation, and that the name of InfoSeek not be used in
advertising or publicity pertaining to distribution of the software
without specific, written prior permission.  This permission is
explicitly restricted to the copying and modification of the software
to remain in Python, compiled Python, or other languages (such as C)
wherein the modified or derived code is exclusively imported into a
Python module.

<P>
INFOSEEK CORPORATION DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS
SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS. IN NO EVENT SHALL INFOSEEK CORPORATION BE LIABLE FOR ANY
SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER
RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF
CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

<P>
The profiler was written after only programming in Python for 3 weeks.
As a result, it is probably clumsy code, but I don't know for sure yet
'cause I'm a beginner :-).  I did work hard to make the code run fast,
so that profiling would be a reasonable thing to do.  I tried not to
repeat code fragments, but I'm sure I did some stuff in really awkward
ways at times.  Please send suggestions for improvements to:
<span class="email">jar@netscape.com</span>.  I won't promise <em>any</em> support.  ...but
I'd appreciate the feedback.

<P>
<BR><HR><H4>Footnotes</H4>
<DL>
<DT><A NAME="foot46120">... Roskind.</A><A
 href="profile.html#tex2html50"><SUP>10.1</SUP></A></DT>
<DD>
  Updated and converted to <span class="LaTeX">LaTeX</span> by Guido van Rossum.  The references to
  the old profiler are left in the text, although it no longer exists.

</DD>
</DL>
<p><br /></p><hr class='online-navigation' />
<div class='online-navigation'>
<!--Table of Child-Links-->
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></a>

<UL CLASS="ChildLinks">
<LI><A href="node450.html">10.1 Introduction to the profiler</a>
<LI><A href="node451.html">10.2 How Is This Profiler Different From The Old Profiler?</a>
<LI><A href="profile-instant.html">10.3 Instant Users Manual</a>
<LI><A href="node453.html">10.4 What Is Deterministic Profiling?</a>
<LI><A href="module-profile.html">10.5 Reference Manual</a>
<UL>
<LI><A href="profile-stats.html">10.5.1 The <tt class="class">Stats</tt> Class</a>
</ul>
<LI><A href="profile-limits.html">10.6 Limitations</a>
<LI><A href="profile-calibration.html">10.7 Calibration</a>
<LI><A href="node458.html">10.8 Extensions -- Deriving Better Profilers</a>
<LI><A href="module-hotshot.html">10.9 <tt class="module">hotshot</tt> --
         High performance logging profiler</a>
<UL>
<LI><A href="hotshot-objects.html">10.9.1 Profile Objects</a>
<LI><A href="module-hotshot.stats.html">10.9.2 Using hotshot data</a>
<LI><A href="hotshot-example.html">10.9.3 Example Usage</a>
</ul>
<LI><A href="module-timeit.html">10.10 <tt class="module">timeit</tt> --
         Measure execution time of small code snippets</a>
<UL>
<LI><A href="node464.html">10.10.1 Command Line Interface</a>
<LI><A href="node465.html">10.10.2 Examples</a>
</ul></ul>
<!--End of Table of Child-Links-->
</div>

<DIV CLASS="navigation">
<div class='online-navigation'>
<p></p><hr />
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="9.2 How It Works"
  href="debugger-hooks.html"><img src='../icons/previous.png'
  border='0' height='32'  alt='Previous Page' width='32' /></A></td>
<td class='online-navigation'><a rel="parent" title="Python Library Reference"
  href="lib.html"><img src='../icons/up.png'
  border='0' height='32'  alt='Up One Level' width='32' /></A></td>
<td class='online-navigation'><a rel="next" title="10.1 Introduction to the"
  href="node450.html"><img src='../icons/next.png'
  border='0' height='32'  alt='Next Page' width='32' /></A></td>
<td align="center" width="100%">Python Library Reference</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
  href="contents.html"><img src='../icons/contents.png'
  border='0' height='32'  alt='Contents' width='32' /></A></td>
<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
  border='0' height='32'  alt='Module Index' width='32' /></a></td>
<td class='online-navigation'><a rel="index" title="Index"
  href="genindex.html"><img src='../icons/index.png'
  border='0' height='32'  alt='Index' width='32' /></A></td>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="debugger-hooks.html">9.2 How It Works</A>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="lib.html">Python Library Reference</A>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="node450.html">10.1 Introduction to the</A>
</div>
</div>
<hr />
<span class="release-info">Release 2.4.2, documentation updated on 28 September 2005.</span>
</DIV>
<!--End of Navigation Panel-->
<ADDRESS>
See <i><a href="about.html">About this document...</a></i> for information on suggesting changes.
</ADDRESS>
</BODY>
</HTML>
Commit	Line	Data
920dae64 AT	1	<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
	2	<html>
	3	<head>
	4	<link rel="STYLESHEET" href="lib.css" type='text/css' />
	5	<link rel="SHORTCUT ICON" href="../icons/pyfav.png" type="image/png" />
	6	<link rel='start' href='../index.html' title='Python Documentation Index' />
	7	<link rel="first" href="lib.html" title='Python Library Reference' />
	8	<link rel='contents' href='contents.html' title="Contents" />
	9	<link rel='index' href='genindex.html' title='Index' />
	10	<link rel='last' href='about.html' title='About this document...' />
	11	<link rel='help' href='about.html' title='About this document...' />
	12	<link rel="next" href="internet.html" />
	13	<link rel="prev" href="module-pdb.html" />
	14	<link rel="parent" href="lib.html" />
	15	<link rel="next" href="node450.html" />
	16	<meta name='aesop' content='information' />
	17	<title>10. The Python Profiler </title>
	18	</head>
	19	<body>
	20	<DIV CLASS="navigation">
	21	<div id='top-navigation-panel' xml:id='top-navigation-panel'>
	22	<table align="center" width="100%" cellpadding="0" cellspacing="2">
	23	<tr>
	24	<td class='online-navigation'><a rel="prev" title="9.2 How It Works"
	25	href="debugger-hooks.html"><img src='../icons/previous.png'
	26	border='0' height='32' alt='Previous Page' width='32' /></A></td>
	27	<td class='online-navigation'><a rel="parent" title="Python Library Reference"
	28	href="lib.html"><img src='../icons/up.png'
	29	border='0' height='32' alt='Up One Level' width='32' /></A></td>
	30	<td class='online-navigation'><a rel="next" title="10.1 Introduction to the"
	31	href="node450.html"><img src='../icons/next.png'
	32	border='0' height='32' alt='Next Page' width='32' /></A></td>
	33	<td align="center" width="100%">Python Library Reference</td>
	34	<td class='online-navigation'><a rel="contents" title="Table of Contents"
	35	href="contents.html"><img src='../icons/contents.png'
	36	border='0' height='32' alt='Contents' width='32' /></A></td>
	37	<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
	38	border='0' height='32' alt='Module Index' width='32' /></a></td>
	39	<td class='online-navigation'><a rel="index" title="Index"
	40	href="genindex.html"><img src='../icons/index.png'
	41	border='0' height='32' alt='Index' width='32' /></A></td>
	42	</tr></table>
	43	<div class='online-navigation'>
	44	<b class="navlabel">Previous:</b>
	45	<a class="sectref" rel="prev" href="debugger-hooks.html">9.2 How It Works</A>
	46	<b class="navlabel">Up:</b>
	47	<a class="sectref" rel="parent" href="lib.html">Python Library Reference</A>
	48	<b class="navlabel">Next:</b>
	49	<a class="sectref" rel="next" href="node450.html">10.1 Introduction to the</A>
	50	</div>
	51	<hr /></div>
	52	</DIV>
	53	<!--End of Navigation Panel-->
	54
	55	<H1><A NAME="SECTION0012000000000000000000"></A><A NAME="profile"></A>
	56	<BR>
	57	10. The Python Profiler
	58	</H1>
	59
	60	<P>
	61
	62	<P>
	63	Copyright © 1994, by InfoSeek Corporation, all rights reserved.
	64	<a id='l2h-3105' xml:id='l2h-3105'></a>
65
66	<P>
67	Written by James Roskind.<A NAME="tex2html50"
68	HREF="#foot46120"><SUP>10.1</SUP></A>
69	<P>
70	Permission to use, copy, modify, and distribute this Python software
71	and its associated documentation for any purpose (subject to the
72	restriction in the following sentence) without fee is hereby granted,
73	provided that the above copyright notice appears in all copies, and
74	that both that copyright notice and this permission notice appear in
75	supporting documentation, and that the name of InfoSeek not be used in
76	advertising or publicity pertaining to distribution of the software
77	without specific, written prior permission. This permission is
78	explicitly restricted to the copying and modification of the software
79	to remain in Python, compiled Python, or other languages (such as C)
80	wherein the modified or derived code is exclusively imported into a
81	Python module.
82
83	<P>
84	INFOSEEK CORPORATION DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS
85	SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
86	FITNESS. IN NO EVENT SHALL INFOSEEK CORPORATION BE LIABLE FOR ANY
87	SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER
88	RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF
89	CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
90	CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
91
92	<P>
93	The profiler was written after only programming in Python for 3 weeks.
94	As a result, it is probably clumsy code, but I don't know for sure yet
95	'cause I'm a beginner :-). I did work hard to make the code run fast,
96	so that profiling would be a reasonable thing to do. I tried not to
97	repeat code fragments, but I'm sure I did some stuff in really awkward
98	ways at times. Please send suggestions for improvements to:
99	<span class="email">jar@netscape.com</span>. I won't promise <em>any</em> support. ...but
100	I'd appreciate the feedback.
101
102	<P>
103	<BR><HR><H4>Footnotes</H4>
104	<DL>
105	<DT><A NAME="foot46120">... Roskind.</A><A
106	href="profile.html#tex2html50"><SUP>10.1</SUP></A></DT>
107	<DD>
108	Updated and converted to <span class="LaTeX">LaTeX</span> by Guido van Rossum. The references to
109	the old profiler are left in the text, although it no longer exists.
110
111	</DD>
112	</DL>
113	<p><br /></p><hr class='online-navigation' />
114	<div class='online-navigation'>
115	<!--Table of Child-Links-->
116	<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></a>
117
118	<UL CLASS="ChildLinks">
119	<LI><A href="node450.html">10.1 Introduction to the profiler</a>
120	<LI><A href="node451.html">10.2 How Is This Profiler Different From The Old Profiler?</a>
121	<LI><A href="profile-instant.html">10.3 Instant Users Manual</a>
122	<LI><A href="node453.html">10.4 What Is Deterministic Profiling?</a>
123	<LI><A href="module-profile.html">10.5 Reference Manual</a>
124	<UL>
125	<LI><A href="profile-stats.html">10.5.1 The <tt class="class">Stats</tt> Class</a>
126	</ul>
127	<LI><A href="profile-limits.html">10.6 Limitations</a>
128	<LI><A href="profile-calibration.html">10.7 Calibration</a>
129	<LI><A href="node458.html">10.8 Extensions -- Deriving Better Profilers</a>
130	<LI><A href="module-hotshot.html">10.9 <tt class="module">hotshot</tt> --
131	High performance logging profiler</a>
132	<UL>
133	<LI><A href="hotshot-objects.html">10.9.1 Profile Objects</a>
134	<LI><A href="module-hotshot.stats.html">10.9.2 Using hotshot data</a>
135	<LI><A href="hotshot-example.html">10.9.3 Example Usage</a>
136	</ul>
137	<LI><A href="module-timeit.html">10.10 <tt class="module">timeit</tt> --
138	Measure execution time of small code snippets</a>
139	<UL>
140	<LI><A href="node464.html">10.10.1 Command Line Interface</a>
141	<LI><A href="node465.html">10.10.2 Examples</a>
142	</ul></ul>
143	<!--End of Table of Child-Links-->
144	</div>
145
146	<DIV CLASS="navigation">
147	<div class='online-navigation'>
148	<p></p><hr />
149	<table align="center" width="100%" cellpadding="0" cellspacing="2">
150	<tr>
151	<td class='online-navigation'><a rel="prev" title="9.2 How It Works"
152	href="debugger-hooks.html"><img src='../icons/previous.png'
153	border='0' height='32' alt='Previous Page' width='32' /></A></td>
154	<td class='online-navigation'><a rel="parent" title="Python Library Reference"
155	href="lib.html"><img src='../icons/up.png'
156	border='0' height='32' alt='Up One Level' width='32' /></A></td>
157	<td class='online-navigation'><a rel="next" title="10.1 Introduction to the"
158	href="node450.html"><img src='../icons/next.png'
159	border='0' height='32' alt='Next Page' width='32' /></A></td>
160	<td align="center" width="100%">Python Library Reference</td>
161	<td class='online-navigation'><a rel="contents" title="Table of Contents"
162	href="contents.html"><img src='../icons/contents.png'
163	border='0' height='32' alt='Contents' width='32' /></A></td>
164	<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
165	border='0' height='32' alt='Module Index' width='32' /></a></td>
166	<td class='online-navigation'><a rel="index" title="Index"
167	href="genindex.html"><img src='../icons/index.png'
168	border='0' height='32' alt='Index' width='32' /></A></td>
169	</tr></table>
170	<div class='online-navigation'>
171	<b class="navlabel">Previous:</b>
172	<a class="sectref" rel="prev" href="debugger-hooks.html">9.2 How It Works</A>
173	<b class="navlabel">Up:</b>
174	<a class="sectref" rel="parent" href="lib.html">Python Library Reference</A>
175	<b class="navlabel">Next:</b>
176	<a class="sectref" rel="next" href="node450.html">10.1 Introduction to the</A>
177	</div>
178	</div>
179	<hr />
180	<span class="release-info">Release 2.4.2, documentation updated on 28 September 2005.</span>
181	</DIV>
182	<!--End of Navigation Panel-->
183	<ADDRESS>
184	See <i><a href="about.html">About this document...</a></i> for information on suggesting changes.
185	</ADDRESS>
186	</BODY>
187	</HTML>