.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $Id: dump.8.in,v 1.29 2001/07/18 13:12:33 stelian Exp $
+.\" $Id: dump.8.in,v 1.34 2001/11/11 00:06:39 stelian Exp $
.\"
.Dd __DATE__
.Dt DUMP 8
.Nd ext2 filesystem backup
.Sh SYNOPSIS
.Nm dump
-.Op Fl 0123456789ackMnSu
+.Op Fl 0123456789ackMnqSu
.Op Fl B Ar records
.Op Fl b Ar blocksize
.Op Fl d Ar density
-.Op Fl e Ar inode number
+.Op Fl e Ar inode numbers
+.Op Fl E Ar file
.Op Fl f Ar file
.Op Fl F Ar script
.Op Fl h Ar level
+.Op Fl I Ar nr errors
+.Op Fl j Ar compression level
.Op Fl L Ar label
.Op Fl Q Ar file
.Op Fl s Ar feet
Change the defaults for use with a cartridge tape drive, with a density
of 8000 bpi, and a length of 1700 feet. Specifying a cartridge drive
overrides the end-of-media detection.
-.It Fl e Ar inode
+.It Fl e Ar inodes
Exclude
-.Ar inode
-from the dump (you can use
+.Ar inodes
+from the dump. The
+.Ar inodes
+parameter is a comma separated list of inode numbers (you can use
.Ar stat
to find the inode number for a file or directory).
+.It Fl E Ar file
+Read list of inodes to be excluded from the dump from the text file
+.Ar file .
+The file
+.Ar file
+should be an ordinary file containing inode numbers separated by
+newlines.
.It Fl h Ar level
Honor the user
.Dq nodump
.Nm
reverts back to the real user ID and the real group ID before
running the script.
+.It Fl I Ar nr errors
+By default,
+.Nm
+will ignore the first 32 read errors on the file
+system before asking for operator intervention. You can change this
+using this flag to any value. This is useful when running
+.Nm
+on an active filesystem where read errors simply indicate an
+inconsistency between the mapping and dumping passes.
+.It Fl j Ar compression level
+Compress every block to be written on the tape using bzlib library. This
+option will work only when dumping to a file or pipe or, when dumping
+to a tape drive, if the tape drive is capable of writing variable
+length blocks. You will need at least the 0.4b24 version of restore in
+order to extract compressed tapes. Tapes written using compression will
+not be compatible with the BSD tape format. The (optional) parameter
+specifies the compression level bzlib will use. The default compression
+level is 2.
.It Fl k
Use Kerberos authentication to talk to remote tape servers. (Only
available if this option was enabled when
.Dq operator
by means similar to a
.Xr wall 1 .
+.It Fl q
+Make
+.Nm
+abort immediately whenever operator attention is required,
+without prompting in case of write errors, tape changes etc.
.It Fl Q Ar file
Enable the Quick File Access support. Tape positions for each
inode are stored into the file
end of dump,
tape write error,
tape open error or
-disk read error (if there is more than a threshold of 32).
+disk read error (if there is more than a threshold of nr errors).
In addition to alerting all operators implied by the
.Fl n
key,
If this variable is not set,
.Xr rcmd 3
will be used, but only root will be able to do remote backups.
+.El
.Sh FILES
.Bl -tag -width __DUMPDATES__ -compact
.It Pa /dev/st0
It might be considered a bug that this version of dump can only handle ext2
filesystems. Specifically, it does not work with FAT filesystems.
.Pp
-Fewer than 32 read errors on the filesystem are ignored. If noticing
+Fewer than 32 read errors (change this with -I)
+on the filesystem are ignored. If noticing
read errors is important, the output from dump can be parsed to look for lines
that contain the text 'read error'.
.Pp