1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2<html> 3<!-- This file documents the gprof profiler of the GNU system. 4 5Copyright (C) 1988-2021 Free Software Foundation, Inc. 6 7Permission is granted to copy, distribute and/or modify this document 8under the terms of the GNU Free Documentation License, Version 1.3 9or any later version published by the Free Software Foundation; 10with no Invariant Sections, with no Front-Cover Texts, and with no 11Back-Cover Texts. A copy of the license is included in the 12section entitled "GNU Free Documentation License". 13 --> 14<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ --> 15<head> 16<title>GNU gprof: Deprecated Options</title> 17 18<meta name="description" content="GNU gprof: Deprecated Options"> 19<meta name="keywords" content="GNU gprof: Deprecated Options"> 20<meta name="resource-type" content="document"> 21<meta name="distribution" content="global"> 22<meta name="Generator" content="makeinfo"> 23<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 24<link href="index.html#Top" rel="start" title="Top"> 25<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> 26<link href="Invoking.html#Invoking" rel="up" title="Invoking"> 27<link href="Symspecs.html#Symspecs" rel="next" title="Symspecs"> 28<link href="Miscellaneous-Options.html#Miscellaneous-Options" rel="previous" title="Miscellaneous Options"> 29<style type="text/css"> 30<!-- 31a.summary-letter {text-decoration: none} 32blockquote.smallquotation {font-size: smaller} 33div.display {margin-left: 3.2em} 34div.example {margin-left: 3.2em} 35div.indentedblock {margin-left: 3.2em} 36div.lisp {margin-left: 3.2em} 37div.smalldisplay {margin-left: 3.2em} 38div.smallexample {margin-left: 3.2em} 39div.smallindentedblock {margin-left: 3.2em; font-size: smaller} 40div.smalllisp {margin-left: 3.2em} 41kbd {font-style:oblique} 42pre.display {font-family: inherit} 43pre.format {font-family: inherit} 44pre.menu-comment {font-family: serif} 45pre.menu-preformatted {font-family: serif} 46pre.smalldisplay {font-family: inherit; font-size: smaller} 47pre.smallexample {font-size: smaller} 48pre.smallformat {font-family: inherit; font-size: smaller} 49pre.smalllisp {font-size: smaller} 50span.nocodebreak {white-space:nowrap} 51span.nolinebreak {white-space:nowrap} 52span.roman {font-family:serif; font-weight:normal} 53span.sansserif {font-family:sans-serif; font-weight:normal} 54ul.no-bullet {list-style: none} 55--> 56</style> 57 58 59</head> 60 61<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000"> 62<a name="Deprecated-Options"></a> 63<div class="header"> 64<p> 65Next: <a href="Symspecs.html#Symspecs" accesskey="n" rel="next">Symspecs</a>, Previous: <a href="Miscellaneous-Options.html#Miscellaneous-Options" accesskey="p" rel="previous">Miscellaneous Options</a>, Up: <a href="Invoking.html#Invoking" accesskey="u" rel="up">Invoking</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> 66</div> 67<hr> 68<a name="Deprecated-Options-1"></a> 69<h3 class="section">4.4 Deprecated Options</h3> 70 71<p>These options have been replaced with newer versions that use symspecs. 72</p> 73<dl compact="compact"> 74<dt><code>-e <var>function_name</var></code></dt> 75<dd><p>The ‘<samp>-e <var>function</var></samp>’ option tells <code>gprof</code> to not print 76information about the function <var>function_name</var> (and its 77children…) in the call graph. The function will still be listed 78as a child of any functions that call it, but its index number will be 79shown as ‘<samp>[not printed]</samp>’. More than one ‘<samp>-e</samp>’ option may be 80given; only one <var>function_name</var> may be indicated with each ‘<samp>-e</samp>’ 81option. 82</p> 83</dd> 84<dt><code>-E <var>function_name</var></code></dt> 85<dd><p>The <code>-E <var>function</var></code> option works like the <code>-e</code> option, but 86time spent in the function (and children who were not called from 87anywhere else), will not be used to compute the percentages-of-time for 88the call graph. More than one ‘<samp>-E</samp>’ option may be given; only one 89<var>function_name</var> may be indicated with each ‘<samp>-E</samp>’ option. 90</p> 91</dd> 92<dt><code>-f <var>function_name</var></code></dt> 93<dd><p>The ‘<samp>-f <var>function</var></samp>’ option causes <code>gprof</code> to limit the 94call graph to the function <var>function_name</var> and its children (and 95their children…). More than one ‘<samp>-f</samp>’ option may be given; 96only one <var>function_name</var> may be indicated with each ‘<samp>-f</samp>’ 97option. 98</p> 99</dd> 100<dt><code>-F <var>function_name</var></code></dt> 101<dd><p>The ‘<samp>-F <var>function</var></samp>’ option works like the <code>-f</code> option, but 102only time spent in the function and its children (and their 103children…) will be used to determine total-time and 104percentages-of-time for the call graph. More than one ‘<samp>-F</samp>’ option 105may be given; only one <var>function_name</var> may be indicated with each 106‘<samp>-F</samp>’ option. The ‘<samp>-F</samp>’ option overrides the ‘<samp>-E</samp>’ option. 107</p> 108</dd> 109</dl> 110 111 112<p>Note that only one function can be specified with each <code>-e</code>, 113<code>-E</code>, <code>-f</code> or <code>-F</code> option. To specify more than one 114function, use multiple options. For example, this command: 115</p> 116<div class="example"> 117<pre class="example">gprof -e boring -f foo -f bar myprogram > gprof.output 118</pre></div> 119 120<p>lists in the call graph all functions that were reached from either 121<code>foo</code> or <code>bar</code> and were not reachable from <code>boring</code>. 122</p> 123<hr> 124<div class="header"> 125<p> 126Next: <a href="Symspecs.html#Symspecs" accesskey="n" rel="next">Symspecs</a>, Previous: <a href="Miscellaneous-Options.html#Miscellaneous-Options" accesskey="p" rel="previous">Miscellaneous Options</a>, Up: <a href="Invoking.html#Invoking" accesskey="u" rel="up">Invoking</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> 127</div> 128 129 130 131</body> 132</html> 133