git: 9432e798fc6d - main - mountd.8: Update for mountd running in jails

From: Rick Macklem <rmacklem_at_FreeBSD.org>
Date: Mon, 20 Mar 2023 22:17:17 UTC
The branch main has been updated by rmacklem:

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

commit 9432e798fc6daaad341a496e9abcf9e3b760a63b
Author:     Rick Macklem <rmacklem@FreeBSD.org>
AuthorDate: 2023-03-20 22:16:03 +0000
Commit:     Rick Macklem <rmacklem@FreeBSD.org>
CommitDate: 2023-03-20 22:16:03 +0000

    mountd.8: Update for mountd running in jails
    
    Mountd can now be run in an appropriately
    configured vnet jail.
    
    This man page update adds some information
    for this case.
    
    This is a content change.
    
    Reviewed by:    markj
    MFC after:      3 months
    Differential Revision:  https://reviews.freebsd.org/D39168
---
 usr.sbin/mountd/mountd.8 | 29 +++++++++++++++++++++++++++--
 1 file changed, 27 insertions(+), 2 deletions(-)

diff --git a/usr.sbin/mountd/mountd.8 b/usr.sbin/mountd/mountd.8
index 128b305cb5d9..207b50e3501d 100644
--- a/usr.sbin/mountd/mountd.8
+++ b/usr.sbin/mountd/mountd.8
@@ -28,7 +28,7 @@
 .\"     @(#)mountd.8	8.4 (Berkeley) 4/28/95
 .\" $FreeBSD$
 .\"
-.Dd October 11, 2020
+.Dd March 18, 2023
 .Dt MOUNTD 8
 .Os
 .Sh NAME
@@ -158,7 +158,7 @@ When
 is started,
 it loads the export host addresses and options into the kernel
 using the
-.Xr mount 2
+.Xr nmount 2
 system call.
 After changing the exports file,
 a hangup signal should be sent to the
@@ -172,6 +172,20 @@ check the syslog output to see if
 logged any parsing
 errors in the exports file.
 .Pp
+If multiple instances of
+.Nm
+are being run, either in multiple jails or both within
+and outside of a jail, care must be taken to export
+any given file system in only one of the instances.
+Note that the
+.Va allow.nfsd
+jail parameter is required to allow
+.Nm
+to run in a jail.
+See
+.Xr jail 8
+for more information.
+.Pp
 If
 .Nm
 detects that the running kernel does not include
@@ -185,6 +199,15 @@ If this fails, or no
 KLD was available,
 .Nm
 exits with an error.
+When run in a jail, the
+.Xr kldload 2
+must be done outside the jail, typically by adding
+.Dq nfsd
+to
+.Va kld_list
+in the
+.Xr rc.conf 5
+file on the jail host.
 .Sh FILES
 .Bl -tag -width /var/run/mountd.pid -compact
 .It Pa /etc/exports
@@ -199,6 +222,8 @@ the current list of remote mounted file systems
 .Xr kldload 2 ,
 .Xr nfsv4 4 ,
 .Xr exports 5 ,
+.Xr rc.conf 5 ,
+.Xr jail 8 ,
 .Xr nfsd 8 ,
 .Xr rpcbind 8 ,
 .Xr showmount 8