X-Git-Url: https://wimlib.net/git/?p=wimlib;a=blobdiff_plain;f=doc%2Fman1%2Fwimapply.1;h=b0e45cf44a4412a578ba5d68fd7d77d6172c5db3;hp=5c160d0e9964cb6d2d946b98e60c76486551573b;hb=HEAD;hpb=3770d244330395ed3325d8832d5eebb43ebfe980 diff --git a/doc/man1/wimapply.1 b/doc/man1/wimapply.1 index 5c160d0e..448fafda 100644 --- a/doc/man1/wimapply.1 +++ b/doc/man1/wimapply.1 @@ -1,4 +1,4 @@ -.TH WIMAPPLY "1" "July 2017" "wimlib 1.12.0" "User Commands" +.TH WIMAPPLY "1" "February 2024" "wimlib 1.14.4" "User Commands" .SH NAME wimapply \- Apply a WIM image .SH SYNOPSIS @@ -217,7 +217,7 @@ image from a WIM file available on a HTTP server to an NTFS volume on /dev/sda1, 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 @@ -355,15 +355,22 @@ files matching any of the patterns in this section will not be compressed. 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