X-Git-Url: https://wimlib.net/git/?p=wimlib;a=blobdiff_plain;f=doc%2Fimagex-optimize.1.in;h=8ccbaa7dcb5c2a7c5957f20fb976dc28eace2457;hp=9a575aa87037d8aff6e6c380b3b1cf53fc280718;hb=2254a0fc3f1d7af1151ee83f3458f44339b5028b;hpb=1a8b4a9f6e24d3ebbd75a86f73955e0f3f5e1785 diff --git a/doc/imagex-optimize.1.in b/doc/imagex-optimize.1.in index 9a575aa8..8ccbaa7d 100644 --- a/doc/imagex-optimize.1.in +++ b/doc/imagex-optimize.1.in @@ -1,8 +1,8 @@ -.TH IMAGEX "1" "June 2013" "@IMAGEX_PROGNAME@ @VERSION@" "User Commands" +.TH WIMLIB-IMAGEX "1" "October 2013" "@IMAGEX_PROGNAME@ @VERSION@" "User Commands" .SH NAME @IMAGEX_PROGNAME@-optimize \- Optimize a WIM archive .SH SYNOPSIS -\fB@IMAGEX_PROGNAME@ optimize\fR \fIWIMFILE\fR [--check] [--recompress] +\fB@IMAGEX_PROGNAME@ optimize\fR \fIWIMFILE\fR [\fIOPTION\fR...] .SH DESCRIPTION \fB@IMAGEX_PROGNAME@ optimize\fR will rebuild the stand-alone WIM \fIWIMFILE\fR. The new WIM is written to a temporary file, and it is renamed to the original file when @@ -10,13 +10,20 @@ it's ready. This action will remove any holes that have been left as a result of appending images, so the new WIM may be slightly smaller than the old WIM. In addition, some errors in the original WIM may be fixed by re-writing it (although most cannot). +This command is also available as simply \fBwimoptimize\fR if the appropriate +hard link or batch file has been installed. .SH OPTIONS .TP 6 \fB--check\fR -When reading \fIWIMFILE\fR, verify its integrity if the integrity table is -present; in addition, include an integrity table in the optimized WIM. If this -option is not specified, no integrity table is included in the optimized WIM, -even if there was one in the original WIM. +When reading \fIWIMFILE\fR, verify its integrity if an integrity table is +present. In addition, include an integrity table in the optimized WIM. If this +option is not specified, by default the integrity table (if present) is not +checked, and an integrity table is included in the rebuilt WIM if and only if +one was present in the original WIM. +.TP +\fB--nocheck\fR +Neither verify the integrity of \fIWIMFILE\fR using the integrity table, nor +include an integrity table in the rebuilt WIM file. .TP \fB--recompress\fR Recompress all compressed streams in \fIWIMFILE\fR when rebuilding it. This @@ -32,17 +39,37 @@ a slightly worse LZX compression ratio than Microsoft's software. So, you may not want to specify \fB--recompress\fR when optimizing a LZX-compressed WIM created on Windows with Microsoft's ImageX. .TP +\fB--compress-slow\fR +With \fB--recompress\fR: Spend even more time compressing the data in order to +achieve a higher compression ratio. Currently, this only has an effect with LZX +("maximum") compression. Depending on the data, compressing with this option +will take around 10 to 15 times longer and produce a LZX-compressed WIM about 1% +to 5% smaller than one produced with the default LZX compressor. Depending on +the data, the resulting WIM may be approximately the same size (typically no +more than 0.4% different) as a LZX-compressed WIM produced by WIMGAPI. +.TP \fB--threads\fR=\fINUM_THREADS\fR Number of threads to use for compressing data. Default: autodetect (number of processors). This parameter is only meaningful when \fB--recompress\fR is also specified. +.TP +\fB--pipable\fR +Rebuild the WIM so that it can be applied fully sequentially, including from a +pipe. See \fB@IMAGEX_PROGNAME@ capture\fR(1) for more details about creating +pipable WIMs. By default, when neither \fB--pipable\fR or \fB--not-pipable\fR +is specified, the rebuilt WIM will be pipable if and only if it was already +pipable. +.TP +\fB--not-pipable\fR +Rebuild the WIM in the non-pipable format. (This is the default if +\fIWIMFILE\fR is not pipable.) .SH NOTES \fB@IMAGEX_PROGNAME@ optimize\fR does not support split WIMs. .PP \fB@IMAGEX_PROGNAME@ optimize\fR is roughly equivalent to: .RS .PP -\fB@IMAGEX_PROGNAME@ export\fR \fIWIMFILE\fR all tmp.wim [--check] && mv tmp.wim \fIWIMFILE\fR +\fB@IMAGEX_PROGNAME@ export\fR \fIWIMFILE\fR all tmp.wim && mv tmp.wim \fIWIMFILE\fR .RE .PP .SH SEE ALSO