article.xml revision 125249
176082Sbmah<!-- 
276082Sbmah	FreeBSD errata document.  Unlike some of the other RELNOTESng
376082Sbmah	files, this file should remain as a single SGML file, so that
476082Sbmah	the dollar FreeBSD dollar header has a meaningful modification
576082Sbmah	time.  This file is all but useless without a datestamp on it,
676082Sbmah	so we'll take some extra care to make sure it has one.
776082Sbmah
876082Sbmah	(If we didn't do this, then the file with the datestamp might
976082Sbmah	not be the one that received the last change in the document.)
1076082Sbmah
1176082Sbmah-->
1276082Sbmah
1376082Sbmah<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
1476082Sbmah<!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN">
1576082Sbmah%man;
1676082Sbmah<!ENTITY % authors PUBLIC  "-//FreeBSD//ENTITIES DocBook Author Entities//EN">
1776082Sbmah%authors;
1876082Sbmah<!ENTITY % mlists PUBLIC "-//FreeBSD//ENTITIES DocBook Mailing List Entities//EN">
1976082Sbmah%mlists;
20119884Ssimon<!ENTITY % trademarks PUBLIC "-//FreeBSD//ENTITIES DocBook Trademark Entities//EN">
21119884Ssimon%trademarks;
2276082Sbmah<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN">
2376082Sbmah%release;
24124312Sbmah<!ENTITY % misc PUBLIC  "-//FreeBSD//ENTITIES DocBook Miscellaneous FreeBSD Entities//EN">
25124312Sbmah%misc;
2676082Sbmah]>
2776082Sbmah
2876082Sbmah<article>
2976082Sbmah  <articleinfo>
30109307Sbmah    <title>&os;
31109543Sbmah<![ %release.type.snapshot [
32109543Sbmah    &release.prev;
33109543Sbmah]]>
34109543Sbmah<![ %release.type.release [
35109543Sbmah    &release.current;
36109543Sbmah]]>
37109307Sbmah    Errata</title>
3877914Sbmah
3976082Sbmah    <corpauthor>
4076082Sbmah    The &os; Project
4176082Sbmah    </corpauthor>
4276082Sbmah
4376082Sbmah    <pubdate>$FreeBSD: head/release/doc/en_US.ISO8859-1/errata/article.sgml 125249 2004-01-30 17:53:48Z bmah $</pubdate>
4476082Sbmah
4576082Sbmah    <copyright>
4676082Sbmah      <year>2000</year>
4776082Sbmah      <year>2001</year>
4888820Sbmah      <year>2002</year>
49108829Sbmah      <year>2003</year>
50124312Sbmah      <year>2004</year>
5176082Sbmah      <holder role="mailto:doc@FreeBSD.org">The FreeBSD Documentation Project</holder>
5276082Sbmah    </copyright>
53119884Ssimon
54119884Ssimon    <legalnotice id="trademarks" role="trademarks">
55119884Ssimon      &tm-attrib.freebsd;
56119884Ssimon      &tm-attrib.intel;
57119884Ssimon      &tm-attrib.sparc;
58119884Ssimon      &tm-attrib.general;
59119884Ssimon    </legalnotice>
6076082Sbmah  </articleinfo>
6176082Sbmah
6277914Sbmah  <abstract>
6379807Sbmah    <para>This document lists errata items for &os; 
64109543Sbmah<![ %release.type.snapshot [
65109543Sbmah      &release.prev;,
66109543Sbmah]]>
67109543Sbmah<![ %release.type.release [
68109543Sbmah      &release.current;,
69109543Sbmah]]>
70112874Sbmah      containing significant information discovered after the release
71112874Sbmah      or too late in the release cycle to be otherwise included in the
72112874Sbmah      release documentation.
7392295Sbmah      This information includes security advisories, as well as news
7492295Sbmah      relating to the software or documentation that could affect its
7592295Sbmah      operation or usability.  An up-to-date version of this document
7692295Sbmah      should always be consulted before installing this version of
7792295Sbmah      &os;.</para>
7877914Sbmah
79109307Sbmah    <para>This errata document for &os; 
80109543Sbmah<![ %release.type.snapshot [
81109543Sbmah      &release.prev;
82109543Sbmah]]>
83109543Sbmah<![ %release.type.release [
84109543Sbmah      &release.current;
85109543Sbmah]]>
86116130Sbmah      will be maintained until the release of &os; &release.next;.</para>
8777914Sbmah  </abstract>
8877914Sbmah
89109143Sroam  <sect1 id="intro">
9076082Sbmah    <title>Introduction</title>
9176082Sbmah
9279807Sbmah    <para>This errata document contains <quote>late-breaking news</quote>
9392295Sbmah      about &os;
94109543Sbmah<![ %release.type.snapshot [
95109543Sbmah      &release.prev;.
96109543Sbmah]]>
97109543Sbmah<![ %release.type.release [
98109543Sbmah      &release.current;.
99109543Sbmah]]>
10092295Sbmah      Before installing this version, it is important to consult this
10192295Sbmah      document to learn about any post-release discoveries or problems
10292295Sbmah      that may already have been found and fixed.</para>
10379807Sbmah
10492295Sbmah    <para>Any version of this errata document actually distributed
10592295Sbmah      with the release (for example, on a CDROM distribution) will be
10692295Sbmah      out of date by definition, but other copies are kept updated on
10792295Sbmah      the Internet and should be consulted as the <quote>current
10892295Sbmah      errata</quote> for this release.  These other copies of the
10992295Sbmah      errata are located at <ulink
11092295Sbmah      url="http://www.FreeBSD.org/releases/"></ulink>, plus any sites
11192295Sbmah      which keep up-to-date mirrors of this location.</para>
11276082Sbmah
11379807Sbmah    <para>Source and binary snapshots of &os; &release.branch; also
11492295Sbmah      contain up-to-date copies of this document (as of the time of
11592295Sbmah      the snapshot).</para>
11676082Sbmah
11777914Sbmah    <para>For a list of all &os; CERT security advisories, see <ulink
11892295Sbmah      url="http://www.FreeBSD.org/security/"></ulink> or <ulink
11992295Sbmah      url="ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/"></ulink>.</para>
12092295Sbmah
12176082Sbmah  </sect1>
12276082Sbmah
123109143Sroam  <sect1 id="security">
12476082Sbmah    <title>Security Advisories</title>
125109309Sbmah
126115963Sbmah<![ %release.type.release [
127115963Sbmah    <para>No advisories.</para>
128115963Sbmah]]>
129109309Sbmah
130115963Sbmah<![ %release.type.snapshot [
131125249Sbmah
132125249Sbmah    <para>(30 Jan 2004) A bug in &man.mksnap.ffs.8; causes the creation of a
133125249Sbmah      filesystem snapshot to reset the flags on the filesystem to
134125249Sbmah      their default values.  The possible consequences depend on local
135125249Sbmah      usage, but can include disabling extended access control lists
136125249Sbmah      or enabling the use of setuid executables stored on an untrusted
137125249Sbmah      filesystem.  This bug also affects the &man.dump.8;
138125249Sbmah      <option>-L</option> option, which uses &man.mksnap.ffs.8;.  Note
139125249Sbmah      that &man.mksnap.ffs.8; is normally only available to the
140125249Sbmah      superuser and members of the <groupname>operator</groupname>
141125249Sbmah      group.  This bug has been fixed on the &os; &release.current;
142125249Sbmah      security fix branch.  For more information, see security advisory <ulink
143125249Sbmah      url="ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/advisories/FreeBSD-SA-04:01.mksnap_ffs.asc">FreeBSD-SA-04:01</ulink>.</para>
144125249Sbmah
145115963Sbmah]]>
146111435Sbmah
147115963Sbmah  </sect1>
148111435Sbmah
149115963Sbmah  <sect1 id="open-issues">
150115963Sbmah    <title>Open Issues</title>
151111834Sbmah
152115963Sbmah<![ %release.type.release [
153115963Sbmah    <para>No open issues.</para>
154115963Sbmah]]>
155112435Sbmah
156115963Sbmah<![ %release.type.snapshot [
157124312Sbmah
158124312Sbmah    <para>(9 Jan 2004) Due to a change in &man.cpp.1; behavior, the
159124312Sbmah      login screen for &man.xdm.1; is in black and white, even on
160124312Sbmah      systems with color displays.  As a workaround, update to a newer
161124312Sbmah      version of the 
162124312Sbmah      <filename role="package">x11/XFree86-4-clients</filename>
163124312Sbmah      port/package.</para>
164124312Sbmah
165124312Sbmah    <para>(9 Jan 2004) There remain some residual problems with ACPI.
166124312Sbmah      In some cases, systems may behave erratically, or hang at boot
167124312Sbmah      time.  As a workaround, disable ACPI, using the <quote>safe
168124312Sbmah      mode</quote> option of the bootloader or using the
169124312Sbmah      <varname>hint.acpi.0.disabled</varname> kernel environment
170124312Sbmah      variable.  These problems are being investigated.  For problems
171124312Sbmah      that have not already been reported (check the mailing list
172124312Sbmah      archives <emphasis>before</emphasis> posting), sending the
173124312Sbmah      output of &man.dmesg.8; and &man.acpidump.8; to the
174124312Sbmah      &a.current; may help diagnose the problem.</para>
175124312Sbmah
176124312Sbmah    <para>(9 Jan 2004) In some cases, ATA devices may behave
177124312Sbmah      erratically, particularly SATA devices.  Reported symptoms
178124352Sbmah      include command timeouts or missing interrupts.  These problems
179124312Sbmah      appear to be timing-dependent, making them rather difficult to
180124312Sbmah      isolate.  Workarounds include:</para>
181124312Sbmah
182124312Sbmah    <itemizedlist>
183124312Sbmah      <listitem>
184124312Sbmah	<para>Turn off ATA DMA using the <quote>safe mode</quote>
185124312Sbmah	  option of the bootloader or the
186124312Sbmah	  <varname>hw.ata.ata_dma</varname> sysctl variable.</para>
187124312Sbmah      </listitem>
188124312Sbmah
189124312Sbmah      <listitem>
190124312Sbmah	<para>Use the host's BIOS setup options to put the ATA
191124312Sbmah	  controller in its <quote>legacy mode</quote>, if
192124312Sbmah	  available.</para>
193124312Sbmah      </listitem>
194124312Sbmah
195124312Sbmah      <listitem>
196124312Sbmah	<para>Disable ACPI, for example using the <quote>safe mode</quote>
197124312Sbmah	  option of the bootloader or using the
198124312Sbmah	  <varname>hint.acpi.0.disabled</varname> kernel environment
199124312Sbmah	  variable.</para>
200124312Sbmah      </listitem>
201124312Sbmah    </itemizedlist>
202124312Sbmah
203124312Sbmah    <para>(9 Jan 2004) Installing over NFS when using the install
204124312Sbmah      floppies requires that the <filename>nfsclient.ko</filename>
205124312Sbmah      module be manually loaded from the third floppy disk.  This can
206124312Sbmah      be done by following the prompts when &man.sysinstall.8;
207124312Sbmah      launches to load a driver off of the third floppy disk.</para>
208124312Sbmah
209124312Sbmah    <para>(9 Jan 2004) The use of multiple vchans (virtual audio
210124312Sbmah      channels with dynamic mixing in software) in the &man.pcm.4;
211124312Sbmah      driver has been known to cause some instability.</para>
212124312Sbmah
213124352Sbmah    <para>(10 Jan 2004) Although APIC interrupt routing seems to work
214124352Sbmah      correctly on many systems, on some others (such as some laptops)
215124352Sbmah      it can cause various errors, such as &man.ata.4; errors or hangs
216124352Sbmah      when starting or exiting X11.  For these situations, it may be
217124352Sbmah      advisable to disable APIC routing, using the <quote>safe
218124352Sbmah      mode</quote> of the bootloader or the
219124352Sbmah      <varname>hint.apic.0.disabled</varname> loader tunable.  Note
220124352Sbmah      that disabling APIC is not compatible with SMP systems.</para>
221124352Sbmah
222124352Sbmah    <para>(10 Jan 2004) The NFSv4 client may panic when attempting an
223124352Sbmah      NFSv4 operation against an NFSv3/NFSv2-only server.  This
224124352Sbmah      problem has been fixed with revision 1.4 of
225124352Sbmah      <filename>src/sys/rpc/rpcclnt.c</filename> in &os;
226124352Sbmah      &release.current;.</para>
227124352Sbmah
228124484Sbmah    <para>(11 Jan 2004) Some problems have been encountered when using
229124484Sbmah      third-party NSS modules, such as <filename>nss_ldap</filename>,
230124484Sbmah      and groups with large membership lists.  These have been fixed
231124484Sbmah      with revision 1.2 of <filename>src/include/nss.h</filename> and
232124484Sbmah      revision 1.2 of
233124484Sbmah      <filename>src/lib/libc/net/nss_compat.c</filename> in &os;
234124484Sbmah      &release.current;.</para>
235124484Sbmah
236124484Sbmah    <para>(13 Jan 2004) The &os; &release.current; release notes
237124484Sbmah      incorrectly stated that <application>GCC</application> was a
238124484Sbmah      post-release GCC 3.3.3 snapshot.  They should have stated that
239124484Sbmah      GCC was a <emphasis>pre-release</emphasis> GCC 3.3.3
240124484Sbmah      snapshot.</para>
241124484Sbmah
242124485Sbmah    <para>(13 Jan 2004) The <filename
243124485Sbmah      role="package">sysutils/kdeadmin3</filename> port/package has a
244124485Sbmah      bug in the <application>KUser</application> component that can
245124485Sbmah      cause deletion of the <username>root</username> user from the
246124485Sbmah      system password file.  Users are strongly urged to upgrade to
247124485Sbmah      version 3.1.4_1 of this port/package.</para>
248124485Sbmah
249124801Sbmah    <para>(21 Jan 2004) Some bugs in the IPsec implementation imported
250124801Sbmah      from the KAME Project can result in memory objects being freed
251124801Sbmah      before all references to them were removed.  Reported symptoms
252124801Sbmah      include erratic behavior or kernel panics after flushing the
253124801Sbmah      Security Policy Database (SPD).  Some of these problems have
254124801Sbmah      been fixed in &os; &release.current; in rev. 1.31 of
255124801Sbmah      <filename>src/sys/netinet6/ipsec.c</filename>, rev. 1.136 of
256124801Sbmah      <filename>src/sys/netinet/in_pcb.c</filename>, and revs. 1.63
257124801Sbmah      and 1.64 of <filename>src/sys/netkey/key.c</filename>.  More
258124801Sbmah      information about these problems has been posted to the
259124801Sbmah      &a.current;, in particular the thread entitled <ulink 
260124947Sbmah      url="http://lists.FreeBSD.org/pipermail/freebsd-current/2004-January/thread.html#18084">
261124801Sbmah      <quote>[PATCH] IPSec fixes</quote></ulink>.</para>
262124801Sbmah
263115963Sbmah]]>
264112477Sbmah
26576082Sbmah  </sect1>
26676082Sbmah
267109309Sbmah  <sect1 id="late-news">
268109309Sbmah    <title>Late-Breaking News</title>
269109309Sbmah
270115963Sbmah<![ %release.type.release [
271115963Sbmah    <para>No news.</para>
272115963Sbmah]]>
273109583Schris
274115963Sbmah<![ %release.type.snapshot [
275124352Sbmah
276124352Sbmah    <para>(10 Jan 2004) The TCP implementation in &os; now includes
277124352Sbmah      protection against a certain class of TCP MSS resource
278124352Sbmah      exhaustion attacks, in the form of limits on the size and rate
279124352Sbmah      of TCP segments.  The first limit sets the minimum allowed
280124352Sbmah      maximum TCP segment size, and is controlled by the
281124352Sbmah      <varname>net.inet.tcp.minmss</varname> sysctl variable (the
282124352Sbmah      default value is <literal>216</literal> bytes).  The second
283124352Sbmah      limit is set by the
284124352Sbmah      <varname>net.inet.tcp.minmssoverload</varname> variable, and
285124352Sbmah      controls the maximum rate of connections whose average segment
286124352Sbmah      size is less than <varname>net.inet.tcp.minmss</varname>.
287124352Sbmah      Connections exceeding this packet rate are reset and dropped.
288124352Sbmah      Because this feature was added late in the &release.prev;
289124352Sbmah      release cycle, connection rate limiting is disabled by default,
290124352Sbmah      but can be enabled manually by assigning a non-zero value to
291124352Sbmah      <varname>net.inet.tcp.minmssoverload</varname> (the default
292124352Sbmah      value in &release.current; at the time of this writing is
293124352Sbmah      <literal>1000</literal> packets per second).</para>
294124352Sbmah
295115963Sbmah]]>
296109309Sbmah
297115963Sbmah  </sect1>
298109583Schris
29976082Sbmah</article>
300