path: root/release/doc/en_US.ISO8859-1/errata/article.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
        "http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd" [
<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN"
        "http://www.FreeBSD.org/release/XML/release.ent">
%release;
<!ENTITY % sponsor PUBLIC "-//FreeBSD//ENTITIES Sponsor Specification//EN" "sponsor.ent">
%sponsor;
<!ENTITY % vendor PUBLIC "-//FreeBSD//ENTITIES Vendor Specification//EN" "vendor.ent">
%vendor;
<!ENTITY security SYSTEM "../../share/xml/security.xml">
<!ENTITY errata SYSTEM "../../share/xml/errata.xml">
]>

<article xmlns="http://docbook.org/ns/docbook"
	 xmlns:xlink="http://www.w3.org/1999/xlink"
	 version="5.0">
  <info>
    <title>&os; &release; Errata </title>

    <author><orgname>The &os; Project</orgname></author>

    <pubdate>$FreeBSD$</pubdate>

    <copyright>
      <year>2016</year>

      <holder role="mailto:doc@FreeBSD.org">The &os; Documentation Project</holder>
    </copyright>

    <legalnotice xml:id="trademarks" role="trademarks">
      &tm-attrib.freebsd;
      &tm-attrib.intel;
      &tm-attrib.sparc;
      &tm-attrib.general;
    </legalnotice>

    <abstract>
      <para>This document lists errata items for &os; &release;,
	containing significant information discovered after the release
	or too late in the release cycle to be otherwise included in the
	release documentation.
	This information includes security advisories, as well as news
	relating to the software or documentation that could affect its
	operation or usability.  An up-to-date version of this document
	should always be consulted before installing this version of
	&os;.</para>

      <para>This errata document for &os; &release;
	will be maintained until the release of &os; &release.next;.</para>
    </abstract>
  </info>

  <sect1 xml:id="intro">
    <title>Introduction</title>

    <para>This errata document contains <quote>late-breaking news</quote>
      about &os; &release;
      Before installing this version, it is important to consult this
      document to learn about any post-release discoveries or problems
      that may already have been found and fixed.</para>

    <para>Any version of this errata document actually distributed
      with the release (for example, on a CDROM distribution) will be
      out of date by definition, but other copies are kept updated on
      the Internet and should be consulted as the <quote>current
      errata</quote> for this release.  These other copies of the
      errata are located at
      <link xlink:href="https://www.FreeBSD.org/releases/" />,
      plus any sites
      which keep up-to-date mirrors of this location.</para>

    <para>Source and binary snapshots of &os; &release.branch; also
      contain up-to-date copies of this document (as of the time of
      the snapshot).</para>

    <para>For a list of all &os; CERT security advisories, see
      <link xlink:href="https://www.FreeBSD.org/security/"/>.</para>
  </sect1>

  <sect1 xml:id="security">
    <title>Security Advisories</title>

    &security;
  </sect1>

  <sect1 xml:id="errata">
    <title>Errata Notices</title>

    &errata;
  </sect1>

  <sect1 xml:id="open-issues">
    <title>Open Issues</title>

    <itemizedlist>
      <listitem>
	<para>An issue was discovered with Amazon&reg; EC2&trade;
	  images which would cause the virtual machine to hang during
	  boot when upgrading from previous FreeBSD versions.  New
	  EC2&trade; installations are not affected, but existing
	  installations running earlier releases are advised to wait
	  until the issue is resolved in an Errata Notice before
	  upgrading.  An Errata Notice to address this is planned
	  following the release.</para>
      </listitem>

      <listitem>
	<para>&os;/&arch.i386; installed on ZFS may crash during boot
	  when the ZFS pool mount is attempted while booting an
	  unmodified <literal>GENERIC</literal> kernel.</para>

	<para>A system tunable has been added as of revision
	  <literal>r286584</literal> to make the
	  <literal>kern.kstack_pages</literal> tunable configurable
	  without recompiling the kernel.</para>

	<para>To mitigate system crashes with such configurations,
	  chose <literal>Escape to loader prompt</literal> in the boot
	  menu and enter the following lines from &man.loader.8;
	  prompt, after an <literal>OK</literal>:</para>

	<screen>set kern.kstack_pages=4
boot</screen>

	<para>Add this line to
	  <filename>/boot/loader.conf</filename> for the change to
	  persist across reboots:</para>

	<programlisting>kern.kstack_pages=4</programlisting>
      </listitem>

      <listitem>
	<para>A bug was diagnosed in interaction of the
	  <literal>pmap_activate()</literal> function and
	  <acronym>TLB</acronym> shootdown <acronym>IPI</acronym>
	  handler on amd64 systems which have <acronym>PCID</acronym>
	  features but do not implement the <acronym>INVPCID</acronym>
	  instruction.  On such machines, such as SandyBridge&trade;
	  and IvyBridge&trade; microarchitectures, set the loader
	  tunable <literal>vm.pmap.pcid_enabled=0</literal> during
	  boot:</para>

	<screen>set vm.pmap.pcid_enabled=0
boot</screen>

	<para>Add this line to
	  <filename>/boot/loader.conf</filename> for the change to
	  persist across reboots:</para>

	<para>To check if the system is affected, check
	  &man.dmesg.8; for <acronym>PCID</acronym> listed in the
	  &quot;Features2&quot;, and absence of
	  <acronym>INVPCID</acronym> in the &quot;Structured Extended
	  Features&quot;.  If the <acronym>PCID</acronym> feature is
	  not present, or <acronym>INVPCID</acronym> is present,
	  system is not affected.</para>

	<programlisting>vm.pmap.pcid_enabled=0</programlisting>
      </listitem>

      <listitem>
	<para>The Release Notes erroneously states the
	  <literal>WITH_SYSTEM_COMPILER</literal> &man.src.conf.5;
	  option is enabled by default, however this was disabled
	  prior to the final release build.</para>
      </listitem>

      <listitem>
	<para>The release announcement stated &quot;Wireless support
	  for 802.11n has been added.&quot;  This was intended to
	  state &quot;Wireless support for 802.11n has been added for
	  additional wireless network drivers.&quot;</para>
      </listitem>

      <listitem>
	<para>Some release notes pertaining to the Cavium ThunderX
	  platform (the &os;/&arch.arm64; reference platform) were
	  omitted:</para>

	<itemizedlist>
	  <listitem>
	    <para revision="289550" contrib="sponsor"
	      sponsor="&cavium;">Support for the Cavium Virtualized
	      NIC ethernet driver has been added.</para>
	  </listitem>

	  <listitem>
	    <para revision="286919" contrib="sponsor"
	      sponsor="&cavium;">Support for the GICv3 and ITS device
	      drivers has been added.</para>
	  </listitem>

	  <listitem>
	    <para revision="296308" contrib="sponsor"
	      sponsor="&cavium;">Support for PCI Enhanced Allocation
	      support has been added.</para>
	  </listitem>
	</itemizedlist>
      </listitem>

      <listitem>
	<para revision="293860">[2016-10-20] Several recent Dell
	  systems fail to find a bootable disk when the system boots
	  in Legacy/BIOS/CSM mode, the boot disk is partitioned with
	  <acronym>GPT</acronym>, and the Active flag in the
	  Protective <acronym>MBR</acronym> is not set.  To work
	  around this issue, either configure the system to boot in
	  <acronym>UEFI</acronym> mode, or choose the &quot;GPT
	  + Active&quot; scheme.</para>
      </listitem>

      <listitem>
	<para>[2016-10-21] Support for <literal>sha512</literal> and
	  <literal>skein</literal> checksumming has been added to the
	  <acronym>ZFS</acronym> filesystem.  This was not mentioned
	  in the release notes.</para>

	<para>Systems being upgraded from earlier &os; releases with
	  <acronym>ZFS</acronym> will see a message in <literal>zpool
	    status</literal> output noting the pool is not at the
	  latest version, and some features may not be enabled.
	  Additional instructions on how to update
	  <acronym>ZFS</acronym> pools to the latest version and
	  update the boot blocks for all boot drives in the pool will
	  also be provided in the output.</para>

	<para>This information is also documented in
	  <filename>/usr/src/UPDATING</filename>, which is included if
	  the <literal>src</literal> component is selected during
	  installation.</para>
      </listitem>

      <listitem>
	<para>[2016-10-21] The size of the <acronym>GPT</acronym>
	  enabled <acronym>ZFS</acronym> boot blocks
	  (<filename>/boot/gptzfsboot</filename>) has increased past
	  64K.  Systems upgraded from older releases may experience
	  a problem where the size of the existing
	  &quot;freebsd-boot&quot; partition is too small to hold the
	  new <filename>gptzfsboot</filename>.</para>

	<para>Systems where the boot partition is immediately followed
	  by the swap partition, such as those installed via
	  &man.bsdinstall.8;, can resize the swap partition slightly
	  using the &man.gpart.8; <literal>resize</literal> command,
	  so space can be reclaimed to increase the size of the
	  freebsd-boot partition.</para>
      </listitem>

      <listitem>
	<para>[2016-10-21] Due to a bug in earlier versions of
	  &man.clang.1; that is difficult to work around in the
	  upgrade process, to upgrade the system from sources via
	  buildworld to -CURRENT or &release;, it is necessary to
	  upgrade machines running 9.x to at least revision r286035,
	  or machines running 10.x to revision r286033.  Source-based
	  upgrades from 10.3-RELEASE are not affected.  This differs
	  from the historical situation where one could generally
	  upgrade from anywhere on earlier stable branches, so caution
	  should be exercised.</para>
      </listitem>
    </itemizedlist>
  </sect1>

  <sect1 xml:id="late-news">
    <title>Late-Breaking News</title>

    <para>No news.</para>
  </sect1>
</article>