mirror of
https://github.com/fadden/nulib2.git
synced 2024-05-28 08:41:29 +00:00
Fixed up the usage info for "launder".
This commit is contained in:
parent
7e0ad70cc2
commit
91248976d7
|
@ -543,7 +543,7 @@ Usage(const char* argv0)
|
||||||
fprintf(stderr, "\t-r : copy threads in reverse order to test ordering\n");
|
fprintf(stderr, "\t-r : copy threads in reverse order to test ordering\n");
|
||||||
fprintf(stderr, "\t-f : call Flush frequently to reduce memory usage\n");
|
fprintf(stderr, "\t-f : call Flush frequently to reduce memory usage\n");
|
||||||
fprintf(stderr, "\t-a : exercise nufxlib Abort code frequently\n");
|
fprintf(stderr, "\t-a : exercise nufxlib Abort code frequently\n");
|
||||||
fprintf(stderr, "\t-t : force use of temp file\n");
|
fprintf(stderr, "\t-t : write to temp file instead of directly to outfile.shk\n");
|
||||||
fprintf(stderr,
|
fprintf(stderr,
|
||||||
"\t[method] is one of {sq,lzw1,lzw2,lzc12,lzc16,deflate,bzip2}\n");
|
"\t[method] is one of {sq,lzw1,lzw2,lzc12,lzc16,deflate,bzip2}\n");
|
||||||
fprintf(stderr, "\tIf not specified, method defaults to lzw2\n");
|
fprintf(stderr, "\tIf not specified, method defaults to lzw2\n");
|
||||||
|
|
|
@ -52,27 +52,34 @@ lists are stripped out, etc).
|
||||||
|
|
||||||
The basic usage is:
|
The basic usage is:
|
||||||
|
|
||||||
% launder [-crfa] infile.shk outfile.shk
|
% launder [-crfa] [-m method] infile.shk outfile.shk
|
||||||
|
|
||||||
The flags are:
|
The flags are:
|
||||||
|
|
||||||
-c Just copy threads rather than recompressing them
|
-c Just copy data threads rather than recompressing them
|
||||||
-r Add threads in reverse order
|
-r Add threads in reverse order
|
||||||
-f Call NuFlush after every record
|
-f Call NuFlush after every record
|
||||||
-a Call NuAbort after every record, then re-do the record and call NuFlush
|
-a Call NuAbort after every record, then re-do the record and call NuFlush
|
||||||
-t Write to temp file, instead of writing directly into outfile.shk
|
-t Write to temp file, instead of writing directly into outfile.shk
|
||||||
|
|
||||||
If you use the "-c" flag with an archive created by P8 ShrinkIt or NuLib,
|
The "-m method" flag allows you to specify the compression method. Valid
|
||||||
the laundered archive may have CRC failures. This is because "launder"
|
values are sq (SQueeze), lzw1 (ShrinkIt LZW/1), lzw2 (ShrinkIt LZW/2),
|
||||||
creates version 3 records, which are expected to have a valid CRC in the
|
lzc12 (12-bit UNIX "compress"), lzc16 (16-bit UNIX "compress"), deflate
|
||||||
thread header. The only way to compute the CRC is to uncompress the data,
|
(zlib deflate), and bzip2 (libbz2 compression). The default is lzw2.
|
||||||
which "launder" doesn't do when "-c" is set. The data itself is fine,
|
|
||||||
it's just the thread CRC that's wrong (if the data were hosed, the LZW/1
|
|
||||||
CRC would be bad too). "launder" will issue a warning when it detects
|
|
||||||
this situation.
|
|
||||||
|
|
||||||
If you find that you're running out of memory on very large archives, you
|
If you use the "-c" flag with an archive created by P8 ShrinkIt or NuLib,
|
||||||
can reduce the memory requirements by specifying the "-f" flag.
|
the laundered archive may have CRC failures when you try to extract
|
||||||
|
from it. This is because "launder" creates version 3 records, which
|
||||||
|
are expected to have a valid CRC in the thread header. The only way
|
||||||
|
to compute the CRC is to uncompress the data, which "launder" doesn't
|
||||||
|
do when "-c" is set. The data itself is fine, it's just the thread CRC
|
||||||
|
that's wrong (if the data were hosed, the LZW/1 CRC would be bad too).
|
||||||
|
"launder" will issue a warning when it detects this situation.
|
||||||
|
|
||||||
|
By default, launder will try to keep the entire archive in memory and flush
|
||||||
|
all of the operations at the end. If you find that you're running out
|
||||||
|
of memory on very large archives, you can reduce the memory requirements
|
||||||
|
by specifying the "-f" flag.
|
||||||
|
|
||||||
|
|
||||||
test-simple
|
test-simple
|
||||||
|
|
Loading…
Reference in New Issue
Block a user