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