article.xml revision 149248
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 149248 2005-08-18 19:05:46Z joel $</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  <legalnotice id="trademarks" role="trademarks">
19    &tm-attrib.freebsd;
20    &tm-attrib.ibm;
21    &tm-attrib.ieee;
22    &tm-attrib.intel;
23    &tm-attrib.sparc;
24    &tm-attrib.general;
25  </legalnotice>
26
27  <abstract>
28    <para>The release notes for &os; &release.current; contain a summary
29      of the changes made to the &os; base system on the
30      &release.branch; development line.
31      This document lists applicable security advisories that were issued since
32      the last release, as well as significant changes to the &os;
33      kernel and userland.
34      Some brief remarks on upgrading are also presented.</para>
35  </abstract>
36</articleinfo>
37
38<sect1 id="intro">
39  <title>Introduction</title>
40
41  <para>This document contains the release notes for &os;
42    &release.current; on the &arch.print; hardware platform.  It
43    describes recently added, changed, or deleted features of &os;.
44    It also provides some notes on upgrading
45    from previous versions of &os;.</para>
46
47<![ %release.type.current [
48
49  <para>The &release.type; distribution to which these release notes
50    apply represents the latest point along the &release.branch; development
51    branch since &release.branch; was created.  Information regarding pre-built, binary
52    &release.type; distributions along this branch
53    can be found at <ulink url="&release.url;"></ulink>.</para>
54
55]]>
56
57<![ %release.type.snapshot [
58
59  <para>The &release.type; distribution to which these release notes
60    apply represents a point along the &release.branch; development
61    branch between &release.prev; and the future &release.next;.
62    Information regarding
63    pre-built, binary &release.type; distributions along this branch
64    can be found at <ulink url="&release.url;"></ulink>.</para>
65
66]]>
67
68<![ %release.type.release [
69
70  <para>This distribution of &os; &release.current; is a
71    &release.type; distribution.  It can be found at <ulink
72    url="&release.url;"></ulink> or any of its mirrors.  More
73    information on obtaining this (or other) &release.type;
74    distributions of &os; can be found in the <ulink
75    url="&url.books.handbook;/mirrors.html"><quote>Obtaining
76    &os;</quote> appendix</ulink> to the <ulink
77    url="&url.books.handbook;/">&os;
78    Handbook</ulink>.</para>
79
80]]>
81
82  <para>All users are encouraged to consult the release errata before
83    installing &os;.  The errata document is updated with
84    <quote>late-breaking</quote> information discovered late in the
85    release cycle or after the release.  Typically, it contains
86    information on known bugs, security advisories, and corrections to
87    documentation.  An up-to-date copy of the errata for &os;
88    &release.current; can be found on the &os; Web site.</para>
89
90</sect1>
91
92<sect1 id="new">
93  <title>What's New</title>
94
95  <para>This section describes
96    the most user-visible new or changed features in &os;
97    since &release.prev;.
98    In general, changes described here are unique to the &release.branch;
99    branch unless specifically marked as &merged; features.
100  </para>
101
102  <para>Typical release note items
103    document recent security advisories issued after
104    &release.prev.historic;,
105    new drivers or hardware support, new commands or options,
106    major bug fixes, or contributed software upgrades.  They may also
107    list changes to major ports/packages or release engineering
108    practices.  Clearly the release notes cannot list every single
109    change made to &os; between releases; this document focuses
110    primarily on security advisories, user-visible changes, and major
111    architectural improvements.</para>
112
113  <sect2 id="security">
114    <title>Security Advisories</title>
115
116    <para></para>
117  </sect2>
118
119  <sect2 id="kernel">
120    <title>Kernel Changes</title>
121
122    <para>A new sysctl variable <varname>kern.malloc_stats</varname>
123      has been added.  This allows to export kernel malloc
124      statistics via a binary structure stream.</para>
125
126    <para>A new sysctl variable <varname>vm.zone_stats</varname>
127      has been added.  This allows to export &man.uma.9; allocator
128      statistics via a binary structure stream.</para>
129
130    <sect3 id="boot">
131      <title>Boot Loader Changes</title>
132
133      <para></para>
134
135      <!-- Above this line, order boot loader changes by keyword-->
136
137    </sect3>
138
139    <sect3 id="proc">
140      <title>Hardware Support</title>
141
142      <para></para>
143
144      <sect4 id="mm">
145	<title>Multimedia Support</title>
146
147	<para></para>
148      </sect4>
149
150      <sect4 id="net-if">
151	<title>Network Interface Support</title>
152
153	<para></para>
154      </sect4>
155    </sect3>
156
157    <sect3 id="net-proto">
158      <title>Network Protocols</title>
159
160      <para></para>
161    </sect3>
162
163    <sect3 id="disks">
164      <title>Disks and Storage</title>
165
166      <para>The &man.mpt.4; driver has been updated to support
167	various new features such as RAID volume and RAID member
168	state/settings reporting, periodic volume re-synchronization
169	status reporting, and sysctl variables for volume
170	re-synchronization rate, volume member write cache status,
171	and volume transaction queue depth.</para>
172    </sect3>
173
174    <sect3 id="fs">
175      <title>File Systems</title>
176
177      <para></para>
178    </sect3>
179
180    <sect3>
181      <title>Contributed Software</title>
182
183      <para></para>
184    </sect3>
185  </sect2>
186
187  <sect2 id="userland">
188    <title>Userland Changes</title>
189
190    <para>The &man.ifconfig.8; utility now supports
191      a <option>-k</option> flag to allow printing
192      potentially sensitive keying material to standard output.
193      This sensitive information will not be printed by default.</para>
194
195    <para>The &man.libmemstat.3; library has been added.
196      This is for use by debugging and monitoring applications
197      in tracking kernel memory statistics.  It provides an
198      abstracted interface to &man.uma.9; and &man.malloc.9;
199      statistics, wrapped around the binary stream sysctl variables
200      for the allocators.</para>
201
202    <sect3 id="rc-scripts">
203      <title><filename>/etc/rc.d</filename> Scripts</title>
204
205      <para></para>
206    </sect3>
207  </sect2>
208
209  <sect2 id="contrib">
210    <title>Contributed Software</title>
211
212    <para><application>libpcap</application> has been updated
213      to v0.9.1 (release).</para>
214
215    <para><application>tcpdump</application> has been updated
216      to v3.9.1 (release).</para>
217  </sect2>
218
219  <sect2 id="ports">
220    <title>Ports/Packages Collection Infrastructure</title>
221
222    <para></para>
223  </sect2>
224
225  <sect2 id="releng">
226    <title>Release Engineering and Integration</title>
227
228    <para></para>
229  </sect2>
230
231  <sect2 id="doc">
232    <title>Documentation</title>
233
234    <para>Documentation of existing functionality has been improved by
235      the addition of the following manual page:
236      &man.snd.t4dwave.4;.</para>
237  </sect2>
238</sect1>
239
240<sect1 id="upgrade">
241  <title>Upgrading from previous releases of &os;</title>
242
243  <para></para>
244
245  <important>
246    <para>Upgrading &os; should, of course, only be attempted after
247      backing up <emphasis>all</emphasis> data and configuration
248      files.</para>
249  </important>
250</sect1>
251