moncontrol.3 (84306) | moncontrol.3 (108037) |
---|---|
1.\" Copyright (c) 1980, 1991, 1992, 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.\" @(#)moncontrol.3 8.1 (Berkeley) 6/4/93 | 1.\" Copyright (c) 1980, 1991, 1992, 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.\" @(#)moncontrol.3 8.1 (Berkeley) 6/4/93 |
33.\" $FreeBSD: head/lib/libc/gmon/moncontrol.3 84306 2001-10-01 16:09:29Z ru $ | 33.\" $FreeBSD: head/lib/libc/gmon/moncontrol.3 108037 2002-12-18 12:45:11Z ru $ |
34.\" 35.Dd June 4, 1993 36.Dt MONCONTROL 3 37.Os 38.Sh NAME 39.Nm moncontrol , 40.Nm monstartup 41.Nd control execution profile --- 16 unchanged lines hidden (view full) --- 58In typical operation, profiling begins at program startup 59and ends when the program calls exit. 60When the program exits, the profiling data are written to the file 61.Em progname.gmon , 62where progname is the name of the program, then 63.Xr gprof 1 64can be used to examine the results. 65.Pp | 34.\" 35.Dd June 4, 1993 36.Dt MONCONTROL 3 37.Os 38.Sh NAME 39.Nm moncontrol , 40.Nm monstartup 41.Nd control execution profile --- 16 unchanged lines hidden (view full) --- 58In typical operation, profiling begins at program startup 59and ends when the program calls exit. 60When the program exits, the profiling data are written to the file 61.Em progname.gmon , 62where progname is the name of the program, then 63.Xr gprof 1 64can be used to examine the results. 65.Pp |
66The |
|
66.Fn moncontrol | 67.Fn moncontrol |
68function |
|
67selectively controls profiling within a program. 68When the program starts, profiling begins. 69To stop the collection of histogram ticks and call counts use 70.Fn moncontrol 0 ; 71to resume the collection of histogram ticks and call counts use 72.Fn moncontrol 1 . 73This feature allows the cost of particular operations to be measured. 74Note that an output file will be produced on program exit --- 35 unchanged lines hidden --- | 69selectively controls profiling within a program. 70When the program starts, profiling begins. 71To stop the collection of histogram ticks and call counts use 72.Fn moncontrol 0 ; 73to resume the collection of histogram ticks and call counts use 74.Fn moncontrol 1 . 75This feature allows the cost of particular operations to be measured. 76Note that an output file will be produced on program exit --- 35 unchanged lines hidden --- |