default) and LZMS ("recovery") compression.
.TP
\fB--chunk-size\fR=\fISIZE\fR
-Set the WIM compression chunk size to \fISIZE\fR. Larger chunks mean larger
+Set the WIM compression chunk size to \fISIZE\fR bytes. Larger chunks mean larger
LZ77 dictionaries and better compression ratios on sufficiently large files, but
slower random access. \fBUsing this option is generally not recommended because
of the compatibility limitations detailed in the next paragraph.\fR But if you
-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^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
-such files, it will crash, extract the data incorrectly, or report that the data
-is invalid. For LZMS compression, Microsoft's implementation (as of Windows 8)
-appears to only support chunk sizes that are powers of 2 between 2^15 (32768)
-and 2^20 (1048576) inclusively. In addition, wimlib versions before 1.6.0 do
-not support alternate chunk sizes.
+decide to use this option regardless, you may choose a chunk size that is
+allowed by the compression format. All formats only allow power-of-2 chunk
+sizes. For LZX ("maximum") compression the maximum allowed chunk size is 2^21
+(2097152), for XPRESS ("fast") compression the maximum allowed chunk size is
+2^26 (67108864), and for LZMS ("recovery") compression the maximum allowed chunk
+size is 2^30 (1073741824).
+.IP ""
+Beware that Microsoft's implementation has limited support for non-default chunk
+sizes. Depending on the version, their software may refuse to open the WIM, or
+open it and crash, or open it and report the data is invalid, or even extract
+the data incorrectly. In addition, wimlib versions before 1.6.0 do not support
+alternate chunk sizes.
.TP
\fB--pack-streams\fR, \fB--solid\fR
Create a "solid" archive that compresses multiple unique streams ("files")
option use a different version number in their header and as of Windows 8 are
only compatible with Windows Setup and WIMGAPI, not even ImageX and Dism.
.IP ""
-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 used in packed resources; however, the
-\fB--pack-chunk-size\fR option may be used to set the chunk size.
+The default compression type and chunk size in packed resources is LZMS with
+2^25 (33554432) byte chunks. This is independent of the WIM's main compression
+type and 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).
+default is LZMS compression with 2^25 (33554432) byte chunks. This option only
+has an effect when \fB--pack-streams\fR is also specified. For maximum
+compatibility with the Microsoft implementation, do not use either of these
+options.
+.TP
+\fB--pack-compress\fR=\fITYPE\fR, \fB--solid-compress\fR=\fITYPE\fR
+Like \fB--compress\fR, but set the compression format used in packed resources.
+The default is LZMS compression with 2^25 (33554432) byte chunks. This option
+only has an effect when \fB--pack-streams\fR is also specified. For maximum
+compatibility with the Microsoft implementation, do not use either of these
+options.
.TP
\fB--threads\fR=\fINUM_THREADS\fR
Number of threads to use for compressing data. Default: autodetect (number of
to, rather than archiving the links themselves.
.TP
\fB--config\fR=\fIFILE\fR
-Specifies a configuration file for capturing the new image. The configuration
-file specifies files that are to be treated specially during the image capture.
+Specifies a configuration file (UTF-8 or UTF-16LE encoded) for capturing the new
+image. The configuration file specifies files that are to be treated specially
+during the image capture.
.IP ""
The format of the configuration file is a number of sections containing path
globs one per line, where each section begins with the tag [ExclusionList],
.IP ""
For compatibility with Windows, the path separators in the globs may be either
forward slashes or backslashes, and the line separators may be either UNIX-style
-or DOS-style. Globs with spaces in them must be quoted, and leading and
-trailing whitespace is not significant. Empty lines and lines beginning with
-\'#' or whitespace followed by '#' are ignored.
+or DOS-style. Trailing and leading whitespace is ignored. Lines beginning with
+the '#' or ';' characters are treated as comments and ignored. Globs with
+whitespace in them need not be quoted, unless the whitespace is leading or
+trailing. Both double and single quotes are accepted.
.IP ""
Paths may not have drive letters in them, as they are all relative to the root
of capture and not absolute external paths.
\\$ntfs.log
\\hiberfil.sys
\\pagefile.sys
-"\\System Volume Information"
+\\System Volume Information
\\RECYCLER
\\Windows\\CSC
.RE
pipe after the delta WIM.
.TP
\fB--wimboot\fR
-Windows only: mark the image as WIMBoot-compatible. See Microsoft's
+Mark the image as WIMBoot-compatible. See Microsoft's
documentation for more information about WIMBoot. This option will, by default,
change the compression type to XPRESS and the chunk size to 4096 bytes; these
can, however, still be overridden through the \fB--compress\fR and
git://wimlib.net / wimlib / blobdiff