pxp(1)pxp(1)Namepxp - Pascal execution profiler
Syntaxpxp [-acdefjnstuw_] [-23456789] [-z[name...]] name.p
Description
The command can be used to obtain execution profiles of Pascal programs
or as a pretty-printer. To produce an execution profile all that is
necessary is to translate the program specifying the z option to or to
execute the program, and to then issue the command
pxp-z name.p
A reformatted listing is output if none of the c, t, or z options are
specified; thus
pxp old.p > new.p
places a pretty-printed version of the program in old.p in the file
new.p.
Options
The use of the following options of is discussed in sections 2.6, 5.4,
5.5 and 5.10 of the "Berkeley Pascal User's Manual" in the Supplemen‐
tary Documents, Volume 2: Programmer.
-_ Underscores all keywords.
-d Uses the specified number (-d) as the indentation unit. The
default is 4.
-a Displays all procedures (even those not executed).
-c Uses the file in generating the profiling data.
-d Displays all declaration parts.
-e Eliminates directives when reformatting a file. The is replaced
by the reformatted contents of the specified file.
-f Displays all parenthesized expression.
-j Left justifies all procedures and functions.
-n Begins a new page for each included file. In profiles, print a
blank line at the top of the page.
-s Strips comments from the input text.
-t Prints a table summarizing and call counts.
-u Generates the output in card image format, using only the first 72
characters of input lines.
-w Suppresses all warning diagnostics.
-z Generate an execution profile for the specified modules (next
arguments). If no names, are given the profile is of the entire
program. If a list of names is given, then only any specified
procedures or functions and the contents of any specified include
files appear in the profile.
Restrictions
Does not place multiple statements per line.
Diagnostics
For a basic explanation of the command, type:
pxp
Error diagnostics include `No profile data in file' with the c option
if the z option was not enabled to `Not a Pascal system core file' if
the core is not from a execution; `Program and count data do not corre‐
spond' if the program was changed after compilation, before profiling;
or if the wrong program is specified.
Files
name.p input file
name.i include file(s)
pmon.out profile data
core profile data source with -c
/usr/lib/how_pxp
information on basic usage
See Alsopi(1), px(1)
"Berkeley Pascal User's Manual," Supplementary Documents, Volume 2:
Programmer
VAX pxp(1)
