![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to pxp.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDTahoe / man / man1|
Return to pxp.1 CVS log | Up to [CSRG BSD Unix] / 43BSDTahoe / man / man1 |
1.1 root 1: .\" Copyright (c) 1980 Regents of the University of California.
2: .\" All rights reserved. The Berkeley software License Agreement
3: .\" specifies the terms and conditions for redistribution.
4: .\"
5: .\" @(#)pxp.1 6.1 (Berkeley) 4/29/85
6: .\"
7: .TH PXP 1 "April 29, 1985"
8: .UC
9: .SH NAME
10: pxp \- Pascal execution profiler
11: .SH SYNOPSIS
12: .B pxp
13: [
14: .B \-acdefjnstuw_
15: ] [
16: .B \-23456789
17: ] [
18: .B \-z
19: [ name ... ] ] name.p
20: .SH DESCRIPTION
21: .I Pxp
22: can be used to obtain execution profiles of Pascal programs or
23: as a pretty-printer.
24: To produce an execution profile all that is necessary is to translate
25: the program specifying the
26: .B z
27: option to
28: .I pi
29: or
30: .I pix,
31: to execute the program,
32: and to then issue the command
33: .DT
34: .PP
35: \fBpxp \-z\fR name.p
36: .PP
37: A reformatted listing is output if none of the
38: .BR c ,
39: .BR t ,
40: or
41: .B z
42: options are specified;
43: thus
44: .PP
45: \fBpxp\fR old.p > new.p
46: .PP
47: places a pretty-printed version of the program in `old.p' in the file `new.p'.
48: .PP
49: The use of the following options of
50: .I pxp
51: is discussed in sections 2.6, 5.4, 5.5 and 5.10 of the
52: .IR "Berkeley Pascal User's Manual" "."
53: .TP 6
54: .B \-a
55: Print the bodies of all procedures and functions in the profile;
56: even those which were never executed.
57: .TP 6
58: .B \-c
59: Extract profile data from the file
60: .IR core .
61: .TP 6
62: .B \-d
63: Include declaration parts in a profile.
64: .TP 6
65: .B \-e
66: Eliminate
67: .B include
68: directives when reformatting a file;
69: the
70: .B include
71: is replaced by the reformatted contents of the specified
72: file.
73: .TP 6
74: .B \-f
75: Fully parenthesize expressions.
76: .TP 6
77: .B \-j
78: Left justify all procedures and functions.
79: .TP 6
80: .B \-n
81: Eject a new page
82: as each file is included;
83: in profiles, print a blank line at the top of the page.
84: .TP 6
85: .B \-s
86: Strip comments from the input text.
87: .TP 6
88: .B \-t
89: Print a table summarizing
90: .B procedure
91: and
92: .B function
93: call counts.
94: .TP 6
95: .B \-u
96: Card image mode; only the first 72 characters of input lines
97: are used.
98: .TP 6
99: .B \-w
100: Suppress warning diagnostics.
101: .TP 6
102: .B \-z
103: Generate an execution profile.
104: If no
105: .IR name \|s,
106: are given the profile is of the entire program.
107: If a list of names is given, then only any specified
108: .BR procedure s
109: or
110: .BR function s
111: and the contents of any specified
112: .B include
113: files will appear in the profile.
114: .TP 6
115: .B \-\_
116: Underline keywords.
117: .TP 6
118: .BI \- d
119: With
120: .I d
121: a digit, 2 \(<=
122: .IR d ""
123: \(<= 9,
124: causes
125: .I pxp
126: to use
127: .IR d ""
128: spaces as the basic indenting unit.
129: The default is 4.
130: .SH FILES
131: .DT
132: name.p input file
133: .br
134: name.i include file(s)
135: .br
136: pmon.out profile data
137: .br
138: core profile data source with
139: .B \-c
140: .br
141: /usr/lib/how_pxp information on basic usage
142: .br
143: .ne 8
144: .SH "SEE ALSO"
145: Berkeley Pascal User's Manual
146: .br
147: pi(1),
148: px(1)
149: .ne 5
150: .SH DIAGNOSTICS
151: For a basic explanation do
152: .IP
153: .DT
154: .B pxp
155: .PP
156: Error diagnostics include
157: `No profile data in file'
158: with the
159: .B c
160: option if the
161: .B z
162: option was not enabled to
163: .I pi;
164: `Not a Pascal system core file'
165: if the core is not from a
166: .I px
167: execution;
168: `Program and count data do not correspond'
169: if the program was changed after compilation, before profiling;
170: or if the wrong program is specified.
171: .SH AUTHOR
172: William Joy
173: .SH BUGS
174: Does not place multiple statements per line.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.