Assorted man page fixes

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

diff --git a/utils/exportfs/exportfs.man b/utils/exportfs/exportfs.man
index 510c48ff5372089cebbd0b98a9ce7ca4fdfbba96..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>
 .\" 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,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
 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
 .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
 .\" -------------------- 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
 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
 .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