Return to profil.2 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man2

Annotation of cci/usr/src/man/man2/profil.2, revision 1.1.1.1

1.1       root        1: .TH PROFIL 2 "12 February 1983"
                      2: .UC 4
                      3: .SH NAME
                      4: profil \- execution time profile
                      5: .SH SYNOPSIS
                      6: .nf
                      7: .B profil(buff, bufsiz, offset, scale)
                      8: .B char *buff;
                      9: .B int bufsiz, offset, scale;
                     10: .fi
                     11: .SH DESCRIPTION
                     12: .I Buff
                     13: points to an area of core whose length (in bytes) is given by
                     14: .IR bufsiz .
                     15: After this call, the user's program counter (pc)
                     16: is examined each clock tick (10 milliseconds);
                     17: .I offset
                     18: is subtracted from it, and the result multiplied by
                     19: .IR scale .
                     20: If the resulting number corresponds to a word
                     21: inside
                     22: .I buff,
                     23: that word is incremented.
                     24: .PP
                     25: The scale is interpreted as an unsigned,
                     26: fixed-point fraction with binary point at the
                     27: left: 0x10000 gives a 1-1 mapping of pc's to words
                     28: in
                     29: .I buff;
                     30: 0x8000 maps each pair of instruction words
                     31: together.
                     32: 0x2 maps all instructions onto the beginning of
                     33: .I buff
                     34: (producing a non-interrupting core clock).
                     35: .PP
                     36: Profiling is turned off by giving a
                     37: .I scale
                     38: of 0 or 1.
                     39: It is rendered
                     40: ineffective by giving a
                     41: .I bufsiz
                     42: of 0.
                     43: Profiling is turned off when an
                     44: .I execve
                     45: is executed, but remains on in child and parent both
                     46: after a
                     47: .IR fork .
                     48: Profiling is turned off if an update in
                     49: .I buff
                     50: would cause a memory fault.
                     51: .SH "RETURN VALUE
                     52: A 0, indicating success, is always returned.
                     53: .SH "SEE ALSO"
                     54: gprof(1), setitimer(2), monitor(3)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.