-.TH WIMUPDATE "1" "July 2017" "wimlib 1.12.0" "User Commands"
+.TH WIMUPDATE "1" "February 2024" "wimlib 1.14.4" "User Commands"
.SH NAME
wimupdate \- Update a WIM image
.SH SYNOPSIS
contained in \fIWIMFILE\fR.
.PP
The modifications to perform on the WIM image are specified as a sequence of
-commands, one per line, read in a text file from standard input. It is
-recommended that standard input be redirected from a file (\fICMDFILE\fR), as
-shown above, rather than typing in commands interactively. Alternatively, to
-specify a command directly on the command line, see the \fB--command\fR option.
+commands, one per line, read in a text file (UTF-8 or UTF-16LE encoded; plain
+ASCII is also fine) from standard input. It is recommended that standard input
+be redirected from a file (\fICMDFILE\fR), as shown above, rather than typing in
+commands interactively. Alternatively, to specify a command directly on the
+command line, see the \fB--command\fR option.
.SH AVAILABLE COMMANDS
This section documents the commands that may appear in the \fICMDFILE\fR
described above.
information. Also include extra integrity information in the updated WIM even
if it was not present before.
.TP
+\fB--include-integrity\fR
+Include extra integrity information in the updated WIM, i.e. like \fB--check\fR
+but don't also verify the WIM beforehand.
+.TP
\fB--threads\fR=\fINUM_THREADS\fR
Number of threads to use for compressing newly added files. Default: autodetect
(number of processors).
This is efficient, but in general this option should \fInot\fR be used because a
failed or interrupted compaction will corrupt the WIM archive. For more
information, see the documentation for this option in \fBwimoptimize\fR(1).
+.TP
+\fB--ref\fR="\fIGLOB\fR"
+File glob of WIM(s) on which the delta WIM is based. Updating split WIMs is not
+allowed, but updating delta WIMs is allowed. When updating a delta WIM, the
+WIM(s) on which the delta WIM is based should be specified using this option.
+(It isn't a hard requirement, but it's needed for data deduplication to work
+fully and for the TOTALBYTES statistic to be correctly updated.)
.SH NOTES
\fBwimupdate\fR can be viewed as redundant with \fBwimmountrw\fR, since a WIM
image can also be updated by mounting it read-write. However, \fBwimupdate\fR
.PP
Add some files and directories to a WIM image. Note that the first path of each
\fBadd\fR command specifies the files to add, while the second path of each
-\fBadd\fR command specify the locations at which to to add them inside the WIM
+\fBadd\fR command specify the locations at which to add them inside the WIM
image:
.PP
.RS