diff options
| author | Richard Jones <rjones@redhat.com> | 2009-10-19 10:45:44 +0100 |
|---|---|---|
| committer | Richard Jones <rjones@redhat.com> | 2009-10-19 10:45:44 +0100 |
| commit | 5c4bf92bc298e078ceccdde603313282d038544c (patch) | |
| tree | c8f9908718c07f5aedb139d3c95b9d913f914d72 /tools/virt-rescue | |
| parent | 945b6e0a085611b45b2ab0752a66e6e60b21666c (diff) | |
| download | libguestfs-5c4bf92bc298e078ceccdde603313282d038544c.tar.gz libguestfs-5c4bf92bc298e078ceccdde603313282d038544c.tar.xz libguestfs-5c4bf92bc298e078ceccdde603313282d038544c.zip | |
tools: Make warnings about running on live guests more prominent.
Add prominent warnings to the man pages about how it is dangerous
to run these tools against live guests.
Diffstat (limited to 'tools/virt-rescue')
| -rwxr-xr-x | tools/virt-rescue | 16 |
1 files changed, 10 insertions, 6 deletions
diff --git a/tools/virt-rescue b/tools/virt-rescue index 9ad2fa4f..4f90ab10 100755 --- a/tools/virt-rescue +++ b/tools/virt-rescue @@ -37,6 +37,16 @@ virt-rescue - Run a rescue shell on a virtual machine virt-rescue [--options] disk.img [disk.img ...] +=head1 WARNING + +You must I<not> use C<virt-rescue> on live virtual machines. Doing so +will probably result in disk corruption in the VM. C<virt-rescue> +tries to stop you from doing this, but doesn't catch all cases. + +However if you use the I<--ro> (read only) option, then you can attach +a shell to a live virtual machine, but the results might be strange or +inconsistent at times (but you won't get disk corruption). + =head1 DESCRIPTION virt-rescue gives you a rescue shell and some simple recovery tools @@ -53,12 +63,6 @@ eg: # mount /dev/vg_f11x64/lv_root /sysroot # ls /sysroot -B<Note> that the virtual machine must not be powered on when you use -this tool. Doing so will probably result in disk corruption in the -VM. However if you use the I<--ro> (read only) option, then you can -attach a shell to a running machine, but the results might be strange -or inconsistent. - This tool is just designed for quick interactive hacking on a virtual machine. For more structured access to a virtual machine disk image, you should use L<guestfs(3)>. To get a structured shell, use |