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="213554,213556,213560">The following sysctl
 190         variables are also now loader tunables:
 191         <varname>vm.kmem_size</varname>,
 192         <varname>vm.kmem_size_max</varname>, and
 193         <varname>vm.kmem_size_min</varname>,
 194         <varname>debug.kdb.stop_cpus</varname>,
 195         <varname>debug.trace_on_panic</varname>, and
 196         <varname>kern.sync_on_panic</varname>.</para>
 197
 198       <para revision="212427">The &os; &man.memguard.9; framework has
 199         been improved to make it able to detect use-after-free of
 200         allocated memories over a longer time.  For more details, see
 201         &man.memguard.9; manual page.</para>
 202
 203       <sect3 id="boot">
 204         <title>Boot Loader Changes</title>
 205
 206         <para revision="212717">The &man.pxeboot.8; now uses NFS
 207           version 3 instead of version 2 by default.</para>
 208       </sect3>
 209
 210       <sect3 id="proc">
 211         <title>Hardware Support</title>
 212
 213         <para revision="210476">The &man.aibs.4; driver has been
 214           added.  This supports the hardware sensors in ASUS
 215           motherboards and replaces the &man.acpi.aiboost.4;
 216           driver.</para>
 217
 218         <para revision="211914">The &man.coretemp.4; driver now supports
 219           Xeon 5500/5600 series.</para>
 220
 221         <para revision="209952">The &man.ichwd.4; driver
 222           now supports Intel NM10 Express chipset watchdog
 223           timer.</para>
 224
 225         <sect4 id="mm">
 226           <title>Multimedia Support</title>
 227
 228           <para>The &os; Linux emulation subsystem now supports
 229             video4linux API.  This requires native video4linux
 230             hardware drivers such as ones which<filename
 231             role="ports">multimedia/pwc</filename> and <filename
 232             role="ports">multimedia/webcamd</filename> provide.</para>
 233         </sect4>
 234
 235         <sect4 id="net-if">
 236           <title>Network Interface Support</title>
 237
 238           <para revision="212021">The &man.alc.4; driver now supports
 239             Atheros AR8151/AR8152 PCIe Gigabit/Fast Ethernet
 240             controllers.</para>
 241
 242           <para revision="212011">The TX interrupt moderation timer in
 243             the &man.alc.4; driver has been reduced from 50ms to 1ms.
 244             The 50ms timer resulted in a poor UDP performance.</para>
 245
 246           <para revision="211379">The &man.bce.4; driver now supports
 247             flow control.</para>
 248
 249           <para revision="211367">A bug in the &man.bge.4; driver which
 250             prevents TSO in BCM57780 from working has been
 251             fixed.</para>
 252
 253           <para revision="213109">UDP checksum offloading in the
 254             &man.bge.4; driver has been disabled by default.  This is
 255             because Broadcom controllers have a bug which can generate
 256             UDP datagrams with checksum value <literal>0</literal>
 257             when TX UDP checksum offloading is enabled.  The checksum
 258             offloading can be enabled by using the following loader
 259             tunable:</para>
 260
 261           <programlisting>dev.bge.<replaceable>N</replaceable>.forced_udpcsum</programlisting>
 262
 263           <para revision="213593">A bug in the &man.bge.4; driver
 264             which can lead poor performance on a system with RAM
 265             larger than 4GB has been fixed.  The cause was that all of
 266             Broadcom controllers except for BCM5755 and later has 4GB
 267             boundary DMA bug and the inefficient use of bounce
 268             buffer.</para>
 269
 270           <para revision="212275">The &man.bwi.4; driver, which supports
 271             Broadcom BCM430* and BCM431* family Wireless Ethernet
 272             controllers, has been added.  This is not compiled into
 273             the <filename>GENERIC</filename> kernel because there are
 274             some problems.  The kernel module
 275             <filename>if_bwi.ko</filename> is available and can be
 276             loaded without recompiling the kernel to enable this
 277             driver.</para>
 278
 279           <para revision="212274">A bug in the &man.bwn.4; driver which
 280             prevents WPA authentication from working has been
 281             fixed.</para>
 282
 283           <para revision="211848">The &man.cxgb.4; driver now supports
 284             the following new &man.sysctl.8; variables:
 285             <varname>hw.cxgb.nfilters</varname> sets the maximum
 286             number of entries in the hardware filter table,
 287             <varname>dev.cxgbc.<replaceable>N</replaceable>.pkt_timestamp</varname>
 288             provides packet timestamp instead of connection hash, and
 289             <varname>dev.cxgbc.<replaceable>N</replaceable>.core_clock</varname>
 290             provides the core clock frequency in kHz.</para>
 291
 292           <para>The &man.em.4; driver has been updated to version
 293             7.1.9.</para>
 294
 295           <para>The &man.igb.4; driver has been updated to version
 296             2.0.7.</para>
 297
 298           <para revision="209309">The &man.em.4; and &man.igb.4; drivers
 299             now provide statistics counters as &man.sysctl.8; MIB
 300             objects.</para>
 301
 302           <para revision="211241">The &man.em.4; and &man.igb.4; drivers
 303             now support &man.led.4; interface via
 304             <filename>/dev/led/em<replaceable>N</replaceable></filename>
 305             and
 306             <filename>/dev/led/igb<replaceable>N</replaceable></filename>
 307             for identification LED control.  The following command
 308             line makes the LED blink on <literal>em0</literal>:</para>
 309
 310           <screen>&prompt.root; echo f2 &gt; /dev/led/em0</screen>
 311
 312           <para revision="212386">The &man.ixgbe.4;
 313             driver is now also provided as a kernel module.</para>
 314
 315           <para revision="212150">The &man.epair.4; virtual Ethernet
 316             interface driver now supports explicit UP/DOWN linkstate.
 317             This fixes an issue when it is used with the &man.carp.4;
 318             protocol.</para>
 319
 320           <para revision="210673">The &man.iwn.4; driver now supports
 321             Intel Wireless WiFi Link 6000 series.  The firmware has
 322             been updated to version 9.221.4.1.</para>
 323
 324           <para revision="209308">The &man.ixgbe.4; driver has been
 325             updated to version 2.2.1.  It now supports 82599, better
 326             interrupt handling, hardware assist to LRO, and so
 327             on.</para>
 328
 329           <para revision="212386">The &man.mwlfw.4;
 330             driver is now also provided as a kernel module.</para>
 331
 332           <para revision="211377">The &man.rl.4; driver now supports WoL
 333             (Wake on LAN) on RTL8139B or newer controllers.</para>
 334
 335           <para revision="212039">The &man.rl.4; driver now supports a
 336             device hint to change a way of register access.  Although
 337             some newer RTL8139 controllers support memory-mapped
 338             register access, it is difficult to detect the support
 339             automatically.  For this reason the driver uses I/O
 340             mapping by default and provides the following device hint.
 341             If it is set to <literal>0</literal>, the driver uses
 342             memory mapping for register access.</para>
 343
 344           <programlisting>hint.rl.<replaceable>N</replaceable>.prefer_iomap="0"</programlisting>
 345
 346           <para>Note that the default value is <literal>1</literal>.</para>
 347
 348           <para revision="212468,213612,213628">The &man.sis.4; driver
 349             now works on all supported platforms.  Some stability and
 350             performance issues have also been fixed.</para>
 351
 352           <para revision="213637">The &man.sis.4; driver now supports
 353             WoL (Wake on LAN) on NS DP8315 controller.</para>
 354
 355           <para revision="213626">A tunable
 356             <varname>dev.sis.<replaceable>N</replaceable>.manual_pad</varname>
 357             for the &man.sis.4; driver has been added.  This controls
 358             whether padding with 0x00 for short frames by software,
 359             not the controller.  The reason why this tunable has been
 360             added is that NS DP83815/DP83816 pads them with 0xff
 361             though RFC 1042 specifies it should be 0x00.  The tunable
 362             is disabled by default, which means padding with 0xff is
 363             used because padding with 0x00 by software needs extra CPU
 364             cycles.  Setting a non-zero value enables the software
 365             padding.</para>
 366
 367           <para revision="211357">The &man.ste.4; driver now supports a
 368             device hint to change a way of register access.  Although
 369             it uses memory-mapped register access by default, some old
 370             IC Plus Corp (formerly Sundace) controllers are found
 371             unstable.  The following device hint makes the driver use
 372             I/O mapping for register access:</para>
 373
 374           <programlisting>hint.ste.<replaceable>N</replaceable>.prefer_iomap="1"</programlisting>
 375
 376           <para revision="211359">The &man.sk.4; driver now disable TX
 377             checksum offloading by default.  This is because some
 378             revision of Yukon controller generates corrupted frames.
 379             The checksum offloading can be enabled manually by using
 380             <option>txcsum</option> option in the &man.ifconfig.8;
 381             utility.</para>
 382
 383           <para revision="213120">The &man.xl.4; driver now supports
 384             WoL (Wake on LAN).  Note that not all controllers support
 385             this functionality and some need an additional remote
 386             wakeup cable.</para>
 387         </sect4>
 388       </sect3>
 389
 390       <sect3 id="net-proto">
 391         <title>Network Protocols</title>
 392
 393         <para revision="209783">The &man.altq.4; support is now provided
 394           as a kernel module <filename>alq.ko</filename>.</para>
 395
 396         <para revision="212738">A bug in the &man.ipfw.4; packet
 397           filter subsystem has been fixed.  The syctl variable
 398           <varname>net.inet.ip.fw.one_pass</varname> did not work for
 399           <literal>netgraph</literal> action.</para>
 400
 401         <para revision="212742">A <literal>ngtee</literal> action in
 402           the &man.ipfw.4; packet filter subsystem has been changed.
 403           It no longer accepts a packet.</para>
 404
 405         <para revision="209691">IPsec flow distribution has been
 406           improved for more parallel processing.</para>
 407
 408         <para revision="209277">A bug in &os; IPv4 stack that a proxy
 409           ARP entry cannot be added over &man.netgraph.4; interfaces
 410           has been fixed.</para>
 411
 412         <para revision="211435">A bug in &os; IPv6 stack which prevents
 413           an <option>-I</option> in the &man.ping6.8; utility from
 414           working with
 415           <varname>net.inet6.ip6.use_defaultzone=1</varname> has been
 416           fixed.</para>
 417
 418         <para revision="209843">A new &man.netgraph.4; node
 419           &man.ng.patch.4; has been added.  This performs data
 420           modification of packets passing through.  Modifications are
 421           restricted to a subset of C language operations on unsigned
 422           integers of 8, 16, 32 or 64-bit size.</para>
 423
 424         <para revision="212320">The &man.ng.ether.4; &man.netgraph.4;
 425           node now supports interface transfer between multiple virtual
 426           network stacks by &man.ifconfig.8; <command>vnet</command>
 427           command.  A &man.ng.ether.4; node associated with an network
 428           interface is now destroyed and recreated when the network
 429           interface is moved to another vnet.</para>
 430
 431         <para revision="212905">An ICMP unreachable problem in the
 432           &man.pf.4; packet filter subsystem when TSO support is
 433           enabled has been fixed.</para>
 434
 435         <para revision="211538">A TCP bandwidth delay product window
 436           limiting algorithm by a &man.sysctl.8; variable
 437           <varname>net.inet.tcp.inflight.enable</varname> is now
 438           disabled by default.  It has been found that this algorithm
 439           is inefficient on a fast network with smaller RTT than 10ms.
 440           It had been enabled by default since 5.2-RELEASE, and then
 441           had been disabled only if the RTT was lesser than 10ms since
 442           7.0-RELEASE.  Pluggable TCP congestion control algorithm
 443           modules are planned to be added for the future
 444           releases.</para>
 445
 446         <para revision="211602">A bug in &os; TCP Path MTU discovery
 447           which can lead to a wrong calculation for a smaller MTU than
 448           256 octets has been fixed.  Note that this bug does not
 449           affect when MTU is equal to or larger than 256
 450           octets.</para>
 451
 452         <para revision="211870">The TCP initial window increase in RFC
 453           3390 which can be controlled by a &man.sysctl.8; variable
 454           <varname>net.inet.tcp.rfc3390</varname> now reduces the
 455           congestion window to the restart window if a TCP connection
 456           has been idle for one retransmit timeout or more.  For more
 457           details, see RFC 5681 Section 4.1.</para>
 458
 459         <para revision="212319">&os; virtual network stack (vnet) now
 460           supports IPv4 multicast routing.</para>
 461       </sect3>
 462
 463       <sect3 id="disks">
 464         <title>Disks and Storage</title>
 465
 466         <para revision="211458">The &man.ahci.4; driver now disables NCQ
 467           and PMP support on VIA VT8251 because they are unreliable
 468           under load.</para>
 469
 470         <para revision="211718">The &man.ahci.4; driver now uses 15
 471           seconds for device reset timeout instead of 10 seconds
 472           because some devices needs 10-12 seconds to spin up.</para>
 473
 474         <para revision="210836">The &man.arcmsr.4; driver
 475           has been updated to version 1.20.00.17.</para>
 476
 477         <para revision="210164">The &man.ata.4; driver
 478           now supports limiting initial ATA mode for devices via
 479           device hints
 480           <varname>hint.<replaceable>devname</replaceable>.<replaceable>unit</replaceable>.dev<replaceable>N</replaceable
 481           >.mode</varname> or
 482           <varname>hint.<replaceable>devname</replaceable>.<replaceable>unit</replaceable>.mode</varname>.
 483           The valid values are the same as ones supported in the
 484           &man.atacontrol.8; and &man.camcontrol.8;.</para>
 485
 486         <para revision="210204">The &man.ata.4; driver
 487           now enables cable status check on both of controller and
 488           device side when
 489           <varname>hw.ata.ata_dma_check_80pin</varname> is
 490           enabled.</para>
 491
 492         <para revision="213291">A device detection of Serverworls K2
 493           SATA controllers in the &man.ata.4; has been
 494           improved.</para>
 495
 496         <para revision="210376">The &man.mpt.4; driver now supports
 497           larger I/O sizes which the device and &man.CAM.4; subsystem
 498           can support.  This was limited to 64KB, and the number of
 499           scatter/gather segments was limited to 33 on platforms with
 500           4K pages.</para>
 501
 502         <para revision="209404">The &man.twa.4;
 503           driver has been updated.  The version number is
 504           3.80.06.003.</para>
 505       </sect3>
 506
 507       <sect3 id="fs">
 508         <title>File Systems</title>
 509
 510         <para revision="212716">The &os; NFS client now supports a
 511           kernel environment variable
 512           <varname>boot.nfsroot.nfshandlelen</varname>.  This lets the
 513           diskless root file system on boot to use NFS version 3 and
 514           the spedified file handle length.  If this variable is not
 515           set, NFS version 2 is used.</para>
 516
 517         <para revision="212668">The ZFS on-disk format has been updated
 518           to version 15.</para>
 519
 520         <para revision="212671">The ZFS metaslab code has been updated.
 521           This provides a noticeable improvement on write speed,
 522           especially on pools with less than 30% of free space.  The
 523           related OpenSolaris Bug IDs are 6826241, 6869229, 6918420,
 524           and 6917066.</para>
 525
 526         <para revision="212672">Performance improvements for the ZFS
 527           have been imported from OpenSolaris.  They include cachin of
 528           ACL permission checks, faster handling of &man.stat.2;,
 529           mitigation of mutex lock contention.  The related
 530           OpenSolaris Bug IDs are 6802734, 6844861, 6848431, 6775100,
 531           6827779, 6857433, 6860318, 6865875, 6867395, 6868276, and
 532           6870564.</para>
 533
 534         <para revision="210541">The default value of
 535           <varname>vfs.zfs.vdev.max_pending</varname> has been
 536           decreased from 35 to 10 (OpenSolaris Bug ID is 6891731) to
 537           improve latency.</para>
 538
 539         <para>Various bugs in the ZFS subsystem have been fixed.  The
 540           related OpenSolaris Bug IDs are: 6328632, 6396518, 6501037,
 541           6504953, 6542860, 6551866, 6572357, 6572376, 6582163,
 542           6586537, 6595194, 6596237, 6604992, 6621164, 6623978,
 543           6633095, 6635482, 6664765, 6674216, 6696858, 6696858,
 544           6702206, 6710376, 6713916, 6717022, 6722540, 6722991,
 545           6737463, 6739487, 6739553, 6740164, 6745863, 6747596,
 546           6747698, 6748436, 6755435, 6757430, 6758107, 6759986,
 547           6759999, 6761100, 6761406, 6764124, 6765294, 6767129,
 548           6769612, 6770866, 6774713, 6774886, 6775697, 6776104,
 549           6776548, 6780491, 6784104, 6784108, 6788152, 6788152,
 550           6788830, 6789318, 6790064, 6790345, 6790687, 6791064,
 551           6791066, 6791071, 6791101, 6792134, 6792139, 6792884,
 552           6793430, 6794136, 6794570, 6794570, 6794830, 6797109,
 553           6797118, 6798384, 6798878, 6798878, 6799895, 6800184,
 554           6800942, 6801507, 6801810, 6803343, 6803822, 6804954,
 555           6807339, 6807765, 6809340, 6809683, 6809683, 6809691,
 556           6810367, 6815592, 6815893, 6816124, 6818183, 6821169,
 557           6821170, 6822816, 6824006, 6824062, 6824968, 6826466,
 558           6826468, 6826469, 6826470, 6826471, 6826472, 6827260,
 559           6830237, 6833162, 6833711, 6833999, 6834217, 6836714,
 560           6836714, 6836768, 6838062, 6838344, 6841321, 6843069,
 561           6843235, 6843235, 6844069, 6844069, 6844900, 6847229,
 562           6848242, 6856634, 6857012, 6857012, 6857012, 6861983,
 563           6862984, 6863610, 6870564, 6870564, 6880764, 6882227,
 564           6892298, 6898245, 6906110, 6906946, 6939941, 6950219,
 565           6951024, and 6953403.</para>
 566       </sect3>
 567     </sect2>
 568
 569     <sect2 id="userland">
 570       <title>Userland Changes</title>
 571
 572       <para revision="209267">The &man.arp.8; utility has been improved.
 573         It now runs faster even when a single interface has a number
 574         of aliases.</para>
 575
 576       <para revision="211723">The &man.calendar.1; utility now supports
 577         repeating events which span multiple years, lunar events, and
 578         solar events.</para>
 579
 580       <para revision="210915">The &man.dhclient.8; utility now reports a
 581         reason for exiting and the 10-second period in which the
 582         &man.dhclient.8; ignores routing messages has been changed to
 583         start just after <filename>dhclient-script</filename> starts
 584         instead of just after it finished.  This change fixes a
 585         symptom that &man.dhclient.8; silently exits under a certain
 586         condition.</para>
 587
 588       <para revision="209362">The &man.du.1; utility now supports a
 589         <option>-t <replaceable>threshold</replaceable></option>
 590         option to display entries that exceeds the value of
 591         <replaceable>threshold</replaceable>.  If the value is
 592         negative, it displays entries with a value less than the
 593         absolute value of <replaceable>threshold</replaceable>.</para>
 594
 595       <para revision="210567">The &man.gcore.1; utility now supports an
 596         <option>-f</option> flag which forces a full dump of all the
 597         segments except for the malformed ones.</para>
 598
 599       <para revision="211938">The <function>gethost*()</function>,
 600         <function>getnet*()</function>, and
 601         <function>getproto*()</function> functions now set the errno
 602         to <literal>ERANGE</literal> and the NSS backend terminates
 603         with <literal>NS_RETURN</literal> when the result buffer size
 604         is too small.</para>
 605
 606       <para revision="209497">The &man.gpart.8; utility now supports
 607         <command>resize</command> command to resize partitions for all
 608         schemes but EBR.</para>
 609
 610       <para revision="213661">The &man.gpart.8; utility now handles
 611         given geom/provider names with and without
 612         <filename>/dev/</filename> prefix.</para>
 613
 614       <para revision="213049">The &man.hastd.8; utility now supports
 615         <literal>SIGHUP</literal> for reloading the configuration
 616         file.  When <literal>SIGTERM</literal> or
 617         <literal>SIGINT</literal> is received, the worker processes
 618         terminate.</para>
 619
 620       <para revision="212144">The &man.ifconfig.8; utility now check an
 621         invalid CIDR subnet notation more strictly.  It wrongly
 622         accepted <literal>10.0.0.1/10.0.0.1</literal> as
 623         <literal>10.0.0.1/10</literal>.</para>
 624
 625       <para revision="209284">Incorrect behaviors in stuttering
 626         sequences and reverse ranges in the &man.jot.1; utility have
 627         been fixed.</para>
 628
 629       <para revision="213667">The <filename>libarchive</filename> and
 630         &man.tar.1; utility now support LZMA (Lempel-Ziv-Markov
 631         chain-Algorithm) compression format.</para>
 632
 633       <para revision="211699">The &man.newsyslog.8; utility now supports
 634         an <option>-S <replaceable>pidfile</replaceable></option>
 635         option to override the default &man.syslogd.8; PID
 636         file.</para>
 637
 638       <para revision="212848">An off-by-one error in the &man.pax.1;
 639         utility when ustar file name is too long has been
 640         fixed.</para>
 641
 642       <para revision="209912">The &man.pkill.1; utility now supports
 643         an <option>-l</option> option which the &man.kill.1; utility
 644         does.</para>
 645
 646       <para revision="211098">The &man.pmcstat.8; utility now supports a
 647         file and a network socket as a top source.  A new option
 648         <option>-O <replaceable>filename</replaceable></option>
 649         specifies to send log output to
 650         <replaceable>filename</replaceable>, and another new option
 651         <option>-R <replaceable>filename</replaceable></option>
 652         specifies to receive events from
 653         <replaceable>filename</replaceable>.  For a socket, the
 654         <replaceable>filename</replaceable> is in a form of
 655         <replaceable>ipaddr:port</replaceable>.  This allows top
 656         monitoring over TCP on a system with no local symbols, for
 657         example.</para>
 658
 659       <para revision="210089">The &man.pom.6; utility now
 660         supports a <option>-p</option> flag to print only the
 661         percentage.</para>
 662
 663       <para revision="212472">The &man.powerd.8; utility now supports
 664         an <option>-m <replaceable>freq</replaceable></option> and
 665         <option>-M <replaceable>freq</replaceable></option> to control
 666         the minimum and maximum frequency, respectively.</para>
 667
 668       <para revision="210616">A bug in the &man.sh.1; program has been
 669         fixed.  A <literal>SIGINT</literal> signal is now passed
 670         through from a child process if the shell is interactive and
 671         the job control is enabled.  For example, aborting
 672         &man.sleep.1; command by Ctrl-C no longer display
 673         <literal>ok</literal> in the following command line:</para>
 674
 675       <screen>&prompt.user; sleep 5; echo ok</screen>
 676
 677       <para revision="210732">The &man.sh.1; program now supports a
 678         <command>bg</command> command consisting solely of
 679         redirections.  For example:</para>
 680
 681       <screen>&prompt.user; &lt; /dev/null &amp;</screen>
 682
 683       <para revision="211536">The &man.sleep.1; utility now supports
 684         <literal>SIGINFO</literal> signal and reports the specified
 685         sleep time and the remaining time.</para>
 686
 687       <para revision="213036,213038">The &man.tftp.1; and &man.tftpd.8;
 688         utilities have been improved for better interoperability and
 689         they now supports RFC 1350, 2347, 2348, 2349, and 3617.</para>
 690
 691       <para revision="210566">The &man.uname.1; utility now supports an
 692         <option>-o</option> flag as a synonym for the
 693         <option>-s</option> flag for compatibility with other
 694         systems.</para>
 695
 696       <para revision="211060">Bugs in &man.vi.1; utility have been
 697         fixed.  They include handling of <literal>^@</literal> and
 698         <literal>^C</literal> in insert mode when reading an ex
 699         command.</para>
 700
 701       <para revision="209870">The <command>set sharenfs</command>
 702         command in the &man.zfs.8; utility now supports
 703         <option>sec</option> option.</para>
 704
 705       <sect3 id="periodic-scripts">
 706         <title><filename>/etc/periodic</filename> Scripts</title>
 707
 708         <para>A periodic script for <command>zfs scrub</command> has
 709           been added.  For more details, see &man.periodic.conf.5;
 710           manual page.</para>
 711       </sect3>
 712
 713       <sect3 id="rc-scripts">
 714         <title><filename>/etc/rc.d</filename> Scripts</title>
 715
 716         <para></para>
 717       </sect3>
 718     </sect2>
 719
 720     <sect2 id="contrib">
 721       <title>Contributed Software</title>
 722
 723       <para></para>
 724 <!--
 725       <para>The <application>ACPI-CA</application> has been updated to
 726         20100304.</para>
 727
 728       <para>The <application>awk</application> has been updated from
 729         the 23 October 2007 release to the 26 November 2009 release.</para>
 730
 731       <para><application>ISC BIND</application> has been updated to
 732         version 9.6.2-P2.</para>
 733
 734       <para><application>netcat</application> has been updated to
 735         version 4.7.</para>
 736
 737       <para><application>OpenSSH</application> has been updated from
 738         version 5.1p1 to version 5.4p1.</para>
 739
 740       <para><application>OpenSSL</application> has been updated to
 741         version 0.9.8n.</para>
 742
 743       <para><application>sendmail</application> has been updated to
 744         version 8.14.4.</para>
 745 -->
 746       <para>The timezone database has been updated to the
 747         <application>tzdata2010m</application> release.</para>
 748     </sect2>
 749
 750     <sect2 id="releng">
 751       <title>Release Engineering and Integration</title>
 752
 753       <para revision="211007">The &man.sysinstall.8; utility now uses
 754         the following numbers for default and minimum partition sizes:
 755         1GB for <filename>/</filename>, 4GB for
 756         <filename>/var</filename>, and 1GB for
 757         <filename>/tmp</filename>.</para>
 758
 759       <para revision="211009">The &man.sysinstall.8; utility now
 760         attempts to enable &man.getty.8; on a serial port when no VGA
 761         card on the system.</para>
 762
 763       <para>The supported version of
 764         the <application>GNOME</application> desktop environment
 765         (<filename role="package">x11/gnome2</filename>) has been
 766         updated to 2.32.1.</para>
 767
 768       <para>The supported version of
 769         the <application>KDE</application> desktop environment
 770         (<filename role="package">x11/kde4</filename>) has been
 771         updated to 4.5.5.</para>
 772     </sect2>
 773   </sect1>
 774
 775   <sect1 id="upgrade">
 776     <title>Upgrading from previous releases of &os;</title>
 777
 778     <para arch="amd64,i386">Upgrades between RELEASE versions (and
 779       snapshots of the various security branches) are supported using
 780       the &man.freebsd-update.8; utility.  The binary upgrade
 781       procedure will update unmodified userland utilities, as well as
 782       unmodified GENERIC kernel distributed as a part of an
 783       official &os; release.  The &man.freebsd-update.8; utility
 784       requires that the host being upgraded has Internet
 785       connectivity.</para>
 786
 787     <para>An older form of binary upgrade is supported through the
 788       <command>Upgrade</command> option from the main
 789       &man.sysinstall.8; menu on CDROM distribution media.  This type
 790       of binary upgrade may be useful on non-&arch.i386;,
 791       non-&arch.amd64; machines or on systems with no Internet
 792       connectivity.</para>
 793
 794     <para>Source-based upgrades (those based on recompiling the &os;
 795       base system from source code) from previous versions are
 796       supported, according to the instructions in
 797       <filename>/usr/src/UPDATING</filename>.</para>
 798
 799     <important>
 800       <para>Upgrading &os; should, of course, only be attempted after
 801         backing up <emphasis>all</emphasis> data and configuration
 802         files.</para>
 803     </important>
 804   </sect1>
 805 </article>