X-Git-Url: https://wimlib.net/git/?p=wimlib;a=blobdiff_plain;f=doc%2Fman1%2Fwimlib-imagex-export.1;h=198b5044ac21ed319c0a7c3d277952212278402f;hp=78bf8f03ba00d87574c19f98c6c9799daf2f8b6b;hb=4e0e062e081fcbb6a660084308287926c52c9353;hpb=c7a6a38f0b0146eeff7b6f4c0d00501166a11e8c;ds=sidebyside diff --git a/doc/man1/wimlib-imagex-export.1 b/doc/man1/wimlib-imagex-export.1 index 78bf8f03..198b5044 100644 --- a/doc/man1/wimlib-imagex-export.1 +++ b/doc/man1/wimlib-imagex-export.1 @@ -1,4 +1,4 @@ -.TH WIMLIB-IMAGEX "1" "February 2015" "wimlib 1.8.0" "User Commands" +.TH WIMLIB-IMAGEX "1" "January 2016" "wimlib 1.9.0" "User Commands" .SH NAME wimlib-imagex-export \- Exports an image from a WIM archive to an existing or new WIM archive .SH SYNOPSIS @@ -132,6 +132,12 @@ pipable, or if \fIDEST_WIMFILE\fR was "-" (standard output). Mark the destination image as WIMBoot-compatible. Also, if exporting to a new archive, set the compression type to that recommended for WIMBoot (currently, XPRESS with 4096 byte chunks). +.TP +\fB--unsafe-compact\fR +Compact the WIM archive in-place and append any new data, eliminating "holes". +In general, this option should \fInot\fR be used because a failed or interrupted +compaction will corrupt the WIM archive. For more information, see the +documentation for this option in \fBwimlib-imagex-optimize\fR (1). .SH SPLIT WIMS You may use \fBwimlib-imagex export\fR to export images from a split WIM. The \fISRC_WIMFILE\fR argument must specify the first part of the split WIM, @@ -156,12 +162,13 @@ To export the first image of this split WIM to a new or existing WIM file wimlib-imagex export mywim.swm 1 other.wim --ref="mywim*.swm" .RE .SH NOTES -\fIData integrity\fR: It is safe to abort a \fBwimlib-imagex export\fR command partway through. -However, after doing this, it is recommended to run \fBwimlib-imagex -optimize\fR on the destination WIM to remove any data that was appended to the -physical WIM file but not yet incorporated into the structure of the WIM, unless -the WIM was being rebuilt (e.g. with \fB--rebuild\fR), in which case you should -delete the temporary file left over. +\fIData integrity\fR: Except when using \fB--unsafe-compact\fR, it is safe to +abort a \fBwimlib-imagex export\fR command partway through. However, after +doing this, it is recommended to run \fBwimlib-imagex optimize\fR on the +destination WIM to remove any data that was appended to the physical WIM file +but not yet incorporated into the structure of the WIM, unless the WIM was being +rebuilt (e.g. with \fB--rebuild\fR), in which case you should delete the +temporary file left over. .PP \fISingle instancing\fR: The WIM format uses single-instance streams (roughly, "files"). When an image is exported, only the streams ("files") not already