From: Richard Jones <rjones@redhat.com>
Date: Thu, 3 Jun 2010 10:48:41 +0000 (+0100)
Subject: grub-install: In docs suggest manually creating device.map (RHBZ#484986).
X-Git-Tag: 1.2.10~13
X-Git-Url: http://git.annexia.org/?a=commitdiff_plain;h=35f6f6df609b6f27fc27302abf0d72124a964824;p=libguestfs.git

grub-install: In docs suggest manually creating device.map (RHBZ#484986).
(cherry picked from commit dccd9b8f525cfae49b89c38066d752e6c054c7f6)
---

diff --git a/src/generator.ml b/src/generator.ml
index a52ddce..9c13d40 100755
--- a/src/generator.ml
+++ b/src/generator.ml
@@ -2327,7 +2327,18 @@ See also: C<guestfs_scrub_device>.");
    "install GRUB",
    "\
 This command installs GRUB (the Grand Unified Bootloader) on
-C<device>, with the root directory being C<root>.");
+C<device>, with the root directory being C<root>.
+
+Note: If grub-install reports the error
+\"No suitable drive was found in the generated device map.\"
+it may be that you need to create a C</boot/grub/device.map>
+file first that contains the mapping between grub device names
+and Linux device names.  It is usually sufficient to create
+a file containing:
+
+ (hd0) /dev/vda
+
+replacing C</dev/vda> with the name of the installation device.");
 
   ("cp", (RErr, [Pathname "src"; Pathname "dest"]), 87, [],
    [InitBasicFS, Always, TestOutput (