release/doc/en_US.ISO8859-1/relnotes/article.sgml

   1 <!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
   2 <!ENTITY % articles.ent PUBLIC "-//FreeBSD//ENTITIES DocBook FreeBSD Articles Entity Set//EN">
   3 %articles.ent;
   4
   5 <!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN">
   6 %release;
   7 ]>
   8
   9 <article>
  10 <articleinfo>
  11   <title>&os; &release.current; Release Notes</title>
  12
  13   <corpauthor>The &os; Project</corpauthor>
  14
  15   <pubdate>$FreeBSD$</pubdate>
  16
  17   <copyright>
  18     <year>2011</year>
  19     <holder role="mailto:doc@FreeBSD.org">The &os; Documentation Project</holder>
  20   </copyright>
  21
  22   <legalnotice id="trademarks" role="trademarks">
  23     &tm-attrib.freebsd;
  24     &tm-attrib.ibm;
  25     &tm-attrib.ieee;
  26     &tm-attrib.intel;
  27     &tm-attrib.sparc;
  28     &tm-attrib.general;
  29   </legalnotice>
  30
  31   <abstract>
  32     <para>The release notes for &os; &release.current; contain a summary
  33       of the changes made to the &os; base system on the
  34       &release.branch; development line.
  35       This document lists applicable security advisories that were issued since
  36       the last release, as well as significant changes to the &os;
  37       kernel and userland.
  38       Some brief remarks on upgrading are also presented.</para>
  39   </abstract>
  40 </articleinfo>
  41
  42 <sect1 id="intro">
  43   <title>Introduction</title>
  44
  45   <para>This document contains the release notes for &os;
  46     &release.current;.  It
  47     describes recently added, changed, or deleted features of &os;.
  48     It also provides some notes on upgrading
  49     from previous versions of &os;.</para>
  50
  51 <![ %release.type.current [
  52
  53   <para>The &release.type; distribution to which these release notes
  54     apply represents the latest point along the &release.branch; development
  55     branch since &release.branch; was created.  Information regarding pre-built, binary
  56     &release.type; distributions along this branch
  57     can be found at <ulink url="&release.url;"></ulink>.</para>
  58
  59 ]]>
  60
  61 <![ %release.type.snapshot [
  62
  63   <para>The &release.type; distribution to which these release notes
  64     apply represents a point along the &release.branch; development
  65     branch between &release.prev; and the future &release.next;.
  66     Information regarding
  67     pre-built, binary &release.type; distributions along this branch
  68     can be found at <ulink url="&release.url;"></ulink>.</para>
  69
  70 ]]>
  71
  72 <![ %release.type.release [
  73
  74   <para>This distribution of &os; &release.current; is a
  75     &release.type; distribution.  It can be found at <ulink
  76     url="&release.url;"></ulink> or any of its mirrors.  More
  77     information on obtaining this (or other) &release.type;
  78     distributions of &os; can be found in the <ulink
  79     url="&url.books.handbook;/mirrors.html"><quote>Obtaining
  80     &os;</quote> appendix</ulink> to the <ulink
  81     url="&url.books.handbook;/">&os;
  82     Handbook</ulink>.</para>
  83
  84 ]]>
  85
  86   <para>All users are encouraged to consult the release errata before
  87     installing &os;.  The errata document is updated with
  88     <quote>late-breaking</quote> information discovered late in the
  89     release cycle or after the release.  Typically, it contains
  90     information on known bugs, security advisories, and corrections to
  91     documentation.  An up-to-date copy of the errata for &os;
  92     &release.current; can be found on the &os; Web site.</para>
  93
  94 </sect1>
  95
  96   <sect1 id="new">
  97     <title>What's New</title>
  98
  99     <para>This section describes the most user-visible new or changed
 100       features in &os; since &release.prev;.</para>
 101
 102     <para>Typical release note items document recent security
 103       advisories issued after &release.prev;, new drivers or hardware
 104       support, new commands or options, major bug fixes, or
 105       contributed software upgrades.  They may also list changes to
 106       major ports/packages or release engineering practices.  Clearly
 107       the release notes cannot list every single change made to &os;
 108       between releases; this document focuses primarily on security
 109       advisories, user-visible changes, and major architectural
 110       improvements.</para>
 111
 112     <sect2 id="security">
 113       <title>Security Advisories</title>
 114
 115       <para>Problems described in the following security advisories have
 116         been fixed.  For more information, consult the individual
 117         advisories available from
 118         <ulink url="http://security.FreeBSD.org/"></ulink>.</para>
 119
 120       <informaltable frame="none" pgwide="0">
 121         <tgroup cols="3">
 122           <colspec colwidth="1*">
 123           <colspec colwidth="1*">
 124           <colspec colwidth="3*">
 125             <thead>
 126               <row>
 127                 <entry>Advisory</entry>
 128                 <entry>Date</entry>
 129                 <entry>Topic</entry>
 130               </row>
 131             </thead>
 132
 133             <tbody>
 134               <row>
 135                 <entry><ulink url="http://security.freebsd.org/advisories/FreeBSD-SA-10:08.bzip2.asc"
 136                               >SA-10:08.bzip2</ulink></entry>
 137                 <entry>20&nbsp;September&nbsp;2010</entry>
 138                 <entry><para>Integer overflow in bzip2 decompression</para></entry>
 139               </row>
 140 <!-- XXX: not for 8.2
 141               <row>
 142                 <entry><ulink url="http://security.freebsd.org/advisories/FreeBSD-SA-10:09.pseudofs.asc"
 143                               >SA-10:09.pseudofs</ulink></entry>
 144                 <entry>10&nbsp;October&nbsp;2010</entry>
 145                 <entry><para>Spurious mutex unlock</para></entry>
 146               </row>
 147 -->
 148               <row>
 149                 <entry><ulink url="http://security.freebsd.org/advisories/FreeBSD-SA-10:10.openssl.asc"
 150                               >SA-10:10.openssl</ulink></entry>
 151                 <entry>29&nbsp;November&nbsp;2010</entry>
 152                 <entry><para>OpenSSL multiple vulnerabilities</para></entry>
 153               </row>
 154             </tbody>
 155         </tgroup>
 156       </informaltable>
 157     </sect2>
 158
 159     <sect2 id="kernel">
 160       <title>Kernel Changes</title>
 161
 162       <para></para>
 163
 164       <sect3 id="boot">
 165         <title>Boot Loader Changes</title>
 166
 167         <para></para>
 168       </sect3>
 169
 170       <sect3 id="proc">
 171         <title>Hardware Support</title>
 172
 173         <para></para>
 174
 175         <sect4 id="mm">
 176           <title>Multimedia Support</title>
 177
 178           <para></para>
 179         </sect4>
 180
 181         <sect4 id="net-if">
 182           <title>Network Interface Support</title>
 183
 184           <para></para>
 185         </sect4>
 186       </sect3>
 187
 188       <sect3 id="net-proto">
 189         <title>Network Protocols</title>
 190
 191         <para></para>
 192       </sect3>
 193
 194       <sect3 id="disks">
 195         <title>Disks and Storage</title>
 196
 197         <para></para>
 198       </sect3>
 199
 200       <sect3 id="fs">
 201         <title>File Systems</title>
 202
 203         <para></para>
 204       </sect3>
 205     </sect2>
 206
 207     <sect2 id="userland">
 208       <title>Userland Changes</title>
 209
 210       <para></para>
 211
 212       <sect3 id="rc-scripts">
 213         <title><filename>/etc/rc.d</filename> Scripts</title>
 214
 215         <para></para>
 216       </sect3>
 217     </sect2>
 218
 219     <sect2 id="contrib">
 220       <title>Contributed Software</title>
 221
 222       <para></para>
 223 <!--
 224       <para>The <application>ACPI-CA</application> has been updated to
 225         20100304.</para>
 226
 227       <para>The <application>awk</application> has been updated from
 228         the 23 October 2007 release to the 26 November 2009 release.</para>
 229
 230       <para><application>ISC BIND</application> has been updated to
 231         version 9.6.2-P2.</para>
 232
 233       <para><application>netcat</application> has been updated to
 234         version 4.7.</para>
 235
 236       <para><application>OpenSSH</application> has been updated from
 237         version 5.1p1 to version 5.4p1.</para>
 238
 239       <para><application>OpenSSL</application> has been updated to
 240         version 0.9.8n.</para>
 241
 242       <para><application>sendmail</application> has been updated to
 243         version 8.14.4.</para>
 244
 245       <para>The timezone database has been updated to the
 246         <application>tzdata2010j</application> release.</para>
 247 -->
 248     </sect2>
 249
 250     <sect2 id="releng">
 251       <title>Release Engineering and Integration</title>
 252
 253       <para>The supported version of
 254         the <application>GNOME</application> desktop environment
 255         (<filename role="package">x11/gnome2</filename>) has been
 256         updated to 2.32.1.</para>
 257
 258       <para>The supported version of
 259         the <application>KDE</application> desktop environment
 260         (<filename role="package">x11/kde4</filename>) has been
 261         updated to 4.5.5.</para>
 262     </sect2>
 263   </sect1>
 264
 265   <sect1 id="upgrade">
 266     <title>Upgrading from previous releases of &os;</title>
 267
 268     <para arch="amd64,i386">Upgrades between RELEASE versions (and
 269       snapshots of the various security branches) are supported using
 270       the &man.freebsd-update.8; utility.  The binary upgrade
 271       procedure will update unmodified userland utilities, as well as
 272       unmodified GENERIC kernel distributed as a part of an
 273       official &os; release.  The &man.freebsd-update.8; utility
 274       requires that the host being upgraded has Internet
 275       connectivity.</para>
 276
 277     <para>An older form of binary upgrade is supported through the
 278       <command>Upgrade</command> option from the main
 279       &man.sysinstall.8; menu on CDROM distribution media.  This type
 280       of binary upgrade may be useful on non-&arch.i386;,
 281       non-&arch.amd64; machines or on systems with no Internet
 282       connectivity.</para>
 283
 284     <para>Source-based upgrades (those based on recompiling the &os;
 285       base system from source code) from previous versions are
 286       supported, according to the instructions in
 287       <filename>/usr/src/UPDATING</filename>.</para>
 288
 289     <important>
 290       <para>Upgrading &os; should, of course, only be attempted after
 291         backing up <emphasis>all</emphasis> data and configuration
 292         files.</para>
 293     </important>
 294   </sect1>
 295 </article>