Return to prof.1 CVS log

Up to [Research Unix] / researchv10dc / man / man1

Annotation of researchv10dc/man/man1/prof.1, revision 1.1.1.1

1.1       root        1: .TH PROF 1
                      2: .CT 1 debug_tune
                      3: .SH NAME
                      4: prof \(mi display profile data
                      5: .SH SYNOPSIS
                      6: .B prof
                      7: [
                      8: .I option ...
                      9: ]
                     10: [
                     11: .I a.out
                     12: [
                     13: .I mon.out ...
                     14: ]
                     15: ]
                     16: .SH DESCRIPTION
                     17: .I Prof
                     18: interprets files
                     19: produced by
                     20: .IR monitor (3)
                     21: or the
                     22: .B -p
                     23: option of
                     24: .I cc
                     25: or
                     26: .I f77.
                     27: The symbol table in the
                     28: named object file
                     29: .RL ( a.out
                     30: by default)
                     31: is read and correlated with the
                     32: profile file
                     33: .RL ( mon.out
                     34: by default).
                     35: For each symbol, the percentage
                     36: of time spent executing between that symbol
                     37: and the next
                     38: is printed (in decreasing order),
                     39: together with the time spent there and
                     40: the number of times that routine was called.
                     41: If more than one profile file is specified,
                     42: the output represents the sum of the profiles.
                     43: .PP
                     44: Zero call counts are tallied for subroutines not compiled
                     45: with option
                     46: .BR -p .
                     47: The flag
                     48: .BR -p
                     49: must be passed to the loader to get the profiling output written.
                     50: .PP
                     51: Options are:
                     52: .TP
                     53: .B -l
                     54: Sort the output by symbol value.
                     55: .TP
                     56: .B -n
                     57: Sort the output by number of calls.
                     58: .TP
                     59: .B -s
                     60: Produce a summary profile file in
                     61: .FR mon.sum .
                     62: .TP
                     63: .BI "-v -" low " -" high
                     64: Produce a graphic profile
                     65: on the standard output for display by the
                     66: .IR  plot (1)
                     67: filters.
                     68: Optional numbers
                     69: .I low
                     70: and
                     71: .I high,
                     72: by default 0 and 100, select
                     73: a percentage of the profile to be plotted.
                     74: .TP
                     75: .B -z
                     76: Include routines with zero usage in the output.
                     77: .SH FILES
                     78: .TF mon.out
                     79: .TP
                     80: .F mon.out
                     81: for profile
                     82: .TP
                     83: .F a.out
                     84: for namelist
                     85: .TP
                     86: .F mon.sum
                     87: for summary profile
                     88: .SH "SEE ALSO"
                     89: .IR time (1), 
                     90: .IR lcomp (1), 
                     91: .IR monitor (3),
                     92: .IR getopt (3), 
                     93: .IR profil (2),
                     94: .IR plot (1), 
                     95: .IR cc (1),
                     96: .IR f77 (1)
                     97: .SH BUGS
                     98: Beware of quantization errors.
                     99: .br
                    100: .I Prof
                    101: is confused by
                    102: .I f77,
                    103: which puts the entry points at the bottom of subroutines and functions.
                    104: .br
                    105: Option
                    106: .B -v
                    107: has been disabled.

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