.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $Id: dump.8.in,v 1.4 1999/10/30 22:55:51 tiniou Exp $
+.\" $Id: dump.8.in,v 1.12 2000/03/02 11:34:51 stelian Exp $
.\"
.Dd __DATE__
.Dt DUMP 8
.Nd ext2 filesystem backup
.Sh SYNOPSIS
.Nm dump
-.Op Fl 0123456789acknu
+.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 filesystem
.Nm dump
-.Op Fl 0123456789acknu
+.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
.Nm dump
to
copy all files new or modified since the
-last dump of the same or lower level.
+last dump of a lower level.
The default level is 9.
.It Fl B Ar records
The number of 1 KB blocks per volume.
.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 script must return 0
+if the dump should continue without asking the user to change
+the tape, 1 if the dump should continue but ask the user
+to change the tape. Any other exit code will cause dump to
+abort.
.It Fl k
Use Kerberos authentication to talk to remote tape servers. (Only
available if this option was enabled when
to be at most LBLSIZE (currently 16) characters, which must include
the terminating
.Ql \e0 .
+.It Fl M
+Enable the multi-volume feature. The name specified with
+.Fl f
+is treated as a prefix and
+.Nm
+writes in sequence to <prefix>001, <prefix>002 etc. This can be
+useful when dumping to files on an ext2 partition, in order to bypass
+the 2GB file size limitation.
.It Fl n
Whenever
.Nm
It is recommended to be a bit conservative on this option.
The default tape length is 2300 feet.
.ne 1i
+.It Fl S
+Size estimate. Determine the amount of space
+that is needed to perform the dump without
+actually doing it, and display the estimated
+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
Use the specified date as the starting time for the dump
instead of the time determined from looking in
.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