os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Add an errata.html page, generated from modified stable/10 sources

Browse source 
pending commit after 10.2-RELEASE is available.

Approved by:	re (implicit)
Sponsored by:	The FreeBSD Foundation
This commit is contained in:
Glen Barber 2015-08-06 20:53:48 +00:00
parent 1c7b96d100
commit 261b8d0bbb
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=47168
1 changed files with 113 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

113
en_US.ISO8859-1/htdocs/releases/10.2R/errata.html Normal file
View file

@ -0,0 +1,113 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /><title>FreeBSD 10.2-RELEASE Errata</title><link rel="stylesheet" type="text/css" href="docbook.css" /><link rev="made" href="mailto:doc@FreeBSD.org" /><meta name="generator" content="DocBook XSL Stylesheets V1.78.1" /><meta name="description" content="This document lists errata items for FreeBSD 10.2-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 FreeBSD. This errata document for FreeBSD 10.2-RELEASE will be maintained until the release of FreeBSD 10.3-RELEASE." /><script xmlns="" type="text/javascript" src="/layout/js/google.js"></script></head><body><div class="article"><div xmlns="" class="titlepage"><div><div><h1 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="idp60884336"></a>FreeBSD 10.2-RELEASE Errata </h1></div><div><div xmlns="http://www.w3.org/1999/xhtml" class="author"><h3 class="author"><span class="orgname">The FreeBSD Project</span></h3></div></div><div><p xmlns="http://www.w3.org/1999/xhtml" class="copyright">Copyright © 2015 The FreeBSD Documentation
Project</p></div><div><div xmlns="http://www.w3.org/1999/xhtml" class="legalnotice"><a id="trademarks"></a><p xmlns="http://www.w3.org/TR/xhtml1/transitional">FreeBSD is a registered trademark of
the FreeBSD Foundation. </p><p xmlns="http://www.w3.org/TR/xhtml1/transitional">Intel, Celeron, Centrino, Core, EtherExpress, i386,
i486, Itanium, Pentium, and Xeon are trademarks or registered
trademarks of Intel Corporation or its subsidiaries in the United
States and other countries. </p><p xmlns="http://www.w3.org/TR/xhtml1/transitional">SPARC, SPARC64, and
UltraSPARC are trademarks of SPARC International, Inc in the United
States and other countries. SPARC International, Inc owns all of the
SPARC trademarks and under licensing agreements allows the proper use
of these trademarks by its members. </p><p xmlns="http://www.w3.org/TR/xhtml1/transitional">Many of the designations used by
manufacturers and sellers to distinguish their products are claimed
as trademarks. Where those designations appear in this document,
and the FreeBSD Project was aware of the trademark claim, the
designations have been followed by the <span xmlns="http://www.w3.org/1999/xhtml" class="quote">&#8220;<span class="quote">&#8482;</span>&#8221;</span> or the
<span xmlns="http://www.w3.org/1999/xhtml" class="quote">&#8220;<span class="quote">®</span>&#8221;</span> symbol. </p></div></div><div>Last modified on 2015-04-01 by gjb.</div><div><div xmlns="http://www.w3.org/1999/xhtml" class="abstract"><div class="abstract-title">Abstract</div><p xmlns="http://www.w3.org/TR/xhtml1/transitional">This document lists errata items for FreeBSD 10.2-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
FreeBSD. </p><p xmlns="http://www.w3.org/TR/xhtml1/transitional">This errata document for FreeBSD 10.2-RELEASE will be
maintained until the release of FreeBSD 10.3-RELEASE. </p></div></div></div><hr /></div><div class="toc"><div class="toc-title">Table of Contents</div><dl class="toc"><dt><span class="sect1"><a href="#intro">1. Introduction</a></span></dt><dt><span class="sect1"><a href="#security">2. Security Advisories</a></span></dt><dt><span class="sect1"><a href="#errata">3. Errata Notices</a></span></dt><dt><span class="sect1"><a href="#open-issues">4. Open Issues</a></span></dt><dt><span class="sect1"><a href="#late-news">5. Late-Breaking News</a></span></dt></dl></div><div class="sect1"><div xmlns="" class="titlepage"><div><div><h2 xmlns="http://www.w3.org/1999/xhtml" class="title" style="clear: both"><a id="intro"></a>1. Introduction</h2></div></div></div><p xmlns="http://www.w3.org/TR/xhtml1/transitional">This errata document contains <span xmlns="http://www.w3.org/1999/xhtml" class="quote">&#8220;<span class="quote">late-breaking
news</span>&#8221;</span> about FreeBSD 10.2-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. </p><p xmlns="http://www.w3.org/TR/xhtml1/transitional">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 <span xmlns="http://www.w3.org/1999/xhtml" class="quote">&#8220;<span class="quote">current
errata</span>&#8221;</span> for this release. These other copies of the
errata are located at <a xmlns="http://www.w3.org/1999/xhtml" class="link" href="http://www.FreeBSD.org/releases/" target="_top">http://www.FreeBSD.org/releases/</a>, plus any
sites which keep up-to-date mirrors of this location. </p><p xmlns="http://www.w3.org/TR/xhtml1/transitional">Source and binary snapshots of FreeBSD 10.2-STABLE also
contain up-to-date copies of this document (as of the time of
the snapshot). </p><p xmlns="http://www.w3.org/TR/xhtml1/transitional">For a list of all FreeBSD CERT security advisories, see <a xmlns="http://www.w3.org/1999/xhtml" class="link" href="http://www.FreeBSD.org/security/" target="_top">http://www.FreeBSD.org/security/</a> or <a xmlns="http://www.w3.org/1999/xhtml" class="link" href="ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/" target="_top">ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/</a>. </p></div><div class="sect1"><div xmlns="" class="titlepage"><div><div><h2 xmlns="http://www.w3.org/1999/xhtml" class="title" style="clear: both"><a id="security"></a>2. Security Advisories</h2></div></div></div><div class="informaltable"><table width="100%" border="0"><colgroup><col width="40%" /><col width="30%" /><col width="30%" /></colgroup><thead><tr><th>Advisory</th><th>Date</th><th>Topic</th></tr></thead><tbody><tr><td>No advisories.</td><td> </td><td> </td></tr></tbody></table></div></div><div class="sect1"><div xmlns="" class="titlepage"><div><div><h2 xmlns="http://www.w3.org/1999/xhtml" class="title" style="clear: both"><a id="errata"></a>3. Errata Notices</h2></div></div></div><div class="informaltable"><table width="100%" border="0"><colgroup><col width="40%" /><col width="30%" /><col width="30%" /></colgroup><thead><tr><th>Errata</th><th>Date</th><th>Topic</th></tr></thead><tbody><tr><td>No notices.</td><td> </td><td> </td></tr></tbody></table></div></div><div class="sect1"><div xmlns="" class="titlepage"><div><div><h2 xmlns="http://www.w3.org/1999/xhtml" class="title" style="clear: both"><a id="open-issues"></a>4. Open Issues</h2></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p xmlns="http://www.w3.org/TR/xhtml1/transitional">FreeBSD/i386 10.2-RELEASE running as a guest
operating system on <span xmlns="http://www.w3.org/1999/xhtml" class="application">VirtualBox</span>
can have a problem with disk I/O access. It depends on some
specific hardware configuration and does not depend on a
specific version of <span xmlns="http://www.w3.org/1999/xhtml" class="application">VirtualBox</span> or
host operating system. </p><p xmlns="http://www.w3.org/TR/xhtml1/transitional">It has been reported that instability may be present on
virtual machines running on other hypervisors, such as Xen
or KVM. </p><p xmlns="http://www.w3.org/TR/xhtml1/transitional">It causes various errors and makes FreeBSD quite unstable.
Although the cause is still unclear, disabling unmapped I/O
works as a workaround. To disable it, choose
<code xmlns="http://www.w3.org/1999/xhtml" class="literal">Escape to loader prompt</code> in the boot menu
and enter the following lines from <a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=loader&amp;sektion=8"><span class="citerefentry"><span class="refentrytitle">loader</span>(8)</span></a> prompt,
after an <code xmlns="http://www.w3.org/1999/xhtml" class="literal">OK</code>: </p><pre class="screen">set vfs.unmapped_buf_allowed=0
boot</pre><p xmlns="http://www.w3.org/TR/xhtml1/transitional">Note that the following line has to be added to
<code xmlns="http://www.w3.org/1999/xhtml" class="filename">/boot/loader.conf</code> after a boot. It
disables unmapped I/O at every boot: </p><pre class="programlisting">vfs.unmapped_buf_allowed=0</pre></li><li class="listitem"><p xmlns="http://www.w3.org/TR/xhtml1/transitional">FreeBSD/i386 10.2-RELEASE installed on ZFS
may crash during boot when the ZFS pool mount is attempted
while booting an unmodified <code xmlns="http://www.w3.org/1999/xhtml" class="literal">GENERIC</code>
kernel. </p><p xmlns="http://www.w3.org/TR/xhtml1/transitional">As described in <code xmlns="http://www.w3.org/1999/xhtml" class="filename">/usr/src/UPDATING</code>
entry <code xmlns="http://www.w3.org/1999/xhtml" class="literal">20121223</code>, rebuilding the kernel
with <code xmlns="http://www.w3.org/1999/xhtml" class="literal">options KSTACK_PAGES=4</code> has been
observed to resolve the boot-time crash. This, however, is
not an ideal solution for inclusion in the
<code xmlns="http://www.w3.org/1999/xhtml" class="literal">GENERIC</code> kernel configuration, as
increasing <code xmlns="http://www.w3.org/1999/xhtml" class="literal">KSTACK_PAGES</code> implicitly
decreases available usermode threads in an environment that
is already resource-starved. </p><p xmlns="http://www.w3.org/TR/xhtml1/transitional">Taking into account the heavy resource requirements of
ZFS, in addition to the i386-specific tuning
requirements for general workloads, using ZFS with the
FreeBSD/i386 <code xmlns="http://www.w3.org/1999/xhtml" class="literal">GENERIC</code> kernel
is strongly discouraged. </p><p xmlns="http://www.w3.org/TR/xhtml1/transitional">If installing FreeBSD/i386 on ZFS, it is possible to
configure the system after installation to increase the
<code xmlns="http://www.w3.org/1999/xhtml" class="literal">KSTACK_PAGES</code>. </p><p xmlns="http://www.w3.org/TR/xhtml1/transitional">When prompted by <a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=bsdinstall&amp;sektion=8"><span class="citerefentry"><span class="refentrytitle">bsdinstall</span>(8)</span></a> to perform
additional post-installation configuration to the system,
select <span xmlns="http://www.w3.org/1999/xhtml" class="guibutton">[ YES ]</span>. </p><p xmlns="http://www.w3.org/TR/xhtml1/transitional">This procedure requires the system sources available
locally. If the <code xmlns="http://www.w3.org/1999/xhtml" class="literal">System source code</code>
distribution was not selected during installation, it can
be obtained using <span xmlns="http://www.w3.org/1999/xhtml" class="application">svnlite</span>: </p><pre class="screen"><code class="prompt">#</code> mkdir -p /usr/src
<code class="prompt">#</code> svnlite co svn://svn.freebsd.org/base/releng/10.2 /usr/src</pre><p xmlns="http://www.w3.org/TR/xhtml1/transitional">Build the <code xmlns="http://www.w3.org/1999/xhtml" class="literal">kernel-toolchain</code> required
to rebuild the kernel: </p><pre class="screen"><code class="prompt">#</code> make -C /usr/src kernel-toolchain</pre><p xmlns="http://www.w3.org/TR/xhtml1/transitional">Next, create a kernel configuration file to increase the
<code xmlns="http://www.w3.org/1999/xhtml" class="literal">KSTACK_PAGES</code> option: </p><pre class="screen"><code class="prompt">#</code> printf "include GENERIC\noptions KSTACK_PAGES=4\n" &gt; <code class="filename">/usr/src/sys/i386/conf/<em class="replaceable"><code>ZFS</code></em></code></pre><p xmlns="http://www.w3.org/TR/xhtml1/transitional">Then build and install the
<em xmlns="http://www.w3.org/1999/xhtml" class="replaceable"><code>ZFS</code></em> kernel: </p><pre class="screen"><code class="prompt">#</code> make -C /usr/src buildkernel KERNCONF=<em class="replaceable"><code>ZFS</code></em>
<code class="prompt">#</code> make -C /usr/src installkernel KERNCONF=<em class="replaceable"><code>ZFS</code></em></pre><div xmlns="" class="warning"><h3 class="admontitle">Warning: </h3><p xmlns="http://www.w3.org/TR/xhtml1/transitional">It is extremely important to take note that, by
default, <a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=freebsd-update&amp;sektion=8"><span class="citerefentry"><span class="refentrytitle">freebsd-update</span>(8)</span></a> will install the
<code xmlns="http://www.w3.org/1999/xhtml" class="literal">GENERIC</code> kernel configuration, and
as such, <a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=freebsd-update&amp;sektion=8"><span class="citerefentry"><span class="refentrytitle">freebsd-update</span>(8)</span></a> consumers are strongly
encouraged to avoid FreeBSD-provided kernel binary upgrades
with such configurations. </p></div></li><li class="listitem"><p xmlns="http://www.w3.org/TR/xhtml1/transitional">Due to an incompatibility between <a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=bsdconfig&amp;sektion=8"><span class="citerefentry"><span class="refentrytitle">bsdconfig</span>(8)</span></a>
and <a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=pkg&amp;sektion=8"><span class="citerefentry"><span class="refentrytitle">pkg</span>(8)</span></a>, packages included on the FreeBSD dvd
installer will not be recognized by
<a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=bsdconfig&amp;sektion=8"><span class="citerefentry"><span class="refentrytitle">bsdconfig</span>(8)</span></a>. </p><p xmlns="http://www.w3.org/TR/xhtml1/transitional">To install packages from the <code xmlns="http://www.w3.org/1999/xhtml" class="literal">dvd1.iso</code>
installer, create the <code xmlns="http://www.w3.org/1999/xhtml" class="filename">/dist</code> target directory, and
manually mount the <code xmlns="http://www.w3.org/1999/xhtml" class="literal">dvd1.iso</code>
<acronym xmlns="http://www.w3.org/1999/xhtml" class="acronym">ISO</acronym>: </p><pre class="screen"><code class="prompt">#</code> mkdir -p /dist
<code class="prompt">#</code> mount -t cd9660 /dev/<em class="replaceable"><code>cd0</code></em> /dist</pre><div xmlns="" class="note"><h3 class="admontitle">Note: </h3><p xmlns="http://www.w3.org/TR/xhtml1/transitional">Be sure to use the correct <code xmlns="http://www.w3.org/1999/xhtml" class="filename">/dev</code> device path for the
<code xmlns="http://www.w3.org/1999/xhtml" class="literal">dvd1.iso</code> <acronym xmlns="http://www.w3.org/1999/xhtml" class="acronym">ISO</acronym>
installer. </p></div><p xmlns="http://www.w3.org/TR/xhtml1/transitional">Next, set <code xmlns="http://www.w3.org/1999/xhtml" class="envar">REPOS_DIR</code> to the path of the
<code xmlns="http://www.w3.org/1999/xhtml" class="filename">repos/</code> directory
within the installer so <a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=pkg&amp;sektion=8"><span class="citerefentry"><span class="refentrytitle">pkg</span>(8)</span></a> will use the correct
repository metadata. </p><p xmlns="http://www.w3.org/TR/xhtml1/transitional">If using <a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=sh&amp;sektion=1"><span class="citerefentry"><span class="refentrytitle">sh</span>(1)</span></a>: </p><pre class="screen"><code class="prompt">#</code> export REPOS_DIR=/dist/packages/repos</pre><p xmlns="http://www.w3.org/TR/xhtml1/transitional">If using <a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=csh&amp;sektion=1"><span class="citerefentry"><span class="refentrytitle">csh</span>(1)</span></a>: </p><pre class="screen"><code class="prompt">#</code> setenv REPOS_DIR /dist/packages/repos</pre><div xmlns="" class="note"><h3 class="admontitle">Note: </h3><p xmlns="http://www.w3.org/TR/xhtml1/transitional">Keep in mind that <code xmlns="http://www.w3.org/1999/xhtml" class="envar">REPOS_DIR</code> will need
to be set again after the current shell session is
terminated, if continuing to use the packages provided on
the <code xmlns="http://www.w3.org/1999/xhtml" class="literal">dvd1.iso</code> installer. </p></div><p xmlns="http://www.w3.org/TR/xhtml1/transitional">Finally, bootstrap <a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=pkg&amp;sektion=8"><span class="citerefentry"><span class="refentrytitle">pkg</span>(8)</span></a> from the
<acronym xmlns="http://www.w3.org/1999/xhtml" class="acronym">ISO</acronym>, and install required
packages: </p><pre class="screen"><code class="prompt">#</code> pkg bootstrap
<code class="prompt">#</code> pkg install <em class="replaceable"><code>xorg-server</code></em> <em class="replaceable"><code>xorg</code></em> <em class="replaceable"><code>gnome2</code></em> [...]</pre></li><li class="listitem"><p xmlns="http://www.w3.org/TR/xhtml1/transitional">An issue was discovered where the <a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=netstat&amp;sektion=1"><span class="citerefentry"><span class="refentrytitle">netstat</span>(1)</span></a>
<code xmlns="http://www.w3.org/1999/xhtml" class="literal">-s</code> option will cause a segmentation fault
on systems with <code xmlns="http://www.w3.org/1999/xhtml" class="literal">IPSEC</code> compiled into the
kernel. The issue was resolved in the
<code xmlns="http://www.w3.org/1999/xhtml" class="literal">stable/10</code> branch, and an Errata Notice is
planned after 10.2-RELEASE is released. </p></li></ul></div></div><div class="sect1"><div xmlns="" class="titlepage"><div><div><h2 xmlns="http://www.w3.org/1999/xhtml" class="title" style="clear: both"><a id="late-news"></a>5. Late-Breaking News</h2></div></div></div><p xmlns="http://www.w3.org/TR/xhtml1/transitional">No news. </p></div></div><p xmlns="http://www.w3.org/TR/xhtml1/transitional" align="center"><small>This file, and other release-related documents,
can be downloaded from <a href="https://www.FreeBSD.org/snapshots/">https://www.FreeBSD.org/snapshots/</a>.</small></p><p xmlns="http://www.w3.org/TR/xhtml1/transitional" align="center"><small>For questions about FreeBSD, read the
<a href="http://www.FreeBSD.org/docs.html">documentation</a> before
contacting &lt;<a href="mailto:questions@FreeBSD.org">questions@FreeBSD.org</a>&gt;.</small></p><p xmlns="http://www.w3.org/TR/xhtml1/transitional" align="center"><small>All users of FreeBSD 10.2-STABLE should
subscribe to the &lt;<a href="mailto:stable@FreeBSD.org">stable@FreeBSD.org</a>&gt;
mailing list.</small></p><p xmlns="http://www.w3.org/TR/xhtml1/transitional" align="center"><small>For questions about this documentation,
e-mail &lt;<a href="mailto:doc@FreeBSD.org">doc@FreeBSD.org</a>&gt;.</small></p></body></html>