mirrors/libguestfs
1
0
Fork 0
mirror of https://github.com/libguestfs/libguestfs.git synced 2026-03-21 22:53:37 +00:00
Code Issues Packages Projects Releases Wiki Activity

doc: Document problems with hibernated Windows guests and Windows 8 "fast startup" (RHBZ#882299).

Browse Source
This commit is contained in:
Richard W.M. Jones
2012-12-01 13:20:55 +00:00
parent 921b716b0b
commit b57ab59b8e
5 changed files with 62 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
fish/guestfish.pod
View File

@@ -1168,6 +1168,12 @@ Note these these require a terminal that supports ANSI escape codes.
A bold black version of the ordinary prompt.
=head1 WINDOWS 8
Windows 8 "fast startup" can prevent guestfish from mounting NTFS
partitions. See
L<guestfs(3)/WINDOWS HIBERNATION AND WINDOWS 8 FAST STARTUP>.
=head1 GUESTFISH COMMANDS
The commands in this section are guestfish convenience commands, in

5
sparsify/virt-sparsify.pod
View File

@@ -264,6 +264,11 @@ code if there was a fatal error.
All versions of virt-sparsify have supported the I<--machine-readable>
option.
=head1 WINDOWS 8
Windows 8 "fast startup" can prevent virt-sparsify from working.
See L<guestfs(3)/WINDOWS HIBERNATION AND WINDOWS 8 FAST STARTUP>.
=head1 EXIT STATUS
This program returns 0 if successful, or non-zero if there was an

39
src/guestfs.pod
View File

@@ -803,6 +803,45 @@ ntfs-3g filesystems (using L</guestfs_getxattr>). See:
L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>
=head3 WINDOWS HIBERNATION AND WINDOWS 8 FAST STARTUP
Windows guests which have been hibernated (instead of fully shut down)
cannot be mounted. This is a limitation of ntfs-3g. You will see an
error like this:
The disk contains an unclean file system (0, 0).
Metadata kept in Windows cache, refused to mount.
Failed to mount '/dev/sda2': Operation not permitted
The NTFS partition is in an unsafe state. Please resume
and shutdown Windows fully (no hibernation or fast
restarting), or mount the volume read-only with the
'ro' mount option.
In Windows 8, the shutdown button does not shut down the guest at all.
Instead it usually hibernates the guest. This is known as "fast
startup".
Some suggested workarounds are:
=over 4
=item *
Mount read-only (eg. L</guestfs_mount_ro>).
=item *
On Windows 8, turn off fast startup. It is in the Control Panel →
Power Options → Choose what the power buttons do → Change settings
that are currently unavailable → Turn on fast startup.
=item *
On Windows 7 and earlier, shut the guest off properly instead of
hibernating it.
=back
=head2 RESIZE2FS ERRORS
The L</guestfs_resize2fs>, L</guestfs_resize2fs_size> and

5
sysprep/virt-sysprep.pod
View File

@@ -466,6 +466,11 @@ I<--selinux-relabel> option.
You can disable relabelling entirely by supplying the
I<--no-selinux-relabel> option.
=head1 WINDOWS 8
Windows 8 "fast startup" can prevent virt-sysprep from working.
See L<guestfs(3)/WINDOWS HIBERNATION AND WINDOWS 8 FAST STARTUP>.
=head1 SHELL QUOTING
Libvirt guest names can contain arbitrary characters, some of which

8
tools/virt-win-reg
View File

@@ -546,7 +546,7 @@ sub upload_hive
=head1 SUPPORTED SYSTEMS
The program currently supports Windows NT-derived guests starting with
Windows XP through to at least Windows 7.
Windows XP through to at least Windows 8.
The following Registry keys are supported:
@@ -578,6 +578,12 @@ C<HKU> for C<HKEY_USERS>.
The literal keys C<HKEY_USERS\$SID> and C<HKEY_CURRENT_USER> are not
supported (there is no "current user").
=head2 WINDOWS 8
Windows 8 "fast startup" can prevent virt-win-reg from being
able to edit the Registry. See
L<guestfs(3)/WINDOWS HIBERNATION AND WINDOWS 8 FAST STARTUP>.
=head1 ENCODING
C<virt-win-reg> expects that regedit files have already been reencoded