summaryrefslogtreecommitdiffstats
path: root/doc/lziprecover.texinfo
diff options
context:
space:
mode:
Diffstat (limited to 'doc/lziprecover.texinfo')
-rw-r--r--doc/lziprecover.texinfo36
1 files changed, 26 insertions, 10 deletions
diff --git a/doc/lziprecover.texinfo b/doc/lziprecover.texinfo
index 9086787..22eea8a 100644
--- a/doc/lziprecover.texinfo
+++ b/doc/lziprecover.texinfo
@@ -1,12 +1,13 @@
\input texinfo @c -*-texinfo-*-
@c %**start of header
@setfilename lziprecover.info
+@documentencoding ISO-8859-15
@settitle Lziprecover Manual
@finalout
@c %**end of header
-@set UPDATED 20 November 2011
-@set VERSION 1.13-rc2
+@set UPDATED 24 February 2012
+@set VERSION 1.13
@dircategory Data Compression
@direntry
@@ -43,7 +44,7 @@ This manual is for Lziprecover (version @value{VERSION}, @value{UPDATED}).
@end menu
@sp 1
-Copyright @copyright{} 2009, 2010, 2011 Antonio Diaz Diaz.
+Copyright @copyright{} 2009, 2010, 2011, 2012 Antonio Diaz Diaz.
This manual is free documentation: you have unlimited permission
to copy, distribute and modify it.
@@ -64,6 +65,13 @@ the compressors in the lzip family; lzip, plzip, minilzip/lzlib, clzip
and pdlzip. This recovery capability contributes to make the lzip format
one of the best options for long-term data archiving.
+Lziprecover is able to efficiently extract a range of bytes from a
+multi-member file, because it only decompresses the members containing
+the desired data.
+
+Lziprecover can print correct total file sizes and ratios even for
+multi-member files.
+
When recovering data, lziprecover takes as arguments the names of the
damaged files and writes zero or more recovered files depending on the
operation selected and whether the recovery succeeded or not. The
@@ -133,7 +141,7 @@ produced bytes are sent to standard output unless the @samp{--output}
option is used. In order to guarantee the correctness of the data
produced, all members containing any part of the desired data are
decompressed and their integrity is verified. This operation is more
-efficient in multimember files because it only decompresses the members
+efficient in multi-member files because it only decompresses the members
containing the desired data.
@item -f
@@ -147,7 +155,7 @@ Keep (don't delete) input files during decompression.
@item -l
@itemx --list
Print total file sizes and ratios. The values produced are correct even
-for multimember files.
+for multi-member files.
@item -m
@itemx --merge
@@ -295,7 +303,7 @@ Size of the uncompressed original data.
@item Member size (8 bytes)
Total size of the member, including header and trailer. This facilitates
-safe recovery of undamaged members from multimember files.
+safe recovery of undamaged members from multi-member files.
@end table
@@ -327,7 +335,7 @@ Example 3: Decompress @samp{file.lz} partially until 10KiB of
decompressed data are produced.
@example
-lziprecover -cd file.lz | dd bs=1024 count=10
+lziprecover -D 10KiB file.lz
@end example
@sp 1
@@ -336,7 +344,7 @@ Example 4: Decompress @samp{file.lz} partially from decompressed byte
10000 to decompressed byte 15000 (5000 bytes are produced).
@example
-lziprecover -cd file.lz | dd bs=1000 skip=10 count=5
+lziprecover -D 10000-15000 file.lz
@end example
@sp 1
@@ -365,8 +373,16 @@ lziprecover -tv rec*file.lz
@sp 1
@anchor{ddrescue-example}
@noindent
-Example 7: Recover a compressed backup from two copies on CD-ROM (see
-the GNU ddrescue manual for details about ddrescue)
+Example 7: Recover a compressed backup from two copies on CD-ROM with
+error-checked merging of copies
+@ifnothtml
+(@xref{Top,GNU ddrescue manual,,ddrescue},
+@end ifnothtml
+@ifhtml
+(See the
+@uref{http://www.gnu.org/software/ddrescue/manual/ddrescue_manual.html,,ddrescue manual}
+@end ifhtml
+for details about ddrescue).
@example
ddrescue -b2048 /dev/cdrom cdimage1 logfile1