]> wimlib.net Git - wimlib/blob - doc/imagex-join.1.in
c3112fdb319c50e4780448012a394ea859006f4a
[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 This command is also available as simply \fBwimjoin\fR if the appropriate hard
9 link is installed.
10 .PP
11 All parts of the split WIM  must be specified.  You probably want to do so using
12 a shell wildcard.
13 .PP
14 \fB@IMAGEX_PROGNAME@ join\fR can join both non-pipable and pipable split WIMs.
15 .SH OPTIONS
16 .TP 6
17 \fB--check\fR
18 When reading each \fISPLIT_WIM\fR, verify its integrity if the integrity table
19 is present; additionally, when writing \fIOUT_WIMFILE\fR, write an integrity
20 table.  If this option is not specified, an integrity table will be included in
21 \fIOUT_WIMFILE\fR if and only if one was present in the first part of the split
22 WIM.
23 .SH EXAMPLES
24 Join a split WIM, with the parts named `windows*.swm' where the * is anything
25 (usually the number of the part, except for the first part which may have no
26 number), and write the joined WIM to the file `windows.wim'.
27 .RS
28 .PP
29 @IMAGEX_PROGNAME@ join windows.wim windows*.swm
30 .RE
31 .SH NOTES
32 \fB@IMAGEX_PROGNAME@ join\fR is roughly equivalent to:
33 .RS
34 .PP
35 \fB@IMAGEX_PROGNAME@ export\fR \fISWM_PART_1\fR --ref="\fISWM_GLOB\fR" [--check] all \fIOUT_WIMFILE\fR
36 .RE
37 .SH SEE ALSO
38 .BR @IMAGEX_PROGNAME@ (1)
39 .BR @IMAGEX_PROGNAME@-export (1)