MFC: r319866, r319867
top: Change the way the ZFS ARC compression ratio is calculated
remove overhead statistics, already included in other counters

Approved by: re (gjb)

MFC r308474, r308691, r309203, r309365, r309703, r309898, r310720,
r308489, r308706:
Add PQ_LAUNDRY and remove PG_CACHED pages.

MFC r315435:
Add ZFS compressed ARC stats to top(1)

MFC r316314:
top(1) read the wrong amount of data from sysctl

MFC r318448:
Explain the new fields in top(1) related to ZFS compressed ARC

Remove the laundry field during the merge, does not exist in stable/11

Copy head@r302406 to stable/11 as part of the 11.0-RELEASE cycle.
Prune svn:mergeinfo from the new branch, as nothing has been merged
here.

Additional commits post-branch will follow.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

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

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

Remove trailing whitespace per mdoc lint warning

Disussed with: gavin
No objection from: doc
Approved by: joel
MFC after: 3 days

- Document the -H option and 'H' key alongside other options and keys
rather than at the bottom of the manpage.
- Remove an obsolete comment about SWAIT being a stale state. It was
resurrected for a different purpose in FreeBSD 5 to mark idle ithreads.
- Add a comment documenting that the SLEEP and LOCK states typically
display the name of the event being waited on with lock names being
prefixed with an asterisk and sleep event names not having a prefix.

MFC after: 1 week

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

Memory stats are reported in bytes, not pages.

PR: docs/151283
Submitted by: Bas Smeelen <b.smeelen at ose.nl>
MFC after: 3 days

Inactive pages don't have to be dirty plus improve description of
the cache queue.

Submitted by: alc
Approved by: re (kensmith)

Fix the description of the "Cache" memory and clarify the
description of the "Inact" memory. (They count pages in
the cache/inactive page queues, respectively.)

Approved by: re (kensmith)

Changes to allow top to decide whether or not to show multiple threads per
process. Option -H enables it and it is toggled at the interactive
screen by 'H'.

Submitted by: Jung-uk Kim <jkim@niksun.com>

Man pages for top refer to only 2.x, but not to 3.x and later

This commit was generated by cvs2svn to compensate for changes in r24143,
which included commits to RCS files with non-trunk default branches.

This is the FreeBSD-specific files for top, plus the Makefile
that pulls all the files from contrib.

Obtained from: The ports collection (mostly).