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