Return to lcomp.1 CVS log

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

Annotation of researchv10dc/man/adm/man1/lcomp.1, revision 1.1

1.1     ! root        1: .TH LCOMP 1
        !             2: .CT 1 debug_tune
        !             3: .SH NAME
        !             4: lcomp, lprint \(mi line-by-line profiler
        !             5: .SH SYNOPSIS
        !             6: .B lcomp
        !             7: [
        !             8: .I option ...
        !             9: ]
        !            10: .I file ...
        !            11: .PP
        !            12: .B lprint
        !            13: [
        !            14: .I option
        !            15: ]
        !            16: [
        !            17: .I file ...
        !            18: ]
        !            19: .SH DESCRIPTION
        !            20: .I Lcomp
        !            21: is used in place of
        !            22: .IR cc (1)
        !            23: or
        !            24: .IR f77 (1)
        !            25: to insert instruction-counting code into programs.
        !            26: It shares with those commands options
        !            27: whose initial letters are taken from the string
        !            28: .LR cwpDUIRdlNnz ,
        !            29: and accepts files whose names end in
        !            30: .BR .c ,
        !            31: .BR .f ,
        !            32: .BR .s ,
        !            33: or
        !            34: .BR .o .
        !            35: From each source file it derives a 
        !            36: .B .o
        !            37: file and a
        !            38: .B .sL
        !            39: file which
        !            40: .I lprint
        !            41: uses to correlate source lines with basic blocks.
        !            42: .PP
        !            43: Option
        !            44: .B -C
        !            45: declares that
        !            46: .B .c
        !            47: files (and
        !            48: .B .o
        !            49: files, if no source files are named)
        !            50: are C++ files.
        !            51: If the
        !            52: .B -c
        !            53: option is not present
        !            54: .I lcomp
        !            55: creates
        !            56: .FR a.out .
        !            57: Each time
        !            58: .F a.out
        !            59: is run statistics are added
        !            60: to a profiling file
        !            61: .FR prof.out .
        !            62: .PP
        !            63: .I Lprint
        !            64: produces on the standard output a listing (in the style of
        !            65: .IR pr (1))
        !            66: of the programs compiled by
        !            67: .I lcomp.
        !            68: Without arguments or files,
        !            69: each line of the listing is preceded by the number of times it was executed,
        !            70: as determined from the data in
        !            71: .FR prof.out .
        !            72: .I Lprint
        !            73: interprets the following options.
        !            74: .TP
        !            75: .B -a
        !            76: Detailed listing of every machine instruction and how often it was executed.
        !            77: .TP
        !            78: .B -b
        !            79: How often each basic block was executed.
        !            80: .TP
        !            81: .B -c
        !            82: Compress the
        !            83: .F prof.out
        !            84: file, which otherwise grows with every execution of
        !            85: .LR a.out .
        !            86: .TP
        !            87: .B -f
        !            88: Print summary information by function: instruction executions, number of
        !            89: invocations, source instructions, and number of instructions never executed.
        !            90: .TP
        !            91: .B -i
        !            92: Before each line of source print the number of machine instructions executed.
        !            93: .TP
        !            94: .B -p
        !            95: Before each line of source print the number of times the first basic block
        !            96: in that line was executed.
        !            97: .TP
        !            98: .B -s
        !            99: Summarize the counts by source file: instruction executions, source
        !           100: instructions, instructions never executed, basic block executions, total
        !           101: number of source basic blocks, and how many were never executed.
        !           102: .PP
        !           103: If any file names are given, the options
        !           104: .L abip
        !           105: apply only to them.
        !           106: If no options are given,
        !           107: .B -p
        !           108: is assumed.
        !           109: Any combination of options is allowed.
        !           110: .SH FILES
        !           111: .TF /usr/lib/nexit.o   
        !           112: .TP
        !           113: .F prof.out
        !           114: counts
        !           115: .TP
        !           116: .F *.sL
        !           117: for correlating with source
        !           118: .TP
        !           119: .F /usr/lib/bb
        !           120: for finding basic blocks and inserting counting code
        !           121: .TP
        !           122: .F /usr/lib/nexit.o
        !           123: for printing counts when
        !           124: .L a.out
        !           125: exits
        !           126: .SH "SEE ALSO"
        !           127: .IR cc (1), 
        !           128: .IR f77 (1),
        !           129: .IR prof (1)
        !           130: .SH BUGS
        !           131: A line in the source file may be in zero, one, or more basic
        !           132: blocks;
        !           133: the count given in the listing corresponds to some particular
        !           134: choice of the basic block to associate with the line.
        !           135: .br
        !           136: Processing the output of
        !           137: .IR yacc (1)
        !           138: without removing
        !           139: .L #line
        !           140: directives will produce unsatisfactory results.
        !           141: .br
        !           142: Option
        !           143: .B -C
        !           144: masks an option of
        !           145: .IR cc (1).

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