+++ /dev/null
-.TH WIMLIB-IMAGEX "1" "August 2016" "wimlib 1.10.0" "User Commands"
-.SH NAME
-wimlib-imagex-export \- Exports an image from a WIM archive to an existing or new WIM archive
-.SH SYNOPSIS
-\fBwimlib-imagex export\fR \fISRC_WIMFILE\fR \fISRC_IMAGE\fR
-\fIDEST_WIMFILE\fR [\fIDEST_IMAGE_NAME\fR [\fIDEST_IMAGE_DESCRIPTION\fR]]
-[\fIOPTION\fR...]
-.SH DESCRIPTION
-Copies the specified image in \fISRC_WIMFILE\fR to \fIDEST_WIMFILE\fR,
-optionally changing its name and/or description and/or compression type.
-If \fIDEST_WIMFILE\fR exists, it is taken be a WIM archive to which the image
-will be appended. Otherwise, it is created as a new WIM archive containing only
-the exported image.
-This command is also available as simply \fBwimexport\fR if the appropriate hard
-link or batch file has been installed.
-.PP
-\fISRC_IMAGE\fR specifies the image in \fISRC_WIMFILE\fR to export. It may be a
-1-based index of an image in \fISRC_WIMFILE\fR, the name of an image in
-\fISRC_WIMFILE\fR, or the keyword "all" to indicate that all images in
-\fISRC_WIMFILE\fR are to be exported. Use the \fBwimlib-imagex info\fR (1)
-command to list the images a WIM file contains.
-.PP
-If specified, \fIDEST_IMAGE_NAME\fR is the name to give the image being exported
-to \fIDEST_WIMFILE\fR. The default is its name in \fISRC_WIMFILE\fR.
-\fIDEST_IMAGE_NAME\fR cannot be specified if multiple images are being exported.
-.PP
-If specified, \fIDEST_IMAGE_DESCRIPTION\fR is the description to give the image
-being exported to \fIDEST_WIMFILE\fR. The default is its description in
-\fISRC_WIMFILE\fR.
-.PP
-\fBwimlib-imagex export\fR supports exporting images from stand-alone WIMs as well as
-from split WIMs. However, you cannot export an image to a split WIM. See
-\fBSPLIT WIMS\fR.
-.PP
-\fBwimlib-imagex export\fR also supports exporting images from a non-pipable
-WIM into a (possibly new) pipable WIM, and vice versa. Furthermore, it will
-export a pipable WIM directly to standard output if "-" is specified as
-\fIDEST_WIMFILE\fR (this implies \fB--pipable\fR). See \fB--pipable\fR and
-\fB--not-pipable\fR.
-.PP
-.SH OPTIONS
-.TP 6
-\fB--boot\fR
-Specifies that the exported image is to be the bootable image of the destination
-WIM archive.
-.IP ""
-If multiple images are being exported, this flag indicates that the image in the
-\fISRC_WIMFILE\fR that is currently marked as bootable is to be made bootable in
-\fIDEST_WIMFILE\fR. If no image in \fISRC_WIMFILE\fR is bootable, it is an
-error.
-.TP
-\fB--check\fR
-When reading \fISRC_WIMFILE\fR, and \fIDEST_WIMFILE\fR if it exists, verify the
-file's integrity if the integrity table is present; additionally, when writing
-\fIDEST_WIMFILE\fR with the new image(s) added, write an integrity table.
-If neither \fB--check\fR nor \fB--nocheck\fR is specified, an integrity
-table is included in \fIDEST_WIMFILE\fR if and only if \fIDEST_WIMFILE\fR
-already existed and it had an integrity table before.
-.TP
-\fB--nocheck\fR
-When writing \fIDEST_WIMFILE\fR with the new image(s) added, do not write an
-integrity table.
-If neither \fB--check\fR nor \fB--nocheck\fR is specified, an integrity
-table is included in \fIDEST_WIMFILE\fR if and only if \fIDEST_WIMFILE\fR
-already existed and it had an integrity table before.
-.TP
-\fB--compress\fR=\fITYPE\fR[:\fILEVEL\fR]
-Specifies the compression type, and optionally the compression level for that
-compression type, for \fIDEST_WIMFILE\fR. Setting the compression type only has
-an effect if \fIDEST_WIMFILE\fR does not yet exist, since if \fIDEST_WIMFILE\fR
-exists, the compression type must be the same as that of \fIDEST_WIMFILE\fR.
-.IP ""
-See the documentation for this option to \fBwimlib-imagex capture\fR (1) for
-more details.
-.TP
-\fB--recompress\fR
-Force all exported data to be recompressed, even if the destination WIM will use
-the same compression type as the source WIM.
-.TP
-\fB--chunk-size\fR=\fISIZE\fR
-Set the WIM compression chunk size to \fISIZE\fR. See the documentation for
-this option to \fBwimlib-imagex capture\fR (1) for more details.
-.TP
-\fB--solid\fR
-Create a "solid" archive that compresses multiple files together. This can
-result in a higher compression ratio, but has disadvantages such as reduced
-compatibility. See the documentation for this option to \fBwimlib-imagex
-capture\fR (1) for more details.
-.TP
-\fB--solid-chunk-size\fR=\fISIZE\fR
-Like \fB--chunk-size\fR, but set the chunk size used in solid resources. See the
-documentation for this option to \fBwimlib-imagex capture\fR (1) for more
-details.
-.TP
-\fB--solid-compress\fR=\fITYPE\fR[:\fILEVEL\fR]
-Like \fB--compress\fR, but set the compression type used in solid resources. See
-the documentation for this option to \fBwimlib-imagex capture\fR (1) for
-more details.
-.TP
-\fB--threads\fR=\fINUM_THREADS\fR
-Number of threads to use for compressing data. Default: autodetect (number of
-processors). Note: multiple compressor threads are not very useful when
-exporting to a WIM with the same compression type as the source WIM, since
-wimlib optimizes this case by re-using the raw compressed data.
-.TP
-\fB--rebuild\fR
-When exporting image(s) to an existing WIM: rebuild the entire WIM rather than
-appending data to the end of it. Rebuilding the WIM is slower, but will save a
-little bit of space that would otherwise be left as a hole in the WIM. Also see
-\fBwimlib-imagex optimize\fR.
-.TP
-\fB--ref\fR="\fIGLOB\fR"
-File glob of additional WIMs or split WIM parts to reference resources from.
-See \fBSPLIT_WIMS\fR. This option can be specified multiple times. Note:
-\fIGLOB\fR is listed in quotes because it is interpreted by
-\fBwimlib-imagex\fR and may need to be quoted to protect against shell
-expansion.
-.TP
-\fB--pipable\fR
-Build, or rebuild, \fIDEST_WIMFILE\fR as a "pipable WIM" so that it can be
-applied fully sequentially, including from a pipe. See \fBwimlib-imagex
-capture\fR(1) for more details about creating pipable WIMs. The default without
-this option is to make \fIDEST_WIMFILE\fR pipable if and only if it already
-existed and was already pipable, or was "-" (standard output).
-.TP
-\fB--not-pipable\fR
-Build, or rebuild, \fIDEST_WIMFILE\fR as a normal, non-pipable WIM. This is the
-default behavior, unless \fIDEST_WIMFILE\fR already existed and was already
-pipable, or if \fIDEST_WIMFILE\fR was "-" (standard output).
-.TP
-\fB--wimboot\fR
-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,
-while the additional parts of the split WIM must be specified in one or more
-\fB--ref\fR="\fIGLOB\fR" options. Since globbing is built into the \fB--ref\fR
-option, typically only one \fB--ref\fR option is necessary. For example, the
-names for the split WIM parts usually go something like:
-.PP
-.RS
-.nf
-mywim.swm
-mywim2.swm
-mywim3.swm
-mywim4.swm
-mywim5.swm
-.RE
-.PP
-To export the first image of this split WIM to a new or existing WIM file
-"other.wim", run:
-.PP
-.RS
-wimlib-imagex export mywim.swm 1 other.wim --ref="mywim*.swm"
-.RE
-.SH NOTES
-\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
-present in the destination WIM will be copied. However, a new copy of the
-image's metadata resource, which describes the full directory structure, will
-always be created.
-.PP
-\fIESD files\fR: wimlib v1.6.0 and later can export images from version 3584
-WIMs, which usually contain LZMS-compressed solid resources and may carry the
-\fI.esd\fR file extension rather than \fI.wim\fR. However, \fI.esd\fR files
-downloaded directly by the Windows 8 web downloader have encrypted segments, and
-wimlib cannot export images from such files until they are first decrypted. In
-addition, to ensure the destination archive is created in the original WIM
-format rather than in the newer format, specify \fB--compress\fR=\fILZX\fR (or
-\fB--compress\fR=\fImaximum\fR).
-.SH EXAMPLES
-Export the second image of 'boot.wim' to the new WIM file 'new.wim':
-.RS
-.PP
-wimlib-imagex export boot.wim 2 new.wim
-.RE
-.PP
-The above example creates "new.wim" with the same compression type as
-"boot.wim". If you wish to change the compression type, specify
-\fB--compress\fR=\fITYPE\fR; for example:
-.RS
-.PP
-wimlib-imagex export boot.wim 2 new.wim --compress=LZX
-.RE
-.PP
-Export "ESD to WIM" --- that is, solid WIM to non-solid WIM:
-.RS
-.PP
-wimlib-imagex export install.esd all install.wim --compress=LZX
-.RE
-.PP
-Export "WIM to ESD" --- that is, non-solid WIM to solid WIM:
-.RS
-.PP
-wimlib-imagex export install.wim all install.esd --solid
-.RE
-.PP
-.SH SEE ALSO
-.BR wimlib-imagex (1)
-.BR wimlib-imagex-info (1)
-.BR wimlib-imagex-optimize (1)
git://wimlib.net / wimlib / blobdiff