


EXPORTS(5)                FILE FORMATS                 EXPORTS(5)



NAME
     exports, xtab - directories to export to NFS clients

SYNOPSIS
     /etc/exports

     /etc/xtab

DESCRIPTION
     The /etc/exports file contains entries for directories  that
     can be exported to NFS clients.  This file is read automati-
     cally by the exportfs(8) command.  If you change this  file,
     you  must  run  exportfs(8)  for  the  changes to affect the
     daemon's operation.

     Only when this  file  is  present  at  boot  time  does  the
     rc.local  script execute exportfs(8) and start the NFS file-
     system daemon, nfsd(8).

     The /etc/xtab file contains entries for directories that are
     _c_u_r_r_e_n_t_l_y  exported.   This  file should only be accessed by
     programs using getexportent() (see exportent(3)).   Use  the
     -u option of exportfs to remove entries from this file.

     An entry for a directory consists of a line of the following
     form:

          _d_i_r_e_c_t_o_r_y   -_o_p_t_i_o_n[,_o_p_t_i_o_n ]...

     _d_i_r_e_c_t_o_r_y      is the pathname of a directory (or file).

     _o_p_t_i_o_n         is one of the following:

                    ro   Export the directory read-only.  If  not
                         specified,  the  directory  is  exported
                         read-write.

                    rw=_h_o_s_t_n_a_m_e_s[:_h_o_s_t_n_a_m_e]...
                         Export   the   directory    read-mostly.
                         Read-mostly   means  read-only  to  most
                         machines, but read-write to those speci-
                         fied.   If  not specified, the directory
                         is exported read-write to all.

                    anon=_u_i_d
                         If a request comes from an unknown user,
                         use  _u_i_d as the effective user ID. Note:
                         root users (uid 0) are always considered
                         "unknown" by the NFS server, unless they
                         are included in the "root" option below.
                         The default value for this option is the
                         UID of the user "nobody".  If  the  user
                         "nobody"  does  not exist then the value
                         65534 is used.   Setting  the  value  of
                         "anon"   to   65535  disables  anonymous
                         access.  Note:  by  default  secure  NFS
                         accepts  insecure requests as anonymous,
                         and those wishing for extra security can
                         disable  this  feature by setting "anon"
                         to 65534.

                    root=_h_o_s_t_n_a_m_e_s[:_h_o_s_t_n_a_m_e]...
                         Give root access only to the root  users
                         from  a specified _h_o_s_t_n_a_m_e.  The default
                         is for  no  hosts  to  be  granted  root
                         access.

                    access=_c_l_i_e_n_t[:_c_l_i_e_n_t]...
                         Give mount access to each _c_l_i_e_n_t listed.
                         A  _c_l_i_e_n_t can either be a hostname, or a
                         netgroup (see netgroup(5)).  Each _c_l_i_e_n_t
                         in  the list is first checked for in the
                         /etc/hosts  database,   and   then   the
                         /etc/netgroups  database.   The  default
                         value allows any machine  to  mount  the
                         given directory.

                    secure
                         Require clients to  use  a  more  secure
                         protocol when accessing the directory.

     A `#' (pound-sign) anywhere in the file indicates a  comment
     that extends to the end of the line.

EXAMPLE
     /usr      -access=clients     # export to my clients
     /usr/local                    # export to the world
     /usr2     -access=hermes:zip:tutorial# export to only these machines
     /usr/sun  -root=hermes:zip    # give root access only to these
     /usr/new  -anon=0             # give all machines root access
     /usr/bin  -ro                 # export read-only to everyone
     /usr/stuff                    -access=zip,anon=-3,ro# several options on one line

FILES
     /etc/exports
     /etc/xtab
     /etc/hosts
     /etc/netgroup
     rc.local

SEE ALSO
     exportent(3), hosts(5), netgroup(5), exportfs(8), nfsd(8)

WARNINGS
     You cannot export either a parent directory or  a  subdirec-
     tory  of  an  exported  directory  that  is  _w_i_t_h_i_n _t_h_e _s_a_m_e
     _f_i_l_e_s_y_s_t_e_m.  It would be illegal, for  instance,  to  export
     both  /usr and /usr/local if both directories resided on the
     same disk partition.

