.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $Id: dump.8.in,v 1.7 1999/12/06 21:37:50 tiniou Exp $
+.\" $Id: dump.8.in,v 1.17 2000/11/10 11:48:31 stelian Exp $
.\"
.Dd __DATE__
.Dt DUMP 8
.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 filesystem
-.Nm dump
-.Op Fl 0123456789ackMnSu
-.Op Fl B Ar records
-.Op Fl b Ar blocksize
-.Op Fl d Ar density
-.Op Fl f Ar file
-.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
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
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 e Ar inode
+Exclude
+.Ar inode
+from the dump (you can use
+.Ar stat
+to find the inode number for a file or directory).
.It Fl h Ar level
Honor the user
.Dq nodump
.Pa /etc/rmt ;
this can be overridden by the environment variable
.Ev RMT .
+.It Fl F Ar script
+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
+dump should continue but ask the user to change the tape.
+Any other exit code will cause
+.Nm
+to abort.
+For security reasons,
+.Nm
+reverts back to the real user ID and the real group ID before
+running the script.
.It Fl k
Use Kerberos authentication to talk to remote tape servers. (Only
available if this option was enabled when
Size estimate. Determine the amount of space
that is needed to perform the dump without
actually doing it, and display the estimated
-number of blocks it will take. This is useful
+number of bytes it will take. This is useful
with incremental dumps to determine how many
volumes of media will be needed.
.It Fl T Ar date
.Fl W
option causes
.Nm
-to print out, for each file system in
+to print out, for all file systems in
.Pa __DUMPDATES__ ,
+and regognized file systems in
+.Pa /etc/fstab .
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
.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
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,
.Sh AVAILABILITY
The
.Nm dump/restore
-backup suit is available for anonymous ftp from tsx-11.mit.edu
-in /pub/linux/ALPHA/ext2fs (development versions) or
-/pub/linux/packages/ext2fs (stable versions).
-.Pp
-An alternate downloading location is http://perso.cybercable.fr/pop/dump.
+backup suit is available from
+.br
+http://dump.sourceforge.net
.Sh HISTORY
A
.Nm