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="339446">The &man.jail.8; utility has been
 165         updated to include a new &man.jail.conf.5; parameter,
 166         <literal>allow.read_msgbuf</literal>, which prevents jailed
 167         processes and users from accessing the &man.dmesg.8; buffer.
 168         This parameter is set to <literal>false</literal> by
 169         default.</para>
 170
 171       <para revision="342103">The system &man.crontab.5;,
 172         <filename>/etc/crontab</filename>, has been updated to set
 173         <varname>PATH</varname> for consistency with the &man.cron.8;
 174         daemon.</para>
 175
 176       <para revision="343469">The default &man.devd.conf.5; has been
 177         updated to prevent duplicated &man.hostapd.8; and
 178         &man.wpa.supplicant.8; startup via &man.devd.8;.</para>
 179     </sect2>
 180
 181     <sect2 xml:id="userland-programs">
 182       <title>Userland Application Changes</title>
 183
 184       <para revision="336040">The &man.cpuset.1;, &man.sockstat.1;,
 185         &man.ipfw.8;, and &man.ugidfw.8; utilities have been updated
 186         to support &man.jail.8; names.</para>
 187
 188       <para revision="336328">The &man.newfs.msdos.8; utililty has
 189         been updated to include a new flag, <literal>-T</literal>,
 190         which is used to specify the timestamp for build
 191         reproducibility.</para>
 192
 193       <para revision="338364">The &man.dd.1; utility has been updated
 194         to add a new <literal>status</literal>operand,
 195         <literal>progress</literal>, which reports the current status
 196         on a single line every second.</para>
 197
 198       <para revision="338451">The &man.last.1; utility has been
 199         updated to include &man.libxo.3; support.</para>
 200
 201       <para revision="338452">The &man.lastlogin.8; utility has been
 202         updated to include &man.libxo.3; support.</para>
 203
 204       <para revision="338475">The &man.traceroute.8; utility has been
 205         updated to include &man.libcasper.3; support.</para>
 206
 207       <para revision="339160">The &man.diff.1; utility has been
 208         updated to implement <literal>-B</literal> and
 209         <literal>--ignore-blank-lines</literal> support.</para>
 210
 211       <para revision="340963">The &man.makewhatis.1; utility has been
 212         updated to prevent operating within read-only
 213         directories.</para>
 214
 215       <para revision="341790">The &man.jail.8; utility has been
 216         updated to add a new flag, <literal>-e</literal>, which takes
 217         a &man.jail.conf.5; parameter as an argument and prints a list
 218         of non-wildcard jails with the specified parameter.</para>
 219
 220       <para revision="342706">The &man.ktrdump.8; utility has been
 221         updated to include the <literal>-l</literal> flag which
 222         enables &quot;live&quot; mode when specified.</para>
 223
 224       <para revision="343118">The &man.trim.8; utility has been added,
 225         which deletes content for blocks on flash-based storage
 226         devices that use wear-leveling algorithms.</para>
 227
 228       <para revision="343251">The &man.gzip.1; utility has been
 229         updated to add <literal>-l</literal> support for &man.xz.1;
 230         files.</para>
 231
 232       <para revision="343538" contrib="sponsor"
 233         sponsor="&netflix;">The &man.newfs.8; and &man.tunefs.8;
 234         utilities have been updated to allow underscores in label
 235         names.</para>
 236
 237       <para revision="344020">The &man.pfctl.8; utility has been
 238         updated to provide clearer output and reference the
 239         <literal>net.pf.request_maxcount</literal> &man.sysctl.8;
 240         if a defined table is too large.</para>
 241
 242       <para revision="344052">The &man.newfs.8; and &man.tunefs.8;
 243         utilities have been updated to allow dashes in label
 244         names.</para>
 245
 246       <para revision="344490">The &man.fdisk.8; utility has been
 247         updated to support sectors larger than 2048 bytes.</para>
 248
 249       <para revision="345561">The &man.sh.1; utility has been updated
 250         to add the <literal>pipefail</literal> option which simplifies
 251         checking the exit status of all commands in a pipeline.</para>
 252
 253       <para revision="345878">The &man.patch.1; utility has been
 254         updated to exit successfully if the input patch file is
 255         zero-length.</para>
 256     </sect2>
 257
 258     <sect2 xml:id="userland-contrib">
 259       <title>Contributed Software</title>
 260
 261       <para revision="334607">The &man.xz.1; utility has been updated
 262         to version 5.2.4.</para>
 263
 264       <para revision="337817">The <application>WPA</application>
 265         utilities have been updated to version 2.6.</para>
 266
 267       <para revision="337827">The &man.file.1; utility has been
 268         updated to version 5.34.</para>
 269
 270       <para revision="338414" contrib="sponsor" sponsor="&ff;">The
 271         <application>ELF Tool Chain</application> has been updated to
 272         version r3614.</para>
 273
 274       <para revision="338795">The &man.libarchive.3; library has been
 275         updated to version 3.3.3, with additional fixes from
 276         upstream.</para>
 277
 278       <para revision="339100" contrib="sponsor" sponsor="&ff;">The
 279         <application>lld</application> utility has been updated to add
 280         <literal>-z interpose</literal>, marking the object file as
 281         an interposer.</para>
 282
 283       <para revision="343079">The &man.file.1; utility has been
 284         updated to fix incorrect date reporting for &man.dump.8;
 285         files.</para>
 286
 287       <para revision="344213">The <application>clang</application>,
 288         <application>llvm</application>,
 289         <application>lld</application>,
 290         <application>lldb</application>, and
 291         <application>compiler-rt</application> utilities as well as
 292         <application>libc++</application> have been updated to
 293         upstream version 7.0.1.</para>
 294
 295       <para revision="344220">The <application>LUA</application>
 296         &man.loader.8; has been merged.</para>
 297
 298       <para revision="344604"><application>OpenSSL</application> has
 299         been updated to version 1.0.2r.</para>
 300
 301       <para revision="344884">The &man.ntpd.8; utilities have been
 302         updated to version 4.2.8p13.</para>
 303
 304       <para revision="345670">Timezone data files have been updated to
 305         version 2019a.</para>
 306     </sect2>
 307
 308     <sect2 xml:id="userland-installer">
 309       <title>Installation and Configuration Tools</title>
 310
 311       <para>&nbsp;</para>
 312     </sect2>
 313
 314     <sect2 xml:id="userland-rc">
 315       <title><filename class="directory">/etc/rc.d</filename>
 316         Scripts</title>
 317
 318       <para revision="340611">Support for auxiliary
 319         <acronym>RAM</acronym> has been added to
 320         <filename>/etc/rc.initdiskless</filename>.</para>
 321
 322       <para revision="340966">The &man.rcorder.8; utility has been
 323         updated to add support for
 324         <filename>/etc/rc.resume</filename>.</para>
 325
 326       <para revision="341792">The <literal>jail_conf</literal>
 327         definition, which defaults to
 328         <filename>/etc/jail.conf</filename>, has been moved from
 329         the &man.jail.8; &man.rc.8; script to
 330         <filename>/etc/defaults/rc.conf</filename>.</para>
 331
 332       <para revision="343046">The <varname>rc_service</varname>
 333         variable has been added to &man.rc.subr.8;, which defaults to
 334         the path of the service being executed in case the service
 335         needs to re-invoke itself.</para>
 336     </sect2>
 337
 338     <sect2 xml:id="userland-periodic">
 339       <title><filename class="directory">/etc/periodic</filename>
 340         Scripts</title>
 341
 342       <para revision="341794">The &man.periodic.8; weekly
 343         <filename>340.noid</filename> script has been updated to
 344         prevent decending into the root directory of jails.</para>
 345     </sect2>
 346
 347     <sect2 xml:id="userland-libraries">
 348       <title>Runtime Libraries and API</title>
 349
 350       <para revision="335640">The &man.pcap.3; library has been
 351         updated to version 1.9.0 (pre-release).</para>
 352
 353       <para revision="336449">The &man.setproctitle.fast.3; function
 354         has been added, which is optimized for high-frequency process
 355         title updates.</para>
 356
 357       <para revision="337418" contrib="sponsor"
 358         sponsor="&dellemc;">The &man.kqueue.2; system call has been
 359         updated to allow updating
 360         <literal>EVFILT_TIMER</literal>.</para>
 361
 362       <para revision="338405">The &man.pthread.get.name.np.3; function
 363         has been added, which is used to retrieve the function name
 364         associated with a thread.</para>
 365
 366       <para revision="338707">The &man.pthread.3; library has been
 367         updated to improve <acronym>POSIX</acronym> compliance.</para>
 368     </sect2>
 369
 370     <sect2 xml:id="userland-abi">
 371       <title>ABI Compatibility</title>
 372
 373       <para>&nbsp;</para>
 374     </sect2>
 375
 376     <sect2 xml:id="userland-debug">
 377       <title>Userland Debugging</title>
 378
 379       <para>&nbsp;</para>
 380     </sect2>
 381   </sect1>
 382
 383   <sect1 xml:id="kernel">
 384     <title>Kernel</title>
 385
 386     <para>This section covers changes to kernel configurations, system
 387       tuning, and system control parameters that are not otherwise
 388       categorized.</para>
 389
 390     <sect2 xml:id="kernel-general">
 391       <title>General Kernel Changes</title>
 392
 393       <para revision="339857" contrib="sponsor"
 394         sponsor="&panzura;">The &man.ddb.4; debugging utility has been
 395         updated to print command-line arguments to a process.</para>
 396
 397       <para revision="342656">The number of <acronym>MSI</acronym>
 398         <acronym>IRQ</acronym>s have been converted from a constant to
 399         a tunable.  The default remains at <literal>512</literal>,
 400         which can now be changed during boot with the
 401         <literal>machdep.num_msi_irqs</literal> &man.sysctl.8;.</para>
 402
 403       <para revision="343084" contrib="sponsor"
 404         sponsor="&modirum;">The kernel will now log the &man.jail.8;
 405         <acronym>ID</acronym> when logging a process exit.  The
 406         &man.jail.8; <acronym>ID</acronym> <literal>0</literal>
 407         represents processes that are not jailed.</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="340182" contrib="sponsor"
 445         sponsor="&panzura;">The &man.ichwd.4; driver has been updated
 446         to include support for <acronym>TCO</acronym> watchdog timers
 447         in the Lewisburg <acronym>PCH</acronym> (C620) chipset.</para>
 448
 449       <para revision="345981">The &man.random.4; driver has been
 450         updated to improve performance during expensive
 451         reseeding.</para>
 452     </sect2>
 453
 454     <sect2 xml:id="drivers-storage">
 455       <title>Storage Drivers</title>
 456
 457       <para>&nbsp;</para>
 458     </sect2>
 459
 460     <sect2 xml:id="drivers-network">
 461       <title>Network Drivers</title>
 462
 463       <para revision="340369">The TP-Link&reg; TL-WN321G&trade;
 464         network adapter now uses the &man.run.4; driver instead of the
 465         &man.rum.4; driver.</para>
 466
 467       <para revision="342206" contrib="sponsor" sponsor="&ix;">The
 468         &man.lagg.4; driver has been updated to allow changing the
 469         <acronym>MTU</acronym> without requiring destroying and
 470         recreating the interface.</para>
 471
 472       <para revision="345040" contrib="sponsor"
 473         sponsor="&chelsio;">The &man.ccr.4; driver has been added,
 474         providing support for Chelsio&reg; T6&trade; cryptography
 475         accelerators.</para>
 476     </sect2>
 477   </sect1>
 478
 479   <sect1 xml:id="hardware">
 480     <title>Hardware Support</title>
 481
 482     <para>This section covers general hardware support for physical
 483       machines, hypervisors, and virtualization environments, as well
 484       as hardware changes and updates that do not otherwise fit in
 485       other sections of this document.</para>
 486
 487     <sect2 xml:id="hardware-support">
 488       <title>Hardware Support</title>
 489
 490       <para revision="342254">The &man.vt.4; keyboard mapping has been
 491         updated to include <literal>uk.macbook.kbd</literal>
 492         support.</para>
 493     </sect2>
 494
 495     <sect2 xml:id="hardware-virtualization">
 496       <title>Virtualization Support</title>
 497
 498       <para revision="341758" contrib="sponsor" sponsor="&ix;">Support
 499         for <acronym>PS/2</acronym> scan codes for
 500         <literal>NumLock</literal>, <literal>ScrollLock</literal>, and
 501         numerical keypad keys has been added to &man.bhyve.8;.</para>
 502     </sect2>
 503
 504     <sect2 xml:id="hardware-arm">
 505       <title>ARM Support</title>
 506
 507       <para>&nbsp;</para>
 508     </sect2>
 509   </sect1>
 510
 511   <sect1 xml:id="storage">
 512     <title>Storage</title>
 513
 514     <para>This section covers changes and additions to file systems
 515       and other storage subsystems, both local and networked.</para>
 516
 517     <sect2 xml:id="storage-general">
 518       <title>General Storage</title>
 519
 520       <para>&nbsp;</para>
 521     </sect2>
 522
 523     <sect2 xml:id="storage-net">
 524       <title>Networked Storage</title>
 525
 526       <para>&nbsp;</para>
 527     </sect2>
 528
 529     <sect2 xml:id="storage-zfs">
 530       <title>ZFS</title>
 531
 532       <para revision="341828" contrib="sponsor" sponsor="&klara;">An
 533         issue that could result in a system hang during
 534         <acronym>ZFS</acronym> vnode reclaimation has been
 535         fixed.</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="344399">The functionality provided by
 555         <filename>zfsloader</filename> has been added to
 556         &man.loader.8;.  Once the system boot blocks have been updated
 557         following <filename>UPDATING</filename>,
 558         <filename>zfsloader</filename> is no longer needed.  A hard
 559         link to &man.loader.8; has been added to ease in the
 560         transition.</para>
 561
 562       <para revision="344399">The &man.loader.8; has been updated to
 563         extend &man.geli.8; support to all architectures.</para>
 564
 565       <para revision="344403">The <acronym>UEFI</acronym> boot
 566         &man.loader.8; has been updated to better determine the system
 567         console type and device if not defined in
 568         &man.loader.conf.5;.</para>
 569     </sect2>
 570
 571     <sect2 xml:id="boot-menu">
 572       <title>Boot Menu Changes</title>
 573
 574       <para>&nbsp;</para>
 575     </sect2>
 576   </sect1>
 577
 578   <sect1 xml:id="network">
 579     <title>Networking</title>
 580
 581     <para>This section describes changes that affect networking in
 582       &os;.</para>
 583
 584     <sect2 xml:id="network-general">
 585       <title>General Network Changes</title>
 586
 587       <para revision="337461">The &man.ipfw.8; firewall has been
 588         updated to include new rule options,
 589         <literal>record-state</literal>, <literal>set-limit</literal>,
 590         and <literal>defer-action</literal>.</para>
 591     </sect2>
 592
 593     <sect2 xml:id="network-protocols">
 594       <title>Network Protocols</title>
 595
 596       <para>&nbsp;</para>
 597     </sect2>
 598   </sect1>
 599
 600   <sect1 xml:id="ports">
 601     <title>Ports Collection and Package Infrastructure</title>
 602
 603     <para>This section covers changes to the &os;&nbsp;Ports
 604       Collection, package infrastructure, and package maintenance and
 605       installation tools.</para>
 606
 607     <sect2 xml:id="ports-infrastructure">
 608       <title>Infrastructure Changes</title>
 609
 610       <para>&nbsp;</para>
 611     </sect2>
 612
 613     <sect2 xml:id="ports-packages ">
 614       <title>Packaging Changes</title>
 615
 616       <para>&nbsp;</para>
 617     </sect2>
 618   </sect1>
 619
 620   <sect1 xml:id="doc">
 621     <title>Documentation</title>
 622
 623     <para>This section covers changes to the &os;&nbsp;Documentation
 624       Project sources and toolchain.</para>
 625
 626     <sect2 xml:id="doc-sources">
 627       <title>Documentation Source Changes</title>
 628
 629       <para>&nbsp;</para>
 630     </sect2>
 631
 632     <sect2 xml:id="doc-toolchain">
 633       <title>Documentation Toolchain Changes</title>
 634
 635       <para>&nbsp;</para>
 636     </sect2>
 637   </sect1>
 638
 639   <sect1 xml:id="releng">
 640     <title>Release Engineering and Integration</title>
 641
 642     <para>This section convers changes that are specific to the
 643       &os;&nbsp;Release Engineering processes.</para>
 644
 645     <sect2 xml:id="releng-changes">
 646       <title>Integration Changes</title>
 647
 648       <para>&nbsp;</para>
 649     </sect2>
 650   </sect1>
 651 </article>