NAME

pxp − Pascal execution profiler

SYNOPSIS

pxp [ options ] [ −n ] [ −z [ names ] ] file.p

DESCRIPTION

Pxp can be used to obtain execution profiles of Pascal programs or to format such programs for printing.  To produce an execution profile, the user need only translate the program, specifying the −z option to pi or pix; execute the program;  and then issue the command:

pxp −z file.p

A reformatted listing is output if neither the −c, −t, nor −z option is specified; thus

pxp old.p > new.p

places a pretty-printed version of the “old.p” program into a “new.p” file. 

OPTIONS

Use of the following pxp options is discussed in sections 2.6, 5.4, 5.5 and 5.10 of the Berkeley Pascal User’s Manual.

−a Prints the contents of all procedures and functions in the profile, including those which were never executed. 

−c Extracts profile data from the file core. 

−d Includes declaration parts in a profile. 

−e Eliminates include directives when reformatting a file; the include is replaced by the reformatted contents of the specified file. 

−f Fully parenthesizes expressions. 

−j Left justifies all procedures and functions. 

−n Ejects a new page as each file is included; in profiles, prints a blank line at the top of the page. 

−s Strips comments from the input text. 

−t Prints a table summarizing procedure and function call counts. 

−u Card image mode; only the first 72 characters of input lines are used. 

−w Suppresses warning diagnostics. 

−z names Generates an execution profile for names.  If no names are given, the entire program is profiled.  If a list of names is given, then the profile will contain only specified procedures or functions, and the contents of any specified include files. 

−_ Underlines keywords. 

−n With n a digit in the range 2 through 9, pxp uses n spaces as the basic indenting unit.  The default is 4. 

FILES

name.pinput file
name.iinclude file(s)
pmon.outprofile data
coreprofile data source with −c
/usr/lib/how_pxpinformation on basic usage

SEE ALSO

Berkeley Pascal User’s Manual, in Volume III of the UNIX Programmer’s Manual. 
pi(1), px(1)

DIAGNOSTICS

For a basic explanation, enter pxp.  Error diagnostics include the following.  “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. 

BUGS

Does not place multiple statements per line. 

3rd Berkeley Distribution  —  1 August 1985