NFSD(8) Maintenance Commands and Procedures NFSD(8)

NAME

nfsd - NFS daemon

SYNOPSIS

/usr/lib/nfs/nfsd [-a] [-c max_conn] [-l listen_backlog] [-p protocol]
[-t device] [nservers]

DESCRIPTION

nfsd is the daemon that handles client file system requests. Only users
with {PRIV_SYS_NFS} and sufficient privileges to write to /var/run can run
this daemon.

The nfsd daemon is automatically invoked using share(8) with the -a option.

By default, nfsd starts over the TCP and UDP transports for versions 2 and
3. By default, it starts over the TCP for version 4. You can change this
with the -p option.

A previously invoked nfsd daemon started with or without options must be
stopped before invoking another nfsd command.

See nfs(5) for available configuration properties for nfsd.

Options

The following options are supported:

-a Start a NFS daemon over all available connectionless and
connection-oriented transports, including UDP and TCP. Equivalent
of setting the protocol property to all.

-c max_conn
Set the maximum number of connections allowed to the NFS server
over connection-oriented transports. By default, the number of
connections is unlimited. Equivalent of the max_connections
property.

-l Set connection queue length for the NFS server over a connection-
oriented transport. The default value is 32 entries. Equivalent
of the listen_backlog property.

-p protocol
Start a NFS daemon over the specified protocol. Equivalent of the
protocol property.

-t device
Start a NFS daemon for the transport specified by the given device.
Equivalent of the device property.

Operands

The following operands are supported:

nservers
This sets the maximum number of concurrent NFS requests that the
server can handle. This concurrency is achieved by up to nservers
threads created as needed in the kernel. nservers should be based
on the load expected on this server. 16 is the usual number of
nservers. If nservers is not specified, the maximum number of
concurrent NFS requests will default to 1. Equivalent of the
servers property.

Usage

If the nfs_portmon variable is set to non-zero value in /etc/system, then
clients are required to use privileged ports (ports < IPPORT_RESERVED) to
get NFS services. This variable is equal to zero by default. This
variable has been moved from the "nfs" module to the "nfssrv" module. To
set the variable, edit the /etc/system file and add this entry:

set nfssrv:nfs_portmon = 1

FILES

.nfsXXX
Client machine pointer to an open-but-unlinked file.

/etc/system
System configuration information file.

/var/nfs/v4_state
/var/nfs/v4_oldstate
Directories used by the server to manage client state information.
These directories should not be removed.

EXIT STATUS

0 Daemon started successfully.

1 Daemon failed to start.

SEE ALSO

svcs(1), nfs(5), sharetab(5), system(5), attributes(7), smf(7), zones(7),
mountd(8), share(8), sharectl(8), sharemgr(8), svcadm(8)

NOTES

Manually starting and restarting nfsd is not recommended. If it is
necessary to do so, use svcadm to enable or disable the nfs service
(svc:/network/nfs/server). If it is disabled, it will be enabled by
share_nfs(8), unless its application/auto_enable property is set to false.
See smf(7) and svcadm(8) for more information.

The nfsd service is managed by the service management facility, smf(7),
under the service identifier:

svc:/network/nfs/server

Administrative actions on this service, such as enabling, disabling, or
requesting restart, can be performed using svcadm(8). The service's status
can be queried using the svcs(1) command.

If nfsd is killed with SIGTERM, it will not be restarted by the service
management facility. Instead, nfsd can be restarted by other signals, such
as SIGINT.

NFS service, which includes nfsd, can run inside a non-global zone. See
the discussion under ZONES in nfs(5) for more information.

illumos February 4, 2020 illumos