release/doc/en_US.ISO8859-1/relnotes/article.sgml

   1 <!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
   2 <!ENTITY % articles.ent PUBLIC "-//FreeBSD//ENTITIES DocBook FreeBSD Articles Entity Set//EN">
   3 %articles.ent;
   4
   5 <!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN">
   6 %release;
   7 ]>
   8
   9 <article>
  10 <articleinfo>
  11   <title>&os; &release.current; Release Notes</title>
  12
  13   <corpauthor>The &os; Project</corpauthor>
  14
  15   <pubdate>$FreeBSD$</pubdate>
  16
  17   <copyright>
  18     <year>2011</year>
  19     <holder role="mailto:doc@FreeBSD.org">The &os; Documentation Project</holder>
  20   </copyright>
  21
  22   <legalnotice id="trademarks" role="trademarks">
  23     &tm-attrib.freebsd;
  24     &tm-attrib.ibm;
  25     &tm-attrib.ieee;
  26     &tm-attrib.intel;
  27     &tm-attrib.sparc;
  28     &tm-attrib.general;
  29   </legalnotice>
  30
  31   <abstract>
  32     <para>The release notes for &os; &release.current; contain a summary
  33       of the changes made to the &os; base system on the
  34       &release.branch; development line.
  35       This document lists applicable security advisories that were issued since
  36       the last release, as well as significant changes to the &os;
  37       kernel and userland.
  38       Some brief remarks on upgrading are also presented.</para>
  39   </abstract>
  40 </articleinfo>
  41
  42 <sect1 id="intro">
  43   <title>Introduction</title>
  44
  45   <para>This document contains the release notes for &os;
  46     &release.current;.  It
  47     describes recently added, changed, or deleted features of &os;.
  48     It also provides some notes on upgrading
  49     from previous versions of &os;.</para>
  50
  51 <![ %release.type.current [
  52
  53   <para>The &release.type; distribution to which these release notes
  54     apply represents the latest point along the &release.branch; development
  55     branch since &release.branch; was created.  Information regarding pre-built, binary
  56     &release.type; distributions along this branch
  57     can be found at <ulink url="&release.url;"></ulink>.</para>
  58
  59 ]]>
  60
  61 <![ %release.type.snapshot [
  62
  63   <para>The &release.type; distribution to which these release notes
  64     apply represents a point along the &release.branch; development
  65     branch between &release.prev; and the future &release.next;.
  66     Information regarding
  67     pre-built, binary &release.type; distributions along this branch
  68     can be found at <ulink url="&release.url;"></ulink>.</para>
  69
  70 ]]>
  71
  72 <![ %release.type.release [
  73
  74   <para>This distribution of &os; &release.current; is a
  75     &release.type; distribution.  It can be found at <ulink
  76     url="&release.url;"></ulink> or any of its mirrors.  More
  77     information on obtaining this (or other) &release.type;
  78     distributions of &os; can be found in the <ulink
  79     url="&url.books.handbook;/mirrors.html"><quote>Obtaining
  80     &os;</quote> appendix</ulink> to the <ulink
  81     url="&url.books.handbook;/">&os;
  82     Handbook</ulink>.</para>
  83
  84 ]]>
  85
  86   <para>All users are encouraged to consult the release errata before
  87     installing &os;.  The errata document is updated with
  88     <quote>late-breaking</quote> information discovered late in the
  89     release cycle or after the release.  Typically, it contains
  90     information on known bugs, security advisories, and corrections to
  91     documentation.  An up-to-date copy of the errata for &os;
  92     &release.current; can be found on the &os; Web site.</para>
  93
  94 </sect1>
  95
  96   <sect1 id="new">
  97     <title>What's New</title>
  98
  99     <para>This section describes the most user-visible new or changed
 100       features in &os; since &release.prev;.</para>
 101
 102     <para>Typical release note items document recent security
 103       advisories issued after &release.prev;, new drivers or hardware
 104       support, new commands or options, major bug fixes, or
 105       contributed software upgrades.  They may also list changes to
 106       major ports/packages or release engineering practices.  Clearly
 107       the release notes cannot list every single change made to &os;
 108       between releases; this document focuses primarily on security
 109       advisories, user-visible changes, and major architectural
 110       improvements.</para>
 111
 112     <sect2 id="security">
 113       <title>Security Advisories</title>
 114
 115       <para>Problems described in the following security advisories have
 116         been fixed.  For more information, consult the individual
 117         advisories available from
 118         <ulink url="http://security.FreeBSD.org/"></ulink>.</para>
 119
 120       <informaltable frame="none" pgwide="0">
 121         <tgroup cols="3">
 122           <colspec colwidth="1*">
 123           <colspec colwidth="1*">
 124           <colspec colwidth="3*">
 125             <thead>
 126               <row>
 127                 <entry>Advisory</entry>
 128                 <entry>Date</entry>
 129                 <entry>Topic</entry>
 130               </row>
 131             </thead>
 132
 133             <tbody>
 134               <row>
 135                 <entry><ulink url="http://security.freebsd.org/advisories/FreeBSD-SA-10:08.bzip2.asc"
 136                               >SA-10:08.bzip2</ulink></entry>
 137                 <entry>20&nbsp;September&nbsp;2010</entry>
 138                 <entry><para>Integer overflow in bzip2 decompression</para></entry>
 139               </row>
 140 <!-- XXX: not for 8.2
 141               <row>
 142                 <entry><ulink url="http://security.freebsd.org/advisories/FreeBSD-SA-10:09.pseudofs.asc"
 143                               >SA-10:09.pseudofs</ulink></entry>
 144                 <entry>10&nbsp;October&nbsp;2010</entry>
 145                 <entry><para>Spurious mutex unlock</para></entry>
 146               </row>
 147 -->
 148               <row>
 149                 <entry><ulink url="http://security.freebsd.org/advisories/FreeBSD-SA-10:10.openssl.asc"
 150                               >SA-10:10.openssl</ulink></entry>
 151                 <entry>29&nbsp;November&nbsp;2010</entry>
 152                 <entry><para>OpenSSL multiple vulnerabilities</para></entry>
 153               </row>
 154             </tbody>
 155         </tgroup>
 156       </informaltable>
 157     </sect2>
 158
 159     <sect2 id="kernel">
 160       <title>Kernel Changes</title>
 161
 162       <para arch="ia64" revision="209326">The maximum number of pages
 163         used for DMA bounce buffer pool has been increased from 256 to
 164         1024.</para>
 165
 166       <para arch="powerpc" revision="209765">The default value of
 167         <varname>kern.hz</varname> has been increased from 100 to
 168         1000.</para>
 169
 170       <para arch="powerpc" revision="209767">The SMP kernel now works on
 171         MPC7400-based Apple desktop machines such as
 172         PowerMac3,3.</para>
 173
 174       <para arch="powerpc" revision="211593">&os;/powerpc now supports
 175         DMA bounce buffer which is required on systems with larger RAM
 176         than 4GB.</para>
 177
 178       <para revision="209692">The &man.ddb.8; kernel debugger now
 179         supports an optional delay in <command>reset</command> and
 180         <command>reboot</command> commands.  This allows an
 181         administrator to break the system into debugger and trigger
 182         automatic textdump when an unattended panic occurs.</para>
 183
 184       <para revision="212230">The &man.ddb.8; kernel debugger now
 185         supports a <command>show cdev</command> command.  This
 186         displays the list of all created cdev's, consisting of devfs
 187         node name and struct cdev address.</para>
 188
 189       <para revision="214326">The &os; <filename>GENERIC</filename>
 190         kernel is now compiled with <option>KDB</option> and
 191         <option>KDB_TRACE</option> options.  From 8.2-RELEASE the
 192         kernel supports displaying a stack trace on panic by using
 193         &man.stack.9; facility with no debugger backend like
 194         &man.ddb.8;.  Note that this does not change the default
 195         behaviors of the <filename>GENERIC</filename> kernel on
 196         panic.</para>
 197
 198       <para revision="213554,213556,213560">The following
 199         &man.sysctl.8; variables are also now loader tunables:
 200         <varname>vm.kmem_size</varname>,
 201         <varname>vm.kmem_size_max</varname>, and
 202         <varname>vm.kmem_size_min</varname>,
 203         <varname>debug.kdb.stop_cpus</varname>,
 204         <varname>debug.trace_on_panic</varname>, and
 205         <varname>kern.sync_on_panic</varname>.  Also, new
 206         &man.sysctl.8; variables <varname>vm.kmem_map_size</varname>
 207         for the current kmem map size and
 208         <varname>vm.kmem_map_free</varname> for largest contiguous
 209         free range in kmem map, <varname>vfs.ncsizefactor</varname>
 210         for size factor for namecache, and
 211         <varname>vfs.ncnegfactor</varname> for ratio of negative
 212         namecache entries have been added.</para>
 213
 214       <para revision="212427">The &os; &man.memguard.9; framework has
 215         been improved to make it able to detect use-after-free of
 216         allocated memories over a longer time.  For more details, see
 217         &man.memguard.9; manual page.</para>
 218
 219       <para revision="214254">The &os; &man.crypto.4; framework
 220         (opencrypto) now supports XTS-AES (XEX-TCB-CTS, or XEX-based
 221         Tweaked Code Book mode with CipherText Stealing), which is
 222         defined in IEEE Std. 1619-2007.</para>
 223
 224       <sect3 id="boot">
 225         <title>Boot Loader Changes</title>
 226
 227         <para revision="213994">&os; now fully supports GPT (GUID
 228           Partition Table).  Checksums of primary header and primary
 229           partition table are verified properly now.</para>
 230
 231         <para revision="212717">The &man.pxeboot.8; now uses NFS
 232           version 3 instead of version 2 by default.</para>
 233       </sect3>
 234
 235       <sect3 id="proc">
 236         <title>Hardware Support</title>
 237
 238         <para revision="210476">The &man.aibs.4; driver has been
 239           added.  This supports the hardware sensors in ASUS
 240           motherboards and replaces the &man.acpi.aiboost.4;
 241           driver.</para>
 242
 243         <para revision="211914">The &man.coretemp.4; driver now supports
 244           Xeon 5500/5600 series.</para>
 245
 246         <para revision="209952">The &man.ichwd.4; driver
 247           now supports Intel NM10 Express chipset watchdog
 248           timer.</para>
 249
 250         <sect4 id="mm">
 251           <title>Multimedia Support</title>
 252
 253           <para>The &os; Linux emulation subsystem now supports
 254             video4linux API.  This requires native video4linux
 255             hardware drivers such as ones which<filename
 256             role="ports">multimedia/pwc</filename> and <filename
 257             role="ports">multimedia/webcamd</filename> provide.</para>
 258         </sect4>
 259
 260         <sect4 id="net-if">
 261           <title>Network Interface Support</title>
 262
 263           <para revision="212021">The &man.alc.4; driver now supports
 264             Atheros AR8151/AR8152 PCIe Gigabit/Fast Ethernet
 265             controllers.</para>
 266
 267           <para revision="212011">The TX interrupt moderation timer in
 268             the &man.alc.4; driver has been reduced from 50ms to 1ms.
 269             The 50ms timer resulted in a poor UDP performance.</para>
 270
 271           <para revision="214297,214298,214301">The &man.axe.4; driver
 272             has been improved for stability and better performance on
 273             the TX packet rate.</para>
 274
 275           <para revision="211379">The &man.bce.4; driver now supports
 276             flow control.</para>
 277
 278           <para revision="211367">A bug in the &man.bge.4; driver which
 279             prevents TSO in BCM57780 from working has been
 280             fixed.</para>
 281
 282           <para revision="213109">UDP checksum offloading in the
 283             &man.bge.4; driver has been disabled by default.  This is
 284             because Broadcom controllers have a bug which can generate
 285             UDP datagrams with checksum value <literal>0</literal>
 286             when TX UDP checksum offloading is enabled.  The checksum
 287             offloading can be enabled by using the following loader
 288             tunable:</para>
 289
 290           <programlisting>dev.bge.<replaceable>N</replaceable>.forced_udpcsum</programlisting>
 291
 292           <para revision="213593">A bug in the &man.bge.4; driver
 293             which can lead poor performance on a system with RAM
 294             larger than 4GB has been fixed.  The cause was that all of
 295             Broadcom controllers except for BCM5755 and later has 4GB
 296             boundary DMA bug and the inefficient use of bounce
 297             buffer.</para>
 298
 299           <para revision="212275">The &man.bwi.4; driver, which supports
 300             Broadcom BCM430* and BCM431* family Wireless Ethernet
 301             controllers, has been added.  This is not compiled into
 302             the <filename>GENERIC</filename> kernel because there are
 303             some problems.  The kernel module
 304             <filename>if_bwi.ko</filename> is available and can be
 305             loaded without recompiling the kernel to enable this
 306             driver.</para>
 307
 308           <para revision="212274">A bug in the &man.bwn.4; driver which
 309             prevents WPA authentication from working has been
 310             fixed.</para>
 311
 312           <para revision="211848">The &man.cxgb.4; driver now supports
 313             the following new &man.sysctl.8; variables:
 314             <varname>hw.cxgb.nfilters</varname> sets the maximum
 315             number of entries in the hardware filter table,
 316             <varname>dev.cxgbc.<replaceable>N</replaceable>.pkt_timestamp</varname>
 317             provides packet timestamp instead of connection hash, and
 318             <varname>dev.cxgbc.<replaceable>N</replaceable>.core_clock</varname>
 319             provides the core clock frequency in kHz.</para>
 320
 321           <para>The &man.em.4; driver has been updated to version
 322             7.1.9.</para>
 323
 324           <para>The &man.igb.4; driver has been updated to version
 325             2.0.7.</para>
 326
 327           <para revision="209309">The &man.em.4; and &man.igb.4; drivers
 328             now provide statistics counters as &man.sysctl.8; MIB
 329             objects.</para>
 330
 331           <para revision="211241">The &man.em.4; and &man.igb.4; drivers
 332             now support &man.led.4; interface via
 333             <filename>/dev/led/em<replaceable>N</replaceable></filename>
 334             and
 335             <filename>/dev/led/igb<replaceable>N</replaceable></filename>
 336             for identification LED control.  The following command
 337             line makes the LED blink on <literal>em0</literal>:</para>
 338
 339           <screen>&prompt.root; echo f2 &gt; /dev/led/em0</screen>
 340
 341           <para revision="212386">The &man.ixgbe.4;
 342             driver is now also provided as a kernel module.</para>
 343
 344           <para revision="212150">The &man.epair.4; virtual Ethernet
 345             interface driver now supports explicit UP/DOWN linkstate.
 346             This fixes an issue when it is used with the &man.carp.4;
 347             protocol.</para>
 348
 349           <para revision="210673">The &man.iwn.4; driver now supports
 350             Intel Wireless WiFi Link 6000 series.  The firmware has
 351             been updated to version 9.221.4.1.</para>
 352
 353           <para revision="209308">The &man.ixgbe.4; driver has been
 354             updated to version 2.2.1.  It now supports 82599, better
 355             interrupt handling, hardware assist to LRO, and so
 356             on.</para>
 357
 358           <para revision="212386">The &man.mwlfw.4;
 359             driver is now also provided as a kernel module.</para>
 360
 361           <para revision="211377">The &man.rl.4; driver now supports WoL
 362             (Wake on LAN) on RTL8139B or newer controllers.</para>
 363
 364           <para revision="212039">The &man.rl.4; driver now supports a
 365             device hint to change a way of register access.  Although
 366             some newer RTL8139 controllers support memory-mapped
 367             register access, it is difficult to detect the support
 368             automatically.  For this reason the driver uses I/O
 369             mapping by default and provides the following device hint.
 370             If it is set to <literal>0</literal>, the driver uses
 371             memory mapping for register access.</para>
 372
 373           <programlisting>hint.rl.<replaceable>N</replaceable>.prefer_iomap="0"</programlisting>
 374
 375           <para>Note that the default value is <literal>1</literal>.</para>
 376
 377           <para revision="214407">The man.rl.4; driver has been
 378             improved on interrupt handling.  It now has better TX
 379             performance under high RX load.</para>
 380
 381           <para revision="212468,213612,213628">The &man.sis.4; driver
 382             now works on all supported platforms.  Some stability and
 383             performance issues have also been fixed.</para>
 384
 385           <para revision="213637">The &man.sis.4; driver now supports
 386             WoL (Wake on LAN) on NS DP8315 controller.</para>
 387
 388           <para revision="213626">A tunable
 389             <varname>dev.sis.<replaceable>N</replaceable>.manual_pad</varname>
 390             for the &man.sis.4; driver has been added.  This controls
 391             whether padding with 0x00 for short frames by software,
 392             not the controller.  The reason why this tunable has been
 393             added is that NS DP83815/DP83816 pads them with 0xff
 394             though RFC 1042 specifies it should be 0x00.  The tunable
 395             is disabled by default, which means padding with 0xff is
 396             used because padding with 0x00 by software needs extra CPU
 397             cycles.  Setting a non-zero value enables the software
 398             padding.</para>
 399
 400           <para revision="211357">The &man.ste.4; driver now supports a
 401             device hint to change a way of register access.  Although
 402             it uses memory-mapped register access by default, some old
 403             IC Plus Corp (formerly Sundace) controllers are found
 404             unstable.  The following device hint makes the driver use
 405             I/O mapping for register access:</para>
 406
 407           <programlisting>hint.ste.<replaceable>N</replaceable>.prefer_iomap="1"</programlisting>
 408
 409           <para revision="211359">The &man.sk.4; driver now disable TX
 410             checksum offloading by default.  This is because some
 411             revision of Yukon controller generates corrupted frames.
 412             The checksum offloading can be enabled manually by using
 413             <option>txcsum</option> option in the &man.ifconfig.8;
 414             utility.</para>
 415
 416           <para revision="213120">The &man.xl.4; driver now supports
 417             WoL (Wake on LAN).  Note that not all controllers support
 418             this functionality and some need an additional remote
 419             wakeup cable.</para>
 420         </sect4>
 421       </sect3>
 422
 423       <sect3 id="net-proto">
 424         <title>Network Protocols</title>
 425
 426         <para revision="209783">The &man.altq.4; support is now provided
 427           as a kernel module <filename>alq.ko</filename>.</para>
 428
 429         <para revision="212738">A bug in the &man.ipfw.4; packet
 430           filter subsystem has been fixed.  The syctl variable
 431           <varname>net.inet.ip.fw.one_pass</varname> did not work for
 432           <literal>netgraph</literal> action.</para>
 433
 434         <para revision="212742">A <literal>ngtee</literal> action in
 435           the &man.ipfw.4; packet filter subsystem has been changed.
 436           It no longer accepts a packet.</para>
 437
 438         <para revision="214108">A possible panic in the &man.ipfw.4;
 439           pseudo interface for logging has been fixed.</para>
 440
 441         <para revision="209691">IPsec flow distribution has been
 442           improved for more parallel processing.</para>
 443
 444         <para revision="209277">A bug in &os; IPv4 stack that a proxy
 445           ARP entry cannot be added over &man.netgraph.4; interfaces
 446           has been fixed.</para>
 447
 448         <para revision="211435">A bug in &os; IPv6 stack which prevents
 449           an <option>-I</option> in the &man.ping6.8; utility from
 450           working with
 451           <varname>net.inet6.ip6.use_defaultzone=1</varname> has been
 452           fixed.</para>
 453
 454         <para revision="214111">The &man.lagg.4; interface now
 455           supports a sysctl variable
 456           <varname>net.link.lagg.failover_rx_all</varname>.  This
 457           controls whether to accept input packets on any link in a
 458           failover lagg.</para>
 459
 460         <para revision="209843">A new &man.netgraph.4; node
 461           &man.ng.patch.4; has been added.  This performs data
 462           modification of packets passing through.  Modifications are
 463           restricted to a subset of C language operations on unsigned
 464           integers of 8, 16, 32 or 64-bit size.</para>
 465
 466         <para revision="212320">The &man.ng.ether.4; &man.netgraph.4;
 467           node now supports interface transfer between multiple virtual
 468           network stacks by &man.ifconfig.8; <command>vnet</command>
 469           command.  A &man.ng.ether.4; node associated with an network
 470           interface is now destroyed and recreated when the network
 471           interface is moved to another vnet.</para>
 472
 473         <para revision="212905">An ICMP unreachable problem in the
 474           &man.pf.4; packet filter subsystem when TSO support is
 475           enabled has been fixed.</para>
 476
 477         <para revision="211538">A TCP bandwidth delay product window
 478           limiting algorithm by a &man.sysctl.8; variable
 479           <varname>net.inet.tcp.inflight.enable</varname> is now
 480           disabled by default.  It has been found that this algorithm
 481           is inefficient on a fast network with smaller RTT than 10ms.
 482           It had been enabled by default since 5.2-RELEASE, and then
 483           had been disabled only if the RTT was lesser than 10ms since
 484           7.0-RELEASE.  Pluggable TCP congestion control algorithm
 485           modules are planned to be added for the future
 486           releases.</para>
 487
 488         <para revision="211602">A bug in &os; TCP Path MTU discovery
 489           which can lead to a wrong calculation for a smaller MTU than
 490           256 octets has been fixed.  Note that this bug does not
 491           affect when MTU is equal to or larger than 256
 492           octets.</para>
 493
 494         <para revision="211870">The TCP initial window increase in RFC
 495           3390 which can be controlled by a &man.sysctl.8; variable
 496           <varname>net.inet.tcp.rfc3390</varname> now reduces the
 497           congestion window to the restart window if a TCP connection
 498           has been idle for one retransmit timeout or more.  For more
 499           details, see RFC 5681 Section 4.1.</para>
 500
 501         <para revision="212319">&os; virtual network stack (vnet) now
 502           supports IPv4 multicast routing.</para>
 503       </sect3>
 504
 505       <sect3 id="disks">
 506         <title>Disks and Storage</title>
 507
 508         <para revision="211458">The &man.ahci.4; driver now disables NCQ
 509           and PMP support on VIA VT8251 because they are unreliable
 510           under load.</para>
 511
 512         <para revision="211718">The &man.ahci.4; driver now uses 15
 513           seconds for device reset timeout instead of 10 seconds
 514           because some devices needs 10-12 seconds to spin up.</para>
 515
 516         <para revision="210836">The &man.arcmsr.4; driver
 517           has been updated to version 1.20.00.17.</para>
 518
 519         <para revision="210164">The &man.ata.4; driver
 520           now supports limiting initial ATA mode for devices via
 521           device hints
 522           <varname>hint.<replaceable>devname</replaceable>.<replaceable>unit</replaceable>.dev<replaceable>N</replaceable
 523           >.mode</varname> or
 524           <varname>hint.<replaceable>devname</replaceable>.<replaceable>unit</replaceable>.mode</varname>.
 525           The valid values are the same as ones supported in the
 526           &man.atacontrol.8; and &man.camcontrol.8;.</para>
 527
 528         <para revision="210204">The &man.ata.4; driver
 529           now enables cable status check on both of controller and
 530           device side when
 531           <varname>hw.ata.ata_dma_check_80pin</varname> is
 532           enabled.</para>
 533
 534         <para revision="213291">A device detection of Serverworls K2
 535           SATA controllers in the &man.ata.4; has been
 536           improved.</para>
 537
 538         <para revision="214330">The &man.gconcat.8; GEOM class now
 539           supports kernel crash dump.  The dumping is performed to the
 540           component where a dump partition begins.</para>
 541
 542         <para revision="214405">A bug in the &man.geli.8; GEOM class
 543           on little endian platforms has been fixed.  The metadata
 544           version has been updated to <literal>4</literal> due to
 545           this.</para>
 546
 547         <para revision="214405">The &man.geli.8; GEOM class now
 548           supports a &man.sysctl.8; variable
 549           <varname>kern.geom.eli.overwrites</varname>.  This specifies
 550           the number of times on-disk keys should be overwritten when
 551           destroying them.  The default value is
 552           <literal>5</literal>.</para>
 553
 554         <para revision="214405">The &man.geli.8; GEOM class has been
 555           improved for preventing the same encryption key from being
 556           used in 2^20 blocks (sectors).</para>
 557
 558         <para revision="214405">The &man.geli.8; GEOM class now uses
 559           XTS-AES mode by default.</para>
 560
 561         <para revision="214405">A &man.sysctl.8; variable
 562           <varname>kern.geom.eli.debug</varname> now allows a value
 563           <literal>-1</literal>.  This means turn off any log messages
 564           of the &man.geli.8; GEOM class.</para>
 565
 566         <para revision="210376">The &man.mpt.4; driver now supports
 567           larger I/O sizes which the device and &man.CAM.4; subsystem
 568           can support.  This was limited to 64KB, and the number of
 569           scatter/gather segments was limited to 33 on platforms with
 570           4K pages.</para>
 571
 572         <para revision="209404">The &man.twa.4;
 573           driver has been updated.  The version number is
 574           3.80.06.003.</para>
 575       </sect3>
 576
 577       <sect3 id="fs">
 578         <title>File Systems</title>
 579
 580         <para revision="214050">The &man.linprocfs.5; Linux process
 581           file system now supports
 582           <filename>proc/$$/environment</filename>.</para>
 583
 584         <para revision="212716">The &os; NFS client now supports a
 585           kernel environment variable
 586           <varname>boot.nfsroot.nfshandlelen</varname>.  This lets the
 587           diskless root file system on boot to use NFS version 3 and
 588           the spedified file handle length.  If this variable is not
 589           set, NFS version 2 is used.</para>
 590
 591         <para revision="212668">The ZFS on-disk format has been updated
 592           to version 15.</para>
 593
 594         <para revision="212671">The ZFS metaslab code has been updated.
 595           This provides a noticeable improvement on write speed,
 596           especially on pools with less than 30% of free space.  The
 597           related OpenSolaris Bug IDs are 6826241, 6869229, 6918420,
 598           and 6917066.</para>
 599
 600         <para revision="214013">The ZFS now supports offlining of log
 601           devices.  The related OpenSolaris Bug IDs are 6599442,
 602           6726045, and 6803605.</para>
 603
 604         <para revision="212672">Performance improvements for the ZFS
 605           have been imported from OpenSolaris.  They include cachin of
 606           ACL permission checks, faster handling of &man.stat.2;,
 607           mitigation of mutex lock contention.  The related
 608           OpenSolaris Bug IDs are 6802734, 6844861, 6848431, 6775100,
 609           6827779, 6857433, 6860318, 6865875, 6867395, 6868276, and
 610           6870564.</para>
 611
 612         <para revision="210541">The default value of
 613           <varname>vfs.zfs.vdev.max_pending</varname> has been
 614           decreased from 35 to 10 (OpenSolaris Bug ID is 6891731) to
 615           improve latency.</para>
 616
 617         <para>Various bugs in the ZFS subsystem have been fixed.  The
 618           related OpenSolaris Bug IDs are: 6328632, 6396518, 6501037,
 619           6504953, 6542860, 6551866, 6572357, 6572376, 6582163,
 620           6586537, 6595194, 6596237, 6604992, 6621164, 6623978,
 621           6633095, 6635482, 6664765, 6674216, 6696858, 6696858,
 622           6702206, 6710376, 6713916, 6717022, 6722540, 6722991,
 623           6737463, 6739487, 6739553, 6740164, 6745863, 6747596,
 624           6747698, 6748436, 6755435, 6757430, 6758107, 6759986,
 625           6759999, 6761100, 6761406, 6764124, 6765294, 6767129,
 626           6769612, 6770866, 6774713, 6774886, 6775697, 6776104,
 627           6776548, 6780491, 6784104, 6784108, 6788152, 6788152,
 628           6788830, 6789318, 6790064, 6790345, 6790687, 6791064,
 629           6791066, 6791071, 6791101, 6792134, 6792139, 6792884,
 630           6793430, 6794136, 6794570, 6794570, 6794830, 6797109,
 631           6797118, 6798384, 6798878, 6798878, 6799895, 6800184,
 632           6800942, 6801507, 6801810, 6803343, 6803822, 6804954,
 633           6807339, 6807765, 6809340, 6809683, 6809683, 6809691,
 634           6810367, 6815592, 6815893, 6816124, 6818183, 6821169,
 635           6821170, 6822816, 6824006, 6824062, 6824968, 6826466,
 636           6826468, 6826469, 6826470, 6826471, 6826472, 6827260,
 637           6830237, 6833162, 6833711, 6833999, 6834217, 6836714,
 638           6836714, 6836768, 6838062, 6838344, 6841321, 6843014,
 639           6843069, 6843235, 6844069, 6844069, 6844900, 6847229,
 640           6848242, 6856634, 6857012, 6857012, 6857012, 6861983,
 641           6862984, 6863610, 6870564, 6870564, 6880764, 6882227,
 642           6892298, 6898245, 6906110, 6906946, 6939941, 6950219,
 643           6951024, and 6953403.</para>
 644       </sect3>
 645     </sect2>
 646
 647     <sect2 id="userland">
 648       <title>Userland Changes</title>
 649
 650       <para revision="209267">The &man.arp.8; utility has been improved.
 651         It now runs faster even when a single interface has a number
 652         of aliases.</para>
 653
 654       <para revision="211723">The &man.calendar.1; utility now supports
 655         repeating events which span multiple years, lunar events, and
 656         solar events.</para>
 657
 658       <para revision="210915">The &man.dhclient.8; utility now reports a
 659         reason for exiting and the 10-second period in which the
 660         &man.dhclient.8; ignores routing messages has been changed to
 661         start just after <filename>dhclient-script</filename> starts
 662         instead of just after it finished.  This change fixes a
 663         symptom that &man.dhclient.8; silently exits under a certain
 664         condition.</para>
 665
 666       <para revision="209362">The &man.du.1; utility now supports a
 667         <option>-t <replaceable>threshold</replaceable></option>
 668         option to display entries that exceeds the value of
 669         <replaceable>threshold</replaceable>.  If the value is
 670         negative, it displays entries with a value less than the
 671         absolute value of <replaceable>threshold</replaceable>.</para>
 672
 673       <para revision="210567">The &man.gcore.1; utility now supports an
 674         <option>-f</option> flag which forces a full dump of all the
 675         segments except for the malformed ones.</para>
 676
 677       <para revision="214405">The &man.geli.8; utility now supports
 678         <command>resize</command> subcommand to resize encrypted file
 679         systems prior to growing it</para>
 680
 681       <para revision="214405">The &man.geli.8; utility now supports
 682         <command>suspend</command> and <command>resume</command>
 683         subcommands.  The <command>suspend</command> subcommand makes
 684         &man.geli.8; devices wait for all in-flight I/O requests,
 685         suspend new I/O requests, remove all &man.geli.8; sensitive
 686         data from the kernel memory (like encryption keys) and will
 687         wait for either <command>geli resume</command> or
 688         <command>geli detach</command> commmand.  For more
 689         information, see &man.geli.8; manual page.</para>
 690
 691       <para revision="214405">The &man.geli.8; utility now checks the
 692         metadata provider size strictly.  If the check fails, the
 693         provider is not attached.  A new option <option>-f</option>
 694         can override this behavior.</para>
 695
 696       <para revision="214405">The &man.geli.8; utility now supports
 697         <option>-J <replaceable>newpassfile</replaceable></option> and
 698         <option>-j <replaceable>passfile</replaceable></option>
 699         options for loading passphrease from a file.</para>
 700
 701       <para revision="211938">The <function>gethost*()</function>,
 702         <function>getnet*()</function>, and
 703         <function>getproto*()</function> functions now set the errno
 704         to <literal>ERANGE</literal> and the NSS backend terminates
 705         with <literal>NS_RETURN</literal> when the result buffer size
 706         is too small.</para>
 707
 708       <para revision="209497">The &man.gpart.8; utility now supports
 709         <command>resize</command> command to resize partitions for all
 710         schemes but EBR.</para>
 711
 712       <para revision="213661">The &man.gpart.8; utility now handles
 713         given geom/provider names with and without
 714         <filename>/dev/</filename> prefix.</para>
 715
 716       <para revision="213684">The &man.gpart.8; utility now supports
 717         an <option>-F</option> option for <command>force</command>
 718         subcommand.  This option force destroying of the partition
 719         table even if it is not empty.</para>
 720
 721       <para revision="213994">The &man.gpart.8; utility now supports
 722         <literal>GPT_ENT_ATTR_BOOTME</literal>,
 723         <literal>GPT_ENT_ATTR_BOOTONCE</literal>, and
 724         <literal>GPT_ENT_ATTR_BOOTFAILED</literal> attributes in GPT.
 725         The attribute keywords in the command line are
 726         <literal>bootme</literal>, <literal>bootonce</literal>, and
 727         <literal>bootfailed</literal> respectively.</para>
 728
 729       <para revision="213049">The &man.hastd.8; utility now supports
 730         <literal>SIGHUP</literal> for reloading the configuration
 731         file.  When <literal>SIGTERM</literal> or
 732         <literal>SIGINT</literal> is received, the worker processes
 733         terminate.</para>
 734
 735       <para revision="212144">The &man.ifconfig.8; utility now check an
 736         invalid CIDR subnet notation more strictly.  It wrongly
 737         accepted <literal>10.0.0.1/10.0.0.1</literal> as
 738         <literal>10.0.0.1/10</literal>.</para>
 739
 740       <para revision="209284">Incorrect behaviors in stuttering
 741         sequences and reverse ranges in the &man.jot.1; utility have
 742         been fixed.</para>
 743
 744       <para revision="213667">The <filename>libarchive</filename> and
 745         &man.tar.1; utility now support LZMA (Lempel-Ziv-Markov
 746         chain-Algorithm) compression format.</para>
 747
 748       <para revision="214442">A bug in the &man.lpr.1; utility which
 749         prevents it from working with some files on a ZFS file system
 750         has been fixed.</para>
 751
 752       <para revision="213978">The <option>-p</option> option in the
 753         &man.mount.8; utility now displays <literal>rw</literal> mount
 754         option correctly as in the &man.fstab.5; format.</para>
 755
 756       <para revision="213889">The &man.ncal.1; utility has been
 757         updated.  The option <option>-b</option> has been replaced
 758         with <option>-C</option> and <option>-B
 759         <replaceable>number</replaceable></option>.  Options
 760         <option>-3</option> to show previous, this and next month, and
 761         <option>-A <replaceable>number</replaceable></option> to show
 762         months after this month have been added.  The option
 763         <option>-m <replaceable>N</replaceable>
 764         <replaceable>YYYY</replaceable></option> now prints only the
 765         month, not the whole year.</para>
 766
 767       <para revision="211699">The &man.newsyslog.8; utility now supports
 768         an <option>-S <replaceable>pidfile</replaceable></option>
 769         option to override the default &man.syslogd.8; PID
 770         file.</para>
 771
 772       <para revision="213980">The &man.ntpd.8; utility is now compiled
 773         with shared memory reference clock driver.  For exmaple, GPS
 774         devices can be used as source of precise time via <filename
 775         role="ports">astro/gpsd</filename> in the Ports
 776         Collection.</para>
 777
 778       <para revision="212848">An off-by-one error in the &man.pax.1;
 779         utility when ustar file name is too long has been
 780         fixed.</para>
 781
 782       <para revision="209912">The &man.pkill.1; utility now supports
 783         an <option>-l</option> option which the &man.kill.1; utility
 784         does.</para>
 785
 786       <para revision="211098">The &man.pmcstat.8; utility now supports a
 787         file and a network socket as a top source.  A new option
 788         <option>-O <replaceable>filename</replaceable></option>
 789         specifies to send log output to
 790         <replaceable>filename</replaceable>, and another new option
 791         <option>-R <replaceable>filename</replaceable></option>
 792         specifies to receive events from
 793         <replaceable>filename</replaceable>.  For a socket, the
 794         <replaceable>filename</replaceable> is in a form of
 795         <replaceable>ipaddr:port</replaceable>.  This allows top
 796         monitoring over TCP on a system with no local symbols, for
 797         example.</para>
 798
 799       <para revision="210089">The &man.pom.6; utility now
 800         supports a <option>-p</option> flag to print only the
 801         percentage.</para>
 802
 803       <para revision="212472">The &man.powerd.8; utility now supports
 804         an <option>-m <replaceable>freq</replaceable></option> and
 805         <option>-M <replaceable>freq</replaceable></option> to control
 806         the minimum and maximum frequency, respectively.</para>
 807
 808       <para revision="213825">The &man.ruptime.1; utility now displays
 809         hostnames longer than 12 characters.</para>
 810
 811       <para revision="210616">A bug in the &man.sh.1; program has been
 812         fixed.  A <literal>SIGINT</literal> signal is now passed
 813         through from a child process if the shell is interactive and
 814         the job control is enabled.  For example, aborting
 815         &man.sleep.1; command by Ctrl-C no longer display
 816         <literal>ok</literal> in the following command line:</para>
 817
 818       <screen>&prompt.user; sleep 5; echo ok</screen>
 819
 820       <para revision="210732">The &man.sh.1; program now supports a
 821         <command>bg</command> command consisting solely of
 822         redirections.  For example:</para>
 823
 824       <screen>&prompt.user; &lt; /dev/null &amp;</screen>
 825
 826       <para revision="211536">The &man.sleep.1; utility now supports
 827         <literal>SIGINFO</literal> signal and reports the specified
 828         sleep time and the remaining time.</para>
 829
 830       <para revision="213036,213038">The &man.tftp.1; and &man.tftpd.8;
 831         utilities have been improved for better interoperability and
 832         they now supports RFC 1350, 2347, 2348, 2349, and 3617.</para>
 833
 834       <para revision="213899">A bug in <literal>[=]=]</literal>
 835         equivalent class handling in the &man.tr.1; utility has been
 836         fixed.</para>
 837
 838       <para revision="210566">The &man.uname.1; utility now supports an
 839         <option>-o</option> flag as a synonym for the
 840         <option>-s</option> flag for compatibility with other
 841         systems.</para>
 842
 843       <para revision="211060">Bugs in &man.vi.1; utility have been
 844         fixed.  They include handling of <literal>^@</literal> and
 845         <literal>^C</literal> in insert mode when reading an ex
 846         command.</para>
 847
 848       <para revision="214345">The &man.watchdogd.8; program now set
 849         <literal>MADV_PROTECT</literal> memory flag onto themselves to
 850         protect from being terminated by the &os; kernel when
 851         available memory becomes short.  This kind of process
 852         termination happens in a swap-intensive workload.</para>
 853
 854       <para revision="209870">The <command>set sharenfs</command>
 855         command in the &man.zfs.8; utility now supports
 856         <option>sec</option> option.</para>
 857
 858       <sect3 id="periodic-scripts">
 859         <title><filename>/etc/periodic</filename> Scripts</title>
 860
 861         <para>A periodic script for <command>zfs scrub</command> has
 862           been added.  For more details, see &man.periodic.conf.5;
 863           manual page.</para>
 864       </sect3>
 865
 866       <sect3 id="rc-scripts">
 867         <title><filename>/etc/rc.d</filename> Scripts</title>
 868
 869         <para></para>
 870       </sect3>
 871     </sect2>
 872
 873     <sect2 id="contrib">
 874       <title>Contributed Software</title>
 875
 876       <para></para>
 877 <!--
 878       <para>The <application>ACPI-CA</application> has been updated to
 879         20100304.</para>
 880
 881       <para>The <application>awk</application> has been updated from
 882         the 23 October 2007 release to the 26 November 2009 release.</para>
 883 -->
 884       <para revision="214287">The &man.ee.1; program has been updated
 885         to version 1.5.2.</para>
 886
 887 <!--
 888       <para><application>ISC BIND</application> has been updated to
 889         version 9.6.2-P2.</para>
 890
 891       <para><application>netcat</application> has been updated to
 892         version 4.7.</para>
 893
 894       <para><application>OpenSSH</application> has been updated from
 895         version 5.1p1 to version 5.4p1.</para>
 896
 897       <para><application>OpenSSL</application> has been updated to
 898         version 0.9.8n.</para>
 899
 900       <para><application>sendmail</application> has been updated to
 901         version 8.14.4.</para>
 902 -->
 903       <para>The timezone database has been updated to the
 904         <application>tzdata2010m</application> release.</para>
 905     </sect2>
 906
 907     <sect2 id="releng">
 908       <title>Release Engineering and Integration</title>
 909
 910       <para revision="211007">The &man.sysinstall.8; utility now uses
 911         the following numbers for default and minimum partition sizes:
 912         1GB for <filename>/</filename>, 4GB for
 913         <filename>/var</filename>, and 1GB for
 914         <filename>/tmp</filename>.</para>
 915
 916       <para revision="211009">The &man.sysinstall.8; utility now
 917         attempts to enable &man.getty.8; on a serial port when no VGA
 918         card on the system.</para>
 919
 920       <para>The supported version of
 921         the <application>GNOME</application> desktop environment
 922         (<filename role="package">x11/gnome2</filename>) has been
 923         updated to 2.32.1.</para>
 924
 925       <para>The supported version of
 926         the <application>KDE</application> desktop environment
 927         (<filename role="package">x11/kde4</filename>) has been
 928         updated to 4.5.5.</para>
 929     </sect2>
 930   </sect1>
 931
 932   <sect1 id="upgrade">
 933     <title>Upgrading from previous releases of &os;</title>
 934
 935     <para arch="amd64,i386">Upgrades between RELEASE versions (and
 936       snapshots of the various security branches) are supported using
 937       the &man.freebsd-update.8; utility.  The binary upgrade
 938       procedure will update unmodified userland utilities, as well as
 939       unmodified GENERIC kernel distributed as a part of an
 940       official &os; release.  The &man.freebsd-update.8; utility
 941       requires that the host being upgraded has Internet
 942       connectivity.</para>
 943
 944     <para>An older form of binary upgrade is supported through the
 945       <command>Upgrade</command> option from the main
 946       &man.sysinstall.8; menu on CDROM distribution media.  This type
 947       of binary upgrade may be useful on non-&arch.i386;,
 948       non-&arch.amd64; machines or on systems with no Internet
 949       connectivity.</para>
 950
 951     <para>Source-based upgrades (those based on recompiling the &os;
 952       base system from source code) from previous versions are
 953       supported, according to the instructions in
 954       <filename>/usr/src/UPDATING</filename>.</para>
 955
 956     <important>
 957       <para>Upgrading &os; should, of course, only be attempted after
 958         backing up <emphasis>all</emphasis> data and configuration
 959         files.</para>
 960     </important>
 961   </sect1>
 962 </article>