From 9f842ad87d2255dce15c7d743ff1d67b4c31915d Mon Sep 17 00:00:00 2001 From: Eric Biggers Date: Tue, 29 Jan 2013 23:16:52 -0600 Subject: [PATCH] imagex-apply.1.in: Update --- NEWS | 3 ++- doc/imagex-apply.1.in | 26 ++++++++++++++++---------- 2 files changed, 18 insertions(+), 11 deletions(-) diff --git a/NEWS b/NEWS index 528c3e7a..207ead8d 100644 --- a/NEWS +++ b/NEWS @@ -4,7 +4,8 @@ Version 1.2.4: Added --arch switch to mkwinpeimg script to support getting AMD64 WinPE from the WAIK. - Update to work with ntfs-3g version 2013.1.13. + Update to work with ntfs-3g version 2013.1.13. DOS names are no longer + applied to files with multiple links. Version 1.2.3: Fixed truncating file to shorter but non-zero length on read-write diff --git a/doc/imagex-apply.1.in b/doc/imagex-apply.1.in index 2b386923..3eb5644e 100644 --- a/doc/imagex-apply.1.in +++ b/doc/imagex-apply.1.in @@ -71,8 +71,9 @@ Short (DOS) names for files A special extraction mode is entered when \fITARGET\fR is a regular file or block device. If this is the case, \fITARGET\fR is interpreted as an NTFS volume and opened using libntfs-3g. If successful, the WIM image is extracted -to the root of the NTFS volume in a special mode that preserves all information -contained in the WIM image. \fIIMAGE\fR may not be "all" for this action. +to the root of the NTFS volume in a special mode that preserves almost all +information contained in the WIM image. \fIIMAGE\fR may not be "all" for this +action. The NTFS volume does not need to be empty, although it's expected that it be empty for the intended use cases. A new NTFS filesystem can be created using @@ -106,17 +107,22 @@ the WIM. .IP \[bu] File attribute flags are applied. .IP \[bu] -Short (DOS) names for files are extracted. The corresponding long name for each -DOS name is made to be a Win32 name. Any additional names for the file in the -same directory are made to be names in the POSIX namespace. +Short (DOS) names for non-hard-linked files are extracted. The corresponding +long name for each DOS name is made to be a Win32 name. Files with multiple +hard links are extracted with filenames in the POSIX namespace, and short names +(if any) are ignored. A singly-linked file with no short name is also extracted +in the POSIX namespace. Note that this assigning of namespaces may not be +exactly the same as in the original filesystem that was captured, and also this +means that some DOS names may be lost (most likely inconsequentially). .PP -Since all information from the WIM image is restored in the NTFS extraction -mode, it is possible to restore an image of an actual Windows installation. In -the examples at the end of this manual page, there is an example of applying an -image from the "install.wim" file contained in the installation media for -Windows Vista, Windows 7, and Windows 8 in the "sources" directory. +Since almost all information from the WIM image is restored in the NTFS +extraction mode, it is possible to restore an image of an actual Windows +installation. In the examples at the end of this manual page, there is an +example of applying an image from the "install.wim" file contained in the +installation media for Windows Vista, Windows 7, and Windows 8 in the "sources" +directory. But in order to actually boot Windows from an applied image, you must understand the boot process of Windows versions Vista and later. Basically, it is the -- 2.43.0