Return to mon.3 CVS log

Up to [Research Unix] / researchv10dc / dist / man / v4 / manx

Annotation of researchv10dc/dist/man/v4/manx/mon.3, revision 1.1

1.1     ! root        1: .th MONITOR III 5/10/73
        !             2: .sh NAME
        !             3: monitor \*- prepare execution profile
        !             4: .sh SYNOPSIS
        !             5: .ft B
        !             6: monitor(lowpc, highpc, buffer, bufsize)
        !             7: .br
        !             8: int lowpc( ), highpc( ), buffer[ ], bufsize;
        !             9: .sh DESCRIPTION
        !            10: .it Monitor
        !            11: is an interface to the system's profile entry (II).
        !            12: .it lowpc
        !            13: and
        !            14: .it highpc
        !            15: are the names of two functions;
        !            16: .it buffer
        !            17: is the address of a (user supplied)
        !            18: array of
        !            19: .it bufsize
        !            20: integers.
        !            21: .it Monitor
        !            22: arranges for the system to sample the user's
        !            23: program counter periodically
        !            24: and record the execution histogram in
        !            25: the buffer.
        !            26: The lowest address sampled
        !            27: is that of
        !            28: .it lowpc
        !            29: and the highest is
        !            30: just below \fIhighpc\fR.
        !            31: For the results to be significant,
        !            32: especially where there are small, heavily
        !            33: used routines,
        !            34: it is suggested that the buffer be no more
        !            35: than a few times smaller than the range
        !            36: of locations sampled.
        !            37: .s3
        !            38: To profile the entire program,
        !            39: it is sufficient to use
        !            40: .s3
        !            41:        extern etext;
        !            42:        ...
        !            43:        monitor(2, &etext, buf, bufsize);
        !            44: .s3
        !            45: .it etext
        !            46: is a loader-defined symbol which lies just above all the
        !            47: program text.
        !            48: .s3
        !            49: To stop execution monitoring and write the results
        !            50: on the file \fBmon.out\fR.
        !            51: use
        !            52: .s3
        !            53:        monitor(0);
        !            54: .s3
        !            55: Then, when the program exits, prof (I) can be used
        !            56: to examine the results.
        !            57: .sh FILES
        !            58: mon.out
        !            59: .sh "SEE ALSO"
        !            60: prof (I), profil (II)

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