article.xml revision 110463
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 110463 2003-02-06 17:06:57Z 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      This information includes security advisories, as well as news
60      relating to the software or documentation that could affect its
61      operation or usability.  An up-to-date version of this document
62      should always be consulted before installing this version of
63      &os;.</para>
64
65    <para>This errata document for &os; 
66<![ %release.type.snapshot [
67      &release.prev;
68]]>
69<![ %release.type.release [
70      &release.current;
71]]>
72      will be maintained until the release of &os; 5.1-RELEASE.</para>
73  </abstract>
74
75  <sect1 id="intro">
76    <title>Introduction</title>
77
78    <para>This errata document contains <quote>late-breaking news</quote>
79      about &os;
80<![ %release.type.snapshot [
81      &release.prev;.
82]]>
83<![ %release.type.release [
84      &release.current;.
85]]>
86      Before installing this version, it is important to consult this
87      document to learn about any post-release discoveries or problems
88      that may already have been found and fixed.</para>
89
90    <para>Any version of this errata document actually distributed
91      with the release (for example, on a CDROM distribution) will be
92      out of date by definition, but other copies are kept updated on
93      the Internet and should be consulted as the <quote>current
94      errata</quote> for this release.  These other copies of the
95      errata are located at <ulink
96      url="http://www.FreeBSD.org/releases/"></ulink>, plus any sites
97      which keep up-to-date mirrors of this location.</para>
98
99    <para>Source and binary snapshots of &os; &release.branch; also
100      contain up-to-date copies of this document (as of the time of
101      the snapshot).</para>
102
103    <para>For a list of all &os; CERT security advisories, see <ulink
104      url="http://www.FreeBSD.org/security/"></ulink> or <ulink
105      url="ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/"></ulink>.</para>
106
107  </sect1>
108
109  <sect1 id="security">
110    <title>Security Advisories</title>
111
112    <para>Remotely exploitable vulnerabilities in
113      <application>CVS</application> could allow an attacker to
114      execute arbitrary comands on a CVS server.  More details can be
115      found in security advisory <ulink
116      url="ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/advisories/FreeBSD-SA-03:01.cvs.asc">FreeBSD-SA-03:01</ulink>.</para>
117
118  </sect1>
119
120  <sect1 id="late-news">
121    <title>Late-Breaking News</title>
122
123    <bridgehead renderas="sect3">GEOM</bridgehead>
124
125    <para>The &man.geom.4;-based disk partitioning code in the kernel
126      will not allow an open partition to be overwritten.  This
127      usually prevents the use of <command>disklabel -B</command> to
128      update the boot blocks on a disk because the
129      <literal>a</literal> partition overlaps the space where the boot
130      blocks are stored.  A suggested workaround is to boot from an
131      alternate disk, a CDROM, or a fixit floppy.</para>
132
133    <bridgehead renderas="sect3">&man.dump.8;</bridgehead>
134
135    <para>When using disk media with sector sizes larger than 512
136      bytes (for instance, &man.gbde.4; encrypted disks), the
137      &man.dump.8; program fails to respect the larger sector size and
138      cannot dump the partition.  One possible workaround is to copy
139      the entire file system in raw format and dump the copy.  It is,
140      for instance, possible to dump a file system stored in a regular
141      file:</para>
142
143      <screen>&prompt.root; <userinput>dd if=/dev/ad0s1d.bde of=/junk/ad0.dd bs=1m</userinput>
144&prompt.root; <userinput>dump 0f - /junk/ad0.dd | ...</userinput></screen>
145
146    <para>A simpler workaround is to use &man.tar.1; or &man.cpio.1;
147      to make backup copies.</para>
148
149    <bridgehead renderas="sect3">&man.mly.4;</bridgehead>
150
151    <para>Hangs have been reported during &os; 5.0 snapshot
152      installations when installing to &man.mly.4;-supported RAID
153      arrays, in hardware configurations that appear to work fine
154      under &os; 4.7-RELEASE.</para>
155
156    <bridgehead renderas="sect3">NETNCP/Netware File System
157      Support</bridgehead>
158
159    <para>NETNCP and nwfs appear to be as-yet unadapted for KSE, and
160      hence not working.</para>
161
162    <bridgehead renderas="sect3">&man.iir.4; controller</bridgehead>
163
164    <para>During installation, the &man.iir.4; controller appears to
165      probe correctly, but finds no disk devices.</para>
166
167    <bridgehead renderas="sect3">&man.truss.1; race condition</bridgehead>
168
169    <para>&man.truss.1; appears to contain a race condition during the
170      start-up of debugging, which can result in &man.truss.1; failing
171      to attach to the process before it exists.  The symptom is that
172      &man.truss.1; reports that it cannot open the &man.procfs.5;
173      node supporting the process being debugged.  A bug also appears
174      to exist wherein &man.truss.1; will hang if &man.execve.2;
175      returns <literal>ENOENT</literal> A further race appears to
176      exist in which &man.truss.1; will return <errorname>PIOCWAIT:
177      Input/output error</errorname> occasionally on startup.  The fix
178      for this sufficiently changes process execution handling that it
179      has been deferred until after 5.0.</para>
180
181    <bridgehead renderas="sect3">Disk Partitioning in Installer</bridgehead>
182
183    <para>Some bugs have been reported in &man.sysinstall.8; disk
184      partitioning.  One observed problem on the i386 is that
185      &man.sysinstall.8; cannot recalculate the free space left on a
186      disk after changing the type of an FDISK-type partition.</para>
187
188    <bridgehead renderas="sect3">Stale Documentation</bridgehead>
189
190    <para>In some case, documentation (such as the FAQ or Handbook)
191      has not been updated to take into account &os; &release.prev;
192      features.  Examples of areas where documentation is still
193      needed include &man.gbde.8; and the new <quote>fast
194      IPsec</quote> implementation.</para>
195
196    <bridgehead renderas="sect3">SMB File System</bridgehead>
197
198    <para>Attempting to unmount smbfs shares may fail with
199      <errorname>Device busy</errorname> errors even when the
200      mount-point is not really busy.  A workaround is to keep trying
201      to unmount the share until it eventually succeeds.  This bug has
202      been fixed in &release.current;.</para>
203
204    <para>Forcefully unmounting (<command>umount -f</command>) smbfs
205      shares may cause a kernel panic.  This bug has been fixed in
206      &release.current;.</para>
207
208    <bridgehead renderas="sect3">&man.fstat.2;</bridgehead>
209
210    <para>When called on a connected socket file descriptor,
211      &man.fstat.2; is supposed to return the number of bytes
212      available to read in the <varname>st_size</varname> member of
213      <varname>struct stat</varname>. However,
214      <varname>st_size</varname> is always erroneously reported as
215      <literal>0</literal> on TCP sockets.  This bug has been fixed in
216      &release.current;.</para>
217
218    <bridgehead renderas="sect3">Kernel Event Queues</bridgehead>
219
220    <para>The &man.kqueue.2; <literal>EVFILT_READ</literal> filter
221      erroneously indicates that <literal>0</literal> bytes are
222      available to be read on TCP sockets, regardless of the number of
223      bytes that are actually available. The
224      <literal>NOTE_LOWAT</literal> flag for
225      <literal>EVFILT_READ</literal> is also broken on TCP sockets.
226      This bug has been fixed in &release.current;.</para>
227
228    <bridgehead renderas="sect3">POSIX Named Semaphores</bridgehead>
229
230    <para>&os; &release.prev; introduced support for POSIX named semaphores
231      but the implementation contains a critical bug that causes
232      &man.sem.open.3; to incorrectly handle the opening of the same
233      semaphore multiple times by the same process, and that causes
234      &man.sem.close.3; to crash calling programs.  This bug has been
235      fixed in &release.current;.</para>
236
237    <bridgehead renderas="sect3"><filename>/dev/tty</filename>
238      Permissions</bridgehead>
239
240    <para>&os; &release.prev; has a minor bug in how the permissions of
241      <filename>/dev/tty</filename> are handled.  This can be
242      triggered by logging in as a non-<username>root</username>,
243      non-<groupname>tty</groupname> group user, and using &man.su.1;
244      to switch to a second non-<username>root</username>,
245      non-<groupname>tty</groupname> group user.  &man.ssh.1; will
246      fail because it cannot open <filename>/dev/tty</filename>.  This
247      bug has been fixed in &release.current;.</para>
248
249    <bridgehead renderas="sect3">&man.growfs.8;</bridgehead>
250
251    <para>&man.growfs.8; no longer works on &man.vinum.4; volumes (and
252      presumably, on &man.geom.4; entities) since these subsystems no
253      longer fake disklabels, but &man.growfs.8; insists on examining
254      a label.</para>
255
256    <bridgehead renderas="sect3">IPFW</bridgehead>
257
258    <para>&man.ipfw.4; <literal>skipto</literal> rules do not work
259      when coupled with the <literal>log</literal> keyword.  This bug
260      has been fixed in &release.current;.</para>
261
262    <bridgehead renderas="sect3">Passwords and &man.adduser.8;</bridgehead>
263
264    <para>&man.adduser.8; does not correctly handle setting user
265      passwords containing special shell characters.  This problem has
266      been corrected in &release.current;.</para>
267
268    <bridgehead renderas="sect3">&man.xl.4;</bridgehead>
269
270    <para>The &man.xl.4; driver has a timing bug that may cause a
271      kernel panic (or other problems) when attempting to configure an
272      interface.  This bug has been fixed in &release.current;.</para>
273
274    <bridgehead renderas="sect3">ISC DHCP</bridgehead>
275
276    <para><application>ISC DHCP</application> was updated to
277      3.0.1rc11.  This update was actually a part of &os;
278      &release.prev;, but was not documented in the release
279      notes.</para>
280
281    <bridgehead renderas="sect3">&man.amd.8;
282      Interoperability</bridgehead>
283
284    <para>&release.prev; contains some bugs in its non-blocking RPC
285      code.  The most noticeable side-effect of these bugs was that
286      &man.amd.8; users were not able to mount volumes from a
287      &release.prev; server.  This bug has been fixed in
288      &release.current;.</para>
289
290  </sect1>
291</article>
292