From: Richard W.M. Jones <rjones@redhat.com>
Date: Thu, 11 Aug 2011 12:11:02 +0000 (+0100)
Subject: docs: Explain how to debug libvirt initialization problems (RHBZ#680031).
X-Git-Tag: 1.0.6~3
X-Git-Url: http://git.annexia.org/?p=virt-top.git;a=commitdiff_plain;h=067b868b9cce7620774d7fb57dac6fd8df45d8df;hp=314b2898f46e1f88aba654b6c1f56c32a0aa0124

docs: Explain how to debug libvirt initialization problems (RHBZ#680031).
---

diff --git a/virt-top/virt-top.pod b/virt-top/virt-top.pod
index 225c5ea..63aa30a 100755
--- a/virt-top/virt-top.pod
+++ b/virt-top/virt-top.pod
@@ -424,6 +424,20 @@ will probably see a steady "background noise" of RX packets even when
 the network interface is idle or down.  These are caused by STP
 packets generated by the bridge.
 
+=head2 DEBUGGING LIBVIRT ISSUES
+
+virt-top tries to turn libvirt errors into informative messages.
+However if libvirt initialization fails then this is not possible.
+Instead you will get an obscure error like:
+
+ libvir: error : Unknown failure
+ Fatal error: exception Libvirt.Virterror(...)
+
+To see the cause of libvirt errors in more detail, enable libvirt
+debugging by setting this environment variable:
+
+ export LIBVIRT_DEBUG=1
+
 =head1 SEE ALSO
 
 L<top(1)>,