]> wimlib.net Git - wimlib/blob - doc/imagex-export.1.in
test-imagex-ntfs: Use lazy unmount
[wimlib] / doc / imagex-export.1.in
1 .TH IMAGEX "1" "October 2012" "imagex (wimlib) wimlib @VERSION@" "User Commands"
2 .SH NAME
3 imagex-export \- Exports an image from a WIM archive to an existing or new WIM archive
4
5 .SH SYNOPSIS
6 \fBimagex export\fR \fISRC_WIMFILE\fR (\fISRC_IMAGE_NUM\fR | \
7 \fISRC_IMAGE_NAME\fR | all ) \fIDEST_WIMFILE\fR [\fIDEST_IMAGE_NAME\fR\] \
8 [\fIDEST_IMAGE_DESCRIPTION\fR] [\fIOPTION\fR]...
9
10 .SH DESCRIPTION
11 .PP
12
13 Copies the specified image in \fISRC_WIMFILE\fR to \fIDEST_WIMFILE\fR,
14 optionally changing its name and/or description and/or compression type.
15 If \fIDEST_WIMFILE\fR exists, it is taken be be a WIM archive to which the image
16 will be appended.  Otherwise, it is created as a new WIM archive containing only
17 the exported image.
18
19 The source image may be specified by \fISRC_IMAGE_NUM\fR, which must be an integer that is
20 an index of an image in \fISRC_WIMFILE\fR, starting at 1.  Alternatively, it may be
21 the name of an image in \fISRC_WIMFILE\fR, or it may be the keyword "all" to
22 specify that all images are to be exported.
23
24 If given, \fIDEST_IMAGE_NAME\fR specifies the name to give the image being
25 exported to \fIDEST_WIMFILE\fR.  The default is its name in \fISRC_WIMFILE\fR.
26 \fIDEST_IMAGE_NAME\fR cannot be specified if multiple images are being exported.
27
28 If given, \fIDEST_IMAGE_DESCRIPTION\fR specifies the description to give the
29 image being exported to \fIDEST_WIMFILE\fR.  The default is its description in
30 \fISRC_WIMFILE\fR.
31
32 \fBimagex export\fR supports exporting images from stand-alone WIMs as well as
33 from split WIMs.  However, you cannot export an image to a split WIM.  See
34 \fBSPLIT WIMS\fR.
35
36 .SH OPTIONS
37 .TP 6
38 \fB--boot\fR
39 Specifies that the exported image is to be the bootable image of the destination
40 WIM archive.
41
42 If multiple images are being exported, this flag indicates that the image in the
43 \fISRC_WIMFILE\fR that is currently marked as bootable is to be made bootable in
44 \fIDEST_WIMFILE\fR.  If no image in \fISRC_WIMFILE\fR is bootable, it is an
45 error.
46 .TP
47 \fB--check\fR
48 When reading \fISRC_WIMFILE\fR, verify its integrity if the integrity table is
49 present; additionally, when writing \fIDEST_WIMFILE\fR with the new image added,
50 write an integrity table.  If this option is not specified, no integrity table
51 is included in \fIDEST_WIMFILE\fR, even if there was one before.
52 .TP
53 \fB--compress\fR=\fITYPE\fR
54 Specifies the compression type for \fIDEST_WIMFILE\fR.  This is only valid if
55 \fIDEST_WIMFILE\fR does not yet exist, since if \fIDEST_WIMFILE\fR exists, the
56 compression type must be the same as that of \fIDEST_WIMFILE\fR.
57
58 \fITYPE\fR may be "none", "maximum", or "fast".  By default, it is the same as
59 that of the input WIM file.
60
61 You may also specify the actual names of the compression algorithms, "XPRESS"
62 and "LZX", instead of "fast" and "maximum", respectively.
63
64 .TP
65 \fB--ref\fR="\fIGLOB\fR"
66 File glob of additional split WIM parts that are part of the split WIM being
67 exported.  See \fBSPLIT_WIMS\fR.
68
69 .SH SPLIT WIMS
70
71 You may use \fBimagex export\fR to export images from a split WIM.  The
72 \fISRC_WIMFILE\fR argument is used to specify the first part of the split WIM, and
73 the \fB--refs\fR="\fIGLOB\fR" option is used to provide a shell-style file glob
74 that specifies the additional parts of the split WIM.  \fIGLOB\fR is expected to
75 be a single string on the command line, so \fIGLOB\fR must be quoted so that it
76 is protected against shell expansion.  \fIGLOB\fR must expand to all parts of
77 the split WIM, except optionally the first part which may either omitted or
78 included in the glob (but the first part MUST be specified as \fISRC_WIMFILE\fR as
79 well).
80
81 Here's an example.  The names for the split WIMs usually go something like:
82         
83 .RS
84 .PP
85 .nf
86 mywim.swm
87 mywim2.swm
88 mywim3.swm
89 mywim4.swm
90 mywim5.swm
91 .RE
92
93 To export the first image of this split WIM to a new or existing WIM file
94 "other.wim", run:
95 .PP
96 .RS
97 imagex export mywim.swm 1 other.wim --ref="mywim*.swm"
98 .RE
99 .PP
100
101 .SH EXAMPLES
102 Export the second image of 'boot.wim' to the new WIM file 'new.wim', and
103 change the compression type to maximum, if it wasn't maximum already:
104 .RS
105 .PP
106 image export boot.wim 2 new.wim --compress=maximum
107 .RE
108 .PP
109
110 .SH SEE ALSO
111 .BR imagex (1)
112