]> git.wh0rd.org - dump.git/blobdiff - dump/dump.8.in
Fixed -F to be run even if -M/-f is in use.
[dump.git] / dump / dump.8.in
index 13b1e52ee2611f5e24c604e6e985acf46dba5191..1245d849325163b82d1fb1ce4be7836a20fe79bf 100644 (file)
@@ -26,7 +26,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"    $Id: dump.8.in,v 1.51 2003/03/30 15:40:35 stelian Exp $
+.\"    $Id: dump.8.in,v 1.55 2004/02/18 16:26:41 stelian Exp $
 .\"
 .TH DUMP 8 "version __VERSION__ of __DATE__" BSD "System management commands"
 .SH NAME
@@ -50,6 +50,7 @@ dump \- ext2/3 filesystem backup
 [\fB\-Q \fIfile\fR]
 [\fB\-s \fIfeet\fR]
 [\fB\-T \fIdate\fR]
+[\fB\-y\fR]
 [\fB\-z\fIcompression level\fR]
 .I files-to-dump
 .PP
@@ -112,8 +113,11 @@ to be used by
 to determine whether a file is in the dump file that is being restored.
 .TP
 .BI \-b " blocksize"
-The number of kilobytes per dump record. The default blocksize is 10
-and the maximal value is 1024.
+The number of kilobytes per dump record. The default blocksize is 10,
+unless the
+.B \-d
+option has been used to specify a tape density of 6250BPI or more,
+in which case the default blocksize is 32. Th maximal value is 1024.
 Note however that, since the IO system slices all requests into chunks
 of 
 .B MAXBSIZE
@@ -130,7 +134,15 @@ can detect end-of-media. When the specified size is reached,
 .B dump
 waits for you to change the volume.  This option overrides the calculation of 
 tape size based on length and density. If compression is on this limits the 
-size of the compressed output per volume.
+size of the compressed output per volume.  Multiple values may be given
+as a single argument separated by commas.  Each value will be used for one
+dump volume in the order listed; if
+.B dump
+creates more volumes than the
+number of values given, the last value will be used for the remaining
+volumes. This is useful for filling up already partially filled media
+(and then continuing with full size volumes on empty media) or mixing media
+of different sizes.
 .TP
 .BI \-c
 Change the defaults for use with a cartridge tape drive, with a density of 8000
@@ -183,7 +195,8 @@ media changes. If the name of the file is of the form
 or
 .I user@host:file
 .B dump
-writes to the named file on the remote host using
+writes to the named file on the remote host (which should already 
+exist, dump doesn't create a new remote file) using
 .BR rmt (8).
 The default path name of the remote
 .BR rmt (8)
@@ -436,6 +449,16 @@ and
 .I /etc/fstab
 which need to be dumped.
 .TP
+.BI \-y
+Compress every block to be written to the tape using the lzo library.
+This doesn't compress as well as the zlib library but it's much faster.
+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.4b34 version of
+.B restore
+in order to extract compressed tapes. Tapes written using compression will not
+be compatible with the BSD tape format.
+.TP
 .BI \-z "compression level"
 Compress every block to be written on the tape using zlib library. This option
 will work only when dumping to a file or pipe or, when dumping to a tape drive,