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

   1 <?xml version="1.0" encoding="iso-8859-1"?>
   2 <!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
   3         "../../../share/xml/freebsd50.dtd" [
   4 <!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN" "release.ent">
   5  %release;
   6 <!ENTITY % sponsor PUBLIC "-//FreeBSD//ENTITIES Sponsor Specification//EN" "sponsor.ent">
   7  %sponsor;
   8 <!ENTITY % vendor PUBLIC "-//FreeBSD//ENTITIES Vendor Specification//EN" "vendor.ent">
   9  %vendor;
  10 ]>
  11 <article xmlns="http://docbook.org/ns/docbook"
  12   xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
  13
  14   <info>
  15     <title>&os; &release.current; Release Notes</title>
  16
  17     <author>
  18       <orgname>The &os; Project</orgname>
  19     </author>
  20
  21     <pubdate>$FreeBSD$</pubdate>
  22
  23     <copyright>
  24       <year>2000</year>
  25       <year>2001</year>
  26       <year>2002</year>
  27       <year>2003</year>
  28       <year>2004</year>
  29       <year>2005</year>
  30       <year>2006</year>
  31       <year>2007</year>
  32       <year>2008</year>
  33       <year>2009</year>
  34       <year>2010</year>
  35       <year>2011</year>
  36       <year>2012</year>
  37       <year>2013</year>
  38       <year>2014</year>
  39       <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
  40         Project</holder>
  41     </copyright>
  42
  43     <legalnotice xml:id="trademarks" role="trademarks">
  44       &tm-attrib.freebsd;
  45       &tm-attrib.ibm;
  46       &tm-attrib.ieee;
  47       &tm-attrib.intel;
  48       &tm-attrib.sparc;
  49       &tm-attrib.general;
  50     </legalnotice>
  51
  52     <abstract>
  53       <para>The release notes for &os; &release.current; contain
  54         a summary of the changes made to the &os; base system on the
  55         &release.branch; development line.  This document lists
  56         applicable security advisories that were issued since the last
  57         release, as well as significant changes to the &os; kernel and
  58         userland.  Some brief remarks on upgrading are also
  59         presented.</para>
  60     </abstract>
  61   </info>
  62
  63   <sect1 xml:id="intro">
  64     <title>Introduction</title>
  65
  66     <para>This document contains the release notes for &os;
  67       &release.current;.  It describes recently added, changed, or
  68       deleted features of &os;.  It also provides some notes on
  69       upgrading from previous versions of &os;.</para>
  70
  71     <para releasetype="current">The &release.type; distribution to
  72       which these release notes apply represents the latest point
  73       along the &release.branch; development branch since
  74       &release.branch; was created.  Information regarding pre-built,
  75       binary &release.type; distributions along this branch can be
  76       found at <uri
  77         xlink:href="&release.url;">&release.url;</uri>.</para>
  78
  79     <para releasetype="snapshot">The &release.type; distribution to
  80       which these release notes apply represents a point along the
  81       &release.branch; development branch between &release.prev; and
  82       the future &release.next;.  Information regarding pre-built,
  83       binary &release.type; distributions along this branch can be
  84       found at <uri
  85         xlink:href="&release.url;">&release.url;</uri>.</para>
  86
  87     <para releasetype="release">This distribution of &os;
  88       &release.current; is a &release.type; distribution.  It can be
  89       found at <uri xlink:href="&release.url;">&release.url;</uri> or
  90       any of its mirrors.  More information on obtaining this (or
  91       other) &release.type; distributions of &os; can be found in the
  92       <link
  93         xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
  94           &os;</quote> appendix</link> to the <link
  95         xlink:href="&url.books.handbook;/">&os;
  96         Handbook</link>.</para>
  97
  98     <para>All users are encouraged to consult the release errata
  99       before installing &os;.  The errata document is updated with
 100       <quote>late-breaking</quote> information discovered late in the
 101       release cycle or after the release.  Typically, it contains
 102       information on known bugs, security advisories, and corrections
 103       to documentation.  An up-to-date copy of the errata for &os;
 104       &release.current; can be found on the &os; Web site.</para>
 105   </sect1>
 106
 107   <sect1 xml:id="new">
 108     <title>What's New</title>
 109
 110     <para>This section describes the most user-visible new or changed
 111       features in &os; since &release.prev;.</para>
 112
 113     <para>Typical release note items document recent security
 114       advisories issued after &release.prev;, new drivers or hardware
 115       support, new commands or options, major bug fixes, or
 116       contributed software upgrades.  They may also list changes to
 117       major ports/packages or release engineering practices.  Clearly
 118       the release notes cannot list every single change made to &os;
 119       between releases; this document focuses primarily on security
 120       advisories, user-visible changes, and major architectural
 121       improvements.</para>
 122
 123     <sect2 xml:id="security">
 124       <title>Security Advisories</title>
 125
 126       <para>&nbsp;</para>
 127
 128     </sect2>
 129
 130     <sect2 xml:id="kernel">
 131       <title>Kernel Changes</title>
 132
 133       <para revision="260431">A new &man.sysctl.8;,
 134         <literal>kern.panic_reboot_wait_time</literal>, has been
 135         added, which allows controlling how long the system will wait
 136         after &man.panic.9; before rebooting.</para>
 137
 138       <para revision="262861">The &man.vt.4; driver has been merged
 139         from &os;-CURRENT.  To enable &man.vt.4;, enter
 140         <literal>set kern.vty=vt</literal> at the &man.loader.8;
 141         prompt during boot, or add <literal>kern.vty=vt</literal> to
 142         &man.loader.conf.5; and reboot the system.</para>
 143
 144       <para revision="263122">Support for &man.hwpmc.4; has been added
 145         for &powerpc;&nbsp;970 class processors.</para>
 146
 147       <para revision="263197">Support for ADT7460 and ADT7467 fan
 148         controllers found in newer PowerBooks&trade; and
 149         iBooks&trade; has been added to the &man.iicbus.4;
 150         driver.</para>
 151
 152       <para revision="263256">A panic triggered by removing
 153         a &man.urtwn.4; device has been fixed.</para>
 154
 155       <para revision="263799">A potential deadlock in the &man.usb.4;
 156         stack triggered by detaching USB devices that create character
 157         devices has been fixed.</para>
 158
 159       <para revision="263869">Support for &amd;&nbsp;Family 16h sensor
 160         devices has been added to &man.amdtemp.4;.</para>
 161
 162       <para revision="265610">The &man.uslcom.4; driver has been
 163         updated to support 26 new devices.</para>
 164
 165       <para revision="266165">A kernel bug that inhibited proper
 166         functionality of the <literal>dev.cpu.0.freq</literal>
 167         &man.sysctl.8; on &intel; processors with Turbo
 168         Boost&trade; enabled has been fixed.</para>
 169
 170       <para revision="266436">The &man.uart.4; driver has been
 171         updated to include support for the &intel;&nbsp;Lynx Point
 172         KT <acronym>AMT</acronym> serial port.</para>
 173
 174       <para revision="266594">The <literal>radeonkms(4)</literal>
 175         driver has been updated to include 32-bit &man.ioctl.2;
 176         support, allowing 32-bit applications to run on a 64-bit
 177         system.</para>
 178
 179       <para revision="266718">A bug that would prevent
 180         a &man.jail.8; from setting the correct IPv4 source address
 181         with some operations that required
 182         <literal>security.jail.allow_raw_sockets</literal> has been
 183         fixed.</para>
 184
 185       <para revision="266911">The &man.hwpmc.4; driver has been
 186         updated to support core events from the Atom&trade;
 187         Silvermont architecture.</para>
 188
 189       <para revision="268046">The &man.oce.4; driver has been updated
 190         with vendor-supplied fixes for big endian support, and 20GB/s
 191         and 25GB/s link speeds.</para>
 192
 193       <para revision="270630">The &os;&nbsp;virtual memory subsystem
 194         has been updated to implement <quote>fast path</quote> for
 195         the page fault handler.</para>
 196
 197       <sect3 xml:id="kernel-virtualization">
 198         <title>Virtualization Support</title>
 199
 200         <para revision="259450">Support for &microsoft; Hyper-V
 201           has been added to &os;/i386 as loadable modules, however
 202           not available in the <filename>GENERIC</filename> kernel
 203           configuration.</para>
 204
 205         <para revision="261090">The &man.bhyve.4; hypervisor now
 206           supports soft power-off functionality via the ACPI S5
 207           state.</para>
 208
 209         <para revision="267399">Support for &os;/i386 guests has been
 210           added to &man.bhyve.4;.</para>
 211
 212         <para revision="267427">Support for virtualized
 213           <literal>XSAVE</literal> has been added to &man.bhyve.4;,
 214           allowing guest operating systems to use
 215           <literal>XSAVE</literal> and
 216           <literal>XSAVE</literal>-enabled features, such as
 217           <acronym>AVX</acronym>.</para>
 218
 219         <para revision="268932">The &man.bhyve.4; hypervisor now
 220           supports booting from a &man.zfs.8; filesystem.</para>
 221
 222         <para revision="268933">A new driver, &man.virtio_random.4;,
 223           has been added, which allows &os; virtual machines to
 224           harvest entropy from the hypervisor.</para>
 225
 226         <para revision="270159">The &man.bhyve.4; hypervisor has been
 227           synced with the version in &os;-CURRENT.</para>
 228
 229         <para>A number of enhancements have been added, and several
 230           bug fixes, including:</para>
 231
 232         <itemizedlist>
 233           <listitem>
 234             <para>Post-mortem debugging has been added when
 235               a guest virtual machine exits with an
 236               <quote><acronym>EPT</acronym> Misconfiguration</quote>
 237               error.</para>
 238           </listitem>
 239
 240           <listitem>
 241             <para>The hypervisor &man.virtio.4; <acronym>API</acronym>
 242               has been expanded from 32- to 64-bit.</para>
 243           </listitem>
 244
 245           <listitem>
 246             <para>Support for identifying capabilities of the virtual
 247               <acronym>CPU</acronym> has been added.</para>
 248           </listitem>
 249
 250           <listitem>
 251             <para>Support for emulating legacy x86 task
 252               switching has been added.</para>
 253           </listitem>
 254
 255           <listitem>
 256             <para>Support to list the VT-x features in base kernel
 257               &man.dmesg.8; has been added.</para>
 258           </listitem>
 259
 260           <listitem>
 261             <para>Support for extended PCI configuration space
 262               has been added.</para>
 263           </listitem>
 264         </itemizedlist>
 265       </sect3>
 266
 267       <sect3 xml:id="kernel-arm">
 268         <title>ARM Support</title>
 269
 270         <para revision="259355">The <filename>WANDBOARD</filename>
 271           kernel configuration file has been added.</para>
 272
 273         <para revision="265067">Boot devices may now be specified by
 274           setting a u-boot environment variable.  If a boot device is
 275           not specified, the probe mechanism will be used.  To specify
 276           the boot device, set the
 277           <literal>loaderdev=<replaceable>device</replaceable></literal>
 278           u-boot environment variable.</para>
 279
 280         <para revision="266000">The <literal>nexus(4)</literal> driver
 281           has been updated to include <quote>Flattened Device
 282             Tree</quote> support, replacing the &man.fdtbus.4; driver
 283           in most cases.</para>
 284
 285         <para revision="266105">The &man.gpioiic.4; and
 286           &man.gpioled.4; have been merged from &os;-CURRENT.</para>
 287
 288         <para revision="266379">The <literal>ZEDBOARD</literal> kernel
 289           configuration file has been updated to include
 290           <acronym>SMP</acronym> support.</para>
 291       </sect3>
 292
 293       <sect3 xml:id="boot">
 294         <title>Boot Loader Changes</title>
 295
 296         <para revision="262701">A kernel selection menu has been added
 297           to &man.loader.8;.  If the <quote>beastie menu</quote> is
 298           enabled, the kernel to boot may be selected from the kernel
 299           selection menu.  Additional kernels may be listed in
 300           &man.loader.conf.5; as a comma- or space-separated list.  By
 301           default, <literal>kernel</literal> and
 302           <literal>kernel.old</literal> are listed.</para>
 303       </sect3>
 304
 305       <sect3 xml:id="proc">
 306         <title>Hardware Support</title>
 307
 308         <para>&nbsp;</para>
 309
 310         <sect4 xml:id="mm">
 311           <title>Multimedia Support</title>
 312
 313           <para>&nbsp;</para>
 314
 315         </sect4>
 316
 317         <sect4 xml:id="net-if">
 318           <title>Network Interface Support</title>
 319
 320           <para revision="259453">Support for Ralink RT5370 and
 321             RT5372 chipsets has been added to the &man.run.4;
 322             driver.</para>
 323
 324           <para revision="260120">Firmware for the &man.run.4; driver
 325             has been updated to version 0.33.</para>
 326
 327           <para revision="261868">Support for the Ralink RT3593
 328             chipset has been added to the &man.run.4; driver.</para>
 329
 330           <para revision="261972">The &man.nve.4; driver is now
 331             deprecated, and the &man.nfe.4; driver should be used
 332             instead.</para>
 333
 334           <para revision="262137">Support for the &man.axge.4; driver
 335             has been added.  This driver supports the ASIX AX88178A
 336             and AX88179 USB ethernet adapters.  The AX88178A supports
 337             USB 2.0, and the AX88179 supports USB 2.0 and 3.0.</para>
 338
 339           <para revision="262363">The &man.urndis.4; driver has been
 340             imported from OpenBSD.</para>
 341
 342           <para revision="264866">Support for multiple
 343             transmitter/receiver queues has been added to the
 344             &man.vmx.4; driver.</para>
 345
 346           <note>
 347             <para>The &os;&nbsp;guest operating system must have
 348               <acronym>MSIX</acronym> enabled as a prerequisite for
 349               multiple queues.</para>
 350           </note>
 351
 352           <para revision="265345">Support for the ASUS USB-N10 Nano
 353             wireless card has been added to the &man.urtwn.4;
 354             driver.</para>
 355
 356           <para revision="266212">Transmission checksum offloading has
 357             been disabled for the RTL8168C and RTL8168CP chipsets in
 358             the &man.re.4; driver for TCP and UDP frames.  This is
 359             due to a report of UDP datagrams with IP options
 360             generating corrupt frames.</para>
 361
 362           <para revision="266578">Preliminary support has been added
 363             to the &man.urtwn.4; driver for the Realtek RTL8188EUS and
 364             RTL8188ETV chipsets.</para>
 365
 366           <para revision="267694">A bug in the fast receiver buffer
 367             recycle path has been fixed in the &man.cxgbe.4;
 368             driver.</para>
 369
 370           <para revision="267849" contrib="vendor"
 371             vendor="&chelsio;">The bundled &man.cxgbe.4; firmware for
 372             T4 and T5 cards has been updated to version
 373             1.11.27.0.</para>
 374
 375           <para revision="269196">The &man.em.4; driver has been
 376             updated to version 7.4.2.</para>
 377
 378           <para revision="269975">The &man.ixgbe.4; tunables have been
 379             renamed to match their &man.sysctl.8; counterparts:</para>
 380
 381           <informaltable frame="none" pgwide="0">
 382             <tgroup cols="2">
 383               <colspec colwidth="1*"/>
 384               <colspec colwidth="1*"/>
 385               <thead>
 386                 <row>
 387                   <entry>Old Name</entry>
 388                   <entry>New Name</entry>
 389                 </row>
 390               </thead>
 391
 392               <tbody>
 393                 <row>
 394                   <entry><literal>hw.ixgbe.enable_aim</literal></entry>
 395                   <entry><literal>hw.ix.enable_aim</literal></entry>
 396                 </row>
 397
 398                 <row>
 399                   <entry><literal>hw.ixgbe.max_interrupt_rate</literal></entry>
 400                   <entry><literal>hw.ix.max_interrupt_rate</literal></entry>
 401                 </row>
 402
 403                 <row>
 404                   <entry><literal>hw.ixgbe.rx_process_limit</literal></entry>
 405                   <entry><literal>hw.ix.rx_process_limit</literal></entry>
 406                 </row>
 407
 408                 <row>
 409                   <entry><literal>hw.ixgbe.tx_process_limit</literal></entry>
 410                   <entry><literal>hw.ix.tx_process_limit</literal></entry>
 411                 </row>
 412
 413                 <row>
 414                   <entry><literal>hw.ixgbe.enable_msix</literal></entry>
 415                   <entry><literal>hw.ix.enable_msix</literal></entry>
 416                 </row>
 417
 418                 <row>
 419                   <entry><literal>hw.ixgbe.num_queues</literal></entry>
 420                   <entry><literal>hw.ix.num_queues</literal></entry>
 421                 </row>
 422
 423                 <row>
 424                   <entry><literal>hw.ixgbe.txd</literal></entry>
 425                   <entry><literal>hw.ix.txd</literal></entry>
 426                 </row>
 427
 428                 <row>
 429                   <entry><literal>hw.ixgbe.rxd</literal></entry>
 430                   <entry><literal>hw.ix.rxd</literal></entry>
 431                 </row>
 432
 433                 <row>
 434                   <entry><literal>hw.ixgbe.unsupported_sfp</literal></entry>
 435                   <entry><literal>hw.ix.unsupported_sfp</literal></entry>
 436                 </row>
 437               </tbody>
 438             </tgroup>
 439           </informaltable>
 440
 441           <para>Be sure to update &man.loader.conf.5; if using the
 442             old tunables before upgrading to
 443             &os;&nbsp;&release.current;.</para>
 444
 445           <para revision="270061">The &man.if.nf10bmac.4; driver has
 446             been merged from &os;-CURRENT to support the NetFPGA-10G
 447             Embedded CPU Ethernet Core.</para>
 448
 449           <para revision="270297">The &man.cxgbe.4; driver has been
 450             updated to support &man.netmap.4; for the T5 10G/40G
 451             cards.</para>
 452
 453           <para revision="270509">The &man.vtnet.4; driver has been
 454             updated to support &man.netmap.4;.</para>
 455
 456           <para revision="270514">The &man.urtwn.4; driver has been
 457             updated to support the ASUS USB-AC51 wireless card.</para>
 458
 459           <para revision="270631">The &intel;&nbsp;XL710 ethernet
 460             controller driver, <literal>ixlv(4)</literal>, has been
 461             merged from &os;-CURRENT.</para>
 462         </sect4>
 463       </sect3>
 464
 465       <sect3 xml:id="net-proto">
 466         <title>Network Protocols</title>
 467
 468         <para revision="265946">Support for the UDP-Lite protocol
 469           (RFC 3828) has been added to the IPv4 and IPv6
 470           stacks.</para>
 471
 472         <para revision="267771">A bug in &man.sctp.4; that would allow
 473           two listening sockets bound to the same port has been
 474           fixed.</para>
 475       </sect3>
 476
 477       <sect3 xml:id="disks">
 478         <title>Disks and Storage</title>
 479
 480         <para revision="260385" contrib="sponsor" sponsor="&ix;">The
 481           &man.geom.4; got I/O direct dispatch support.
 482           When safety requirements are met, it allows to avoid passing
 483           I/O requests to GEOM g_up/g_down thread, executing them directly
 484           in the caller context. That allows to avoid CPU bottlenecks in
 485           g_up/g_down threads, plus avoid several context switches per I/O.
 486           </para>
 487
 488         <para revision="260385" contrib="sponsor" sponsor="&ix;">The
 489           &man.geom.4; RAID driver has been
 490           updated to support unmapped I/O.</para>
 491
 492         <para revision="260478">The &man.geom.8;
 493           <literal>GEOM_MULTIPATH</literal> class got automatic live
 494           resize support.</para>
 495
 496         <para revision="260857">The &man.virtio_blk.4; driver has been
 497           updated to support unmapped I/O.</para>
 498
 499         <para revision="260858">The &man.virtio_scsi.4; driver has been
 500           updated to support unmapped I/O.</para>
 501
 502         <para revision="264522">Support for LUN-based CD changers has
 503           been removed from the &man.cd.4; driver.</para>
 504
 505         <para revision="264734">Support for 9th generation HP host bus
 506           adapter cards has been added to &man.ciss.4;.</para>
 507
 508         <para revision="265388" contrib="sponsor" sponsor="&lsi;">The
 509           &man.mpr.4; device has been added,
 510           providing support for LSI Fusion-MPT 3 12Gb SCSI/SATA
 511           controllers.</para>
 512
 513         <para revision="265922" contrib="sponsor" sponsor="&lsi;">The
 514           &man.mrsas.4; driver has been added,
 515           providing support for LSI MegaRAID SAS controllers.  The
 516           &man.mfi.4; driver will attach to the controller, by default.
 517           To enable &man.mrsas.4; add
 518           <literal>hw.mfi.mrsas_enable=1</literal> to
 519           <filename>/boot/loader.conf</filename>, which turns off
 520           &man.mfi.4; device probing.</para>
 521
 522         <note>
 523           <para>At this time, the &man.mfiutil.8; utility and
 524             the &os; version of
 525             <application>MegaCLI</application> and
 526             <application>StorCli</application> do not work with
 527             &man.mrsas.4;.</para>
 528         </note>
 529
 530         <para revision="266608">Fixed accounting of BIO_FLUSH operation
 531           in &man.geom.8; <literal>GEOM_DISK</literal> class</para>
 532
 533         <para revision="266610">The &man.gstat.8;
 534           utility now has a <literal>-o</literal> option, to
 535           display "other" operatins (e.g. BIO_FLUSH).</para>
 536
 537         <para revision="267084">The &man.mfi.4; driver has been
 538           updated to include support for unmapped I/O.</para>
 539
 540         <para revision="267457">The &man.hpt27xx.4; driver has been
 541           updated with various vendor-supplied bug fixes.</para>
 542
 543         <para revision="270130" contrib="sponsor"
 544           sponsor="&citrix.rd;">Support for unmapped I/O has been added
 545           to the &man.xen.4; <literal>blkfront</literal> driver.</para>
 546
 547         <para revision="259328" contrib="sponsor" sponsor="&ff;">The
 548           &man.geom.8; <literal>label</literal> class is now aware of
 549           resized partitions.  This corrects an issue where
 550           <command>geom resize</command> would resize the partition,
 551           but the label provider in <filename
 552             class="directory">/dev/gptid/</filename> would not be
 553           resized.</para>
 554
 555         <para revision="260502">The &man.gmirror.8;
 556           utility now has a <literal>resize</literal> command, making
 557           it easier to resize the size of a mirror when all of its
 558           components have been replaced.</para>
 559
 560         <para revision="262967">Support for MegaRAID Fury cards has been
 561           added to the &man.mfi.4; driver.</para>
 562
 563         <para revision="263024">The &man.aacraid.4; driver has been
 564           updated to version 3.2.5.</para>
 565
 566         <para revision="265536">The <literal>GEOM_VINUM</literal> option
 567           is now able to be built both directly into the kernel or as
 568           a &man.kldload.8; loadable module.</para>
 569
 570         <para revision="265912">The &man.geom.8;
 571           <literal>GEOM_PART</literal> class has been updated to
 572           support automatic partition resizing.  Changes to the
 573           partition size are not saved to disk until
 574           <command>gpart commit</command> is run, and prior to saving,
 575           can be reverted with <command>gpart undo</command>.</para>
 576
 577         <para revision="266220">The &man.geom.uncompress.4; module is
 578           built by default which, similar to &man.geom.uzip.4;,
 579           provides support for compressed, read-only disk
 580           images.</para>
 581
 582         <para revision="268091">Support for the
 583           <literal>disklabel64</literal> partitioning scheme has been
 584           added to &man.gpart.8;.</para>
 585
 586         <para revision="269298">The maximum number of
 587           <acronym>SCSI</acronym> ports in the &man.ctl.4; driver has
 588           been increased from 32 to 128.</para>
 589
 590         <para revision="270552">A new &man.sysctl.8; and
 591           &man.loader.8; tunable,
 592           <literal>kern.geom.part.mbr.enforce_chs</literal> has been
 593           added to the &man.geom.8; <literal>MBR</literal> partition
 594           class.  When set to a non-zero value,
 595           <literal>GEOM_PART_MBR</literal> will automatically
 596           recalculate the user-specified offset and size for alignment
 597           with the disk geometry.</para>
 598       </sect3>
 599
 600       <sect3 xml:id="fs">
 601         <title>File Systems</title>
 602
 603         <para revision="260338">The
 604           <literal>vfs.zfs.zio.use_uma</literal> &man.sysctl.8; has been
 605           re-enabled.  On multi-CPU machines with enough RAM, this can
 606           easily double &man.zfs.8; performance or reduce CPU usage in
 607           half.  It was originally disabled due to memory and
 608           <acronym>KVA</acronym> exhaustion problem reports, which
 609           should be resolved due to several change in the VM
 610           subsystem.</para>
 611
 612         <para revision="260178" contrib="vendor"
 613           vendor="&netflix;">A new flag, <literal>-R</literal>,
 614           has been added to the &man.fsck.ffs.8; utility.  When used,
 615           &man.fsck.ffs.8; will restart itself when too many critical
 616           errors have been detected.</para>
 617
 618         <para revision="263407">The &man.zfs.8; filesystem has been
 619           updated to implement <quote>bookmarks</quote>.  See
 620           &man.zfs.8; for further details.</para>
 621
 622         <para revision="266122">The &man.zfs.8; filesystem has been
 623           updated to allow tuning the minimum <quote>ashift</quote>
 624           value when creating new top-level virtual devices (vdevs).
 625           To set the minimum ashift value, for example when creating
 626           a &man.zpool.8; on <quote>Advanced Format</quote> drives,
 627           set the <literal>vfs.zfs.min_auto_ashift</literal>
 628           &man.sysctl.8; accordingly.</para>
 629
 630         <para revision="266612">The <literal>libzfs</literal> thread
 631           pool <acronym>API</acronym> has been imported from
 632           OpenSolaris, and adapted for &os;.  This change allows
 633           parallel disk scanning, which can reduce &man.zpool.8;
 634           overall import time in some workloads.</para>
 635
 636         <para revision="269651">The &man.restore.8; utility has been
 637           updated to prevent assertion failures when restoring
 638           a <acronym>UFS</acronym> filesystem dump to
 639           a <acronym>ZFS</acronym> filesystem by writing restored
 640           files in block sizes that are a multiple of 1024.</para>
 641
 642         <para revision="269774">Two &man.sysctl.8;s have been added
 643           to the &man.zfs.8; filesystem:</para>
 644
 645         <itemizedlist>
 646           <listitem>
 647             <para>
 648               <literal>vfs.zfs.mg_fragmentation_threshold</literal>:&nbsp;The
 649               percentage of the metaslab group size that should be
 650               considered eligible for allocation, unless all metaslab
 651               groups within the metaslab class have also crossed this
 652               threshold.</para>
 653           </listitem>
 654
 655           <listitem>
 656             <para>
 657               <literal>vfs.zfs.metaslab.fragmentation_threshold</literal>:&nbsp;The
 658               maximum percentage of metaslab fragmentation level to
 659               keep their active state</para>
 660           </listitem>
 661         </itemizedlist>
 662
 663         <para revision="269846">The default &man.zfs.8;
 664           <acronym>ARC</acronym> hash table size has been increased,
 665           and a new &man.loader.8; tunable,
 666           <literal>vfs.zfs.arc_average_blocksize</literal>, has been
 667           added.  Previously, the hash table could be too small, which
 668           would lead to long hash chains and limit performance for
 669           cached reads.  The
 670           <literal>vfs.zfs.arc_average_blocksize</literal> tunable
 671           allows overriding the default block size.  The previous
 672           default was 65536, and default of the new &man.loader.8;
 673           tunable is 8192.</para>
 674
 675         <para revision="270157">The Fast File System
 676           (<acronym>FFS</acronym>) has been updated to support
 677           multi-threaded soft updates.  Previously, soft updates were
 678           handled by a single thread, and as of this change, now have
 679           one thread per <acronym>FFS</acronym> mountpoint.</para>
 680       </sect3>
 681     </sect2>
 682
 683     <sect2 xml:id="userland">
 684       <title>Userland Changes</title>
 685
 686       <para revision="260177" contrib="sponsor"
 687         sponsor="&netflix;">A new flag is added to &man.camcontrol.8;,
 688         <literal>-b</literal>, which outputs the existing buses and
 689         their parents.</para>
 690
 691       <para revision="262075">The &man.newsyslog.8; utility has been
 692         updated to rotate files based on the actual file size instead
 693         of the blocks on disk.  This matches the behavior documented
 694         in &man.newsyslog.conf.5;.</para>
 695
 696       <para revision="262384">The location of the &man.rctl.8;
 697         configuration file can now be overridden in &man.rc.conf.5;.
 698         To use a non-default location, set
 699         <literal>rctl_rules</literal> in &man.rc.conf.5; to the
 700         location of the file.</para>
 701
 702       <para revision="262855">The <application>ATF</application> test
 703         suite has been updated to version 0.20.</para>
 704
 705       <para revision="263019">The <literal>libucl</literal> library
 706         (Unified Configuration Library) has been merged from
 707         &os;-CURRENT.</para>
 708
 709       <para revision="263020">The &man.pkg.7; bootstrapping utility
 710         has been synced with the version in &os;-CURRENT.</para>
 711
 712       <para revision="263403">The &man.zfs.8; userland utility has
 713         been updated to include aliases for
 714         <command>snapshot</command>, which allows use of <command>zfs
 715           list -t snap</command> and <command>zfs
 716           snap</command>.</para>
 717
 718       <para revision="263405">The &man.zfs.8; userland utility has
 719         been updated to include a new flag to <command>zfs
 720           list</command>, <literal>-p</literal>, which when specified,
 721         prints the output in a parsable format.</para>
 722
 723       <para revision="263783">The Blowfish password format
 724         implementation updated.  Support for &dollar;2b&dollar; has
 725         been added, allowing use of passwords greater than 256
 726         characters long.</para>
 727
 728       <para revision="264497">The &man.iconv.3; library has been
 729         updated to match NetBSD, providing several bug fixes.</para>
 730
 731       <para revision="265265">The &man.date.1; utility has been
 732         updated to include a new flag, <literal>-R</literal>, which
 733         prints the date and time output as specified in RFC
 734         2822.</para>
 735
 736       <para revision="265533">The &man.bc.1; utility has been updated
 737         to version 1.1, in sync with the version in OpenBSD.</para>
 738
 739       <para revision="265604" contrib="vendor"
 740         vendor="&netflix;">The &man.pmcstat.8; utility has been
 741         updated to include a new flag, <literal>-a</literal>, which
 742         when specified, produces a full stack track on the sampled
 743         points.</para>
 744
 745       <para revision="265701">The &man.netstat.8; and &man.route.8;
 746         utilities have been updated to include a shorthand equivalent
 747         to the <literal>-f inet</literal> and <literal>-f
 748           inet6</literal> address specifiers, <literal>-4</literal>
 749         and <literal>-6</literal>, respectively.</para>
 750
 751       <para revision="265879">The &man.crypt.3; library now defaults
 752         to SHA512 for password hashing.</para>
 753
 754       <para revision="266014">The &man.gvinum.8; utility has been
 755         updated to allow forceful configuration reset with the
 756         <literal>-f</literal> flag.  Additionally, a bug that would
 757         prevent <literal>-f</literal> from properly creating
 758         a &man.gvinum.8; configuration has been fixed.</para>
 759
 760       <para revision="266029">The &man.login.conf.5; file now takes
 761         precedence over the shell-specific environment files.  In
 762         particular, the <literal>PATH</literal>,
 763         <literal>BLOCKSIZE</literal> variables are commented from
 764         <filename>/usr/share/skel/dot.profile</filename>, and the
 765         <literal>path</literal>, <literal>BLOCKSIZE</literal>, and
 766         <literal>umask</literal> variables have been commented from
 767         <filename>/usr/share/skel/dot.cshrc</filename>.</para>
 768
 769       <para revision="266272">The &man.binmiscctl.8; userland utility
 770         and related image activator features have been merged from
 771         &os;-CURRENT.</para>
 772
 773       <para revision="266279">The &man.ps.1; utility has been
 774         updated to include the <literal>-J</literal> flag, used to
 775         filter output by matching &man.jail.8; IDs and names.
 776         Additionally, argument <literal>0</literal> can be used to
 777         <literal>-J</literal> to only list processes running on the
 778         host system.</para>
 779
 780       <para revision="266280">The &man.top.1; utility has been updated
 781         to filter by &man.jail.8; ID or name, in followup to the
 782         &man.ps.1; change in <literal>r265229</literal>.</para>
 783
 784       <para revision="266610">The &man.gstat.8; utility has been
 785         updated to include a new flag, <literal>-o</literal>.  When
 786         set, &man.gstat.8; will display statistics for operations
 787         such as <literal>BIO_FLUSH</literal>.</para>
 788
 789       <para revision="266632">The &man.fetch.3; library has been
 790         updated to look for root <acronym>SSL</acronym> certificates
 791         in <filename class="directory">/usr/local/etc/ssl/</filename>
 792         before <filename
 793           class="directory">/etc/ssl/</filename>.</para>
 794
 795       <para revision="266715">The &man.clang.1;/llvm suite has been
 796         updated to version 3.4.1.</para>
 797
 798       <para revision="266816">The Blowfish password format
 799         has been changed to &dollar;2b&dollar; by default.</para>
 800
 801       <para revision="266888">The amount of data collected for
 802         &man.hwpmc.4; has been updated to work with modern processors
 803         and larger amounts of available memory.</para>
 804
 805       <para revision="266890">The &man.pmcstat.8; utility has been
 806         updated to include a new flag, <literal>-l</literal>, which
 807         ends event collection after the specified number of
 808         seconds.</para>
 809
 810       <para revision="266953">The &man.mergemaster.8; utility has
 811         been updated to avoid printing
 812         <quote><filename>/var/tmp/temproot</filename>
 813           disappeared</quote> if there is nothing to compare.</para>
 814
 815       <para revision="267056">The &os; installer, &man.bsdinstall.8;,
 816         has been updated to include optional
 817         &man.geli.8;-encrypted or &man.gmirror.8;-mirrored swap
 818         devices when installing onto a full &man.zfs.8; filesystem.
 819         Additionally, the parent &man.zfs.8; dataset is now configured
 820         with <literal>lz4</literal> compression enabled.</para>
 821
 822       <para revision="267113">The default &man.newsyslog.conf.5; now
 823         includes files in the
 824         <filename>/etc/newsyslog.conf.d/</filename> and
 825         <filename>/usr/local/etc/newsyslog.conf.d/</filename>
 826         directories by default for &man.newsyslog.8;.</para>
 827
 828       <para revision="267161">The &man.realpath.1; utility has been
 829         updated to return <literal>ENOTDIR</literal> on paths
 830         components <quote>.</quote> and <quote>..</quote> that are
 831         not directories, such as <filename
 832           class="directory">/dev/null/.</filename> or <filename
 833           class="directory">/dev/null/..</filename>.</para>
 834
 835       <para revision="267236">A new flag, <quote>onifconsole</quote>
 836         has been added to <filename>/etc/ttys</filename>.  This allows
 837         the system to provide a login prompt via serial console if the
 838         device is an active kernel console, otherwise it is equivalent
 839         to <literal>off</literal>.</para>
 840
 841       <para revision="267341">Support for legacy
 842         <acronym>PCI</acronym> devices has been removed from
 843         &man.bhyve.8;.</para>
 844
 845       <para revision="267450">The &man.bhyve.8; userland utility
 846         has been updated to include SMBIOS support.  A new flag has
 847         been added, <literal>-U</literal>, which allows specifying the
 848         UUID of the guest in the System Information structure.</para>
 849
 850       <para revision="267734">The &os;&nbsp;Project has migrated
 851         from the <application>GNATS</application> bug tracking system
 852         to <application>Bugzilla</application>.  The &man.send-pr.1;
 853         utility used for submitting problem reports has been replaced
 854         with a stub shell script that instructs to use the Bugzilla
 855         web interface.</para>
 856
 857       <para revision="267747">The &man.patch.1; utility has been
 858         updated to include a <literal>--dry-run</literal> flag, which
 859         is equivalent to <literal>--check</literal> and
 860         <literal>-C</literal>.</para>
 861
 862       <para revision="267878">A bug in &man.bsdgrep.1; that would
 863         prevent patterns from being matched under certain conditions
 864         has been fixed.</para>
 865
 866       <para revision="267979">The &man.procstat.1; utility has been
 867         updated to include two new flags, <literal>-r</literal> and
 868         <literal>-H</literal>.  When <literal>-r</literal> is
 869         specified, &man.procstat.1; will print current resource usage
 870         about the process(es).  When <literal>-H</literal> is
 871         specified, &man.procstat.1; will print information about
 872         threads rather than the process(es).</para>
 873
 874       <note>
 875         <para>The <literal>-H</literal> flag is currently only used
 876           with <literal>-r</literal> to display resource usage for
 877           individual threads, rather than the entire process.</para>
 878       </note>
 879
 880       <para revision="268019">The &man.sed.1; utility has been
 881         updated to include a new flag, <literal>-u</literal>, which
 882         enables unbuffered output when specified.</para>
 883
 884       <para revision="268161">The &man.mkimg.1; utility has been
 885         merged from &os;-CURRENT.</para>
 886
 887       <para revision="268700">The &man.camcontrol.8; has been updated
 888         to include a new <literal>persist</literal> command, which
 889         allows issuing <command>SCSI PERSISTENT RESERVE IN</command>
 890         and <command>SCSI PERSISTENT RESERVE OUT</command>.</para>
 891
 892       <para revision="268791">The &man.gstat.8; utility has been
 893         updated to include a new flag, <literal>-p</literal>, which
 894         displays only physical providers when specified.</para>
 895
 896       <para revision="268903">The &man.kldstat.8; utility has been
 897         updated to allow <literal>-q</literal> to be specified when
 898         also specifying <literal>-n
 899           <replaceable>module.ko</replaceable></literal>.</para>
 900
 901       <para revision="269177">The &man.mkimg.1; utility has been
 902         updated to include support for both fixed- and
 903         dynamically-allocated images for the <acronym>VHD</acronym>
 904         and <acronym>VMDK</acronym> formats.</para>
 905
 906       <para revision="269220">The &man.random.4; entropy collection
 907         script, <filename>/usr/libexec/save-entropy</filename>, no
 908         longer runs within &man.jail.8; environments.</para>
 909
 910       <para revision="269397">The &man.bhyve.8; wrapper script,
 911         <filename>/usr/share/examples/bhyve/vmrun.sh</filename>,
 912         has been synced with &os;-CURRENT.</para>
 913
 914       <para>This update includes:</para>
 915
 916       <itemizedlist>
 917         <listitem>
 918           <para>A new flag, <literal>-e</literal>, has been added,
 919             which is used to set &man.loader.8; environment
 920             variables.</para>
 921         </listitem>
 922
 923         <listitem>
 924           <para>A new flag, <literal>-C</literal>, has been added,
 925             which is used to specify the guest console device.</para>
 926         </listitem>
 927
 928         <listitem>
 929           <para>A new flag, <literal>-H</literal>, has been added,
 930             which is used to pass the host path to
 931             &man.bhyveload.8;.</para>
 932         </listitem>
 933
 934         <listitem>
 935           <para>Support for multiple disk and &man.tap.4; devices
 936             has been added.</para>
 937         </listitem>
 938
 939         <listitem>
 940           <para>The <literal>-I</literal> flag has been
 941             removed.</para>
 942         </listitem>
 943       </itemizedlist>
 944
 945       <para revision="269398">The &man.nfsd.8; server update to 4.1
 946         has merged from &os;-CURRENT.</para>
 947
 948       <para revision="269432" arch="ia64">The serial terminals
 949         <filename>ttyu0</filename> and <filename>ttyu1</filename> have
 950         been updated to <literal>onifconsole</literal> by default in
 951         &man.ttys.5;, which either can be the serial console,
 952         depending on the platform.</para>
 953
 954       <para revision="269800">The &man.ping6.8; utility has been
 955         updated to reset <literal>itimer</literal> when the maximum
 956         number of packets to send have been reached.  This prevents
 957         &man.ping6.8; from exiting when the interval in set to a small
 958         value and a low number of packets to send has been
 959         specified.</para>
 960
 961       <para revision="269805">The &man.jail.8; utility has been
 962         updated to support extra &man.ifconfig.8; arguments for the
 963         <literal>ip4.addr</literal> and <literal>ip6.addr</literal>
 964         parameters.  This change allows &man.carp.4; interfaces to
 965         be used within the &man.jail.8;.</para>
 966
 967       <para revision="269946">Support for generating and compiling
 968         <acronym>USDT</acronym> <application>DTrace</application>
 969         probes has been improved.  <application>DTrace</application>
 970         <acronym>USDT</acronym> files are now handled similar to
 971         &man.lex.1; and &man.yacc.1; files, meaning support for
 972         handling <application>D</application> files as part of the
 973         build process is built into the <literal>SRCS</literal>
 974         &man.make.1; environment variable.</para>
 975
 976       <para revision="269968">The &man.iscsictl.8; utility has been
 977         updated to include a new flag, <literal>-M</literal>, which
 978         allows modifying the <acronym>iSCSI</acronym> session
 979         parameters without requiring the session to be removed and
 980         added back.</para>
 981
 982       <para revision="270043">The &man.mount.nfs.8; utility has been
 983         updated to support specifying the NFS version as
 984         a <literal>key=<replaceable>value</replaceable></literal> pair
 985         argument to the <literal>-o</literal> flag.  For example, to
 986         specify NFS version 4, the syntax to use is
 987         <literal>-o&nbsp;vers=4</literal>.</para>
 988
 989       <para revision="270401">Support for the <quote>account</quote>
 990         facility has been added to the &man.pam.group.8;
 991         module.</para>
 992
 993       <sect3 xml:id="rc-scripts">
 994         <title><filename>/etc/rc.d</filename> Scripts</title>
 995
 996         <para revision="264438">The <filename>network.subr</filename>
 997           &man.rc.8; script has been updated to loosen the requirement
 998           of listing network aliases in numeric order.  Previously,
 999           a network alias of
1000           <literal>_alias<replaceable>2</replaceable></literal>
1001           would not be created if
1002           <literal>_alias<replaceable>1</replaceable></literal> was
1003           not defined.</para>
1004
1005         <para revision="268098">The &man.service.8; utility has been
1006           updated to check that the &man.rc.d.8; directory exists
1007           before traversing the directory.</para>
1008       </sect3>
1009     </sect2>
1010
1011     <sect2 xml:id="contrib">
1012       <title>Contributed Software</title>
1013
1014       <para revision="263285">The &man.xz.1; utility has been updated
1015         to a post-5.0.5 snapshot.</para>
1016
1017       <para revision="264377"><application>OpenSSH</application> has
1018         been updated to version 6.6p1.</para>
1019
1020       <para revision="264911">The &man.nc.1; utility has been updated
1021         to match the version in OpenBSD 5.5.</para>
1022
1023       <para revision="266692"><application>Sendmail</application>
1024         has been updated to 8.14.9.</para>
1025
1026       <para revision="267477">The timezone database has been updated
1027         to version tzdata2014e.</para>
1028
1029       <para revision="268515">The &man.file.1; utility and
1030         &man.libmagic.3; library have been updated to 5.19.</para>
1031
1032       <para revision="268899">The &man.byacc.1; parser has been
1033         updated to version 20140422.</para>
1034
1035       <para revision="269024" contrib="sponsor"
1036         sponsor="&darpa_afrl;">The &man.lldb.1; debugging library has
1037         been updated to the r202189 snapshot.</para>
1038
1039       <para revision="269257">The &man.unbound.8; caching resolver and
1040         <literal>ldns</literal> have been updated to version
1041         1.4.22.</para>
1042
1043       <para revision="269686"><application>OpenSSL</application> has
1044         been updated to version 1.0.1i.</para>
1045
1046       <para revision="269847">The <quote>lite</quote> version of
1047         <application>Subversion</application> included in the
1048         &os;&nbsp;base system and its dependencies have been
1049         updated:</para>
1050
1051       <itemizedlist>
1052         <listitem>
1053           <para><application>apr</application> has been
1054             updated to version 1.5.1.</para>
1055         </listitem>
1056
1057         <listitem>
1058           <para><application>apr-util</application> has been
1059             updated to version 1.5.3.</para>
1060         </listitem>
1061
1062         <listitem>
1063           <para><application>serf</application> has been
1064             updated to version 1.3.7.</para>
1065         </listitem>
1066
1067         <listitem>
1068           <para><application>svnlite</application> has been
1069             updated to version 1.8.10.</para>
1070         </listitem>
1071       </itemizedlist>
1072
1073       <para revision="270026">The &man.nvi.1; editor has been
1074         update to version 2.1.2-c80f493b038.</para>
1075
1076       <para revision="270031">The &man.fparseln.3; library has
1077         been updated to version 1.7.</para>
1078
1079       <para revision="270415">The <application>lukemftpd</application>
1080         <acronym>FTP</acronym> server has been removed from the
1081         &os;&nbsp;base system.</para>
1082     </sect2>
1083
1084     <sect2 xml:id="ports">
1085       <title>Ports/Packages Collection Infrastructure</title>
1086
1087       <para>&nbsp;</para>
1088
1089     </sect2>
1090
1091     <sect2 xml:id="releng">
1092       <title>Release Engineering and Integration</title>
1093
1094       <para revision="263028">The &man.services.mkdb.8; utility has
1095         been updated to include endianness awareness, allowing the
1096         <filename>services.db</filename> database to be created as
1097         part of the release build, regardless of native- or
1098         cross-built releases.</para>
1099     </sect2>
1100
1101     <sect2 xml:id="doc">
1102       <title>Documentation</title>
1103
1104       <para>&nbsp;</para>
1105
1106     </sect2>
1107   </sect1>
1108
1109   <sect1 xml:id="upgrade">
1110     <title>Upgrading from Previous Releases of &os;</title>
1111
1112     <para arch="amd64,i386">Binary upgrades between RELEASE versions
1113       (and snapshots of the various security branches) are supported
1114       using the &man.freebsd-update.8; utility.  The binary upgrade
1115       procedure will update unmodified userland utilities, as well as
1116       unmodified GENERIC or SMP kernels distributed as a part of an
1117       official &os; release.  The &man.freebsd-update.8; utility
1118       requires that the host being upgraded have Internet
1119       connectivity.</para>
1120
1121     <para>Source-based upgrades (those based on recompiling the &os;
1122       base system from source code) from previous versions are
1123       supported, according to the instructions in
1124       <filename>/usr/src/UPDATING</filename>.</para>
1125
1126     <important>
1127       <para>Upgrading &os; should only be attempted after
1128         backing up <emphasis>all</emphasis> data and configuration
1129         files.</para>
1130     </important>
1131   </sect1>
1132 </article>