Return to prof.1 CVS log

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

Annotation of researchv10dc/man/adm/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.

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