Add an entry about and on how to avoid portsdb segfaults. I don't know

if the bug in the imported bdb 1.85 which causes this has ever been fixed
and if so which FreeBSD versions contain the fix - feel free to add that
information to the entry.

1 files changed, 13 insertions, 0 deletions

diff --git a/UPDATING b/UPDATING
index 8c0c591bd9e5..f7251caaf24e 100644
--- a/UPDATING
+++ b/UPDATING
@@ -6,6 +6,19 @@ You should get into the habit of checking this file for changes each
 time you update your ports collection, before attempting any port
 upgrades.
 
+20041118:
+  AFFECTS: users of sysutils/portupgrade
+  AUTHOR: lofi@freebsd.org
+
+  portsdb(1) is part of the portupgrade suite and is used to convert a ports 
+  INDEX file to a binary INDEX.db database. By default, it uses the libc-builtin
+  berkeley db to do so, which has a buggy btree implementation.
+
+  If you see errors like "[BUG] Segmentation fault" while a portsdb update is
+  in progress, adjust the PORTS_DBDRIVER variable (in your environment or in
+  pkgtools.conf) to either bdb_hash or bdb_btree (the latter requires you to install
+  the sysutils/ruby-bdb port).
+
 20041116:
   AFFECTS: users of www/bricolage
   AUTHOR: ports@rbt.ca