unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

nfs(4)                           File Formats                           nfs(4)



NAME
       nfs - file containing parameter values for NFS-related daemons

SYNOPSIS
       /etc/default/nfs

DESCRIPTION
       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 Ver-
           sion 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 is 4.




       NFS_SERVER_DELEGATION=on | off

           By  default, this variable is commented out and the NFS server pro-
           vides delegations to clients. The user can turn off delegations for
           all exported filesystems by setting this variable to off (case-sen-
           sitive).  This variable only applies to NFS Version 4.



       NFSMAPID_DOMAIN=domain-string

           By default, the 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
           "Setting NFSMAPID_DOMAIN," below for further details.



       NFSD_MAX_CONNECTIONS=num

           Sets  the maximum number of concurrent, connection-oriented connec-
           tions. 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.



       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 set-
           ting 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  overrides  the
       domain  used  by  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
       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 wid-
            gets.sales.acme.com, sales.acme.com is returned.

         o  If /etc/resolv.conf does not exist, no domain name has  been  con-
            figured  (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  attribute string could
            potentially be mapped to the wrong id. However, this is not  func-
            tionally  different from mapping the inbound string to nobody, yet
            provides greater flexibility.


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

       System Administration Guide: Network Services



SunOS 5.10                        13 Oct 2004                           nfs(4)