kgess-mirror/freebsd-src
1
0
Fork 0
mirror of https://git.freebsd.org/src.git synced 2026-01-16 23:02:24 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

RELNOTES: ps(1): Document change in behavior for '-a'/'-A'

Browse source 
Document the practical consequence of change "ps(1): Make '-a' and '-A'
always show all processes" (93a94ce731) that specifying '-a'/'-A'
leads to printing all processes regardless of the presence of other
process selection options (except for '-x'/'-X', which command
a filter).

While here, mention a possible practical issue with '-J', as reported by
dch@.  This option was introduced by commit "Add -J to filter by
matching jail IDs and names." (13767130c7, r265229), which
unfortunately talked about '-J' being a filter while actually
implementing it as a regular selection option which adds to the
processes to display.

Reviewed by:    dch
MFC after:      1 day
Sponsored by:   The FreeBSD Foundation
Differential Revision:  https://reviews.freebsd.org/D50193
This commit is contained in:
Olivier Certner 2025-05-06 15:42:33 +02:00
parent 68e73f0365
commit 428200d2f0
No known key found for this signature in database
GPG key ID: 8CA13040971E2627
1 changed files with 18 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

18
RELNOTES
View file

@ -15,6 +15,24 @@ Changes to this file should not be MFCed.
interfaces for viewing and manipulating audio device settings (sysctls,
/dev/sndstat), into a single utility with a similar control-driven
interface to that of mixer(8).
93a94ce731a8:
ps(1)'s options '-a' and '-A', when combined with any other one
affecting the selection of processes except for '-X' and '-x', would
have no effect, in contradiction with the rule that one process is
listed as soon as any of the specified options selects it (inclusive
OR), which is both mandated by POSIX and arguably a natural expectation.
This bug has been fixed.
As a practical consequence, specifying '-a'/'-A' now causes all
processes to be listed regardless of other selection options (except for
'-X' and '-x', which still apply). In particular, to list only
processes from specific jails, one must not use '-a' with '-J'. Option
'-J', contrary to its apparent initial intent, never worked as a filter
in practice (except by accident with '-a' due to the bug), but instead
as any other selection options (e.g., '-U', '-p', '-G', etc.) subject to
the "inclusive OR" rule.
995b690d1398:
ps(1)'s '-U' option has been changed to select processes by their real
user IDs instead of their effective one, in accordance with POSIX and