diff --git a/usr.sbin/nfsd/nfsd.8.sav b/usr.sbin/nfsd/nfsd.8 --- a/usr.sbin/nfsd/nfsd.8.sav +++ 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,13 +46,52 @@ .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. .Pp 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 +nfs_server_enable="YES" +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 kerberos mounts or +run nfsuserd (but choose one, not both of these). +Setting vfs.nfs.enable_uidtostring and vfs.nfsd.enable_stringtouid +to one and not running the nfsuserd chooses uids in +.Dq strings . +.It +Set nfsv4_server_enable="YES" in +.Xr rc.conf 5 +or set nfsv4_server_only="YES" in +.Xr rc.conf 5 +if you do not want NFSv3 to be served. +.El +.sp .Pp When .Nm @@ -336,6 +375,7 @@ .Xr pnfs 4 , .Xr pnfsserver 4 , .Xr exports 5 , +.Xr rc.conf 5 , .Xr stablerestart 5 , .Xr gssd 8 , .Xr ipfw 8 ,