compilers/q3/lcc/doc/.svn/text-base/bprint.1.svn-base

   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 .