1 files changed, 59 insertions, 40 deletions
diff --git a/usr/src/man/man4/nfs.4 b/usr/src/man/man4/nfs.4
index 959bb472c7..46c82e5e21 100644
--- a/usr/src/man/man4/nfs.4
+++ b/usr/src/man/man4/nfs.4
@@ -35,7 +35,8 @@ and
 daemons and
 .Xr mount_nfs 1M
 command is controlled by property values that are stored in the Service
-Management Facility, smf(5). The
+Management Facility, smf(5).
+The
 .Xr sharectl 1M
 command should be used to query or change values for these properties.
 .Pp
@@ -58,8 +59,9 @@ The following list describes the properties:
 .Sy client_versmax Ns = Ns Ar num
 .Xc
 The NFS client only uses NFS versions in the range specified by these
-properties. Valid values of versions are: 2, 3, and 4. Default minimum version
-is
+properties.
+Valid values of versions are: 2, 3, and 4.
+Default minimum version is
 .Li 2 ,
 while default maximum is
 .Li 4 .
@@ -74,29 +76,34 @@ option to
 .Sy server_versmax Ns = Ns Ar num
 .Xc
 The NFS server only uses NFS versions in the range specified by these
-properties. Valid values of versions are: 2, 3, and 4. Default minimum version
-is
+properties.
+Valid values of versions are: 2, 3, and 4.
+Default minimum version is
 .Li 2 ,
 while the default maximum version is
 .Li 4 .
 .It Sy server_delegation Ns = Ns Sy on Ns | Ns Sy off
-By default the NFS server provides
-delegations to clients. The user can turn off delegations for all exported
-filesystems by setting this variable to
+By default the NFS server provides delegations to clients.
+The user can turn off delegations for all exported filesystems by setting this
+variable to
 .Li off .
 This variable only applies to NFS Version 4.
 .It Sy nfsmapid_domain Ns = Ns Op Ar string
 By default, the
 .Nm nfsmapid
-uses the DNS domain of the system. 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 normally. This variable only applies to NFS Version 4. See
+uses the DNS domain of the system.
+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
+normally.
+This variable only applies to NFS Version 4.
+See
 .Sx Setting nfsmapid_domain
 below for further details.
 .It Sy max_connections Ns = Ns Ar num
-Sets the maximum number of concurrent, connection-oriented connections. The
-default is
+Sets the maximum number of concurrent, connection-oriented connections.
+The default is
 .Li -1
 .Pq unlimited .
 Equivalent to the
@@ -107,14 +114,16 @@ option in
 Set connection queue length for the NFS over a connection-oriented transport.
 The default value is
 .Li 32 ,
-meaning 32 entries in the queue. Equivalent to the
+meaning 32 entries in the queue.
+Equivalent to the
 .Fl l
 option in
 .Nm nfsd .
 .It Sy protocol Ns = Ns Op Sy all Ns | Ns Ar protocol
 Start
 .Nm nfsd
-over the specified protocol only. Equivalent to the
+over the specified protocol only.
+Equivalent to the
 .Fl p
 option in
 .Nm nfsd .
@@ -123,10 +132,11 @@ is equivalent to
 .Fl a
 on the
 .Nm nfsd
-command line. Mutually exlusive of
+command line.
+Mutually exlusive of
 .Sy device .
-For the UDP protocol, only version 2 and version 3 service is established. NFS
-Version 4 is not supported for the UDP protocol.
+For the UDP protocol, only version 2 and version 3 service is established.
+NFS Version 4 is not supported for the UDP protocol.
 .It Sy device Ns = Ns Op Ar devname
 Start NFS daemon for the transport specified by the given device only.
 Equivalent to the
@@ -136,35 +146,41 @@ option in
 Mutually exclusive of
 .Sy protocol .
 .It Sy servers Ns = Ns Ar num
-Maximum number of concurrent NFS requests. Equivalent to last numeric argument
-on the
+Maximum number of concurrent NFS requests.
+Equivalent to last numeric argument on the
 .Nm nfsd
-command line. The default is
+command line.
+The default is
 .Li 1024 .
 .It Sy lockd_listen_backlog Ns = Ns Ar num
 Set connection queue length for
 .Nm lockd
-over a connection-oriented transport. The default and minimum value is
+over a connection-oriented transport.
+The default and minimum value is
 .Li 32 .
 .It Sy lockd_servers Ns = Ns Ar num
 Maximum number of concurrent
 .Nm lockd
-requests. The default is 256.
+requests.
+The default is 256.
 .It Sy lockd_retransmit_timeout Ns = Ns Ar num
 Retransmit timeout, in seconds, before
 .Nm lockd
-retries. The default is
+retries.
+The default is
 .Li 5 .
 .It Sy grace_period Ns = Ns Ar num
 Grace period, in seconds, that all clients
 .Pq both NLM and NFSv4
-have to reclaim locks after a server reboot. This parameter also controls the
-NFSv4 lease interval. The default is
+have to reclaim locks after a server reboot.
+This parameter also controls the NFSv4 lease interval.
+The default is
 .Li 90 .
 .It Sy mountd_listen_backlog Ns = Ns Ar num
 Set the connection queue length for
 .Nm mountd
-over a connection-oriented transport. The default value is
+over a connection-oriented transport.
+The default value is
 .Li 64 .
 .It Sy mountd_max_threads Ns = Ns Ar num
 Maximum number of threads for
@@ -178,8 +194,8 @@ As described above, the setting for
 overrides the domain used by
 .Xr nfsmapid 1M
 for building and comparing outbound and inbound attribute strings, respectively.
-This setting overrides any other mechanism for setting the NFSv4 domain. In the
-absence of a
+This setting overrides any other mechanism for setting the NFSv4 domain.
+In the absence of a
 .Sy nfsmapid_domain
 setting, the
 .Xr nfsmapid 1M
@@ -216,7 +232,8 @@ falls back on using the configured domain name
 .Po see
 .Xr domainname 1M
 .Pc ,
-which is returned with the leading domain suffix removed. For example, for
+which is returned with the leading domain suffix removed.
+For example, for
 .Li widgets.sales.acme.com ,
 .Li sales.acme.com
 is returned.
@@ -236,30 +253,32 @@ contains a fully qualified domain name
 .Pp
 If a domainname is still not obtained following all of the preceding steps,
 .Nm nfsmapid
-will have no domain configured. This results in the following behavior:
+will have no domain configured.
+This results in the following behavior:
 .Bl -bullet
 .It
 Outbound
 .Qq owner
 and
 .Qq owner_group
-attribute strings are encoded as literal id's. For example, the UID 12345 is
-encoded as
+attribute strings are encoded as literal id's.
+For example, the UID 12345 is encoded as
 .Li 12345 .
 .It
 .Nm nfsmapid
 ignores the
 .Qq 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.
+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.
 .Pp
 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
-attribute string could potentially be mapped to the wrong id. However, this is
-not functionally different from mapping the inbound string to
+on both client and server).
+In the case of overlapping id spaces, the inbound attribute string could
+potentially be mapped to the wrong id.
+However, this is not functionally different from mapping the inbound string to
 .Sy nobody ,
 yet provides greater flexibility.
 .El