X-Git-Url: https://wimlib.net/git/?p=wimlib;a=blobdiff_plain;f=doc%2Fman1%2Fimagex-apply.1.in;h=5aec9b3fb30cc7b9450d782fea7a32c3531db99f;hp=571823e1c3494d4e1a87e206cd794575d44c38be;hb=d82950b8ae73d50bffebb88c2b5c10b49f4082f4;hpb=cd433ce49f582175063141cc3673840bf321c453 diff --git a/doc/man1/imagex-apply.1.in b/doc/man1/imagex-apply.1.in index 571823e1..5aec9b3f 100644 --- a/doc/man1/imagex-apply.1.in +++ b/doc/man1/imagex-apply.1.in @@ -1,4 +1,4 @@ -.TH WIMLIB-IMAGEX "1" "March 2014" "@IMAGEX_PROGNAME@ @VERSION@" "User Commands" +.TH WIMLIB-IMAGEX "1" "May 2014" "@IMAGEX_PROGNAME@ @VERSION@" "User Commands" .SH NAME @IMAGEX_PROGNAME@-apply \- Extract one image, or all images, from a WIM archive .SH SYNOPSIS @@ -49,7 +49,7 @@ This section documents how \fB@IMAGEX_PROGNAME@ apply\fR (and also thereof, in the case of \fB@IMAGEX_PROGNAME@ extract\fR) to a directory on UNIX-like systems. See \fBDIRECTORY EXTRACTION (WINDOWS)\fR for the corresponding documentation for Windows. - +.PP As mentioned, a WIM image can be applied to a directory on a UNIX-like system by providing a \fITARGET\fR directory. However, it is important to keep in mind that the WIM format was designed for Windows, and as a result WIM files can @@ -124,9 +124,10 @@ mode: .IP \[bu] 4 Encrypted files will not be extracted. .IP \[bu] -Although sparse file attributes will be applied, the full data will be extracted -to each sparse file, so extracted "sparse" files may not actually contain any -sparse regions. +wimlib v1.7.0 and later: Sparse file attributes will not be extracted (same +behavior as ImageX/DISM/WIMGAPI). wimlib v1.6.2 and earlier: Although sparse +file attributes will be applied, the full data will be extracted to each sparse +file, so extracted "sparse" files may not actually contain any sparse regions. .PP Regardless, since almost all information from the WIM image is restored in this mode, it is possible to restore an image of an actual Windows installation using @@ -329,21 +330,6 @@ captured with reparse-point fixups done. Otherwise, it is \fB--norpfix\fR. Reparse point fixups are never done in the NTFS volume extraction mode on UNIX-like systems. .TP -\fB--hardlink\fR -When extracting a file from the WIM that is identical to a file that has already -extracted, create a hard link rather than creating a separate file. This option -causes all identical files to be hard-linked, overriding the hard link groups -that are specified in the WIM image(s). In the case of extracting all images -from the WIM, files may be hard-linked even if they are in different WIM images. -.IP "" -However, hard-linked extraction mode does have some additional quirks. Named -data streams will not be extracted, and files can be hard linked even if their -metadata is not fully consistent. -.TP -\fB--symlink\fR -This option is similar to \fB--hardlink\fR, except symbolic links are created -instead. -.TP \fB--unix-data\fR (UNIX-like systems only) By default, in the directory extraction mode on UNIX, \fB@IMAGEX_PROGNAME@ apply\fR will ignore both Windows-style security @@ -441,7 +427,7 @@ wimlib cannot extract such files until they are first decrypted. .PP \fIDirectory traversal attacks\fR: wimlib validates filenames before extracting them and is not vulnerable to directory traversal attacks. This is in contrast -to Microsoft WIMGAPI/Imagex/Dism which can overwrite arbitrary files on the +to Microsoft WIMGAPI/ImageX/DISM which can overwrite arbitrary files on the target drive when extracting a malicious WIM file containing files named \fI..\fR or containing path separators. .SH EXAMPLES