kgess-mirror/freebsd-src
1
0
Fork 0
mirror of https://git.freebsd.org/src.git synced 2026-01-11 19:57:22 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1

nfsd.8: Add a short paragraph w.r.t. NFSv3 vs NFSv4 setup
Some checks are pending
Cross-build Kernel / amd64 ubuntu-22.04 (clang-15) (push) Waiting to run
Details
Cross-build Kernel / aarch64 ubuntu-22.04 (clang-15) (push) Waiting to run
Details
Cross-build Kernel / amd64 ubuntu-24.04 (clang-18) (push) Waiting to run
Details
Cross-build Kernel / aarch64 ubuntu-24.04 (clang-18) (push) Waiting to run
Details
Cross-build Kernel / amd64 macos-latest (clang-18) (push) Waiting to run
Details
Cross-build Kernel / aarch64 macos-latest (clang-18) (push) Waiting to run
Details

Browse source 
The nfsd can be configured to support NFSv3, NFSv4 or both
of them.

This patch adds a short paragraph to nfsd.8 to explain this.

This is a content change.

Reviewed by:	kib, zaiee (manpages)
MFC after:	1 week
Differential Revision:	https://reviews.freebsd.org/D54279
This commit is contained in:
Rick Macklem 2025-12-24 08:29:29 -08:00
parent 160077a4d7
commit 4f184fd35d
1 changed files with 60 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

62
usr.sbin/nfsd/nfsd.8
View file

@ -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 @@ NFS server
.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 @@ must be running for a machine to operate as a server.
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 @@ just do a
.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 ,