Merge remote branch 'crater/DragonFly_RELEASE_3_0' into rel3_0
[dragonfly.git] / UPDATING
index d8e4073..a48727c 100644 (file)
--- a/UPDATING
+++ b/UPDATING
@@ -7,15 +7,89 @@
 #
 # If you discover any problem, please contact the bugs@lists.dragonflybsd.org
 # mailing list with the details.
-#
-# $DragonFly: src/UPDATING,v 1.26 2008/09/15 20:03:36 thomas Exp $
 
 +-----------------------------------------------------------------------+
-+         UPGRADING DRAGONFLY FROM 2.8 to later versions
++         UPGRADING DRAGONFLY FROM 2.10 to later versions               +
 +-----------------------------------------------------------------------+
 
+SEVERAL ISA DRIVERS REMOVED
+---------------------------
+
+The following ISA only drivers have been removed along with a couple of
+associated userland tools:
+
+aha(4)
+asc(4) & sasc(1)
+ctx
+dgb(4)
+el(4)
+gpib
+gsc(4) & sgsc(1)
+ie(4)
+labpc(4)
+le(4)
+mse(4)
+rc(4)
+rdp(4)
+spigot
+tw(4) & xten(1) & xtend(8)
+wl(4) & wlconfig(8)
+wt(4)
+
+Note that two of these drivers (aha(4) and ie(4)) are in our GENERIC
+config and one (aha(4)) is in our X86_64_GENERIC kernel configuration
+file.
+
+If buildkernel complains about any of these drivers, just remove them
+from your kernel configuration.
+
+BINUTILS 2.20
+-------------
+Binutils 2.20 has been removed in favor of Binutils 2.21.  The accepted
+values of BINUTILSVERS are now binutils221 (default) and binutils222.
+
+BUILDWORLD/-KERNEL PARALLELIZATION WORK
+---------------------------------------
+Due to changes in the way we build with more than one make job, you
+will have to update install(1) and mkdir(1) prior to buildworld if you
+want to build with 'make -j':
+
+cd /usr/src/usr.bin/xinstall; make; make install; make clean
+cd /usr/src/bin/mkdir; make; make install; make clean
+
+DMA(8) UPGRADE
+--------------
+dma(8) has been upgraded to v0.7 which no longer supports the
+/etc/dma/virtusertable. Some of its functionality has been replaced
+with the MASQUERADE keyword and the EMAIL environment variable (see
+the dma(8) manual page).
+
++-----------------------------------------------------------------------+
++         UPGRADING DRAGONFLY FROM 2.8 to later versions                +
++-----------------------------------------------------------------------+
+
+GCC 4.4 & BINUTILS 2.21
+-----------------------
+
+GCC 4.4 has been made DragonFly's default compiler and Binutils 2.21 has
+been made DragonFly's default Binutils.
+
+That means that any settings that set CCVER to 'gcc44' are not needed
+anymore. Instead, CCVER can be set to 'gcc41' to go back to using
+GCC 4.1.
+
+It also means that 'binutils221' as a value for BINUTILSVER has no
+effect anymore. 2.17 has been removed and 'binutils220' is available
+as an option.
+
+The NO_GCC44 option has been removed and will not affect the build
+anymore. There is now a NO_GCC41 option that will prevent GCC 4.1 from
+building in a similar fashion.
+
+Note that you must do a full buildworld/buildkernel for upgrading.
+
 pkg_radd settings
-=================
+-----------------
 
 The config file for pkg_radd has moved from /etc/settings.conf to 
 /etc/pkg_radd.conf.  Save the contents of settings.conf before upgrading
@@ -23,12 +97,19 @@ if this is needed.  This warning only applies if /etc/settings.conf
 exists.  pkg_radd will continue to work with defaults.
 
 +-----------------------------------------------------------------------+
-+         20100924
-+         UPGRADING DRAGONFLY FROM 2.6 to 2.8 or HEAD
++         20100927                                                     +
++         UPGRADING DRAGONFLY FROM 2.6 to 2.8 or HEAD                  +
 +-----------------------------------------------------------------------+
 
+OpenSSL
+--------
+
+OpenSSL has been upgraded, and SHLIB_MAJOR was bumped for libssh and libcrypto.
+This shouldn't break any 3rd-party software, but you'll need to recompile your
+3rd-party software if you want it to link against the new version of OpenSSL.
+
 Loader
-=======
+-------
 
 A new loader (dloader) has been added which better handles booting from
 multiple kernel/module versions.
@@ -46,7 +127,7 @@ Note that you must installworld and run the 'upgrade' target before
 installing the new kernel.
 
 BIND
-=====
+-----
 
 BIND has been removed from the base system.  The ldns and drill tools have 
 been added for basic functionality.  Use 'drill' where you would normally