Add support for zerofree command.

[libguestfs.git] / BUGS

diff --git a/BUGS b/BUGS
index 7acddb0..fca6909 100644 (file)
--- a/BUGS
+++ b/BUGS
@@ -1,8 +1,71 @@
 [guestfish] Built-in commands like 'alloc' and 'help' don't auto-complete.
 
 [libguestfs] /tmp/libguestfs temporary directory is not cleaned up
-(sometimes).
+sometimes.  This appears to happen (only?) if the main program
+segfaults.
+
+[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]
 
 [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]
+
+[java] Java bindings documentation messed up.  See:
+http://java.sun.com/j2se/javadoc/writingdoccomments/
+
+[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]
+
+[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.