article.xml revision 121080
1<articleinfo>
2  <title>&os;/&arch; &release.current; Release Notes</title>
3
4  <corpauthor>The FreeBSD Project</corpauthor>
5
6  <pubdate>$FreeBSD: head/release/doc/en_US.ISO8859-1/relnotes/article.sgml 121080 2003-10-14 05:36:36Z rushani $</pubdate>
7
8  <copyright>
9    <year>2000</year>
10    <year>2001</year>
11    <year>2002</year>
12    <year>2003</year>
13    <holder role="mailto:doc@FreeBSD.org">The FreeBSD Documentation Project</holder>
14  </copyright>
15
16  <abstract>
17    <para>The release notes for &os; &release.current; contain a summary
18      of
19<![ %include.historic; [
20      the changes made to the &os; base system since &release.prev;.
21]]>
22<![ %no.include.historic; [
23      recent changes made to the &os; base system on the &release.branch;
24      development branch.
25]]>
26      This document lists applicable security advisories that were issued since
27      the last release, as well as significant changes to the &os;
28      kernel and userland.
29      Some brief remarks on upgrading are also presented.</para>
30  </abstract>
31</articleinfo>
32
33<sect1 id="intro">
34  <title>Introduction</title>
35
36  <para>This document contains the release notes for &os;
37    &release.current; on the &arch.print; hardware platform.  It
38    describes recently added, changed, or deleted features of &os;.
39    It also provides some notes on upgrading
40    from previous versions of &os;.</para>
41
42<![ %release.type.snapshot [
43
44  <para>The &release.type; distribution to which these release notes
45    apply represents a point along the &release.branch; development
46    branch between &release.prev; and the future &release.next;.  Some
47    pre-built, binary &release.type; distributions along this branch
48    can be found at <ulink url="&release.url;"></ulink>.</para>
49
50]]>
51
52<![ %release.type.release [
53
54  <para>This distribution of &os; &release.current; is a
55    &release.type; distribution.  It can be found at <ulink
56    url="&release.url;"></ulink> or any of its mirrors.  More
57    information on obtaining this (or other) &release.type;
58    distributions of &os; can be found in the <ulink
59    url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/mirrors.html"><quote>Obtaining
60    FreeBSD</quote> appendix</ulink> to the <ulink
61    url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/">FreeBSD
62    Handbook</ulink>.</para>
63
64]]>
65
66  <para>Users who are new to the &release.branch; series of &os;
67    &release.type;s should also read the <quote>Early Adopters Guide
68    to &os; &release.current;</quote>.  This document can generally be
69    found in the same location as the release notes (either as a part of a
70    &os; distribution or on the &os; Web site).  It contains important
71    information regarding the advantages and disadvantages of using
72    &os; &release.current;, as opposed to releases based on the &os;
73    4-STABLE development branch.</para>
74
75  <para>All users are encouraged to consult the release errata before
76    installing &os;.  The errata document is updated with
77    <quote>late-breaking</quote> information discovered late in the
78    release cycle or after the release.  Typically, it contains
79    information on known bugs, security advisories, and corrections to
80    documentation.  An up-to-date copy of the errata for &os;
81    &release.current; can be found on the &os; Web site.</para>
82
83</sect1>
84
85<sect1 id="new">
86  <title>What's New</title>
87
88  <para>This section describes
89<![ %include.historic; [
90      the most user-visible new or changed features in &os;
91      since &release.prev;.
92      In general, changes described here are unique to the &release.branch;
93      branch unless specifically marked as &merged; features.
94]]>
95<![ %no.include.historic; [
96      many of the user-visible new or changed features in &os;
97      since &release.prev;.  It includes items that are unique to the
98      &release.branch; branch, as well as some features that may have been
99      recently merged to
100      other branches (after &os; &release.prev.historic;).  The latter
101      items are marked as &merged;.
102]]>
103  </para>
104
105  <para>Typical release note items
106    document recent security advisories issued after
107    &release.prev.historic;,
108    new drivers or hardware support, new commands or options,
109    major bug fixes, or contributed software upgrades.  They may also
110    list changes to major ports/packages or release engineering
111    practices.  Clearly the release notes cannot list every single
112    change made to &os; between releases; this document focuses
113    primarily on security advisories, user-visible changes, and major
114    architectural improvements.</para>
115
116  <sect2 id="security">
117    <title>Security Advisories</title>
118
119    <para>A single-byte buffer overflow in &man.realpath.3; was
120      fixed.  Although the fix was committed prior to &os;
121      &release.prev; (and thus &release.prev; was not affected),
122      it was not noted in the release documentation.  See security advisory 
123      <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/advisories/FreeBSD-SA-03:08.realpath.asc">FreeBSD-SA-03:08</ulink>. &merged;</para>
124
125    <para>A bug that could allow the kernel to attempt delivery of
126      invalid signals has been fixed.  The bug could have led to a
127      kernel panic or, under some circumstances, unauthorized
128      modification of kernel memory.  For more information, see
129      security advisory
130      <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/advisories/FreeBSD-SA-03:09.signal.asc">FreeBSD-SA-03:09</ulink>. &merged;</para>
131
132    <para>A bug in the iBCS2 emulation module, which could result in
133      disclosing the contents of kernel memory, has been fixed.  This
134      module is not enabled in &os; by default.  For more information,
135      see security advisory
136      <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/advisories/FreeBSD-SA-03:10.ibcs2.asc">FreeBSD-SA-03:10</ulink>. &merged;</para>
137
138    <para>A buffer management bug in
139      <application>OpenSSH</application>, which could potentially
140      cause a crash, has been fixed.  More information can be found in
141      security advisory 
142      <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/advisories/FreeBSD-SA-03:12.openssh.asc">FreeBSD-SA-03:12</ulink>. &merged;</para>
143
144    <para>A buffer overflow in <application>sendmail</application> has
145      been fixed.  More information can be found in security advisory
146      <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/advisories/FreeBSD-SA-03:13.sendmail.asc">FreeBSD-SA-03:13</ulink>.
147      &merged;</para>
148
149    <para>A bug that could allow the kernel to cause resource starvation
150      which eventually results in a system panic in the ARP cache code
151      has been fixed.  More information can be found in security advisory
152      <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/advisories/FreeBSD-SA-03:14.arp.asc">FreeBSD-SA-03:14</ulink>.
153      &merged;</para>
154
155    <para>Several errors in the <application>OpenSSH</application> PAM
156      challenge/authentication subsystem have been fixed.  The impacts
157      of these bugs vary; details can be found in security advisory
158      <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/advisories/FreeBSD-SA-03:15.openssh.asc">FreeBSD-SA-03:15</ulink>.
159      &merged;</para>
160
161    <para>A bug in &man.procfs.5; and &man.linprocfs.5;, which could result in
162      disclosing the contents of kernel memory, has been fixed.
163      More information can be found in security advisory
164      <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/advisories/FreeBSD-SA-03:17.procfs.asc">FreeBSD-SA-03:17</ulink>.
165      &merged;</para>
166
167    <para>Four separate security flaws in <application>OpenSSL</application>,
168      which could allow a remote attacker to crash an
169      <application>OpenSSL</application>-using application or
170      to execute arbitrary code with the privileges of the application,
171      have been fixed.
172      More information can be found in security advisory 
173      <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/advisories/FreeBSD-SA-03:18.openssl.asc">FreeBSD-SA-03:18</ulink>. &merged;</para>
174  </sect2>
175
176  <sect2 id="kernel">
177    <title>Kernel Changes</title>
178
179    <para arch="i386">A bug that even when no AT keyboard is connected,
180      &man.atkbd.4; registers an AT keyboard during console initialization
181      has been fixed.  <command>kbdcontrol -k /dev/kbd1</command>
182      is no longer needed when only a USB keyboard is connected.
183      &merged;</para>
184
185    <para arch="i386,pc98">The DRM kernel modules have been updated from
186      DRI CVS as of 9 September 2003.  Among other changes, this
187      import includes a newly-ported SiS 300/305/540/630/730
188      driver.</para>
189
190    <para>A multi-byte character set conversion method is now supported
191      by the <literal>LIBICONV</literal> kernel option.</para>
192
193    <para arch="sparc64">A new OFW PCI framework, conditional on the
194      <literal>OFW_NEWPCI</literal> kernel configuration option, has
195      been added.  This addition improves the handling of PCI busses.
196      One user-visible change is that the enumeration of devices is
197      closer to &solaris; (as a result of this change, the numbering
198      of devices may change if more than one unit of a device type is
199      present).  The <literal>OFW_NEWPCI</literal> kernel
200      configuration is enabled by default in the
201      <filename>GENERIC</filename> kernel.</para>
202
203    <para arch="i386,pc98">The &man.hifn.4; driver now supports 
204      symmetric crypto for the 7955 and 7956 chipsets.
205      &merged;</para>
206
207    <para arch="amd64,alpha,i386,ia64,pc98">The &man.puc.4;, 
208      PCI Universal Communications driver now supports
209      to connect parallel ports to the &man.ppc.4; driver.</para>
210
211    <para arch="i386,pc98">The &man.safe.4; driver has been added
212      to support SafeNet 1141, 1741-based crypto accelerators.
213      &merged;
214
215      <warning>
216	<para>This driver should be considered experimental and
217	  and should be used with some caution.</para>
218      </warning>
219
220      <note>
221        <para>The public key support is not implemented.</para>
222      </note></para>
223
224    <para>A kernel software watchdog facility has been implemented.
225      For more information, see &man.watchdog.4; and
226      &man.watchdogd.8;.</para>
227
228    <!-- Above this line, sort kernel changes by manpage/keyword-->
229
230    <para>The swap pager has been revamped.  Among user-visible
231      changes are a change in the layout policy (from fixed-width
232      striping to a round-robin across devices) for better I/O
233      throughput, the elimination of compile-time limits on the number
234      of swap devices, and a reduction in memory overheads.</para>
235
236    <sect3 id="proc">
237      <title>Platform-Specific Hardware Support</title>
238
239      <para arch="i386">PCI interrupts are always routed on i386 UP
240	machines, which may improve the usability of some PCI devices
241	(particularly on laptops).</para>
242
243      <para arch="i386">An integer overflow that could cause kernel
244        panics on PAE machines of certain large memory sizes has been
245        corrected.</para>
246
247      <para arch="i386,pc98">Floating point emulation in the kernel has
248	been removed.</para>
249
250    </sect3>
251
252    <sect3 id="boot">
253      <title>Boot Loader Changes</title>
254
255      <para></para>
256
257      <!-- Above this line, order boot loader changes by keyword-->
258
259    </sect3>
260
261    <sect3 id="net-if">
262      <title>Network Interface Support</title>
263
264      <para>The new &man.ath.4; and &man.ath.hal.4; drivers provide
265	support for 802.11a/b/g devices based on the AR5210, AR5211,
266	and AR5212 chips.</para>
267
268      <para>The &man.bfe.4; driver has been added to support Broadcom
269	BCM4401 based Fast Ethernet adapters.</para>
270
271      <para>&man.bge.4; now supports Broadcom 5705 based Gigabit Ethernet NICs.
272        &merged;</para>
273
274      <para>A bug in the &man.bge.4; driver that prevented it from
275	working correctly at 10 Mbps has been fixed.</para>
276
277      <para>The &man.em.4; driver now has support for tuning
278        the interrupt delays using sysctl tunables
279        without recompiling the driver.</para>
280
281      <para arch="i386,pc98,sparc64">The &man.harp.4; driver has been added.
282        This is a pseudo physical interface driver for HARP, 
283        which attaches to all netgraph ATM interface in the
284        system and presents a physical interface to the HARP stack
285        for each of these interfaces.</para>
286
287      <para arch="i386,pc98,sparc64">The &man.hatm.4; driver has been added
288        to support Fore/Marconi HE155 and HE622 ATM cards.</para>
289
290      <para arch="i386,pc98,sparc64">The &man.patm.4; driver has been added to
291        support IDT77252 based ATM interfaces.</para>
292
293      <para>The &man.re.4; driver has been added.  It provides support
294	for the RealTek RTL8139C+, RTL8169, RTL8169S and RTL8110S PCI
295	Fast Ethernet and Gigabit Ethernet controllers.</para>
296
297      <para>&man.sk.4; now supports SK-9521 V2.0 and 3COM 3C940 based Gigabit
298        Ethernet NICs.</para>
299
300      <para>The &man.uart.4; driver has been added to support various
301	classes of UART (Universal Asynchronous Receiver/Transmitter)
302	devices.  It is an analog of the &man.sio.4; driver but
303	supports a wider range of devices.  This driver is necessary
304	to support serial ports on certain architectures, such as
305	ia64 and sparc64.</para>
306
307      <para>The suspend/resume support for the &man.wi.4; driver
308        now works correctly when the device is configured down.
309        &merged;</para>
310
311      <para>The 802.11 support layer has been rewritten to allow for
312	future growth and new features.</para>
313    </sect3>
314
315    <sect3 id="net-proto">
316      <title>Network Protocols</title>
317
318      <para>An <literal>IP_ONESBCAST</literal> option has been added
319	to enable undirected &man.ip.4; broadcasts to be sent to
320	specific network interfaces.</para>
321
322      <para>&man.ipfw.4; rules now support comma-separated address lists
323        (such as <literal>1.2.3.4, 5.6.7.8/30, 9.10.11.12/22</literal>),
324        and allow spaces after commas to make lists of addresses more readable.
325        &merged;</para>
326
327      <para>&man.ipfw.4; rules now support C++-style comments.
328        Each comment is stored together with its rule and appears using
329        the &man.ipfw.8; <literal>show</literal> command.
330        &merged;</para>
331
332      <para>&man.ipfw.8; can now modify &man.ipfw.4; rules in set 31,
333        which was read-only and used for the default rules.
334        They can be deleted by <command>ipfw delete set 31</command>
335        command but are not deleted
336        by the <command>ipfw flush</command> command.
337        This implements a flexible form of <quote>persistent
338          rules</quote>.  More details can be found in &man.ipfw.8;.
339        &merged;</para>
340
341      <para>The &man.ng.atmpif.4; NetGraph node type has been added.
342	It emulates a HARP physical interface, and allows one
343	to run the HARP ATM stack without real hardware.</para>
344
345      <para>Kernel support has been added for Protocol Independent
346	Multicast routing. &merged;</para>
347
348      <para>To reduce information leakage, IPv4 packets no longer have
349	a <varname>ip_id</varname> field set unless fragmentation is
350	being done.</para>
351
352    </sect3>
353
354    <sect3 id="disks">
355      <title>Disks and Storage</title>
356
357      <para>The &man.amr.4; driver now has system crashdump support.</para>
358
359      <para>A major rework of the &man.ata.4; driver has been
360	committed.  One of the more notable changes is that the
361	&man.ata.4; driver has now out from under the Giant kernel
362	lock.  Note that ATA software RAID systems must now include
363	<literal>device ataraid</literal> in their kernel
364	configuration files, as it is no longer automatically implied
365	by <literal>device atadisk</literal>.</para>
366
367      <para>&man.ccd.4; can now operate on raw disks and other
368	&man.geom.4; providers.</para>
369
370      <para>The &man.da.4; driver no longer tries to send 6-byte
371	commands to USB and Firewire devices.  The quirks for these
372	devices (which hopefully are now unnecessary) have been
373	disabled; to restore the old behavior, add <literal>options
374	DA_OLD_QUIRKS</literal> to the kernel configuration. &merged;</para>
375
376      <para>Various &man.geom.4; modules can now be loaded as kernel
377	modules, namely:
378	<filename>geom_apple</filename>,
379	<filename>geom_bde</filename>,
380	<filename>geom_bsd</filename>,
381	<filename>geom_gpt</filename>,
382	<filename>geom_mbr</filename>,
383	<filename>geom_pc98</filename>,
384	<filename>geom_sunlabel</filename>,
385	<filename>geom_vol_ffs</filename>.
386	</para>
387
388      <para>A <literal>GEOM_FOX</literal> module has been added to
389	detect and select between multiple redundant paths to the same
390	device.</para>
391
392      <para arch="i386">The &man.matcd.4; driver, which supports the
393        Matsushita CR-562 and CR-563 CD drives, has returned.</para>
394
395      <para>The &man.twe.4; driver now supports the 3ware generic
396	API. &merged;</para>
397    </sect3>
398
399    <sect3 id="fs">
400      <title>File Systems</title>
401
402      <para>Multi-byte character conversion with the cd9660, msdosfs,
403	and ntfs filesystems is now supported by including the
404	<literal>CD9660_ICONV</literal>,
405	<literal>MSDOSFS_ICONV</literal>, and
406	<literal>NTFS_ICONV</literal> kernel options,
407	respectively.</para>
408
409      <para>Some off-by-one errors in the smbfs that prevented it from
410	working correctly with 15-character NetBIOS names have been fixed.</para>
411
412    </sect3>
413
414    <sect3 id="mm">
415      <title>Multimedia Support</title>
416
417      <para></para>
418
419    </sect3>
420
421  </sect2>
422
423  <sect2 id="userland">
424    <title>Userland Changes</title>
425
426    <para>&man.acpidb.8;, an ACPI DSDT debugger, has been
427      added.</para>
428
429    <para>&man.arp.8; now supports a <option>-i</option> option
430      to limit the scope of the current operation to the ARP entries
431      on a particular interface.  This option applies to the display
432      operations only.  It should be useful on routers with numerous
433      network interfaces. &merged;</para>
434
435    <para>The &man.atmconfig.8; program has been added for
436      configuration of the ATM drivers and IP-over-ATM
437      functionality.</para>
438
439    <para>&man.chroot.8; now allows the optional setting of a user,
440      primary group, or group list to use inside the chroot
441      environment via the <option>-u</option>, <option>-g</option>,
442      and <option>-G</option> options respectively. &merged;</para>
443
444    <para>The dev_db utility is unnecessary due to the mandatory
445      presence of devfs, and has been removed.</para>
446
447    <para>&man.dhclient.8; now polls the state of network interfaces
448      and only sends DHCP requests on interfaces that are up.  The
449      polling interval can be controlled with the <option>-i</option>
450      option.</para>
451
452    <para>The &man.ffsinfo.8; utility has been updated to understand
453      UFS2 filesystems and has been re-enabled.</para>
454
455    <para>The &man.iasl.8; utility, a compiler/decompiler for ACPI
456      Source Language (ASL) and ACPI Machine language (AML), has been
457      added.</para>
458
459    <para>&man.ipfw.8; <literal>list</literal> and <literal>show</literal>
460      command now support ranges of rule numbers.
461      &merged;</para>
462
463    <para>&man.ipfw.8; now supports a <option>-n</option> flag
464      to test the syntax of commands without actually changing anything.
465      &merged;</para>
466
467    <para>The <filename>libalias</filename> library,
468      &man.natd.8;, and &man.ppp.8; now support Cisco Skinny Station protocol,
469      which is the protocol used by Cisco IP phones to talk to Cisco Call
470      Managers.  Note that currently having the Call Manager behind
471      the NAT gateway is not supported.</para>
472
473    <para>The <filename>libcipher</filename> DES cryptography library
474      has been removed.  All of its functionality is provided by the
475      <filename>libcrypto</filename> library, and all base systems
476      programs that used <filename>libcipher</filename> have been
477      converted to use <filename>libcrypto</filename> instead.</para>
478
479    <para>The <filename>libkiconv</filename> library has been added to
480      support working with loadable character set conversion tables in
481      the kernel.</para>
482
483    <para arch="i386,ia64">The <filename>libthr</filename> 1:1
484      threading library is now built by default.</para>
485
486    <para>The &man.locale.1; utility has been re-implemented and is
487      now POSIX-compliant.  A new <option>-m</option> option shows all
488      available codesets.</para>
489
490    <para>The &man.mount.8; utility now supports to display the filesystem
491      ID for each file system in addition to the normal information
492      when a <option>-v</option> flag is specified,
493      and &man.umount.8; utility now accepts the filesystem ID
494      as well as the usual device and path names.
495      This allows to unambiguously specify which file system is
496      to be unmounted even when two or more file systems share
497      the same device and mount point names.</para>
498
499    <para>The &man.mount.cd9660.8; and &man.mount.ntfs.8; utilities
500      now support a <option>-C</option> option to specify local
501      character sets to convert Unicode filenames. It is possible to
502      specify multi-byte character sets using this option.</para>
503
504    <para>The &man.mount.msdosfs.8; utility now supports a
505      <option>-M</option> option to specify the maximum file
506      permissions for directories in the file system. &merged;</para>
507
508    <para>The &man.mount.msdosfs.8; utility now supports a
509      <option>-D</option> option to specify MS-DOS codepages and a
510      <option>-L</option> option to specify local character sets.  They are
511      used to convert character sets of filenames.  The
512      <filename>/usr/libdata/msdosfs</filename> tables have
513      retired.</para>
514
515    <para>The &man.mount.nwfs.8;, &man.mount.portalfs.8;, and
516      &man.mount.smbfs.8; utilities have been moved from
517      <filename>/sbin</filename> to <filename>/usr/sbin</filename>.</para>
518
519    <para>The &man.rc.conf.5; variable <varname>ntpd_flags</varname> for
520      &man.ntpd.8; now includes <option>-f /var/db/ntpd.drift</option>
521      by default.</para>
522
523    <para>The &man.pam.guest.8; PAM module has been added to allow
524      guest logins.  It replaces the pam_ftp(8) module.</para>
525
526    <para>&man.ps.1; and &man.top.1; now support a <option>-H</option> flag to display all
527      kernel-visible threads in each process.</para>
528
529    <para>A bug that &man.rarpd.8; does not recognize removable Ethernet NICs
530      has been fixed.</para>
531
532    <para>&man.rtld.1; now includes <quote>libmap</quote>
533      functionality by default; the <varname>WITH_LIBMAP</varname>
534      compile knob is unnecessary and has been retired.  More
535      information can be found in &man.libmap.conf.5;.</para>
536
537    <para>The symorder utility has been removed.  It is unnecessary
538      now that all kernels use ELF format and there is no a.out format
539      toolchain.</para>
540
541    <para>&man.sysinstall.8; now gives the ability to select an
542      alternate MTA during installation.  Currently,
543      <application>exim</application> and
544      <application>Postfix</application> are supported.</para>
545
546    <para>&man.systat.1; now includes displays for IPv6 and ICMPv6
547      traffic. &merged;</para>
548
549    <para>A number of utilities available in <filename>/bin</filename>
550      and <filename>/sbin</filename> are now available as a
551      statically-linked <quote>crunched</quote> binary that lives in
552      <filename>/rescue</filename>.  This functionality is similar to
553      the <filename>/stand</filename> directory installed by
554      &man.sysinstall.8;, but <filename>/rescue</filename> includes
555      more functionality and is updated as part of
556      <literal>buildworld</literal>/<literal>installworld</literal> operations.  More details can be found in
557      &man.rescue.8;.
558      </para>
559
560    <para>It is now possible to build <filename>/bin</filename> and
561      <filename>/sbin</filename> directories containing
562      dynamically-linked executables.  This feature brings support for
563      loadable PAM and NSS modules to base system utilities located in
564      those directories.  It also reduces the storage requirements for
565      the root filesystem due to the use of shared libraries.  This
566      feature can be enabled in a <literal>buildworld</literal> by
567      defining the Makefile variable
568      <varname>WITH_DYNAMICROOT</varname>.</para>
569
570  </sect2>
571
572  <sect2 id="contrib">
573    <title>Contributed Software</title>
574
575    <para>The <application>ACPI-CA</application> code has been updated
576      from the 20030228 snapshot to the 20030619 snapshot.</para>
577
578    <para><application>amd</application> has been updated from 6.0.7
579      to 6.0.9.</para>
580
581    <para><application>awk</application> from Bell Labs has been
582      updated from a 14 March 2003 snapshot to a 29 July 2003 snapshot.</para>
583
584    <para><application>BIND</application> has been updated from 8.3.4
585      to 8.3.6.</para>
586
587    <para><application>GCC</application> has been updated from 3.2.2 to
588      3.3.1-release.
589
590      <note>
591        <para>Previous versions of <application>GCC</application>
592	  generated incorrect code when
593	  <literal>-march=pentium4</literal> optimization was
594	  enabled.  This problem is believed to have been fixed with
595	  this upgrade, and the earlier workaround for the case of
596	  <literal>CPUTYPE=p4</literal> has been removed.</para>
597      </note>
598      </para>
599
600    <para>The <application>GCC</application> <option>-pthread</option>
601      option, which formerly controlled linking of the threading
602      library, has been removed.  This flag is confusing in the
603      presence of multiple threading libraries (specifically
604      <filename>libc_r</filename>, <filename>libkse</filename>, and
605      <filename>libthr</filename>).  Ports should use the
606      <varname>PTHREAD_LIBS</varname> variable to select the correct
607      threading library.</para>
608
609    <para><application>GNU Readline</application> has been updated
610      from 4.2 to 4.3.</para>
611
612    <para><application>GNU Sort</application> has been updated from
613      the version in textutils 2.0.21 to the version in textutils
614      2.1.</para>
615
616    <para><application>Heimdal Kerberos</application> has been
617      updated from 0.5.1 to 0.6.</para>
618
619    <para>The <application>ISC DHCP</application> client has been
620      updated from 3.0.1rc11 to 3.0.1rc12.</para>
621
622    <para><application>lukemftp</application> has been updated from
623      1.6beta2 to a 30 June 2003 snapshot from NetBSD.</para>
624
625    <para><application>OpenPAM</application> has been updated from the
626      <quote>Dianthus</quote> release to the
627      <quote>Dogwood</quote> release.</para>
628
629    <para><application>OpenSSL</application> has been updated from
630      0.9.7a to 0.9.7c. &merged;</para>
631
632    <para><application>sendmail</application> has been updated to
633      version 8.12.10.</para>
634
635    <para><application>texinfo</application> has been updated from 4.5
636      to 4.6. &merged;</para>
637
638  </sect2>
639
640  <sect2 id="ports">
641    <title>Ports/Packages Collection Infrastructure</title>
642
643    <para>If <makevar>GNU_CONFIGURE</makevar> is defined,
644      all instances of <filename>config.guess</filename> and
645      <filename>config.sub</filename> found
646      under <filename><makevar>WRKDIR</makevar></filename>
647      are replaced with the master versions from
648      <filename><makevar>PORTSDIR</makevar>/Template</filename>.
649      This allows old ports (which contain old versions
650      of these scripts) to build on newer architectures like ia64 and amd64.</para>
651
652  </sect2>
653
654  <sect2 id="releng">
655    <title>Release Engineering and Integration</title>
656
657    <para arch="alpha,amd64,ia64">Floppy disk installation images are
658      no longer built for the alpha, amd64, and ia64
659      architectures.</para>
660
661    <para>The supported release of <application>GNOME</application> has
662      been updated from 2.2.1 to 2.4. &merged;</para>
663
664    <para>The supported release of <application>KDE</application> has
665      been updated from 3.1.2 to 3.1.4. &merged;</para>
666
667  </sect2>
668
669  <sect2 id="doc">
670    <title>Documentation</title>
671
672    <para></para>
673
674  </sect2>
675
676</sect1>
677
678<sect1 id="upgrade">
679  <title>Upgrading from previous releases of &os;</title>
680
681  <para>Users with existing &os; systems are
682    <emphasis>highly</emphasis> encouraged to read the <quote>Early
683    Adopter's Guide to &os; &release.current;</quote>.  This document generally has
684    the filename <filename>EARLY.TXT</filename> on the distribution
685    media, or any other place that the release notes can be found.  It
686    offers some notes on upgrading, but more importantly, also
687    discusses some of the relative merits of upgrading to &os;
688    5.<replaceable>X</replaceable> versus running &os;
689    4.<replaceable>X</replaceable>.</para>
690
691  <important>
692    <para>Upgrading &os; should, of course, only be attempted after
693      backing up <emphasis>all</emphasis> data and configuration
694      files.</para>
695  </important>
696</sect1>
697