This file describes the usage of unzsplit.

Please notice in order to access devices or files your 
should have read/write rights.

Unzsplit

unzsplit - will read splitted files produced by zsplit, 
glue and decompress them to its origin.

usage: unzsplit [OPTIONS] SOURCE

Reads from SOURCE, which can be one, or a list of 
splitted and compressed files produced by zsplit, 
make decompress and glue them in a right order together. The result of operation is the uncompressed original big file or restored device. To read the list of files it is sufficient to use a common part of the file names as a SOURCE. Unzsplit recognizes all files which belong to the list and the right order of reading of file-chunks if file names remain the same as created by zsplit (see example). It is absolutely necessarily that the file name contains the end part: _[digit].spl.zp (such as: _0.spl.zp or _1.spl.zp ...) because this [digit] is used to find a right reading order of file chunks. The [digit] of the first file should always be 0.

unzsplit returns 0 if during the operation no error 
was detected, otherwise -1.

SOURCE: can be a file (example: some_name_0.spl.zp), 
a file list (example: some_name_0.spl.zp, some_name_1.spl.zp, ...) 
or stdin (-). "some_name" is a common part of names of the file list.

OPTIONS:

-b, --buffer SIZE: Setup read/write buffer SIZE (in kibibytes) to optimize read/write speed.
Example of SIZE: 2 (2048 bytes).
If this option is not used, the default size is 64 (65536 bytes).

-c, --stdout : Write output to stdout (standard output).

-D, --outdev : Write output to output device.

-d, --debug : Debug information will be written into the debug.log 
file in the current directory If this option is not used, the debug 
information will be printed to stderr.

-i, --indir DIR : Input directory (DIR is directory which containes the SOURCE).

-m, --multivol : Switch the multivolume feature on.

-N, --outname OUT_NAME : The name of the output file.

-h, --help : Shows this message.

-o, --outdir DIR : Output directory 
(DIR is directory which containes the output files).

-r, --noerror: If during the read operation I/O error 
happens, safely ignore these errors and read farther.

EXAMPLES:

unzsplit -D /dev/hda -d WinXP_bkp 

unzsplit reads the file list in a current 
directory with a common name-part WinXP_bkp, such as: 
WinXP_bkp_0.spl.zp, WinXP_bkp_1.spl.zp, WinXP_bkp_2.spl.zp ..., 
uncompresses and glue them together to one image, and restore this image to the device /dev/hda. The debug information is written into the debug.log file in the current directory.

unzsplit -N test_img -o /home/user -d - 

unzsplit reads from stdin, decompresses using 
default decompression method, creates an uncompressed 
image file test_img.img into the directory /home/user 
and writes the debug information to the debug.log 
file in the current directory.

unzsplit -N test_bkp WinXP_bkp 

unzsplit reads list of files with a common name-part 
WinXP_bkp in a current directory, decompresses 
using default decompression method, ties all 
uncompressed parts in a right order together, 
saves the output file as test_bkp.img in the current 
directory and writes the debug information to the 
console (stderr).