s/maxiumum/maximum/

reflect reality on flags.

Provide symbolic printing of some keywords by capitalizing them.

Sort options in synopsis.

PR standards/11223

Add -G to take a single group argument heading towards POSIX.2 compliance.
Patch from jperkin and reviewed by simonb.

branches: 1.110.6;
Restore maxrss, idrss, isrss, ixrss printing in ps(1)

The RSS related statistics are now back in the NetBSD kernel.

These values were disabled since day0 until today.

libkvm(3) users will still receive inappropriate values as RSS statistics
are updated upon sysctl(3) call.

Patch submitted by <Krzysztof Lasocki>

branches: 1.109.4; 1.109.6;
Bump date for previous. Remove/replace bogus Tn uses.

Remove the filesystem tracing feature

This is a legacy interface from 4.4BSD, and it was
introduced to overcome shortcomings of ptrace(2) at that time, which are
no longer relevant (performance). Today /proc/#/ctl offers a narrow
subset of ptrace(2) commands and is not applicable for modern
applications use beyond simplistic tracing scenarios.

This removal will simplify kernel internals. Users will still be able to
use all the other /proc files.

This change won't affect other procfs files neither Linux compat
features within mount_procfs(8). /proc/#/ctl isn't available on Linux.

Remove:
- /proc/#/ctl from mount_procfs(8)
- P_FSTRACE note from the documentation of ps(1)
- /proc/#/ctl and filesystem tracing documentation from mount_procfs(8)
- KAUTH_REQ_PROCESS_PROCFS_CTL documentation from kauth(9)
- source code file miscfs/procfs/procfs_ctl.c
- PFSctl and procfs_doctl() from sys/miscfs/procfs/procfs.h
- KAUTH_REQ_PROCESS_PROCFS_CTL from sys/sys/kauth.h
- PSL_FSTRACE (0x00010000) from sys/sys/proc.h
- P_FSTRACE (0x00010000) from sys/sys/sysctl.h

Reduce code complexity after removal of this functionality.

Update TODO.ptrace accordingly: remove two entries about /proc tracing.

Do not keep legacy notes as comments in the headers about removed
PSL_FSTRACE / P_FSTRACE, as this interface had little number of users
(close or equal to zero).

Proposed on tech-kern@.

All filesystem tracing utility users are encouraged to switch to ptrace(2).

Sponsored by <The NetBSD Foundation>

Remove workaround for ancient HTML generation code.

branches: 1.106.6;
provide a tree like display with -d, from FreeBSD

Earliest reference in the TUHS archive is v3
Unfortunately only the source code for the compiler is present for that
release. The v2 archive is missing the manuals & only contains a some of the
commands.
Switch to v3 and reference manual category eight, as per r1.32 of
src/bin/ps/ps.1 from OpenBSD.
Heads up from Ingo Schwarze.

Document the version ps first appeared.

branches: 1.103.8;
Bump date for previous.

Add an LTIME column that prints lwp cputime.

branches: 1.101.2;
Switch device database to cdb(5). Rework ttyname(3) and ttyname_r(3) to
depend on new devname_r(3) as heart. Add /dev/pts magic directly to
devname(3). While it can lead to returning non-existing paths, the
behavior is more consistent that way. Drop caching layer in devname(3),
it doesn't buy anything for the common case of having access to the
database. Teach devname(3) proper fallback behavior of scanning /dev.
Create both old-style and new-style database for now in /etc/rc.d/sysdb.

Increase width of table column so it formats more nicely.

- choose better argument name for `-U';
- add argument names for options in man page;
- improve wording, punctuation, capitalization.

From Bug Hunting in email.

Remove trailing whitespace.

Fix obsolete example (that referred to letters in process state that are
not set anymore), and clarify their meaning.

The 'lstart' column uses strftime %c, not %C. Noted by mrg.

branches: 1.95.2;
Minor English improvements for -w, partly from Snader_LB.

branches: 1.94.4;
fix typo, from Randolf Richardson in PR 44559

branches: 1.93.2;
Don't break lines in .It, there be dragons in groff.

Use .In instead of .Aq Pa for header files

Bump date for uarea swap-out removal.

Remove uarea swap-out functionality:

- Addresses the issue described in PR/38828.
- Some simplification in threading and sleepq subsystems.
- Eliminates pmap_collect() and, as a side note, allows pmap optimisations.
- Eliminates XS_CTL_DATA_ONSTACK in scsipi code.
- Avoids few scans on LWP list and thus potentially long holds of proc_lock.
- Cuts ~1.5k lines of code. Reduces amd64 kernel size by ~4k.
- Removes __SWAP_BROKEN cases.

Tested on x86, mips, acorn32 (thanks <mpumford>) and partly tested on
acorn26 (thanks to <bjh21>).

Discussed on <tech-kern>, reviewed by <ad>.

Bump date for previous.

Remove reference to P_SYSTRACE.
Fixes PR/41426
(leave defn in sys/sysctl.h since the bit shouldn't be reused!)

Fix number of columns in .Bl. Escape %C.

branches: 1.86.4;
Improve wording.

Use 'O' for LSONPROC like solaris instead of bundling LSIDL, LSRUN, LSONPROC
to 'R'

Sort options.
Remove systrace reference.

Add "ps -A" option. This displays information about all processes,
like BSD "ps -ax" or SYSV "ps -ef". It's specified in SUSv3.

Also make some minor clarifications to the man page.

Add a CPUID keyword; idea and some of the code from Anon Ymous

Remove systrace. Ok core@.

Document "emul" keyword. Fixes PR 36935.
Also sort list of keywords, and bump date.

add a keyword "lname", to print l_name.

branches: 1.78.4;
remove descriptions of some states. ('A', 'S', '>')
- they are wrong. (madvise is not vadvise)
- they don't exist anymore.

Remove trailing whitespace.
Remove a partially duplicated sentence.

Make it clear that multiple sort keys may be specified.
Closes PR 34271.

Avoid .No if easily possible.

Add some markup missed in previous.

Document changes to -o and -O options, and improve markup.

add "uaddr" and improve text for "laddr".

branches: 1.71.2;
Add the missing suspended state 'U'.

Bump date.

Bump date for laddr.

Add a "laddr" keyword, analagous to "paddr". Useful for finding
struct pcb's.

s/the the/the/ (only in sources that aren't regularly imported from
elsewhere).

Add support for the POSIX.2 "args" and "comm" keywords. "args" is just
an alias for "command", and "comm" shows just argv[0] and not the whole
argument list.

Fix for part of PR standards/11224.

Add support for the POSIX.2 "etime" keyword - shows the elapsed time
since the process was started. Fix a couple of style nits as well.

Fix for part of PR standards/11224.

Uppercase CPU where appropriate.

Add Xr for dev_mkdb(8), per PR 23168. Increase width in FILES section while here.

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22249, verified by myself.

More mdoc.

Update date for recent changes.

- add keywords for utime, stime and ctime (output sss.ssssss if small)
- fiddle with keyword table - mainly to keep width under 80 cols
- add -k keylist so sort output
- don't use logs to work out field width, get -MAXINT right
- user defined headers can be 1 char (actually they can be zero length)
so ?? in tty column isn't guaranteed to be wider than header
- remove some long long casts (compiles on sparc64 still)
- use kvm_openfiles(NULL, NULL, NULL, KVN_NO_FILES, ..) unless core file
specified,
(approved by christos)

Add p_svuid and p_svgid to kinfo_proc2. Populate them in the kernel
and in libkvm. Then teach ps how to show them to you.

Also, teach ps how to show the names for all the uids, the rest of the
group numbers, and the "group access list".

.Nm does not need a dummy argument ("") before punctuation or
for correct formatting of the SYNOPSIS any longer.

Merge the nathanw_sa branch.

Use more mdoc.

New policy: New sentences start on a new line.
Patches by Robert Elz <kre at munnari oz au>, with minimal changes by me.

g/c procfs fallback code, it's redundant now that we use sysctl to get
process info

Sort SEE ALSO.

Document some missing flags and add systrace(1) 'x' flag.

"a, b, c, and d", not "a, b, c and d".

branches: 1.50.2;
Drop trailing space.

Xref pkill/pgrep.

Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

Properly quote punctuation.

Whitespace nits.

precede, not preceed.

Print system processes/kernel threads as [kprocname] as top(1) does.

correct the description of paddr

clarify things a bit more (from hubertf)

Really explain what parenthesized names mean and why we parenthesize names!

Document the meaning of commands shown in parantheses.

Patches submitted by Jeremy C. Reed <reed@reedmedia.net> in PR 11930.

Add a K flag to the state information - K is for kernel thread or system
process (ie, P_SYSTEM set in p_flag). The L flag (locked in core) is
only used for non-P_SYSTEM processes.

Update description of process flag 0x20000 to match reality:
P_NOCLDWAIT, not P_SSTEP.

Remove the 'poip' (pageouts in progress) keyword from the manpage.
From PR bin/8843 by Brian Stark.

branches: 1.36.4;
Use tty "?" to select processes with no controlling tty and tty "-" to
select processes with a revoked controlling tty.

Idea from SunOS/Solaris, suggested by Alexis Rosen.

make -M imply -K. the current system is not likely to be
a reasonable approximation of a crash dump.

name database is kvm.db not kvm_netbsd.db

Document -U switch (displays processes belonging to given user/uid).
Reported in PR 8943 by WL <wliao@dura.spc.uchicago.edu>

"ps -e" only shows the environment for the processes owned by the
current user id or all process if run by root.

Fixes PR security/5967 from Todd Vierling.

branches: 1.31.6;
Minor fixes:
1. Use statfs() to verify that /proc is a procfs.
2. Add -K option to disable /proc-based method.
3. Make warnings less verbose, but still accurate.

Added experimental fallback /proc-based lookup. Warnings are printed when the
fallback method is used, as the results could be untrustworthy if an
intruder is present. It is highly likely that NetBSD-1.5 will have
an improved kvm interface for reading process information, at which
point this code can be garbage-collected. Also added a word to the
man page -x option description while I was here.

More and more .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Many more to
come.

ps's information is sorted by controlling terminal and (among processes with
the same controlling terminal) by PID.

Clean up SYNOPSIS formatting.

Fix formatting errors.

The system namelist database is called "/var/db/kvm.db" not
"/var/db/kvm_netbsd.db". Fixes PR bin/6712 by Brian Grayson.

change references to vadvise to madvise; remove reference to lisp(1)

Sync with reality: the uprocp keyword doesn't exist.

remove old OLD BSD VM code.

branches: 1.21.2;
Use .Nm "" instead of .Nm ps in SYNOPSIS.

all but the first .Nm in SYNOPSIS need to be spelt out. [bin/4256]

getopt returns -1 not EOF
cleanup manpage

default swap device is /dev/drum, not nonexistent /dev/swap; from
<entropy@tardis.bernstein.com> in PR bin/4042

Refer to execve(2), add section to `vfork' ref. (almost per PR#3627).

fix damage caused by sccs (long ago)

add a 'holdcnt' keyword and document it.

Sync process flags with sys/proc.h

convert to new RCS id conventions.

Integrate `-c' option, from Arne Juul.

vmunix -> netbsd (PR #375)

branches: 1.10.2;
clean up import

Fix spelling errors.

fix from Thomas Eberhardt <thomas@mathematik.uni-Bremen.de>:
don't try to display the resident text size; we can't do that anymore

Add RCS indentifiers.

Fix up FILES sections.

Update file names.

add support and documentation for the 'e' option, to print out
the process environment.

changed "Id" to "Header" for rcsids

added rcs ids to all files

branches: 1.1.1;
Initial revision