./_Man_NeXT_html/html5/exports.5.html

Manual page for EXPORTS(5)

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

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.