X-Git-Url: https://wimlib.net/git/?a=blobdiff_plain;ds=sidebyside;f=doc%2Fimagex-apply.1.in;h=5db59f92a7f0fd0ac91fb559aacef08c14a54d7f;hb=7907dcb5432f65ea030a4c7b1d8b118b5c9e3e1b;hp=1868100ca3da65ec9db3fcbebed721655a017b59;hpb=232c381f9f3ab814258aa8e2380f537498a50905;p=wimlib diff --git a/doc/imagex-apply.1.in b/doc/imagex-apply.1.in index 1868100c..5db59f92 100644 --- a/doc/imagex-apply.1.in +++ b/doc/imagex-apply.1.in @@ -1,4 +1,4 @@ -.TH IMAGEX "1" "March 2013" "@IMAGEX_PROGNAME@ @VERSION@" "User Commands" +.TH IMAGEX "1" "April 2013" "@IMAGEX_PROGNAME@ @VERSION@" "User Commands" .SH NAME @IMAGEX_PROGNAME@-apply \- Extract one image, or all images, from a WIM archive @@ -244,12 +244,37 @@ File glob of additional split WIM parts that are part of the split WIM being applied. See \fBSPLIT_WIMS\fR. .TP \fB--unix-data\fR -This option may only be given in the normal extraction mode (not NTFS). -By default, in the normal extraction mode, \fB@IMAGEX_PROGNAME@ apply\fR will ignore both -Windows-style security descriptors and UNIX-specific file owners, groups, and -modes set when using \fB@IMAGEX_PROGNAME@ capture\fR with the \fB--unix-data\fR flag. By -passing \fB--unix-data\fR to \fB@IMAGEX_PROGNAME@ apply\fR instead, this causes this -UNIX-specific data to be restored when available. +This option may only be given in the normal extraction mode (not NTFS). By +default, in the normal extraction mode on UNIX, \fB@IMAGEX_PROGNAME@ apply\fR +will ignore both Windows-style security descriptors and UNIX-specific file +owners, groups, and modes set when using \fB@IMAGEX_PROGNAME@ capture\fR with +the \fB--unix-data\fR flag. By passing \fB--unix-data\fR to +\fB@IMAGEX_PROGNAME@ apply\fR instead, this causes this UNIX-specific data to be +restored when available. +.TP +\fB--no-acls\fR +In the NTFS apply mode, do not apply security descriptors. This flag is also +available in the native Win32 build of wimlib and may be useful when running +\fB@IMAGEX_PROGNAME@\fR as a non-administrator. +.TP +\fB--strict-acls\fR +Fail immediately if the full security descriptor of any file or directory cannot +be set exactly as specified in the WIM file. The default behavior without this +option is to fall back to setting a security descriptor with the SACL omitted, +then only the default inherited security descriptor, if we do not have +permission to set the desired one. +.TP +\fB--rpfix\fR, \fB--norpfix\fR +Set whether to fix targets of absolute symbolic links (reparse points in Windows +terminology) or not. When enabled (\fB--rpfix\fR), extracted absolute symbolic +links that are marked in the WIM image as being fixed are assumed to have +absolute targets relative to the image root, and therefore have the actual root +of extraction prepended to their targets. The intention is that you can apply +an image containing absolute symbolic links and still have them be valid after +it's been applied to any location. + +The default behavior is \fB--rpfix\fR if any images in \fIWIMFILE\fR have been +captured with reparse-point fixups done. Otherwise, it is \fB--norpfix\fR. .SH NOTES @@ -273,14 +298,14 @@ Extract the first image from the Windows PE image from the Windows Vista/7/8 installation media to the directory "boot": .RS .PP -image apply /media/windows/sources/boot.wim 1 boot +@IMAGEX_PROGNAME@ apply /media/windows/sources/boot.wim 1 boot .RE .PP Extract all images from the Windows PE image from the Windows Vista/7/8 installation media to the directory "boot", and hard link all identical files: .RS .PP -image apply /media/windows8/sources/boot.wim all boot --hardlink +@IMAGEX_PROGNAME@ apply /media/windows8/sources/boot.wim all boot --hardlink .RE .PP .SS NTFS extraction mode