]> wimlib.net Git - wimlib/blob - doc/imagex-join.1.in
Merge branch with pipable WIM support
[wimlib] / doc / imagex-join.1.in
1 .TH IMAGEX "1" "August 2013" "@IMAGEX_PROGNAME@ @VERSION@" "User Commands"
2 .SH NAME
3 @IMAGEX_PROGNAME@-join \- Join split WIMs into a standalone one-part WIM
4 .SH SYNOPSIS
5 \fB@IMAGEX_PROGNAME@ join\fR [\fIOPTION\fR...] \fIOUT_WIMFILE\fR \fISPLIT_WIM\fR...
6 .SH DESCRIPTION
7 Joins the \fISPLIT_WIMs\fR into a standalone one-part WIM \fIOUT_WIMFILE\fR.
8 .PP
9 All parts of the split WIM  must be specified.  You probably want to do so using
10 a shell wildcard.
11 .PP
12 \fB@IMAGEX_PROGNAME@ join\fR can join both non-pipable and pipable split WIMs.
13 .SH OPTIONS
14 .TP 6
15 \fB--check\fR
16 When reading each \fISPLIT_WIM\fR, verify its integrity if the integrity table
17 is present; additionally, when writing \fIOUT_WIMFILE\fR, write an integrity
18 table.  If this option is not specified, an integrity table will be included in
19 \fIOUT_WIMFILE\fR if and only if one was present in the first part of the split
20 WIM.
21 .SH EXAMPLES
22 Join a split WIM, with the parts named `windows*.swm' where the * is anything
23 (usually the number of the part, except for the first part which may have no
24 number), and write the joined WIM to the file `windows.wim'.
25 .RS
26 .PP
27 @IMAGEX_PROGNAME@ join windows.wim windows*.swm
28 .RE
29 .SH NOTES
30 \fB@IMAGEX_PROGNAME@ join\fR is roughly equivalent to:
31 .RS
32 .PP
33 \fB@IMAGEX_PROGNAME@ export\fR \fISWM_PART_1\fR --ref="\fISWM_GLOB\fR" [--check] all \fIOUT_WIMFILE\fR
34 .RE
35 .SH SEE ALSO
36 .BR @IMAGEX_PROGNAME@ (1)
37 .BR @IMAGEX_PROGNAME@-export (1)