svcadm(8)을 검색하려면 섹션에서 8 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.
nfs(5)
nfs(5) File Formats nfs(5)
NAME
nfs - configuration properties for the Oracle Solaris NFS server and
client
DESCRIPTION
The settings formerly managed by the nfs file have been moved to SMF
properties and are now managed by the sharectl command. For more infor‐
mation, see the sharectl(8) man page.
An authorized user can use the sharectl command to set global values
for these properties in SMF.
The following list describes the properties:
client_versmin=num
client_versmax=num
The NFS client only uses NFS versions in the range specified by
these variables. Valid versions are 2, 3, 4, 4.0, and 4.1. The
client's default minimum version is 2. The default maximum version
is 4 which can be either 4.1 or 4.0 depending on the server. You
can override the default maximum version on a per-mount basis by
using the vers=<NFS version> option in the mount_nfs command. For
more information, see the mount_nfs(8) man page.
server_versmin=num
server_versmax=num
The NFS server only uses NFS versions in the range specified by
these variables. Valid values or versions are: 2, 3, 4, 4.0, and
4.1. For the server, the default minimum version is 2 and the de‐
fault maximum version is 4.1. server_versmin=4 is equivalent to
4.0, while server_versmax=4 is equivalent to 4.1. Both min and max
can be set to 4.0 or 4.1 explicitly to avoid confusion.
server_delegation=on|off
Delegation is an NFS Version 4 feature in which the server can del‐
egate the management of a file to a client. By default, the NFS
server provides delegations to clients. The user can turn off dele‐
gations for all exported filesystems by setting this variable to
off (case-sensitive).
nfsmapid_domain=domain-string
By default, nfsmapid uses the DNS domain of the system. This set‐
ting 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 normally. This variable only applies to NFS Version 4. For
further details, see "Setting nfsmapid_domain".
max_connections=num
Sets the maximum number of concurrently open connections on the
server for connection-oriented transports. The default is unlimited
and is obtained by setting it to -1. Equivalent to the -c option in
nfsd.
listen_backlog=num
Sets 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.
protocol=ALL
Starts 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 device. For the UDP protocol, only version 2
and version 3 service is established. NFS Version 4 is not sup‐
ported for the UDP protocol.
device=devname
Starts NFS daemon for the transport specified by the given device
only. Equivalent to the -t option in nfsd. Mutually exclusive of
the protocol parameter. One or the other of NFS SMF parameters de‐
vice and protocol must not be set.
servers=num
Maximum number of concurrent NFS requests. Equivalent to last nu‐
meric argument on the nfsd command line. The default is 2048.
lockd_listen_backlog=num
Sets connection queue length for lockd over a connection-oriented
transport. The default and minimum value is 32.
lockd_servers=num
Maximum number of concurrent lockd requests. The default is 1024.
lockd_retransmit_timeout=num
Retransmits timeout, in seconds, before lockd retries. The default
is 5.
grace_period=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 set‐
ting LOCKD_GRACE_PERIOD. The default is 90. The minimum allowed
value is 15.
server_enable_idmap=on|off
By default, this variable is on. Set the variable to off to allow
the NFS server to accept numeric UIDs and GIDs from NFS clients us‐
ing auth_sys authentication and returns numeric UIDs and GIDs to
clients using auth_sys. This variable applies only to NFS Version 4
and is intended to ease migration from NFSv2/v3.
server_authz_cache_refresh=num
Controls the refresh rate of the NFS authentication cache. The de‐
fault value is 600 seconds. Setting it to 0 means no expiration.
netgroup_refresh=num
Controls the refresh of the mountd netgroup cache. The default
value is 600 seconds and a value of 0 means no expiration.
resvport=true|false
Controls whether or not the server requires the client to use a re‐
served port for all NFS calls. The default is false.
statd_servers=num
Maximum number of concurrent statd requests. The default is 1024.
explicit_netgroups=true|false
Controls whether to enforce new syntax for netgroups, where net‐
groups in share access list entries must be marked with a leading
'%' to distinguish them from hostnames. Enabling this setting re‐
quires the admin to make this change to all share access lists man‐
ually, and can eliminate unnecessary DNS lookups. The default is
false.
client_nfs23_acl=true|false
Controls whether the client will try to use the NFS_ACL protocol
for NFSv2 and NFSv3 mounts. The default value is true. Individual
mounts can override this property using the acl or noacl options.
See the description of those options in the mount_nfs(8) man page
for additional details and cautions.
SETTING nfsmapid_domain
As described above, the setting for nfsmapid_domain overrides the do‐
main used by nfsmapid for building and comparing outbound and inbound
attribute strings, respectively. This setting overrides any other mech‐
anism for setting the NFSv4 domain. In the absence of a nfsmapid_domain
setting, the nfsmapid daemon determines the NFSv4 domain as follows:
o If a properly configured /etc/resolv.conf exists, nfsmapid
queries specified nameservers for the domain. For more in‐
formation, see the resolv.conf(5) man page.
o If a properly configured /etc/resolv.conf exists, but the
queried nameserver does not have a proper record of the do‐
main name, nfsmapid attempts to obtain the domain name
through the BIND interface. For more information, see the
resolver(3RESOLV) man page.
o If no /etc/resolv.conf exists, nfsmapid falls back on using
the configured domain name, which is returned with the lead‐
ing domain suffix removed. For example, for wid‐
gets.sales.example.com, sales.example.com is returned. For
more information, see the domainname(8) man page.
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 has no domain configured. This results in the following
behavior:
o Outbound owner and owner_group 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 at‐
tribute string and performs name service lookups only for
the user or group. If the user or group exists in the local
system name service databases, then the proper UID or GID is
mapped even when no domain has been configured.
This behavior implies that the same administrative user or
group domain exists between NFSv4 client and server (that
is, the same UID or GID for users or groups on both client
and server). In the case of overlapping id spaces, the in‐
bound attribute string could potentially be mapped to the
wrong id. However, this is not functionally different from
mapping the inbound string to nobody, yet provides greater
flexibility.
SEE ALSO
lockd(8), mount_nfs(8), mountd(8), netcfg(8), nfsd(8), nfsmapid(8),
sharectl(8), statd(8)
Managing Network File Systems in Oracle Solaris 11.4
HISTORY
The minumum value allowed for the grace_period property was raised from
0 to 15 seconds in Oracle Solaris 11.4.60.
The client_nfs23_acl and explicit_netgroups properties were added in
Oracle Solaris 11.4.39.
The statd_servers property was added in Oracle Solaris 11.4.36.
Support for NFS version 4.1 in the version properties was added in Ora‐
cle Solaris 11.4.0.
The server_enable_idmap property was added in Oracle Solaris 11.4.0.
The resvport property was added in Oracle Solaris 11.3.0.
The netgroup_refresh and server_authz_cache_refresh properties were
added in Oracle Solaris 11.1.2 and Solaris 10 1/13 (Update 11).
The properties were moved from /etc/default/nfs to SMF properties in
Oracle Solaris 11.0.0.
The client_versmin, client_versmax, grace_period, nfsmapid_domain,
server_delegation, server_versmin, and server_versmax properties were
added in Oracle Solaris 10 3/05. The version properties supported NFS
versions 2 through 4.0.
The /etc/default/nfs file was created in the Solaris 9 release. Prior
to that, configuration changes required editing the
/etc/init.d/nfs.server script. This included support for the max_con‐
nections, listen_backlog, protocol, device, servers, lockd_listen_back‐
log, lockd_servers, lockd_retransmit_timeout, and lockd_grace_period
properties.
Oracle Solaris 11.4 14 Dec 2023 nfs(5)