X-Git-Url: https://wimlib.net/git/?a=blobdiff_plain;f=doc%2Fman1%2Fwimapply.1;h=ebd8f7eb7991c2f677f20e0385169052c1a4c895;hb=HEAD;hp=fb649553857cf046d11c8fdcbb09b8709bb05f8e;hpb=055a7496d1f9af18bf0514f94228c64131cb3f02;p=wimlib diff --git a/doc/man1/wimapply.1 b/doc/man1/wimapply.1 index fb649553..448fafda 100644 --- a/doc/man1/wimapply.1 +++ b/doc/man1/wimapply.1 @@ -1,4 +1,4 @@ -.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 @@ -88,6 +88,8 @@ Object IDs. .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 @@ -141,6 +143,8 @@ Short filenames (also known as 8.3 names or DOS names). 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 @@ -213,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 @@ -351,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