Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
profil(2)		      System Calls Manual		     profil(2)

NAME
       profil -	execution time profile

SYNOPSIS
DESCRIPTION
       controls	 profiling,  by	 which	the  system maintains estimates	of the
       amount of time the calling program spends executing at  various	places
       in its address space.

       The  buff  argument  must  point	 to an area of memory whose length (in
       bytes) is given by bufsiz.  When	profiling is on, the process's program
       counter	(pc)  is examined each clock tick times	per second), offset is
       subtracted from the pc value, and the result is	multiplied  by	scale.
       If  the	resulting number corresponds to	an element inside the array of
       to which	buff points, that element is incremented.

       The number of samples per second	for a given implementation is given by
       which is	defined	in

       The scale is interpreted	as an unsigned,	sixteen	bit, fixed-point frac-
       tion with binary	point at the left: 0177777 (octal) gives a  one-to-one
       mapping	of pc's	to words in buff; 077777 (octal) maps each pair	of in-
       struction words together.  02(octal) maps all instructions onto the be-
       ginning of buff (producing a non-interrupting core clock).

       Profiling  is  turned  off by giving a scale of 0 or 1.	It is rendered
       ineffective by giving a bufsiz of 0.  Profiling is turned off when  one
       of  the	functions is executed, but remains on in child and parent both
       after a Profiling is turned off if an update in buff would cause	a mem-
       ory fault.

RETURN VALUE
       No value	is returned.

SEE ALSO
       prof(1),	monitor(3C).

STANDARDS CONFORMANCE
								     profil(2)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO | STANDARDS CONFORMANCE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=profil&sektion=2&manpath=HP-UX+11.22>

home | help