[unix-history] / usr / man / man1 / prof.1

.TH PROF 1 
.SH NAME
prof \- display profile data
.SH SYNOPSIS
.B prof
[
.B \-v
] [
.B \-a
] [
.B \-l
] [
.BI \- "low\fR [ \fB\-\fIhigh\fR ]"
] [ file ]
.SH DESCRIPTION
.I Prof
interprets the file
.I mon.out
produced by the
.I monitor
subroutine.
Under default modes,
the symbol table in the
named object file
.I (a.out
default)
is read and correlated with the
.I mon.out
profile file.
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.
.PP
If the
.B \-a
option is used,
all symbols are reported rather than
just external symbols.
If the
.B \-l
option
is used,
the output is listed by
symbol value rather than
decreasing percentage.
.PP
If the
.B \-v
option is used,
all printing is suppressed
and a graphic version of the profile
is produced
on the standard output for display by the
.IR  plot (1)
filters.
The numbers
.I low
and 
.I high,
by default 0 and 100, cause a selected
percentage of the profile to be plotted
with accordingly higher resolution.
.PP
In order for the number of calls to a routine to be tallied,
the
.B \-p
option of
.I cc
must have been given when the file containing the
routine was compiled.
This option also arranges for the
.I mon.out
file to be produced automatically.
.SH FILES
.ta \w'mon.out  'u
mon.out	for profile
.br
a.out		for namelist
.SH "SEE ALSO"
monitor(3), profil(2), cc(1), plot(1)
.SH BUGS
Beware of quantization errors.
Commit	Line	Data
e6817382 BJ	1	.TH PROF 1
	2	.SH NAME
	3	prof \- display profile data
	4	.SH SYNOPSIS
	5	.B prof
	6	[
	7	.B \-v
	8	] [
	9	.B \-a
	10	] [
	11	.B \-l
	12	] [
	13	.BI \- "low\fR [ \fB\-\fIhigh\fR ]"
	14	] [ file ]
	15	.SH DESCRIPTION
	16	.I Prof
	17	interprets the file
	18	.I mon.out
	19	produced by the
	20	.I monitor
	21	subroutine.
	22	Under default modes,
	23	the symbol table in the
	24	named object file
	25	.I (a.out
	26	default)
	27	is read and correlated with the
	28	.I mon.out
	29	profile file.
	30	For each external symbol, the percentage
	31	of time spent executing between that symbol
	32	and the next
	33	is printed (in decreasing order),
	34	together with the number of times that routine was called
	35	and the number of milliseconds per call.
	36	.PP
	37	If the
	38	.B \-a
	39	option is used,
	40	all symbols are reported rather than
	41	just external symbols.
	42	If the
	43	.B \-l
	44	option
	45	is used,
	46	the output is listed by
	47	symbol value rather than
	48	decreasing percentage.
	49	.PP
	50	If the
	51	.B \-v
	52	option is used,
	53	all printing is suppressed
	54	and a graphic version of the profile
	55	is produced
	56	on the standard output for display by the
	57	.IR plot (1)
	58	filters.
	59	The numbers
	60	.I low
	61	and
	62	.I high,
	63	by default 0 and 100, cause a selected
	64	percentage of the profile to be plotted
65	with accordingly higher resolution.
66	.PP
67	In order for the number of calls to a routine to be tallied,
68	the
69	.B \-p
70	option of
71	.I cc
72	must have been given when the file containing the
73	routine was compiled.
74	This option also arranges for the
75	.I mon.out
76	file to be produced automatically.
77	.SH FILES
78	.ta \w'mon.out 'u
79	mon.out for profile
80	.br
81	a.out for namelist
82	.SH "SEE ALSO"
83	monitor(3), profil(2), cc(1), plot(1)
84	.SH BUGS
85	Beware of quantization errors.