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"
  15   xml:id="top"
  16   version="5.0">
  17
  18   <info>
  19     <title>&os; &release.current; Release Notes</title>
  20
  21     <author>
  22       <orgname>The &os; Project</orgname>
  23     </author>
  24
  25     <pubdate>$FreeBSD$</pubdate>
  26
  27     <!-- Last rev: 288943 -->
  28
  29     <copyright>
  30       <year>2019</year>
  31       <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
  32         Project</holder>
  33     </copyright>
  34
  35     <legalnotice xml:id="trademarks" role="trademarks">
  36       &tm-attrib.freebsd;
  37       &tm-attrib.ibm;
  38       &tm-attrib.ieee;
  39       &tm-attrib.intel;
  40       &tm-attrib.sparc;
  41       &tm-attrib.general;
  42     </legalnotice>
  43
  44     <abstract>
  45       <para>The release notes for &os; &release.current; contain
  46         a summary of the changes made to the &os; base system on the
  47         &release.branch; development line.  This document lists
  48         applicable security advisories that were issued since the last
  49         release, as well as significant changes to the &os; kernel and
  50         userland.  Some brief remarks on upgrading are also
  51         presented.</para>
  52     </abstract>
  53   </info>
  54
  55   <sect1 xml:id="intro">
  56     <title>Introduction</title>
  57
  58     <para>This document contains the release notes for &os;
  59       &release.current;.  It describes recently added, changed, or
  60       deleted features of &os;.  It also provides some notes on
  61       upgrading from previous versions of &os;.</para>
  62
  63     <para releasetype="current">The &release.type; distribution to
  64       which these release notes apply represents the latest point
  65       along the &release.branch; development branch since
  66       &release.branch; was created.  Information regarding pre-built,
  67       binary &release.type; distributions along this branch can be
  68       found at <uri
  69         xlink:href="&release.url;">&release.url;</uri>.</para>
  70
  71     <para releasetype="snapshot">The &release.type; distribution to
  72       which these release notes apply represents a point along the
  73       &release.branch; development branch between &release.prev; and
  74       the future &release.next;.  Information regarding pre-built,
  75       binary &release.type; distributions along this branch can be
  76       found at <uri
  77         xlink:href="&release.url;">&release.url;</uri>.</para>
  78
  79     <para releasetype="release">This distribution of &os;
  80       &release.current; is a &release.type; distribution.  It can be
  81       found at <uri xlink:href="&release.url;">&release.url;</uri> or
  82       any of its mirrors.  More information on obtaining this (or
  83       other) &release.type; distributions of &os; can be found in the
  84       <link
  85         xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
  86           &os;</quote> appendix</link> to the <link
  87         xlink:href="&url.books.handbook;/">&os;
  88         Handbook</link>.</para>
  89
  90     <para>All users are encouraged to consult the release errata
  91       before installing &os;.  The errata document is updated with
  92       <quote>late-breaking</quote> information discovered late in the
  93       release cycle or after the release.  Typically, it contains
  94       information on known bugs, security advisories, and corrections
  95       to documentation.  An up-to-date copy of the errata for &os;
  96       &release.current; can be found on the &os; Web site.</para>
  97
  98     <para>This document describes the most user-visible new or changed
  99       features in &os; since &release.prev;.  In general, changes
 100       described here are unique to the &release.branch; branch unless
 101       specifically marked as &merged; features.</para>
 102
 103     <para>Typical release note items document recent security
 104       advisories issued after &release.prev;, new drivers or hardware
 105       support, new commands or options, major bug fixes, or
 106       contributed software upgrades.  They may also list changes to
 107       major ports/packages or release engineering practices.  Clearly
 108       the release notes cannot list every single change made to &os;
 109       between releases; this document focuses primarily on security
 110       advisories, user-visible changes, and major architectural
 111       improvements.</para>
 112   </sect1>
 113
 114   <sect1 xml:id="upgrade">
 115     <title>Upgrading from Previous Releases of &os;</title>
 116
 117     <para arch="amd64,i386">Binary upgrades between RELEASE versions
 118       (and snapshots of the various security branches) are supported
 119       using the &man.freebsd-update.8; utility.  The binary upgrade
 120       procedure will update unmodified userland utilities, as well as
 121       unmodified GENERIC kernels distributed as a part of an official
 122       &os; release.  The &man.freebsd-update.8; utility requires that
 123       the host being upgraded have Internet connectivity.</para>
 124
 125     <para>Source-based upgrades (those based on recompiling the &os;
 126       base system from source code) from previous versions are
 127       supported, according to the instructions in
 128       <filename>/usr/src/UPDATING</filename>.</para>
 129
 130     <important>
 131       <para>Upgrading &os; should only be attempted after backing up
 132         <emphasis>all</emphasis> data and configuration files.</para>
 133     </important>
 134   </sect1>
 135
 136   <sect1 xml:id="security-errata">
 137     <title>Security and Errata</title>
 138
 139     <para>This section lists the various Security Advisories and
 140       Errata Notices since &release.prev;.</para>
 141
 142     <sect2 xml:id="security">
 143       <title>Security Advisories</title>
 144
 145       &security;
 146     </sect2>
 147
 148     <sect2 xml:id="errata">
 149       <title>Errata Notices</title>
 150
 151       &errata;
 152     </sect2>
 153   </sect1>
 154
 155   <sect1 xml:id="userland">
 156     <title>Userland</title>
 157
 158     <para>This section covers changes and additions to userland
 159       applications, contributed software, and system utilities.</para>
 160
 161     <sect2 xml:id="userland-config">
 162       <title>Userland Configuration Changes</title>
 163
 164       <para revision="342103">The system &man.crontab.5;,
 165         <filename>/etc/crontab</filename>, has been updated to set
 166         <varname>PATH</varname> for consistency with the &man.cron.8;
 167         daemon.</para>
 168
 169       <para revision="343469">The default &man.devd.conf.5; has been
 170         updated to prevent duplicated &man.hostapd.8; and
 171         &man.wpa.supplicant.8; startup via &man.devd.8;.</para>
 172     </sect2>
 173
 174     <sect2 xml:id="userland-programs">
 175       <title>Userland Application Changes</title>
 176
 177       <para revision="336040">The &man.cpuset.1;, &man.sockstat.1;,
 178         &man.ipfw.8;, and &man.ugidfw.8; utilities have been updated
 179         to support &man.jail.8; names.</para>
 180
 181       <para revision="336328">The &man.newfs.msdos.8; utililty has
 182         been updated to include a new flag, <literal>-T</literal>,
 183         which is used to specify the timestamp for build
 184         reproducibility.</para>
 185
 186       <para revision="338451">The &man.last.1; utility has been
 187         updated to include &man.libxo.3; support.</para>
 188
 189       <para revision="338364">The &man.dd.1; utility has been updated
 190         to add a new <literal>status</literal>operand,
 191         <literal>progress</literal>, which reports the current status
 192         on a single line every second.</para>
 193
 194       <para revision="339160">The &man.diff.1; utility has been
 195         updated to implement <literal>-B</literal> and
 196         <literal>--ignore-blank-lines</literal> support.</para>
 197
 198       <para revision="344490">The &man.fdisk.8; utility has been
 199         updated to support sectors larger than 2048 bytes.</para>
 200
 201       <para revision="342706">The &man.ktrdump.8; utility has been
 202         updated to include the <literal>-l</literal> flag which
 203         enables &quot;live&quot; mode when specified.</para>
 204
 205       <para revision="343251">The &man.gzip.1; utility has been
 206         updated to add <literal>-l</literal> support for &man.xz.1;
 207         files.</para>
 208
 209       <para revision="343538" contrib="sponsor"
 210         sponsor="&netflix;">The &man.newfs.8; and &man.tunefs.8;
 211         utilities have been updated to allow underscores in label
 212         names.</para>
 213
 214       <para revision="344020">The &man.pfctl.8; utility has been
 215         updated to provide clearer output and reference the
 216         <literal>net.pf.request_maxcount</literal> &man.sysctl.8;
 217         if a defined table is too large.</para>
 218
 219       <para revision="344052">The &man.newfs.8; and &man.tunefs.8;
 220         utilities have been updated to allow dashes in label
 221         names.</para>
 222
 223       <para revision="345561">The &man.sh.1; utility has been updated
 224         to add the <literal>pipefail</literal> option which simplifies
 225         checking the exit status of all commands in a pipeline.</para>
 226
 227       <para revision="345878">The &man.patch.1; utility has been
 228         updated to exit successfully if the input patch file is
 229         zero-length.</para>
 230     </sect2>
 231
 232     <sect2 xml:id="userland-contrib">
 233       <title>Contributed Software</title>
 234
 235       <para revision="334607">The &man.xz.1; utility has been updated
 236         to version 5.2.4.</para>
 237
 238       <para revision="337817">The <application>WPA</application>
 239         utilities have been updated to version 2.6.</para>
 240
 241       <para revision="337827">The &man.file.1; utility has been
 242         updated to version 5.34.</para>
 243
 244       <para revision="338414" contrib="sponsor" sponsor="&ff;">The
 245         <application>ELF Tool Chain</application> has been updated to
 246         version r3614.</para>
 247
 248       <para revision="338795">The &man.libarchive.3; library has been
 249         updated to version 3.3.3, with additional fixes from
 250         upstream.</para>
 251
 252       <para revision="339100" contrib="sponsor" sponsor="&ff;">The
 253         <application>lld</application> utility has been updated to add
 254         <literal>-z interpose</literal>, marking the object file as
 255         an interposer.</para>
 256
 257       <para revision="343079">The &man.file.1; utility has been
 258         updated to fix incorrect date reporting for &man.dump.8;
 259         files.</para>
 260
 261       <para revision="344213">The <application>clang</application>,
 262         <application>llvm</application>,
 263         <application>lld</application>,
 264         <application>lldb</application>, and
 265         <application>compiler-rt</application> utilities as well as
 266         <application>libc++</application> have been updated to
 267         upstream version 7.0.1.</para>
 268
 269       <para revision="344220">The <application>LUA</application>
 270         &man.loader.8; has been merged.</para>
 271
 272       <para revision="344604"><application>OpenSSL</application> has
 273         been updated to version 1.0.2r.</para>
 274
 275       <para revision="344884">The &man.ntpd.8; utilities have been
 276         updated to version 4.2.8p13.</para>
 277
 278       <para revision="345670">Timezone data files have been updated to
 279         version 2019a.</para>
 280     </sect2>
 281
 282     <sect2 xml:id="userland-installer">
 283       <title>Installation and Configuration Tools</title>
 284
 285       <para>&nbsp;</para>
 286     </sect2>
 287
 288     <sect2 xml:id="userland-rc">
 289       <title><filename class="directory">/etc/rc.d</filename>
 290         Scripts</title>
 291
 292       <para revision="340611">Support for auxiliary
 293         <acronym>RAM</acronym> has been added to
 294         <filename>/etc/rc.initdiskless</filename>.</para>
 295
 296       <para revision="340966">The &man.rcorder.8; utility has been
 297         updated to add support for
 298         <filename>/etc/rc.resume</filename>.</para>
 299
 300       <para revision="341792">The <literal>jail_conf</literal>
 301         definition, which defaults to
 302         <filename>/etc/jail.conf</filename>, has been moved from
 303         the &man.jail.8; &man.rc.8; script to
 304         <filename>/etc/defaults/rc.conf</filename>.</para>
 305
 306       <para revision="343046">The <varname>rc_service</varname>
 307         variable has been added to &man.rc.subr.8;, which defaults to
 308         the path of the service being executed in case the service
 309         needs to re-invoke itself.</para>
 310     </sect2>
 311
 312     <sect2 xml:id="userland-periodic">
 313       <title><filename class="directory">/etc/periodic</filename>
 314         Scripts</title>
 315
 316       <para revision="341794">The &man.periodic.8; weekly
 317         <filename>340.noid</filename> script has been updated to
 318         prevent decending into the root directory of jails.</para>
 319     </sect2>
 320
 321     <sect2 xml:id="userland-libraries">
 322       <title>Runtime Libraries and API</title>
 323
 324       <para>&nbsp;</para>
 325     </sect2>
 326
 327     <sect2 xml:id="userland-abi">
 328       <title>ABI Compatibility</title>
 329
 330       <para>&nbsp;</para>
 331     </sect2>
 332
 333     <sect2 xml:id="userland-debug">
 334       <title>Userland Debugging</title>
 335
 336       <para>&nbsp;</para>
 337     </sect2>
 338   </sect1>
 339
 340   <sect1 xml:id="kernel">
 341     <title>Kernel</title>
 342
 343     <para>This section covers changes to kernel configurations, system
 344       tuning, and system control parameters that are not otherwise
 345       categorized.</para>
 346
 347     <sect2 xml:id="kernel-general">
 348       <title>General Kernel Changes</title>
 349
 350       <para>&nbsp;</para>
 351     </sect2>
 352
 353     <sect2 xml:id="kernel-bugfix">
 354       <title>Kernel Bug Fixes</title>
 355
 356       <para>&nbsp;</para>
 357     </sect2>
 358
 359     <sect2 xml:id="kernel-config">
 360       <title>Kernel Configuration</title>
 361
 362       <para>&nbsp;</para>
 363     </sect2>
 364
 365     <sect2 xml:id="kernel-modules">
 366       <title>Kernel Modules</title>
 367
 368       <para>&nbsp;</para>
 369     </sect2>
 370
 371     <sect2 xml:id="kernel-sysctl">
 372       <title>System Tuning and Controls</title>
 373
 374       <para>&nbsp;</para>
 375     </sect2>
 376   </sect1>
 377
 378   <sect1 xml:id="drivers">
 379     <title>Devices and Drivers</title>
 380
 381     <para>This section covers changes and additions to devices and
 382       device drivers since &release.prev;.</para>
 383
 384     <sect2 xml:id="drivers-device">
 385       <title>Device Drivers</title>
 386
 387       <para>&nbsp;</para>
 388     </sect2>
 389
 390     <sect2 xml:id="drivers-storage">
 391       <title>Storage Drivers</title>
 392
 393       <para>&nbsp;</para>
 394     </sect2>
 395
 396     <sect2 xml:id="drivers-network">
 397       <title>Network Drivers</title>
 398
 399       <para>&nbsp;</para>
 400     </sect2>
 401   </sect1>
 402
 403   <sect1 xml:id="hardware">
 404     <title>Hardware Support</title>
 405
 406     <para>This section covers general hardware support for physical
 407       machines, hypervisors, and virtualization environments, as well
 408       as hardware changes and updates that do not otherwise fit in
 409       other sections of this document.</para>
 410
 411     <sect2 xml:id="hardware-support">
 412       <title>Hardware Support</title>
 413
 414       <para>&nbsp;</para>
 415     </sect2>
 416
 417     <sect2 xml:id="hardware-virtualization">
 418       <title>Virtualization Support</title>
 419
 420       <para revision="341758" contrib="sponsor" sponsor="&ix;">Support
 421         for <acronym>PS/2</acronym> scan codes for
 422         <literal>NumLock</literal>, <literal>ScrollLock</literal>, and
 423         numerical keypad keys has been added to &man.bhyve.8;.</para>
 424     </sect2>
 425
 426     <sect2 xml:id="hardware-arm">
 427       <title>ARM Support</title>
 428
 429       <para>&nbsp;</para>
 430     </sect2>
 431   </sect1>
 432
 433   <sect1 xml:id="storage">
 434     <title>Storage</title>
 435
 436     <para>This section covers changes and additions to file systems
 437       and other storage subsystems, both local and networked.</para>
 438
 439     <sect2 xml:id="storage-general">
 440       <title>General Storage</title>
 441
 442       <para>&nbsp;</para>
 443     </sect2>
 444
 445     <sect2 xml:id="storage-net">
 446       <title>Networked Storage</title>
 447
 448       <para>&nbsp;</para>
 449     </sect2>
 450
 451     <sect2 xml:id="storage-zfs">
 452       <title>ZFS</title>
 453
 454       <para>&nbsp;</para>
 455     </sect2>
 456
 457     <sect2 xml:id="storage-geom">
 458       <title><literal>geom(4)</literal></title>
 459
 460       <para>&nbsp;</para>
 461     </sect2>
 462   </sect1>
 463
 464   <sect1 xml:id="boot">
 465     <title>Boot Loader Changes</title>
 466
 467     <para>This section covers the boot loader, boot menu, and other
 468       boot-related changes.</para>
 469
 470     <sect2 xml:id="boot-loader">
 471       <title>Boot Loader Changes</title>
 472
 473       <para>&nbsp;</para>
 474     </sect2>
 475
 476     <sect2 xml:id="boot-menu">
 477       <title>Boot Menu Changes</title>
 478
 479       <para>&nbsp;</para>
 480     </sect2>
 481   </sect1>
 482
 483   <sect1 xml:id="network">
 484     <title>Networking</title>
 485
 486     <para>This section describes changes that affect networking in
 487       &os;.</para>
 488
 489     <sect2 xml:id="network-general">
 490       <title>General Network Changes</title>
 491
 492       <para revision="337461">The &man.ipfw.8; firewall has been
 493         updated to include new rule options,
 494         <literal>record-state</literal>, <literal>set-limit</literal>,
 495         and <literal>defer-action</literal>.</para>
 496     </sect2>
 497
 498     <sect2 xml:id="network-protocols">
 499       <title>Network Protocols</title>
 500
 501       <para>&nbsp;</para>
 502     </sect2>
 503   </sect1>
 504
 505   <sect1 xml:id="ports">
 506     <title>Ports Collection and Package Infrastructure</title>
 507
 508     <para>This section covers changes to the &os;&nbsp;Ports
 509       Collection, package infrastructure, and package maintenance and
 510       installation tools.</para>
 511
 512     <sect2 xml:id="ports-infrastructure">
 513       <title>Infrastructure Changes</title>
 514
 515       <para>&nbsp;</para>
 516     </sect2>
 517
 518     <sect2 xml:id="ports-packages ">
 519       <title>Packaging Changes</title>
 520
 521       <para>&nbsp;</para>
 522     </sect2>
 523   </sect1>
 524
 525   <sect1 xml:id="doc">
 526     <title>Documentation</title>
 527
 528     <para>This section covers changes to the &os;&nbsp;Documentation
 529       Project sources and toolchain.</para>
 530
 531     <sect2 xml:id="doc-sources">
 532       <title>Documentation Source Changes</title>
 533
 534       <para>&nbsp;</para>
 535     </sect2>
 536
 537     <sect2 xml:id="doc-toolchain">
 538       <title>Documentation Toolchain Changes</title>
 539
 540       <para>&nbsp;</para>
 541     </sect2>
 542   </sect1>
 543
 544   <sect1 xml:id="releng">
 545     <title>Release Engineering and Integration</title>
 546
 547     <para>This section convers changes that are specific to the
 548       &os;&nbsp;Release Engineering processes.</para>
 549
 550     <sect2 xml:id="releng-changes">
 551       <title>Integration Changes</title>
 552
 553       <para>&nbsp;</para>
 554     </sect2>
 555   </sect1>
 556 </article>