PROFIL(2)               COMMAND REFERENCE               PROFIL(2)



NAME
     profil - execution time profile

SYNOPSIS
     profil(buf, bufsiz, offset, scale)
     char *buf;
     int bufsiz, offset, scale;

DESCRIPTION
     Buf points to an area of core whose length (in bytes) is
     given by bufsiz.  After this call, the user's program
     counter (pc) is examined each clock tick (10 milliseconds);
     offset is subtracted from it, and the result multiplied by
     scale.  If the resulting number corresponds to a word inside
     buf, that word is incremented.

     The scale is interpreted as an unsigned, fixed-point
     fraction with binary point at the left: 0x10000 gives a 1-1
     mapping of pc's to words in buf; 0x8000 maps each pair of
     instruction words together.  0x2 maps all instructions onto
     the beginning of buf (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 an execve is executed, but remains on in
     child and parent both after a fork.  Profiling is turned off
     if an update in buf would cause a memory fault.

RETURN VALUE
     A 0, indicating success, is always returned.

SEE ALSO
     gprof(1), setitimer(2), and monitor(3c).





















Printed 4/6/89                                                  1

%%index%%
na:288,83;
sy:371,808;
de:1179,1219;
rv:2398,174;
se:2572,193;
%%index%%000000000096