Name

pxp − Pascal execution profiler

Syntax

pxp [−acdefjnstuw_] [−23456789] [−z[name...]] name.p

Description

The pxp 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 pi or pix, 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 pxp is discussed in sections 2.6, 5.4, 5.5 and 5.10 of the "Berkeley Pascal User’s Manual" in the Supplementary Documents, Volume 2: Programmer. 

−_Underscores all keywords. 

−dUses the specified number (−d) as the indentation unit.  The default is 4. 

−aDisplays all procedures (even those not executed). 

−cUses the core file in generating the profiling data.

−dDisplays all declaration parts. 

−eEliminates include directives when reformatting a file. The include is replaced by the reformatted contents of the specified file.

−fDisplays all parenthesized expression. 

−jLeft justifies all procedures and functions. 

−nBegins a new page for each included file.  In profiles, print a blank line at the top of the page. 

−sStrips comments from the input text. 

−tPrints a table summarizing procedure and function call counts.

−uGenerates the output in card image format, using only the first 72 characters of input lines. 

−wSuppresses all warning diagnostics. 

−zGenerate 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 pxp command, type:

pxp

Error diagnostics include ‘No profile data in file’ with the c option if the z option was not enabled to pi; ‘Not a Pascal system core file’ if the core is not from a px execution; ‘Program and count data do not correspond’ 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 Also

pi(1), px(1)
"Berkeley Pascal User’s Manual," Supplementary Documents, Volume 2: Programmer