grub-install: In docs suggest manually creating device.map (RHBZ#484986).

[libguestfs.git] / src / generator.ml

diff --git a/src/generator.ml b/src/generator.ml
index efc8bfd..cc34676 100755 (executable)
--- a/src/generator.ml
+++ b/src/generator.ml
@@ -2329,7 +2329,18 @@ See also: C<guestfs_zero_device>, 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 (