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