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 <!ENTITY security SYSTEM "../../share/xml/security.xml">
  11 <!ENTITY errata SYSTEM "../../share/xml/errata.xml">
  12 ]>
  13 <article xmlns="http://docbook.org/ns/docbook"
  14   xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
  15   xml:id="top">
  16
  17   <info>
  18     <title>&os; &release.current; Release Notes</title>
  19
  20     <author>
  21       <orgname>The &os; Project</orgname>
  22     </author>
  23
  24     <pubdate>$FreeBSD$</pubdate>
  25
  26     <!-- First rev: 285831 -->
  27     <!-- Last rev: 284813 -->
  28
  29     <copyright>
  30       <year>2016</year>
  31       <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
  32         Project</holder>
  33     </copyright>
  34
  35     <legalnotice xml:id="trademarks" role="trademarks">
  36       &tm-attrib.freebsd;
  37       &tm-attrib.ibm;
  38       &tm-attrib.ieee;
  39       &tm-attrib.intel;
  40       &tm-attrib.sparc;
  41       &tm-attrib.general;
  42     </legalnotice>
  43
  44     <abstract>
  45       <para>The release notes for &os; &release.current; contain
  46         a summary of the changes made to the &os; base system on the
  47         &release.branch; development line.  This document lists
  48         applicable security advisories that were issued since the last
  49         release, as well as significant changes to the &os; kernel and
  50         userland.  Some brief remarks on upgrading are also
  51         presented.</para>
  52     </abstract>
  53   </info>
  54
  55   <sect1 xml:id="intro">
  56     <title>Introduction</title>
  57
  58     <para>This document contains the release notes for &os;
  59       &release.current;.  It describes recently added, changed, or
  60       deleted features of &os;.  It also provides some notes on
  61       upgrading from previous versions of &os;.</para>
  62
  63     <para releasetype="current">The &release.type; distribution to
  64       which these release notes apply represents the latest point
  65       along the &release.branch; development branch since
  66       &release.branch; was created.  Information regarding pre-built,
  67       binary &release.type; distributions along this branch can be
  68       found at <uri
  69         xlink:href="&release.url;">&release.url;</uri>.</para>
  70
  71     <para releasetype="snapshot">The &release.type; distribution to
  72       which these release notes apply represents a point along the
  73       &release.branch; development branch between &release.prev; and
  74       the future &release.next;.  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="release">This distribution of &os;
  80       &release.current; is a &release.type; distribution.  It can be
  81       found at <uri xlink:href="&release.url;">&release.url;</uri> or
  82       any of its mirrors.  More information on obtaining this (or
  83       other) &release.type; distributions of &os; can be found in the
  84       <link
  85         xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
  86           &os;</quote> appendix</link> to the <link
  87         xlink:href="&url.books.handbook;/">&os;
  88         Handbook</link>.</para>
  89
  90     <para>All users are encouraged to consult the release errata
  91       before installing &os;.  The errata document is updated with
  92       <quote>late-breaking</quote> information discovered late in the
  93       release cycle or after the release.  Typically, it contains
  94       information on known bugs, security advisories, and corrections
  95       to documentation.  An up-to-date copy of the errata for &os;
  96       &release.current; can be found on the &os; Web site.</para>
  97
  98     <para>This document describes the most user-visible new or changed
  99       features in &os; since &release.prev;.</para>
 100
 101     <para>Typical release note items document recent security
 102       advisories issued after &release.prev;, new drivers or hardware
 103       support, new commands or options, major bug fixes, or
 104       contributed software upgrades.  They may also list changes to
 105       major ports/packages or release engineering practices.  Clearly
 106       the release notes cannot list every single change made to &os;
 107       between releases; this document focuses primarily on security
 108       advisories, user-visible changes, and major architectural
 109       improvements.</para>
 110   </sect1>
 111
 112   <sect1 xml:id="upgrade">
 113     <title>Upgrading from Previous Releases of &os;</title>
 114
 115     <para arch="amd64,i386">Binary upgrades between RELEASE versions
 116       (and snapshots of the various security branches) are supported
 117       using the &man.freebsd-update.8; utility.  The binary upgrade
 118       procedure will update unmodified userland utilities, as well as
 119       unmodified <filename>GENERIC</filename> kernel distributed as
 120       a part of an official &os; release.  The &man.freebsd-update.8;
 121       utility requires that the host being upgraded have Internet
 122       connectivity.</para>
 123
 124     <para>Source-based upgrades (those based on recompiling the &os;
 125       base system from source code) from previous versions are
 126       supported, according to the instructions in
 127       <filename>/usr/src/UPDATING</filename>.</para>
 128
 129     <important>
 130       <para>Upgrading &os; should only be attempted after
 131         backing up <emphasis>all</emphasis> data and configuration
 132         files.</para>
 133     </important>
 134   </sect1>
 135
 136   <sect1 xml:id="security-errata">
 137     <title>Security and Errata</title>
 138
 139     <para>This section lists the various Security Advisories and
 140       Errata Notices since &release.prev;.</para>
 141
 142     <sect2 xml:id="security">
 143       <title>Security Advisories</title>
 144
 145       &security;
 146     </sect2>
 147
 148     <sect2 xml:id="errata">
 149       <title>Errata Notices</title>
 150
 151       &errata;
 152     </sect2>
 153   </sect1>
 154
 155   <sect1 xml:id="userland">
 156     <title>Userland</title>
 157
 158     <para>This section covers changes and additions to userland
 159       applications, contributed software, and system utilities.</para>
 160
 161     <sect2 xml:id="userland-config">
 162       <title>Userland Configuration Changes</title>
 163
 164       <para>&nbsp;</para>
 165     </sect2>
 166
 167     <sect2 xml:id="userland-programs">
 168       <title>Userland Application Changes</title>
 169
 170       <para revision="286064">The &man.jail.8; utility has been
 171         updated to include a new flag, <literal>-l</literal>, which
 172         ensures a clean environment in the target jail when used.
 173         Additionally, &man.jail.8; will run a shell within the target
 174         jail when run no commands are specified.</para>
 175
 176       <para revision="287122">The &man.mkimg.1; utility has been
 177         updated to include support for <literal>NTFS</literal>
 178         filesystems in both <acronym>MBR</acronym> and
 179         <acronym>GPT</acronym> partitioning schemes.</para>
 180
 181       <para revision="288202" contrib="sponsor" sponsor="&ff;">The
 182         &man.ar.1; utility now enables deterministic mode
 183         (<literal>-D</literal>) by default.  This behavior can be
 184         disabled by specifying the <literal>-U</literal> flag.</para>
 185
 186       <para revision="287746">The &man.pciconf.8; utility has been
 187         updated to use the PCI ID database from the <filename
 188           role="package">misc/pciids</filename> package, if present,
 189         falling back to the PCI ID database in the &os; base
 190         system.</para>
 191
 192       <para revision="288710" contrib="sponsor" sponsor="&gandi;">A
 193         new utility, &man.sesutil.8;, has been added, which is used
 194         to manage &man.ses.4; devices.</para>
 195
 196       <para revision="291774">The &man.cp.1; utility has been updated
 197         to include a new flag, <literal>-s</literal>, which creates
 198         a symbolic link to the specified source.</para>
 199
 200       <para revision="292231">Support for the
 201         <literal>-manage-gids</literal> has been added to
 202         &man.nfsd.8;.  This option can be enabled at boot time by
 203         adding <literal>nfs_server_managegids="YES"</literal> to
 204         &man.rc.conf.5;.</para>
 205
 206       <para revision="292462" contrib="sponsor"
 207         sponsor="&dellinc;">The resolver library has been updated to
 208         reload <filename>/etc/resolv.conf</filename> if the
 209         modification time has changed.</para>
 210
 211       <para revision="293744" contrib="sponsor" sponsor="&ff;">The
 212         initial implementation of <quote>reroot</quote> support has
 213         been added to the &man.reboot.8; utility, allowing the root
 214         filesystem to be mounted from a temporary source filesystem
 215         without requiring a full system reboot.</para>
 216     </sect2>
 217
 218     <sect2 xml:id="userland-contrib">
 219       <title>Contributed Software</title>
 220
 221       <para revision="286082">The &man.libarchive.3; library has been
 222         updated to properly skip a sparse file entry in a &man.tar.1;
 223         file, which would previously produce errors.</para>
 224
 225       <para revision="286751">Timezone data files have been updated to
 226         version 2015f.</para>
 227
 228       <para revision="290152">The &man.file.1; utility has been
 229         updated to version 5.25.</para>
 230
 231       <para revision="292588">The &man.xz.1; utility has been updated
 232         to version 5.2.2, which provides support for multi-threaded
 233         compression.</para>
 234
 235       <para revision="293650">The &man.ntpd.8; utility has been
 236         updated to version 4.2.8p5.</para>
 237
 238       <para revision="294190">The &man.unbound.8; utility has been
 239         updated to version 1.5.7.</para>
 240
 241       <para revision="294286">The &man.less.1; utility has been
 242         updated to version v481.</para>
 243
 244       <para revision="295690">The
 245         <literal>unbound-control-setup</literal> script has been
 246         removed from the base system.</para>
 247
 248       <para revision="295691">The &man.unbound.8; utility has been
 249         updated to enable the <literal>insecure-lan-zones</literal>
 250         option in preference of listing each <acronym>AS112</acronym>
 251         zone individually.</para>
 252
 253       <para revision="296317">The <application>OpenSSL</application>
 254         suite has been updated to version 1.0.1s.</para>
 255
 256       <para revision="296853">The <application>OpenSSH</application>
 257         suite has been updated to version 7.2p2.</para>
 258     </sect2>
 259
 260     <sect2 xml:id="userland-installer">
 261       <title>Installation and Configuration Tools</title>
 262
 263       <para revision="295264" contrib="sponsor"
 264         sponsor="&scaleengine;">The &man.bsdinstall.8; utility has
 265         been updated to support <acronym>ZFS</acronym> installation
 266         on <acronym>EFI</acronym>-based systems.</para>
 267     </sect2>
 268
 269     <sect2 xml:id="userland-rc">
 270       <title><filename class="directory">/etc/rc.d</filename>
 271         Scripts</title>
 272
 273       <para revision="294680">The <literal>netwait</literal>
 274         &man.rc.8; script has been updated to wait for network
 275         interfaces that attach late in the boot process, such as some
 276         <acronym>USB</acronym> network cards.</para>
 277     </sect2>
 278
 279     <sect2 xml:id="userland-periodic">
 280       <title><filename class="directory">/etc/periodic</filename>
 281         Scripts</title>
 282
 283       <para>&nbsp;</para>
 284     </sect2>
 285
 286     <sect2 xml:id="userland-libraries">
 287       <title>Runtime Libraries and API</title>
 288
 289       <para>&nbsp;</para>
 290     </sect2>
 291
 292     <sect2 xml:id="userland-abi">
 293       <title>ABI Compatibility</title>
 294
 295       <para>&nbsp;</para>
 296     </sect2>
 297   </sect1>
 298
 299   <sect1 xml:id="kernel">
 300     <title>Kernel</title>
 301
 302     <para>This section covers changes to kernel configurations, system
 303       tuning, and system control parameters that are not otherwise
 304       categorized.</para>
 305
 306     <sect2 xml:id="kernel-bugfix">
 307       <title>Kernel Bug Fixes</title>
 308
 309       <para revision="288167" contrib="sponsor"
 310         sponsor="&multiplay;">The &man.kqueue.2; system call has been
 311         updated to handle write events to files larger than 2
 312         gigabytes.</para>
 313     </sect2>
 314
 315     <sect2 xml:id="kernel-config">
 316       <title>Kernel Configuration</title>
 317
 318       <para>&nbsp;</para>
 319     </sect2>
 320
 321     <sect2 xml:id="kernel-sysctl">
 322       <title>System Tuning and Controls</title>
 323
 324       <para revision="287037">The &man.uart.4; driver has been
 325         updated to allow tuning pulses per second captured in the
 326         CTS line during runtime, whereas previously only the DCD line
 327         could be used without rebuilding the kernel.</para>
 328     </sect2>
 329   </sect1>
 330
 331   <sect1 xml:id="drivers">
 332     <title>Devices and Drivers</title>
 333
 334     <para>This section covers changes and additions to devices and
 335       device drivers since &release.prev;.</para>
 336
 337     <sect2 xml:id="drivers-device">
 338       <title>Device Drivers</title>
 339
 340       <para>&nbsp;</para>
 341     </sect2>
 342
 343     <sect2 xml:id="drivers-storage">
 344       <title>Storage Drivers</title>
 345
 346       <para revision="288732" contrib="sponsor" sponsor="&ix;">The
 347         <acronym>CTL</acronym> High Availability implementation has
 348         been rewritten.</para>
 349
 350       <para revision="288810">The &man.ctl.4; driver has been updated
 351         to support CD-ROM and removable devices.</para>
 352
 353       <para contrib="sponsor" sponsor="&ix;">The &man.isp.4; driver has
 354         been updated and improved: added support for 16Gbps FC cards,
 355         improved target mode support, completed Multi-ID (NPIV)
 356         functionality.</para>
 357     </sect2>
 358
 359     <sect2 xml:id="drivers-network">
 360       <title>Network Drivers</title>
 361
 362       <para revision="295524" contrib="sponsor"
 363         sponsor="&limelight;, &intelcorp;">The &man.ixgbe.4; driver
 364         has been updated to version 3.1.13-k.</para>
 365     </sect2>
 366   </sect1>
 367
 368   <sect1 xml:id="hardware">
 369     <title>Hardware Support</title>
 370
 371     <para>This section covers general hardware support for physical
 372       machines, hypervisors, and virtualization environments, as well
 373       as hardware changes and updates that do not otherwise fit in
 374       other sections of this document.</para>
 375
 376     <sect2 xml:id="hardware-support">
 377       <title>Hardware Support</title>
 378
 379       <para revision="293675">The &man.ismt.4; driver has been added,
 380         providing support for recent &intel; SMBus 2.0
 381         controllers.</para>
 382     </sect2>
 383
 384     <sect2 xml:id="hardware-virtualization">
 385       <title>Virtualization Support</title>
 386
 387       <para revision="287802">The &man.xen.4; driver has been updated
 388         to include support for <literal>blkif</literal> indirect
 389         segment I/O.</para>
 390     </sect2>
 391
 392     <sect2 xml:id="hardware-arm">
 393       <title>ARM Support</title>
 394
 395       <para>&nbsp;</para>
 396     </sect2>
 397   </sect1>
 398
 399   <sect1 xml:id="storage">
 400     <title>Storage</title>
 401
 402     <para>This section covers changes and additions to file systems
 403       and other storage subsystems, both local and networked.</para>
 404
 405     <sect2 xml:id="storage-general">
 406       <title>General Storage</title>
 407
 408       <para>&nbsp;</para>
 409     </sect2>
 410
 411     <sect2 xml:id="storage-net">
 412       <title>Networked Storage</title>
 413
 414       <para>&nbsp;</para>
 415     </sect2>
 416
 417     <sect2 xml:id="storage-zfs">
 418       <title>ZFS</title>
 419
 420       <para revision="287665" contrib="sponsor"
 421         sponsor="&clusterhq;">The &man.zfs.8; <literal>l2arc</literal>
 422         code has been updated to take <literal>ashift</literal> into
 423         account when gathering buffers to be written to the
 424         <literal>l2arc</literal> device.</para>
 425     </sect2>
 426
 427     <sect2 xml:id="storage-geom">
 428       <title>&man.geom.4;</title>
 429
 430       <para>&nbsp;</para>
 431     </sect2>
 432   </sect1>
 433
 434   <sect1 xml:id="boot">
 435     <title>Boot Loader Changes</title>
 436
 437     <para>This section covers the boot loader, boot menu, and other
 438       boot-related changes.</para>
 439
 440     <sect2 xml:id="boot-loader">
 441       <title>Boot Loader Changes</title>
 442
 443       <para revision="294445">Initial terminal emulation support has
 444         been added to <filename>loader.efi</filename> for
 445         <acronym>UEFI</acronym>-based systems.</para>
 446
 447       <para revision="294999" contrib="sponsor"
 448         sponsor="&multiplay;">Initial <acronym>ZFS</acronym> boot
 449         support has been added to the <acronym>EFI</acronym>
 450         implementation.</para>
 451
 452       <para revision="295475" contrib="sponsor"
 453         sponsor="&scaleengine;">The <acronym>UEFI</acronym> loader has
 454         been updated to support multiple <acronym>ZFS</acronym> boot
 455         environments, such as those provided by <filename
 456           role="package">sysutils/beadm</filename>.</para>
 457     </sect2>
 458
 459     <sect2 xml:id="boot-menu">
 460       <title>Boot Menu Changes</title>
 461
 462       <para revision="294446">The <acronym>UEFI</acronym> boot menu
 463         has been updated to enable the <quote>Beastie</quote> menu,
 464         similiar to the traditional &man.sc.4; boot menu.</para>
 465     </sect2>
 466   </sect1>
 467
 468   <sect1 xml:id="network">
 469     <title>Networking</title>
 470
 471     <para>This section describes changes that affect networking in
 472       &os;.</para>
 473
 474     <sect2 xml:id="network-protocols">
 475       <title>Network Protocols</title>
 476
 477       <para>&nbsp;</para>
 478     </sect2>
 479   </sect1>
 480
 481   <sect1 xml:id="ports">
 482     <title>Ports Collection and Package Infrastructure</title>
 483
 484     <para>This section covers changes to the &os;&nbsp;Ports
 485       Collection, package infrastructure, and package maintenance and
 486       installation tools.</para>
 487
 488     <sect2 xml:id="ports-infrastructure">
 489       <title>Infrastructure Changes</title>
 490
 491       <para>&nbsp;</para>
 492     </sect2>
 493
 494     <sect2 xml:id="ports-packages ">
 495       <title>Packaging Changes</title>
 496
 497       <para>&nbsp;</para>
 498     </sect2>
 499   </sect1>
 500
 501   <sect1 xml:id="doc">
 502     <title>Documentation</title>
 503
 504     <para>This section covers changes to the &os;&nbsp;Documentation
 505       Project sources and toolchain.</para>
 506
 507     <sect2 xml:id="doc-sources">
 508       <title>Documentation Source Changes</title>
 509
 510       <para>&nbsp;</para>
 511     </sect2>
 512
 513     <sect2 xml:id="doc-toolchain">
 514       <title>Documentation Toolchain Changes</title>
 515
 516       <para>&nbsp;</para>
 517     </sect2>
 518   </sect1>
 519
 520   <sect1 xml:id="releng">
 521     <title>Release Engineering and Integration</title>
 522
 523     <para>This section convers changes that are specific to the
 524       &os;&nbsp;Release Engineering processes.</para>
 525
 526     <sect2 xml:id="releng-changes">
 527       <title>Integration Changes</title>
 528
 529       <para>&nbsp;</para>
 530     </sect2>
 531   </sect1>
 532 </article>