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="325003" contrib="sponsor"
 216         sponsor="&spectralogic;">The &man.diskinfo.8; utility has been
 217         updated to display disk rotation rate and if
 218         <acronym>TRIM</acronym>/<acronym>UNMAP</acronym> is supported
 219         by the disk.</para>
 220
 221       <para revision="326848">The &man.pw.8; utility has been updated
 222         to correct handling of account expiration periods.</para>
 223
 224       <para revision="328140">The &man.df.1; utility has been updated
 225         to include the <literal>--si</literal> long option, which is
 226         an alias to <literal>-H</literal>.</para>
 227
 228       <para revision="330694" contrib="sponsor"
 229         sponsor="&dellemc;">The &man.pw.8; utility has been updated to
 230         allow the <literal>@</literal> and <literal>!</literal>
 231         characters in the <acronym>GECOS</acronym> field.</para>
 232
 233       <para revision="331471">The &man.ps.1; utility has been updated
 234         to include a <literal>jail</literal>, which when used will
 235         list the name of a &man.jail.8; instead of the numeric
 236         ID.</para>
 237
 238       <para revision="331586" contrib="sponsor"
 239         sponsor="&mellanox;">The &man.mlx5tool.8; utility has been
 240         added, which is used to manage Connect-X&nbsp;4 and
 241         Connect-X&nbsp;5 devices supported by &man.mlx5io.4;.</para>
 242
 243       <para revision="332126" contrib="sponsor"
 244         sponsor="&netflix;">The &man.efibootmgr.8; utility has been
 245         added, which is used to manipulate the <acronym>EFI</acronym>
 246         boot manager.</para>
 247     </sect2>
 248
 249     <sect2 xml:id="userland-contrib">
 250       <title>Contributed Software</title>
 251
 252       <para revision="321303">The &man.libarchive.3; library has been
 253         updated to version 3.3.2.</para>
 254
 255       <para revision="322172">The &man.libxo.3; library has been
 256         updated to version 0.8.4.</para>
 257
 258       <para revision="322442"><application>Subversion</application>
 259         has been updated to version 1.9.7.</para>
 260
 261       <para revision="328874">The &man.file.1; utility has been
 262         updated to version 5.32.</para>
 263
 264       <para revision="323136"><application>OpenSSH</application> has
 265         been updated to version 7.5p1.</para>
 266
 267       <para revision="324581">The &man.mandoc.1; utility has been
 268         updated to version 1.14.3.</para>
 269
 270       <para revision="327234">The &man.tcpdump.1; utility has been
 271         updated to version 4.9.2.</para>
 272
 273       <para revision="330106">The <acronym>NTP</acronym> utilities
 274         have been updated to version 4.2.8p11.</para>
 275
 276       <para revision="330570">The &man.less.1; utility has been
 277         updated to upstream version v530.</para>
 278
 279       <para revision="331246">The <application>bmake</application>
 280         utility has been updated to upstream version 20180222.</para>
 281
 282       <para revision="331638"><application>OpenSSL</application> has
 283         been updated to version 1.0.2o.</para>
 284
 285       <para revision="331662">Timezone data files have been updated to
 286         version 2018d.</para>
 287
 288       <para revision="331838">The <application>clang</application>,
 289         <application>llvm</application>,
 290         <application>lld</application>,
 291         <application>lldb</application>, and
 292         <application>complier-rt</application> utilities as well as
 293         <literal>libc++</literal> have been updated to upstream
 294         version 6.0.0.</para>
 295     </sect2>
 296
 297     <sect2 xml:id="userland-installer">
 298       <title>Installation and Configuration Tools</title>
 299
 300       <para revision="322254" contrib="sponsor" sponsor="&ff;"
 301         arch="&arch.arm64;">The &man.bsdinstall.8; installer has been
 302         updated to default to <acronym>UEFI</acronym>-only
 303         boot.</para>
 304     </sect2>
 305
 306     <sect2 xml:id="userland-rc">
 307       <title><filename class="directory">/etc/rc.d</filename>
 308         Scripts</title>
 309
 310       <para>&nbsp;</para>
 311     </sect2>
 312
 313     <sect2 xml:id="userland-periodic">
 314       <title><filename class="directory">/etc/periodic</filename>
 315         Scripts</title>
 316
 317       <para>&nbsp;</para>
 318     </sect2>
 319
 320     <sect2 xml:id="userland-libraries">
 321       <title>Runtime Libraries and API</title>
 322
 323       <para>&nbsp;</para>
 324     </sect2>
 325
 326     <sect2 xml:id="userland-abi">
 327       <title>ABI Compatibility</title>
 328
 329       <para>&nbsp;</para>
 330     </sect2>
 331
 332     <sect2 xml:id="userland-debug">
 333       <title>Userland Debugging</title>
 334
 335       <para>&nbsp;</para>
 336     </sect2>
 337   </sect1>
 338
 339   <sect1 xml:id="kernel">
 340     <title>Kernel</title>
 341
 342     <para>This section covers changes to kernel configurations, system
 343       tuning, and system control parameters that are not otherwise
 344       categorized.</para>
 345
 346     <sect2 xml:id="kernel-general">
 347       <title>General Kernel Changes</title>
 348
 349       <para>&nbsp;</para>
 350     </sect2>
 351
 352     <sect2 xml:id="kernel-bugfix">
 353       <title>Kernel Bug Fixes</title>
 354
 355       <para>&nbsp;</para>
 356     </sect2>
 357
 358     <sect2 xml:id="kernel-config">
 359       <title>Kernel Configuration</title>
 360
 361       <para>&nbsp;</para>
 362     </sect2>
 363
 364     <sect2 xml:id="kernel-modules">
 365       <title>Kernel Modules</title>
 366
 367       <para>&nbsp;</para>
 368     </sect2>
 369
 370     <sect2 xml:id="kernel-sysctl">
 371       <title>System Tuning and Controls</title>
 372
 373       <para>&nbsp;</para>
 374     </sect2>
 375   </sect1>
 376
 377   <sect1 xml:id="drivers">
 378     <title>Devices and Drivers</title>
 379
 380     <para>This section covers changes and additions to devices and
 381       device drivers since &release.prev;.</para>
 382
 383     <sect2 xml:id="drivers-device">
 384       <title>Device Drivers</title>
 385
 386       <para revision="331586" contrib="sponsor"
 387         sponsor="&mellanox;">The &man.mlx5io.4; driver has been added,
 388         providing an interface to manage supported Connect-X&nbsp;4
 389         and Connect-X&nbsp;5 network adapters.</para>
 390     </sect2>
 391
 392     <sect2 xml:id="drivers-storage">
 393       <title>Storage Drivers</title>
 394
 395       <para>&nbsp;</para>
 396     </sect2>
 397
 398     <sect2 xml:id="drivers-network">
 399       <title>Network Drivers</title>
 400
 401       <para>&nbsp;</para>
 402     </sect2>
 403   </sect1>
 404
 405   <sect1 xml:id="hardware">
 406     <title>Hardware Support</title>
 407
 408     <para>This section covers general hardware support for physical
 409       machines, hypervisors, and virtualization environments, as well
 410       as hardware changes and updates that do not otherwise fit in
 411       other sections of this document.</para>
 412
 413     <sect2 xml:id="hardware-support">
 414       <title>Hardware Support</title>
 415
 416       <para revision="331500">Support for the TAIO
 417         <acronym>USB</acronym> multi-protocol adapter
 418         (<acronym>TUMPA</acronym>) has been added.</para>
 419     </sect2>
 420
 421     <sect2 xml:id="hardware-virtualization">
 422       <title>Virtualization Support</title>
 423
 424       <para revision="321413">Support for &man.virtio.console.4; has
 425         been added to &man.bhyve.4;.</para>
 426     </sect2>
 427
 428     <sect2 xml:id="hardware-arm">
 429       <title>ARM Support</title>
 430
 431       <para>&nbsp;</para>
 432     </sect2>
 433   </sect1>
 434
 435   <sect1 xml:id="storage">
 436     <title>Storage</title>
 437
 438     <para>This section covers changes and additions to file systems
 439       and other storage subsystems, both local and networked.</para>
 440
 441     <sect2 xml:id="storage-general">
 442       <title>General Storage</title>
 443
 444       <para>&nbsp;</para>
 445     </sect2>
 446
 447     <sect2 xml:id="storage-net">
 448       <title>Networked Storage</title>
 449
 450       <para>&nbsp;</para>
 451     </sect2>
 452
 453     <sect2 xml:id="storage-zfs">
 454       <title>ZFS</title>
 455
 456       <para>&nbsp;</para>
 457     </sect2>
 458
 459     <sect2 xml:id="storage-geom">
 460       <title><literal>geom(4)</literal></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 revision="329114">The length of <acronym>GELI</acronym>
 476         passphrases entered when booting a system with encrypted disks
 477         is now hidden by default.  See the configuration options in
 478         &man.geli.8; to restore the previous behavior.</para>
 479     </sect2>
 480
 481     <sect2 xml:id="boot-menu">
 482       <title>Boot Menu Changes</title>
 483
 484       <para>&nbsp;</para>
 485     </sect2>
 486   </sect1>
 487
 488   <sect1 xml:id="network">
 489     <title>Networking</title>
 490
 491     <para>This section describes changes that affect networking in
 492       &os;.</para>
 493
 494     <sect2 xml:id="network-general">
 495       <title>General Network Changes</title>
 496
 497       <para>&nbsp;</para>
 498     </sect2>
 499
 500     <sect2 xml:id="network-protocols">
 501       <title>Network Protocols</title>
 502
 503       <para>&nbsp;</para>
 504     </sect2>
 505   </sect1>
 506
 507   <sect1 xml:id="ports">
 508     <title>Ports Collection and Package Infrastructure</title>
 509
 510     <para>This section covers changes to the &os;&nbsp;Ports
 511       Collection, package infrastructure, and package maintenance and
 512       installation tools.</para>
 513
 514     <sect2 xml:id="ports-infrastructure">
 515       <title>Infrastructure Changes</title>
 516
 517       <para>&nbsp;</para>
 518     </sect2>
 519
 520     <sect2 xml:id="ports-packages ">
 521       <title>Packaging Changes</title>
 522
 523       <para>&nbsp;</para>
 524     </sect2>
 525   </sect1>
 526
 527   <sect1 xml:id="doc">
 528     <title>Documentation</title>
 529
 530     <para>This section covers changes to the &os;&nbsp;Documentation
 531       Project sources and toolchain.</para>
 532
 533     <sect2 xml:id="doc-sources">
 534       <title>Documentation Source Changes</title>
 535
 536       <para>&nbsp;</para>
 537     </sect2>
 538
 539     <sect2 xml:id="doc-toolchain">
 540       <title>Documentation Toolchain Changes</title>
 541
 542       <para>&nbsp;</para>
 543     </sect2>
 544   </sect1>
 545
 546   <sect1 xml:id="releng">
 547     <title>Release Engineering and Integration</title>
 548
 549     <para>This section convers changes that are specific to the
 550       &os;&nbsp;Release Engineering processes.</para>
 551
 552     <sect2 xml:id="releng-changes">
 553       <title>Integration Changes</title>
 554
 555       <para revision="326892">Amazon&reg; EC2&trade; instances now
 556         keep their clocks synchronized using the Amazon Time Sync
 557         Service, the <acronym>NTP</acronym> service internal to the
 558         EC2&trade; infrastructure.</para>
 559     </sect2>
 560   </sect1>
 561 </article>