Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 9 Sep 2025 00:55:19 GMT
From:      Rick Macklem <rmacklem@FreeBSD.org>
To:        src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org
Subject:   git: caf162412dbc - stable/14 - exports.5: Add a paragraph clarifying the use of "V4:"
Message-ID:  <202509090055.5890tJW4047469@gitrepo.freebsd.org>

next in thread | raw e-mail | index | archive | help
The branch stable/14 has been updated by rmacklem:

URL: https://cgit.FreeBSD.org/src/commit/?id=caf162412dbc74e71ca2ac02e2a8a96e5e086f47

commit caf162412dbc74e71ca2ac02e2a8a96e5e086f47
Author:     Rick Macklem <rmacklem@FreeBSD.org>
AuthorDate: 2025-08-26 01:38:54 +0000
Commit:     Rick Macklem <rmacklem@FreeBSD.org>
CommitDate: 2025-09-09 00:52:16 +0000

    exports.5: Add a paragraph clarifying the use of "V4:"
    
    The exports.5 man page is a bit of a monster.
    One place of common confusion is the use of
    the "V4:" line(s) for defining the location of the
    root of the NFSv4 export subtree.
    
    This patch adds a paragraph in an attempt to
    clarify this.
    
    This is a content change.
    
    (cherry picked from commit 200730f29dbc8da2aa9392b35518bf77b8899f89)
---
 usr.sbin/mountd/exports.5 | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/usr.sbin/mountd/exports.5 b/usr.sbin/mountd/exports.5
index b8f0e93aec8a..4c8e90635cb2 100644
--- a/usr.sbin/mountd/exports.5
+++ b/usr.sbin/mountd/exports.5
@@ -27,7 +27,7 @@
 .\"
 .\"     @(#)exports.5	8.3 (Berkeley) 3/29/95
 .\"
-.Dd December 16, 2024
+.Dd August 24, 2025
 .Dt EXPORTS 5
 .Os
 .Sh NAME
@@ -150,6 +150,19 @@ characters.
 Mount points for a file system may appear on multiple lines each with
 different sets of hosts and export options.
 .Pp
+Note that, for NFSv4 exporting, there must be both one or more ``V4:'' line(s)
+and one or more line(s) exporting the file systems that are to be
+exported to NFSv4 clients.
+If there are multiple ``V4:'' lines, these lines must all specify the
+same root directory path, but with different options for different
+clients.
+These line(s) do not export any file system, but simply define the
+location of the ``root'' of the NFSv4 export subtree.
+The line(s) exporting the file systems should always
+specify the pathname of the root of a server file system
+and must include at least one line exporting the file system
+which is specified as the ``root'' by the ``V4:'' line(s).
+.Pp
 The second component of a line specifies how the file system is to be
 exported to the host set.
 The option flags specify whether the file system



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202509090055.5890tJW4047469>