SYNOPSIS
/usr/sbin/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 sufficient privileges can run this daemon.
The
nfsd
daemon is automatically invoked if
NFS_CORE=1
and
NFS_SERVER=1
in the
/etc/rc.config.d/nfsconf
file.
By default,
nfsd
starts over the TCP and UDP transports for version 2 and version 3, and
over TCP for version 4, if NFS version 4 is enabled.
One 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.
Administrators wanting to change startup parameters for
nfsd
should make changes (as root user) to the NFS default file
/etc/default/nfs,
(see
nfs(4)).
Administrators can
either edit this file or use the
setoncenv
command to make changes.
Options
The following options are supported:
- -a
Start a NFS
daemon over all available connectionless and connection-oriented transports,
including UDP and TCP. Equivalent to setting the
NFSD_PROTOCOL
parameter to
ALL
in the NFS default file.
- -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 to the
NFSD_MAX_CONNECTION
parameter in the NFS default file.
- -l
Set connection
queue length for the NFS TCP over a connection-oriented transport.
The default value is 32 entries.
Equivalent to the
NFSD_LISTEN_BACKLOG
parameter in the NFS default file.
- -p protocol
Start a NFS daemon over the specified protocol.
Equivalent to the
NFSD_PROTOCOL
parameter in the NFS default file.
- -t device
Start a NFS daemon for the transport specified by the given device.
Equivalent to the
NFSD_DEVICE
parameter in the NFS default file.
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. Changing the value of
nservers
requires stopping and restarting
nfsd.
Equivalent to the
NFSD_SERVERS
parameter in the NFS default
file.
Notes
A directory service that provides service name data base support must have
the following service entries in its database:
nfsd 2049/udp nfs # NFS server daemon (clts)
nfsd 2049/tcp nfs # NFS server daemon (cots)
If the kernel tunable
NFS_PORTMON
(see
nfs_portmon(5))
is set to 1, then clients are required to use privileged
ports (ports < IPPORT_RESERVED)
to receive NFS services.
This tunable is set to 0 by default.
Use
kctune
(see
kctune(1M))
to set this tunable.
By default, the NFS version 4 server is disabled. In order to enable
it you must stop the NFS server.
As root, either use
the
setoncenv
command (see
setoncenv(1M))
or edit
/etc/default/nfs
to set the
NFS_SERVER_VERSMAX
parameter to 4.
EXIT STATUS
- 0
Daemon started successfully.
- 1
Daemon failed to start.
WARNINGS
Manually starting and restarting
nfsd
is not recommended.
If it is necessary to do so, use the NFS server start/stop script
(/sbin/init.d/nfs.server).
FILES
- .nfsXXX
client
machine pointer to an open-but-unlinked file.
- /sbin/init.d/nfs.server
shell script for starting
nfsd.
- /etc/default/nfs
startup parameters for
nfsd.
- /var/nfs4/v4_state
- /var/nfs4/v4_oldstate
directories used by the server to manage client state
information; these directories should not be removed.
AUTHOR
was developed by Sun Microsystems, Inc.
Printable version
