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
  16   <info>
  17     <title>&os; &release.current; Release Notes</title>
  18
  19     <author>
  20       <orgname>The &os; Project</orgname>
  21     </author>
  22
  23     <pubdate>$FreeBSD$</pubdate>
  24
  25     <!-- Last rev: 288943 -->
  26
  27     <copyright>
  28       <year>2017</year>
  29       <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
  30         Project</holder>
  31     </copyright>
  32
  33     <legalnotice xml:id="trademarks" role="trademarks">
  34       &tm-attrib.freebsd;
  35       &tm-attrib.ibm;
  36       &tm-attrib.ieee;
  37       &tm-attrib.intel;
  38       &tm-attrib.sparc;
  39       &tm-attrib.general;
  40     </legalnotice>
  41
  42     <abstract>
  43       <para>The release notes for &os; &release.current; contain
  44         a summary of the changes made to the &os; base system on the
  45         &release.branch; development line.  This document lists
  46         applicable security advisories that were issued since the last
  47         release, as well as significant changes to the &os; kernel and
  48         userland.  Some brief remarks on upgrading are also
  49         presented.</para>
  50     </abstract>
  51   </info>
  52
  53   <sect1 xml:id="intro">
  54     <title>Introduction</title>
  55
  56     <para>This document contains the release notes for &os;
  57       &release.current;.  It describes recently added, changed, or
  58       deleted features of &os;.  It also provides some notes on
  59       upgrading from previous versions of &os;.</para>
  60
  61     <para releasetype="current">The &release.type; distribution to
  62       which these release notes apply represents the latest point
  63       along the &release.branch; development branch since
  64       &release.branch; was created.  Information regarding pre-built,
  65       binary &release.type; distributions along this branch can be
  66       found at <uri
  67         xlink:href="&release.url;">&release.url;</uri>.</para>
  68
  69     <para releasetype="snapshot">The &release.type; distribution to
  70       which these release notes apply represents a point along the
  71       &release.branch; development branch between &release.prev; and
  72       the future &release.next;.  Information regarding pre-built,
  73       binary &release.type; distributions along this branch can be
  74       found at <uri
  75         xlink:href="&release.url;">&release.url;</uri>.</para>
  76
  77     <para releasetype="release">This distribution of &os;
  78       &release.current; is a &release.type; distribution.  It can be
  79       found at <uri xlink:href="&release.url;">&release.url;</uri> or
  80       any of its mirrors.  More information on obtaining this (or
  81       other) &release.type; distributions of &os; can be found in the
  82       <link
  83         xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
  84           &os;</quote> appendix</link> to the <link
  85         xlink:href="&url.books.handbook;/">&os;
  86         Handbook</link>.</para>
  87
  88     <para>All users are encouraged to consult the release errata
  89       before installing &os;.  The errata document is updated with
  90       <quote>late-breaking</quote> information discovered late in the
  91       release cycle or after the release.  Typically, it contains
  92       information on known bugs, security advisories, and corrections
  93       to documentation.  An up-to-date copy of the errata for &os;
  94       &release.current; can be found on the &os; Web site.</para>
  95
  96     <para>This document describes the most user-visible new or changed
  97       features in &os; since &release.prev;.  In general, changes
  98       described here are unique to the &release.branch; branch unless
  99       specifically marked as &merged; features.</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 GENERIC kernels distributed as a part of an official
 120       &os; release.  The &man.freebsd-update.8; utility requires that
 121       the host being upgraded have Internet connectivity.</para>
 122
 123     <para>Source-based upgrades (those based on recompiling the &os;
 124       base system from source code) from previous versions are
 125       supported, according to the instructions in
 126       <filename>/usr/src/UPDATING</filename>.</para>
 127
 128     <important>
 129       <para>Upgrading &os; should only be attempted after backing up
 130         <emphasis>all</emphasis> data and configuration files.</para>
 131     </important>
 132   </sect1>
 133
 134   <sect1 xml:id="security-errata">
 135     <title>Security and Errata</title>
 136
 137     <para>This section lists the various Security Advisories and
 138       Errata Notices since &release.prev;.</para>
 139
 140     <sect2 xml:id="security">
 141       <title>Security Advisories</title>
 142
 143       &security;
 144     </sect2>
 145
 146     <sect2 xml:id="errata">
 147       <title>Errata Notices</title>
 148
 149       &errata;
 150     </sect2>
 151   </sect1>
 152
 153   <sect1 xml:id="userland">
 154     <title>Userland</title>
 155
 156     <para>This section covers changes and additions to userland
 157       applications, contributed software, and system utilities.</para>
 158
 159     <sect2 xml:id="userland-config">
 160       <title>Userland Configuration Changes</title>
 161
 162       <para>&nbsp;</para>
 163     </sect2>
 164
 165     <sect2 xml:id="userland-programs">
 166       <title>Userland Application Changes</title>
 167
 168       <para revision="321092">The &man.ln.1; utility has been updated
 169         to correct the behavior of the <literal>-F</literal> flag by
 170         unlinking an existing directory before creating a symbolic
 171         link.</para>
 172
 173       <para revision="321241">The &man.crontab.1; utility has been
 174         updated to include a new flag, <literal>-f</literal>, which
 175         forces &man.crontab.5; removal when <literal>-r</literal> is
 176         used non-interactively.</para>
 177
 178       <para revision="321262">The &man.newsyslog.8; utility has been
 179         updated to support <acronym>RFC</acronym>5424-compliant
 180         messages when rotating system logs.</para>
 181
 182       <para revision="321287" contrib="sponsor" sponsor="&gandi;">The
 183         &man.sesutil.8; utility has been updated to include
 184         &man.libxo.3; support in output.</para>
 185
 186       <para revision="321927">The &man.diskinfo.8; utility has been
 187         updated to include two new flags, <literal>-s</literal> which
 188         displays the disk identity (usually the serial number), and
 189         <literal>-p</literal> which displays the physical path to the
 190         disk in a storage controller.  The <literal>-s</literal> and
 191         <literal>-p</literal> flags are mutually exclusive, and cannot
 192         be used with any other flags.</para>
 193
 194       <para revision="321929">The &man.diskinfo.8; utility has also
 195         been updated to include device model when the
 196         <literal>-s</literal> flag is used.</para>
 197
 198       <para revision="322910">The &man.umount.8; utility has been
 199         updated to include a new flag, <literal>-N</literal>, which
 200         is used to forcefully unmount an <acronym>NFS</acronym>
 201         mounted filesystem.</para>
 202
 203       <para revision="322919">The &man.pw.8; utility has been updated
 204         to properly handle empty secondary group lists as an argument
 205         to the <literal>-G</literal> flag when using the
 206         <literal>usermod</literal> subcommand.</para>
 207
 208       <para revision="324270">The &man.ps.1; utility has been updated
 209         to reflect realtime and idle priorities in state flags.</para>
 210
 211       <para revision="324271">The &man.ps.1; utility has been updated
 212         to display if a process is running with &man.capsicum.4;
 213         capability mode, indicated by <literal>C</literal>.</para>
 214
 215       <para revision="324380">The &man.cpucontrol.8; utility has been
 216         updated to include a new flag, <literal>-n</literal>, that
 217         disables the default microcode update search path when
 218         used.</para>
 219
 220       <para revision="324674">The &man.fsck.ffs.8; utility has been
 221         updated to prevent a filesystem from being reported as
 222         modified when only the timestamp in the superblock is
 223         updated.</para>
 224
 225       <para revision="325003" contrib="sponsor"
 226         sponsor="&spectralogic;">The &man.diskinfo.8; utility has been
 227         updated to display disk rotation rate and if
 228         <acronym>TRIM</acronym>/<acronym>UNMAP</acronym> is supported
 229         by the disk.</para>
 230
 231       <para revision="326413">The &man.pfctl.8; utility has been
 232         updated to allow <literal>route-to</literal> to properly
 233         handle network interfaces with multiple <acronym>IP</acronym>
 234         addresses.</para>
 235
 236       <para revision="326778" contrib="sponsor"
 237         sponsor="&spectralogic;">The &man.camcontrol.8; utility has
 238         been updated to include <acronym>ZAC</acronym> (Zoned-device
 239         <acronym>ATA</acronym> command set) information when the
 240         <literal>identify</literal> subcommand is used.</para>
 241
 242       <para revision="326848">The &man.pw.8; utility has been updated
 243         to correct handling of account expiration periods.</para>
 244
 245       <para revision="327592">The &man.mdmfs.8; utility has been
 246         updated to support &man.tmpfs.5;.</para>
 247
 248       <para revision="327871">The &man.cpucontrol.8; utility has been
 249         updated to include a new flag, <literal>-e</literal>, which is
 250         used to re-evaluate reported <acronym>CPU</acronym> features
 251         after applying firmware updates.</para>
 252
 253       <note>
 254         <para>The &man.cpucontrol.8; <literal>-e</literal> flag should
 255           only be used after microcode update have been applied to all
 256           <acronym>CPU</acronym>s in the system, otherwise system
 257           instability may be experienced if processor features are not
 258           identical across the system.</para>
 259       </note>
 260
 261       <para revision="328140">The &man.df.1; utility has been updated
 262         to include the <literal>--si</literal> long option, which is
 263         an alias to <literal>-H</literal>.</para>
 264
 265       <para revision="328599">The &man.service.8; utility has been
 266         updated to include a new flag, <literal>-j</literal>, which is
 267         used to interact with services running within a &man.jail.8;.
 268         The argument to <literal>-j</literal> can be either the name
 269         or numeric jail <acronym>ID</acronym>.</para>
 270
 271       <para revision="328604" contrib="sponsor"
 272         sponsor="&dellemc;">The &man.fsck.ffs.8; utility has been
 273         updated to exit with a non-zero status when the filesystem is
 274         not repaired.</para>
 275
 276       <para revision="328668">The &man.nvmecontrol.8; utility has been
 277         updated to print the full 128 bit value for
 278         <acronym>SMART</acronym> data, instead of the hexidecimal
 279         value.</para>
 280
 281       <para revision="330692" contrib="sponsor"
 282         sponsor="&dellemc;">The &man.dhclient.8; utility has been
 283         updated to be more compliant with <acronym>RFC</acronym>2131
 284         by setting the source address field in the
 285         <acronym>IP</acronym> header to <literal>0</literal> when
 286         sending a <literal>DHCPREQUEST</literal> message to attempt to
 287         obtain a previously-assigned <literal>IP</literal>
 288         address.</para>
 289
 290       <para revision="330694" contrib="sponsor"
 291         sponsor="&dellemc;">The &man.pw.8; utility has been updated to
 292         allow the <literal>@</literal> and <literal>!</literal>
 293         characters in the <acronym>GECOS</acronym> field.</para>
 294
 295       <para revision="331471">The &man.ps.1; utility has been updated
 296         to include a <literal>jail</literal>, which when used will
 297         list the name of a &man.jail.8; instead of the numeric
 298         ID.</para>
 299
 300       <para revision="331586" contrib="sponsor"
 301         sponsor="&mellanox;">The &man.mlx5tool.8; utility has been
 302         added, which is used to manage Connect-X&nbsp;4 and
 303         Connect-X&nbsp;5 devices supported by &man.mlx5io.4;.</para>
 304
 305       <para revision="331603" contrib="sponsor"
 306         sponsor="&chelsio;">The &man.sysctl.8; utility has been
 307         updated to support setting an array of values to nodes.  Prior
 308         to this change, &man.sysctl.8; could only set one value to
 309         a node that may return multiple values when queried.</para>
 310
 311       <para revision="331729">The &man.ifconfig.8; utility has been
 312         updated to include a <literal>random</literal> option, which
 313         when used with the <literal>ether</literal> option, generates
 314         a random <acronym>MAC</acronym> address for an
 315         interface.</para>
 316
 317       <para revision="332126" contrib="sponsor"
 318         sponsor="&netflix;">The &man.efibootmgr.8; utility has been
 319         added, which is used to manipulate the <acronym>EFI</acronym>
 320         boot manager.</para>
 321     </sect2>
 322
 323     <sect2 xml:id="userland-contrib">
 324       <title>Contributed Software</title>
 325
 326       <para revision="321303">The &man.libarchive.3; library has been
 327         updated to version 3.3.2.</para>
 328
 329       <para revision="322172">The &man.libxo.3; library has been
 330         updated to version 0.8.4.</para>
 331
 332       <para revision="322442"><application>Subversion</application>
 333         has been updated to version 1.9.7.</para>
 334
 335       <para revision="328874">The &man.file.1; utility has been
 336         updated to version 5.32.</para>
 337
 338       <para revision="323136"><application>OpenSSH</application> has
 339         been updated to version 7.5p1.</para>
 340
 341       <para revision="324581">The &man.mandoc.1; utility has been
 342         updated to version 1.14.3.</para>
 343
 344       <para revision="327234">The &man.tcpdump.1; utility has been
 345         updated to version 4.9.2.</para>
 346
 347       <para revision="330106">The <acronym>NTP</acronym> utilities
 348         have been updated to version 4.2.8p11.</para>
 349
 350       <para revision="330570">The &man.less.1; utility has been
 351         updated to upstream version v530.</para>
 352
 353       <para revision="331246">The <application>bmake</application>
 354         utility has been updated to upstream version 20180222.</para>
 355
 356       <para revision="331638"><application>OpenSSL</application> has
 357         been updated to version 1.0.2o.</para>
 358
 359       <para revision="331662">Timezone data files have been updated to
 360         version 2018d.</para>
 361
 362       <para revision="331838">The <application>clang</application>,
 363         <application>llvm</application>,
 364         <application>lld</application>,
 365         <application>lldb</application>, and
 366         <application>complier-rt</application> utilities as well as
 367         <literal>libc++</literal> have been updated to upstream
 368         version 6.0.0.</para>
 369     </sect2>
 370
 371     <sect2 xml:id="userland-installer">
 372       <title>Installation and Configuration Tools</title>
 373
 374       <para revision="322254" contrib="sponsor" sponsor="&ff;"
 375         arch="&arch.arm64;">The &man.bsdinstall.8; installer has been
 376         updated to default to <acronym>UEFI</acronym>-only
 377         boot.</para>
 378     </sect2>
 379
 380     <sect2 xml:id="userland-rc">
 381       <title><filename class="directory">/etc/rc.d</filename>
 382         Scripts</title>
 383
 384       <para>&nbsp;</para>
 385     </sect2>
 386
 387     <sect2 xml:id="userland-periodic">
 388       <title><filename class="directory">/etc/periodic</filename>
 389         Scripts</title>
 390
 391       <para>&nbsp;</para>
 392     </sect2>
 393
 394     <sect2 xml:id="userland-libraries">
 395       <title>Runtime Libraries and API</title>
 396
 397       <para>&nbsp;</para>
 398     </sect2>
 399
 400     <sect2 xml:id="userland-abi">
 401       <title>ABI Compatibility</title>
 402
 403       <para>&nbsp;</para>
 404     </sect2>
 405
 406     <sect2 xml:id="userland-debug">
 407       <title>Userland Debugging</title>
 408
 409       <para>&nbsp;</para>
 410     </sect2>
 411   </sect1>
 412
 413   <sect1 xml:id="kernel">
 414     <title>Kernel</title>
 415
 416     <para>This section covers changes to kernel configurations, system
 417       tuning, and system control parameters that are not otherwise
 418       categorized.</para>
 419
 420     <sect2 xml:id="kernel-general">
 421       <title>General Kernel Changes</title>
 422
 423       <para>&nbsp;</para>
 424     </sect2>
 425
 426     <sect2 xml:id="kernel-bugfix">
 427       <title>Kernel Bug Fixes</title>
 428
 429       <para>&nbsp;</para>
 430     </sect2>
 431
 432     <sect2 xml:id="kernel-config">
 433       <title>Kernel Configuration</title>
 434
 435       <para>&nbsp;</para>
 436     </sect2>
 437
 438     <sect2 xml:id="kernel-modules">
 439       <title>Kernel Modules</title>
 440
 441       <para>&nbsp;</para>
 442     </sect2>
 443
 444     <sect2 xml:id="kernel-sysctl">
 445       <title>System Tuning and Controls</title>
 446
 447       <para>&nbsp;</para>
 448     </sect2>
 449   </sect1>
 450
 451   <sect1 xml:id="drivers">
 452     <title>Devices and Drivers</title>
 453
 454     <para>This section covers changes and additions to devices and
 455       device drivers since &release.prev;.</para>
 456
 457     <sect2 xml:id="drivers-device">
 458       <title>Device Drivers</title>
 459
 460       <para revision="331586" contrib="sponsor"
 461         sponsor="&mellanox;">The &man.mlx5io.4; driver has been added,
 462         providing an interface to manage supported Connect-X&nbsp;4
 463         and Connect-X&nbsp;5 network adapters.</para>
 464
 465       <para revision="330307" contrib="sponsor"
 466         sponsor="&chelsio;">The &man.cxgbe.4; driver has been updated
 467         to firmware version 1.16.63.0 for T4, T5, and T6 network
 468         adapters.</para>
 469     </sect2>
 470
 471     <sect2 xml:id="drivers-storage">
 472       <title>Storage Drivers</title>
 473
 474       <para>&nbsp;</para>
 475     </sect2>
 476
 477     <sect2 xml:id="drivers-network">
 478       <title>Network Drivers</title>
 479
 480       <para>&nbsp;</para>
 481     </sect2>
 482   </sect1>
 483
 484   <sect1 xml:id="hardware">
 485     <title>Hardware Support</title>
 486
 487     <para>This section covers general hardware support for physical
 488       machines, hypervisors, and virtualization environments, as well
 489       as hardware changes and updates that do not otherwise fit in
 490       other sections of this document.</para>
 491
 492     <sect2 xml:id="hardware-support">
 493       <title>Hardware Support</title>
 494
 495       <para revision="331500">Support for the TAIO
 496         <acronym>USB</acronym> multi-protocol adapter
 497         (<acronym>TUMPA</acronym>) has been added.</para>
 498     </sect2>
 499
 500     <sect2 xml:id="hardware-virtualization">
 501       <title>Virtualization Support</title>
 502
 503       <para revision="321413">Support for &man.virtio.console.4; has
 504         been added to &man.bhyve.4;.</para>
 505     </sect2>
 506
 507     <sect2 xml:id="hardware-arm">
 508       <title>ARM Support</title>
 509
 510       <para>&nbsp;</para>
 511     </sect2>
 512   </sect1>
 513
 514   <sect1 xml:id="storage">
 515     <title>Storage</title>
 516
 517     <para>This section covers changes and additions to file systems
 518       and other storage subsystems, both local and networked.</para>
 519
 520     <sect2 xml:id="storage-general">
 521       <title>General Storage</title>
 522
 523       <para>&nbsp;</para>
 524     </sect2>
 525
 526     <sect2 xml:id="storage-net">
 527       <title>Networked Storage</title>
 528
 529       <para>&nbsp;</para>
 530     </sect2>
 531
 532     <sect2 xml:id="storage-zfs">
 533       <title>ZFS</title>
 534
 535       <para>&nbsp;</para>
 536     </sect2>
 537
 538     <sect2 xml:id="storage-geom">
 539       <title><literal>geom(4)</literal></title>
 540
 541       <para>&nbsp;</para>
 542     </sect2>
 543   </sect1>
 544
 545   <sect1 xml:id="boot">
 546     <title>Boot Loader Changes</title>
 547
 548     <para>This section covers the boot loader, boot menu, and other
 549       boot-related changes.</para>
 550
 551     <sect2 xml:id="boot-loader">
 552       <title>Boot Loader Changes</title>
 553
 554       <para revision="329114">The length of <acronym>GELI</acronym>
 555         passphrases entered when booting a system with encrypted disks
 556         is now hidden by default.  See the configuration options in
 557         &man.geli.8; to restore the previous behavior.</para>
 558     </sect2>
 559
 560     <sect2 xml:id="boot-menu">
 561       <title>Boot Menu Changes</title>
 562
 563       <para>&nbsp;</para>
 564     </sect2>
 565   </sect1>
 566
 567   <sect1 xml:id="network">
 568     <title>Networking</title>
 569
 570     <para>This section describes changes that affect networking in
 571       &os;.</para>
 572
 573     <sect2 xml:id="network-general">
 574       <title>General Network Changes</title>
 575
 576       <para>&nbsp;</para>
 577     </sect2>
 578
 579     <sect2 xml:id="network-protocols">
 580       <title>Network Protocols</title>
 581
 582       <para>&nbsp;</para>
 583     </sect2>
 584   </sect1>
 585
 586   <sect1 xml:id="ports">
 587     <title>Ports Collection and Package Infrastructure</title>
 588
 589     <para>This section covers changes to the &os;&nbsp;Ports
 590       Collection, package infrastructure, and package maintenance and
 591       installation tools.</para>
 592
 593     <sect2 xml:id="ports-infrastructure">
 594       <title>Infrastructure Changes</title>
 595
 596       <para>&nbsp;</para>
 597     </sect2>
 598
 599     <sect2 xml:id="ports-packages ">
 600       <title>Packaging Changes</title>
 601
 602       <para>&nbsp;</para>
 603     </sect2>
 604   </sect1>
 605
 606   <sect1 xml:id="doc">
 607     <title>Documentation</title>
 608
 609     <para>This section covers changes to the &os;&nbsp;Documentation
 610       Project sources and toolchain.</para>
 611
 612     <sect2 xml:id="doc-sources">
 613       <title>Documentation Source Changes</title>
 614
 615       <para>&nbsp;</para>
 616     </sect2>
 617
 618     <sect2 xml:id="doc-toolchain">
 619       <title>Documentation Toolchain Changes</title>
 620
 621       <para>&nbsp;</para>
 622     </sect2>
 623   </sect1>
 624
 625   <sect1 xml:id="releng">
 626     <title>Release Engineering and Integration</title>
 627
 628     <para>This section convers changes that are specific to the
 629       &os;&nbsp;Release Engineering processes.</para>
 630
 631     <sect2 xml:id="releng-changes">
 632       <title>Integration Changes</title>
 633
 634       <para revision="326892">Amazon&reg; EC2&trade; instances now
 635         keep their clocks synchronized using the Amazon Time Sync
 636         Service, the <acronym>NTP</acronym> service internal to the
 637         EC2&trade; infrastructure.</para>
 638     </sect2>
 639   </sect1>
 640 </article>