[apple/system_cmds.git] / zprint.tproj / zprint.1

.TH ZPRINT 1 27/02/87
.CM 4
.SH NAME
zprint \- show information about kernel zones
.SH SYNOPSIS
\fBzprint\fP [\fB-w\fP] [\fB-s\fP] [\fB-c\fP] [\fB-h\fP] [name]
.SH DESCRIPTION
\fIzprint(1)\fR displays data about Mach zones.  By default,
\fIzprint\fR will print out information about all Mach zones.  If the
optional \fIname\fR is specified, \fIzprint\fR will print information
about each zone for which \fIname\fR is a substring of the zone's
name.
.PP
\fIzprint\fR interprets the following options:
.TP 8
.B \-w
For each zone, \fIzprint\fR calculates how much space is allocated but
not currently in use, the space wasted by the zone.
.TP 8
.B \-s
\fIzprint\fR sorts the zones, showing the wasting the most memory first.
.TP 8
.B \-c
(Default)
\fIzprint\fR prints zone info in columns. Long zone names are truncated
with '$', and spaces are replaced with '.', to allow for sorting by column.
Pageable and collectible zones are shown with 'P' and 'C'
on the far right. Zones with preposterously large maximum
sizes are shown with '----' in the max size and max num elts fields.
.TP 8
.B \-h
(Default)
Shows headings for the columns printed with the -c option.
It may be useful to override this option when sorting by column.
.PP
Any option (including default options) can be overridden
by specifying the option in upper-case; for example, -C overrides
the (default) option -c.
.SH "SEE ALSO"
host_zone_info(2).
Commit	Line	Data
c3a08f59 A	1	.TH ZPRINT 1 27/02/87
	2	.CM 4
	3	.SH NAME
	4	zprint \- show information about kernel zones
	5	.SH SYNOPSIS
	6	\fBzprint\fP [\fB-w\fP] [\fB-s\fP] [\fB-c\fP] [\fB-h\fP] [name]
	7	.SH DESCRIPTION
	8	\fIzprint(1)\fR displays data about Mach zones. By default,
	9	\fIzprint\fR will print out information about all Mach zones. If the
	10	optional \fIname\fR is specified, \fIzprint\fR will print information
	11	about each zone for which \fIname\fR is a substring of the zone's
	12	name.
	13	.PP
	14	\fIzprint\fR interprets the following options:
	15	.TP 8
	16	.B \-w
	17	For each zone, \fIzprint\fR calculates how much space is allocated but
	18	not currently in use, the space wasted by the zone.
	19	.TP 8
	20	.B \-s
	21	\fIzprint\fR sorts the zones, showing the wasting the most memory first.
	22	.TP 8
	23	.B \-c
	24	(Default)
	25	\fIzprint\fR prints zone info in columns. Long zone names are truncated
	26	with '$', and spaces are replaced with '.', to allow for sorting by column.
	27	Pageable and collectible zones are shown with 'P' and 'C'
	28	on the far right. Zones with preposterously large maximum
	29	sizes are shown with '----' in the max size and max num elts fields.
	30	.TP 8
	31	.B \-h
	32	(Default)
	33	Shows headings for the columns printed with the -c option.
	34	It may be useful to override this option when sorting by column.
	35	.PP
	36	Any option (including default options) can be overridden
	37	by specifying the option in upper-case; for example, -C overrides
	38	the (default) option -c.
	39	.SH "SEE ALSO"
	40	host_zone_info(2).