article.xml revision 119884
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;
2476082Sbmah]>
2576082Sbmah
2676082Sbmah<article>
2776082Sbmah  <articleinfo>
28109307Sbmah    <title>&os;
29109543Sbmah<![ %release.type.snapshot [
30109543Sbmah    &release.prev;
31109543Sbmah]]>
32109543Sbmah<![ %release.type.release [
33109543Sbmah    &release.current;
34109543Sbmah]]>
35109307Sbmah    Errata</title>
3677914Sbmah
3776082Sbmah    <corpauthor>
3876082Sbmah    The &os; Project
3976082Sbmah    </corpauthor>
4076082Sbmah
4176082Sbmah    <pubdate>$FreeBSD: head/release/doc/en_US.ISO8859-1/errata/article.sgml 119884 2003-09-08 14:53:02Z simon $</pubdate>
4276082Sbmah
4376082Sbmah    <copyright>
4476082Sbmah      <year>2000</year>
4576082Sbmah      <year>2001</year>
4688820Sbmah      <year>2002</year>
47108829Sbmah      <year>2003</year>
4876082Sbmah      <holder role="mailto:doc@FreeBSD.org">The FreeBSD Documentation Project</holder>
4976082Sbmah    </copyright>
50119884Ssimon
51119884Ssimon    <legalnotice id="trademarks" role="trademarks">
52119884Ssimon      &tm-attrib.freebsd;
53119884Ssimon      &tm-attrib.intel;
54119884Ssimon      &tm-attrib.sparc;
55119884Ssimon      &tm-attrib.general;
56119884Ssimon    </legalnotice>
5776082Sbmah  </articleinfo>
5876082Sbmah
5977914Sbmah  <abstract>
6079807Sbmah    <para>This document lists errata items for &os; 
61109543Sbmah<![ %release.type.snapshot [
62109543Sbmah      &release.prev;,
63109543Sbmah]]>
64109543Sbmah<![ %release.type.release [
65109543Sbmah      &release.current;,
66109543Sbmah]]>
67112874Sbmah      containing significant information discovered after the release
68112874Sbmah      or too late in the release cycle to be otherwise included in the
69112874Sbmah      release documentation.
7092295Sbmah      This information includes security advisories, as well as news
7192295Sbmah      relating to the software or documentation that could affect its
7292295Sbmah      operation or usability.  An up-to-date version of this document
7392295Sbmah      should always be consulted before installing this version of
7492295Sbmah      &os;.</para>
7577914Sbmah
76109307Sbmah    <para>This errata document for &os; 
77109543Sbmah<![ %release.type.snapshot [
78109543Sbmah      &release.prev;
79109543Sbmah]]>
80109543Sbmah<![ %release.type.release [
81109543Sbmah      &release.current;
82109543Sbmah]]>
83116130Sbmah      will be maintained until the release of &os; &release.next;.</para>
8477914Sbmah  </abstract>
8577914Sbmah
86109143Sroam  <sect1 id="intro">
8776082Sbmah    <title>Introduction</title>
8876082Sbmah
8979807Sbmah    <para>This errata document contains <quote>late-breaking news</quote>
9092295Sbmah      about &os;
91109543Sbmah<![ %release.type.snapshot [
92109543Sbmah      &release.prev;.
93109543Sbmah]]>
94109543Sbmah<![ %release.type.release [
95109543Sbmah      &release.current;.
96109543Sbmah]]>
9792295Sbmah      Before installing this version, it is important to consult this
9892295Sbmah      document to learn about any post-release discoveries or problems
9992295Sbmah      that may already have been found and fixed.</para>
10079807Sbmah
10192295Sbmah    <para>Any version of this errata document actually distributed
10292295Sbmah      with the release (for example, on a CDROM distribution) will be
10392295Sbmah      out of date by definition, but other copies are kept updated on
10492295Sbmah      the Internet and should be consulted as the <quote>current
10592295Sbmah      errata</quote> for this release.  These other copies of the
10692295Sbmah      errata are located at <ulink
10792295Sbmah      url="http://www.FreeBSD.org/releases/"></ulink>, plus any sites
10892295Sbmah      which keep up-to-date mirrors of this location.</para>
10976082Sbmah
11079807Sbmah    <para>Source and binary snapshots of &os; &release.branch; also
11192295Sbmah      contain up-to-date copies of this document (as of the time of
11292295Sbmah      the snapshot).</para>
11376082Sbmah
11477914Sbmah    <para>For a list of all &os; CERT security advisories, see <ulink
11592295Sbmah      url="http://www.FreeBSD.org/security/"></ulink> or <ulink
11692295Sbmah      url="ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/"></ulink>.</para>
11792295Sbmah
11876082Sbmah  </sect1>
11976082Sbmah
120109143Sroam  <sect1 id="security">
12176082Sbmah    <title>Security Advisories</title>
122109309Sbmah
123115963Sbmah<![ %release.type.release [
124115963Sbmah    <para>No advisories.</para>
125115963Sbmah]]>
126109309Sbmah
127115963Sbmah<![ %release.type.snapshot [
128118789Sbmah    <para>The implementation of the &man.realpath.3; function contained
129118789Sbmah      a single-byte buffer overflow bug.  This had various
130118405Sbmah      impacts, depending on the application using &man.realpath.3; and
131118426Srushani      other factors.  This bug was fixed on the &release.branch; development
132118429Sbmah      branch before &release.prev;; &os; &release.prev; is therefore not affected.  However, this change
133118429Sbmah      was not noted in the release documentation.  For
134118405Sbmah      more information, see security advisory
135118405Sbmah      <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/advisories/FreeBSD-SA-03:08.realpath.asc">FreeBSD-SA-03:08</ulink>.</para>
136118789Sbmah
137118789Sbmah    <para>The kernel contains a bug that could allow it to attempt
138118789Sbmah      delivery of invalid signals, leading to a kernel panic or, under
139118789Sbmah      some circumstances, unauthorized modification of kernel memory.
140118789Sbmah      This bug has been fixed on the &release.branch; development
141118789Sbmah      branch and the &release.prev; security fix branch.  For more
142118789Sbmah      information, see security advisory
143118789Sbmah      <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/advisories/FreeBSD-SA-03:09.signal.asc">FreeBSD-SA-03:09</ulink>.</para>
144118789Sbmah
145118789Sbmah    <para>A bug in the iBCS2 emulation module could result in
146118789Sbmah      disclosing the contents of kernel memory.  (Note that this
147118789Sbmah      module is not enabled in &os; by default.)  This bug has been
148118789Sbmah      fixed on the &release.branch; development branch and the
149118789Sbmah      &release.prev; security fix branch.  More information can be
150118789Sbmah      found in security advisory
151118789Sbmah      <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/advisories/FreeBSD-SA-03:10.ibcs2.asc">FreeBSD-SA-03:10</ulink>.</para>
152115963Sbmah]]>
153111435Sbmah
154115963Sbmah  </sect1>
155111435Sbmah
156115963Sbmah  <sect1 id="open-issues">
157115963Sbmah    <title>Open Issues</title>
158111834Sbmah
159115963Sbmah<![ %release.type.release [
160115963Sbmah    <para>No open issues.</para>
161115963Sbmah]]>
162112435Sbmah
163115963Sbmah<![ %release.type.snapshot [
164115965Sbmah    <para>The RAIDframe disk driver described in &man.raid.4; is
165115965Sbmah      non-functional for this release.</para>
166115965Sbmah
167119884Ssimon    <para>ACPI seems to make some &i386; machines unstable.  Turning off
168115965Sbmah      ACPI support may help solve some of these problems; see an item
169115965Sbmah      in <xref linkend="late-news">.</para>
170116787Sbmah
171116787Sbmah    <para>An integer overflow could cause kernel panics on PAE-using
172116787Sbmah      machines with certain memory sizes.  This bug has been corrected
173116787Sbmah      on both the <literal>RELENG_5_1</literal> and
174116787Sbmah      <literal>HEAD</literal> branches.  A workaround for this problem
175116787Sbmah      is to remove some memory, update the system in question, and
176116787Sbmah      reinstall the memory.</para>
177116787Sbmah
178116787Sbmah    <para>Attempting to write to an &man.msdosfs.5; file system that
179116787Sbmah      has been upgraded from read-only to read-write via
180116787Sbmah      <command>mount -u</command> will cause the system to lock up.
181116787Sbmah      To work around this problem, unmount the file system first, then
182116787Sbmah      mount it again with the appropriate options instead of using
183116787Sbmah      <command>mount -u</command>.</para>
184115963Sbmah]]>
185112477Sbmah
18676082Sbmah  </sect1>
18776082Sbmah
188109309Sbmah  <sect1 id="late-news">
189109309Sbmah    <title>Late-Breaking News</title>
190109309Sbmah
191115963Sbmah<![ %release.type.release [
192115963Sbmah    <para>No news.</para>
193115963Sbmah]]>
194109583Schris
195115963Sbmah<![ %release.type.snapshot [
196115965Sbmah    <para>&man.ipfw.4; should work correctly on strict-alignment
197119884Ssimon      64-bit architectures such as alpha and &sparc64;.</para>
198115965Sbmah
199115965Sbmah    <para>The release notes should have stated that the
200115965Sbmah      <filename>libthr</filename> library is built by default for the
201119884Ssimon      &i386; platform.</para>
202115965Sbmah
203115965Sbmah    <para>&os; &release.prev; includes some new boot loader scripts
204115965Sbmah      designed to make booting &os; with different options easier.
205115965Sbmah      This may help diagnose bootstrapping problems.  These scripts
206115965Sbmah      build on the existing Forth-based boot loader scripts (thus,
207115965Sbmah      <filename>/boot/loader.conf</filename> and other existing loader
208115965Sbmah      configuration files still apply).  They are only installed by
209119884Ssimon      default for new binary installs on &i386; machines.  The new
210115965Sbmah      scripts present a boot-time menu that controls how &os; is
211115965Sbmah      booted, and include options to turn off ACPI, a <quote>safe
212115965Sbmah      mode</quote> boot, single-user booting, and verbose booting.
213115965Sbmah      <quote>Safe mode</quote> booting can be particularly useful when
214115965Sbmah      compatibility with a system's hardware is uncertain, and sets
215115965Sbmah      the following kernel tunable variables:</para>
216115965Sbmah
217115965Sbmah      <programlisting>hint.acpi.0.disabled=1 # disable ACPI (i386 only)
218115965Sbmahhw.ata.ata_dma=0       # disable IDE DMA
219115965Sbmahhw.ata.atapi_dma=0     # disable ATAPI/IDE DMA
220115965Sbmahhw.ata.wc=0            # disable IDE disk write cache
221115965Sbmahhw.eisa_slots=0        # disable probing for EISA devices</programlisting>
222115965Sbmah
223119884Ssimon    <para>For new installs on &i386; architecture machines,
224115965Sbmah      &man.sysinstall.8; will try to determine if ACPI was disabled
225115965Sbmah      via the new boot loader scripts mentioned above, and if so,
226115965Sbmah      ask if this change should be made permanent.</para>
227115965Sbmah
228115965Sbmah    <para>The release notes should have mentioned that work on the
229115965Sbmah      following features was sponsored by the Defense Advanced
230115965Sbmah      Research Projects Agency (DARPA): OpenPAM, NSS support, PAE
231115965Sbmah      support, various MAC framework updates, the GEOM disk geometry
232115965Sbmah      system.</para>
233116630Sbmah
234115963Sbmah]]>
235109309Sbmah
236115963Sbmah  </sect1>
237109583Schris
23876082Sbmah</article>
239