mirrors/libguestfs
1
0
Fork 0
mirror of https://github.com/libguestfs/libguestfs.git synced 2026-03-21 22:53:37 +00:00
Code Issues Packages Projects Releases Wiki Activity

FAQ: Further improve debugging section.

Browse Source
This commit is contained in:
Richard W.M. Jones
2015-08-13 22:51:43 +01:00
parent 8828005691
commit 571fca8e71
1 changed files with 16 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files

33
examples/guestfs-faq.pod
View File

@@ -893,24 +893,30 @@ standalone programs).
=head2 Help, it's not working!
Please supply all the information in this checklist, in an
email sent to C<libguestfs> @ C<redhat.com>:
If no libguestfs program seems to work at all, run the program below
and paste the B<complete, unedited> output into the email to
C<libguestfs> @ C<redhat.com>:
libguestfs-test-tool
If a particular operation fails, supply all the information in this
checklist, in an email to C<libguestfs> @ C<redhat.com>:
=over 4
=item *
=item 1.
What are you trying to achieve?
What are you trying to do?
=item *
=item 2.
What exact commands did you run?
What exact command(s) did you run?
=item *
=item 3.
What was the precise error / output of these commands?
What was the precise error or output of these commands?
=item *
=item 4.
Enable debugging, run the commands again, and capture the B<complete>
output. B<Do not edit the output.>
@@ -918,18 +924,11 @@ output. B<Do not edit the output.>
export LIBGUESTFS_DEBUG=1
export LIBGUESTFS_TRACE=1
=item *
=item 5.
Include the version of libguestfs, the operating system version, and
how you installed libguestfs (eg. from source, C<yum install>, etc.)
=item *
If no libguestfs program seems to work at all, run the program below
and paste the B<complete, unedited> output into the email:
libguestfs-test-tool
=back
=head2 How do I debug when using any libguestfs program or tool