System Administration Commands nfsd(1M)
NAME
nfsd - NFS daemon
SYNOPSIS
/usr/lib/nfs/nfsd [-a] [-c #_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(1M)
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 forversion 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 com-
mand.To change startup parameters for nfsd, use the sharectl(1M)
and sharemgr(1M) commands. SMF ManagementThe nfsd service is managed by the service management facil-
ity, smf(5), 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(1M). 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 res-
tarted by other signals, such as SIGINT.SunOS 5.11 Last change: 20 Aug 2010 1
System Administration Commands nfsd(1M)
The sharectl(1M) command can be used to manage all theparameters related to nfsd. The following are the parameters
currently supported:server_versmax=num
server_versmin=num
The NFS server only uses NFS versions in the range specified by these variables. Valid values or versions are: 2, 3, and 4. As with the client, the default is to leave these variables commented out and the default minimum version is 2, while the default maximum version is 4.server_delegation=on | off
By default, this variable is on and the NFS server pro-
vides delegations to clients. The user can turn off delegations for all exported file systems by settingthis variable to off (case-sensitive). This variable
applies only to NFS Version 4.max_connections=num
Sets the maximum number of concurrent, connection-
oriented connections. The default is unlimited and isobtained by setting to -1. Equivalent to the -c option
in nfsd.
listen_backlog=num
Set connection queue length for the NFS over aconnection-oriented transport. The default value is 32,
meaning 32 entries in the queue. Equivalent to the -l
option in nfsd.
protocol=ALLStart nfsd over the specified protocol only. Equivalent
to the -p option in nfsd. ALL is equivalent to -a on the
nfsd command line. Mutually exclusive of NFS SMF parame-
ter device. One or the other of NFS SMF parameters dev-
ice and protocol must not be set. If both are set, the nfs/server service goes into maintenance mode. For the UDP protocol, only version 2 and version 3 service is established. NFS Version 4 is not supported for the UDPprotocol. Equivalent to the -p option.
SunOS 5.11 Last change: 20 Aug 2010 2
System Administration Commands nfsd(1M)
device=devname Start NFS daemon for the transport specified by thespecified device only. Equivalent to the -t option in
nfsd. Mutually exclusive of NFS SMF parameter protocol.
One or the other of NFS SMF parameters device and proto-
col must not be set. servers=num Maximum number of concurrent NFS requests. Equivalent tolast numeric argument on the nfsd command line. The
default is 16. Equivalent to the nservers operand.See EXAMPLES, below.
OPTIONS The following options are supported:-a Start an NFS daemon over all available con-
nectionless and connection-oriented tran-
sports, including UDP and TCP. Equivalent of setting the protocol parameter to ALL in the SMF for NFS using the sharectl(1M) command.-c #_conn This sets the maximum number of connections
allowed to the NFS server over connection-
oriented transports. By default, the number of connections is unlimited. Equivalent ofthe max_connections parameter in the SMF for
NFS using the sharectl(1M) command.-l Set connection queue length for the NFS TCP
over a connection-oriented transport. The
default value is 32 entries. Equivalent ofthe listen_backlog parameter in the SMF for
NFS using the sharectl(1M) command.-p protocol Start a NFS daemon over the specified proto-
col. Equivalent of the protocol parameter inthe SMF for NFS using the sharectl(1M) com-
mand.-t device Start a NFS daemon for the transport speci-
fied by the given device. Equivalent of theSunOS 5.11 Last change: 20 Aug 2010 3
System Administration Commands nfsd(1M)
device parameter in the SMF for NFS using the sharectl(1M) command. OPERANDS The following operands are supported: nservers This sets the maximum number of concurrent NFSrequests that the server can handle. This con-
currency 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 parameter in the SMF for NFS using the sharectl(1M) command.USAGE
If the NFS_PORTMON variable is set 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
EXAMPLES
Example 1 Turning Off DelegationThe nfsd properties specified in these examples are
described under "SMF Management," above. Delegation is an NFSv4 feature in which the server delegates the management of a file to a client. For example, the server could grant (or not grant) either a read delegation or a write delegation to a client. The following commanddoes this, setting the server_delegation property to off.
# sharectl set -p server_delegation=off nfs
Example 2 Determining Value of DelegationSunOS 5.11 Last change: 20 Aug 2010 4
System Administration Commands nfsd(1M)
The following command obtains the current value of theserver_delegation property.
# sharectl get -p server_delegation nfs
delegation=off Example 3 Setting Maximum Number of Concurrent Requests The following command sets the maximum number of concurrent NFS requests.# sharectl set -p servers=32 nfs
Example 4 Setting Connection Queue Length The following command sets the maximum queue length for theNFS over a connection-oriented transport.
# sharectl set -p listen_backlog=48 nfs
EXIT STATUS 0 Daemon started successfully. 1 Daemon failed to start. FILES.nfsXXX Client machine pointer to an open-
but-unlinked file.
/etc/system System configuration information file./var/nfs/v4_state Directories used by the server to
/var/nfs/v4_oldstate manage client state information.
These directories should not be removed.SunOS 5.11 Last change: 20 Aug 2010 5
System Administration Commands nfsd(1M)
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | service/file-system/nfs |
|_____________________________|_____________________________|
SEE ALSO
ps(1), svcs(1), mountd(1M), share(1M), sharectl(1M),sharemgr(1M), svcadm(1M), sharetab(4), system(4), attri-
butes(5), smf(5) System Administration Guide: Network Services NOTESManually starting and restarting nfsd is not recommended. If
it is necessary to do so, use svcadm to enable or disablethe nfs service (svc:/network/nfs/server). If it is dis-
abled, it will be enabled by share_nfs(1M), unless its
application/auto_enable property is set to false. See the
System Administration Guide: Network Services, and svcadm(1M) for more information.SunOS 5.11 Last change: 20 Aug 2010 6