OpenCores
URL https://opencores.org/ocsvn/eco32/eco32/trunk

Subversion Repositories eco32

[/] [eco32/] [trunk/] [lcc/] [doc/] [bprint.1] - Blame information for rev 130

Go to most recent revision | Details | Compare with Previous | View Log

Line No. Rev Author Line
1 4 hellwig
.\" $Id: bprint.1,v 1.4 1998/08/24 21:18:18 drh Exp $
2
.TH BPRINT 1 "local \- $Date: 1998/08/24 21:18:18 $"
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 .

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.