Made dump report the total number of MB written to tape.

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

diff --git a/dump/dump.8.in b/dump/dump.8.in
index bb7503331c73581deeb636401223ed23c1352321..50c8fdea27d3d6210831607fdef213b3cba4c5a5 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.
 .\"
-.\"    $Id: dump.8.in,v 1.5 1999/11/22 19:08:50 tiniou Exp $
+.\"    $Id: dump.8.in,v 1.13 2000/03/02 12:07:36 stelian Exp $
 .\"
 .Dd __DATE__
 .Dt DUMP 8
@@ -40,22 +40,26 @@
 .Nd ext2 filesystem backup
 .Sh SYNOPSIS
 .Nm dump
-.Op Fl 0123456789acknSu
+.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 0123456789acknSu
+.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
@@ -111,7 +115,7 @@ tells
 .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.
@@ -137,6 +141,12 @@ will constrain writes to MAXBSIZE.
 .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
@@ -184,6 +194,19 @@ program is
 .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 
+.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
@@ -201,6 +224,14 @@ Note that this label is limited
 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
@@ -222,7 +253,7 @@ The default tape length is 2300 feet.
 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
@@ -468,11 +499,9 @@ Starting with 0.4b5, the new maintainer is Stelian Pop
 .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