exportfs(NADM)                  19 June 1992                  exportfs(NADM)


 Name

    exportfs - export and unexport directories to NFS clients

 Syntax

    /etc/exportfs [ -avui ] [ -o options ] [ directory ]

 Description

    exportfs makes a local directory (or filename) available for mounting
    over the network by NFS clients.  It is normally invoked at boot time by
    the NFS startup script, and uses information contained in the
    /etc/exports file to export directories (which must be specified as a
    full pathname).  The super-user can run exportfs at any time to alter the
    list or characteristics of exported directories.  Directories that are
    currently exported are listed in the file /etc/xtab.

    With no options or arguments, exportfs prints out the list of directories
    currently exported.

 Options


    -a   all.  This option exports all directories listed in /etc/exports, or
         if -u is also specified, unexports all of the currently exported
         directories.

    -v   verbose.  This option prints each directory as it is exported or
         unexported.

    -u   unexport the indicated directories

    -i   ignore the options in /etc/exports.  Normally, exportfs will consult
         /etc/exports for the options associated with the exported directory.

    -o options
         specify a comma-separated list of optional characteristics for the
         directory being exported.  options can be selected from among:

         ro   export the directory read-only.  If not specified, the direc-
              tory is exported read-write.

         rw=hostname[:hostname]...
              export the directory read-mostly.  Read-mostly means exported
              read-only to most machines, but read-write to those specified.
              If not specified, the directory is exported read-write to all.

         anon=uid
              If a request comes from an unknown user, use uid as the effec-
              tive 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 -2.  Setting the value of anon to -1 disables
                 anonymous access.  Note that by default NFS accepts
                 insecure requests as anonymous, and those wishing for
                 extra security can disable this feature by setting anon
                 to -1.
              _________________________________________________________________________


         root=hostname[:hostname]...
              give root access only to the root users from a specified host-
              name.  The default is for no hosts to be granted root access.

         access=client[:client]...
              give mount access to each client listed.  A client can either
              be a hostname, or a netgroup (see netgroup(NF)).  clients in
              the list are checked for in the netgroup and hosts databases.
              The default value allows any machine to mount the given direc-
              tory.

 Files


    /etc/exports        static export information

    /etc/xtab           current state of exported directories

    /etc/netgroup       list of network-wide groups

 See also

    exports(NF), netgroup(NF)

 Warnings

    You cannot export a directory that is either a parent or a sub-directory
    of one that is currently exported and within the same filesystem.  It
    would be illegal, for example, to export both /usr and /usr/local if both
    directories resided in the same disk partition.