From nobody Wed Feb 18 09:51:44 2026 X-Original-To: dev-commits-src-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 4fGBcK3x88z6RsYb for ; Wed, 18 Feb 2026 09:51:45 +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" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4fGBcK16Snz3KCb for ; Wed, 18 Feb 2026 09:51:45 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1771408305; 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=KBzrl2kylABTKUaQnX3CGRIrHpzZnpIq6+0Ej//ffcE=; b=QL/E6fyTUI0fpz5JXgUJagfNZLkqxcYBoGpaCRti8nD1OVMYtb17ij3Rh/G1H76YKo7s7Y WXzA0MLg5LUr2UzFSWk1GCOlcjtCdY9fohDYhOJLKDX7jxN2LFuorYZD55ojfYEtK9gS7v YSmvjywaXRGIH++NZ1aKYlY7Yx+Q0tTUXvvtlD1XDma1Ia0V+zxUJgz4Bkg0h6/mW9d1d2 VOVrk2X0stkPI2ElvROqFmHTVSBcKirFSRz93eAbDz8a5Js6klxramMzeT8CILtYE9t0tS cCIjhibs0sXPiDxXe4WagND9x8Vzi0F2o3dyz1tYCPtaJbyE/Hy5/+Gff5PyRg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1771408305; a=rsa-sha256; cv=none; b=f66TH2guGiRjN4Lvg/6zfIqiWKVnSN6fMleOoSiLBxAUSDEVeo/KTIuF7t7vczLP8P5voM iiEeIFg+pwh9vLAkPrsZh4SoBKdI6T26bP4KKH/4hEiLWYRJ9u8d3n/1pfPbmxeA+KUQTB xj+IbzLBUbddyhMkIZ1JHlZKzzJRyvOKLO1LPEsodIT9KYxF3elExNbM6xnDQZkc5jNA3+ 6rYH34DOYtdsVEbeMGp7fNEojR7Uc1rZkuRSABdvM4GF4/0AIhFEDoGHUp+wX6iTd+a6Kj ia+QlwpbV9NmIIzIkYv6nCathWvgPAnXjHSIAMVGKYsuZJA1vXZdThgf0aA/pQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1771408305; 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=KBzrl2kylABTKUaQnX3CGRIrHpzZnpIq6+0Ej//ffcE=; b=sUNaXZA4hRWtzEXXtLLP2xOepAOG94pRO8CKXepghCE+tEj64Y34tHHy/vCk2eYV0/uj2G BkTrijsBlO0Xarc7hNxmYXsTIXp77V7PhF/bbBstWWeUfz4RY8flEQ0zhBpQnYjOSEcfcm eqcL4mHrFqyx4L4gjdmEwlLLxO22PxSfyFBN2EJxZqDkr/IHzLtkCWJ+SVThAxFxAlt+jP Lyg7shRf8qcF2eDWNuXZBehek1ObxhX4zxOIakDWQs1X7d837F97iVWjw/J6+sntcHOm6n OOxszMh0pPvPahdKXOgusgGYCoIO07G/bSCBC+FSY8qlEkjk8iLf8jtyRKJscg== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4fGBcJ70DPzrNt for ; Wed, 18 Feb 2026 09:51:44 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 2163b by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Wed, 18 Feb 2026 09:51:44 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Dmitry Morozovsky Subject: git: 4c66fafd6b29 - stable/13 - pw: make manual page more friendly for uid/gid search List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: marck X-Git-Repository: src X-Git-Refname: refs/heads/stable/13 X-Git-Reftype: branch X-Git-Commit: 4c66fafd6b29e306184ff3bd1bcd6c8f4a29f11c Auto-Submitted: auto-generated Date: Wed, 18 Feb 2026 09:51:44 +0000 Message-Id: <69958bb0.2163b.6f8a7e08@gitrepo.freebsd.org> The branch stable/13 has been updated by marck: URL: https://cgit.FreeBSD.org/src/commit/?id=4c66fafd6b29e306184ff3bd1bcd6c8f4a29f11c commit 4c66fafd6b29e306184ff3bd1bcd6c8f4a29f11c Author: Dmitry Morozovsky AuthorDate: 2026-02-11 19:34:00 +0000 Commit: Dmitry Morozovsky CommitDate: 2026-02-18 09:50:59 +0000 pw: make manual page more friendly for uid/gid search pw.8 structure is quite different from usual manual page, especially in describing -o option usage. Specifically, these paragraphs do not contain "uid/gid" terms, and have "user id"/"group id" instead, making searching for "override duplicate safety belt" difficult. Try to simplify such searches. Also, clarify uid/gid space between 100 and 1000 as "somewhat special", as it actually is. Discussed on: russian telegram FreeBSD group Reviewed by: eugen, novel MFC after: 1 week (cherry picked from commit e89454417b2bfecce9daee10dece2f49632640d3) --- usr.sbin/pw/pw.8 | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/usr.sbin/pw/pw.8 b/usr.sbin/pw/pw.8 index 5ba35c193811..9bbb05ae0082 100644 --- a/usr.sbin/pw/pw.8 +++ b/usr.sbin/pw/pw.8 @@ -22,7 +22,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd November 28, 2022 +.Dd February 11, 2026 .Dt PW 8 .Os .Sh NAME @@ -551,8 +551,8 @@ It is possible to use to create a new account that duplicates an existing user id. While this is normally considered an error and will be rejected, the .Fl o -option overrides the check for duplicates and allows the duplication of -the user id. +option overrides the check for uniqueness and allows the duplication of +the uid. This may be useful if you allow the same user to login under different contexts (different group allocations, different home directory, different shell) while providing basically the same @@ -665,6 +665,9 @@ In general, user and group ids less than 100 are reserved for use by the system, and numbers greater than 32000 may also be reserved for special purposes .Pq used by some system daemons . +Also, uids and gids between 100 and 999 are commonly used by pseudo-users +assotiated with third-party programs, and generally should be avoided for +assigning for normal users. .It Fl w Ar passmethod The .Fl w @@ -864,7 +867,7 @@ also has a option that allows allocation of an existing group id to a new group. The default action is to reject an attempt to add a group, and this option overrides the check for duplicate group ids. -There is rarely any need to duplicate a group id. +There is rarely any need to duplicate a gid. .Pp The .Cm groupmod