From dccd9b8f525cfae49b89c38066d752e6c054c7f6 Mon Sep 17 00:00:00 2001
From: Richard Jones <rjones@redhat.com>
Date: Thu, 3 Jun 2010 11:48:41 +0100
Subject: [PATCH] grub-install: In docs suggest manually creating device.map
 (RHBZ#484986).

---
 src/generator.ml | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/src/generator.ml b/src/generator.ml
index efc8bfd..cc34676 100755
--- 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 (
-- 
1.8.3.1