git: bda48373633c - stable/13 - exports.5: Add a paragraph clarifying the use of "V4:"

From: Rick Macklem <rmacklem_at_FreeBSD.org>
Date: Tue, 09 Sep 2025 01:01:59 UTC
The branch stable/13 has been updated by rmacklem:

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

commit bda48373633c4870f2963d62395fbb7a7ffa524a
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:59:06 +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 dfbc16c28639..b1ecf16cfc8c 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 October 08, 2024
+.Dd August 24, 2025
 .Dt EXPORTS 5
 .Os
 .Sh NAME
@@ -111,6 +111,19 @@ components.
 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