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.
 .\"
 .\" 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
 .\"
 .Dd __DATE__
 .Dt DUMP 8


@@ -40,22 +40,26 @@
 .Nd ext2 filesystem backup
 .Sh SYNOPSIS
 .Nm dump
 .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 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 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 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 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 file

+.Op Fl F Ar script

 .Op Fl h Ar level
 .Op Fl L Ar label
 .Op Fl s Ar feet
 .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
 .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.
 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 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
 .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 .
 .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
 .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 .
 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 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
 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
 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
 .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
 .Sh HISTORY
 A
 .Nm