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 security SYSTEM "../../share/xml/security.xml">
   8 <!ENTITY errata SYSTEM "../../share/xml/errata.xml">
   9 ]>
  10
  11 <article xmlns="http://docbook.org/ns/docbook"
  12          xmlns:xlink="http://www.w3.org/1999/xlink"
  13          version="5.0">
  14   <info>
  15     <title>&os; &release; Errata </title>
  16
  17     <author><orgname>The &os; Project</orgname></author>
  18
  19     <pubdate>$FreeBSD$</pubdate>
  20
  21     <copyright>
  22       <year>2016</year>
  23
  24       <holder role="mailto:doc@FreeBSD.org">The &os; Documentation Project</holder>
  25     </copyright>
  26
  27     <legalnotice xml:id="trademarks" role="trademarks">
  28       &tm-attrib.freebsd;
  29       &tm-attrib.intel;
  30       &tm-attrib.sparc;
  31       &tm-attrib.general;
  32     </legalnotice>
  33
  34     <abstract>
  35       <para>This document lists errata items for &os; &release;,
  36         containing significant information discovered after the release
  37         or too late in the release cycle to be otherwise included in the
  38         release documentation.
  39         This information includes security advisories, as well as news
  40         relating to the software or documentation that could affect its
  41         operation or usability.  An up-to-date version of this document
  42         should always be consulted before installing this version of
  43         &os;.</para>
  44
  45       <para>This errata document for &os; &release;
  46         will be maintained until the release of &os; &release.next;.</para>
  47     </abstract>
  48   </info>
  49
  50   <sect1 xml:id="intro">
  51     <title>Introduction</title>
  52
  53     <para>This errata document contains <quote>late-breaking news</quote>
  54       about &os; &release;
  55       Before installing this version, it is important to consult this
  56       document to learn about any post-release discoveries or problems
  57       that may already have been found and fixed.</para>
  58
  59     <para>Any version of this errata document actually distributed
  60       with the release (for example, on a CDROM distribution) will be
  61       out of date by definition, but other copies are kept updated on
  62       the Internet and should be consulted as the <quote>current
  63       errata</quote> for this release.  These other copies of the
  64       errata are located at
  65       <link xlink:href="https://www.FreeBSD.org/releases/" />,
  66       plus any sites
  67       which keep up-to-date mirrors of this location.</para>
  68
  69     <para>Source and binary snapshots of &os; &release.branch; also
  70       contain up-to-date copies of this document (as of the time of
  71       the snapshot).</para>
  72
  73     <para>For a list of all &os; CERT security advisories, see
  74       <link xlink:href="https://www.FreeBSD.org/security/"/>.</para>
  75   </sect1>
  76
  77   <sect1 xml:id="security">
  78     <title>Security Advisories</title>
  79
  80     &security;
  81   </sect1>
  82
  83   <sect1 xml:id="errata">
  84     <title>Errata Notices</title>
  85
  86     &errata;
  87   </sect1>
  88
  89   <sect1 xml:id="open-issues">
  90     <title>Open Issues</title>
  91
  92     <itemizedlist>
  93       <listitem>
  94         <para>An issue was discovered with Amazon&reg; EC2&trade;
  95           images which would cause the virtual machine to hang during
  96           boot when upgrading from previous FreeBSD versions. New
  97           EC2&trade; installations are not affected, but exisiting
  98           installations running earlier releases are advised to wait
  99           until the issue is resolved in an Errata Notice before
 100           upgrading.  An Errata Notice to address this is planned
 101           following the release.</para>
 102       </listitem>
 103
 104       <listitem>
 105         <para>&os;/&arch.i386; installed on ZFS may crash during boot
 106           when the ZFS pool mount is attempted while booting an
 107           unmodified <literal>GENERIC</literal> kernel.</para>
 108
 109         <para>A system tunable has been added as of revision
 110           <literal>r286584</literal> to make the
 111           <literal>kern.kstack_pages</literal> tunable configurable
 112           without recompiling the kernel.</para>
 113
 114         <para>To mitigate system crashes with such configurations,
 115           chose <literal>Escape to loader prompt</literal> in the boot
 116           menu and enter the following lines from &man.loader.8;
 117           prompt, after an <literal>OK</literal>:</para>
 118
 119         <screen>set kern.kstack_pages=4
 120 boot</screen>
 121
 122         <para>Add this line to
 123           <filename>/boot/loader.conf</filename> for the change to
 124           persist across reboots:</para>
 125
 126         <programlisting>kern.kstack_pages=4</programlisting>
 127       </listitem>
 128
 129       <listitem>
 130         <para>A bug was diagnosed in interaction of the
 131           <literal>pmap_activate()</literal> function and
 132           <acronym>TLB</acronym> shootdown <acronym>IPI</acronym>
 133           handler on amd64 systems which have <acronym>PCID</acronym>
 134           features but do not implement the <acronym>INVPCID</acronym>
 135           instruction.  On such machines, such as SandyBridge&trade;
 136           and IvyBridge&trade; microarchitectures, set the loader
 137           tunable <literal>vm.pmap.pcid_enabled=0</literal> during
 138           boot:</para>
 139
 140         <screen>set vm.pmap.pcid_enabled=0
 141 boot</screen>
 142
 143         <para>Add this line to
 144           <filename>/boot/loader.conf</filename> for the change to
 145           persist across reboots:</para>
 146
 147         <para>To check if the system is affected, check
 148           &man.dmesg.8; for <acronym>PCID</acronym> listed in the
 149           &quot;Features2&quot;, and absence of
 150           <acronym>INVPCID</acronym> in the &quot;Structured Extended
 151           Features&quot;.  If the <acronym>PCID</acronym> feature is
 152           not present, or <acronym>INVPCID</acronym> is present,
 153           system is not affected.</para>
 154
 155         <programlisting>vm.pmap.pcid_enabled=0</programlisting>
 156       </listitem>
 157
 158       <listitem>
 159         <para>The Release Notes erroneously states the
 160           <literal>WITH_SYSTEM_COMPILER</literal> &man.src.conf.5;
 161           option is enabled by default, however this was disabled
 162           prior to the final release build.</para>
 163       </listitem>
 164
 165       <listitem>
 166         <para>The release announcement stated &quot;Wireless support
 167           for 802.11n has been added.&quot;  This was intended to
 168           state &quot;Wireless support for 802.11n has been added for
 169           additional wireless network drivers.&quot;</para>
 170       </listitem>
 171     </itemizedlist>
 172   </sect1>
 173
 174   <sect1 xml:id="late-news">
 175     <title>Late-Breaking News</title>
 176
 177     <para>No news.</para>
 178   </sect1>
 179 </article>