Page MenuHomeFreeBSD

D54279.diff
No OneTemporary

D54279.diff

diff --git a/usr.sbin/nfsd/nfsd.8 b/usr.sbin/nfsd/nfsd.8
--- a/usr.sbin/nfsd/nfsd.8
+++ b/usr.sbin/nfsd/nfsd.8
@@ -25,7 +25,7 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd May 30, 2025
+.Dd December 23, 2025
.Dt NFSD 8
.Os
.Sh NAME
@@ -46,7 +46,7 @@
.Sh DESCRIPTION
The
.Nm
-utility runs on a server machine to service NFS requests from client machines.
+utility runs on a server machine to service NFSv4 and/or NFSv3 requests from client machines.
At least one
.Nm
must be running for a machine to operate as a server.
@@ -54,6 +54,62 @@
Unless otherwise specified, eight servers per CPU for UDP transport are
started.
.Pp
+The
+.Nm
+server may be configured to serve NFSv3, NFSv4 or both of them.
+When
+.Bd
+nfs_server_enable="YES"
+.Ed
+is set in
+.Xr rc.conf 5 ,
+.Nm
+is configured for NFSv3 only, by default.
+To configure the
+.Nm
+to serve NFSv4, you must also:
+.sp
+.Bl -bullet -compact
+.It
+Add a
+.Dq V4:
+line to
+.Xr exports 5 .
+(This is needed as well as either the ZFS sharenfs property
+or an exports line for each exported file system.)
+.It
+Either choose to do uids in
+.Dq strings ,
+which is probably
+the easiest unless you are doing
+.Xr kerberos 7
+mounts or
+run
+.Xr nfsuserd 8
+.Pq choose one, not both of these .
+Setting the sysctls MIBs
+.Va vfs.nfs.enable_uidtostring
+and
+.Va vfs.nfsd.enable_stringtouid
+to one and not running the nfsuserd chooses uids in
+.Dq strings .
+.It
+Set
+.Bd
+nfsv4_server_enable="YES"
+.Ed
+in
+.Xr rc.conf 5
+or set
+.Bd
+nfsv4_server_only="YES"
+.Ed
+in
+.Xr rc.conf 5
+if you do not want NFSv3 to be served.
+.El
+.sp
+.Pp
When
.Nm
is run in an appropriately configured vnet jail, the server is restricted
@@ -336,7 +392,9 @@
.Xr pnfs 4 ,
.Xr pnfsserver 4 ,
.Xr exports 5 ,
+.Xr rc.conf 5 ,
.Xr stablerestart 5 ,
+.Xr kerberos 7 ,
.Xr gssd 8 ,
.Xr ipfw 8 ,
.Xr jail 8 ,

File Metadata

Mime Type
text/plain
Expires
Tue, Dec 30, 2:07 PM (10 m, 10 s)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
27252024
Default Alt Text
D54279.diff (1 KB)

Event Timeline