1. Remove a rather strangely gratuitous bit of profanity
[unix-history] / KNOWNBUGS
index faf6e2b..f38df55 100644 (file)
--- a/KNOWNBUGS
+++ b/KNOWNBUGS
@@ -11,15 +11,35 @@ installed on your hard-drive is to 'bounce' on a key like shift or
 num-lock (which works well since you can see when the keyboard comes
 back to life) until the boot sequence is finished.  The keyboard will
 work fine for installing FreeBSD onto the hard-drive.
 num-lock (which works well since you can see when the keyboard comes
 back to life) until the boot sequence is finished.  The keyboard will
 work fine for installing FreeBSD onto the hard-drive.
-       Generally the problems go away at this point, but if it doesn't
-you should install a SYSCONS kernel which doesn't experience these
-keyboard problems.
 
 /usr/bin/gdb:
        The gdb in the release will not work on shared objects nor will it
        work with C++ executables.  Please use the gdb in the ports area for
        debugging shared and/or C++ code.  This is just a work-around until
 
 /usr/bin/gdb:
        The gdb in the release will not work on shared objects nor will it
        work with C++ executables.  Please use the gdb in the ports area for
        debugging shared and/or C++ code.  This is just a work-around until
-       we can transition to the new version of gdb completely.
+       we can transition to the new version of gdb completely.  See below.
+
+/usr/gnu/bin/gdb:
+       This is the gdb from the ports area (if installed), also known as
+       gdb-4.11.  There is a problem using gdb-4.11 to debug a core-file
+       generated by a binary which uses shared libraries. The problem is
+       basically due to the fact that the shared libraries are mmap'ed at
+       addresses in the memory space of the binary which are not accessible
+       to gdb-4.11 at the time that it tries to examine the core-file. This
+       usually manifests itself in "Cannot access memory at address <foo>"
+       messages at startup and "#0  <bar> in end ()" when you try to do
+       a backtrace ("bt").
+
+       Workaround: start gdb-4.11 without reference to the core-file,
+       e.g. "gdb fubar". Set a breakpoint in main and run the inferior
+       so that gdb-4.11 can resolve references to the shared libraries.
+       After this, use the "core-file" command to force gdb-4.11 to
+       load the core-file, e.g. "core-file fubar.core". Since all
+       shared library references were previously resolved gdb-4.11 can
+       now access the shared libraries and things like "bt" now work.
+       You will also be able to reference items previously on the stack
+       (from the core file), but all globals will show up as zero'd.
+       All these problems may be avoided if you compile the application
+       with -static.
 
 /sys/i386/isa/if_ep.c
        The 3c509 driver will hang under heavy network loads and take your
 
 /sys/i386/isa/if_ep.c
        The 3c509 driver will hang under heavy network loads and take your
@@ -29,37 +49,25 @@ keyboard problems.
        Workaround: Try a "ifconfig ep0 down" and a "ifconfig ep0 up"
        to get it running again.
 
        Workaround: Try a "ifconfig ep0 down" and a "ifconfig ep0 up"
        to get it running again.
 
-
-/sys/i386/boot
-       DO NOT ATTEMPT TO REBUILD THE BOOT BLOCKS.  There is currently
-       a problem in that the boot block code has grown and if you build
-       it with the new version of as and install them you will NOT BE
-       ABLE TO BOOT YOUR SYSTEM.  This problem will be fixed before
-       the 1.1 release is ship, and should only exist with the 1.1 BETA
-       release.
-
-       The boot block binaries shipped with the 1.1 BETA release were
-       built using an older version of as and can be installed safely.
-
 /sys/i386/isa/bt742a.c
        The Bt445S and Bt747 controllers can cause problems when ISA DMA
        is selected as an option.  With the EISA controller the remedy is
        easy - simply turn it off using your EISA configuration utility.
        With the Bt445S, which is a VLB card, you must switch the undocumented
        "SW10" on "SB2" to the off position.  Also note that certain revisions
 /sys/i386/isa/bt742a.c
        The Bt445S and Bt747 controllers can cause problems when ISA DMA
        is selected as an option.  With the EISA controller the remedy is
        easy - simply turn it off using your EISA configuration utility.
        With the Bt445S, which is a VLB card, you must switch the undocumented
        "SW10" on "SB2" to the off position.  Also note that certain revisions
-       of the Buslogic firmware can cause data corruption with systems
-       containing more than 16Mb of memory.  If you find this to be the case,
-       temporarily remove your extra memory and contact Buslogic for an
-       upgrade.
-
-/usr/bin/find
-       find doesn't work on CDROM's. You need to call find with the
-       "fstype isofs" argument to get it working. The bug seems to be 
-       in the "fts(3)" routines that find uses.
+       of the Buslogic board (Revision C or earlier, firmware revision <3.37)
+       will cause DATA CORRUPTION with systems containing more than 16MB of
+       memory.  If you find this to be the case, temporarily remove your
+       extra memory and contact Buslogic for an upgrade!
 
 
-/usr/bin/awk
-       awk dumps core for the following command line "awk '' blubber".
-       Problem is already known by the gawk maintainers and will be fixed
-       in the next release of gawk.
+fsck:
+       fsck can go into an endless loop in the repair/fsck cycle on
+       a corrupted filesystem. The message "VALUES IN SUPER BLOCK
+       DISAGREE WITH THOSE IN FIRST ALTERNATE" is very misleading.
+       fsck compares the superblock with the alternate in the last
+       cylinder group? So if this block is corrupt, you have no chance
+       to get the filesystem repaired. You can answer on the question
+       "UPDATE STANDARD SUPERBLOCK" with yes and get always the same
+       error message on the next fsck.
 
 
-$Id: KNOWNBUGS,v 1.9 1994/03/20 18:04:18 ats Exp $
+$Id: KNOWNBUGS,v 1.15 1994/06/03 22:22:41 ats Exp $