From nobody Thu Nov 27 20:16:12 2025 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4dHSP86Ct1z6J2qL for ; Thu, 27 Nov 2025 20:16:12 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4dHSP83bNjz3WVb for ; Thu, 27 Nov 2025 20:16:12 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1764274572; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=NB8lNVlVx866NlYuKFKVYssR11yzsj6H5yWBfAIcIpM=; b=I1s+ALXoc5Qa4WBkBx6qGhhxXl04/gtLBsr6nMFgh3LDoaqMYcASiC23w7ap5tcpQgTSIG CWzJoa73SR2QSjPNaAkgvbnaebC48EppuQtDjkD4ndhVZV9YhdIN5H7g0Roaxi5Ue3yxdO 4dn1hWtppm+wLunrQdzUNAdpXoLH70TBctduZQhGEFGVwASkXMXrsRXyfwajxom1YPW1Rk sXjFQxgmuys9n5Csp8A81LBkaQ1NqNyD7AvTidmCThEhlWfZt8H75BPndSqaiDQW3Ix8cn CCouslzyWYbq/1phNHNHlWtqmZbH6co8HI/raZQQob1HzdvIpxkxU8DCpson/w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1764274572; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=NB8lNVlVx866NlYuKFKVYssR11yzsj6H5yWBfAIcIpM=; b=U1W3v8bJcB/6SO4B1macSUEtLtnwalm6nr4ZBUsHPohQmdb3f+v24rUEQv8e9s65tXO59R EEbzbf5dxWTCJd8+xQjKwtxY8/RRIGC831mNYyuXUEp/sKChw4oc7thrYEuuNc5TXiFuGM 4NIcg/GgtMLKeRhhJJCL839EOPNxQ/lVGJxzQLRHhzR04cPQEYC/MwyRMhCF6/BSTltENn DTFltjUkVmHxC+86x9xG/J+TSXs2QUh6I7Nbhq1wMhE2eapl6GtQEPlt76IsrRrcbWpKFK vw7t4H5ymSuO7NFC6gjJN8w0ouk/9JZQW0OvgxEYH9Q2NUDWabNfWZNfZquRzA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1764274572; a=rsa-sha256; cv=none; b=Z8nz7NRgfT9ecF9FT2a0l/H/TQD7WltRJWcqqFYAkkSHOh1m9h1tQ/lt6IZydV21UP6c6l O033cghhwjQDvp5DbhlAvTbGYxzEppWFPzGAJbOjD8RlHSGCJDgxftlVba5nsVix4r5jgR IBRFJhWftJMpdwCizuxj2FkOLNohdArX9oiwfe43VyCUYkFM18aMF2nhBbJ1s54lQdfP2d RRDeMVGBKzJDK1moZwscguGv9sAxQzvkTWFcnOct3w8n+b+tW054lBHL1cbY26YS/P57dK oY5ggpteIdy356UNw+pnZAIFlq3vXEgR1fu7YrurOo0nXarAEyAP8A87AA2oSg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4dHSP82m69zXH0 for ; Thu, 27 Nov 2025 20:16:12 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 286af by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Thu, 27 Nov 2025 20:16:12 +0000 To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Olivier Certner Subject: git: f4362d80cb - main - releases/15.0R/relnotes: Fix and expand paragraphs on ps(1) List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: olce X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: f4362d80cbcfa6a0b042090bd53a3693589ea7a6 Auto-Submitted: auto-generated Date: Thu, 27 Nov 2025 20:16:12 +0000 Message-Id: <6928b18c.286af.7f7516c2@gitrepo.freebsd.org> The branch main has been updated by olce: URL: https://cgit.FreeBSD.org/doc/commit/?id=f4362d80cbcfa6a0b042090bd53a3693589ea7a6 commit f4362d80cbcfa6a0b042090bd53a3693589ea7a6 Author: Olivier Certner AuthorDate: 2025-11-27 18:00:45 +0000 Commit: Olivier Certner CommitDate: 2025-11-27 18:21:09 +0000 releases/15.0R/relnotes: Fix and expand paragraphs on ps(1) Improve description of what was changed. Add missing description of the change on matching user's processes using the effective user ID under "Userland", and of the manual page revamp under "Man Pages". Remove paragraphs under "Man Pages" that in fact refer to commits to RELNOTES. These are not manual page changes, and instead the *content* of the commit should appear in the release notes. The relevant information has been added under "Userland". Re-order changes chronologically. Fix commit hashes (they pointed to MFC commits to stable/14). While here, in the change portions, fix punctuation around the commit links and "Sponsored by The FreeBSD Foundation" lines to match what I think was common practice in earlier release notes. Sponsored by: The FreeBSD Foundation --- website/content/en/releases/15.0R/relnotes.adoc | 68 ++++++++++++++----------- 1 file changed, 37 insertions(+), 31 deletions(-) diff --git a/website/content/en/releases/15.0R/relnotes.adoc b/website/content/en/releases/15.0R/relnotes.adoc index 72b816a0ac..3b49548334 100644 --- a/website/content/en/releases/15.0R/relnotes.adoc +++ b/website/content/en/releases/15.0R/relnotes.adoc @@ -414,22 +414,39 @@ gitref:7b9a772f9f64[repository=src] An option has been added to change the directory in man:env[1] which closely resembles the feature in the GNU version of env, although it does not support long options. gitref:08e8554c4a39[repository=src] (Sponsored by Klara, Inc.) -Fix `-U` flag of man:ps[1] to select processes by real user IDs. -This is what POSIX mandates for option `-U` and arguably the behavior that most users actually need in most cases. -Before, `-U` would select processes by their effective user IDs (which is the behavior mandated by POSIX for option `-u`). -gitref:a2132d91739d[repository=src]. -(Sponsored by The FreeBSD Foundation). - -Make '-O' more versatile and predictable for man:ps[1]. +man:ps[1]: Automatically remove canned displays' columns that contain same data as those of some explicitly-requested columns. +Before this change, if some user requested to add some "canned display" (options `-j`, `-l`, `-u` or `-v`), columns in it that were duplicates of explicitly-requested ones earlier on the command line were omitted, but this did not work the other way around, when a canned display appears before explicitly-requested columns. +Additionally, columns with different keywords but which are aliases to the same +keyword are now also considered holding the same data, in addition to columns having the same keyword. +gitref:cd768a840644[repository=src] +(Sponsored by The FreeBSD Foundation.) + +man:ps[1]: Make `-O` more versatile and predictable. The man:ps[1] display's list of columns is now first built without taking into account the `-O` options. In a second step, all columns passed via `-O` are finally inserted after the built-so-far display's first PID column (if it exists, else at start), in their order of appearance as arguments to the `-O` options. -gitref:1fc8cb547cd4[repository=src]. -(Sponsored by The FreeBSD Foundation). - -Remove not-explicitly-requested columns with duplicate data in man:ps[1]. -Before this change, when stacking up more columns in the display through command-line options, if user requested to add some "canned" display (through options `-j`, `-l`, `-u` or `-v`), columns in it that were "duplicates" of already requested ones (meaning that they share the same keyword, regardless of whether their headers have been customized) were in the end omitted. -gitref:7aa2f4826717[repository=src]. -(Sponsored by The FreeBSD Foundation). +gitref:5dad61d9b949[repository=src] +(Sponsored by The FreeBSD Foundation.) + +man:ps[1]: Make `-a` and `-A` always show all processes. +When combined with other options affecting the selection of processes, except for `-X` and `-x`, option `-a` would have no effect (and `-A` would reduce to just `-x`). +This was in contradiction with the rule applying to all other selection options stating that one process is listed as soon as any of these options has been specified and selects it, which is both mandated by POSIX and arguably a natural expectation. +As a practical consequence, specifying `-a` or `-A` now causes all processes to be listed regardless of other selection options such as `-U`, `-p`, `-G`, etc., except for the `-X` and `-x` filter options, which continue to 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 only `-a` due to the bug. +gitref:93a94ce731a8[repository=src] +(Sponsored by The FreeBSD Foundation.) + +man:ps[1]: Match current user's processes using the effective user ID. +Previously, we would match using the real user ID. +This puts man:ps[1] in conformance with POSIX on that topic. +gitref:1aabbb25c9f9c4372[repository=src] +(Sponsored by The FreeBSD Foundation.) + +man:ps[1]: Fix `-U` flag to select processes by real user IDs. +This is what POSIX mandates for option `-U` and arguably the behavior that most users actually need in most cases. +Before, `-U` would select processes by their effective user IDs (which is the behavior mandated by POSIX for option `-u`). +gitref:995b690d1398[repository=src] +(Sponsored by The FreeBSD Foundation.) Add flags to filter jail prison and vnet variables in man:sysctl[8] output. So users do not have to contact the source code to tell whether a variable is a jail prison / vnet one or not. @@ -986,23 +1003,12 @@ gitref:39f92a4c4c49[repository=src] Refer to man:graid[8] and man:zfs[8] instead of man:gvinum[8] in man:ccdconfig[8]). (gitref:55cb3a33d920[repository=src]). -man:ps[1]: Document change in behavior for `-a`/`-A`. -Document the practical consequence of change gitref:93a94ce731a8[repository=src] 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). -gitref:eed005b57895[repository=src]. -(Sponsored by The FreeBSD Foundation). - -man:ps[1]: Change in behavior for option `-U`. -gitref:4e4739dd0745[repository=src] -(Sponsored by The FreeBSD Foundation). - -man:ps[1]: Change of how current user's processes are matched. -gitref:7219648f60d1[repository=src]. -(Sponsored by The FreeBSD Foundation). - -man:ps[1]: Match current user's processes using effective UID. -This puts man:ps[1] of FreeBSD in conformance with POSIX. -gitref:1e8dc267ca91[repository=src]. -(Sponsored by The FreeBSD Foundation). +man:ps[1]: Revamp: Explain general principles, update to match reality. +The preamble has been revamped to give a thorough overview of the different aspects of the man:ps[1] command. +The description of several options and some keywords have been fixed to match their actual behavior or expanded. +The STANDARDS and BUGS sections have been expanded. +gitref:ddf144a04b53[repository=src] +(Sponsored by The FreeBSD Foundation.) man:mac_do[4]: Change of rules syntax; Provide hints and pointers. gitref:0c3357dfa18f[repository=src].