Return to prof.1 CVS log

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

Annotation of cci/usr/src/man/man1/prof.1, revision 1.1

1.1     ! root        1: .TH PROF 1  "18 January 1983"
        !             2: .UC 4
        !             3: .SH NAME
        !             4: prof \- display profile data
        !             5: .SH SYNOPSIS
        !             6: .B prof
        !             7: [
        !             8: .B \-a
        !             9: ] [
        !            10: .B \-l
        !            11: ] [
        !            12: .B \-n
        !            13: ] [
        !            14: .B \-z
        !            15: ] [
        !            16: .B \-s
        !            17: [
        !            18: .BI \- "low\fR [ \fB\-\fIhigh\fR ]"
        !            19: ] ]
        !            20: [ a.out
        !            21: [ mon.out ... ] ]
        !            22: .SH DESCRIPTION
        !            23: .I Prof
        !            24: interprets the file
        !            25: produced by the
        !            26: .I monitor
        !            27: subroutine.
        !            28: Under default modes,
        !            29: the symbol table in the
        !            30: named object file
        !            31: .I (a.out
        !            32: default)
        !            33: is read and correlated with the
        !            34: profile file
        !            35: .I (mon.out
        !            36: default).
        !            37: For each external symbol, the percentage
        !            38: of time spent executing between that symbol
        !            39: and the next
        !            40: is printed (in decreasing order),
        !            41: together with the number of times that routine was called
        !            42: and the number of milliseconds per call.
        !            43: If more than one profile file is specified,
        !            44: the output represents the sum of the profiles.
        !            45: .PP
        !            46: In order for the number of calls to a routine to be tallied,
        !            47: the
        !            48: .B \-p
        !            49: option of
        !            50: .I cc,
        !            51: .I f77
        !            52: or
        !            53: .I pc
        !            54: must have been given when the file containing the
        !            55: routine was compiled.
        !            56: This option also arranges for the
        !            57: profile file to be produced automatically.
        !            58: .PP
        !            59: Options are:
        !            60: .TP
        !            61: .B \-a
        !            62: all symbols are reported rather than
        !            63: just external symbols.
        !            64: .TP
        !            65: .B \-l
        !            66: the output is sorted by symbol value.
        !            67: .TP
        !            68: .B \-n
        !            69: the output is sorted by number of calls
        !            70: .TP
        !            71: .B \-s
        !            72: a summary profile file is produced in
        !            73: .I mon.sum.
        !            74: This is really only useful
        !            75: when more than one profile file is specified.
        !            76: .TP
        !            77: .B \-z
        !            78: routines which have zero usage (as indicated by call counts
        !            79: and accumulated time) are nevertheless printed in the output.
        !            80: .SH FILES
        !            81: .ta \w'mon.out  'u
        !            82: mon.out        for profile
        !            83: .br
        !            84: a.out          for namelist
        !            85: .br
        !            86: mon.sum        for summary profile
        !            87: .SH "SEE ALSO"
        !            88: monitor(3), profil(2), cc(1), plot(1G)
        !            89: .SH BUGS
        !            90: Beware of quantization errors.
        !            91: .PP
        !            92: Is confused by
        !            93: .I f77
        !            94: which puts the entry points at the bottom of subroutines and functions.

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