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

(cherry picked from commit 428200d2f0)

Commit hash edited on MFC.
This commit is contained in:
Olivier Certner 2025-05-06 15:42:33 +02:00
parent 455203ec88
commit f18a49a747
No known key found for this signature in database
GPG key ID: 8CA13040971E2627
1 changed files with 17 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

17
RELNOTES
View file

@ -10,6 +10,23 @@ newline. Entries should be separated by a newline.
Changes to this file should not be MFCed.
1ee62f354ab0:
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.
a2132d91739d:
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