4 .\" Copyright (C) 1995 Olaf Kirch <okir@monad.swb.de>
5 .\" Modifications 1999 Neil Brown <neilb@cse.unsw.edu.au>
6 .TH exportfs 8 "7 Sep 1999"
8 exportfs \- maintain list of NFS exported file systems
10 .BI "/usr/sbin/exportfs [-avi] [-o " "options,.." "] [" "client:/path" " ..]
12 .BI "/usr/sbin/exportfs -r [-v]"
14 .BI "/usr/sbin/exportfs [-av] -u [" "client:/path" " ..]
16 .BI "/usr/sbin/exportfs [-v]
21 command is used to maintain the current table of exported file systems for
22 NFS. This list is kept in a separate file named
26 when a remote host requests access to mount a file tree, and parts of
27 the list which are active are kept in the kernel's export table.
31 file is initialized with the list of all file systems named in
36 However, administrators can choose to add and delete individual file systems
42 Any export requests which identify a specific host (rather than a
43 subnet or netgroup etc) are entered directly into the kernel's export
44 table as well as being written to
45 .BR /var/lib/nfs/xtab .
46 Further, any mount points listed in
48 which match a non host-specific export request will cause an
49 appropriate export entry for the host given in
52 into the kernel's export table.
56 Export or unexport all directories.
59 Specify a list of export options in the same manner as in
65 file, so that only default options and options given on the command
69 Reexport all directories. It synchronizes /var/lib/nfs/xtab
70 with /etc/exports. It removes entries in /var/lib/nfs/xtab
71 which are deleted from /etc/exports, and remove any entries from the
72 kernel export table which are no longer valid.
76 Unexport one or more directories.
79 Be verbose. When exporting or unexporting, show what's going on. When
80 displaying the current export list, also display the list of export
83 .\" -------------------- Exporting Directories --------------------
84 .SS Exporting Directories
85 The first synopsis shows how to invoke the command when adding new
86 entries to the export table. When using
92 and the resulting list is pushed into the kernel.
96 argument specifies the directory to export along with the host or hosts to
97 export it to. All formats described in
99 are supported; to export a directory to the world, simply specify
102 The export options for a particular host/directory pair derive from
103 several sources. There is a set of default options which can be overridden by
109 In addition, the administrator may overide any options from these sources
112 argument which takes a comma-separated list of options in the same fashion
113 as one would specify them in
117 can also be used to modify the export options of an already exported
120 Modifications of the kernel export table used by
122 take place immediately after parsing the command line and updating the
126 The default export options are
127 .BR async,ro,root_squash,no_delay .
128 .\" -------------------- Unexporting Directories ------------------
129 .SS Unexporting Directories
130 The third synopsis shows how to unexported a currently exported directory.
133 all entries listed in
135 are removed from the kernel export tables, and the file is cleared. This
136 effectively shuts down all NFS activity.
138 To remove individial export entries, one can specify a
140 pair. This deletes the specified entry from
142 and removes the corresponding kernel entry (if any).
144 .\" -------------------- Dumping the Export Table -----------------
145 .SS Dumping the Export Table
148 without further options shows the current list of exported file systems.
151 option, the list of flags pertaining to each export are shown in addition.
152 .\" -------------------- EXAMPLES ---------------------------------
154 The following adds all directories listed in
155 .B /etc/exports to /var/lib/nfs/xtab
156 and pushes the resulting export entries into the kernel:
166 allowing asynchronous writes, one would do this:
169 .B "# exportfs -o async django:/usr/tmp
171 .\" -------------------- DEPENDENCIES -----------------------------
173 Exporting to IP networks, DNS and NIS domains does not enable clients
174 from these groups to access NFS immediately; rather, these sorts of
177 to grant any mount requests from these clients.
178 This is usually not a big problem, because any existing mounts are preserved
183 When unexporting a network or domain entry, any current exports to members
184 of this group will be checked against the remaining valid exports and
185 if they themselves are nolonger valid they will be removed.
187 .\" -------------------- SEE ALSO --------------------------------
189 .BR exports(5) ", " mountd(8)
190 .\" -------------------- AUTHOR ----------------------------------
192 Olaf Kirch, <okir@monad.swb.de>
194 Neil Brown, <neilb@cse.unsw.edu.au>