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