gprof.1 (131493) | gprof.1 (131507) |
---|---|
1.\" Copyright (c) 1983, 1990, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 16 unchanged lines hidden (view full) --- 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" 32.\" @(#)gprof.1 8.1 (Berkeley) 6/6/93 | 1.\" Copyright (c) 1983, 1990, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 16 unchanged lines hidden (view full) --- 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" 32.\" @(#)gprof.1 8.1 (Berkeley) 6/6/93 |
33.\" $FreeBSD: head/usr.bin/gprof/gprof.1 131493 2004-07-02 22:24:53Z ru $ | 33.\" $FreeBSD: head/usr.bin/gprof/gprof.1 131507 2004-07-03 00:24:45Z ru $ |
34.\" 35.Dd June 20, 2004 36.Dt GPROF 1 37.Os 38.Sh NAME 39.Nm gprof 40.Nd display call graph profile data 41.Sh SYNOPSIS --- 62 unchanged lines hidden (view full) --- 104time of its descendants is propagated to its (direct) call graph parents. 105.Pp 106Cycles are also shown, with an entry for the cycle as a whole and 107a listing of the members of the cycle and their contributions to the 108time and call counts of the cycle. 109.Pp 110Second, a flat profile is given, 111similar to that provided by | 34.\" 35.Dd June 20, 2004 36.Dt GPROF 1 37.Os 38.Sh NAME 39.Nm gprof 40.Nd display call graph profile data 41.Sh SYNOPSIS --- 62 unchanged lines hidden (view full) --- 104time of its descendants is propagated to its (direct) call graph parents. 105.Pp 106Cycles are also shown, with an entry for the cycle as a whole and 107a listing of the members of the cycle and their contributions to the 108time and call counts of the cycle. 109.Pp 110Second, a flat profile is given, 111similar to that provided by |
112.Xr prof 1 . | 112.Xr prof 1 . |
113This listing gives the total execution times, the call counts, 114the time in msec or usec the call spent in the routine itself, and 115the time in msec or usec the call spent in the routine itself including 116its descendants. 117.Pp 118Finally, an index of the function names is provided. 119.Pp 120The following options are available: --- 27 unchanged lines hidden (view full) --- 148.Ar name 149may be given with each 150.Fl e 151option. 152.It Fl E Ar name 153Suppress the printing of the graph profile entry for routine 154.Ar name 155(and its descendants) as | 113This listing gives the total execution times, the call counts, 114the time in msec or usec the call spent in the routine itself, and 115the time in msec or usec the call spent in the routine itself including 116its descendants. 117.Pp 118Finally, an index of the function names is provided. 119.Pp 120The following options are available: --- 27 unchanged lines hidden (view full) --- 148.Ar name 149may be given with each 150.Fl e 151option. 152.It Fl E Ar name 153Suppress the printing of the graph profile entry for routine 154.Ar name 155(and its descendants) as |
156.Fl e , | 156.Fl e , |
157above, and also excludes the time spent in 158.Ar name 159(and its descendants) from the total and percentage time computations. 160(For example, 161.Fl E 162.Ar mcount 163.Fl E 164.Ar mcleanup --- 150 unchanged lines hidden (view full) --- 315not have their time propagated further. 316Similarly, signal catchers, even though profiled, will appear 317to be spontaneous (although for more obscure reasons). 318Any profiled children of signal catchers should have their times 319propagated properly, unless the signal catcher was invoked during 320the execution of the profiling routine, in which case all is lost. 321.Pp 322The profiled program must call | 157above, and also excludes the time spent in 158.Ar name 159(and its descendants) from the total and percentage time computations. 160(For example, 161.Fl E 162.Ar mcount 163.Fl E 164.Ar mcleanup --- 150 unchanged lines hidden (view full) --- 315not have their time propagated further. 316Similarly, signal catchers, even though profiled, will appear 317to be spontaneous (although for more obscure reasons). 318Any profiled children of signal catchers should have their times 319propagated properly, unless the signal catcher was invoked during 320the execution of the profiling routine, in which case all is lost. 321.Pp 322The profiled program must call |
323.Xr exit 3 | 323.Xr exit 3 |
324or return normally for the profiling information to be saved 325in the graph profile file. | 324or return normally for the profiling information to be saved 325in the graph profile file. |