*** UNIX MANUAL PAGE BROWSER ***

LCOMP(1) General Commands Manual LCOMP(1) NAME lcomp, lprint - line-by-line profiler SYNOPSIS lcomp [ option ... ] file ... lprint [ option ] [ file ... ] DESCRIPTION Lcomp is used in place of cc(1) or f77(1) to insert instruction-count- ing code into programs. It shares with those commands options whose initial letters are taken from the string and accepts files whose names end in .c, .f, .s, or .o. From each source file it derives a .o file and a .sL file which lprint uses to correlate source lines with basic blocks. Option -C declares that .c files (and .o files, if no source files are named) are C++ files. If the -c option is not present lcomp creates Each time is run statistics are added to a profiling file Lprint produces on the standard output a listing (in the style of pr(1)) of the programs compiled by lcomp. Without arguments or files, each line of the listing is preceded by the number of times it was exe- cuted, as determined from the data in Lprint interprets the following options. -a Detailed listing of every machine instruction and how often it was executed. -b How often each basic block was executed. -c Compress the file, which otherwise grows with every execution of -f Print summary information by function: instruction executions, number of invocations, source instructions, and number of in- structions never executed. -i Before each line of source print the number of machine instruc- tions executed. -p Before each line of source print the number of times the first basic block in that line was executed. -s Summarize the counts by source file: instruction executions, source instructions, instructions never executed, basic block executions, total number of source basic blocks, and how many were never executed. If any file names are given, the options apply only to them. If no op- tions are given, -p is assumed. Any combination of options is allowed. FILES counts for correlating with source for finding basic blocks and inserting counting code for printing counts when exits SEE ALSO cc(1), f77(1), prof(1) BUGS A line in the source file may be in zero, one, or more basic blocks; the count given in the listing corresponds to some particular choice of the basic block to associate with the line. Processing the output of yacc(1) without removing directives will pro- duce unsatisfactory results. Option -C masks an option of cc(1). LCOMP(1)