From nobody Sat Dec 28 21:52:05 2024 X-Original-To: dev-commits-src-main@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 4YLGKx4mgHz5jFxJ; Sat, 28 Dec 2024 21:52:05 +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 "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4YLGKx4Jnlz46xK; Sat, 28 Dec 2024 21:52:05 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1735422725; 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=pZW7gCr4fWO1cFZ6ONFtJbayD7EWxE0/OcHVvUlc1/I=; b=y2AuVkY0x2d0DrHFUI8ZwoHr802N4nNAFCpMEAUd3WsUCsMTtSh6ezJInhgtpYkYoc43Fx f028SAAi/kyc7ov5vF96bkmu3xUuNFjQt1k2+mGIPQh88kdhcwdjVaQJzdKqoxUI+H4X5O 2I7EM+nHjzL8y+Xhk8eFuuYR/DHHqGsRPUIMosYhGwQAVLRhlE3xJY3mYd4CpweBGHC1WQ kEV38kCZNlfGq3aaU05b338ITZIkY3AFN8KVUy1NTf0ArZnfFNWbkIuEIQhg1Uj4PmfWC/ QKdp30pMkpoSu1woFaakvAwIoci58l0VUl9a5AWV/uEohTf+3fNcKnjKOFGZnA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1735422725; 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=pZW7gCr4fWO1cFZ6ONFtJbayD7EWxE0/OcHVvUlc1/I=; b=R9VRNCNl6n544rCJEJW+7bPGIyq4vdt/0tDQqJQkQvGMcirwEOhOe4Hi/U00QNq2y8wmNl 6lONJ94dVILPpFeWcIZCJDITPapBvQdz1Ib1g9RiJCVpgBMXqK0epEiycSSx9dN5bjBMoI sl4/n6Fgj2DzoLoNlof5JGHZdFS3YIYDceRjEp+IaJG9i3TBukp/PBpzsXHOgshJLCSewa FPmGnqjdXglTxl7J8XHeTW6kh3TJm7Y7g0rL+GWeSTdzDtwJNc0Txjj5VVtOLIo2/36XLs sCFcMRSll3MLA9WtOT3GeZ+4H2Xud1QdR1DafcmTS9kqd05odfTd6jpE2d+u1g== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1735422725; a=rsa-sha256; cv=none; b=WA2StTHT95WE9vgmSaUKuPIzOPK7hnMS+jx5CgJGa0E+7COw+L4CMDSoPmUgUVR4/oNY4Q /jw/vEY9TsJSig01av46yNH7PhFyG3rKumxUWZRSfI5zh0ryizsfrfxrF6QWHRmti5QOrb TCgkmo6MnQSz9FuqBZxpUTpWjT0HsvHcKPTVNHLpbHpRyX2I3cQ2lBy8OSsEutGUESx95Y cYAxBx+Q+NRN9MmxKCIipZB0ck0yTNc3/34rGTuMLCB2bCQbM58qKc769PVx+TnvL+GOCd dZZM/YwTUT/izoH6fp7g2ZXPoxIh49IG8amzwjDT2f59suhQ7KLoCooOVYNVVA== 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 4YLGKx3bznzhw6; Sat, 28 Dec 2024 21:52:05 +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 4BSLq5e8074220; Sat, 28 Dec 2024 21:52:05 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 4BSLq5cM074217; Sat, 28 Dec 2024 21:52:05 GMT (envelope-from git) Date: Sat, 28 Dec 2024 21:52:05 GMT Message-Id: <202412282152.4BSLq5cM074217@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Rick Macklem Subject: git: 295934eaa92c - main - exports.5: Document the current behavior of -alldirs List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: rmacklem X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 295934eaa92cd917ae42a446899c0d527ad9c0c9 Auto-Submitted: auto-generated The branch main has been updated by rmacklem: URL: https://cgit.FreeBSD.org/src/commit/?id=295934eaa92cd917ae42a446899c0d527ad9c0c9 commit 295934eaa92cd917ae42a446899c0d527ad9c0c9 Author: Rick Macklem AuthorDate: 2024-12-28 21:51:08 +0000 Commit: Rick Macklem CommitDate: 2024-12-28 21:51:08 +0000 exports.5: Document the current behavior of -alldirs Commit 07cd69e272da adds a new "-a" mountd option, which changes the behavior of mountd when file systems are exported via -alldirs. This patch updates the man page to reflect the actual behavior when -alldirs is used when mountd is started with/without -a. Prior to the above commit, exports(5) documented that, when -alldirs was specified, the exports line would fail unless the directory was a server file system mount point. This behavior was only documented in the Examples section and has not been implemented since a change between FreeBSD 1 and FreeBSD 2 was done. This is a contents change. PR: 282995 Reviewed by: markj MFC after: 2 weeks Differential Revision: https://reviews.freebsd.org/D48139 --- usr.sbin/mountd/exports.5 | 23 +++++++++++++++++++---- 1 file changed, 19 insertions(+), 4 deletions(-) diff --git a/usr.sbin/mountd/exports.5 b/usr.sbin/mountd/exports.5 index 6436e586cab9..a90d81c4db99 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 October 08, 2024 +.Dd December 16, 2024 .Dt EXPORTS 5 .Os .Sh NAME @@ -84,6 +84,15 @@ to limit exported directories to server local file system mount points. When exporting ZFS datasets with the .Sy sharenfs property, this is auomatically the case. +If the +.Fl alldirs +flag is specified and +the +.Fl a +command line option is specified for +.Xr mountd 8 , +the export will fail if the directory path is not a local file system +mount point. .Pp There are three forms of the directory path specification. The first is to list all mount points as absolute @@ -550,12 +559,18 @@ will be exported read-only to the entire network 192.168.33.0/24, including all its subdirectories. Since .Pa /cdrom -is the conventional mountpoint for a CD-ROM device, this export will -fail if no CD-ROM medium is currently mounted there since that line +is the conventional mountpoint for a CD-ROM device, +for the case where the +.Fl a +option has been specified for +.Xr mountd 8 , +this export will +fail if no CD-ROM medium is currently mounted there +since that line would then attempt to export a subdirectory of the root file system with the .Fl alldirs -option which is not allowed. +option. The .Fl quiet option will then suppress the error message for this condition that