Assorted man page fixes

[nfs-utils.git] / utils / exportfs / exportfs.man

diff --git a/utils/exportfs/exportfs.man b/utils/exportfs/exportfs.man
index 0cd5cca283d9c88b1525e0bed1df63ae5e66d9ed..2bd8e31519eb02fdbbf8f87531f9c5aded5cca1e 100644 (file)
--- a/utils/exportfs/exportfs.man
+++ b/utils/exportfs/exportfs.man
@@ -2,8 +2,8 @@
 .\" 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
@@ -15,6 +15,8 @@ exportfs \- maintain list of NFS exported file systems
 .br
 .BI "/usr/sbin/exportfs [-v]
 .br
+.BI "/usr/sbin/exportfs -f"
+.br
 .SH DESCRIPTION
 The
 .B exportfs
@@ -39,7 +41,32 @@ without modifying
 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 .
@@ -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
-.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
@@ -106,7 +138,7 @@ entries in
 (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
@@ -124,7 +156,7 @@ take place immediately after parsing the command line and updating the
 file.
 .P
 The default export options are
-.BR async,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.
@@ -135,7 +167,7 @@ all entries listed in
 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 individual export entries, one can specify a
 .I host:/path
 pair. This deletes the specified entry from
 .B xtab
@@ -152,7 +184,9 @@ option, the list of flags pertaining to each export are shown in addition.
 .\" -------------------- 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/xtab
 and pushes the resulting export entries into the kernel:
 .P
 .nf
@@ -182,7 +216,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
-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