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