aboutsummaryrefslogtreecommitdiff
path: root/bzip2.1
diff options
context:
space:
mode:
authorJulian Seward <jseward@acm.org>2001-12-30 22:13:13 +0100
committerJulian Seward <jseward@acm.org>2001-12-30 22:13:13 +0100
commit099d844292f60f9d58914da29e5773204dc55e7a (patch)
tree04bdb38dbcd894d6fdbbc3253e216d029cade5c6 /bzip2.1
parent795b859eee96c700e8f3c3fe68e6a9a39d95797c (diff)
downloadbzip2-099d844292f60f9d58914da29e5773204dc55e7a.tar.gz
bzip2-099d844292f60f9d58914da29e5773204dc55e7a.tar.bz2
bzip2-099d844292f60f9d58914da29e5773204dc55e7a.zip
bzip2-1.0.2bzip2-1.0.2
Diffstat (limited to 'bzip2.1')
-rw-r--r--bzip2.156
1 files changed, 35 insertions, 21 deletions
diff --git a/bzip2.1 b/bzip2.1
index 7de54a0..623435c 100644
--- a/bzip2.1
+++ b/bzip2.1
@@ -1,7 +1,7 @@
1.PU 1.PU
2.TH bzip2 1 2.TH bzip2 1
3.SH NAME 3.SH NAME
4bzip2, bunzip2 \- a block-sorting file compressor, v1.0 4bzip2, bunzip2 \- a block-sorting file compressor, v1.0.2
5.br 5.br
6bzcat \- decompresses files to stdout 6bzcat \- decompresses files to stdout
7.br 7.br
@@ -197,7 +197,7 @@ to decompress.
197.TP 197.TP
198.B \-z --compress 198.B \-z --compress
199The complement to \-d: forces compression, regardless of the 199The complement to \-d: forces compression, regardless of the
200invokation name. 200invocation name.
201.TP 201.TP
202.B \-t --test 202.B \-t --test
203Check integrity of the specified file(s), but don't decompress them. 203Check integrity of the specified file(s), but don't decompress them.
@@ -211,6 +211,10 @@ existing output files. Also forces
211.I bzip2 211.I bzip2
212to break hard links 212to break hard links
213to files, which it otherwise wouldn't do. 213to files, which it otherwise wouldn't do.
214
215bzip2 normally declines to decompress files which don't have the
216correct magic header bytes. If forced (-f), however, it will pass
217such files through unmodified. This is how GNU gzip behaves.
214.TP 218.TP
215.B \-k --keep 219.B \-k --keep
216Keep (don't delete) input files during compression 220Keep (don't delete) input files during compression
@@ -239,9 +243,13 @@ information which is primarily of interest for diagnostic purposes.
239.B \-L --license -V --version 243.B \-L --license -V --version
240Display the software version, license terms and conditions. 244Display the software version, license terms and conditions.
241.TP 245.TP
242.B \-1 to \-9 246.B \-1 (or \-\-fast) to \-9 (or \-\-best)
243Set the block size to 100 k, 200 k .. 900 k when compressing. Has no 247Set the block size to 100 k, 200 k .. 900 k when compressing. Has no
244effect when decompressing. See MEMORY MANAGEMENT below. 248effect when decompressing. See MEMORY MANAGEMENT below.
249The \-\-fast and \-\-best aliases are primarily for GNU gzip
250compatibility. In particular, \-\-fast doesn't make things
251significantly faster.
252And \-\-best merely selects the default behaviour.
245.TP 253.TP
246.B \-- 254.B \--
247Treats all subsequent arguments as file names, even if they start 255Treats all subsequent arguments as file names, even if they start
@@ -352,11 +360,11 @@ undamaged.
352 360
353.I bzip2recover 361.I bzip2recover
354takes a single argument, the name of the damaged file, 362takes a single argument, the name of the damaged file,
355and writes a number of files "rec0001file.bz2", 363and writes a number of files "rec00001file.bz2",
356"rec0002file.bz2", etc, containing the extracted blocks. 364"rec00002file.bz2", etc, containing the extracted blocks.
357The output filenames are designed so that the use of 365The output filenames are designed so that the use of
358wildcards in subsequent processing -- for example, 366wildcards in subsequent processing -- for example,
359"bzip2 -dc rec*file.bz2 > recovered_data" -- lists the files in 367"bzip2 -dc rec*file.bz2 > recovered_data" -- processes the files in
360the correct order. 368the correct order.
361 369
362.I bzip2recover 370.I bzip2recover
@@ -397,27 +405,31 @@ I/O error messages are not as helpful as they could be.
397tries hard to detect I/O errors and exit cleanly, but the details of 405tries hard to detect I/O errors and exit cleanly, but the details of
398what the problem is sometimes seem rather misleading. 406what the problem is sometimes seem rather misleading.
399 407
400This manual page pertains to version 1.0 of 408This manual page pertains to version 1.0.2 of
401.I bzip2. 409.I bzip2.
402Compressed 410Compressed data created by this version is entirely forwards and
403data created by this version is entirely forwards and backwards 411backwards compatible with the previous public releases, versions
404compatible with the previous public releases, versions 0.1pl2, 0.9.0 4120.1pl2, 0.9.0, 0.9.5, 1.0.0 and 1.0.1, but with the following
405and 0.9.5, 413exception: 0.9.0 and above can correctly decompress multiple
406but with the following exception: 0.9.0 and above can correctly 414concatenated compressed files. 0.1pl2 cannot do this; it will stop
407decompress multiple concatenated compressed files. 0.1pl2 cannot do 415after decompressing just the first file in the stream.
408this; it will stop after decompressing just the first file in the
409stream.
410 416
411.I bzip2recover 417.I bzip2recover
412uses 32-bit integers to represent bit positions in 418versions prior to this one, 1.0.2, used 32-bit integers to represent
413compressed files, so it cannot handle compressed files more than 512 419bit positions in compressed files, so it could not handle compressed
414megabytes long. This could easily be fixed. 420files more than 512 megabytes long. Version 1.0.2 and above uses
42164-bit ints on some platforms which support them (GNU supported
422targets, and Windows). To establish whether or not bzip2recover was
423built with such a limitation, run it without arguments. In any event
424you can build yourself an unlimited version if you can recompile it
425with MaybeUInt64 set to be an unsigned 64-bit integer.
426
427
415 428
416.SH AUTHOR 429.SH AUTHOR
417Julian Seward, jseward@acm.org. 430Julian Seward, jseward@acm.org.
418 431
419http://sourceware.cygnus.com/bzip2 432http://sources.redhat.com/bzip2
420http://www.muraroa.demon.co.uk
421 433
422The ideas embodied in 434The ideas embodied in
423.I bzip2 435.I bzip2
@@ -434,6 +446,8 @@ indebted for their help, support and advice. See the manual in the
434source distribution for pointers to sources of documentation. Christian 446source distribution for pointers to sources of documentation. Christian
435von Roques encouraged me to look for faster sorting algorithms, so as to 447von Roques encouraged me to look for faster sorting algorithms, so as to
436speed up compression. Bela Lubkin encouraged me to improve the 448speed up compression. Bela Lubkin encouraged me to improve the
437worst-case compression performance. Many people sent patches, helped 449worst-case compression performance.
450The bz* scripts are derived from those of GNU gzip.
451Many people sent patches, helped
438with portability problems, lent machines, gave advice and were generally 452with portability problems, lent machines, gave advice and were generally
439helpful. 453helpful.