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