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: stable/11/release/doc/en_US.ISO8859-1/errata/article.xml 322313 2017-08-09 12:55:58Z gjb $</pubdate>

    <copyright>
      <year>2017</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>&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,
	  choose <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>[2017-07-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>

      <listitem>
	<para>[2017-07-25] &os;/&arch.arm64; currently lacks
	  <acronym>EFI</acronym> real-time clock
	  (<acronym>RTC</acronym>) support, which may cause the system
	  to boot with the wrong time set.</para>

	<para>As a workaround, either enable &man.ntpdate.8; or
	  include <literal>ntpd_sync_on_start="YES"</literal> in
	  &man.rc.conf.5;.</para>
      </listitem>

      <listitem>
	<para>[2017-07-25] A late issue was discovered with
	  &os;/&arch.arm64; and &quot;root on
	  <acronym>ZFS</acronym>&quot; installations where the root
	  <acronym>ZFS</acronym> pool would fail to be located.</para>

	<para>There currently is no workaround.</para>
      </listitem>

      <listitem>
	<para>[2017-07-26] Note for those upgrading from 11.1-RC2 in
	  <application>VirtualBox</application>:</para>

	<para>If system panics were experienced when upgrading from
	  11.1-RC1 to 11.1-RC2, and the <filename
	    role="package">emulators/virtualbox-ose-additions{,-nox11}</filename>
	  port was built locally as a resolution, the port will either
	  need to be rebuilt when upgrading from 11.1-RC2 to
	  11.1-RELEASE, or reinstall the package from the pkg(8)
	  mirrors using either:</para>

	<screen> &prompt.root; <userinput>pkg install -f virtualbox-ose-additions</userinput></screen>

	<para>or</para>

	<screen> &prompt.root; <userinput>pkg install -f virtualbox-ose-additions-nox11</userinput></screen>

	<para>To ensure the system does not panic after rebooting into
	  the updated kernel, it is recommended to disable the
	  <literal>vboxguest</literal> service in &man.rc.conf.5;
	  prior to rebooting the system if possible, or use
	  &man.pkg.8; to forcefully reinstall the package.</para>

	<para>Systems being upgraded from 11.1-RC1 and earlier and
	  11.1-RC3 to 11.1-RELEASE should be unaffected.</para>
      </listitem>

      <listitem>
	<para>[2017-07-27] The release notes erroneously state
	  revision <literal>r315330</literal> was sponsored by Rubicon
	  Communications, LLC (Netgate), when in fact this work was
	  done by Hiroki Mori independently.</para>
      </listitem>

      <listitem>
	<para>[2017-08-09] The release notes stated the
	  &man.ruptime.1;, &man.rwho.1;, and &man.rwhod.8; utilities
	  have been marked &quot;deprecated&quot;, however this change
	  was reversed in 12.0-CURRENT.</para>

	<para>The other utilities mentioned in the entry in the
	  release notes, however, are unchanged.</para>
      </listitem>
    </itemizedlist>
  </sect1>

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

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