summaryrefslogtreecommitdiffstats
path: root/src/launch.c
diff options
context:
space:
mode:
authorRichard W.M. Jones <rjones@redhat.com>2012-09-20 11:41:16 +0100
committerRichard W.M. Jones <rjones@redhat.com>2012-09-20 11:41:16 +0100
commit840deea12079b05a9f588016af273843d5d6e1b8 (patch)
tree3c16f71161ab33c48e0f7de70496217ca3701f80 /src/launch.c
parent181de70feb86840ee9ef761107933414e37ff144 (diff)
downloadlibguestfs-840deea12079b05a9f588016af273843d5d6e1b8.tar.gz
libguestfs-840deea12079b05a9f588016af273843d5d6e1b8.tar.xz
libguestfs-840deea12079b05a9f588016af273843d5d6e1b8.zip
launch: Make the "launched failed" message more explanatory.
Since this is the most common error seen by people who have installation problems, buggy qemu, etc, and since no one reads the FAQ, describe in this error message what resources are available to debug launch problems.
Diffstat (limited to 'src/launch.c')
-rw-r--r--src/launch.c16
1 files changed, 16 insertions, 0 deletions
diff --git a/src/launch.c b/src/launch.c
index 379fd3f0..7ca6fe11 100644
--- a/src/launch.c
+++ b/src/launch.c
@@ -468,6 +468,22 @@ guestfs___timeval_diff (const struct timeval *x, const struct timeval *y)
return msec;
}
+/* Since this is the most common error seen by people who have
+ * installation problems, buggy qemu, etc, and since no one reads the
+ * FAQ, describe in this error message what resources are available to
+ * debug launch problems.
+ */
+void
+guestfs___launch_failed_error (guestfs_h *g)
+{
+ if (g->verbose)
+ error (g, _("guestfs_launch failed, see earlier error messages"));
+ else
+ error (g, _("guestfs_launch failed.\n"
+ "See http://libguestfs.org/guestfs-faq.1.html#debugging-libguestfs\n"
+ "and/or run 'libguestfs-test-tool'."));
+}
+
/* Return the location of the tmpdir (eg. "/tmp") and allow users
* to override it at runtime using $TMPDIR.
* http://www.pathname.com/fhs/pub/fhs-2.3.html#TMPTEMPORARYFILES