Add release documentation and glue pages for 5.1-RELEASE...not

connected to Web site build yet.
This commit is contained in:
Bruce A. Mah 2003-06-03 17:19:25 +00:00
parent 624152df7a
commit 1a8b9aba7c
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/www/; revision=17165
21 changed files with 32919 additions and 0 deletions

View file

@ -0,0 +1,611 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org" />
<title>Early Adopter's Guide to FreeBSD 5.1-RELEASE</title>
<meta name="GENERATOR"
content="Modular DocBook HTML Stylesheet Version 1.73 " />
<link rel="STYLESHEET" type="text/css" href="docbook.css" />
</head>
<body class="ARTICLE" bgcolor="#FFFFFF" text="#000000"
link="#0000FF" vlink="#840084" alink="#0000FF">
<div class="ARTICLE">
<div class="TITLEPAGE">
<h1 class="TITLE"><a id="AEN2" name="AEN2">Early Adopter's
Guide to FreeBSD 5.1-RELEASE</a></h1>
<div class="AUTHORGROUP">
<a id="AEN4" name="AEN4"></a>
<h3 class="CORPAUTHOR">The FreeBSD Release Engineering
Team</h3>
</div>
<p class="COPYRIGHT">Copyright &copy; 2002, 2003 by The
FreeBSD Release Engineering Team</p>
<p class="PUBDATE">$FreeBSD:
src/release/doc/en_US.ISO8859-1/early-adopter/article.sgml,v
1.15 2003/05/03 22:14:55 bmah Exp $<br />
</p>
<div>
<div class="ABSTRACT">
<a id="AEN11" name="AEN11"></a>
<p>This article describes the status of FreeBSD
5.1-RELEASE, from the standpoint of users who may be
new to the 5.<tt class="REPLACEABLE"><i>X</i></tt>
series of releases or to FreeBSD in general. It
presents some background information on release
engineering, some highlights of new features, and some
possible drawbacks that might be faced by early
adopters. It also contains some of the future release
engineering plans for the 4-STABLE development branch
and some tips on upgrading existing systems.</p>
</div>
</div>
<hr />
</div>
<div class="SECT1">
<hr />
<h1 class="SECT1"><a id="INTRO" name="INTRO">1
Introduction</a></h1>
<p>FreeBSD 5.<tt class="REPLACEABLE"><i>X</i></tt> marks
the first new major version of FreeBSD in over two years.
Besides a number of new features, it also contains a number
of major developments in the underlying system
architecture. Along with these advances, however, comes a
system that incorporates a tremendous amount of new and
not-widely-tested code. Compared to the existing line of
4.<tt class="REPLACEABLE"><i>X</i></tt> releases, the first
few 5.<tt class="REPLACEABLE"><i>X</i></tt> releases may
have regressions in areas of stability, performance, and
occasionally functionality.</p>
<p>For these reasons, the Release Engineering Team <tt
class="EMAIL">&#60;<a
href="mailto:re@FreeBSD.org">re@FreeBSD.org</a>&#62;</tt>
specifically discourages users from updating from older
FreeBSD releases to 5.1-RELEASE unless they are aware of
(and prepared to deal with) possible regressions in the
newer releases. Specifically, for more conservative users,
we recommend running 4.<tt
class="REPLACEABLE"><i>X</i></tt> releases (such as
4.8-RELEASE) for the near-term future. We feel that such
users are probably best served by upgrading to 5.<tt
class="REPLACEABLE"><i>X</i></tt> only after a 5-STABLE
development branch has been created; this may be around the
time of 5.2-RELEASE.</p>
<p>(FreeBSD 5.<tt class="REPLACEABLE"><i>X</i></tt> suffers
from what has been described as a ``chicken and egg''
problem. The entire project has a goal of producing
releases that are as stable and reliable as possible. This
stability and reliability requires widespread testing,
particularly of the system's newer features. However,
getting a large number of users to test the system, in a
practical sense, means building and distributing a release
first!)</p>
<p>This article describes some of the issues involved in
installing and running FreeBSD 5.1-RELEASE. We begin with a
brief overview of the FreeBSD release process. We then
present some of the more noteworthy new features in FreeBSD
5.1-RELEASE, along with some areas that may prove
troublesome for unwary users. For those users choosing to
remain with 4-STABLE-based releases, we give some of the
short- to medium-term plans for this development branch.
Finally, we present some notes on upgrading existing 4.<tt
class="REPLACEABLE"><i>X</i></tt> systems to
5.1-RELEASE.</p>
</div>
<div class="SECT1">
<hr />
<h1 class="SECT1"><a id="RELEASE-OVERVIEW"
name="RELEASE-OVERVIEW">2 An Overview of the FreeBSD
Release Process</a></h1>
<p>FreeBSD employs a model of development that relies on
multiple development branches within the source code
repository. The main branch is called ``CURRENT'', and is
referred to in the CVS repository with the <tt
class="LITERAL">HEAD</tt> tag. New features are committed
first to this branch; although this means that CURRENT is
the first to see new functionality, it also means that it
occasionally suffers from breakages as new features are
added and debugged.</p>
<p>Most FreeBSD releases are made from one of several
``STABLE'' branches. Features are only added to these
branches after some amount of testing in CURRENT. At the
moment, only one STABLE branch is under active development;
this branch is referred to as ``4-STABLE'', and all of the
FreeBSD 4.<tt class="REPLACEABLE"><i>X</i></tt> releases
were based on it. This branch has the tag <tt
class="LITERAL">RELENG_4</tt> in the CVS repository.</p>
<p>FreeBSD 5.0 and 5.1 are based on the CURRENT branch.
These are the first releases from this branch in over two
years (the last was FreeBSD 4.0, in March 2000).</p>
<p>At some point after the release of FreeBSD 5.0, a
``5-STABLE'' branch will be created in the FreeBSD CVS
repository with the branch tag <tt
class="LITERAL">RELENG_5</tt>. The past two stable branches
(3-STABLE and 4-STABLE) were created immediately after
their respective ``dot-oh'' releases (3.0 and 4.0,
respectively). In hindsight, this practice did not give
sufficient time for either CURRENT to stabilize before the
new branches were created. This in turn resulted in wasted
effort porting bug fixes between branches, as well as some
architectural changes that could not be ported between
branches at all.</p>
<p>Therefore, the release engineering team will only create
the 5-STABLE branch in the CVS repository after we have
found a relatively stable state to use as its basis. It is
likely that there will be multiple releases in the 5.<tt
class="REPLACEABLE"><i>X</i></tt> series before this
happens; we estimate that the 5-STABLE branch will be
created sometime after 5.2-RELEASE.</p>
<p>More information on FreeBSD release engineering
processes can be found on the <a
href="http://www.FreeBSD.org/releng/index.html"
target="_top">Release Engineering Web pages</a> and in the
<a
href="http://www.FreeBSD.org/doc/en_US.ISO8859-1/articles/releng/index.html"
target="_top">``FreeBSD Release Engineering''</a> article.
Specific issues for the upcoming 5-STABLE development
branch can be found in <a
href="http://www.FreeBSD.org/doc/en_US.ISO8859-1/articles/5-roadmap/index.html"
target="_top">``The Roadmap for 5-STABLE''</a>.</p>
</div>
<div class="SECT1">
<hr />
<h1 class="SECT1"><a id="NEW" name="NEW">3 New
Features</a></h1>
<p>A large attraction of FreeBSD 5.<tt
class="REPLACEABLE"><i>X</i></tt> is a number of new
features. These new features and functionality generally
involve large architectural changes that were not feasible
to port back to the FreeBSD 4-STABLE development branch.
(By contrast, many self-contained enhancements, such as new
device drivers or userland utilities, have already been
ported.) A brief, but not exhaustive list includes:</p>
<ul>
<li>
<p>SMPng: The ``next generation'' support for SMP
machines (work in progress). There is now partial
support for multiple processors to be running in the
kernel at the same time. This work is ongoing.</p>
</li>
<li>
<p>KSE: Kernel Scheduled Entities allow a single
process to have multiple kernel-level threads, similar
to Scheduler Activations. The (experimental) <tt
class="FILENAME">libkse</tt> and <tt
class="FILENAME">libthr</tt> libraries make this
feature available to multi-threaded userland
programs.</p>
</li>
<li>
<p>New architectures: Support for the sparc64 and ia64
architectures, in addition to the i386, pc98, and
alpha.</p>
</li>
<li>
<p>GCC: The compiler toolchain is now based on GCC
3.2.2, rather than GCC 2.95.<tt
class="REPLACEABLE"><i>X</i></tt>.</p>
</li>
<li>
<p>MAC: Support for extensible, loadable Mandatory
Access Control policies.</p>
</li>
<li>
<p>GEOM: A flexible framework for transformations of
disk I/O requests. An experimental disk encryption
facility has been developed based on GEOM.</p>
</li>
<li>
<p>FFS: The FFS filesystem now supports background <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=fsck&amp;sektion=8&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">fsck</span>(8)</span></a>
operations (for faster crash recovery) and filesystem
snapshots.</p>
</li>
<li>
<p>UFS2: A new UFS2 on-disk format has been added,
which supports extended per-file attributes and larger
file sizes. UFS2 is now the default format for <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=newfs&amp;sektion=8&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">newfs</span>(8)</span></a>. On
all platforms except for pc98, filesystems created from
within <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=sysinstall&amp;sektion=8&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">sysinstall</span>(8)</span></a>
will use UFS2 by default.</p>
</li>
<li>
<p>Cardbus: Support for Cardbus devices.</p>
</li>
</ul>
<p>A more comprehensive list of new features can be found
in the release notes for FreeBSD 5.0-RELEASE and FreeBSD
5.1-RELEASE.</p>
</div>
<div class="SECT1">
<hr />
<h1 class="SECT1"><a id="DRAWBACKS" name="DRAWBACKS">4
Drawbacks to Early Adoption</a></h1>
<p>Along with the new features of FreeBSD 5.<tt
class="REPLACEABLE"><i>X</i></tt> come some areas that can
cause problems, or at least can lead to unexpected
behavior. Generally, these come from the fact that a number
of features are works-in-progress. A partial list of these
areas of difficulty includes:</p>
<ul>
<li>
<p>A number of features are not yet finished. Examples
from the feature list above include SMPng and KSE.
While suitable for testing and experimentation, these
features may not be ready for production use.</p>
</li>
<li>
<p>Because of changes in kernel data structures and
ABIs/APIs, third-party binary device drivers will
require modifications to work correctly under FreeBSD
5.0. There is a possibility of more minor ABI/API
changes before the 5-STABLE branch is created.</p>
</li>
<li>
<p>Several parts of FreeBSD's base system functionality
have been moved to the Ports Collection. Notable
examples include <b class="APPLICATION">Perl</b>, <b
class="APPLICATION">UUCP</b>, and most (but not all)
games. While these programs are still supported, their
removal from the base system may cause some
confusion.</p>
</li>
<li>
<p>Some parts of the FreeBSD base system have fallen
into a state of disrepair due to a lack of users and
maintainers. These have been removed. Specific examples
include the generation of a.out-style executables, XNS
networking support, and the X-10 controller driver.</p>
</li>
<li>
<p>A number of ports and packages do not build or do
not run correctly under FreeBSD 5.0, whereas they did
under FreeBSD 4-STABLE. Generally these problems are
caused by compiler toolchain changes or cleanups of
header files.</p>
</li>
<li>
<p>Many FreeBSD 5.<tt class="REPLACEABLE"><i>X</i></tt>
features are seeing wide exposure for the first time.
Many of these features (such as SMPng) have broad
impacts on the kernel.</p>
</li>
<li>
<p>A certain amount of debugging and diagnostic code is
still in place to help track down problems in FreeBSD
5.0's new features. This may cause FreeBSD 5.0 to
perform more slowly than 4-STABLE.</p>
</li>
<li>
<p>Features are only added to the 4-STABLE development
branch after a ``settling time'' in -CURRENT. FreeBSD
5.0 does not have the stabilizing influence of a
-STABLE branch. (It is likely that the 5-STABLE
development branch will be created sometime after
5.2-RELEASE.)</p>
</li>
<li>
<p>Documentation (such as the FreeBSD <a
href="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/index.html"
target="_top">Handbook</a> and <a
href="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/faq/index.html"
target="_top">FAQ</a>) may not reflect changes
recently made to FreeBSD 5.<tt
class="REPLACEABLE"><i>X</i></tt>.</p>
</li>
</ul>
<p>Because a number of these drawbacks affect system
stability, the release engineering team recommends that
more conservative sites and users stick to releases based
on the 4-STABLE branch until the 5.<tt
class="REPLACEABLE"><i>X</i></tt> series is more
polished.</p>
</div>
<div class="SECT1">
<hr />
<h1 class="SECT1"><a id="PLANS-STABLE"
name="PLANS-STABLE">5 Plans for the 4-STABLE
Branch</a></h1>
<p>The release of FreeBSD 5.0 does not mean the end of the
4-STABLE branch. Indeed, FreeBSD 4.8 was released two
months after 5.0, in April 2003. There will most likely be
at least one more release on this branch, namely
4.9-RELEASE, currently scheduled for summer 2003. A
4.10-RELEASE is a likely possibility as well. Future
releases from this branch will depend on several factors.
The most important of these is the existence and stability
of the 5-STABLE branch. If CURRENT is not sufficiently
stable to allow the creation of a 5-STABLE branch, this may
require and permit more releases from the 4-STABLE branch.
Until the last declared release on the 4-STABLE branch, new
features may be merged from <tt class="LITERAL">HEAD</tt>
at the discretion of developers, subject to existing
release engineering policies.</p>
<p>To some extent, the release engineering team (as well as
the developer community as a whole) will take into account
user demand for future 4-STABLE releases. This demand,
however, will need to be balanced with release engineering
resources (particularly developers' time, computing
resources, and mirror archive space).</p>
<p>The Security Officer Team <tt class="EMAIL">&#60;<a
href="mailto:security-officer@FreeBSD.org">security-officer@FreeBSD.org</a>&#62;</tt>
will continue to support releases made from the 4-STABLE
branch in accordance with their published policies, which
can be found on the <a
href="http://www.FreeBSD.org/security/index.html"
target="_top">Security page</a> on the FreeBSD web site.
Generally, the two most recent releases from any branch
will be supported with respect to security advisories and
security fixes. At its discretion, the team may support
other releases for specific issues.</p>
</div>
<div class="SECT1">
<hr />
<h1 class="SECT1"><a id="UPGRADE" name="UPGRADE">6 Notes on
Upgrading from FreeBSD 4.<tt
class="REPLACEABLE"><i>X</i></tt></a></h1>
<p>For those users with existing FreeBSD systems, this
section offers a few notes on upgrading a FreeBSD 4.<tt
class="REPLACEABLE"><i>X</i></tt> system to 5.<tt
class="REPLACEABLE"><i>X</i></tt>. As with any FreeBSD
upgrade, it is crucial to read the release notes and the
errata for the version in question, as well as <tt
class="FILENAME">src/UPDATING</tt> in the case of source
upgrades.</p>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN136" name="AEN136">6.1 Binary
Upgrades</a></h2>
<p>Probably the most straightforward approach is that of
``backup everything, reformat, reinstall, and restore
everything''. This eliminates problems of incompatible or
obsolete executables or configuration files polluting the
new system. It allows new filesystems to be created to
take advantage of new functionality (most notably, the
UFS2 defaults).</p>
<p>As of this time, the binary upgrade option in <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=sysinstall&amp;sektion=8&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">sysinstall</span>(8)</span></a> has
not been well-tested for cross-major-version upgrades.
Using this feature is not recommended. In particular, a
binary upgrade will leave behind a number of files that
are present in FreeBSD 4.<tt
class="REPLACEABLE"><i>X</i></tt> but not in 5.<tt
class="REPLACEABLE"><i>X</i></tt>. These obsolete files
may create some problems.</p>
<p>On the i386 and pc98 platforms, a UserConfig utility
exists on 4-STABLE to allow boot-time configuration of
ISA devices when booting from installation media. Under
FreeBSD 5.0, this functionality has been replaced in part
by the <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=device.hints&amp;sektion=5&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">device.hints</span>(5)</span></a>
mechanism (it allows specifying the same parameters, but
with a very different interface).</p>
<p>Floppy-based binary installations may require
downloading a third, new floppy image holding additional
device drivers in kernel modules. This <tt
class="FILENAME">drivers.flp</tt> floppy image will
generally be found in the same location as the usual <tt
class="FILENAME">kern.flp</tt> and <tt
class="FILENAME">mfsroot.flp</tt> floppy images.</p>
<p>CDROM-based installations on the i386 architecture now
use a ``no-emulation'' boot loader. This allows, among
other things, the use of a <tt
class="LITERAL">GENERIC</tt> kernel, rather than the
stripped-down kernel on the floppy images. In theory, any
system capable of booting the Microsoft Windows NT 4
installation CDROMs should be able to cope with the
FreeBSD 5.<tt class="REPLACEABLE"><i>X</i></tt>
CDROMs.</p>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN158" name="AEN158">6.2 Source
Upgrades</a></h2>
<p>Reading <tt class="FILENAME">src/UPDATING</tt> is
absolutely essential. The section entitled ``To upgrade
from 4.x-stable to current'' contains a step-by-step
update procedure. This procedure must be followed
exactly, without making use of the ``shortcuts'' that
some users occasionally employ.</p>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN164" name="AEN164">6.3 Common
Notes</a></h2>
<p><b class="APPLICATION">Perl</b> has been removed from
the base system, and should be installed either from a
pre-built package or from the Ports Collection. Building
Perl as a part of the base system created a number of
difficulties which made updates problematic. The base
system utilities that used Perl have either been
rewritten (if still applicable) or discarded (if
obsolete). <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=sysinstall&amp;sektion=8&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">sysinstall</span>(8)</span></a>
will now install the Perl package as a part of most
distribution sets, so most users will not notice this
change.</p>
<p>It is generally possible to run old 4.<tt
class="REPLACEABLE"><i>X</i></tt> executables under 5.<tt
class="REPLACEABLE"><i>X</i></tt>, but this requires the
<tt class="FILENAME">compat4x</tt> distribution to be
installed. Thus, using old ports <span
class="emphasis"><i class="EMPHASIS">may</i></span> be
possible.</p>
<p>When installing or upgrading over the top of an
existing 4-STABLE-based system, it is extremely important
to clear out old header files in <tt
class="FILENAME">/usr/include</tt>. Renaming or moving
this directory before a binary installation or an <tt
class="LITERAL">installworld</tt> is generally
sufficient. If this step is not taken, confusion may
result (especially with C++ programs) as the compiler may
wind up using a mixture of obsolete and current header
files.</p>
<p><tt class="FILENAME">MAKEDEV</tt> is no longer
available, nor is it required. FreeBSD 5.<tt
class="REPLACEABLE"><i>X</i></tt> uses a device
filesystem, which automatically creates device nodes on
demand. For more information, please see <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=devfs&amp;sektion=5&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">devfs</span>(5)</span></a>.</p>
<p>UFS2 is the default on-disk format for file systems
created using <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=newfs&amp;sektion=8&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">newfs</span>(8)</span></a>. For all
platforms except pc98, it is also the default for file
systems created using the disk labeling screen within <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=sysinstall&amp;sektion=8&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">sysinstall</span>(8)</span></a>.
Because FreeBSD 4.<tt class="REPLACEABLE"><i>X</i></tt>
only understands UFS1 (not UFS2), disk partitions that
need to be accessed by both 5.<tt
class="REPLACEABLE"><i>X</i></tt> and 4.<tt
class="REPLACEABLE"><i>X</i></tt> must be created with
UFS1. This can be specified using the <tt
class="OPTION">-O1</tt> option to <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=newfs&amp;sektion=8&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">newfs</span>(8)</span></a>, or on
the disk labeling screen in <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=sysinstall&amp;sektion=8&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">sysinstall</span>(8)</span></a>.
This situation most often arises with a a single machine
that dual-boots FreeBSD 4.<tt
class="REPLACEABLE"><i>X</i></tt> and FreeBSD 5.<tt
class="REPLACEABLE"><i>X</i></tt>. Note that there is no
way to convert file systems between the two on-disk
formats (other than backing up, re-creating the file
system, and restoring).</p>
</div>
</div>
<div class="SECT1">
<hr />
<h1 class="SECT1"><a id="SUMMARY" name="SUMMARY">7
Summary</a></h1>
<p>While FreeBSD 5.1-RELEASE contains a number of new and
exciting features, it may not be suitable for all users at
this time. In this document, we presented some background
on release engineering, some of the more notable new
features of the 5.<tt class="REPLACEABLE"><i>X</i></tt>
series, and some drawbacks to early adoption. We also
presented some future plans for the 4-STABLE development
branch and some tips on upgrading for early adopters.</p>
</div>
</div>
<hr />
<p align="center"><small>This file, and other release-related
documents, can be downloaded from <a
href="ftp://ftp.FreeBSD.org/">ftp://ftp.FreeBSD.org/</a>.</small></p>
<p align="center"><small>For questions about FreeBSD, read the
<a href="http://www.FreeBSD.org/docs.html">documentation</a>
before contacting &#60;<a
href="mailto:questions@FreeBSD.org">questions@FreeBSD.org</a>&#62;.</small></p>
<p align="center"><small><small>All users of FreeBSD 5-CURRENT
should subscribe to the &#60;<a
href="mailto:current@FreeBSD.org">current@FreeBSD.org</a>&#62;
mailing list.</small></small></p>
<p align="center">For questions about this documentation,
e-mail &#60;<a
href="mailto:doc@FreeBSD.org">doc@FreeBSD.org</a>&#62;.</p>
<br />
<br />
</body>
</html>

View file

@ -0,0 +1,126 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org" />
<title>FreeBSD 5.1-RELEASE Errata</title>
<meta name="GENERATOR"
content="Modular DocBook HTML Stylesheet Version 1.73 " />
<link rel="STYLESHEET" type="text/css" href="docbook.css" />
</head>
<body class="ARTICLE" bgcolor="#FFFFFF" text="#000000"
link="#0000FF" vlink="#840084" alink="#0000FF">
<div class="ARTICLE">
<div class="TITLEPAGE">
<h1 class="TITLE"><a id="AEN2" name="AEN2">FreeBSD
5.1-RELEASE Errata</a></h1>
<h3 class="CORPAUTHOR">The FreeBSD Project</h3>
<p class="COPYRIGHT">Copyright &copy; 2000, 2001, 2002,
2003 by The FreeBSD Documentation Project</p>
<p class="PUBDATE">$FreeBSD:
src/release/doc/en_US.ISO8859-1/errata/article.sgml,v
1.38.2.1 2003/06/01 01:50:16 bmah Exp $<br />
</p>
<hr />
</div>
<blockquote class="ABSTRACT">
<div class="ABSTRACT">
<a id="AEN12" name="AEN12"></a>
<p>This document lists errata items for FreeBSD
5.1-RELEASE, containing significant information
discovered after the release or too late in the release
cycle to be otherwise included in the release
documentation. This information includes security
advisories, as well as news relating to the software or
documentation that could affect its operation or
usability. An up-to-date version of this document should
always be consulted before installing this version of
FreeBSD.</p>
<p>This errata document for FreeBSD 5.1-RELEASE will be
maintained until the release of FreeBSD 5.1-RELEASE.</p>
</div>
</blockquote>
<div class="SECT1">
<hr />
<h1 class="SECT1"><a id="INTRO" name="INTRO">1
Introduction</a></h1>
<p>This errata document contains ``late-breaking news''
about FreeBSD 5.1-RELEASE. Before installing this version,
it is important to consult this document to learn about any
post-release discoveries or problems that may already have
been found and fixed.</p>
<p>Any version of this errata document actually distributed
with the release (for example, on a CDROM distribution)
will be out of date by definition, but other copies are
kept updated on the Internet and should be consulted as the
``current errata'' for this release. These other copies of
the errata are located at <a
href="http://www.FreeBSD.org/releases/"
target="_top">http://www.FreeBSD.org/releases/</a>, plus
any sites which keep up-to-date mirrors of this
location.</p>
<p>Source and binary snapshots of FreeBSD 5-CURRENT also
contain up-to-date copies of this document (as of the time
of the snapshot).</p>
<p>For a list of all FreeBSD CERT security advisories, see
<a href="http://www.FreeBSD.org/security/"
target="_top">http://www.FreeBSD.org/security/</a> or <a
href="ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/"
target="_top">ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/</a>.</p>
</div>
<div class="SECT1">
<hr />
<h1 class="SECT1"><a id="SECURITY" name="SECURITY">2
Security Advisories</a></h1>
<p>No advisories.</p>
</div>
<div class="SECT1">
<hr />
<h1 class="SECT1"><a id="LATE-NEWS" name="LATE-NEWS">3
Late-Breaking News</a></h1>
<p>No news.</p>
</div>
</div>
<hr />
<p align="center"><small>This file, and other release-related
documents, can be downloaded from <a
href="ftp://ftp.FreeBSD.org/">ftp://ftp.FreeBSD.org/</a>.</small></p>
<p align="center"><small>For questions about FreeBSD, read the
<a href="http://www.FreeBSD.org/docs.html">documentation</a>
before contacting &#60;<a
href="mailto:questions@FreeBSD.org">questions@FreeBSD.org</a>&#62;.</small></p>
<p align="center"><small><small>All users of FreeBSD 5-CURRENT
should subscribe to the &#60;<a
href="mailto:current@FreeBSD.org">current@FreeBSD.org</a>&#62;
mailing list.</small></small></p>
<p align="center">For questions about this documentation,
e-mail &#60;<a
href="mailto:doc@FreeBSD.org">doc@FreeBSD.org</a>&#62;.</p>
<br />
<br />
</body>
</html>

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

View file

@ -0,0 +1,835 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org" />
<title>FreeBSD/ia64 5.1-RELEASE Hardware Notes</title>
<meta name="GENERATOR"
content="Modular DocBook HTML Stylesheet Version 1.73 " />
<link rel="STYLESHEET" type="text/css" href="docbook.css" />
</head>
<body class="ARTICLE" bgcolor="#FFFFFF" text="#000000"
link="#0000FF" vlink="#840084" alink="#0000FF">
<div class="ARTICLE">
<div class="TITLEPAGE">
<h1 class="TITLE"><a id="AEN2" name="AEN2">FreeBSD/ia64
5.1-RELEASE Hardware Notes</a></h1>
<h3 class="CORPAUTHOR">The FreeBSD Documentation
Project</h3>
<p class="COPYRIGHT">Copyright &copy; 2000, 2001, 2002,
2003 by The FreeBSD Documentation Project</p>
<hr />
</div>
<div class="TOC">
<dl>
<dt><b>Table of Contents</b></dt>
<dt>1 <a href="#INTRO">Introduction</a></dt>
<dt>2 <a href="#PROC-IA64">Supported Processors and
Motherboards</a></dt>
<dd>
<dl>
<dt>2.1 <a href="#AEN38">Supported Devices
Overview</a></dt>
</dl>
</dd>
<dt>3 <a href="#SUPPORT">Supported Devices</a></dt>
<dd>
<dl>
<dt>3.1 <a href="#AEN92">Disk Controllers</a></dt>
<dt>3.2 <a href="#ETHERNET">Ethernet
Interfaces</a></dt>
<dt>3.3 <a href="#AEN1658">FDDI Interfaces</a></dt>
<dt>3.4 <a href="#AEN1668">ATM Interfaces</a></dt>
<dt>3.5 <a href="#AEN1712">Wireless Network
Interfaces</a></dt>
<dt>3.6 <a href="#AEN1840">Miscellaneous
Networks</a></dt>
<dt>3.7 <a href="#AEN1871">ISDN Interfaces</a></dt>
<dt>3.8 <a href="#AEN1935">Serial Interfaces</a></dt>
<dt>3.9 <a href="#AEN2130">Audio Devices</a></dt>
<dt>3.10 <a href="#AEN2253">Camera and Video Capture
Devices</a></dt>
<dt>3.11 <a href="#USB">USB Devices</a></dt>
<dt>3.12 <a href="#FIREWIRE">IEEE 1394 (Firewire)
Devices</a></dt>
<dt>3.13 <a href="#BLUETOOTH">Bluetooth
Devices</a></dt>
<dt>3.14 <a href="#AEN2633">Cryptographic
Accelerators</a></dt>
<dt>3.15 <a href="#AEN2658">Miscellaneous</a></dt>
</dl>
</dd>
</dl>
</div>
<blockquote class="ABSTRACT">
<div class="ABSTRACT">
<a id="AEN11" name="AEN11"></a>
<p>This is a preliminary document. It is incomplete, and
in need of additional content. Please send additional
information on IA-64 processors, motherboards, and
various devices working on FreeBSD to the <a
href="http://lists.FreeBSD.org/mailman/listinfo/freebsd-ia64"
target="_top">FreeBSD IA64 porting mailing list</a>.</p>
</div>
</blockquote>
<div class="SECT1">
<hr />
<h1 class="SECT1"><a id="INTRO" name="INTRO">1
Introduction</a></h1>
<p>This document contains the hardware compatibility notes
for FreeBSD 5.1-RELEASE on the IA-64 hardware platform
(also referred to as FreeBSD/ia64 5.1-RELEASE). It lists
devices known to work on this platform, as well as some
notes on boot-time kernel customization that may be useful
when attempting to configure support for new devices.</p>
<div class="NOTE">
<blockquote class="NOTE">
<p><b>Note:</b> This document includes information
specific to the IA-64 hardware platform. Versions of
the hardware compatibility notes for other
architectures will differ in some details.</p>
</blockquote>
</div>
<p>More information on FreeBSD/ia64 is contained on the <a
href="http://www.FreeBSD.org/platforms/ia64/index.html"
target="_top">FreeBSD/ia64 Project</a> page.</p>
</div>
<div class="SECT1">
<hr />
<h1 class="SECT1"><a id="PROC-IA64" name="PROC-IA64">2
Supported Processors and Motherboards</a></h1>
<p>Currently supported processors are the <a
href="http://www.intel.com/design/itanium/itanium/index.htm"
target="_top">Itanium</a> and the <a
href="http://www.intel.com/design/itanium2/index.htm"
target="_top">Itanium 2</a>.</p>
<p>Supported chipsets include:</p>
<ul>
<li>
<p>HP zx1 (only on development branch, see the <a
href="http://perforce.freebsd.org/"
target="_top">Perforce repository</a>)</p>
</li>
<li>
<p>HP i2000</p>
</li>
<li>
<p>Intel 460GX</p>
</li>
<li>
<p>Intel E8870</p>
</li>
</ul>
<p>Both Uniprocessor (UP) and Symmetric Multi-processor
(SMP) configurations are under active development. At this
time, SMP-enabled systems are considered less stable. The
current priorities are UP fixes to improve stability.</p>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN38" name="AEN38">2.1
Supported Devices Overview</a></h2>
<p>This section contains additional information about
what devices may or may not be supported by
FreeBSD/ia64.</p>
<p>Except for the PC chipset embedded <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=ata&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">ata</span>(4)</span></a>
controllers, most should work out of the box. Eventually,
all ia64-compatible ATA controllers are expected to be
fully supported. Refer to the following sections for
various disk controllers and their current status.</p>
<p>In general, ``PC standard'' serial ports supported by
the <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=sio&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">sio</span>(4)</span></a> driver are
expected to work on Intel legacy machines, but not PA
legacy machines. The reason is that all devices on HP
machines are memory-mapped and there is <span
class="emphasis"><i class="EMPHASIS">no</i></span> ISA
device support other than the PCI dictated VGA
legacy.</p>
<p>In addition to <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=sio&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">sio</span>(4)</span></a> devices,
the following devices fail on non-Intel legacy machines
(but should work on boxes with an Intel legacy) because
their drivers make ISA-specific assumptions that do not
hold:</p>
<div class="INFORMALTABLE">
<a id="AEN55" name="AEN55"></a>
<table border="0" class="CALSTABLE">
<tbody>
<tr>
<td align="LEFT" valign="TOP"><a
href="http://www.FreeBSD.org/cgi/man.cgi?query=sio&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">sio</span>(4)</span></a></td>
<td align="LEFT" valign="TOP">No support for
memory-mapped I/O</td>
</tr>
<tr>
<td align="LEFT" valign="TOP"><a
href="http://www.FreeBSD.org/cgi/man.cgi?query=syscons&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">syscons</span>(4)</span></a></td>
<td align="LEFT" valign="TOP">Expect BIOS, VGA
probes, etc.</td>
</tr>
<tr>
<td align="LEFT" valign="TOP"><a
href="http://www.FreeBSD.org/cgi/man.cgi?query=pcm&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">pcm</span>(4)</span></a></td>
<td align="LEFT" valign="TOP">Probes MSS ISA
ports <span class="emphasis"><i
class="EMPHASIS">ad nauseum</i></span></td>
</tr>
<tr>
<td align="LEFT" valign="TOP"><a
href="http://www.FreeBSD.org/cgi/man.cgi?query=atkbd&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">atkbd</span>(4)</span></a>,
<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=psm&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">psm</span>(4)</span></a></td>
<td align="LEFT" valign="TOP">Fixed ISA port
locations</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div class="SECT1">
<hr />
<h1 class="SECT1"><a id="SUPPORT" name="SUPPORT">3
Supported Devices</a></h1>
$FreeBSD:
src/release/doc/en_US.ISO8859-1/hardware/common/dev.sgml,v
1.157 2003/05/30 11:24:00 nyan Exp $
<p>This section describes the devices currently known to be
supported by with FreeBSD on the IA-64 platform. Other
configurations may also work, but simply have not been
tested yet. Feedback, updates, and corrections to this list
are encouraged.</p>
<p>Where possible, the drivers applicable to each device or
class of devices is listed. If the driver in question has a
manual page in the FreeBSD base distribution (most should),
it is referenced here.</p>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN92" name="AEN92">3.1 Disk
Controllers</a></h2>
<p>IDE/ATA controllers (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=ata&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">ata</span>(4)</span></a>
driver)</p>
<ul>
<li>
<p>Acard ATP850 UDMA2, ATP860 UDMA4, ATP865 UDMA6</p>
</li>
<li>
<p>AMD 756 ATA66, 766 ATA100, 768 ATA100</p>
</li>
<li>
<p>Cenatek Rocket Drive</p>
</li>
<li>
<p>CMD 646, 648 ATA66, and 649 ATA100</p>
</li>
<li>
<p>Cypress 82C693</p>
</li>
<li>
<p>Cyrix 5530 ATA33</p>
</li>
<li>
<p>HighPoint HPT366 ATA66, HPT370 ATA100, HPT372
ATA133, HPT374 ATA133</p>
</li>
<li>
<p>Intel PIIX, PIIX3, PIIX4</p>
</li>
<li>
<p>Intel ICH ATA66, ICH2 ATA100, ICH3 ATA100, ICH4
ATA100</p>
</li>
<li>
<p>nVidia nForce ATA100, nForce2 ATA133</p>
</li>
<li>
<p>Promise ATA100 OEM chip (pdc20265)</p>
</li>
<li>
<p>Promise ATA133 OEM chip (pdc20269)</p>
</li>
<li>
<p>Promise Fasttrak-33, -66, -100, -100 TX2/TX4, -133
TX2/TX2000</p>
</li>
<li>
<p>Promise SATA150 TX2/TX4 Serial ATA/150</p>
</li>
<li>
<p>Promise Ultra-33, -66, -100, -133
TX2/TX2000/TX4000</p>
</li>
<li>
<p>ServerWorks ROSB4 ATA33</p>
</li>
<li>
<p>ServerWorks CSB5 and CSB6 ATA66/ATA100</p>
</li>
<li>
<p>Sil 0680 UDMA6</p>
</li>
<li>
<p>SiS 530, 540, 550, 620</p>
</li>
<li>
<p>SiS 630, 630S, 633, 635, 640, 645, 645DX, 648,
650, 651, 652, 655, 658, 730, 733, 735, 740, 745,
746, 748, 750, 751, 752, 755</p>
</li>
<li>
<p>SiS 5591 ATA100</p>
</li>
<li>
<p>VIA 82C586 ATA33, 82C596 ATA66, 82C686a ATA66,
82C686b ATA100</p>
</li>
<li>
<p>VIA 8233, 8235 ATA133</p>
</li>
</ul>
<br />
<br />
<p>Qlogic controllers and variants (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=isp&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">isp</span>(4)</span></a>
driver)</p>
<ul>
<li>
<p>Qlogic 1020, 1040 SCSI and Ultra SCSI host
adapters</p>
</li>
<li>
<p>Qlogic 1240 dual Ultra SCSI controllers</p>
</li>
<li>
<p>Qlogic 1080 Ultra2 LVD and 1280 Dual Ultra2 LVD
controllers</p>
</li>
<li>
<p>Qlogic 12160 Ultra3 LVD controllers</p>
</li>
<li>
<p>Qlogic 2100 and Qlogic 2200 Fibre Channel SCSI
controllers</p>
</li>
<li>
<p>Qlogic 2300 and Qlogic 2312 2-Gigabit Fibre
Channel SCSI controllers</p>
</li>
<li>
<p>Performance Technology SBS440 ISP1000 variants</p>
</li>
<li>
<p>Performance Technology SBS450 ISP1040 variants</p>
</li>
<li>
<p>Performance Technology SBS470 ISP2100 variants</p>
</li>
<li>
<p>Antares Microsystems P-0033 ISP2100 variants</p>
</li>
</ul>
<br />
<br />
<p>LSI Logic Fusion/MP architecture Fiber Channel
controllers (mpt driver)</p>
<ul>
<li>
<p>LSI 53c1020, 53c1030</p>
</li>
</ul>
<br />
<br />
<p>With all supported SCSI controllers, full support is
provided for SCSI-I, SCSI-II, and SCSI-III peripherals,
including hard disks, optical disks, tape drives
(including DAT, 8mm Exabyte, Mammoth, and DLT), medium
changers, processor target devices and CD-ROM drives.
WORM devices that support CD-ROM commands are supported
for read-only access by the CD-ROM drivers (such as <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=cd&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">cd</span>(4)</span></a>).
WORM/CD-R/CD-RW writing support is provided by <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=cdrecord&amp;sektion=1&amp;manpath=FreeBSD+Ports">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">cdrecord</span>(1)</span></a>,
which is a part of the <a
href="http://www.FreeBSD.org/cgi/url.cgi?ports/sysutils/cdrtools/pkg-descr">
<tt class="FILENAME">sysutils/cdrtools</tt></a> port in
the Ports Collection.</p>
<p>The following CD-ROM type systems are supported at
this time:</p>
<ul>
<li>
<p>SCSI interface (also includes ProAudio Spectrum
and SoundBlaster SCSI) (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=cd&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">cd</span>(4)</span></a>)</p>
</li>
<li>
<p>ATAPI IDE interface (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=acd&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">acd</span>(4)</span></a>)</p>
</li>
</ul>
<br />
<br />
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="ETHERNET" name="ETHERNET">3.2
Ethernet Interfaces</a></h2>
<p>Intel 82557-, 82258-, 82559-, 82550- or 82562-based
Fast Ethernet NICs (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=fxp&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">fxp</span>(4)</span></a>
driver)</p>
<ul>
<li>
<p>Intel EtherExpress Pro/100B PCI Fast Ethernet</p>
</li>
<li>
<p>Intel InBusiness 10/100 PCI Network Adapter</p>
</li>
<li>
<p>Intel PRO/100+ Management Adapter</p>
</li>
<li>
<p>Intel Pro/100 VE Desktop Adapter</p>
</li>
<li>
<p>Intel Pro/100 M Desktop Adapter</p>
</li>
<li>
<p>Intel Pro/100 S Desktop, Server and Dual-Port
Server Adapters</p>
</li>
<li>
<p>On-board Ethernet NICs on many Intel
motherboards.</p>
</li>
</ul>
<br />
<br />
<p>Gigabit Ethernet NICs based on the Broadcom BCM570x
(<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=bge&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">bge</span>(4)</span></a>
driver)</p>
<ul>
<li>
<p>3Com 3c996-SX, 3c996-T</p>
</li>
<li>
<p>Netgear GA302T</p>
</li>
<li>
<p>SysKonnect SK-9D21 and 9D41</p>
</li>
</ul>
<br />
<br />
<p>Gigabit Ethernet NICs based on the Intel 82542 and
82543 controller chips (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=gx&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">gx</span>(4)</span></a> and <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=em&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">em</span>(4)</span></a> drivers),
plus NICs supported by the Intel 82540EM, 82544, 82545EM,
and 82546EB controller chips (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=em&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">em</span>(4)</span></a> driver
only)</p>
<ul>
<li>
<p>Intel PRO/1000 Gigabit Ethernet</p>
</li>
</ul>
<div class="NOTE">
<blockquote class="NOTE">
<p><b>Note:</b> The <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=em&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">em</span>(4)</span></a> driver
is officially supported by Intel, but is only
supported on the i386.</p>
</blockquote>
</div>
<br />
<br />
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN1658" name="AEN1658">3.3 FDDI
Interfaces</a></h2>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN1668" name="AEN1668">3.4 ATM
Interfaces</a></h2>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN1712" name="AEN1712">3.5
Wireless Network Interfaces</a></h2>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN1840" name="AEN1840">3.6
Miscellaneous Networks</a></h2>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN1871" name="AEN1871">3.7 ISDN
Interfaces</a></h2>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN1935" name="AEN1935">3.8
Serial Interfaces</a></h2>
<p>``PC standard'' 8250, 16450, and 16550-based serial
ports (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=sio&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">sio</span>(4)</span></a>
driver)</p>
<p>PCI-Based multi-port serial boards (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=puc&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">puc</span>(4)</span></a>
driver)</p>
<ul>
<li>
<p>Diva Serial (GSP) Multiport UART (development
branch only)</p>
</li>
</ul>
<br />
<br />
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN2130" name="AEN2130">3.9
Audio Devices</a></h2>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN2253" name="AEN2253">3.10
Camera and Video Capture Devices</a></h2>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="USB" name="USB">3.11 USB
Devices</a></h2>
<p>Host Controllers (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=ohci&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">ohci</span>(4)</span></a> and <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=uhci&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">uhci</span>(4)</span></a>
drivers)</p>
<ul>
<li>
<p>UHCI or OHCI compliant motherboard chipsets (no
exceptions known)</p>
</li>
</ul>
<br />
<br />
<p>USB 2.0 controllers using the EHCI interface (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=ehci&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">ehci</span>(4)</span></a>
driver)</p>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="FIREWIRE" name="FIREWIRE">3.12
IEEE 1394 (Firewire) Devices</a></h2>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="BLUETOOTH" name="BLUETOOTH">3.13
Bluetooth Devices</a></h2>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN2633" name="AEN2633">3.14
Cryptographic Accelerators</a></h2>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN2658" name="AEN2658">3.15
Miscellaneous</a></h2>
<p>VGA-compatible video cards (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=vga&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">vga</span>(4)</span></a>
driver)</p>
<div class="NOTE">
<blockquote class="NOTE">
<p><b>Note:</b> Information regarding specific video
cards and compatibility with <b
class="APPLICATION">XFree86</b> can be found at <a
href="http://www.xfree86.org/"
target="_top">http://www.xfree86.org/</a>.</p>
</blockquote>
</div>
<br />
<br />
<p>Keyboards including:</p>
<ul>
<li>
<p>PS/2 keyboards (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=atkbd&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">atkbd</span>(4)</span></a>
driver)</p>
</li>
</ul>
<br />
<br />
<p>Pointing devices including:</p>
<ul>
<li>
<p>PS/2 mice and compatible devices, including many
laptop pointing devices (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=psm&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">psm</span>(4)</span></a>
driver)</p>
</li>
<li>
<p>Serial mice and compatible devices</p>
</li>
</ul>
<div class="NOTE">
<blockquote class="NOTE">
<p><b>Note:</b> <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=moused&amp;sektion=8&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">moused</span>(8)</span></a> has
more information on using pointing devices with
FreeBSD. Information on using pointing devices with
<b class="APPLICATION">XFree86</b> can be found at <a
href="http://www.xfree86.org/"
target="_top">http://www.xfree86.org/</a>.</p>
</blockquote>
</div>
<br />
<br />
</div>
</div>
</div>
<hr />
<p align="center"><small>This file, and other release-related
documents, can be downloaded from <a
href="ftp://ftp.FreeBSD.org/">ftp://ftp.FreeBSD.org/</a>.</small></p>
<p align="center"><small>For questions about FreeBSD, read the
<a href="http://www.FreeBSD.org/docs.html">documentation</a>
before contacting &#60;<a
href="mailto:questions@FreeBSD.org">questions@FreeBSD.org</a>&#62;.</small></p>
<p align="center"><small><small>All users of FreeBSD 5-CURRENT
should subscribe to the &#60;<a
href="mailto:current@FreeBSD.org">current@FreeBSD.org</a>&#62;
mailing list.</small></small></p>
<p align="center">For questions about this documentation,
e-mail &#60;<a
href="mailto:doc@FreeBSD.org">doc@FreeBSD.org</a>&#62;.</p>
<br />
<br />
</body>
</html>

File diff suppressed because it is too large Load diff

View file

@ -0,0 +1,916 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org" />
<title>FreeBSD/sparc64 5.1-RELEASE Hardware Notes</title>
<meta name="GENERATOR"
content="Modular DocBook HTML Stylesheet Version 1.73 " />
<link rel="STYLESHEET" type="text/css" href="docbook.css" />
</head>
<body class="ARTICLE" bgcolor="#FFFFFF" text="#000000"
link="#0000FF" vlink="#840084" alink="#0000FF">
<div class="ARTICLE">
<div class="TITLEPAGE">
<h1 class="TITLE"><a id="AEN2" name="AEN2">FreeBSD/sparc64
5.1-RELEASE Hardware Notes</a></h1>
<h3 class="CORPAUTHOR">The FreeBSD Documentation
Project</h3>
<p class="COPYRIGHT">Copyright &copy; 2000, 2001, 2002,
2003 by The FreeBSD Documentation Project</p>
<hr />
</div>
<div class="TOC">
<dl>
<dt><b>Table of Contents</b></dt>
<dt>1 <a href="#INTRO">Introduction</a></dt>
<dt>2 <a href="#SUPPORT-SYS">Supported Systems</a></dt>
<dd>
<dl>
<dt>2.1 <a href="#AEN25">Fully Supported
Systems</a></dt>
<dt>2.2 <a href="#AEN75">Partially Supported
Systems</a></dt>
<dt>2.3 <a href="#AEN87">Unsupported Systems</a></dt>
</dl>
</dd>
<dt>3 <a href="#SUPPORT">Supported Devices</a></dt>
<dd>
<dl>
<dt>3.1 <a href="#AEN101">Disk Controllers</a></dt>
<dt>3.2 <a href="#ETHERNET">Ethernet
Interfaces</a></dt>
<dt>3.3 <a href="#AEN1667">FDDI Interfaces</a></dt>
<dt>3.4 <a href="#AEN1677">ATM Interfaces</a></dt>
<dt>3.5 <a href="#AEN1721">Wireless Network
Interfaces</a></dt>
<dt>3.6 <a href="#AEN1849">Miscellaneous
Networks</a></dt>
<dt>3.7 <a href="#AEN1880">ISDN Interfaces</a></dt>
<dt>3.8 <a href="#AEN1944">Serial Interfaces</a></dt>
<dt>3.9 <a href="#AEN2139">Audio Devices</a></dt>
<dt>3.10 <a href="#AEN2262">Camera and Video Capture
Devices</a></dt>
<dt>3.11 <a href="#USB">USB Devices</a></dt>
<dt>3.12 <a href="#FIREWIRE">IEEE 1394 (Firewire)
Devices</a></dt>
<dt>3.13 <a href="#BLUETOOTH">Bluetooth
Devices</a></dt>
<dt>3.14 <a href="#AEN2642">Cryptographic
Accelerators</a></dt>
<dt>3.15 <a href="#AEN2667">Miscellaneous</a></dt>
</dl>
</dd>
</dl>
</div>
<div class="SECT1">
<hr />
<h1 class="SECT1"><a id="INTRO" name="INTRO">1
Introduction</a></h1>
<p>This document contains the hardware compatibility notes
for FreeBSD 5.1-RELEASE on the UltraSPARC hardware platform
(also referred to as FreeBSD/sparc64 5.1-RELEASE). It lists
devices known to work on this platform, as well as some
notes on boot-time kernel customization that may be useful
when attempting to configure support for new devices.</p>
<div class="NOTE">
<blockquote class="NOTE">
<p><b>Note:</b> This document includes information
specific to the UltraSPARC hardware platform. Versions
of the hardware compatibility notes for other
architectures will differ in some details.</p>
</blockquote>
</div>
</div>
<div class="SECT1">
<hr />
<h1 class="SECT1"><a id="SUPPORT-SYS" name="SUPPORT-SYS">2
Supported Systems</a></h1>
<p>This section describes the systems currently known to be
supported by FreeBSD on the UltraSPARC platform. For
background information on the various hardware designs see
the <a href="http://sunsolve.sun.com/handbook_pub/"
target="_top">Sun System Handbook</a>.</p>
<p>SMP is supported on all systems with more than 1
processor.</p>
<p>If you have a system that is not listed here, it may not
have been tested with FreeBSD 5.1-RELEASE. We encourage you
to try it and send a note to the <a
href="http://lists.FreeBSD.org/mailman/listinfo/freebsd-sparc64"
target="_top">FreeBSD SPARC porting mailing list</a> with
your results, including which devices work and which do
not.</p>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN25" name="AEN25">2.1 Fully
Supported Systems</a></h2>
<p>The following systems are fully supported by
FreeBSD.</p>
<ul>
<li>
<p>Blade 100</p>
</li>
<li>
<p>Blade 150</p>
</li>
<li>
<p>Enterprise 220R</p>
</li>
<li>
<p>Enterprise 250</p>
</li>
<li>
<p>Enterprise 420R</p>
</li>
<li>
<p>Enterprise 450</p>
</li>
<li>
<p>Fire V100</p>
</li>
<li>
<p>Fire V120</p>
</li>
<li>
<p>Netra t1 105</p>
</li>
<li>
<p>Netra T1 AC200/DC200</p>
</li>
<li>
<p>Netra t 1100</p>
</li>
<li>
<p>Netra t 1120</p>
</li>
<li>
<p>Netra t 1125</p>
</li>
<li>
<p>Netra t 1400/1405</p>
</li>
<li>
<p>Netra 120</p>
</li>
<li>
<p>Netra X1</p>
</li>
<li>
<p>SPARCEngine Ultra AXi</p>
</li>
<li>
<p>SPARCEngine Ultra AXmp</p>
</li>
<li>
<p>Ultra 5</p>
</li>
<li>
<p>Ultra 10</p>
</li>
<li>
<p>Ultra 30</p>
</li>
<li>
<p>Ultra 60</p>
</li>
<li>
<p>Ultra 80</p>
</li>
</ul>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN75" name="AEN75">2.2
Partially Supported Systems</a></h2>
<p>The following systems are partially supported by
FreeBSD. In particular the onboard scsi controller in
sbus systems is not supported.</p>
<ul>
<li>
<p>Enterprise 3500</p>
</li>
<li>
<p>Enterprise 4500</p>
</li>
<li>
<p>Ultra 1 Enterprise (1E for short)</p>
</li>
<li>
<p>Ultra 2</p>
</li>
</ul>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN87" name="AEN87">2.3
Unsupported Systems</a></h2>
<p>The following systems are not supported by FreeBSD.
This may be due to lack of processor support (UltraSPARC
III), due to a quirk in the system design that makes
FreeBSD unstable, or due to lack of support for
sufficient onboard devices to make FreeBSD generally
useful.</p>
<ul>
<li>
<p>All systems containing UltraSPARC III
processor(s).</p>
</li>
<li>
<p>Ultra 1</p>
</li>
</ul>
</div>
</div>
<div class="SECT1">
<hr />
<h1 class="SECT1"><a id="SUPPORT" name="SUPPORT">3
Supported Devices</a></h1>
$FreeBSD:
src/release/doc/en_US.ISO8859-1/hardware/common/dev.sgml,v
1.157 2003/05/30 11:24:00 nyan Exp $
<p>This section describes the devices currently known to be
supported by with FreeBSD on the UltraSPARC platform. Other
configurations may also work, but simply have not been
tested yet. Feedback, updates, and corrections to this list
are encouraged.</p>
<p>Where possible, the drivers applicable to each device or
class of devices is listed. If the driver in question has a
manual page in the FreeBSD base distribution (most should),
it is referenced here.</p>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN101" name="AEN101">3.1 Disk
Controllers</a></h2>
<p>IDE/ATA controllers (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=ata&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">ata</span>(4)</span></a>
driver)</p>
<ul>
<li>
<p>Acard ATP850 UDMA2, ATP860 UDMA4, ATP865 UDMA6</p>
</li>
<li>
<p>AMD 756 ATA66, 766 ATA100, 768 ATA100</p>
</li>
<li>
<p>Cenatek Rocket Drive</p>
</li>
<li>
<p>CMD 646, 648 ATA66, and 649 ATA100</p>
</li>
<li>
<p>Cypress 82C693</p>
</li>
<li>
<p>Cyrix 5530 ATA33</p>
</li>
<li>
<p>HighPoint HPT366 ATA66, HPT370 ATA100, HPT372
ATA133, HPT374 ATA133</p>
</li>
<li>
<p>Intel PIIX, PIIX3, PIIX4</p>
</li>
<li>
<p>Intel ICH ATA66, ICH2 ATA100, ICH3 ATA100, ICH4
ATA100</p>
</li>
<li>
<p>nVidia nForce ATA100, nForce2 ATA133</p>
</li>
<li>
<p>Promise ATA100 OEM chip (pdc20265)</p>
</li>
<li>
<p>Promise ATA133 OEM chip (pdc20269)</p>
</li>
<li>
<p>Promise Fasttrak-33, -66, -100, -100 TX2/TX4, -133
TX2/TX2000</p>
</li>
<li>
<p>Promise SATA150 TX2/TX4 Serial ATA/150</p>
</li>
<li>
<p>Promise Ultra-33, -66, -100, -133
TX2/TX2000/TX4000</p>
</li>
<li>
<p>ServerWorks ROSB4 ATA33</p>
</li>
<li>
<p>ServerWorks CSB5 and CSB6 ATA66/ATA100</p>
</li>
<li>
<p>Sil 0680 UDMA6</p>
</li>
<li>
<p>SiS 530, 540, 550, 620</p>
</li>
<li>
<p>SiS 630, 630S, 633, 635, 640, 645, 645DX, 648,
650, 651, 652, 655, 658, 730, 733, 735, 740, 745,
746, 748, 750, 751, 752, 755</p>
</li>
<li>
<p>SiS 5591 ATA100</p>
</li>
<li>
<p>VIA 82C586 ATA33, 82C596 ATA66, 82C686a ATA66,
82C686b ATA100</p>
</li>
<li>
<p>VIA 8233, 8235 ATA133</p>
</li>
</ul>
<br />
<br />
<p>Adaptec SCSI Controllers</p>
<ul>
<li>
<p>Adaptec
19160/291x/2920/2930/2940/2950/29160/3940/3950/3960/39160/398x/494x
series PCI SCSI controllers, including
Narrow/Wide/Twin/Ultra/Ultra2 variants (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=ahc&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">ahc</span>(4)</span></a>
driver)</p>
</li>
</ul>
<br />
<br />
<p>Ultra-320 SCSI controllers based on the Adaptec
AIC7901, AIC7901A, and AIC7902 Ultra320 controller chips
(<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=ahd&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">ahd</span>(4)</span></a>
driver)</p>
<ul>
<li>
<p>Adaptec 29320, 29320A, 29320B, 29320LP</p>
</li>
<li>
<p>Adaptec 39320, 39320D</p>
</li>
</ul>
<br />
<br />
<p>LSI/SymBios (formerly NCR) 53C810, 53C810a, 53C815,
53C825, 53C825a, 53C860, 53C875, 53C875a, 53C876, 53C885,
53C895, 53C895a, 53C896, 53C1010-33, 53C1010-66, 53C1000,
53C1000R PCI SCSI controllers, either embedded on
motherboard or on add-on boards (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=ncr&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">ncr</span>(4)</span></a> and <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=sym&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">sym</span>(4)</span></a>
drivers)</p>
<ul>
<li>
<p>ASUS SC-200, SC-896</p>
</li>
<li>
<p>Data Technology DTC3130 (all variants)</p>
</li>
<li>
<p>DawiControl DC2976UW</p>
</li>
<li>
<p>Diamond FirePort (all)</p>
</li>
<li>
<p>NCR cards (all)</p>
</li>
<li>
<p>Symbios cards (all)</p>
</li>
<li>
<p>Tekram DC390W, 390U, 390F, 390U2B, 390U2W, 390U3D,
and 390U3W</p>
</li>
<li>
<p>Tyan S1365</p>
</li>
</ul>
<br />
<br />
<p>Qlogic controllers and variants (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=isp&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">isp</span>(4)</span></a>
driver)</p>
<ul>
<li>
<p>Qlogic 1020, 1040 SCSI and Ultra SCSI host
adapters</p>
</li>
<li>
<p>Qlogic 1240 dual Ultra SCSI controllers</p>
</li>
<li>
<p>Qlogic 1080 Ultra2 LVD and 1280 Dual Ultra2 LVD
controllers</p>
</li>
<li>
<p>Qlogic 12160 Ultra3 LVD controllers</p>
</li>
<li>
<p>Qlogic 2100 and Qlogic 2200 Fibre Channel SCSI
controllers</p>
</li>
<li>
<p>Qlogic 2300 and Qlogic 2312 2-Gigabit Fibre
Channel SCSI controllers</p>
</li>
<li>
<p>Performance Technology SBS440 ISP1000 variants</p>
</li>
<li>
<p>Performance Technology SBS450 ISP1040 variants</p>
</li>
<li>
<p>Performance Technology SBS470 ISP2100 variants</p>
</li>
<li>
<p>Antares Microsystems P-0033 ISP2100 variants</p>
</li>
</ul>
<br />
<br />
<p>LSI Logic Fusion/MP architecture Fiber Channel
controllers (mpt driver)</p>
<ul>
<li>
<p>LSI FC909, FC929</p>
</li>
<li>
<p>LSI 53c1020, 53c1030</p>
</li>
</ul>
<br />
<br />
<p>With all supported SCSI controllers, full support is
provided for SCSI-I, SCSI-II, and SCSI-III peripherals,
including hard disks, optical disks, tape drives
(including DAT, 8mm Exabyte, Mammoth, and DLT), medium
changers, processor target devices and CD-ROM drives.
WORM devices that support CD-ROM commands are supported
for read-only access by the CD-ROM drivers (such as <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=cd&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">cd</span>(4)</span></a>).
WORM/CD-R/CD-RW writing support is provided by <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=cdrecord&amp;sektion=1&amp;manpath=FreeBSD+Ports">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">cdrecord</span>(1)</span></a>,
which is a part of the <a
href="http://www.FreeBSD.org/cgi/url.cgi?ports/sysutils/cdrtools/pkg-descr">
<tt class="FILENAME">sysutils/cdrtools</tt></a> port in
the Ports Collection.</p>
<p>The following CD-ROM type systems are supported at
this time:</p>
<ul>
<li>
<p>SCSI interface (also includes ProAudio Spectrum
and SoundBlaster SCSI) (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=cd&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">cd</span>(4)</span></a>)</p>
</li>
<li>
<p>ATAPI IDE interface (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=acd&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">acd</span>(4)</span></a>)</p>
</li>
</ul>
<br />
<br />
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="ETHERNET" name="ETHERNET">3.2
Ethernet Interfaces</a></h2>
<p>RealTek 8129/8139 Fast Ethernet NICs (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=rl&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">rl</span>(4)</span></a> driver)</p>
<ul>
<li>
<p>Accton ``Cheetah'' EN1207D (MPX 5030/5038; RealTek
8139 clone)</p>
</li>
<li>
<p>Allied Telesyn AT2550</p>
</li>
<li>
<p>Allied Telesyn AT2500TX</p>
</li>
<li>
<p>D-Link DFE-530TX+, DFE-538TX</p>
</li>
<li>
<p>Farallon NetLINE 10/100 PCI</p>
</li>
<li>
<p>Genius GF100TXR (RTL8139)</p>
</li>
<li>
<p>KTX-9130TX 10/100 Fast Ethernet</p>
</li>
<li>
<p>NDC Communications NE100TX-E</p>
</li>
<li>
<p>Netronix Inc. EA-1210 NetEther 10/100</p>
</li>
<li>
<p>OvisLink LEF-8129TX</p>
</li>
<li>
<p>OvisLink LEF-8139TX</p>
</li>
<li>
<p>SMC EZ Card 10/100 PCI 1211-TX</p>
</li>
</ul>
<br />
<br />
<p>Intel 82557-, 82258-, 82559-, 82550- or 82562-based
Fast Ethernet NICs (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=fxp&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">fxp</span>(4)</span></a>
driver)</p>
<ul>
<li>
<p>Intel EtherExpress Pro/100B PCI Fast Ethernet</p>
</li>
<li>
<p>Intel PRO/100+ Management Adapter</p>
</li>
<li>
<p>Intel Pro/100 VE Desktop Adapter</p>
</li>
<li>
<p>Intel Pro/100 M Desktop Adapter</p>
</li>
<li>
<p>Intel Pro/100 S Desktop, Server and Dual-Port
Server Adapters</p>
</li>
</ul>
<br />
<br />
<p>3Com Etherlink XL-based NICs (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=xl&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">xl</span>(4)</span></a> driver)</p>
<ul>
<li>
<p>3C900/905/905B/905C PCI</p>
</li>
</ul>
<br />
<br />
<p>Sun HME and QFE Ethernet NICs (hme driver)</p>
<p>Sun GEM (Gigabit Ethernet) and ERI (Fast Ethernet)
NICs (gem driver)</p>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN1667" name="AEN1667">3.3 FDDI
Interfaces</a></h2>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN1677" name="AEN1677">3.4 ATM
Interfaces</a></h2>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN1721" name="AEN1721">3.5
Wireless Network Interfaces</a></h2>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN1849" name="AEN1849">3.6
Miscellaneous Networks</a></h2>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN1880" name="AEN1880">3.7 ISDN
Interfaces</a></h2>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN1944" name="AEN1944">3.8
Serial Interfaces</a></h2>
<p>Serial ports based on the SAB82532 serial chip,
console only (sab driver)</p>
<p>Serial ports based on the Zilog 8530 dual uart,
console only (zs driver)</p>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN2139" name="AEN2139">3.9
Audio Devices</a></h2>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN2262" name="AEN2262">3.10
Camera and Video Capture Devices</a></h2>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="USB" name="USB">3.11 USB
Devices</a></h2>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="FIREWIRE" name="FIREWIRE">3.12
IEEE 1394 (Firewire) Devices</a></h2>
<p>Host Controllers (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=fwohci&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">fwohci</span>(4)</span></a>
driver)</p>
<ul>
<li>
<p>Ricoh R5C552 chipset</p>
</li>
<li>
<p>Sony CX3022 chipset</p>
</li>
<li>
<p>TI TSB12LV22, LV23, 26 and TSB43AA22 chipsets</p>
</li>
<li>
<p>uPD72861 chipset</p>
</li>
<li>
<p>VIA VT6306 chipset</p>
</li>
</ul>
<br />
<br />
<p>Storage (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=sbp&amp;sektion=4&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">sbp</span>(4)</span></a>
driver)</p>
<ul>
<li>
<p>Apple iPod</p>
</li>
<li>
<p>Apple Macintosh G4 (target mode)</p>
</li>
</ul>
<br />
<br />
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="BLUETOOTH" name="BLUETOOTH">3.13
Bluetooth Devices</a></h2>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN2642" name="AEN2642">3.14
Cryptographic Accelerators</a></h2>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN2667" name="AEN2667">3.15
Miscellaneous</a></h2>
<p>OpenFirmware console (ofwcons driver)</p>
</div>
</div>
</div>
<hr />
<p align="center"><small>This file, and other release-related
documents, can be downloaded from <a
href="ftp://ftp.FreeBSD.org/">ftp://ftp.FreeBSD.org/</a>.</small></p>
<p align="center"><small>For questions about FreeBSD, read the
<a href="http://www.FreeBSD.org/docs.html">documentation</a>
before contacting &#60;<a
href="mailto:questions@FreeBSD.org">questions@FreeBSD.org</a>&#62;.</small></p>
<p align="center"><small><small>All users of FreeBSD 5-CURRENT
should subscribe to the &#60;<a
href="mailto:current@FreeBSD.org">current@FreeBSD.org</a>&#62;
mailing list.</small></small></p>
<p align="center">For questions about this documentation,
e-mail &#60;<a
href="mailto:doc@FreeBSD.org">doc@FreeBSD.org</a>&#62;.</p>
<br />
<br />
</body>
</html>

View file

@ -0,0 +1,30 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" [
<!ENTITY base CDATA "../..">
<!ENTITY date "$FreeBSD$">
<!ENTITY title "FreeBSD 5.1-RELEASE Hardware Notes">
<!ENTITY % includes SYSTEM "../../includes.sgml"> %includes;
]>
<html>
&header;
<p>The hardware notes for FreeBSD are customized for different
platforms, as many devices are only supported on (or are
only relevant for)
specific processors or architectures.</p>
<p>Hardware notes for FreeBSD 5.1-RELEASE are available for the following
platforms:</p>
<ul>
<li><a href="hardware-alpha.html">alpha</a></li>
<li><a href="hardware-ia64.html">ia64</a></li>
<li><a href="hardware-i386.html">i386</a></li>
<li><a href="hardware-pc98.html">pc98</a></li>
<li><a href="hardware-sparc64.html">sparc64</a></li>
</ul>
<p>A list of all platforms currently under development can be found
on the <a href="../../platforms/index.html">Supported
Platforms</a> page.</p>
</html>

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

View file

@ -0,0 +1,29 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" [
<!ENTITY base CDATA "../..">
<!ENTITY date "$FreeBSD$">
<!ENTITY title "FreeBSD 5.1-RELEASE Installation Notes">
<!ENTITY % includes SYSTEM "../../includes.sgml"> %includes;
]>
<html>
&header;
<p>The installation notes for FreeBSD are customized for different
platforms, as the procedures for installing FreeBSD are highly
dependent on the hardware platform.</p>
<p>Installation notes for FreeBSD 5.1-RELEASE are available for the following
platforms:</p>
<ul>
<li><a href="installation-alpha.html">alpha</a></li>
<li><a href="installation-ia64.html">ia64</a></li>
<li><a href="installation-i386.html">i386</a></li>
<li><a href="installation-pc98.html">pc98</a></li>
<li><a href="installation-sparc64.html">sparc64</a></li>
</ul>
<p>A list of all platforms currently under development can be found
on the <a href="../../platforms/index.html">Supported
Platforms</a> page.</p>
</html>

View file

@ -0,0 +1,540 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org" />
<title>FreeBSD 5.1-RELEASE README</title>
<meta name="GENERATOR"
content="Modular DocBook HTML Stylesheet Version 1.73 " />
<link rel="STYLESHEET" type="text/css" href="docbook.css" />
</head>
<body class="ARTICLE" bgcolor="#FFFFFF" text="#000000"
link="#0000FF" vlink="#840084" alink="#0000FF">
<div class="ARTICLE">
<div class="TITLEPAGE">
<h1 class="TITLE"><a id="AEN2" name="AEN2">FreeBSD
5.1-RELEASE README</a></h1>
<h3 class="CORPAUTHOR">The FreeBSD Project</h3>
<p class="COPYRIGHT">Copyright &copy; 2000, 2001, 2002,
2003 by The FreeBSD Documentation Project</p>
<p class="PUBDATE">$FreeBSD:
src/release/doc/en_US.ISO8859-1/readme/article.sgml,v 1.26
2003/05/06 20:01:07 bmah Exp $<br />
</p>
<hr />
</div>
<blockquote class="ABSTRACT">
<div class="ABSTRACT">
<a id="AEN12" name="AEN12"></a>
<p>This document gives a brief introduction to FreeBSD
5.1-RELEASE. It includes some information on how to
obtain FreeBSD, a listing of various ways to contact the
FreeBSD Project, and pointers to some other sources of
information.</p>
</div>
</blockquote>
<div class="SECT1">
<hr />
<h1 class="SECT1"><a id="INTRO" name="INTRO">1
Introduction</a></h1>
<p>This distribution is a release of FreeBSD 5.1-RELEASE,
the latest point along the 5-CURRENT branch.</p>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN17" name="AEN17">1.1 About
FreeBSD</a></h2>
<p>FreeBSD is an operating system based on 4.4 BSD Lite
for Intel, AMD, Cyrix or NexGen ``x86'' based PC hardware
(i386), NEC PC-9801/9821 series PCs and compatibles
(pc98), DEC/Compaq/HP Alpha computers (alpha), and
UltraSPARC machines (sparc64). Versions for the IA64
(ia64), PowerPC (powerpc), and AMD ``Hammer'' (amd64)
architectures are currently under development as well.
FreeBSD works with a wide variety of peripherals and
configurations and can be used for everything from
software development to games to Internet Service
Provision.</p>
<p>This release of FreeBSD contains everything you need
to run such a system, including full source code for the
kernel and all utilities in the base distribution. With
the source distribution installed, you can literally
recompile the entire system from scratch with one
command, making it ideal for students, researchers, or
users who simply want to see how it all works.</p>
<p>A large collection of third-party ported software (the
``Ports Collection'') is also provided to make it easy to
obtain and install all your favorite traditional <span
class="TRADEMARK">UNIX</span>&reg; utilities for FreeBSD.
Each ``port'' consists of a set of scripts to retrieve,
configure, build, and install a piece of software, with a
single command. Over 8,500 ports, from editors to
programming languages to graphical applications, make
FreeBSD a powerful and comprehensive operating
environment that extends far beyond what's provided by
many commercial versions of <span
class="TRADEMARK">UNIX</span>&reg;. Most ports are also
available as pre-compiled ``packages'', which can be
quickly installed from the installation program.</p>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN29" name="AEN29">1.2 Target
Audience</a></h2>
<p>This release of FreeBSD is suitable for all users. It
has undergone a period of testing and quality assurance
checking to ensure the highest reliability and
dependability.</p>
</div>
</div>
<div class="SECT1">
<hr />
<h1 class="SECT1"><a id="OBTAIN" name="OBTAIN">2 Obtaining
FreeBSD</a></h1>
<p>FreeBSD may be obtained in a variety of ways. This
section focuses on those ways that are primarily useful for
obtaining a complete FreeBSD distribution, rather than
updating an existing installation.</p>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN35" name="AEN35">2.1 CDROM
and DVD</a></h2>
<p>FreeBSD -RELEASE distributions may be ordered on CDROM
or DVD from several publishers. This is frequently the
most convenient way to obtain FreeBSD for new
installations, as it provides a convenient way to quickly
reinstall the system if necessary. Some distributions
include some of the optional, precompiled ``packages''
from the FreeBSD Ports Collection.</p>
<p>A list of the CDROM and DVD publishers known to the
project are listed in the <a
href="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/mirrors.html"
target="_top">``Obtaining FreeBSD''</a> appendix to the
Handbook.</p>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN42" name="AEN42">2.2
FTP</a></h2>
<p>You can use FTP to retrieve FreeBSD and any or all of
its optional packages from <a
href="ftp://ftp.FreeBSD.org/"
target="_top">ftp://ftp.FreeBSD.org/</a>, which is the
official FreeBSD release site, or any of its
``mirrors''.</p>
<p>Lists of locations that mirror FreeBSD can be found in
the <a
href="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/mirrors-ftp.html"
target="_top">FTP Sites</a> section of the Handbook, or
on the <a href="http://www.freebsdmirrors.org/"
target="_top">http://www.freebsdmirrors.org/</a> Web
pages. Finding a close (in networking terms) mirror from
which to download the distribution is highly
recommended.</p>
<p>Additional mirror sites are always welcome. Contact
<tt class="EMAIL">&#60;<a
href="mailto:freebsd-admin@FreeBSD.org">freebsd-admin@FreeBSD.org</a>&#62;</tt>
for more details on becoming an official mirror site. You
can also find useful information for mirror sites at the
<a
href="http://www.FreeBSD.org/doc/en_US.ISO8859-1/articles/hubs/"
target="_top">Mirroring FreeBSD</a> article.</p>
<p>Mirrors generally contain the floppy disk images
necessary to begin an installation, as well as the
distribution files needed for the install process itself.
Many mirrors also contain the ISO images necessary to
create a CDROM of a FreeBSD release.</p>
</div>
</div>
<div class="SECT1">
<hr />
<h1 class="SECT1"><a id="CONTACTING" name="CONTACTING">3
Contacting the FreeBSD Project</a></h1>
<div class="SECT2">
<h2 class="SECT2"><a id="AEN56" name="AEN56">3.1 Email
and Mailing Lists</a></h2>
<p>For any questions or general technical support issues,
please send mail to the <a
href="http://lists.FreeBSD.org/mailman/listinfo/freebsd-questions"
target="_top">FreeBSD general questions mailing
list</a>.</p>
<p>If you're tracking the 5-CURRENT development efforts,
you <span class="emphasis"><i
class="EMPHASIS">must</i></span> join the <a
href="http://lists.FreeBSD.org/mailman/listinfo/freebsd-current"
target="_top">FreeBSD-CURRENT mailing list</a>, in order
to keep abreast of recent developments and changes that
may affect the way you use and maintain the system.</p>
<p>Being a largely-volunteer effort, the FreeBSD Project
is always happy to have extra hands willing to
help--there are already far more desired enhancements
than there is time to implement them. To contact the
developers on technical matters, or with offers of help,
please send mail to the <a
href="http://lists.FreeBSD.org/mailman/listinfo/freebsd-hackers"
target="_top">FreeBSD technical discussions mailing
list</a>.</p>
<p>Please note that these mailing lists can experience
<span class="emphasis"><i
class="EMPHASIS">significant</i></span> amounts of
traffic. If you have slow or expensive mail access, or
are only interested in keeping up with major FreeBSD
events, you may find it preferable to subscribe instead
to the <a
href="http://lists.FreeBSD.org/mailman/listinfo/freebsd-announce"
target="_top">FreeBSD announcements mailing
list</a>.</p>
<p>All of the mailing lists can be freely joined by
anyone wishing to do so. Visit the <a
href="http://www.FreeBSD.org/mailman/listinfo"
target="_top">FreeBSD Mailman Info Page</a>. This will
give you more information on joining the various lists,
accessing archives, etc. There are a number of mailing
lists targeted at special interest groups not mentioned
here; more information can be obtained either from the
Mailman pages or the <a
href="http://www.FreeBSD.org/support.html#mailing-list"
target="_top">mailing lists section</a> of the FreeBSD
Web site.</p>
<div class="IMPORTANT">
<blockquote class="IMPORTANT">
<p><b>Important:</b> Do <span class="emphasis"><i
class="EMPHASIS">not</i></span> send email to the
lists asking to be subscribed. Use the Mailman
interface instead.</p>
</blockquote>
</div>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN74" name="AEN74">3.2
Submitting Problem Reports</a></h2>
<p>Suggestions, bug reports and contributions of code are
always valued--please do not hesitate to report any
problems you may find. Bug reports with attached fixes
are of course even more welcome.</p>
<p>The preferred method to submit bug reports from a
machine with Internet mail connectivity is to use the <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=send-pr&amp;sektion=1&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">send-pr</span>(1)</span></a>
command. ``Problem Reports'' (PRs) submitted in this way
will be filed and their progress tracked; the FreeBSD
developers will do their best to respond to all reported
bugs as soon as possible. <a
href="http://www.FreeBSD.org/cgi/query-pr-summary.cgi"
target="_top">A list of all active PRs</a> is available
on the FreeBSD Web site; this list is useful to see what
potential problems other users have encountered.</p>
<p>Note that <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=send-pr&amp;sektion=1&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">send-pr</span>(1)</span></a> itself
is a shell script that should be easy to move even onto a
non-FreeBSD system. Using this interface is highly
preferred. If, for some reason, you are unable to use <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=send-pr&amp;sektion=1&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">send-pr</span>(1)</span></a> to
submit a bug report, you can try to send it to the <a
href="http://lists.FreeBSD.org/mailman/listinfo/freebsd-bugs"
target="_top">FreeBSD problem reports mailing
list</a>.</p>
<p>For more information, <a
href="http://www.FreeBSD.org/doc/en_US.ISO8859-1/articles/problem-reports/"
target="_top">``Writing FreeBSD Problem Reports''</a>,
available on the FreeBSD Web site, has a number of
helpful hints on writing and submitting effective problem
reports.</p>
</div>
</div>
<div class="SECT1">
<hr />
<h1 class="SECT1"><a id="SEEALSO" name="SEEALSO">4 Further
Reading</a></h1>
<p>There are many sources of information about FreeBSD;
some are included with this distribution, while others are
available on-line or in print versions.</p>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="RELEASE-DOCS"
name="RELEASE-DOCS">4.1 Release Documentation</a></h2>
<p>A number of other files provide more specific
information about this release distribution. These files
are provided in various formats. Most distributions will
include both ASCII text (<tt class="FILENAME">.TXT</tt>)
and HTML (<tt class="FILENAME">.HTM</tt>) renditions.
Some distributions may also include other formats such as
PostScript (<tt class="FILENAME">.PS</tt>) or Portable
Document Format (<tt class="FILENAME">.PDF</tt>).</p>
<ul>
<li>
<p><tt class="FILENAME">README.TXT</tt>: This file,
which gives some general information about FreeBSD as
well as some cursory notes about obtaining a
distribution.</p>
</li>
<li>
<p><tt class="FILENAME">EARLY.TXT</tt>: A guide for
early adopters of FreeBSD 5.1-RELEASE. Highly
recommended reading for users new to FreeBSD
5-CURRENT and/or the 5.<tt
class="REPLACEABLE"><i>X</i></tt> series of
releases.</p>
</li>
<li>
<p><tt class="FILENAME">RELNOTES.TXT</tt>: The
release notes, showing what's new and different in
FreeBSD 5.1-RELEASE compared to the previous release
(FreeBSD 5.0-RELEASE).</p>
</li>
<li>
<p><tt class="FILENAME">HARDWARE.TXT</tt>: The
hardware compatibility list, showing devices with
which FreeBSD has been tested and is known to
work.</p>
</li>
<li>
<p><tt class="FILENAME">INSTALL.TXT</tt>:
Installation instructions for installing FreeBSD from
its distribution media.</p>
</li>
<li>
<p><tt class="FILENAME">ERRATA.TXT</tt>: Release
errata. Late-breaking, post-release information can
be found in this file, which is principally
applicable to releases (as opposed to snapshots). It
is important to consult this file before installing a
release of FreeBSD, as it contains the latest
information on problems which have been found and
fixed since the release was created.</p>
</li>
</ul>
<div class="NOTE">
<blockquote class="NOTE">
<p><b>Note:</b> Several of these documents (in
particular, <tt class="FILENAME">RELNOTES.TXT</tt>,
<tt class="FILENAME">HARDWARE.TXT</tt>, and <tt
class="FILENAME">INSTALL.TXT</tt>) contain
information that is specific to a particular hardware
architecture. For example, the alpha release notes
contain information not applicable to the i386, and
vice versa. The architecture for which each document
applies will be listed in that document's title.</p>
</blockquote>
</div>
<br />
<br />
<p>On platforms that support <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=sysinstall&amp;sektion=8&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">sysinstall</span>(8)</span></a>
(currently alpha, i386, ia64, pc98, and sparc64), these
documents are generally available via the Documentation
menu during installation. Once the system is installed,
you can revisit this menu by re-running the <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=sysinstall&amp;sektion=8&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">sysinstall</span>(8)</span></a>
utility.</p>
<div class="NOTE">
<blockquote class="NOTE">
<p><b>Note:</b> It is extremely important to read the
errata for any given release before installing it, to
learn about any ``late-breaking news'' or
post-release problems. The errata file accompanying
each release (most likely right next to this file) is
already out of date by definition, but other copies
are kept updated on the Internet and should be
consulted as the ``current errata'' for this release.
These other copies of the errata are located at <a
href="http://www.FreeBSD.org/releases/"
target="_top">http://www.FreeBSD.org/releases/</a>
(as well as any sites which keep up-to-date mirrors
of this location).</p>
</blockquote>
</div>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN141" name="AEN141">4.2 Manual
Pages</a></h2>
<p>As with almost all <span
class="TRADEMARK">UNIX</span>&reg;-like operating
systems, FreeBSD comes with a set of on-line manual
pages, accessed through the <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=man&amp;sektion=1&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">man</span>(1)</span></a> command or
through the <a href="http://www.FreeBSD.org/cgi/man.cgi"
target="_top">hypertext manual pages gateway</a> on the
FreeBSD Web site. In general, the manual pages provide
information on the different commands and APIs available
to the FreeBSD user.</p>
<p>In some cases, manual pages are written to give
information on particular topics. Notable examples of
such manual pages are <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=tuning&amp;sektion=7&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">tuning</span>(7)</span></a> (a
guide to performance tuning), <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=security&amp;sektion=7&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">security</span>(7)</span></a> (an
introduction to FreeBSD security), and <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=style&amp;sektion=9&amp;manpath=FreeBSD+5.1-release">
<span class="CITEREFENTRY"><span
class="REFENTRYTITLE">style</span>(9)</span></a> (a style
guide to kernel coding).</p>
</div>
<div class="SECT2">
<hr />
<h2 class="SECT2"><a id="AEN159" name="AEN159">4.3 Books
and Articles</a></h2>
<p>Two highly-useful collections of FreeBSD-related
information, maintained by the FreeBSD Project, are the
FreeBSD Handbook and FreeBSD FAQ (Frequently Asked
Questions document). On-line versions of the <a
href="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/"
target="_top">Handbook</a> and <a
href="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/faq/"
target="_top">FAQ</a> are always available from the <a
href="http://www.FreeBSD.org/docs.html"
target="_top">FreeBSD Documentation page</a> or its
mirrors. If you install the <tt class="FILENAME">doc</tt>
distribution set, you can use a Web browser to read the
Handbook and FAQ locally.</p>
<p>A number of on-line books and articles, also
maintained by the FreeBSD Project, cover
more-specialized, FreeBSD-related topics. This material
spans a wide range of topics, from effective use of the
mailing lists, to dual-booting FreeBSD with other
operating systems, to guidelines for new committers. Like
the Handbook and FAQ, these documents are available from
the FreeBSD Documentation Page or in the <tt
class="FILENAME">doc</tt> distribution set.</p>
<p>A listing of other books and documents about FreeBSD
can be found in the <a
href="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/bibliography.html"
target="_top">bibliography</a> of the FreeBSD Handbook.
Because of FreeBSD's strong <span
class="TRADEMARK">UNIX</span>&reg; heritage, many other
articles and books written for <span
class="TRADEMARK">UNIX</span>&reg; systems are applicable
as well, some of which are also listed in the
bibliography.</p>
</div>
</div>
<div class="SECT1">
<hr />
<h1 class="SECT1"><a id="ACKNOWLEDGEMENTS"
name="ACKNOWLEDGEMENTS">5 Acknowledgments</a></h1>
<p>FreeBSD represents the cumulative work of many hundreds,
if not thousands, of individuals from around the world who
have worked countless hours to bring about this release.
For a complete list of FreeBSD developers and contributors,
please see <a
href="http://www.FreeBSD.org/doc/en_US.ISO8859-1/articles/contributors/"
target="_top">``Contributors to FreeBSD''</a> on the
FreeBSD Web site or any of its mirrors.</p>
<p>Special thanks also go to the many thousands of FreeBSD
users and testers all over the world, without whom this
release simply would not have been possible.</p>
</div>
</div>
<hr />
<p align="center"><small>This file, and other release-related
documents, can be downloaded from <a
href="ftp://ftp.FreeBSD.org/">ftp://ftp.FreeBSD.org/</a>.</small></p>
<p align="center"><small>For questions about FreeBSD, read the
<a href="http://www.FreeBSD.org/docs.html">documentation</a>
before contacting &#60;<a
href="mailto:questions@FreeBSD.org">questions@FreeBSD.org</a>&#62;.</small></p>
<p align="center"><small><small>All users of FreeBSD 5-CURRENT
should subscribe to the &#60;<a
href="mailto:current@FreeBSD.org">current@FreeBSD.org</a>&#62;
mailing list.</small></small></p>
<p align="center">For questions about this documentation,
e-mail &#60;<a
href="mailto:doc@FreeBSD.org">doc@FreeBSD.org</a>&#62;.</p>
<br />
<br />
</body>
</html>

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

View file

@ -0,0 +1,29 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" [
<!ENTITY base CDATA "../..">
<!ENTITY date "$FreeBSD$">
<!ENTITY title "FreeBSD 5.1-RELEASE Release Notes">
<!ENTITY % includes SYSTEM "../../includes.sgml"> %includes;
]>
<html>
&header;
<p>The release notes for FreeBSD are customized for different
platforms, as some of the changes made to FreeBSD apply only to
specific processor architectures.</p>
<p>Release notes for FreeBSD 5.1-RELEASE are available for the following
platforms:</p>
<ul>
<li><a href="relnotes-alpha.html">alpha</a></li>
<li><a href="relnotes-ia64.html">ia64</a></li>
<li><a href="relnotes-i386.html">i386</a></li>
<li><a href="relnotes-pc98.html">pc98</a></li>
<li><a href="relnotes-sparc64.html">sparc64</a></li>
</ul>
<p>A list of all platforms currently under development can be found
on the <a href="../../platforms/index.html">Supported
Platforms</a> page.</p>
</html>