bprint.1 (1752B)
1 .\" $Id: bprint.1 145 2001-10-17 21:53:10Z timo $ 2 .TH BPRINT 1 "local \- $Date: 2001-10-17 16:53:10 -0500 (Wed, 17 Oct 2001) $" 3 .SH NAME 4 bprint \- expression profiler 5 .SH SYNOPSIS 6 .B bprint 7 [ 8 .I option ... 9 ] 10 [ 11 .I file ... 12 ] 13 .SH DESCRIPTION 14 .I bprint 15 produces on the standard output a listing of the programs compiled by 16 .I lcc 17 with the 18 .B \-b 19 option. 20 Executing an 21 .B a.out 22 so compiled appends profiling data to 23 .BR prof.out . 24 The first token of each expression in the listing is preceded 25 by the number of times it was executed 26 enclosed in angle brackets as determined from the data in 27 .BR prof.out . 28 .I bprint 29 interprets the following options. 30 .TP 31 .B \-c 32 Compress the 33 .B prof.out 34 file, which otherwise grows with every execution of 35 .BR a.out . 36 .TP 37 .B \-b 38 Print an annotated listing as described above. 39 .TP 40 .B \-n 41 Include line numbers in the listing. 42 .TP 43 .B \-f 44 Print only the number of invocations of each function. 45 A second 46 .B \-f 47 summarizes call sites instead of callers. 48 .TP 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'$LCCDIR/liblcc.{a,lib}XX'u 63 .nf 64 prof.out profiling data 65 $LCCDIR/liblcc.{a,lib} \fIlcc\fP-specific library 66 .SH "SEE ALSO" 67 .IR lcc (1), 68 .IR prof (1) 69 .SH BUGS 70 Macros and comments can confuse 71 .I bprint 72 because it uses post-expansion source coordinates 73 to annotate pre-expansion source files. 74 If 75 .I bprint 76 sees that it's about to print a statement count 77 .I inside 78 a number or identifier, it moves the count to just 79 .I before 80 the token. 81 .PP 82 Can't cope with an ill-formed 83 .BR prof.out .