-.TH WIMAPPLY "1" "January 2017" "wimlib 1.11.0" "User Commands"
+.TH WIMAPPLY "1" "February 2024" "wimlib 1.14.4" "User Commands"
.SH NAME
wimapply \- Apply a WIM image
.SH SYNOPSIS
.PP
However, encrypted files will not be extracted.
.PP
+Restoring extended attributes (EAs) is also not yet supported in this mode.
+.PP
Regardless, since almost all information from the WIM image is restored in this
mode, it is possible (and fully supported) to restore an image of an actual
Windows installation using \fBwimapply\fR on a UNIX-like system as an
Hard links, if supported by the target filesystem.
.IP \[bu]
Object IDs, if supported by the target filesystem.
+.IP \[bu]
+Extended attributes (EAs), if supported by the target filesystem.
.PP
Additional notes about extracting files on Windows:
.IP \[bu] 4
run something like:
.PP
.RS
-wget -O - http://myserver/mywim.wim | wimapply - 1 /dev/sda1
+wget -O - https://myserver/mywim.wim | wimapply - 1 /dev/sda1
.RE
.PP
Pipable WIMs may also be split into multiple parts, just like normal WIMs. To
In addition, wimlib has a hardcoded list of files for which it knows, for
compatibility with the Windows bootloader, to override the requested compression
format.
+.TP
+\fB--recover-data\fR
+If a file is corrupted (its stored hash doesn't match its actual hash, or some
+parts of it can't be decompressed), extract the corrupted file anyway with a
+warning, rather than aborting with an error. This may be useful to recover data
+if a WIM archive was corrupted. Note that recovering data is not guaranteed to
+succeed, as it depends on the type of corruption that occurred.
.SH NOTES
\fIData integrity\fR: WIM files include checksums of file data. To detect
accidental (non-malicious) data corruption, wimlib calculates the checksum of
every file it extracts and issues an error if it does not have the expected
-value. (This default behavior seems equivalent to the \fB/verify\fR option of
-ImageX.) In addition, a WIM file can include an integrity table (extra
-checksums) over the raw data of the entire WIM file. For performance reasons
-wimlib does not check the integrity table by default, but the \fB--check\fR
-option can be passed to make it do so.
+value, unless the \fB--recover-data\fR option is given. (This default behavior
+seems equivalent to the \fB/verify\fR option of ImageX.) In addition, a WIM
+file can include an integrity table (extra checksums) over the raw data of the
+entire WIM file. For performance reasons wimlib does not check the integrity
+table by default, but the \fB--check\fR option can be passed to make it do so.
.PP
\fIESD files\fR: wimlib can extract files from solid-compressed WIMs, or "ESD"
(.esd) files, just like from normal WIM (.wim) files. However, Microsoft