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="322919">The &man.pw.8; utility has been updated
 199         to properly handle empty secondary group lists as an argument
 200         to the <literal>-G</literal> flag when using the
 201         <literal>usermod</literal> subcommand.</para>
 202
 203       <para revision="324270">The &man.ps.1; utility has been updated
 204         to reflect realtime and idle priorities in state flags.</para>
 205
 206       <para revision="324271">The &man.ps.1; utility has been updated
 207         to display if a process is running with &man.capsicum.4;
 208         capability mode, indicated by <literal>C</literal>.</para>
 209
 210       <para revision="324380">The &man.cpucontrol.8; utility has been
 211         updated to include a new flag, <literal>-n</literal>, that
 212         disables the default microcode update search path when
 213         used.</para>
 214
 215       <para revision="324674">The &man.fsck.ffs.8; utility has been
 216         updated to prevent a filesystem from being reported as
 217         modified when only the timestamp in the superblock is
 218         updated.</para>
 219
 220       <para revision="325003" contrib="sponsor"
 221         sponsor="&spectralogic;">The &man.diskinfo.8; utility has been
 222         updated to display disk rotation rate and if
 223         <acronym>TRIM</acronym>/<acronym>UNMAP</acronym> is supported
 224         by the disk.</para>
 225
 226       <para revision="326413">The &man.pfctl.8; utility has been
 227         updated to allow <literal>route-to</literal> to properly
 228         handle network interfaces with multiple <acronym>IP</acronym>
 229         addresses.</para>
 230
 231       <para revision="326778" contrib="sponsor"
 232         sponsor="&spectralogic;">The &man.camcontrol.8; utility has
 233         been updated to include <acronym>ZAC</acronym> (Zoned-device
 234         <acronym>ATA</acronym> command set) information when the
 235         <literal>identify</literal> subcommand is used.</para>
 236
 237       <para revision="326848">The &man.pw.8; utility has been updated
 238         to correct handling of account expiration periods.</para>
 239
 240       <para revision="327592">The &man.mdmfs.8; utility has been
 241         updated to support &man.tmpfs.5;.</para>
 242
 243       <para revision="327871">The &man.cpucontrol.8; utility has been
 244         updated to include a new flag, <literal>-e</literal>, which is
 245         used to re-evaluate reported <acronym>CPU</acronym> features
 246         after applying firmware updates.</para>
 247
 248       <note>
 249         <para>The &man.cpucontrol.8; <literal>-e</literal> flag should
 250           only be used after microcode update have been applied to all
 251           <acronym>CPU</acronym>s in the system, otherwise system
 252           instability may be experienced if processor features are not
 253           identical across the system.</para>
 254       </note>
 255
 256       <para revision="328140">The &man.df.1; utility has been updated
 257         to include the <literal>--si</literal> long option, which is
 258         an alias to <literal>-H</literal>.</para>
 259
 260       <para revision="328599">The &man.service.8; utility has been
 261         updated to include a new flag, <literal>-j</literal>, which is
 262         used to interact with services running within a &man.jail.8;.
 263         The argument to <literal>-j</literal> can be either the name
 264         or numeric jail <acronym>ID</acronym>.</para>
 265
 266       <para revision="328604" contrib="sponsor"
 267         sponsor="&dellemc;">The &man.fsck.ffs.8; utility has been
 268         updated to exit with a non-zero status when the filesystem is
 269         not repaired.</para>
 270
 271       <para revision="330692" contrib="sponsor"
 272         sponsor="&dellemc;">The &man.dhclient.8; utility has been
 273         updated to be more compliant with <acronym>RFC</acronym>2131
 274         by setting the source address field in the
 275         <acronym>IP</acronym> header to <literal>0</literal> when
 276         sending a <literal>DHCPREQUEST</literal> message to attempt to
 277         obtain a previously-assigned <literal>IP</literal>
 278         address.</para>
 279
 280       <para revision="330694" contrib="sponsor"
 281         sponsor="&dellemc;">The &man.pw.8; utility has been updated to
 282         allow the <literal>@</literal> and <literal>!</literal>
 283         characters in the <acronym>GECOS</acronym> field.</para>
 284
 285       <para revision="331471">The &man.ps.1; utility has been updated
 286         to include a <literal>jail</literal>, which when used will
 287         list the name of a &man.jail.8; instead of the numeric
 288         ID.</para>
 289
 290       <para revision="331586" contrib="sponsor"
 291         sponsor="&mellanox;">The &man.mlx5tool.8; utility has been
 292         added, which is used to manage Connect-X&nbsp;4 and
 293         Connect-X&nbsp;5 devices supported by &man.mlx5io.4;.</para>
 294
 295       <para revision="331729">The &man.ifconfig.8; utility has been
 296         updated to include a <literal>random</literal> option, which
 297         when used with the <literal>ether</literal> option, generates
 298         a random <acronym>MAC</acronym> address for an
 299         interface.</para>
 300
 301       <para revision="332126" contrib="sponsor"
 302         sponsor="&netflix;">The &man.efibootmgr.8; utility has been
 303         added, which is used to manipulate the <acronym>EFI</acronym>
 304         boot manager.</para>
 305     </sect2>
 306
 307     <sect2 xml:id="userland-contrib">
 308       <title>Contributed Software</title>
 309
 310       <para revision="321303">The &man.libarchive.3; library has been
 311         updated to version 3.3.2.</para>
 312
 313       <para revision="322172">The &man.libxo.3; library has been
 314         updated to version 0.8.4.</para>
 315
 316       <para revision="322442"><application>Subversion</application>
 317         has been updated to version 1.9.7.</para>
 318
 319       <para revision="328874">The &man.file.1; utility has been
 320         updated to version 5.32.</para>
 321
 322       <para revision="323136"><application>OpenSSH</application> has
 323         been updated to version 7.5p1.</para>
 324
 325       <para revision="324581">The &man.mandoc.1; utility has been
 326         updated to version 1.14.3.</para>
 327
 328       <para revision="327234">The &man.tcpdump.1; utility has been
 329         updated to version 4.9.2.</para>
 330
 331       <para revision="330106">The <acronym>NTP</acronym> utilities
 332         have been updated to version 4.2.8p11.</para>
 333
 334       <para revision="330570">The &man.less.1; utility has been
 335         updated to upstream version v530.</para>
 336
 337       <para revision="331246">The <application>bmake</application>
 338         utility has been updated to upstream version 20180222.</para>
 339
 340       <para revision="331638"><application>OpenSSL</application> has
 341         been updated to version 1.0.2o.</para>
 342
 343       <para revision="331662">Timezone data files have been updated to
 344         version 2018d.</para>
 345
 346       <para revision="331838">The <application>clang</application>,
 347         <application>llvm</application>,
 348         <application>lld</application>,
 349         <application>lldb</application>, and
 350         <application>complier-rt</application> utilities as well as
 351         <literal>libc++</literal> have been updated to upstream
 352         version 6.0.0.</para>
 353     </sect2>
 354
 355     <sect2 xml:id="userland-installer">
 356       <title>Installation and Configuration Tools</title>
 357
 358       <para revision="322254" contrib="sponsor" sponsor="&ff;"
 359         arch="&arch.arm64;">The &man.bsdinstall.8; installer has been
 360         updated to default to <acronym>UEFI</acronym>-only
 361         boot.</para>
 362     </sect2>
 363
 364     <sect2 xml:id="userland-rc">
 365       <title><filename class="directory">/etc/rc.d</filename>
 366         Scripts</title>
 367
 368       <para>&nbsp;</para>
 369     </sect2>
 370
 371     <sect2 xml:id="userland-periodic">
 372       <title><filename class="directory">/etc/periodic</filename>
 373         Scripts</title>
 374
 375       <para>&nbsp;</para>
 376     </sect2>
 377
 378     <sect2 xml:id="userland-libraries">
 379       <title>Runtime Libraries and API</title>
 380
 381       <para>&nbsp;</para>
 382     </sect2>
 383
 384     <sect2 xml:id="userland-abi">
 385       <title>ABI Compatibility</title>
 386
 387       <para>&nbsp;</para>
 388     </sect2>
 389
 390     <sect2 xml:id="userland-debug">
 391       <title>Userland Debugging</title>
 392
 393       <para>&nbsp;</para>
 394     </sect2>
 395   </sect1>
 396
 397   <sect1 xml:id="kernel">
 398     <title>Kernel</title>
 399
 400     <para>This section covers changes to kernel configurations, system
 401       tuning, and system control parameters that are not otherwise
 402       categorized.</para>
 403
 404     <sect2 xml:id="kernel-general">
 405       <title>General Kernel Changes</title>
 406
 407       <para>&nbsp;</para>
 408     </sect2>
 409
 410     <sect2 xml:id="kernel-bugfix">
 411       <title>Kernel Bug Fixes</title>
 412
 413       <para>&nbsp;</para>
 414     </sect2>
 415
 416     <sect2 xml:id="kernel-config">
 417       <title>Kernel Configuration</title>
 418
 419       <para>&nbsp;</para>
 420     </sect2>
 421
 422     <sect2 xml:id="kernel-modules">
 423       <title>Kernel Modules</title>
 424
 425       <para>&nbsp;</para>
 426     </sect2>
 427
 428     <sect2 xml:id="kernel-sysctl">
 429       <title>System Tuning and Controls</title>
 430
 431       <para>&nbsp;</para>
 432     </sect2>
 433   </sect1>
 434
 435   <sect1 xml:id="drivers">
 436     <title>Devices and Drivers</title>
 437
 438     <para>This section covers changes and additions to devices and
 439       device drivers since &release.prev;.</para>
 440
 441     <sect2 xml:id="drivers-device">
 442       <title>Device Drivers</title>
 443
 444       <para revision="331586" contrib="sponsor"
 445         sponsor="&mellanox;">The &man.mlx5io.4; driver has been added,
 446         providing an interface to manage supported Connect-X&nbsp;4
 447         and Connect-X&nbsp;5 network adapters.</para>
 448
 449       <para revision="330307" contrib="sponsor"
 450         sponsor="&chelsio;">The &man.cxgbe.4; driver has been updated
 451         to firmware version 1.16.63.0 for T4, T5, and T6 network
 452         adapters.</para>
 453     </sect2>
 454
 455     <sect2 xml:id="drivers-storage">
 456       <title>Storage Drivers</title>
 457
 458       <para>&nbsp;</para>
 459     </sect2>
 460
 461     <sect2 xml:id="drivers-network">
 462       <title>Network Drivers</title>
 463
 464       <para>&nbsp;</para>
 465     </sect2>
 466   </sect1>
 467
 468   <sect1 xml:id="hardware">
 469     <title>Hardware Support</title>
 470
 471     <para>This section covers general hardware support for physical
 472       machines, hypervisors, and virtualization environments, as well
 473       as hardware changes and updates that do not otherwise fit in
 474       other sections of this document.</para>
 475
 476     <sect2 xml:id="hardware-support">
 477       <title>Hardware Support</title>
 478
 479       <para revision="331500">Support for the TAIO
 480         <acronym>USB</acronym> multi-protocol adapter
 481         (<acronym>TUMPA</acronym>) has been added.</para>
 482     </sect2>
 483
 484     <sect2 xml:id="hardware-virtualization">
 485       <title>Virtualization Support</title>
 486
 487       <para revision="321413">Support for &man.virtio.console.4; has
 488         been added to &man.bhyve.4;.</para>
 489     </sect2>
 490
 491     <sect2 xml:id="hardware-arm">
 492       <title>ARM Support</title>
 493
 494       <para>&nbsp;</para>
 495     </sect2>
 496   </sect1>
 497
 498   <sect1 xml:id="storage">
 499     <title>Storage</title>
 500
 501     <para>This section covers changes and additions to file systems
 502       and other storage subsystems, both local and networked.</para>
 503
 504     <sect2 xml:id="storage-general">
 505       <title>General Storage</title>
 506
 507       <para>&nbsp;</para>
 508     </sect2>
 509
 510     <sect2 xml:id="storage-net">
 511       <title>Networked Storage</title>
 512
 513       <para>&nbsp;</para>
 514     </sect2>
 515
 516     <sect2 xml:id="storage-zfs">
 517       <title>ZFS</title>
 518
 519       <para>&nbsp;</para>
 520     </sect2>
 521
 522     <sect2 xml:id="storage-geom">
 523       <title><literal>geom(4)</literal></title>
 524
 525       <para>&nbsp;</para>
 526     </sect2>
 527   </sect1>
 528
 529   <sect1 xml:id="boot">
 530     <title>Boot Loader Changes</title>
 531
 532     <para>This section covers the boot loader, boot menu, and other
 533       boot-related changes.</para>
 534
 535     <sect2 xml:id="boot-loader">
 536       <title>Boot Loader Changes</title>
 537
 538       <para revision="329114">The length of <acronym>GELI</acronym>
 539         passphrases entered when booting a system with encrypted disks
 540         is now hidden by default.  See the configuration options in
 541         &man.geli.8; to restore the previous behavior.</para>
 542     </sect2>
 543
 544     <sect2 xml:id="boot-menu">
 545       <title>Boot Menu Changes</title>
 546
 547       <para>&nbsp;</para>
 548     </sect2>
 549   </sect1>
 550
 551   <sect1 xml:id="network">
 552     <title>Networking</title>
 553
 554     <para>This section describes changes that affect networking in
 555       &os;.</para>
 556
 557     <sect2 xml:id="network-general">
 558       <title>General Network Changes</title>
 559
 560       <para>&nbsp;</para>
 561     </sect2>
 562
 563     <sect2 xml:id="network-protocols">
 564       <title>Network Protocols</title>
 565
 566       <para>&nbsp;</para>
 567     </sect2>
 568   </sect1>
 569
 570   <sect1 xml:id="ports">
 571     <title>Ports Collection and Package Infrastructure</title>
 572
 573     <para>This section covers changes to the &os;&nbsp;Ports
 574       Collection, package infrastructure, and package maintenance and
 575       installation tools.</para>
 576
 577     <sect2 xml:id="ports-infrastructure">
 578       <title>Infrastructure Changes</title>
 579
 580       <para>&nbsp;</para>
 581     </sect2>
 582
 583     <sect2 xml:id="ports-packages ">
 584       <title>Packaging Changes</title>
 585
 586       <para>&nbsp;</para>
 587     </sect2>
 588   </sect1>
 589
 590   <sect1 xml:id="doc">
 591     <title>Documentation</title>
 592
 593     <para>This section covers changes to the &os;&nbsp;Documentation
 594       Project sources and toolchain.</para>
 595
 596     <sect2 xml:id="doc-sources">
 597       <title>Documentation Source Changes</title>
 598
 599       <para>&nbsp;</para>
 600     </sect2>
 601
 602     <sect2 xml:id="doc-toolchain">
 603       <title>Documentation Toolchain Changes</title>
 604
 605       <para>&nbsp;</para>
 606     </sect2>
 607   </sect1>
 608
 609   <sect1 xml:id="releng">
 610     <title>Release Engineering and Integration</title>
 611
 612     <para>This section convers changes that are specific to the
 613       &os;&nbsp;Release Engineering processes.</para>
 614
 615     <sect2 xml:id="releng-changes">
 616       <title>Integration Changes</title>
 617
 618       <para revision="326892">Amazon&reg; EC2&trade; instances now
 619         keep their clocks synchronized using the Amazon Time Sync
 620         Service, the <acronym>NTP</acronym> service internal to the
 621         EC2&trade; infrastructure.</para>
 622     </sect2>
 623   </sect1>
 624 </article>