.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $Id: dump.8.in,v 1.31 2001/08/16 09:37:59 stelian Exp $
+.\" $Id: dump.8.in,v 1.35 2002/01/16 09:32:14 stelian Exp $
.\"
.Dd __DATE__
.Dt DUMP 8
.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
.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
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
.Pp
Starting with 0.4b5, the new maintainer is Stelian Pop
.br
-<pop@noos.fr>.
+<stelian@popies.net>.
.Sh AVAILABILITY
The
.Nm dump/restore