Return to bprint.1 CVS log

Up to [Research Unix] / researchv10no / cmd / lcc / etc

Annotation of researchv10no/cmd/lcc/etc/bprint.1, revision 1.1.1.1

1.1       root        1: .TH BPRINT 1 "local \- 9/24/91"
                      2: .SH NAME
                      3: bprint \- expression profiler
                      4: .SH SYNOPSIS
                      5: .B bprint
                      6: [
                      7: .I option ...
                      8: ]
                      9: [
                     10: .I file ...
                     11: ]
                     12: .SH DESCRIPTION
                     13: .I bprint
                     14: produces on the standard output a listing of the programs compiled by
                     15: .I lcc
                     16: with the
                     17: .B \-b
                     18: option.
                     19: Executing an
                     20: .B a.out
                     21: so compiled appends profiling data to
                     22: .BR prof.out .
                     23: The first token of each expression in the listing is preceded
                     24: by the number of times it was executed
                     25: enclosed in angle brackets as determined from the data in
                     26: .BR prof.out .
                     27: .I bprint
                     28: interprets the following options.
                     29: .TP
                     30: .B \-c
                     31: Compress the
                     32: .B prof.out
                     33: file, which otherwise grows with every execution of
                     34: .BR a.out .
                     35: .TP
                     36: .B \-b
                     37: Print an annotated listing as described above.
                     38: .TP
                     39: .B \-n
                     40: Include line numbers in the listing.
                     41: .TP
                     42: .B \-f
                     43: Print only the number of invocations of each function.
                     44: A second
                     45: .B \-f
                     46: summarizes call sites instead of callers.
                     47: .TP
                     48: .SM
                     49: .BI \-I \*Sdir
                     50: specifies additional directories in which to seek
                     51: files given in
                     52: .B prof.out
                     53: that do not begin with `/'.
                     54: .PP
                     55: If any file names are given, only the requested data for those files are printed
                     56: in the order presented.
                     57: If no options are given,
                     58: .B \-b
                     59: is assumed.
                     60: .SH FILES
                     61: .PP
                     62: .ta \w'/usr/lib/bbexit.oXX'u
                     63: prof.out       profiling data
                     64: .br
                     65: /usr/lib/bbexit.o      creates
                     66: .B prof.out
                     67: when
                     68: .B a.out
                     69: exits
                     70: .SH "SEE ALSO"
                     71: .IR lcc (1), 
                     72: .IR prof (1)
                     73: .SH BUGS
                     74: Macros and comments can confuse
                     75: .I bprint
                     76: because it uses post-expansion source coordinates
                     77: to annotate pre-expansion source files.
                     78: If
                     79: .I bprint
                     80: sees that it's about to print a statement count
                     81: .I inside
                     82: a number or identifier, it moves the count to just
                     83: .I before
                     84: the token.
                     85: .PP
                     86: Can't cope with an ill-formed
                     87: .BR prof.out .

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