nfs - nfs fstab format and options


SYNOPSIS

       /etc/fstab


DESCRIPTION

       The  fstab  file contains information about which filesys­
       tems to mount  where  and  with  what  options.   For  NFS
       mounts,  it  contains  the server name and exported server
       directory to mount from, the local directory that  is  the
       mount point, and the NFS specific options that control the
       way the filesystem is mounted.

       Here is an example from an /etc/fstab  file  from  an  NFS
       mount.

       server:/usr/local/pub    /pub   nfs    rsize=8192,wsize=8192,timeo=14,intr

   Options
       rsize=n        The  number  of bytes NFS uses when reading
                      files from  an  NFS  server.   The  default
                      value is dependent on the kernel, currently
                      1024  bytes.    (However,   throughput   is
                      improved greatly by asking for rsize=8192.)

       wsize=n        The number of bytes NFS uses  when  writing
                      files  to an NFS server.  The default value
                      is dependent on the kernel, currently  1024
                      bytes.   (However,  throughput  is improved
                      greatly by asking for wsize=8192.)

       timeo=n        The value in  tenths  of  a  second  before
                      sending  the  first retransmission after an
                      RPC timeout.  The default value is 7 tenths
                      of  a second.  After the first timeout, the
                      timeout is doubled  after  each  successive
                      timeout  until a maximum timeout of 60 sec­
                      onds is reached or the  enough  retransmis­
                      sions  have  occured to cause a major time­
                      out.   Then,  if  the  filesystem  is  hard
                      mounted,  each new timeout cascade restarts
                      at twice the initial value of the  previous
                      cascade, again doubling at each retransmis­
                      sion.  The maximum  timeout  is  always  60
                      seconds.  Better overall performance may be
                      achieved by  increasing  the  timeout  when
                      mounting  on  a  busy  network,  to  a slow
                      server, or through several routers or gate­
                      ways.

       retrans=n      The  number  of minor timeouts and retrans­
                      missions that must  occur  before  a  major
                      timeout occurs.  The default is 3 timeouts.

                      ation  is  either  aborted or a "server not
                      responding" message is printed on the  con­
                      sole.

       acregmin=n     The minimum time in seconds that attributes
                      of a regular file should be  cached  before
                      requesting fresh information from a server.
                      The default is 3 seconds.

       acregmax=n     The maximum time in seconds that attributes
                      of  a  regular  file  can  be cached before
                      requesting fresh information from a server.
                      The default is 60 seconds.

       acdirmin=n     The minimum time in seconds that attributes
                      of a  directory  should  be  cached  before
                      requesting fresh information from a server.
                      The default is 30 seconds.

       acdirmax=n     The maximum time in seconds that attributes
                      of   a   directory  can  be  cached  before
                      requesting fresh information from a server.
                      The default is 60 seconds.

       actimeo=n      Using  actimeo sets all of acregmin, acreg­
                      max, acdirmin, and  acdirmax  to  the  same
                      value.  There is no default value.

       retry=n        The number of minutes to retry an NFS mount
                      operation in the foreground  or  background
                      before  giving  up.   The  default value is
                      10000 minutes, which is roughly one week.

       namlen=n       When an NFS server does not support version
                      two  of the RPC mount protocol, this option
                      can be used to specify the  maximum  length
                      of  a  filename  that  is  supported on the
                      remote filesystem.  This is used to support
                      the  POSIX pathconf functions.  The default
                      is 255 characters.

       nolock         Disable NFS locking. This has  to  be  used
                      with  some  old NFS servers that don't sup­
                      port locking (for example  servers  running
                      Red Hat Linux 5.2 or older).

       port=n         The numeric value of the port to connect to
                      the NFS server on.  If the port number is 0
                      (the  default) then query the remote host's
                      portmapper for the port number to use.   If
                      the  remote host's NFS daemon is not regis­
                      tered with its portmapper, the standard NFS
                      port number 2049 is used instead.


       mounthost=name The name of the host running mountd .

       mountprog=n    Use an alternate RPC program number to con­
                      tact the mount daemon on the  remote  host.
                      This  option  is  useful for hosts that can
                      run  multiple  NFS  servers.   The  default
                      value  is  100005 which is the standard RPC
                      mount daemon program number.

       mountvers=n    Use an alternate RPC version number to con­
                      tact  the  mount daemon on the remote host.
                      This option is useful for  hosts  that  can
                      run  multiple  NFS  servers.   The  default
                      value is version 1.

       nfsprog=n      Use an alternate RPC program number to con­
                      tact  the  NFS  daemon  on the remote host.
                      This option is useful for  hosts  that  can
                      run  multiple  NFS  servers.   The  default
                      value is 100003 which is the  standard  RPC
                      NFS daemon program number.

       nfsvers=n      Use an alternate RPC version number to con­
                      tact the NFS daemon  on  the  remote  host.
                      This  option  is  useful for hosts that can
                      run  multiple  NFS  servers.   The  default
                      value is version 2.

       nolock         Disable  NFS  locking.  This has to be used
                      with some old NFS servers that  don't  sup­
                      port locking.

       bg             If  the  first NFS mount attempt times out,
                      retry the mount in the background.  After a
                      mount operation is backgrounded, all subse­
                      quent mounts on the same NFS server will be
                      backgrounded   immediately,  without  first
                      attempting  the  mount.   A  missing  mount
                      point is treated as a timeout, to allow for
                      nested NFS mounts.

       fg             If the first NFS mount attempt  times  out,
                      retry the mount in the foreground.  This is
                      the complement of the bg option,  and  also
                      the default behavior.

       soft           If  an NFS file operation has a major time­
                      out then report an I/O error to the calling
                      program.  The default is to continue retry­
                      ing NFS file operations indefinitely.

       hard           If  an  NFS  file  operation  has  a  major

                      on the console and continue retrying indef­
                      initely.  This is the default.

       intr           If  an NFS file operation has a major time­
                      out and it is hard mounted, then allow sig­
                      nals  to  interupt  the  file operation and
                      cause it to return  EINTR  to  the  calling
                      program.   The default is to not allow file
                      operations to be interrupted.

       posix          Mount the NFS filesystem using POSIX seman­
                      tics.   This  allows  an  NFS filesystem to
                      properly support the POSIX pathconf command
                      by  querying the mount server for the maxi­
                      mum length of a filename.  To do this,  the
                      remote host must support version two of the
                      RPC mount protocol.  Many NFS servers  sup­
                      port only version one.

       nocto          Suppress  the  retrieval  of new attributes
                      when creating a file.

       noac           Disable  all  forms  of  attribute  caching
                      entirely.   This  extracts a server perfor­
                      mance penalty but it allows  two  different
                      NFS  clients to get reasonable good results
                      when both clients are actively  writing  to
                      common filesystem on the server.

       nolock         Do not use locking. Do not start lockd.

       tcp            Mount the NFS filesystem using the TCP pro­
                      tocol instead of the default UDP  protocol.
                      Many NFS severs only support UDP.

       udp            Mount the NFS filesystem using the UDP pro­
                      tocol.  This is the default.

       All of the non-value options have  corresponding  nooption
       forms.   For example, nointr means don't allow file opera­
       tions to be interrupted.


FILES

       /etc/fstab


SEE ALSO

       fstab(5), mount(8), umount(8), exports(5)


AUTHOR

       "Rick Sladkey" <jrs@world.std.com>


BUGS

       The posix, and nocto  options  are  parsed  by  mount  but


       The  tcp  and  namlen  options are implemented but are not
       currently supported by the Linux kernel.

       The umount command should notify the server  when  an  NFS
       filesystem is unmounted.


Man(1) output converted with man2html