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     </sect2>
 219
 220     <sect2 xml:id="userland-contrib">
 221       <title>Contributed Software</title>
 222
 223       <para revision="309512"><application>Subversion</application>
 224         has been updated to version 1.9.5.</para>
 225
 226       <para revision="309848">&man.file.1; has been updated to version
 227         5.29.</para>
 228
 229       <para revision="310490">The &man.amd.8; utility has been updated
 230         to version 6.2.</para>
 231
 232       <para revision="312516">&man.xz.1; has been updated to version
 233         5.2.3.</para>
 234
 235       <para revision="313796">&man.zlib.3; has been updated to version
 236         1.2.11.</para>
 237
 238       <para revision="316069">&man.ntpd.8; has been updated to version
 239         4.2.8p10.</para>
 240
 241       <para revision="316350">Timezone data files have been updated to
 242         version 2017b.</para>
 243
 244       <para revision="316958">&man.tcsh.1; has been updated to version
 245         6.20.00.</para>
 246
 247       <para revision="321304">&man.libarchive.3; has been updated to
 248         version 3.3.2.</para>
 249     </sect2>
 250
 251     <sect2 xml:id="userland-installer">
 252       <title>Installation and Configuration Tools</title>
 253
 254       <para>&nbsp;</para>
 255     </sect2>
 256
 257     <sect2 xml:id="userland-rc">
 258       <title><filename class="directory">/etc/rc.d</filename>
 259         Scripts</title>
 260
 261       <para>&nbsp;</para>
 262     </sect2>
 263
 264     <sect2 xml:id="userland-periodic">
 265       <title><filename class="directory">/etc/periodic</filename>
 266         Scripts</title>
 267
 268       <para>&nbsp;</para>
 269     </sect2>
 270
 271     <sect2 xml:id="userland-libraries">
 272       <title>Runtime Libraries and API</title>
 273
 274       <para revision="316040">The &man.kvm.close.3; function has been
 275         updated to return the accumulated error from previous
 276         &man.close.2; calls.</para>
 277     </sect2>
 278
 279     <sect2 xml:id="userland-abi">
 280       <title>ABI Compatibility</title>
 281
 282       <para revision="309258">The type <literal>max_align_t</literal>
 283         is now defined for C11 compliance.</para>
 284     </sect2>
 285
 286     <sect2 xml:id="userland-debug">
 287       <title>Userland Debugging</title>
 288
 289       <para revision="304017">&man.ptrace.2; now supports events for
 290         thread creation and destruction, permitting more reliable
 291         debugging of threaded processes.</para>
 292
 293       <para revision="304499">&man.ptrace.2; now supports events for
 294         &man.vfork.2;, permitting reliable debugging across
 295         &man.vfork.2; invocations.</para>
 296
 297       <para revision="306786">Process core dumps now include the
 298         process ID (<acronym>PID</acronym>) and command line
 299         arguments.</para>
 300     </sect2>
 301   </sect1>
 302
 303   <sect1 xml:id="kernel">
 304     <title>Kernel</title>
 305
 306     <para>This section covers changes to kernel configurations, system
 307       tuning, and system control parameters that are not otherwise
 308       categorized.</para>
 309
 310     <sect2 xml:id="kernel-bugfix">
 311       <title>Kernel Bug Fixes</title>
 312
 313       <para revision="317434">The &man.ipf.4; packet filter has been
 314         updated to prevent <literal>keep state</literal> from
 315         incorrectly implying <literal>keep frags</literal>, matching
 316         the behavior documented in &man.ipf.5;.</para>
 317     </sect2>
 318
 319     <sect2 xml:id="kernel-config">
 320       <title>Kernel Configuration</title>
 321
 322       <para>&nbsp;</para>
 323     </sect2>
 324
 325     <sect2 xml:id="kernel-sysctl">
 326       <title>System Tuning and Controls</title>
 327
 328       <para></para>
 329     </sect2>
 330   </sect1>
 331
 332   <sect1 xml:id="drivers">
 333     <title>Devices and Drivers</title>
 334
 335     <para>This section covers changes and additions to devices and
 336       device drivers since &release.prev;.</para>
 337
 338     <sect2 xml:id="drivers-device">
 339       <title>Device Drivers</title>
 340
 341       <para revision="306533" contrib="sponsor"
 342         sponsor="&chelsio;">&man.devctl.8; now supports a &quot;clear
 343         driver&quot; command as a complement to &quot;set
 344         driver&quot;.</para>
 345     </sect2>
 346
 347     <sect2 xml:id="drivers-storage">
 348       <title>Storage Drivers</title>
 349
 350       <para revision="319436">The &man.mpr.4; driver has been updated
 351         to support tri-mode
 352         (<acronym>SAS</acronym>/<acronym>SATA</acronym>/<acronym>PCIe</acronym>)
 353         Broadcom&reg; storage adapters.</para>
 354     </sect2>
 355
 356     <sect2 xml:id="drivers-network">
 357       <title>Network Drivers</title>
 358
 359       <para revision="309447" contrib="sponsor"
 360         sponsor="&chelsio;">The &man.cxgbev.4; driver has been added,
 361         providing support for Virtual Function devices
 362         (<acronym>VFs</acronym>) on Chelsio T4 and T5 adapters.</para>
 363
 364       <para revision="309560" contrib="sponsor"
 365         sponsor="&chelsio;">The &man.cxgbe.4; driver has been updated
 366         to provide support for Virtual Function devices
 367         (<acronym>VFs</acronym>) on Chelsio T6 adapters.</para>
 368
 369       <para revision="309560" contrib="sponsor"
 370         sponsor="&chelsio;">The &man.cxgbe.4; driver now supports
 371         devices using T6-based adapters which support 10, 25, 40, and
 372         100 Gbps.</para>
 373
 374       <para revision="312359">The &man.alc.4; driver has been updated
 375         to provide support for Atheros&reg; Killer&nbsp;E2400&trade;
 376         Gigabit ethernet cards.</para>
 377
 378       <para revision="314019" contrib="sponsor" sponsor="&ms;">The
 379         &man.alc.4; driver has been updated to provide support for
 380         Atheros&reg; Killer&nbsp;E2500&trade; Gigabit ethernet
 381         cards.</para>
 382
 383       <para revision="316485">The &man.qlnxe.4; driver has been added,
 384         providing support for Cavium&reg; Qlogic&trade; 45000 Series
 385         adapters.</para>
 386
 387       <para revision="319270" contrib="sponsor"
 388         sponsor="&chelsio;">The &man.cxgbe.4; driver has been updated
 389         to firmware version 1.16.45.0 for T4, T5, and T6 cards.</para>
 390     </sect2>
 391   </sect1>
 392
 393   <sect1 xml:id="hardware">
 394     <title>Hardware Support</title>
 395
 396     <para>This section covers general hardware support for physical
 397       machines, hypervisors, and virtualization environments, as well
 398       as hardware changes and updates that do not otherwise fit in
 399       other sections of this document.</para>
 400
 401     <sect2 xml:id="hardware-support">
 402       <title>Hardware Support</title>
 403
 404       <para>&nbsp;</para>
 405     </sect2>
 406
 407     <sect2 xml:id="hardware-virtualization">
 408       <title>Virtualization Support</title>
 409
 410       <para revision="306520" contrib="sponsor"
 411         sponsor="&chelsio;"><acronym>PCI</acronym> passthrough with
 412         &man.bhyve.4; resets functions via <acronym>FLR</acronym> when
 413         a virtual machine is started and stopped.</para>
 414
 415       <para revision="306472" contrib="sponsor"
 416         sponsor="&chelsio;"><acronym>PCI</acronym> passthrough with
 417         &man.bhyve.4; supports more dynamic configurations permitting
 418         devices to be marked for passthrough or host use at
 419         runtime.</para>
 420     </sect2>
 421
 422     <sect2 xml:id="hardware-arm">
 423       <title>ARM Support</title>
 424
 425       <para>&nbsp;</para>
 426     </sect2>
 427   </sect1>
 428
 429   <sect1 xml:id="storage">
 430     <title>Storage</title>
 431
 432     <para>This section covers changes and additions to file systems
 433       and other storage subsystems, both local and networked.</para>
 434
 435     <sect2 xml:id="storage-general">
 436       <title>General Storage</title>
 437
 438       <para>&nbsp;</para>
 439     </sect2>
 440
 441     <sect2 xml:id="storage-net">
 442       <title>Networked Storage</title>
 443
 444       <para revision="318675">The <acronym>NFS</acronym> client now
 445         properly handles <literal>NFS4ERR_BAD_SESSION</literal> errors
 446         received from an <acronym>NFS</acronym> server.  Additionally,
 447         the kernel <acronym>RPC</acronym> client has been updated to
 448         prevent creating new <acronym>TCP</acronym> connections when
 449         <literal>ERESTART</literal> is received from
 450         &man.sosend.9;.</para>
 451     </sect2>
 452
 453     <sect2 xml:id="storage-zfs">
 454       <title>ZFS</title>
 455
 456       <para></para>
 457     </sect2>
 458
 459     <sect2 xml:id="storage-geom">
 460       <title>&man.geom.4;</title>
 461
 462       <para>&nbsp;</para>
 463     </sect2>
 464   </sect1>
 465
 466   <sect1 xml:id="boot">
 467     <title>Boot Loader Changes</title>
 468
 469     <para>This section covers the boot loader, boot menu, and other
 470       boot-related changes.</para>
 471
 472     <sect2 xml:id="boot-loader">
 473       <title>Boot Loader Changes</title>
 474
 475       <para>&nbsp;</para>
 476     </sect2>
 477
 478     <sect2 xml:id="boot-menu">
 479       <title>Boot Menu Changes</title>
 480
 481       <para>&nbsp;</para>
 482     </sect2>
 483   </sect1>
 484
 485   <sect1 xml:id="network">
 486     <title>Networking</title>
 487
 488     <para>This section describes changes that affect networking in
 489       &os;.</para>
 490
 491     <sect2 xml:id="network-general">
 492       <title>General Networking Changes</title>
 493
 494       <para revision="313558" contrib="sponsor"
 495         sponsor="&dellemc;">The network stack has been modified to fix
 496         incorrect or invalid <acronym>IP</acronym> addresses if
 497         multiple threads emit a <acronym>UDP</acronym>
 498         <literal>log_in_vain</literal> message concurrently.</para>
 499
 500       <para revision="317375" contrib="sponsor"
 501         sponsor="&multiplay;">The <acronym>TCP</acronym> stack has
 502         been changed to use the estimated <acronym>RTT</acronym>
 503         instead of timestamps for receive buffer auto resizing.</para>
 504     </sect2>
 505
 506     <sect2 xml:id="network-protocols">
 507       <title>Network Protocols</title>
 508
 509       <para revision="309340" contrib="sponsor"
 510         sponsor="&dellemc;">Support for <acronym>GARP</acronym>
 511         (gratuitous <acronym>ARP</acronym>) retransmit has been added.
 512         A new &man.sysctl.8;,
 513         <literal>net.link.ether.inet.garp_rexmit_count</literal>, has
 514         been added, which sets the maximum number of retransmissions
 515         when set to a non-zero value.</para>
 516     </sect2>
 517   </sect1>
 518
 519   <sect1 xml:id="ports">
 520     <title>Ports Collection and Package Infrastructure</title>
 521
 522     <para>This section covers changes to the &os;&nbsp;Ports
 523       Collection, package infrastructure, and package maintenance and
 524       installation tools.</para>
 525
 526     <sect2 xml:id="ports-infrastructure">
 527       <title>Infrastructure Changes</title>
 528
 529       <para>&nbsp;</para>
 530     </sect2>
 531
 532     <sect2 xml:id="ports-packages ">
 533       <title>Packaging Changes</title>
 534
 535       <para>&nbsp;</para>
 536     </sect2>
 537   </sect1>
 538
 539   <sect1 xml:id="doc">
 540     <title>Documentation</title>
 541
 542     <para>This section covers changes to the &os;&nbsp;Documentation
 543       Project sources and toolchain.</para>
 544
 545     <sect2 xml:id="doc-sources">
 546       <title>Documentation Source Changes</title>
 547
 548       <para>&nbsp;</para>
 549     </sect2>
 550
 551     <sect2 xml:id="doc-toolchain">
 552       <title>Documentation Toolchain Changes</title>
 553
 554       <para>&nbsp;</para>
 555     </sect2>
 556   </sect1>
 557
 558   <sect1 xml:id="releng">
 559     <title>Release Engineering and Integration</title>
 560
 561     <para>This section convers changes that are specific to the
 562       &os;&nbsp;Release Engineering processes.</para>
 563
 564     <sect2 xml:id="releng-changes">
 565       <title>Integration Changes</title>
 566
 567       <para>&nbsp;</para>
 568     </sect2>
 569   </sect1>
 570 </article>