2 .\" The contents of this file are subject to the terms of the
3 .\" Common Development and Distribution License (the "License").
4 .\" You may not use this file except in compliance with the License.
6 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
7 .\" or http://www.opensolaris.org/os/licensing.
8 .\" See the License for the specific language governing permissions
9 .\" and limitations under the License.
11 .\" When distributing Covered Code, include this CDDL HEADER in each
12 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
13 .\" If applicable, add the following below this CDDL HEADER, with the
14 .\" fields enclosed by brackets "[]" replaced with your own identifying
15 .\" information: Portions Copyright [yyyy] [name of copyright owner]
18 .\" Copyright 1989 AT&T
19 .\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved.
20 .\" Copyright 2016 Nexenta Systems, Inc.
27 .Nd NFS configuration properties
37 command is controlled by property values that are stored in the Service
38 Management Facility, smf(5).
41 command should be used to query or change values for these properties.
45 property values on the
51 command line override the values set using
54 The following list describes the properties:
57 .Sy client_versmin Ns = Ns Ar num
59 .Sy client_versmax Ns = Ns Ar num
61 The NFS client only uses NFS versions in the range specified by these
63 Valid values of versions are: 2, 3, and 4.
64 Default minimum version is
66 while default maximum is
69 You can override this range on a per-mount basis by using the
74 .Sy server_versmin Ns = Ns Ar num
76 .Sy server_versmax Ns = Ns Ar num
78 The NFS server only uses NFS versions in the range specified by these
80 Valid values of versions are: 2, 3, and 4.
81 Default minimum version is
83 while the default maximum version is
85 .It Sy server_delegation Ns = Ns Sy on Ns | Ns Sy off
86 By default the NFS server provides delegations to clients.
87 The user can turn off delegations for all exported filesystems by setting this
90 This variable only applies to NFS Version 4.
91 .It Sy nfsmapid_domain Ns = Ns Op Ar string
94 uses the DNS domain of the system.
95 This setting overrides the default.
96 This domain is used for identifying user and group attribute strings in the NFS
98 Clients and servers must match with this domain for operation to proceed
100 This variable only applies to NFS Version 4.
102 .Sx Setting nfsmapid_domain
103 below for further details.
104 .It Sy max_connections Ns = Ns Ar num
105 Sets the maximum number of concurrent, connection-oriented connections.
113 .It Sy listen_backlog Ns = Ns Ar num
114 Set connection queue length for the NFS over a connection-oriented transport.
117 meaning 32 entries in the queue.
122 .It Sy protocol Ns = Ns Op Sy all Ns | Ns Ar protocol
125 over the specified protocol only.
138 For the UDP protocol, only version 2 and version 3 service is established.
139 NFS Version 4 is not supported for the UDP protocol.
140 .It Sy device Ns = Ns Op Ar devname
141 Start NFS daemon for the transport specified by the given device only.
146 Mutually exclusive of
148 .It Sy servers Ns = Ns Ar num
149 Maximum number of concurrent NFS requests.
150 Equivalent to last numeric argument on the
155 .It Sy lockd_listen_backlog Ns = Ns Ar num
156 Set connection queue length for
158 over a connection-oriented transport.
159 The default and minimum value is
161 .It Sy lockd_servers Ns = Ns Ar num
162 Maximum number of concurrent
166 .It Sy lockd_retransmit_timeout Ns = Ns Ar num
167 Retransmit timeout, in seconds, before
172 .It Sy grace_period Ns = Ns Ar num
173 Grace period, in seconds, that all clients
174 .Pq both NLM and NFSv4
175 have to reclaim locks after a server reboot.
176 This parameter also controls the NFSv4 lease interval.
179 .It Sy mountd_listen_backlog Ns = Ns Ar num
180 Set the connection queue length for
182 over a connection-oriented transport.
185 .It Sy mountd_max_threads Ns = Ns Ar num
186 Maximum number of threads for
190 .It Sy mountd_port Ns = Ns Ar num
191 The IP port number on which
196 which means it should use a default binding.
198 .Ss Setting nfsmapid_domain
199 As described above, the setting for
201 overrides the domain used by
203 for building and comparing outbound and inbound attribute strings, respectively.
204 This setting overrides any other mechanism for setting the NFSv4 domain.
209 daemon determines the NFSv4 domain as follows:
212 If a properly configured
219 queries specified nameserver(s) for the domain.
221 If a properly configured
226 exists, but the queried nameserver does not have a proper record of the domain
229 attempts to obtain the domain name through the BIND interface
238 falls back on using the configured domain name
242 which is returned with the leading domain suffix removed.
244 .Li widgets.sales.acme.com ,
250 does not exist, no domain name has been configured
252 .Pa /etc/defaultdomain
256 falls back on obtaining the domain name from the host name, if the host name
257 contains a fully qualified domain name
261 If a domainname is still not obtained following all of the preceding steps,
263 will have no domain configured.
264 This results in the following behavior:
271 attribute strings are encoded as literal id's.
272 For example, the UID 12345 is encoded as
278 portion of the inbound attribute string and performs name service lookups only
279 for the user or group.
280 If the user/group exists in the local system name service databases, then the
281 proper uid/gid will be mapped even when no domain has been configured.
283 This behavior implies that the same administrative user/group domain exists
284 between NFSv4 client and server (that is, the same uid/gid's for users/groups
285 on both client and server).
286 In the case of overlapping id spaces, the inbound attribute string could
287 potentially be mapped to the wrong id.
288 However, this is not functionally different from mapping the inbound string to
290 yet provides greater flexibility.