UPDATING revision 213404
1Updating Information for FreeBSD current users 2 3This file is maintained and copyrighted by M. Warner Losh <imp@freebsd.org>. 4See end of file for further details. For commonly done items, please see the 5COMMON ITEMS: section later in the file. These instructions assume that you 6basically know what you are doing. If not, then please consult the FreeBSD 7handbook. 8 9Items affecting the ports and packages system can be found in 10/usr/ports/UPDATING. Please read that file before running portupgrade. 11 12NOTE TO PEOPLE WHO THINK THAT FreeBSD 9.x IS SLOW: 13 FreeBSD 9.x has many debugging features turned on, in both the kernel 14 and userland. These features attempt to detect incorrect use of 15 system primitives, and encourage loud failure through extra sanity 16 checking and fail stop semantics. They also substantially impact 17 system performance. If you want to do performance measurement, 18 benchmarking, and optimization, you'll want to turn them off. This 19 includes various WITNESS- related kernel options, INVARIANTS, malloc 20 debugging flags in userland, and various verbose features in the 21 kernel. Many developers choose to disable these features on build 22 machines to maximize performance. (To disable malloc debugging, run 23 ln -s aj /etc/malloc.conf.) 24 2520101002: 26 The man(1) utility has been replaced by a new version that no longer 27 uses /etc/manpath.config. Please consult man.conf(5) for how to 28 migrate local entries to the new format. 29 3020100915: 31 A workaround for a fixed ld bug has been removed in kernel code, 32 so make sure that your system ld is built from sources after 33 revision 210245 (r211583 if building head kernel on stable/8, 34 r211584 for stable/7). A symptom of incorrect ld version is 35 different addresses for set_pcpu section and __start_set_pcpu 36 symbol in kernel and/or modules. 37 3820100913: 39 The $ipv6_prefer variable in rc.conf(5) has been split into 40 $ip6addrctl_policy and $ipv6_activate_all_interfaces. 41 42 The $ip6addrctl_policy is a variable to choose a pre-defined 43 address selection policy set by ip6addrctl(8). A value 44 "ipv4_prefer", "ipv6_prefer" or "AUTO" can be specified. The 45 default is "AUTO". 46 47 The $ipv6_activate_all_interfaces specifies whether IFDISABLED 48 flag (see an entry of 20090926) is set on an interface with no 49 corresponding $ifconfig_IF_ipv6 line. The default is "NO" for 50 security reason. If you want IPv6 link-local address on all 51 interfaces by default, set this to "YES". 52 53 The old ipv6_prefer="YES" is equivalent to 54 ipv6_activate_all_interfaces="YES" and 55 ip6addrctl_policy="ipv6_prefer". 56 5720100913: 58 DTrace has grown support for userland tracing. Due to this, DTrace is 59 now i386 and amd64 only. 60 dtruss(1) is now installed by default on those systems and a new 61 kernel module is needed for userland tracing: fasttrap. 62 No changes to your kernel config file are necessary to enable 63 userland tracing, but you might consider adding 'STRIP=' and 64 'CFLAGS+=-fno-omit-frame-pointer' to your make.conf if you want 65 to have informative userland stack traces in DTrace (ustack). 66 6720100725: 68 The acpi_aiboost(4) driver has been removed in favor of the new 69 aibs(4) driver. You should update your kernel configuration file. 70 7120100722: 72 BSD grep has been imported to the base system and it is built by 73 default. It is completely BSD licensed, highly GNU-compatible, uses 74 less memory than its GNU counterpart and has a small codebase. 75 However, it is slower than its GNU counterpart, which is mostly 76 noticeable for larger searches, for smaller ones it is measurable 77 but not significant. The reason is complex, the most important factor 78 is that we lack a modern and efficient regex library and GNU 79 overcomes this by optimizing the searches internally. Future work 80 on improving the regex performance is planned, for the meantime, 81 users that need better performance, can build GNU grep instead by 82 setting the WITH_GNU_GREP knob. 83 8420100713: 85 Due to the import of powerpc64 support, all existing powerpc kernel 86 configuration files must be updated with a machine directive like this: 87 machine powerpc powerpc 88 89 In addition, an updated config(8) is required to build powerpc kernels 90 after this change. 91 9220100713: 93 A new version of ZFS (version 15) has been merged to -HEAD. 94 This version uses a python library for the following subcommands: 95 zfs allow, zfs unallow, zfs groupspace, zfs userspace. 96 For full functionality of these commands the following port must 97 be installed: sysutils/py-zfs 98 9920100429: 100 'vm_page's are now hashed by physical address to an array of mutexes. 101 Currently this is only used to serialize access to hold_count. Over 102 time the page queue mutex will be peeled away. This changes the size 103 of pmap on every architecture. And requires all callers of vm_page_hold 104 and vm_page_unhold to be updated. 105 10620100402: 107 WITH_CTF can now be specified in src.conf (not recommended, there 108 are some problems with static executables), make.conf (would also 109 affect ports which do not use GNU make and do not override the 110 compile targets) or in the kernel config (via "makeoptions 111 WITH_CTF=yes"). 112 When WITH_CTF was specified there before this was silently ignored, 113 so make sure that WITH_CTF is not used in places which could lead 114 to unwanted behavior. 115 11620100311: 117 The kernel option COMPAT_IA32 has been replaced with COMPAT_FREEBSD32 118 to allow 32-bit compatibility on non-x86 platforms. All kernel 119 configurations on amd64 and ia64 platforms using these options must 120 be modified accordingly. 121 12220100113: 123 The utmp user accounting database has been replaced with utmpx, 124 the user accounting interface standardized by POSIX. 125 Unfortunately the semantics of utmp and utmpx don't match, 126 making it practically impossible to support both interfaces. 127 The user accounting database is used by tools like finger(1), 128 last(1), talk(1), w(1) and ac(8). 129 130 All applications in the base system use utmpx. This means only 131 local binaries (e.g. from the ports tree) may still use these 132 utmp database files. These applications must be rebuilt to make 133 use of utmpx. 134 135 After the system has been upgraded, it is safe to remove the old 136 log files (/var/run/utmp, /var/log/lastlog and /var/log/wtmp*), 137 assuming their contents is of no importance anymore. Old wtmp 138 databases can only be used by last(1) and ac(8) after they have 139 been converted to the new format using wtmpcvt(1). 140 14120100108: 142 Introduce the kernel thread "deadlock resolver" (which can be enabled 143 via the DEADLKRES option, see NOTES for more details) and the 144 sleepq_type() function for sleepqueues. 145 14620091202: 147 The rc.firewall and rc.firewall6 were unified, and 148 rc.firewall6 and rc.d/ip6fw were removed. 149 According to the removal of rc.d/ip6fw, ipv6_firewall_* rc 150 variables are obsoleted. Instead, the following new rc 151 variables are added to rc.d/ipfw: 152 153 firewall_client_net_ipv6, firewall_simple_iif_ipv6, 154 firewall_simple_inet_ipv6, firewall_simple_oif_ipv6, 155 firewall_simple_onet_ipv6, firewall_trusted_ipv6 156 157 The meanings correspond to the relevant IPv4 variables. 158 15920091125: 160 8.0-RELEASE. 161 16220091113: 163 The default terminal emulation for syscons(4) has been changed 164 from cons25 to xterm on all platforms except pc98. This means 165 that the /etc/ttys file needs to be updated to ensure correct 166 operation of applications on the console. 167 168 The terminal emulation style can be toggled per window by using 169 vidcontrol(1)'s -T flag. The TEKEN_CONS25 kernel configuration 170 options can be used to change the compile-time default back to 171 cons25. 172 173 To prevent graphical artifacts, make sure the TERM environment 174 variable is set to match the terminal emulation that is being 175 performed by syscons(4). 176 17720091109: 178 The layout of the structure ieee80211req_scan_result has changed. 179 Applications that require wireless scan results (e.g. ifconfig(8)) 180 from net80211 need to be recompiled. 181 182 Applications such as wpa_supplicant(8) may require a full world 183 build without using NO_CLEAN in order to get synchronized with the 184 new structure. 185 18620091025: 187 The iwn(4) driver has been updated to support the 5000 and 5150 series. 188 There's one kernel module for each firmware. Adding "device iwnfw" 189 to the kernel configuration file means including all three firmware 190 images inside the kernel. If you want to include just the one for 191 your wireless card, use the the devices iwn4965fw, iwn5000fw or 192 iwn5150fw. 193 19420090926: 195 The rc.d/network_ipv6, IPv6 configuration script has been integrated 196 into rc.d/netif. The changes are the following: 197 198 1. To use IPv6, simply define $ifconfig_IF_ipv6 like $ifconfig_IF 199 for IPv4. For aliases, $ifconfig_IF_aliasN should be used. 200 Note that both variables need the "inet6" keyword at the head. 201 202 Do not set $ipv6_network_interfaces manually if you do not 203 understand what you are doing. It is not needed in most cases. 204 205 $ipv6_ifconfig_IF and $ipv6_ifconfig_IF_aliasN still work, but 206 they are obsolete. 207 208 2. $ipv6_enable is obsolete. Use $ipv6_prefer and 209 "inet6 accept_rtadv" keyword in ifconfig(8) instead. 210 211 If you define $ipv6_enable=YES, it means $ipv6_prefer=YES and 212 all configured interfaces have "inet6 accept_rtadv" in the 213 $ifconfig_IF_ipv6. These are for backward compatibility. 214 215 3. A new variable $ipv6_prefer has been added. If NO, IPv6 216 functionality of interfaces with no corresponding 217 $ifconfig_IF_ipv6 is disabled by using "inet6 ifdisabled" flag, 218 and the default address selection policy of ip6addrctl(8) 219 is the IPv4-preferred one (see rc.d/ip6addrctl for more details). 220 Note that if you want to configure IPv6 functionality on the 221 disabled interfaces after boot, first you need to clear the flag by 222 using ifconfig(8) like: 223 224 ifconfig em0 inet6 -ifdisabled 225 226 If YES, the default address selection policy is set as 227 IPv6-preferred. 228 229 The default value of $ipv6_prefer is NO. 230 231 4. If your system need to receive Router Advertisement messages, 232 define "inet6 accept_rtadv" in $ifconfig_IF_ipv6. The rc(8) 233 scripts automatically invoke rtsol(8) when the interface becomes 234 UP. The Router Advertisement messages are used for SLAAC 235 (State-Less Address AutoConfiguration). 236 23720090922: 238 802.11s D3.03 support was committed. This is incompatible with the 239 previous code, which was based on D3.0. 240 24120090912: 242 A sysctl variable net.inet6.ip6.accept_rtadv now sets the default value 243 of a per-interface flag ND6_IFF_ACCEPT_RTADV, not a global knob to 244 control whether accepting Router Advertisement messages or not. 245 Also, a per-interface flag ND6_IFF_AUTO_LINKLOCAL has been added and 246 a sysctl variable net.inet6.ip6.auto_linklocal is its default value. 247 The ifconfig(8) utility now supports these flags. 248 24920090910: 250 ZFS snapshots are now mounted with MNT_IGNORE flag. Use -v option for 251 mount(8) and -a option for df(1) to see them. 252 25320090825: 254 The old tunable hw.bus.devctl_disable has been superseded by 255 hw.bus.devctl_queue. hw.bus.devctl_disable=1 in loader.conf should be 256 replaced by hw.bus.devctl_queue=0. The default for this new tunable 257 is 1000. 258 25920090813: 260 Remove the option STOP_NMI. The default action is now to use NMI only 261 for KDB via the newly introduced function stop_cpus_hard() and 262 maintain stop_cpus() to just use a normal IPI_STOP on ia32 and amd64. 263 26420090803: 265 The stable/8 branch created in subversion. This corresponds to the 266 RELENG_8 branch in CVS. 267 26820090719: 269 Bump the shared library version numbers for all libraries that do not 270 use symbol versioning as part of the 8.0-RELEASE cycle. Bump 271 __FreeBSD_version to 800105. 272 27320090714: 274 Due to changes in the implementation of virtual network stack support, 275 all network-related kernel modules must be recompiled. As this change 276 breaks the ABI, bump __FreeBSD_version to 800104. 277 27820090713: 279 The TOE interface to the TCP syncache has been modified to remove 280 struct tcpopt (<netinet/tcp_var.h>) from the ABI of the network stack. 281 The cxgb driver is the only TOE consumer affected by this change, and 282 needs to be recompiled along with the kernel. As this change breaks 283 the ABI, bump __FreeBSD_version to 800103. 284 28520090712: 286 Padding has been added to struct tcpcb, sackhint and tcpstat in 287 <netinet/tcp_var.h> to facilitate future MFCs and bug fixes whilst 288 maintaining the ABI. However, this change breaks the ABI, so bump 289 __FreeBSD_version to 800102. User space tools that rely on the size of 290 any of these structs (e.g. sockstat) need to be recompiled. 291 29220090630: 293 The NFS_LEGACYRPC option has been removed along with the old kernel 294 RPC implementation that this option selected. Kernel configurations 295 may need to be adjusted. 296 29720090629: 298 The network interface device nodes at /dev/net/<interface> have been 299 removed. All ioctl operations can be performed the normal way using 300 routing sockets. The kqueue functionality can generally be replaced 301 with routing sockets. 302 30320090628: 304 The documentation from the FreeBSD Documentation Project (Handbook, 305 FAQ, etc.) is now installed via packages by sysinstall(8) and under 306 the /usr/local/share/doc/freebsd directory instead of /usr/share/doc. 307 30820090624: 309 The ABI of various structures related to the SYSV IPC API have been 310 changed. As a result, the COMPAT_FREEBSD[456] and COMPAT_43 kernel 311 options now all require COMPAT_FREEBSD7. Bump __FreeBSD_version to 312 800100. 313 31420090622: 315 Layout of struct vnet has changed as routing related variables were 316 moved to their own Vimage module. Modules need to be recompiled. Bump 317 __FreeBSD_version to 800099. 318 31920090619: 320 NGROUPS_MAX and NGROUPS have been increased from 16 to 1023 and 1024 321 respectively. As long as no more than 16 groups per process are used, 322 no changes should be visible. When more than 16 groups are used, old 323 binaries may fail if they call getgroups() or getgrouplist() with 324 statically sized storage. Recompiling will work around this, but 325 applications should be modified to use dynamically allocated storage 326 for group arrays as POSIX.1-2008 does not cap an implementation's 327 number of supported groups at NGROUPS_MAX+1 as previous versions did. 328 329 NFS and portalfs mounts may also be affected as the list of groups is 330 truncated to 16. Users of NFS who use more than 16 groups, should 331 take care that negative group permissions are not used on the exported 332 file systems as they will not be reliable unless a GSSAPI based 333 authentication method is used. 334 33520090616: 336 The compiling option ADAPTIVE_LOCKMGRS has been introduced. This 337 option compiles in the support for adaptive spinning for lockmgrs 338 which want to enable it. The lockinit() function now accepts the flag 339 LK_ADAPTIVE in order to make the lock object subject to adaptive 340 spinning when both held in write and read mode. 341 34220090613: 343 The layout of the structure returned by IEEE80211_IOC_STA_INFO has 344 changed. User applications that use this ioctl need to be rebuilt. 345 34620090611: 347 The layout of struct thread has changed. Kernel and modules need to 348 be rebuilt. 349 35020090608: 351 The layout of structs ifnet, domain, protosw and vnet_net has changed. 352 Kernel modules need to be rebuilt. Bump __FreeBSD_version to 800097. 353 35420090602: 355 window(1) has been removed from the base system. It can now be 356 installed from ports. The port is called misc/window. 357 35820090601: 359 The way we are storing and accessing `routing table' entries has 360 changed. Programs reading the FIB, like netstat, need to be 361 re-compiled. 362 36320090601: 364 A new netisr implementation has been added for FreeBSD 8. Network 365 file system modules, such as igmp, ipdivert, and others, should be 366 rebuilt. 367 Bump __FreeBSD_version to 800096. 368 36920090530: 370 Remove the tunable/sysctl debug.mpsafevfs as its initial purpose is no 371 more valid. 372 37320090530: 374 Add VOP_ACCESSX(9). File system modules need to be rebuilt. 375 Bump __FreeBSD_version to 800094. 376 37720090529: 378 Add mnt_xflag field to 'struct mount'. File system modules need to be 379 rebuilt. 380 Bump __FreeBSD_version to 800093. 381 38220090528: 383 The compiling option ADAPTIVE_SX has been retired while it has been 384 introduced the option NO_ADAPTIVE_SX which handles the reversed logic. 385 The KPI for sx_init_flags() changes as accepting flags: 386 SX_ADAPTIVESPIN flag has been retired while the SX_NOADAPTIVE flag has 387 been introduced in order to handle the reversed logic. 388 Bump __FreeBSD_version to 800092. 389 39020090527: 391 Add support for hierarchical jails. Remove global securelevel. 392 Bump __FreeBSD_version to 800091. 393 39420090523: 395 The layout of struct vnet_net has changed, therefore modules 396 need to be rebuilt. 397 Bump __FreeBSD_version to 800090. 398 39920090523: 400 The newly imported zic(8) produces a new format in the output. Please 401 run tzsetup(8) to install the newly created data to /etc/localtime. 402 40320090520: 404 The sysctl tree for the usb stack has renamed from hw.usb2.* to 405 hw.usb.* and is now consistent again with previous releases. 406 40720090520: 408 802.11 monitor mode support was revised and driver api's were changed. 409 Drivers dependent on net80211 now support DLT_IEEE802_11_RADIO instead 410 of DLT_IEEE802_11. No user-visible data structures were changed but 411 applications that use DLT_IEEE802_11 may require changes. 412 Bump __FreeBSD_version to 800088. 413 41420090430: 415 The layout of the following structs has changed: sysctl_oid, 416 socket, ifnet, inpcbinfo, tcpcb, syncache_head, vnet_inet, 417 vnet_inet6 and vnet_ipfw. Most modules need to be rebuild or 418 panics may be experienced. World rebuild is required for 419 correctly checking networking state from userland. 420 Bump __FreeBSD_version to 800085. 421 42220090429: 423 MLDv2 and Source-Specific Multicast (SSM) have been merged 424 to the IPv6 stack. VIMAGE hooks are in but not yet used. 425 The implementation of SSM within FreeBSD's IPv6 stack closely 426 follows the IPv4 implementation. 427 428 For kernel developers: 429 430 * The most important changes are that the ip6_output() and 431 ip6_input() paths no longer take the IN6_MULTI_LOCK, 432 and this lock has been downgraded to a non-recursive mutex. 433 434 * As with the changes to the IPv4 stack to support SSM, filtering 435 of inbound multicast traffic must now be performed by transport 436 protocols within the IPv6 stack. This does not apply to TCP and 437 SCTP, however, it does apply to UDP in IPv6 and raw IPv6. 438 439 * The KPIs used by IPv6 multicast are similar to those used by 440 the IPv4 stack, with the following differences: 441 * im6o_mc_filter() is analogous to imo_multicast_filter(). 442 * The legacy KAME entry points in6_joingroup and in6_leavegroup() 443 are shimmed to in6_mc_join() and in6_mc_leave() respectively. 444 * IN6_LOOKUP_MULTI() has been deprecated and removed. 445 * IPv6 relies on MLD for the DAD mechanism. KAME's internal KPIs 446 for MLDv1 have an additional 'timer' argument which is used to 447 jitter the initial membership report for the solicited-node 448 multicast membership on-link. 449 * This is not strictly needed for MLDv2, which already jitters 450 its report transmissions. However, the 'timer' argument is 451 preserved in case MLDv1 is active on the interface. 452 453 * The KAME linked-list based IPv6 membership implementation has 454 been refactored to use a vector similar to that used by the IPv4 455 stack. 456 Code which maintains a list of its own multicast memberships 457 internally, e.g. carp, has been updated to reflect the new 458 semantics. 459 460 * There is a known Lock Order Reversal (LOR) due to in6_setscope() 461 acquiring the IF_AFDATA_LOCK and being called within ip6_output(). 462 Whilst MLDv2 tries to avoid this otherwise benign LOR, it is an 463 implementation constraint which needs to be addressed in HEAD. 464 465 For application developers: 466 467 * The changes are broadly similar to those made for the IPv4 468 stack. 469 470 * The use of IPv4 and IPv6 multicast socket options on the same 471 socket, using mapped addresses, HAS NOT been tested or supported. 472 473 * There are a number of issues with the implementation of various 474 IPv6 multicast APIs which need to be resolved in the API surface 475 before the implementation is fully compatible with KAME userland 476 use, and these are mostly to do with interface index treatment. 477 478 * The literature available discusses the use of either the delta / ASM 479 API with setsockopt(2)/getsockopt(2), or the full-state / ASM API 480 using setsourcefilter(3)/getsourcefilter(3). For more information 481 please refer to RFC 3768, 'Socket Interface Extensions for 482 Multicast Source Filters'. 483 484 * Applications which use the published RFC 3678 APIs should be fine. 485 486 For systems administrators: 487 488 * The mtest(8) utility has been refactored to support IPv6, in 489 addition to IPv4. Interface addresses are no longer accepted 490 as arguments, their names must be used instead. The utility 491 will map the interface name to its first IPv4 address as 492 returned by getifaddrs(3). 493 494 * The ifmcstat(8) utility has also been updated to print the MLDv2 495 endpoint state and source filter lists via sysctl(3). 496 497 * The net.inet6.ip6.mcast.loop sysctl may be tuned to 0 to disable 498 loopback of IPv6 multicast datagrams by default; it defaults to 1 499 to preserve the existing behaviour. Disabling multicast loopback is 500 recommended for optimal system performance. 501 502 * The IPv6 MROUTING code has been changed to examine this sysctl 503 instead of attempting to perform a group lookup before looping 504 back forwarded datagrams. 505 506 Bump __FreeBSD_version to 800084. 507 50820090422: 509 Implement low-level Bluetooth HCI API. 510 Bump __FreeBSD_version to 800083. 511 51220090419: 513 The layout of struct malloc_type, used by modules to register new 514 memory allocation types, has changed. Most modules will need to 515 be rebuilt or panics may be experienced. 516 Bump __FreeBSD_version to 800081. 517 51820090415: 519 Anticipate overflowing inp_flags - add inp_flags2. 520 This changes most offsets in inpcb, so checking v4 connection 521 state will require a world rebuild. 522 Bump __FreeBSD_version to 800080. 523 52420090415: 525 Add an llentry to struct route and struct route_in6. Modules 526 embedding a struct route will need to be recompiled. 527 Bump __FreeBSD_version to 800079. 528 52920090414: 530 The size of rt_metrics_lite and by extension rtentry has changed. 531 Networking administration apps will need to be recompiled. 532 The route command now supports show as an alias for get, weighting 533 of routes, sticky and nostick flags to alter the behavior of stateful 534 load balancing. 535 Bump __FreeBSD_version to 800078. 536 53720090408: 538 Do not use Giant for kbdmux(4) locking. This is wrong and 539 apparently causing more problems than it solves. This will 540 re-open the issue where interrupt handlers may race with 541 kbdmux(4) in polling mode. Typical symptoms include (but 542 not limited to) duplicated and/or missing characters when 543 low level console functions (such as gets) are used while 544 interrupts are enabled (for example geli password prompt, 545 mountroot prompt etc.). Disabling kbdmux(4) may help. 546 54720090407: 548 The size of structs vnet_net, vnet_inet and vnet_ipfw has changed; 549 kernel modules referencing any of the above need to be recompiled. 550 Bump __FreeBSD_version to 800075. 551 55220090320: 553 GEOM_PART has become the default partition slicer for storage devices, 554 replacing GEOM_MBR, GEOM_BSD, GEOM_PC98 and GEOM_GPT slicers. It 555 introduces some changes: 556 557 MSDOS/EBR: the devices created from MSDOS extended partition entries 558 (EBR) can be named differently than with GEOM_MBR and are now symlinks 559 to devices with offset-based names. fstabs may need to be modified. 560 561 BSD: the "geometry does not match label" warning is harmless in most 562 cases but it points to problems in file system misalignment with 563 disk geometry. The "c" partition is now implicit, covers the whole 564 top-level drive and cannot be (mis)used by users. 565 566 General: Kernel dumps are now not allowed to be written to devices 567 whose partition types indicate they are meant to be used for file 568 systems (or, in case of MSDOS partitions, as something else than 569 the "386BSD" type). 570 571 Most of these changes date approximately from 200812. 572 57320090319: 574 The uscanner(4) driver has been removed from the kernel. This follows 575 Linux removing theirs in 2.6 and making libusb the default interface 576 (supported by sane). 577 57820090319: 579 The multicast forwarding code has been cleaned up. netstat(1) 580 only relies on KVM now for printing bandwidth upcall meters. 581 The IPv4 and IPv6 modules are split into ip_mroute_mod and 582 ip6_mroute_mod respectively. The config(5) options for statically 583 compiling this code remain the same, i.e. 'options MROUTING'. 584 58520090315: 586 Support for the IFF_NEEDSGIANT network interface flag has been 587 removed, which means that non-MPSAFE network device drivers are no 588 longer supported. In particular, if_ar, if_sr, and network device 589 drivers from the old (legacy) USB stack can no longer be built or 590 used. 591 59220090313: 593 POSIX.1 Native Language Support (NLS) has been enabled in libc and 594 a bunch of new language catalog files have also been added. 595 This means that some common libc messages are now localized and 596 they depend on the LC_MESSAGES environmental variable. 597 59820090313: 599 The k8temp(4) driver has been renamed to amdtemp(4) since 600 support for Family 10 and Family 11 CPU families was added. 601 60220090309: 603 IGMPv3 and Source-Specific Multicast (SSM) have been merged 604 to the IPv4 stack. VIMAGE hooks are in but not yet used. 605 606 For kernel developers, the most important changes are that the 607 ip_output() and ip_input() paths no longer take the IN_MULTI_LOCK(), 608 and this lock has been downgraded to a non-recursive mutex. 609 610 Transport protocols (UDP, Raw IP) are now responsible for filtering 611 inbound multicast traffic according to group membership and source 612 filters. The imo_multicast_filter() KPI exists for this purpose. 613 Transports which do not use multicast (SCTP, TCP) already reject 614 multicast by default. Forwarding and receive performance may improve 615 as a mutex acquisition is no longer needed in the ip_input() 616 low-level input path. in_addmulti() and in_delmulti() are shimmed 617 to new KPIs which exist to support SSM in-kernel. 618 619 For application developers, it is recommended that loopback of 620 multicast datagrams be disabled for best performance, as this 621 will still cause the lock to be taken for each looped-back 622 datagram transmission. The net.inet.ip.mcast.loop sysctl may 623 be tuned to 0 to disable loopback by default; it defaults to 1 624 to preserve the existing behaviour. 625 626 For systems administrators, to obtain best performance with 627 multicast reception and multiple groups, it is always recommended 628 that a card with a suitably precise hash filter is used. Hash 629 collisions will still result in the lock being taken within the 630 transport protocol input path to check group membership. 631 632 If deploying FreeBSD in an environment with IGMP snooping switches, 633 it is recommended that the net.inet.igmp.sendlocal sysctl remain 634 enabled; this forces 224.0.0.0/24 group membership to be announced 635 via IGMP. 636 637 The size of 'struct igmpstat' has changed; netstat needs to be 638 recompiled to reflect this. 639 Bump __FreeBSD_version to 800070. 640 64120090309: 642 libusb20.so.1 is now installed as libusb.so.1 and the ports system 643 updated to use it. This requires a buildworld/installworld in order to 644 update the library and dependencies (usbconfig, etc). Its advisable to 645 rebuild all ports which uses libusb. More specific directions are given 646 in the ports collection UPDATING file. Any /etc/libmap.conf entries for 647 libusb are no longer required and can be removed. 648 64920090302: 650 A workaround is committed to allow the creation of System V shared 651 memory segment of size > 2 GB on the 64-bit architectures. 652 Due to a limitation of the existing ABI, the shm_segsz member 653 of the struct shmid_ds, returned by shmctl(IPC_STAT) call is 654 wrong for large segments. Note that limits must be explicitly 655 raised to allow such segments to be created. 656 65720090301: 658 The layout of struct ifnet has changed, requiring a rebuild of all 659 network device driver modules. 660 66120090227: 662 The /dev handling for the new USB stack has changed, a 663 buildworld/installworld is required for libusb20. 664 66520090223: 666 The new USB2 stack has now been permanently moved in and all kernel and 667 module names reverted to their previous values (eg, usb, ehci, ohci, 668 ums, ...). The old usb stack can be compiled in by prefixing the name 669 with the letter 'o', the old usb modules have been removed. 670 Updating entry 20090216 for xorg and 20090215 for libmap may still 671 apply. 672 67320090217: 674 The rc.conf(5) option if_up_delay has been renamed to 675 defaultroute_delay to better reflect its purpose. If you have 676 customized this setting in /etc/rc.conf you need to update it to 677 use the new name. 678 67920090216: 680 xorg 7.4 wants to configure its input devices via hald which does not 681 yet work with USB2. If the keyboard/mouse does not work in xorg then 682 add 683 Option "AllowEmptyInput" "off" 684 to your ServerLayout section. This will cause X to use the configured 685 kbd and mouse sections from your xorg.conf. 686 68720090215: 688 The GENERIC kernels for all architectures now default to the new USB2 689 stack. No kernel config options or code have been removed so if a 690 problem arises please report it and optionally revert to the old USB 691 stack. If you are loading USB kernel modules or have a custom kernel 692 that includes GENERIC then ensure that usb names are also changed over, 693 eg uftdi -> usb2_serial_ftdi. 694 695 Older programs linked against the ports libusb 0.1 need to be 696 redirected to the new stack's libusb20. /etc/libmap.conf can 697 be used for this: 698 # Map old usb library to new one for usb2 stack 699 libusb-0.1.so.8 libusb20.so.1 700 70120090209: 702 All USB ethernet devices now attach as interfaces under the name ueN 703 (eg. ue0). This is to provide a predictable name as vendors often 704 change usb chipsets in a product without notice. 705 70620090203: 707 The ichsmb(4) driver has been changed to require SMBus slave 708 addresses be left-justified (xxxxxxx0b) rather than right-justified. 709 All of the other SMBus controller drivers require left-justified 710 slave addresses, so this change makes all the drivers provide the 711 same interface. 712 71320090201: 714 INET6 statistics (struct ip6stat) was updated. 715 netstat(1) needs to be recompiled. 716 71720090119: 718 NTFS has been removed from GENERIC kernel on amd64 to match 719 GENERIC on i386. Should not cause any issues since mount_ntfs(8) 720 will load ntfs.ko module automatically when NTFS support is 721 actually needed, unless ntfs.ko is not installed or security 722 level prohibits loading kernel modules. If either is the case, 723 "options NTFS" has to be added into kernel config. 724 72520090115: 726 TCP Appropriate Byte Counting (RFC 3465) support added to kernel. 727 New field in struct tcpcb breaks ABI, so bump __FreeBSD_version to 728 800061. User space tools that rely on the size of struct tcpcb in 729 tcp_var.h (e.g. sockstat) need to be recompiled. 730 73120081225: 732 ng_tty(4) module updated to match the new TTY subsystem. 733 Due to API change, user-level applications must be updated. 734 New API support added to mpd5 CVS and expected to be present 735 in next mpd5.3 release. 736 73720081219: 738 With __FreeBSD_version 800060 the makefs tool is part of 739 the base system (it was a port). 740 74120081216: 742 The afdata and ifnet locks have been changed from mutexes to 743 rwlocks, network modules will need to be re-compiled. 744 74520081214: 746 __FreeBSD_version 800059 incorporates the new arp-v2 rewrite. 747 RTF_CLONING, RTF_LLINFO and RTF_WASCLONED flags are eliminated. 748 The new code reduced struct rtentry{} by 16 bytes on 32-bit 749 architecture and 40 bytes on 64-bit architecture. The userland 750 applications "arp" and "ndp" have been updated accordingly. 751 The output from "netstat -r" shows only routing entries and 752 none of the L2 information. 753 75420081130: 755 __FreeBSD_version 800057 marks the switchover from the 756 binary ath hal to source code. Users must add the line: 757 758 options AH_SUPPORT_AR5416 759 760 to their kernel config files when specifying: 761 762 device ath_hal 763 764 The ath_hal module no longer exists; the code is now compiled 765 together with the driver in the ath module. It is now 766 possible to tailor chip support (i.e. reduce the set of chips 767 and thereby the code size); consult ath_hal(4) for details. 768 76920081121: 770 __FreeBSD_version 800054 adds memory barriers to 771 <machine/atomic.h>, new interfaces to ifnet to facilitate 772 multiple hardware transmit queues for cards that support 773 them, and a lock-less ring-buffer implementation to 774 enable drivers to more efficiently manage queueing of 775 packets. 776 77720081117: 778 A new version of ZFS (version 13) has been merged to -HEAD. 779 This version has zpool attribute "listsnapshots" off by 780 default, which means "zfs list" does not show snapshots, 781 and is the same as Solaris behavior. 782 78320081028: 784 dummynet(4) ABI has changed. ipfw(8) needs to be recompiled. 785 78620081009: 787 The uhci, ohci, ehci and slhci USB Host controller drivers have 788 been put into separate modules. If you load the usb module 789 separately through loader.conf you will need to load the 790 appropriate *hci module as well. E.g. for a UHCI-based USB 2.0 791 controller add the following to loader.conf: 792 793 uhci_load="YES" 794 ehci_load="YES" 795 79620081009: 797 The ABI used by the PMC toolset has changed. Please keep 798 userland (libpmc(3)) and the kernel module (hwpmc(4)) in 799 sync. 800 80120081009: 802 atapci kernel module now includes only generic PCI ATA 803 driver. AHCI driver moved to ataahci kernel module. 804 All vendor-specific code moved into separate kernel modules: 805 ataacard, ataacerlabs, ataadaptec, ataamd, ataati, atacenatek, 806 atacypress, atacyrix, atahighpoint, ataintel, ataite, atajmicron, 807 atamarvell, atamicron, atanational, atanetcell, atanvidia, 808 atapromise, ataserverworks, atasiliconimage, atasis, atavia 809 81020080820: 811 The TTY subsystem of the kernel has been replaced by a new 812 implementation, which provides better scalability and an 813 improved driver model. Most common drivers have been migrated to 814 the new TTY subsystem, while others have not. The following 815 drivers have not yet been ported to the new TTY layer: 816 817 PCI/ISA: 818 cy, digi, rc, rp, sio 819 820 USB: 821 ubser, ucycom 822 823 Line disciplines: 824 ng_h4, ng_tty, ppp, sl, snp 825 826 Adding these drivers to your kernel configuration file shall 827 cause compilation to fail. 828 82920080818: 830 ntpd has been upgraded to 4.2.4p5. 831 83220080801: 833 OpenSSH has been upgraded to 5.1p1. 834 835 For many years, FreeBSD's version of OpenSSH preferred DSA 836 over RSA for host and user authentication keys. With this 837 upgrade, we've switched to the vendor's default of RSA over 838 DSA. This may cause upgraded clients to warn about unknown 839 host keys even for previously known hosts. Users should 840 follow the usual procedure for verifying host keys before 841 accepting the RSA key. 842 843 This can be circumvented by setting the "HostKeyAlgorithms" 844 option to "ssh-dss,ssh-rsa" in ~/.ssh/config or on the ssh 845 command line. 846 847 Please note that the sequence of keys offered for 848 authentication has been changed as well. You may want to 849 specify IdentityFile in a different order to revert this 850 behavior. 851 85220080713: 853 The sio(4) driver has been removed from the i386 and amd64 854 kernel configuration files. This means uart(4) is now the 855 default serial port driver on those platforms as well. 856 857 To prevent collisions with the sio(4) driver, the uart(4) driver 858 uses different names for its device nodes. This means the 859 onboard serial port will now most likely be called "ttyu0" 860 instead of "ttyd0". You may need to reconfigure applications to 861 use the new device names. 862 863 When using the serial port as a boot console, be sure to update 864 /boot/device.hints and /etc/ttys before booting the new kernel. 865 If you forget to do so, you can still manually specify the hints 866 at the loader prompt: 867 868 set hint.uart.0.at="isa" 869 set hint.uart.0.port="0x3F8" 870 set hint.uart.0.flags="0x10" 871 set hint.uart.0.irq="4" 872 boot -s 873 87420080609: 875 The gpt(8) utility has been removed. Use gpart(8) to partition 876 disks instead. 877 87820080603: 879 The version that Linuxulator emulates was changed from 2.4.2 880 to 2.6.16. If you experience any problems with Linux binaries 881 please try to set sysctl compat.linux.osrelease to 2.4.2 and 882 if it fixes the problem contact emulation mailing list. 883 88420080525: 885 ISDN4BSD (I4B) was removed from the src tree. You may need to 886 update a your kernel configuration and remove relevant entries. 887 88820080509: 889 I have checked in code to support multiple routing tables. 890 See the man pages setfib(1) and setfib(2). 891 This is a hopefully backwards compatible version, 892 but to make use of it you need to compile your kernel 893 with options ROUTETABLES=2 (or more up to 16). 894 89520080420: 896 The 802.11 wireless support was redone to enable multi-bss 897 operation on devices that are capable. The underlying device 898 is no longer used directly but instead wlanX devices are 899 cloned with ifconfig. This requires changes to rc.conf files. 900 For example, change: 901 ifconfig_ath0="WPA DHCP" 902 to 903 wlans_ath0=wlan0 904 ifconfig_wlan0="WPA DHCP" 905 see rc.conf(5) for more details. In addition, mergemaster of 906 /etc/rc.d is highly recommended. Simultaneous update of userland 907 and kernel wouldn't hurt either. 908 909 As part of the multi-bss changes the wlan_scan_ap and wlan_scan_sta 910 modules were merged into the base wlan module. All references 911 to these modules (e.g. in kernel config files) must be removed. 912 91320080408: 914 psm(4) has gained write(2) support in native operation level. 915 Arbitrary commands can be written to /dev/psm%d and status can 916 be read back from it. Therefore, an application is responsible 917 for status validation and error recovery. It is a no-op in 918 other operation levels. 919 92020080312: 921 Support for KSE threading has been removed from the kernel. To 922 run legacy applications linked against KSE libmap.conf may 923 be used. The following libmap.conf may be used to ensure 924 compatibility with any prior release: 925 926 libpthread.so.1 libthr.so.1 927 libpthread.so.2 libthr.so.2 928 libkse.so.3 libthr.so.3 929 93020080301: 931 The layout of struct vmspace has changed. This affects libkvm 932 and any executables that link against libkvm and use the 933 kvm_getprocs() function. In particular, but not exclusively, 934 it affects ps(1), fstat(1), pkill(1), systat(1), top(1) and w(1). 935 The effects are minimal, but it's advisable to upgrade world 936 nonetheless. 937 93820080229: 939 The latest em driver no longer has support in it for the 940 82575 adapter, this is now moved to the igb driver. The 941 split was done to make new features that are incompatible 942 with older hardware easier to do. 943 94420080220: 945 The new geom_lvm(4) geom class has been renamed to geom_linux_lvm(4), 946 likewise the kernel option is now GEOM_LINUX_LVM. 947 94820080211: 949 The default NFS mount mode has changed from UDP to TCP for 950 increased reliability. If you rely on (insecurely) NFS 951 mounting across a firewall you may need to update your 952 firewall rules. 953 95420080208: 955 Belatedly note the addition of m_collapse for compacting 956 mbuf chains. 957 95820080126: 959 The fts(3) structures have been changed to use adequate 960 integer types for their members and so to be able to cope 961 with huge file trees. The old fts(3) ABI is preserved 962 through symbol versioning in libc, so third-party binaries 963 using fts(3) should still work, although they will not take 964 advantage of the extended types. At the same time, some 965 third-party software might fail to build after this change 966 due to unportable assumptions made in its source code about 967 fts(3) structure members. Such software should be fixed 968 by its vendor or, in the worst case, in the ports tree. 969 FreeBSD_version 800015 marks this change for the unlikely 970 case that a portable fix is impossible. 971 97220080123: 973 To upgrade to -current after this date, you must be running 974 FreeBSD not older than 6.0-RELEASE. Upgrading to -current 975 from 5.x now requires a stop over at RELENG_6 or RELENG_7 systems. 976 97720071128: 978 The ADAPTIVE_GIANT kernel option has been retired because its 979 functionality is the default now. 980 98120071118: 982 The AT keyboard emulation of sunkbd(4) has been turned on 983 by default. In order to make the special symbols of the Sun 984 keyboards driven by sunkbd(4) work under X these now have 985 to be configured the same way as Sun USB keyboards driven 986 by ukbd(4) (which also does AT keyboard emulation), f.e.: 987 988 Option "XkbLayout" "us" 989 Option "XkbRules" "xorg" 990 Option "XkbSymbols" "pc(pc105)+sun_vndr/usb(sun_usb)+us" 991 99220071024: 993 It has been decided that it is desirable to provide ABI 994 backwards compatibility to the FreeBSD 4/5/6 versions of the 995 PCIOCGETCONF, PCIOCREAD and PCIOCWRITE IOCTLs, which was 996 broken with the introduction of PCI domain support (see the 997 20070930 entry). Unfortunately, this required the ABI of 998 PCIOCGETCONF to be broken again in order to be able to 999 provide backwards compatibility to the old version of that 1000 IOCTL. Thus consumers of PCIOCGETCONF have to be recompiled 1001 again. As for prominent ports this affects neither pciutils 1002 nor xorg-server this time, the hal port needs to be rebuilt 1003 however. 1004 100520071020: 1006 The misnamed kthread_create() and friends have been renamed 1007 to kproc_create() etc. Many of the callers already 1008 used kproc_start().. 1009 I will return kthread_create() and friends in a while 1010 with implementations that actually create threads, not procs. 1011 Renaming corresponds with version 800002. 1012 101320071010: 1014 RELENG_7 branched. 1015 1016COMMON ITEMS: 1017 1018 General Notes 1019 ------------- 1020 Avoid using make -j when upgrading. While generally safe, there are 1021 sometimes problems using -j to upgrade. If your upgrade fails with 1022 -j, please try again without -j. From time to time in the past there 1023 have been problems using -j with buildworld and/or installworld. This 1024 is especially true when upgrading between "distant" versions (eg one 1025 that cross a major release boundary or several minor releases, or when 1026 several months have passed on the -current branch). 1027 1028 Sometimes, obscure build problems are the result of environment 1029 poisoning. This can happen because the make utility reads its 1030 environment when searching for values for global variables. To run 1031 your build attempts in an "environmental clean room", prefix all make 1032 commands with 'env -i '. See the env(1) manual page for more details. 1033 1034 When upgrading from one major version to another it is generally best 1035 to upgrade to the latest code in the currently installed branch first, 1036 then do an upgrade to the new branch. This is the best-tested upgrade 1037 path, and has the highest probability of being successful. Please try 1038 this approach before reporting problems with a major version upgrade. 1039 1040 ZFS notes 1041 --------- 1042 When upgrading the boot ZFS pool to a new version, always follow 1043 these two steps: 1044 1045 1.) recompile and reinstall the ZFS boot loader and boot block 1046 (this is part of "make buildworld" and "make installworld") 1047 1048 2.) update the ZFS boot block on your boot drive 1049 1050 The following example updates the ZFS boot block on the first 1051 partition (freebsd-boot) of a GPT partitioned drive ad0: 1052 "gpart bootcode -p /boot/gptzfsboot -i 1 ad0" 1053 1054 Non-boot pools do not need these updates. 1055 1056 To build a kernel 1057 ----------------- 1058 If you are updating from a prior version of FreeBSD (even one just 1059 a few days old), you should follow this procedure. It is the most 1060 failsafe as it uses a /usr/obj tree with a fresh mini-buildworld, 1061 1062 make kernel-toolchain 1063 make -DALWAYS_CHECK_MAKE buildkernel KERNCONF=YOUR_KERNEL_HERE 1064 make -DALWAYS_CHECK_MAKE installkernel KERNCONF=YOUR_KERNEL_HERE 1065 1066 To test a kernel once 1067 --------------------- 1068 If you just want to boot a kernel once (because you are not sure 1069 if it works, or if you want to boot a known bad kernel to provide 1070 debugging information) run 1071 make installkernel KERNCONF=YOUR_KERNEL_HERE KODIR=/boot/testkernel 1072 nextboot -k testkernel 1073 1074 To just build a kernel when you know that it won't mess you up 1075 -------------------------------------------------------------- 1076 This assumes you are already running a CURRENT system. Replace 1077 ${arch} with the architecture of your machine (e.g. "i386", 1078 "arm", "amd64", "ia64", "pc98", "sparc64", "powerpc", "mips", etc). 1079 1080 cd src/sys/${arch}/conf 1081 config KERNEL_NAME_HERE 1082 cd ../compile/KERNEL_NAME_HERE 1083 make depend 1084 make 1085 make install 1086 1087 If this fails, go to the "To build a kernel" section. 1088 1089 To rebuild everything and install it on the current system. 1090 ----------------------------------------------------------- 1091 # Note: sometimes if you are running current you gotta do more than 1092 # is listed here if you are upgrading from a really old current. 1093 1094 <make sure you have good level 0 dumps> 1095 make buildworld 1096 make kernel KERNCONF=YOUR_KERNEL_HERE 1097 [1] 1098 <reboot in single user> [3] 1099 mergemaster -p [5] 1100 make installworld 1101 make delete-old 1102 mergemaster -i [4] 1103 <reboot> 1104 1105 1106 To cross-install current onto a separate partition 1107 -------------------------------------------------- 1108 # In this approach we use a separate partition to hold 1109 # current's root, 'usr', and 'var' directories. A partition 1110 # holding "/", "/usr" and "/var" should be about 2GB in 1111 # size. 1112 1113 <make sure you have good level 0 dumps> 1114 <boot into -stable> 1115 make buildworld 1116 make buildkernel KERNCONF=YOUR_KERNEL_HERE 1117 <maybe newfs current's root partition> 1118 <mount current's root partition on directory ${CURRENT_ROOT}> 1119 make installworld DESTDIR=${CURRENT_ROOT} 1120 make distribution DESTDIR=${CURRENT_ROOT} # if newfs'd 1121 make installkernel KERNCONF=YOUR_KERNEL_HERE DESTDIR=${CURRENT_ROOT} 1122 cp /etc/fstab ${CURRENT_ROOT}/etc/fstab # if newfs'd 1123 <edit ${CURRENT_ROOT}/etc/fstab to mount "/" from the correct partition> 1124 <reboot into current> 1125 <do a "native" rebuild/install as described in the previous section> 1126 <maybe install compatibility libraries from ports/misc/compat*> 1127 <reboot> 1128 1129 1130 To upgrade in-place from 8.x-stable to current 1131 ---------------------------------------------- 1132 <make sure you have good level 0 dumps> 1133 make buildworld [9] 1134 make kernel KERNCONF=YOUR_KERNEL_HERE [8] 1135 [1] 1136 <reboot in single user> [3] 1137 mergemaster -p [5] 1138 make installworld 1139 make delete-old 1140 mergemaster -i [4] 1141 <reboot> 1142 1143 Make sure that you've read the UPDATING file to understand the 1144 tweaks to various things you need. At this point in the life 1145 cycle of current, things change often and you are on your own 1146 to cope. The defaults can also change, so please read ALL of 1147 the UPDATING entries. 1148 1149 Also, if you are tracking -current, you must be subscribed to 1150 freebsd-current@freebsd.org. Make sure that before you update 1151 your sources that you have read and understood all the recent 1152 messages there. If in doubt, please track -stable which has 1153 much fewer pitfalls. 1154 1155 [1] If you have third party modules, such as vmware, you 1156 should disable them at this point so they don't crash your 1157 system on reboot. 1158 1159 [3] From the bootblocks, boot -s, and then do 1160 fsck -p 1161 mount -u / 1162 mount -a 1163 cd src 1164 adjkerntz -i # if CMOS is wall time 1165 Also, when doing a major release upgrade, it is required that 1166 you boot into single user mode to do the installworld. 1167 1168 [4] Note: This step is non-optional. Failure to do this step 1169 can result in a significant reduction in the functionality of the 1170 system. Attempting to do it by hand is not recommended and those 1171 that pursue this avenue should read this file carefully, as well 1172 as the archives of freebsd-current and freebsd-hackers mailing lists 1173 for potential gotchas. The -U option is also useful to consider. 1174 See mergemaster(8) for more information. 1175 1176 [5] Usually this step is a noop. However, from time to time 1177 you may need to do this if you get unknown user in the following 1178 step. It never hurts to do it all the time. You may need to 1179 install a new mergemaster (cd src/usr.sbin/mergemaster && make 1180 install) after the buildworld before this step if you last updated 1181 from current before 20020224 or from -stable before 20020408. 1182 1183 [8] In order to have a kernel that can run the 4.x binaries needed to 1184 do an installworld, you must include the COMPAT_FREEBSD4 option in 1185 your kernel. Failure to do so may leave you with a system that is 1186 hard to boot to recover. A similar kernel option COMPAT_FREEBSD5 is 1187 required to run the 5.x binaries on more recent kernels. And so on 1188 for COMPAT_FREEBSD6 and COMPAT_FREEBSD7. 1189 1190 Make sure that you merge any new devices from GENERIC since the 1191 last time you updated your kernel config file. 1192 1193 [9] When checking out sources, you must include the -P flag to have 1194 cvs prune empty directories. 1195 1196 If CPUTYPE is defined in your /etc/make.conf, make sure to use the 1197 "?=" instead of the "=" assignment operator, so that buildworld can 1198 override the CPUTYPE if it needs to. 1199 1200 MAKEOBJDIRPREFIX must be defined in an environment variable, and 1201 not on the command line, or in /etc/make.conf. buildworld will 1202 warn if it is improperly defined. 1203FORMAT: 1204 1205This file contains a list, in reverse chronological order, of major 1206breakages in tracking -current. Not all things will be listed here, 1207and it only starts on October 16, 2004. Updating files can found in 1208previous releases if your system is older than this. 1209 1210Copyright information: 1211 1212Copyright 1998-2009 M. Warner Losh. All Rights Reserved. 1213 1214Redistribution, publication, translation and use, with or without 1215modification, in full or in part, in any form or format of this 1216document are permitted without further permission from the author. 1217 1218THIS DOCUMENT IS PROVIDED BY WARNER LOSH ``AS IS'' AND ANY EXPRESS OR 1219IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 1220WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 1221DISCLAIMED. IN NO EVENT SHALL WARNER LOSH BE LIABLE FOR ANY DIRECT, 1222INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 1223(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 1224SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 1225HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 1226STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING 1227IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 1228POSSIBILITY OF SUCH DAMAGE. 1229 1230Contact Warner Losh if you have any questions about your use of 1231this document. 1232 1233$FreeBSD: head/UPDATING 213404 2010-10-04 15:39:53Z gordon $ 1234