From nobody Mon Dec 16 14:45:26 2024 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 4YBjRB6Pzcz5hWSW; Mon, 16 Dec 2024 14:45:26 +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 "R10" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4YBjRB23HVz4cjd; Mon, 16 Dec 2024 14:45:26 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1734360326; 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=Amatx3kXvWn7xRz+LnnPZUmZNst6ohzRkObhmeSmqWk=; b=cm/pw4qPg1SifXa9R9If8n00xUhP2vHsta0cfqTsJUwbcXgjOmudxV6dSgx9CmSrRvIKkn qf8SfDW3ocEc1UZ8yXnL/GsMq9R5x37iTldYeq82WiFLtzi0UURUSjXq9eb0v04TCYSPy9 c0TuHgGHaaAZ5ZtiZ3txsjN/aDqEmAWvnXay9TE1/uLJA1a7msWCidco6bizZXTUBTyG/8 lpE3Am3n+1U1NaF/ra1gOLym2kh3J4Vr04RhsJLj7begfJUTKFwO7wk6ZdpQZ4HSnvuUG2 TVMTNrJN9MR6jGPNElK287bdeNoaoP9J20lzeI17lebN+ZRsMD6lZj7y0PhDTQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1734360326; 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=Amatx3kXvWn7xRz+LnnPZUmZNst6ohzRkObhmeSmqWk=; b=QZDI8RkS4ofiTQleNZZn/YpMW7MASCsy9i7WTx6D4IQn3YVa1q2hJZv23PhnD8t8irYJD+ UCzNL0yfKbe1rqho1Oly/wXMiYv+npYzpwqZP4fuV1NQtHnWoET5ioOjhMEmDRpGRlX+PD iM2u9OSYpeysbfH+oz1LtRV/tafPQdzj5txByrZvvY6UH+n0CdptzLUeuCz4dfBm14nTIN smYmDymrk8wgGTn3T0ts3Evtt2GKFsgl3+HNEaAtnSoBTmfPlvfmaVMWemfhIJ2ICIZrWc FWWCZJBC2aIVlLwywRPQFMUYRgYSMvB2uJoxvrBsYCCvyqox8cc1ZbHzhRkJ9Q== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1734360326; a=rsa-sha256; cv=none; b=IBKGwwtTvp1wjWPjcyqn6gTK3vbf8p1m5YYTXdTX/PQktvLXKUxERaiKQeAyY2i/cF0SZI 1IB7thyqvFRb3enyglfuZxRXaXzOiluW7IlbejhF8+xuE84LicImKcGuZvUdJVwEVWQ/63 Km3bNjZvbOVZmfOtU2pblor0kP+s8z59ZSiBWv1zqOV1qt04GSE+y6DErdKs6VA9ZC4MMb 78vmvhSrjjf3CYrnPSe3Xpyw7FBOGVsAHhwamr1VGsgwOod8oc9xL2lXo8bt2wVHuTjWe8 X8U5Uyj+lKho0DMn5/0q/iC3Yv6u9NDvlDeaCwoUhMAhRnbQlTc2aqI7mWviFw== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4YBjRB1cjGzxH6; Mon, 16 Dec 2024 14:45:26 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 4BGEjQ4P051951; Mon, 16 Dec 2024 14:45:26 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 4BGEjQsi051948; Mon, 16 Dec 2024 14:45:26 GMT (envelope-from git) Date: Mon, 16 Dec 2024 14:45:26 GMT Message-Id: <202412161445.4BGEjQsi051948@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Olivier Certner Subject: git: 2ef608de9062 - main - exports(5): -maproot, -mapall: Explain the fallback on no group 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: olce X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 2ef608de90629df37c29043afc638f8ff99ecfc4 Auto-Submitted: auto-generated The branch main has been updated by olce: URL: https://cgit.FreeBSD.org/src/commit/?id=2ef608de90629df37c29043afc638f8ff99ecfc4 commit 2ef608de90629df37c29043afc638f8ff99ecfc4 Author: Olivier Certner AuthorDate: 2024-10-08 09:34:44 +0000 Commit: Olivier Certner CommitDate: 2024-12-16 14:42:30 +0000 exports(5): -maproot, -mapall: Explain the fallback on no group Reviewed by: rmacklem (older version) Approved by: markj (mentor) MFC after: 2 weeks Sponsored by: The FreeBSD Foundation Differential Revision: https://reviews.freebsd.org/D47012 --- usr.sbin/mountd/exports.5 | 21 ++++++++++++++++++--- 1 file changed, 18 insertions(+), 3 deletions(-) diff --git a/usr.sbin/mountd/exports.5 b/usr.sbin/mountd/exports.5 index ee3e9a89f114..6436e586cab9 100644 --- a/usr.sbin/mountd/exports.5 +++ b/usr.sbin/mountd/exports.5 @@ -25,7 +25,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd April 16, 2024 +.Dd October 08, 2024 .Dt EXPORTS 5 .Os .Sh NAME @@ -170,8 +170,23 @@ The user string may be quoted, or use backslash escaping. The colon separated list is used to specify the precise credential to be used for remote access by root. The elements of the list may be either names or numbers. -Note that user: should be used to distinguish a credential containing -no groups from a complete credential for that user. +Note that +.Cm user: +should be used to specify a credential containing no groups, in which case the +established credential will use +.Ql nogroup , +else 65533 +.Pq Dv GID_NOGROUP , +as the fallback group +.Pq a credential object must have at least one group internally . +Using just +.Cm user +.Pq without colon at end +falls into the +.Sm off +.Fl maproot Li = Sy user +.Sm on +case described above. The group names may be quoted, or use backslash escaping. .Pp .Sm off