X-Git-Url: https://wimlib.net/git/?a=blobdiff_plain;f=doc%2Fimagex-capture.1.in;h=25212292072f4f2f3aa227146a57c9997de3a2fd;hb=56f881eba91349abe40dd250ecbf08310cb88ce8;hp=76ef71f10187a6c90ef28598f9f093236af3122f;hpb=ee12326ac5a4259892b98d65c54905744adacf2b;p=wimlib diff --git a/doc/imagex-capture.1.in b/doc/imagex-capture.1.in index 76ef71f1..25212292 100644 --- a/doc/imagex-capture.1.in +++ b/doc/imagex-capture.1.in @@ -1,4 +1,4 @@ -.TH WIMLIB-IMAGEX "1" "January 2014" "@IMAGEX_PROGNAME@ @VERSION@" "User Commands" +.TH WIMLIB-IMAGEX "1" "March 2014" "@IMAGEX_PROGNAME@ @VERSION@" "User Commands" .SH NAME @IMAGEX_PROGNAME@-capture, @IMAGEX_PROGNAME@-append \- Create or append a WIM image .SH SYNOPSIS @@ -225,7 +225,7 @@ decide to use this option regardless, you may choose a chunk size that is a power of 2 greater than or equal to 2^15 (32768) up to a maximum determined by the compression format. For LZX ("maximum") compression, the maximum allowed chunk size is 2^21 (2097152), and for XPRESS ("fast") and LZMS ("recovery") -compression, the maximum allowed chunk size is 2^26 (67108864). +compression, the maximum allowed chunk size is 2^30 (1073741824). .IP "" For XPRESS and LZX compression, Microsoft's implementation (as of Windows 8) does not appear to support alternate chunk sizes; although it will still open @@ -248,7 +248,18 @@ Packed resources use a compression type and chunk size that is independent of the WIM's "default compression type" and "default chunk size" (which may be adjusted by the \fB--compress\fR and \fB--chunk-size\fR options, respectively). For compatibility reasons, \fB@IMAGEX_PROGNAME@ capture\fR currently has no -option to change the compression type or chunk size used in packed resources. +option to change the compression type used in packed resources; however, the +\fB--pack-chunk-size\fR option may be used to set the chunk size. +.TP +\fB--pack-chunk-size\fR=\fISIZE\fR, \fB--solid-chunk-size\fR=\fISIZE\fR +Like \fB--chunk-size\fR, but set the chunk size used in packed resources. The +compression format is LZMS, so the chunk size can be any power of 2 between 2^15 +and 2^30, inclusively. WIMGAPI (Windows 8) appears to be compatible with these +sizes up to 2^26 inclusively, despite not being compatible with sizes greater +than 2^20 in non-packed resources. The default is currently 2^25 (33554432). +Note: currently, the LZMS compression algorithm uses about 15 times the chunk +size in memory per thread, which is about 500 MB per thread for the default pack +chunk size of 2^25 or 1 GB per thread if you change it to 2^26 (67108864). .TP \fB--threads\fR=\fINUM_THREADS\fR Number of threads to use for compressing data. Default: autodetect (number of