svn commit: r47168 - head/en_US.ISO8859-1/htdocs/releases/10.2R

Glen Barber gjb at FreeBSD.org
Thu Aug 6 20:53:49 UTC 2015


Author: gjb
Date: Thu Aug  6 20:53:48 2015
New Revision: 47168
URL: https://svnweb.freebsd.org/changeset/doc/47168

Log:
  Add an errata.html page, generated from modified stable/10 sources
  pending commit after 10.2-RELEASE is available.
  
  Approved by:	re (implicit)
  Sponsored by:	The FreeBSD Foundation

Added:
  head/en_US.ISO8859-1/htdocs/releases/10.2R/errata.html   (contents, props changed)

Added: head/en_US.ISO8859-1/htdocs/releases/10.2R/errata.html
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ head/en_US.ISO8859-1/htdocs/releases/10.2R/errata.html	Thu Aug  6 20:53:48 2015	(r47168)
@@ -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 at 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 FreeB
 SD 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">“<span class="quote">™</span>”</span> or the
+  <span xmlns="http://www.w3.org/1999/xhtml" class="quote">“<span class="quote">®</span>”</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">“<span class="quote">late-breaking
+	news</span>”</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">“<span class="quote">current
+	errata</span>”</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&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&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" > <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&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&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&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&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&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&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&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&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&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&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 <<a href="mailto:questions at FreeBSD.org">questions at FreeBSD.org</a>>.</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 <<a href="mailto:stable at FreeBSD.org">stable at FreeBSD.org</a>>
+      mailing list.</small></p><p xmlns="http://www.w3.org/TR/xhtml1/transitional" align="center"><small>For questions about this documentation,
+      e-mail <<a href="mailto:doc at FreeBSD.org">doc at FreeBSD.org</a>>.</small></p></body></html>
\ No newline at end of file


More information about the svn-doc-all mailing list