From nobody Fri Apr 10 18:31:13 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 4fslkB0cw7z6Y9jT for ; Fri, 10 Apr 2026 18:31:14 +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 4fslk963Wqz42Pw for ; Fri, 10 Apr 2026 18:31:13 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1775845873; 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=i8VxNhNHOz7XEYBDx/sxyCjn6q5QynAHIwowcdlSJak=; b=t0AW5cfJG3H8/h6+2M2zjDeRqr6RAnmQt09zRe2iFhdedHlTf+asYRqWguuIlp1ialJVaF MX9N37h/P8yxyVjR1PO7vwK2uaBeQc0uYsTfDYFM/shpz8rg6yXjXnftvc8GitidB+JX/t M/tYjodK+zlb4WbwTsi2Cs7/ulngU918f3TicuUKLdgPyEA3+f5eKrnFQLHxOaam+A/1fq 5Qwkb3muPz95UmbWj3BlNVzURIvsjoqfr/+XOtC4dUx84VReA8kBC1FyWreGI4TPIvkb9k suEQ7DO4BR7MtKDXLd1ykTNFXVoStkk5XgTScHCbNe4Pned5w0Q9WJDyQShgww== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1775845873; a=rsa-sha256; cv=none; b=Prds2M9sFJMrvBW0cD/rHFenn1qeGmqdKgZH8MsngFUxyfDByjO4p8Jm6TR1Zaaun/JwsQ RQbt8zHFaqgd4gZ4tbbkAhlxY6p+0yL1Fu/K4I+VXTLy1nzk03vRu5/kzUJT/a8O//L2Hz IluoMC4eHB/4ZmJ3u64SvEiYQRKXqO7+wJhW9pV46f3mcW4b7gICnO2ItODdz+od4Qx3VM BYsFDPxTcZ9XtMHkdZrOspszJfvaByz2DeDaP3k0/0sxqb/g29WFgwAFdogxNqQSbK1KvZ nAiwaMn0CgxCavFuXo518Bi22aIypPE1iglG5Mmm0/WZWIhubQbvHlavBH9uRg== 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=1775845873; 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=i8VxNhNHOz7XEYBDx/sxyCjn6q5QynAHIwowcdlSJak=; b=DLwNQRQwXkcs9Dq23cAC/kMqKGkKJ7Xt2WplTdi8K80/hRIZsLJp2pWozBg0ki5qGFhkVL YkYjmP0DEE1DimD3V3R/3uwov3uvGTCEMCtfz2IVzrK0vocjbCQbR/GVZt+iaKtk5ReIsd 6+QOiJX0N8DOYybF/dnND5o0PbOtMZL49eVT+uP1/VtwVCqp2YNCuUjXNEr6S5gThHy2rp 7gzl4hIuXKfzmlQli9Da7N7GTjMcztGkexwiVv+BBoqF9hzfGnAEeRl/JO4UoR2kuyHOoh IzDiRLfA8Kn52jcfoMpAcPQ5xnFxWEw1XGyRpsxBVUpbsdXXqX9VX2P+DiwH9A== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4fslk95Rfbzw0t for ; Fri, 10 Apr 2026 18:31:13 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 39c0d by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Fri, 10 Apr 2026 18:31:13 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org Cc: Felix Johnson From: Alexander Ziaee Subject: git: 67f28803e0ec - stable/15 - newgrp.1: Provide examples 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: ziaee X-Git-Repository: src X-Git-Refname: refs/heads/stable/15 X-Git-Reftype: branch X-Git-Commit: 67f28803e0ec3ec93cb431bb6c0b3680a91d0849 Auto-Submitted: auto-generated Date: Fri, 10 Apr 2026 18:31:13 +0000 Message-Id: <69d941f1.39c0d.e85e05e@gitrepo.freebsd.org> The branch stable/15 has been updated by ziaee: URL: https://cgit.FreeBSD.org/src/commit/?id=67f28803e0ec3ec93cb431bb6c0b3680a91d0849 commit 67f28803e0ec3ec93cb431bb6c0b3680a91d0849 Author: Felix Johnson AuthorDate: 2026-02-27 00:45:03 +0000 Commit: Alexander Ziaee CommitDate: 2026-04-10 18:28:36 +0000 newgrp.1: Provide examples "These examples appear to be originally noted thirteen years ago by Mark Saad, contributed by eadler, put into a patch by Felix Johnson, and made into mdoc by myself. Finally, put this bug to rest." ~ziaee PR: 167742 Co-authored-by: eadler, ziaee, Mark Saad Differential Revision: https://reviews.freebsd.org/D48877 (cherry picked from commit 86dc5dd0b2a861cf9d8cad18fc17c17dbbfc4465) --- usr.bin/newgrp/newgrp.1 | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/usr.bin/newgrp/newgrp.1 b/usr.bin/newgrp/newgrp.1 index d9701feef0d7..032aeb72616d 100644 --- a/usr.bin/newgrp/newgrp.1 +++ b/usr.bin/newgrp/newgrp.1 @@ -22,7 +22,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd February 8, 2013 +.Dd February 6, 2025 .Dt NEWGRP 1 .Os .Sh NAME @@ -67,6 +67,21 @@ exits >0. Otherwise, the exit status of .Nm is the exit status of the shell. +.Sh EXAMPLES +Create a new group, +.Ar foo , +with +.Xr pw 8 : +.Pp +.Dl pw group add foo +.Pp +Set the group password: +.Pp +.Dl pw group mod foo -h 0 +.Pp +As a non-root user, switch to the group: +.Pp +.Dl newgrp foo .Sh SEE ALSO .Xr csh 1 , .Xr groups 1 ,