104 lines
4.5 KiB
HTML
104 lines
4.5 KiB
HTML
<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.13">
|
|
<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-2019 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.3
|
|
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''.
|
|
|
|
-->
|
|
<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; }
|
|
span.sansserif { font-family:sans-serif; font-weight:normal; }
|
|
--></style>
|
|
</head>
|
|
<body>
|
|
<div class="node">
|
|
<a name="Introduction"></a>
|
|
<p>
|
|
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>
|
|
</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>
|
|
|