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">
7 <!ENTITY % sponsor PUBLIC "-//FreeBSD//ENTITIES Sponsor Specification//EN" "sponsor.ent">
9 <!ENTITY % vendor PUBLIC "-//FreeBSD//ENTITIES Vendor Specification//EN" "vendor.ent">
11 <!ENTITY security SYSTEM "../../share/xml/security.xml">
12 <!ENTITY errata SYSTEM "../../share/xml/errata.xml">
15 <article xmlns="http://docbook.org/ns/docbook"
16 xmlns:xlink="http://www.w3.org/1999/xlink"
20 <title>&os; &release; Errata</title>
22 <author><orgname>The &os; Project</orgname></author>
24 <pubdate>$FreeBSD$</pubdate>
29 <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
33 <legalnotice xml:id="trademarks" role="trademarks">
41 <para>This document lists errata items for &os; &release;,
42 containing significant information discovered after the
43 release or too late in the release cycle to be otherwise
44 included in the release documentation. This information
45 includes security advisories, as well as news relating to the
46 software or documentation that could affect its operation or
47 usability. An up-to-date version of this document should
48 always be consulted before installing this version of
51 <para>This errata document for &os; &release; will be maintained
52 until the release of &os; &release.next;.</para>
56 <sect1 xml:id="intro">
57 <title>Introduction</title>
59 <para>This errata document contains <quote>late-breaking
60 news</quote> about &os; &release;. Before installing this
61 version, it is important to consult this document to learn about
62 any post-release discoveries or problems that may already have
63 been found and fixed.</para>
65 <para>Any version of this errata document actually distributed
66 with the release (for example, on a CDROM distribution) will be
67 out of date by definition, but other copies are kept updated on
68 the Internet and should be consulted as the <quote>current
69 errata</quote> for this release. These other copies of the
70 errata are located at <link
71 xlink:href="https://www.FreeBSD.org/releases/" />, plus any
72 sites which keep up-to-date mirrors of this location.</para>
74 <para>Source and binary snapshots of &os; &release.branch; also
75 contain up-to-date copies of this document (as of the time of
78 <para>For a list of all &os; CERT security advisories, see <link
79 xlink:href="https://www.FreeBSD.org/security/"/>.</para>
82 <sect1 xml:id="security">
83 <title>Security Advisories</title>
88 <sect1 xml:id="errata">
89 <title>Errata Notices</title>
94 <sect1 xml:id="open-issues">
95 <title>Open Issues</title>
99 <para>&os;/&arch.i386; installed on ZFS may crash during boot
100 when the ZFS pool mount is attempted while booting an
101 unmodified <literal>GENERIC</literal> kernel.</para>
103 <para>A system tunable has been added as of revision
104 <literal>r286584</literal> to make the
105 <literal>kern.kstack_pages</literal> tunable configurable
106 without recompiling the kernel.</para>
108 <para>To mitigate system crashes with such configurations,
109 choose <literal>Escape to loader prompt</literal> in the
110 boot menu and enter the following lines from &man.loader.8;
111 prompt, after an <literal>OK</literal>:</para>
113 <screen>set kern.kstack_pages=4
116 <para>Add this line to
117 <filename>/boot/loader.conf</filename> for the change to
118 persist across reboots:</para>
120 <programlisting>kern.kstack_pages=4</programlisting>
124 <para>[2017-07-25] &os;/&arch.arm64; currently lacks
125 <acronym>EFI</acronym> real-time clock
126 (<acronym>RTC</acronym>) support, which may cause the system
127 to boot with the wrong time set.</para>
129 <para>As a workaround, either enable &man.ntpdate.8; or
130 include <literal>ntpd_sync_on_start="YES"</literal> in
131 &man.rc.conf.5;.</para>
135 <para>[2017-07-25] A late issue was discovered with
136 &os;/&arch.arm64; and "root on
137 <acronym>ZFS</acronym>" installations where the root
138 <acronym>ZFS</acronym> pool would fail to be located.</para>
140 <para>There currently is no workaround.</para>
144 <para>[2017-11-06] An issue with &os; virtual machines with
145 <application>vagrant</application> was discovered that
146 affects the <application>VirtualBox</application> where the
147 virtual machine will not start on the initial boot invoked
148 with <literal>vagrant up</literal>.</para>
150 <para>The issue is due to the virtual machine
151 <acronym>MAC</acronym> being unset, as &os; does not provide
152 a default <filename>Vagrantfile</filename>.</para>
154 <para>It has been observed, however, that a subsequent
155 invocation of <literal>vagrant up</literal> will allow the
156 virtual machine to successfully boot, allowing access via
157 <literal>vagrant ssh</literal>.</para>
161 <para>[2018-06-21] An issue had been discovered late in the
162 release cycle where removing <acronym>ZFS</acronym> vdevs
163 from a pool under certain conditions would cause a system
164 crash when &man.zfsd.8; is enabled in
165 &man.rc.conf.5;.</para>
167 <para>At present, it is believed to be limited to removal of
168 a <literal>mirror</literal> vdev from a pool consisting of
169 multiple <literal>mirror</literal> vdevs.</para>
171 <para>See <acronym>PR</acronym> <link
172 xlink:href="https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=228750">228750</link>
173 for more information and updates as the issue is
178 <para>[2018-06-26] An issue had been discovered late in the
179 release cycle where a system crash could occur after
181 role="package">emulators/virtualbox-ose</filename> from
182 upstream package mirrors via &man.pkg.8;.</para>
184 <para>Building <filename
185 role="package">emulators/virtualbox-ose</filename> from
186 the &man.ports.7; collection has been observed to work
187 around the crash.</para>
189 <para>See <acronym>PR</acronym> <link
190 xlink:href="https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=228535">228535</link>
191 for more information.</para>
195 <para>[2018-06-26] It was discovered after the <filename
196 class="directory">releng/11.2</filename> branch was tagged
197 for &os; 11.2-RELEASE that a few device drivers were
198 missing from the <link
199 xlink:href="https://www.FreeBSD.org/releases/11.2R/hardware.html">hardware</link>
200 page. The missing drivers, &man.alc.4;, &man.cxgbev.4;,
201 &man.liquidio.4;, and &man.mos.4; were added to the
203 xlink:href="https://www.FreeBSD.org/relnotes/11-STABLE/hardware/support.html">hardware
208 <para>[2018-06-26] The <acronym>URL</acronym> to the
209 instructions for source-based upgrades in
210 <filename>UPDATING</filename> incorrectly points to a page
211 that no longer exists. The correct URL is <link
212 xlink:href="https://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html" />.</para>
217 <sect1 xml:id="late-news">
218 <title>Late-Breaking News</title>
220 <para>No news.</para>