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.
197 .It Sy statd_port Ns = Ns Ar num
198 The IP port number on which
203 which means it should use a default binding.
205 .Ss Setting nfsmapid_domain
206 As described above, the setting for
208 overrides the domain used by
210 for building and comparing outbound and inbound attribute strings, respectively.
211 This setting overrides any other mechanism for setting the NFSv4 domain.
216 daemon determines the NFSv4 domain as follows:
219 If a properly configured
226 queries specified nameserver(s) for the domain.
228 If a properly configured
233 exists, but the queried nameserver does not have a proper record of the domain
236 attempts to obtain the domain name through the BIND interface
245 falls back on using the configured domain name
249 which is returned with the leading domain suffix removed.
251 .Li widgets.sales.acme.com ,
257 does not exist, no domain name has been configured
259 .Pa /etc/defaultdomain
263 falls back on obtaining the domain name from the host name, if the host name
264 contains a fully qualified domain name
268 If a domainname is still not obtained following all of the preceding steps,
270 will have no domain configured.
271 This results in the following behavior:
278 attribute strings are encoded as literal id's.
279 For example, the UID 12345 is encoded as
285 portion of the inbound attribute string and performs name service lookups only
286 for the user or group.
287 If the user/group exists in the local system name service databases, then the
288 proper uid/gid will be mapped even when no domain has been configured.
290 This behavior implies that the same administrative user/group domain exists
291 between NFSv4 client and server (that is, the same uid/gid's for users/groups
292 on both client and server).
293 In the case of overlapping id spaces, the inbound attribute string could
294 potentially be mapped to the wrong id.
295 However, this is not functionally different from mapping the inbound string to
297 yet provides greater flexibility.