git: 922e78f65fd9 - main - mountd: Update exports.5 for commit 7c5146da1286

From: Rick Macklem <rmacklem_at_FreeBSD.org>
Date: Fri, 22 Dec 2023 20:19:03 UTC
The branch main has been updated by rmacklem:

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

commit 922e78f65fd9a58db9e52d84290ed7c187b09278
Author:     Rick Macklem <rmacklem@FreeBSD.org>
AuthorDate: 2023-12-22 20:17:36 +0000
Commit:     Rick Macklem <rmacklem@FreeBSD.org>
CommitDate: 2023-12-22 20:17:36 +0000

    mountd: Update exports.5 for commit 7c5146da1286
    
    Commit 7c5146da1286 modified mountd so that it uses
    strunvis(3) to decode directory names in exports lines.
    This allows special characters, such as blanks, to be
    encoded in the directory names.
    
    This patch updates the exports.5 man page for this change.
    
    This is a content change.
    
    Reviewed by:    karels, pauamma_gundo.com (manpages)
    MFC after:      1 week
    Differential Revision:  https://reviews.freebsd.org/D42163
---
 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 deae95dd6831..8b55162cdcbb 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 August 16, 2022
+.Dd December 21, 2023
 .Dt EXPORTS 5
 .Os
 .Sh NAME
@@ -106,6 +106,17 @@ any
 or
 .Dq Pa ..
 components.
+Pathnames are decoded by
+.Xr strunvis 3
+allowing special characters to be included in the directory name(s).
+In particular, whitespace, such as embedded blanks in directory names
+can be handled.
+For example, a blank can be encoded as \(rs040.
+.Xr vis 1
+with the
+.Fl M
+option may be used to encode directory name(s) with embedded special
+characters.
 Mount points for a file system may appear on multiple lines each with
 different sets of hosts and export options.
 .Pp
@@ -582,6 +593,8 @@ NFSv4 mount request for a directory that the client does not have
 permission for will succeed and read/write access will fail
 afterwards, whereas NFSv3 rejects the mount request.
 .Sh SEE ALSO
+.Xr vis 1 ,
+.Xr strunvis 3 ,
 .Xr nfsv4 4 ,
 .Xr netgroup 5 ,
 .Xr mountd 8 ,