]> git.decadent.org.uk Git - nfs-utils.git/blobdiff - utils/exportfs/exportfs.man
The wording in the exportfs man page can be a bit confusing, implying
[nfs-utils.git] / utils / exportfs / exportfs.man
index 510c48ff5372089cebbd0b98a9ce7ca4fdfbba96..59789cc43d930e12f55c46bc03d845a77ddd34f9 100644 (file)
@@ -2,8 +2,8 @@
 .\" exportfs(8)
 .\" 
 .\" Copyright (C) 1995 Olaf Kirch <okir@monad.swb.de>
 .\" exportfs(8)
 .\" 
 .\" Copyright (C) 1995 Olaf Kirch <okir@monad.swb.de>
-.\" Modifications 1999 Neil Brown <neilb@cse.unsw.edu.au>
-.TH exportfs 8 "7 Sep 1999"
+.\" Modifications 1999-2003 Neil Brown <neilb@cse.unsw.edu.au>
+.TH exportfs 8 "18 July 2003"
 .SH NAME
 exportfs \- maintain list of NFS exported file systems
 .SH SYNOPSIS
 .SH NAME
 exportfs \- maintain list of NFS exported file systems
 .SH SYNOPSIS
@@ -15,6 +15,8 @@ exportfs \- maintain list of NFS exported file systems
 .br
 .BI "/usr/sbin/exportfs [-v]
 .br
 .br
 .BI "/usr/sbin/exportfs [-v]
 .br
+.BI "/usr/sbin/exportfs -f"
+.br
 .SH DESCRIPTION
 The
 .B exportfs
 .SH DESCRIPTION
 The
 .B exportfs
@@ -39,7 +41,32 @@ without modifying
 using
 .BR exportfs .
 .P
 using
 .BR exportfs .
 .P
-Any export requests which identify a specific host (rather than a
+.B exportfs
+and it's partner program
+.B mountd
+work in one of two modes, a legacy mode which applies to 2.4 and
+earlier versions of the Linux kernel, and a new mode which applies to
+2.6 and later versions providing the
+.B nfsd
+virtual filesystem has been mounted at
+.B /proc/fs/nfsd
+or
+.BR /proc/fs/nfs .
+If this filesystem is not mounted in 2.6, the legacy mode is used.
+.P
+In the new mode,
+.B exportfs
+does not give any information to the kernel but only provides it to
+.B mountd
+through the
+.B /var/lib/nfs/xtab
+file.
+.B mountd
+will listen to requests from the kernel and will provide information
+as needed.
+.P
+In the legacy mode,
+any export requests which identify a specific host (rather than a
 subnet or netgroup etc) are entered directly into the kernel's export
 table as well as being written to
 .BR /var/lib/nfs/xtab .
 subnet or netgroup etc) are entered directly into the kernel's export
 table as well as being written to
 .BR /var/lib/nfs/xtab .
@@ -71,10 +98,15 @@ with /etc/exports. It removes entries in /var/lib/nfs/xtab
 which are deleted from /etc/exports, and remove any entries from the
 kernel export table which are no longer valid.
 .TP
 which are deleted from /etc/exports, and remove any entries from the
 kernel export table which are no longer valid.
 .TP
-.TP
 .B -u
 Unexport one or more directories.
 .TP
 .B -u
 Unexport one or more directories.
 .TP
+.B -f
+In 'new' mode, flush everything out of the kernels export table. Any
+clients that are active will get new entries added by
+.B mountd
+when they make their next request.
+.TP
 .B -v
 Be verbose. When exporting or unexporting, show what's going on. When
 displaying the current export list, also display the list of export
 .B -v
 Be verbose. When exporting or unexporting, show what's going on. When
 displaying the current export list, also display the list of export
@@ -106,7 +138,7 @@ entries in
 (unless the
 .B -i
 option is given).
 (unless the
 .B -i
 option is given).
-In addition, the administrator may overide any options from these sources
+In addition, the administrator may override any options from these sources
 using the
 .B -o
 argument which takes a comma-separated list of options in the same fashion
 using the
 .B -o
 argument which takes a comma-separated list of options in the same fashion
@@ -124,7 +156,7 @@ take place immediately after parsing the command line and updating the
 file.
 .P
 The default export options are
 file.
 .P
 The default export options are
-.BR sync,ro,root_squash,no_delay .
+.BR sync,ro,root_squash,wdelay .
 .\" -------------------- Unexporting Directories ------------------
 .SS Unexporting Directories
 The third synopsis shows how to unexported a currently exported directory.
 .\" -------------------- Unexporting Directories ------------------
 .SS Unexporting Directories
 The third synopsis shows how to unexported a currently exported directory.
@@ -135,11 +167,13 @@ all entries listed in
 are removed from the kernel export tables, and the file is cleared. This
 effectively shuts down all NFS activity.
 .P
 are removed from the kernel export tables, and the file is cleared. This
 effectively shuts down all NFS activity.
 .P
-To remove individial export entries, one can specify a
+To remove an export to a host, specify a
 .I host:/path
 pair. This deletes the specified entry from
 .B xtab
 and removes the corresponding kernel entry (if any).
 .I host:/path
 pair. This deletes the specified entry from
 .B xtab
 and removes the corresponding kernel entry (if any).
+To remove one or more exports to several hosts, use
+.BR "exportfs -ua" .
 .P
 .\" -------------------- Dumping the Export Table -----------------
 .SS Dumping the Export Table 
 .P
 .\" -------------------- Dumping the Export Table -----------------
 .SS Dumping the Export Table 
@@ -152,7 +186,9 @@ option, the list of flags pertaining to each export are shown in addition.
 .\" -------------------- EXAMPLES ---------------------------------
 .SH EXAMPLES
 The following adds all directories listed in
 .\" -------------------- EXAMPLES ---------------------------------
 .SH EXAMPLES
 The following adds all directories listed in
-.B /etc/exports to /var/lib/nfs/xtab
+.B /etc/exports
+to
+.B /var/lib/nfs/etab
 and pushes the resulting export entries into the kernel:
 .P
 .nf
 and pushes the resulting export entries into the kernel:
 .P
 .nf
@@ -168,6 +204,21 @@ allowing asynchronous writes, one would do this:
 .nf
 .B "# exportfs -o async django:/usr/tmp
 .fi
 .nf
 .B "# exportfs -o async django:/usr/tmp
 .fi
+.P
+To unexport the
+.B /usr/tmp
+directory:
+.P
+.nf
+.B "# exportfs -u django:/usr/tmp
+.fi
+.P
+To unexport all the directories listed in
+.B /etc/exports:
+.P
+.nf
+.B "# exportfs -au
+.fi
 .\" -------------------- DEPENDENCIES -----------------------------
 .SH DEPENDENCIES
 Exporting to IP networks, DNS and NIS domains does not enable clients
 .\" -------------------- DEPENDENCIES -----------------------------
 .SH DEPENDENCIES
 Exporting to IP networks, DNS and NIS domains does not enable clients
@@ -182,7 +233,7 @@ across reboots.
 .P
 When unexporting a network or domain entry, any current exports to members
 of this group will be checked against the remaining valid exports and
 .P
 When unexporting a network or domain entry, any current exports to members
 of this group will be checked against the remaining valid exports and
-if they themselves are nolonger valid they will be removed.
+if they themselves are no longer valid they will be removed.
 .P
 .\" -------------------- SEE ALSO --------------------------------
 .SH SEE ALSO
 .P
 .\" -------------------- SEE ALSO --------------------------------
 .SH SEE ALSO