release/doc/en_US.ISO8859-1/errata/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         "http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd" [
   4 <!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN"
   5         "http://www.FreeBSD.org/release/XML/release.ent">
   6 %release;
   7 <!ENTITY % sponsor PUBLIC "-//FreeBSD//ENTITIES Sponsor Specification//EN" "sponsor.ent">
   8 %sponsor;
   9 <!ENTITY % vendor PUBLIC "-//FreeBSD//ENTITIES Vendor Specification//EN" "vendor.ent">
  10 %vendor;
  11 <!ENTITY security SYSTEM "../../share/xml/security.xml">
  12 <!ENTITY errata SYSTEM "../../share/xml/errata.xml">
  13 ]>
  14
  15 <article xmlns="http://docbook.org/ns/docbook"
  16         xmlns:xlink="http://www.w3.org/1999/xlink"
  17         xml:id="top"
  18         version="5.0">
  19   <info>
  20     <title>&os; &release; Errata</title>
  21
  22     <author><orgname>The &os; Project</orgname></author>
  23
  24     <pubdate>$FreeBSD$</pubdate>
  25
  26     <copyright>
  27       <year>2018</year>
  28
  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.intel;
  36       &tm-attrib.sparc;
  37       &tm-attrib.general;
  38     </legalnotice>
  39
  40     <abstract>
  41       <para>This document lists errata items for &os; &release;,
  42         containing significant information discovered after the
  43         release or too late in the release cycle to be otherwise
  44         included in the release documentation.  This information
  45         includes security advisories, as well as news relating to the
  46         software or documentation that could affect its operation or
  47         usability.  An up-to-date version of this document should
  48         always be consulted before installing this version of
  49         &os;.</para>
  50
  51       <para>This errata document for &os; &release; will be maintained
  52         until the release of &os; &release.next;.</para>
  53     </abstract>
  54   </info>
  55
  56   <sect1 xml:id="intro">
  57     <title>Introduction</title>
  58
  59     <para>This errata document contains <quote>late-breaking
  60         news</quote> about &os; &release; Before installing this
  61       version, it is important to consult this document to learn about
  62       any post-release discoveries or problems that may already have
  63       been found and fixed.</para>
  64
  65     <para>Any version of this errata document actually distributed
  66       with the release (for example, on a CDROM distribution) will be
  67       out of date by definition, but other copies are kept updated on
  68       the Internet and should be consulted as the <quote>current
  69         errata</quote> for this release.  These other copies of the
  70       errata are located at <link
  71         xlink:href="https://www.FreeBSD.org/releases/" />, plus any
  72       sites which keep up-to-date mirrors of this location.</para>
  73
  74     <para>Source and binary snapshots of &os; &release.branch; also
  75       contain up-to-date copies of this document (as of the time of
  76       the snapshot).</para>
  77
  78     <para>For a list of all &os; CERT security advisories, see <link
  79         xlink:href="https://www.FreeBSD.org/security/"/>.</para>
  80   </sect1>
  81
  82   <sect1 xml:id="security">
  83     <title>Security Advisories</title>
  84
  85     &security;
  86   </sect1>
  87
  88   <sect1 xml:id="errata">
  89     <title>Errata Notices</title>
  90
  91     &errata;
  92   </sect1>
  93
  94   <sect1 xml:id="open-issues">
  95     <title>Open Issues</title>
  96
  97     <itemizedlist>
  98       <listitem>
  99         <para>&os;/&arch.i386; installed on ZFS may crash during boot
 100           when the ZFS pool mount is attempted while booting an
 101           unmodified <literal>GENERIC</literal> kernel.</para>
 102
 103         <para>A system tunable has been added as of revision
 104           <literal>r286584</literal> to make the
 105           <literal>kern.kstack_pages</literal> tunable configurable
 106           without recompiling the kernel.</para>
 107
 108         <para>To mitigate system crashes with such configurations,
 109           choose <literal>Escape to loader prompt</literal> in the
 110           boot menu and enter the following lines from &man.loader.8;
 111           prompt, after an <literal>OK</literal>:</para>
 112
 113         <screen>set kern.kstack_pages=4
 114 boot</screen>
 115
 116         <para>Add this line to
 117           <filename>/boot/loader.conf</filename> for the change to
 118           persist across reboots:</para>
 119
 120         <programlisting>kern.kstack_pages=4</programlisting>
 121       </listitem>
 122
 123       <listitem>
 124         <para>[2017-07-21] Due to a bug in earlier versions of
 125           &man.clang.1; that is difficult to work around in the
 126           upgrade process, to upgrade the system from sources via
 127           buildworld to -CURRENT or &release;, it is necessary to
 128           upgrade machines running 9.x to at least revision r286035,
 129           or machines running 10.x to revision r286033.  Source-based
 130           upgrades from 10.3-RELEASE are not affected.  This differs
 131           from the historical situation where one could generally
 132           upgrade from anywhere on earlier stable branches, so caution
 133           should be exercised.</para>
 134       </listitem>
 135
 136       <listitem>
 137         <para>[2017-07-25] &os;/&arch.arm64; currently lacks
 138           <acronym>EFI</acronym> real-time clock
 139           (<acronym>RTC</acronym>) support, which may cause the system
 140           to boot with the wrong time set.</para>
 141
 142         <para>As a workaround, either enable &man.ntpdate.8; or
 143           include <literal>ntpd_sync_on_start="YES"</literal> in
 144           &man.rc.conf.5;.</para>
 145       </listitem>
 146
 147       <listitem>
 148         <para>[2017-07-25] A late issue was discovered with
 149           &os;/&arch.arm64; and &quot;root on
 150           <acronym>ZFS</acronym>&quot; installations where the root
 151           <acronym>ZFS</acronym> pool would fail to be located.</para>
 152
 153         <para>There currently is no workaround.</para>
 154       </listitem>
 155
 156       <listitem>
 157         <para>[2017-07-26] Note for those upgrading from 11.1-RC2 in
 158           <application>VirtualBox</application>:</para>
 159
 160         <para>If system panics were experienced when upgrading from
 161           11.1-RC1 to 11.1-RC2, and the <filename
 162             role="package">emulators/virtualbox-ose-additions{,-nox11}</filename>
 163           port was built locally as a resolution, the port will either
 164           need to be rebuilt when upgrading from 11.1-RC2 to
 165           11.1-RELEASE, or reinstall the package from the pkg(8)
 166           mirrors using either:</para>
 167
 168         <screen> &prompt.root; <userinput>pkg install -f virtualbox-ose-additions</userinput></screen>
 169
 170         <para>or</para>
 171
 172         <screen> &prompt.root; <userinput>pkg install -f virtualbox-ose-additions-nox11</userinput></screen>
 173
 174         <para>To ensure the system does not panic after rebooting into
 175           the updated kernel, it is recommended to disable the
 176           <literal>vboxguest</literal> service in &man.rc.conf.5;
 177           prior to rebooting the system if possible, or use
 178           &man.pkg.8; to forcefully reinstall the package.</para>
 179
 180         <para>Systems being upgraded from 11.1-RC1 and earlier and
 181           11.1-RC3 to 11.1-RELEASE should be unaffected.</para>
 182       </listitem>
 183
 184       <listitem>
 185         <para>[2017-07-27] The release notes erroneously state
 186           revision <literal>r315330</literal> was sponsored by Rubicon
 187           Communications, LLC (Netgate), when in fact this work was
 188           done by Hiroki Mori independently.</para>
 189       </listitem>
 190
 191       <listitem>
 192         <para>[2017-08-09] The release notes stated the
 193           &man.ruptime.1;, &man.rwho.1;, and &man.rwhod.8; utilities
 194           have been marked &quot;deprecated&quot;, however this change
 195           was reversed in 12.0-CURRENT.</para>
 196
 197         <para>The other utilities mentioned in the entry in the
 198           release notes, however, are unchanged.</para>
 199       </listitem>
 200
 201       <listitem>
 202         <para>[2017-11-06] An issue with &os; virtual machines with
 203           <application>vagrant</application> was discovered that
 204           affects the <application>VirtualBox</application> where the
 205           virtual machine will not start on the initial boot invoked
 206           with <literal>vagrant up</literal>.</para>
 207
 208         <para>The issue is due to the virtual machine
 209           <acronym>MAC</acronym> being unset, as &os; does not provide
 210           a default <filename>Vagrantfile</filename>.</para>
 211
 212         <para>It has been observed, however, that a subsequent
 213           invocation of <literal>vagrant up</literal> will allow the
 214           virtual machine to successfully boot, allowing access via
 215           <literal>vagrant ssh</literal>.</para>
 216       </listitem>
 217     </itemizedlist>
 218   </sect1>
 219
 220   <sect1 xml:id="late-news">
 221     <title>Late-Breaking News</title>
 222
 223     <para>No news.</para>
 224   </sect1>
 225 </article>