MFC r322139

Enhance top(1) to filter on multiple usernames

Reviewed by: cognet, bapt
Approved by: cognet
Relnotes: yes
Differential Revision: https://reviews.freebsd.org/D11840

MFH (r305414): add a toggle to show approximate swap usage.

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

Move contrib/top/top.X to contrib/top/top.xs and move
contrib/top/top.local.H to contrib/top/top.local.hs.
This fixes a build breakage when src is on a case-
insensitive file system -- we never properly create
top.x nor top.local.h. Change the makefile accordingly.

MFC after: 3 days

Add -J command/flag to filter by jail name/jid. This will automatically
display the JID as well (the -j command/flag).

0 displays host.
+ displays all.

MFC after: 2 weeks
Relnotes: yes

Allow per-CPU statistics to be toggled at runtime via the 'P' key.
While here, make -P a toggle similar to other options such as -I.

Reviewed by: arundel
MFC after: 1 week

Note that -a, -C, -H, -j, and -z are also toggles.

PR: bin/158682
Reported by: arundel
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

Add a new option to toggle the display of the system idle process (per-CPU
idle threads). The process is displayed by default (subject to whether or
not system processes are displayed) to preserve existing behavior. The
system idle process can be hidden via the '-z' command line argument or the
'z' key while top is running. When it is hidden, top more closely matches
the behavior of FreeBSD <= 4.x where idle time was not accounted to any
process.

MFC after: 2 weeks

Removed the no-op -p; documented -P.

MFC after: 3 days

- s/jail id/jail ID/, acronyms should be in uppercase in general. Also,
it is written this way in jail(8).

Suggested by: brueffer
Approved by: delphij (mentor, implicit)

- Add documentation notes for the 'a' option, forgotten in the previous
commit.

commands.c [1]
top.X

Suggested by: rafan [1]

- Add a new 'j' switch and runtime option to toggle display jail id for
each process.
- While I'm here, keep help message sorted by keys

PR: 98489, 98975
Submitted by: clsung
Approved by: delphij (mentor)
MFC after: 2 weeks

- Add new 'a' switch and runtime option that allows 'top' to display process
titles extracted from argv vector instead of the real executable names.
This is useful when you want to watch applications that set their status
information via setproctitle(3).

Approved by: alfred
MFC after: 2 weeks

Update the description of the `STATE' column for SMP systems,
and add the missing `C' SMP-only column.

PR: docs/29245
Submitted by: ada@bsd.org
Patch by: Pawel Worach <pawel.worach@telia.com>
MFC after: 3 days

Document the -C option of top(1), which has been added to the source
and the usage message of top, but not to the manpage.

Pointy hat to: keramida
Reminded by: ru
MFC after: 1 week

Bring SYNOPSIS in line with usage().

Typo.

PR: docs/88015
Submitted by: Marian Cerny <jojo@matfyz.cz>
MFC after: 3 days

Correct macro usage.

Submitted by: Christoph Mallon <christoph.mallon@gmx.de>
MFC after: 3 days

Make 'S' in interactive mode toggle display of system processes.

New feature, provide a display that shows the amount of IO processes
are doing. Toggle this mode by hitting "m" or passing the command line
option "-m io" to top(1). This allows one to identify disk bandwidth
hogs much easier.

Replace a reference to /kernel with /boot/kernel/kernel

Resolve conflicts (we have a -t option).

Correct default value for -s option.

PR: bin/12946
Submitted by: Matthew D. Fuller <fullermd@over-yonder.net>

Add missing .TP in "INTERACTIVE MODE" section.

Add -t option ('t' in interactive mode) to make top(1) ignore itself.
Attempts to contact the author of top(1) (William LeFebvre) have so
far been unsuccessful.

PR: 7253
Submitted by: Yours Truly

vmunix -> kernel

PR: 5484
Submitted by: Vasily V. Grechishnikov <bazilio@ns1.ied-vorstu.ac.ru>

spelling corrections.

PR: docs/4450
Submitted by: josh@quick.net

fix a few spelling changes

Submitted by: Josh Gilliam

Closes PR's: 4429, 4431-4438

PS: He has agreed to submit all contrib fixes back to the original author.

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

This is the long-awaited import of top into the base system (actually,
the src/contrib/top part right now). This tools is simply too system-
dependant to maintain it in the ports collection.