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     ! 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.