Manual Pages for UNIX Operating System command usage for man nfs

File Formats                                               nfs(4)



NAME
     nfs - file containing parameter values for NFS-related  dae-
     mons

SYNOPSIS
     /etc/default/nfs


DESCRIPTION
     The settings formerly managed by  the  nfs  file  have  been
     moved to SMF properties and are now managed by sharectl(1M).
     The functionality described here is  provided  for  backward
     compatibility only.


     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 ASCII; 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:

     NFS_CLIENT_VERSMIN=num
     NFS_CLIENT_VERSMAX=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 mount_nfs(1M).


     NFS_SERVER_VERSMIN=num
     NFS_SERVER_VERSMAX=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



SunOS 5.11          Last change: 18 Aug 2010                    1






File Formats                                               nfs(4)



         is 4.


     NFS_SERVER_DELEGATION=on | off

         By default, this variable is commented out and  the  NFS
         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.


     NFSMAPID_DOMAIN=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 NFSMAPID_DOMAIN," below for further details.


     NFSD_MAX_CONNECTIONS=num

         Sets  the  maximum  number  of  concurrent,  connection-
         oriented  connections.  The  default is unlimited and is
         obtained  by  not  setting  (that  is,  commenting  out)
         NFSD_MAX_CONNECTIONS.  Equivalent  to  the  -c option in
         nfsd.


     NFSD_LISTEN_BACKLOG=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.


     NFSD_PROTOCOL=ALL

         Start nfsd over the specified protocol only.  Equivalent
         to the -p option in nfsd. ALL is equivalent to -a on the
         nfsd command line. Mutually exlusive of NFSD_DEVICE. One
         or  the  other  of NFSD_DEVICE and NFSD_PROTOCOL 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.






SunOS 5.11          Last change: 18 Aug 2010                    2






File Formats                                               nfs(4)



     NFSD_DEVICE=devname

         Start NFS daemon for  the  transport  specified  by  the
         given  device only. Equivalent to the -t option in nfsd.
         Mutually exclusive of NFSD_PROTOCOL. One or the other of
         NFSD_DEVICE and NFSD_PROTOCOL must be commented out.


     NFSD_SERVERS=num

         Maximum number of concurrent NFS requests. Equivalent to
         last  numeric  argument  on  the  nfsd command line. The
         default is 16.


     LOCKD_LISTEN_BACKLOG=num

         Set  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 20.


     LOCKD_RETRANSMIT_TIMEOUT=num

         Retransmit 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 setting LOCKD_GRACE_PERIOD. The
         default is 90.


     LOCKD_GRACE_PERIOD=num

         Deprecated. Same as GRACE_PERIOD=num above. The  default
         is 90.


  Setting NFSMAPID_DOMAIN
     As described above, the setting  for  NFSMAPID_DOMAIN  over-
     rides  the  domain  used  by  nfsmapid(1M)  for building and



SunOS 5.11          Last change: 18 Aug 2010                    3






File Formats                                               nfs(4)



     comparing outbound and inbound  attribute  strings,  respec-
     tively.  This setting overrides any other mechanism for set-
     ting the NFSv4 domain. In the absence of  a  NFSMAPID_DOMAIN
     setting, the nfsmapid(1M) daemon determines the NFSv4 domain
     as follows:

         o    If  a  properly  configured  /etc/resolv.conf  (see
              resolv.conf(4))  exists, nfsmapid queries specified
              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  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  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,



SunOS 5.11          Last change: 18 Aug 2010                    4






File Formats                                               nfs(4)



              yet provides greater flexibility.

SEE ALSO
     lockd(1M),    mount_nfs(1M),     nfsd(1M),     nfsmapid(1M),
     sharectl(1M)


     System Administration Guide: Network Services















































SunOS 5.11          Last change: 18 Aug 2010                    5