From: Richard W.M. Jones 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/?a=commitdiff_plain;h=067b868b9cce7620774d7fb57dac6fd8df45d8df;p=virt-top.git 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,