Added -e exclude inode option to dump.

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

diff --git a/dump/dump.8.in b/dump/dump.8.in
index 84e462c6db6ece70aa00696271869a973334e557..469ff1b3b82282e9ee299bf827d25f72d957ff9e 100644 (file)
--- a/dump/dump.8.in
+++ b/dump/dump.8.in
@@ -30,18 +30,17 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"     @(#)dump.8     8.3 (Berkeley) 5/1/95
-.\"    $Id: dump.8.in,v 1.1 1999/10/11 13:08:07 stelian Exp $
+.\"    $Id: dump.8.in,v 1.11 2000/02/04 20:22:21 stelian Exp $
 .\"
 .Dd __DATE__
 .Dt DUMP 8
-.Os "__VERSION__"
+.Os "dump __VERSION__"
 .Sh NAME
 .Nm dump
 .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
@@ -52,7 +51,7 @@
 .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
@@ -112,7 +111,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.
@@ -138,6 +137,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
@@ -202,6 +207,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
@@ -219,6 +232,13 @@ prompts for a new tape.
 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
@@ -381,6 +401,13 @@ The environment variable
 will be used to determine the pathname of the remote
 .Xr rmt 8
 program.
+.It Ev RSH
+.Nm Dump
+uses the contents of this variable to determine the name of the
+remote shell command to use when doing remote backups (rsh, ssh etc.). 
+If this variable is not set, 
+.Xr rcmd 3
+will be used, but only root will be able to do remote backups.
 .Sh FILES
 .Bl -tag -width __DUMPDATES__ -compact
 .It Pa /dev/st0
@@ -438,10 +465,10 @@ for the operator running
 .Pp
 .Nm Dump
 cannot do remote backups without being run as root, due to its
-security history.  This will be fixed in a later version of
-.Bx Free .
+security history.
 Presently, it works if you set it setuid (like it used to be), but this
-might constitute a security risk.
+might constitute a security risk. Note that you can set RSH to use
+a remote shell program instead.
 .Sh AUTHOR
 The 
 .Nm dump/restore
@@ -455,11 +482,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