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