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

.\" Copyright (c) 1997, Apple Computer, Inc.  All rights reserved.
.\"
.Dd August 13, 1997
.Dt VM_STAT 1
.Os Mac OS X
.Sh NAME
.Nm vm_stat
.Nd show Mach virtual memory statistics
.Sh SYNOPSIS
.Nm vm_stat
.Op Ar interval
.Sh DESCRIPTION
.Nm vm_stat 
displays Mach virtual memory statistics.  If the optional 
.Ar interval 
is specified, then 
.Nm vm_stat 
will display the statistics every 
.Ar interval 
seconds.  In this case, each line of output displays the change in
each statistic (an
.Ar interval 
count of 1 displays the values per second).  However, the first line
of output following each banner displays the system-wide totals for
each statistic.  The following values are displayed:
.Bl -tag -width indent -compact
.It Pages free
the total number of free pages in the system.
.It Pages active
the total number of pages currently in use and pageable.
.It Pages inactive
the total number of pages on the inactive list.
.It Pages wired down
the total number of pages wired down.  That is, pages that cannot be
paged out.
.It Translation faults
the number of times the "vm_fault" routine has been called.
.It Pages copy-on-write
the number of faults that caused a page to be
copied (generally caused by copy-on-write faults).
.It Pages zero filled
the total number of pages that have been zero-filled on demand.
.It Pages reactivated
the total number of pages that have been moved from the inactive list
to the active list (reactivated).
.It Pageins
the number of requests for pages from a pager (such as the inode pager).
.It Pageouts
the number of pages that have been paged out.
.El
.Pp
If 
.Ar interval 
is not specified, then 
.Nm vm_stat 
displays all accumulated statistics along with the page size and the
object cache performance.
Commit	Line	Data
b51d5b5f A	1	.\" Copyright (c) 1997, Apple Computer, Inc. All rights reserved.
	2	.\"
	3	.Dd August 13, 1997
	4	.Dt VM_STAT 1
	5	.Os Mac OS X
	6	.Sh NAME
	7	.Nm vm_stat
	8	.Nd show Mach virtual memory statistics
	9	.Sh SYNOPSIS
	10	.Nm vm_stat
	11	.Op Ar interval
	12	.Sh DESCRIPTION
	13	.Nm vm_stat
	14	displays Mach virtual memory statistics. If the optional
	15	.Ar interval
	16	is specified, then
	17	.Nm vm_stat
	18	will display the statistics every
	19	.Ar interval
	20	seconds. In this case, each line of output displays the change in
	21	each statistic (an
	22	.Ar interval
	23	count of 1 displays the values per second). However, the first line
	24	of output following each banner displays the system-wide totals for
	25	each statistic. The following values are displayed:
	26	.Bl -tag -width indent -compact
	27	.It Pages free
	28	the total number of free pages in the system.
	29	.It Pages active
	30	the total number of pages currently in use and pageable.
	31	.It Pages inactive
	32	the total number of pages on the inactive list.
	33	.It Pages wired down
	34	the total number of pages wired down. That is, pages that cannot be
	35	paged out.
	36	.It Translation faults
	37	the number of times the "vm_fault" routine has been called.
	38	.It Pages copy-on-write
	39	the number of faults that caused a page to be
	40	copied (generally caused by copy-on-write faults).
	41	.It Pages zero filled
	42	the total number of pages that have been zero-filled on demand.
	43	.It Pages reactivated
	44	the total number of pages that have been moved from the inactive list
	45	to the active list (reactivated).
	46	.It Pageins
	47	the number of requests for pages from a pager (such as the inode pager).
	48	.It Pageouts
	49	the number of pages that have been paged out.
20e66415	50	.El
b51d5b5f A	51	.Pp
	52	If
	53	.Ar interval
	54	is not specified, then
	55	.Nm vm_stat
	56	displays all accumulated statistics along with the page size and the
	57	object cache performance.