doc/en/releases/7.1R/errata.html
2009-01-05 15:39:24 +00:00

325 lines
14 KiB
HTML

<!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 name="generator" content="HTML Tidy, see www.w3.org" />
<title>FreeBSD 7.1-RELEASE Errata</title>
<meta name="GENERATOR" content="Modular DocBook HTML Stylesheet Version 1.79" />
<link rel="STYLESHEET" type="text/css" href="docbook.css" />
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
</head>
<body class="ARTICLE" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#840084"
alink="#0000FF">
<div class="ARTICLE">
<div class="TITLEPAGE">
<h1 class="TITLE"><a id="AEN2" name="AEN2">FreeBSD 7.1-RELEASE Errata</a></h1>
<h3 class="CORPAUTHOR">The FreeBSD Project</h3>
<p class="COPYRIGHT">Copyright &copy; 2008, 2009 The FreeBSD Documentation Project</p>
<p class="PUBDATE">$FreeBSD: stable/7/release/doc/en_US.ISO8859-1/errata/article.sgml
186782 2009-01-05 15:38:45Z hrs $<br />
</p>
<div class="LEGALNOTICE"><a id="TRADEMARKS" name="TRADEMARKS"></a>
<p>FreeBSD is a registered trademark of the FreeBSD Foundation.</p>
<p>Intel, Celeron, 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>Sparc, Sparc64, SPARCEngine, and UltraSPARC are trademarks of SPARC International, Inc
in the United States and other countries. Products bearing SPARC trademarks are based
upon architecture developed by Sun Microsystems, Inc.</p>
<p>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 &#8220;&trade;&#8221; or the &#8220;&reg;&#8221; symbol.</p>
</div>
<hr />
</div>
<blockquote class="ABSTRACT">
<div class="ABSTRACT"><a id="AEN17" name="AEN17"></a>
<p>This document lists errata items for FreeBSD 7.1-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>This errata document for FreeBSD 7.1-RELEASE will be maintained until the release of
FreeBSD 7.2-RELEASE.</p>
</div>
</blockquote>
<div class="SECT1">
<hr />
<h2 class="SECT1"><a id="INTRO" name="INTRO">1 Introduction</a></h2>
<p>This errata document contains &#8220;late-breaking news&#8221; about FreeBSD
7.1-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>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 &#8220;current errata&#8221;
for this release. These other copies of the errata are located at <a
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>Source and binary snapshots of FreeBSD 7-STABLE also contain up-to-date copies of this
document (as of the time of the snapshot).</p>
<p>For a list of all FreeBSD CERT security advisories, see <a
href="http://www.FreeBSD.org/security/"
target="_top">http://www.FreeBSD.org/security/</a> or <a
href="ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/"
target="_top">ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/</a>.</p>
</div>
<div class="SECT1">
<hr />
<h2 class="SECT1"><a id="SECURITY" name="SECURITY">2 Security Advisories</a></h2>
<p>No advisories.</p>
</div>
<div class="SECT1">
<hr />
<h2 class="SECT1"><a id="OPEN-ISSUES" name="OPEN-ISSUES">3 Open Issues</a></h2>
<p>[20090105] As in the Announcement of 7.1-RELEASE, certain Intel NICs will come up as
<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=igb&sektion=4&manpath=FreeBSD+7.1-stable"><span
class="CITEREFENTRY"><span class="REFENTRYTITLE">igb</span>(4)</span></a> instead of <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=em&sektion=4&manpath=FreeBSD+7.1-stable"><span
class="CITEREFENTRY"><span class="REFENTRYTITLE">em</span>(4)</span></a> in this
release. There are only 3 PCI ID's that should have their name changed from <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=em&sektion=4&manpath=FreeBSD+7.1-stable"><span
class="CITEREFENTRY"><span class="REFENTRYTITLE">em</span>(4)</span></a> to <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=igb&sektion=4&manpath=FreeBSD+7.1-stable"><span
class="CITEREFENTRY"><span class="REFENTRYTITLE">igb</span>(4)</span></a>:</p>
<ul>
<li>
<p>0x10A78086</p>
</li>
<li>
<p>0x10A98086</p>
</li>
<li>
<p>0x10D68086</p>
</li>
</ul>
<p>You should be able to determine if your card will change names by running the
following command:</p>
<pre class="SCREEN">
<samp class="PROMPT">%</samp> pciconf -l
. . .
em0@pci0:0:25:0: class=0x020000 card=0x02381028 chip=0x10c08086 rev=0x02 hdr=0x00
</pre>
<p>and for the line representing your NIC (should be named <span class="emphasis"><i
class="EMPHASIS">em</i></span> on older systems, e.g. <span class="emphasis"><i
class="EMPHASIS">em0</i></span> or <span class="emphasis"><i
class="EMPHASIS">em1</i></span>, etc) check the fourth column. If that says <tt
class="LITERAL">chip=0x10a78086</tt> (or one of the other two IDs given above) you will
have the adapter's name change.</p>
</div>
<div class="SECT1">
<hr />
<h2 class="SECT1"><a id="LATE-NEWS" name="LATE-NEWS">4 Late-Breaking News and
Corrections</a></h2>
<p>[20090105] The Release Notes for 7.1-RELEASE should have mentioned that the <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=procstat&sektion=1&manpath=FreeBSD+7.1-stable">
<span class="CITEREFENTRY"><span class="REFENTRYTITLE">procstat</span>(1)</span></a>
utility has been added. This is a process inspection utility which provides both some of
the missing functionality from <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=procfs&sektion=5&manpath=FreeBSD+7.1-stable">
<span class="CITEREFENTRY"><span class="REFENTRYTITLE">procfs</span>(5)</span></a> and
new functionality for monitoring and debugging specific processes.</p>
<p>[20090105] The Release Notes for 7.1-RELEASE should have mentioned changes that the <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=ae&sektion=4&manpath=FreeBSD+7.1-stable"><span
class="CITEREFENTRY"><span class="REFENTRYTITLE">ae</span>(4)</span></a> driver has been
added to provide support for the Attansic/Atheros L2 FastEthernet controllers. This
driver is not enabled in <tt class="FILENAME">GENERIC</tt> kernels for this release.</p>
<p>[20090105] The Release Notes for 7.1-RELEASE included the following
misdescriptions:</p>
<ul>
<li>
<p>In the entry of <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=linux&sektion=4&manpath=FreeBSD+7.1-stable">
<span class="CITEREFENTRY"><span class="REFENTRYTITLE">linux</span>(4)</span></a> ABI
support, <code class="FUNCTION">get_setaffinity()</code> should have been <code
class="FUNCTION">sched_setaffinity()</code>.</p>
</li>
</ul>
<p>[20090105] The Release Notes for 7.1-RELEASE should have mentioned changes that the <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=jme&sektion=4&manpath=FreeBSD+7.1-stable"><span
class="CITEREFENTRY"><span class="REFENTRYTITLE">jme</span>(4)</span></a> driver has
been added to provide support for PCIe adapters based on JMicron JMC250 gigabit Ethernet
and JMC260 fast Ethernet controllers.</p>
<p>[20090105] The Release Notes for 7.1-RELEASE should have mentioned changes that the <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=age&sektion=4&manpath=FreeBSD+7.1-stable"><span
class="CITEREFENTRY"><span class="REFENTRYTITLE">age</span>(4)</span></a> driver has
been added to provide support for Attansic/Atheros L1 gigabit Ethernet controller.</p>
<p>[20090105] The Release Notes for 7.1-RELEASE should have mentioned changes that the <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=malo&sektion=4&manpath=FreeBSD+7.1-stable">
<span class="CITEREFENTRY"><span class="REFENTRYTITLE">malo</span>(4)</span></a> driver
has been added to provide support for Marvell Libertas 88W8335 based PCI network
adapters.</p>
<p>[20090105] The Release Notes for 7.1-RELEASE should have mentioned changes that the
bm(4) driver has been added to provide support for Apple Big Mac (BMAC) Ethernet
controller, found on various Apple G3 models.</p>
<p>[20090105] The Release Notes for 7.1-RELEASE should have mentioned changes that the
et(4) driver has been added to provide support for Agere ET1310 10/100/Gigabit Ethernet
controller.</p>
<p>[20090105] The Release Notes for 7.1-RELEASE should have mentioned changes that the <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=glxsb&sektion=4&manpath=FreeBSD+7.1-stable">
<span class="CITEREFENTRY"><span class="REFENTRYTITLE">glxsb</span>(4)</span></a> driver
has been added to provide support for the Security Block in AMD Geode LX processors.</p>
<p>[20090105] The Release Notes for 7.1-RELEASE should have mentioned that FreeBSD now
supports multiple routing tables. To enable this, the following steps are needed:</p>
<ul>
<li>
<p>Add the following kernel configuration option and rebuild the kernel. The <tt
class="LITERAL">2</tt> is the number of FIB (Forward Information Base, synonym for a
routing table here). The maximum value is 16.</p>
<pre class="PROGRAMLISTING">
options ROUTETABLES=2
</pre>
<p>The procedure for rebuilding the FreeBSD kernel is described in the <a
href="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html#AEN30408"
target="_top">FreeBSD Handbook</a>.</p>
<p>This number can be modified on boot time. To do so, add the following to <tt
class="FILENAME">/boot/loader.conf</tt> and reboot the system:</p>
<pre class="PROGRAMLISTING">
net.fibs=6
</pre>
</li>
<li>
<p>Set a loader tunable <code class="VARNAME">net.my_fibnum</code> if needed. This means
the default number of routing tables. If not specified, <tt class="LITERAL">0</tt> will
be used.</p>
</li>
<li>
<p>Set a loader tunable <code class="VARNAME">net.add_addr_allfibs</code> if needed. This
enables to add routes to all FIBs for new interfaces by default. When this is set to <tt
class="LITERAL">0</tt>, it will only allocate routes on interface changes for the FIB of
the caller when adding a new set of addresses to an interface. Note that this tunable is
set to <tt class="LITERAL">1</tt> by default.</p>
</li>
</ul>
<p>To select one of the FIBs, the new <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=setfib&sektion=1&manpath=FreeBSD+7.1-stable">
<span class="CITEREFENTRY"><span class="REFENTRYTITLE">setfib</span>(1)</span></a>
utility can be used. This set an associated FIB with the process. For example:</p>
<pre class="SCREEN">
<samp class="PROMPT">#</samp> setfib -3 ping target.example.com
</pre>
<p>The FIB #3 will be used for the <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=ping&sektion=8&manpath=FreeBSD+7.1-stable">
<span class="CITEREFENTRY"><span class="REFENTRYTITLE">ping</span>(8)</span></a>
command.</p>
<p>The FIB which the packet will be associated with will be determined in the following
rules:</p>
<ul>
<li>
<p>All packets which have a FIB associated with them will use the FIB. If not, FIB #0
will be used.</p>
</li>
<li>
<p>A packet received on an interface for forwarding uses FIB #0.</p>
</li>
<li>
<p>A TCP listen socket associated with an FIB will generate accept sockets which are
associated with the same FIB.</p>
</li>
<li>
<p>A packet generated in response to other packet uses the FIB associated with the packet
being responded to.</p>
</li>
<li>
<p>A packet generated on tunnel interfaces such as <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=gif&sektion=4&manpath=FreeBSD+7.1-stable"><span
class="CITEREFENTRY"><span class="REFENTRYTITLE">gif</span>(4)</span></a> and <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=tun&sektion=4&manpath=FreeBSD+7.1-stable"><span
class="CITEREFENTRY"><span class="REFENTRYTITLE">tun</span>(4)</span></a> will be
encapsulated using the FIB of the process which set up the tunnel.</p>
</li>
<li>
<p>Routing messages will be associated with the process's FIB.</p>
</li>
</ul>
<p>Also, the <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=ipfw&sektion=8&manpath=FreeBSD+7.1-stable">
<span class="CITEREFENTRY"><span class="REFENTRYTITLE">ipfw</span>(8)</span></a> now
supports an action rule <tt class="LITERAL">setfib</tt>. The following action:</p>
<pre class="PROGRAMLISTING">
setfib <tt class="REPLACEABLE"><i>fibnum</i></tt>
</pre>
<p>will make the matched packet use the FIB specified in <tt
class="REPLACEABLE"><i>fibnum</i></tt>. The rule processing continues at the next
rule.</p>
</div>
</div>
<hr />
<p align="center"><small>This file, and other release-related documents, can be
downloaded from <a
href="http://www.FreeBSD.org/snapshots/">http://www.FreeBSD.org/snapshots/</a>.</small></p>
<p align="center"><small>For questions about FreeBSD, read the <a
href="http://www.FreeBSD.org/docs.html">documentation</a> before contacting &#60;<a
href="mailto:questions@FreeBSD.org">questions@FreeBSD.org</a>&#62;.</small></p>
<p align="center"><small>All users of FreeBSD 7-STABLE should subscribe to the &#60;<a
href="mailto:stable@FreeBSD.org">stable@FreeBSD.org</a>&#62; mailing list.</small></p>
<p align="center"><small>For questions about this documentation, e-mail &#60;<a
href="mailto:doc@FreeBSD.org">doc@FreeBSD.org</a>&#62;.</small></p>
</body>
</html>