cdrestore.1
branchtrunk
changeset 4 79da91042fcc
parent 2 6bcb44b9edb1
child 8 a306b5e43b44
     1.1 --- a/cdrestore.1	Sat Dec 29 15:23:55 2007 +0100
     1.2 +++ b/cdrestore.1	Sat Dec 29 15:25:21 2007 +0100
     1.3 @@ -1,14 +1,14 @@
     1.4 -.TH "cdrestore" "1" "0.6.3" "Stefan Hülswitt" ""
     1.5 +.TH "cdrestore" "1" "0.6.4beta" "Stefan Hülswitt" ""
     1.6  .SH "NAME"
     1.7  .LP 
     1.8 -cdrestore \- Streaming restore from CD\-R(W)
     1.9 +cdrestore \- Streaming restore from CD\-R(W)/DVD\-R(W)
    1.10  .SH "SYNOPSIS"
    1.11  .LP 
    1.12 -cdrestore [\-qvDFRTV] [\-d \fIdevice\fP] [\-l \fIsize\fP] [\-t \fItrack\fP]
    1.13 -          [\-c \fIcommand\fP]
    1.14 +cdrestore [\-qvDFRTV] [\-d \fIdevice\fP] [\-i \fIimage\fP] [\-l \fIsize\fP]
    1.15 +          [\-t \fItrack\fP] [\-c \fIcommand\fP]
    1.16  .SH "DESCRIPTION"
    1.17  .LP 
    1.18 -cdrestore is a utility to make streaming restores from CD\-R(W) disks. It's designed to work with any backup tool which is able to restore from stdin (like tar/cpio/afio).
    1.19 +cdrestore is a utility to make streaming restores from CD\-R(W)/DVD\-R(W) disks. It's designed to work with any backup tool which is able to restore from stdin (like tar/cpio/afio).
    1.20  .SH "OPTIONS"
    1.21  .LP 
    1.22  .TP 
    1.23 @@ -18,10 +18,18 @@
    1.24  (default: /dev/cdrom)
    1.25  
    1.26  .TP 
    1.27 +\fB\-i\fR \fIimage\fP
    1.28 +Enables virtual image mode. The backup stream is read from the given image file. You have to use this option, if you are restoring from a dumped image too.
    1.29 +.br 
    1.30 +(default: none)
    1.31 +
    1.32 +.TP 
    1.33  \fB\-l\fR \fIsize\fP
    1.34 -The media size in megabytes. This value is used to calculate the free space on the media.
    1.35 +Specifies the media size. This value is used to display the free space on the media only.
    1.36  .br 
    1.37 -(default: 650)
    1.38 +By default the given value is taken as megabytes. You can append a single letter to the number to select: (k)ilobytes, (m)egabytes, (g)igabytes or (s)ectors (e.g. 170k, 4488m, 350000s).
    1.39 +.br 
    1.40 +(default: 650m)
    1.41  
    1.42  .TP 
    1.43  \fB\-t\fR \fItrack\fP
    1.44 @@ -31,9 +39,9 @@
    1.45  
    1.46  .TP 
    1.47  \fB\-T\fR
    1.48 -Enables test mode. The complete restore process is done to test data integrity, but no data is output.
    1.49 +Enables test mode. The complete restore process is done to test data integrity (includes CRC checksum test, if available), but no data is output.
    1.50  .br 
    1.51 -\fINOTE:\fR This only verifies that the data is readable by cdrestore at all. This doesn't quaranties that your backup software will be able to do a real restore with the data.
    1.52 +\fINOTE:\fR This only verifies that the data is readable by cdrestore at all. This doesn't guarantee that your backup software will be able to do a real restore with the data.
    1.53  
    1.54  .TP 
    1.55  \fB\-F\fR
    1.56 @@ -69,22 +77,32 @@
    1.57  Prints out version information and exits.
    1.58  .SH "EXAMPLES"
    1.59  .LP 
    1.60 -To query the 700 MB media on /dev/sr0:
    1.61 +Query the 700 MB media on /dev/sr0:
    1.62  .IP 
    1.63  cdrestore \-d /dev/sr0 \-l 700 \-q
    1.64  
    1.65  .LP 
    1.66 -To restore a tar archive to the current directory from track 2 of a 702 MB media on /dev/scd0:
    1.67 +Restore a tar archive to the current directory from track 2 of a 702 MB media on /dev/scd0:
    1.68  .IP 
    1.69  cdrestore \-d /dev/scd0 \-l 702 \-t 2 | tar xf \-
    1.70 +
    1.71 +.LP 
    1.72 +Query the contents of a virtual image:
    1.73 +.IP 
    1.74 +cdrestore \-i /tmp/vimage \-l 4488m \-q
    1.75 +
    1.76 +.LP 
    1.77 +Check data integrity of track 3 in a virtual image after dumping it to DVD media:
    1.78 +.IP 
    1.79 +cdrestore \-i /dev/dvd \-t 3 \-T
    1.80  .SH "AUTHORS"
    1.81  .LP 
    1.82 -Stefan Hülswitt <huels@iname.com>
    1.83 +Stefan Hülswitt <s.huelswitt@gmx.de>
    1.84  .SH "SEE ALSO"
    1.85  .LP 
    1.86  \fBcdbackup\fR(1)
    1.87  .SH "LICENSE"
    1.88 -Copyright (c) 2000\-2002 Craig Condit, Stefan Hülswitt.
    1.89 +Copyright (c) 2000\-2004 Craig Condit, Stefan Hülswitt.
    1.90  
    1.91  Redistribution and use in source and binary forms, with or without
    1.92  modification, are permitted provided that the following conditions are met: