wimlib-imagex-export.pdf

(10 KB) Pobierz
WIMLIB-IMAGEX(1)
User Commands
WIMLIB-IMAGEX(1)
NAME
wimlib-imagex-export − Exports an image from a WIM archive to an existing or new WIM archive
SYNOPSIS
wimlib-imagex export
SRC_WIMFILE SRC_IMAGE
[DEST_IMAGE_DESCRIPTION]] [OPTION...]
DEST_WIMFILE
[DEST_IMAGE_NAME
DESCRIPTION
Copies the specified image in
SRC_WIMFILE
to
DEST_WIMFILE,
optionally changing its name and/or
description and/or compression type. If
DEST_WIMFILE
exists, it is taken be 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
wimexport
if the appropriate hard link or batch file has
been installed.
SRC_IMAGE
specifies the image in
SRC_WIMFILE
to export. It may be a 1-based index of an image in
SRC_WIMFILE,
the name of an image in
SRC_WIMFILE,
or the keyword "all" to indicate that all images
in
SRC_WIMFILE
are to be exported. Use the
wimlib-imagex info
(1) command to list the images a WIM
file contains.
If specified,
DEST_IMAGE_NAME
is the name to give the image being exported to
DEST_WIMFILE.
The
default is its name in
SRC_WIMFILE. DEST_IMAGE_NAME
cannot be specified if multiple images are
being exported.
If specified,
DEST_IMAGE_DESCRIPTION
is the description to give the image being exported to
DEST_WIMFILE.
The default is its description in
SRC_WIMFILE.
wimlib-imagex export
supports exporting images from stand-alone WIMs as well as from split WIMs.
However, you cannot export an image to a split WIM. See
SPLIT WIMS.
wimlib-imagex export
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
DEST_WIMFILE
(this implies
--pipable).
See
--pipable
and
--not-pipable.
OPTIONS
--boot
Specifies that the exported image is to be the bootable image of the destination WIM archive.
If multiple images are being exported, this flag indicates that the image in the
SRC_WIMFILE
that
is currently marked as bootable is to be made bootable in
DEST_WIMFILE.
If no image in
SRC_WIMFILE
is bootable, it is an error.
--check
When reading
SRC_WIMFILE,
and
DEST_WIMFILE
if it exists, verify the file’s integrity if the
integrity table is present; additionally, when writing
DEST_WIMFILE
with the new image(s) added,
write an integrity table. If neither
--check
nor
--nocheck
is specified, an integrity table is included
in
DEST_WIMFILE
if and only if
DEST_WIMFILE
already existed and it had an integrity table
before.
--nocheck
When writing
DEST_WIMFILE
with the new image(s) added, do not write an integrity table. If nei-
ther
--check
nor
--nocheck
is specified, an integrity table is included in
DEST_WIMFILE
if and
only if
DEST_WIMFILE
already existed and it had an integrity table before.
--compress=TYPE
Specifies the compression type for
DEST_WIMFILE.
This is only valid if
DEST_WIMFILE
does
not yet exist, since if
DEST_WIMFILE
exists, the compression type must be the same as that of
DEST_WIMFILE.
TYPE
may be "none", "maximum", or "fast". By default, it is the same as that of the input WIM
file.
You may also specify the actual names of the compression algorithms, "XPRESS" and "LZX",
instead of "fast" and "maximum", respectively.
wimlib-imagex 1.6.0
January 2014
1
WIMLIB-IMAGEX(1)
User Commands
WIMLIB-IMAGEX(1)
TYPE
may also be "recovery" (or "LZMS"); however, this will result in reduced compatibility. See
the documentation for this option to
wimlib-imagex capture
(1) for more details.
--pack-streams
Create a "solid" archive that compresses multiple files together. This can result in a higher compres-
sion ratio, but has disadvantages such as reduced compatibility; see the documentation for this
option to
wimlib-imagex capture
(1) for more details.
--threads=NUM_THREADS
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 compres-
sion type as the source WIM, since wimlib optimizes this case by re-using the raw compressed data.
--rebuild
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
wimlib-imagex optimize.
--ref="GLOB"
File glob of additional WIMs or split WIM parts to reference resources from. See
SPLIT_WIMS.
This option can be specified multiple times. Note:
GLOB
is listed in quotes because it is interpreted
by
wimlib-imagex
and may need to be quoted to protect against shell expansion.
--pipable
Build, or rebuild,
DEST_WIMFILE
as a "pipable WIM" so that it can be applied fully sequentially,
including from a pipe. See
wimlib-imagex capture(1)
for more details about creating pipable
WIMs. The default without this option is to make
DEST_WIMFILE
pipable if and only if it already
existed and was already pipable, or was "-" (standard output).
--not-pipable
Build, or rebuild,
DEST_WIMFILE
as a normal, non-pipable WIM. This is the default behavior,
unless
DEST_WIMFILE
already existed and was already pipable, or if
DEST_WIMFILE
was "-"
(standard output).
SPLIT WIMS
You may use
wimlib-imagex export
to export images from a split WIM. The
SRC_WIMFILE
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
--ref="GLOB"
options. Since globbing is built into the
--ref
option, typically only one
--ref
option is necessary. For example, the names for the split WIM parts usually go something like:
mywim.swm
mywim2.swm
mywim3.swm
mywim4.swm
mywim5.swm
To export the first image of this split WIM to a new or existing WIM file
"other.wim", run:
wimlib-imagex export mywim.swm 1 other.wim --ref="mywim*.swm"
NOTES
It is safe to abort an
wimlib-imagex export
command partway through; however, after doing this, it is rec-
ommended to run
wimlib-imagex optimize
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
rebuild (e.g. with
--rebuild),
in which case you should delete the temporary file left over.
Since the WIM format uses single-instancing (streams are content-addressed by SHA1 message digests),
when an image is exported, only the streams not already present in the destination WIM need to be copied.
However, a new copy of the image’s metadata resource always needs to be created.
wimlib-imagex 1.6.0
January 2014
2
WIMLIB-IMAGEX(1)
User Commands
WIMLIB-IMAGEX(1)
EXAMPLES
Export the second image of ’boot.wim’ to the new WIM file ’new.wim’:
wimlib-imagex export boot.wim 2 new.wim
The above example creates "new.wim" with the same compression type as "boot.wim". If you wish to
change the compression type, specify
--compress=TYPE;
for example:
wimlib-imagex export boot.wim 2 new.wim --compress=maximum
SEE ALSO
wimlib-imagex(1) wimlib-imagex-info(1) wimlib-imagex-optimize(1)
wimlib-imagex 1.6.0
January 2014
3

Plik z chomika:

Inne pliki z tego folderu:

Inne foldery tego chomika:

Zgłoś jeśli naruszono regulamin