.\" SCCSID: @(#)prof.1	8.1	9/11/90.TH prof 1 VAX.SH Nameprof \- profile an object file.SH Syntax.B prof[\fB\-a\fR] [\fB\-l\fR] [\fB\-n\fR][\fB\-z\fR] [\fB\-s\fR][\fB\-v\fR][\fIlow\fR\|[\fB\-\fIhigh\fR\|]\|]\|][\fIfile1\fR\|[\fIfile2...\fR]\|].SH Description.NXR "prof command".NXA "plot command" "prof command".NXAM "monitor subroutine" "prof command".NXA "cc compiler" "prof command".NXA "f77 compiler" "prof command".NXR "profile file" "displaying data"The.PN profcommand interprets the file produced by the.PN monitor(3)subroutine.Under default modes,the symbol table in thenamed object file(a.outdefault)is read and correlated with theprofile file(mon.outdefault).For each external symbol, the percentageof time spent executing between that symboland the nextis printed (in decreasing order),together with the number of times that routine was calledand the number of milliseconds per call.If more than one profile file is specified,the output represents the sum of the profiles..SH Options.NXR "prof command" "options"In order for the number of calls to a routine to be tallied,the.B \-poption of.PN cc(1),.PN f77(1)or.PN pc(1)must have been given when the file containing theroutine was compiled.This option also arranges for theprofile file to be produced automatically..IP \fB\-a\fR 5Displays all symbols rather thanjust external symbols..IP \fB\-l\fR Displays output by symbol value.  .IP \fB\-n\fR Displays output by number of calls. .IP \fB\-s\fR Summary profile file is produced in mon.sum.This is useful onlywhen more than one profile file is specified..IP \fB\-v\fR Produces graphic output for display by the.PN plot(1g) filters.When plotting, the numbers.I lowand .I high,by default 0 and 100, may be given, which causes a selectedpercentage of the profile to be plottedwith accordingly higher resolution..IP \fB\-z\fR Routines having zero usage, as indicated by call countsand accumulated time, are printed in the output..SH Restrictions.NXR "prof command" "restricted"Beware of quantization errors..PPThe.PN f77command causes confusion because the entry points are at the bottom of subroutines and functions..SH Files.ta \w'mon.out  'umon.out	for profile.bra.out		for namelist.brmon.sum	for summary profile.SH See Alsocc(1), plot(1g), profil(2), monitor(3)