From ff1b92c857d3c0377ce5062e2291fc3332dfc11e Mon Sep 17 00:00:00 2001 From: Richard Jones Date: Thu, 21 May 2009 10:00:00 +0100 Subject: [PATCH] Bugs have been moved to Red Hat Bugzilla. --- BUGS | 78 ++++++++----------------------------------------------------- guestfs.pod | 28 ++++++++++++++++++++++ 2 files changed, 38 insertions(+), 68 deletions(-) diff --git a/BUGS b/BUGS index 00ce125..fee66ca 100644 --- a/BUGS +++ b/BUGS @@ -1,74 +1,16 @@ -[guestfish] Built-in commands like 'alloc' and 'help' don't auto-complete. +Please note: This file used to contain a list of bugs. Bugs in +libguestfs are now tracked in Red Hat's Bugzilla. -[libguestfs] /tmp/libguestfs temporary directory is not cleaned up -sometimes. This appears to happen (only?) if the main program -segfaults. +To get a list of bugs against libguestfs use this link: -[libguestfs] qemu process not cleaned up occasionally. This appears -to happen only if the main program or library segfaults, in which case -the atexit handler which would normally perform cleanup is not run. -sometimes. This appears to happen (only?) if the main program -segfaults. -[testing a hacky fix to this] +https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Fedora -[kernel?] Kernel boot times are significantly slower for Fedora 11/12 -than for Fedora 10, like 2-3 times slower. This greatly affects the -time it takes to launch the subprocess (although it does still work). -[fixed - was a KVM bug] +To report a new bug against libguestfs use this link: -[java] Java bindings documentation messed up. See: -http://java.sun.com/j2se/javadoc/writingdoccomments/ +https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Fedora -[libguestfs] If qemu process is a shell script, then it is not cleaned -up correctly, even on "good" exit. This is because we need to set up -a new process group (see commented code for doing setpgid). -[fixed? - added documentation in the manual page that you have to -do 'exec qemu' in the wrapper. However I still notice that the -recovery process kills qemu, instead of it being killed by the -parent process, or at least that's what I think is happening] +When reporting a bug, please check: -[libguestfs] Some occasional data corruption, certainly on tgz-out. -Try using tgz-out on a very large directory. -[we think this is fixed by 64a6a828bd318622420cf3018899392fd80c14e7] - -[libguestfs] futimens (do_touch) not available in glibc 2.5 -(reported by Charles Duffy) -[fixed] - -[ocaml] Does not compile with OCaml 3.09.3 from RHEL 5 -(reported by Charles Duffy) -[fixed] - -[inspector] If there are missing Perl module deps, it still -configures the inspector. (eg. if perl-Sys-Virt is missing). - -[build] "exec: chroot not found" -Setting PATH to include /usr/sbin solves this temporarily. - -[libguestfs] FileOut parameters can cause -"internal error: reply callback called twice" -This bug is rare but well-understood. Unfortunately it's also -quite hard to fix cleanly. - -[libguestfs] write-file does not support strings containing ASCII NUL. - -[perl] Perl bindings cause a segfault when you call any command which -takes a StringList (eg. $g->command). -[should be fixed now] - -[libguestfs] OptString parameters in the bindings are often not -handled correctly. For example in OCaml (but this is NOT exclusive -to OCaml), OptString should become 'string option'. - -[libguestfs] Certain functions such as 'set-path' can take NULL -parameters, but the parameters are not OptString. - -[tests] command and command-lines tests fail if test-command binary -cannot be statically linked by libtool. The workaround is to install -glibc-static. - -[tests] Should be possible to conditionally skip tests based on a -runtime check. - -[fedora] Depends on 'qemu' but should depend on the real subpackage, -eg. qemu-kvm or qemu-system-x86_64 or whatever. [reported by markmc] + - That the bug hasn't been reported already. + - That you are testing a recent version. + - Describe the bug accurately, and give a way to reproduce it. diff --git a/guestfs.pod b/guestfs.pod index 4dc5757..dbf422d 100644 --- a/guestfs.pod +++ b/guestfs.pod @@ -691,6 +691,34 @@ L, L, L. +=head1 BUGS + +To get a list of bugs against libguestfs use this link: + +L + +To report a new bug against libguestfs use this link: + +L + +When reporting a bug, please check: + +=over 4 + +=item * + +That the bug hasn't been reported already. + +=item * + +That you are testing a recent version. + +=item * + +Describe the bug accurately, and give a way to reproduce it. + +=back + =head1 AUTHORS Richard W.M. Jones (C) -- 1.8.3.1