EXPORTS(5)EXPORTS(5)NAME
exports, xtab - lists of directories to export to NFS clients
SYNOPSIS
/etc/exports
/etc/xtab
DESCRIPTION
NOTE: If NetInfo is running, this information is derived from the
/exports directory in NetInfo, instead of the /etc/exports file.
The /etc/exports file contains entries for directories that can be
exported to NFS clients. Changes to /etc/exports require running
exportfs(8) for the changes to affect the daemon's operation. Entries
added by the NFSManager application automatically result in exportfs
being run. Manually done changes require rerunning exportfs(8).
Only when this file is present at boot time, or entries exist in the
local netinfo /exports directory, does the rc.local script execute
exportfs(8) and start the NFS filesystem daemons nfsd(8) and
rpc.mountd(8).
The /etc/xtab file contains entries for directories that are currently
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:
directory -option[,option ]...
directory is the pathname of a directory (or file).
option is one of
ro Export the directory read-only. If not
specified, the directory is exported read-
write.
rw=hostnames[:hostname]...
Export the directory read-mostly. Read-
mostly means 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 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 -2.
Setting “anon” to -1 disables anonymous
access.
root=hostnames[:hostname]...
Give root access only to the root users from
a specified hostname. 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(5)). Each client in
the list is first checked for in the
netgroup database, and then the hosts
database. Simple hostnames for machines in
the server's domain should be used. The
default value allows any machine to mount
the given directory.
A ``#'' 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 ALSOexportent(3), hosts(5), netgroup(5), exportfs(8), nfsd(8)WARNINGS
You cannot export either a parent directory or a subdirectory of an
exported directory that is within the same filesystem. It would be
illegal, for instance, to export both /usr and /usr/local if both
directories resided on the same disk partition.
19 October 1987 EXPORTS(5)