arduino-0018-windows
This commit is contained in:
parent
157fd6f1a1
commit
f39fc49523
5182 changed files with 950586 additions and 0 deletions
|
@ -0,0 +1,101 @@
|
|||
<html lang="en">
|
||||
<head>
|
||||
<title>Introduction - GNU gprof</title>
|
||||
<meta http-equiv="Content-Type" content="text/html">
|
||||
<meta name="description" content="GNU gprof">
|
||||
<meta name="generator" content="makeinfo 4.7">
|
||||
<link title="Top" rel="start" href="index.html#Top">
|
||||
<link rel="prev" href="index.html#Top" title="Top">
|
||||
<link rel="next" href="Compiling.html#Compiling" title="Compiling">
|
||||
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
|
||||
<!--
|
||||
This file documents the gprof profiler of the GNU system.
|
||||
|
||||
Copyright (C) 1988, 92, 97, 98, 99, 2000, 2001, 2003, 2007 Free Software Foundation, Inc.
|
||||
|
||||
Permission is granted to copy, distribute and/or modify this document
|
||||
under the terms of the GNU Free Documentation License, Version 1.1
|
||||
or any later version published by the Free Software Foundation;
|
||||
with no Invariant Sections, with no Front-Cover Texts, and with no
|
||||
Back-Cover Texts. A copy of the license is included in the
|
||||
section entitled ``GNU Free Documentation License''.
|
||||
|
||||
man end-->
|
||||
<meta http-equiv="Content-Style-Type" content="text/css">
|
||||
<style type="text/css"><!--
|
||||
pre.display { font-family:inherit }
|
||||
pre.format { font-family:inherit }
|
||||
pre.smalldisplay { font-family:inherit; font-size:smaller }
|
||||
pre.smallformat { font-family:inherit; font-size:smaller }
|
||||
pre.smallexample { font-size:smaller }
|
||||
pre.smalllisp { font-size:smaller }
|
||||
span.sc { font-variant:small-caps }
|
||||
span.roman { font-family: serif; font-weight: normal; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
<div class="node">
|
||||
<p>
|
||||
<a name="Introduction"></a>Next: <a rel="next" accesskey="n" href="Compiling.html#Compiling">Compiling</a>,
|
||||
Previous: <a rel="previous" accesskey="p" href="index.html#Top">Top</a>,
|
||||
Up: <a rel="up" accesskey="u" href="index.html#Top">Top</a>
|
||||
<hr><br>
|
||||
</div>
|
||||
|
||||
<h2 class="chapter">1 Introduction to Profiling</h2>
|
||||
|
||||
<p>Profiling allows you to learn where your program spent its time and which
|
||||
functions called which other functions while it was executing. This
|
||||
information can show you which pieces of your program are slower than you
|
||||
expected, and might be candidates for rewriting to make your program
|
||||
execute faster. It can also tell you which functions are being called more
|
||||
or less often than you expected. This may help you spot bugs that had
|
||||
otherwise been unnoticed.
|
||||
|
||||
<p>Since the profiler uses information collected during the actual execution
|
||||
of your program, it can be used on programs that are too large or too
|
||||
complex to analyze by reading the source. However, how your program is run
|
||||
will affect the information that shows up in the profile data. If you
|
||||
don't use some feature of your program while it is being profiled, no
|
||||
profile information will be generated for that feature.
|
||||
|
||||
<p>Profiling has several steps:
|
||||
|
||||
<ul>
|
||||
<li>You must compile and link your program with profiling enabled.
|
||||
See <a href="Compiling.html#Compiling">Compiling a Program for Profiling</a>.
|
||||
|
||||
<li>You must execute your program to generate a profile data file.
|
||||
See <a href="Executing.html#Executing">Executing the Program</a>.
|
||||
|
||||
<li>You must run <code>gprof</code> to analyze the profile data.
|
||||
See <a href="Invoking.html#Invoking"><code>gprof</code> Command Summary</a>.
|
||||
</ul>
|
||||
|
||||
<p>The next three chapters explain these steps in greater detail.
|
||||
|
||||
<!-- man begin DESCRIPTION -->
|
||||
<p>Several forms of output are available from the analysis.
|
||||
|
||||
<p>The <dfn>flat profile</dfn> shows how much time your program spent in each function,
|
||||
and how many times that function was called. If you simply want to know
|
||||
which functions burn most of the cycles, it is stated concisely here.
|
||||
See <a href="Flat-Profile.html#Flat-Profile">The Flat Profile</a>.
|
||||
|
||||
<p>The <dfn>call graph</dfn> shows, for each function, which functions called it, which
|
||||
other functions it called, and how many times. There is also an estimate
|
||||
of how much time was spent in the subroutines of each function. This can
|
||||
suggest places where you might try to eliminate function calls that use a
|
||||
lot of time. See <a href="Call-Graph.html#Call-Graph">The Call Graph</a>.
|
||||
|
||||
<p>The <dfn>annotated source</dfn> listing is a copy of the program's
|
||||
source code, labeled with the number of times each line of the
|
||||
program was executed. See <a href="Annotated-Source.html#Annotated-Source">The Annotated Source Listing</a>.
|
||||
<!-- man end -->
|
||||
|
||||
<p>To better understand how profiling works, you may wish to read
|
||||
a description of its implementation.
|
||||
See <a href="Implementation.html#Implementation">Implementation of Profiling</a>.
|
||||
|
||||
</body></html>
|
||||
|
Reference in a new issue