

BPRINT(1)                  Unix Programmer's Manual                  BPRINT(1)


NAME
     bprint - expression profiler

SYNOPSIS
     bprint [ option ... ] [ file ... ]

DESCRIPTION
     bprint produces on the standard output a listing of the programs compiled
     by  lcc  with  the  -b  option.   Executing  an a.out so compiled appends
     profiling data to prof.out.  The first token of each  expression  in  the
     listing  is  preceded  by the number of times it was executed enclosed in
     angle  brackets  as  determined  from  the  data  in  prof.out.    bprint
     interprets the following options.

     -c   Compress  the  prof.out  file,  which  otherwise  grows  with  every
          execution of a.out.

     -b   Print an annotated listing as described above.

     -n   Include line numbers in the listing.

     -f   Print only the number of invocations of each function.  A second  -f
          summarizes call sites instead of callers.

     -Idir
          specifies additional directories in which to  seek  files  given  in
          prof.out that do not begin with `/'.

     If any file names are given, only the requested data for those files  are
     printed in the order presented.  If no options are given, -b is assumed.

FILES

     prof.out           profiling data
     /usr/lib/bbexit.o  creates prof.out when a.out exits

SEE ALSO
     lcc(1), prof(1)

BUGS
     Macros and comments can confuse bprint  because  it  uses  post-expansion
     source  coordinates  to  annotate  pre-expansion source files.  If bprint
     sees that it's about to print  a  statement  count  inside  a  number  or
     identifier, it moves the count to just before the token.

     Can't cope with an ill-formed prof.out.












                              local \- 9/24/91                               1

