Start using NEWS and stop using ChangeLog
[wimlib] / doc / imagex-append.1
1 .TH IMAGEX "1" "May 2012" "imagex (wimlib) wimlib 0.6.3" "User Commands"
2 .SH NAME
3 imagex append \- Append a directory to a WIM archive as a new image
4
5 .SH SYNOPSIS
6 \fBimagex append\fR \fIDIRECTORY\fR \fIWIMFILE\fR [\fIIMAGE_NAME\fR] \
7 [\fIDESCRIPTION\fR] [\fIOPTION\fR]...
8
9 .SH DESCRIPTION
10 .PP
11 Captures a WIM image from \fIDIRECTORY\fR and appends it to \fIWIMFILE\fR, which
12 must be a valid WIM archive.  \fIDIRECTORY\fR becomes the root directory of the
13 image.
14
15 \fIIMAGE_NAME\fR and \fIDESCRIPTION\fR specify the name and description of the
16 new image.  If \fIIMAGE_NAME\fR is not given, it is taken to be the same as the
17 base name of \fIDIRECTORY\fR.  If \fIDESCRIPTION\fR is not given, the
18 description is taken to be empty.
19
20 .SH OPTIONS
21 .TP 6
22 \fB--boot\fR
23 Specifies that the new image is to be the bootable image of the WIM archive.
24 .TP
25 \fB--check\fR
26 When reading \fIWIMFILE\fR, verify its integrity if the integrity table is
27 present; additionally, when writing \fIWIMFILE\fR with the new image added,
28 write an integrity table.  If this option is not specified, no integrity table
29 is included in the new WIM file, even if there was one before.
30 .TP
31 \fB--config\fR \fICONFIG_FILE\fR
32 This option is currently unsupported.
33 .TP
34 \fB--flags\fR \fIEDITIONID\fR
35 Specify a string to use in the <FLAGS> element of the XML data for the image.
36 .TP
37 \fB--verify\fR
38 This option is currently unsupported.
39 .SH SEE ALSO
40 .BR imagex (1)
41