From nobody Wed Feb 18 16:29:06 2026 X-Original-To: dev-commits-src-branches@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 4fGMQq0nsFz6SRM5 for ; Wed, 18 Feb 2026 16:29:07 +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 4fGMQq0Bc7z3GHs for ; Wed, 18 Feb 2026 16:29:07 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1771432147; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=rUGU0ozR1V6g5NNAbkp7ob4b0NqJNkd/s/yx0lLBRqk=; b=HXes4XTsqDcJvIpPGlYvojyuPw/2St/lDjHEwQPA1F4jdm2w9NPHuLsunxRb41sBxgGWHH tVqGCsUjuI9dmjZnWUin5HrKJ4cBj0r5OqOTsYC/ERqa/prRpN7yyEcMn8fHBRiNBABuD3 nwmmWekq6X2Jvx4DCWeQjAIHlf8Vp/sVLAIEt4zYe/YGUiTD1gEMfCGLHheUcJu6MazPoj s2GuyFwjAVhQhOwXEbwR24IHSjjfNiAJFAKIweh9mvu1Ph+oiyRyDjPmSNhgAZdECBWFEg MUL2iqrB4nCB2D63MwJ63e+MGfBO9nbq/1YvSmjK/aocYjO9yluE8G28sWN/nw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1771432147; a=rsa-sha256; cv=none; b=B4U01yjbb9L0dkKLr7Wcgf5HrhX/0Zqt/f+IXXYQGk6xUTdozjBl+UWZ0RU3kcX2HxdD86 5YYjkLCSDBTDMoOn784inWeV+lPak5AZ22LLj7rHZCcKgjBzY8ns/hg0wrShx1oq/IUrxw 0O1d2E+MQbUdKgUU7cuBeliw/ZgLwbcA/BIDiLnR67lqS132xZC4qnNfkW4OsTRx92RWiK bPV2cWJvyvYFWw6WU7Wj/VJirDDGct8OffB5YBvmrjrnilSzpwxjGj+f9blH57hlO1OxYp jxtP49h/cbwrXSgYdF2wiZ6NMn9c5dVSBQLmohYfK0A53wod1ASDWpYEh4CAcw== 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=1771432147; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=rUGU0ozR1V6g5NNAbkp7ob4b0NqJNkd/s/yx0lLBRqk=; b=laf5SqFJeoRpHN2lM8uIwA00fmoNkzBOOBIH9j9qibuxYYHPdbhOyYwHbUEhW6YH5fv3x6 UFQayZY0NlfTw32/HrhUoc8tE52yZwTybp9UwkElgd2IUd9dXgB/jacMtwSU7YzFHHN8Ch QNbAzShljP42uo6slzek18Ux61uLhBi97UzhrRhS8jKdBjWLU4HDqnQeW/xwSLI+d21iCK GgKYZdJVJpsWFIxqNr4RJpI/oKkfVyJ980M+j2u6RgW9vmPUdmlkAsnK8082B//HkoGXla /t+1yAvXn+Hl9L6qfQTNRk8c0TTIHBJP2EVm29oZK+Z8zTT1OHw//9chi/vrfw== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4fGMQp6bfqz138b for ; Wed, 18 Feb 2026 16:29:06 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 3174a by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Wed, 18 Feb 2026 16:29:06 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org Cc: Dmitry Morozovsky From: Colin Percival Subject: git: 7f1e9f945154 - releng/14.4 - pw: make manual page more friendly for uid/gid search List-Id: Commits to the stable branches of the FreeBSD src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-branches List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-branches@freebsd.org Sender: owner-dev-commits-src-branches@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: cperciva X-Git-Repository: src X-Git-Refname: refs/heads/releng/14.4 X-Git-Reftype: branch X-Git-Commit: 7f1e9f945154485f9f73bfb4ddb44ea231ae1cf0 Auto-Submitted: auto-generated Date: Wed, 18 Feb 2026 16:29:06 +0000 Message-Id: <6995e8d2.3174a.3bbe7d9b@gitrepo.freebsd.org> The branch releng/14.4 has been updated by cperciva: URL: https://cgit.FreeBSD.org/src/commit/?id=7f1e9f945154485f9f73bfb4ddb44ea231ae1cf0 commit 7f1e9f945154485f9f73bfb4ddb44ea231ae1cf0 Author: Dmitry Morozovsky AuthorDate: 2026-02-11 19:34:00 +0000 Commit: Colin Percival CommitDate: 2026-02-18 16:28:43 +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) (cherry picked from commit 8a2d04cf8c866ff3a6f358257d7aeeefbdd84455) --- 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 f6d9ebca6308..9b75ff772c25 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 August 19, 2025 +.Dd February 11, 2026 .Dt PW 8 .Os .Sh NAME @@ -572,8 +572,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 @@ -686,6 +686,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 @@ -886,7 +889,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