BSD 4_3 release

[unix-history] / usr / man / man2 / profil.2

diff --git a/usr/man/man2/profil.2 b/usr/man/man2/profil.2
index e9a24a4..3433d4c 100644 (file)
--- a/usr/man/man2/profil.2
+++ b/usr/man/man2/profil.2
@@ -1,18 +1,25 @@
-.TH PROFIL 2 
+.\" Copyright (c) 1980 Regents of the University of California.
+.\" All rights reserved.  The Berkeley software License Agreement
+.\" specifies the terms and conditions for redistribution.
+.\"
+.\"    @(#)profil.2    6.2 (Berkeley) 5/14/86
+.\"
+.TH PROFIL 2 "May 14, 1986"
+.UC 4

 .SH NAME
 profil \- execution time profile
 .SH SYNOPSIS
 .SH NAME
 profil \- execution time profile
 .SH SYNOPSIS

+.nf

 .B profil(buff, bufsiz, offset, scale)
 .B profil(buff, bufsiz, offset, scale)

-.br

 .B char *buff;
 .B char *buff;

-.br

 .B int bufsiz, offset, scale;
 .B int bufsiz, offset, scale;

+.fi

 .SH DESCRIPTION
 .I Buff
 points to an area of core whose length (in bytes) is given by
 .IR bufsiz .
 After this call, the user's program counter (pc)
 .SH DESCRIPTION
 .I Buff
 points to an area of core whose length (in bytes) is given by
 .IR bufsiz .
 After this call, the user's program counter (pc)

-is examined each clock tick (60th second);
+is examined each clock tick (10 milliseconds);

 .I offset
 is subtracted from it, and the result multiplied by
 .IR scale .
 .I offset
 is subtracted from it, and the result multiplied by
 .IR scale .


@@ -22,15 +29,12 @@ inside
 that word is incremented.
 .PP
 The scale is interpreted as an unsigned,
 that word is incremented.
 .PP
 The scale is interpreted as an unsigned,

-fixed-point fraction with binary point at the
-left: 0177777(8) gives a 1-1 mapping of pc's to words
+fixed-point fraction with 16 bits of fraction:
+0x10000 gives a 1-1 mapping of pc's to words

 in
 .I buff;
 in
 .I buff;

-077777(8) maps each pair of instruction words
+0x8000 maps each pair of instruction words

 together.
 together.

-02(8) maps all instructions onto the beginning of
-.I buff
-(producing a non-interrupting core clock).

 .PP
 Profiling is turned off by giving a
 .I scale
 .PP
 Profiling is turned off by giving a
 .I scale


@@ -40,16 +44,14 @@ ineffective by giving a
 .I bufsiz
 of 0.
 Profiling is turned off when an
 .I bufsiz
 of 0.
 Profiling is turned off when an

-.I exec
+.I execve

 is executed, but remains on in child and parent both
 after a
 .IR fork .
 is executed, but remains on in child and parent both
 after a
 .IR fork .

-Profiling may be turned off if an update in
+Profiling is turned off if an update in

 .I buff
 would cause a memory fault.
 .I buff
 would cause a memory fault.

+.SH "RETURN VALUE
+A 0, indicating success, is always returned.

 .SH "SEE ALSO"
 .SH "SEE ALSO"

-monitor(3), prof(1)
-.SH "ASSEMBLER (PDP-11)"
-(profil = 44.)
-.br
-.B sys profil; buff; bufsiz; offset; scale
+gprof(1), setitimer(2), monitor(3)