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>2016</year>
  27
  28       <holder role="mailto:doc@FreeBSD.org">The &os; Documentation Project</holder>
  29     </copyright>
  30
  31     <legalnotice xml:id="trademarks" role="trademarks">
  32       &tm-attrib.freebsd;
  33       &tm-attrib.intel;
  34       &tm-attrib.sparc;
  35       &tm-attrib.general;
  36     </legalnotice>
  37
  38     <abstract>
  39       <para>This document lists errata items for &os; &release;,
  40         containing significant information discovered after the release
  41         or too late in the release cycle to be otherwise included in the
  42         release documentation.
  43         This information includes security advisories, as well as news
  44         relating to the software or documentation that could affect its
  45         operation or usability.  An up-to-date version of this document
  46         should always be consulted before installing this version of
  47         &os;.</para>
  48
  49       <para>This errata document for &os; &release;
  50         will be maintained until the release of &os; &release.next;.</para>
  51     </abstract>
  52   </info>
  53
  54   <sect1 xml:id="intro">
  55     <title>Introduction</title>
  56
  57     <para>This errata document contains <quote>late-breaking news</quote>
  58       about &os; &release;
  59       Before installing this version, it is important to consult this
  60       document to learn about any post-release discoveries or problems
  61       that may already have been found and fixed.</para>
  62
  63     <para>Any version of this errata document actually distributed
  64       with the release (for example, on a CDROM distribution) will be
  65       out of date by definition, but other copies are kept updated on
  66       the Internet and should be consulted as the <quote>current
  67       errata</quote> for this release.  These other copies of the
  68       errata are located at
  69       <link xlink:href="https://www.FreeBSD.org/releases/" />,
  70       plus any sites
  71       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
  78       <link 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>An issue was discovered with Amazon&reg; EC2&trade;
  99           images which would cause the virtual machine to hang during
 100           boot when upgrading from previous FreeBSD versions. New
 101           EC2&trade; installations are not affected, but exisiting
 102           installations running earlier releases are advised to wait
 103           until the issue is resolved in an Errata Notice before
 104           upgrading.  An Errata Notice to address this is planned
 105           following the release.</para>
 106       </listitem>
 107
 108       <listitem>
 109         <para>&os;/&arch.i386; installed on ZFS may crash during boot
 110           when the ZFS pool mount is attempted while booting an
 111           unmodified <literal>GENERIC</literal> kernel.</para>
 112
 113         <para>A system tunable has been added as of revision
 114           <literal>r286584</literal> to make the
 115           <literal>kern.kstack_pages</literal> tunable configurable
 116           without recompiling the kernel.</para>
 117
 118         <para>To mitigate system crashes with such configurations,
 119           chose <literal>Escape to loader prompt</literal> in the boot
 120           menu and enter the following lines from &man.loader.8;
 121           prompt, after an <literal>OK</literal>:</para>
 122
 123         <screen>set kern.kstack_pages=4
 124 boot</screen>
 125
 126         <para>Add this line to
 127           <filename>/boot/loader.conf</filename> for the change to
 128           persist across reboots:</para>
 129
 130         <programlisting>kern.kstack_pages=4</programlisting>
 131       </listitem>
 132
 133       <listitem>
 134         <para>A bug was diagnosed in interaction of the
 135           <literal>pmap_activate()</literal> function and
 136           <acronym>TLB</acronym> shootdown <acronym>IPI</acronym>
 137           handler on amd64 systems which have <acronym>PCID</acronym>
 138           features but do not implement the <acronym>INVPCID</acronym>
 139           instruction.  On such machines, such as SandyBridge&trade;
 140           and IvyBridge&trade; microarchitectures, set the loader
 141           tunable <literal>vm.pmap.pcid_enabled=0</literal> during
 142           boot:</para>
 143
 144         <screen>set vm.pmap.pcid_enabled=0
 145 boot</screen>
 146
 147         <para>Add this line to
 148           <filename>/boot/loader.conf</filename> for the change to
 149           persist across reboots:</para>
 150
 151         <para>To check if the system is affected, check
 152           &man.dmesg.8; for <acronym>PCID</acronym> listed in the
 153           &quot;Features2&quot;, and absence of
 154           <acronym>INVPCID</acronym> in the &quot;Structured Extended
 155           Features&quot;.  If the <acronym>PCID</acronym> feature is
 156           not present, or <acronym>INVPCID</acronym> is present,
 157           system is not affected.</para>
 158
 159         <programlisting>vm.pmap.pcid_enabled=0</programlisting>
 160       </listitem>
 161
 162       <listitem>
 163         <para>The Release Notes erroneously states the
 164           <literal>WITH_SYSTEM_COMPILER</literal> &man.src.conf.5;
 165           option is enabled by default, however this was disabled
 166           prior to the final release build.</para>
 167       </listitem>
 168
 169       <listitem>
 170         <para>The release announcement stated &quot;Wireless support
 171           for 802.11n has been added.&quot;  This was intended to
 172           state &quot;Wireless support for 802.11n has been added for
 173           additional wireless network drivers.&quot;</para>
 174       </listitem>
 175
 176       <listitem>
 177         <para>Some release notes pertaining to the Cavium ThunderX
 178           platform (the &os;/&arch.arm64; reference platform) were
 179           omitted:</para>
 180
 181         <itemizedlist>
 182           <listitem>
 183             <para revision="289550" contrib="sponsor"
 184               sponsor="&cavium;">Support for the Cavium Virtualized
 185               NIC ethernet driver has been added.</para>
 186           </listitem>
 187
 188           <listitem>
 189             <para revision="286919" contrib="sponsor"
 190               sponsor="&cavium;">Support for the GICv3 and ITS device
 191               drivers has been added.</para>
 192           </listitem>
 193
 194           <listitem>
 195             <para revision="296308" contrib="sponsor"
 196               sponsor="&cavium;">Support for PCI Enhanced Allocation
 197               support has been added.</para>
 198           </listitem>
 199         </itemizedlist>
 200       </listitem>
 201     </itemizedlist>
 202   </sect1>
 203
 204   <sect1 xml:id="late-news">
 205     <title>Late-Breaking News</title>
 206
 207     <para>No news.</para>
 208   </sect1>
 209 </article>