article.xml revision 116130 
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 116130 2003-06-09 22:33:19Z 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>No advisories.</para>
120]]>
121
122  </sect1>
123
124  <sect1 id="open-issues">
125    <title>Open Issues</title>
126
127<![ %release.type.release [
128    <para>No open issues.</para>
129]]>
130
131<![ %release.type.snapshot [
132    <para>The RAIDframe disk driver described in &man.raid.4; is
133      non-functional for this release.</para>
134
135    <para>ACPI seems to make some i386 machines unstable.  Turning off
136      ACPI support may help solve some of these problems; see an item
137      in <xref linkend="late-news">.</para>
138]]>
139
140  </sect1>
141
142  <sect1 id="late-news">
143    <title>Late-Breaking News</title>
144
145<![ %release.type.release [
146    <para>No news.</para>
147]]>
148
149<![ %release.type.snapshot [
150    <para>&man.ipfw.4; should work correctly on strict-alignment
151      64-bit architectures such as alpha and sparc64.</para>
152
153    <para>The release notes should have stated that the
154      <filename>libthr</filename> library is built by default for the
155      i386 platform.</para>
156
157    <para>&os; &release.prev; includes some new boot loader scripts
158      designed to make booting &os; with different options easier.
159      This may help diagnose bootstrapping problems.  These scripts
160      build on the existing Forth-based boot loader scripts (thus,
161      <filename>/boot/loader.conf</filename> and other existing loader
162      configuration files still apply).  They are only installed by
163      default for new binary installs on i386 machines.  The new
164      scripts present a boot-time menu that controls how &os; is
165      booted, and include options to turn off ACPI, a <quote>safe
166      mode</quote> boot, single-user booting, and verbose booting.
167      <quote>Safe mode</quote> booting can be particularly useful when
168      compatibility with a system's hardware is uncertain, and sets
169      the following kernel tunable variables:</para>
170
171      <programlisting>hint.acpi.0.disabled=1 # disable ACPI (i386 only)
172hw.ata.ata_dma=0       # disable IDE DMA
173hw.ata.atapi_dma=0     # disable ATAPI/IDE DMA
174hw.ata.wc=0            # disable IDE disk write cache
175hw.eisa_slots=0        # disable probing for EISA devices</programlisting>
176
177    <para>For new installs on i386 architecture machines,
178      &man.sysinstall.8; will try to determine if ACPI was disabled
179      via the new boot loader scripts mentioned above, and if so,
180      ask if this change should be made permanent.</para>
181
182    <para>The release notes should have mentioned that work on the
183      following features was sponsored by the Defense Advanced
184      Research Projects Agency (DARPA): OpenPAM, NSS support, PAE
185      support, various MAC framework updates, the GEOM disk geometry
186      system.</para>
187]]>
188
189  </sect1>
190
191</article>
192