article.xml revision 142147
1<articleinfo>
2  <title>&os;/&arch; &release.current; Release Notes</title>
3
4  <corpauthor>The &os; Project</corpauthor>
5
6  <pubdate>$FreeBSD: head/release/doc/en_US.ISO8859-1/relnotes/article.sgml 142147 2005-02-20 22:22:32Z bmah $</pubdate>
7
8  <copyright>
9    <year>2000</year>
10    <year>2001</year>
11    <year>2002</year>
12    <year>2003</year>
13    <year>2004</year>
14    <year>2005</year>
15    <holder role="mailto:doc@FreeBSD.org">The &os; Documentation Project</holder>
16  </copyright>
17
18  <abstract>
19    <para>The release notes for &os; &release.current; contain a summary
20      of the changes made to the &os; base system since &release.branch; is created.
21      This document lists applicable security advisories that were issued since
22      the last release, as well as significant changes to the &os;
23      kernel and userland.
24      Some brief remarks on upgrading are also presented.</para>
25  </abstract>
26</articleinfo>
27
28<sect1 id="intro">
29  <title>Introduction</title>
30
31  <para>This document contains the release notes for &os;
32    &release.current; on the &arch.print; hardware platform.  It
33    describes recently added, changed, or deleted features of &os;.
34    It also provides some notes on upgrading
35    from previous versions of &os;.</para>
36
37<![ %release.type.current [
38
39  <para>The &release.type; distribution to which these release notes
40    apply represents the latest point along the &release.branch; development
41    branch since &release.branch; is created.  Some pre-built, binary
42    &release.type; distributions along this branch
43    can be found at <ulink url="&release.url;"></ulink>.</para>
44
45]]>
46
47<![ %release.type.snapshot [
48
49  <para>The &release.type; distribution to which these release notes
50    apply represents a point along the &release.branch; development
51    branch between &release.prev; and the future &release.next;.  Some
52    pre-built, binary &release.type; distributions along this branch
53    can be found at <ulink url="&release.url;"></ulink>.</para>
54
55]]>
56
57<![ %release.type.release [
58
59  <para>This distribution of &os; &release.current; is a
60    &release.type; distribution.  It can be found at <ulink
61    url="&release.url;"></ulink> or any of its mirrors.  More
62    information on obtaining this (or other) &release.type;
63    distributions of &os; can be found in the <ulink
64    url="&url.books.handbook;/mirrors.html"><quote>Obtaining
65    &os;</quote> appendix</ulink> to the <ulink
66    url="&url.books.handbook;/">&os;
67    Handbook</ulink>.</para>
68
69]]>
70
71  <para>All users are encouraged to consult the release errata before
72    installing &os;.  The errata document is updated with
73    <quote>late-breaking</quote> information discovered late in the
74    release cycle or after the release.  Typically, it contains
75    information on known bugs, security advisories, and corrections to
76    documentation.  An up-to-date copy of the errata for &os;
77    &release.current; can be found on the &os; Web site.</para>
78
79</sect1>
80
81<sect1 id="new">
82  <title>What's New</title>
83
84  <para>This section describes
85    the most user-visible new or changed features in &os;
86    since &release.prev;.
87    In general, changes described here are unique to the &release.branch;
88    branch unless specifically marked as &merged; features.
89  </para>
90
91  <para>Typical release note items
92    document recent security advisories issued after
93    &release.prev.historic;,
94    new drivers or hardware support, new commands or options,
95    major bug fixes, or contributed software upgrades.  They may also
96    list changes to major ports/packages or release engineering
97    practices.  Clearly the release notes cannot list every single
98    change made to &os; between releases; this document focuses
99    primarily on security advisories, user-visible changes, and major
100    architectural improvements.</para>
101
102  <sect2 id="security">
103    <title>Security Advisories</title>
104
105    <para></para>
106  </sect2>
107
108  <sect2 id="kernel">
109    <title>Kernel Changes</title>
110
111    <para arch="i386">Support for 80386 processors (the
112      <literal>I386_CPU</literal> kernel configuration option) has
113      been removed.  Users running this class of CPU should use &os;
114      5.<replaceable>X</replaceable> or earlier.</para>
115
116    <para>The loader tunable <varname>debug.mpsafevm</varname> has been
117      has been enabled by default.</para>
118
119    <para>A number of bugs have been fixed in the ULE
120      scheduler. &merged;</para>
121
122    <para>Fine-grained locking to allow much of the VFS stack to run
123      without the Giant lock has been added.  It is currently enabled
124      by the loader tunable (and sysctl variable)
125      <varname>debug.mpsafevfs</varname>, which currently defaults to
126      <literal>0</literal> (disabled).</para>
127
128    <!-- Above this line, sort kernel changes by manpage/keyword-->
129
130    <sect3 id="boot">
131      <title>Boot Loader Changes</title>
132
133      <para arch="i386">A serial console-capable version of
134	<filename>boot0</filename> has been added.  It can be written
135	to a disk using &man.boot0cfg.8; and specifying
136	<filename>/boot/boot0sio</filename> as the argument to the
137	<option>-b</option> option.</para>
138
139      <para arch="i386"><filename>cdboot</filename> now works around a
140	BIOS problem observed on some systems when booting from USB
141	CDROM drives.</para>
142
143      <!-- Above this line, order boot loader changes by keyword-->
144
145    </sect3>
146
147    <sect3 id="proc">
148      <title>Hardware Support</title>
149
150      <para>A framework for flexible processor speed control has been
151	added.  It provides methods for various drivers to control CPU
152	power utilization by adjusting the processor speed.  More
153	details can be found in the &man.cpufreq.4; manual page.
154	Currently supported drivers include acpi_perf (ACPI CPU
155	performance states), icss (Intel SpeedStep for ICH), and
156	acpi_throttle (ACPI CPU throttling).</para>
157
158      <para arch="i386,pc98">Support for the OLDCARD subsystem has
159	been removed.  The NEWCARD system is now used for all PCCARD
160	device support.</para>
161
162      <sect4 id="mm">
163	<title>Multimedia Support</title>
164
165	<para>The &man.uaudio.4; driver now has some added
166	  functionality, including volume control on more inputs and
167	  recording capability on some devices.</para>
168
169      </sect4>
170
171      <sect4 id="net-if">
172	<title>Network Interface Support</title>
173
174	<para>The &man.ath.4; driver has been updated to split the
175	  transmit rate control algorithm into a separate module.
176	  Either <literal>device ath_rate_onoe</literal> or
177	  <literal>device ath_rate_amrr</literal> must be included in
178	  the kernel configuration when using the &man.ath.4;
179	  driver.</para>
180
181	<para arch="amd64">The &man.ndis.4; device driver wrapper now
182	  supports &windows;/x86-64 binaries on amd64
183	  systems. &merged;</para>
184
185	<para>The &man.sf.4; driver now has support for device polling
186	  and &man.altq.4;. &merged;</para>
187
188	<para>The &man.sk.4; driver now has support for &man.altq.4;.
189	  This driver also now supports jumbo frames on Yukon-based
190	  interfaces. &merged;</para>
191
192	<para>Support for 802.11 devices in the &man.wlan.4; has been
193	  greatly overhauled.  In addition to architectural changes,
194	  it includes completed 802.11g, WPA, 802.11i, 802.1x,
195	  WME/WMM, AP-side power-saving, and plugin frameworks for
196	  cryptography modules, authenticators, and access control.
197	  Note in particular that WEP now requires the
198	  <filename>wlan_wep</filename> module to be loaded (or
199	  compiled) into the kernel.</para>
200
201      </sect4>
202    </sect3>
203
204    <sect3 id="net-proto">
205      <title>Network Protocols</title>
206
207      <para>Ongoing work is reducing the use of the Giant lock by the
208	network protocol stack and improving the locking
209	strategies.</para>
210
211      <para>A bug in TCP that sometimes caused RST packets to
212	be ignored if the receive window was zero bytes has been
213	fixed. &merged;</para>
214
215      <para>Several bugs in the TCP SACK implementation have been
216	fixed. &merged;</para>
217
218      <para>RFC 1644 T/TCP support has been removed.</para>
219
220    </sect3>
221
222    <sect3 id="disks">
223      <title>Disks and Storage</title>
224
225      <para>The &man.amr.4; driver is now safe for use on systems
226	using &man.pae.4;. &merged;</para>
227
228      <para>The &man.matcd.4; driver has been removed.</para>
229
230      <para>The default SCSI boot-time probe delay in the
231	<filename>GENERIC</filename> kernel has been reduced from
232	fifteen seconds to five seconds.</para>
233
234      <para arch="pc98">The &man.wd.4; driver has been removed.  The
235	&man.ata.4; driver has been found to work well enough on the
236	pc98 platform that there is no need for the older &man.wd.4;
237	driver.</para>
238
239      <para>Information about newly-mounted cd9660 file systems (such
240	as the presence of Rockridge extensions) is now only printed
241	if the kernel was booted in verbose mode.  This change was
242	made to reduce the amount of (generally unnecessary) kernel
243	log messages.</para>
244
245    </sect3>
246
247    <sect3 id="fs">
248      <title>File Systems</title>
249
250      <para>The autofs(9) file system and the userland library
251	&man.libautofs.3; have been added.</para>
252    </sect3>
253
254    <sect3>
255      <title>Contributed Software</title>
256
257      <para><application>ACPI-CA</application> has been updated from
258	20040527 to 20041119. &merged;</para>
259
260    </sect3>
261  </sect2>
262
263  <sect2 id="userland">
264    <title>Userland Changes</title>
265
266    <para>The &man.burncd.8; utility now allows commands (such as
267      <command>eject</command>) to take place after fixating a
268      disk.</para>
269
270    <para>The <literal>create</literal> command of the &man.gpt.8;
271      utility now supports a <option>-f</option> command-line flag to
272      force creation of a GPT even when there is an MBR record on a
273      disk. &merged;</para>
274
275    <para>The &man.ifconfig.8; utility has been restructured.  It is
276      now more modular and flexible with respect to supporting
277      interface-specific functionality.  The 802.11 support has been
278      updated to support recent changes to the 802.11 subsystem and
279      drivers.</para>
280
281    <para>The <literal>NO_NIS</literal> compile-time knob for userland
282      has been added.  As its name implies, enabling this
283      <filename>Makefile</filename> variable will cause NIS support to
284      be excluded from various programs and will cause the NIS
285      utilities to not be built. &merged;</para>
286
287    <para arch="i386">The &man.mkuzip.8;, which is a non-GPL
288      utility to compress file system images for use with
289      <literal>GEOM_UZIP</literal> &man.geom.4; module,
290      has been added.</para>
291
292    <para>The &man.ncal.1; utility now supports a <option>-m</option>
293      flag to generate a calendar for a specified month in the current
294      year. &merged;</para>
295
296    <para>The &man.mknod.8; utility has been marked deprecated.
297      Device nodes have been managed by the &man.devfs.5; device file
298      system since &os; 5.0.</para>
299
300    <para>For years, &os; has used <filename>Makefile</filename>
301      variables of the form
302      <varname>NO<replaceable>FOO</replaceable></varname> and
303      <varname>NO_<replaceable>FOO</replaceable></varname>.  For
304      consistency, those variables using the former naming convention
305      have been converted to the
306      <varname>NO_<replaceable>FOO</replaceable></varname> form.  The
307      file <filename>/usr/share/mk/bsd.compat.mk</filename> has a
308      complete list of these variables; it also implements some
309      temporary backward compatability for the old names.</para>
310
311    <para>The &man.ppp.8; program now implements an
312      <option>echo</option> parameter, which allows LCP ECHOs to be
313      enabled independently of LQR reports.  Older versions of
314      &man.ppp.8; would revert to LCP ECHO mode on negotiation
315      failure.  It is now necessary to specify <command>enable
316      echo</command> to get this behaviour. &merged;</para>
317
318    <para>The &man.tcpdrop.8; command, which closes a selected TCP
319      connection, has been added.  It was obtained from
320      OpenBSD.</para>
321
322    <para>&man.whois.1; now supports
323      a <option>-k</option> flag
324      for querying <hostid role="fqdn">whois.krnic.net</hostid>
325      (the National Internet Development Agency of Korea)
326      which hold details of IP address allocations within
327      Korea. &merged;</para>
328
329    <sect3 id="rc-scripts">
330      <title><filename>/etc/rc.d</filename> Scripts</title>
331
332      <para></para>
333    </sect3>
334  </sect2>
335
336  <sect2 id="contrib">
337    <title>Contributed Software</title>
338
339    <para><application>FILE</application> has been updated from 4.10
340      to 4.12.</para>
341
342    <para><application>lukemftp</application> has been updated from a
343      26 April 2004 snapshot from OpenBSD's sources to a snapshot as
344      of 19 February 2005.</para>
345
346    <para>A snapshot of <application>netcat</application> from OpenBSD
347      as of 4 February 2005 has been added.  More information can be
348      found in the &man.nc.1; manual page. &merged;</para>
349
350    <para><application>OpenPAM</application> has been updated from the
351      Eelgrass release to the Feterita release.</para>
352
353    <para><application>OpenSSH</application> has been updated from 3.8p1
354      to 3.9p1.</para>
355
356    <para><application>sendmail</application> has been updated from
357      version 8.13.1 to version 8.13.3. &merged;</para>
358
359    <para>The timezone database has been updated from the
360      <application>tzdata2004e</application> release to the
361      <application>tzdata2004g</application> release. &merged;</para>
362
363  </sect2>
364
365  <sect2 id="ports">
366    <title>Ports/Packages Collection Infrastructure</title>
367
368    <para></para>
369  </sect2>
370
371  <sect2 id="releng">
372    <title>Release Engineering and Integration</title>
373
374    <para></para>
375  </sect2>
376
377  <sect2 id="doc">
378    <title>Documentation</title>
379
380    <para></para>
381
382  </sect2>
383</sect1>
384
385<sect1 id="upgrade">
386  <title>Upgrading from previous releases of &os;</title>
387
388  <para></para>
389
390  <important>
391    <para>Upgrading &os; should, of course, only be attempted after
392      backing up <emphasis>all</emphasis> data and configuration
393      files.</para>
394  </important>
395</sect1>
396