.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $Id: dump.8.in,v 1.40 2002/04/04 08:20:23 stelian Exp $
+.\" $Id: dump.8.in,v 1.42 2002/06/10 14:05:00 stelian Exp $
.\"
.Dd __DATE__
.Dt DUMP 8
.Nd ext2 filesystem backup
.Sh SYNOPSIS
.Nm dump
-.Op Fl 0123456789ackMnqSu
+.Op Fl 0123456789ackMnqSuv
.Op Fl A Ar file
.Op Fl B Ar records
.Op Fl b Ar blocksize
.Pa __DUMPDATES__
may be edited to change any of the fields,
if necessary.
+.It Fl v
+The
+.Fl v
+(verbose) makes
+.Nm dump
+to print extra information which could be helpful in debug sessions.
.It Fl W
.Nm Dump
tells the operator what file systems need to be dumped.
read errors is important, the output from dump can be parsed to look for lines
that contain the text 'read error'.
.Pp
+When a read error occurs,
+.Nm
+prints out the corresponding physical disk block and sector number and the
+ext2 logical block number.
+It doesn't print out the corresponing file name or even the inode number.
+The user has to use
+.Xr debugfs 8 ,
+commands
+.Pa ncheck
+and
+.Pa icheck
+to translate the
+.Pa ext2blk
+number printed out by dump into an inode number, then into a file name.
+.Pp
Each reel requires a new process, so parent processes for
reels already written just hang around until the entire tape
is written.