freebsd-skq/usr.bin/top/top.local.1

.\" $FreeBSD$
.SH "FreeBSD NOTES"

.SH DESCRIPTION OF MEMORY
Mem: 9220K Active, 1M Inact, 3284K Wired, 1M Cache, 2M Buf, 1320K Free
ARC: 2048K Total, 342K MRU, 760K MFU, 272K Anon, 232K Header, 442K Other
Swap: 91M Total, 79M Free, 13% Inuse, 80K In, 104K Out
.TP
.B K:
Kilobyte
.TP
.B M:
Megabyte
.TP
.B G:
Gigabyte
.TP
.B %:
1/100
.SS Physical Memory Stats
.TP
.B Active:
number of bytes active
.TP
.B Inact:
number of bytes inactive
.TP
.B Wired:
number of bytes wired down, including BIO-level cached file data pages
.TP
.B Cache:
number of clean bytes caching data that are available for
immediate reallocation
.TP
.B Buf:
number of bytes used for BIO-level disk caching
.TP
.B Free:
number of bytes free
.SS ZFS ARC Stats
These stats are only displayed when the ARC is in use.
.TP
.B Total:
number of wired bytes used for the ZFS ARC
.TP
.B MRU:
number of ARC bytes holding most recently used data
.TP
.B MFU:
number of ARC bytes holding most frequently used data
.TP
.B Anon:
number of ARC bytes holding in flight data
.TP
.B Header:
number of ARC bytes holding headers
.TP
.B Other
miscellaneous ARC bytes
.SS Swap Stats
.TP
.B Total:
total available swap usage
.TP
.B Free:
total free swap usage
.TP
.B Inuse:
swap usage
.TP
.B In:
bytes paged in from swap devices (last interval)
.TP
.B Out:
bytes paged out to swap devices (last interval)
Remove trailing whitespace per mdoc lint warning Disussed with: gavin No objection from: doc Approved by: joel MFC after: 3 days 2012-03-29 05:02:12 +00:00			`.\" $FreeBSD$`
Man pages for top refer to only 2.x, but not to 3.x and later 1999-06-14 12:06:11 +00:00			`.SH "FreeBSD NOTES"`
This is the FreeBSD-specific files for top, plus the Makefile that pulls all the files from contrib. Obtained from: The ports collection (mostly). 1997-03-23 18:55:20 +00:00
Touch up the sample memory usage numbers a bit, to avoid wrapping on terminal boundary. While here add definition for 'G' and fix the indentation of 'K' units. Submitted by: plunket PR: docs/153614 MFC after: 3 days 2011-01-23 11:08:39 +00:00			`.SH DESCRIPTION OF MEMORY`
			`Mem: 9220K Active, 1M Inact, 3284K Wired, 1M Cache, 2M Buf, 1320K Free`
Add a new line to top that provides a brief summary of the ZFS ARC memory usage on hosts using ZFS. The new line displays the total amount of RAM used by the ARC along with the size of MFU, MRU, anonymous (in flight), headers, and other (miscellaneous) sub-categories. The line is not displayed on systems that are not using ZFS. Reviewed by: avg, fs@ MFC after: 3 days 2012-06-27 18:08:48 +00:00			`ARC: 2048K Total, 342K MRU, 760K MFU, 272K Anon, 232K Header, 442K Other`
Memory stats are reported in bytes, not pages. PR: docs/151283 Submitted by: Bas Smeelen <b.smeelen at ose.nl> MFC after: 3 days 2010-11-13 11:43:20 +00:00			`Swap: 91M Total, 79M Free, 13% Inuse, 80K In, 104K Out`
Touch up the sample memory usage numbers a bit, to avoid wrapping on terminal boundary. While here add definition for 'G' and fix the indentation of 'K' units. Submitted by: plunket PR: docs/153614 MFC after: 3 days 2011-01-23 11:08:39 +00:00			`.TP`
This is the FreeBSD-specific files for top, plus the Makefile that pulls all the files from contrib. Obtained from: The ports collection (mostly). 1997-03-23 18:55:20 +00:00			`.B K:`
			`Kilobyte`
			`.TP`
			`.B M:`
			`Megabyte`
			`.TP`
Touch up the sample memory usage numbers a bit, to avoid wrapping on terminal boundary. While here add definition for 'G' and fix the indentation of 'K' units. Submitted by: plunket PR: docs/153614 MFC after: 3 days 2011-01-23 11:08:39 +00:00			`.B G:`
			`Gigabyte`
			`.TP`
This is the FreeBSD-specific files for top, plus the Makefile that pulls all the files from contrib. Obtained from: The ports collection (mostly). 1997-03-23 18:55:20 +00:00			`.B %:`
			`1/100`
Add a new line to top that provides a brief summary of the ZFS ARC memory usage on hosts using ZFS. The new line displays the total amount of RAM used by the ARC along with the size of MFU, MRU, anonymous (in flight), headers, and other (miscellaneous) sub-categories. The line is not displayed on systems that are not using ZFS. Reviewed by: avg, fs@ MFC after: 3 days 2012-06-27 18:08:48 +00:00			`.SS Physical Memory Stats`
This is the FreeBSD-specific files for top, plus the Makefile that pulls all the files from contrib. Obtained from: The ports collection (mostly). 1997-03-23 18:55:20 +00:00			`.TP`
			`.B Active:`
Memory stats are reported in bytes, not pages. PR: docs/151283 Submitted by: Bas Smeelen <b.smeelen at ose.nl> MFC after: 3 days 2010-11-13 11:43:20 +00:00			`number of bytes active`
This is the FreeBSD-specific files for top, plus the Makefile that pulls all the files from contrib. Obtained from: The ports collection (mostly). 1997-03-23 18:55:20 +00:00			`.TP`
			`.B Inact:`
Memory stats are reported in bytes, not pages. PR: docs/151283 Submitted by: Bas Smeelen <b.smeelen at ose.nl> MFC after: 3 days 2010-11-13 11:43:20 +00:00			`number of bytes inactive`
This is the FreeBSD-specific files for top, plus the Makefile that pulls all the files from contrib. Obtained from: The ports collection (mostly). 1997-03-23 18:55:20 +00:00			`.TP`
			`.B Wired:`
Clarify that the cached file data pages included in the "Wired" count in top are the BIO-level cached data (i.e. "Buf"), since the previous phrase was a bit ambiguous with the "Cache" count. MFC after: 3 days 2012-06-27 12:30:56 +00:00			`number of bytes wired down, including BIO-level cached file data pages`
This is the FreeBSD-specific files for top, plus the Makefile that pulls all the files from contrib. Obtained from: The ports collection (mostly). 1997-03-23 18:55:20 +00:00			`.TP`
			`.B Cache:`
Memory stats are reported in bytes, not pages. PR: docs/151283 Submitted by: Bas Smeelen <b.smeelen at ose.nl> MFC after: 3 days 2010-11-13 11:43:20 +00:00			`number of clean bytes caching data that are available for`
Inactive pages don't have to be dirty plus improve description of the cache queue. Submitted by: alc Approved by: re (kensmith) 2007-09-02 10:29:16 +00:00			`immediate reallocation`
This is the FreeBSD-specific files for top, plus the Makefile that pulls all the files from contrib. Obtained from: The ports collection (mostly). 1997-03-23 18:55:20 +00:00			`.TP`
			`.B Buf:`
Memory stats are reported in bytes, not pages. PR: docs/151283 Submitted by: Bas Smeelen <b.smeelen at ose.nl> MFC after: 3 days 2010-11-13 11:43:20 +00:00			`number of bytes used for BIO-level disk caching`
This is the FreeBSD-specific files for top, plus the Makefile that pulls all the files from contrib. Obtained from: The ports collection (mostly). 1997-03-23 18:55:20 +00:00			`.TP`
Remove trailing whitespace per mdoc lint warning Disussed with: gavin No objection from: doc Approved by: joel MFC after: 3 days 2012-03-29 05:02:12 +00:00			`.B Free:`
Memory stats are reported in bytes, not pages. PR: docs/151283 Submitted by: Bas Smeelen <b.smeelen at ose.nl> MFC after: 3 days 2010-11-13 11:43:20 +00:00			`number of bytes free`
Add a new line to top that provides a brief summary of the ZFS ARC memory usage on hosts using ZFS. The new line displays the total amount of RAM used by the ARC along with the size of MFU, MRU, anonymous (in flight), headers, and other (miscellaneous) sub-categories. The line is not displayed on systems that are not using ZFS. Reviewed by: avg, fs@ MFC after: 3 days 2012-06-27 18:08:48 +00:00			`.SS ZFS ARC Stats`
			`These stats are only displayed when the ARC is in use.`
			`.TP`
			`.B Total:`
			`number of wired bytes used for the ZFS ARC`
			`.TP`
			`.B MRU:`
			`number of ARC bytes holding most recently used data`
			`.TP`
			`.B MFU:`
			`number of ARC bytes holding most frequently used data`
			`.TP`
			`.B Anon:`
			`number of ARC bytes holding in flight data`
			`.TP`
			`.B Header:`
			`number of ARC bytes holding headers`
			`.TP`
			`.B Other`
			`miscellaneous ARC bytes`
			`.SS Swap Stats`
This is the FreeBSD-specific files for top, plus the Makefile that pulls all the files from contrib. Obtained from: The ports collection (mostly). 1997-03-23 18:55:20 +00:00			`.TP`
Remove trailing whitespace per mdoc lint warning Disussed with: gavin No objection from: doc Approved by: joel MFC after: 3 days 2012-03-29 05:02:12 +00:00			`.B Total:`
This is the FreeBSD-specific files for top, plus the Makefile that pulls all the files from contrib. Obtained from: The ports collection (mostly). 1997-03-23 18:55:20 +00:00			`total available swap usage`
Remove trailing whitespace per mdoc lint warning Disussed with: gavin No objection from: doc Approved by: joel MFC after: 3 days 2012-03-29 05:02:12 +00:00			`.TP`
			`.B Free:`
This is the FreeBSD-specific files for top, plus the Makefile that pulls all the files from contrib. Obtained from: The ports collection (mostly). 1997-03-23 18:55:20 +00:00			`total free swap usage`
Remove trailing whitespace per mdoc lint warning Disussed with: gavin No objection from: doc Approved by: joel MFC after: 3 days 2012-03-29 05:02:12 +00:00			`.TP`
			`.B Inuse:`
This is the FreeBSD-specific files for top, plus the Makefile that pulls all the files from contrib. Obtained from: The ports collection (mostly). 1997-03-23 18:55:20 +00:00			`swap usage`
Remove trailing whitespace per mdoc lint warning Disussed with: gavin No objection from: doc Approved by: joel MFC after: 3 days 2012-03-29 05:02:12 +00:00			`.TP`
			`.B In:`
Memory stats are reported in bytes, not pages. PR: docs/151283 Submitted by: Bas Smeelen <b.smeelen at ose.nl> MFC after: 3 days 2010-11-13 11:43:20 +00:00			`bytes paged in from swap devices (last interval)`
This is the FreeBSD-specific files for top, plus the Makefile that pulls all the files from contrib. Obtained from: The ports collection (mostly). 1997-03-23 18:55:20 +00:00			`.TP`
Remove trailing whitespace per mdoc lint warning Disussed with: gavin No objection from: doc Approved by: joel MFC after: 3 days 2012-03-29 05:02:12 +00:00			`.B Out:`
Memory stats are reported in bytes, not pages. PR: docs/151283 Submitted by: Bas Smeelen <b.smeelen at ose.nl> MFC after: 3 days 2010-11-13 11:43:20 +00:00			`bytes paged out to swap devices (last interval)`