wimlib-imagex: add options to enable unsafe compaction
[wimlib] / doc / man1 / wimlib-imagex-join.1
1 .TH WIMLIB-IMAGEX "1" "August 2015" "wimlib 1.8.2" "User Commands"
2 .SH NAME
3 wimlib-imagex-join \- Join split WIMs into a standalone one-part WIM
4 .SH SYNOPSIS
5 \fBwimlib-imagex 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 \fBwimlib-imagex 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 wimlib-imagex join windows.wim windows*.swm
31 .RE
32 .SH NOTES
33 \fBwimlib-imagex join\fR is roughly equivalent to:
34 .RS
35 .PP
36 \fBwimlib-imagex export\fR \fISWM_PART_1\fR --ref="\fISWM_GLOB\fR" all \fIOUT_WIMFILE\fR
37 .RE
38 .SH SEE ALSO
39 .BR wimlib-imagex (1)
40 .BR wimlib-imagex-export (1)