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
  21   <info>
  22     <title>&os; &release.current; Release Notes</title>
  23
  24     <author>
  25       <orgname>The &os; Project</orgname>
  26     </author>
  27
  28     <pubdate>$FreeBSD$</pubdate>
  29
  30     <copyright>
  31       <year>2017</year>
  32       <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
  33         Project</holder>
  34     </copyright>
  35
  36     <legalnotice xml:id="trademarks" role="trademarks">
  37       &tm-attrib.freebsd;
  38       &tm-attrib.ibm;
  39       &tm-attrib.ieee;
  40       &tm-attrib.intel;
  41       &tm-attrib.sparc;
  42       &tm-attrib.general;
  43     </legalnotice>
  44
  45     <abstract>
  46       <para>The release notes for &os; &release.current; contain
  47         a summary of the changes made to the &os; base system on the
  48         &release.branch; development line.  This document lists
  49         applicable security advisories that were issued since the last
  50         release, as well as significant changes to the &os; kernel and
  51         userland.  Some brief remarks on upgrading are also
  52         presented.</para>
  53     </abstract>
  54   </info>
  55
  56   <sect1 xml:id="intro">
  57     <title>Introduction</title>
  58
  59     <para>This document contains the release notes for &os;
  60       &release.current;.  It describes recently added, changed, or
  61       deleted features of &os;.  It also provides some notes on
  62       upgrading from previous versions of &os;.</para>
  63
  64     <para releasetype="current">The &release.type; distribution to
  65       which these release notes apply represents the latest point
  66       along the &release.branch; development branch since
  67       &release.branch; was created.  Information regarding pre-built,
  68       binary &release.type; distributions along this branch can be
  69       found at <uri
  70         xlink:href="&release.url;">&release.url;</uri>.</para>
  71
  72     <para releasetype="snapshot">The &release.type; distribution to
  73       which these release notes apply represents a point along the
  74       &release.branch; development branch between &release.prev; and
  75       the future &release.next;.  Information regarding pre-built,
  76       binary &release.type; distributions along this branch can be
  77       found at <uri
  78         xlink:href="&release.url;">&release.url;</uri>.</para>
  79
  80     <para releasetype="release">This distribution of &os;
  81       &release.current; is a &release.type; distribution.  It can be
  82       found at <uri xlink:href="&release.url;">&release.url;</uri> or
  83       any of its mirrors.  More information on obtaining this (or
  84       other) &release.type; distributions of &os; can be found in the
  85       <link
  86         xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
  87           &os;</quote> appendix</link> to the <link
  88         xlink:href="&url.books.handbook;/">&os;
  89         Handbook</link>.</para>
  90
  91     <para>All users are encouraged to consult the release errata
  92       before installing &os;.  The errata document is updated with
  93       <quote>late-breaking</quote> information discovered late in the
  94       release cycle or after the release.  Typically, it contains
  95       information on known bugs, security advisories, and corrections
  96       to documentation.  An up-to-date copy of the errata for &os;
  97       &release.current; can be found on the &os; Web site.</para>
  98
  99     <para>This document describes the most user-visible new or changed
 100       features in &os; since &release.prev;.</para>
 101
 102     <para>Typical release note items document recent security
 103       advisories issued after &release.prev;, new drivers or hardware
 104       support, new commands or options, major bug fixes, or
 105       contributed software upgrades.  They may also list changes to
 106       major ports/packages or release engineering practices.  Clearly
 107       the release notes cannot list every single change made to &os;
 108       between releases; this document focuses primarily on security
 109       advisories, user-visible changes, and major architectural
 110       improvements.</para>
 111   </sect1>
 112
 113   <sect1 xml:id="upgrade">
 114     <title>Upgrading from Previous Releases of &os;</title>
 115
 116     <para arch="amd64,i386">Binary upgrades between RELEASE versions
 117       (and snapshots of the various security branches) are supported
 118       using the &man.freebsd-update.8; utility.  The binary upgrade
 119       procedure will update unmodified userland utilities, as well as
 120       unmodified <filename>GENERIC</filename> kernel distributed as
 121       a part of an official &os; release.  The &man.freebsd-update.8;
 122       utility requires that the host being upgraded have Internet
 123       connectivity.</para>
 124
 125     <para>Source-based upgrades (those based on recompiling the &os;
 126       base system from source code) from previous versions are
 127       supported, according to the instructions in
 128       <filename>/usr/src/UPDATING</filename>.</para>
 129
 130     <important>
 131       <para>Upgrading &os; should only be attempted after
 132         backing up <emphasis>all</emphasis> data and configuration
 133         files.</para>
 134     </important>
 135   </sect1>
 136
 137   <sect1 xml:id="security-errata">
 138     <title>Security and Errata</title>
 139
 140     <para>This section lists the various Security Advisories and
 141       Errata Notices since &release.prev;.</para>
 142
 143     <sect2 xml:id="security">
 144       <title>Security Advisories</title>
 145
 146       &security;
 147     </sect2>
 148
 149     <sect2 xml:id="errata">
 150       <title>Errata Notices</title>
 151
 152       &errata;
 153     </sect2>
 154   </sect1>
 155
 156   <sect1 xml:id="userland">
 157     <title>Userland</title>
 158
 159     <para>This section covers changes and additions to userland
 160       applications, contributed software, and system utilities.</para>
 161
 162     <sect2 xml:id="userland-config">
 163       <title>Userland Configuration Changes</title>
 164
 165       <para revision="313206">The &man.inetd.8; utility is now built
 166         without <literal>libwrap</literal> support when
 167         <literal>WITHOUT_TCP_WRAPPERS</literal> is set in
 168         &man.src.conf.5;.</para>
 169
 170       <para revision="316046">The &man.libthr.3; library and related
 171         files are now evaluated and removed by the
 172         <literal>delete-old-libs</literal> target when upgrading the
 173         system if <literal>WITHOUT_LIBTHR</literal> is
 174         set in &man.src.conf.5;.</para>
 175
 176       <para revision="319243">The
 177         <literal>WITH_RPCBIND_WARMSTART_SUPPORT</literal>
 178         &man.src.conf.5; knob has been added, which when enabled
 179         allows building &man.rpcbind.8; with
 180         <literal>warmstart</literal> support.</para>
 181     </sect2>
 182
 183     <sect2 xml:id="userland-programs">
 184       <title>Userland Application Changes</title>
 185
 186       <para revision="298427">The &man.truss.1; utility has been
 187         updated to include the <literal>-H</literal> flag, which logs
 188         the thread ID of a thread invoking a system call.</para>
 189
 190       <para revision="308915">The &man.zfsbootcfg.8; utility has been
 191         added, providing one-time &man.boot.config.5;-style options
 192         for &man.zfsboot.8;.</para>
 193
 194       <para revision="319390">The &man.cxgbetool.8; utility has been
 195         added, providing command-line access to features and debugging
 196         facilities of &man.cxgbe.4; devices.</para>
 197
 198       <para revision="321242">The &man.cron.8; utility has been
 199         updated to add support for including files within <filename
 200           class="directory">/etc/cron.d</filename> and <filename
 201           class="directory">/usr/local/etc/cron.d</filename> by
 202         default.</para>
 203
 204       <para revision="321234">The &man.syslogd.8; utility has been
 205         updated to add the <literal>include</literal> keyword which
 206         allows specifying a directory containing configuration files
 207         to be included in addition to &man.syslog.conf.5;.  The
 208         default &man.syslog.conf.5; has been updated to include
 209         <filename class="directory">/etc/syslog.d</filename> and
 210         <filename class="directory">/usr/local/etc/syslog.d</filename>
 211         by default.</para>
 212
 213       <para revision="321263">The &man.newsyslog.8; utility has been
 214         updated to support logging to &man.syslogd.8; in a format
 215         compliant with RFC5424.  For more details, see the description
 216         for the <literal>T</literal> flag in
 217         &man.newsyslog.conf.5;.</para>
 218
 219       <para revision="321216">The &man.savecore.8; utility has been
 220         updated to use <acronym>KiB</acronym> when outputting
 221         information regarding total space, free space, etc.</para>
 222     </sect2>
 223
 224     <sect2 xml:id="userland-contrib">
 225       <title>Contributed Software</title>
 226
 227       <para revision="309512"><application>Subversion</application>
 228         has been updated to version 1.9.5.</para>
 229
 230       <para revision="309848">&man.file.1; has been updated to version
 231         5.29.</para>
 232
 233       <para revision="310490">The &man.amd.8; utility has been updated
 234         to version 6.2.</para>
 235
 236       <para revision="312516">&man.xz.1; has been updated to version
 237         5.2.3.</para>
 238
 239       <para revision="313796">&man.zlib.3; has been updated to version
 240         1.2.11.</para>
 241
 242       <para revision="316069">&man.ntpd.8; has been updated to version
 243         4.2.8p10.</para>
 244
 245       <para revision="316350">Timezone data files have been updated to
 246         version 2017b.</para>
 247
 248       <para revision="316958">&man.tcsh.1; has been updated to version
 249         6.20.00.</para>
 250
 251       <para revision="321304">&man.libarchive.3; has been updated to
 252         version 3.3.2.</para>
 253     </sect2>
 254
 255     <sect2 xml:id="userland-installer">
 256       <title>Installation and Configuration Tools</title>
 257
 258       <para>&nbsp;</para>
 259     </sect2>
 260
 261     <sect2 xml:id="userland-rc">
 262       <title><filename class="directory">/etc/rc.d</filename>
 263         Scripts</title>
 264
 265       <para>&nbsp;</para>
 266     </sect2>
 267
 268     <sect2 xml:id="userland-periodic">
 269       <title><filename class="directory">/etc/periodic</filename>
 270         Scripts</title>
 271
 272       <para>&nbsp;</para>
 273     </sect2>
 274
 275     <sect2 xml:id="userland-libraries">
 276       <title>Runtime Libraries and API</title>
 277
 278       <para revision="316040">The &man.kvm.close.3; function has been
 279         updated to return the accumulated error from previous
 280         &man.close.2; calls.</para>
 281     </sect2>
 282
 283     <sect2 xml:id="userland-abi">
 284       <title>ABI Compatibility</title>
 285
 286       <para revision="309258">The type <literal>max_align_t</literal>
 287         is now defined for C11 compliance.</para>
 288     </sect2>
 289
 290     <sect2 xml:id="userland-debug">
 291       <title>Userland Debugging</title>
 292
 293       <para revision="304017">&man.ptrace.2; now supports events for
 294         thread creation and destruction, permitting more reliable
 295         debugging of threaded processes.</para>
 296
 297       <para revision="304499">&man.ptrace.2; now supports events for
 298         &man.vfork.2;, permitting reliable debugging across
 299         &man.vfork.2; invocations.</para>
 300
 301       <para revision="306786">Process core dumps now include the
 302         process ID (<acronym>PID</acronym>) and command line
 303         arguments.</para>
 304     </sect2>
 305   </sect1>
 306
 307   <sect1 xml:id="kernel">
 308     <title>Kernel</title>
 309
 310     <para>This section covers changes to kernel configurations, system
 311       tuning, and system control parameters that are not otherwise
 312       categorized.</para>
 313
 314     <sect2 xml:id="kernel-bugfix">
 315       <title>Kernel Bug Fixes</title>
 316
 317       <para revision="317434">The &man.ipf.4; packet filter has been
 318         updated to prevent <literal>keep state</literal> from
 319         incorrectly implying <literal>keep frags</literal>, matching
 320         the behavior documented in &man.ipf.5;.</para>
 321     </sect2>
 322
 323     <sect2 xml:id="kernel-config">
 324       <title>Kernel Configuration</title>
 325
 326       <para>&nbsp;</para>
 327     </sect2>
 328
 329     <sect2 xml:id="kernel-sysctl">
 330       <title>System Tuning and Controls</title>
 331
 332       <para></para>
 333     </sect2>
 334   </sect1>
 335
 336   <sect1 xml:id="drivers">
 337     <title>Devices and Drivers</title>
 338
 339     <para>This section covers changes and additions to devices and
 340       device drivers since &release.prev;.</para>
 341
 342     <sect2 xml:id="drivers-device">
 343       <title>Device Drivers</title>
 344
 345       <para revision="306533" contrib="sponsor"
 346         sponsor="&chelsio;">&man.devctl.8; now supports a &quot;clear
 347         driver&quot; command as a complement to &quot;set
 348         driver&quot;.</para>
 349     </sect2>
 350
 351     <sect2 xml:id="drivers-storage">
 352       <title>Storage Drivers</title>
 353
 354       <para revision="319436">The &man.mpr.4; driver has been updated
 355         to support tri-mode
 356         (<acronym>SAS</acronym>/<acronym>SATA</acronym>/<acronym>PCIe</acronym>)
 357         Broadcom&reg; storage adapters.</para>
 358     </sect2>
 359
 360     <sect2 xml:id="drivers-network">
 361       <title>Network Drivers</title>
 362
 363       <para revision="309447" contrib="sponsor"
 364         sponsor="&chelsio;">The &man.cxgbev.4; driver has been added,
 365         providing support for Virtual Function devices
 366         (<acronym>VFs</acronym>) on Chelsio T4 and T5 adapters.</para>
 367
 368       <para revision="309560" contrib="sponsor"
 369         sponsor="&chelsio;">The &man.cxgbe.4; driver has been updated
 370         to provide support for Virtual Function devices
 371         (<acronym>VFs</acronym>) on Chelsio T6 adapters.</para>
 372
 373       <para revision="309560" contrib="sponsor"
 374         sponsor="&chelsio;">The &man.cxgbe.4; driver now supports
 375         devices using T6-based adapters which support 10, 25, 40, and
 376         100 Gbps.</para>
 377
 378       <para revision="312359">The &man.alc.4; driver has been updated
 379         to provide support for Atheros&reg; Killer&nbsp;E2400&trade;
 380         Gigabit ethernet cards.</para>
 381
 382       <para revision="314019" contrib="sponsor" sponsor="&ms;">The
 383         &man.alc.4; driver has been updated to provide support for
 384         Atheros&reg; Killer&nbsp;E2500&trade; Gigabit ethernet
 385         cards.</para>
 386
 387       <para revision="316485">The &man.qlnxe.4; driver has been added,
 388         providing support for Cavium&reg; Qlogic&trade; 45000 Series
 389         adapters.</para>
 390
 391       <para revision="319270" contrib="sponsor"
 392         sponsor="&chelsio;">The &man.cxgbe.4; driver has been updated
 393         to firmware version 1.16.45.0 for T4, T5, and T6 cards.</para>
 394     </sect2>
 395   </sect1>
 396
 397   <sect1 xml:id="hardware">
 398     <title>Hardware Support</title>
 399
 400     <para>This section covers general hardware support for physical
 401       machines, hypervisors, and virtualization environments, as well
 402       as hardware changes and updates that do not otherwise fit in
 403       other sections of this document.</para>
 404
 405     <sect2 xml:id="hardware-support">
 406       <title>Hardware Support</title>
 407
 408       <para>&nbsp;</para>
 409     </sect2>
 410
 411     <sect2 xml:id="hardware-virtualization">
 412       <title>Virtualization Support</title>
 413
 414       <para revision="306520" contrib="sponsor"
 415         sponsor="&chelsio;"><acronym>PCI</acronym> passthrough with
 416         &man.bhyve.4; resets functions via <acronym>FLR</acronym> when
 417         a virtual machine is started and stopped.</para>
 418
 419       <para revision="306472" contrib="sponsor"
 420         sponsor="&chelsio;"><acronym>PCI</acronym> passthrough with
 421         &man.bhyve.4; supports more dynamic configurations permitting
 422         devices to be marked for passthrough or host use at
 423         runtime.</para>
 424     </sect2>
 425
 426     <sect2 xml:id="hardware-arm">
 427       <title>ARM Support</title>
 428
 429       <para>&nbsp;</para>
 430     </sect2>
 431   </sect1>
 432
 433   <sect1 xml:id="storage">
 434     <title>Storage</title>
 435
 436     <para>This section covers changes and additions to file systems
 437       and other storage subsystems, both local and networked.</para>
 438
 439     <sect2 xml:id="storage-general">
 440       <title>General Storage</title>
 441
 442       <para>&nbsp;</para>
 443     </sect2>
 444
 445     <sect2 xml:id="storage-net">
 446       <title>Networked Storage</title>
 447
 448       <para revision="318675">The <acronym>NFS</acronym> client now
 449         properly handles <literal>NFS4ERR_BAD_SESSION</literal> errors
 450         received from an <acronym>NFS</acronym> server.  Additionally,
 451         the kernel <acronym>RPC</acronym> client has been updated to
 452         prevent creating new <acronym>TCP</acronym> connections when
 453         <literal>ERESTART</literal> is received from
 454         &man.sosend.9;.</para>
 455     </sect2>
 456
 457     <sect2 xml:id="storage-zfs">
 458       <title>ZFS</title>
 459
 460       <para></para>
 461     </sect2>
 462
 463     <sect2 xml:id="storage-geom">
 464       <title>&man.geom.4;</title>
 465
 466       <para>&nbsp;</para>
 467     </sect2>
 468   </sect1>
 469
 470   <sect1 xml:id="boot">
 471     <title>Boot Loader Changes</title>
 472
 473     <para>This section covers the boot loader, boot menu, and other
 474       boot-related changes.</para>
 475
 476     <sect2 xml:id="boot-loader">
 477       <title>Boot Loader Changes</title>
 478
 479       <para>&nbsp;</para>
 480     </sect2>
 481
 482     <sect2 xml:id="boot-menu">
 483       <title>Boot Menu Changes</title>
 484
 485       <para>&nbsp;</para>
 486     </sect2>
 487   </sect1>
 488
 489   <sect1 xml:id="network">
 490     <title>Networking</title>
 491
 492     <para>This section describes changes that affect networking in
 493       &os;.</para>
 494
 495     <sect2 xml:id="network-general">
 496       <title>General Networking Changes</title>
 497
 498       <para revision="313558" contrib="sponsor"
 499         sponsor="&dellemc;">The network stack has been modified to fix
 500         incorrect or invalid <acronym>IP</acronym> addresses if
 501         multiple threads emit a <acronym>UDP</acronym>
 502         <literal>log_in_vain</literal> message concurrently.</para>
 503
 504       <para revision="317375" contrib="sponsor"
 505         sponsor="&multiplay;">The <acronym>TCP</acronym> stack has
 506         been changed to use the estimated <acronym>RTT</acronym>
 507         instead of timestamps for receive buffer auto resizing.</para>
 508     </sect2>
 509
 510     <sect2 xml:id="network-protocols">
 511       <title>Network Protocols</title>
 512
 513       <para revision="309340" contrib="sponsor"
 514         sponsor="&dellemc;">Support for <acronym>GARP</acronym>
 515         (gratuitous <acronym>ARP</acronym>) retransmit has been added.
 516         A new &man.sysctl.8;,
 517         <literal>net.link.ether.inet.garp_rexmit_count</literal>, has
 518         been added, which sets the maximum number of retransmissions
 519         when set to a non-zero value.</para>
 520     </sect2>
 521   </sect1>
 522
 523   <sect1 xml:id="ports">
 524     <title>Ports Collection and Package Infrastructure</title>
 525
 526     <para>This section covers changes to the &os;&nbsp;Ports
 527       Collection, package infrastructure, and package maintenance and
 528       installation tools.</para>
 529
 530     <sect2 xml:id="ports-infrastructure">
 531       <title>Infrastructure Changes</title>
 532
 533       <para>&nbsp;</para>
 534     </sect2>
 535
 536     <sect2 xml:id="ports-packages ">
 537       <title>Packaging Changes</title>
 538
 539       <para>&nbsp;</para>
 540     </sect2>
 541   </sect1>
 542
 543   <sect1 xml:id="doc">
 544     <title>Documentation</title>
 545
 546     <para>This section covers changes to the &os;&nbsp;Documentation
 547       Project sources and toolchain.</para>
 548
 549     <sect2 xml:id="doc-sources">
 550       <title>Documentation Source Changes</title>
 551
 552       <para>&nbsp;</para>
 553     </sect2>
 554
 555     <sect2 xml:id="doc-toolchain">
 556       <title>Documentation Toolchain Changes</title>
 557
 558       <para>&nbsp;</para>
 559     </sect2>
 560   </sect1>
 561
 562   <sect1 xml:id="releng">
 563     <title>Release Engineering and Integration</title>
 564
 565     <para>This section convers changes that are specific to the
 566       &os;&nbsp;Release Engineering processes.</para>
 567
 568     <sect2 xml:id="releng-changes">
 569       <title>Integration Changes</title>
 570
 571       <para>&nbsp;</para>
 572     </sect2>
 573   </sect1>
 574 </article>