release/doc/en_US.ISO8859-1/relnotes/common/new.sgml

   1 <articleinfo>
   2   <title>&os;/&arch; &release.current; Release Notes</title>
   3
   4   <pubdate>$FreeBSD: src/release/doc/en_US.ISO8859-1/relnotes/common/new.sgml,v 1.22.2.355 2003/05/23 15:05:23 bmah Exp $</pubdate>
   5   <pubdate>$DragonFly: src/release/doc/en_US.ISO8859-1/relnotes/common/Attic/new.sgml,v 1.2 2003/06/17 04:27:19 dillon Exp $</pubdate>
   6
   7   <corpauthor>The FreeBSD Project</corpauthor>
   8
   9   <copyright>
  10     <year>2000</year>
  11     <year>2001</year>
  12     <year>2002</year>
  13     <year>2003</year>
  14     <holder role="mailto:doc@FreeBSD.org">The FreeBSD Documentation Project</holder>
  15   </copyright>
  16
  17   <abstract>
  18     <para>The release notes for &os; &release.current; contain a
  19       summary of the changes made to the &os; base system since
  20       &release.prev;.  Both changes for kernel and userland are
  21       listed, as well as applicable security advisories for the base
  22       system that were issued since the last release.  Some brief
  23       remarks on upgrading are also presented.</para>
  24   </abstract>
  25 </articleinfo>
  26
  27 <sect1 id="intro">
  28   <title>Introduction</title>
  29
  30   <para>This document contains the release notes for &os;
  31     &release.current; on the &arch.print; hardware platform.  It
  32     describes new features of &os; that have been added (or changed)
  33     since &release.prev;.  It also provides some notes on upgrading
  34     from previous versions of &os;.</para>
  35
  36 <![ %release.type.snapshot [
  37
  38   <para>The &release.type; distribution to which these release notes
  39     apply represents a point along the &release.branch; development
  40     branch between &release.prev; and the future &release.next;.  Some
  41     pre-built, binary &release.type; distributions along this branch
  42     can be found at <ulink url="&release.url;"></ulink>.</para>
  43
  44 ]]>
  45
  46 <![ %release.type.release [
  47
  48   <para>This distribution of &os; &release.current; is a
  49     &release.type; distribution.  It can be found at <ulink
  50     url="&release.url;"></ulink> or any of its mirrors.  More
  51     information on obtaining this (or other) &release.type;
  52     distributions of &os; can be found in the <ulink
  53     url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/mirrors.html"><quote>Obtaining
  54     FreeBSD</quote></ulink> appendix in the <ulink
  55     url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/">FreeBSD
  56     Handbook</ulink>.</para>
  57
  58 ]]>
  59 </sect1>
  60
  61 <!--
  62         The "What's New" section of the release notes.
  63
  64         Guidelines for new entries:
  65
  66         1.  If there is some obvious "keyword" associated with an
  67         entry (such as a manpage entry or an application name), try to
  68         put it at the start of the sentence.
  69
  70         2.  Within each subsection (i.e. kernel, security, userland),
  71         list items in alphabetical order by these keywords.
  72
  73         Some entries will have no obvious keywords to help with
  74         ordering.  In sections containing these entries, put those
  75         containing (e.g.) manpage references first, then some
  76         suitable SGML comment line as a demarc, then the remaining
  77         entries.
  78
  79 -->
  80
  81 <sect1 id="new">
  82   <title>What's New</title>
  83
  84   <para>This section describes the most user-visible new or changed
  85     features in &os; since &release.prev;.  Typical release note items
  86     document new drivers or hardware support, new commands or options,
  87     major bugfixes, or contributed software upgrades.  Security
  88     advisories for the base system that were issued after
  89     &release.prev; are also listed.</para>
  90
  91   <sect2 id="security">
  92     <title>Security Advisories</title>
  93
  94     <para>A remotely-exploitable buffer overflow vulnerability in
  95       <application>sendmail</application> has been fixed.  For more
  96       details, see security advisory <ulink
  97       url="ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/advisories/FreeBSD-SA-03:07.sendmail.asc">FreeBSD-SA-03:07</ulink>.
  98       In &os; &release.prev;, this vulnerability was fixed using a
  99       vendor-supplied patch (but too late for inclusion in the release
 100       notes).  In &os; &release.current;, it has been fixed with the
 101       import of a new version of
 102       <application>sendmail</application>.</para>
 103
 104   </sect2>
 105
 106   <sect2 id="kernel">
 107     <title>Kernel Changes</title>
 108
 109     <para></para>
 110
 111 <!-- Above this line, kernel changes ordered by manpage/variable name -->
 112
 113     <sect3 id="proc">
 114       <title>Processor/Motherboard Support</title>
 115
 116       <para arch="i386">A bug which prevented the kernel from booting
 117         on an Intel 80386 processor has been corrected.</para>
 118
 119     </sect3>
 120
 121     <sect3 id="boot">
 122       <title>Boot Loaders</title>
 123
 124       <para></para>
 125
 126 <!-- Above this line, order boot loader changes by manpage/variable name-->
 127
 128     </sect3>
 129
 130     <sect3 id="net-if">
 131       <title>Network Interface Support</title>
 132
 133       <para></para>
 134
 135 <!-- Above this line, order network driver changes by manpage/variable name-->
 136
 137     </sect3>
 138
 139     <sect3 id="net-proto">
 140       <title>Network Protocols</title>
 141
 142       <para></para>
 143
 144     </sect3>
 145
 146     <sect3 id="disks">
 147       <title>Disks and Storage</title>
 148
 149       <para></para>
 150
 151     </sect3>
 152
 153     <sect3 id="fs">
 154       <title>Filesystems</title>
 155
 156       <para>A new <literal>DIRECTIO</literal> kernel option enables
 157         support for read operations that bypass the buffer cache and
 158         put data directly into a userland buffer.  This feature
 159         requires that the <literal>O_DIRECT</literal> flag is set on
 160         the file descriptor and that both the offset and length for
 161         the read operation are multiples of the physical media sector
 162         size.</para>
 163
 164     </sect3>
 165
 166     <sect3 id="pccard">
 167       <title>PCCARD Support</title>
 168
 169       <para></para>
 170
 171     </sect3>
 172
 173     <sect3 id="mm">
 174       <title>Multimedia Support</title>
 175
 176       <para></para>
 177
 178     </sect3>
 179   </sect2>
 180
 181   <sect2 id="userland">
 182     <title>Userland Changes</title>
 183
 184     <para>&man.uudecode.1; and &man.b64decode.1; now support a
 185       <option>-r</option> flag for decoding raw (or broken) files that
 186       may be missing the initial and possibly final framing
 187       lines.</para>
 188
 189 <!-- Above this line, order userland changes by manpage/variable name-->
 190
 191   </sect2>
 192
 193   <sect2 id="contrib">
 194     <title>Contributed Software</title>
 195
 196     <para><application>sendmail</application> has been updated to
 197       version 8.12.9.</para>
 198
 199     <para>The timezone database has been updated from
 200       <filename>tzdata2002d</filename> to
 201       <filename>tzdata2003a</filename>.</para>
 202
 203   </sect2>
 204
 205   <sect2 id="ports">
 206     <title>Ports/Packages Collection Infrastructure</title>
 207
 208     <para></para>
 209   </sect2>
 210
 211   <sect2 id="releng">
 212     <title>Release Engineering and Integration</title>
 213
 214     <para>The supported release of <application>GNOME</application>
 215       has been updated to 2.2.1.</para>
 216
 217     <para>The supported release of <application>KDE</application>
 218       has been updated to 3.1.1a.</para>
 219
 220   </sect2>
 221 </sect1>
 222
 223 <sect1 id="upgrade">
 224   <title>Upgrading from previous releases of &os;</title>
 225
 226   <para>If you're upgrading from a previous release of &os;, you
 227     generally will have three options:
 228
 229     <itemizedlist>
 230       <listitem>
 231         <para>Using the binary upgrade option of &man.sysinstall.8;.
 232           This option is perhaps the quickest, although it presumes
 233           that your installation of &os; uses no special compilation
 234           options.</para>
 235       </listitem>
 236       <listitem>
 237         <para>Performing a complete reinstall of &os;.  Technically,
 238           this is not an upgrading method, and in any case is usually less
 239           convenient than a binary upgrade, in that it requires you to
 240           manually backup and restore the contents of
 241           <filename>/etc</filename>.  However, it may be useful in
 242           cases where you want (or need) to change the partitioning of
 243           your disks.
 244       </listitem>
 245       <listitem>
 246         <para>From source code in <filename>/usr/src</filename>.  This
 247           route is more flexible, but requires more disk space, time,
 248           and technical expertise.  More information can be found
 249           in the <ulink
 250           url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html"><quote>Using
 251           <command>make world</command></quote></ulink> section of the <ulink
 252           url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/">FreeBSD
 253           Handbook</ulink>.  Upgrading from very old
 254           versions of &os; may be problematic; in cases like this, it
 255           is usually more effective to perform a binary upgrade or a
 256           complete reinstall.</para>
 257       </listitem>
 258     </itemizedlist>
 259   </para>
 260
 261   <para>Please read the <filename>INSTALL.TXT</filename> file for more
 262     information, preferably <emphasis>before</emphasis> beginning an
 263     upgrade.  If you are upgrading from source, please be sure to read
 264     <filename>/usr/src/UPDATING</filename> as well.</para>
 265
 266   <para>Finally, if you want to use one of various means to track the
 267     -STABLE or -CURRENT branches of &os;, please be sure to consult
 268     the <ulink
 269     url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/current-stable.html"><quote>-CURRENT
 270     vs. -STABLE</quote></ulink> section of the <ulink
 271     url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/">FreeBSD
 272     Handbook</ulink>.</para>
 273
 274   <important>
 275     <para>Upgrading &os; should, of course, only be attempted after
 276       backing up <emphasis>all</emphasis> data and configuration
 277       files.</para>
 278   </important>
 279 </sect1>
 280