-[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.