rtld(1): Add shared object search order to the man page
[dragonfly.git] / UPDATING
index a2a617c..c20d5dc 100644 (file)
--- a/UPDATING
+++ b/UPDATING
 # If you discover any problem, please contact the bugs@lists.dragonflybsd.org
 # mailing list with the details.
 
++-----------------------------------------------------------------------+
++         UPGRADING DRAGONFLY FROM 3.0 to later versions                +
++-----------------------------------------------------------------------+
+
+APIC_IO OPTION REMOVED
+----------------------
+
+The APIC_IO kernel option is no longer accepted after having been without
+effect for a while. The hw.ioapic_enable tunable now serves its purpose.
+If you have 'options APIC_IO' in your kernel config, you'll have to
+remove it.
+
+WATCHDOG_ENABLE & HW_WDOG OPTIONS REMOVED
+-----------------------------------------
+
+The wdog framework is now compiled into our kernels by default, so the
+options are no longer needed.
+
++-----------------------------------------------------------------------+
++         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.22.  The accepted
+values of BINUTILSVERS are now binutils221 and binutils222 (default).
+
+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
@@ -26,14 +120,14 @@ exists.  pkg_radd will continue to work with defaults.
 +-----------------------------------------------------------------------+
 
 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.
@@ -51,7 +145,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