UPDATING

   1 Updating Information for FreeBSD current users
   2
   3 This file is maintained and copyrighted by M. Warner Losh
   4 <imp@village.org>.  See end of file for further details.  For commonly
   5 done items, please see the COMMON ITEMS: section later in the file.
   6
   7 Items affecting the ports and packages system can be found in
   8 /usr/ports/UPDATING.  Please read that file before running
   9 portupgrade.
  10
  11 NOTE TO PEOPLE WHO THINK THAT FreeBSD 8.x IS SLOW ON IA64 OR SUN4V:
  12         For ia64 the INVARIANTS and INVARIANT_SUPPORT kernel options
  13         were left in the GENERIC kernel because the kernel does not
  14         work properly without them.  For sun4v all of the normal kernel
  15         debugging tools present in HEAD were left in place because
  16         sun4v support still needs work to become production ready.
  17
  18 20111223:       p7      FreeBSD-SA-11:06.bind, FreeBSD-SA-11:07.chroot
  19                         FreeBSD-SA-11:08.telnetd, FreeBSD-SA-11:09.pam_ssh
  20                         FreeBSD-SA-11:10.pam
  21         Fix a problem whereby a corrupt DNS record can cause named to crash.
  22         [11:06]
  23
  24         Add an API for alerting internal libc routines to the presence of
  25         "unsafe" paths post-chroot, and use it in ftpd. [11:07]
  26
  27         Fix a buffer overflow in telnetd. [11:08]
  28
  29         Make pam_ssh ignore unpassphrased keys unless the "nullok" option is
  30         specified. [11:09]
  31
  32         Add sanity checking of service names in pam_start. [11:10]
  33
  34 20111004:       p6      FreeBSD-SA-11:05.unix (revised)
  35         Fix a bug in UNIX socket handling in the linux emulator which was
  36         exposed by the security fix in FreeBSD-SA-11:05.unix.
  37
  38 20110928:       p5      FreeBSD-SA-11:04.compress, FreeBSD-SA-11:05.unix
  39         Fix handling of corrupt compress(1)ed data. [11:04]
  40
  41         Add missing length checks on unix socket addresses. [11:05]
  42
  43 20110528:       p4      FreeBSD-SA-11:02.bind
  44         Fix BIND remote DoS with large RRSIG RRsets and negative
  45         caching.
  46
  47 20110420:       p3      FreeBSD-SA-11:01.mountd
  48         Fix CIDR parsing bug in mountd ACLs.
  49
  50 20101129:       p2      FreeBSD-SA-10:10.openssl
  51         Fix OpenSSL multiple vulnerabilities.
  52
  53 20100920:       p1      FreeBSD-SA-10:08.bzip2
  54         Fix an integer overflow in RLE length parsing when decompressing
  55         corrupt bzip2 data.
  56
  57 20100720:
  58         8.1-RELEASE.
  59
  60 20100713:               FreeBSD-SA-10:07.mbuf
  61         Correctly copy the M_RDONLY flag when duplicating a reference
  62         to an mbuf external buffer.
  63
  64 20100502:
  65         The config(8) command has been updated to maintain compatibility
  66         with config files from 8.0-RELEASE.  You will need a new version
  67         of config to build kernels (this version can be used from 8.0-RELEASE
  68         forward).  The buildworld target will generate it, so following
  69         the instructions in this file for updating will work glitch-free.
  70         Merely doing a make buildkernel without first doing a make buildworld
  71         (or kernel-toolchain), or attempting to build a kernel using
  72         traidtional methods will generate a config version warning, indicating
  73         you should update.
  74
  75 20100408:
  76         The rc.firewall and rc.firewall6 were unified, and
  77         rc.firewall6 and rc.d/ip6fw were removed.
  78         According to the removal of rc.d/ip6fw, ipv6_firewall_* rc
  79         variables are obsoleted.  Instead, the following new rc
  80         variables are added to rc.d/ipfw:
  81
  82                 firewall_client_net_ipv6, firewall_simple_iif_ipv6,
  83                 firewall_simple_inet_ipv6, firewall_simple_oif_ipv6,
  84                 firewall_simple_onet_ipv6
  85
  86         The meanings correspond to the relevant IPv4 variables.
  87
  88 20100417:
  89         COMPAT_IA32 has been added as an alias for COMPAT_FREEBSD32.  A new
  90         version of config(8) is required.  The error message when you hit this
  91         condition is confusing (COMPAT_FREEBSD32 duplicate option), when it
  92         should really say "your config is too old to compile this new kernel."
  93
  94 20100406:
  95         The kernel option COMPAT_IA32 has been replaced with COMPAT_FREEBSD32
  96         to allow 32-bit compatibility on non-x86 platforms. All kernel
  97         configurations on amd64 and ia64 platforms using these options must
  98         be modified accordingly.
  99
 100 20100125:
 101         Introduce the kernel thread "deadlock resolver" (which can be enabled
 102         via the DEADLKRES option, see NOTES for more details) and the
 103         sleepq_type() function for sleepqueues.
 104
 105 20091125:
 106         8.0-RELEASE.
 107
 108 20090929:
 109         802.11s D3.03 support was committed. This is incompatible with
 110         the previous code, which was based on D3.0.
 111
 112 20090915:
 113         ZFS snapshots are now mounted with MNT_IGNORE flag. Use -v option for
 114         mount(8) and -a option for df(1) to see them.
 115
 116 20090813:
 117         Remove the option STOP_NMI.  The default action is now to use NMI
 118         only for KDB via the newly introduced function stop_cpus_hard()
 119         and maintain stop_cpus() to just use a normal IPI_STOP on ia32
 120         and amd64.
 121
 122 20090803:
 123         RELENG_8 branched.
 124
 125 20090719:
 126         Bump the shared library version numbers for all libraries that
 127         do not use symbol versioning as part of the 8.0-RELEASE cycle.
 128         Bump __FreeBSD_version to 800105.
 129
 130 20090714:
 131         Due to changes in the implementation of virtual network stack
 132         support, all network-related kernel modules must be recompiled.
 133         As this change breaks the ABI, bump __FreeBSD_version to 800104.
 134
 135 20090713:
 136         The TOE interface to the TCP syncache has been modified to remove struct
 137         tcpopt (<netinet/tcp_var.h>) from the ABI of the network stack.  The
 138         cxgb driver is the only TOE consumer affected by this change, and needs
 139         to be recompiled along with the kernel. As this change breaks the ABI,
 140         bump __FreeBSD_version to 800103.
 141
 142 20090712:
 143         Padding has been added to struct tcpcb, sackhint and tcpstat in
 144         <netinet/tcp_var.h> to facilitate future MFCs and bug fixes whilst
 145         maintainig the ABI. However, this change breaks the ABI, so bump
 146         __FreeBSD_version to 800102. User space tools that rely on the size of
 147         any of these structs (e.g. sockstat) need to be recompiled.
 148
 149 20090630:
 150         The NFS_LEGACYRPC option has been removed along with the old
 151         kernel RPC implementation that this option selected. Kernel
 152         configurations may need to be adjusted.
 153
 154 20090629:
 155         The network interface device nodes at /dev/net/<interface> have
 156         been removed.  All ioctl operations can be performed the normal
 157         way using routing sockets.  The kqueue functionality can
 158         generally be replaced with routing sockets.
 159
 160 20090628:
 161         The documentation from the FreeBSD Documentation Project
 162         (Handbook, FAQ, etc.) is now installed via packages by
 163         sysinstall(8) and under the /usr/local/share/doc/freebsd
 164         directory instead of /usr/share/doc.
 165
 166 20090624:
 167         The ABI of various structures related to the SYSV IPC API have
 168         been changed.  As a result, the COMPAT_FREEBSD[456] and COMPAT_43
 169         kernel options now all require COMPAT_FREEBSD7.
 170         Bump __FreeBSD_version to 800100.
 171
 172 20090622:
 173         Layout of struct vnet has changed as routing related variables
 174         were moved to their own Vimage module. Modules need to be
 175         recompiled.  Bump __FreeBSD_version to 800099.
 176
 177 20090619:
 178         NGROUPS_MAX and NGROUPS have been increased from 16 to 1023
 179         and 1024 respectively.  As long as no more than 16 groups per
 180         process are used, no changes should be visible.  When more
 181         than 16 groups are used, old binaries may fail if they call
 182         getgroups() or getgrouplist() with statically sized storage.
 183         Recompiling will work around this, but applications should be
 184         modified to use dynamically allocated storage for group arrays
 185         as POSIX.1-2008 does not cap an implementation's number of
 186         supported groups at NGROUPS_MAX+1 as previous versions did.
 187
 188         NFS and portalfs mounts may also be affected as the list of
 189         groups is truncated to 16.  Users of NFS who use more than 16
 190         groups, should take care that negative group permissions are not
 191         used on the exported file systems as they will not be reliable
 192         unless a GSSAPI based authentication method is used.
 193
 194 20090616:
 195         The compiling option ADAPTIVE_LOCKMGRS has been introduced.
 196         This option compiles in the support for adaptive spinning for lockmgrs
 197         which want to enable it.  The lockinit() function now accepts the
 198         flag LK_ADAPTIVE in order to make the lock object subject to
 199         adaptive spinning when both held in write and read mode.
 200
 201 20090613:
 202         The layout of the structure returned by IEEE80211_IOC_STA_INFO
 203         has changed.  User applications that use this ioctl need to be
 204         rebuilt.
 205
 206 20090611:
 207         The layout of struct thread has changed.  Kernel and modules
 208         need to be rebuilt.
 209
 210 20090608:
 211         The layout of structs ifnet, domain, protosw and vnet_net has
 212         changed.  Kernel modules need to be rebuilt.
 213         Bump __FreeBSD_version to 800097.
 214
 215 20090602:
 216         window(1) has been removed from the base system. It can now be
 217         installed from ports. The port is called misc/window.
 218
 219 20090601:
 220         The way we are storing and accessing `routing table' entries
 221         has changed. Programs reading the FIB, like netstat, need to
 222         be re-compiled.
 223
 224 20090601:
 225         A new netisr implementation has been added for FreeBSD 8.  Network
 226         file system modules, such as igmp, ipdivert, and others, should be
 227         rebuilt.
 228         Bump __FreeBSD_version to 800096.
 229
 230 20090530:
 231         Remove the tunable/sysctl debug.mpsafevfs as its initial purpose
 232         is no more valid.
 233
 234 20090530:
 235         Add VOP_ACCESSX(9).  File system modules need to be rebuilt.
 236         Bump __FreeBSD_version to 800094.
 237
 238 20090529:
 239         Add mnt_xflag field to 'struct mount'.  File system modules
 240         need to be rebuilt.
 241         Bump __FreeBSD_version to 800093.
 242
 243 20090528:
 244         The compiling option ADAPTIVE_SX has been retired while it has been
 245         introduced the option NO_ADAPTIVE_SX which handles the reversed logic.
 246         The KPI for sx_init_flags() changes as accepting flags:
 247         SX_ADAPTIVESPIN flag has been retired while the SX_NOADAPTIVE flag
 248         has been introduced in order to handle the reversed logic.
 249         Bump __FreeBSD_version to 800092.
 250
 251 20090527:
 252         Add support for hierarchical jails.  Remove global securelevel.
 253         Bump __FreeBSD_version to 800091.
 254
 255 20090523:
 256         The layout of struct vnet_net has changed, therefore modules
 257         need to be rebuilt.
 258         Bump __FreeBSD_version to 800090.
 259
 260 20090523:
 261         The newly imported zic(8) produces a new format in the
 262         output. Please run tzsetup(8) to install the newly created
 263         data to /etc/localtime.
 264
 265 20090520:
 266         The sysctl tree for the usb stack has renamed from hw.usb2.* to
 267         hw.usb.* and is now consistent again with previous releases.
 268
 269 20090520:
 270         802.11 monitor mode support was revised and driver api's
 271         were changed.  Drivers dependent on net80211 now support
 272         DLT_IEEE802_11_RADIO instead of DLT_IEEE802_11.  No
 273         user-visible data structures were changed but applications
 274         that use DLT_IEEE802_11 may require changes.
 275         Bump __FreeBSD_version to 800088.
 276
 277 20090430:
 278         The layout of the following structs has changed: sysctl_oid,
 279         socket, ifnet, inpcbinfo, tcpcb, syncache_head, vnet_inet,
 280         vnet_inet6 and vnet_ipfw.  Most modules need to be rebuild or
 281         panics may be experienced.  World rebuild is required for
 282         correctly checking networking state from userland.
 283         Bump __FreeBSD_version to 800085.
 284
 285 20090429:
 286         MLDv2 and Source-Specific Multicast (SSM) have been merged
 287         to the IPv6 stack. VIMAGE hooks are in but not yet used.
 288         The implementation of SSM within FreeBSD's IPv6 stack closely
 289         follows the IPv4 implementation.
 290
 291         For kernel developers:
 292
 293         * The most important changes are that the ip6_output() and
 294           ip6_input() paths no longer take the IN6_MULTI_LOCK,
 295           and this lock has been downgraded to a non-recursive mutex.
 296
 297         * As with the changes to the IPv4 stack to support SSM, filtering
 298           of inbound multicast traffic must now be performed by transport
 299           protocols within the IPv6 stack. This does not apply to TCP and
 300           SCTP, however, it does apply to UDP in IPv6 and raw IPv6.
 301
 302         * The KPIs used by IPv6 multicast are similar to those used by
 303           the IPv4 stack, with the following differences:
 304            * im6o_mc_filter() is analogous to imo_multicast_filter().
 305            * The legacy KAME entry points in6_joingroup and in6_leavegroup()
 306              are shimmed to in6_mc_join() and in6_mc_leave() respectively.
 307            * IN6_LOOKUP_MULTI() has been deprecated and removed.
 308            * IPv6 relies on MLD for the DAD mechanism. KAME's internal KPIs
 309              for MLDv1 have an additional 'timer' argument which is used to
 310              jitter the initial membership report for the solicited-node
 311              multicast membership on-link.
 312            * This is not strictly needed for MLDv2, which already jitters
 313              its report transmissions.  However, the 'timer' argument is
 314              preserved in case MLDv1 is active on the interface.
 315
 316         * The KAME linked-list based IPv6 membership implementation has
 317           been refactored to use a vector similar to that used by the IPv4
 318           stack.
 319           Code which maintains a list of its own multicast memberships
 320           internally, e.g. carp, has been updated to reflect the new
 321           semantics.
 322
 323         * There is a known Lock Order Reversal (LOR) due to in6_setscope()
 324           acquiring the IF_AFDATA_LOCK and being called within ip6_output().
 325           Whilst MLDv2 tries to avoid this otherwise benign LOR, it is an
 326           implementation constraint which needs to be addressed in HEAD.
 327
 328         For application developers:
 329
 330         * The changes are broadly similar to those made for the IPv4
 331           stack.
 332
 333         * The use of IPv4 and IPv6 multicast socket options on the same
 334           socket, using mapped addresses, HAS NOT been tested or supported.
 335
 336         * There are a number of issues with the implementation of various
 337           IPv6 multicast APIs which need to be resolved in the API surface
 338           before the implementation is fully compatible with KAME userland
 339           use, and these are mostly to do with interface index treatment.
 340
 341         * The literature available discusses the use of either the delta / ASM
 342           API with setsockopt(2)/getsockopt(2), or the full-state / ASM API
 343           using setsourcefilter(3)/getsourcefilter(3). For more information
 344           please refer to RFC 3768, 'Socket Interface Extensions for
 345           Multicast Source Filters'.
 346
 347         * Applications which use the published RFC 3678 APIs should be fine.
 348
 349         For systems administrators:
 350
 351         * The mtest(8) utility has been refactored to support IPv6, in
 352           addition to IPv4. Interface addresses are no longer accepted
 353           as arguments, their names must be used instead. The utility
 354           will map the interface name to its first IPv4 address as
 355           returned by getifaddrs(3).
 356
 357         * The ifmcstat(8) utility has also been updated to print the MLDv2
 358           endpoint state and source filter lists via sysctl(3).
 359
 360         * The net.inet6.ip6.mcast.loop sysctl may be tuned to 0 to disable
 361           loopback of IPv6 multicast datagrams by default; it defaults to 1
 362           to preserve the existing behaviour. Disabling multicast loopback is
 363           recommended for optimal system performance.
 364
 365         * The IPv6 MROUTING code has been changed to examine this sysctl
 366           instead of attempting to perform a group lookup before looping
 367           back forwarded datagrams.
 368
 369         Bump __FreeBSD_version to 800084.
 370
 371 20090422:
 372         Implement low-level Bluetooth HCI API.
 373         Bump __FreeBSD_version to 800083.
 374
 375 20090419:
 376         The layout of struct malloc_type, used by modules to register new
 377         memory allocation types, has changed.  Most modules will need to
 378         be rebuilt or panics may be experienced.
 379         Bump __FreeBSD_version to 800081.
 380
 381 20090415:
 382         Anticipate overflowing inp_flags - add inp_flags2.
 383         This changes most offsets in inpcb, so checking v4 connection
 384         state will require a world rebuild.
 385         Bump __FreeBSD_version to 800080.
 386
 387 20090415:
 388         Add an llentry to struct route and struct route_in6. Modules
 389         embedding a struct route will need to be recompiled.
 390         Bump __FreeBSD_version to 800079.
 391
 392 20090414:
 393         The size of rt_metrics_lite and by extension rtentry has changed.
 394         Networking administration apps will need to be recompiled.
 395         The route command now supports show as an alias for get, weighting
 396         of routes, sticky and nostick flags to alter the behavior of stateful
 397         load balancing.
 398         Bump __FreeBSD_version to 800078.
 399
 400 20090408:
 401         Do not use Giant for kbdmux(4) locking. This is wrong and
 402         apparently causing more problems than it solves. This will
 403         re-open the issue where interrupt handlers may race with
 404         kbdmux(4) in polling mode. Typical symptoms include (but
 405         not limited to) duplicated and/or missing characters when
 406         low level console functions (such as gets) are used while
 407         interrupts are enabled (for example geli password prompt,
 408         mountroot prompt etc.). Disabling kbdmux(4) may help.
 409
 410 20090407:
 411         The size of structs vnet_net, vnet_inet and vnet_ipfw has changed;
 412         kernel modules referencing any of the above need to be recompiled.
 413         Bump __FreeBSD_version to 800075.
 414
 415 20090320:
 416         GEOM_PART has become the default partition slicer for storage devices,
 417         replacing GEOM_MBR, GEOM_BSD, GEOM_PC98 and GEOM_GPT slicers. It
 418         introduces some changes:
 419
 420         MSDOS/EBR: the devices created from MSDOS extended partition entries
 421         (EBR) can be named differently than with GEOM_MBR and are now symlinks
 422         to devices with offset-based names. fstabs may need to be modified.
 423
 424         BSD: the "geometry does not match label" warning is harmless in most
 425         cases but it points to problems in file system misalignment with
 426         disk geometry. The "c" partition is now implicit, covers the whole
 427         top-level drive and cannot be (mis)used by users.
 428
 429         General: Kernel dumps are now not allowed to be written to devices
 430         whose partition types indicate they are meant to be used for file
 431         systems (or, in case of MSDOS partitions, as something else than
 432         the "386BSD" type).
 433
 434         Most of these changes date approximately from 200812.
 435
 436 20090319:
 437         The uscanner(4) driver has been removed from the kernel. This follows
 438         Linux removing theirs in 2.6 and making libusb the default interface
 439         (supported by sane).
 440
 441 20090319:
 442         The multicast forwarding code has been cleaned up. netstat(1)
 443         only relies on KVM now for printing bandwidth upcall meters.
 444         The IPv4 and IPv6 modules are split into ip_mroute_mod and
 445         ip6_mroute_mod respectively. The config(5) options for statically
 446         compiling this code remain the same, i.e. 'options MROUTING'.
 447
 448 20090315:
 449         Support for the IFF_NEEDSGIANT network interface flag has been
 450         removed, which means that non-MPSAFE network device drivers are no
 451         longer supported.  In particular, if_ar, if_sr, and network device
 452         drivers from the old (legacy) USB stack can no longer be built or
 453         used.
 454
 455 20090313:
 456         POSIX.1 Native Language Support (NLS) has been enabled in libc and
 457         a bunch of new language catalog files have also been added.
 458         This means that some common libc messages are now localized and
 459         they depend on the LC_MESSAGES environmental variable.
 460
 461 20090313:
 462         The k8temp(4) driver has been renamed to amdtemp(4) since
 463         support for K10 and K11 CPU families was added.
 464
 465 20090309:
 466         IGMPv3 and Source-Specific Multicast (SSM) have been merged
 467         to the IPv4 stack. VIMAGE hooks are in but not yet used.
 468
 469         For kernel developers, the most important changes are that the
 470         ip_output() and ip_input() paths no longer take the IN_MULTI_LOCK(),
 471         and this lock has been downgraded to a non-recursive mutex.
 472
 473         Transport protocols (UDP, Raw IP) are now responsible for filtering
 474         inbound multicast traffic according to group membership and source
 475         filters. The imo_multicast_filter() KPI exists for this purpose.
 476         Transports which do not use multicast (SCTP, TCP) already reject
 477         multicast by default. Forwarding and receive performance may improve
 478         as a mutex acquisition is no longer needed in the ip_input()
 479         low-level input path.  in_addmulti() and in_delmulti() are shimmed
 480         to new KPIs which exist to support SSM in-kernel.
 481
 482         For application developers, it is recommended that loopback of
 483         multicast datagrams be disabled for best performance, as this
 484         will still cause the lock to be taken for each looped-back
 485         datagram transmission. The net.inet.ip.mcast.loop sysctl may
 486         be tuned to 0 to disable loopback by default; it defaults to 1
 487         to preserve the existing behaviour.
 488
 489         For systems administrators, to obtain best performance with
 490         multicast reception and multiple groups, it is always recommended
 491         that a card with a suitably precise hash filter is used. Hash
 492         collisions will still result in the lock being taken within the
 493         transport protocol input path to check group membership.
 494
 495         If deploying FreeBSD in an environment with IGMP snooping switches,
 496         it is recommended that the net.inet.igmp.sendlocal sysctl remain
 497         enabled; this forces 224.0.0.0/24 group membership to be announced
 498         via IGMP.
 499
 500         The size of 'struct igmpstat' has changed; netstat needs to be
 501         recompiled to reflect this.
 502         Bump __FreeBSD_version to 800070.
 503
 504 20090309:
 505         libusb20.so.1 is now installed as libusb.so.1 and the ports system
 506         updated to use it. This requires a buildworld/installworld in order to
 507         update the library and dependencies (usbconfig, etc). Its advisable to
 508         rebuild all ports which uses libusb. More specific directions are given
 509         in the ports collection UPDATING file. Any /etc/libmap.conf entries for
 510         libusb are no longer required and can be removed.
 511
 512 20090302:
 513         A workaround is committed to allow the creation of System V shared
 514         memory segment of size > 2 GB on the 64-bit architectures.
 515         Due to a limitation of the existing ABI, the shm_segsz member
 516         of the struct shmid_ds, returned by shmctl(IPC_STAT) call is
 517         wrong for large segments. Note that limits must be explicitly
 518         raised to allow such segments to be created.
 519
 520 20090301:
 521         The layout of struct ifnet has changed, requiring a rebuild of all
 522         network device driver modules.
 523
 524 20090227:
 525         The /dev handling for the new USB stack has changed, a
 526         buildworld/installworld is required for libusb20.
 527
 528 20090223:
 529         The new USB2 stack has now been permanently moved in and all kernel and
 530         module names reverted to their previous values (eg, usb, ehci, ohci,
 531         ums, ...).  The old usb stack can be compiled in by prefixing the name
 532         with the letter 'o', the old usb modules have been removed.
 533         Updating entry 20090216 for xorg and 20090215 for libmap may still
 534         apply.
 535
 536 20090217:
 537         The rc.conf(5) option if_up_delay has been renamed to
 538         defaultroute_delay to better reflect its purpose. If you have
 539         customized this setting in /etc/rc.conf you need to update it to
 540         use the new name.
 541
 542 20090216:
 543         xorg 7.4 wants to configure its input devices via hald which does not
 544         yet work with USB2. If the keyboard/mouse does not work in xorg then
 545         add
 546                 Option "AllowEmptyInput" "off"
 547         to your ServerLayout section.  This will cause X to use the configured
 548         kbd and mouse sections from your xorg.conf.
 549
 550 20090215:
 551         The GENERIC kernels for all architectures now default to the new USB2
 552         stack. No kernel config options or code have been removed so if a
 553         problem arises please report it and optionally revert to the old USB
 554         stack. If you are loading USB kernel modules or have a custom kernel
 555         that includes GENERIC then ensure that usb names are also changed over,
 556         eg uftdi -> usb2_serial_ftdi.
 557
 558         Older programs linked against the ports libusb 0.1 need to be
 559         redirected to the new stack's libusb20.  /etc/libmap.conf can
 560         be used for this:
 561                 # Map old usb library to new one for usb2 stack
 562                 libusb-0.1.so.8 libusb20.so.1
 563
 564 20090209:
 565         All USB ethernet devices now attach as interfaces under the name ueN
 566         (eg. ue0). This is to provide a predictable name as vendors often
 567         change usb chipsets in a product without notice.
 568
 569 20090203:
 570         The ichsmb(4) driver has been changed to require SMBus slave
 571         addresses be left-justified (xxxxxxx0b) rather than right-justified.
 572         All of the other SMBus controller drivers require left-justified
 573         slave addresses, so this change makes all the drivers provide the
 574         same interface.
 575
 576 20090201:
 577         INET6 statistics (struct ip6stat) was updated.
 578         netstat(1) needs to be recompiled.
 579
 580 20090119:
 581         NTFS has been removed from GENERIC kernel on amd64 to match
 582         GENERIC on i386. Should not cause any issues since mount_ntfs(8)
 583         will load ntfs.ko module automatically when NTFS support is
 584         actually needed, unless ntfs.ko is not installed or security
 585         level prohibits loading kernel modules. If either is the case,
 586         "options NTFS" has to be added into kernel config.
 587
 588 20090115:
 589         TCP Appropriate Byte Counting (RFC 3465) support added to kernel.
 590         New field in struct tcpcb breaks ABI, so bump __FreeBSD_version to
 591         800061. User space tools that rely on the size of struct tcpcb in
 592         tcp_var.h (e.g. sockstat) need to be recompiled.
 593
 594 20081225:
 595         ng_tty(4) module updated to match the new TTY subsystem.
 596         Due to API change, user-level applications must be updated.
 597         New API support added to mpd5 CVS and expected to be present
 598         in next mpd5.3 release.
 599
 600 20081219:
 601         With __FreeBSD_version 800060 the makefs tool is part of
 602         the base system (it was a port).
 603
 604 20081216:
 605         The afdata and ifnet locks have been changed from mutexes to
 606         rwlocks, network modules will need to be re-compiled.
 607
 608 20081214:
 609         __FreeBSD_version 800059 incorporates the new arp-v2 rewrite.
 610         RTF_CLONING, RTF_LLINFO and RTF_WASCLONED flags are eliminated.
 611         The new code reduced struct rtentry{} by 16 bytes on 32-bit
 612         architecture and 40 bytes on 64-bit architecture. The userland
 613         applications "arp" and "ndp" have been updated accordingly.
 614         The output from "netstat -r" shows only routing entries and
 615         none of the L2 information.
 616
 617 20081130:
 618         __FreeBSD_version 800057 marks the switchover from the
 619         binary ath hal to source code. Users must add the line:
 620
 621         options AH_SUPPORT_AR5416
 622
 623         to their kernel config files when specifying:
 624
 625         device  ath_hal
 626
 627         The ath_hal module no longer exists; the code is now compiled
 628         together with the driver in the ath module.  It is now
 629         possible to tailor chip support (i.e. reduce the set of chips
 630         and thereby the code size); consult ath_hal(4) for details.
 631
 632 20081121:
 633         __FreeBSD_version 800054 adds memory barriers to
 634         <machine/atomic.h>, new interfaces to ifnet to facilitate
 635         multiple hardware transmit queues for cards that support
 636         them, and a lock-less ring-buffer implementation to
 637         enable drivers to more efficiently manage queueing of
 638         packets.
 639
 640 20081117:
 641         A new version of ZFS (version 13) has been merged to -HEAD.
 642         This version has zpool attribute "listsnapshots" off by
 643         default, which means "zfs list" does not show snapshots,
 644         and is the same as Solaris behavior.
 645
 646 20081028:
 647         dummynet(4) ABI has changed. ipfw(8) needs to be recompiled.
 648
 649 20081009:
 650         The uhci, ohci, ehci and slhci USB Host controller drivers have
 651         been put into separate modules. If you load the usb module
 652         separately through loader.conf you will need to load the
 653         appropriate *hci module as well. E.g. for a UHCI-based USB 2.0
 654         controller add the following to loader.conf:
 655
 656                 uhci_load="YES"
 657                 ehci_load="YES"
 658
 659 20081009:
 660         The ABI used by the PMC toolset has changed.  Please keep
 661         userland (libpmc(3)) and the kernel module (hwpmc(4)) in
 662         sync.
 663
 664 20081009:
 665         atapci kernel module now includes only generic PCI ATA
 666         driver. AHCI driver moved to ataahci kernel module.
 667         All vendor-specific code moved into separate kernel modules:
 668         ataacard, ataacerlabs, ataadaptec, ataamd, ataati, atacenatek,
 669         atacypress, atacyrix, atahighpoint, ataintel, ataite, atajmicron,
 670         atamarvell, atamicron, atanational, atanetcell, atanvidia,
 671         atapromise, ataserverworks, atasiliconimage, atasis, atavia
 672
 673 20080820:
 674         The TTY subsystem of the kernel has been replaced by a new
 675         implementation, which provides better scalability and an
 676         improved driver model. Most common drivers have been migrated to
 677         the new TTY subsystem, while others have not. The following
 678         drivers have not yet been ported to the new TTY layer:
 679
 680         PCI/ISA:
 681                 cy, digi, rc, rp, sio
 682
 683         USB:
 684                 ubser, ucycom
 685
 686         Line disciplines:
 687                 ng_h4, ng_tty, ppp, sl, snp
 688
 689         Adding these drivers to your kernel configuration file shall
 690         cause compilation to fail.
 691
 692 20080818:
 693         ntpd has been upgraded to 4.2.4p5.
 694
 695 20080801:
 696         OpenSSH has been upgraded to 5.1p1.
 697
 698         For many years, FreeBSD's version of OpenSSH preferred DSA
 699         over RSA for host and user authentication keys.  With this
 700         upgrade, we've switched to the vendor's default of RSA over
 701         DSA.  This may cause upgraded clients to warn about unknown
 702         host keys even for previously known hosts.  Users should
 703         follow the usual procedure for verifying host keys before
 704         accepting the RSA key.
 705
 706         This can be circumvented by setting the "HostKeyAlgorithms"
 707         option to "ssh-dss,ssh-rsa" in ~/.ssh/config or on the ssh
 708         command line.
 709
 710         Please note that the sequence of keys offered for
 711         authentication has been changed as well.  You may want to
 712         specify IdentityFile in a different order to revert this
 713         behavior.
 714
 715 20080713:
 716         The sio(4) driver has been removed from the i386 and amd64
 717         kernel configuration files. This means uart(4) is now the
 718         default serial port driver on those platforms as well.
 719
 720         To prevent collisions with the sio(4) driver, the uart(4) driver
 721         uses different names for its device nodes. This means the
 722         onboard serial port will now most likely be called "ttyu0"
 723         instead of "ttyd0". You may need to reconfigure applications to
 724         use the new device names.
 725
 726         When using the serial port as a boot console, be sure to update
 727         /boot/device.hints and /etc/ttys before booting the new kernel.
 728         If you forget to do so, you can still manually specify the hints
 729         at the loader prompt:
 730
 731                 set hint.uart.0.at="isa"
 732                 set hint.uart.0.port="0x3F8"
 733                 set hint.uart.0.flags="0x10"
 734                 set hint.uart.0.irq="4"
 735                 boot -s
 736
 737 20080609:
 738         The gpt(8) utility has been removed. Use gpart(8) to partition
 739         disks instead.
 740
 741 20080603:
 742         The version that Linuxulator emulates was changed from 2.4.2
 743         to 2.6.16. If you experience any problems with Linux binaries
 744         please try to set sysctl compat.linux.osrelease to 2.4.2 and
 745         if it fixes the problem contact emulation mailing list.
 746
 747 20080525:
 748         ISDN4BSD (I4B) was removed from the src tree. You may need to
 749         update a your kernel configuration and remove relevant entries.
 750
 751 20080509:
 752         I have checked in code to support multiple routing tables.
 753         See the man pages setfib(1) and setfib(2).
 754         This is a hopefully backwards compatible version,
 755         but to make use of it you need to compile your kernel
 756         with options ROUTETABLES=2 (or more up to 16).
 757
 758 20080420:
 759         The 802.11 wireless support was redone to enable multi-bss
 760         operation on devices that are capable.  The underlying device
 761         is no longer used directly but instead wlanX devices are
 762         cloned with ifconfig.  This requires changes to rc.conf files.
 763         For example, change:
 764                 ifconfig_ath0="WPA DHCP"
 765         to
 766                 wlans_ath0=wlan0
 767                 ifconfig_wlan0="WPA DHCP"
 768         see rc.conf(5) for more details.  In addition, mergemaster of
 769         /etc/rc.d is highly recommended.  Simultaneous update of userland
 770         and kernel wouldn't hurt either.
 771
 772         As part of the multi-bss changes the wlan_scan_ap and wlan_scan_sta
 773         modules were merged into the base wlan module.  All references
 774         to these modules (e.g. in kernel config files) must be removed.
 775
 776 20080408:
 777         psm(4) has gained write(2) support in native operation level.
 778         Arbitrary commands can be written to /dev/psm%d and status can
 779         be read back from it.  Therefore, an application is responsible
 780         for status validation and error recovery.  It is a no-op in
 781         other operation levels.
 782
 783 20080312:
 784         Support for KSE threading has been removed from the kernel.  To
 785         run legacy applications linked against KSE libmap.conf may
 786         be used.  The following libmap.conf may be used to ensure
 787         compatibility with any prior release:
 788
 789         libpthread.so.1 libthr.so.1
 790         libpthread.so.2 libthr.so.2
 791         libkse.so.3 libthr.so.3
 792
 793 20080301:
 794         The layout of struct vmspace has changed. This affects libkvm
 795         and any executables that link against libkvm and use the
 796         kvm_getprocs() function. In particular, but not exclusively,
 797         it affects ps(1), fstat(1), pkill(1), systat(1), top(1) and w(1).
 798         The effects are minimal, but it's advisable to upgrade world
 799         nonetheless.
 800
 801 20080229:
 802         The latest em driver no longer has support in it for the
 803         82575 adapter, this is now moved to the igb driver. The
 804         split was done to make new features that are incompatible
 805         with older hardware easier to do.
 806
 807 20080220:
 808         The new geom_lvm(4) geom class has been renamed to geom_linux_lvm(4),
 809         likewise the kernel option is now GEOM_LINUX_LVM.
 810
 811 20080211:
 812         The default NFS mount mode has changed from UDP to TCP for
 813         increased reliability.  If you rely on (insecurely) NFS
 814         mounting across a firewall you may need to update your
 815         firewall rules.
 816
 817 20080208:
 818         Belatedly note the addition of m_collapse for compacting
 819         mbuf chains.
 820
 821 20080126:
 822         The fts(3) structures have been changed to use adequate
 823         integer types for their members and so to be able to cope
 824         with huge file trees.  The old fts(3) ABI is preserved
 825         through symbol versioning in libc, so third-party binaries
 826         using fts(3) should still work, although they will not take
 827         advantage of the extended types.  At the same time, some
 828         third-party software might fail to build after this change
 829         due to unportable assumptions made in its source code about
 830         fts(3) structure members.  Such software should be fixed
 831         by its vendor or, in the worst case, in the ports tree.
 832         FreeBSD_version 800015 marks this change for the unlikely
 833         case that a portable fix is impossible.
 834
 835 20080123:
 836         To upgrade to -current after this date, you must be running
 837         FreeBSD not older than 6.0-RELEASE.  Upgrading to -current
 838         from 5.x now requires a stop over at RELENG_6 or RELENG_7 systems.
 839
 840 20071128:
 841         The ADAPTIVE_GIANT kernel option has been retired because its
 842         functionality is the default now.
 843
 844 20071118:
 845         The AT keyboard emulation of sunkbd(4) has been turned on
 846         by default. In order to make the special symbols of the Sun
 847         keyboards driven by sunkbd(4) work under X these now have
 848         to be configured the same way as Sun USB keyboards driven
 849         by ukbd(4) (which also does AT keyboard emulation), f.e.:
 850
 851         Option  "XkbLayout" "us"
 852         Option  "XkbRules" "xorg"
 853         Option  "XkbSymbols" "pc(pc105)+sun_vndr/usb(sun_usb)+us"
 854
 855 20071024:
 856         It has been decided that it is desirable to provide ABI
 857         backwards compatibility to the FreeBSD 4/5/6 versions of the
 858         PCIOCGETCONF, PCIOCREAD and PCIOCWRITE IOCTLs, which was
 859         broken with the introduction of PCI domain support (see the
 860         20070930 entry). Unfortunately, this required the ABI of
 861         PCIOCGETCONF to be broken again in order to be able to
 862         provide backwards compatibility to the old version of that
 863         IOCTL. Thus consumers of PCIOCGETCONF have to be recompiled
 864         again. As for prominent ports this affects neither pciutils
 865         nor xorg-server this time, the hal port needs to be rebuilt
 866         however.
 867
 868 20071020:
 869         The misnamed kthread_create() and friends have been renamed
 870         to kproc_create() etc. Many of the callers already
 871         used kproc_start()..
 872         I will return kthread_create() and friends in a while
 873         with implementations that actually create threads, not procs.
 874         Renaming corresponds with version 800002.
 875
 876 20071010:
 877         RELENG_7 branched.
 878
 879 20071009:
 880         Setting WITHOUT_LIBPTHREAD now means WITHOUT_LIBKSE and
 881         WITHOUT_LIBTHR are set.
 882
 883 20070930:
 884         The PCI code has been made aware of PCI domains. This means that
 885         the location strings as used by pciconf(8) etc are now in the
 886         following format: pci<domain>:<bus>:<device>[:<function>]. It
 887         also means that consumers of <sys/pciio.h> potentially need to
 888         be recompiled; this includes the hal and xorg-server ports.
 889
 890 20070928:
 891         The caching daemon (cached) was renamed to nscd. nscd.conf
 892         configuration file should be used instead of cached.conf and
 893         nscd_enable, nscd_pidfile and nscd_flags options should be used
 894         instead of cached_enable, cached_pidfile and cached_flags in
 895         rc.conf.
 896
 897 20070921:
 898         The getfacl(1) utility now prints owning user and group name
 899         instead of owning uid and gid in the three line comment header.
 900         This is the same behavior as getfacl(1) on Solaris and Linux.
 901
 902 20070704:
 903         The new IPsec code is now compiled in using the IPSEC option.  The
 904         IPSEC option now requires "device crypto" be defined in your kernel
 905         configuration.  The FAST_IPSEC kernel option is now deprecated.
 906
 907 20070702:
 908         The packet filter (pf) code has been updated to OpenBSD 4.1 Please
 909         note the changed syntax - keep state is now on by default.  Also
 910         note the fact that ftp-proxy(8) has been changed from bottom up and
 911         has been moved from libexec to usr/sbin.  Changes in the ALTQ
 912         handling also affect users of IPFW's ALTQ capabilities.
 913
 914 20070701:
 915         Remove KAME IPsec in favor of FAST_IPSEC, which is now the
 916         only IPsec supported by FreeBSD.  The new IPsec stack
 917         supports both IPv4 and IPv6. The kernel option will change
 918         after the code changes have settled in.  For now the kernel
 919         option IPSEC is deprecated and FAST_IPSEC is the only option, that
 920         will change after some settling time.
 921
 922 20070701:
 923         The wicontrol(8) utility has been removed from the base system. wi(4)
 924         cards should be configured using ifconfig(8), see the man page for more
 925         information.
 926
 927 20070612:
 928         The i386/amd64 GENERIC kernel now defaults to the nfe(4) driver
 929         instead of the nve(4) driver. Please update your configuration
 930         accordingly.
 931
 932 20070612:
 933         By default, /etc/rc.d/sendmail no longer rebuilds the aliases
 934         database if it is missing or older than the aliases file.  If
 935         desired, set the new rc.conf option sendmail_rebuild_aliases
 936         to "YES" to restore that functionality.
 937
 938 20070612:
 939         The IPv4 multicast socket code has been considerably modified, and
 940         moved to the file sys/netinet/in_mcast.c. Initial support for the
 941         RFC 3678 Source-Specific Multicast Socket API has been added to
 942         the IPv4 network stack.
 943
 944         Strict multicast and broadcast reception is now the default for
 945         UDP/IPv4 sockets; the net.inet.udp.strict_mcast_mship sysctl variable
 946         has now been removed.
 947
 948         The RFC 1724 hack for interface selection has been removed; the use
 949         of the Linux-derived ip_mreqn structure with IP_MULTICAST_IF has
 950         been added to replace it. Consumers such as routed will soon be
 951         updated to reflect this.
 952
 953         These changes affect users who are running routed(8) or rdisc(8)
 954         from the FreeBSD base system on point-to-point or unnumbered
 955         interfaces.
 956
 957 20070610:
 958         The net80211 layer has changed significantly and all wireless
 959         drivers that depend on it need to be recompiled.  Further these
 960         changes require that any program that interacts with the wireless
 961         support in the kernel be recompiled; this includes: ifconfig,
 962         wpa_supplicant, hostapd, and wlanstats.  Users must also, for
 963         the moment, kldload the wlan_scan_sta and/or wlan_scan_ap modules
 964         if they use modules for wireless support.  These modules implement
 965         scanning support for station and ap modes, respectively.  Failure
 966         to load the appropriate module before marking a wireless interface
 967         up will result in a message to the console and the device not
 968         operating properly.
 969
 970 20070610:
 971         The pam_nologin(8) module ceases to provide an authentication
 972         function and starts providing an account management function.
 973         Consequent changes to /etc/pam.d should be brought in using
 974         mergemaster(8).  Third-party files in /usr/local/etc/pam.d may
 975         need manual editing as follows.  Locate this line (or similar):
 976
 977                 auth    required        pam_nologin.so  no_warn
 978
 979         and change it according to this example:
 980
 981                 account required        pam_nologin.so  no_warn
 982
 983         That is, the first word needs to be changed from "auth" to
 984         "account".  The new line can be moved to the account section
 985         within the file for clarity.  Not updating pam.conf(5) files
 986         will result in nologin(5) ignored by the respective services.
 987
 988 20070529:
 989         The ether_ioctl() function has been synchronized with ioctl(2)
 990         and ifnet.if_ioctl.  Due to that, the size of one of its arguments
 991         has changed on 64-bit architectures.  All kernel modules using
 992         ether_ioctl() need to be rebuilt on such architectures.
 993
 994 20070516:
 995         Improved INCLUDE_CONFIG_FILE support has been introduced to the
 996         config(8) utility. In order to take advantage of this new
 997         functionality, you are expected to recompile and install
 998         src/usr.sbin/config. If you don't rebuild config(8), and your
 999         kernel configuration depends on INCLUDE_CONFIG_FILE, the kernel
1000         build will be broken because of a missing "kernconfstring"
1001         symbol.
1002
1003 20070513:
1004         Symbol versioning is enabled by default.  To disable it, use
1005         option WITHOUT_SYMVER.  It is not advisable to attempt to
1006         disable symbol versioning once it is enabled; your installworld
1007         will break because a symbol version-less libc will get installed
1008         before the install tools.  As a result, the old install tools,
1009         which previously had symbol dependencies to FBSD_1.0, will fail
1010         because the freshly installed libc will not have them.
1011
1012         The default threading library (providing "libpthread") has been
1013         changed to libthr.  If you wish to have libkse as your default,
1014         use option DEFAULT_THREAD_LIB=libkse for the buildworld.
1015
1016 20070423:
1017         The ABI breakage in sendmail(8)'s libmilter has been repaired
1018         so it is no longer necessary to recompile mail filters (aka,
1019         milters).  If you recompiled mail filters after the 20070408
1020         note, it is not necessary to recompile them again.
1021
1022 20070417:
1023         The new trunk(4) driver has been renamed to lagg(4) as it better
1024         reflects its purpose. ifconfig will need to be recompiled.
1025
1026 20070408:
1027         sendmail(8) has been updated to version 8.14.1.  Mail filters
1028         (aka, milters) compiled against the libmilter included in the
1029         base operating system should be recompiled.
1030
1031 20070302:
1032         Firmwares for ipw(4) and iwi(4) are now included in the base tree.
1033         In order to use them one must agree to the respective LICENSE in
1034         share/doc/legal and define legal.intel_<name>.license_ack=1 via
1035         loader.conf(5) or kenv(1).  Make sure to deinstall the now
1036         deprecated modules from the respective firmware ports.
1037
1038 20070228:
1039         The name resolution/mapping functions addr2ascii(3) and ascii2addr(3)
1040         were removed from FreeBSD's libc. These originally came from INRIA
1041         IPv6. Nothing in FreeBSD ever used them. They may be regarded as
1042         deprecated in previous releases.
1043         The AF_LINK support for getnameinfo(3) was merged from NetBSD to
1044         replace it as a more portable (and re-entrant) API.
1045
1046 20070224:
1047         To support interrupt filtering a modification to the newbus API
1048         has occurred, ABI was broken and __FreeBSD_version was bumped
1049         to 700031. Please make sure that your kernel and modules are in
1050         sync. For more info:
1051         http://docs.freebsd.org/cgi/mid.cgi?20070221233124.GA13941
1052
1053 20070224:
1054         The IPv6 multicast forwarding code may now be loaded into GENERIC
1055         kernels by loading the ip_mroute.ko module. This is built into the
1056         module unless WITHOUT_INET6 or WITHOUT_INET6_SUPPORT options are
1057         set; see src.conf(5) for more information.
1058
1059 20070214:
1060         The output of netstat -r has changed. Without -n, we now only
1061         print a "network name" without the prefix length if the network
1062         address and mask exactly match a Class A/B/C network, and an entry
1063         exists in the nsswitch "networks" map.
1064         With -n, we print the full unabbreviated CIDR network prefix in
1065         the form "a.b.c.d/p". 0.0.0.0/0 is always printed as "default".
1066         This change is in preparation for changes such as equal-cost
1067         multipath, and to more generally assist operational deployment
1068         of FreeBSD as a modern IPv4 router.
1069
1070 20070210:
1071         PIM has been turned on by default in the IPv4 multicast
1072         routing code. The kernel option 'PIM' has now been removed.
1073         PIM is now built by default if option 'MROUTING' is specified.
1074         It may now be loaded into GENERIC kernels by loading the
1075         ip_mroute.ko module.
1076
1077 20070207:
1078         Support for IPIP tunnels (VIFF_TUNNEL) in IPv4 multicast routing
1079         has been removed. Its functionality may be achieved by explicitly
1080         configuring gif(4) interfaces and using the 'phyint' keyword in
1081         mrouted.conf.
1082         XORP does not support source-routed IPv4 multicast tunnels nor the
1083         integrated IPIP tunneling, therefore it is not affected by this
1084         change. The __FreeBSD_version macro has been bumped to 700030.
1085
1086 20061221:
1087         Support for PCI Message Signalled Interrupts has been
1088         re-enabled in the bge driver, only for those chips which are
1089         believed to support it properly.  If there are any problems,
1090         MSI can be disabled completely by setting the
1091         'hw.pci.enable_msi' and 'hw.pci.enable_msix' tunables to 0
1092         in the loader.
1093
1094 20061214:
1095         Support for PCI Message Signalled Interrupts has been
1096         disabled again in the bge driver.  Many revisions of the
1097         hardware fail to support it properly.  Support can be
1098         re-enabled by removing the #define of BGE_DISABLE_MSI in
1099         "src/sys/dev/bge/if_bge.c".
1100
1101 20061214:
1102         Support for PCI Message Signalled Interrupts has been added
1103         to the bge driver.  If there are any problems, MSI can be
1104         disabled completely by setting the 'hw.pci.enable_msi' and
1105         'hw.pci.enable_msix' tunables to 0 in the loader.
1106
1107 20061205:
1108         The removal of several facets of the experimental Threading
1109         system from the kernel means that the proc and thread structures
1110         have changed quite a bit. I suggest all kernel modules that might
1111         reference these structures be recompiled.. Especially the
1112         linux module.
1113
1114 20061126:
1115         Sound infrastructure has been updated with various fixes and
1116         improvements. Most of the changes are pretty much transparent,
1117         with exceptions of followings:
1118         1) All sound driver specific sysctls (hw.snd.pcm%d.*) have been
1119            moved to their own dev sysctl nodes, for example:
1120                 hw.snd.pcm0.vchans -> dev.pcm.0.vchans
1121         2) /dev/dspr%d.%d has been deprecated. Each channel now has its
1122            own chardev in the form of "dsp%d.<function>%d", where <function>
1123            is p = playback, r = record and v = virtual, respectively. Users
1124            are encouraged to use these devs instead of (old) "/dev/dsp%d.%d".
1125            This does not affect those who are using "/dev/dsp".
1126
1127 20061122:
1128         geom(4)'s gmirror(8) class metadata structure has been
1129         rev'd from v3 to v4. If you update across this point and
1130         your metadata is converted for you, you will not be easily
1131         able to downgrade since the /boot/kernel.old/geom_mirror.ko
1132         kernel module will be unable to read the v4 metadata.  You
1133         can resolve this by doing from the loader(8) prompt:
1134
1135                 set vfs.root.mountfrom="ufs:/dev/XXX"
1136
1137         where XXX is the root slice of one of the disks that composed
1138         the mirror (i.e.: /dev/ad0s1a). You can then rebuild
1139         the array the same way you built it originally.
1140
1141 20061122:
1142         The following binaries have been disconnected from the build:
1143         mount_devfs, mount_ext2fs, mount_fdescfs, mount_procfs, mount_linprocfs,
1144         and mount_std.  The functionality of these programs has been
1145         moved into the mount program.  For example, to mount a devfs
1146         filesystem, instead of using mount_devfs, use: "mount -t devfs".
1147         This does not affect entries in /etc/fstab, since entries in
1148         /etc/fstab are always processed with "mount -t fstype".
1149
1150 20061113:
1151         Support for PCI Message Signalled Interrupts on i386 and amd64
1152         has been added to the kernel and various drivers will soon be
1153         updated to use MSI when it is available.  If there are any problems,
1154         MSI can be disabled completely by setting the 'hw.pci.enable_msi'
1155         and 'hw.pci.enable_msix' tunables to 0 in the loader.
1156
1157 20061110:
1158         The MUTEX_PROFILING option has been renamed to LOCK_PROFILING.
1159         The lockmgr object layout has been changed as a result of having
1160         a lock_object embedded in it. As a consequence all file system
1161         kernel modules must be re-compiled. The mutex profiling man page
1162         has not yet been updated to reflect this change.
1163
1164 20061026:
1165         KSE in the kernel has now been made optional and turned on by
1166         default. Use 'nooption KSE' in your kernel config to turn it
1167         off. All kernel modules *must* be recompiled after this change.
1168         There-after, modules from a KSE kernel should be compatible with
1169         modules from a NOKSE kernel due to the temporary padding fields
1170         added to 'struct proc'.
1171
1172 20060929:
1173         mrouted and its utilities have been removed from the base system.
1174
1175 20060927:
1176         Some ioctl(2) command codes have changed.  Full backward ABI
1177         compatibility is provided if the "options COMPAT_FREEBSD6" is
1178         present in the kernel configuration file.  Make sure to add
1179         this option to your kernel config file, or recompile X.Org
1180         and the rest of ports; otherwise they may refuse to work.
1181
1182 20060924:
1183         tcpslice has been removed from the base system.
1184
1185 20060913:
1186         The sizes of struct tcpcb (and struct xtcpcb) have changed due to
1187         the rewrite of TCP syncookies.  Tools like netstat, sockstat, and
1188         systat needs to be rebuilt.
1189
1190 20060903:
1191         libpcap updated to v0.9.4 and tcpdump to v3.9.4
1192
1193 20060816:
1194         The IPFIREWALL_FORWARD_EXTENDED option is gone and the behaviour
1195         for IPFIREWALL_FORWARD is now as it was before when it was first
1196         committed and for years after. The behaviour is now ON.
1197
1198 20060725:
1199         enigma(1)/crypt(1) utility has been changed on 64 bit architectures.
1200         Now it can decrypt files created from different architectures.
1201         Unfortunately, it is no longer able to decrypt a cipher text
1202         generated with an older version on 64 bit architectures.
1203         If you have such a file, you need old utility to decrypt it.
1204
1205 20060709:
1206         The interface version of the i4b kernel part has changed. So
1207         after updating the kernel sources and compiling a new kernel,
1208         the i4b user space tools in "/usr/src/usr.sbin/i4b" must also
1209         be rebuilt, and vice versa.
1210
1211 20060627:
1212         The XBOX kernel now defaults to the nfe(4) driver instead of
1213         the nve(4) driver. Please update your configuration
1214         accordingly.
1215
1216 20060514:
1217         The i386-only lnc(4) driver for the AMD Am7900 LANCE and Am79C9xx
1218         PCnet family of NICs has been removed. The new le(4) driver serves
1219         as an equivalent but cross-platform replacement with the pcn(4)
1220         driver still providing performance-optimized support for the subset
1221         of AMD Am79C971 PCnet-FAST and greater chips as before.
1222
1223 20060511:
1224         The machdep.* sysctls and the adjkerntz utility have been
1225         modified a bit.  The new adjkerntz utility uses the new
1226         sysctl names and sysctlbyname() calls, so it may be impossible
1227         to run an old /sbin/adjkerntz utility in single-user mode
1228         with a new kernel.  Replace the `adjkerntz -i' step before
1229         `make installworld' with:
1230
1231             /usr/obj/usr/src/sbin/adjkerntz/adjkerntz -i
1232
1233         and proceed as usual with the rest of the installworld-stage
1234         steps.  Otherwise, you risk installing binaries with their
1235         timestamp set several hours in the future, especially if
1236         you are running with local time set to GMT+X hours.
1237
1238 20060412:
1239         The ip6fw utility has been removed.  The behavior provided by
1240         ip6fw has been in ipfw2 for a good while and the rc.d scripts
1241         have been updated to deal with it.  There are some rules that
1242         might not migrate cleanly.  Use rc.firewall6 as a template to
1243         rewrite rules.
1244
1245 20060428:
1246         The puc(4) driver has been overhauled. The ebus(4) and sbus(4)
1247         attachments have been removed. Make sure to configure scc(4)
1248         on sparc64. Note also that by default puc(4) will use uart(4)
1249         and not sio(4) for serial ports because interrupt handling has
1250         been optimized for multi-port serial cards and only uart(4)
1251         implements the interface to support it.
1252
1253 20060330:
1254         The scc(4) driver replaces puc(4) for Serial Communications
1255         Controllers (SCCs) like the Siemens SAB82532 and the Zilog
1256         Z8530. On sparc64, it is advised to add scc(4) to the kernel
1257         configuration to make sure that the serial ports remain
1258         functional.
1259
1260 20060317:
1261         Most world/kernel related NO_* build options changed names.
1262         New knobs have common prefixes WITHOUT_*/WITH_* (modelled
1263         after FreeBSD ports) and should be set in /etc/src.conf
1264         (the src.conf(5) manpage is provided).  Full backwards
1265         compatibility is maintained for the time being though it's
1266         highly recommended to start moving old options out of the
1267         system-wide /etc/make.conf file into the new /etc/src.conf
1268         while also properly renaming them.  More conversions will
1269         likely follow.  Posting to current@:
1270
1271         http://lists.freebsd.org/pipermail/freebsd-current/2006-March/061725.html
1272
1273 20060305:
1274         The NETSMBCRYPTO kernel option has been retired because its
1275         functionality is always included in NETSMB and smbfs.ko now.
1276
1277 20060303:
1278         The TDFX_LINUX kernel option was retired and replaced by the
1279         tdfx_linux device.  The latter can be loaded as the 3dfx_linux.ko
1280         kernel module.  Loading it alone should suffice to get 3dfx support
1281         for Linux apps because it will pull in 3dfx.ko and linux.ko through
1282         its dependencies.
1283
1284 20060204:
1285         The 'audit' group was added to support the new auditing functionality
1286         in the base system.  Be sure to follow the directions for updating,
1287         including the requirement to run mergemaster -p.
1288
1289 20060201:
1290         The kernel ABI to file system modules was changed on i386.
1291         Please make sure that your kernel and modules are in sync.
1292
1293 20060118:
1294         This actually occured some time ago, but installing the kernel
1295         now also installs a bunch of symbol files for the kernel modules.
1296         This increases the size of /boot/kernel to about 67Mbytes. You
1297         will need twice this if you will eventually back this up to kernel.old
1298         on your next install.
1299         If you have a shortage of room in your root partition, you should add
1300         -DINSTALL_NODEBUG to your make arguments or add INSTALL_NODEBUG="yes"
1301         to your /etc/make.conf.
1302
1303 20060113:
1304         libc's malloc implementation has been replaced.  This change has the
1305         potential to uncover application bugs that previously went unnoticed.
1306         See the malloc(3) manual page for more details.
1307
1308 20060112:
1309         The generic netgraph(4) cookie has been changed. If you upgrade
1310         kernel passing this point, you also need to upgrade userland
1311         and netgraph(4) utilities like ports/net/mpd or ports/net/mpd4.
1312
1313 20060106:
1314         si(4)'s device files now contain the unit number.
1315         Uses of {cua,tty}A[0-9a-f] should be replaced by {cua,tty}A0[0-9a-f].
1316
1317 20060106:
1318         The kernel ABI was mostly destroyed due to a change in the size
1319         of struct lock_object which is nested in other structures such
1320         as mutexes which are nested in all sorts of other structures.
1321         Make sure your kernel and modules are in sync.
1322
1323 20051231:
1324         The page coloring algorithm in the VM subsystem was converted
1325         from tuning with kernel options to autotuning. Please remove
1326         any PQ_* option except PQ_NOOPT from your kernel config.
1327
1328 20051211:
1329         The net80211-related tools in the tools/tools/ath directory
1330         have been moved to tools/tools/net80211 and renamed with a
1331         "wlan" prefix.  Scripts that use them should be adjusted
1332         accordingly.
1333
1334 20051202:
1335         Scripts in the local_startup directories (as defined in
1336         /etc/defaults/rc.conf) that have the new rc.d semantics will
1337         now be run as part of the base system rcorder. If there are
1338         errors or problems with one of these local scripts, it could
1339         cause boot problems. If you encounter such problems, boot in
1340         single user mode, remove that script from the */rc.d directory.
1341         Please report the problem to the port's maintainer, and the
1342         freebsd-ports@freebsd.org mailing list.
1343
1344 20051129:
1345         The nodev mount option was deprecated in RELENG_6 (where it
1346         was a no-op), and is now unsupported.  If you have nodev or dev listed
1347         in /etc/fstab, remove it, otherwise it will result in a mount error.
1348
1349 20051129:
1350         ABI between ipfw(4) and ipfw(8) has been changed. You need
1351         to rebuild ipfw(8) when rebuilding kernel.
1352
1353 20051108:
1354         rp(4)'s device files now contain the unit number.
1355         Uses of {cua,tty}R[0-9a-f] should be replaced by {cua,tty}R0[0-9a-f].
1356
1357 20051029:
1358         /etc/rc.d/ppp-user has been renamed to /etc/rc.d/ppp.
1359         Its /etc/rc.conf.d configuration file has been `ppp' from
1360         the beginning, and hence there is no need to touch it.
1361
1362 20051014:
1363         Now most modules get their build-time options from the kernel
1364         configuration file.  A few modules still have fixed options
1365         due to their non-conformant implementation, but they will be
1366         corrected eventually.  You may need to review the options of
1367         the modules in use, explicitly specify the non-default options
1368         in the kernel configuration file, and rebuild the kernel and
1369         modules afterwards.
1370
1371 20051001:
1372         kern.polling.enable sysctl MIB is now deprecated. Use ifconfig(8)
1373         to turn polling(4) on your interfaces.
1374
1375 20050927:
1376         The old bridge(4) implementation was retired.  The new
1377         if_bridge(4) serves as a full functional replacement.
1378
1379 20050722:
1380         The ai_addrlen of a struct addrinfo was changed to a socklen_t
1381         to conform to POSIX-2001.  This change broke an ABI
1382         compatibility on 64 bit architecture.  You have to recompile
1383         userland programs that use getaddrinfo(3) on 64 bit
1384         architecture.
1385
1386 20050711:
1387         RELENG_6 branched here.
1388
1389 20050629:
1390         The pccard_ifconfig rc.conf variable has been removed and a new
1391         variable, ifconfig_DEFAULT has been introduced.  Unlike
1392         pccard_ifconfig, ifconfig_DEFAULT applies to ALL interfaces that
1393         do not have ifconfig_ifn entries rather than just those in
1394         removable_interfaces.
1395
1396 20050616:
1397         Some previous versions of PAM have permitted the use of
1398         non-absolute paths in /etc/pam.conf or /etc/pam.d/* when referring
1399         to third party PAM modules in /usr/local/lib.  A change has been
1400         made to require the use of absolute paths in order to avoid
1401         ambiguity and dependence on library path configuration, which may
1402         affect existing configurations.
1403
1404 20050610:
1405         Major changes to network interface API.  All drivers must be
1406         recompiled.  Drivers not in the base system will need to be
1407         updated to the new APIs.
1408
1409 20050609:
1410         Changes were made to kinfo_proc in sys/user.h.  Please recompile
1411         userland, or commands like `fstat', `pkill', `ps', `top' and `w'
1412         will not behave correctly.
1413
1414         The API and ABI for hwpmc(4) have changed with the addition
1415         of sampling support.  Please recompile lib/libpmc(3) and
1416         usr.sbin/{pmcstat,pmccontrol}.
1417
1418 20050606:
1419         The OpenBSD dhclient was imported in place of the ISC dhclient
1420         and the network interface configuration scripts were updated
1421         accordingly.  If you use DHCP to configure your interfaces, you
1422         must now run devd.  Also, DNS updating was lost so you will need
1423         to find a workaround if you use this feature.
1424
1425         The '_dhcp' user was added to support the OpenBSD dhclient.  Be
1426         sure to run mergemaster -p (like you are supposed to do every time
1427         anyway).
1428
1429 20050605:
1430         if_bridge was added to the tree. This has changed struct ifnet.
1431         Please recompile userland and all network related modules.
1432
1433 20050603:
1434         The n_net of a struct netent was changed to an uint32_t, and
1435         1st argument of getnetbyaddr() was changed to an uint32_t, to
1436         conform to POSIX-2001.  These changes broke an ABI
1437         compatibility on 64 bit architecture.  With these changes,
1438         shlib major of libpcap was bumped.  You have to recompile
1439         userland programs that use getnetbyaddr(3), getnetbyname(3),
1440         getnetent(3) and/or libpcap on 64 bit architecture.
1441
1442 20050528:
1443         Kernel parsing of extra options on '#!' first lines of shell
1444         scripts has changed.  Lines with multiple options likely will
1445         fail after this date.  For full details, please see
1446                 http://people.freebsd.org/~gad/Updating-20050528.txt
1447
1448 20050503:
1449         The packet filter (pf) code has been updated to OpenBSD 3.7
1450         Please note the changed anchor syntax and the fact that
1451         authpf(8) now needs a mounted fdescfs(5) to function.
1452
1453 20050415:
1454         The NO_MIXED_MODE kernel option has been removed from the i386
1455         amd64 platforms as its use has been superceded by the new local
1456         APIC timer code.  Any kernel config files containing this option
1457         should be updated.
1458
1459 20050227:
1460         The on-disk format of LC_CTYPE files was changed to be machine
1461         independent.  Please make sure NOT to use NO_CLEAN buildworld
1462         when crossing this point. Crossing this point also requires
1463         recompile or reinstall of all locale depended packages.
1464
1465 20050225:
1466         The ifi_epoch member of struct if_data has been changed to
1467         contain the uptime at which the interface was created or the
1468         statistics zeroed rather then the wall clock time because
1469         wallclock time may go backwards.  This should have no impact
1470         unless an snmp implementation is using this value (I know of
1471         none at this point.)
1472
1473 20050224:
1474         The acpi_perf and acpi_throttle drivers are now part of the
1475         acpi(4) main module.  They are no longer built separately.
1476
1477 20050223:
1478         The layout of struct image_params has changed. You have to
1479         recompile all compatibility modules (linux, svr4, etc) for use
1480         with the new kernel.
1481
1482 20050223:
1483         The p4tcc driver has been merged into cpufreq(4).  This makes
1484         "options CPU_ENABLE_TCC" obsolete.  Please load cpufreq.ko or
1485         compile in "device cpufreq" to restore this functionality.
1486
1487 20050220:
1488         The responsibility of recomputing the file system summary of
1489         a SoftUpdates-enabled dirty volume has been transferred to the
1490         background fsck.  A rebuild of fsck(8) utility is recommended
1491         if you have updated the kernel.
1492
1493         To get the old behavior (recompute file system summary at mount
1494         time), you can set vfs.ffs.compute_summary_at_mount=1 before
1495         mounting the new volume.
1496
1497 20050206:
1498         The cpufreq import is complete.  As part of this, the sysctls for
1499         acpi(4) throttling have been removed.  The power_profile script
1500         has been updated, so you can use performance/economy_cpu_freq in
1501         rc.conf(5) to set AC on/offline cpu frequencies.
1502
1503 20050206:
1504         NG_VERSION has been increased. Recompiling kernel (or ng_socket.ko)
1505         requires recompiling libnetgraph and userland netgraph utilities.
1506
1507 20050114:
1508         Support for abbreviated forms of a number of ipfw options is
1509         now deprecated.  Warnings are printed to stderr indicating the
1510         correct full form when a match occurs.  Some abbreviations may
1511         be supported at a later date based on user feedback.  To be
1512         considered for support, abbreviations must be in use prior to
1513         this commit and unlikely to be confused with current key words.
1514
1515 20041221:
1516         By a popular demand, a lot of NOFOO options were renamed
1517         to NO_FOO (see bsd.compat.mk for a full list).  The old
1518         spellings are still supported, but will cause annoying
1519         warnings on stderr.  Make sure you upgrade properly (see
1520         the COMMON ITEMS: section later in this file).
1521
1522 20041219:
1523         Auto-loading of ancillary wlan modules such as wlan_wep has
1524         been temporarily disabled; you need to statically configure
1525         the modules you need into your kernel or explicitly load them
1526         prior to use.  Specifically, if you intend to use WEP encryption
1527         with an 802.11 device load/configure wlan_wep; if you want to
1528         use WPA with the ath driver load/configure wlan_tkip, wlan_ccmp,
1529         and wlan_xauth as required.
1530
1531 20041213:
1532         The behaviour of ppp(8) has changed slightly.  If lqr is enabled
1533         (``enable lqr''), older versions would revert to LCP ECHO mode on
1534         negotiation failure.  Now, ``enable echo'' is required for this
1535         behaviour.  The ppp version number has been bumped to 3.4.2 to
1536         reflect the change.
1537
1538 20041201:
1539         The wlan support has been updated to split the crypto support
1540         into separate modules.  For static WEP you must configure the
1541         wlan_wep module in your system or build and install the module
1542         in place where it can be loaded (the kernel will auto-load
1543         the module when a wep key is configured).
1544
1545 20041201:
1546         The ath driver has been updated to split the tx rate control
1547         algorithm into a separate module.  You need to include either
1548         ath_rate_onoe or ath_rate_amrr when configuring the kernel.
1549
1550 20041116:
1551         Support for systems with an 80386 CPU has been removed.  Please
1552         use FreeBSD 5.x or earlier on systems with an 80386.
1553
1554 20041110:
1555         We have had a hack which would mount the root filesystem
1556         R/W if the device were named 'md*'.  As part of the vnode
1557         work I'm doing I have had to remove this hack.  People
1558         building systems which use preloaded MD root filesystems
1559         may need to insert a "/sbin/mount -u -o rw /dev/md0 /" in
1560         their /etc/rc scripts.
1561
1562 20041104:
1563         FreeBSD 5.3 shipped here.
1564
1565 20041102:
1566         The size of struct tcpcb has changed again due to the removal
1567         of RFC1644 T/TCP.  You have to recompile userland programs that
1568         read kmem for tcp sockets directly (netstat, sockstat, etc.)
1569
1570 20041022:
1571         The size of struct tcpcb has changed.  You have to recompile
1572         userland programs that read kmem for tcp sockets directly
1573         (netstat, sockstat, etc.)
1574
1575 20041016:
1576         RELENG_5 branched here.  For older entries, please see updating
1577         in the RELENG_5 branch.
1578
1579 COMMON ITEMS:
1580
1581         General Notes
1582         -------------
1583         Avoid using make -j when upgrading.  From time to time in the
1584         past there have been problems using -j with buildworld and/or
1585         installworld.  This is especially true when upgrading between
1586         "distant" versions (eg one that cross a major release boundary
1587         or several minor releases, or when several months have passed
1588         on the -current branch).
1589
1590         Sometimes, obscure build problems are the result of environment
1591         poisoning.  This can happen because the make utility reads its
1592         environment when searching for values for global variables.
1593         To run your build attempts in an "environmental clean room",
1594         prefix all make commands with 'env -i '.  See the env(1) manual
1595         page for more details.
1596
1597         When upgrading from one major version to another it is generally
1598         best to upgrade to the latest code in the currently installed branch
1599         first, then do an upgrade to the new branch. This is the best-tested
1600         upgrade path, and has the highest probability of being successful.
1601         Please try this approach before reporting problems with a major
1602         version upgrade.
1603
1604         To build a kernel
1605         -----------------
1606         If you are updating from a prior version of FreeBSD (even one just
1607         a few days old), you should follow this procedure.  It is the most
1608         failsafe as it uses a /usr/obj tree with a fresh mini-buildworld,
1609
1610         make kernel-toolchain
1611         make -DALWAYS_CHECK_MAKE buildkernel KERNCONF=YOUR_KERNEL_HERE
1612         make -DALWAYS_CHECK_MAKE installkernel KERNCONF=YOUR_KERNEL_HERE
1613
1614         To test a kernel once
1615         ---------------------
1616         If you just want to boot a kernel once (because you are not sure
1617         if it works, or if you want to boot a known bad kernel to provide
1618         debugging information) run
1619         make installkernel KERNCONF=YOUR_KERNEL_HERE KODIR=/boot/testkernel
1620         nextboot -k testkernel
1621
1622         To just build a kernel when you know that it won't mess you up
1623         --------------------------------------------------------------
1624         This assumes you are already running a 5.X system.  Replace
1625         ${arch} with the architecture of your machine (e.g. "i386",
1626         "alpha", "amd64", "ia64", "pc98", "sparc64", etc).
1627
1628         cd src/sys/${arch}/conf
1629         config KERNEL_NAME_HERE
1630         cd ../compile/KERNEL_NAME_HERE
1631         make depend
1632         make
1633         make install
1634
1635         If this fails, go to the "To build a kernel" section.
1636
1637         To rebuild everything and install it on the current system.
1638         -----------------------------------------------------------
1639         # Note: sometimes if you are running current you gotta do more than
1640         # is listed here if you are upgrading from a really old current.
1641
1642         <make sure you have good level 0 dumps>
1643         make buildworld
1644         make kernel KERNCONF=YOUR_KERNEL_HERE
1645                                                         [1]
1646         <reboot in single user>                         [3]
1647         mergemaster -p                                  [5]
1648         make installworld
1649         make delete-old
1650         mergemaster                                     [4]
1651         <reboot>
1652
1653
1654         To cross-install current onto a separate partition
1655         --------------------------------------------------
1656         # In this approach we use a separate partition to hold
1657         # current's root, 'usr', and 'var' directories.   A partition
1658         # holding "/", "/usr" and "/var" should be about 2GB in
1659         # size.
1660
1661         <make sure you have good level 0 dumps>
1662         <boot into -stable>
1663         make buildworld
1664         make buildkernel KERNCONF=YOUR_KERNEL_HERE
1665         <maybe newfs current's root partition>
1666         <mount current's root partition on directory ${CURRENT_ROOT}>
1667         make installworld DESTDIR=${CURRENT_ROOT}
1668         make distribution DESTDIR=${CURRENT_ROOT} # if newfs'd
1669         make installkernel KERNCONF=YOUR_KERNEL_HERE DESTDIR=${CURRENT_ROOT}
1670         cp /etc/fstab ${CURRENT_ROOT}/etc/fstab                    # if newfs'd
1671         <edit ${CURRENT_ROOT}/etc/fstab to mount "/" from the correct partition>
1672         <reboot into current>
1673         <do a "native" rebuild/install as described in the previous section>
1674         <maybe install compatibility libraries from ports/misc/compat*>
1675         <reboot>
1676
1677
1678         To upgrade in-place from 5.x-stable to current
1679         ----------------------------------------------
1680         <make sure you have good level 0 dumps>
1681         make buildworld                                 [9]
1682         make kernel KERNCONF=YOUR_KERNEL_HERE           [8]
1683                                                         [1]
1684         <reboot in single user>                         [3]
1685         mergemaster -p                                  [5]
1686         make installworld
1687         make delete-old
1688         mergemaster -i                                  [4]
1689         <reboot>
1690
1691         Make sure that you've read the UPDATING file to understand the
1692         tweaks to various things you need.  At this point in the life
1693         cycle of current, things change often and you are on your own
1694         to cope.  The defaults can also change, so please read ALL of
1695         the UPDATING entries.
1696
1697         Also, if you are tracking -current, you must be subscribed to
1698         freebsd-current@freebsd.org.  Make sure that before you update
1699         your sources that you have read and understood all the recent
1700         messages there.  If in doubt, please track -stable which has
1701         much fewer pitfalls.
1702
1703         [1] If you have third party modules, such as vmware, you
1704         should disable them at this point so they don't crash your
1705         system on reboot.
1706
1707         [3] From the bootblocks, boot -s, and then do
1708                 fsck -p
1709                 mount -u /
1710                 mount -a
1711                 cd src
1712                 adjkerntz -i            # if CMOS is wall time
1713         Also, when doing a major release upgrade, it is required that
1714         you boot into single user mode to do the installworld.
1715
1716         [4] Note: This step is non-optional.  Failure to do this step
1717         can result in a significant reduction in the functionality of the
1718         system.  Attempting to do it by hand is not recommended and those
1719         that pursue this avenue should read this file carefully, as well
1720         as the archives of freebsd-current and freebsd-hackers mailing lists
1721         for potential gotchas.
1722
1723         [5] Usually this step is a noop.  However, from time to time
1724         you may need to do this if you get unknown user in the following
1725         step.  It never hurts to do it all the time.  You may need to
1726         install a new mergemaster (cd src/usr.sbin/mergemaster && make
1727         install) after the buildworld before this step if you last updated
1728         from current before 20020224 or from -stable before 20020408.
1729
1730         [8] In order to have a kernel that can run the 4.x binaries
1731         needed to do an installworld, you must include the COMPAT_FREEBSD4
1732         option in your kernel.  Failure to do so may leave you with a system
1733         that is hard to boot to recover. A similar kernel option COMPAT_FREEBSD5
1734         is required to run the 5.x binaries on more recent kernels.
1735
1736         Make sure that you merge any new devices from GENERIC since the
1737         last time you updated your kernel config file.
1738
1739         [9] When checking out sources, you must include the -P flag to have
1740         cvs prune empty directories.
1741
1742         If CPUTYPE is defined in your /etc/make.conf, make sure to use the
1743         "?=" instead of the "=" assignment operator, so that buildworld can
1744         override the CPUTYPE if it needs to.
1745
1746         MAKEOBJDIRPREFIX must be defined in an environment variable, and
1747         not on the command line, or in /etc/make.conf.  buildworld will
1748         warn if it is improperly defined.
1749 FORMAT:
1750
1751 This file contains a list, in reverse chronological order, of major
1752 breakages in tracking -current.  Not all things will be listed here,
1753 and it only starts on October 16, 2004.  Updating files can found in
1754 previous releases if your system is older than this.
1755
1756 Copyright information:
1757
1758 Copyright 1998-2005 M. Warner Losh.  All Rights Reserved.
1759
1760 Redistribution, publication, translation and use, with or without
1761 modification, in full or in part, in any form or format of this
1762 document are permitted without further permission from the author.
1763
1764 THIS DOCUMENT IS PROVIDED BY WARNER LOSH ``AS IS'' AND ANY EXPRESS OR
1765 IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
1766 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
1767 DISCLAIMED.  IN NO EVENT SHALL WARNER LOSH BE LIABLE FOR ANY DIRECT,
1768 INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
1769 (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
1770 SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
1771 HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
1772 STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
1773 IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
1774 POSSIBILITY OF SUCH DAMAGE.
1775
1776 If you find this document useful, and you want to, you may buy the
1777 author a beer.
1778
1779 Contact Warner Losh if you have any questions about your use of
1780 this document.
1781
1782 $FreeBSD$