article.xml revision 118405 
1<!-- 
2	FreeBSD errata document.  Unlike some of the other RELNOTESng
3	files, this file should remain as a single SGML file, so that
4	the dollar FreeBSD dollar header has a meaningful modification
5	time.  This file is all but useless without a datestamp on it,
6	so we'll take some extra care to make sure it has one.
7
8	(If we didn't do this, then the file with the datestamp might
9	not be the one that received the last change in the document.)
10
11-->
12
13<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
14<!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN">
15%man;
16<!ENTITY % authors PUBLIC  "-//FreeBSD//ENTITIES DocBook Author Entities//EN">
17%authors;
18<!ENTITY % mlists PUBLIC "-//FreeBSD//ENTITIES DocBook Mailing List Entities//EN">
19%mlists;
20<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN">
21%release;
22]>
23
24<article>
25  <articleinfo>
26    <title>&os;
27<![ %release.type.snapshot [
28    &release.prev;
29]]>
30<![ %release.type.release [
31    &release.current;
32]]>
33    Errata</title>
34
35    <corpauthor>
36    The &os; Project
37    </corpauthor>
38
39    <pubdate>$FreeBSD: head/release/doc/en_US.ISO8859-1/errata/article.sgml 118405 2003-08-04 00:57:28Z bmah $</pubdate>
40
41    <copyright>
42      <year>2000</year>
43      <year>2001</year>
44      <year>2002</year>
45      <year>2003</year>
46      <holder role="mailto:doc@FreeBSD.org">The FreeBSD Documentation Project</holder>
47    </copyright>
48  </articleinfo>
49
50  <abstract>
51    <para>This document lists errata items for &os; 
52<![ %release.type.snapshot [
53      &release.prev;,
54]]>
55<![ %release.type.release [
56      &release.current;,
57]]>
58      containing significant information discovered after the release
59      or too late in the release cycle to be otherwise included in the
60      release documentation.
61      This information includes security advisories, as well as news
62      relating to the software or documentation that could affect its
63      operation or usability.  An up-to-date version of this document
64      should always be consulted before installing this version of
65      &os;.</para>
66
67    <para>This errata document for &os; 
68<![ %release.type.snapshot [
69      &release.prev;
70]]>
71<![ %release.type.release [
72      &release.current;
73]]>
74      will be maintained until the release of &os; &release.next;.</para>
75  </abstract>
76
77  <sect1 id="intro">
78    <title>Introduction</title>
79
80    <para>This errata document contains <quote>late-breaking news</quote>
81      about &os;
82<![ %release.type.snapshot [
83      &release.prev;.
84]]>
85<![ %release.type.release [
86      &release.current;.
87]]>
88      Before installing this version, it is important to consult this
89      document to learn about any post-release discoveries or problems
90      that may already have been found and fixed.</para>
91
92    <para>Any version of this errata document actually distributed
93      with the release (for example, on a CDROM distribution) will be
94      out of date by definition, but other copies are kept updated on
95      the Internet and should be consulted as the <quote>current
96      errata</quote> for this release.  These other copies of the
97      errata are located at <ulink
98      url="http://www.FreeBSD.org/releases/"></ulink>, plus any sites
99      which keep up-to-date mirrors of this location.</para>
100
101    <para>Source and binary snapshots of &os; &release.branch; also
102      contain up-to-date copies of this document (as of the time of
103      the snapshot).</para>
104
105    <para>For a list of all &os; CERT security advisories, see <ulink
106      url="http://www.FreeBSD.org/security/"></ulink> or <ulink
107      url="ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/"></ulink>.</para>
108
109  </sect1>
110
111  <sect1 id="security">
112    <title>Security Advisories</title>
113
114<![ %release.type.release [
115    <para>No advisories.</para>
116]]>
117
118<![ %release.type.snapshot [
119    <para>The implementation of the &man.realpath.3; function contains
120      a single-byte buffer overflow bug.  This may have various
121      impacts, depending on the application using &man.realpath.3; and
122      other factors.  This bug has been fixed on the &release.prev;
123      security fix branch and the &release.branch; development branch.  For
124      more information, see security advisory
125      <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/advisories/FreeBSD-SA-03:08.realpath.asc">FreeBSD-SA-03:08</ulink>.</para>
126]]>
127
128  </sect1>
129
130  <sect1 id="open-issues">
131    <title>Open Issues</title>
132
133<![ %release.type.release [
134    <para>No open issues.</para>
135]]>
136
137<![ %release.type.snapshot [
138    <para>The RAIDframe disk driver described in &man.raid.4; is
139      non-functional for this release.</para>
140
141    <para>ACPI seems to make some i386 machines unstable.  Turning off
142      ACPI support may help solve some of these problems; see an item
143      in <xref linkend="late-news">.</para>
144
145    <para>An integer overflow could cause kernel panics on PAE-using
146      machines with certain memory sizes.  This bug has been corrected
147      on both the <literal>RELENG_5_1</literal> and
148      <literal>HEAD</literal> branches.  A workaround for this problem
149      is to remove some memory, update the system in question, and
150      reinstall the memory.</para>
151
152    <para>Attempting to write to an &man.msdosfs.5; file system that
153      has been upgraded from read-only to read-write via
154      <command>mount -u</command> will cause the system to lock up.
155      To work around this problem, unmount the file system first, then
156      mount it again with the appropriate options instead of using
157      <command>mount -u</command>.</para>
158]]>
159
160  </sect1>
161
162  <sect1 id="late-news">
163    <title>Late-Breaking News</title>
164
165<![ %release.type.release [
166    <para>No news.</para>
167]]>
168
169<![ %release.type.snapshot [
170    <para>&man.ipfw.4; should work correctly on strict-alignment
171      64-bit architectures such as alpha and sparc64.</para>
172
173    <para>The release notes should have stated that the
174      <filename>libthr</filename> library is built by default for the
175      i386 platform.</para>
176
177    <para>&os; &release.prev; includes some new boot loader scripts
178      designed to make booting &os; with different options easier.
179      This may help diagnose bootstrapping problems.  These scripts
180      build on the existing Forth-based boot loader scripts (thus,
181      <filename>/boot/loader.conf</filename> and other existing loader
182      configuration files still apply).  They are only installed by
183      default for new binary installs on i386 machines.  The new
184      scripts present a boot-time menu that controls how &os; is
185      booted, and include options to turn off ACPI, a <quote>safe
186      mode</quote> boot, single-user booting, and verbose booting.
187      <quote>Safe mode</quote> booting can be particularly useful when
188      compatibility with a system's hardware is uncertain, and sets
189      the following kernel tunable variables:</para>
190
191      <programlisting>hint.acpi.0.disabled=1 # disable ACPI (i386 only)
192hw.ata.ata_dma=0       # disable IDE DMA
193hw.ata.atapi_dma=0     # disable ATAPI/IDE DMA
194hw.ata.wc=0            # disable IDE disk write cache
195hw.eisa_slots=0        # disable probing for EISA devices</programlisting>
196
197    <para>For new installs on i386 architecture machines,
198      &man.sysinstall.8; will try to determine if ACPI was disabled
199      via the new boot loader scripts mentioned above, and if so,
200      ask if this change should be made permanent.</para>
201
202    <para>The release notes should have mentioned that work on the
203      following features was sponsored by the Defense Advanced
204      Research Projects Agency (DARPA): OpenPAM, NSS support, PAE
205      support, various MAC framework updates, the GEOM disk geometry
206      system.</para>
207
208]]>
209
210  </sect1>
211
212</article>
213