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="338707">The &man.pthread.3; library has been
 354         updated to improve <acronym>POSIX</acronym> compliance.</para>
 355     </sect2>
 356
 357     <sect2 xml:id="userland-abi">
 358       <title>ABI Compatibility</title>
 359
 360       <para>&nbsp;</para>
 361     </sect2>
 362
 363     <sect2 xml:id="userland-debug">
 364       <title>Userland Debugging</title>
 365
 366       <para>&nbsp;</para>
 367     </sect2>
 368   </sect1>
 369
 370   <sect1 xml:id="kernel">
 371     <title>Kernel</title>
 372
 373     <para>This section covers changes to kernel configurations, system
 374       tuning, and system control parameters that are not otherwise
 375       categorized.</para>
 376
 377     <sect2 xml:id="kernel-general">
 378       <title>General Kernel Changes</title>
 379
 380       <para>&nbsp;</para>
 381     </sect2>
 382
 383     <sect2 xml:id="kernel-bugfix">
 384       <title>Kernel Bug Fixes</title>
 385
 386       <para>&nbsp;</para>
 387     </sect2>
 388
 389     <sect2 xml:id="kernel-config">
 390       <title>Kernel Configuration</title>
 391
 392       <para>&nbsp;</para>
 393     </sect2>
 394
 395     <sect2 xml:id="kernel-modules">
 396       <title>Kernel Modules</title>
 397
 398       <para>&nbsp;</para>
 399     </sect2>
 400
 401     <sect2 xml:id="kernel-sysctl">
 402       <title>System Tuning and Controls</title>
 403
 404       <para>&nbsp;</para>
 405     </sect2>
 406   </sect1>
 407
 408   <sect1 xml:id="drivers">
 409     <title>Devices and Drivers</title>
 410
 411     <para>This section covers changes and additions to devices and
 412       device drivers since &release.prev;.</para>
 413
 414     <sect2 xml:id="drivers-device">
 415       <title>Device Drivers</title>
 416
 417       <para>&nbsp;</para>
 418     </sect2>
 419
 420     <sect2 xml:id="drivers-storage">
 421       <title>Storage Drivers</title>
 422
 423       <para>&nbsp;</para>
 424     </sect2>
 425
 426     <sect2 xml:id="drivers-network">
 427       <title>Network Drivers</title>
 428
 429       <para revision="340369">The TP-Link&reg; TL-WN321G&trade;
 430         network adapter now uses the &man.run.4; driver instead of the
 431         &man.rum.4; driver.</para>
 432     </sect2>
 433   </sect1>
 434
 435   <sect1 xml:id="hardware">
 436     <title>Hardware Support</title>
 437
 438     <para>This section covers general hardware support for physical
 439       machines, hypervisors, and virtualization environments, as well
 440       as hardware changes and updates that do not otherwise fit in
 441       other sections of this document.</para>
 442
 443     <sect2 xml:id="hardware-support">
 444       <title>Hardware Support</title>
 445
 446       <para revision="342254">The &man.vt.4; keyboard mapping has been
 447         updated to include <literal>uk.macbook.kbd</literal>
 448         support.</para>
 449     </sect2>
 450
 451     <sect2 xml:id="hardware-virtualization">
 452       <title>Virtualization Support</title>
 453
 454       <para revision="341758" contrib="sponsor" sponsor="&ix;">Support
 455         for <acronym>PS/2</acronym> scan codes for
 456         <literal>NumLock</literal>, <literal>ScrollLock</literal>, and
 457         numerical keypad keys has been added to &man.bhyve.8;.</para>
 458     </sect2>
 459
 460     <sect2 xml:id="hardware-arm">
 461       <title>ARM Support</title>
 462
 463       <para>&nbsp;</para>
 464     </sect2>
 465   </sect1>
 466
 467   <sect1 xml:id="storage">
 468     <title>Storage</title>
 469
 470     <para>This section covers changes and additions to file systems
 471       and other storage subsystems, both local and networked.</para>
 472
 473     <sect2 xml:id="storage-general">
 474       <title>General Storage</title>
 475
 476       <para>&nbsp;</para>
 477     </sect2>
 478
 479     <sect2 xml:id="storage-net">
 480       <title>Networked Storage</title>
 481
 482       <para>&nbsp;</para>
 483     </sect2>
 484
 485     <sect2 xml:id="storage-zfs">
 486       <title>ZFS</title>
 487
 488       <para>&nbsp;</para>
 489     </sect2>
 490
 491     <sect2 xml:id="storage-geom">
 492       <title><literal>geom(4)</literal></title>
 493
 494       <para>&nbsp;</para>
 495     </sect2>
 496   </sect1>
 497
 498   <sect1 xml:id="boot">
 499     <title>Boot Loader Changes</title>
 500
 501     <para>This section covers the boot loader, boot menu, and other
 502       boot-related changes.</para>
 503
 504     <sect2 xml:id="boot-loader">
 505       <title>Boot Loader Changes</title>
 506
 507       <para>&nbsp;</para>
 508     </sect2>
 509
 510     <sect2 xml:id="boot-menu">
 511       <title>Boot Menu Changes</title>
 512
 513       <para>&nbsp;</para>
 514     </sect2>
 515   </sect1>
 516
 517   <sect1 xml:id="network">
 518     <title>Networking</title>
 519
 520     <para>This section describes changes that affect networking in
 521       &os;.</para>
 522
 523     <sect2 xml:id="network-general">
 524       <title>General Network Changes</title>
 525
 526       <para revision="337461">The &man.ipfw.8; firewall has been
 527         updated to include new rule options,
 528         <literal>record-state</literal>, <literal>set-limit</literal>,
 529         and <literal>defer-action</literal>.</para>
 530     </sect2>
 531
 532     <sect2 xml:id="network-protocols">
 533       <title>Network Protocols</title>
 534
 535       <para>&nbsp;</para>
 536     </sect2>
 537   </sect1>
 538
 539   <sect1 xml:id="ports">
 540     <title>Ports Collection and Package Infrastructure</title>
 541
 542     <para>This section covers changes to the &os;&nbsp;Ports
 543       Collection, package infrastructure, and package maintenance and
 544       installation tools.</para>
 545
 546     <sect2 xml:id="ports-infrastructure">
 547       <title>Infrastructure Changes</title>
 548
 549       <para>&nbsp;</para>
 550     </sect2>
 551
 552     <sect2 xml:id="ports-packages ">
 553       <title>Packaging Changes</title>
 554
 555       <para>&nbsp;</para>
 556     </sect2>
 557   </sect1>
 558
 559   <sect1 xml:id="doc">
 560     <title>Documentation</title>
 561
 562     <para>This section covers changes to the &os;&nbsp;Documentation
 563       Project sources and toolchain.</para>
 564
 565     <sect2 xml:id="doc-sources">
 566       <title>Documentation Source Changes</title>
 567
 568       <para>&nbsp;</para>
 569     </sect2>
 570
 571     <sect2 xml:id="doc-toolchain">
 572       <title>Documentation Toolchain Changes</title>
 573
 574       <para>&nbsp;</para>
 575     </sect2>
 576   </sect1>
 577
 578   <sect1 xml:id="releng">
 579     <title>Release Engineering and Integration</title>
 580
 581     <para>This section convers changes that are specific to the
 582       &os;&nbsp;Release Engineering processes.</para>
 583
 584     <sect2 xml:id="releng-changes">
 585       <title>Integration Changes</title>
 586
 587       <para>&nbsp;</para>
 588     </sect2>
 589   </sect1>
 590 </article>