File Formats nfs(4)
NAME
nfs - file containing parameter values for NFS-related dae-
mons
SYNOPSIS
/etc/default/nfs
DESCRIPTION
The nfs file resides in directory /etc/default and provides
startup parameters for the nfsd(1M) and lockd(1M) daemons.
The nfs file format is ASCI; comment lines begin with the
crosshatch (#) character. Parameters consist of a keyword
followed by an equals (=) sign followed by the parameter
value, of the form:
keyword=value
The following parameters are currently supported in the nfs
file:
NFSCLIENTVERSMIN=num
NFSCLIENTVERSMAX=num
The NFS client only uses NFS versions in the range
specified by these variables. Valid values or versions
are: 2, 3, and 4. By default these variables are
unspecified (commented out) and the client's default
minimum is Version 2. The default maximum is Version 4.
You can override this range on a per-mount basis by
using the -o vers= option to mountnfs(1M).
NFSERVERVERSMIN=num
NFSERVERVERSMAX=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.
NFSERVERDELEGATION=on off
By default, this variable is commented out and the NFS
SunOS 5.11 Last change: 13 Oct 2004 1
File Formats nfs(4)
server provides delegations to clients. The user can
turn off delegations for all exported filesystems by
setting this variable to off (case-sensitive). This
variable only applies to NFS Version 4.
NFSMAPIDOMAIN=domain-string
By default, the nfsmapid uses the DNS domain of the sys-
tem. This setting overrides the default. This domain is
used for identifying user and group attribute strings in
the NFS Version 4 protocol. Clients and servers must
match with this domain for operation to proceed nor-
mally. This variable only applies to NFS Version 4. See
"Setting NFSMAPIDOMAIN," below for further details.
NFSDMAXCONECTIONS=num
Sets the maximum number of concurrent, connection-
oriented connections. The default is unlimited and is
obtained by not setting (that is, commenting out)
NFSDMAXCONECTIONS. Equivalent to the -c option in
nfsd.
NFSDLISTENBACKLOG=num
Set connection queue length for the NFS over a
connection-oriented transport. The default value is 32,
meaning 32 entries in the queue. Equivalent to the -l
option in nfsd.
NFSDPROTOCOL=AL
Start nfsd over the specified protocol only. Equivalent
to the -p option in nfsd. AL is equivalent to -a on the
nfsd command line. Mutually exlusive of NFSDEVICE. One
or the other of NFSDEVICE and NFSDPROTOCOL must be
commented out. For the UDP protocol, only version 2 and
version 3 service is established. NFS Version 4 is not
supported for the UDP protocol.
NFSDEVICE=devname
Start NFS daemon for the transport specified by the
given device only. Equivalent to the -t option in nfsd.
Mutually exclusive of NFSDPROTOCOL. One or the other of
NFSDEVICE and NFSDPROTOCOL must be commented out.
SunOS 5.11 Last change: 13 Oct 2004 2
File Formats nfs(4)
NFSDSERVERS=num
Maximum number of concurrent NFS requests. Equivalent to
last numeric argument on the nfsd command line. The
default is 16.
LOCKDLISTENBACKLOG=num
Set connection queue length for lockd over a
connection-oriented transport. The default and minimum
value is 32.
LOCKDSERVERS=num
Maximum number of concurrent lockd requests. The default
is 20.
LOCKDRETRANSMITIMEOUT=num
Retransmit timeout, in seconds, before lockd retries.
The default is 5.
GRACEPERIOD=num
Grace period, in seconds, that all clients (both NLM and
NFSv4) have to reclaim locks after a server reboot. This
parameter also controls the NFSv4 lease interval and
overrides the deprecated setting LOCKDGRACEPERIOD. The
default is 90.
LOCKDGRACEPERIOD=num
Deprecated. Same as GRACEPERIOD=num above. The default
is 90.
Setting NFSMAPIDOMAIN
As described above, the setting for NFSMAPIDOMAIN over-
rides the domain used by nfsmapid(1M) for building and com-
paring outbound and inbound attribute strings, respectively.
This setting overrides any other mechanism for setting the
NFSv4 domain. In the absence of a NFSMAPIDOMAIN setting,
the nfsmapid(1M) daemon determines the NFSv4 domain as fol-
lows:
o If a properly configured /etc/resolv.conf (see
resolv.conf(4)) exists, nfsmapid queries specified
SunOS 5.11 Last change: 13 Oct 2004 3
File Formats nfs(4)
nameserver(s) for the domain.
o If a properly configured /etc/resolv.conf (see
resolv.conf(4)) exists, but the queried nameserver
does not have a proper record of the domain name,
nfsmapid attempts to obtain the domain name through
the BIND interface (see resolver(3RESOLV)).
o If no /etc/resolv.conf exists, nfsmapid falls back
on using the configured domain name (see
domainname(1M)), which is returned with the leading
domain suffix removed. For example, for
widgets.sales.acme.com, sales.acme.com is returned.
o If /etc/resolv.conf does not exist, no domain name
has been configured (or no /etc/defaultdomain
exists), nfsmapid falls back on obtaining the
domain name from the host name, if the host name
contains a fully qualified domain name (FQDN).
If a domainname is still not obtained following all of the
preceding steps, nfsmapid will have no domain configured.
This results in the following behavior:
o Outbound "owner" and "ownergroup" attribute
strings are encoded as literal id's. For example,
the UID 12345 is encoded as 12345.
o nfsmapid ignores the "domain" portion of the
inbound attribute string and performs name service
lookups only for the user or group. If the
user/group exists in the local system name service
databases, then the proper uid/gid will be mapped
even when no domain has been configured.
This behavior implies that the same administrative
user/group domain exists between NFSv4 client and
server (that is, the same uid/gid's for
users/groups on both client and server). In the
case of overlapping id spaces, the inbound attri-
bute string could potentially be mapped to the
wrong id. However, this is not functionally dif-
ferent from mapping the inbound string to nobody,
yet provides greater flexibility.
SEE ALSO
lockd(1M), mountnfs(1M), nfsd(1M), nfsmapid(1M)
System Administration Guide: Network Services
SunOS 5.11 Last change: 13 Oct 2004 4
|
