Bugs have been moved to Red Hat Bugzilla.
authorRichard Jones <rjones@redhat.com>
Thu, 21 May 2009 09:00:00 +0000 (10:00 +0100)
committerRichard Jones <rjones@redhat.com>
Thu, 21 May 2009 09:00:00 +0000 (10:00 +0100)
BUGS
guestfs.pod

diff --git a/BUGS b/BUGS
index 00ce125..fee66ca 100644 (file)
--- 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.
index 4dc5757..dbf422d 100644 (file)
@@ -691,6 +691,34 @@ L<qemu(1)>,
 L<febootstrap(1)>,
 L<http://et.redhat.com/~rjones/libguestfs>.
 
+=head1 BUGS
+
+To get a list of bugs against libguestfs use this link:
+
+L<https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Fedora>
+
+To report a new bug against libguestfs use this link:
+
+L<https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Fedora>
+
+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<rjones at redhat dot com>)