Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ prof(1) — Ultrix WS 2.0 VAX

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

cc(1)

plot(1g)

profil(2)

monitor(3)

prof(1)

NAME

prof − profile an object file

SYNTAX

prof [−a] [−l] [−n] [−z] [−s] [−v] [low[−high]]] [file1[file2...]]

DESCRIPTION

The prof command interprets the file produced by the monitor(3) subroutine. Under default modes, the symbol table in the named object file (a.out default) is read and correlated with the profile file (mon.out default). For each external symbol, the percentage of time spent executing between that symbol and the next is printed (in decreasing order), together with the number of times that routine was called and the number of milliseconds per call. If more than one profile file is specified, the output represents the sum of the profiles.

OPTIONS

In order for the number of calls to a routine to be tallied, the −p option of cc(1), f77(1) or pc(1) must have been given when the file containing the routine was compiled. This option also arranges for the profile file to be produced automatically.

−aDisplays all symbols rather than just external symbols. 

−lDisplays output by symbol value. 

−nDisplays output by number of calls.  Summary profile file is produced in mon.sum.  This is useful only when more than one profile file is specified. 

−vProduces graphic output for display by the plot(1g) filters. When plotting, the numbers low and high, by default 0 and 100, may be given, which causes a selected percentage of the profile to be plotted with accordingly higher resolution. 

−zRoutines having zero usage, as indicated by call counts and accumulated time, are printed in the output. 

RESTRICTIONS

Beware of quantization errors. 

The f77 command causes confusion because the entry points are at the bottom of subroutines and functions.

FILES

mon.outfor profile
a.outfor namelist
mon.sumfor summary profile

SEE ALSO

cc(1), plot(1g), profil(2), monitor(3)

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026