Return to profil.2 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / lib / libc / sys

Annotation of 43BSDReno/lib/libc/sys/profil.2, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1980 Regents of the University of California.
                      2: .\" All rights reserved.  The Berkeley software License Agreement
                      3: .\" specifies the terms and conditions for redistribution.
                      4: .\"
                      5: .\"    @(#)profil.2    6.2 (Berkeley) 5/14/86
                      6: .\"
                      7: .TH PROFIL 2 "May 14, 1986"
                      8: .UC 4
                      9: .SH NAME
                     10: profil \- execution time profile
                     11: .SH SYNOPSIS
                     12: .nf
                     13: .B profil(buff, bufsiz, offset, scale)
                     14: .B char *buff;
                     15: .B int bufsiz, offset, scale;
                     16: .fi
                     17: .SH DESCRIPTION
                     18: .I Buff
                     19: points to an area of core whose length (in bytes) is given by
                     20: .IR bufsiz .
                     21: After this call, the user's program counter (pc)
                     22: is examined each clock tick (10 milliseconds);
                     23: .I offset
                     24: is subtracted from it, and the result multiplied by
                     25: .IR scale .
                     26: If the resulting number corresponds to a word
                     27: inside
                     28: .I buff,
                     29: that word is incremented.
                     30: .PP
                     31: The scale is interpreted as an unsigned,
                     32: fixed-point fraction with 16 bits of fraction:
                     33: 0x10000 gives a 1-1 mapping of pc's to words
                     34: in
                     35: .I buff;
                     36: 0x8000 maps each pair of instruction words
                     37: together.
                     38: .PP
                     39: Profiling is turned off by giving a
                     40: .I scale
                     41: of 0 or 1.
                     42: It is rendered
                     43: ineffective by giving a
                     44: .I bufsiz
                     45: of 0.
                     46: Profiling is turned off when an
                     47: .I execve
                     48: is executed, but remains on in child and parent both
                     49: after a
                     50: .IR fork .
                     51: Profiling is turned off if an update in
                     52: .I buff
                     53: would cause a memory fault.
                     54: .SH "RETURN VALUE
                     55: A 0, indicating success, is always returned.
                     56: .SH "SEE ALSO"
                     57: 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.