Return to lcomp.1 CVS log

Up to [Research Unix] / researchv10no / cmd / lcomp

Annotation of researchv10no/cmd/lcomp/lcomp.1, revision 1.1.1.1

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

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