Made dump -w|-W report all recognized filesystems...

[dump.git] / dump / dump.8.in

diff --git a/dump/dump.8.in b/dump/dump.8.in
index 50c8fdea27d3d6210831607fdef213b3cba4c5a5..f81cffb908d85f55a108b8ec6524e50c6dafa537 100644 (file)
--- a/dump/dump.8.in
+++ b/dump/dump.8.in
@@ -30,7 +30,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"

-.\"    $Id: dump.8.in,v 1.13 2000/03/02 12:07:36 stelian Exp $
+.\"    $Id: dump.8.in,v 1.17 2000/11/10 11:48:31 stelian Exp $

 .\"
 .Dd __DATE__
 .Dt DUMP 8
 .\"
 .Dd __DATE__
 .Dt DUMP 8


@@ -51,20 +51,7 @@
 .Op Fl L Ar label
 .Op Fl s Ar feet
 .Op Fl T Ar date
 .Op Fl L Ar label
 .Op Fl s Ar feet
 .Op Fl T Ar date

-.Ar filesystem
-.Nm dump
-.Op Fl 0123456789ackMnSu
-.Op Fl B Ar records
-.Op Fl b Ar blocksize
-.Op Fl d Ar density
-.Op Fl e Ar inode number
-.Op Fl f Ar file
-.Op Fl F Ar script
-.Op Fl h Ar level
-.Op Fl L Ar label
-.Op Fl s Ar feet
-.Op Fl T Ar date
-.Ar directory
+.Ar file-to-dump

 .Nm dump
 .Op Fl W Li \&| Fl w
 .Pp
 .Nm dump
 .Op Fl W Li \&| Fl w
 .Pp


@@ -99,6 +86,16 @@ block count options below.
 By default, the same output file name is used for each volume
 after prompting the operator to change media.
 .Pp
 By default, the same output file name is used for each volume
 after prompting the operator to change media.
 .Pp

+.Ar file-to-dump
+is either a mountpoint of a filesystem
+or a directory to be backed up as a subset of a filesystem.
+In the former case, either the path to a mounted filesystem
+or the device of an unmounted filesystem can be used.
+In the latter case, certain restrictions are placed on the backup:
+.Fl u
+is not allowed and the only dump level that is supported is
+.Fl 0 .
+.Pp

 The following options are supported by
 .Nm Ns :
 .Bl -tag -width Ds
 The following options are supported by
 .Nm Ns :
 .Bl -tag -width Ds


@@ -138,6 +135,7 @@ without having problems later with
 Therefore
 .Nm dump
 will constrain writes to MAXBSIZE.
 Therefore
 .Nm dump
 will constrain writes to MAXBSIZE.

+The default blocksize is 10.

 .It Fl c
 Change the defaults for use with a cartridge tape drive, with a density
 of 8000 bpi, and a length of 1700 feet.
 .It Fl c
 Change the defaults for use with a cartridge tape drive, with a density
 of 8000 bpi, and a length of 1700 feet.


@@ -195,7 +193,9 @@ program is
 this can be overridden by the environment variable
 .Ev RMT .
 .It Fl F Ar script
 this can be overridden by the environment variable
 .Ev RMT .
 .It Fl F Ar script

-Run script at the end of each tape. The script must return 0 if 
+Run script at the end of each tape. The device name and the
+current volume number are passed on the command line.
+The script must return 0 if 

 .Nm
 should continue without asking the user to change the tape, 1 if 
 .Nm
 .Nm
 should continue without asking the user to change the tape, 1 if 
 .Nm


@@ -300,10 +300,12 @@ The
 .Fl W
 option causes
 .Nm
 .Fl W
 option causes
 .Nm

-to print out, for each file system in
+to print out, for all file systems in

 .Pa __DUMPDATES__ ,
 .Pa __DUMPDATES__ ,

+and regognized file systems in
+.Pa /etc/fstab .

 the most recent dump date and level,
 the most recent dump date and level,

-and highlights those file systems that should be dumped.
+and highlights those that should be dumped.

 If the
 .Fl W
 option is set, all other options are ignored, and
 If the
 .Fl W
 option is set, all other options are ignored, and


@@ -312,7 +314,9 @@ exits immediately.
 .It Fl w
 Is like
 .Fl W ,
 .It Fl w
 Is like
 .Fl W ,

-but prints only those filesystems which need to be dumped.
+but prints only recognized filesystems in
+.Pa /etc/fstab
+which need to be dumped.

 .El
 .Pp
 .Nm Dump
 .El
 .Pp
 .Nm Dump


@@ -460,17 +464,6 @@ Each reel requires a new process, so parent processes for
 reels already written just hang around until the entire tape
 is written.
 .Pp
 reels already written just hang around until the entire tape
 is written.
 .Pp

-.Nm Dump
-with the
-.Fl W
-or
-.Fl w
-option does not report filesystems that have never been recorded
-in
-.Pa __DUMPDATES__ ,
-even if listed in
-.Pa /etc/fstab .
-.Pp

 It would be nice if
 .Nm
 knew about the dump sequence,
 It would be nice if
 .Nm
 knew about the dump sequence,