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     </sect2>
 353
 354     <sect2 xml:id="drivers-network">
 355       <title>Network Drivers</title>
 356
 357       <para revision="295524" contrib="sponsor"
 358         sponsor="&limelight;, &intelcorp;">The &man.ixgbe.4; driver
 359         has been updated to version 3.1.13-k.</para>
 360     </sect2>
 361   </sect1>
 362
 363   <sect1 xml:id="hardware">
 364     <title>Hardware Support</title>
 365
 366     <para>This section covers general hardware support for physical
 367       machines, hypervisors, and virtualization environments, as well
 368       as hardware changes and updates that do not otherwise fit in
 369       other sections of this document.</para>
 370
 371     <sect2 xml:id="hardware-support">
 372       <title>Hardware Support</title>
 373
 374       <para revision="293675">The &man.ismt.4; driver has been added,
 375         providing support for recent &intel; SMBus 2.0
 376         controllers.</para>
 377     </sect2>
 378
 379     <sect2 xml:id="hardware-virtualization">
 380       <title>Virtualization Support</title>
 381
 382       <para revision="287802">The &man.xen.4; driver has been updated
 383         to include support for <literal>blkif</literal> indirect
 384         segment I/O.</para>
 385     </sect2>
 386
 387     <sect2 xml:id="hardware-arm">
 388       <title>ARM Support</title>
 389
 390       <para>&nbsp;</para>
 391     </sect2>
 392   </sect1>
 393
 394   <sect1 xml:id="storage">
 395     <title>Storage</title>
 396
 397     <para>This section covers changes and additions to file systems
 398       and other storage subsystems, both local and networked.</para>
 399
 400     <sect2 xml:id="storage-general">
 401       <title>General Storage</title>
 402
 403       <para>&nbsp;</para>
 404     </sect2>
 405
 406     <sect2 xml:id="storage-net">
 407       <title>Networked Storage</title>
 408
 409       <para>&nbsp;</para>
 410     </sect2>
 411
 412     <sect2 xml:id="storage-zfs">
 413       <title>ZFS</title>
 414
 415       <para revision="287665" contrib="sponsor"
 416         sponsor="&clusterhq;">The &man.zfs.8; <literal>l2arc</literal>
 417         code has been updated to take <literal>ashift</literal> into
 418         account when gathering buffers to be written to the
 419         <literal>l2arc</literal> device.</para>
 420     </sect2>
 421
 422     <sect2 xml:id="storage-geom">
 423       <title>&man.geom.4;</title>
 424
 425       <para>&nbsp;</para>
 426     </sect2>
 427   </sect1>
 428
 429   <sect1 xml:id="boot">
 430     <title>Boot Loader Changes</title>
 431
 432     <para>This section covers the boot loader, boot menu, and other
 433       boot-related changes.</para>
 434
 435     <sect2 xml:id="boot-loader">
 436       <title>Boot Loader Changes</title>
 437
 438       <para revision="294445">Initial terminal emulation support has
 439         been added to <filename>loader.efi</filename> for
 440         <acronym>UEFI</acronym>-based systems.</para>
 441
 442       <para revision="294999" contrib="sponsor"
 443         sponsor="&multiplay;">Initial <acronym>ZFS</acronym> boot
 444         support has been added to the <acronym>EFI</acronym>
 445         implementation.</para>
 446
 447       <para revision="295475" contrib="sponsor"
 448         sponsor="&scaleengine;">The <acronym>UEFI</acronym> loader has
 449         been updated to support multiple <acronym>ZFS</acronym> boot
 450         environments, such as those provided by <filename
 451           role="package">sysutils/beadm</filename>.</para>
 452     </sect2>
 453
 454     <sect2 xml:id="boot-menu">
 455       <title>Boot Menu Changes</title>
 456
 457       <para revision="294446">The <acronym>UEFI</acronym> boot menu
 458         has been updated to enable the <quote>Beastie</quote> menu,
 459         similiar to the traditional &man.sc.4; boot menu.</para>
 460     </sect2>
 461   </sect1>
 462
 463   <sect1 xml:id="network">
 464     <title>Networking</title>
 465
 466     <para>This section describes changes that affect networking in
 467       &os;.</para>
 468
 469     <sect2 xml:id="network-protocols">
 470       <title>Network Protocols</title>
 471
 472       <para>&nbsp;</para>
 473     </sect2>
 474   </sect1>
 475
 476   <sect1 xml:id="ports">
 477     <title>Ports Collection and Package Infrastructure</title>
 478
 479     <para>This section covers changes to the &os;&nbsp;Ports
 480       Collection, package infrastructure, and package maintenance and
 481       installation tools.</para>
 482
 483     <sect2 xml:id="ports-infrastructure">
 484       <title>Infrastructure Changes</title>
 485
 486       <para>&nbsp;</para>
 487     </sect2>
 488
 489     <sect2 xml:id="ports-packages ">
 490       <title>Packaging Changes</title>
 491
 492       <para>&nbsp;</para>
 493     </sect2>
 494   </sect1>
 495
 496   <sect1 xml:id="doc">
 497     <title>Documentation</title>
 498
 499     <para>This section covers changes to the &os;&nbsp;Documentation
 500       Project sources and toolchain.</para>
 501
 502     <sect2 xml:id="doc-sources">
 503       <title>Documentation Source Changes</title>
 504
 505       <para>&nbsp;</para>
 506     </sect2>
 507
 508     <sect2 xml:id="doc-toolchain">
 509       <title>Documentation Toolchain Changes</title>
 510
 511       <para>&nbsp;</para>
 512     </sect2>
 513   </sect1>
 514
 515   <sect1 xml:id="releng">
 516     <title>Release Engineering and Integration</title>
 517
 518     <para>This section convers changes that are specific to the
 519       &os;&nbsp;Release Engineering processes.</para>
 520
 521     <sect2 xml:id="releng-changes">
 522       <title>Integration Changes</title>
 523
 524       <para>&nbsp;</para>
 525     </sect2>
 526   </sect1>
 527 </article>