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

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.