From 1a8b9aba7c682a2c68106647e3d96c432c932467 Mon Sep 17 00:00:00 2001 From: "Bruce A. Mah" Date: Tue, 3 Jun 2003 17:19:25 +0000 Subject: [PATCH] Add release documentation and glue pages for 5.1-RELEASE...not connected to Web site build yet. --- en/releases/5.1R/early-adopter.html | 611 ++ en/releases/5.1R/errata.html | 126 + en/releases/5.1R/hardware-alpha.html | 5842 ++++++++++++++++++++ en/releases/5.1R/hardware-i386.html | 5036 +++++++++++++++++ en/releases/5.1R/hardware-ia64.html | 835 +++ en/releases/5.1R/hardware-pc98.html | 3431 ++++++++++++ en/releases/5.1R/hardware-sparc64.html | 916 +++ en/releases/5.1R/hardware.sgml | 30 + en/releases/5.1R/installation-alpha.html | 1544 ++++++ en/releases/5.1R/installation-i386.html | 2091 +++++++ en/releases/5.1R/installation-ia64.html | 1188 ++++ en/releases/5.1R/installation-pc98.html | 1346 +++++ en/releases/5.1R/installation-sparc64.html | 1248 +++++ en/releases/5.1R/installation.sgml | 29 + en/releases/5.1R/readme.html | 540 ++ en/releases/5.1R/relnotes-alpha.html | 1563 ++++++ en/releases/5.1R/relnotes-i386.html | 1740 ++++++ en/releases/5.1R/relnotes-ia64.html | 1563 ++++++ en/releases/5.1R/relnotes-pc98.html | 1641 ++++++ en/releases/5.1R/relnotes-sparc64.html | 1570 ++++++ en/releases/5.1R/relnotes.sgml | 29 + 21 files changed, 32919 insertions(+) create mode 100644 en/releases/5.1R/early-adopter.html create mode 100644 en/releases/5.1R/errata.html create mode 100644 en/releases/5.1R/hardware-alpha.html create mode 100644 en/releases/5.1R/hardware-i386.html create mode 100644 en/releases/5.1R/hardware-ia64.html create mode 100644 en/releases/5.1R/hardware-pc98.html create mode 100644 en/releases/5.1R/hardware-sparc64.html create mode 100644 en/releases/5.1R/hardware.sgml create mode 100644 en/releases/5.1R/installation-alpha.html create mode 100644 en/releases/5.1R/installation-i386.html create mode 100644 en/releases/5.1R/installation-ia64.html create mode 100644 en/releases/5.1R/installation-pc98.html create mode 100644 en/releases/5.1R/installation-sparc64.html create mode 100644 en/releases/5.1R/installation.sgml create mode 100644 en/releases/5.1R/readme.html create mode 100644 en/releases/5.1R/relnotes-alpha.html create mode 100644 en/releases/5.1R/relnotes-i386.html create mode 100644 en/releases/5.1R/relnotes-ia64.html create mode 100644 en/releases/5.1R/relnotes-pc98.html create mode 100644 en/releases/5.1R/relnotes-sparc64.html create mode 100644 en/releases/5.1R/relnotes.sgml diff --git a/en/releases/5.1R/early-adopter.html b/en/releases/5.1R/early-adopter.html new file mode 100644 index 0000000000..8a4825639a --- /dev/null +++ b/en/releases/5.1R/early-adopter.html @@ -0,0 +1,611 @@ + + + + + Early Adopter's Guide to FreeBSD 5.1-RELEASE + + + + + +
+
+

Early Adopter's + Guide to FreeBSD 5.1-RELEASE

+ +
+ + +

The FreeBSD Release Engineering + Team

+
+ +

Copyright © 2002, 2003 by The + FreeBSD Release Engineering Team

+ +

$FreeBSD: + src/release/doc/en_US.ISO8859-1/early-adopter/article.sgml,v + 1.15 2003/05/03 22:14:55 bmah Exp $
+

+ +
+
+ + +

This article describes the status of FreeBSD + 5.1-RELEASE, from the standpoint of users who may be + new to the 5.X + 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.

+
+
+
+
+ +
+
+ +

1 + Introduction

+ +

FreeBSD 5.X 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.X releases, the first + few 5.X releases may + have regressions in areas of stability, performance, and + occasionally functionality.

+ +

For these reasons, the Release Engineering Team + 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.X releases (such as + 4.8-RELEASE) for the near-term future. We feel that such + users are probably best served by upgrading to 5.X only after a 5-STABLE + development branch has been created; this may be around the + time of 5.2-RELEASE.

+ +

(FreeBSD 5.X 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!)

+ +

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.X systems to + 5.1-RELEASE.

+
+ +
+
+ +

2 An Overview of the FreeBSD + Release Process

+ +

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 HEAD 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.

+ +

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.X releases + were based on it. This branch has the tag RELENG_4 in the CVS repository.

+ +

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).

+ +

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 RELENG_5. 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.

+ +

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.X series before this + happens; we estimate that the 5-STABLE branch will be + created sometime after 5.2-RELEASE.

+ +

More information on FreeBSD release engineering + processes can be found on the Release Engineering Web pages and in the + ``FreeBSD Release Engineering'' article. + Specific issues for the upcoming 5-STABLE development + branch can be found in ``The Roadmap for 5-STABLE''.

+
+ +
+
+ +

3 New + Features

+ +

A large attraction of FreeBSD 5.X 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:

+ +
    +
  • +

    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.

    +
    • + +
  • +

    KSE: Kernel Scheduled Entities allow a single + process to have multiple kernel-level threads, similar + to Scheduler Activations. The (experimental) libkse and libthr libraries make this + feature available to multi-threaded userland + programs.

    +
    • + +
  • +

    New architectures: Support for the sparc64 and ia64 + architectures, in addition to the i386, pc98, and + alpha.

    +
    • + +
  • +

    GCC: The compiler toolchain is now based on GCC + 3.2.2, rather than GCC 2.95.X.

    +
    • + +
  • +

    MAC: Support for extensible, loadable Mandatory + Access Control policies.

    +
    • + +
  • +

    GEOM: A flexible framework for transformations of + disk I/O requests. An experimental disk encryption + facility has been developed based on GEOM.

    +
    • + +
  • +

    FFS: The FFS filesystem now supports background + fsck(8) + operations (for faster crash recovery) and filesystem + snapshots.

    +
    • + +
  • +

    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 + newfs(8). On + all platforms except for pc98, filesystems created from + within + sysinstall(8) + will use UFS2 by default.

    +
    • + +
  • +

    Cardbus: Support for Cardbus devices.

    +
    • +
+ +

A more comprehensive list of new features can be found + in the release notes for FreeBSD 5.0-RELEASE and FreeBSD + 5.1-RELEASE.

+
+ +
+
+ +

4 + Drawbacks to Early Adoption

+ +

Along with the new features of FreeBSD 5.X 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:

+ +
    +
  • +

    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.

    +
    • + +
  • +

    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.

    +
    • + +
  • +

    Several parts of FreeBSD's base system functionality + have been moved to the Ports Collection. Notable + examples include Perl, UUCP, and most (but not all) + games. While these programs are still supported, their + removal from the base system may cause some + confusion.

    +
    • + +
  • +

    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.

    +
    • + +
  • +

    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.

    +
    • + +
  • +

    Many FreeBSD 5.X + features are seeing wide exposure for the first time. + Many of these features (such as SMPng) have broad + impacts on the kernel.

    +
    • + +
  • +

    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.

    +
    • + +
  • +

    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.)

    +
    • + +
  • +

    Documentation (such as the FreeBSD Handbook and FAQ) may not reflect changes + recently made to FreeBSD 5.X.

    +
    • +
+ +

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.X series is more + polished.

+
+ +
+
+ +

5 Plans for the 4-STABLE + Branch

+ +

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 HEAD + at the discretion of developers, subject to existing + release engineering policies.

+ +

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).

+ +

The Security Officer Team + will continue to support releases made from the 4-STABLE + branch in accordance with their published policies, which + can be found on the Security page 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.

+
+ +
+
+ +

6 Notes on + Upgrading from FreeBSD 4.X

+ +

For those users with existing FreeBSD systems, this + section offers a few notes on upgrading a FreeBSD 4.X system to 5.X. As with any FreeBSD + upgrade, it is crucial to read the release notes and the + errata for the version in question, as well as src/UPDATING in the case of source + upgrades.

+ +
+
+ +

6.1 Binary + Upgrades

+ +

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).

+ +

As of this time, the binary upgrade option in + sysinstall(8) 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.X but not in 5.X. These obsolete files + may create some problems.

+ +

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 + device.hints(5) + mechanism (it allows specifying the same parameters, but + with a very different interface).

+ +

Floppy-based binary installations may require + downloading a third, new floppy image holding additional + device drivers in kernel modules. This drivers.flp floppy image will + generally be found in the same location as the usual kern.flp and mfsroot.flp floppy images.

+ +

CDROM-based installations on the i386 architecture now + use a ``no-emulation'' boot loader. This allows, among + other things, the use of a GENERIC 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.X + CDROMs.

+
+ +
+
+ +

6.2 Source + Upgrades

+ +

Reading src/UPDATING 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.

+
+ +
+
+ +

6.3 Common + Notes

+ +

Perl 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). + sysinstall(8) + will now install the Perl package as a part of most + distribution sets, so most users will not notice this + change.

+ +

It is generally possible to run old 4.X executables under 5.X, but this requires the + compat4x distribution to be + installed. Thus, using old ports may be + possible.

+ +

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 /usr/include. Renaming or moving + this directory before a binary installation or an installworld 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.

+ +

MAKEDEV is no longer + available, nor is it required. FreeBSD 5.X uses a device + filesystem, which automatically creates device nodes on + demand. For more information, please see + devfs(5).

+ +

UFS2 is the default on-disk format for file systems + created using + newfs(8). For all + platforms except pc98, it is also the default for file + systems created using the disk labeling screen within + sysinstall(8). + Because FreeBSD 4.X + only understands UFS1 (not UFS2), disk partitions that + need to be accessed by both 5.X and 4.X must be created with + UFS1. This can be specified using the -O1 option to + newfs(8), or on + the disk labeling screen in + sysinstall(8). + This situation most often arises with a a single machine + that dual-boots FreeBSD 4.X and FreeBSD 5.X. 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).

+
+
+ +
+
+ +

7 + Summary

+ +

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.X + 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.

+
+
+
+ +

This file, and other release-related + documents, can be downloaded from ftp://ftp.FreeBSD.org/.

+ +

For questions about FreeBSD, read the + documentation + before contacting <questions@FreeBSD.org>.

+ +

All users of FreeBSD 5-CURRENT + should subscribe to the <current@FreeBSD.org> + mailing list.

+ +

For questions about this documentation, + e-mail <doc@FreeBSD.org>.

+
+
+ + + diff --git a/en/releases/5.1R/errata.html b/en/releases/5.1R/errata.html new file mode 100644 index 0000000000..bf10366c7c --- /dev/null +++ b/en/releases/5.1R/errata.html @@ -0,0 +1,126 @@ + + + + + FreeBSD 5.1-RELEASE Errata + + + + + +
+
+

FreeBSD + 5.1-RELEASE Errata

+ +

The FreeBSD Project

+ +

Copyright © 2000, 2001, 2002, + 2003 by The FreeBSD Documentation Project

+ +

$FreeBSD: + src/release/doc/en_US.ISO8859-1/errata/article.sgml,v + 1.38.2.1 2003/06/01 01:50:16 bmah Exp $
+

+
+
+ +
+
+ + +

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.

+ +

This errata document for FreeBSD 5.1-RELEASE will be + maintained until the release of FreeBSD 5.1-RELEASE.

+
+
+ +
+
+ +

1 + Introduction

+ +

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.

+ +

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 http://www.FreeBSD.org/releases/, plus + any sites which keep up-to-date mirrors of this + location.

+ +

Source and binary snapshots of FreeBSD 5-CURRENT also + contain up-to-date copies of this document (as of the time + of the snapshot).

+ +

For a list of all FreeBSD CERT security advisories, see + http://www.FreeBSD.org/security/ or ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/.

+
+ +
+
+ +

2 + Security Advisories

+ +

No advisories.

+
+ +
+
+ +

3 + Late-Breaking News

+ +

No news.

+
+
+
+ +

This file, and other release-related + documents, can be downloaded from ftp://ftp.FreeBSD.org/.

+ +

For questions about FreeBSD, read the + documentation + before contacting <questions@FreeBSD.org>.

+ +

All users of FreeBSD 5-CURRENT + should subscribe to the <current@FreeBSD.org> + mailing list.

+ +

For questions about this documentation, + e-mail <doc@FreeBSD.org>.

+
+
+ + + diff --git a/en/releases/5.1R/hardware-alpha.html b/en/releases/5.1R/hardware-alpha.html new file mode 100644 index 0000000000..aa9ee4df82 --- /dev/null +++ b/en/releases/5.1R/hardware-alpha.html @@ -0,0 +1,5842 @@ + + + + + FreeBSD/alpha 5.1-RELEASE Hardware Notes + + + + + +
+
+

FreeBSD/alpha + 5.1-RELEASE Hardware Notes

+ +

The FreeBSD Documentation + Project

+ +

Copyright © 2000, 2001, 2002, + 2003 by The FreeBSD Documentation Project

+
+
+ +
+
+
Table of Contents
+ +
1 Introduction
+ +
2 Supported processors and + motherboards
+ +
+
+
2.1 Overview
+ +
2.2 In general, what do you need + to run FreeBSD on an Alpha?
+ +
2.3 System-specific + information
+ +
+
+
2.3.1 AXPpci33 + (``NoName'')
+ +
2.3.2 Universal Desktop Box + (UDB or ``Multia'')
+ +
2.3.3 Personal Workstation + (``Miata'')
+ +
2.3.4 Evaluation Board 64 + family
+ +
2.3.5 Evaluation Board 164 + (``EB164, PC164, PC164LX, PC164SX'') + family
+ +
2.3.6 AlphaStation 200 + (``Mustang'') and 400 (``Avanti'') + series
+ +
2.3.7 AlphaStation 500 and + 600 (``Alcor'' & ``Maverick'' for EV5, + ``Bret'' for EV56)
+ +
2.3.8 AlphaServer 1000 + (``Mikasa''), 1000A (``Noritake'') and + 800(``Corelle'')
+ +
2.3.9 DS10/VS10/XP900 + (``Webbrick'') / XP1000 (``Monet'') / DS10L + (``Slate'')
+ +
2.3.10 DS20/DS20E + (``Goldrush'')
+ +
2.3.11 AlphaPC 264DP / + UP2000
+ +
2.3.12 AlphaServer 2000 + (``DemiSable''), 2100 (``Sable''), 2100A + (``Lynx'')
+ +
2.3.13 AlphaServer 4x00 + (``Rawhide'')
+ +
2.3.14 AlphaServer 1200 + (``Tincup'') and AlphaStation 1200 + (``DaVinci'')
+ +
2.3.15 AlphaServer 8200 + and 8400 (``TurboLaser'')
+ +
2.3.16 Alpha Processor + Inc. UP1000
+ +
2.3.17 Alpha Processor + Inc. UP1100
+ +
2.3.18 Alpha Processor + Inc. CS20, Compaq DS20L
+ +
2.3.19 Compaq AlphaServer + ES40 (``Clipper'')
+
+
+ +
2.4 Supported Hardware + Overview
+ +
2.5 Acknowledgments
+
+
+ +
3 Supported Devices
+ +
+
+
3.1 Disk Controllers
+ +
3.2 Ethernet + Interfaces
+ +
3.3 FDDI Interfaces
+ +
3.4 ATM Interfaces
+ +
3.5 Wireless Network + Interfaces
+ +
3.6 Miscellaneous + Networks
+ +
3.7 ISDN Interfaces
+ +
3.8 Serial Interfaces
+ +
3.9 Audio Devices
+ +
3.10 Camera and Video Capture + Devices
+ +
3.11 USB Devices
+ +
3.12 IEEE 1394 (Firewire) + Devices
+ +
3.13 Bluetooth + Devices
+ +
3.14 Cryptographic + Accelerators
+ +
3.15 Miscellaneous
+
+
+
+
+ +
+
+ +

1 + Introduction

+ +

This document contains the hardware compatibility notes + for FreeBSD 5.1-RELEASE on the Alpha/AXP hardware platform + (also referred to as FreeBSD/alpha 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.

+ +
+
+

Note: This document includes information + specific to the Alpha/AXP hardware platform. Versions + of the hardware compatibility notes for other + architectures will differ in some details.

+
+
+
+ +
+
+ +

2 Supported processors and + motherboards

+ Maintained + by Wilko Bulte. + +

Additions, corrections and constructive criticism are + invited. In particular, information on system quirks is + more than welcome.

+ +
+
+ +

2.1 + Overview

+ +

This document tries to provide a starting point for + those who want to run FreeBSD on an Alpha-based machine. + It is aimed at providing background information on the + various hardware designs. It is not a replacement for the + systems manuals.

+ +

The information is structured as follows:

+ +
    +
  • +

    general hardware requirements to run FreeBSD on + alpha;

    +
    • + +
  • +

    system specific information for each of the + systems/boards supported by FreeBSD;

    +
    • + +
  • +

    information on expansion boards for FreeBSD, + including things that differ from what is in the + generic supported hardware list.

    +
    • +
+ +
+
+

Note: You will see references to DEC, + Digital Equipment Corporation and Compaq used more or + less interchangeably. Now that Compaq has acquired + Digital Equipment it would be more correct to refer + to Compaq only. To be completely politically correct + given that Hewlett Packard in turn has acquired + Compaq I probably should be using HP everywhere. + Given the fact that you will see the mix of names + everywhere, I don't bother.

+
+
+ +
+
+

Note: SRM commands will be in UPPER CASE. Lower case + input is also acceptable to SRM. Upper case is used + for clarity.

+
+
+ +
+
+

Note: Compaq has put information on the Web + for Linux developers that is also very useful for + FreeBSD users. Please check at Linux Alpha Power tools.

+
+
+
+ +
+
+ +

2.2 In + general, what do you need to run FreeBSD on an + Alpha?

+ +

Obviously you will need an Alpha machine that FreeBSD + knows about. Alpha machines are NOT like PCs. There are + considerable differences between the various core logic + chip sets and mainboard designs. This means that a kernel + needs to know the intimate details of a particular + machine before it can run on it. Throwing some odd GENERIC kernel at unknown hardware + is almost guaranteed to fail miserably.

+ +

For a machine even to be considered for FreeBSD use + please make sure it has the SRM console firmware + installed. Or at least make sure that SRM console + firmware is available for the particular machine type. If + FreeBSD does not currently support your machine type, + there is a good chance that this will change at some + point in time, assuming SRM is available. All bets are + off when SRM console firmware is not available.

+ +

Machines with the ARC or AlphaBIOS console firmware + were intended for WindowsNT. Some have SRM console + firmware available in the system ROMs which you only have + to select (via an ARC or AlphaBIOS menu). In other cases + you will have to re-flash the ROMs with SRM code. Check + on http://ftp.digital.com/pub/DEC/Alpha/firmware to see + what is available for your particular system. In any + case: no SRM means no FreeBSD (or NetBSD, + OpenBSD, Tru64 Unix or OpenVMS for that matter). With the + demise of WindowsNT/alpha a lot of former NT boxes are + sold on the second hand market. They have little or no + trade-in value when they are NT-only from the console + firmware perspective. So, be suspicious if the price + appears too good.

+ +

Known non-SRM machines are:

+ +
    +
  • +

    Digital XL series

    +
    • + +
  • +

    Digital XLT series

    +
    • + +
  • +

    Samsung PC164UX (``Ruffian'')

    +
    • + +
  • +

    Samsung 164B

    +
    • +
+ +

Machines that have SRM but are not supported by + FreeBSD are:

+ +
    +
  • +

    DECpc 150 (``Jensen'')

    +
    • + +
  • +

    DEC 2000/300 (``Jensen'')

    +
    • + +
  • +

    DEC 2000/500 (``Culzean'')

    +
    • + +
  • +

    AXPvme series (``Medulla'')

    +
    • +
+ +

To complicate things a bit further: Digital used to + have so called ``white-box'' Alpha machines destined as + NT-only and ``blue-box'' Alpha machines destined for + OpenVMS and Digital Unix. These names are based on the + color of the cabinets, ``FrostWhite'' and ``TopGunBlue'' + respectively. Although you could put the SRM console + firmware on a whitebox, OpenVMS and Digital Unix will + refuse to boot on them. FreeBSD in post-4.0-RELEASE will + run on both the white and the blue-box variants. Before + someone asks: the white ones had a rather different + (read: cheaper) Digital price tag.

+ +

As part of the SRM you will get the so called OSF/1 + PAL code (OSF/1 being the initial name of Digital's UNIX + offering on Alpha). The PAL code can be thought of as a + software abstraction layer between the hardware and the + operating system. It uses normal CPU instruction plus a + handful of privileged instructions specific for PAL use. + PAL is not microcode. The ARC console firmware contains a + different PAL code, geared towards WinNT and in no way + suitable for use by FreeBSD (or more generic: Unix or + OpenVMS). Before someone asks: Linux/alpha brings its own + PAL code, allowing it to boot on ARC and AlphaBIOS. There + are various reasons why this is not a very good idea in + the eyes of the *BSD folks. I don't want to go into + details here. If you are interested in the gory details + search the FreeBSD and NetBSD web sites.

+ +

There is another pitfall ahead: you will need a disk + adapter that the SRM console firmware recognizes in order + to be able to boot from a disk. What is acceptable to SRM + as a boot adapter is unfortunately highly system and SRM + version dependent. For older PCI based machines it means + you will need either a NCR/Symbios 53C810 based adapter, + or a Qlogic 1020/1040 based adapter. Some machines come + with a SCSI chip embedded on the mainboard. Newer machine + designs and SRM versions will be able to work with more + modern SCSI chips/adapters. Check out the machine + specific info below. Please note that the rest of this + discussion only refers to Symbios chips, this is meant to + include the older chips that still have NCR stamped on + them. Symbios bought NCR sometime.

+ +

The problem might bite those who have machines that + started their lives as WindowsNT boxes. The ARC or + AlphaBIOS knows about other adapter types that it + can boot from than the SRM. For example you can boot from + an Adaptec 2940UW with ARC/AlphaBios but (generally) not + with SRM. Some newer machine types have introduced + Adaptec boot support. Please consult the machine specific + section for details.

+ +

Most adapters that cannot be booted from work fine for + data-only disks. The differences between SRM and ARC + could also get you pre-packaged IDE CDROMs and hard + drives in some (former WindowsNT) systems. SRM versions + exist (depends on the machine type) that can boot from + IDE disks and CDROMs. Check the machine specific section + for details.

+ +

FreeBSD 4.0 and later can be booted from the + distribution CDROM. Earlier versions needed booting from + a 2 disk floppy set.

+ +

In order to be bootable the root partition (partition + a) must be at offset 0 of the disk drive. This means you + have to use the installer's partitioning menu and start + with assigning partition a at offset 0 to the root + partition. Subsequently layout the rest of the partitions + to your liking. If you do not adhere to this rule the + install will proceed just fine, but the system will not + be bootable from the freshly installed disk.

+ +

If you don't have/want a local disk drive you can boot + via the Ethernet. This assumes an Ethernet adapter/chip + that is recognized by the SRM console. Generally speaking + this boils down to either a 21040 or 21142 or 21143 based + Ethernet interface. Older machines or SRM versions may + not recognize the 21142 / 21143 Fast Ethernet chips, you + are then limited to using 10Mbit Ethernet for net booting + those machines. Non-DEC cards based on said chips will + generally (but are not guaranteed to) work. Note that + Intel took over the 21x4x chips when it bought Digital + Semiconductor. So you might see an Intel logo on them + these days. Recent machine designs have SRM support for + Intel 8255x Ethernet chips.

+ +

Alpha machines can be run with SRM on a graphics + console or on a serial console. ARC can also be run on a + serial consoles if need be. VT100 emulation with 8 bit + controls should at least allow you to switch from + ARC/AlphaBIOS to SRM mode without having to install a + graphics card first.

+ +

If you want to run your Alpha machine without a + monitor/graphics card just don't connect a keyboard/mouse + to the machine. Instead hook up a serial + terminal[emulator] to serial port #1. The SRM will talk + 9600N81 to you. This can also be really practical for + debugging purposes. Beware: some/most (?) SRMs will also + present you with a console prompt at serial port #2. The + booting kernel, however, will display the boot messages + on serial port #1 and will also put the console there. + This can be + extremely confusing.

+ +

Most PCI based Alphas can use ordinary PC-type VGA + cards. The SRM contains enough smarts to make that work. + It does not, however, mean that each and every PCI VGA + card out on the street will work in an Alpha machine. + Things like S3 Trio64, Mach64, and Matrox Millennium + generally work. Old ET4000 based ISA cards have also + worked for me. But ask around first before buying.

+ +

Most PCI devices from the PC-world will also work in + FreeBSD PCI-based machines. Check the /sys/alpha/conf/GENERIC file for + the latest word on this. Check the appropriate machine + type's discussion in case you want to use PCI cards that + have PCI bridge chips on them. In some cases you might + encounter problems with PCI cards not handling PCI parity + correctly. This can lead to panics. PCI parity checking + can be disabled using the following SRM command:

+
+>>> SET PCI_PARITY OFF
+
+ +

This is not a FreeBSD problem, all operating systems + running on Alpha hardware will need this workaround.

+ +

If your system (also) contains EISA expansion slots + you will need to run the EISA Configuration Utility (ECU) + after you have installed EISA cards or after you have + upgraded your console firmware.

+ +

For Alpha CPUs you will find multiple generations. The + original Alpha design is the 21064. It was produced in a + chip process called MOS4, chips made in this process are + nicknamed EV4. Newer CPUs are 21164, 21264 etc. You will + see designations like EV4S, EV45, EV5, EV56, EV6, EV67, + EV68. The EVs with double digit numbers are slightly + improved versions. For example EV45 has an improved FPU + and 16 kByte on-chip separate I & D caches compared + to the EV4 on which it is based. Rule of thumb: the + higher the digit immediately following ``EV'' the more + desirable (read: faster / more modern).

+ +

For memory you want at least 32 Mbytes. I have had + FreeBSD run on a 16 Mbyte system but you will not enjoy + that. Kernel build times halved when I went to 32 Mbytes. + Note that the SRM console steals 2Mbyte from the total + system memory (and keeps it). For more serious work 64 + Mbytes or more are recommended.

+ +

While on the subject of memory: pay close attention to + the type of memory your machine uses. There are very + different memory configurations and requirements for the + various machines.

+ +

Final word: I expect the above to sound a bit daunting + to the first-time Alpha user. Don't be daunted too much. + And do feel free to ask questions if something is not + clear after reading this document.

+
+ +
+
+ +

2.3 + System-specific information

+ +

Below is an overview of the hardware that FreeBSD runs + on. This list will definitely grow, a look in /sys/alpha/conf/GENERIC can be + enlightening.

+ +

Alpha machines are often best known by their project + code name. Where known these are listed below in + parentheses.

+ +
+
+ +

2.3.1 + AXPpci33 (``NoName'')

+ +

The NoName is a baby-AT mainboard based on the 21066 + LCA (Low Cost Alpha) processor. NoName was originally + designed for OEM-use. The LCA chip includes almost all + of the logic to drive a PCI bus and the memory + subsystem. All of this makes for a low-priced + design.

+ +

Due to the limited memory interface the system is + not particularly fast in case of cache misses. As long + as you stay inside the on-chip cache the CPU is + comparable to a 21064 (first generation Alpha). These + boards should be very cheap to obtain these days. It is + a full-fledged 64 bit CPU, just don't expect miracles + as far as speed goes.

+ +

Features:

+ +
    +
  • +

    21066 Alpha CPU at 166 MHz or 21066A CPU at + 233MHz. 21068 CPUs are also possible, but are even + slower.

    +
    • + +
  • +

    on-board Bcache / L2 cache: 0, 256k or 1 Mbyte + (uses DIL chips)

    +
    • + +
  • +

    PS/2 mouse & keyboard port OR 5pin DIN + keyboard (2 mainboard models)

    +
    • + +
  • +

    memory:

    + +
      +
    • +

      bus width: 64 bits

      +
      • + +
    • +

      PS/2 style 72 pin 36 bit Fast Page Mode + SIMMs

      +
      • + +
    • +

      70ns or better

      +
      • + +
    • +

      installed in pairs of 2

      +
      • + +
    • +

      4 SIMM sockets

      +
      • + +
    • +

      uses ECC

      +
      • +
    +
    • + +
  • +

    512kB Flash ROM for the console code.

    +
    • + +
  • +

    2 16550A serial ports

    +
    • + +
  • +

    1 parallel port

    +
    • + +
  • +

    floppy interface

    +
    • + +
  • +

    1 embedded IDE interface

    +
    • + +
  • +

    expansion:

    + +
      +
    • +

      3 32 bit PCI slots (1 shared with ISA)

      +
      • + +
    • +

      5 ISA slots (1 shared with PCI)

      +
      • +
    +
    • + +
  • +

    embedded Fast SCSI using a Symbios 53C810 + chip

    +
    • +
+ +

NoNames can either have SRM or ARC + console firmware in their Flash ROM. The Flash ROM is + not big enough to hold both ARC and SRM at the same + time and allow software selection of alternate console + code. But you only need SRM anyway.

+ +

Cache for the NoNames are 15 or 20 ns DIL chips. For + a 256 kByte cache you want to check your junked 486 + mainboard. Chips for a 1 Mbyte cache are a rarer breed + unfortunately. Getting at least a 256kByte cache is + recommended performance wise. Cache-less they are + really slow.

+ +

The NoName mainboard has a PC/AT-standard power + connector. It also has a power connector for 3.3 Volts. + No need to rush out to get a new power supply. The 3.3 + Volts is only needed in case you run 3.3 Volts PCI + expansion boards. These are quite rare.

+ +

The IDE interface is supported by FreeBSD and + requires a line in the kernel configuration file as + follows:

+
+device ata
+
+ +

The ATA interface uses irq 14.

+ +

The SRM console unfortunately cannot + boot from IDE disks. This means you will + have to use a SCSI disk as the boot device.

+ +

The NoName is somewhat stubborn when it comes to + serial consoles. It needs

+
+>>> SET CONSOLE SERIAL
+
+ +

before it goes for a serial console. Pulling the + keyboard from the machine is not sufficient, like it is + on most other Alpha models. Going back to a graphical + console needs

+
+>>> SET CONSOLE GRAPHICS
+
+ +

at the serial console.

+ +

There have been reports that you sometimes need to + press Control-Alt-Del to + capture the SRM's attention. I have never seen this + myself, but it is worth trying if you are greeted by a + blank screen after powerup.

+ +

Make sure you use true 36 bit SIMMs, and only FPM + (Fast Page Mode) DRAM. EDO DRAM or SIMMs with fake + parity will + not work. The board uses the 4 extra bits + for ECC. 33 bit FPM SIMMs will for the same reason not + work.

+ +

Given the choice, get the PS/2-variant mainboard. + Apart from giving you a mouse port as bonus it is + directly supported by Tru64 Unix in case you ever want + or need to run it. The ``DIN-plug''-variant should work + OK for FreeBSD.

+ +

The OEM manual is recommended + reading.

+ +

The kernel configuration file for a NoName kernel + must contain:

+
+options    DEC_AXPPCI_33           
+cpu EV4
+
+
+ +
+
+ +

2.3.2 + Universal Desktop Box (UDB or ``Multia'')

+ +
+
+

Note: Multia can be either Intel or Alpha + CPU based. We assume Alpha based ones here for + obvious reasons.

+
+
+ +

Multia is a small desktop box intended as a sort of + personal workstation. They come in a considerable + number of variations, check closely what you get.

+ +

Features:

+ +
    +
  • +

    21066 Alpha CPU at 166 MHz or 21066A CPU at + 233MHz

    +
    • + +
  • +

    on-board Bcache / L2 cache: COAST-like 256 kByte + cache module; 233MHz models have 512kByte of cache; + 166MHz models have soldered-on 256kB caches

    +
    • + +
  • +

    PS/2 mouse & keyboard port

    +
    • + +
  • +

    memory:

    + +
      +
    • +

      bus width: 64 bits

      +
      • + +
    • +

      PS/2 style 72 pin 36 bit Fast Page Mode + SIMMs

      +
      • + +
    • +

      70ns or better

      +
      • + +
    • +

      SIMMs are installed in pairs of 2

      +
      • + +
    • +

      4 SIMM sockets

      +
      • + +
    • +

      uses ECC

      +
      • +
    +
    • + +
  • +

    2 16550A serial ports

    +
    • + +
  • +

    1 parallel port

    +
    • + +
  • +

    floppy interface

    +
    • + +
  • +

    Intel 82378ZB PCI to ISA bridge

    +
    • + +
  • +

    1 embedded 21040 based 10Mbit Ethernet, AUI and + 10base2 connector

    +
    • + +
  • +

    expansion:

    + +
      +
    • +

      1 32 bit PCI slot

      +
      • + +
    • +

      2 PCMCIA slots

      +
      • +
    +
    • + +
  • +

    on-board Crystal CS4231 or AD1848 sound chip

    +
    • + +
  • +

    embedded Fast SCSI, using a Symbios 53C810[A] + chip on the PCI riser card

    +
    • +
+ +

Multia has enough Flash ROM to store both SRM and + ARC code at the same time and allow software selection + of one of them.

+ +

The embeded TGA video adapter is not + currently usable as a FreeBSD console. You will need to + use a serial console.

+ +

Multia has only one 32 bit PCI slot for expansion, + and it is only suitable for a small form factor PCI + card. By sacrificing the PCI slot space you can mount a + 3.5" hard disk drive. Mounting stuff may have come + with your Multia. Adding a 3.5" disk is not a + recommended upgrade due to the limited power rating of + the power supply and the extremely marginal cooling of + the system box.

+ +

Multia also has 2 PCMCIA expansion slots. These are + currently not supported by FreeBSD.

+ +

The CPU might or might not be socketed, check this + before considering CPU upgrade hacks. The low-end + Multias have a soldered-in CPU.

+ +

Multia has 2 serial ports but routes both of them to + the outside world on a single 25 pin sub-D connector. + The Multia FAQ explains how to build your own Y-cable + to allow both ports to be used.

+ +

Although the Multia SRM supports booting from floppy + this can be problematic. Typically the errors look + like:

+
+*** Soft Error - Error #10 - FDC: Data overrun or underrun
+
+ +

This is not a FreeBSD problem, it is a SRM problem. + The best available workaround to install FreeBSD is to + boot from a SCSI CDROM.

+ +

There have been reports that you sometimes need to + press Control-Alt-Del to + capture the SRM's attention. I have never seen this + myself, but it is worth trying when you are greeted by + a blank screen after powerup.

+ +

Sound works fine using + pcm(4) driver + and a line in the kernel configuration file as follows + for the Crystal CS4231 chip:

+
+device pcm
+
+ +

The sound device lives at port 0x530, and uses irq 9 + along with drq 3. You also need to specify flags 0x15 + in the device.hints file.

+ +

I have not yet been successful in getting my Multia + with the AD1848 to play any sound.

+ +

While verifying playback I was reminded of the lack + of CPU power of the 166MHz CPU. MP3 only plays + acceptable using 22kHz down-sampling.

+ +

Multias are somewhat notorious for dying of heat + strokes. The very compact box does not really allow + access to cooling air. Please use the Multia on its + vertical stand, don't put it horizontally (``pizza + style''). Replacing the fan with something which pushes + around more air is really recommended. You can also cut + one of the wires to the fan speed sensor. Once cut, the + fan runs at a (loud) full speed. Beware of PCI cards + with high power consumption. If your system has died + you might want to check the Multia-Heat-Death pages at + the NetBSD Web site for help in reviving + it.

+ +

The Intel 82378ZB PCI to ISA bridge enables the use + of an IDE disk. This requires a line in the kernel + configuration file as follows:

+
+device ata
+
+ +

The ATA interface uses IRQ 14.

+ +

The IDE connector pin spacing is thought for + 2.5" laptop disks. A 3.5" IDE disk would not + fit in the case anyway. At least not without + sacrificing your only PCI slot. The SRM console + unfortunately does not know how to boot from IDE disks. + You will need to use a SCSI disk as the boot disk.

+ +

In case you want to change the internal hard drive: + the internal flat cable running from the PCI riser + board to the 2.5" hard drive has a + finer pitch than the standard SCSI flat cables. + Otherwise it would not fit on the 2.5" drives. + There are also riser cards that have a standard-pitch + SCSI cable attached to it, which will fit an ordinary + SCSI disk.

+ +

Again, I recommend against trying to cram a + replacement hard disk inside. Use the external SCSI + connector and put your disk in an external enclosure. + Multias run hot enough as-is. In most cases you will + have the external high density 50-pin SCSI connector + but some Multia models came without disk and may lack + the connector. Something to check before buying + one.

+ +

The kernel configuration file for a Multia kernel + must contain:

+
+options    DEC_AXPPCI_33
+cpu EV4
+
+ +

Recommended reading on Multia can be found at http://www.netbsd.org/Ports/alpha/multiafaq.html + or http://www.brouhaha.com/~eric/computers/udb.html.

+
+ +
+
+ +

2.3.3 + Personal Workstation (``Miata'')

+ +

The Miata is a small tower machine intended to be + put under a desk. There are multiple Miata variants. + The original Miata is the MX5 model. Because it suffers + from a number of hardware design flaws a redesign was + done, yielding the MiataGL. Unfortunately the variants + are not easily distinguishable at first sight from the + outside of the case. An easy check is to see if the + back of the machine sports two USB connectors. If yes, + it is a MiataGL. MX5 models tend to be more common in + the used system market place.

+ +

System designations look like ``Personal Workstation + 433a''. Personal Workstation, being a bit of a + mouthful, is often abbreviated to PWS. This means it + has a 433 MHz CPU, and started life as a WinNT + workstation (the trailing ``a''). Systems designated + from day 1 to run Tru64 Unix or OpenVMS will sport + ``433au''. WinNT-Miatas are likely to come + pre-configured with an IDE CDROM drive. So, in general + systems are named like PWS[433,500,600]a[u].

+ +

There was also a Miata model with a special CPU + cooling system by Kryotech. The Kryotech has a special + cooling system and is housed in a different + enclosure.

+ +

Features:

+ +
    +
  • +

    21164A EV56 Alpha CPU at 433, 500 or 600MHz

    +
    • + +
  • +

    21174 core logic (``Pyxis'') chip

    +
    • + +
  • +

    on-board Bcache / L3 cache: 0, 2 or 4 Mbytes + (uses a cache module)

    +
    • + +
  • +

    memory:

    + +
      +
    • +

      bus width: 128 bits wide, ECC protected

      +
      • + +
    • +

      unbuffered 72 bit wide SDRAMs DIMMs, + installed in pairs of 2

      +
      • + +
    • +

      6 DIMM sockets

      +
      • + +
    • +

      maximum memory 1.5 GBytes

      +
      • +
    +
    • + +
  • +

    on-board Fast Ethernet:

    + +
      +
    • +

      MX5 uses a 21142 or 21143 Ethernet chip, + dependent on the version of the PCI riser + card

      +
      • + +
    • +

      MiataGL has a 21143 chip

      +
      • + +
    • +

      the bulkhead can be 10/100 Mbit UTP, or 10 + Mbit UTP/BNC

      +
      • +
    +
    • + +
  • +

    2 on-board [E]IDE disk interfaces, based on the + CMD646 (MX5) or the Cypress 82C693 (MiataGL)

    +
    • + +
  • +

    1 Ultra-Wide SCSI Qlogic 1040 [MiataGL only]

    +
    • + +
  • +

    2 64-bit PCI slots

    +
    • + +
  • +

    3 32-bit PCI slots (behind a DEC PCI-PCI bridge + chip)

    +
    • + +
  • +

    3 ISA slots (physically shared with the 32 bit + PCI slots, via an Intel 82378IB PCI to ISA bridge + chip)

    +
    • + +
  • +

    2 16550A serial port

    +
    • + +
  • +

    1 parallel port

    +
    • + +
  • +

    PS/2 keyboard & mouse port

    +
    • + +
  • +

    USB interface [MiataGL only]

    +
    • + +
  • +

    embedded sound based on an ESS1888 chip

    +
    • +
+ +

The Miata logic is divided into two printed circuit + boards. The lower board in the bottom of the machine + has the PCI and ISA slots and things like the sound + chip etc. The top board has the CPU, the Pyxis chip, + memory etc. Note that MX5 and the MiataGL use a + different PCI riser board. This means that you cannot + just upgrade to a MiataGL CPU board (with the newer + Pyxis chip) but that you will also need a different + riser board. Apparently an MX5 riser with a MiataGL CPU + board will work but it is definitely not a supported or + tested configuration. Everything else (cabinet, wiring, + etc.) is identical for MX5 and MiataGL.

+ +

MX5 has problems with DMA via the 2 64-bit PCI slots + when this DMA crosses a page boundary. The 32 bit slots + don't have this problem because the PCI-PCI bridge chip + does not allow the offending transfers. The SRM code + knows about the problem and refuses to start the system + if there is a PCI card in one of the 64bit slots that + it does not know about. Cards that are ``known good'' + to the SRM are allowed to be used in the 64bit + slots.

+ +

If you want to fool the SRM you can type set pci_device_override + at the SRM prompt. Just don't complain if your data + mysteriously gets mangled.

+ +

The complete command is:

+
+>>> SET PCI_DEVICE_OVERRIDE <vendor_id><device_id>
+
+ +

For example:

+
+>>> SET PCI_DEVICE_OVERRIDE 88c15333
+
+ +

The most radical approach is to use:

+
+>>> SET PCI_DEVICE_OVERRIDE -1
+
+ +

This disables PCI ID checking altogether, so that + you can install any PCI card without its ID getting + checked. For this to work you need a reasonable current + SRM version.

+ +
+
+

Important: Do this on your own risk..

+
+
+ +

The FreeBSD kernel reports it when it sees a buggy + Pyxis chip:

+
+Sep 16 18:39:43 miata /kernel: cia0: Pyxis, pass 1
+Sep 16 18:39:43 miata /kernel: cia0: extended capabilities: 1<BWEN>
+Sep 16 18:39:43 miata /kernel: cia0: WARNING: Pyxis pass 1 DMA bug; no bets...
+
+ +

A MiataGL probes as:

+
+Jan  3 12:22:32 miata /kernel: cia0: Pyxis, pass 1
+Jan  3 12:22:32 miata /kernel: cia0: extended capabilities: 1<BWEN>
+Jan  3 12:22:32 miata /kernel: pcib0: <2117x PCI host bus adapter> on cia0
+
+ +

MiataGL does not have the DMA problems of the MX5. + PCI cards that make the MX5 SRM choke when installed in + the 64bit slots are accepted without problems by the + MiataGL SRM.

+ +

The latest mainboard revisions of MX5 contain a + hardware workaround for the bug. The SRM does not know + about the ECO and will complain about unknown cards as + before. So does the FreeBSD kernel by the way.

+ +

The Miata SRM can boot from IDE CDROM drives. IDE + hard disk boot is known to work for both MiataGL and + MX5 disks, so you can root FreeBSD from an IDE disk. + Speeds on MX5 are around 14 Mbytes/sec assuming a + suitable drive. Miata's CMD646 chip will support up to + WDMA2 mode as the chip is too buggy for use with + UDMA.

+ +

Miata MX5s generally use Qlogic 1040 based SCSI + adapters. These are bootable by the SRM console. Note + that Adaptec cards are not bootable by the Miata + SRM console.

+ +

The MiataGL has a faster PCI-PCI bridge chip on the + PCI riser card than some of the MX5 riser card + versions. Some of the MX5 risers have the same + chip as the MiataGL. All in all there is a lot of + variation.

+ +

Not all VGA cards will work behind the PCI-PCI + bridge. This manifests itself as no video at all. + Workaround is to put the VGA card ``before'' the + bridge, in one of the 64 bit PCI slots. Graphics + performance using a 64 bit slot is generally + substantially better.

+ +

Both MX5 and MiataGL have an on-board sound chip, an + ESS1888. It emulates a SoundBlaster and can be enabled + by putting

+
+device pcm
+device  sbc
+
+ +

in your kernel configuration file:

+ +

in case your Miata has the optional cache board + installed make sure it is firmly seated. A slightly + loose cache has been observed to cause weird crashes + (not surprising obviously, but maybe not so obvious + when troubleshooting). The cache module is identical + between MX5 and MiataGL.

+ +

Installing a 2Mb cache module achieves, apart from a + 10-15% speed increase (based on buildworld elapsed + time), a decrease for PCI DMA read + bandwidth from 64bit PCI cards. A benchmark on a 64-bit + Myrinet card resulted in a decrease from 149 Mbytes/sec + to 115 Mbytes/sec. Something to keep in mind when doing + really high speed things with 64 bit PCI adapters.

+ +

Although the hardware allows you to install up to + 1.5Gbyte of memory, FreeBSD is limited to 1Gbyte + because the DMA code does not correctly handle memory + above 1Gbyte.

+ +

Moving to a faster CPU is quite simple, swap out the + CPU chip and set the clock multiplier dipswitch to the + speed of the new CPU.

+ +

If you experience SRM errors like

+
+ERROR: scancode 0xa3 not supported on PCXAL
+
+ +

after halting FreeBSD you should update your SRM + firmware to V7.2-1 or later. This SRM version is first + available on the Firmware Update CD V5.7, or on http://www.compaq.com/ This SRM + problem is fixed on both Miata MX5 and Miata GL.

+ +

USB is supported by FreeBSD 4.1 and later.

+ +

Disconnect the power cord before dismantling the + machine, the soft-power switch keeps part of the logic + powered even when the machine is + switched off.

+ +

The kernel configuration file for a Miata kernel + must contain:

+
+options    DEC_ST550               
+cpu EV5
+
+
+ +
+
+ +

2.3.4 + Evaluation Board 64 family

+ +

In its attempts to popularize the Alpha CPU DEC + produced a number of so called Evaluation Boards. + Members of this family are EB64, EB64+, AlphaPC64 + (codename ``Cabriolet''). A non-DEC member of this + family is the Aspen Alpine. The EB64 family of + evaluation boards has the following feature set:

+ +
    +
  • +

    21064 or 21064A CPU, 150 to 275 MHz

    +
    • + +
  • +

    memory:

    + +
      +
    • +

      memory buswidth: 128 bit

      +
      • + +
    • +

      PS/2 style 72 pin 33 bit Fast Page Mode + SIMMs

      +
      • + +
    • +

      70ns or better

      +
      • + +
    • +

      installed in sets of 4

      +
      • + +
    • +

      8 SIMM sockets

      +
      • + +
    • +

      uses parity memory

      +
      • +
    +
    • + +
  • +

    Bcache / L2 cache: 0, 512 kByte, 1 Mbyte or 2 + Mbytes

    +
    • + +
  • +

    21072 (``APECS'') chip set

    +
    • + +
  • +

    Intel 82378ZB PCI to ISA bridge chip + (``Saturn'')

    +
    • + +
  • +

    dual 16550A serial ports

    +
    • + +
  • +

    parallel printer port

    +
    • + +
  • +

    Symbios 53C810 Fast-SCSI (not on AlphaPC64)

    +
    • + +
  • +

    IDE interface (only on AlphaPC64)

    +
    • + +
  • +

    embedded 10 Mbit Ethernet (not on AlphaPC64)

    +
    • + +
  • +

    2 PCI slots (4 slots on AlphaPC64)

    +
    • + +
  • +

    3 ISA slots

    +
    • +
+ +

Aspen Alpine is slightly different, but is close + enough to the EB64+ to run an EB64+ SRM EPROM (mine + did..). The Aspen Alpine does not have an embedded + Ethernet, has 3 instead of 2 PCI slots. It comes with 2 + Mbytes of cache already soldered onto the mainboard. It + has jumpers to select the use of 60, 70 or 80ns SIMM + speeds.

+ +

36 bits SIMMs work fine, 3 bits simply remain + unused. Note the systems use Fast Page Mode memory, not + EDO memory.

+ +

The EB64+ SRM console code is housed in an + UV-erasable EPROM. No easy flash SRM upgrades for the + EB64+ The latest SRM version available for EB64+ is + quite ancient anyway.

+ +

The EB64+ SRM can boot both 53C810 and Qlogic1040 + SCSI adapters. Pitfall for the Qlogic is that the + firmware that is down-loaded by the SRM onto the Qlogic + chip is very old. There are no updates for the EB64+ + SRM available. So you are stuck with old Qlogic bits + too. I have had quite some problems when I wanted to + use Ultra-SCSI drives on the Alpine with Qlogic. The + FreeBSD kernel can be compiled to include a much newer + Qlogic firmware revision. This is not the default + because it adds hundreds of kBytes worth of bloat to + the kernel. In FreeBSD 4.1 and later the isp firmware + is contained in a kernel loadable module. All of this + might mean that you need to use a non-Qlogic adapter to + boot from.

+ +

AlphaPC64 boards generally come with ARC console + firmware. SRM console code can be loaded from floppy + into the Flash ROM.

+ +

The IDE interface of the AlphaPC64 is not bootable + from the SRM console. Enabling it requires the + following line in the kernel configuration file:

+
+device ata
+
+ +

The ATA interface uses irq 14.

+ +

Note that the boards require a power supply that + supplies 3.3 Volts for the CPU.

+ +

For the EB64 family machines the kernel config file + must contain:

+
+options    DEC_EB64PLUS            
+cpu EV4
+
+
+ +
+
+ +

2.3.5 + Evaluation Board 164 (``EB164, PC164, PC164LX, + PC164SX'') family

+ +

EB164 is a newer design evaluation board, based on + the 21164A CPU. This design has been used to ``spin + off'' multiple variations, some of which are used by + OEM manufacturers/assembly shops. Samsung did its own + PC164LX which has only 32 bit PCI, whereas the Digital + variant has 64 bit PCI.

+ +
    +
  • +

    21164A, multiple speed variants [EB164, PC164, + PC164LX]

    +
    • + +
  • +

    21164PC [only on PC164SX]

    +
    • + +
  • +

    21171 (Alcor) chip set [EB164]

    + +

    21172 (Alcor2) chip set [PC164]

    + +

    21174 (Pyxis) chip [164LX, 164SX]

    +
    • + +
  • +

    Bcache / L3 cache: EB164 uses special + cache-SIMMs

    +
    • + +
  • +

    memory bus: 128 bit / 256 bit

    +
    • + +
  • +

    memory:

    + +
      +
    • +

      PS/2 style SIMMs in sets of 4 or 8

      +
      • + +
    • +

      36 bit, Fast Page Mode, uses ECC, [EB164 / + PC164]

      +
      • + +
    • +

      SDRAM DIMMs in sets of 2, uses ECC [PC164SX + / PC164LX]

      +
      • +
    +
    • + +
  • +

    2 16550A serial ports

    +
    • + +
  • +

    PS/2 style keyboard & mouse

    +
    • + +
  • +

    floppy controller

    +
    • + +
  • +

    parallel port

    +
    • + +
  • +

    32 bits PCI

    +
    • + +
  • +

    64 bits PCI [some models]

    +
    • + +
  • +

    ISA slots via an Intel 82378ZB PCI to ISA bridge + chip

    +
    • +
+ +

Using 8 SIMMs for a 256bit wide memory can yield + interesting speedups over a 4 SIMM/128bit wide memory. + Obviously all 8 SIMMs must be of the same type to make + this work. The system must be explicitly setup to use + the 8 SIMM memory arrangement. You must have 8 SIMMs, 4 + SIMMs distributed over 2 banks will not work. For the + AlphaPC164 you can have a maximum of 1Gbyte of RAM, + using 8 128Mbyte SIMMs. The manual indicates the + maximum is 512 Mbyte.

+ +

The SRM can boot from Qlogic 10xx boards or the + Symbios 53C810[A]. Newer Symbios 810 revisions like the + Symbios 810AE are not recognized by the SRM on PC164. + PC164 SRM does not appear to recognize a Symbios 53C895 + based host adapter (tested with a Tekram DC-390U2W). On + the other hand some no-name Symbios 53C985 board has + been reported to work. Cards like the Tekram DC-390F + (Symbios875 based) have been confirmed to work fine on + the PC164. Unfortunately this seems to be dependent on + the actual version of the chip/board.

+ +

Symbios 53C825[a] will also work as boot adapter. + Diamond FirePort, although based on Symbios chips, is + not bootable by the PC164SX SRM. PC164SX is reported to + boot fine with Symbios825, Symbios875, Symbios895 and + Symbios876 based cards. In addition, Adaptec 2940U and + 2940UW are reported to work for booting (verified on + SRM V5.7-1). Adaptec 2930U2 and 2940U2[W] do not + work.

+ +

164LX and 164SX with SRM firmware version 5.8 or + later can boot from Adaptec 2940-series adapters.

+ +

In summary: this family of machines is ``blessed'' + with a challenging compatibility as far as SCSI + adapters go.

+ +

On 164SX you can have a maximum of 1 Gbyte of RAM. 4 + regular 256MB PC133 ECC DIMMs are reported to work just + fine. Whether 512MB DIMMs will also work is currently + unknown.

+ +

PCI bridge chips are sometimes not appreciated by + the 164SX, they cause SRM errors and kernel panics in + those cases. This seems to depend on the fact if the + card is recognised, and therefore correctly + initialised, by the SRM console. The 164SX' onboard IDE + interface is quite slow, a Promise card gives a 3-4 + times speed improvement.

+ +

On PC164 the SRM sometimes seems to lose its + variable settings. ``For PC164, current superstition + says that, to avoid losing settings, you want to first + downgrade to SRM 4.x and then upgrade to 5.x.'' One + sample error that was observed was:

+
+ERROR: ISA table corrupt!
+
+ +

A sequence of a downgrade to SRM4.9, an

+
+>>> ISACFG -INIT
+
+ +

followed by

+
+>>> INIT
+
+ +

made the problem go away. Some PC164 owners report + they have never seen the problem.

+ +

On PC164SX the AlphaBIOS allows you a selection to + select SRM to be used as console on the next power up. + This selection does not appear to have any effect. In + other words, you will get the AlphaBIOS regardless of + what you select. The fix is to reflash the console ROM + with the SRM code for PC164SX. This will overwrite the + AlphaBIOS and will get you the SRM console you desire. + The SRM code can be found on the Compaq Web site.

+ +

164LX can either have the SRM console code or the + AlphaBIOS code in its flash ROM because the flash ROM + is too small to hold both at the same time.

+ +

PC164 can boot from IDE disks assuming your SRM + version is recent enough.

+ +

EB164 needs a power supply that supplies 3.3 Volts. + PC164 does not implement the PS_ON signal that ATX + power supplies need to switch on. A simple switch + pulling this signal to ground allows you to run a + standard ATX power supply.

+ +

For the EB164 class machines the kernel config file + must contain:

+
+options         DEC_EB164
+cpu             EV5
+
+
+ +
+
+ +

2.3.6 + AlphaStation 200 (``Mustang'') and 400 (``Avanti'') + series

+ +

The Digital AlphaStation 200 and 400 series systems + are early low end PCI based workstations. The 200 and + 250 series are desktop boxes, the 400 series is a + desk-side mini-tower.

+ +

Features:

+ +
    +
  • +

    21064 or 21064A CPU at speeds of 166 up to 333 + MHz

    +
    • + +
  • +

    DECchip 21071-AA core logic chip set

    +
    • + +
  • +

    Bcache / L2 cache: 512 Kbytes (200 and 400 + series) or 2048KBytes (250 series)

    +
    • + +
  • +

    memory:

    + +
      +
    • +

      64 bit bus width

      +
      • + +
    • +

      8 to 384 MBytes of RAM

      +
      • + +
    • +

      70 ns or better Fast Page DRAM

      +
      • + +
    • +

      in three pairs (200 and 400 series)

      +
      • + +
    • +

      in two quads, so banks of four. (250 + series)

      +
      • + +
    • +

      the memory subsystem uses parity

      +
      • +
    +
    • + +
  • +

    PS/2 keyboard and mouse port

    +
    • + +
  • +

    two 16550 serial ports

    +
    • + +
  • +

    parallel port

    +
    • + +
  • +

    floppy disk interface

    +
    • + +
  • +

    32 bit PCI expansion slots (3 for the + AS400-series, 2 for the AS200 & 250-series)

    +
    • + +
  • +

    ISA expansion slots (4 for the AS400-series, 2 + for the AS200 & 250-series) (some ISA/PCI slots + are physically shared)

    +
    • + +
  • +

    embedded 21040-based Ethernet (200 & 250 + series)

    +
    • + +
  • +

    embedded Symbios 53c810 Fast SCSI-2 chip

    +
    • + +
  • +

    Intel 82378IB (``Saturn'') PCI-ISA bridge + chip

    +
    • + +
  • +

    graphics is embedded TGA or PCI VGA (model + dependent)

    +
    • + +
  • +

    16 bit sound (on 200 & 250 series)

    +
    • +
+ +

The systems use parity memory SIMMs, but these do + not need 36 bit wide SIMMs. 33 bit wide SIMMs are + sufficient, 36 bit SIMMs are acceptable too. EDO or 32 + bit SIMMs will not work. 4, 8, 16, 32 and 64 Mbyte + SIMMs are supported.

+ +

The AS200 & AS250 sound hardware is reported to + work OK assuming you have the following line in your + kernel config file:

+
+device pcm
+
+ +

The sound device uses port 0x530, IRQ 10 and drq 0. + You also need to specify flags 0x10011 in the device.hints file.

+ +

AlphaStation 200 & 250 series have an automatic + SCSI terminator. This means that as soon as you plug a + cable onto the external SCSI connector the internal + terminator of the system is disabled. It also means + that you should not leave unterminated cables plugged + into the machine.

+ +

AlphaStation 400 series have an SRM variable that + controls termination. In case you have external SCSI + devices connected you must set this SRM variable + using

+
+>>> SET CONTROL_SCSI_TERM EXTERNAL.
+
+ +

If only internal SCSI devices are present use:

+
+>>> SET CONTROL_SCSI_TERM INTERNAL
+
+ +

For the AlphaStation-[24][05]00 machines the kernel + config file must contain:

+
+options    DEC_2100_A50
+cpu EV4
+
+
+ +
+
+ +

2.3.7 + AlphaStation 500 and 600 (``Alcor'' & ``Maverick'' + for EV5, ``Bret'' for EV56)

+ +

AS500 and 600 were the high-end EV5 / PCI based + workstations. EV6 based machines have in the meantime + taken their place as front runners. AS500 is a desktop + in a dark blue case (TopGun blue), AS600 is a sturdy + desk-side box. AS600 has a nice LCD panel to observe + the early stages of SRM startup.

+ +

Features:

+ +
    +
  • +

    21164 EV5 CPU at 266, 300, 333, 366, 400, 433, + 466, or 500 MHz (AS500) or at 266, 300 or 333 MHz + (AS600)

    +
    • + +
  • +

    21171 (Alcor) or 21172 (Alcor2) core logic chip + set

    +
    • + +
  • +

    Cache:

    + +
      +
    • +

      2 or 4 Mb L3 / Bcache (AS600 at 266 MHz)

      +
      • + +
    • +

      4 Mb L3 / Bcache (AS600 at 300 MHz)

      +
      • + +
    • +

      2 or 8 Mb L3 / Bcache (8 Mb on 500 MHz + version only)

      +
      • + +
    • +

      2 to 16 Mb L3 / Bcache (AS600; 3 cache-SIMM + slots)

      +
      • +
    +
    • + +
  • +

    memory buswidth: 256 bits

    +
    • + +
  • +

    AS500 memory:

    + +
      +
    • +

      industry standard 72 bit wide buffered Fast + Page Mode DIMMs

      +
      • + +
    • +

      8 DIMM slots

      +
      • + +
    • +

      installed in sets of 4

      +
      • + +
    • +

      maximum memory is 1 GB (512 Mb max on 333 + MHz CPUs)

      +
      • + +
    • +

      uses ECC

      +
      • +
    +
    • + +
  • +

    AS600 memory:

    + +
      +
    • +

      industry standard 36 bit Fast Page Mode + SIMMs

      +
      • + +
    • +

      32 SIMM slots

      +
      • + +
    • +

      installed in sets of 8

      +
      • + +
    • +

      maximum memory is 1 GB

      +
      • + +
    • +

      uses ECC

      +
      • +
    +
    • + +
  • +

    Qlogic 1020 based wide SCSI bus (1 bus/chip for + AS500, 2 buses/chip for AS600)

    +
    • + +
  • +

    21040 based 10 Mbit Ethernet adapter, both + Thinwire and UTP connectors

    +
    • + +
  • +

    expansion:

    + +
      +
    • +

      AS500:

      + +
        +
      • +

        3 32-bit PCI slots

        +
        • + +
      • +

        1 64-bit PCI slot

        +
        • +
      +
      • + +
    • +

      AS600:

      + +
        +
      • +

        2 32-bit PCI slot

        +
        • + +
      • +

        3 64-bit PCI slots

        +
        • + +
      • +

        1 PCI/EISA physically shared slot

        +
        • + +
      • +

        3 EISA slots

        +
        • + +
      • +

        1 PCI and 1 EISA slot are occupied by + default

        +
        • +
      +
      • +
    +
    • + +
  • +

    21050 PCI-to-PCI bridge chip

    +
    • + +
  • +

    Intel 82375EB PCI-EISA bridge (AS600 only)

    +
    • + +
  • +

    2 16550A serial ports

    +
    • + +
  • +

    1 parallel port

    +
    • + +
  • +

    16 bit audio Windows Sound System, in a + dedicated slot (AS500) in EISA slot (AS600, this is + an ISA card)

    +
    • + +
  • +

    PS/2 keyboard and mouse port

    +
    • +
+ +

Early machines had Fast SCSI interfaces, later ones + are Ultra SCSI capable. AS500 shares its single SCSI + bus with internal and external devices. For a Fast SCSI + bus you are limited to 1.8 meters bus length external + to the box. The AS500 Qlogic ISP1020A chip can be set + to run in Ultra mode by setting a SRM variable. FreeBSD + however follows the Qlogic chip errata and limits the + bus speed to Fast.

+ +

Beware of ancient SRM versions on AS500. When you + see weird SCSI speeds being reported by FreeBSD + like

+
+cd0 at isp0 bus 0 target 4 lun 0
+cd0: <DEC RRD45   DEC 0436> Removable CD-ROM SCSI-2 device
+cd0: 250.000MB/s transfers (250.000MHz, offset 12)
+
+ +

it is time to do a SRM console firmware upgrade.

+ +

AS600 has one Qlogic SCSI chip dedicated to the + internal devices whereas the other Qlogic SCSI chip is + dedicated to external SCSI devices.

+ +

In AS500 DIMMs are installed in sets of 4, in + ``physically interleaved'' layout. So, a bank of 4 + DIMMs is not 4 physically adjacent + DIMMs. Note that the DIMMs are not + SDRAM DIMMs.

+ +

In AS600 the memory SIMMs are placed onto two memory + daughter cards. SIMMs are installed in sets of 8. Both + memory daughter cards must be populated + identically.

+ +

Note that both AS500 and AS600 are EISA machines. + This means you have to run the EISA Configuration + Utility (ECU) from floppy after adding EISA cards or to + change things like the configuration settings of the + onboard I/O. For AS500 which does not have a physical + EISA slot the ECU is used to configure the onboard + sound interface etc.

+ +

AS500 onboard sound can be used by adding a line + like

+
+device pcm
+
+ +

to the kernel configuration file.

+ +

Using the ECU I configured my AS500 to use IRQ 10, + port 0x530, drq 0. Corresponding entries along with + flags 0x10011 must go into the device.hints file. Note that the + flags value is rather non-standard.

+ +

AS600 has a peculiarity for its PCI slots. AS600 (or + rather the PCI expansion card containing the SCSI + adapters) does not allow I/O port mapping, therefore + all devices behind it must use memory mapping. If you + have problems getting the Qlogic SCSI adapters to work, + add the following option to /boot/loader.rc:

+
+set isp_mem_map=0xff
+
+ +

This may need to be typed at the boot loader prompt + before booting the installation kernel.

+ +

For the AlphaStation-[56]00 machines the kernel + config file must contain:

+
+options    DEC_KN20AA 
+cpu EV5
+
+
+ +
+
+ +

2.3.8 + AlphaServer 1000 (``Mikasa''), 1000A (``Noritake'') and + 800(``Corelle'')

+ +

The AlphaServer 1000 and 800 range of machines are + intended as departmental servers. They come in quite + some variations in packaging and mainboard/cpu. + Generally speaking there are 21064 (EV4) CPU based + machines and 21164 (EV5) based ones. The CPU is on a + daughter card, and the type of CPU (EV4 or EV5) must + match the mainboard in use.

+ +

AlphaServer 800 has a much smaller mini tower case, + it lacks the StorageWorks SCSI hot-plug chassis. The + main difference between AS1000 and AS1000A is that + AS1000A has 7 PCI slots whereas AS1000 only has 3 PCI + slots and has EISA slots instead.

+ +

AS800 with an EV5/400 MHz CPU was later re-branded + to become a ``DIGITAL Server 3300[R]'', AS800 with an + EV5/500 MHz CPU was later re-branded to become a + ``DIGITAL Server 3305[R]''.

+ +

Features:

+ +
    +
  • +

    21064 EV4[5] CPU at 200, 233 or 266 MHz 21164 + EV5[6] CPU at 300, 333 or 400 MHz (or 500 MHz for + AS800 only)

    +
    • + +
  • +

    memory:

    + +
      +
    • +

      buswidth: 128 bit with ECC

      +
      • + +
    • +

      AS1000[A]:

      + +
        +
      • +

        72pin 36 bit Fast Page Mode SIMMs, 70ns + or better

        +
        • + +
      • +

        16 (EV5 machines) or 20 (EV4 machines) + SIMM slots

        +
        • + +
      • +

        max memory is 1 GB

        +
        • + +
      • +

        uses ECC

        +
        • +
      +
      • + +
    • +

      AS800: Uses 60ns 3.3 Volts EDO DIMMs

      +
      • +
    +
    • + +
  • +

    embedded VGA (on some mainboard models)

    +
    • + +
  • +

    3 PCI, 2 EISA, 1 64-bit PCI/EISA combo + (AS800)

    +
    • + +
  • +

    7 PCI, 2 EISA (AS1000A)

    +
    • + +
  • +

    2 PCI, 1 EISA/PCI, 7 EISA (AS1000)

    +
    • + +
  • +

    embedded SCSI based on Symbios 810 [AS1000] or + Qlogic 1020 [AS1000A]

    +
    • +
+ +

AS1000 based machines come in multiple enclosure + types. Floor standing, rack-mount, with or without + StorageWorks SCSI chassis etc. The electronics are the + same.

+ +

AS1000-systems: All EV4 based machines use standard + PS/2 style 36 bit 72pin SIMMs in sets of 5. The fifth + SIMM is used for ECC. All EV5 based machines use + standard PS/2 style 36 bit 72pin SIMMs in sets of 4. + The ECC is done based on the 4 extra bits per SIMM (4 + bits out of 36). The EV5 mainboards have 16 SIMM slots, + the EV4 mainboards have 20 slots.

+ +

AS800 machines use DIMMs in sets of 4. DIMM + installation must start in slots marked bank 0. A bank + is four physically adjacent slots. The biggest size + DIMMs must be installed in bank 0 in case 2 banks of + different DIMM sizes are used. Max memory size is 2GB. + Note that these are EDO DIMMs.

+ +

The AS1000/800 are somewhat stubborn when it comes + to serial consoles. They need

+
+>>> SET CONSOLE SERIAL
+
+ +

before they go for a serial console. Pulling the + keyboard from the machine is not sufficient, like it is + on most other Alpha models. Going back to a graphical + console needs

+
+>>> SET CONSOLE GRAPHICS
+
+ +

at the serial console.

+ +

For AS800 you want to check if your Ultra-Wide SCSI + is indeed in Ultra mode. This can be done using the EEROMCFG.EXE utility that is on + the Console Firmware Upgrade CDROM.

+ +

For the AlphaServer1000/1000A/800 machines the + kernel config file must contain:

+
+options    DEC_1000A
+cpu EV4     # depends on the CPU model installed
+cpu EV5     # depends on the CPU model installed
+
+
+ +
+
+ +

2.3.9 + DS10/VS10/XP900 (``Webbrick'') / XP1000 (``Monet'') / + DS10L (``Slate'')

+ +

Webbrick and Monet are high performance + workstations/servers based on the EV6 CPU and the + Tsunami chipset. Tsunami is also used in much + higher-end systems and as such has plenty of + performance to offer. DS10, VS10 and XP900 are + different names for essentially the same system. The + differences are the software and options that are + supported. DS10L is a DS10 based machine in a 1U high + rackmount enclosure. DS10L is intended for ISPs and for + HPTC clusters (e.g. Beowulf)

+ +
+
+ +

2.3.9.1 ``Webbrick / Slate''

+ +
    +
  • +

    21264 EV6 CPU at 466 MHz

    +
    • + +
  • +

    L2 / Bcache: 2MB, ECC protected

    +
    • + +
  • +

    memory bus: 128 bit via crossbar, 1.3GB/sec + memory bandwidth

    +
    • + +
  • +

    memory:

    + +
      +
    • +

      industry standard 200 pin 83 MHz buffered + ECC SDRAM DIMMs

      +
      • + +
    • +

      4 DIMM slots for DS10; 2GB max memory

      +
      • + +
    • +

      2 DIMM slots for DS10L; 1GB max memory

      +
      • + +
    • +

      DIMMs are installed in pairs of 2

      +
      • +
    +
    • + +
  • +

    21271 Core Logic chipset (``Tsunami'')

    +
    • + +
  • +

    2 on-board 21143 Fast Ethernet controllers

    +
    • + +
  • +

    AcerLabs M5237 (Aladdin-V) USB controller + (disabled)

    +
    • + +
  • +

    AcerLabs M1533 PCI-ISA bridge

    +
    • + +
  • +

    AcerLabs Aladdin ATA-33 controller

    +
    • + +
  • +

    embedded dual EIDE

    +
    • + +
  • +

    expansion: 3 64-bit PCI slots and 1 32-bit PCI + slot. DS10L has a single 64bit PCI slot

    +
    • + +
  • +

    2 16550A serial ports

    +
    • + +
  • +

    1 parallel port

    +
    • + +
  • +

    2 USB

    +
    • + +
  • +

    PS/2 keyboard & mouse port

    +
    • +
+ +

The system has a smart power controller. This + means that parts of the system remain powered when it + is switched off (like an ATX-style PC power supply). + Before servicing the machine remove the power + cord.

+ +

The smart power controller is called the RMC. When + enabled, typing EscapeEscapeRMC on serial port 1 will + bring you to the RMC prompt. RMC allows you to + powerup or powerdown, reset the machine, monitor and + set temperature trip levels etc. RMC has its own + builtin help.

+ +

Webbrick is shipped in a desktop-style case + similar to the older 21164 ``Maverick'' workstations + but this case offers much better access to the + components. If you intend to build a farm you can + rackmount them in a 19-inch rack; they are 3U high. + Slate is 1U high but has only one PCI slot.

+ +

DS10 has 4 DIMM slots. DIMMs are installed as + pairs. Please note that DIMM pairs are not installed + in adjacent DIMM sockets but rather physically + interleaved. DIMM sizes of 32, 64, 128, 256 and 512 + Mbytes are supported.

+ +

When 2 pairs of identical-sized DIMMs are + installed DS10 will use memory interleaving for + increased performance. DS10L, which has only 2 DIMM + slots cannot do interleaving.

+ +

Starting with SRM firmware version 5.9 you can + boot from Adaptec 2940-series adapters in addition to + the usual set of Qlogic and Symbios/NCR adapters.

+ +

The base model comes with a FUJITSU 9.5GB ATA disk + as its boot device. FreeBSD works just fine using + EIDE disks on Webbrick. DS10 has 2 IDE interfaces on + the mainboard. Machines destined for Tru64 Unix or + VMS are standard equipped with Qlogic-driven + Ultra-SCSI disks

+ +

On the PCI bus 32 and 64 bit cards are supported, + in 3.3V and 5V variants.

+ +

The USB ports are not supported and are disabled + by the SRM console in all recent SRM versions.

+ +

The kernel config file must contain:

+
+options    DEC_ST6600    
+cpu EV5
+
+ +
+
+

Note: Contrary to expectation there is + no cpu EV6 defined for + inclusion in the kernel config file. The cpu EV5 is mandatory to keep + + config(8) + happy.

+
+
+
+ +
+
+ +

2.3.9.2 ``Monet''

+ +
    +
  • +

    21264 EV6 at 500 MHz 21264 EV67 at 500 or 667 + MHz (XP1000G, codenamed Brisbane) CPU is mounted + on a daughter-card which is field-upgradable

    +
    • + +
  • +

    L2 / Bcache: 4MB, ECC protected

    +
    • + +
  • +

    memory bus: 256 bit

    +
    • + +
  • +

    memory: 128 or 256 Mbytes 100 MHz (PC100) 168 + pin JEDEC standard, registered ECC SDRAM + DIMMs

    +
    • + +
  • +

    21271 core logic chip set (``Tsunami'')

    +
    • + +
  • +

    1 on-board 21143 Ethernet controller

    +
    • + +
  • +

    Cypress 82C693 USB controller

    +
    • + +
  • +

    Cypress 82C693 PCI-ISA bridge

    +
    • + +
  • +

    Cypress 82C693 controller

    +
    • + +
  • +

    expansion: 2 independent PCI buses, driven by + high-speed I/O channels called ``hoses'':

    + +
      +
    • +

      hose 0: (the upper 3 slots) 2 64-bit PCI + slots 1 32-bit PCI slot

      +
      • + +
    • +

      hose 1: (the bottom 2 slots) 2 32-bit PCI + slots (behind a 21154 PCI-PCI bridge)

      +
      • + +
    • +

      2 of the 64-bit PCI slots are for + full-length cards

      +
      • + +
    • +

      all of the 32-bit PCI slots are for short + cards

      +
      • + +
    • +

      1 of the 32-bit PCI slots is physically + shared with an ISA slot

      +
      • + +
    • +

      all PCI slots run at 33MHz

      +
      • +
    +
    • + +
  • +

    1 Ultra-Wide SCSI port based on a Qlogic 1040 + chip

    +
    • + +
  • +

    2 16550A serial port

    +
    • + +
  • +

    1 parallel port

    +
    • + +
  • +

    PS/2 keyboard & mouse port

    +
    • + +
  • +

    embedded 16-bit ESS ES1888 sound chip

    +
    • + +
  • +

    2 USB ports

    +
    • + +
  • +

    graphics options: ELSA Gloria Synergy or + DEC/Compaq PowerStorm 3D accelerator cards

    +
    • +
+ +

Monet is housed in a mini-tower like enclosure + quite similar to the Miata box.

+ +

The on-board Qlogic UW-SCSI chip supports up to 4 + internal devices. There is no external connector for + the on-board SCSI.

+ +

For 500 MHz CPUs 83 MHz DIMMs will do. Compaq + specifies PC100 DIMMs for all CPU speeds. DIMMs are + installed in sets of 4, starting with the DIMM slots + marked ``0'' Memory capacity is max 4 GB. DIMMs are + installed ``physically interleaved'', note the + markings of the slots. Memory bandwidth of Monet is + twice that of Webbrick. The DIMMs live on the CPU + daughter-card. Note that the system uses ECC RAM so + you need DIMMs with 72 bits (not the generic PC-class + 64 bit DIMMs)

+ +

The EIDE interface is usable / SRM bootable so + FreeBSD can be rooted on an EIDE disk. Although the + Cypress chip has potential for 2 EIDE channels Monet + uses only one of them.

+ +

The USB interface is supported by FreeBSD.If you + experience problems trying to use the USB interface + please check if the SRM variable usb_enable is set to on. You can change this by + performing:

+
+>>> SET USB_ENABLE ON
+
+ +
+
+

Important: Don"t try to use + Symbios-chip based SCSI adapters in the PCI slots + connected to hose 1. There is a not-yet-found + FreeBSD bug that prevents this from working + correctly.

+
+
+ +
+
+

Important: Not all VGA cards will work + behind the PCI-PCI bridge (so in slots 4 and 5). + Only cards that implement VGA-legacy addressing + correctly will work. Workaround is to put the VGA + card ``before'' the bridge.

+
+
+ +

The sound chip is not currently supported with + FreeBSD.

+ +

The kernel config file must contain:

+
+options    DEC_ST6600    
+cpu EV5
+
+ +
+
+

Note: Contrary to expectation there is + no cpu EV6 defined for + inclusion in the kernel config file. The cpu EV5 is mandatory to keep + + config(8) + happy.

+
+
+
+
+ +
+
+ +

2.3.10 + DS20/DS20E (``Goldrush'')

+ +

Features:

+ +
    +
  • +

    21264 EV6 CPU at 500 or 670 MHz

    +
    • + +
  • +

    dual CPU capable machine

    +
    • + +
  • +

    L2 / Bcache: 4 Mbytes per CPU

    +
    • + +
  • +

    memory bus: dual 256 bit wide with crossbar + switch

    +
    • + +
  • +

    memory:

    + +
      +
    • +

      SDRAM DIMMs

      +
      • + +
    • +

      installed in sets of 4

      +
      • + +
    • +

      16 DIMM slots, max. 4GB

      +
      • + +
    • +

      uses ECC

      +
      • +
    +
    • + +
  • +

    21271 core logic chip set (``Tsunami'')

    +
    • + +
  • +

    embedded Adaptec ? Wide Ultra SCSI

    +
    • + +
  • +

    expansion:

    + +
      +
    • +

      2 independent PCI buses, driven by + high-speed I/O channels called ``hoses''

      +
      • + +
    • +

      6 64-bit PCI slots, 3 per hose

      +
      • + +
    • +

      1 ISA slot

      +
      • +
    +
    • +
+ +

DS20 needs

+
+>>> SET CONSOLE SERIAL
+
+ +

before it goes for a serial console. Pulling the + keyboard from the machine is not sufficient. Going back + to a graphical console needs

+
+>>> SET CONSOLE GRAPHICS
+
+ +

at the serial console. Confusing is the fact that + you will get SRM console output on the graphics console + with the console set to serial, but when FreeBSD boots + it honors the CONSOLE variable + setting and all the boot messages as well as the login + prompt will go to the serial port.

+ +

The DS20 is housed in a fat cube-like enclosure. The + enclosure also contains a StorageWorks SCSI hot-swap + shelf for a maximum of seven 3.5" SCSI devices. + The DS20E is in a sleeker case, and lacks the + StorageWorks shelf.

+ +

The system has a smart power controller. This means + that parts of the system remain powered when it is + switched off (like an ATX-style PC power supply). + Before servicing the machine remove the power + cord(s).

+ +

The smart power controller is called the RMC. When + enabled, typing EscapeEscapeRMC on serial port 1 will + bring you to the RMC prompt. RMC allows you to powerup + or powerdown, reset the machine, monitor and set + temperature trip levels etc. RMC has its own builtin + help.

+ +

The embedded Adaptec SCSI chip on the DS20 is + disabled and is therefore not usable under FreeBSD.

+ +

Starting with SRM firmware version 5.9 you can boot + from Adaptec 2940-series adapters in addition to the + usual set of Qlogic and Symbios/NCR adapters. This + unfortunately does not include the embedded Adaptec + SCSI chips.

+ +

If you are using banks of DIMMs of different sizes + the biggest DIMMs should be installed in the DIMM slots + marked 0 on the mainboard. The + DIMM slots should be filled ``in order'' so after bank + 0 install in bank 1 and so on.

+ +

Don't try to use Symbios-chip based SCSI adapters in + the PCI slots connected to hose 1. There is a + not-yet-found FreeBSD bug that prevents this from + working correctly. DS20 ships by default with a Symbios + on hose 1 so you have to move this card before you can + install/boot FreeBSD on it.

+ +

The kernel config file must contain:

+
+options    DEC_ST6600    
+cpu EV5
+
+ +
+
+

Note: Contrary to expectation there is no + cpu EV6 defined for + inclusion in the kernel config file. The cpu EV5 is mandatory to keep + + config(8) + happy.

+
+
+
+ +
+
+ +

2.3.11 + AlphaPC 264DP / UP2000

+ +

UP2000 is built by Alpha Processor Inc.

+ +

Features:

+ +
    +
  • +

    21264 EV6 CPU at 670 MHz

    +
    • + +
  • +

    dual CPU capable

    +
    • + +
  • +

    L2 / Bcache: 4 Mbytes per CPU

    +
    • + +
  • +

    memory bus: 256 bit

    +
    • + +
  • +

    memory: SDRAM DIMMs installed in sets of 4, uses + ECC, 16 DIMM slots, max. 4GB

    +
    • + +
  • +

    21272 core logic chip set (``Tsunami'')

    +
    • + +
  • +

    embedded Adaptec AIC7890/91 Wide Ultra SCSI

    +
    • + +
  • +

    2 embedded IDE based on Cypress 82C693 chips

    +
    • + +
  • +

    embedded USB via Cypress 82C693

    +
    • + +
  • +

    expansion:

    + +
      +
    • +

      2 independent PCI buses, driven by + high-speed I/O channels called ``hoses''

      +
      • + +
    • +

      6 64-bit PCI slots, 3 per hose

      +
      • + +
    • +

      1 ISA slot

      +
      • +
    +
    • +
+ +

Currently a maximum of 2GB memory is supported by + FreeBSD.

+ +

The on-board Adaptec is not bootable but works with + FreeBSD 4.0 and later as a datadisk-only SCSI bus.

+ +

Busmaster DMA is supported on the first IDE + interface only.

+ +

The kernel config file must contain:

+
+options    DEC_ST6600    
+cpu EV5
+
+ +
+
+

Note: Contrary to expectation there is no + cpu EV6 defined for + inclusion in the kernel config file. The cpu EV5 is mandatory to keep + + config(8) + happy.

+
+
+
+ +
+
+ +

2.3.12 + AlphaServer 2000 (``DemiSable''), 2100 (``Sable''), + 2100A (``Lynx'')

+ +

The AlphaServer 2[01]00 machines are intended as + departmental servers. This is medium iron. They are + multi-CPU machines, up to 2 CPUs (AS2000) or 4 CPUs + (2100[A]) can be installed. Both floor-standing and + 19" rackmount boxes exist. Rackmount variations + have different numbers of I/O expansion slots, + different max number of CPUs and different maximum + memory size. Some of the boxes come with an integral + StorageWorks shelf to house hot-swap SCSI disks. There + was an upgrade program available to convert your Sable + machine into a Lynx by swapping the I/O backplane (the + C-bus backplane remains). CPU upgrades were available + as well.

+ +
    +
  • +

    21064 EV4[5] CPU[s] at 200, 233, 275 MHz or + 21164 EV5[6] CPU[s]s at 250, 300, 375, 400 MHz

    +
    • + +
  • +

    cache: varies in size with the CPU model; 1, 4 + or 8Mbyte per CPU

    +
    • + +
  • +

    embedded floppy controller driving a 2.88 Mbytes + drive

    +
    • + +
  • +

    embedded 10Mbit 21040 Ethernet [AS2100 only]

    +
    • + +
  • +

    2 serial ports

    +
    • + +
  • +

    1 parallel port

    +
    • + +
  • +

    PS/2 style keyboard & mouse port

    +
    • +
+ +

The CPUs spec-ed as 200 MHz are in reality running + at 190 MHz. Maximum number of CPUs is 4. All CPUs must + be of the same type/speed.

+ +

If any of the processors are ever marked as failed, + they will remain marked as failed even after they have + been replaced (or reseated) until you issue the + command

+
+>>> CLEAR_ERROR ALL
+
+ +

on the SRM console and power-cycle the machine. This + may be true for other modules (IO and memory) as well, + but it has not been verified.

+ +

The machines use dedicated memory boards. These + boards live on a 128 bit C-bus shared with the CPU + boards. DemiSable supports up to 1GB, Sable up to 2GB. + One of the memory bus slots can either hold a CPU or a + memory card. A 4 CPU machine can have a maximum of 2 + memory boards.

+ +

Some memory board models house SIMMs. These are + called SIMM carriers. There are also memory modules + that have soldered-on memory chips instead of SIMMs. + These are called ``flat memory modules''.

+ +

SIMM boards are used in sets of eight 72-pin 36 bit + FPM memory of 70ns or faster. SIMM types supported are + 1M x36 bit (4 Mbyte), 2M x36bit (8 Mbyte) and 4M x36 + bit (16 Mbyte). Each memory board can house 4 banks of + SIMMs. SIMM sizes can not be mixed on a single memory + board. The first memory module must be filled with + SIMMs before starting to fill the next memory module. + Note that the spacing between the slots is not that + big, so make sure your SIMMs fit physically (before + buying them..)

+ +

Both Lynx and Sable are somewhat stubborn when it + comes to serial consoles. They need

+
+>>> SET CONSOLE SERIAL
+
+ +

before they go for a serial console. Pulling the + keyboard from the machine is not sufficient, like it is + on many other Alpha models. Going back to a graphical + console needs

+
+>>> SET CONSOLE GRAPHICS
+
+ +

at the serial console. On Lynx keep the VGA card in + one of the primary PCI slots. EISA VGA cards are not + slot sensitive.

+ +

The machines are equipped with a small OCP (Operator + Control Panel) LCD screen. On this screen the self-test + messages are displayed during system initialization. + You can put your own little text there by using the + SRM:

+
+>>> SET OCP_TEXT "FreeBSD"
+     
+
+ +

The SRM

+
+>>> SHOW FRU
+
+ +

command produces an overview of your configuration + with module serial numbers, hardware revisions and + error log counts.

+ +

Both Sable, DemiSable and Lynx have Symbios 810 + based Fast SCSI on-board. Check if it is set to Fast + SCSI speed by

+
+>>> SHOW PKA0_FAST
+
+ +

When set to 1 it is negotiating for Fast speeds.

+
+>>> SET PKA0_FAST 1
+
+ +

enables Fast SCSI speeds.

+ +

AS2100[A] come equipped with a StorageWorks 7 slot + SCSI cage. A second cage can be added inside the + cabinet. AS2000 has a single 7 slot SCSI cage, which + cannot be expanded with an additional one. Note that + the slot locations in these cages map differently to + SCSI IDs compared to the standard StorageWorks shelves. + Slot IDs from top to bottom are 0, 4, 1, 5, 2, 6, 3 + when using a single bus configuration.

+ +

The cage can also be set to provide two independent + SCSI buses. This is used for embedded RAID controllers + like the KZPSC (Mylex DAC960). Slot ID assignments for + split bus are, from top to bottom: 0A, 0B, 1A, 1B, 2A, + 2B, 3A, 3B. Where A and B signify a SCSI bus. In a + single bus configuration the terminator module on the + back of the SCSI cage is on the TOP. The jumper module + is on the BOTTOM. For split bus operation these two + modules are reversed. The terminator can be + distinguished from the jumper by noting the chips on + the terminator. The jumper does not have any active + components on it.

+ +

DemiSable has 7 EISA slots and 3 PCI slots. Sable + has 8 EISA and 3 PCI slots. Lynx, being newer, has 8 + PCI and 3 EISA slots. The Lynx PCI slots are grouped in + sets of 4. The 4 PCI slots closest to the CPU/memory + slots are the primary slots, so logically before the + PCI bridge chip. Note that contrary to expectation the + primary PCI slots are the highest numbered ones (PCI4 - + PCI7).

+ +

Make sure you run the EISA Configuration Utility + (from floppy) when adding/change expansion cards in + EISA slots or after upgrading your console firmware. + This is done by inserting the ECU floppy and typing

+
+>>> RUNECU
+
+ +
+
+

Note: EISA slots are currently + unsupported, but the Compaq Qvision EISA VGA + adapter is treated as an ISA device. It therefore + works OK as a console.

+
+
+ +

A special Extended I/O module for use on the C-bus + was planned-for. If they ever saw daylight is unknown. + In any case FreeBSD has never been verified with an + ExtIO module.

+ +

The machines can be equipped with redundant power + supplies. Note that the enclosure is equipped with + interlock switches that switch off power when the + enclosure is opened. The system's cooling fans are + speed controlled. When the machine has more than 2 CPUs + and more than 1 memory board dual power supplies are + mandatory.

+ +

The kernel config file must contain:

+
+options    DEC_2100_A500
+cpu EV4 #dependent on CPU model installed
+cpu EV5 #dependent on CPU model installed
+
+
+ +
+
+ +

2.3.13 + AlphaServer 4x00 (``Rawhide'')

+ +

The AlphaServer 4x00 machines are intended as small + enterprise servers. Expect a 30" high pedestal + cabinet or alternatively the same system box in a + 19" rack. Rawhides are multi-CPU machines, up to 4 + CPUs can be in a single machine. Basic disk storage is + housed in one or two StorageWorks shelves at the bottom + of the pedestal. The Rawhides intended for the NT + market are designated DIGITAL Server 7300 (5/400 CPU), + DIGITAL Server 7305 (5/533 CPU). A trailing R on the + part-number means a rackmount variant.

+ +

Features:

+ +
    +
  • +

    21164 EV5 CPUs at 266, 300, 333 MHz or 21164A + EV56 CPUs at 400, 466, 533, 600 Mhz

    +
    • + +
  • +

    cache: 4 Mbytes per CPU. EV5 300 MHz was also + available cache-less. 8 Mbytes for EV56 600Mhz

    +
    • + +
  • +

    memory bus: 128 bit with ECC

    +
    • + +
  • +

    embedded floppy controller

    +
    • + +
  • +

    2 serial ports

    +
    • + +
  • +

    1 parallel port

    +
    • + +
  • +

    PS/2 style keyboard & mouse port

    +
    • +
+ +

Rawhide can be equipped with a variety of CPU + modules. CPU modules exist in versions with and without + external cache. In all cases the CPU modules installed + always must be of the same speed. A mix of NT-only and + full-blown Tru64/VMS CPUs works fine. It will however + result in the system reporting itself to the operating + system as a Digital Server 730x (so the NT-only + variant). FreeBSD does not care, but such a system will + not allow Tru64 or VMS to run.

+ +

Rawhide uses a maximum of 8 RAM modules. These + modules are used in pairs and supply 72 bits to the bus + (this includes ECC bits). Memory can be EDO RAM or + synchronous DRAM. A fully populated AS4100 has 4 pairs + of memory modules. The AS4000 model is limited to 2 + pairs of memory modules. Given the choice use SDRAM for + best performance. The highest capacity memory boards + must be in the memory slots marked MEM0L and MEM0H. A + mix of memory board sizes is allowed. A mix of EDO and + SDRAM works as well (assuming you don't try to mix EDO + and SDRAM in a single module pair). A mix of EDO and + SDRAM results in the entire memory subsystem + running at the slower EDO timing.

+ +

Rawhide has an embedded Symbios 810 chip that gives + you a narrow fast-SCSI bus. Generally only the SCSI + CDROM is driven by this interface.

+ +

Rawhides are available with a 8 64-bit PCI / 3 EISA + slot expansion backplanes (called ``Saddle'' modules). + There are 2 separate PCI buses, PCI0 and PCI1. PCI0 has + 1 dedicated PCI slot and (shared) 3 PCI/EISA slots. + PCI0 also has a PCI/EISA bridge that drives things like + the serial and parallel ports, keyboard/mouse etc. PCI1 + has 4 PCI slots and a Symbios 810 SCSI chip. VGA + console cards must be installed in a slot connected to + PCI0.

+ +

The current FreeBSD implementation has problems in + handling PCI bridges. There is currently a limited fix + in place which allows for single level, single device + PCI bridges. The fix allows the use of the Digital + supplied Qlogic SCSI card which sits behind a 21054 PCI + bridge chip.

+ +
+
+

Note: EISA slots are currently + unsupported, but the Compaq Qvision EISA VGA + adapter is treated as an ISA device. It therefore + works as a console. In case you use EISA options in + your machine you must run the EISA Configuration + Utility (ECU) from floppy. Do yourself a favor and + use the Tru64/OpenVMS ECU, and not the WindowsNT + ECU.

+
+
+ +

Rawhide employs an I2C based power controller + system. If you want to be sure all power is removed + from the system remove all mains cables from the + system.

+ +

Rawhide comes with RCM functionality, which means + you can power it on/off remotely, reset it etc. See + also the description for RMC in the DS10 section of + this document. RCM versus RMC is not a typo, the + various documentation I consulted used both acronyms + interchangably.

+ +

The kernel config file must contain:

+
+options    DEC_KN300
+cpu EV5
+
+
+ +
+
+ +

2.3.14 + AlphaServer 1200 (``Tincup'') and AlphaStation 1200 + (``DaVinci'')

+ +

The AlphaServer 1200 machine is the successor to the + AlphaServer 1000A. It uses the same enclosure the 1000A + uses, but the logic is based on the AlphaServer 4000 + design. These are multi-CPU machines, up to 2 CPUs can + be in a single machine. Basic disk storage is housed in + a StorageWorks shelves The AS1200 intended for the NT + market were designated DIGITAL Server 5300 (5/400 CPU) + and DIGITAL Server 5305 (5/533 CPU).

+ +

Features:

+ +
    +
  • +

    21164A EV56 CPUs at 400 or 533 Mhz

    +
    • + +
  • +

    cache: 4 Mbytes per CPU

    +
    • + +
  • +

    memory bus: 128 bit with ECC, DIMM memory on two + memory daughter boards

    +
    • + +
  • +

    embedded floppy controller

    +
    • + +
  • +

    2 serial ports

    +
    • + +
  • +

    1 parallel port

    +
    • + +
  • +

    PS/2 style keyboard & mouse port

    +
    • +
+ +

AS1200 uses 2 memory daughter cards. On each of + these cards are 8 DIMM slots. DIMMs must be installed + in pairs. The maximum memory size is 4 GBytes. Slots + must be filled in order and slot 0 must contain the + largest size DIMM if different sized DIMMs are used. + AS1200 employs fixed starting addresses for DIMMs, each + DIMM pair starts at a 512 Mbyte boundary. This means + that if DIMMs smaller than 256 Mbyte are used the + system's physical memory map will contain ``holes''. + Supported DIMM sizes are 64 Mbytes and 256 Mbytes. The + DIMMs are 72 bit SDRAM based, as the system employs + ECC.

+ +
+
+

Note: FreeBSD currently supports up to + 2GBytes

+
+
+ +

AS1200 has an embedded Symbios 810 drive Fast SCSI + bus.

+ +

Tincup has 5 64-bit PCI slots, one 1 32-bit PCI slot + and one EISA slot (which is physically shared with one + of the 64-bit PCI slots). There are 2 separate PCI + buses, PCI0 and PCI1. PCI0 has the 32-bit PCI slot and + the 2 top-most 64-bit PCI slots. PCI0 also has an Intel + 82375EB PCI/EISA bridge that drives things like the + serial and parallel ports, keyboard/mouse etc. PCI1 has + 4 64-bit PCI slots and a Symbios 810 SCSI chip. VGA + console cards must be installed in a slot connected to + PCI0.

+ +

The system employs an I2C based power controller + system. If you want to be sure all power is removed + from the system remove the mains cables from the + system. Tincup uses dual power supplies in load-sharing + mode and not as a redundancy pair.

+ +

The kernel config file must contain:

+
+options    DEC_KN300
+cpu EV5
+
+
+ +
+
+ +

2.3.15 + AlphaServer 8200 and 8400 (``TurboLaser'')

+ +

The AlphaServer 8200 and 8400 machines are + enterprise servers. Expect a tall 19" cabinet + (8200) or fat (8400) 19" rack. This is big iron, + not a hobbyist system. TurboLasers are multi-CPU + machines, up to 12 CPUs can be in a single machine. The + TurboLaser System Bus (TLSB) allows 9 nodes on the + AS8400 and 5 nodes on the AS8200. TLSB is 256 bit data, + 40 bit address allowing 2.1 GBytes/sec. Nodes on the + TLSB can be CPUs, memory or I/O. A maximum of 3 I/O + ports are supported on a TLSB.

+ +

Basic disk storage is housed in a StorageWorks + shelf. AS8400 uses 3 phase power, AS8200 uses single + phase power.

+ +

Features:

+ +
    +
  • +

    21164 EV5/EV56 CPUs at up to 467 MHz or 21264 + EV67 CPUs at up to 625 MHz

    +
    • + +
  • +

    one or two CPUs per CPU module

    +
    • + +
  • +

    cache: 4Mbytes B-cache per CPU

    +
    • + +
  • +

    memory bus: 256 bit with ECC

    +
    • + +
  • +

    memory: big memory modules that plug into the + TLSB, which in turn hold special SIMM modules. + Memory modules come in varying sizes, up to 4 + GBytes a piece. Uses ECC (8 bits per 64 bits of + data) 7 memory modules max for AS8400, 3 modules + max for AS8200. Maximum memory is 28 GBytes.

    +
    • + +
  • +

    expansion: 3 system ``I/O ports'' that allow up + to 12 I/O channels each I/O channel can connect to + XMI, Futurebus+ or PCI boxes

    +
    • +
+ +

FreeBSD supports (and has been tested with) up to 2 + GBytes of memory on TurboLaser. There is a trade-off to + be made between TLSB slots occupied by memory modules + and TLSB slots occupied by CPU modules. For example you + can have 28GBytes of memory but only 2 CPUs (1 module) + at the same time.

+ +

Only PCI expansion is supported on FreeBSD. XMI or + Futurebus+ (which are AS8400 only) are both + unsupported.

+ +

The I/O port modules are designated KFTIA or KFTHA. + The I/O port modules supply so called ``hoses'' that + connect to up to 4 (KFTHA) PCI buses or 1 PCI bus + (KFTIA). KFTIA has embedded dual 10baseT Ethernet, + single FDDI, 3 SCSI Fast Wide Differential SCSI buses + and a single Fast Wide Single Ended SCSI bus. The FWSE + SCSI is intended for the CDROM.

+ +

KFTHA can drive via each of its 4 hoses a DWLPA or + DWLPB box. The DWLPx house a 12 slots 32 bit PCI + backplane. Physically the 12 slots are 3 4-slot buses + but to the software it appears as a single 12 slots PCI + bus. A fully expanded AS8x00 can have 3 (I/O ports) + times 4 (hoses) times 12 (PCI slots/DWLPx) = 144 PCI + slots. The maximum bandwidth per KFTHA is 500 + Mbytes/second. DWLPA can also house 8 EISA cards, 2 + slots are PCI-only, 2 slots are EISA only. Of the 12 + slots 2 are always occupied by an I/O and connector + module. DWLPB are the prefered I/O boxes.

+ +

For best performance distribute high bandwidth + (FibreChannel, Gigabit Ethernet) over multiple hoses + and/or multiple KFTHA/KFTIA.

+ +

Currently PCI expansion cards containing PCI bridges + are not usable with FreeBSD. Don't use them at this + time.

+ +

The single ended narrow SCSI bus on the KFTIA will + turn up as the fourth SCSI bus. The 3 + fast-wide differential SCSI buses of the KFTIA precede + it.

+ +

AS8x00 are generally run with serial consoles. Some + newer machines might have a graphical console of some + sorts but FreeBSD has only been tested on a serial + console.

+ +

For serial console usage either change /etc/ttys to have:

+
+console "/usr/libexec/getty std.9600"   unknown   on secure
+
+ +

as the console entry, or add

+
+zs0     "/usr/libexec/getty std.9600"   unknown   on secure
+
+ +

For the AlphaServer 8x00 machines the kernel config + file must contain:

+
+options    DEC_KN8AE   # Alpha 8200/8400 (Turbolaser)
+cpu EV5
+
+ +

Contrary to expectation there is no cpu EV6 defined for inclusion in + the kernel config file. The cpu + EV5 is mandatory to keep + config(8) + happy.

+
+ +
+
+ +

2.3.16 + Alpha Processor Inc. UP1000

+ +

The UP1000 is an ATX mainboard based on the 21264a + CPU which itself lives in a Slot B module. It is + normally housed in an ATX tower enclosure.

+ +

Features:

+ +
    +
  • +

    21264a Alpha CPU at 600 or 700 MHz in a Slot B + module (includes cooling fans)

    +
    • + +
  • +

    memory bus: 128 bits to the L2 cache, 64 bits + from Slot B to the AMD-751

    +
    • + +
  • +

    on-board Bcache / L2 cache: 2MB (600Mhz) or 4MB + (700Mhz)

    +
    • + +
  • +

    AMD AMD-751 (``Irongate'') system controller + chip

    +
    • + +
  • +

    Acer Labs M1543C PCI-ISA bridge controller / + super-IO chip

    +
    • + +
  • +

    PS/2 mouse & keyboard port

    +
    • + +
  • +

    memory: 168-pin PC100 unbuffered SDRAM DIMMS, 3 + DIMM slots DIMM sizes supported are 64, 128 or 256 + Mb in size

    +
    • + +
  • +

    2 16550A serial port

    +
    • + +
  • +

    1 ECP/EPP parallel port

    +
    • + +
  • +

    floppy interface

    +
    • + +
  • +

    2 embedded Ultra DMA33 IDE interface

    +
    • + +
  • +

    2 USB ports

    +
    • + +
  • +

    expansion:

    + +
      +
    • +

      4 32 bit PCI slots

      +
      • + +
    • +

      2 ISA slots

      +
      • + +
    • +

      1 AGP slot

      +
      • +
    +
    • +
+ +

Slot B is a box-like enclosure that houses a + daughter-board for the CPU and cache. It has 2 small + fans for cooling. Loud fans..

+ +

The machine needs ECC capable DIMMs, so 72 bit ones. + This does not appear to be documented in the UP1000 + docs. The system accesses the serial EEPROM on the + DIMMs via the SM bus. Note that if only a single DIMM + is used it must be installed in slot 2. This + is a bit counter-intuitive.

+ +

The UP1000 needs a 400Watt ATX power supply + according to the manufacturer. This might be a bit + overly conservative/pessimistic judging from the power + consumption of the board & cpu. But as always you + will have to take your expansion cards and peripherals + into account. The M1543C chip contains power management + functionality & temperature monitoring (via I2C / + SM bus).

+ +

Chances are that your UP1000 comes by default with + AlphaBios only. The SRM console firmware is available + from the Alpha Processor Inc. web site. It is currently + available in a beta version which was successfully used + during the port of FreeBSD to the UP1000.

+ +

The embedded Ultra DMA EIDE ports are bootable by + the SRM console.

+ +

UP1000 SRM can boot off an Adaptec 294x adapter. + Under high I/O load conditions machine lockups have + been observed using the Adaptec 294x. A Symbios 875 + based card works just fine, using the sym driver. Most + likely other cards based on the Symbios chips that the + sym driver supports will work as well.

+ +

The USB interfaces are disabled by the SRM console + and have not (yet) been tested with FreeBSD.

+ +

For the UP1000 the kernel config file must + contain:

+
+options    API_UP1000  # UP1000, UP1100 (Nautilus)
+cpu EV5
+
+
+ +
+
+ +

2.3.17 + Alpha Processor Inc. UP1100

+ +

The UP1100 is an ATX mainboard based on the 21264a + CPU running at 600 MHz. It is normally housed in an ATX + tower enclosure.

+ +

Features:

+ +
    +
  • +

    21264a Alpha EV6 CPU at 600 or 700 MHz

    +
    • + +
  • +

    memory bus: 100MHz 64-bit (PC-100 SDRAM), 800 + MB/s memory bandwidth

    +
    • + +
  • +

    on-board Bcache / L2 cache: 2Mb

    +
    • + +
  • +

    AMD AMD-751 (``Irongate'') system controller + chip

    +
    • + +
  • +

    Acer Labs M1535D PCI-ISA bridge controller / + super-IO chip

    +
    • + +
  • +

    PS/2 mouse & keyboard port

    +
    • + +
  • +

    memory: 168-pin PC100 unbuffered SDRAM DIMMS, 3 + DIMM slots DIMM sizes supported are 64, 128 or 256 + Mb in size

    +
    • + +
  • +

    2 16550A serial port

    +
    • + +
  • +

    1 ECP/EPP parallel port

    +
    • + +
  • +

    floppy interface

    +
    • + +
  • +

    2 embedded Ultra DMA66 IDE interface

    +
    • + +
  • +

    2 USB port

    +
    • + +
  • +

    expansion: 3 32 bit PCI slots and 1 AGP2x + slot

    +
    • +
+ +

SRM console code comes standard with the UP1100. The + SRM lives in 2Mbytes of flash ROM.

+ +

The machine needs ECC capable DIMMs, so 72 bit ones. + This does not appear to be documented in the UP1100 + docs. The system accesses the serial EEPROM on the + DIMMs via the SM bus. Note that if only a single DIMM + is used it must be installed in slot 2. This + is a bit counter-intuitive.

+ +

The UP1100 needs a 400Watt ATX power supply + according to the manufacturer. This might be a bit + overly conservative/pessimistic judging from the power + consumption of the board & cpu. But as always you + will have to take your expansion cards and peripherals + into account. The M1535D chip contains power management + functionality & temperature monitoring (via I2C / + SM bus using a LM75 thermal sensor).

+ +

The UP1100 has an on-board 21143 10/100Mbit Ethernet + interface.

+ +

The UP1100 is equipped with a SoundBlaster + compatible audio interface. Whether it works with + FreeBSD is as of yet unknown.

+ +

The embedded Ultra DMA EIDE ports are bootable by + the SRM console.

+ +

The UP1100 has 3 USB ports, 2 going external and one + connected to the AGP port.

+ +

For the UP1100 the kernel config file must + contain:

+
+options    API_UP1000  # UP1000, UP1100 (Nautilus)
+cpu EV5
+
+ +

Contrary to expectation there is no cpu EV6 defined for inclusion in + the kernel config file. The cpu + EV5 is mandatory to keep + config(8) + happy.

+
+ +
+
+ +

2.3.18 + Alpha Processor Inc. CS20, Compaq DS20L

+ +

The CS20 is a 19", 1U high rackmount server + based on the 21264[ab] CPU. It can have a maximum of 2 + CPUs. Compaq sells the CS20 rebranded as the + AlphaServer DS20L. DS20L has 833MHz CPUs.

+ +

Features:

+ +
    +
  • +

    21264a Alpha CPU at 667 MHz or 21264b 833 MHz + (max. 2 CPUs)

    +
    • + +
  • +

    memory bus: 100MHz 256-bit wide

    +
    • + +
  • +

    21271 Core Logic chipset (``Tsunami'')

    +
    • + +
  • +

    Acer Labs M1533 PCI-ISA bridge controller / + super-IO chip

    +
    • + +
  • +

    PS/2 mouse & keyboard port

    +
    • + +
  • +

    memory: 168-pin PC100 PLL buffered/registered + SDRAM DIMMS, 8 DIMM slots, uses ECC memory, min 256 + Mbytes / max 2 GBytes of memory

    +
    • + +
  • +

    2 16550A serial port

    +
    • + +
  • +

    1 ECP/EPP parallel port

    +
    • + +
  • +

    ALI M1543C Ultra DMA66 IDE interface

    +
    • + +
  • +

    embedded dual Intel 82559 10/100Mbit + Ethernet

    +
    • + +
  • +

    embedded Symbios 53C1000 Ultra160 SCSI + controller

    +
    • + +
  • +

    expansion: 2 64 bit PCI slots (2/3 length)

    +
    • +
+ +

SRM console code comes standard with the CS20. The + SRM lives in 2Mbytes of flash ROM.

+ +

The CS20 needs ECC capable DIMMs. Note that it uses + buffered DIMMs.

+ +

The CS20 has an I2C based internal monitoring system + for things like temperature, fans, voltages etc. The + I2C also supports ``wake on LAN''.

+ +

Each PCI slot is connected to its own independent + PCI bus on the Tsunami.

+ +

The embedded Ultra DMA EIDE ports are bootable by + the SRM console.

+ +

The CS20 has an embedded slim-line IDE CD drive. + There is a front-accessible bay for a 1" high + 3.5" SCSI hard-disk drive with SCA connector.

+ +

Note that there is no floppy disk drive (or a + connector to add one).

+ +

The kernel config file must contain:

+
+options    DEC_ST6600
+cpu EV5
+
+ +

Contrary to expectation there is no cpu EV6 defined for inclusion in + the kernel config file. The cpu + EV5 is mandatory to keep + config(8) + happy.

+
+ +
+
+ +

2.3.19 + Compaq AlphaServer ES40 (``Clipper'')

+ +

The ES40 is a SMP system that can have 1 - 4 21264 + Alpha CPUs. With the maximum configuration of 32GB of + memory these systems are often deployed as heavy + database servers and are also found in HPTC compute + farm environments.

+ +

Features:

+ +
    +
  • +

    21264 Alpha CPU at 500 (EV6), 667 (EV67) or 833 + MHz (EV68) (max. 4 CPUs)

    +
    • + +
  • +

    memory bus: 256-bit wide

    +
    • + +
  • +

    21272 Core Logic chipset

    +
    • + +
  • +

    PS/2 mouse & keyboard port

    +
    • + +
  • +

    memory: 200-pin JEDEC standard SDRAM DIMMS, max + 32 GBytes of memory

    +
    • + +
  • +

    2 16550A serial port

    +
    • + +
  • +

    1 ECP/EPP parallel port

    +
    • + +
  • +

    ALI M1543C Ultra DMA66 IDE interface

    +
    • + +
  • +

    expansion: 2 64 bit PCI buses

    +
    • +
+ +

SRM console code comes standard with the ES40.

+ +

ES40 comes with an ATA CDROM drive, but uses SCSI + harddisks.

+ +

Memory is divided in 4 memory arrays which each + contain a set of 4 SDRAM DIMMs. Each DIMM is 72 bit + wide and of the 100MHz speed variant. An array can + contain 2 sets, so 8 DIMMs max per array. The DIMMs + live on Memory Mother Boards (MMBs). There are 2 MMB + models, with 4 and 8 DIMM sockets respectively. Each + MMB provides half of the 256 bit memory bus width to + the CPUs. Given the myriad options for the memory + configuration it is advisable to check the system + documentation for the optimum memory configuration.

+ +

Dependent on the model variation the ES40 has 6 or + 10 64 bit PCI slots. This is basically just means the + same backplane with less connectors mounted.

+ +

ES40 has the same RMC remote power control as DS10 + and DS20. See the description of the RMC in the DS10 + section of this document. Most variations of ES40 have + multiple power supplies, allowing for N+1 redundancy. + When installing CPU cards you must unplug all power + cords, the CPU cards receive standby power from the + power supplies. Maximum memory configurations need more + than the default number of powersupplies.

+ +

The kernel config file must contain:

+
+options   DEC_ST6600
+cpu     EV5
+
+ +

Contrary to expectation there is no cpu EV6 defined for inclusion in + the kernel config file. The cpu + EV5 is mandatory to keep + config(8) + happy.

+
+
+ +
+
+ +

2.4 + Supported Hardware Overview

+ +

A word of caution: the installed base for FreeBSD is + not nearly as large as for FreeBSD/Intel. This means that + the enormous variation of PCI/ISA expansion cards out + there has much less chance of having been tested on alpha + than on Intel. This is not to imply they are doomed to + fail, just that the chance of running into something + never tested before is much higher. GENERIC contains things that are + known to work on Alpha only.

+ +

The PCI and ISA expansion busses are fully supported. + Turbo Channel is not in GENERIC + and has limited support (see the relevant machine model + info). The MCA bus is not supported. The EISA bus is not + supported for use with EISA expansion cards as the EISA + support code is lacking. ISA cards in EISA slots are + reported to work. The Compaq Qvision EISA VGA card is + driven in ISA mode and works OK as a console.

+ +

1.44 Mbyte and 1.2 Mbyte floppy drives are supported. + 2.88 Mbyte drives sometimes found in Alpha machines are + supported up to 1.44Mbyte.

+ +

ATA and ATAPI (IDE) devices are supported via the + ata(4) driver + framework. As most people run their Alphas with SCSI + disks it is not as well tested as SCSI. Be aware of + boot-ability restrictions for IDE disks. See the machine + specific information.

+ +

There is full SCSI support via the CAM layer for + Adaptec 2940x (AIC7xxx chip-based), Qlogic family and + Symbios. Be aware of the machine-specific boot-ability + issues for the various adapter types.

+ +

The Qlogic QL2x00 FibreChannel host adapters are fully + supported.

+ +

If you want to boot your Alpha over the Ethernet you + will obviously need an Ethernet card that the SRM console + recognizes. This generally means you need a board with an + 21x4x Ethernet chip as that is what Digital used. These + chips are driven by the FreeBSD + de(4) (older + driver) or + dc(4) (newer + driver). Some new SRM versions are known to recognize the + Intel 8255x Ethernet chips as driven by the FreeBSD + fxp(4) driver. + But beware: the + fxp(4) driver is + reported not to work correctly with FreeBSD (although it + works excellently on FreeBSD/x86).

+ +

DEC DEFPA PCI FDDI network adapters are supported on + alpha.

+ +

In general the SRM console emulates a + VGA-compatibility mode on PCI VGA cards. This is, + however, not guaranteed to work by Compaq/DEC for each + and every card type out there. When the SRM thinks the + VGA is acceptable FreeBSD will be able to use it. The + console driver works just like on a FreeBSD/intel + machine. Please note that VESA modes are not supported on + Alpha, so that leaves you with 80x25 consoles.

+ +

In some Alpha machines you will find video adapters + based on TGA chips. The plain TGA adapter does not + emulate VGA and is therefore not usable for a FreeBSD + console. TGA2 cards have a basic VGA compatibility mode + and work fine as FreeBSD consoles.

+ +

The ``PC standard'' serial ports found on most Alphas + are supported.

+ +

ISDN (i4b) is not supported on FreeBSD/alpha.

+
+ +
+
+ +

2.5 + Acknowledgments

+ +

In compiling this file I used multiple information + sources, but the NetBSD Web site proved to be an + invaluable source of information. If it wasn't for + NetBSD/alpha there probably would not be a FreeBSD/alpha + in the first place.

+ +

People who kindly helped me create this section:

+ +
    +
  • +

    Andrew Gallatin

    +
    • + +
  • +

    Chuck Robey

    +
    • + +
  • +

    Matthew Jacob

    +
    • + +
  • +

    Michael Smith

    +
    • + +
  • +

    David O'Brien

    +
    • + +
  • +

    Christian Weisgerber

    +
    • + +
  • +

    Kazutaka YOKOTA

    +
    • + +
  • +

    Nick Maniscalco

    +
    • + +
  • +

    Eric Schnoebelen

    +
    • + +
  • +

    Peter van Dijk

    +
    • + +
  • +

    Peter Jeremy

    +
    • + +
  • +

    Dolf de Waal

    +
    • + +
  • +

    Wim Lemmers, ex-Compaq

    +
    • + +
  • +

    Wouter Brackman, Compaq

    +
    • + +
  • +

    Lodewijk van den Berg, Compaq

    +
    • +
+
+
+ +
+
+ +

3 + Supported Devices

+ $FreeBSD: + src/release/doc/en_US.ISO8859-1/hardware/common/dev.sgml,v + 1.157 2003/05/30 11:24:00 nyan Exp $ + +

This section describes the devices currently known to be + supported by with FreeBSD on the Alpha/AXP platform. Other + configurations may also work, but simply have not been + tested yet. Feedback, updates, and corrections to this list + are encouraged.

+ +

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.

+ +
+
+ +

3.1 Disk + Controllers

+ +

IDE/ATA controllers ( + ata(4) + driver)

+ +
    +
  • +

    Acard ATP850 UDMA2, ATP860 UDMA4, ATP865 UDMA6

    +
    • + +
  • +

    AMD 756 ATA66, 766 ATA100, 768 ATA100

    +
    • + +
  • +

    Cenatek Rocket Drive

    +
    • + +
  • +

    CMD 646, 648 ATA66, and 649 ATA100

    +
    • + +
  • +

    Cypress 82C693

    +
    • + +
  • +

    Cyrix 5530 ATA33

    +
    • + +
  • +

    HighPoint HPT366 ATA66, HPT370 ATA100, HPT372 + ATA133, HPT374 ATA133

    +
    • + +
  • +

    Intel PIIX, PIIX3, PIIX4

    +
    • + +
  • +

    Intel ICH ATA66, ICH2 ATA100, ICH3 ATA100, ICH4 + ATA100

    +
    • + +
  • +

    nVidia nForce ATA100, nForce2 ATA133

    +
    • + +
  • +

    Promise ATA100 OEM chip (pdc20265)

    +
    • + +
  • +

    Promise ATA133 OEM chip (pdc20269)

    +
    • + +
  • +

    Promise Fasttrak-33, -66, -100, -100 TX2/TX4, -133 + TX2/TX2000

    +
    • + +
  • +

    Promise SATA150 TX2/TX4 Serial ATA/150

    +
    • + +
  • +

    Promise Ultra-33, -66, -100, -133 + TX2/TX2000/TX4000

    +
    • + +
  • +

    ServerWorks ROSB4 ATA33

    +
    • + +
  • +

    ServerWorks CSB5 and CSB6 ATA66/ATA100

    +
    • + +
  • +

    Sil 0680 UDMA6

    +
    • + +
  • +

    SiS 530, 540, 550, 620

    +
    • + +
  • +

    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

    +
    • + +
  • +

    SiS 5591 ATA100

    +
    • + +
  • +

    VIA 82C586 ATA33, 82C596 ATA66, 82C686a ATA66, + 82C686b ATA100

    +
    • + +
  • +

    VIA 8233, 8235 ATA133

    +
    • +
+
+
+ +

Adaptec SCSI Controllers

+ +
    +
  • +

    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 ( + ahc(4) + driver)

    +
    • + +
  • +

    Adaptec AIC7770, AIC7850, AIC7860, AIC7870, + AIC7880, and AIC789x on-board SCSI controllers ( + ahc(4) + driver)

    +
    • +
+
+
+ +

AMI MegaRAID Express and Enterprise family RAID + controllers ( + amr(4) + driver)

+ +
    +
  • +

    MegaRAID Series 418

    +
    • + +
  • +

    MegaRAID Enterprise 1200 (Series 428)

    +
    • + +
  • +

    MegaRAID Enterprise 1300 (Series 434)

    +
    • + +
  • +

    MegaRAID Enterprise 1400 (Series 438)

    +
    • + +
  • +

    MegaRAID Enterprise 1500 (Series 467)

    +
    • + +
  • +

    MegaRAID Enterprise 1600 (Series 471)

    +
    • + +
  • +

    MegaRAID Elite 1500 (Series 467)

    +
    • + +
  • +

    MegaRAID Elite 1600 (Series 493)

    +
    • + +
  • +

    MegaRAID Express 100 (Series 466WS)

    +
    • + +
  • +

    MegaRAID Express 200 (Series 466)

    +
    • + +
  • +

    MegaRAID Express 300 (Series 490)

    +
    • + +
  • +

    MegaRAID Express 500 (Series 475)

    +
    • + +
  • +

    Dell PERC

    +
    • + +
  • +

    Dell PERC 2/SC

    +
    • + +
  • +

    Dell PERC 2/DC

    +
    • + +
  • +

    Dell PERC 3/DCL

    +
    • + +
  • +

    HP NetRaid-1si

    +
    • + +
  • +

    HP NetRaid-3si

    +
    • + +
  • +

    HP Embedded NetRaid

    +
    • +
+ +
+
+

Booting from these controllers is not supported + due to SRM limitations.

+
+
+
+
+ +

Mylex DAC960 and DAC1100 RAID controllers with 2.x, + 3.x, 4.x and 5.x firmware ( + mlx(4) + driver)

+ +
    +
  • +

    DAC960P

    +
    • + +
  • +

    DAC960PD

    +
    • + +
  • +

    DAC960PDU

    +
    • + +
  • +

    DAC960PL

    +
    • + +
  • +

    DAC960PJ

    +
    • + +
  • +

    DAC960PG

    +
    • + +
  • +

    AcceleRAID 150

    +
    • + +
  • +

    AcceleRAID 250

    +
    • + +
  • +

    eXtremeRAID 1100

    +
    • +
+ +
+
+

Booting from these controllers is not supported + due to SRM limitations. This list includes + controllers sold by Digital/Compaq in Alpha systems + in the StorageWorks family, e.g. KZPSC or KZPAC.

+
+
+
+
+ +

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 ( + ncr(4) and + sym(4) + drivers)

+ +
    +
  • +

    ASUS SC-200, SC-896

    +
    • + +
  • +

    Data Technology DTC3130 (all variants)

    +
    • + +
  • +

    DawiControl DC2976UW

    +
    • + +
  • +

    Diamond FirePort (all)

    +
    • + +
  • +

    NCR cards (all)

    +
    • + +
  • +

    Symbios cards (all)

    +
    • + +
  • +

    Tekram DC390W, 390U, 390F, 390U2B, 390U2W, 390U3D, + and 390U3W

    +
    • + +
  • +

    Tyan S1365

    +
    • +
+
+
+ +

Qlogic controllers and variants ( + isp(4) + driver)

+ +
    +
  • +

    Qlogic 1020, 1040 SCSI and Ultra SCSI host + adapters

    +
    • + +
  • +

    Qlogic 1240 dual Ultra SCSI controllers

    +
    • + +
  • +

    Qlogic 1080 Ultra2 LVD and 1280 Dual Ultra2 LVD + controllers

    +
    • + +
  • +

    Qlogic 12160 Ultra3 LVD controllers

    +
    • + +
  • +

    Qlogic 2100 and Qlogic 2200 Fibre Channel SCSI + controllers

    +
    • + +
  • +

    Qlogic 2300 and Qlogic 2312 2-Gigabit Fibre + Channel SCSI controllers

    +
    • + +
  • +

    Performance Technology SBS440 ISP1000 variants

    +
    • + +
  • +

    Performance Technology SBS450 ISP1040 variants

    +
    • + +
  • +

    Performance Technology SBS470 ISP2100 variants

    +
    • + +
  • +

    Antares Microsystems P-0033 ISP2100 variants

    +
    • +
+
+
+ +

LSI Logic Fusion/MP architecture Fiber Channel + controllers (mpt driver)

+ +
    +
  • +

    LSI FC909, FC929

    +
    • + +
  • +

    LSI 53c1020, 53c1030

    +
    • +
+
+
+ +

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 + cd(4)). + WORM/CD-R/CD-RW writing support is provided by + cdrecord(1), + which is a part of the + sysutils/cdrtools port in + the Ports Collection.

+ +

The following CD-ROM type systems are supported at + this time:

+ +
    +
  • +

    SCSI interface (also includes ProAudio Spectrum + and SoundBlaster SCSI) ( + cd(4))

    +
    • + +
  • +

    ATAPI IDE interface ( + acd(4))

    +
    • +
+
+
+
+ +
+
+ +

3.2 + Ethernet Interfaces

+ +

Adaptec Duralink PCI Fast Ethernet adapters based on + the Adaptec AIC-6915 Fast Ethernet controller chip ( + sf(4) driver)

+ +
    +
  • +

    ANA-62011 64-bit single port 10/100baseTX + adapter

    +
    • + +
  • +

    ANA-62022 64-bit dual port 10/100baseTX + adapter

    +
    • + +
  • +

    ANA-62044 64-bit quad port 10/100baseTX + adapter

    +
    • + +
  • +

    ANA-69011 32-bit single port 10/100baseTX + adapter

    +
    • + +
  • +

    ANA-62020 64-bit single port 100baseFX adapter

    +
    • +
+
+
+ +

AMD PCnet NICs ( + lnc(4) and + pcn(4) + drivers)

+ +
    +
  • +

    AMD PCnet/PCI (79c970 & 53c974 or 79c974)

    +
    • + +
  • +

    AMD PCnet/FAST

    +
    • + +
  • +

    Isolan AT 4141-0 (16 bit)

    +
    • + +
  • +

    Isolink 4110 (8 bit)

    +
    • + +
  • +

    PCnet/FAST+

    +
    • + +
  • +

    PCnet/FAST III

    +
    • + +
  • +

    PCnet/PRO

    +
    • + +
  • +

    PCnet/Home

    +
    • + +
  • +

    HomePNA

    +
    • +
+
+
+ +

RealTek 8129/8139 Fast Ethernet NICs ( + rl(4) driver)

+ +
    +
  • +

    Accton ``Cheetah'' EN1207D (MPX 5030/5038; RealTek + 8139 clone)

    +
    • + +
  • +

    Allied Telesyn AT2550

    +
    • + +
  • +

    Allied Telesyn AT2500TX

    +
    • + +
  • +

    D-Link DFE-530TX+, DFE-538TX

    +
    • + +
  • +

    Farallon NetLINE 10/100 PCI

    +
    • + +
  • +

    Genius GF100TXR (RTL8139)

    +
    • + +
  • +

    KTX-9130TX 10/100 Fast Ethernet

    +
    • + +
  • +

    NDC Communications NE100TX-E

    +
    • + +
  • +

    Netronix Inc. EA-1210 NetEther 10/100

    +
    • + +
  • +

    OvisLink LEF-8129TX

    +
    • + +
  • +

    OvisLink LEF-8139TX

    +
    • + +
  • +

    SMC EZ Card 10/100 PCI 1211-TX

    +
    • +
+
+
+ +

Lite-On 82c168/82c169 PNIC Fast Ethernet NICs ( + dc(4) driver)

+ +
    +
  • +

    Kingston KNE110TX

    +
    • + +
  • +

    LinkSys EtherFast LNE100TX

    +
    • + +
  • +

    Matrox FastNIC 10/100

    +
    • + +
  • +

    NetGear FA310-TX Rev. D1

    +
    • +
+
+
+ +

Macronix 98713, 98713A, 98715, 98715A and 98725 Fast + Ethernet NICs ( + dc(4) driver)

+ +
    +
  • +

    Accton EN1217 (98715A)

    +
    • + +
  • +

    Adico AE310TX (98715A)

    +
    • + +
  • +

    Compex RL100-TX (98713 or 98713A)

    +
    • + +
  • +

    CNet Pro120A (98713 or 98713A)

    +
    • + +
  • +

    CNet Pro120B (98715)

    +
    • + +
  • +

    NDC Communications SFA100A (98713A)

    +
    • + +
  • +

    SVEC PN102TX (98713)

    +
    • +
+
+
+ +

Macronix/Lite-On PNIC II LC82C115 Fast Ethernet NICs + ( + dc(4) driver)

+ +
    +
  • +

    LinkSys EtherFast LNE100TX Version 2

    +
    • +
+
+
+ +

Winbond W89C840F Fast Ethernet NICs ( + wb(4) driver)

+ +
    +
  • +

    Trendware TE100-PCIE

    +
    • +
+
+
+ +

VIA Technologies VT3043 ``Rhine I'', VT86C100A ``Rhine + II'', and VT86C105/VT86C105M ``Rhine III'' Fast Ethernet + NICs ( + vr(4) driver)

+ +
    +
  • +

    AOpen/Acer ALN-320

    +
    • + +
  • +

    D-Link DFE-530TX

    +
    • + +
  • +

    Hawking Technologies PN102TX

    +
    • +
+
+
+ +

Silicon Integrated Systems SiS 900 and SiS 7016 PCI + Fast Ethernet NICs ( + sis(4) + driver)

+ +
    +
  • +

    SiS 630, 635 and 735 motherboard chipsets

    +
    • +
+
+
+ +

National Semiconductor DP83815 Fast Ethernet NICs ( + sis(4) + driver)

+ +
    +
  • +

    NetGear FA311-TX

    +
    • + +
  • +

    NetGear FA312-TX

    +
    • +
+
+
+ +

Sundance Technologies ST201 PCI Fast Ethernet NICs ( + ste(4) + driver)

+ +
    +
  • +

    D-Link DFE-550TX

    +
    • +
+
+
+ +

SysKonnect SK-984x PCI Gigabit Ethernet cards ( + sk(4) + drivers)

+ +
    +
  • +

    SK-9821 1000baseT copper, single port

    +
    • + +
  • +

    SK-9822 1000baseT copper, dual port

    +
    • + +
  • +

    SK-9841 1000baseLX single mode fiber, single + port

    +
    • + +
  • +

    SK-9842 1000baseLX single mode fiber, dual + port

    +
    • + +
  • +

    SK-9843 1000baseSX multimode fiber, single + port

    +
    • + +
  • +

    SK-9844 1000baseSX multimode fiber, dual port

    +
    • +
+
+
+ +

Texas Instruments ThunderLAN PCI NICs ( + tl(4) driver)

+ +
    +
  • +

    Compaq Netelligent 10, 10/100, 10/100 + Dual-Port

    +
    • + +
  • +

    Compaq Netelligent 10/100 TX Embedded UTP, 10 T + PCI UTP/Coax, 10/100 TX UTP

    +
    • + +
  • +

    Compaq NetFlex 3P, 3P Integrated, 3P w/BNC

    +
    • + +
  • +

    Olicom OC-2135/2138, OC-2325, OC-2326 10/100 TX + UTP

    +
    • + +
  • +

    Racore 8165 10/100baseTX

    +
    • + +
  • +

    Racore 8148 10baseT/100baseTX/100baseFX + multi-personality

    +
    • +
+
+
+ +

ADMtek Inc. AL981-based PCI Fast Ethernet NICs ( + dc(4) driver)

+ +

ADMtek Inc. AN985-based PCI Fast Ethernet NICs ( + dc(4) driver)

+ +
    +
  • +

    LinkSys EtherFast LNE100TX v4.0/4.1

    +
    • +
+
+
+ +

ASIX Electronics AX88140A PCI NICs ( + dc(4) driver)

+ +
    +
  • +

    Alfa Inc. GFC2204

    +
    • + +
  • +

    CNet Pro110B

    +
    • +
+
+
+ +

DEC DC21040, DC21041, DC21140, DC21141, DC21142, and + DC21143 based NICs ( + de(4) driver)

+ +
    +
  • +

    Asante

    +
    • + +
  • +

    Cogent EM100FX and EM440TX

    +
    • + +
  • +

    DEC DE425, DE435, DE450, and DE500

    +
    • + +
  • +

    SMC Etherpower 8432T, 9332, and 9334

    +
    • + +
  • +

    ZYNX ZX 3xx

    +
    • +
+
+
+ +

DEC/Intel 21143 based Fast Ethernet NICs ( + dc(4) driver)

+ +
    +
  • +

    DEC DE500

    +
    • + +
  • +

    Compaq Presario 7900 series built-in Ethernet

    +
    • + +
  • +

    D-Link DFE-570TX

    +
    • + +
  • +

    Kingston KNE100TX

    +
    • + +
  • +

    LinkSys EtherFast 10/100 Instant GigaDrive + built-in Ethernet

    +
    • +
+
+
+ +

Davicom DM9009, DM9100 and DM9102 PCI Fast Ethernet + NICs ( + dc(4) driver)

+ +
    +
  • +

    Jaton Corporation XpressNet

    +
    • +
+
+
+ +

Intel 82557-, 82258-, 82559-, 82550- or 82562-based + Fast Ethernet NICs ( + fxp(4) + driver)

+ +
    +
  • +

    Intel EtherExpress Pro/100B PCI Fast Ethernet

    +
    • + +
  • +

    Intel InBusiness 10/100 PCI Network Adapter

    +
    • + +
  • +

    Intel PRO/100+ Management Adapter

    +
    • + +
  • +

    Intel Pro/100 VE Desktop Adapter

    +
    • + +
  • +

    Intel Pro/100 M Desktop Adapter

    +
    • + +
  • +

    Intel Pro/100 S Desktop, Server and Dual-Port + Server Adapters

    +
    • +
+
+
+ +

3Com Etherlink XL-based NICs ( + xl(4) driver)

+ +
    +
  • +

    3C900/905/905B/905C PCI

    +
    • + +
  • +

    3C555/556/556B MiniPCI

    +
    • + +
  • +

    3C450-TX HomeConnect adapter

    +
    • + +
  • +

    3c980/3c980B Fast Etherlink XL server adapter

    +
    • + +
  • +

    3cSOHO100-TX OfficeConnect adapter

    +
    • + +
  • +

    3C575TX/575B/XFE575BT/575C/656/656B/656C + (Cardbus)

    +
    • +
+
+
+ +

Ethernet and Fast Ethernet NICs based on the 3Com 3XP + Typhoon/Sidewinder (3CR990) chipset ( + txp(4) + driver)

+ +
    +
  • +

    3Com 3CR990-TX-95

    +
    • + +
  • +

    3Com 3CR990-TX-97

    +
    • + +
  • +

    3Com 3CR990B-SRV

    +
    • + +
  • +

    3Com 3CR990B-TXM

    +
    • + +
  • +

    3Com 3CR990SVR95

    +
    • + +
  • +

    3Com 3CR990SVR97

    +
    • +
+
+
+ +

Gigabit Ethernet NICs based on the Intel 82542 and + 82543 controller chips ( + gx(4) and + em(4) drivers), + plus NICs supported by the Intel 82540EM, 82544, 82545EM, + and 82546EB controller chips ( + em(4) driver + only)

+ +
    +
  • +

    Intel PRO/1000 Gigabit Ethernet

    +
    • +
+ +
+
+

Note: The + em(4) driver + is officially supported by Intel, but is only + supported on the i386.

+
+
+
+
+
+ +
+
+ +

3.3 FDDI + Interfaces

+ +

DEC DEFPA PCI ( + fpa(4) + driver)

+
+ +
+
+ +

3.4 ATM + Interfaces

+
+ +
+
+ +

3.5 + Wireless Network Interfaces

+
+ +
+
+ +

3.6 + Miscellaneous Networks

+
+ +
+
+ +

3.7 ISDN + Interfaces

+
+ +
+
+ +

3.8 + Serial Interfaces

+ +

``PC standard'' 8250, 16450, and 16550-based serial + ports ( + sio(4) + driver)

+ +

AST 4 port serial card using shared IRQ

+ +

Comtrol Rocketport card ( + rp(4) driver)

+
+ +
+
+ +

3.9 + Audio Devices

+ +

ESS

+ +
    +
  • +

    ES1868, ES1869, ES1879 and ES1888 ( + sbc(4) + driver)

    +
    • + +
  • +

    Maestro-1, Maestro-2, and Maestro-2E

    +
    • + +
  • +

    Maestro-3/Allegro

    + +
    +
    +

    Note: The Maestro-3/Allegro cannot be + compiled into the FreeBSD kernel due to licensing + restrictions. To use this driver, add the + following line to /boot/loader.conf:

    +
    +snd_maestro3_load="YES"
+
    +
    +
    +
    • +
+
+
+ +

MSS/WSS Compatible DSPs ( + pcm(4) + driver)

+ +

Creative Technologies SoundBlaster series ( + sbc(4) + driver)

+ +
    +
  • +

    SoundBlaster

    +
    • + +
  • +

    SoundBlaster Pro

    +
    • + +
  • +

    SoundBlaster AWE-32

    +
    • + +
  • +

    SoundBlaster AWE-64

    +
    • + +
  • +

    SoundBlaster AWE-64 GOLD

    +
    • + +
  • +

    SoundBlaster ViBRA-16

    +
    • +
+
+
+
+ +
+
+ +

3.10 + Camera and Video Capture Devices

+
+ +
+
+ +

3.11 USB + Devices

+ +

A range of USB peripherals are supported; devices + known to work are listed in this section. Owing to the + generic nature of most USB devices, with some exceptions + any device of a given class will be supported, even if + not explicitly listed here.

+ +
+
+

Note: USB Ethernet adapters can be found in + the section listing Ethernet + interfaces.

+
+
+ +
+
+

Note: USB Bluetooth adapters can be found + in Bluetooth section.

+
+
+ +

Host Controllers ( + ohci(4) and + uhci(4) + drivers)

+ +
    +
  • +

    ALi Aladdin-V

    +
    • + +
  • +

    AMD-756

    +
    • + +
  • +

    CMD Tech 670 & 673

    +
    • + +
  • +

    Intel 82371SB (PIIX3)

    +
    • + +
  • +

    Intel 82371AB and EB (PIIX4)

    +
    • + +
  • +

    Intel 82801AA (ICH)

    +
    • + +
  • +

    Intel 82801AB (ICH0)

    +
    • + +
  • +

    Intel 82801BA/BAM (ICH2)

    +
    • + +
  • +

    Intel 82443MX

    +
    • + +
  • +

    NEC uPD 9210

    +
    • + +
  • +

    OPTi 82C861 (FireLink)

    +
    • + +
  • +

    SiS 5571

    +
    • + +
  • +

    VIA 83C572 USB

    +
    • + +
  • +

    UHCI or OHCI compliant motherboard chipsets (no + exceptions known)

    +
    • +
+
+
+ +

Hubs

+ +
    +
  • +

    Andromeda hub

    +
    • + +
  • +

    MacAlly self powered hub (4 ports)

    +
    • + +
  • +

    NEC hub

    +
    • +
+
+
+ +

Keyboards ( + ukbd(4) + driver)

+ +
    +
  • +

    Apple iMac keyboard

    +
    • + +
  • +

    BTC BTC7935 keyboard with PS/2 mouse port

    +
    • + +
  • +

    Cherry G81-3504 keyboard

    +
    • + +
  • +

    Logitech M2452 keyboard

    +
    • + +
  • +

    MacAlly iKey keyboard

    +
    • + +
  • +

    Microsoft keyboard

    +
    • + +
  • +

    Sun Microsystems Type 6 USB keyboard

    +
    • +
+
+
+ +

Mice ( + ums(4) + driver)

+ +
    +
  • +

    Agiler Mouse 29UO

    +
    • + +
  • +

    Apple iMac Mouse

    +
    • + +
  • +

    Belkin Mouse

    +
    • + +
  • +

    Chic mouse

    +
    • + +
  • +

    Cypress mouse

    +
    • + +
  • +

    Genius Niche mouse

    +
    • + +
  • +

    Kensington Mouse-in-a-Box

    +
    • + +
  • +

    Logitech wheel mouse (3 buttons)

    +
    • + +
  • +

    Logitech PS/2 / USB mouse (3 buttons)

    +
    • + +
  • +

    MacAlly mouse (3 buttons)

    +
    • + +
  • +

    Microsoft IntelliMouse (3 buttons)

    +
    • + +
  • +

    Sun Microsystems Type 6 USB Mouse

    +
    • + +
  • +

    Trust Ami Mouse (3 buttons)

    +
    • +
+
+
+ +

Printers and parallel printer conversion cables ( + ulpt(4) + driver)

+ +
    +
  • +

    ATen parallel printer adapter

    +
    • + +
  • +

    Belkin F5U002 parallel printer adapter

    +
    • + +
  • +

    Entrega USB-to-parallel printer adapter

    +
    • +
+
+
+ +

Storage ( + umass(4) + driver)

+ +
    +
  • +

    ADTEC Stick Drive AD-UST32M, 64M, 128M, 256M

    +
    • + +
  • +

    Denno FireWire/USB2 Removable 2.5-inch HDD Case + MIFU-25CB20

    +
    • + +
  • +

    FujiFilm Zip USB Drive ZDR100 USB A

    +
    • + +
  • +

    GREEN HOUSE USB Flash Memory ``PicoDrive'' + GH-UFD32M, 64M, 128M

    +
    • + +
  • +

    IBM 32MB USB Memory Key (P/N 22P5296)

    +
    • + +
  • +

    IBM ThinkPad USB Portable CD-ROM Drive (P/N + 33L5151)

    +
    • + +
  • +

    I-O DATA USB x6 CD-RW Drive CDRW-i64/USB (CDROM + only)

    +
    • + +
  • +

    I-O DATA USB + CD/CD-R/CD-RW/DVD-R/DVD-RW/DVD-RAM/DVD-ROM Drive + DVR-iUH2 (CDROM, DVD-RAM only)

    +
    • + +
  • +

    Iomega Zip750 USB2.0 Drive

    +
    • + +
  • +

    Keian USB1.1/2.0 3.5-inch HDD Case KU350A

    +
    • + +
  • +

    Kurouto Shikou USB 2.5-inch HDD Case + GAWAP2.5PS-USB2.0

    +
    • + +
  • +

    Logitec USB1.1/2.0 HDD Unit SHD-E60U2

    +
    • + +
  • +

    Logitec Mobile USB Memory LMC-256UD

    +
    • + +
  • +

    Logitec USB Double-Speed Floppy Drive LFD-31U2

    +
    • + +
  • +

    Logitec USB/IEEE1394 DVD-RAM/R/RW Unit LDR-N21FU2 + (CDROM only)

    +
    • + +
  • +

    Matshita CF-VFDU03 floppy drive

    +
    • + +
  • +

    MELCO USB2.0 MO Drive MO-CH640U2

    +
    • + +
  • +

    I-O DATA USB/IEEE1394 Portable HD Drive + HDP-i30P/CI, HDP-i40P/CI

    +
    • + +
  • +

    MELCO USB Flash Disk ``PetitDrive'', RUF-32M, + -64M, -128M, -256M

    +
    • + +
  • +

    MELCO USB2.0 Flash Disk ``PetitDrive2'', + RUF-256M/U2, -512M/U2

    +
    • + +
  • +

    MELCO USB Flash Disk ``ClipDrive'', RUF-C32M, + -C64M, -C128M, -C256M, -C512M

    +
    • + +
  • +

    Microtech USB-SCSI-HD 50 USB to SCSI cable

    +
    • + +
  • +

    NOVAC USB2.0 2.5/3.5-inch HDD Case NV-HD351U

    +
    • + +
  • +

    Panasonic floppy drive

    +
    • + +
  • +

    Panasonic USB2.0 Portable CD-RW Drive KXL-RW40AN + (CDROM only)

    +
    • + +
  • +

    RATOC Systems USB2.0 Removable HDD Case U2-MDK1, + U2-MDK1B

    +
    • + +
  • +

    Sony Portable CD-R/RW Drive CRX10U (CDROM + only)

    +
    • + +
  • +

    TEAC Portable USB CD-ROM Unit CD-110PU/210PU

    +
    • + +
  • +

    Y-E Data floppy drive (720/1.44/2.88Mb)

    +
    • +
+
+
+
+ +
+
+ +

3.12 + IEEE 1394 (Firewire) Devices

+
+ +
+
+ +

3.13 + Bluetooth Devices

+
+ +
+
+ +

3.14 + Cryptographic Accelerators

+
+ +
+
+ +

3.15 + Miscellaneous

+ +

Floppy drives ( + fdc(4) + driver)

+ +

VGA-compatible video cards ( + vga(4) + driver)

+ +
+
+

Note: Information regarding specific video + cards and compatibility with XFree86 can be found at http://www.xfree86.org/.

+
+
+
+
+ +

Keyboards including:

+ +
    +
  • +

    AT-style keyboards ( + atkbd(4) + driver)

    +
    • + +
  • +

    PS/2 keyboards ( + atkbd(4) + driver)

    +
    • + +
  • +

    USB keyboards (specific instances are listed in + the section describing USB + devices)

    +
    • +
+
+
+ +

Pointing devices including:

+ +
    +
  • +

    PS/2 mice and compatible devices, including many + laptop pointing devices ( + psm(4) + driver)

    +
    • + +
  • +

    Serial mice and compatible devices

    +
    • + +
  • +

    USB mice (specific instances are listed in the + section describing USB + devices)

    +
    • +
+ +
+
+

Note: + moused(8) has + more information on using pointing devices with + FreeBSD. Information on using pointing devices with + XFree86 can be found at http://www.xfree86.org/.

+
+
+
+
+ +

``PC standard'' parallel ports ( + ppc(4) + driver)

+
+
+
+
+ +

This file, and other release-related + documents, can be downloaded from ftp://ftp.FreeBSD.org/.

+ +

For questions about FreeBSD, read the + documentation + before contacting <questions@FreeBSD.org>.

+ +

All users of FreeBSD 5-CURRENT + should subscribe to the <current@FreeBSD.org> + mailing list.

+ +

For questions about this documentation, + e-mail <doc@FreeBSD.org>.

+
+
+ + + diff --git a/en/releases/5.1R/hardware-i386.html b/en/releases/5.1R/hardware-i386.html new file mode 100644 index 0000000000..d228215b5a --- /dev/null +++ b/en/releases/5.1R/hardware-i386.html @@ -0,0 +1,5036 @@ + + + + + FreeBSD/i386 5.1-RELEASE Hardware Notes + + + + + +
+
+

FreeBSD/i386 + 5.1-RELEASE Hardware Notes

+ +

The FreeBSD Documentation + Project

+ +

Copyright © 2000, 2001, 2002, + 2003 by The FreeBSD Documentation Project

+
+
+ +
+
+
Table of Contents
+ +
1 Introduction
+ +
2 Supported Processors and + Motherboards
+ +
3 Supported Devices
+ +
+
+
3.1 Disk Controllers
+ +
3.2 Ethernet + Interfaces
+ +
3.3 FDDI Interfaces
+ +
3.4 ATM Interfaces
+ +
3.5 Wireless Network + Interfaces
+ +
3.6 Miscellaneous + Networks
+ +
3.7 ISDN Interfaces
+ +
3.8 Serial Interfaces
+ +
3.9 Audio Devices
+ +
3.10 Camera and Video Capture + Devices
+ +
3.11 USB Devices
+ +
3.12 IEEE 1394 (Firewire) + Devices
+ +
3.13 Bluetooth + Devices
+ +
3.14 Cryptographic + Accelerators
+ +
3.15 Miscellaneous
+
+
+
+
+ +
+
+ +

1 + Introduction

+ +

This document contains the hardware compatibility notes + for FreeBSD 5.1-RELEASE on the i386 hardware platform (also + referred to as FreeBSD/i386 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.

+ +
+
+

Note: This document includes information + specific to the i386 hardware platform. Versions of the + hardware compatibility notes for other architectures + will differ in some details.

+
+
+
+ +
+
+ +

2 Supported + Processors and Motherboards

+ +

FreeBSD/i386 runs on a wide variety of ``IBM PC + compatible'' machines. Due to the wide range of hardware + available for this architecture, it is impossible to + exhaustively list all combinations of equipment supported + by FreeBSD. Nevertheless, some general guidelines are + presented here.

+ +

Almost all i386-compatible processors are supported. All + Intel processors beginning with the 80386 are supported, + including the 80386, 80486, Pentium, Pentium Pro, Pentium + II, Pentium III, Pentium 4, and variants thereof, such as + the Xeon and Celeron processors. (While technically + supported, the use of the 80386SX is specifically not + recommended.) All i386-compatible AMD processors are also + supported, including the Am486, Am5x86, K5, K6 (and + variants), Athlon (including Athlon-MP, Athlon-XP, + Athlon-4, and Athlon Thunderbird), and Duron processors. + The AMD Élan SC520 embedded processor is supported. + The Transmeta Crusoe is recognized and supported, as are + i386-compatible processors from Cyrix and NexGen.

+ +

There is a wide variety of motherboards available for + this architecture. Motherboards using the ISA, VLB, EISA, + AGP, and PCI expansion busses are well-supported. There is + some limited support for the MCA (``MicroChannel'') + expansion bus used in the IBM PS/2 line of PCs.

+ +

Symmetric multi-processor (SMP) systems are generally + supported by FreeBSD, although in some cases, BIOS or + motherboard bugs may generate some problems. Perusal of the + archives of the FreeBSD symmetric multiprocessing mailing + list may yield some clues.

+ +

FreeBSD will take advantage of HyperThreading (HTT) + support on Intel CPUs that support this feature. A kernel + with the options SMP feature + enabled will automatically detect the additional logical + processors. The default FreeBSD scheduler treats the + logical processors the same as additional physical + processors; in other words, no attempt is made to optimize + scheduling decisions given the shared resources between + logical processors within the same CPU. Because this naive + scheduling can result in suboptimal performance, the + logical CPUs are halted by default at startup. They can be + enabled with the machdep.hlt_logical_cpus sysctl + variable. It is also possible to halt any CPU in the idle + loop with the machdep.hlt_cpus + sysctl variable. The + smp(4) manual page + has more details.

+ +

FreeBSD will take advantage of Physical Address + Extensions (PAE) support on CPUs that support this feature. + A kernel with the PAE feature + enabled will detect memory above 4 gigabytes and allow it + to be used by the system. This feature places constraints + on the device drivers and other features of FreeBSD which + may be used; consult the + pae(4) manpage for + more details.

+ +

FreeBSD will generally run on i386-based laptops, albeit + with varying levels of support for certain hardware + features such as sound, graphics, power management, and + PCCARD expansion slots. These features tend to vary in + idiosyncratic ways between machines, and frequently require + special-case support in FreeBSD to work around hardware + bugs or other oddities. When in doubt, a search of the + archives of the FreeBSD laptop computer mailing list may + be useful.

+ +

Most modern laptops (as well as many desktops) use the + Advanced Configuration and Power Management (ACPI) + standard. FreeBSD supports ACPI via the ACPI Component + Architecture reference implementation from Intel, as + described in the + acpi(4) manual + page. The use of ACPI causes instabilities on some machines + and it may be necessary to disable the ACPI driver, which + is normally loaded via a kernel module. This may be + accomplished by adding the following line to /boot/device.hints:

+
+hint.acpi.0.disabled="1"
+
+ +

Users debugging ACPI-related problems may find it useful + to disable portions of the ACPI functionality. The + acpi(4) manual page + has more information on how to do this via loader + tunables.

+ +

ACPI depends on a Differentiated System Descriptor Table + (DSDT) provided by each machine's BIOS. Some machines have + bad or incomplete DSDTs, which prevents ACPI from + functioning correctly. Replacement DSDTs for some machines + can be found at the DSDT section of the ACPI4Linux project Web site. FreeBSD can + use these DSDTs to override the DSDT provided by the BIOS; + see the + acpi(4) manual page + for more information.

+
+ +
+
+ +

3 + Supported Devices

+ $FreeBSD: + src/release/doc/en_US.ISO8859-1/hardware/common/dev.sgml,v + 1.157 2003/05/30 11:24:00 nyan Exp $ + +

This section describes the devices currently known to be + supported by with FreeBSD on the i386 platform. Other + configurations may also work, but simply have not been + tested yet. Feedback, updates, and corrections to this list + are encouraged.

+ +

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.

+ +
+
+ +

3.1 Disk + Controllers

+ +

IDE/ATA controllers ( + ata(4) + driver)

+ +
    +
  • +

    Acard ATP850 UDMA2, ATP860 UDMA4, ATP865 UDMA6

    +
    • + +
  • +

    AMD 756 ATA66, 766 ATA100, 768 ATA100

    +
    • + +
  • +

    Cenatek Rocket Drive

    +
    • + +
  • +

    CMD 646, 648 ATA66, and 649 ATA100

    +
    • + +
  • +

    Cypress 82C693

    +
    • + +
  • +

    Cyrix 5530 ATA33

    +
    • + +
  • +

    HighPoint HPT366 ATA66, HPT370 ATA100, HPT372 + ATA133, HPT374 ATA133

    +
    • + +
  • +

    Intel PIIX, PIIX3, PIIX4

    +
    • + +
  • +

    Intel ICH ATA66, ICH2 ATA100, ICH3 ATA100, ICH4 + ATA100

    +
    • + +
  • +

    nVidia nForce ATA100, nForce2 ATA133

    +
    • + +
  • +

    Promise ATA100 OEM chip (pdc20265)

    +
    • + +
  • +

    Promise ATA133 OEM chip (pdc20269)

    +
    • + +
  • +

    Promise Fasttrak-33, -66, -100, -100 TX2/TX4, -133 + TX2/TX2000

    +
    • + +
  • +

    Promise SATA150 TX2/TX4 Serial ATA/150

    +
    • + +
  • +

    Promise Ultra-33, -66, -100, -133 + TX2/TX2000/TX4000

    +
    • + +
  • +

    ServerWorks ROSB4 ATA33

    +
    • + +
  • +

    ServerWorks CSB5 and CSB6 ATA66/ATA100

    +
    • + +
  • +

    Sil 0680 UDMA6

    +
    • + +
  • +

    SiS 530, 540, 550, 620

    +
    • + +
  • +

    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

    +
    • + +
  • +

    SiS 5591 ATA100

    +
    • + +
  • +

    VIA 82C586 ATA33, 82C596 ATA66, 82C686a ATA66, + 82C686b ATA100

    +
    • + +
  • +

    VIA 8233, 8235 ATA133

    +
    • +
+
+
+ +

Adaptec SCSI Controllers

+ +
    +
  • +

    Adaptec 1535 ISA SCSI controllers

    +
    • + +
  • +

    Adaptec 154x series ISA SCSI controllers ( + aha(4) + driver)

    +
    • + +
  • +

    Adaptec 164x series MCA SCSI controllers ( + aha(4) + driver)

    +
    • + +
  • +

    Adaptec 174x series EISA SCSI controller in + standard and enhanced mode ( + aha(4) and + ahb(4) + driver)

    +
    • + +
  • +

    Adaptec 274x series EISA SCSI controllers, + including narrow and wide variants ( + ahc(4) + driver)

    +
    • + +
  • +

    Adaptec 284x series VLB SCSI controllers, + including narrow and wide variants ( + ahc(4) + driver)

    +
    • + +
  • +

    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 ( + ahc(4) + driver)

    +
    • + +
  • +

    Adaptec AIC7770, AIC7850, AIC7860, AIC7870, + AIC7880, and AIC789x on-board SCSI controllers ( + ahc(4) + driver)

    +
    • + +
  • +

    Adaptec 1510 series ISA SCSI controllers (not for + bootable devices)

    +
    • + +
  • +

    Adaptec 152x series ISA SCSI controllers ( + aha(4) + driver)

    +
    • + +
  • +

    Adaptec AIC-6260 and AIC-6360 based boards, which + includes the AHA-152x and SoundBlaster SCSI cards ( + aic(4) + driver)

    +
    • +
+
+
+ +

Ultra-320 SCSI controllers based on the Adaptec + AIC7901, AIC7901A, and AIC7902 Ultra320 controller chips + ( + ahd(4) + driver)

+ +
    +
  • +

    Adaptec 29320, 29320A, 29320B, 29320LP

    +
    • + +
  • +

    Adaptec 39320, 39320D

    +
    • +
+
+
+ +

Adaptec 21x0S/32x0S/34x0S SCSI RAID controllers ( + asr(4) + driver)

+ +

Adaptec 2000S/2005S Zero-Channel RAID controllers ( + asr(4) + driver)

+ +

Adaptec 2400A ATA-100 RAID controller ( + asr(4) + driver)

+ +

Adaptec FSA family RAID controllers ( + aac(4) + driver)

+ +
    +
  • +

    Adaptec AAC-2622

    +
    • + +
  • +

    Adaptec AAC-364

    +
    • + +
  • +

    Adaptec SCSI RAID 2120S

    +
    • + +
  • +

    Adaptec SCSI RAID 2200S

    +
    • + +
  • +

    Adaptec SCSI RAID 5400S

    +
    • + +
  • +

    Dell PERC 2/QC

    +
    • + +
  • +

    Dell PERC 2/Si

    +
    • + +
  • +

    Dell PERC 3/Di

    +
    • + +
  • +

    Dell PERC 3/QC

    +
    • + +
  • +

    Dell PERC 3/Si

    +
    • + +
  • +

    HP NetRAID-4M

    +
    • +
+
+
+ +

AdvanSys SCSI controllers (all models, + adv(4) and + adw(4) + drivers)

+
+
+ +

BusLogic MultiMaster ``W'' Series Host Adapters ( + bt(4) + driver):

+ +
    +
  • +

    BT-948

    +
    • + +
  • +

    BT-958

    +
    • + +
  • +

    BT-958D

    +
    • +
+
+
+ +

BusLogic MultiMaster ``C'' Series Host Adapters ( + bt(4) + driver):

+ +
    +
  • +

    BT-946C

    +
    • + +
  • +

    BT-956C

    +
    • + +
  • +

    BT-956CD

    +
    • + +
  • +

    BT-445C

    +
    • + +
  • +

    BT-747C

    +
    • + +
  • +

    BT-757C

    +
    • + +
  • +

    BT-757CD

    +
    • + +
  • +

    BT-545C

    +
    • + +
  • +

    BT-540CF

    +
    • +
+
+
+ +

BusLogic MultiMaster ``S'' Series Host Adapters ( + bt(4) + driver):

+ +
    +
  • +

    BT-445S

    +
    • + +
  • +

    BT-747S

    +
    • + +
  • +

    BT-747D

    +
    • + +
  • +

    BT-757S

    +
    • + +
  • +

    BT-757D

    +
    • + +
  • +

    BT-545S

    +
    • + +
  • +

    BT-542D

    +
    • + +
  • +

    BT-742A

    +
    • + +
  • +

    BT-542B

    +
    • +
+
+
+ +

BusLogic MultiMaster ``A'' Series Host Adapters ( + bt(4) + driver):

+ +
    +
  • +

    BT-742A

    +
    • + +
  • +

    BT-542B

    +
    • +
+
+
+ +
+
+

Note: BusLogic/Mylex ``Flashpoint'' + adapters are not yet supported.

+
+
+ +
+
+

Note: AMI FastDisk controllers that are + true BusLogic MultiMaster clones are also + supported.

+
+
+ +
+
+

Note: The Buslogic/Bustek BT-640 and + Storage Dimensions SDC3211B and SDC3211F Microchannel + (MCA) bus adapters are also supported.

+
+
+ +

DPT SmartCACHE Plus, SmartCACHE III, SmartRAID III, + SmartCACHE IV and SmartRAID IV SCSI/RAID controllers ( + dpt(4) + driver)

+ +

DPT SmartRAID V and VI SCSI RAID controllers ( + asr(4) + driver)

+ +
    +
  • +

    PM1554

    +
    • + +
  • +

    PM2554

    +
    • + +
  • +

    PM2654

    +
    • + +
  • +

    PM2865

    +
    • + +
  • +

    PM2754

    +
    • + +
  • +

    PM3755

    +
    • + +
  • +

    PM3757

    +
    • +
+
+
+ +

AMI MegaRAID Express and Enterprise family RAID + controllers ( + amr(4) + driver)

+ +
    +
  • +

    MegaRAID Series 418

    +
    • + +
  • +

    MegaRAID Enterprise 1200 (Series 428)

    +
    • + +
  • +

    MegaRAID Enterprise 1300 (Series 434)

    +
    • + +
  • +

    MegaRAID Enterprise 1400 (Series 438)

    +
    • + +
  • +

    MegaRAID Enterprise 1500 (Series 467)

    +
    • + +
  • +

    MegaRAID Enterprise 1600 (Series 471)

    +
    • + +
  • +

    MegaRAID Elite 1500 (Series 467)

    +
    • + +
  • +

    MegaRAID Elite 1600 (Series 493)

    +
    • + +
  • +

    MegaRAID Express 100 (Series 466WS)

    +
    • + +
  • +

    MegaRAID Express 200 (Series 466)

    +
    • + +
  • +

    MegaRAID Express 300 (Series 490)

    +
    • + +
  • +

    MegaRAID Express 500 (Series 475)

    +
    • + +
  • +

    Dell PERC

    +
    • + +
  • +

    Dell PERC 2/SC

    +
    • + +
  • +

    Dell PERC 2/DC

    +
    • + +
  • +

    Dell PERC 3/DCL

    +
    • + +
  • +

    HP NetRaid-1si

    +
    • + +
  • +

    HP NetRaid-3si

    +
    • + +
  • +

    HP Embedded NetRaid

    +
    • +
+ +
+
+

Note: Booting from these controllers is + supported. EISA adapters are not supported.

+
+
+
+
+ +

Mylex DAC960 and DAC1100 RAID controllers with 2.x, + 3.x, 4.x and 5.x firmware ( + mlx(4) + driver)

+ +
    +
  • +

    DAC960P

    +
    • + +
  • +

    DAC960PD

    +
    • + +
  • +

    DAC960PDU

    +
    • + +
  • +

    DAC960PL

    +
    • + +
  • +

    DAC960PJ

    +
    • + +
  • +

    DAC960PG

    +
    • + +
  • +

    AcceleRAID 150

    +
    • + +
  • +

    AcceleRAID 250

    +
    • + +
  • +

    eXtremeRAID 1100

    +
    • +
+ +
+
+

Note: Booting from these controllers is + supported. EISA adapters are not supported.

+
+
+
+
+ +

Mylex PCI to SCSI RAID controllers with 6.x firmware + ( + mly(4) + driver)

+ +
    +
  • +

    AcceleRAID 160

    +
    • + +
  • +

    AcceleRAID 170

    +
    • + +
  • +

    AcceleRAID 352

    +
    • + +
  • +

    eXtremeRAID 2000

    +
    • + +
  • +

    eXtremeRAID 3000

    +
    • +
+ +
+
+

Note: Compatible Mylex controllers not + listed should work, but have not been verified.

+
+
+
+
+ +

3ware Escalade ATA RAID controllers ( + twe(4) + driver)

+ +
    +
  • +

    5000 series

    +
    • + +
  • +

    6000 series

    +
    • + +
  • +

    7000 series

    +
    • +
+
+
+ +

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 ( + ncr(4) and + sym(4) + drivers)

+ +
    +
  • +

    ASUS SC-200, SC-896

    +
    • + +
  • +

    Data Technology DTC3130 (all variants)

    +
    • + +
  • +

    DawiControl DC2976UW

    +
    • + +
  • +

    Diamond FirePort (all)

    +
    • + +
  • +

    NCR cards (all)

    +
    • + +
  • +

    Symbios cards (all)

    +
    • + +
  • +

    Tekram DC390W, 390U, 390F, 390U2B, 390U2W, 390U3D, + and 390U3W

    +
    • + +
  • +

    Tyan S1365

    +
    • +
+
+
+ +

NCR 53C500 based PC-Card SCSI host adapters (ncv + driver)

+ +
    +
  • +

    IO DATA PCSC-DV

    +
    • + +
  • +

    KME KXLC002 (TAXAN ICD-400PN, etc.), KXLC004

    +
    • + +
  • +

    Macnica Miracle SCSI-II mPS110

    +
    • + +
  • +

    Media Intelligent MSC-110, MSC-200

    +
    • + +
  • +

    NEC PC-9801N-J03R

    +
    • + +
  • +

    New Media Corporation BASICS SCSI

    +
    • + +
  • +

    Qlogic Fast SCSI

    +
    • + +
  • +

    RATOC REX-9530, REX-5572 (as SCSI only)

    +
    • +
+
+
+ +

TMC 18C30, 18C50 based ISA/PC-Card SCSI host adapters + (stg driver)

+ +
    +
  • +

    Future Domain SCSI2GO

    +
    • + +
  • +

    IBM SCSI PCMCIA Card

    +
    • + +
  • +

    ICM PSC-2401 SCSI

    +
    • + +
  • +

    MELCO IFC-SC

    +
    • + +
  • +

    RATOC REX-5536, REX-5536AM, REX-5536M, + REX-9836A

    +
    • +
+
+
+ +

Qlogic controllers and variants ( + isp(4) + driver)

+ +
    +
  • +

    Qlogic 1020, 1040 SCSI and Ultra SCSI host + adapters

    +
    • + +
  • +

    Qlogic 1240 dual Ultra SCSI controllers

    +
    • + +
  • +

    Qlogic 1080 Ultra2 LVD and 1280 Dual Ultra2 LVD + controllers

    +
    • + +
  • +

    Qlogic 12160 Ultra3 LVD controllers

    +
    • + +
  • +

    Qlogic 2100 and Qlogic 2200 Fibre Channel SCSI + controllers

    +
    • + +
  • +

    Qlogic 2300 and Qlogic 2312 2-Gigabit Fibre + Channel SCSI controllers

    +
    • + +
  • +

    Performance Technology SBS440 ISP1000 variants

    +
    • + +
  • +

    Performance Technology SBS450 ISP1040 variants

    +
    • + +
  • +

    Performance Technology SBS470 ISP2100 variants

    +
    • + +
  • +

    Antares Microsystems P-0033 ISP2100 variants

    +
    • +
+
+
+ +

DTC 3290 EISA SCSI controller in 1542 emulation + mode.

+ +

Tekram DC390 and DC390T controllers, maybe other cards + based on the AMD 53c974 as well ( + amd(4) + driver)

+ +

Workbit Ninja SCSI-3 based PC-Card SCSI host adapters + (nsp driver)

+ +
    +
  • +

    Alpha-Data AD-PCS201

    +
    • + +
  • +

    IO DATA CBSC16

    +
    • +
+
+
+ +

Parallel to SCSI interfaces ( + vpo(4) + driver)

+ +
    +
  • +

    AIC 7110 SCSI controller (built-in to Iomega ZIP + drive)

    +
    • + +
  • +

    Iomega Jaz Traveller interface

    +
    • + +
  • +

    Iomega MatchMaker SCSI interface (built-in to + Iomega ZIP+ drive)

    +
    • +
+
+
+ +

Compaq Intelligent Drive Array Controllers ( + ida(4) + driver)

+ +
    +
  • +

    Compaq SMART Array 221

    +
    • + +
  • +

    Compaq Integrated SMART Array Controller

    +
    • + +
  • +

    Compaq SMART Array 4200, 4250ES Controllers

    +
    • + +
  • +

    Compaq SMART Array 3200, 3100ES Controller

    +
    • + +
  • +

    Compaq SMART-2/DH, SMART-2/SL, SMART-2/P, + SMART-2E, and SMART Controllers

    +
    • +
+
+
+ +

SCSI adapters utilizing the Command Interface for + SCSI-3 Support ( + ciss(4) + driver)

+ +
    +
  • +

    Compaq Smart Array 5* series (5300, 5i, 532)

    +
    • +
+
+
+ +

Intel Integrated RAID Controllers ( + iir(4) + driver)

+ +
    +
  • +

    Intel RAID Controller SRCMR

    +
    • + +
  • +

    ICP Vortex SCSI RAID controllers (all + Wide/Ultra160, 32-bit/64-bit PCI models)

    +
    • +
+
+
+ +

Promise SuperTrak ATA RAID controllers ( + pst(4) + driver)

+ +
    +
  • +

    Promise SuperTrak SX6000 ATA RAID controller

    +
    • +
+
+
+ +

IBM / Adaptec ServeRAID series (ips driver)

+ +

LSI Logic Fusion/MP architecture Fiber Channel + controllers (mpt driver)

+ +
    +
  • +

    LSI FC909, FC929

    +
    • + +
  • +

    LSI 53c1020, 53c1030

    +
    • +
+
+
+ +

PCI SCSI host adapters using the Tekram TRM-S1040 SCSI + chipset ( + trm(4) + driver)

+ +
    +
  • +

    Tekram DC395U/UW/U2W/F

    +
    • + +
  • +

    Tekram DC315U

    +
    • +
+
+
+ +

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 + cd(4)). + WORM/CD-R/CD-RW writing support is provided by + cdrecord(1), + which is a part of the + sysutils/cdrtools port in + the Ports Collection.

+ +

The following CD-ROM type systems are supported at + this time:

+ +
    +
  • +

    SCSI interface (also includes ProAudio Spectrum + and SoundBlaster SCSI) ( + cd(4))

    +
    • + +
  • +

    Sony proprietary interface (all models) ( + scd(4))

    +
    • + +
  • +

    ATAPI IDE interface ( + acd(4))

    +
    • +
+
+
+ +

The following drivers were supported under the old + SCSI subsystem, but are not yet supported under the + cam(4) SCSI + subsystem:

+ +
    +
  • +

    NCR5380/NCR53400 (``ProAudio Spectrum'') SCSI + controller

    +
    • + +
  • +

    UltraStor 14F, 24F and 34F SCSI controllers.

    + +
    +
    +

    Note: There is work-in-progress to port + the UltraStor driver to the new CAM SCSI + framework, but no estimates on when or if it will + be completed.

    +
    +
    +
    +
    +
    • + +
  • +

    Seagate ST01/02 SCSI controllers

    +
    • + +
  • +

    Future Domain 8xx/950 series SCSI controllers

    +
    • + +
  • +

    WD7000 SCSI controller

    +
    • +
+
+
+ +

The following device is unmaintained:

+ +
    +
  • +

    Mitsumi proprietary CD-ROM interface (all models) + ( + mcd(4))

    +
    • +
+
+
+
+ +
+
+ +

3.2 + Ethernet Interfaces

+ +

Adaptec Duralink PCI Fast Ethernet adapters based on + the Adaptec AIC-6915 Fast Ethernet controller chip ( + sf(4) driver)

+ +
    +
  • +

    ANA-62011 64-bit single port 10/100baseTX + adapter

    +
    • + +
  • +

    ANA-62022 64-bit dual port 10/100baseTX + adapter

    +
    • + +
  • +

    ANA-62044 64-bit quad port 10/100baseTX + adapter

    +
    • + +
  • +

    ANA-69011 32-bit single port 10/100baseTX + adapter

    +
    • + +
  • +

    ANA-62020 64-bit single port 100baseFX adapter

    +
    • +
+
+
+ +

Allied-Telesis AT1700 and RE2000 cards ( + fe(4) driver)

+ +
    +
  • +

    CONTEC C-NET(PC)C PCMCIA Ethernet

    +
    • + +
  • +

    Fujitsu MBH10303, MBH10302 Ethernet PCMCIA

    +
    • + +
  • +

    Fujitsu Towa LA501 Ethernet

    +
    • + +
  • +

    Fujitsu FMV-J182, FMV-J182A

    +
    • + +
  • +

    RATOC REX-5588, REX-9822, REX-4886, and + REX-R280

    +
    • + +
  • +

    Eiger Labs EPX-10BT

    +
    • + +
  • +

    HITACHI HT-4840-11

    +
    • + +
  • +

    NextCom J Link NC5310

    +
    • + +
  • +

    TDK LAK-CD021, LAK-CD021A, LAK-CD021BX

    +
    • +
+
+
+ +

Alteon Networks PCI Gigabit Ethernet NICs based on the + Tigon 1 and Tigon 2 chipsets ( + ti(4) driver)

+ +
    +
  • +

    3Com 3c985-SX (Tigon 1 and 2)

    +
    • + +
  • +

    Alteon AceNIC (Tigon 1 and 2)

    +
    • + +
  • +

    Alteon AceNIC 1000baseT (Tigon 2)

    +
    • + +
  • +

    Asante PCI 1000BASE-SX Gigabit Ethernet + Adapter

    +
    • + +
  • +

    Asante GigaNIX1000T Gigabit Ethernet Adapter

    +
    • + +
  • +

    DEC/Compaq EtherWORKS 1000

    +
    • + +
  • +

    Farallon PN9000SX

    +
    • + +
  • +

    NEC Gigabit Ethernet

    +
    • + +
  • +

    Netgear GA620 (Tigon 2)

    +
    • + +
  • +

    Netgear GA620T (Tigon 2, 1000baseT)

    +
    • + +
  • +

    Silicon Graphics Gigabit Ethernet

    +
    • +
+
+
+ +

AMD PCnet NICs ( + lnc(4) and + pcn(4) + drivers)

+ +
    +
  • +

    AMD PCnet/PCI (79c970 & 53c974 or 79c974)

    +
    • + +
  • +

    AMD PCnet/FAST

    +
    • + +
  • +

    Isolan AT 4141-0 (16 bit)

    +
    • + +
  • +

    Isolink 4110 (8 bit)

    +
    • + +
  • +

    PCnet/FAST+

    +
    • + +
  • +

    PCnet/FAST III

    +
    • + +
  • +

    PCnet/PRO

    +
    • + +
  • +

    PCnet/Home

    +
    • + +
  • +

    HomePNA

    +
    • +
+
+
+ +

SMC 83c17x (EPIC)-based Ethernet NICs ( + tx(4) driver)

+ +
    +
  • +

    SMC EtherPower II 9432 series

    +
    • +
+
+
+ +

National Semiconductor DS8390-based Ethernet NICs, + including Novell NE2000 and clones ( + ed(4) driver)

+ +
    +
  • +

    3C503 Etherlink II ( + ed(4) + driver)

    +
    • + +
  • +

    DEC Etherworks DE305

    +
    • + +
  • +

    Hewlett-Packard PC Lan+ 27247B and 27252A

    +
    • + +
  • +

    NetVin 5000

    +
    • + +
  • +

    Novell NE1000, NE2000, and NE2100

    +
    • + +
  • +

    RealTek 8029

    +
    • + +
  • +

    SMC Elite 16 WD8013 Ethernet interface

    +
    • + +
  • +

    SMC Elite Ultra

    +
    • + +
  • +

    SMC WD8003E, WD8003EBT, WD8003W, WD8013W, WD8003S, + WD8003SBT and WD8013EBT and clones

    +
    • + +
  • +

    Surecom NE-34

    +
    • + +
  • +

    VIA VT86C926

    +
    • + +
  • +

    Winbond W89C940

    +
    • +
+
+
+ +

NE2000 compatible PC-Card (PCMCIA) Ethernet and + FastEthernet cards ( + ed(4) driver)

+ +
    +
  • +

    AR-P500 Ethernet

    +
    • + +
  • +

    Accton EN2212/EN2216/UE2216

    +
    • + +
  • +

    Allied Telesis CentreCOM LA100-PCM_V2

    +
    • + +
  • +

    AmbiCom 10BaseT card

    +
    • + +
  • +

    BayNetworks NETGEAR FA410TXC Fast Ethernet

    +
    • + +
  • +

    CNet BC40 adapter

    +
    • + +
  • +

    COREGA Ether PCC-T/EtherII PCC-T/FEther + PCC-TXF/PCC-TXD

    +
    • + +
  • +

    Compex Net-A adapter

    +
    • + +
  • +

    CyQ've ELA-010

    +
    • + +
  • +

    D-Link DE-650/660

    +
    • + +
  • +

    Danpex EN-6200P2

    +
    • + +
  • +

    Elecom Laneed LD-CDL/TX, LD-CDF, LD-CDS, + LD-10/100CD, LD-CDWA (DP83902A), MACNICA Ethernet ME1 + for JEIDA

    +
    • + +
  • +

    IO DATA PCLATE

    +
    • + +
  • +

    IBM Creditcard Ethernet I/II

    +
    • + +
  • +

    IC-CARD Ethernet/IC-CARD+ Ethernet

    +
    • + +
  • +

    Kingston KNE-PC2, KNE-PCM/x Ethernet

    +
    • + +
  • +

    Linksys EC2T/PCMPC100/PCM100, PCMLM56, EtherFast + 10/100 PC Card, Combo PCMCIA Ethernet Card (PCMPC100 + V2)

    +
    • + +
  • +

    MELCO + LPC-T/LPC2-T/LPC2-CLT/LPC2-TX/LPC3-TX/LPC3-CLX

    +
    • + +
  • +

    NDC Ethernet Instant-Link

    +
    • + +
  • +

    National Semiconductor InfoMover NE4100

    +
    • + +
  • +

    NetGear FA-410TX

    +
    • + +
  • +

    Network Everywhere Ethernet 10BaseT PC Card

    +
    • + +
  • +

    Planex FNW-3600-T

    +
    • + +
  • +

    Socket LP-E

    +
    • + +
  • +

    Surecom EtherPerfect EP-427

    +
    • + +
  • +

    TDK LAK-CD031,Grey Cell GCS2000 Ethernet Card

    +
    • + +
  • +

    Telecom Device SuperSocket RE450T

    +
    • +
+
+
+ +

RealTek RTL 8002 Pocket Ethernet ( + rdp(4) + driver)

+ +

RealTek 8129/8139 Fast Ethernet NICs ( + rl(4) driver)

+ +
    +
  • +

    Accton ``Cheetah'' EN1207D (MPX 5030/5038; RealTek + 8139 clone)

    +
    • + +
  • +

    Allied Telesyn AT2550

    +
    • + +
  • +

    Allied Telesyn AT2500TX

    +
    • + +
  • +

    D-Link DFE-530TX+, DFE-538TX

    +
    • + +
  • +

    Farallon NetLINE 10/100 PCI

    +
    • + +
  • +

    Genius GF100TXR (RTL8139)

    +
    • + +
  • +

    KTX-9130TX 10/100 Fast Ethernet

    +
    • + +
  • +

    NDC Communications NE100TX-E

    +
    • + +
  • +

    Netronix Inc. EA-1210 NetEther 10/100

    +
    • + +
  • +

    OvisLink LEF-8129TX

    +
    • + +
  • +

    OvisLink LEF-8139TX

    +
    • + +
  • +

    SMC EZ Card 10/100 PCI 1211-TX

    +
    • +
+
+
+ +

Lite-On 82c168/82c169 PNIC Fast Ethernet NICs ( + dc(4) driver)

+ +
    +
  • +

    Kingston KNE110TX

    +
    • + +
  • +

    LinkSys EtherFast LNE100TX

    +
    • + +
  • +

    Matrox FastNIC 10/100

    +
    • + +
  • +

    NetGear FA310-TX Rev. D1

    +
    • +
+
+
+ +

Macronix 98713, 98713A, 98715, 98715A and 98725 Fast + Ethernet NICs ( + dc(4) driver)

+ +
    +
  • +

    Accton EN1217 (98715A)

    +
    • + +
  • +

    Adico AE310TX (98715A)

    +
    • + +
  • +

    Compex RL100-TX (98713 or 98713A)

    +
    • + +
  • +

    CNet Pro120A (98713 or 98713A)

    +
    • + +
  • +

    CNet Pro120B (98715)

    +
    • + +
  • +

    NDC Communications SFA100A (98713A)

    +
    • + +
  • +

    SVEC PN102TX (98713)

    +
    • +
+
+
+ +

Macronix/Lite-On PNIC II LC82C115 Fast Ethernet NICs + ( + dc(4) driver)

+ +
    +
  • +

    LinkSys EtherFast LNE100TX Version 2

    +
    • +
+
+
+ +

Winbond W89C840F Fast Ethernet NICs ( + wb(4) driver)

+ +
    +
  • +

    Trendware TE100-PCIE

    +
    • +
+
+
+ +

VIA Technologies VT3043 ``Rhine I'', VT86C100A ``Rhine + II'', and VT86C105/VT86C105M ``Rhine III'' Fast Ethernet + NICs ( + vr(4) driver)

+ +
    +
  • +

    AOpen/Acer ALN-320

    +
    • + +
  • +

    D-Link DFE-530TX

    +
    • + +
  • +

    Hawking Technologies PN102TX

    +
    • +
+
+
+ +

Silicon Integrated Systems SiS 900 and SiS 7016 PCI + Fast Ethernet NICs ( + sis(4) + driver)

+ +
    +
  • +

    SiS 630, 635 and 735 motherboard chipsets

    +
    • +
+
+
+ +

National Semiconductor DP83815 Fast Ethernet NICs ( + sis(4) + driver)

+ +
    +
  • +

    NetGear FA311-TX

    +
    • + +
  • +

    NetGear FA312-TX

    +
    • +
+
+
+ +

National Semiconductor DP83820 and DP83821 Gigabit + Ethernet NICs ( + nge(4) + driver)

+ +
    +
  • +

    Addtron AEG320T

    +
    • + +
  • +

    Ark PC SOHO-GA2500T (32-bit PCI) and SOHO-GA2000T + (64-bit PCI)

    +
    • + +
  • +

    Asante FriendlyNet GigaNIC 1000TA and 1000TPC

    +
    • + +
  • +

    D-Link DGE-500T

    +
    • + +
  • +

    LinkSys EG1032 (32-bit PCI) and EG1064 (64-bit + PCI)

    +
    • + +
  • +

    Netgear GA621 and GA622T

    +
    • + +
  • +

    SMC EZ Card 1000 (SMC9462TX)

    +
    • + +
  • +

    Surecom Technology EP-320G-TX

    +
    • + +
  • +

    Trendware TEG-PCITX (32-bit PCI) and TEG-PCITX2 + (64-bit PCI)

    +
    • +
+
+
+ +

Sundance Technologies ST201 PCI Fast Ethernet NICs ( + ste(4) + driver)

+ +
    +
  • +

    D-Link DFE-550TX

    +
    • +
+
+
+ +

SysKonnect SK-984x PCI Gigabit Ethernet cards ( + sk(4) + drivers)

+ +
    +
  • +

    SK-9821 1000baseT copper, single port

    +
    • + +
  • +

    SK-9822 1000baseT copper, dual port

    +
    • + +
  • +

    SK-9841 1000baseLX single mode fiber, single + port

    +
    • + +
  • +

    SK-9842 1000baseLX single mode fiber, dual + port

    +
    • + +
  • +

    SK-9843 1000baseSX multimode fiber, single + port

    +
    • + +
  • +

    SK-9844 1000baseSX multimode fiber, dual port

    +
    • +
+
+
+ +

Texas Instruments ThunderLAN PCI NICs ( + tl(4) driver)

+ +
    +
  • +

    Compaq Netelligent 10, 10/100, 10/100 + Dual-Port

    +
    • + +
  • +

    Compaq Netelligent 10/100 Proliant

    +
    • + +
  • +

    Compaq Netelligent 10/100 TX Embedded UTP, 10 T + PCI UTP/Coax, 10/100 TX UTP

    +
    • + +
  • +

    Compaq NetFlex 3P, 3P Integrated, 3P w/BNC

    +
    • + +
  • +

    Olicom OC-2135/2138, OC-2325, OC-2326 10/100 TX + UTP

    +
    • + +
  • +

    Racore 8165 10/100baseTX

    +
    • + +
  • +

    Racore 8148 10baseT/100baseTX/100baseFX + multi-personality

    +
    • +
+
+
+ +

ADMtek Inc. AL981-based PCI Fast Ethernet NICs ( + dc(4) driver)

+ +

ADMtek Inc. AN985-based PCI Fast Ethernet NICs ( + dc(4) driver)

+ +
    +
  • +

    LinkSys EtherFast LNE100TX v4.0/4.1

    +
    • +
+
+
+ +

ADMtek Inc. AN986-based USB Ethernet NICs ( + aue(4) + driver)

+ +
    +
  • +

    Abocom UFE1000, DSB650TX_NA

    +
    • + +
  • +

    Accton USB320-EC, SpeedStream

    +
    • + +
  • +

    ADMtek AN986, AN8511

    +
    • + +
  • +

    Billionton USB100, USB100LP, USB100EL, USBE100

    +
    • + +
  • +

    Corega Ether FEther USB-T, FEther USB-TX, FEther + USB-TXS

    +
    • + +
  • +

    D-Link DSB-650, DSB-650TX, DSB-650TX-PNA

    +
    • + +
  • +

    Elecom LD-USBL/TX

    +
    • + +
  • +

    Elsa Microlink USB2Ethernet

    +
    • + +
  • +

    I-O Data USB ETTX

    +
    • + +
  • +

    Kingston KNU101TX

    +
    • + +
  • +

    LinkSys USB10T, USB10TA, USB10TX, USB100TX, + USB100H1

    +
    • + +
  • +

    MELCO LUA-TX, LUA2-TX

    +
    • + +
  • +

    Planex UE-200TX

    +
    • + +
  • +

    Siemens Speedstream

    +
    • + +
  • +

    SmartBridges smartNIC

    +
    • + +
  • +

    SMC 2202USB

    +
    • + +
  • +

    SOHOware NUB100

    +
    • +
+
+
+ +

CATC USB-EL1210A-based USB Ethernet NICs ( + cue(4) + driver)

+ +
    +
  • +

    Belkin F5U011, F5U111

    +
    • + +
  • +

    CATC Netmate, Netmate II

    +
    • + +
  • +

    SmartBridges SmartLink

    +
    • +
+
+
+ +

Kawasaki LSI KU5KUSB101B-based USB Ethernet NICs ( + kue(4) + driver)

+ +
    +
  • +

    3Com 3c19250

    +
    • + +
  • +

    AOX USB101

    +
    • + +
  • +

    Abocom URE 450

    +
    • + +
  • +

    ADS Technologies USB-10BT

    +
    • + +
  • +

    ATen UC10T

    +
    • + +
  • +

    Corega USB-T

    +
    • + +
  • +

    D-Link DSB-650C

    +
    • + +
  • +

    Entrega NET-USB-E45

    +
    • + +
  • +

    I/O Data USB ETT

    +
    • + +
  • +

    Kawasaki DU-H3E

    +
    • + +
  • +

    LinkSys USB10T

    +
    • + +
  • +

    Netgear EA101

    +
    • + +
  • +

    Peracom USB Ethernet Adapter

    +
    • + +
  • +

    SMC 2102USB, 2104USB

    +
    • +
+
+
+ +

ASIX Electronics AX88172-based USB Ethernet NICs ( + axe(4) + driver)

+ +
    +
  • +

    D-Link DUBE100

    +
    • + +
  • +

    Linksys USB200M

    +
    • + +
  • +

    Netgear FA120

    +
    • +
+
+
+ +

RealTek RTL8150-based USB Ethernet NICs ( + rue(4) + driver)

+ +
    +
  • +

    GREEN HOUSE GH-USB100B

    +
    • + +
  • +

    MELCO LUA-KTX

    +
    • +
+
+
+ +

ASIX Electronics AX88140A PCI NICs ( + dc(4) driver)

+ +
    +
  • +

    Alfa Inc. GFC2204

    +
    • + +
  • +

    CNet Pro110B

    +
    • +
+
+
+ +

DEC EtherWORKS II and III NICs ( + le(4) driver)

+ +
    +
  • +

    DE200, DE201, DE202, DE422

    +
    • + +
  • +

    DE203, DE204, DE205

    +
    • +
+
+
+ +

DEC DC21040, DC21041, DC21140, DC21141, DC21142, and + DC21143 based NICs ( + de(4) driver)

+ +
    +
  • +

    Asante

    +
    • + +
  • +

    Cogent EM100FX and EM440TX

    +
    • + +
  • +

    DEC DE425, DE435, DE450, and DE500

    +
    • + +
  • +

    SMC Etherpower 8432T, 9332, and 9334

    +
    • + +
  • +

    ZYNX ZX 3xx

    +
    • +
+
+
+ +

DEC/Intel 21143 based Fast Ethernet NICs ( + dc(4) driver)

+ +
    +
  • +

    DEC DE500

    +
    • + +
  • +

    Compaq Presario 7900 series built-in Ethernet

    +
    • + +
  • +

    D-Link DFE-570TX

    +
    • + +
  • +

    Kingston KNE100TX

    +
    • + +
  • +

    LinkSys EtherFast 10/100 Instant GigaDrive + built-in Ethernet

    +
    • +
+
+
+ +

Davicom DM9009, DM9100 and DM9102 PCI Fast Ethernet + NICs ( + dc(4) driver)

+ +
    +
  • +

    Jaton Corporation XpressNet

    +
    • +
+
+
+ +

Xircom 3201 (Cardbus) ( + dc(4) driver)

+ +

Conexant LANfinity RS7112 (MiniPCI) ( + dc(4) driver)

+ +

Fujitsu MB86960A/MB86965A based Fast Ethernet NICs ( + fe(4) driver)

+ +
    +
  • +

    CONTEC C-NET(PC)C Ethernet

    +
    • + +
  • +

    Eiger Labs EPX-10BT

    +
    • + +
  • +

    Fujitsu FMV-J182, FMV-J182A, MBH10302, MBH10303 + Ethernet PCMCIA

    +
    • + +
  • +

    Fujitsu Towa LA501 Ethernet

    +
    • + +
  • +

    HITACHI HT-4840-11

    +
    • + +
  • +

    NextCom J Link NC5310

    +
    • + +
  • +

    RATOC REX-5588, REX-9822, REX-4886, REX-R280

    +
    • + +
  • +

    TDK LAK-CD021, LAK-CD021A, LAK-CD021BX

    +
    • +
+
+
+ +

Intel 82557-, 82258-, 82559-, 82550- or 82562-based + Fast Ethernet NICs ( + fxp(4) + driver)

+ +
    +
  • +

    Intel EtherExpress Pro/100B PCI Fast Ethernet

    +
    • + +
  • +

    Intel InBusiness 10/100 PCI Network Adapter

    +
    • + +
  • +

    Intel PRO/100+ Management Adapter

    +
    • + +
  • +

    Intel Pro/100 VE Desktop Adapter

    +
    • + +
  • +

    Intel Pro/100 M Desktop Adapter

    +
    • + +
  • +

    Intel Pro/100 S Desktop, Server and Dual-Port + Server Adapters

    +
    • + +
  • +

    On-board Ethernet NICs on many Intel + motherboards.

    +
    • +
+
+
+ +

Intel 82595-based Ethernet NICs ( + ex(4) driver)

+ +
    +
  • +

    Intel EtherExpress Pro/10 and Pro/10+ Ethernet

    +
    • + +
  • +

    Olicom OC2220

    +
    • +
+
+
+ +

Intel 82586-based Ethernet NICs ( + ie(4) driver)

+ +
    +
  • +

    3Com 3C507 Etherlink 16/TP

    +
    • + +
  • +

    AT&T Starlan 10 and Starlan Fiber

    +
    • + +
  • +

    EN100

    +
    • + +
  • +

    Intel EtherExpress 16

    +
    • + +
  • +

    RACAL Interlan NI5210

    +
    • +
+
+
+ +

3Com 3C5x9 Etherlink III NICs ( + ep(4) driver)

+ +
    +
  • +

    3C509

    +
    • + +
  • +

    3C529 MCA

    +
    • + +
  • +

    3C579 EISA

    +
    • + +
  • +

    3CXE589EC, 3CXE589ET PCMCIA

    +
    • + +
  • +

    3C589/589B/589C/589D/589E/574TX/574B + PC-card/PCMCIA

    +
    • + +
  • +

    Megahertz 3CCFEM556BI, 3CXEM556, 3CCFEM556B

    +
    • + +
  • +

    OfficeConnect 3CXSH572BT

    +
    • + +
  • +

    Farallon EtherMac

    +
    • +
+
+
+ +

3Com 3C501 8-bit ISA Ethernet NIC ( + el(4) driver)

+ +

3Com Etherlink XL-based NICs ( + xl(4) driver)

+ +
    +
  • +

    3C900/905/905B/905C PCI

    +
    • + +
  • +

    3C555/556/556B MiniPCI

    +
    • + +
  • +

    3C450-TX HomeConnect adapter

    +
    • + +
  • +

    3c980/3c980B Fast Etherlink XL server adapter

    +
    • + +
  • +

    3cSOHO100-TX OfficeConnect adapter

    +
    • + +
  • +

    3C575TX/575B/XFE575BT/575C/656/656B/656C + (Cardbus)

    +
    • + +
  • +

    Dell Optiplex GX1 on-board 3C918

    +
    • + +
  • +

    Dell On-board 3C920

    +
    • + +
  • +

    Dell Precision on-board 3C905B

    +
    • + +
  • +

    Dell Latitude laptop docking station embedded + 3C905-TX

    +
    • +
+
+
+ +

3Com 3C59X series NICs ( + vx(4) driver)

+ +
    +
  • +

    3C590 Etherlink III (PCI)

    +
    • + +
  • +

    3C595 Fast Etherlink III (PCI)

    +
    • + +
  • +

    3C592/3C597 (EISA)

    +
    • +
+
+
+ +

Crystal Semiconductor CS89x0-based NICs ( + cs(4) driver)

+ +
    +
  • +

    IBM Etherjet ISA

    +
    • +
+
+
+ +

Megahertz X-Jack Ethernet PC-Card CC-10BT ( + sn(4) driver)

+ +

Xircom X3201 (Cardbus) based Ethernet cards, including + the following:

+ +
    +
  • +

    IBM EtherJet Cardbus Adapter

    +
    • + +
  • +

    Intel PRO/100 Mobile Cardbus (versions that use + the X3201 chipset)

    +
    • + +
  • +

    Xircom Cardbus Realport

    +
    • + +
  • +

    Xircom Cardbus Ethernet 10/100

    +
    • + +
  • +

    Xircom Cardbus Ethernet II 10/100

    +
    • +
+
+
+ +

Xircom CreditCard adapters (16 bit) and workalikes (xe + driver)

+ +
    +
  • +

    Accton EN2226/Fast EtherCard (16-bit version)

    +
    • + +
  • +

    Compaq Netelligent 10/100 PC Card

    +
    • + +
  • +

    Intel EtherExpress PRO/100 Mobile Adapter (16-bit + version)

    +
    • + +
  • +

    Xircom 10/100 Network PC Card adapter

    +
    • + +
  • +

    Xircom Realport card + modem(Ethernet part)

    +
    • + +
  • +

    Xircom CreditCard Ethernet 10/100

    +
    • + +
  • +

    Xircom CreditCard 10Base-T ``CreditCard Ethernet + Adapter IIps'' (PS-CE2-10)

    +
    • + +
  • +

    Xircom CreditCard Ethernet 10/100 + modem + (Ethernet part)

    +
    • +
+
+
+ +

Gigabit Ethernet cards based on the Level 1 LXT1001 + NetCellerator controller ( + lge(4) + driver)

+ +
    +
  • +

    D-Link DGE-500SX

    +
    • + +
  • +

    SMC TigerCard 1000 (SMC9462SX)

    +
    • +
+
+
+ +

Ethernet and Fast Ethernet NICs based on the 3Com 3XP + Typhoon/Sidewinder (3CR990) chipset ( + txp(4) + driver)

+ +
    +
  • +

    3Com 3CR990-TX-95

    +
    • + +
  • +

    3Com 3CR990-TX-97

    +
    • + +
  • +

    3Com 3CR990B-SRV

    +
    • + +
  • +

    3Com 3CR990B-TXM

    +
    • + +
  • +

    3Com 3CR990SVR95

    +
    • + +
  • +

    3Com 3CR990SVR97

    +
    • +
+
+
+ +

Gigabit Ethernet NICs based on the Broadcom BCM570x + ( + bge(4) + driver)

+ +
    +
  • +

    3Com 3c996-SX, 3c996-T

    +
    • + +
  • +

    Netgear GA302T

    +
    • + +
  • +

    SysKonnect SK-9D21 and 9D41

    +
    • + +
  • +

    Integrated Gigabit Ethernet NICs on DELL PowerEdge + 2550 servers

    +
    • + +
  • +

    Integrated Gigabit Ethernet NICs on IBM x235 + servers

    +
    • +
+
+
+ +

Gigabit Ethernet NICs based on the Intel 82542 and + 82543 controller chips ( + gx(4) and + em(4) drivers), + plus NICs supported by the Intel 82540EM, 82544, 82545EM, + and 82546EB controller chips ( + em(4) driver + only)

+ +
    +
  • +

    Intel PRO/1000 Gigabit Ethernet

    +
    • +
+ +
+
+

Note: The + em(4) driver + is officially supported by Intel, but is only + supported on the i386.

+
+
+
+
+ +

Myson Ethernet NICs (my driver)

+ +
    +
  • +

    Myson MTD80X Based Fast Ethernet Card

    +
    • + +
  • +

    Myson MTD89X Based Gigabit Ethernet Card

    +
    • +
+
+
+
+ +
+
+ +

3.3 FDDI + Interfaces

+ +

DEC DEFPA PCI ( + fpa(4) + driver)

+ +

DEC DEFEA EISA ( + fpa(4) + driver)

+
+ +
+
+ +

3.4 ATM + Interfaces

+ +

Efficient Networks, Inc. ENI-155p ATM PCI Adapters + (hea driver)

+ +

FORE Systems, Inc. PCA-200E ATM PCI Adapters (hfa + driver)

+ +

IDT 77201/211 NICStAR ATM Adapters (idt driver)

+ +

FORE Systems, Inc. LE155 ATM Adapter (idt driver)

+ +

The ATM support in FreeBSD supports the following + signaling protocols:

+ +
    +
  • +

    The ATM Forum UNI 3.1 signaling protocol

    +
    • + +
  • +

    The ATM Forum UNI 3.0 signaling protocol

    +
    • + +
  • +

    The ATM Forum ILMI address registration

    +
    • + +
  • +

    FORE Systems' proprietary SPANS signaling + protocol

    +
    • + +
  • +

    Permanent Virtual Channels (PVCs)

    +
    • +
+
+
+ +

Support for the IETF ``Classical IP and ARP over ATM'' + model is provided, compliant with the following RFCs and + Internet Drafts:

+ +
    +
  • +

    RFC 1483, ``Multiprotocol Encapsulation over ATM + Adaptation Layer 5''

    +
    • + +
  • +

    RFC 1577, ``Classical IP and ARP over ATM''

    +
    • + +
  • +

    RFC 1626, ``Default IP MTU for use over ATM + AAL5''

    +
    • + +
  • +

    RFC 1755, ``ATM Signaling Support for IP over + ATM''

    +
    • + +
  • +

    RFC 2225, ``Classical IP and ARP over ATM''

    +
    • + +
  • +

    RFC 2334, ``Server Cache Synchronization Protocol + (SCSP)''

    +
    • + +
  • +

    Internet Draft draft-ietf-ion-scsp-atmarp-00.txt, + ``A Distributed ATMARP Service Using SCSP''

    +
    • +
+
+
+ +

Support for an ATM sockets interface is also + provided.

+
+ +
+
+ +

3.5 + Wireless Network Interfaces

+ +

NCR / AT&T / Lucent Technologies WaveLan T1-speed + ISA/radio LAN cards ( + wl(4) driver)

+ +

Lucent Technologies WaveLAN/IEEE 802.11 PCMCIA and ISA + standard speed (2Mbps) and turbo speed (6Mbps) wireless + network adapters and workalikes ( + wi(4) driver)

+ +
+
+

Note: The ISA versions of these adapters + are actually PCMCIA cards combined with an ISA to + PCMCIA bridge card, so both kinds of devices work + with the same driver.

+
+
+ +
    +
  • +

    3COM 3crwe737A AirConnect Wireless LAN PC Card

    +
    • + +
  • +

    Accton airDirect WN3301

    +
    • + +
  • +

    Addtron AWA100

    +
    • + +
  • +

    Adtec ADLINK340APC

    +
    • + +
  • +

    Airway 802.11 Adapter

    +
    • + +
  • +

    Avaya Wireless PC Card

    +
    • + +
  • +

    Blue Concentric Circle CF Wireless LAN Model + WL-379F

    +
    • + +
  • +

    BreezeNET PC-DS.11

    +
    • + +
  • +

    Buffalo WLI-CF-S11G

    +
    • + +
  • +

    Cabletron RoamAbout 802.11 DS

    +
    • + +
  • +

    Compaq WL100, WL110

    +
    • + +
  • +

    Corega KK Wireless LAN PCC-11, PCCA-11, + PCCB-11

    +
    • + +
  • +

    D-Link DWL-650

    +
    • + +
  • +

    Dell TrueMobile 1150 Series

    +
    • + +
  • +

    ELECOM Air@Hawk/LD-WL11/PCC

    +
    • + +
  • +

    ELSA AirLancer MC-11

    +
    • + +
  • +

    Farallon Skyline 11Mbps Wireless

    +
    • + +
  • +

    ICOM SL-1100

    +
    • + +
  • +

    IBM High Rate Wireless LAN PC Card

    +
    • + +
  • +

    Intel PRO/Wireless 2011 LAN PC Card

    +
    • + +
  • +

    IO Data WN-B11/PCM

    +
    • + +
  • +

    Laneed Wireless card

    +
    • + +
  • +

    Linksys Instant Wireless WPC11

    +
    • + +
  • +

    Lucent WaveLAN/IEEE 802.11

    +
    • + +
  • +

    MELCO Airconnect WLI-PCM-S11, WLI-PCM-L11

    +
    • + +
  • +

    NCR WaveLAN/IEEE 802.11

    +
    • + +
  • +

    NEC Wireless Card CMZ-RT-WP

    +
    • + +
  • +

    NEC Aterm WL11C (PC-WL/11C)

    +
    • + +
  • +

    NEC PK-WL001

    +
    • + +
  • +

    Netgear MA401

    +
    • + +
  • +

    PLANEX GeoWave/GW-NS110

    +
    • + +
  • +

    Proxim Harmony, RangeLAN-DS

    +
    • + +
  • +

    SMC 2632W, 2602W

    +
    • + +
  • +

    Sony PCWA-C100

    +
    • + +
  • +

    TDK LAK-CD011WL

    +
    • + +
  • +

    Toshiba Wireless LAN Card

    +
    • + +
  • +

    US Robotics Wireless Card 2410

    +
    • +
+
+
+ +

Aironet 802.11 wireless adapters ( + an(4) driver)

+ +
    +
  • +

    Aironet 4500/4800 series (PCMCIA, PCI, and ISA + adapters are all supported)

    +
    • + +
  • +

    Cisco Systems Aironet 340 and 350 series (PCMCIA, + PCI, Mini-PCI, and ISA adapters are all + supported)

    +
    • + +
  • +

    Xircom Wireless Ethernet adapter (rebadged + Aironet)

    +
    • +
+
+
+ +

Raytheon Raylink 2.4GHz wireless adapters ( + ray(4) + driver)

+ +
    +
  • +

    Webgear Aviator

    +
    • + +
  • +

    Webgear Aviator Pro

    +
    • + +
  • +

    Raytheon Raylink PC Card

    +
    • +
+
+
+ +

AMD Am79C930 and Harris (Intersil) based 802.11 cards + ( + awi(4) + driver)

+ +
    +
  • +

    BayStack 650 and 660

    +
    • + +
  • +

    Farallon SkyLINE Wireless

    +
    • + +
  • +

    Icom SL-200

    +
    • + +
  • +

    MELCO WLI-PCM

    +
    • + +
  • +

    NEL SSMagic

    +
    • + +
  • +

    Netwave AirSurfer Plus and AirSurfer Pro

    +
    • + +
  • +

    ZoomAir 4000

    +
    • +
+
+
+
+ +
+
+ +

3.6 + Miscellaneous Networks

+ +

Granch SBNI12 point-to-point communications adapters + ( + sbni(4) + driver)

+ +
    +
  • +

    SBNI12-XX and SBNI12D-XX ISA and PCI

    +
    • +
+
+
+ +

Granch SBNI16 SHDSL modems ( + sbsh(4) + driver)

+ +

SMC COM90cx6 ARCNET network adapters (cm driver)

+ +
    +
  • +

    SMC 90c26, 90c56, and 90c66 in 90c56 compatability + mode

    +
    • +
+
+
+ +

LAN Media Corp WAN adapters based on the DEC ``Tulip'' + Fast Ethernet controller ( + lmc(4) + driver)

+ +
    +
  • +

    LMC1000 Synchronous Serial Interface adapter

    +
    • + +
  • +

    LMC1200 T1/E1 WAN adapter

    +
    • + +
  • +

    LMC5200 High Speed Synchronous Interface (HSSI) + adapter

    +
    • + +
  • +

    LMC5245 DS3 WAN adapter

    +
    • +
+
+
+
+ +
+
+ +

3.7 ISDN + Interfaces

+ +

AcerISDN P10 ISA PnP (experimental)

+ +

Asuscom ISDNlink 128K ISA

+ +

ASUSCOM P-IN100-ST-D (and other Winbond W6692-based + cards)

+ +

AVM

+ +
    +
  • +

    A1

    +
    • + +
  • +

    B1 ISA (tested with V2.0)

    +
    • + +
  • +

    B1 PCI (tested with V4.0)

    +
    • + +
  • +

    Fritz!Card classic

    +
    • + +
  • +

    Fritz!Card PnP

    +
    • + +
  • +

    Fritz!Card PCI

    +
    • + +
  • +

    Fritz!Card PCI, Version 2

    +
    • + +
  • +

    T1

    +
    • +
+
+
+ +

Creatix

+ +
    +
  • +

    ISDN-S0

    +
    • + +
  • +

    ISDN-S0 P&P

    +
    • +
+
+
+ +

Compaq Microcom 610 ISDN (Compaq series PSB2222I) ISA + PnP

+ +

Dr. Neuhaus Niccy Go@ and compatibles

+ +

Dynalink IS64PPH and IS64PPH+

+ +

Eicon Diehl DIVA 2.0 and 2.02

+ +

ELSA

+ +
    +
  • +

    ELSA PCC-16

    +
    • + +
  • +

    QuickStep 1000pro ISA

    +
    • + +
  • +

    MicroLink ISDN/PCI

    +
    • + +
  • +

    QuickStep 1000pro PCI

    +
    • +
+
+
+ +

ITK ix1 Micro ( < V.3, non-PnP version )

+ +

Sedlbauer Win Speed

+ +

Siemens I-Surf 2.0

+ +

TELEINT ISDN SPEED No.1 (experimental)

+ +

Teles

+ +
    +
  • +

    S0/8

    +
    • + +
  • +

    S0/16

    +
    • + +
  • +

    S0/16.3

    +
    • + +
  • +

    S0/16.3 PnP

    +
    • + +
  • +

    16.3c ISA PnP (experimental)

    +
    • + +
  • +

    Teles PCI-TJ

    +
    • +
+
+
+ +

Traverse Technologies NETjet-S PCI

+ +

USRobotics Sportster ISDN TA intern

+ +

Winbond W6692 based PCI cards

+
+ +
+
+ +

3.8 + Serial Interfaces

+ +

``PC standard'' 8250, 16450, and 16550-based serial + ports ( + sio(4) + driver)

+ +

AST 4 port serial card using shared IRQ

+ +

ARNET serial cards ( + ar(4) driver)

+ +
    +
  • +

    ARNET 8 port serial card using shared IRQ

    +
    • + +
  • +

    ARNET (now Digiboard) Sync 570/i high-speed + serial

    +
    • +
+
+
+ +

Boca multi-port serial cards

+ +
    +
  • +

    Boca BB1004 4-Port serial card (Modems not + supported)

    +
    • + +
  • +

    Boca IOAT66 6-Port serial card (Modems + supported)

    +
    • + +
  • +

    Boca BB1008 8-Port serial card (Modems not + supported)

    +
    • + +
  • +

    Boca BB2016 16-Port serial card (Modems + supported)

    +
    • +
+
+
+ +

Comtrol Rocketport card ( + rp(4) driver)

+ +

Cyclades Cyclom-Y serial board ( + cy(4) driver)

+ +

STB 4 port card using shared IRQ

+ +

DigiBoard intelligent serial cards ( + dgb(4) + driver)

+ +
    +
  • +

    DigiBoard PC/Xe series

    +
    • + +
  • +

    DigiBoard PC/Xi series

    +
    • +
+
+
+ +

PCI-Based multi-port serial boards ( + puc(4) + driver)

+ +
    +
  • +

    Actiontech 56K PCI

    +
    • + +
  • +

    Avlab Technology, PCI IO 2S and PCI IO 4S

    +
    • + +
  • +

    Comtrol RocketPort 550

    +
    • + +
  • +

    Decision Computers PCCOM 4-port serial and dual + port RS232/422/485

    +
    • + +
  • +

    Dolphin Peripherals 4025/4035/4036

    +
    • + +
  • +

    IC Book Labs Dreadnought 16x Lite and Pro

    +
    • + +
  • +

    Lava Computers + 2SP-PCI/DSerial-PCI/Quattro-PCI/Octopus-550

    +
    • + +
  • +

    Middle Digital, Weasle serial port

    +
    • + +
  • +

    Moxa Industio CP-114, Smartio C104H-PCI and + C168H/PCI

    +
    • + +
  • +

    NEC PK-UG-X001 and PK-UG-X008

    +
    • + +
  • +

    Netmos NM9835 PCI-2S-550

    +
    • + +
  • +

    Oxford Semiconductor OX16PCI954 PCI UART

    +
    • + +
  • +

    Syba Tech SD-LAB PCI-4S2P-550-ECP

    +
    • + +
  • +

    SIIG Cyber I/O PCI 16C550/16C650/16C850

    +
    • + +
  • +

    SIIG Cyber 2P1S PCI 16C550/16C650/16C850

    +
    • + +
  • +

    SIIG Cyber 2S1P PCI 16C550/16C650/16C850

    +
    • + +
  • +

    SIIG Cyber 4S PCI 16C550/16C650/16C850

    +
    • + +
  • +

    SIIG Cyber Serial (Single and Dual) PCI + 16C550/16C650/16C850

    +
    • + +
  • +

    Syba Tech Ltd. PCI-4S2P-550-ECP

    +
    • + +
  • +

    Titan PCI-200H and PCI-800H

    +
    • + +
  • +

    US Robotics (3Com) 3CP5609 modem

    +
    • + +
  • +

    VScom PCI-400 and PCI-800

    +
    • +
+
+
+ +

SDL Communication serial boards

+ +
    +
  • +

    SDL Communications Riscom/8 Serial Board (rc + driver)

    +
    • + +
  • +

    SDL Communications RISCom/N2 and N2pci high-speed + sync serial boards ( + sr(4) + driver)

    +
    • +
+
+
+ +

Stallion Technologies multiport serial boards

+ + +
+
+ +

Specialix SI/XIO/SX multiport serial cards, with both + the older SIHOST2.x and the new ``enhanced'' (transputer + based, aka JET) host cards (ISA, EISA and PCI are + supported) ( + si(4) driver)

+
+ +
+
+ +

3.9 + Audio Devices

+ +

Advance ( + sbc(4) + driver)

+ +
    +
  • +

    Asound 100 and 110

    +
    • + +
  • +

    Logic ALS120 and ALS4000

    +
    • +
+
+
+ +

CMedia sound chips

+ +
    +
  • +

    CMI8338/CMI8738

    +
    • +
+
+
+ +

Crystal Semiconductor ( + csa(4) + driver)

+ +
    +
  • +

    CS461x/462x Audio Accelerator

    +
    • + +
  • +

    CS428x Audio Controller

    +
    • +
+
+
+ +

ENSONIQ ( + pcm(4) + driver)

+ +
    +
  • +

    AudioPCI ES1370/1371

    +
    • +
+
+
+ +

ESS

+ +
    +
  • +

    ES1868, ES1869, ES1879 and ES1888 ( + sbc(4) + driver)

    +
    • + +
  • +

    Maestro-1, Maestro-2, and Maestro-2E

    +
    • + +
  • +

    Maestro-3/Allegro

    + +
    +
    +

    Note: The Maestro-3/Allegro cannot be + compiled into the FreeBSD kernel due to licensing + restrictions. To use this driver, add the + following line to /boot/loader.conf:

    +
    +snd_maestro3_load="YES"
+
    +
    +
    +
    • +
+
+
+ +

ForteMedia fm801

+ +

Gravis ( + gusc(4) + driver)

+ +
    +
  • +

    UltraSound MAX

    +
    • + +
  • +

    UltraSound PnP

    +
    • +
+
+
+ +

Intel 443MX, 810, 815, and 815E integrated sound + devices ( + pcm(4) + driver)

+ +

MSS/WSS Compatible DSPs ( + pcm(4) + driver)

+ +

NeoMagic 256AV/ZX ( + pcm(4) + driver)

+ +

OPTi 931/82C931 ( + pcm(4) + driver)

+ +

S3 Sonicvibes

+ +

Creative Technologies SoundBlaster series ( + sbc(4) + driver)

+ +
    +
  • +

    SoundBlaster

    +
    • + +
  • +

    SoundBlaster Pro

    +
    • + +
  • +

    SoundBlaster AWE-32

    +
    • + +
  • +

    SoundBlaster AWE-64

    +
    • + +
  • +

    SoundBlaster AWE-64 GOLD

    +
    • + +
  • +

    SoundBlaster ViBRA-16

    +
    • +
+
+
+ +

Creative Technologies Sound Blaster Live! series + (emu10k1 driver)

+ +

Trident 4DWave DX/NX ( + pcm(4) + driver)

+ +

VIA Technologies VT82C686A

+ +

Yamaha

+ +
    +
  • +

    DS1

    +
    • + +
  • +

    DS1e

    +
    • +
+
+
+
+ +
+
+ +

3.10 + Camera and Video Capture Devices

+ +

Brooktree Bt848/849/878/879-based frame grabbers ( + bktr(4) + driver)

+ +
    +
  • +

    AverMedia cards

    +
    • + +
  • +

    Hauppauge Wincast TV and WinTV boards (PCI)

    +
    • + +
  • +

    Intel Smart Video Recorder III

    +
    • + +
  • +

    Miro PC TV

    +
    • + +
  • +

    STB TV PCI

    +
    • + +
  • +

    Video Highway XTreme

    +
    • + +
  • +

    VideoLogic Captivator PCI

    +
    • +
+
+
+ +

Connectix QuickCam

+ +

Cortex1 frame grabber (ctx driver)

+ +

Creative Labs Video Spigot frame grabber (spigot + driver)

+ +

Matrox Meteor Video frame grabber ( + meteor(4) + driver)

+
+ +
+
+ +

3.11 USB + Devices

+ +

A range of USB peripherals are supported; devices + known to work are listed in this section. Owing to the + generic nature of most USB devices, with some exceptions + any device of a given class will be supported, even if + not explicitly listed here.

+ +
+
+

Note: USB Ethernet adapters can be found in + the section listing Ethernet + interfaces.

+
+
+ +
+
+

Note: USB Bluetooth adapters can be found + in Bluetooth section.

+
+
+ +

Host Controllers ( + ohci(4) and + uhci(4) + drivers)

+ +
    +
  • +

    ALi Aladdin-V

    +
    • + +
  • +

    AMD-756

    +
    • + +
  • +

    CMD Tech 670 & 673

    +
    • + +
  • +

    Intel 82371SB (PIIX3)

    +
    • + +
  • +

    Intel 82371AB and EB (PIIX4)

    +
    • + +
  • +

    Intel 82801AA (ICH)

    +
    • + +
  • +

    Intel 82801AB (ICH0)

    +
    • + +
  • +

    Intel 82801BA/BAM (ICH2)

    +
    • + +
  • +

    Intel 82443MX

    +
    • + +
  • +

    NEC uPD 9210

    +
    • + +
  • +

    OPTi 82C861 (FireLink)

    +
    • + +
  • +

    SiS 5571

    +
    • + +
  • +

    VIA 83C572 USB

    +
    • + +
  • +

    UHCI or OHCI compliant motherboard chipsets (no + exceptions known)

    +
    • +
+
+
+ +

USB host controllers (PCI)

+ +
    +
  • +

    ADS Electronics PCI plug-in card (2 ports)

    +
    • + +
  • +

    Entrega PCI plug-in card (4 ports)

    +
    • +
+
+
+ +

USB 2.0 controllers using the EHCI interface ( + ehci(4) + driver)

+ +

Hubs

+ +
    +
  • +

    Andromeda hub

    +
    • + +
  • +

    MacAlly self powered hub (4 ports)

    +
    • + +
  • +

    NEC hub

    +
    • +
+
+
+ +

Keyboards ( + ukbd(4) + driver)

+ +
    +
  • +

    Apple iMac keyboard

    +
    • + +
  • +

    BTC BTC7935 keyboard with PS/2 mouse port

    +
    • + +
  • +

    Cherry G81-3504 keyboard

    +
    • + +
  • +

    Logitech M2452 keyboard

    +
    • + +
  • +

    MacAlly iKey keyboard

    +
    • + +
  • +

    Microsoft keyboard

    +
    • + +
  • +

    Sun Microsystems Type 6 USB keyboard

    +
    • +
+
+
+ +

Miscellaneous

+ +
    +
  • +

    ActiveWire I/O Board

    +
    • + +
  • +

    Diamond Rio 500, 600, and 800 MP3 players ( + urio(4) + driver)

    +
    • + +
  • +

    D-Link DSB-R100 USB Radio (ufm driver)

    +
    • +
+
+
+ +

Modems ( + umodem(4) + driver)

+ +
    +
  • +

    3Com 5605

    +
    • + +
  • +

    Metricom Ricochet GS USB wireless modem

    +
    • + +
  • +

    Yamaha Broadband Wireless Router RTW65b

    +
    • +
+
+
+ +

Mice ( + ums(4) + driver)

+ +
    +
  • +

    Agiler Mouse 29UO

    +
    • + +
  • +

    Apple iMac Mouse

    +
    • + +
  • +

    Belkin Mouse

    +
    • + +
  • +

    Chic mouse

    +
    • + +
  • +

    Cypress mouse

    +
    • + +
  • +

    Genius Niche mouse

    +
    • + +
  • +

    Kensington Mouse-in-a-Box

    +
    • + +
  • +

    Logitech wheel mouse (3 buttons)

    +
    • + +
  • +

    Logitech PS/2 / USB mouse (3 buttons)

    +
    • + +
  • +

    MacAlly mouse (3 buttons)

    +
    • + +
  • +

    Microsoft IntelliMouse (3 buttons)

    +
    • + +
  • +

    Sun Microsystems Type 6 USB Mouse

    +
    • + +
  • +

    Trust Ami Mouse (3 buttons)

    +
    • +
+
+
+ +

Printers and parallel printer conversion cables ( + ulpt(4) + driver)

+ +
    +
  • +

    ATen parallel printer adapter

    +
    • + +
  • +

    Belkin F5U002 parallel printer adapter

    +
    • + +
  • +

    Entrega USB-to-parallel printer adapter

    +
    • +
+
+
+ +

Serial devices

+ +
    +
  • +

    Belkin F5U103 and F5U120 (ubsa driver)

    +
    • + +
  • +

    e-Tek Labs Kwik232 (ubsa driver)

    +
    • + +
  • +

    GoHubs GoCOM232 (ubsa driver)

    +
    • + +
  • +

    HP USB-Serial adapter ( + uftdi(4) + driver)

    +
    • + +
  • +

    Inland UAS111 ( + uftdi(4) + driver)

    +
    • + +
  • +

    Peracom single port serial adapter (ubsa + driver)

    +
    • + +
  • +

    Prolific PL-2303 serial adapter ( + uplcom(4) + driver)

    +
    • + +
  • +

    QVS USC-1000 ( + uftdi(4) + driver)

    +
    • + +
  • +

    SUNTAC Slipper U VS-10U ( + uvscom(4) + driver)

    +
    • +
+
+
+ +

Scanners (through SANE) ( + uscanner(4) + driver)

+ +
    +
  • +

    Perfection 636U

    +
    • + +
  • +

    HP ScanJet 4100C, 5200C, 6300C

    +
    • +
+
+
+ +

Storage ( + umass(4) + driver)

+ +
    +
  • +

    ADTEC Stick Drive AD-UST32M, 64M, 128M, 256M

    +
    • + +
  • +

    Denno FireWire/USB2 Removable 2.5-inch HDD Case + MIFU-25CB20

    +
    • + +
  • +

    FujiFilm Zip USB Drive ZDR100 USB A

    +
    • + +
  • +

    GREEN HOUSE USB Flash Memory ``PicoDrive'' + GH-UFD32M, 64M, 128M

    +
    • + +
  • +

    IBM 32MB USB Memory Key (P/N 22P5296)

    +
    • + +
  • +

    IBM ThinkPad USB Portable CD-ROM Drive (P/N + 33L5151)

    +
    • + +
  • +

    I-O DATA USB x6 CD-RW Drive CDRW-i64/USB (CDROM + only)

    +
    • + +
  • +

    I-O DATA USB + CD/CD-R/CD-RW/DVD-R/DVD-RW/DVD-RAM/DVD-ROM Drive + DVR-iUH2 (CDROM, DVD-RAM only)

    +
    • + +
  • +

    Iomega USB Zip 100Mb (primitive support still)

    +
    • + +
  • +

    Iomega Zip750 USB2.0 Drive

    +
    • + +
  • +

    Keian USB1.1/2.0 3.5-inch HDD Case KU350A

    +
    • + +
  • +

    Kurouto Shikou USB 2.5-inch HDD Case + GAWAP2.5PS-USB2.0

    +
    • + +
  • +

    Logitec USB1.1/2.0 HDD Unit SHD-E60U2

    +
    • + +
  • +

    Logitec Mobile USB Memory LMC-256UD

    +
    • + +
  • +

    Logitec USB Double-Speed Floppy Drive LFD-31U2

    +
    • + +
  • +

    Logitec USB/IEEE1394 DVD-RAM/R/RW Unit LDR-N21FU2 + (CDROM only)

    +
    • + +
  • +

    Matshita CF-VFDU03 floppy drive

    +
    • + +
  • +

    MELCO USB2.0 MO Drive MO-CH640U2

    +
    • + +
  • +

    I-O DATA USB/IEEE1394 Portable HD Drive + HDP-i30P/CI, HDP-i40P/CI

    +
    • + +
  • +

    MELCO USB Flash Disk ``PetitDrive'', RUF-32M, + -64M, -128M, -256M

    +
    • + +
  • +

    MELCO USB2.0 Flash Disk ``PetitDrive2'', + RUF-256M/U2, -512M/U2

    +
    • + +
  • +

    MELCO USB Flash Disk ``ClipDrive'', RUF-C32M, + -C64M, -C128M, -C256M, -C512M

    +
    • + +
  • +

    Microtech USB-SCSI-HD 50 USB to SCSI cable

    +
    • + +
  • +

    NOVAC USB2.0 2.5/3.5-inch HDD Case NV-HD351U

    +
    • + +
  • +

    Panasonic floppy drive

    +
    • + +
  • +

    Panasonic USB2.0 Portable CD-RW Drive KXL-RW40AN + (CDROM only)

    +
    • + +
  • +

    RATOC Systems USB2.0 Removable HDD Case U2-MDK1, + U2-MDK1B

    +
    • + +
  • +

    Sony Portable CD-R/RW Drive CRX10U (CDROM + only)

    +
    • + +
  • +

    TEAC Portable USB CD-ROM Unit CD-110PU/210PU

    +
    • + +
  • +

    Y-E Data floppy drive (720/1.44/2.88Mb)

    +
    • +
+
+
+ +

Audio Devices (uaudio driver)

+ +
    +
  • +

    Audio-Technica USB Digital Headphone + ATC-HA4USB

    +
    • + +
  • +

    Ergo Systems AUDIOTRAK OPTOPlay USB

    +
    • + +
  • +

    KENWOOD MD Personal Stereo System MDX-G7

    +
    • + +
  • +

    KENWOOD/SOTEC VH-7PC

    +
    • + +
  • +

    I-O DATA Analog to Digital USB Audio Adapter + DAVOX

    +
    • + +
  • +

    ONKYO PC Speaker GX-R5U(W)

    +
    • + +
  • +

    ONKYO USB Digital Audio Processor SE-U55X(S)

    +
    • + +
  • +

    Roland UA-5 USB Audio Interface ``Audio + Capture''

    +
    • + +
  • +

    Sony PC Active Speaker System SRS-T100PC

    +
    • +
+
+
+ +

Handspring Visor and other PalmOS devices ( + uvisor(4) + driver)

+ +
    +
  • +

    Handspring Visor

    +
    • + +
  • +

    Palm M125, M500, M505

    +
    • + +
  • +

    Sony Clie 4.0 and 4.1

    +
    • +
+
+
+
+ +
+
+ +

3.12 + IEEE 1394 (Firewire) Devices

+ +

Host Controllers ( + fwohci(4) + driver)

+ +
    +
  • +

    Ricoh R5C552 chipset

    +
    • + +
  • +

    Sony CX3022 chipset

    +
    • + +
  • +

    TI TSB12LV22, LV23, 26 and TSB43AA22 chipsets

    +
    • + +
  • +

    uPD72861 chipset

    +
    • + +
  • +

    VIA VT6306 chipset

    +
    • +
+
+
+ +

Storage ( + sbp(4) + driver)

+ +
    +
  • +

    Apple iPod

    +
    • + +
  • +

    Apple Macintosh G4 (target mode)

    +
    • +
+
+
+
+ +
+
+ +

3.13 + Bluetooth Devices

+ +

PCCARD Host Controllers ( + ng_bt3c(4) + driver)

+ +
    +
  • +

    3Com/HP 3CRWB6096-A PCCARD adapter

    +
    • +
+
+
+ +

USB Host Controllers ( + ng_ubt(4) + driver)

+ +
    +
  • +

    3Com 3CREB96

    +
    • + +
  • +

    EPoX BT-DG02

    +
    • + +
  • +

    Mitsumi USB Bluetooth adapter

    +
    • + +
  • +

    MSI MS-6967

    +
    • + +
  • +

    TDK Bluetooth USB adapter

    +
    • +
+
+
+
+ +
+
+ +

3.14 + Cryptographic Accelerators

+ +

Accelerators based on the Hifn 7751, 7811, or 7951 + chipsets ( + hifn(4) + driver)

+ +
    +
  • +

    Invertex AEON

    +
    • + +
  • +

    Hifn 7751 reference board

    +
    • + +
  • +

    Global Technologies Group PowerCrypt and + XL-Crypt

    +
    • + +
  • +

    NetSec 7751

    +
    • + +
  • +

    Soekris Engineering vpn1201 and vpn1211

    +
    • +
+
+
+ +

Accelerators based on the Bluesteel 5501 or 5601 + chipsets ( + ubsec(4) + driver)

+ +

Accelerators based on the Broadcom BCM5801, BCM5802, + BCM5805, BCM5820, BCM 5821, BCM5822 chipsets ( + ubsec(4) + driver)

+
+ +
+
+ +

3.15 + Miscellaneous

+ +

FAX-Modem/PCCARD

+ +
    +
  • +

    MELCO IGM-PCM56K/IGM-PCM56KH

    +
    • + +
  • +

    Nokia Card Phone 2.0 (gsm900/dcs1800 HSCSD + terminal)

    +
    • +
+
+
+ +

Floppy drives ( + fdc(4) + driver)

+ +

Genius and Mustek hand scanners

+ +

GPB and Transputer drivers

+ +

VGA-compatible video cards ( + vga(4) + driver)

+ +
+
+

Note: Information regarding specific video + cards and compatibility with XFree86 can be found at http://www.xfree86.org/.

+
+
+
+
+ +

Keyboards including:

+ +
    +
  • +

    AT-style keyboards ( + atkbd(4) + driver)

    +
    • + +
  • +

    PS/2 keyboards ( + atkbd(4) + driver)

    +
    • + +
  • +

    USB keyboards (specific instances are listed in + the section describing USB + devices)

    +
    • +
+
+
+ +

Loran-C receiver (Dave Mills experimental hardware, + loran driver).

+ +

Pointing devices including:

+ +
    +
  • +

    Bus mice and compatible devices ( + mse(4) + driver)

    +
    • + +
  • +

    PS/2 mice and compatible devices, including many + laptop pointing devices ( + psm(4) + driver)

    +
    • + +
  • +

    Serial mice and compatible devices

    +
    • + +
  • +

    USB mice (specific instances are listed in the + section describing USB + devices)

    +
    • +
+ +
+
+

Note: + moused(8) has + more information on using pointing devices with + FreeBSD. Information on using pointing devices with + XFree86 can be found at http://www.xfree86.org/.

+
+
+
+
+ +

``PC standard'' parallel ports ( + ppc(4) + driver)

+ +

PC-compatible joysticks ( + joy(4) + driver)

+ +

PHS Data Communication Card/PCCARD

+ +
    +
  • +

    NTT DoCoMo P-in Comp@ct

    +
    • + +
  • +

    Panasonic KX-PH405

    +
    • + +
  • +

    SII MC-P200

    +
    • +
+
+
+ +

Xilinx XC6200-based reconfigurable hardware cards + compatible with the HOT1 from Virtual + Computers (xrpu driver).

+
+
+
+
+ +

This file, and other release-related + documents, can be downloaded from ftp://ftp.FreeBSD.org/.

+ +

For questions about FreeBSD, read the + documentation + before contacting <questions@FreeBSD.org>.

+ +

All users of FreeBSD 5-CURRENT + should subscribe to the <current@FreeBSD.org> + mailing list.

+ +

For questions about this documentation, + e-mail <doc@FreeBSD.org>.

+
+
+ + + diff --git a/en/releases/5.1R/hardware-ia64.html b/en/releases/5.1R/hardware-ia64.html new file mode 100644 index 0000000000..f5c9195386 --- /dev/null +++ b/en/releases/5.1R/hardware-ia64.html @@ -0,0 +1,835 @@ + + + + + FreeBSD/ia64 5.1-RELEASE Hardware Notes + + + + + +
+
+

FreeBSD/ia64 + 5.1-RELEASE Hardware Notes

+ +

The FreeBSD Documentation + Project

+ +

Copyright © 2000, 2001, 2002, + 2003 by The FreeBSD Documentation Project

+
+
+ +
+
+
Table of Contents
+ +
1 Introduction
+ +
2 Supported Processors and + Motherboards
+ +
+
+
2.1 Supported Devices + Overview
+
+
+ +
3 Supported Devices
+ +
+
+
3.1 Disk Controllers
+ +
3.2 Ethernet + Interfaces
+ +
3.3 FDDI Interfaces
+ +
3.4 ATM Interfaces
+ +
3.5 Wireless Network + Interfaces
+ +
3.6 Miscellaneous + Networks
+ +
3.7 ISDN Interfaces
+ +
3.8 Serial Interfaces
+ +
3.9 Audio Devices
+ +
3.10 Camera and Video Capture + Devices
+ +
3.11 USB Devices
+ +
3.12 IEEE 1394 (Firewire) + Devices
+ +
3.13 Bluetooth + Devices
+ +
3.14 Cryptographic + Accelerators
+ +
3.15 Miscellaneous
+
+
+
+
+ +
+
+ + +

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 FreeBSD IA64 porting mailing list.

+
+
+ +
+
+ +

1 + Introduction

+ +

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.

+ +
+
+

Note: 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.

+
+
+ +

More information on FreeBSD/ia64 is contained on the FreeBSD/ia64 Project page.

+
+ +
+
+ +

2 + Supported Processors and Motherboards

+ +

Currently supported processors are the Itanium and the Itanium 2.

+ +

Supported chipsets include:

+ +
    +
  • +

    HP zx1 (only on development branch, see the Perforce repository)

    +
    • + +
  • +

    HP i2000

    +
    • + +
  • +

    Intel 460GX

    +
    • + +
  • +

    Intel E8870

    +
    • +
+ +

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.

+ +
+
+ +

2.1 + Supported Devices Overview

+ +

This section contains additional information about + what devices may or may not be supported by + FreeBSD/ia64.

+ +

Except for the PC chipset embedded + ata(4) + 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.

+ +

In general, ``PC standard'' serial ports supported by + the + sio(4) 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 no ISA + device support other than the PCI dictated VGA + legacy.

+ +

In addition to + sio(4) 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:

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ sio(4)No support for + memory-mapped I/O
+ syscons(4)Expect BIOS, VGA + probes, etc.
+ pcm(4)Probes MSS ISA + ports ad nauseum
+ atkbd(4), + + psm(4)Fixed ISA port + locations
+
+
+
+ +
+
+ +

3 + Supported Devices

+ $FreeBSD: + src/release/doc/en_US.ISO8859-1/hardware/common/dev.sgml,v + 1.157 2003/05/30 11:24:00 nyan Exp $ + +

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.

+ +

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.

+ +
+
+ +

3.1 Disk + Controllers

+ +

IDE/ATA controllers ( + ata(4) + driver)

+ +
    +
  • +

    Acard ATP850 UDMA2, ATP860 UDMA4, ATP865 UDMA6

    +
    • + +
  • +

    AMD 756 ATA66, 766 ATA100, 768 ATA100

    +
    • + +
  • +

    Cenatek Rocket Drive

    +
    • + +
  • +

    CMD 646, 648 ATA66, and 649 ATA100

    +
    • + +
  • +

    Cypress 82C693

    +
    • + +
  • +

    Cyrix 5530 ATA33

    +
    • + +
  • +

    HighPoint HPT366 ATA66, HPT370 ATA100, HPT372 + ATA133, HPT374 ATA133

    +
    • + +
  • +

    Intel PIIX, PIIX3, PIIX4

    +
    • + +
  • +

    Intel ICH ATA66, ICH2 ATA100, ICH3 ATA100, ICH4 + ATA100

    +
    • + +
  • +

    nVidia nForce ATA100, nForce2 ATA133

    +
    • + +
  • +

    Promise ATA100 OEM chip (pdc20265)

    +
    • + +
  • +

    Promise ATA133 OEM chip (pdc20269)

    +
    • + +
  • +

    Promise Fasttrak-33, -66, -100, -100 TX2/TX4, -133 + TX2/TX2000

    +
    • + +
  • +

    Promise SATA150 TX2/TX4 Serial ATA/150

    +
    • + +
  • +

    Promise Ultra-33, -66, -100, -133 + TX2/TX2000/TX4000

    +
    • + +
  • +

    ServerWorks ROSB4 ATA33

    +
    • + +
  • +

    ServerWorks CSB5 and CSB6 ATA66/ATA100

    +
    • + +
  • +

    Sil 0680 UDMA6

    +
    • + +
  • +

    SiS 530, 540, 550, 620

    +
    • + +
  • +

    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

    +
    • + +
  • +

    SiS 5591 ATA100

    +
    • + +
  • +

    VIA 82C586 ATA33, 82C596 ATA66, 82C686a ATA66, + 82C686b ATA100

    +
    • + +
  • +

    VIA 8233, 8235 ATA133

    +
    • +
+
+
+ +

Qlogic controllers and variants ( + isp(4) + driver)

+ +
    +
  • +

    Qlogic 1020, 1040 SCSI and Ultra SCSI host + adapters

    +
    • + +
  • +

    Qlogic 1240 dual Ultra SCSI controllers

    +
    • + +
  • +

    Qlogic 1080 Ultra2 LVD and 1280 Dual Ultra2 LVD + controllers

    +
    • + +
  • +

    Qlogic 12160 Ultra3 LVD controllers

    +
    • + +
  • +

    Qlogic 2100 and Qlogic 2200 Fibre Channel SCSI + controllers

    +
    • + +
  • +

    Qlogic 2300 and Qlogic 2312 2-Gigabit Fibre + Channel SCSI controllers

    +
    • + +
  • +

    Performance Technology SBS440 ISP1000 variants

    +
    • + +
  • +

    Performance Technology SBS450 ISP1040 variants

    +
    • + +
  • +

    Performance Technology SBS470 ISP2100 variants

    +
    • + +
  • +

    Antares Microsystems P-0033 ISP2100 variants

    +
    • +
+
+
+ +

LSI Logic Fusion/MP architecture Fiber Channel + controllers (mpt driver)

+ +
    +
  • +

    LSI 53c1020, 53c1030

    +
    • +
+
+
+ +

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 + cd(4)). + WORM/CD-R/CD-RW writing support is provided by + cdrecord(1), + which is a part of the + sysutils/cdrtools port in + the Ports Collection.

+ +

The following CD-ROM type systems are supported at + this time:

+ +
    +
  • +

    SCSI interface (also includes ProAudio Spectrum + and SoundBlaster SCSI) ( + cd(4))

    +
    • + +
  • +

    ATAPI IDE interface ( + acd(4))

    +
    • +
+
+
+
+ +
+
+ +

3.2 + Ethernet Interfaces

+ +

Intel 82557-, 82258-, 82559-, 82550- or 82562-based + Fast Ethernet NICs ( + fxp(4) + driver)

+ +
    +
  • +

    Intel EtherExpress Pro/100B PCI Fast Ethernet

    +
    • + +
  • +

    Intel InBusiness 10/100 PCI Network Adapter

    +
    • + +
  • +

    Intel PRO/100+ Management Adapter

    +
    • + +
  • +

    Intel Pro/100 VE Desktop Adapter

    +
    • + +
  • +

    Intel Pro/100 M Desktop Adapter

    +
    • + +
  • +

    Intel Pro/100 S Desktop, Server and Dual-Port + Server Adapters

    +
    • + +
  • +

    On-board Ethernet NICs on many Intel + motherboards.

    +
    • +
+
+
+ +

Gigabit Ethernet NICs based on the Broadcom BCM570x + ( + bge(4) + driver)

+ +
    +
  • +

    3Com 3c996-SX, 3c996-T

    +
    • + +
  • +

    Netgear GA302T

    +
    • + +
  • +

    SysKonnect SK-9D21 and 9D41

    +
    • +
+
+
+ +

Gigabit Ethernet NICs based on the Intel 82542 and + 82543 controller chips ( + gx(4) and + em(4) drivers), + plus NICs supported by the Intel 82540EM, 82544, 82545EM, + and 82546EB controller chips ( + em(4) driver + only)

+ +
    +
  • +

    Intel PRO/1000 Gigabit Ethernet

    +
    • +
+ +
+
+

Note: The + em(4) driver + is officially supported by Intel, but is only + supported on the i386.

+
+
+
+
+
+ +
+
+ +

3.3 FDDI + Interfaces

+
+ +
+
+ +

3.4 ATM + Interfaces

+
+ +
+
+ +

3.5 + Wireless Network Interfaces

+
+ +
+
+ +

3.6 + Miscellaneous Networks

+
+ +
+
+ +

3.7 ISDN + Interfaces

+
+ +
+
+ +

3.8 + Serial Interfaces

+ +

``PC standard'' 8250, 16450, and 16550-based serial + ports ( + sio(4) + driver)

+ +

PCI-Based multi-port serial boards ( + puc(4) + driver)

+ +
    +
  • +

    Diva Serial (GSP) Multiport UART (development + branch only)

    +
    • +
+
+
+
+ +
+
+ +

3.9 + Audio Devices

+
+ +
+
+ +

3.10 + Camera and Video Capture Devices

+
+ +
+
+ +

3.11 USB + Devices

+ +

Host Controllers ( + ohci(4) and + uhci(4) + drivers)

+ +
    +
  • +

    UHCI or OHCI compliant motherboard chipsets (no + exceptions known)

    +
    • +
+
+
+ +

USB 2.0 controllers using the EHCI interface ( + ehci(4) + driver)

+
+ +
+
+ +

3.12 + IEEE 1394 (Firewire) Devices

+
+ +
+
+ +

3.13 + Bluetooth Devices

+
+ +
+
+ +

3.14 + Cryptographic Accelerators

+
+ +
+
+ +

3.15 + Miscellaneous

+ +

VGA-compatible video cards ( + vga(4) + driver)

+ +
+
+

Note: Information regarding specific video + cards and compatibility with XFree86 can be found at http://www.xfree86.org/.

+
+
+
+
+ +

Keyboards including:

+ + +
+
+ +

Pointing devices including:

+ +
    +
  • +

    PS/2 mice and compatible devices, including many + laptop pointing devices ( + psm(4) + driver)

    +
    • + +
  • +

    Serial mice and compatible devices

    +
    • +
+ +
+
+

Note: + moused(8) has + more information on using pointing devices with + FreeBSD. Information on using pointing devices with + XFree86 can be found at http://www.xfree86.org/.

+
+
+
+
+
+
+
+
+ +

This file, and other release-related + documents, can be downloaded from ftp://ftp.FreeBSD.org/.

+ +

For questions about FreeBSD, read the + documentation + before contacting <questions@FreeBSD.org>.

+ +

All users of FreeBSD 5-CURRENT + should subscribe to the <current@FreeBSD.org> + mailing list.

+ +

For questions about this documentation, + e-mail <doc@FreeBSD.org>.

+
+
+ + + diff --git a/en/releases/5.1R/hardware-pc98.html b/en/releases/5.1R/hardware-pc98.html new file mode 100644 index 0000000000..0ba8f39cf3 --- /dev/null +++ b/en/releases/5.1R/hardware-pc98.html @@ -0,0 +1,3431 @@ + + + + + FreeBSD/pc98 5.1-RELEASE Hardware Notes + + + + + +
+
+

FreeBSD/pc98 + 5.1-RELEASE Hardware Notes

+ +

The FreeBSD Documentation + Project

+ +

Copyright © 2000, 2001, 2002, + 2003 by The FreeBSD Documentation Project

+
+
+ +
+
+
Table of Contents
+ +
1 Introduction
+ +
2 Supported Systems
+ +
3 Supported Devices
+ +
+
+
3.1 Disk Controllers
+ +
3.2 Ethernet + Interfaces
+ +
3.3 FDDI Interfaces
+ +
3.4 ATM Interfaces
+ +
3.5 Wireless Network + Interfaces
+ +
3.6 Miscellaneous + Networks
+ +
3.7 ISDN Interfaces
+ +
3.8 Serial Interfaces
+ +
3.9 Audio Devices
+ +
3.10 Camera and Video Capture + Devices
+ +
3.11 USB Devices
+ +
3.12 IEEE 1394 (Firewire) + Devices
+ +
3.13 Bluetooth + Devices
+ +
3.14 Cryptographic + Accelerators
+ +
3.15 Miscellaneous
+
+
+
+
+ +
+
+ +

1 + Introduction

+ +

This document contains the hardware compatibility notes + for FreeBSD 5.1-RELEASE on the NEC PC-98x1 hardware + platform (also referred to as FreeBSD/pc98 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.

+ +
+
+

Note: This document includes information + specific to the NEC PC-98x1 hardware platform. Versions + of the hardware compatibility notes for other + architectures will differ in some details.

+
+
+
+ +
+
+ +

2 + Supported Systems

+ +

NEC PC-9801/9821 series with almost all i386-compatible + processors, including 80386, 80486, Pentium, Pentium Pro, + Pentium II, and variants. All i386-compatible processors by + AMD, Cyrix, IBM, and IDT are also supported.

+ +

NEC FC-9801/9821 series, and NEC SV-98 series (both of + them are compatible with PC-9801/9821 series) should be + supported.

+ +

EPSON PC-386/486/586 series, which are compatible with + NEC PC-9801 series are supported.

+ +

High-resolution mode is not supported. NEC + PC-98XA/XL/RL/XL^2, and NEC PC-H98 series are supported in + normal (PC-9801 compatible) mode only.

+ +

Although there are some multi-processor systems (such as + Rs20/B20), SMP-related features of FreeBSD are not + supported yet.

+ +

PC-9801/9821 standard bus (called C-Bus), PC-9801NOTE + expansion bus (110pin), and PCI bus are supported. New + Extend Standard Architecture (NESA) bus (used in PC-H98, + SV-H98, and FC-H98 series) is not supported.

+
+ +
+
+ +

3 + Supported Devices

+ $FreeBSD: + src/release/doc/en_US.ISO8859-1/hardware/common/dev.sgml,v + 1.157 2003/05/30 11:24:00 nyan Exp $ + +

This section describes the devices currently known to be + supported by with FreeBSD on the NEC PC-98x1 platform. + Other configurations may also work, but simply have not + been tested yet. Feedback, updates, and corrections to this + list are encouraged.

+ +

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.

+ +
+
+ +

3.1 Disk + Controllers

+ +

IDE/ATA controllers ( + ata(4) + driver)

+ +
    +
  • +

    Acard ATP850 UDMA2, ATP860 UDMA4, ATP865 UDMA6

    +
    • + +
  • +

    AMD 756 ATA66, 766 ATA100, 768 ATA100

    +
    • + +
  • +

    Cenatek Rocket Drive

    +
    • + +
  • +

    CMD 646, 648 ATA66, and 649 ATA100

    +
    • + +
  • +

    Cypress 82C693

    +
    • + +
  • +

    Cyrix 5530 ATA33

    +
    • + +
  • +

    HighPoint HPT366 ATA66, HPT370 ATA100, HPT372 + ATA133, HPT374 ATA133

    +
    • + +
  • +

    Intel PIIX, PIIX3, PIIX4

    +
    • + +
  • +

    Intel ICH ATA66, ICH2 ATA100, ICH3 ATA100, ICH4 + ATA100

    +
    • + +
  • +

    nVidia nForce ATA100, nForce2 ATA133

    +
    • + +
  • +

    Promise ATA100 OEM chip (pdc20265)

    +
    • + +
  • +

    Promise ATA133 OEM chip (pdc20269)

    +
    • + +
  • +

    Promise Fasttrak-33, -66, -100, -100 TX2/TX4, -133 + TX2/TX2000

    +
    • + +
  • +

    Promise SATA150 TX2/TX4 Serial ATA/150

    +
    • + +
  • +

    Promise Ultra-33, -66, -100, -133 + TX2/TX2000/TX4000

    +
    • + +
  • +

    ServerWorks ROSB4 ATA33

    +
    • + +
  • +

    ServerWorks CSB5 and CSB6 ATA66/ATA100

    +
    • + +
  • +

    Sil 0680 UDMA6

    +
    • + +
  • +

    SiS 530, 540, 550, 620

    +
    • + +
  • +

    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

    +
    • + +
  • +

    SiS 5591 ATA100

    +
    • + +
  • +

    VIA 82C586 ATA33, 82C596 ATA66, 82C686a ATA66, + 82C686b ATA100

    +
    • + +
  • +

    VIA 8233, 8235 ATA133

    +
    • +
+
+
+ +

IDE/ATA controllers (wdc driver)

+ +
    +
  • +

    On-board IDE controller

    +
    • +
+
+
+ +

Adaptec SCSI Controllers

+ +
    +
  • +

    NEC PC-9801-100 and Adaptec AHA-1030P, 1030B( + aic(4) + driver)

    +
    • + +
  • +

    NEC PC-9821Xt13 and RvII26 internal, NEC + PC-9821X-B02L/B09, NEC SV-98/2-B03, Adaptec + AHA-2940J, AHA-2940AU and AHA-2940N ( + ahc(4) + driver)

    +
    • +
+
+
+ +

NEC PC-9801-55, 92 and their compatible C-Bus SCSI + interfaces (ct driver)

+ +
    +
  • +

    NEC PC-9801-55, 92 and their compatibles

    + +

    ICM IF-2660

    + +

    Midori-Denshi MDC-554NA

    + +

    Logitec LHA-N151

    + +
    +
    +

    Note: flags + 0x00000 is necessary in kernel configuration + for DMA transfer mode.

    +
    +
    +
    • + +
  • +

    I-O DATA SC-98II

    + +
    +
    +

    Note: flags + 0x10000 is necessary in kernel configuration + for DMA transfer mode.

    +
    +
    +
    • + +
  • +

    TEXA HA-55BS2 and later

    + +

    Midori-Denshi MDC-926Rs

    + +
    +
    +

    Note: flags + 0x20000 is necessary in kernel configuration + for Bus-master transfer mode.

    +
    +
    +
    • + +
  • +

    ELECOM Bus-master SCSI interfaces

    + +
    +
    +

    Note: flags + 0x30000 is necessary in kernel configuration + for Bus-master transfer mode.

    +
    +
    +
    • + +
  • +

    All SMIT transfer type SCSI interfaces

    + +
    +
    +

    Note: flags + 0x40000 is necessary in kernel configuration + for SMIT transfer mode.

    +
    +
    +
    • + +
  • +

    Logitec LHA-20x series

    + +

    ICM IF-2766, IF-2766ET, IF-2767 and IF-2769

    + +
    +
    +

    Note: flags + 0x50000 is necessary in kernel configuration + for Bus-master transfer mode.

    +
    +
    +
    • +
+
+
+ +

NEC PC-9801-55, 92 and their compatible C-Bus SCSI + interfaces (bs driver)

+ +
    +
  • +

    NEC PC-9801-55, 92 and their compatibles

    + +

    ICM IF-2660

    + +

    Midori-Denshi MDC-554NA

    + +

    Logitec LHA-N151

    + +
    +
    +

    Note: "flags 0x00000" is necessary in + kernel configuration for DMA transfer mode.

    +
    +
    +
    • + +
  • +

    I-O DATA SC-98II

    + +
    +
    +

    Note: "flags 0x10000" is necessary in + kernel configuration for DMA transfer mode.

    +
    +
    +
    • + +
  • +

    TEXA HA-55BS2 and later

    + +

    Midori-Denshi MDC-926Rs

    + +
    +
    +

    Note: "flags 0x20000" is necessary in + kernel configuration for Bus-master transfer + mode.

    +
    +
    +
    • + +
  • +

    ELECOM Bus-master SCSI interfaces

    + +
    +
    +

    Note: "flags 0x30000" is necessary in + kernel configuration for Bus-master transfer + mode.

    +
    +
    +
    • + +
  • +

    All SMIT transfer type SCSI interfaces

    + +
    +
    +

    Note: "flags 0x40000" is necessary in + kernel configuration for SMIT transfer mode.

    +
    +
    +
    • + +
  • +

    Logitec LHA-20x series

    + +

    ICM IF-2766, IF-2766ET, IF-2767 and IF-2769

    + +
    +
    +

    Note: "flags 0x50000" is necessary in + kernel configuration for Bus-master transfer + mode.

    +
    +
    +
    • +
+
+
+ +

AdvanSys SCSI controllers (all models, + adv(4) and + adw(4) + drivers)

+ +
    +
  • +

    MELCO IFC-USP, RATOC REX-PCI30 and @Nifty FNECHARD + IFC-USUP-TX ( + adv(4) + driver)

    +
    • +
+
+
+ +

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 ( + ncr(4) and + sym(4) + drivers)

+ +
    +
  • +

    I-O DATA SC-98/PCI and SC-PCI ( + ncr(4) + driver)

    +
    • + +
  • +

    I-O DATA SC-UPCI and Logitec LHA-521UA ( + sym(4) + driver)

    +
    • +
+
+
+ +

NCR 53C500 based PC-Card SCSI host adapters (ncv + driver)

+ +
    +
  • +

    IO DATA PCSC-DV

    +
    • + +
  • +

    KME KXLC002 (TAXAN ICD-400PN, etc.), KXLC004

    +
    • + +
  • +

    Macnica Miracle SCSI-II mPS110

    +
    • + +
  • +

    Media Intelligent MSC-110, MSC-200

    +
    • + +
  • +

    NEC PC-9801N-J03R

    +
    • + +
  • +

    New Media Corporation BASICS SCSI

    +
    • + +
  • +

    Qlogic Fast SCSI

    +
    • + +
  • +

    RATOC REX-9530, REX-5572 (as SCSI only)

    +
    • +
+
+
+ +

TMC 18C30, 18C50 based ISA/PC-Card SCSI host adapters + (stg driver)

+ +
    +
  • +

    Future Domain SCSI2GO

    +
    • + +
  • +

    IBM SCSI PCMCIA Card

    +
    • + +
  • +

    ICM PSC-2401 SCSI

    +
    • + +
  • +

    MELCO IFC-SC

    +
    • + +
  • +

    RATOC REX-5536, REX-5536AM, REX-5536M, + REX-9836A

    +
    • +
+
+
+ +

Qlogic controllers and variants ( + isp(4) + driver)

+ +
    +
  • +

    Qlogic SCSI interface

    +
    • +
+
+
+ +

Tekram DC390 and DC390T controllers, maybe other cards + based on the AMD 53c974 as well ( + amd(4) + driver)

+ +
    +
  • +

    MELCO IFC-DP

    +
    • +
+
+
+ +

Workbit Ninja SCSI-3 based PC-Card SCSI host adapters + (nsp driver)

+ +
    +
  • +

    Alpha-Data AD-PCS201

    +
    • + +
  • +

    IO DATA CBSC16

    +
    • +
+
+
+ +

LSI Logic Fusion/MP architecture Fiber Channel + controllers (mpt driver)

+ +
    +
  • +

    LSI FC909, FC929

    +
    • + +
  • +

    LSI 53c1020, 53c1030

    +
    • +
+
+
+ +

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 + cd(4)). + WORM/CD-R/CD-RW writing support is provided by + cdrecord(1), + which is a part of the + sysutils/cdrtools port in + the Ports Collection.

+ +

The following CD-ROM type systems are supported at + this time:

+ +
    +
  • +

    SCSI interface (also includes ProAudio Spectrum + and SoundBlaster SCSI) ( + cd(4))

    +
    • + +
  • +

    ATAPI IDE interface ( + acd(4))

    +
    • +
+
+
+
+ +
+
+ +

3.2 + Ethernet Interfaces

+ +

Adaptec Duralink PCI Fast Ethernet adapters based on + the Adaptec AIC-6915 Fast Ethernet controller chip ( + sf(4) driver)

+ +
    +
  • +

    ANA-62011 64-bit single port 10/100baseTX + adapter

    +
    • + +
  • +

    ANA-62022 64-bit dual port 10/100baseTX + adapter

    +
    • + +
  • +

    ANA-62044 64-bit quad port 10/100baseTX + adapter

    +
    • + +
  • +

    ANA-69011 32-bit single port 10/100baseTX + adapter

    +
    • + +
  • +

    ANA-62020 64-bit single port 100baseFX adapter

    +
    • +
+
+
+ +

Allied-Telesis AT1700 and RE2000 cards ( + fe(4) driver)

+ +
    +
  • +

    CONTEC C-NET(PC)C PCMCIA Ethernet

    +
    • + +
  • +

    Fujitsu MBH10303, MBH10302 Ethernet PCMCIA

    +
    • + +
  • +

    Fujitsu Towa LA501 Ethernet

    +
    • + +
  • +

    Fujitsu FMV-J182, FMV-J182A

    +
    • + +
  • +

    RATOC REX-5588, REX-9822, REX-4886, and + REX-R280

    +
    • + +
  • +

    Eiger Labs EPX-10BT

    +
    • + +
  • +

    HITACHI HT-4840-11

    +
    • + +
  • +

    NextCom J Link NC5310

    +
    • + +
  • +

    TDK LAK-CD021, LAK-CD021A, LAK-CD021BX

    +
    • +
+
+
+ +

Alteon Networks PCI Gigabit Ethernet NICs based on the + Tigon 1 and Tigon 2 chipsets ( + ti(4) driver)

+ +
    +
  • +

    3Com 3c985-SX (Tigon 1 and 2)

    +
    • + +
  • +

    Alteon AceNIC (Tigon 1 and 2)

    +
    • + +
  • +

    Alteon AceNIC 1000baseT (Tigon 2)

    +
    • + +
  • +

    Asante PCI 1000BASE-SX Gigabit Ethernet + Adapter

    +
    • + +
  • +

    Asante GigaNIX1000T Gigabit Ethernet Adapter

    +
    • + +
  • +

    DEC/Compaq EtherWORKS 1000

    +
    • + +
  • +

    Farallon PN9000SX

    +
    • + +
  • +

    NEC Gigabit Ethernet

    +
    • + +
  • +

    Netgear GA620 (Tigon 2)

    +
    • + +
  • +

    Netgear GA620T (Tigon 2, 1000baseT)

    +
    • + +
  • +

    Silicon Graphics Gigabit Ethernet

    +
    • +
+
+
+ +

AMD PCnet NICs ( + lnc(4) and + pcn(4) + drivers)

+ +
    +
  • +

    Contec C-NET(98)S

    +
    • + +
  • +

    PCI NIC using AMD AM79C97x (PCnet-PCI/Fast)

    +
    • + +
  • +

    NEC SV-98/2-B05, B06 (PCI)

    +
    • + +
  • +

    Allied-Telesis LA-PCI (PCI)

    +
    • +
+
+
+ +

SMC 83c17x (EPIC)-based Ethernet NICs ( + tx(4) driver)

+ +
    +
  • +

    SMC EtherPower II 9432 series

    +
    • +
+
+
+ +

National Semiconductor DS8390-based Ethernet NICs, + including Novell NE2000 and clones ( + ed(4) driver)

+ +
+
+

Note: In kernel configuration, you need to + set flag for non-PCI device.

+
+
+ +
    +
  • +

    Novell NE1000, NE2000, and NE2100

    +
    • + +
  • +

    RealTek 8029

    +
    • + +
  • +

    I-O DATA ET2/T-PCI

    +
    • + +
  • +

    MELCO LGY-PCI-TR

    +
    • + +
  • +

    PLANEX ENW-8300-T

    +
    • + +
  • +

    Allied Telesis LA-98 (flags 0x000000)

    +
    • + +
  • +

    Corega Ether98-T (flags 0x000000)

    +
    • + +
  • +

    SMC EtherEZ98 (flags 0x000000)

    +
    • + +
  • +

    ELECOM LD-BDN, LD-NW801G (flags 0x200000)

    +
    • + +
  • +

    PLANEX EN-2298-C (flags 0x200000)

    +
    • + +
  • +

    MELCO EGY-98 (flags 0x300000)

    +
    • + +
  • +

    Contec C-NET(98)E-A, C-NET(98)L-A, C-NET(98)P + (flags 0x300000)

    +
    • + +
  • +

    MELCO LGY-98, LGH-98, IND-SP, IND-SS, LGY-98-N + (110pin) (flags 0x400000)

    +
    • + +
  • +

    MACNICA NE2098 (flags 0x400000)

    +
    • + +
  • +

    ICM IF-2766ET, IF-2771ET, AD-ET2-T, DT-ET-25, + DT-ET-T5, NB-ET-T (110pin) (flags 0x500000)

    +
    • + +
  • +

    D-Link DE-298, DE-298P (flags 0x500000)

    +
    • + +
  • +

    ELECOM LD-98P (flags 0x500000)

    +
    • + +
  • +

    PLANEX EN-2298-T, EN-2298P-T (flags 0x500000)

    +
    • + +
  • +

    Allied Telesis SIC-98, SIU-98, SIC-98NOTE (110pin) + (flags 0x600000)

    +
    • + +
  • +

    Allied Telesis SIU-98-D (flags 0x610000)

    +
    • + +
  • +

    NEC PC-9801-107, 108 (flags 0x800000)

    +
    • + +
  • +

    I-O DATA LA/T-98, LA/T-98SB, LA2/T-98, ET/T-98 + (flags 0x900000)

    +
    • + +
  • +

    MACNICA ME98 (flags 0x900000)

    +
    • + +
  • +

    Kansai KLA-98C/T (flags 0x900000)

    +
    • + +
  • +

    NEC PC-9801-77, 78 (flags 0x910000)

    +
    • + +
  • +

    Contec C-NET(98), RT-1007(98), C-NET(9N) (110pin) + (flags 0xa00000)

    +
    • + +
  • +

    Contec C-NET(98)E, C-NET(98)L, C-NET(9N)L (110pin) + (flags 0xb00000)

    +
    • + +
  • +

    Logitec LAN-98T (flags 0xb00000)

    +
    • + +
  • +

    Networld 98X3 (flags 0xd00000)

    +
    • + +
  • +

    Accton EN1644(old model), EN1646(old model), + EN2203(old model) (110pin) (flags 0xd00000)

    +
    • + +
  • +

    Networld EC-98X, EP-98X (flags 0xd10000)

    +
    • +
+
+
+ +

NE2000 compatible PC-Card (PCMCIA) Ethernet and + FastEthernet cards ( + ed(4) driver)

+ +
    +
  • +

    AR-P500 Ethernet

    +
    • + +
  • +

    Accton EN2212/EN2216/UE2216

    +
    • + +
  • +

    Allied Telesis CentreCOM LA100-PCM_V2

    +
    • + +
  • +

    AmbiCom 10BaseT card

    +
    • + +
  • +

    BayNetworks NETGEAR FA410TXC Fast Ethernet

    +
    • + +
  • +

    CNet BC40 adapter

    +
    • + +
  • +

    COREGA Ether PCC-T/EtherII PCC-T/FEther + PCC-TXF/PCC-TXD

    +
    • + +
  • +

    Compex Net-A adapter

    +
    • + +
  • +

    CyQ've ELA-010

    +
    • + +
  • +

    D-Link DE-650/660

    +
    • + +
  • +

    Danpex EN-6200P2

    +
    • + +
  • +

    Elecom Laneed LD-CDL/TX, LD-CDF, LD-CDS, + LD-10/100CD, LD-CDWA (DP83902A), MACNICA Ethernet ME1 + for JEIDA

    +
    • + +
  • +

    IO DATA PCLATE

    +
    • + +
  • +

    IBM Creditcard Ethernet I/II

    +
    • + +
  • +

    IC-CARD Ethernet/IC-CARD+ Ethernet

    +
    • + +
  • +

    Kingston KNE-PC2, KNE-PCM/x Ethernet

    +
    • + +
  • +

    Linksys EC2T/PCMPC100/PCM100, PCMLM56, EtherFast + 10/100 PC Card, Combo PCMCIA Ethernet Card (PCMPC100 + V2)

    +
    • + +
  • +

    MELCO + LPC-T/LPC2-T/LPC2-CLT/LPC2-TX/LPC3-TX/LPC3-CLX

    +
    • + +
  • +

    NDC Ethernet Instant-Link

    +
    • + +
  • +

    National Semiconductor InfoMover NE4100

    +
    • + +
  • +

    NetGear FA-410TX

    +
    • + +
  • +

    Network Everywhere Ethernet 10BaseT PC Card

    +
    • + +
  • +

    Planex FNW-3600-T

    +
    • + +
  • +

    Socket LP-E

    +
    • + +
  • +

    Surecom EtherPerfect EP-427

    +
    • + +
  • +

    TDK LAK-CD031,Grey Cell GCS2000 Ethernet Card

    +
    • + +
  • +

    Telecom Device SuperSocket RE450T

    +
    • +
+
+
+ +

RealTek 8129/8139 Fast Ethernet NICs ( + rl(4) driver)

+ +
    +
  • +

    Accton ``Cheetah'' EN1207D (MPX 5030/5038; RealTek + 8139 clone)

    +
    • + +
  • +

    SOHO(PRAGMATIC) UE-1211C (PCI)

    +
    • +
+
+
+ +

Macronix 98713, 98713A, 98715, 98715A and 98725 Fast + Ethernet NICs ( + dc(4) driver)

+ +
    +
  • +

    Accton EN1217 (98715A)

    +
    • + +
  • +

    Adico AE310TX (98715A)

    +
    • + +
  • +

    Compex RL100-TX (98713 or 98713A)

    +
    • + +
  • +

    CNet Pro120A (98713 or 98713A)

    +
    • + +
  • +

    CNet Pro120B (98715)

    +
    • + +
  • +

    NDC Communications SFA100A (98713A)

    +
    • + +
  • +

    SVEC PN102TX (98713)

    +
    • +
+
+
+ +

Macronix/Lite-On PNIC II LC82C115 Fast Ethernet NICs + ( + dc(4) driver)

+ +
    +
  • +

    LinkSys EtherFast LNE100TX Version 2

    +
    • +
+
+
+ +

Winbond W89C840F Fast Ethernet NICs ( + wb(4) driver)

+ +
    +
  • +

    Trendware TE100-PCIE

    +
    • +
+
+
+ +

VIA Technologies VT3043 ``Rhine I'', VT86C100A ``Rhine + II'', and VT86C105/VT86C105M ``Rhine III'' Fast Ethernet + NICs ( + vr(4) driver)

+ +
    +
  • +

    MELCO LGY-PCI-TXR (PCI)

    +
    • + +
  • +

    CO-100MV (PCI)

    +
    • + +
  • +

    Corega FastEtherII PCI-TX (PCI)

    +
    • +
+
+
+ +

Silicon Integrated Systems SiS 900 and SiS 7016 PCI + Fast Ethernet NICs ( + sis(4) + driver)

+ +
    +
  • +

    @Nifty FNECHARD IFC-USUP-TX (PCI)

    +
    • + +
  • +

    MELCO LGY-PCI-TXC (PCI)

    +
    • +
+
+
+ +

National Semiconductor DP83815 Fast Ethernet NICs ( + sis(4) + driver)

+ +
    +
  • +

    NetGear FA311-TX

    +
    • + +
  • +

    NetGear FA312-TX

    +
    • +
+
+
+ +

National Semiconductor DP83820 and DP83821 Gigabit + Ethernet NICs ( + nge(4) + driver)

+ +
    +
  • +

    Addtron AEG320T

    +
    • + +
  • +

    Ark PC SOHO-GA2500T (32-bit PCI) and SOHO-GA2000T + (64-bit PCI)

    +
    • + +
  • +

    Asante FriendlyNet GigaNIC 1000TA and 1000TPC

    +
    • + +
  • +

    D-Link DGE-500T

    +
    • + +
  • +

    LinkSys EG1032 (32-bit PCI) and EG1064 (64-bit + PCI)

    +
    • + +
  • +

    Netgear GA621 and GA622T

    +
    • + +
  • +

    SMC EZ Card 1000 (SMC9462TX)

    +
    • + +
  • +

    Surecom Technology EP-320G-TX

    +
    • + +
  • +

    Trendware TEG-PCITX (32-bit PCI) and TEG-PCITX2 + (64-bit PCI)

    +
    • +
+
+
+ +

Sundance Technologies ST201 PCI Fast Ethernet NICs ( + ste(4) + driver)

+ +
    +
  • +

    D-Link DFE-550TX

    +
    • +
+
+
+ +

SysKonnect SK-984x PCI Gigabit Ethernet cards ( + sk(4) + drivers)

+ +
    +
  • +

    SK-9821 1000baseT copper, single port

    +
    • + +
  • +

    SK-9822 1000baseT copper, dual port

    +
    • + +
  • +

    SK-9841 1000baseLX single mode fiber, single + port

    +
    • + +
  • +

    SK-9842 1000baseLX single mode fiber, dual + port

    +
    • + +
  • +

    SK-9843 1000baseSX multimode fiber, single + port

    +
    • + +
  • +

    SK-9844 1000baseSX multimode fiber, dual port

    +
    • +
+
+
+ +

Texas Instruments ThunderLAN PCI NICs ( + tl(4) driver)

+ +
    +
  • +

    Compaq Netelligent 10, 10/100, 10/100 + Dual-Port

    +
    • + +
  • +

    Compaq Netelligent 10/100 TX Embedded UTP, 10 T + PCI UTP/Coax, 10/100 TX UTP

    +
    • + +
  • +

    Compaq NetFlex 3P, 3P Integrated, 3P w/BNC

    +
    • + +
  • +

    Olicom OC-2135/2138, OC-2325, OC-2326 10/100 TX + UTP

    +
    • + +
  • +

    Racore 8165 10/100baseTX

    +
    • + +
  • +

    Racore 8148 10baseT/100baseTX/100baseFX + multi-personality

    +
    • +
+
+
+ +

ADMtek Inc. AL981-based PCI Fast Ethernet NICs ( + dc(4) driver)

+ +

ADMtek Inc. AN985-based PCI Fast Ethernet NICs ( + dc(4) driver)

+ +
    +
  • +

    LinkSys EtherFast LNE100TX v4.0/4.1

    +
    • +
+
+
+ +

ADMtek Inc. AN986-based USB Ethernet NICs ( + aue(4) + driver)

+ +
    +
  • +

    Abocom UFE1000, DSB650TX_NA

    +
    • + +
  • +

    Accton USB320-EC, SpeedStream

    +
    • + +
  • +

    ADMtek AN986, AN8511

    +
    • + +
  • +

    Billionton USB100, USB100LP, USB100EL, USBE100

    +
    • + +
  • +

    Corega Ether FEther USB-T, FEther USB-TX, FEther + USB-TXS

    +
    • + +
  • +

    D-Link DSB-650, DSB-650TX, DSB-650TX-PNA

    +
    • + +
  • +

    Elecom LD-USBL/TX

    +
    • + +
  • +

    Elsa Microlink USB2Ethernet

    +
    • + +
  • +

    I-O Data USB ETTX

    +
    • + +
  • +

    Kingston KNU101TX

    +
    • + +
  • +

    LinkSys USB10T, USB10TA, USB10TX, USB100TX, + USB100H1

    +
    • + +
  • +

    MELCO LUA-TX, LUA2-TX

    +
    • + +
  • +

    Planex UE-200TX

    +
    • + +
  • +

    Siemens Speedstream

    +
    • + +
  • +

    SmartBridges smartNIC

    +
    • + +
  • +

    SMC 2202USB

    +
    • + +
  • +

    SOHOware NUB100

    +
    • +
+
+
+ +

CATC USB-EL1210A-based USB Ethernet NICs ( + cue(4) + driver)

+ +
    +
  • +

    Belkin F5U011, F5U111

    +
    • + +
  • +

    CATC Netmate, Netmate II

    +
    • + +
  • +

    SmartBridges SmartLink

    +
    • +
+
+
+ +

Kawasaki LSI KU5KUSB101B-based USB Ethernet NICs ( + kue(4) + driver)

+ +
    +
  • +

    3Com 3c19250

    +
    • + +
  • +

    AOX USB101

    +
    • + +
  • +

    Abocom URE 450

    +
    • + +
  • +

    ADS Technologies USB-10BT

    +
    • + +
  • +

    ATen UC10T

    +
    • + +
  • +

    Corega USB-T

    +
    • + +
  • +

    D-Link DSB-650C

    +
    • + +
  • +

    Entrega NET-USB-E45

    +
    • + +
  • +

    I/O Data USB ETT

    +
    • + +
  • +

    Kawasaki DU-H3E

    +
    • + +
  • +

    LinkSys USB10T

    +
    • + +
  • +

    Netgear EA101

    +
    • + +
  • +

    Peracom USB Ethernet Adapter

    +
    • + +
  • +

    SMC 2102USB, 2104USB

    +
    • +
+
+
+ +

ASIX Electronics AX88172-based USB Ethernet NICs ( + axe(4) + driver)

+ +
    +
  • +

    D-Link DUBE100

    +
    • + +
  • +

    Linksys USB200M

    +
    • + +
  • +

    Netgear FA120

    +
    • +
+
+
+ +

RealTek RTL8150-based USB Ethernet NICs ( + rue(4) + driver)

+ +
    +
  • +

    GREEN HOUSE GH-USB100B

    +
    • + +
  • +

    MELCO LUA-KTX

    +
    • +
+
+
+ +

ASIX Electronics AX88140A PCI NICs ( + dc(4) driver)

+ +
    +
  • +

    Alfa Inc. GFC2204

    +
    • + +
  • +

    CNet Pro110B

    +
    • +
+
+
+ +

DEC DC21040, DC21041, DC21140, DC21141, DC21142, and + DC21143 based NICs ( + de(4) driver)

+ +
    +
  • +

    Asante

    +
    • + +
  • +

    Cogent EM100FX and EM440TX

    +
    • + +
  • +

    DEC DE425, DE435, DE450, and DE500

    +
    • + +
  • +

    SMC Etherpower 8432T, 9332, and 9334

    +
    • + +
  • +

    ZYNX ZX 3xx

    +
    • + +
  • +

    I-O DATA LA2/T-PCI (PCI)

    +
    • + +
  • +

    ELECOM LD-PCI2T, LD-PCITS (PCI)

    +
    • + +
  • +

    Corega FastEther PCI-TX (PCI)

    +
    • +
+
+
+ +

DEC/Intel 21143 based Fast Ethernet NICs ( + dc(4) driver)

+ +
    +
  • +

    DEC DE500

    +
    • + +
  • +

    Compaq Presario 7900 series built-in Ethernet

    +
    • + +
  • +

    D-Link DFE-570TX

    +
    • + +
  • +

    Kingston KNE100TX

    +
    • + +
  • +

    LinkSys EtherFast 10/100 Instant GigaDrive + built-in Ethernet

    +
    • +
+
+
+ +

Davicom DM9009, DM9100 and DM9102 PCI Fast Ethernet + NICs ( + dc(4) driver)

+ +
    +
  • +

    Jaton Corporation XpressNet

    +
    • +
+
+
+ +

Cnet Pro120A (PCI) ( + dc(4) driver)

+ +

MELCO LGY-PCI-TXL (PCI) ( + dc(4) driver)

+ +

Fujitsu MB86960A/MB86965A based Fast Ethernet NICs ( + fe(4) driver)

+ +
    +
  • +

    Allied Telesis RE1000, RE1000Plus, ME1500 + (110pin)

    +
    • + +
  • +

    Contec C-NET(98)P2, C-NET(9N)E (110pin), + C-NET(9N)C(ExtCard)

    +
    • + +
  • +

    Ungermann-Bass Access/PC N98C+(PC85152,PC85142), + Access/NOTE N98 (PC86132) (110pin)

    +
    • + +
  • +

    TDK LAC-98012, LAC-98013, LAC-98025, LAC-9N011 + (110pin)

    +
    • + +
  • +

    Ratoc REX-9880/9881/9882/9883

    +
    • +
+
+
+ +

Intel 82557-, 82258-, 82559-, 82550- or 82562-based + Fast Ethernet NICs ( + fxp(4) + driver)

+ +
    +
  • +

    Intel EtherExpress Pro/100B PCI Fast Ethernet

    +
    • + +
  • +

    Intel PRO/100+ Management Adapter

    +
    • + +
  • +

    Intel Pro/100 VE Desktop Adapter

    +
    • + +
  • +

    Intel Pro/100 M Desktop Adapter

    +
    • + +
  • +

    Intel Pro/100 S Desktop, Server and Dual-Port + Server Adapters

    +
    • + +
  • +

    NEC PC-9821Ra20, Rv20, Xv13, Xv20 internal + 100Base-TX (PCI)

    +
    • + +
  • +

    NEC PC-9821X-B06 (PCI)

    +
    • + +
  • +

    Contec C-NET(PI)-100TX (PCI)

    +
    • +
+
+
+ +

3Com 3C5x9 Etherlink III NICs ( + ep(4) driver)

+ +
    +
  • +

    3Com 3C569, 3C569-TPO, 3C569B, 3C569B-COMBO

    +
    • +
+
+
+ +

3Com Etherlink XL-based NICs ( + xl(4) driver)

+ +
    +
  • +

    3C900/905/905B/905C PCI

    +
    • +
+
+
+ +

3Com 3C59X series NICs ( + vx(4) driver)

+ +
    +
  • +

    3C590 Etherlink III (PCI)

    +
    • + +
  • +

    3C595 Fast Etherlink III (PCI)

    +
    • +
+
+
+ +

National Semiconductor DP8393X (SONIC) Ethernet cards + (snc driver)

+ +
    +
  • +

    NEC PC-9801-83, -84, -103, and -104

    +
    • + +
  • +

    NEC PC-9801N-25 and -J02R

    +
    • +
+
+
+ +

Gigabit Ethernet cards based on the Level 1 LXT1001 + NetCellerator controller ( + lge(4) + driver)

+ +
    +
  • +

    D-Link DGE-500SX

    +
    • + +
  • +

    SMC TigerCard 1000 (SMC9462SX)

    +
    • +
+
+
+ +

Ethernet and Fast Ethernet NICs based on the 3Com 3XP + Typhoon/Sidewinder (3CR990) chipset ( + txp(4) + driver)

+ +
    +
  • +

    3Com 3CR990-TX-95

    +
    • + +
  • +

    3Com 3CR990-TX-97

    +
    • + +
  • +

    3Com 3CR990B-SRV

    +
    • + +
  • +

    3Com 3CR990B-TXM

    +
    • + +
  • +

    3Com 3CR990SVR95

    +
    • + +
  • +

    3Com 3CR990SVR97

    +
    • +
+
+
+ +

Gigabit Ethernet NICs based on the Broadcom BCM570x + ( + bge(4) + driver)

+ +
    +
  • +

    3Com 3c996-SX, 3c996-T

    +
    • + +
  • +

    Netgear GA302T

    +
    • + +
  • +

    SysKonnect SK-9D21 and 9D41

    +
    • +
+
+
+ +

Gigabit Ethernet NICs based on the Intel 82542 and + 82543 controller chips ( + gx(4) and + em(4) drivers), + plus NICs supported by the Intel 82540EM, 82544, 82545EM, + and 82546EB controller chips ( + em(4) driver + only)

+ +
    +
  • +

    Intel PRO/1000 Gigabit Ethernet

    +
    • +
+ +
+
+

Note: The + em(4) driver + is officially supported by Intel, but is only + supported on the i386.

+
+
+
+
+ +

Myson Ethernet NICs (my driver)

+ +
    +
  • +

    Myson MTD80X Based Fast Ethernet Card

    +
    • + +
  • +

    Myson MTD89X Based Gigabit Ethernet Card

    +
    • +
+
+
+
+ +
+
+ +

3.3 FDDI + Interfaces

+ +

DEC DEFPA PCI ( + fpa(4) + driver)

+
+ +
+
+ +

3.4 ATM + Interfaces

+ +

Efficient Networks, Inc. ENI-155p ATM PCI Adapters + (hea driver)

+ +

FORE Systems, Inc. PCA-200E ATM PCI Adapters (hfa + driver)

+ +

IDT 77201/211 NICStAR ATM Adapters (idt driver)

+ +

FORE Systems, Inc. LE155 ATM Adapter (idt driver)

+ +

The ATM support in FreeBSD supports the following + signaling protocols:

+ +
    +
  • +

    The ATM Forum UNI 3.1 signaling protocol

    +
    • + +
  • +

    The ATM Forum UNI 3.0 signaling protocol

    +
    • + +
  • +

    The ATM Forum ILMI address registration

    +
    • + +
  • +

    FORE Systems' proprietary SPANS signaling + protocol

    +
    • + +
  • +

    Permanent Virtual Channels (PVCs)

    +
    • +
+
+
+ +

Support for the IETF ``Classical IP and ARP over ATM'' + model is provided, compliant with the following RFCs and + Internet Drafts:

+ +
    +
  • +

    RFC 1483, ``Multiprotocol Encapsulation over ATM + Adaptation Layer 5''

    +
    • + +
  • +

    RFC 1577, ``Classical IP and ARP over ATM''

    +
    • + +
  • +

    RFC 1626, ``Default IP MTU for use over ATM + AAL5''

    +
    • + +
  • +

    RFC 1755, ``ATM Signaling Support for IP over + ATM''

    +
    • + +
  • +

    RFC 2225, ``Classical IP and ARP over ATM''

    +
    • + +
  • +

    RFC 2334, ``Server Cache Synchronization Protocol + (SCSP)''

    +
    • + +
  • +

    Internet Draft draft-ietf-ion-scsp-atmarp-00.txt, + ``A Distributed ATMARP Service Using SCSP''

    +
    • +
+
+
+ +

Support for an ATM sockets interface is also + provided.

+
+ +
+
+ +

3.5 + Wireless Network Interfaces

+ +

Lucent Technologies WaveLAN/IEEE 802.11 PCMCIA and ISA + standard speed (2Mbps) and turbo speed (6Mbps) wireless + network adapters and workalikes ( + wi(4) driver)

+ +
+
+

Note: The ISA versions of these adapters + are actually PCMCIA cards combined with an ISA to + PCMCIA bridge card, so both kinds of devices work + with the same driver.

+
+
+ +
    +
  • +

    3COM 3crwe737A AirConnect Wireless LAN PC Card

    +
    • + +
  • +

    Accton airDirect WN3301

    +
    • + +
  • +

    Addtron AWA100

    +
    • + +
  • +

    Adtec ADLINK340APC

    +
    • + +
  • +

    Airway 802.11 Adapter

    +
    • + +
  • +

    Avaya Wireless PC Card

    +
    • + +
  • +

    Blue Concentric Circle CF Wireless LAN Model + WL-379F

    +
    • + +
  • +

    BreezeNET PC-DS.11

    +
    • + +
  • +

    Buffalo WLI-CF-S11G

    +
    • + +
  • +

    Cabletron RoamAbout 802.11 DS

    +
    • + +
  • +

    Compaq WL100, WL110

    +
    • + +
  • +

    Corega KK Wireless LAN PCC-11, PCCA-11, + PCCB-11

    +
    • + +
  • +

    D-Link DWL-650

    +
    • + +
  • +

    Dell TrueMobile 1150 Series

    +
    • + +
  • +

    ELECOM Air@Hawk/LD-WL11/PCC

    +
    • + +
  • +

    ELSA AirLancer MC-11

    +
    • + +
  • +

    Farallon Skyline 11Mbps Wireless

    +
    • + +
  • +

    ICOM SL-1100

    +
    • + +
  • +

    IBM High Rate Wireless LAN PC Card

    +
    • + +
  • +

    Intel PRO/Wireless 2011 LAN PC Card

    +
    • + +
  • +

    IO Data WN-B11/PCM

    +
    • + +
  • +

    Laneed Wireless card

    +
    • + +
  • +

    Linksys Instant Wireless WPC11

    +
    • + +
  • +

    Lucent WaveLAN/IEEE 802.11

    +
    • + +
  • +

    MELCO Airconnect WLI-PCM-S11, WLI-PCM-L11

    +
    • + +
  • +

    NCR WaveLAN/IEEE 802.11

    +
    • + +
  • +

    NEC Wireless Card CMZ-RT-WP

    +
    • + +
  • +

    NEC Aterm WL11C (PC-WL/11C)

    +
    • + +
  • +

    NEC PK-WL001

    +
    • + +
  • +

    Netgear MA401

    +
    • + +
  • +

    PLANEX GeoWave/GW-NS110

    +
    • + +
  • +

    Proxim Harmony, RangeLAN-DS

    +
    • + +
  • +

    SMC 2632W, 2602W

    +
    • + +
  • +

    Sony PCWA-C100

    +
    • + +
  • +

    TDK LAK-CD011WL

    +
    • + +
  • +

    Toshiba Wireless LAN Card

    +
    • + +
  • +

    US Robotics Wireless Card 2410

    +
    • +
+
+
+ +

Aironet 802.11 wireless adapters ( + an(4) driver)

+ +
    +
  • +

    Aironet 4500/4800 series (PCMCIA, PCI, and ISA + adapters are all supported)

    +
    • + +
  • +

    Cisco Systems Aironet 340 and 350 series (PCMCIA, + PCI, Mini-PCI, and ISA adapters are all + supported)

    +
    • + +
  • +

    Xircom Wireless Ethernet adapter (rebadged + Aironet)

    +
    • +
+
+
+ +

Raytheon Raylink 2.4GHz wireless adapters ( + ray(4) + driver)

+ +
    +
  • +

    Webgear Aviator

    +
    • + +
  • +

    Webgear Aviator Pro

    +
    • + +
  • +

    Raytheon Raylink PC Card

    +
    • +
+
+
+ +

AMD Am79C930 and Harris (Intersil) based 802.11 cards + ( + awi(4) + driver)

+ +
    +
  • +

    BayStack 650 and 660

    +
    • + +
  • +

    Farallon SkyLINE Wireless

    +
    • + +
  • +

    Icom SL-200

    +
    • + +
  • +

    MELCO WLI-PCM

    +
    • + +
  • +

    NEL SSMagic

    +
    • + +
  • +

    Netwave AirSurfer Plus and AirSurfer Pro

    +
    • + +
  • +

    ZoomAir 4000

    +
    • +
+
+
+
+ +
+
+ +

3.6 + Miscellaneous Networks

+
+ +
+
+ +

3.7 ISDN + Interfaces

+
+ +
+
+ +

3.8 + Serial Interfaces

+ +

Internel serial interfaces ( + sio(4) + driver)

+ +
    +
  • +

    PC-9801 on-board

    +
    • + +
  • +

    PC-9821 2'nd CCU (flags 0x12000000)

    +
    • +
+
+
+ +

NEC PC-9861K, PC-9801-101 and Midori-Denshi MDC-926Rs + ( + sio(4) + driver)

+ +
    +
  • +

    COM2 (flags 0x01000000)

    +
    • + +
  • +

    COM3 (flags 0x02000000)

    +
    • +
+
+
+ +

NEC PC-9801-120 ( + sio(4) + driver)

+ +
+
+

Note: "flags 0x11000000" is necessary in + kernel configuration.

+
+
+ +

Microcore MC-16550, MC-16550II, MC-RS98 ( + sio(4) + driver)

+ +
+
+

Note: "flags 0x14000?01" is necessary in + kernel configuration.

+
+
+ +

Media Intelligent RSB-2000, RSB-3000 and AIWA B98-02 + ( + sio(4) + driver)

+ +
+
+

Note: "flags 0x15000?01" is necessary in + kernel configuration.

+
+
+ +

Media Intelligent RSB-384 ( + sio(4) + driver)

+ +
+
+

Note: "flags 0x16000001" is necessary in + kernel configuration.

+
+
+ +

I-O DATA RSA-98III ( + sio(4) + driver)

+ +
+
+

Note: "flags 0x18000?01" is necessary in + kernel configuration.

+
+
+ +

Hayes ESP98 ( + sio(4) + driver)

+ +
+
+

Note: "options COM_ESP" and "flags + 0x19000000" are necessary in kernel + configuration.

+
+
+
+ +
+
+ +

3.9 + Audio Devices

+ +

NEC PC-9801-73, 86 and compatibles (nss driver)

+ +
    +
  • +

    NEC A-MATE internal sound

    +
    • + +
  • +

    Q-Vision WaveStar, WaveMaster

    +
    • +
+
+
+ +

NEC X-MATE, CanBe, ValueStar internal (mss driver)

+ +

Creative Technologies SoundBlaster(98) ( + sb(4) driver)

+ +

I-O DATA CD-BOX ( + sb(4) driver)

+ +

Software PCM using beep (pca driver)

+ +

MPU-401 and compatible interfaces (mpu driver)

+ +
    +
  • +

    Q-Vision WaveStar

    +
    • +
+
+
+
+ +
+
+ +

3.10 + Camera and Video Capture Devices

+ +

Brooktree Bt848/849/878/879-based frame grabbers ( + bktr(4) + driver)

+ +
    +
  • +

    AverMedia cards

    +
    • + +
  • +

    Hauppauge Wincast TV and WinTV boards (PCI)

    +
    • + +
  • +

    Intel Smart Video Recorder III

    +
    • + +
  • +

    Miro PC TV

    +
    • + +
  • +

    STB TV PCI

    +
    • + +
  • +

    Video Highway XTreme

    +
    • + +
  • +

    VideoLogic Captivator PCI

    +
    • +
+
+
+
+ +
+
+ +

3.11 USB + Devices

+ +

A range of USB peripherals are supported; devices + known to work are listed in this section. Owing to the + generic nature of most USB devices, with some exceptions + any device of a given class will be supported, even if + not explicitly listed here.

+ +
+
+

Note: USB Ethernet adapters can be found in + the section listing Ethernet + interfaces.

+
+
+ +
+
+

Note: USB Bluetooth adapters can be found + in Bluetooth section.

+
+
+ +

Host Controllers ( + ohci(4) and + uhci(4) + drivers)

+ +
    +
  • +

    NEC PC-9821V200 etc ( + ohci(4) + driver)

    +
    • +
+
+
+ +

USB host controllers (PCI)

+ +
    +
  • +

    TRY CORPORATION JUS-02 ( + uhci(4) + driver)

    +
    • +
+
+
+ +

USB 2.0 controllers using the EHCI interface ( + ehci(4) + driver)

+ +

Hubs

+ +
    +
  • +

    Andromeda hub

    +
    • + +
  • +

    MacAlly self powered hub (4 ports)

    +
    • + +
  • +

    NEC hub

    +
    • +
+
+
+ +

Keyboards ( + ukbd(4) + driver)

+ +
    +
  • +

    Apple iMac keyboard

    +
    • + +
  • +

    BTC BTC7935 keyboard with PS/2 mouse port

    +
    • + +
  • +

    Cherry G81-3504 keyboard

    +
    • + +
  • +

    Logitech M2452 keyboard

    +
    • + +
  • +

    MacAlly iKey keyboard

    +
    • + +
  • +

    Microsoft keyboard

    +
    • + +
  • +

    Sun Microsystems Type 6 USB keyboard

    +
    • +
+
+
+ +

Miscellaneous

+ +
    +
  • +

    ActiveWire I/O Board

    +
    • + +
  • +

    Diamond Rio 500, 600, and 800 MP3 players ( + urio(4) + driver)

    +
    • + +
  • +

    D-Link DSB-R100 USB Radio (ufm driver)

    +
    • +
+
+
+ +

Modems ( + umodem(4) + driver)

+ +
    +
  • +

    3Com 5605

    +
    • + +
  • +

    Metricom Ricochet GS USB wireless modem

    +
    • + +
  • +

    Yamaha Broadband Wireless Router RTW65b

    +
    • +
+
+
+ +

Mice ( + ums(4) + driver)

+ +
    +
  • +

    Agiler Mouse 29UO

    +
    • + +
  • +

    Apple iMac Mouse

    +
    • + +
  • +

    Belkin Mouse

    +
    • + +
  • +

    Chic mouse

    +
    • + +
  • +

    Cypress mouse

    +
    • + +
  • +

    Genius Niche mouse

    +
    • + +
  • +

    Kensington Mouse-in-a-Box

    +
    • + +
  • +

    Logitech wheel mouse (3 buttons)

    +
    • + +
  • +

    Logitech PS/2 / USB mouse (3 buttons)

    +
    • + +
  • +

    MacAlly mouse (3 buttons)

    +
    • + +
  • +

    Microsoft IntelliMouse (3 buttons)

    +
    • + +
  • +

    Sun Microsystems Type 6 USB Mouse

    +
    • + +
  • +

    Trust Ami Mouse (3 buttons)

    +
    • +
+
+
+ +

Printers and parallel printer conversion cables ( + ulpt(4) + driver)

+ +
    +
  • +

    ATen parallel printer adapter

    +
    • + +
  • +

    Belkin F5U002 parallel printer adapter

    +
    • + +
  • +

    Entrega USB-to-parallel printer adapter

    +
    • +
+
+
+ +

Serial devices

+ +
    +
  • +

    Belkin F5U103 and F5U120 (ubsa driver)

    +
    • + +
  • +

    e-Tek Labs Kwik232 (ubsa driver)

    +
    • + +
  • +

    GoHubs GoCOM232 (ubsa driver)

    +
    • + +
  • +

    HP USB-Serial adapter ( + uftdi(4) + driver)

    +
    • + +
  • +

    Inland UAS111 ( + uftdi(4) + driver)

    +
    • + +
  • +

    Peracom single port serial adapter (ubsa + driver)

    +
    • + +
  • +

    Prolific PL-2303 serial adapter ( + uplcom(4) + driver)

    +
    • + +
  • +

    QVS USC-1000 ( + uftdi(4) + driver)

    +
    • + +
  • +

    SUNTAC Slipper U VS-10U ( + uvscom(4) + driver)

    +
    • +
+
+
+ +

Scanners (through SANE) ( + uscanner(4) + driver)

+ +
    +
  • +

    Perfection 636U

    +
    • + +
  • +

    HP ScanJet 4100C, 5200C, 6300C

    +
    • +
+
+
+ +

Storage ( + umass(4) + driver)

+ +
    +
  • +

    ADTEC Stick Drive AD-UST32M, 64M, 128M, 256M

    +
    • + +
  • +

    Denno FireWire/USB2 Removable 2.5-inch HDD Case + MIFU-25CB20

    +
    • + +
  • +

    FujiFilm Zip USB Drive ZDR100 USB A

    +
    • + +
  • +

    GREEN HOUSE USB Flash Memory ``PicoDrive'' + GH-UFD32M, 64M, 128M

    +
    • + +
  • +

    IBM 32MB USB Memory Key (P/N 22P5296)

    +
    • + +
  • +

    IBM ThinkPad USB Portable CD-ROM Drive (P/N + 33L5151)

    +
    • + +
  • +

    I-O DATA USB x6 CD-RW Drive CDRW-i64/USB (CDROM + only)

    +
    • + +
  • +

    I-O DATA USB + CD/CD-R/CD-RW/DVD-R/DVD-RW/DVD-RAM/DVD-ROM Drive + DVR-iUH2 (CDROM, DVD-RAM only)

    +
    • + +
  • +

    Iomega USB Zip 100Mb (primitive support still)

    +
    • + +
  • +

    Iomega Zip750 USB2.0 Drive

    +
    • + +
  • +

    Keian USB1.1/2.0 3.5-inch HDD Case KU350A

    +
    • + +
  • +

    Kurouto Shikou USB 2.5-inch HDD Case + GAWAP2.5PS-USB2.0

    +
    • + +
  • +

    Logitec USB1.1/2.0 HDD Unit SHD-E60U2

    +
    • + +
  • +

    Logitec Mobile USB Memory LMC-256UD

    +
    • + +
  • +

    Logitec USB Double-Speed Floppy Drive LFD-31U2

    +
    • + +
  • +

    Logitec USB/IEEE1394 DVD-RAM/R/RW Unit LDR-N21FU2 + (CDROM only)

    +
    • + +
  • +

    Matshita CF-VFDU03 floppy drive

    +
    • + +
  • +

    MELCO USB2.0 MO Drive MO-CH640U2

    +
    • + +
  • +

    I-O DATA USB/IEEE1394 Portable HD Drive + HDP-i30P/CI, HDP-i40P/CI

    +
    • + +
  • +

    MELCO USB Flash Disk ``PetitDrive'', RUF-32M, + -64M, -128M, -256M

    +
    • + +
  • +

    MELCO USB2.0 Flash Disk ``PetitDrive2'', + RUF-256M/U2, -512M/U2

    +
    • + +
  • +

    MELCO USB Flash Disk ``ClipDrive'', RUF-C32M, + -C64M, -C128M, -C256M, -C512M

    +
    • + +
  • +

    Microtech USB-SCSI-HD 50 USB to SCSI cable

    +
    • + +
  • +

    NOVAC USB2.0 2.5/3.5-inch HDD Case NV-HD351U

    +
    • + +
  • +

    Panasonic floppy drive

    +
    • + +
  • +

    Panasonic USB2.0 Portable CD-RW Drive KXL-RW40AN + (CDROM only)

    +
    • + +
  • +

    RATOC Systems USB2.0 Removable HDD Case U2-MDK1, + U2-MDK1B

    +
    • + +
  • +

    Sony Portable CD-R/RW Drive CRX10U (CDROM + only)

    +
    • + +
  • +

    TEAC Portable USB CD-ROM Unit CD-110PU/210PU

    +
    • + +
  • +

    Y-E Data floppy drive (720/1.44/2.88Mb)

    +
    • +
+
+
+ +

Audio Devices (uaudio driver)

+ +
    +
  • +

    Audio-Technica USB Digital Headphone + ATC-HA4USB

    +
    • + +
  • +

    Ergo Systems AUDIOTRAK OPTOPlay USB

    +
    • + +
  • +

    KENWOOD MD Personal Stereo System MDX-G7

    +
    • + +
  • +

    KENWOOD/SOTEC VH-7PC

    +
    • + +
  • +

    I-O DATA Analog to Digital USB Audio Adapter + DAVOX

    +
    • + +
  • +

    ONKYO PC Speaker GX-R5U(W)

    +
    • + +
  • +

    ONKYO USB Digital Audio Processor SE-U55X(S)

    +
    • + +
  • +

    Roland UA-5 USB Audio Interface ``Audio + Capture''

    +
    • + +
  • +

    Sony PC Active Speaker System SRS-T100PC

    +
    • +
+
+
+ +

Handspring Visor and other PalmOS devices ( + uvisor(4) + driver)

+ +
    +
  • +

    Handspring Visor

    +
    • + +
  • +

    Palm M125, M500, M505

    +
    • + +
  • +

    Sony Clie 4.0 and 4.1

    +
    • +
+
+
+
+ +
+
+ +

3.12 + IEEE 1394 (Firewire) Devices

+
+ +
+
+ +

3.13 + Bluetooth Devices

+ +

PCCARD Host Controllers ( + ng_bt3c(4) + driver)

+ +
    +
  • +

    3Com/HP 3CRWB6096-A PCCARD adapter

    +
    • +
+
+
+ +

USB Host Controllers ( + ng_ubt(4) + driver)

+ +
    +
  • +

    3Com 3CREB96

    +
    • + +
  • +

    EPoX BT-DG02

    +
    • + +
  • +

    Mitsumi USB Bluetooth adapter

    +
    • + +
  • +

    MSI MS-6967

    +
    • + +
  • +

    TDK Bluetooth USB adapter

    +
    • +
+
+
+
+ +
+
+ +

3.14 + Cryptographic Accelerators

+ +

Accelerators based on the Hifn 7751, 7811, or 7951 + chipsets ( + hifn(4) + driver)

+ +
    +
  • +

    Invertex AEON

    +
    • + +
  • +

    Hifn 7751 reference board

    +
    • + +
  • +

    Global Technologies Group PowerCrypt and + XL-Crypt

    +
    • + +
  • +

    NetSec 7751

    +
    • + +
  • +

    Soekris Engineering vpn1201 and vpn1211

    +
    • +
+
+
+ +

Accelerators based on the Bluesteel 5501 or 5601 + chipsets ( + ubsec(4) + driver)

+ +

Accelerators based on the Broadcom BCM5801, BCM5802, + BCM5805, BCM5820, BCM 5821, BCM5822 chipsets ( + ubsec(4) + driver)

+
+ +
+
+ +

3.15 + Miscellaneous

+ +

FAX-Modem/PCCARD

+ +
    +
  • +

    MELCO IGM-PCM56K/IGM-PCM56KH

    +
    • + +
  • +

    Nokia Card Phone 2.0 (gsm900/dcs1800 HSCSD + terminal)

    +
    • +
+
+
+ +

Floppy drives ( + fdc(4) + driver)

+ +

Keyboards including:

+ +
    +
  • +

    Standard keyboards

    +
    • + +
  • +

    USB keyboards (specific instances are listed in + the section describing USB + devices)

    +
    • +
+
+
+ +

Pointing devices including:

+ +
    +
  • +

    Bus mice and compatible devices ( + mse(4) + driver)

    +
    • + +
  • +

    Serial mice and compatible devices

    +
    • + +
  • +

    USB mice (specific instances are listed in the + section describing USB + devices)

    +
    • +
+ +
+
+

Note: + moused(8) has + more information on using pointing devices with + FreeBSD. Information on using pointing devices with + XFree86 can be found at http://www.xfree86.org/.

+
+
+
+
+ +

``PC-9821 standard'' parallel ports ( + ppc(4) + driver)

+ +

Joystick port of SoundBlaster(98) ( + joy(4) + driver)

+ +

PHS Data Communication Card/PCCARD

+ +
    +
  • +

    NTT DoCoMo P-in Comp@ct

    +
    • + +
  • +

    Panasonic KX-PH405

    +
    • + +
  • +

    SII MC-P200

    +
    • +
+
+
+ +

Power Management Controller of NEC PC-98 Note (pmc + driver)

+
+
+
+
+ +

This file, and other release-related + documents, can be downloaded from ftp://ftp.FreeBSD.org/.

+ +

For questions about FreeBSD, read the + documentation + before contacting <questions@FreeBSD.org>.

+ +

All users of FreeBSD 5-CURRENT + should subscribe to the <current@FreeBSD.org> + mailing list.

+ +

For questions about this documentation, + e-mail <doc@FreeBSD.org>.

+
+
+ + + diff --git a/en/releases/5.1R/hardware-sparc64.html b/en/releases/5.1R/hardware-sparc64.html new file mode 100644 index 0000000000..cec0d3dd07 --- /dev/null +++ b/en/releases/5.1R/hardware-sparc64.html @@ -0,0 +1,916 @@ + + + + + FreeBSD/sparc64 5.1-RELEASE Hardware Notes + + + + + +
+
+

FreeBSD/sparc64 + 5.1-RELEASE Hardware Notes

+ +

The FreeBSD Documentation + Project

+ +

Copyright © 2000, 2001, 2002, + 2003 by The FreeBSD Documentation Project

+
+
+ +
+
+
Table of Contents
+ +
1 Introduction
+ +
2 Supported Systems
+ +
+
+
2.1 Fully Supported + Systems
+ +
2.2 Partially Supported + Systems
+ +
2.3 Unsupported Systems
+
+
+ +
3 Supported Devices
+ +
+
+
3.1 Disk Controllers
+ +
3.2 Ethernet + Interfaces
+ +
3.3 FDDI Interfaces
+ +
3.4 ATM Interfaces
+ +
3.5 Wireless Network + Interfaces
+ +
3.6 Miscellaneous + Networks
+ +
3.7 ISDN Interfaces
+ +
3.8 Serial Interfaces
+ +
3.9 Audio Devices
+ +
3.10 Camera and Video Capture + Devices
+ +
3.11 USB Devices
+ +
3.12 IEEE 1394 (Firewire) + Devices
+ +
3.13 Bluetooth + Devices
+ +
3.14 Cryptographic + Accelerators
+ +
3.15 Miscellaneous
+
+
+
+
+ +
+
+ +

1 + Introduction

+ +

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.

+ +
+
+

Note: This document includes information + specific to the UltraSPARC hardware platform. Versions + of the hardware compatibility notes for other + architectures will differ in some details.

+
+
+
+ +
+
+ +

2 + Supported Systems

+ +

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 Sun System Handbook.

+ +

SMP is supported on all systems with more than 1 + processor.

+ +

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 FreeBSD SPARC porting mailing list with + your results, including which devices work and which do + not.

+ +
+
+ +

2.1 Fully + Supported Systems

+ +

The following systems are fully supported by + FreeBSD.

+ +
    +
  • +

    Blade 100

    +
    • + +
  • +

    Blade 150

    +
    • + +
  • +

    Enterprise 220R

    +
    • + +
  • +

    Enterprise 250

    +
    • + +
  • +

    Enterprise 420R

    +
    • + +
  • +

    Enterprise 450

    +
    • + +
  • +

    Fire V100

    +
    • + +
  • +

    Fire V120

    +
    • + +
  • +

    Netra t1 105

    +
    • + +
  • +

    Netra T1 AC200/DC200

    +
    • + +
  • +

    Netra t 1100

    +
    • + +
  • +

    Netra t 1120

    +
    • + +
  • +

    Netra t 1125

    +
    • + +
  • +

    Netra t 1400/1405

    +
    • + +
  • +

    Netra 120

    +
    • + +
  • +

    Netra X1

    +
    • + +
  • +

    SPARCEngine Ultra AXi

    +
    • + +
  • +

    SPARCEngine Ultra AXmp

    +
    • + +
  • +

    Ultra 5

    +
    • + +
  • +

    Ultra 10

    +
    • + +
  • +

    Ultra 30

    +
    • + +
  • +

    Ultra 60

    +
    • + +
  • +

    Ultra 80

    +
    • +
+
+ +
+
+ +

2.2 + Partially Supported Systems

+ +

The following systems are partially supported by + FreeBSD. In particular the onboard scsi controller in + sbus systems is not supported.

+ +
    +
  • +

    Enterprise 3500

    +
    • + +
  • +

    Enterprise 4500

    +
    • + +
  • +

    Ultra 1 Enterprise (1E for short)

    +
    • + +
  • +

    Ultra 2

    +
    • +
+
+ +
+
+ +

2.3 + Unsupported Systems

+ +

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.

+ +
    +
  • +

    All systems containing UltraSPARC III + processor(s).

    +
    • + +
  • +

    Ultra 1

    +
    • +
+
+
+ +
+
+ +

3 + Supported Devices

+ $FreeBSD: + src/release/doc/en_US.ISO8859-1/hardware/common/dev.sgml,v + 1.157 2003/05/30 11:24:00 nyan Exp $ + +

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.

+ +

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.

+ +
+
+ +

3.1 Disk + Controllers

+ +

IDE/ATA controllers ( + ata(4) + driver)

+ +
    +
  • +

    Acard ATP850 UDMA2, ATP860 UDMA4, ATP865 UDMA6

    +
    • + +
  • +

    AMD 756 ATA66, 766 ATA100, 768 ATA100

    +
    • + +
  • +

    Cenatek Rocket Drive

    +
    • + +
  • +

    CMD 646, 648 ATA66, and 649 ATA100

    +
    • + +
  • +

    Cypress 82C693

    +
    • + +
  • +

    Cyrix 5530 ATA33

    +
    • + +
  • +

    HighPoint HPT366 ATA66, HPT370 ATA100, HPT372 + ATA133, HPT374 ATA133

    +
    • + +
  • +

    Intel PIIX, PIIX3, PIIX4

    +
    • + +
  • +

    Intel ICH ATA66, ICH2 ATA100, ICH3 ATA100, ICH4 + ATA100

    +
    • + +
  • +

    nVidia nForce ATA100, nForce2 ATA133

    +
    • + +
  • +

    Promise ATA100 OEM chip (pdc20265)

    +
    • + +
  • +

    Promise ATA133 OEM chip (pdc20269)

    +
    • + +
  • +

    Promise Fasttrak-33, -66, -100, -100 TX2/TX4, -133 + TX2/TX2000

    +
    • + +
  • +

    Promise SATA150 TX2/TX4 Serial ATA/150

    +
    • + +
  • +

    Promise Ultra-33, -66, -100, -133 + TX2/TX2000/TX4000

    +
    • + +
  • +

    ServerWorks ROSB4 ATA33

    +
    • + +
  • +

    ServerWorks CSB5 and CSB6 ATA66/ATA100

    +
    • + +
  • +

    Sil 0680 UDMA6

    +
    • + +
  • +

    SiS 530, 540, 550, 620

    +
    • + +
  • +

    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

    +
    • + +
  • +

    SiS 5591 ATA100

    +
    • + +
  • +

    VIA 82C586 ATA33, 82C596 ATA66, 82C686a ATA66, + 82C686b ATA100

    +
    • + +
  • +

    VIA 8233, 8235 ATA133

    +
    • +
+
+
+ +

Adaptec SCSI Controllers

+ +
    +
  • +

    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 ( + ahc(4) + driver)

    +
    • +
+
+
+ +

Ultra-320 SCSI controllers based on the Adaptec + AIC7901, AIC7901A, and AIC7902 Ultra320 controller chips + ( + ahd(4) + driver)

+ +
    +
  • +

    Adaptec 29320, 29320A, 29320B, 29320LP

    +
    • + +
  • +

    Adaptec 39320, 39320D

    +
    • +
+
+
+ +

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 ( + ncr(4) and + sym(4) + drivers)

+ +
    +
  • +

    ASUS SC-200, SC-896

    +
    • + +
  • +

    Data Technology DTC3130 (all variants)

    +
    • + +
  • +

    DawiControl DC2976UW

    +
    • + +
  • +

    Diamond FirePort (all)

    +
    • + +
  • +

    NCR cards (all)

    +
    • + +
  • +

    Symbios cards (all)

    +
    • + +
  • +

    Tekram DC390W, 390U, 390F, 390U2B, 390U2W, 390U3D, + and 390U3W

    +
    • + +
  • +

    Tyan S1365

    +
    • +
+
+
+ +

Qlogic controllers and variants ( + isp(4) + driver)

+ +
    +
  • +

    Qlogic 1020, 1040 SCSI and Ultra SCSI host + adapters

    +
    • + +
  • +

    Qlogic 1240 dual Ultra SCSI controllers

    +
    • + +
  • +

    Qlogic 1080 Ultra2 LVD and 1280 Dual Ultra2 LVD + controllers

    +
    • + +
  • +

    Qlogic 12160 Ultra3 LVD controllers

    +
    • + +
  • +

    Qlogic 2100 and Qlogic 2200 Fibre Channel SCSI + controllers

    +
    • + +
  • +

    Qlogic 2300 and Qlogic 2312 2-Gigabit Fibre + Channel SCSI controllers

    +
    • + +
  • +

    Performance Technology SBS440 ISP1000 variants

    +
    • + +
  • +

    Performance Technology SBS450 ISP1040 variants

    +
    • + +
  • +

    Performance Technology SBS470 ISP2100 variants

    +
    • + +
  • +

    Antares Microsystems P-0033 ISP2100 variants

    +
    • +
+
+
+ +

LSI Logic Fusion/MP architecture Fiber Channel + controllers (mpt driver)

+ +
    +
  • +

    LSI FC909, FC929

    +
    • + +
  • +

    LSI 53c1020, 53c1030

    +
    • +
+
+
+ +

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 + cd(4)). + WORM/CD-R/CD-RW writing support is provided by + cdrecord(1), + which is a part of the + sysutils/cdrtools port in + the Ports Collection.

+ +

The following CD-ROM type systems are supported at + this time:

+ +
    +
  • +

    SCSI interface (also includes ProAudio Spectrum + and SoundBlaster SCSI) ( + cd(4))

    +
    • + +
  • +

    ATAPI IDE interface ( + acd(4))

    +
    • +
+
+
+
+ +
+
+ +

3.2 + Ethernet Interfaces

+ +

RealTek 8129/8139 Fast Ethernet NICs ( + rl(4) driver)

+ +
    +
  • +

    Accton ``Cheetah'' EN1207D (MPX 5030/5038; RealTek + 8139 clone)

    +
    • + +
  • +

    Allied Telesyn AT2550

    +
    • + +
  • +

    Allied Telesyn AT2500TX

    +
    • + +
  • +

    D-Link DFE-530TX+, DFE-538TX

    +
    • + +
  • +

    Farallon NetLINE 10/100 PCI

    +
    • + +
  • +

    Genius GF100TXR (RTL8139)

    +
    • + +
  • +

    KTX-9130TX 10/100 Fast Ethernet

    +
    • + +
  • +

    NDC Communications NE100TX-E

    +
    • + +
  • +

    Netronix Inc. EA-1210 NetEther 10/100

    +
    • + +
  • +

    OvisLink LEF-8129TX

    +
    • + +
  • +

    OvisLink LEF-8139TX

    +
    • + +
  • +

    SMC EZ Card 10/100 PCI 1211-TX

    +
    • +
+
+
+ +

Intel 82557-, 82258-, 82559-, 82550- or 82562-based + Fast Ethernet NICs ( + fxp(4) + driver)

+ +
    +
  • +

    Intel EtherExpress Pro/100B PCI Fast Ethernet

    +
    • + +
  • +

    Intel PRO/100+ Management Adapter

    +
    • + +
  • +

    Intel Pro/100 VE Desktop Adapter

    +
    • + +
  • +

    Intel Pro/100 M Desktop Adapter

    +
    • + +
  • +

    Intel Pro/100 S Desktop, Server and Dual-Port + Server Adapters

    +
    • +
+
+
+ +

3Com Etherlink XL-based NICs ( + xl(4) driver)

+ +
    +
  • +

    3C900/905/905B/905C PCI

    +
    • +
+
+
+ +

Sun HME and QFE Ethernet NICs (hme driver)

+ +

Sun GEM (Gigabit Ethernet) and ERI (Fast Ethernet) + NICs (gem driver)

+
+ +
+
+ +

3.3 FDDI + Interfaces

+
+ +
+
+ +

3.4 ATM + Interfaces

+
+ +
+
+ +

3.5 + Wireless Network Interfaces

+
+ +
+
+ +

3.6 + Miscellaneous Networks

+
+ +
+
+ +

3.7 ISDN + Interfaces

+
+ +
+
+ +

3.8 + Serial Interfaces

+ +

Serial ports based on the SAB82532 serial chip, + console only (sab driver)

+ +

Serial ports based on the Zilog 8530 dual uart, + console only (zs driver)

+
+ +
+
+ +

3.9 + Audio Devices

+
+ +
+
+ +

3.10 + Camera and Video Capture Devices

+
+ +
+
+ +

3.11 USB + Devices

+
+ +
+
+ +

3.12 + IEEE 1394 (Firewire) Devices

+ +

Host Controllers ( + fwohci(4) + driver)

+ +
    +
  • +

    Ricoh R5C552 chipset

    +
    • + +
  • +

    Sony CX3022 chipset

    +
    • + +
  • +

    TI TSB12LV22, LV23, 26 and TSB43AA22 chipsets

    +
    • + +
  • +

    uPD72861 chipset

    +
    • + +
  • +

    VIA VT6306 chipset

    +
    • +
+
+
+ +

Storage ( + sbp(4) + driver)

+ +
    +
  • +

    Apple iPod

    +
    • + +
  • +

    Apple Macintosh G4 (target mode)

    +
    • +
+
+
+
+ +
+
+ +

3.13 + Bluetooth Devices

+
+ +
+
+ +

3.14 + Cryptographic Accelerators

+
+ +
+
+ +

3.15 + Miscellaneous

+ +

OpenFirmware console (ofwcons driver)

+
+
+
+
+ +

This file, and other release-related + documents, can be downloaded from ftp://ftp.FreeBSD.org/.

+ +

For questions about FreeBSD, read the + documentation + before contacting <questions@FreeBSD.org>.

+ +

All users of FreeBSD 5-CURRENT + should subscribe to the <current@FreeBSD.org> + mailing list.

+ +

For questions about this documentation, + e-mail <doc@FreeBSD.org>.

+
+
+ + + diff --git a/en/releases/5.1R/hardware.sgml b/en/releases/5.1R/hardware.sgml new file mode 100644 index 0000000000..28e06b7503 --- /dev/null +++ b/en/releases/5.1R/hardware.sgml @@ -0,0 +1,30 @@ + + + + %includes; +]> + + &header; + +

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.

+ +

Hardware notes for FreeBSD 5.1-RELEASE are available for the following + platforms:

+ + + +

A list of all platforms currently under development can be found + on the Supported + Platforms page.

+ + diff --git a/en/releases/5.1R/installation-alpha.html b/en/releases/5.1R/installation-alpha.html new file mode 100644 index 0000000000..49ae00183e --- /dev/null +++ b/en/releases/5.1R/installation-alpha.html @@ -0,0 +1,1544 @@ + + + + + FreeBSD/alpha 5.1-RELEASE Installation + Instructions + + + + + +
+
+

FreeBSD/alpha + 5.1-RELEASE Installation Instructions

+ +

The FreeBSD Project

+ +

Copyright © 2000, 2001, 2002, + 2003 by The FreeBSD Documentation Project

+
+
+ +
+
+ + +

This article gives some brief instructions on + installing FreeBSD/alpha 5.1-RELEASE, with particular + emphasis given to obtaining a FreeBSD distribution. Some + notes on troubleshooting and frequently-asked questions + are also given.

+
+
+ +
+
+ +

1 + Installing FreeBSD

+ +

This section documents the process of installing a new + distribution of FreeBSD. These instructions pay particular + emphasis to the process of obtaining the FreeBSD + 5.1-RELEASE distribution and to beginning the installation + procedure. The ``Installing FreeBSD'' chapter of the FreeBSD Handbook provides more in-depth + information about the installation program itself, + including a guided walkthrough with screenshots.

+ +

If you are upgrading from a previous release of FreeBSD, + please see Section 3 for + instructions on upgrading.

+ +
+
+ +

1.1 Getting Started

+ +

Probably the most important pre-installation step that + can be taken is that of reading the various instruction + documents provided with FreeBSD. A roadmap of documents + pertaining to this release of FreeBSD can be found in README.TXT, which can usually be + found in the same location as this file; most of these + documents, such as the release notes and the hardware + compatibility list, are also accessible in the + Documentation menu of the installer.

+ +

Note that on-line versions of the FreeBSD FAQ and Handbook are also available from the + FreeBSD + Project Web site, if you have an Internet + connection.

+ +

This collection of documents may seem daunting, but + the time spent reading them will likely be saved many + times over. Being familiar with what resources are + available can also be helpful in the event of problems + during installation.

+ +

The best laid plans sometimes go awry, so if you run + into trouble take a look at Section + 4, which contains valuable troubleshooting + information. You should also read an updated copy of ERRATA.TXT before installing, since + this will alert you to any problems which have reported + in the interim for your particular release.

+ +
+
+

Important: While FreeBSD does its best to + safeguard against accidental loss of data, it's still + more than possible to wipe out your entire disk + with this installation if you make a mistake. Please + do not proceed to the final FreeBSD installation menu + unless you've adequately backed up any important data + first.

+
+
+
+ +
+
+ +

1.2 Hardware + Requirements

+ +

FreeBSD for the Alpha/AXP supports the platforms + described in HARDWARE.TXT.

+ +

You will need a dedicated disk for FreeBSD/alpha. It + is not possible to share a disk with another operating + system at this time. This disk will need to be attached + to a SCSI controller which is supported by the SRM + firmware or an IDE disk assuming the SRM in your machine + supports booting from IDE disks.

+ +

Your root filesystem MUST be the first partition + (partition a) on the disk to be + bootable.

+ +

You will need the SRM console firmware for your + platform. In some cases, it is possible to switch between + AlphaBIOS (or ARC) firmware and SRM. In others it will be + necessary to download new firmware from the vendor's Web + site.

+ +

If you are not familiar with configuring hardware for + FreeBSD, you should be sure to read the HARDWARE.TXT file; it contains + important information on what hardware is supported by + FreeBSD.

+
+ +
+
+ +

1.3 + Floppy Disk Image Instructions

+ +

Depending on how you choose to install FreeBSD, you + may need to create a set of floppy disks (usually two) to + begin the installation process. This section briefly + describes how to create these disks, either from a CDROM + installation or from the Internet. Note that in the + common case of installing FreeBSD from CDROM, on a + machine that supports bootable CDROMs, the steps outlined + in this section will not be needed and can be + skipped.

+ +

For most CDROM or network installations, all you need + to copy onto actual floppies from the floppies/ directory are the kern.flp and mfsroot.flp images (for 1.44MB + floppies). Depending on your hardware, you may also need + to make the third drivers.flp + image to provide necessary device drivers.

+ +

Getting these images over the network is easy. Simply + fetch the release/floppies/kern.flp, release/floppies/mfsroot.flp, and release/floppies/drivers.flp files from ftp://ftp.FreeBSD.org/ or one of the + many mirrors listed at FTP Sites section of the Handbook, or + on the http://www.freebsdmirrors.org/ Web + pages.

+ +

Get two blank, freshly formatted floppies and image + copy kern.flp onto one and mfsroot.flp onto the other. These + images are not DOS files. You cannot + simply copy them to a DOS or UFS floppy as regular files, + you need to ``image'' copy them to the floppy with fdimage.exe under DOS (see the tools directory on your CDROM or + FreeBSD FTP mirror) or the + dd(1) command in + UNIX.

+ +

For example, to create the kernel floppy image from + DOS, you'd do something like this:

+
+C> fdimage kern.flp a:
+
+ +

Assuming that you'd copied fdimage.exe and kern.flp into a directory + somewhere. You would do the same for mfsroot.flp, of course.

+ +

If you're creating the boot floppy from a UNIX + machine, you may find that:

+
+# dd if=floppies/kern.flp of=/dev/rfd0
+
+ +

or

+
+# dd if=floppies/kern.flp of=/dev/floppy
+
+ +

work well, depending on your hardware and operating + system environment (different versions of UNIX have + different names for the floppy drive).

+ +

If you're on an alpha machine that can network-boot + its floppy images or you have a 2.88MB or LS-120 floppy + capable of taking a 2.88MB image on an x86 machine, you + may wish to use the single (but twice as large) boot.flp image. It contains the + contents of kern.flp and mfsroot.flp on a single floppy. + This file should also be used as the boot file for those + mastering ``El Torito'' bootable CD images. See the + mkisofs(8) + command for more information.

+
+ +
+
+ +

1.4 Installing FreeBSD from + CDROM or the Internet

+ +

The easiest type of installation is from CDROM. If you + have a supported CDROM drive and a FreeBSD installation + CDROM, you can boot FreeBSD directly from the CDROM. + Insert the CDROM into the drive and type the following + command to start the installation (substituting the name + of the appropriate CDROM drive if necessary):

+
+>>>boot dka0
+
+ +

Alternatively you can boot the installation from + floppy disk. You should start the installation by + building a set of FreeBSD boot floppies from the files + floppies/kern.flp and floppies/mfsroot.flp using the + instructions found in Section + 1.3. From the SRM console prompt (>>>), just insert the kern.flp floppy and type the + following command to start the installation:

+
+>>>boot dva0
+
+ +

Insert the mfsroot.flp + floppy when prompted and you will end up at the first + screen of the install program.

+
+ +
+
+ +

1.5 Detail + on various installation types

+ +

Once you've gotten yourself to the initial + installation screen somehow, you should be able to follow + the various menu prompts and go from there. If you've + never used the FreeBSD installation before, you are also + encouraged to read some of the documentation in the + Documentation submenu as well as the general ``Usage'' + instructions on the first menu.

+ +
+
+

Note: If you get stuck at a screen, press + the F1 key for online + documentation relevant to that specific section.

+
+
+ +

If you've never installed FreeBSD before, or even if + you have, the ``Standard'' installation mode is the most + recommended since it makes sure that you'll visit all the + various important checklist items along the way. If + you're much more comfortable with the FreeBSD + installation process and know exactly what you want to do, + use the ``Express'' or ``Custom'' installation options. + If you're upgrading an existing system, use the + ``Upgrade'' option.

+ +

The FreeBSD installer supports the direct use of + floppy, DOS, tape, CDROM, FTP, NFS and UFS partitions as + installation media; further tips on installing from each + type of media are listed below.

+ +

Once the install procedure has finished, you will be + able to start FreeBSD/alpha by typing something like this + to the SRM prompt:

+
+>>>boot dkc0
+
+ +

This instructs the firmware to boot the specified + disk. To find the SRM names of disks in your machine, use + the show device command:

+
+>>>show device
+dka0.0.0.4.0               DKA0           TOSHIBA CD-ROM XM-57  3476
+dkc0.0.0.1009.0            DKC0                       RZ1BB-BS  0658
+dkc100.1.0.1009.0          DKC100             SEAGATE ST34501W  0015
+dva0.0.0.0.1               DVA0
+ewa0.0.0.3.0               EWA0              00-00-F8-75-6D-01
+pkc0.7.0.1009.0            PKC0                  SCSI Bus ID 7  5.27
+pqa0.0.0.4.0               PQA0                       PCI EIDE
+pqb0.0.1.4.0               PQB0                       PCI EIDE
+
+ +

This example is from a Digital Personal Workstation + 433au and shows three disks attached to the machine. The + first is a CDROM called dka0 + and the other two are disks and are called dkc0 and dkc100 respectively.

+ +

You can specify which kernel file to load and what + boot options to use with the -file and -flags options, for example:

+
+>>> boot -file kernel.old -flags s
+
+ +

To make FreeBSD/alpha boot automatically, use these + commands:

+
+>>> set boot_osflags a
+>>> set bootdef_dev dkc0
+>>> set auto_action BOOT
+
+ +
+
+ +

1.5.1 + Installing from a Network CDROM

+ +

If you simply wish to install from a local CDROM + drive then see Section + 1.4. If you don't have a CDROM drive on your system + and wish to use a FreeBSD distribution CD in the CDROM + drive of another system to which you have network + connectivity, there are also several ways of going + about it:

+ +
    +
  • +

    If you would be able to FTP install FreeBSD + directly from the CDROM drive in some FreeBSD + machine, it's quite easy: You simply add the + following line to the password file (using the + vipw(8) + command):

    +
    +ftp:*:99:99::0:0:FTP:/cdrom:/sbin/nologin
+
    + +

    On the machine on which you are running the + install, go to the Options menu and set Release + Name to any. You may then + choose a Media type of FTP + and type in ftp://machine after + picking ``URL'' in the ftp sites menu.

    + +
    +
    +

    Warning: This may allow anyone on the + local network (or Internet) to make ``anonymous + FTP'' connections to this machine, which may + not be desirable.

    +
    +
    +
    • + +
  • +

    If you would rather use NFS to export the CDROM + directly to the machine(s) you'll be installing + from, you need to first add an entry to the /etc/exports file (on the + machine with the CDROM drive). The example below + allows the machine ziggy.foo.com to mount the + CDROM directly via NFS during installation:

    +
    +/cdrom          -ro             ziggy.foo.com
+
    + +

    The machine with the CDROM must also be + configured as an NFS server, of course, and if + you're not sure how to do that then an NFS + installation is probably not the best choice for + you unless you're willing to read up on + rc.conf(5) + and configure things appropriately. Assuming that + this part goes smoothly, you should be able to + enter: cdrom-host:/cdrom + as the path for an NFS installation when the target + machine is installed, e.g. wiggy:/cdrom.

    +
    • +
+
+ +
+
+ +

1.5.2 + Installing from Floppies

+ +

If you must install from floppy disks, either due to + unsupported hardware or just because you enjoy doing + things the hard way, you must first prepare some + floppies for the install.

+ +

First, make your boot floppies as described in Section 1.3.

+ +

Second, peruse Section 2 and + pay special attention to the ``Distribution Format'' + section since it describes which files you're going to + need to put onto floppy and which you can safely + skip.

+ +

Next you will need, at minimum, as many 1.44MB + floppies as it takes to hold all files in the bin (binary distribution) + directory. If you're preparing these floppies under + DOS, then these floppies must be formatted using the + MS-DOS FORMAT command. If + you're using Windows, use the Windows File Manager + format command.

+ +
+
+

Important: Frequently, floppy disks come + ``factory preformatted''. While convenient, many + problems reported by users in the past have + resulted from the use of improperly formatted + media. Re-format them yourself, just to make + sure.

+
+
+ +

If you're creating the floppies from another FreeBSD + machine, a format is still not a bad idea though you + don't need to put a DOS filesystem on each floppy. You + can use the + disklabel(8) + and + newfs(8) + commands to put a UFS filesystem on a floppy, as the + following sequence of commands illustrates:

+
+# fdformat -f 1440 fd0.1440
+# disklabel -w -r fd0.1440 floppy3
+# newfs -t 2 -u 18 -l 1 -i 65536 /dev/fd0
+
+ +

After you've formatted the floppies for DOS or UFS, + you'll need to copy the files onto them. The + distribution files are split into chunks conveniently + sized so that 5 of them will fit on a conventional + 1.44MB floppy. Go through all your floppies, packing as + many files as will fit on each one, until you've got + all the distributions you want packed up in this + fashion. Each distribution should go into its own + subdirectory on the floppy, e.g.: a:\bin\bin.inf, a:\bin\bin.aa, a:\bin\bin.ab, ...

+ +
+
+

Important: The bin.inf file also needs to go + on the first floppy of the bin set since it is read by + the installation program in order to figure out how + many additional pieces to look for when fetching + and concatenating the distribution. When putting + distributions onto floppies, the distname.inf file must occupy the first + floppy of each distribution set. This is also + covered in README.TXT.

+
+
+ +

Once you come to the Media screen of the install, + select ``Floppy'' and you'll be prompted for the + rest.

+
+ +
+
+ +

1.5.4 + Installing from QIC/SCSI Tape

+ +

When installing from tape, the installation program + expects the files to be simply tar'ed onto it, so after + fetching all of the files for the distributions you're + interested in, simply use + tar(1) to get + them onto the tape with a command something like + this:

+
+# cd /where/you/have/your/dists
+# tar cvf /dev/rsa0 dist1 .. dist2
+
+ +

When you go to do the installation, you should also + make sure that you leave enough room in some temporary + directory (which you'll be allowed to choose) to + accommodate the full contents of the tape + you've created. Due to the non-random access nature of + tapes, this method of installation requires quite a bit + of temporary storage. You should expect to require as + much temporary storage as you have stuff written on + tape.

+ +
+
+

Note: When going to do the installation, + the tape must be in the drive before booting from the + boot floppies. The installation ``probe'' may + otherwise fail to find it.

+
+
+ +

Now create a boot floppy as described in Section 1.3 and proceed with the + installation.

+
+ +
+
+ +

1.5.5 + Installing over a Network using FTP or NFS

+ +

After making the boot floppies as described in the + first section, you can load the rest of the + installation over a network using one of 3 types of + connections: serial port, parallel port, or + Ethernet.

+ +
+
+ +

1.5.5.1 Serial Port

+ +

SLIP support is rather primitive, and is limited + primarily to hard-wired links, such as a serial cable + running between two computers. The link must be + hard-wired because the SLIP installation doesn't + currently offer a dialing capability. If you need to + dial out with a modem or otherwise dialog with the + link before connecting to it, then I recommend that + the PPP utility be used instead.

+ +

If you're using PPP, make sure that you have your + Internet Service Provider's IP address and DNS + information handy as you'll need to know it fairly + early in the installation process. You may also need + to know your own IP address, though PPP supports + dynamic address negotiation and may be able to pick + up this information directly from your ISP if they + support it.

+ +

You will also need to know how to use the various + ``AT commands'' for dialing out with your particular + brand of modem as the PPP dialer provides only a very + simple terminal emulator.

+
+ +
+
+ +

1.5.5.2 Parallel Port

+ +

If a hard-wired connection to another FreeBSD or + Linux machine is available, you might also consider + installing over a ``laplink'' style parallel port + cable. The data rate over the parallel port is much + higher than what is typically possible over a serial + line (up to 50k/sec), thus resulting in a quicker + installation. It's not typically necessary to use + ``real'' IP addresses when using a point-to-point + parallel cable in this way and you can generally just + use RFC 1918 style addresses for the ends of the link + (e.g. 10.0.0.1, 10.0.0.2, etc).

+ +
+
+

Important: If you use a Linux machine + rather than a FreeBSD machine as your PLIP peer, + you will also have to specify link0 in the TCP/IP setup + screen's ``extra options for ifconfig'' field in + order to be compatible with Linux's slightly + different PLIP protocol.

+
+
+
+ +
+
+ +

1.5.5.3 Ethernet

+ +

FreeBSD supports many common Ethernet cards; a + table of supported cards is provided as part of the + FreeBSD Hardware Notes (see HARDWARE.TXT in the + Documentation menu on the boot floppy or the top + level directory of the CDROM). If you are using one + of the supported PCMCIA Ethernet cards, also be sure + that it's plugged in before the laptop is + powered on. FreeBSD does not, unfortunately, + currently support ``hot insertion'' of PCMCIA cards + during installation.

+ +

You will also need to know your IP address on the + network, the netmask value + for your subnet and the name of your machine. Your + system administrator can tell you which values are + appropriate to your particular network setup. If you + will be referring to other hosts by name rather than + IP address, you'll also need a name server and + possibly the address of a gateway (if you're using + PPP, it's your provider's IP address) to use in + talking to it. If you want to install by FTP via an + HTTP proxy (see below), you will also need the + proxy's address.

+ +

If you do not know the answers to these questions + then you should really probably talk to your system + administrator first before trying this + type of installation. Using a randomly chosen IP + address or netmask on a live network is almost + guaranteed not to work, and will probably result in a + lecture from said system administrator.

+ +

Once you have a network connection of some sort + working, the installation can continue over NFS or + FTP.

+
+ +
+
+ +

1.5.5.4 NFS installation tips

+ +

NFS installation is fairly straight-forward: + Simply copy the FreeBSD distribution files you want + onto a server somewhere and then point the NFS media + selection at it.

+ +

If this server supports only ``privileged port'' + access (this is generally the default for Sun and + Linux workstations), you will need to set this option + in the Options menu before installation can + proceed.

+ +

If you have a poor quality Ethernet card which + suffers from very slow transfer rates, you may also + wish to toggle the appropriate Options flag.

+ +

In order for NFS installation to work, the server + must also support ``subdir mounts'', e.g. if your + FreeBSD distribution directory lives on wiggy:/usr/archive/stuff/FreeBSD, + then wiggy will have to allow + the direct mounting of /usr/archive/stuff/FreeBSD, not + just /usr or /usr/archive/stuff.

+ +

In FreeBSD's /etc/exports file this is + controlled by the -alldirs + option. Other NFS servers may have different + conventions. If you are getting Permission Denied messages from + the server then it's likely that you don't have this + properly enabled.

+
+ +
+
+ +

1.5.5.5 FTP Installation tips

+ +

FTP installation may be done from any mirror site + containing a reasonably up-to-date version of + FreeBSD. A full menu of reasonable choices for almost + any location in the world is provided in the FTP site + menu during installation.

+ +

If you are installing from some other FTP site not + listed in this menu, or you are having troubles + getting your name server configured properly, you can + also specify your own URL by selecting the ``URL'' + choice in that menu. A URL can contain a hostname or + an IP address, so something like the following would + work in the absence of a name server:

+
+ftp://216.66.64.162/pub/FreeBSD/releases/alpha/4.2-RELEASE
+
+ +

There are three FTP installation modes you can + use:

+ +
    +
  • +

    FTP: This method uses the standard ``Active'' + mode for transfers, in which the server initiates + a connection to the client. This will not work + through most firewalls but will often work best + with older FTP servers that do not support + passive mode. If your connection hangs with + passive mode, try this one.

    +
    • + +
  • +

    FTP Passive: This sets the FTP "Passive" mode + which prevents the server from opening + connections to the client. This option is best + for users to pass through firewalls that do not + allow incoming connections on random port + addresses.

    +
    • + +
  • +

    FTP via an HTTP proxy: This option instructs + FreeBSD to use HTTP to connect to a proxy for all + FTP operations. The proxy will translate the + requests and send them to the FTP server. This + allows the user to pass through firewalls that do + not allow FTP at all, but offer an HTTP proxy. + You must specify the hostname of the proxy in + addition to the FTP server.

    + +

    In the rare case that you have an FTP proxy + that does not go through HTTP, you can specify + the URL as something like:

    +
    +ftp://foo.bar.com:port/pub/FreeBSD
+
    + +

    In the URL above, port is the port + number of the proxy FTP server.

    +
    • +
+
+
+
+
+ +
+
+ +

1.5.6 + Tips for Serial Console Users

+ +

If you'd like to install FreeBSD on a machine using + just a serial port (e.g. you don't have or wish to use + a VGA card), please follow these steps:

+ +
+
    +
  1. +

    Connect some sort of ANSI (vt100) compatible + terminal or terminal emulation program to the COM1 port of the PC you + are installing FreeBSD onto.

    +
    2. + +
  2. +

    Unplug the keyboard (yes, that's correct!) and + then try to boot from floppy or the installation + CDROM, depending on the type of installation + media you have, with the keyboard unplugged.

    +
    3. + +
  3. +

    If you don't get any output on your serial + console, plug the keyboard in again and wait for + some beeps. If you are booting from the CDROM, + proceed to step 5 as soon + as you hear the beep.

    +
    4. + +
  4. +

    For a floppy boot, the first beep means to + remove the kern.flp + floppy and insert the mfsroot.flp floppy, after + which you should press Enter and wait for another + beep.

    +
    5. + +
  5. + + +

    Hit the space bar, then enter

    +
    +boot -h
+
    + +

    and you should now definitely be seeing + everything on the serial port. If that still + doesn't work, check your serial cabling as well + as the settings on your terminal emulation + program or actual terminal device. It should be + set for 9600 baud, 8 bits, no parity.

    +
    6. +
+
+
+
+ +
+
+ +

1.6 + Question and Answer Section for Alpha/AXP Architecture + Users

+ +
+
+
1.6.1. Can I boot from the ARC + or Alpha BIOS Console?
+ +
1.6.2. Help! I have no space! + Do I need to delete everything first?
+ +
1.6.3. Can I mount my Compaq + Tru64 or VMS extended partitions?
+ +
1.6.4. What about support for + Compaq Tru64 (OSF/1) binaries?
+ +
1.6.5. What about support for + Linux binaries?
+ +
1.6.6. What about support for + NT Alpha binaries?
+
+ +
+
+

1.6.1. + Can I boot from the ARC or Alpha BIOS Console?

+
+ +
+

No. FreeBSD, like Compaq Tru64 and VMS, + will only boot from the SRM console.

+
+
+ +
+
+

1.6.2. + Help! I have no space! Do I need to delete + everything first?

+
+ +
+

Unfortunately, yes.

+
+
+ +
+
+

1.6.3. + Can I mount my Compaq Tru64 or VMS extended + partitions?

+
+ +
+

No, not at this time.

+
+
+ +
+
+

1.6.4. + What about support for Compaq Tru64 (OSF/1) + binaries?

+
+ +
+

FreeBSD can run Tru64 applications very + well using the + emulators/osf1_base + port/package.

+
+
+ +
+
+

1.6.5. + What about support for Linux binaries?

+
+ +
+

FreeBSD can run AlphaLinux binaries with + the assistance of the + emulators/linux_base + port/package.

+
+
+ +
+
+

1.6.6. + What about support for NT Alpha binaries?

+
+ +
+

FreeBSD is not able to run NT + applications natively, although it has the ability + to mount NT partitions.

+
+
+
+
+
+ +
+
+ +

2 + Distribution Format

+ +

A typical FreeBSD distribution directory looks something + like this (exact details may vary depending on version, + architecture, and other factors):

+
+ERRATA.HTM      README.TXT      compat1x        dict            kernel
+ERRATA.TXT      RELNOTES.HTM    compat20        doc             manpages
+HARDWARE.HTM    RELNOTES.TXT    compat21        docbook.css     packages
+HARDWARE.TXT    base            compat22        filename.txt    ports
+INSTALL.HTM     boot            compat3x        floppies        proflibs
+INSTALL.TXT     catpages        compat4x        games           src
+README.HTM      cdrom.inf       crypto          info            tools
+
+ +

If you want to do a CDROM, FTP or NFS installation from + this distribution directory, all you need to do is make the + 1.44MB boot floppies from the floppies directory (see Section 1.3 for instructions on how to + do this), boot them and follow the instructions. The rest + of the data needed during the installation will be obtained + automatically based on your selections. If you've never + installed FreeBSD before, you also want to read the + entirety of this document (the installation instructions) + file.

+ +

If you're trying to do some other type of installation + or are merely curious about how a distribution is + organized, what follows is a more thorough description of + some of these items in more detail:

+ +
    +
  1. +

    The *.TXT and *.HTM files contain documentation + (for example, this document is contained in both INSTALL.TXT and INSTALL.HTM) and should be read + before starting an installation. The *.TXT files are plain text, while + the *.HTM files are HTML + files that can be read by almost any Web browser. Some + distributions may contain documentation in other + formats as well, such as PDF or PostScript.

    +
    2. + +
  2. +

    docbook.css is a Cascading + Style Sheet (CSS) file used by some Web browsers for + formatting the HTML documentation.

    +
    3. + +
  3. +

    The base, catpages, crypto, dict, doc, games, info, manpages, proflibs, and src directories contain the + primary distribution components of FreeBSD itself and + are split into smaller files for easy packing onto + floppies (should that be necessary).

    +
    4. + +
  4. +

    The compat1x, compat20, compat21, compat22, compat3x, and compat4x directories contain + distributions for compatibility with older releases and + are distributed as single gzip'd tar files - they can + be installed during release time or later by running + their install.sh scripts.

    +
    5. + +
  5. +

    The floppies/ subdirectory + contains the floppy installation images; further + information on using them can be found in Section 1.3.

    +
    6. + +
  6. +

    The packages and ports directories contain the + FreeBSD Packages and Ports Collections. Packages may be + installed from the packages directory by running the + command:

    +
    +#/stand/sysinstall configPackages
+
    + +

    Packages can also be installed by feeding individual + filenames in packages/ to the + + pkg_add(1) + command.

    + +

    The Ports Collection may be installed like any other + distribution and requires about 100MB unpacked. More + information on the ports collection may be obtained + from http://www.FreeBSD.org/ports/ or + locally from /usr/share/doc/handbook if you've + installed the doc + distribution.

    +
    7. + +
  7. +

    Last of all, the tools + directory contains various DOS tools for discovering + disk geometries, installing boot managers and the like. + It is purely optional and provided only for user + convenience.

    +
    8. +
+
+
+ +

A typical distribution directory (for example, the info distribution) looks like this + internally:

+
+CHECKSUM.MD5    info.ab         info.ad         info.inf        install.sh
+info.aa         info.ac         info.ae         info.mtree
+
+ +

The CHECKSUM.MD5 file contains + MD5 signatures for each file, should data corruption be + suspected, and is purely for reference. It is not used by + the actual installation and does not need to be copied with + the rest of the distribution files. The info.a* files are split, gzip'd tar + files, the contents of which can be viewed by doing:

+
+# cat info.a* | tar tvzf -
+
+ +

During installation, they are automatically concatenated + and extracted by the installation procedure.

+ +

The info.inf file is also + necessary since it is read by the installation program in + order to figure out how many pieces to look for when + fetching and concatenating the distribution. When putting + distributions onto floppies, the .inf file must occupy the first floppy of + each distribution set!

+ +

The info.mtree file is another + non-essential file which is provided for user reference. It + contains the MD5 signatures of the unpacked + distribution files and can be later used with the + mtree(8) program to + verify the installation permissions and checksums against + any possible modifications to the file. When used with the + base distribution, this can be an + excellent way of detecting trojan horse attacks on your + system.

+ +

Finally, the install.sh file + is for use by those who want to install the distribution + after installation time. To install the info distribution + from CDROM after a system was installed, for example, you'd + do:

+
+# cd /cdrom/info
+# sh install.sh
+
+
+ +
+
+ +

3 + Upgrading FreeBSD

+ +

These instructions describe a procedure for doing a + binary upgrade from an older version of FreeBSD.

+ +
+
+

Warning: While the FreeBSD upgrade procedure + does its best to safeguard against accidental loss of + data, it is still more than possible to wipe out your + entire disk with this installation! Please + do not accept the final confirmation request unless you + have adequately backed up any important data files.

+
+
+ +
+
+

Important: These notes assume that you are + using the version of + sysinstall(8) + supplied with the version of FreeBSD to which you + intend to upgrade. Using a mismatched version of + sysinstall(8) + is almost guaranteed to cause problems and has been + known to leave systems in an unusable state. The most + commonly made mistake in this regard is the use of an + old copy of + sysinstall(8) + from an existing installation to upgrade to a newer + version of FreeBSD. This is not recommended.

+
+
+ +
+
+

Warning: Binary upgrades to FreeBSD + 5.1-RELEASE from FreeBSD 4-STABLE are not supported at + this time. There are some files present in a FreeBSD + 4-STABLE whose presence can be disruptive, but are not + removed by a binary upgrade. One notable example is + that an old /usr/include/g++ + directory will cause C++ programs to compile + incorrectly (or not at all).

+ +

+ +

These upgrade instructions are provided for the use + of users upgrading from relatively recent FreeBSD + 5-CURRENT snapshots.

+
+
+ +
+
+ +

3.1 + Introduction

+ +

The upgrade procedure replaces distributions selected + by the user with those corresponding to the new FreeBSD + release. It preserves standard system configuration data, + as well as user data, installed packages and other + software.

+ +

Administrators contemplating an upgrade are encouraged + to study this section in its entirety before commencing + an upgrade. Failure to do so may result in a failed + upgrade or loss of data.

+ +
+
+ +

3.1.1 + Upgrade Overview

+ +

Upgrading of a distribution is performed by + extracting the new version of the component over the + top of the previous version. Files belonging to the old + distribution are not deleted.

+ +

System configuration is preserved by retaining and + restoring the previous version of the following + files:

+ +

Xaccel.ini, XF86Config, adduser.conf, aliases, aliases.db, amd.map, crontab, csh.cshrc, csh.login, csh.logout, cvsupfile, dhclient.conf, disktab, dm.conf, dumpdates, exports, fbtab, fstab, ftpusers, gettytab, gnats, group, hosts, hosts.allow, hosts.equiv, hosts.lpd, inetd.conf, localtime, login.access, login.conf, mail, mail.rc, make.conf, manpath.config, master.passwd, motd, namedb, networks, newsyslog.conf, nsmb.conf, nsswitch.conf, pam.conf, passwd, periodic, ppp, printcap, profile, pwd.db, rc.conf, rc.conf.local, rc.firewall, rc.local, remote, resolv.conf, rmt, sendmail.cf, sendmail.cw, services, shells, skeykeys, spwd.db, ssh, syslog.conf, ttys, uucp

+ +

The versions of these files which correspond to the + new version are moved to /etc/upgrade/. The system + administrator may peruse these new versions and merge + components as desired. Note that many of these files + are interdependent, and the best merge procedure is to + copy all site-specific data from the current files into + the new.

+ +

During the upgrade procedure, the administrator is + prompted for a location into which all files from /etc/ are saved. In the event + that local modifications have been made to other files, + they may be subsequently retrieved from this + location.

+
+
+ +
+
+ +

3.2 + Procedure

+ +

This section details the upgrade procedure. Particular + attention is given to items which substantially differ + from a normal installation.

+ +
+
+ +

3.2.1 + Backup

+ +

User data and system configuration should be backed + up before upgrading. While the upgrade procedure does + its best to prevent accidental mistakes, it is possible + to partially or completely destroy data and + configuration information.

+
+ +
+
+ +

3.2.2 + Mount Filesystems

+ +

The disklabel editor is entered with the nominated + disk's filesystem devices listed. Prior to commencing + the upgrade, the administrator should make a note of + the device names and corresponding mountpoints. These + mountpoints should be entered here. Do not + set the ``newfs flag'' for any filesystems, as this + will cause data loss.

+
+ +
+
+ +

3.2.3 + Select Distributions

+ +

When selecting distributions, there are no + constraints on which must be selected. As a general + rule, the base distribution + should be selected for an update, and the man distribution if manpages are + already installed. Other distributions may be selected + beyond those originally installed if the administrator + wishes to add additional functionality.

+
+ +
+
+ +

3.2.4 + After Installation

+ +

Once the installation procedure has completed, the + administrator is prompted to examine the new + configuration files. At this point, checks should be + made to ensure that the system configuration is valid. + In particular, the /etc/rc.conf and /etc/fstab files should be + checked.

+
+
+ +
+
+ +

3.3 + Upgrading from Source Code

+ +

Those interested in an upgrade method that allows more + flexibility and sophistication should take a look at The Cutting Edge in the FreeBSD + Handbook. This procedure involves rebuilding all of + FreeBSD from source code. It requires reliable network + connectivity, extra disk space, and time, but has + advantages for networks and other more complex + installations. This is roughly the same procedure as is + used for track the -STABLE or -CURRENT development + branches.

+ +

/usr/src/UPDATING contains + important information on updating a FreeBSD system from + source code. It lists various issues resulting from + changes in FreeBSD that may affect an upgrade.

+ +

+
+
+ +
+
+ +

4 + Troubleshooting

+ +
+

4.1 + Repairing an Existing FreeBSD Installation

+ +

FreeBSD features a ``Fixit'' option in the top menu of + the boot floppy. To use it, you will also need either a + fixit.flp image floppy, + generated in the same fashion as the boot floppy, or the + ``live filesystem'' CDROM; typically the second CDROM in + a multi-disc FreeBSD distribution.

+ +

To invoke fixit, simply boot the kern.flp floppy, choose the + ``Fixit'' item and insert the fixit floppy or CDROM when + asked. You will then be placed into a shell with a wide + variety of commands available (in the /stand and /mnt2/stand directories) for + checking, repairing and examining filesystems and their + contents. Some UNIX administration experience is + required to use the fixit option.

+
+ +
+
+ +

4.2 Common + Installation Problems for Alpha/AXP Architecture + Users

+
+
+
+
+ +

This file, and other release-related + documents, can be downloaded from ftp://ftp.FreeBSD.org/.

+ +

For questions about FreeBSD, read the + documentation + before contacting <questions@FreeBSD.org>.

+ +

All users of FreeBSD 5-CURRENT + should subscribe to the <current@FreeBSD.org> + mailing list.

+ +

For questions about this documentation, + e-mail <doc@FreeBSD.org>.

+
+
+ + + diff --git a/en/releases/5.1R/installation-i386.html b/en/releases/5.1R/installation-i386.html new file mode 100644 index 0000000000..0ca35fad18 --- /dev/null +++ b/en/releases/5.1R/installation-i386.html @@ -0,0 +1,2091 @@ + + + + + FreeBSD/i386 5.1-RELEASE Installation + Instructions + + + + + +
+
+

FreeBSD/i386 + 5.1-RELEASE Installation Instructions

+ +

The FreeBSD Project

+ +

Copyright © 2000, 2001, 2002, + 2003 by The FreeBSD Documentation Project

+
+
+ +
+
+ + +

This article gives some brief instructions on + installing FreeBSD/i386 5.1-RELEASE, with particular + emphasis given to obtaining a FreeBSD distribution. Some + notes on troubleshooting and frequently-asked questions + are also given.

+
+
+ +
+
+ +

1 + Installing FreeBSD

+ +

This section documents the process of installing a new + distribution of FreeBSD. These instructions pay particular + emphasis to the process of obtaining the FreeBSD + 5.1-RELEASE distribution and to beginning the installation + procedure. The ``Installing FreeBSD'' chapter of the FreeBSD Handbook provides more in-depth + information about the installation program itself, + including a guided walkthrough with screenshots.

+ +

If you are upgrading from a previous release of FreeBSD, + please see Section 3 for + instructions on upgrading.

+ +
+
+ +

1.1 Getting Started

+ +

Probably the most important pre-installation step that + can be taken is that of reading the various instruction + documents provided with FreeBSD. A roadmap of documents + pertaining to this release of FreeBSD can be found in README.TXT, which can usually be + found in the same location as this file; most of these + documents, such as the release notes and the hardware + compatibility list, are also accessible in the + Documentation menu of the installer.

+ +

Note that on-line versions of the FreeBSD FAQ and Handbook are also available from the + FreeBSD + Project Web site, if you have an Internet + connection.

+ +

This collection of documents may seem daunting, but + the time spent reading them will likely be saved many + times over. Being familiar with what resources are + available can also be helpful in the event of problems + during installation.

+ +

The best laid plans sometimes go awry, so if you run + into trouble take a look at Section + 4, which contains valuable troubleshooting + information. You should also read an updated copy of ERRATA.TXT before installing, since + this will alert you to any problems which have reported + in the interim for your particular release.

+ +
+
+

Important: While FreeBSD does its best to + safeguard against accidental loss of data, it's still + more than possible to wipe out your entire disk + with this installation if you make a mistake. Please + do not proceed to the final FreeBSD installation menu + unless you've adequately backed up any important data + first.

+
+
+
+ +
+
+ +

1.2 Hardware + Requirements

+ +

FreeBSD for the i386 requires a 386 or better + processor to run (sorry, there is no support for 286 + processors) and at least 5 megs of RAM to install and 4 + megs of RAM to run. You will need at least 100MB of free + hard drive space for the most minimal installation. See + below for ways of shrinking existing DOS partitions in + order to install FreeBSD.

+ +

If you are not familiar with configuring hardware for + FreeBSD, you should be sure to read the HARDWARE.TXT file; it contains + important information on what hardware is supported by + FreeBSD.

+
+ +
+
+ +

1.3 + Floppy Disk Image Instructions

+ +

Depending on how you choose to install FreeBSD, you + may need to create a set of floppy disks (usually two) to + begin the installation process. This section briefly + describes how to create these disks, either from a CDROM + installation or from the Internet. Note that in the + common case of installing FreeBSD from CDROM, on a + machine that supports bootable CDROMs, the steps outlined + in this section will not be needed and can be + skipped.

+ +

For most CDROM or network installations, all you need + to copy onto actual floppies from the floppies/ directory are the kern.flp and mfsroot.flp images (for 1.44MB + floppies). Depending on your hardware, you may also need + to make the third drivers.flp + image to provide necessary device drivers.

+ +

Getting these images over the network is easy. Simply + fetch the release/floppies/kern.flp, release/floppies/mfsroot.flp, and release/floppies/drivers.flp files from ftp://ftp.FreeBSD.org/ or one of the + many mirrors listed at FTP Sites section of the Handbook, or + on the http://www.freebsdmirrors.org/ Web + pages.

+ +

Get two blank, freshly formatted floppies and image + copy kern.flp onto one and mfsroot.flp onto the other. These + images are not DOS files. You cannot + simply copy them to a DOS or UFS floppy as regular files, + you need to ``image'' copy them to the floppy with fdimage.exe under DOS (see the tools directory on your CDROM or + FreeBSD FTP mirror) or the + dd(1) command in + UNIX.

+ +

For example, to create the kernel floppy image from + DOS, you'd do something like this:

+
+C> fdimage kern.flp a:
+
+ +

Assuming that you'd copied fdimage.exe and kern.flp into a directory + somewhere. You would do the same for mfsroot.flp, of course.

+ +

If you're creating the boot floppy from a UNIX + machine, you may find that:

+
+# dd if=floppies/kern.flp of=/dev/rfd0
+
+ +

or

+
+# dd if=floppies/kern.flp of=/dev/floppy
+
+ +

work well, depending on your hardware and operating + system environment (different versions of UNIX have + different names for the floppy drive).

+
+ +
+
+ +

1.4 Installing FreeBSD from + CDROM or the Internet

+ +

The easiest type of installation is from CDROM. If you + have a supported CDROM drive and a FreeBSD installation + CDROM, there are 2 ways of starting the installation from + it:

+ +
    +
  • +

    If your system supports bootable CDROM media + (usually an option which can be selectively enabled + in the controller's setup menu or in the PC BIOS for + some systems) and you have it enabled, FreeBSD + supports the ``El Torito'' bootable CD standard. + Simply put the installation CD in your CDROM drive + and boot the system to begin installation.

    +
    • + +
  • +

    Build a set of FreeBSD boot floppies from the floppies/ directory in every + FreeBSD distribution. Either simply use the makeflp.bat script from DOS or + read Section 1.3 for more + information on creating the bootable floppies under + different operating systems. Then you simply boot + from the first floppy and you should soon be in the + FreeBSD installation.

    +
    • +
+
+
+ +

If you don't have a CDROM (or your computer does not + support booting from CDROM) and would like to simply + install over the net using PPP, SLIP or a dedicated + connection. You should start the installation by building + a set of FreeBSD boot floppies from the files floppies/kern.flp and floppies/mfsroot.flp using the + instructions found in Section + 1.3. Restart your computer using the kern.flp disk; when prompted, + insert the mfsroot.flp disk. + Then, please go to Section 1.5.5 + for additional tips on installing via FTP or NFS.

+
+ +
+
+ +

1.5 Detail + on various installation types

+ +

Once you've gotten yourself to the initial + installation screen somehow, you should be able to follow + the various menu prompts and go from there. If you've + never used the FreeBSD installation before, you are also + encouraged to read some of the documentation in the + Documentation submenu as well as the general ``Usage'' + instructions on the first menu.

+ +
+
+

Note: If you get stuck at a screen, press + the F1 key for online + documentation relevant to that specific section.

+
+
+ +

If you've never installed FreeBSD before, or even if + you have, the ``Standard'' installation mode is the most + recommended since it makes sure that you'll visit all the + various important checklist items along the way. If + you're much more comfortable with the FreeBSD + installation process and know exactly what you want to do, + use the ``Express'' or ``Custom'' installation options. + If you're upgrading an existing system, use the + ``Upgrade'' option.

+ +

The FreeBSD installer supports the direct use of + floppy, DOS, tape, CDROM, FTP, NFS and UFS partitions as + installation media; further tips on installing from each + type of media are listed below.

+ +
+
+ +

1.5.1 + Installing from a Network CDROM

+ +

If you simply wish to install from a local CDROM + drive then see Section + 1.4. If you don't have a CDROM drive on your system + and wish to use a FreeBSD distribution CD in the CDROM + drive of another system to which you have network + connectivity, there are also several ways of going + about it:

+ +
    +
  • +

    If you would be able to FTP install FreeBSD + directly from the CDROM drive in some FreeBSD + machine, it's quite easy: You simply add the + following line to the password file (using the + vipw(8) + command):

    +
    +ftp:*:99:99::0:0:FTP:/cdrom:/sbin/nologin
+
    + +

    On the machine on which you are running the + install, go to the Options menu and set Release + Name to any. You may then + choose a Media type of FTP + and type in ftp://machine after + picking ``URL'' in the ftp sites menu.

    + +
    +
    +

    Warning: This may allow anyone on the + local network (or Internet) to make ``anonymous + FTP'' connections to this machine, which may + not be desirable.

    +
    +
    +
    • + +
  • +

    If you would rather use NFS to export the CDROM + directly to the machine(s) you'll be installing + from, you need to first add an entry to the /etc/exports file (on the + machine with the CDROM drive). The example below + allows the machine ziggy.foo.com to mount the + CDROM directly via NFS during installation:

    +
    +/cdrom          -ro             ziggy.foo.com
+
    + +

    The machine with the CDROM must also be + configured as an NFS server, of course, and if + you're not sure how to do that then an NFS + installation is probably not the best choice for + you unless you're willing to read up on + rc.conf(5) + and configure things appropriately. Assuming that + this part goes smoothly, you should be able to + enter: cdrom-host:/cdrom + as the path for an NFS installation when the target + machine is installed, e.g. wiggy:/cdrom.

    +
    • +
+
+ +
+
+ +

1.5.2 + Installing from Floppies

+ +

If you must install from floppy disks, either due to + unsupported hardware or just because you enjoy doing + things the hard way, you must first prepare some + floppies for the install.

+ +

First, make your boot floppies as described in Section 1.3.

+ +

Second, peruse Section 2 and + pay special attention to the ``Distribution Format'' + section since it describes which files you're going to + need to put onto floppy and which you can safely + skip.

+ +

Next you will need, at minimum, as many 1.44MB + floppies as it takes to hold all files in the bin (binary distribution) + directory. If you're preparing these floppies under + DOS, then these floppies must be formatted using the + MS-DOS FORMAT command. If + you're using Windows, use the Windows File Manager + format command.

+ +
+
+

Important: Frequently, floppy disks come + ``factory preformatted''. While convenient, many + problems reported by users in the past have + resulted from the use of improperly formatted + media. Re-format them yourself, just to make + sure.

+
+
+ +

If you're creating the floppies from another FreeBSD + machine, a format is still not a bad idea though you + don't need to put a DOS filesystem on each floppy. You + can use the + disklabel(8) + and + newfs(8) + commands to put a UFS filesystem on a floppy, as the + following sequence of commands illustrates:

+
+# fdformat -f 1440 fd0.1440
+# disklabel -w -r fd0.1440 floppy3
+# newfs -t 2 -u 18 -l 1 -i 65536 /dev/fd0
+
+ +

After you've formatted the floppies for DOS or UFS, + you'll need to copy the files onto them. The + distribution files are split into chunks conveniently + sized so that 5 of them will fit on a conventional + 1.44MB floppy. Go through all your floppies, packing as + many files as will fit on each one, until you've got + all the distributions you want packed up in this + fashion. Each distribution should go into its own + subdirectory on the floppy, e.g.: a:\bin\bin.inf, a:\bin\bin.aa, a:\bin\bin.ab, ...

+ +
+
+

Important: The bin.inf file also needs to go + on the first floppy of the bin set since it is read by + the installation program in order to figure out how + many additional pieces to look for when fetching + and concatenating the distribution. When putting + distributions onto floppies, the distname.inf file must occupy the first + floppy of each distribution set. This is also + covered in README.TXT.

+
+
+ +

Once you come to the Media screen of the install, + select ``Floppy'' and you'll be prompted for the + rest.

+
+ +
+
+ +

1.5.3 + Installing from a DOS partition

+ +

To prepare for installation from an MS-DOS partition + you should simply copy the files from the distribution + into a directory called FREEBSD on the Primary DOS + partition (C:). For + example, to do a minimal installation of FreeBSD from + DOS using files copied from the CDROM, you might do + something like this:

+
+C:\> MD C:\FREEBSD
+C:\> XCOPY /S E:\BASE C:\FREEBSD\BASE
+
+ +

Assuming that E: was + where your CD was mounted.

+ +

For as many distributions as you wish to install + from DOS (and you have free space for), install each + one in a directory under C:\FREEBSD - the BIN dist is only the minimal + requirement.

+ +

Once you've copied the directories, you can simply + launch the installation from floppies as normal and + select ``DOS'' as your media type when the time + comes.

+
+ +
+
+ +

1.5.4 + Installing from QIC/SCSI Tape

+ +

When installing from tape, the installation program + expects the files to be simply tar'ed onto it, so after + fetching all of the files for the distributions you're + interested in, simply use + tar(1) to get + them onto the tape with a command something like + this:

+
+# cd /where/you/have/your/dists
+# tar cvf /dev/rsa0 dist1 .. dist2
+
+ +

When you go to do the installation, you should also + make sure that you leave enough room in some temporary + directory (which you'll be allowed to choose) to + accommodate the full contents of the tape + you've created. Due to the non-random access nature of + tapes, this method of installation requires quite a bit + of temporary storage. You should expect to require as + much temporary storage as you have stuff written on + tape.

+ +
+
+

Note: When going to do the installation, + the tape must be in the drive before booting from the + boot floppies. The installation ``probe'' may + otherwise fail to find it.

+
+
+ +

Now create a boot floppy as described in Section 1.3 and proceed with the + installation.

+
+ +
+
+ +

1.5.5 + Installing over a Network using FTP or NFS

+ +

After making the boot floppies as described in the + first section, you can load the rest of the + installation over a network using one of 3 types of + connections: serial port, parallel port, or + Ethernet.

+ +
+
+ +

1.5.5.1 Serial Port

+ +

SLIP support is rather primitive, and is limited + primarily to hard-wired links, such as a serial cable + running between two computers. The link must be + hard-wired because the SLIP installation doesn't + currently offer a dialing capability. If you need to + dial out with a modem or otherwise dialog with the + link before connecting to it, then I recommend that + the PPP utility be used instead.

+ +

If you're using PPP, make sure that you have your + Internet Service Provider's IP address and DNS + information handy as you'll need to know it fairly + early in the installation process. You may also need + to know your own IP address, though PPP supports + dynamic address negotiation and may be able to pick + up this information directly from your ISP if they + support it.

+ +

You will also need to know how to use the various + ``AT commands'' for dialing out with your particular + brand of modem as the PPP dialer provides only a very + simple terminal emulator.

+
+ +
+
+ +

1.5.5.2 Parallel Port

+ +

If a hard-wired connection to another FreeBSD or + Linux machine is available, you might also consider + installing over a ``laplink'' style parallel port + cable. The data rate over the parallel port is much + higher than what is typically possible over a serial + line (up to 50k/sec), thus resulting in a quicker + installation. It's not typically necessary to use + ``real'' IP addresses when using a point-to-point + parallel cable in this way and you can generally just + use RFC 1918 style addresses for the ends of the link + (e.g. 10.0.0.1, 10.0.0.2, etc).

+ +
+
+

Important: If you use a Linux machine + rather than a FreeBSD machine as your PLIP peer, + you will also have to specify link0 in the TCP/IP setup + screen's ``extra options for ifconfig'' field in + order to be compatible with Linux's slightly + different PLIP protocol.

+
+
+
+ +
+
+ +

1.5.5.3 Ethernet

+ +

FreeBSD supports many common Ethernet cards; a + table of supported cards is provided as part of the + FreeBSD Hardware Notes (see HARDWARE.TXT in the + Documentation menu on the boot floppy or the top + level directory of the CDROM). If you are using one + of the supported PCMCIA Ethernet cards, also be sure + that it's plugged in before the laptop is + powered on. FreeBSD does not, unfortunately, + currently support ``hot insertion'' of PCMCIA cards + during installation.

+ +

You will also need to know your IP address on the + network, the netmask value + for your subnet and the name of your machine. Your + system administrator can tell you which values are + appropriate to your particular network setup. If you + will be referring to other hosts by name rather than + IP address, you'll also need a name server and + possibly the address of a gateway (if you're using + PPP, it's your provider's IP address) to use in + talking to it. If you want to install by FTP via an + HTTP proxy (see below), you will also need the + proxy's address.

+ +

If you do not know the answers to these questions + then you should really probably talk to your system + administrator first before trying this + type of installation. Using a randomly chosen IP + address or netmask on a live network is almost + guaranteed not to work, and will probably result in a + lecture from said system administrator.

+ +

Once you have a network connection of some sort + working, the installation can continue over NFS or + FTP.

+
+ +
+
+ +

1.5.5.4 NFS installation tips

+ +

NFS installation is fairly straight-forward: + Simply copy the FreeBSD distribution files you want + onto a server somewhere and then point the NFS media + selection at it.

+ +

If this server supports only ``privileged port'' + access (this is generally the default for Sun and + Linux workstations), you will need to set this option + in the Options menu before installation can + proceed.

+ +

If you have a poor quality Ethernet card which + suffers from very slow transfer rates, you may also + wish to toggle the appropriate Options flag.

+ +

In order for NFS installation to work, the server + must also support ``subdir mounts'', e.g. if your + FreeBSD distribution directory lives on wiggy:/usr/archive/stuff/FreeBSD, + then wiggy will have to allow + the direct mounting of /usr/archive/stuff/FreeBSD, not + just /usr or /usr/archive/stuff.

+ +

In FreeBSD's /etc/exports file this is + controlled by the -alldirs + option. Other NFS servers may have different + conventions. If you are getting Permission Denied messages from + the server then it's likely that you don't have this + properly enabled.

+
+ +
+
+ +

1.5.5.5 FTP Installation tips

+ +

FTP installation may be done from any mirror site + containing a reasonably up-to-date version of + FreeBSD. A full menu of reasonable choices for almost + any location in the world is provided in the FTP site + menu during installation.

+ +

If you are installing from some other FTP site not + listed in this menu, or you are having troubles + getting your name server configured properly, you can + also specify your own URL by selecting the ``URL'' + choice in that menu. A URL can contain a hostname or + an IP address, so something like the following would + work in the absence of a name server:

+
+ftp://216.66.64.162/pub/FreeBSD/releases/i386/4.2-RELEASE
+
+ +

There are three FTP installation modes you can + use:

+ +
    +
  • +

    FTP: This method uses the standard ``Active'' + mode for transfers, in which the server initiates + a connection to the client. This will not work + through most firewalls but will often work best + with older FTP servers that do not support + passive mode. If your connection hangs with + passive mode, try this one.

    +
    • + +
  • +

    FTP Passive: This sets the FTP "Passive" mode + which prevents the server from opening + connections to the client. This option is best + for users to pass through firewalls that do not + allow incoming connections on random port + addresses.

    +
    • + +
  • +

    FTP via an HTTP proxy: This option instructs + FreeBSD to use HTTP to connect to a proxy for all + FTP operations. The proxy will translate the + requests and send them to the FTP server. This + allows the user to pass through firewalls that do + not allow FTP at all, but offer an HTTP proxy. + You must specify the hostname of the proxy in + addition to the FTP server.

    + +

    In the rare case that you have an FTP proxy + that does not go through HTTP, you can specify + the URL as something like:

    +
    +ftp://foo.bar.com:port/pub/FreeBSD
+
    + +

    In the URL above, port is the port + number of the proxy FTP server.

    +
    • +
+
+
+
+
+ +
+
+ +

1.5.6 + Tips for Serial Console Users

+ +

If you'd like to install FreeBSD on a machine using + just a serial port (e.g. you don't have or wish to use + a VGA card), please follow these steps:

+ +
+
    +
  1. +

    Connect some sort of ANSI (vt100) compatible + terminal or terminal emulation program to the COM1 port of the PC you + are installing FreeBSD onto.

    +
    2. + +
  2. +

    Unplug the keyboard (yes, that's correct!) and + then try to boot from floppy or the installation + CDROM, depending on the type of installation + media you have, with the keyboard unplugged.

    +
    3. + +
  3. +

    If you don't get any output on your serial + console, plug the keyboard in again and wait for + some beeps. If you are booting from the CDROM, + proceed to step 5 as soon + as you hear the beep.

    +
    4. + +
  4. +

    For a floppy boot, the first beep means to + remove the kern.flp + floppy and insert the mfsroot.flp floppy, after + which you should press Enter and wait for another + beep.

    +
    5. + +
  5. + + +

    Hit the space bar, then enter

    +
    +boot -h
+
    + +

    and you should now definitely be seeing + everything on the serial port. If that still + doesn't work, check your serial cabling as well + as the settings on your terminal emulation + program or actual terminal device. It should be + set for 9600 baud, 8 bits, no parity.

    +
    6. +
+
+
+
+ +
+
+ +

1.6 + Question and Answer Section for i386 Architecture + Users

+ +
+
+
1.6.1. Help! I have no space! + Do I need to delete everything first?
+ +
1.6.2. Can I use compressed + DOS filesystems from FreeBSD?
+ +
1.6.3. Can I mount my DOS + extended partitions?
+ +
1.6.4. Can I run DOS binaries + under FreeBSD?
+
+ +
+
+

1.6.1. + Help! I have no space! Do I need to delete + everything first?

+
+ +
+

If your machine is already running DOS + and has little or no free space available for + FreeBSD's installation, all is not lost! You may + find the FIPS utility, + provided in the tools/ + subdirectory on the FreeBSD CDROM or on the various + FreeBSD ftp sites, to be quite useful.

+ +

FIPS allows you to + split an existing DOS partition into two pieces, + preserving the original partition and allowing you + to install onto the second free piece. You first + ``defrag'' your DOS partition, using the DOS 6.xx + DEFRAG utility or the Norton Disk Tools, then run + FIPS. It will prompt you for the rest of the + information it needs. Afterwards, you can reboot + and install FreeBSD on the new partition. Also note + that FIPS will create the second partition as a + ``clone'' of the first, so you'll actually see that + you now have two DOS Primary partitions where you + formerly had one. Don't be alarmed! You can simply + delete the extra DOS Primary partition (making sure + it's the right one by examining its size).

+ +

FIPS does NOT + currently work with NTFS style partitions. To split + up such a partition, you will need a commercial + product such as Partition + Magic. Sorry, but this is just the breaks if + you've got a Windows partition hogging your whole + disk and you don't want to reinstall from + scratch.

+
+
+ +
+
+

1.6.2. + Can I use compressed DOS filesystems from + FreeBSD?

+
+ +
+

No. If you are using a utility such as Stacker(tm) or DoubleSpace(tm), FreeBSD + will only be able to use whatever portion of the + filesystem you leave uncompressed. The rest of the + filesystem will show up as one large file (the + stacked/dblspaced file!). Do not remove that file + as you will probably regret it greatly!

+ +

It is probably better to create another + uncompressed DOS extended partition and use this + for communications between DOS and FreeBSD if such + is your desire.

+
+
+ +
+
+

1.6.3. + Can I mount my DOS extended partitions?

+
+ +
+

Yes. DOS extended partitions are mapped + in at the end of the other ``slices'' in FreeBSD, + e.g. your D: drive + might be /dev/da0s5, your + E: drive /dev/da0s6, and so on. This + example assumes, of course, that your extended + partition is on SCSI drive 0. For IDE drives, + substitute ad for da appropriately. You + otherwise mount extended partitions exactly like + you would mount any other DOS drive, e.g.:

+
+# mount -t msdos /dev/da0s5 /dos_d
+
+
+
+ +
+
+

1.6.4. + Can I run DOS binaries under FreeBSD?

+
+ +
+

Ongoing work with BSDI's + doscmd(1) + utility will suffice in many cases, though it still + has some rough edges. If you're interested in + working on this, please send mail to the FreeBSD-emulation mailing list + and indicate that you're interested in joining this + ongoing effort!

+ +

The + emulators/pcemu + port/package in the FreeBSD Ports Collection which + emulates an 8088 and enough BIOS services to run + DOS text mode applications. It requires the X + Window System (XFree86) to operate.

+
+
+
+
+
+ +
+
+ +

2 + Distribution Format

+ +

A typical FreeBSD distribution directory looks something + like this (exact details may vary depending on version, + architecture, and other factors):

+
+ERRATA.HTM      README.TXT      compat1x        dict            kernel
+ERRATA.TXT      RELNOTES.HTM    compat20        doc             manpages
+HARDWARE.HTM    RELNOTES.TXT    compat21        docbook.css     packages
+HARDWARE.TXT    base            compat22        filename.txt    ports
+INSTALL.HTM     boot            compat3x        floppies        proflibs
+INSTALL.TXT     catpages        compat4x        games           src
+README.HTM      cdrom.inf       crypto          info            tools
+
+ +

If you want to do a CDROM, FTP or NFS installation from + this distribution directory, all you need to do is make the + 1.44MB boot floppies from the floppies directory (see Section 1.3 for instructions on how to + do this), boot them and follow the instructions. The rest + of the data needed during the installation will be obtained + automatically based on your selections. If you've never + installed FreeBSD before, you also want to read the + entirety of this document (the installation instructions) + file.

+ +

If you're trying to do some other type of installation + or are merely curious about how a distribution is + organized, what follows is a more thorough description of + some of these items in more detail:

+ +
    +
  1. +

    The *.TXT and *.HTM files contain documentation + (for example, this document is contained in both INSTALL.TXT and INSTALL.HTM) and should be read + before starting an installation. The *.TXT files are plain text, while + the *.HTM files are HTML + files that can be read by almost any Web browser. Some + distributions may contain documentation in other + formats as well, such as PDF or PostScript.

    +
    2. + +
  2. +

    docbook.css is a Cascading + Style Sheet (CSS) file used by some Web browsers for + formatting the HTML documentation.

    +
    3. + +
  3. +

    The base, catpages, crypto, dict, doc, games, info, manpages, proflibs, and src directories contain the + primary distribution components of FreeBSD itself and + are split into smaller files for easy packing onto + floppies (should that be necessary).

    +
    4. + +
  4. +

    The compat1x, compat20, compat21, compat22, compat3x, and compat4x directories contain + distributions for compatibility with older releases and + are distributed as single gzip'd tar files - they can + be installed during release time or later by running + their install.sh scripts.

    +
    5. + +
  5. +

    The floppies/ subdirectory + contains the floppy installation images; further + information on using them can be found in Section 1.3.

    +
    6. + +
  6. +

    The packages and ports directories contain the + FreeBSD Packages and Ports Collections. Packages may be + installed from the packages directory by running the + command:

    +
    +#/stand/sysinstall configPackages
+
    + +

    Packages can also be installed by feeding individual + filenames in packages/ to the + + pkg_add(1) + command.

    + +

    The Ports Collection may be installed like any other + distribution and requires about 100MB unpacked. More + information on the ports collection may be obtained + from http://www.FreeBSD.org/ports/ or + locally from /usr/share/doc/handbook if you've + installed the doc + distribution.

    +
    7. + +
  7. +

    Last of all, the tools + directory contains various DOS tools for discovering + disk geometries, installing boot managers and the like. + It is purely optional and provided only for user + convenience.

    +
    8. +
+
+
+ +

A typical distribution directory (for example, the info distribution) looks like this + internally:

+
+CHECKSUM.MD5    info.ab         info.ad         info.inf        install.sh
+info.aa         info.ac         info.ae         info.mtree
+
+ +

The CHECKSUM.MD5 file contains + MD5 signatures for each file, should data corruption be + suspected, and is purely for reference. It is not used by + the actual installation and does not need to be copied with + the rest of the distribution files. The info.a* files are split, gzip'd tar + files, the contents of which can be viewed by doing:

+
+# cat info.a* | tar tvzf -
+
+ +

During installation, they are automatically concatenated + and extracted by the installation procedure.

+ +

The info.inf file is also + necessary since it is read by the installation program in + order to figure out how many pieces to look for when + fetching and concatenating the distribution. When putting + distributions onto floppies, the .inf file must occupy the first floppy of + each distribution set!

+ +

The info.mtree file is another + non-essential file which is provided for user reference. It + contains the MD5 signatures of the unpacked + distribution files and can be later used with the + mtree(8) program to + verify the installation permissions and checksums against + any possible modifications to the file. When used with the + base distribution, this can be an + excellent way of detecting trojan horse attacks on your + system.

+ +

Finally, the install.sh file + is for use by those who want to install the distribution + after installation time. To install the info distribution + from CDROM after a system was installed, for example, you'd + do:

+
+# cd /cdrom/info
+# sh install.sh
+
+
+ +
+
+ +

3 + Upgrading FreeBSD

+ +

These instructions describe a procedure for doing a + binary upgrade from an older version of FreeBSD.

+ +
+
+

Warning: While the FreeBSD upgrade procedure + does its best to safeguard against accidental loss of + data, it is still more than possible to wipe out your + entire disk with this installation! Please + do not accept the final confirmation request unless you + have adequately backed up any important data files.

+
+
+ +
+
+

Important: These notes assume that you are + using the version of + sysinstall(8) + supplied with the version of FreeBSD to which you + intend to upgrade. Using a mismatched version of + sysinstall(8) + is almost guaranteed to cause problems and has been + known to leave systems in an unusable state. The most + commonly made mistake in this regard is the use of an + old copy of + sysinstall(8) + from an existing installation to upgrade to a newer + version of FreeBSD. This is not recommended.

+
+
+ +
+
+

Warning: Binary upgrades to FreeBSD + 5.1-RELEASE from FreeBSD 4-STABLE are not supported at + this time. There are some files present in a FreeBSD + 4-STABLE whose presence can be disruptive, but are not + removed by a binary upgrade. One notable example is + that an old /usr/include/g++ + directory will cause C++ programs to compile + incorrectly (or not at all).

+ +

+ +

These upgrade instructions are provided for the use + of users upgrading from relatively recent FreeBSD + 5-CURRENT snapshots.

+
+
+ +
+
+ +

3.1 + Introduction

+ +

The upgrade procedure replaces distributions selected + by the user with those corresponding to the new FreeBSD + release. It preserves standard system configuration data, + as well as user data, installed packages and other + software.

+ +

Administrators contemplating an upgrade are encouraged + to study this section in its entirety before commencing + an upgrade. Failure to do so may result in a failed + upgrade or loss of data.

+ +
+
+ +

3.1.1 + Upgrade Overview

+ +

Upgrading of a distribution is performed by + extracting the new version of the component over the + top of the previous version. Files belonging to the old + distribution are not deleted.

+ +

System configuration is preserved by retaining and + restoring the previous version of the following + files:

+ +

Xaccel.ini, XF86Config, adduser.conf, aliases, aliases.db, amd.map, crontab, csh.cshrc, csh.login, csh.logout, cvsupfile, dhclient.conf, disktab, dm.conf, dumpdates, exports, fbtab, fstab, ftpusers, gettytab, gnats, group, hosts, hosts.allow, hosts.equiv, hosts.lpd, inetd.conf, localtime, login.access, login.conf, mail, mail.rc, make.conf, manpath.config, master.passwd, motd, namedb, networks, newsyslog.conf, nsmb.conf, nsswitch.conf, pam.conf, passwd, periodic, ppp, printcap, profile, pwd.db, rc.conf, rc.conf.local, rc.firewall, rc.local, remote, resolv.conf, rmt, sendmail.cf, sendmail.cw, services, shells, skeykeys, spwd.db, ssh, syslog.conf, ttys, uucp

+ +

The versions of these files which correspond to the + new version are moved to /etc/upgrade/. The system + administrator may peruse these new versions and merge + components as desired. Note that many of these files + are interdependent, and the best merge procedure is to + copy all site-specific data from the current files into + the new.

+ +

During the upgrade procedure, the administrator is + prompted for a location into which all files from /etc/ are saved. In the event + that local modifications have been made to other files, + they may be subsequently retrieved from this + location.

+
+
+ +
+
+ +

3.2 + Procedure

+ +

This section details the upgrade procedure. Particular + attention is given to items which substantially differ + from a normal installation.

+ +
+
+ +

3.2.1 + Backup

+ +

User data and system configuration should be backed + up before upgrading. While the upgrade procedure does + its best to prevent accidental mistakes, it is possible + to partially or completely destroy data and + configuration information.

+
+ +
+
+ +

3.2.2 + Mount Filesystems

+ +

The disklabel editor is entered with the nominated + disk's filesystem devices listed. Prior to commencing + the upgrade, the administrator should make a note of + the device names and corresponding mountpoints. These + mountpoints should be entered here. Do not + set the ``newfs flag'' for any filesystems, as this + will cause data loss.

+
+ +
+
+ +

3.2.3 + Select Distributions

+ +

When selecting distributions, there are no + constraints on which must be selected. As a general + rule, the base distribution + should be selected for an update, and the man distribution if manpages are + already installed. Other distributions may be selected + beyond those originally installed if the administrator + wishes to add additional functionality.

+
+ +
+
+ +

3.2.4 + After Installation

+ +

Once the installation procedure has completed, the + administrator is prompted to examine the new + configuration files. At this point, checks should be + made to ensure that the system configuration is valid. + In particular, the /etc/rc.conf and /etc/fstab files should be + checked.

+
+
+ +
+
+ +

3.3 + Upgrading from Source Code

+ +

Those interested in an upgrade method that allows more + flexibility and sophistication should take a look at The Cutting Edge in the FreeBSD + Handbook. This procedure involves rebuilding all of + FreeBSD from source code. It requires reliable network + connectivity, extra disk space, and time, but has + advantages for networks and other more complex + installations. This is roughly the same procedure as is + used for track the -STABLE or -CURRENT development + branches.

+ +

/usr/src/UPDATING contains + important information on updating a FreeBSD system from + source code. It lists various issues resulting from + changes in FreeBSD that may affect an upgrade.

+ +

+
+
+ +
+
+ +

4 + Troubleshooting

+ +
+

4.1 + Repairing an Existing FreeBSD Installation

+ +

FreeBSD features a ``Fixit'' option in the top menu of + the boot floppy. To use it, you will also need either a + fixit.flp image floppy, + generated in the same fashion as the boot floppy, or the + ``live filesystem'' CDROM; typically the second CDROM in + a multi-disc FreeBSD distribution.

+ +

To invoke fixit, simply boot the kern.flp floppy, choose the + ``Fixit'' item and insert the fixit floppy or CDROM when + asked. You will then be placed into a shell with a wide + variety of commands available (in the /stand and /mnt2/stand directories) for + checking, repairing and examining filesystems and their + contents. Some UNIX administration experience is + required to use the fixit option.

+
+ +
+
+ +

4.2 Common + Installation Problems for i386 Architecture + Users

+ +
+
+
4.2.1. My system hangs while + probing hardware during boot, or it behaves strangely + during install, or the floppy drive isn't + probed.
+ +
4.2.2. My legacy ISA device + used to be recognized in previous versions of + FreeBSD, but now it's not. What happened?
+ +
4.2.3. I go to boot from the + hard disk for the first time after installing + FreeBSD, the kernel loads and probes my hardware, but + stops with messages like:
+ +
4.2.4. I go to boot from the + hard disk for the first time after installing + FreeBSD, but the Boot Manager prompt just prints F? at the boot menu each time + but the boot won't go any further.
+ +
4.2.5. The mcd(4) driver + keeps thinking that it has found a device and this + stops my Intel EtherExpress card from + working.
+ +
4.2.6. The system finds my + ed(4) network + card, but I keep getting device timeout + errors.
+ +
4.2.7. I booted the install + floppy on my IBM ThinkPad (tm) laptop, and the + keyboard is all messed up.
+ +
4.2.8. My system can not find + my Intel EtherExpress 16 card.
+ +
4.2.9. When installing on an + EISA HP Netserver, my on-board AIC-7xxx SCSI + controller isn't detected.
+ +
4.2.10. I have a Panasonic + AL-N1 or Rios Chandler Pentium machine and I find + that the system hangs before ever getting into the + installation now.
+ +
4.2.11. I have this CMD640 + IDE controller that is said to be broken.
+ +
4.2.12. On a Compaq Aero + notebook, I get the message ``No floppy devices + found! Please check ...'' when trying to install from + floppy.
+ +
4.2.13. When installing on a + Dell Poweredge XE, Dell proprietary RAID controller + DSA (Dell SCSI Array) isn't recognized.
+ +
4.2.14. I have an IBM + EtherJet PCI card, it is detected by the fxp(4) driver + correctly, but the lights on the card don't come on + and it doesn't connect to the network.
+ +
4.2.15. When I configure the + network during installation on an IBM Netfinity 3500, + the system freezes.
+ +
4.2.16. When I install onto a + drive managed by a Mylex PCI RAID controller, the + system fails to boot (eg. with a read error message).
+
+ +
+
+

4.2.1. + My system hangs while probing hardware during boot, + or it behaves strangely during install, or the + floppy drive isn't probed.

+
+ +
+

FreeBSD 5.0 and above makes extensive use + of the system ACPI service on the i386 platform to + aid in system configuration if it's detected during + boot. Unfortunately, some bugs still exist in both + the ACPI driver and within system motherboards and + BIOS. The use of ACPI can be disabled by setting + the ``hint.acpi.0.disabled'' hint in the third + stage boot loader:

+
+set hint.acpi.0.disabled="1"
+
+ +

This is reset each time the system is booted, so + it is necessary to add hint.acpi.0.disabled="1" to + the file /boot/loader.conf. More + information about the boot loader can be found in + the FreeBSD Handbook.

+
+
+ +
+
+

4.2.2. + My legacy ISA device used to be recognized in + previous versions of FreeBSD, but now it's not. + What happened?

+
+ +
+

Some device drivers, like matcd, were + removed over time due to lack of maintainership or + other reasons. Others still exist but are disabled + because of their intrusive hardware probe routines. + The following ISA device drivers fall into this + category and can re-enabled from the third stage + boot loader: aha, ahv, aic, bt, ed, cs, sn, ie, fe, + le, and lnc. To do this, stop the loader during + it's 10 second countdown and enter the following at + the prompt:

+
+unset hint.foo.0.disabled
+
+ +

where foo is + the name of the driver to re-enable. This can be + set permanently by editing the file /boot/device.hints and + removing the appropriate ``disabled'' entry.

+
+
+ +
+
+

4.2.3. + I go to boot from the hard disk for the first time + after installing FreeBSD, the kernel loads and + probes my hardware, but stops with messages + like:

+
+changing root device to ad1s1a panic: cannot mount root
+
+ +

What is wrong? What can I do?

+ +

What is this bios_drive:interface(unit,partition)kernel_name + thing that is displayed with the boot help?

+
+ +
+

There is a longstanding problem in the + case where the boot disk is not the first disk in + the system. The BIOS uses a different numbering + scheme to FreeBSD, and working out which numbers + correspond to which is difficult to get right.

+ +

In the case where the boot disk is not the first + disk in the system, FreeBSD can need some help + finding it. There are two common situations here, + and in both of these cases, you need to tell + FreeBSD where the root filesystem is. You do this + by specifying the BIOS disk number, the disk type + and the FreeBSD disk number for that type.

+ +

The first situation is where you have two IDE + disks, each configured as the master on their + respective IDE busses, and wish to boot FreeBSD + from the second disk. The BIOS sees these as disk 0 + and disk 1, while FreeBSD sees them as ad0 and ad2.

+ +

FreeBSD is on BIOS disk 1, of type ad and the FreeBSD disk number + is 2, so you would say:

+
+1:ad(2,a)kernel
+
+ +

Note that if you have a slave on the primary + bus, the above is not necessary (and is effectively + wrong).

+ +

The second situation involves booting from a + SCSI disk when you have one or more IDE disks in + the system. In this case, the FreeBSD disk number + is lower than the BIOS disk number. If you have two + IDE disks as well as the SCSI disk, the SCSI disk + is BIOS disk 2, type da + and FreeBSD disk number 0, so you would say:

+
+2:da(0,a)kernel
+
+ +

To tell FreeBSD that you want to boot from BIOS + disk 2, which is the first SCSI disk in the system. + If you only had one IDE disk, you would use '1:' + instead.

+ +

Once you have determined the correct values to + use, you can put the command exactly as you would + have typed it in the /boot.config file using a + standard text editor. Unless instructed otherwise, + FreeBSD will use the contents of this file as the + default response to the boot: prompt.

+
+
+ +
+
+

4.2.4. + I go to boot from the hard disk for the first time + after installing FreeBSD, but the Boot Manager + prompt just prints F? at + the boot menu each time but the boot won't go any + further.

+
+ +
+

The hard disk geometry was set + incorrectly in the Partition editor when you + installed FreeBSD. Go back into the partition + editor and specify the actual geometry of your hard + disk. You must reinstall FreeBSD again from the + beginning with the correct geometry.

+ +

If you are failing entirely in figuring out the + correct geometry for your machine, here's a tip: + Install a small DOS partition at the beginning of + the disk and install FreeBSD after that. The + install program will see the DOS partition and try + to infer the correct geometry from it, which + usually works.

+ +

The following tip is no longer recommended, but + is left here for reference:

+ + +
+

If you are setting up a truly dedicated + FreeBSD server or workstation where you don't + care for (future) compatibility with DOS, Linux + or another operating system, you've also got the + option to use the entire disk (`A' in the + partition editor), selecting the non-standard + option where FreeBSD occupies the entire disk + from the very first to the very last sector. This + will leave all geometry considerations aside, but + is somewhat limiting unless you're never going to + run anything other than FreeBSD on a disk.

+
+
+
+ +
+
+

4.2.5. + The mcd(4) driver + keeps thinking that it has found a device and this + stops my Intel EtherExpress card from working.

+
+ +
+

Use the UserConfig utility (see HARDWARE.TXT) and disable the + probing of the mcd0 and + mcd1 devices. Generally + speaking, you should only leave the devices that + you will be using enabled in your kernel.

+
+
+ +
+
+

4.2.6. + The system finds my ed(4) network + card, but I keep getting device timeout errors.

+
+ +
+

Your card is probably on a different IRQ + from what is specified in the kernel configuration. + The ed driver does not use the `soft' configuration + by default (values entered using EZSETUP in DOS), + but it will use the software configuration if you + specify ? in the IRQ field + of your kernel config file.

+ +

Either move the jumper on the card to a hard + configuration setting (altering the kernel settings + if necessary), or specify the IRQ as -1 in UserConfig or ? in your kernel config file. + This will tell the kernel to use the soft + configuration.

+ +

Another possibility is that your card is at IRQ + 9, which is shared by IRQ 2 and frequently a cause + of problems (especially when you have a VGA card + using IRQ 2!). You should not use IRQ 2 or 9 if at + all possible.

+
+
+ +
+
+

4.2.7. + I booted the install floppy on my IBM ThinkPad (tm) + laptop, and the keyboard is all messed up.

+
+ +
+

Older IBM laptops use a non-standard + keyboard controller, so you must tell the keyboard + driver (atkbd0) to go into a special mode which + works on the ThinkPads. Change the atkbd0 'Flags' + to 0x4 in UserConfig and it should work fine. (Look + in the Input Menu for 'Keyboard'.)

+
+
+ +
+
+

4.2.8. + My system can not find my Intel EtherExpress 16 + card.

+
+ +
+

You must set your Intel EtherExpress 16 + card to be memory mapped at address 0xD0000, and + set the amount of mapped memory to 32K using the + Intel supplied softset.exe program.

+
+
+ +
+
+

4.2.9. + When installing on an EISA HP Netserver, my + on-board AIC-7xxx SCSI controller isn't + detected.

+
+ +
+

This is a known problem, and will + hopefully be fixed in the future. In order to get + your system installed at all, boot with the -c option into UserConfig, but + don't use the pretty + visual mode but the plain old CLI mode. Type:

+
+eisa 12
+quit
+
+ +

at the prompt. (Instead of `quit', you might + also type `visual', and continue the rest of the + configuration session in visual mode.) While it's + recommended to compile a custom kernel, dset now + also understands to save this value.

+ +

Refer to the FAQ topic 3.16 for an explanation + of the problem, and for how to continue. Remember + that you can find the FAQ on your local system in + /usr/share/doc/FAQ, provided you have installed the + `doc' distribution.

+
+
+ +
+
+

4.2.10. I have a + Panasonic AL-N1 or Rios Chandler Pentium machine + and I find that the system hangs before ever + getting into the installation now.

+
+ +
+

Your machine doesn't like the new i586_copyout and i586_copyin code for some + reason. To disable this, boot the installation boot + floppy and when it comes to the very first menu + (the choice to drop into kernel UserConfig mode or + not) choose the command-line interface (``expert + mode'') version and type the following at it:

+
+flags npx0 1
+
+ +

Then proceed normally to boot. This will be + saved into your kernel, so you only need to do it + once.

+
+
+ +
+
+

4.2.11. I have this + CMD640 IDE controller that is said to be + broken.

+
+ +
+

FreeBSD does not support this + controller.

+
+
+ +
+
+

4.2.12. On a Compaq Aero + notebook, I get the message ``No floppy devices + found! Please check ...'' when trying to install + from floppy.

+
+ +
+

With Compaq being always a little + different from other systems, they do not announce + their floppy drive in the CMOS RAM of an Aero + notebook. Therefore, the floppy disk driver assumes + there is no drive configured. Go to the UserConfig + screen, and set the Flags value of the fdc0 device + to 0x1. This pretends the existence of the first + floppy drive (as a 1.44 MB drive) to the driver + without asking the CMOS at all.

+
+
+ +
+
+

4.2.13. When installing + on a Dell Poweredge XE, Dell proprietary RAID + controller DSA (Dell SCSI Array) isn't + recognized.

+
+ +
+

Configure the DSA to use AHA-1540 + emulation using EISA configuration utility. After + that FreeBSD detects the DSA as an Adaptec AHA-1540 + SCSI controller, with irq 11 and port 340. Under + emulation mode system will use DSA RAID disks, but + you cannot use DSA-specific features such as + watching RAID health.

+
+
+ +
+
+

4.2.14. I have an IBM + EtherJet PCI card, it is detected by the fxp(4) driver + correctly, but the lights on the card don't come on + and it doesn't connect to the network.

+
+ +
+

We don't understand why this happens. + Neither do IBM (we asked them). The card is a + standard Intel EtherExpress Pro/100 with an IBM + label on it, and these cards normally work just + fine. You may see these symptoms only in some IBM + Netfinity servers. The only solution is to install + a different Ethernet adapter.

+
+
+ +
+
+

4.2.15. When I configure + the network during installation on an IBM Netfinity + 3500, the system freezes.

+
+ +
+

There is a problem with the onboard + Ethernet in the Netfinity 3500 which we have not + been able to identify at this time. It may be + related to the SMP features of the system being + misconfigured. You will have to install another + Ethernet adapter and avoid attempting to configure + the onboard adapter at any time.

+
+
+ +
+
+

4.2.16. When I install + onto a drive managed by a Mylex PCI RAID + controller, the system fails to boot (eg. with a + read error message).

+
+ +
+

There is a bug in the Mylex driver which + results in it ignoring the ``8GB'' geometry mode + setting in the BIOS. Use the 2GB mode instead.

+
+
+
+
+
+
+
+ +

This file, and other release-related + documents, can be downloaded from ftp://ftp.FreeBSD.org/.

+ +

For questions about FreeBSD, read the + documentation + before contacting <questions@FreeBSD.org>.

+ +

All users of FreeBSD 5-CURRENT + should subscribe to the <current@FreeBSD.org> + mailing list.

+ +

For questions about this documentation, + e-mail <doc@FreeBSD.org>.

+
+
+ + + diff --git a/en/releases/5.1R/installation-ia64.html b/en/releases/5.1R/installation-ia64.html new file mode 100644 index 0000000000..0d2db03136 --- /dev/null +++ b/en/releases/5.1R/installation-ia64.html @@ -0,0 +1,1188 @@ + + + + + FreeBSD/ia64 5.1-RELEASE Installation + Instructions + + + + + +
+
+

FreeBSD/ia64 + 5.1-RELEASE Installation Instructions

+ +

The FreeBSD Project

+ +

Copyright © 2000, 2001, 2002, + 2003 by The FreeBSD Documentation Project

+
+
+ +
+
+ + +

This article gives some brief instructions on + installing FreeBSD/ia64 5.1-RELEASE, with particular + emphasis given to obtaining a FreeBSD distribution. Some + notes on troubleshooting and frequently-asked questions + are also given.

+
+
+ +
+
+ +

1 + Installing FreeBSD

+ +

This section documents the process of installing a new + distribution of FreeBSD. These instructions pay particular + emphasis to the process of obtaining the FreeBSD + 5.1-RELEASE distribution and to beginning the installation + procedure. The ``Installing FreeBSD'' chapter of the FreeBSD Handbook provides more in-depth + information about the installation program itself, + including a guided walkthrough with screenshots.

+ +

If you are upgrading from a previous release of FreeBSD, + please see Section 3 for + instructions on upgrading.

+ +
+
+ +

1.1 Getting Started

+ +

Probably the most important pre-installation step that + can be taken is that of reading the various instruction + documents provided with FreeBSD. A roadmap of documents + pertaining to this release of FreeBSD can be found in README.TXT, which can usually be + found in the same location as this file; most of these + documents, such as the release notes and the hardware + compatibility list, are also accessible in the + Documentation menu of the installer.

+ +

Note that on-line versions of the FreeBSD FAQ and Handbook are also available from the + FreeBSD + Project Web site, if you have an Internet + connection.

+ +

This collection of documents may seem daunting, but + the time spent reading them will likely be saved many + times over. Being familiar with what resources are + available can also be helpful in the event of problems + during installation.

+ +

The best laid plans sometimes go awry, so if you run + into trouble take a look at Section + 4, which contains valuable troubleshooting + information. You should also read an updated copy of ERRATA.TXT before installing, since + this will alert you to any problems which have reported + in the interim for your particular release.

+ +
+
+

Important: While FreeBSD does its best to + safeguard against accidental loss of data, it's still + more than possible to wipe out your entire disk + with this installation if you make a mistake. Please + do not proceed to the final FreeBSD installation menu + unless you've adequately backed up any important data + first.

+
+
+
+ +
+
+ +

1.2 Hardware + Requirements

+ +

If you are not familiar with configuring hardware for + FreeBSD, you should be sure to read the HARDWARE.TXT file; it contains + important information on what hardware is supported by + FreeBSD.

+
+ +
+
+ +

1.3 + Floppy Disk Image Instructions

+
+ +
+
+ +

1.4 Installing FreeBSD from + CDROM or the Internet

+
+ +
+
+ +

1.5 Detail + on various installation types

+ +

Once you've gotten yourself to the initial + installation screen somehow, you should be able to follow + the various menu prompts and go from there. If you've + never used the FreeBSD installation before, you are also + encouraged to read some of the documentation in the + Documentation submenu as well as the general ``Usage'' + instructions on the first menu.

+ +
+
+

Note: If you get stuck at a screen, press + the F1 key for online + documentation relevant to that specific section.

+
+
+ +

If you've never installed FreeBSD before, or even if + you have, the ``Standard'' installation mode is the most + recommended since it makes sure that you'll visit all the + various important checklist items along the way. If + you're much more comfortable with the FreeBSD + installation process and know exactly what you want to do, + use the ``Express'' or ``Custom'' installation options. + If you're upgrading an existing system, use the + ``Upgrade'' option.

+ +

The FreeBSD installer supports the direct use of + floppy, DOS, tape, CDROM, FTP, NFS and UFS partitions as + installation media; further tips on installing from each + type of media are listed below.

+ +
+
+ +

1.5.1 + Installing from a Network CDROM

+ +

If you simply wish to install from a local CDROM + drive then see Section + 1.4. If you don't have a CDROM drive on your system + and wish to use a FreeBSD distribution CD in the CDROM + drive of another system to which you have network + connectivity, there are also several ways of going + about it:

+ +
    +
  • +

    If you would be able to FTP install FreeBSD + directly from the CDROM drive in some FreeBSD + machine, it's quite easy: You simply add the + following line to the password file (using the + vipw(8) + command):

    +
    +ftp:*:99:99::0:0:FTP:/cdrom:/sbin/nologin
+
    + +

    On the machine on which you are running the + install, go to the Options menu and set Release + Name to any. You may then + choose a Media type of FTP + and type in ftp://machine after + picking ``URL'' in the ftp sites menu.

    + +
    +
    +

    Warning: This may allow anyone on the + local network (or Internet) to make ``anonymous + FTP'' connections to this machine, which may + not be desirable.

    +
    +
    +
    • + +
  • +

    If you would rather use NFS to export the CDROM + directly to the machine(s) you'll be installing + from, you need to first add an entry to the /etc/exports file (on the + machine with the CDROM drive). The example below + allows the machine ziggy.foo.com to mount the + CDROM directly via NFS during installation:

    +
    +/cdrom          -ro             ziggy.foo.com
+
    + +

    The machine with the CDROM must also be + configured as an NFS server, of course, and if + you're not sure how to do that then an NFS + installation is probably not the best choice for + you unless you're willing to read up on + rc.conf(5) + and configure things appropriately. Assuming that + this part goes smoothly, you should be able to + enter: cdrom-host:/cdrom + as the path for an NFS installation when the target + machine is installed, e.g. wiggy:/cdrom.

    +
    • +
+
+ +
+
+ +

1.5.2 + Installing from Floppies

+ +

If you must install from floppy disks, either due to + unsupported hardware or just because you enjoy doing + things the hard way, you must first prepare some + floppies for the install.

+ +

First, make your boot floppies as described in Section 1.3.

+ +

Second, peruse Section 2 and + pay special attention to the ``Distribution Format'' + section since it describes which files you're going to + need to put onto floppy and which you can safely + skip.

+ +

Next you will need, at minimum, as many 1.44MB + floppies as it takes to hold all files in the bin (binary distribution) + directory. If you're preparing these floppies under + DOS, then these floppies must be formatted using the + MS-DOS FORMAT command. If + you're using Windows, use the Windows File Manager + format command.

+ +
+
+

Important: Frequently, floppy disks come + ``factory preformatted''. While convenient, many + problems reported by users in the past have + resulted from the use of improperly formatted + media. Re-format them yourself, just to make + sure.

+
+
+ +

If you're creating the floppies from another FreeBSD + machine, a format is still not a bad idea though you + don't need to put a DOS filesystem on each floppy. You + can use the + disklabel(8) + and + newfs(8) + commands to put a UFS filesystem on a floppy, as the + following sequence of commands illustrates:

+
+# fdformat -f 1440 fd0.1440
+# disklabel -w -r fd0.1440 floppy3
+# newfs -t 2 -u 18 -l 1 -i 65536 /dev/fd0
+
+ +

After you've formatted the floppies for DOS or UFS, + you'll need to copy the files onto them. The + distribution files are split into chunks conveniently + sized so that 5 of them will fit on a conventional + 1.44MB floppy. Go through all your floppies, packing as + many files as will fit on each one, until you've got + all the distributions you want packed up in this + fashion. Each distribution should go into its own + subdirectory on the floppy, e.g.: a:\bin\bin.inf, a:\bin\bin.aa, a:\bin\bin.ab, ...

+ +
+
+

Important: The bin.inf file also needs to go + on the first floppy of the bin set since it is read by + the installation program in order to figure out how + many additional pieces to look for when fetching + and concatenating the distribution. When putting + distributions onto floppies, the distname.inf file must occupy the first + floppy of each distribution set. This is also + covered in README.TXT.

+
+
+ +

Once you come to the Media screen of the install, + select ``Floppy'' and you'll be prompted for the + rest.

+
+ +
+
+ +

1.5.4 + Installing from QIC/SCSI Tape

+ +

When installing from tape, the installation program + expects the files to be simply tar'ed onto it, so after + fetching all of the files for the distributions you're + interested in, simply use + tar(1) to get + them onto the tape with a command something like + this:

+
+# cd /where/you/have/your/dists
+# tar cvf /dev/rsa0 dist1 .. dist2
+
+ +

When you go to do the installation, you should also + make sure that you leave enough room in some temporary + directory (which you'll be allowed to choose) to + accommodate the full contents of the tape + you've created. Due to the non-random access nature of + tapes, this method of installation requires quite a bit + of temporary storage. You should expect to require as + much temporary storage as you have stuff written on + tape.

+ +
+
+

Note: When going to do the installation, + the tape must be in the drive before booting from the + boot floppies. The installation ``probe'' may + otherwise fail to find it.

+
+
+ +

Now create a boot floppy as described in Section 1.3 and proceed with the + installation.

+
+ +
+
+ +

1.5.5 + Installing over a Network using FTP or NFS

+ +

After making the boot floppies as described in the + first section, you can load the rest of the + installation over a network using one of 3 types of + connections: serial port, parallel port, or + Ethernet.

+ +
+
+ +

1.5.5.1 Serial Port

+ +

SLIP support is rather primitive, and is limited + primarily to hard-wired links, such as a serial cable + running between two computers. The link must be + hard-wired because the SLIP installation doesn't + currently offer a dialing capability. If you need to + dial out with a modem or otherwise dialog with the + link before connecting to it, then I recommend that + the PPP utility be used instead.

+ +

If you're using PPP, make sure that you have your + Internet Service Provider's IP address and DNS + information handy as you'll need to know it fairly + early in the installation process. You may also need + to know your own IP address, though PPP supports + dynamic address negotiation and may be able to pick + up this information directly from your ISP if they + support it.

+ +

You will also need to know how to use the various + ``AT commands'' for dialing out with your particular + brand of modem as the PPP dialer provides only a very + simple terminal emulator.

+
+ +
+
+ +

1.5.5.2 Parallel Port

+ +

If a hard-wired connection to another FreeBSD or + Linux machine is available, you might also consider + installing over a ``laplink'' style parallel port + cable. The data rate over the parallel port is much + higher than what is typically possible over a serial + line (up to 50k/sec), thus resulting in a quicker + installation. It's not typically necessary to use + ``real'' IP addresses when using a point-to-point + parallel cable in this way and you can generally just + use RFC 1918 style addresses for the ends of the link + (e.g. 10.0.0.1, 10.0.0.2, etc).

+ +
+
+

Important: If you use a Linux machine + rather than a FreeBSD machine as your PLIP peer, + you will also have to specify link0 in the TCP/IP setup + screen's ``extra options for ifconfig'' field in + order to be compatible with Linux's slightly + different PLIP protocol.

+
+
+
+ +
+
+ +

1.5.5.3 Ethernet

+ +

FreeBSD supports many common Ethernet cards; a + table of supported cards is provided as part of the + FreeBSD Hardware Notes (see HARDWARE.TXT in the + Documentation menu on the boot floppy or the top + level directory of the CDROM). If you are using one + of the supported PCMCIA Ethernet cards, also be sure + that it's plugged in before the laptop is + powered on. FreeBSD does not, unfortunately, + currently support ``hot insertion'' of PCMCIA cards + during installation.

+ +

You will also need to know your IP address on the + network, the netmask value + for your subnet and the name of your machine. Your + system administrator can tell you which values are + appropriate to your particular network setup. If you + will be referring to other hosts by name rather than + IP address, you'll also need a name server and + possibly the address of a gateway (if you're using + PPP, it's your provider's IP address) to use in + talking to it. If you want to install by FTP via an + HTTP proxy (see below), you will also need the + proxy's address.

+ +

If you do not know the answers to these questions + then you should really probably talk to your system + administrator first before trying this + type of installation. Using a randomly chosen IP + address or netmask on a live network is almost + guaranteed not to work, and will probably result in a + lecture from said system administrator.

+ +

Once you have a network connection of some sort + working, the installation can continue over NFS or + FTP.

+
+ +
+
+ +

1.5.5.4 NFS installation tips

+ +

NFS installation is fairly straight-forward: + Simply copy the FreeBSD distribution files you want + onto a server somewhere and then point the NFS media + selection at it.

+ +

If this server supports only ``privileged port'' + access (this is generally the default for Sun and + Linux workstations), you will need to set this option + in the Options menu before installation can + proceed.

+ +

If you have a poor quality Ethernet card which + suffers from very slow transfer rates, you may also + wish to toggle the appropriate Options flag.

+ +

In order for NFS installation to work, the server + must also support ``subdir mounts'', e.g. if your + FreeBSD distribution directory lives on wiggy:/usr/archive/stuff/FreeBSD, + then wiggy will have to allow + the direct mounting of /usr/archive/stuff/FreeBSD, not + just /usr or /usr/archive/stuff.

+ +

In FreeBSD's /etc/exports file this is + controlled by the -alldirs + option. Other NFS servers may have different + conventions. If you are getting Permission Denied messages from + the server then it's likely that you don't have this + properly enabled.

+
+ +
+
+ +

1.5.5.5 FTP Installation tips

+ +

FTP installation may be done from any mirror site + containing a reasonably up-to-date version of + FreeBSD. A full menu of reasonable choices for almost + any location in the world is provided in the FTP site + menu during installation.

+ +

If you are installing from some other FTP site not + listed in this menu, or you are having troubles + getting your name server configured properly, you can + also specify your own URL by selecting the ``URL'' + choice in that menu. A URL can contain a hostname or + an IP address, so something like the following would + work in the absence of a name server:

+
+ftp://216.66.64.162/pub/FreeBSD/releases/ia64/4.2-RELEASE
+
+ +

There are three FTP installation modes you can + use:

+ +
    +
  • +

    FTP: This method uses the standard ``Active'' + mode for transfers, in which the server initiates + a connection to the client. This will not work + through most firewalls but will often work best + with older FTP servers that do not support + passive mode. If your connection hangs with + passive mode, try this one.

    +
    • + +
  • +

    FTP Passive: This sets the FTP "Passive" mode + which prevents the server from opening + connections to the client. This option is best + for users to pass through firewalls that do not + allow incoming connections on random port + addresses.

    +
    • + +
  • +

    FTP via an HTTP proxy: This option instructs + FreeBSD to use HTTP to connect to a proxy for all + FTP operations. The proxy will translate the + requests and send them to the FTP server. This + allows the user to pass through firewalls that do + not allow FTP at all, but offer an HTTP proxy. + You must specify the hostname of the proxy in + addition to the FTP server.

    + +

    In the rare case that you have an FTP proxy + that does not go through HTTP, you can specify + the URL as something like:

    +
    +ftp://foo.bar.com:port/pub/FreeBSD
+
    + +

    In the URL above, port is the port + number of the proxy FTP server.

    +
    • +
+
+
+
+
+
+ +
+
+ +

1.6 + Question and Answer Section for IA-64 Architecture + Users

+
+
+ +
+
+ +

2 + Distribution Format

+ +

A typical FreeBSD distribution directory looks something + like this (exact details may vary depending on version, + architecture, and other factors):

+
+ERRATA.HTM      README.TXT      compat1x        dict            kernel
+ERRATA.TXT      RELNOTES.HTM    compat20        doc             manpages
+HARDWARE.HTM    RELNOTES.TXT    compat21        docbook.css     packages
+HARDWARE.TXT    base            compat22        filename.txt    ports
+INSTALL.HTM     boot            compat3x        floppies        proflibs
+INSTALL.TXT     catpages        compat4x        games           src
+README.HTM      cdrom.inf       crypto          info            tools
+
+ +

If you want to do a CDROM, FTP or NFS installation from + this distribution directory, all you need to do is make the + 1.44MB boot floppies from the floppies directory (see Section 1.3 for instructions on how to + do this), boot them and follow the instructions. The rest + of the data needed during the installation will be obtained + automatically based on your selections. If you've never + installed FreeBSD before, you also want to read the + entirety of this document (the installation instructions) + file.

+ +

If you're trying to do some other type of installation + or are merely curious about how a distribution is + organized, what follows is a more thorough description of + some of these items in more detail:

+ +
    +
  1. +

    The *.TXT and *.HTM files contain documentation + (for example, this document is contained in both INSTALL.TXT and INSTALL.HTM) and should be read + before starting an installation. The *.TXT files are plain text, while + the *.HTM files are HTML + files that can be read by almost any Web browser. Some + distributions may contain documentation in other + formats as well, such as PDF or PostScript.

    +
    2. + +
  2. +

    docbook.css is a Cascading + Style Sheet (CSS) file used by some Web browsers for + formatting the HTML documentation.

    +
    3. + +
  3. +

    The base, catpages, crypto, dict, doc, games, info, manpages, proflibs, and src directories contain the + primary distribution components of FreeBSD itself and + are split into smaller files for easy packing onto + floppies (should that be necessary).

    +
    4. + +
  4. +

    The compat1x, compat20, compat21, compat22, compat3x, and compat4x directories contain + distributions for compatibility with older releases and + are distributed as single gzip'd tar files - they can + be installed during release time or later by running + their install.sh scripts.

    +
    5. + +
  5. +

    The floppies/ subdirectory + contains the floppy installation images; further + information on using them can be found in Section 1.3.

    +
    6. + +
  6. +

    The packages and ports directories contain the + FreeBSD Packages and Ports Collections. Packages may be + installed from the packages directory by running the + command:

    +
    +#/stand/sysinstall configPackages
+
    + +

    Packages can also be installed by feeding individual + filenames in packages/ to the + + pkg_add(1) + command.

    + +

    The Ports Collection may be installed like any other + distribution and requires about 100MB unpacked. More + information on the ports collection may be obtained + from http://www.FreeBSD.org/ports/ or + locally from /usr/share/doc/handbook if you've + installed the doc + distribution.

    +
    7. + +
  7. +

    Last of all, the tools + directory contains various DOS tools for discovering + disk geometries, installing boot managers and the like. + It is purely optional and provided only for user + convenience.

    +
    8. +
+
+
+ +

A typical distribution directory (for example, the info distribution) looks like this + internally:

+
+CHECKSUM.MD5    info.ab         info.ad         info.inf        install.sh
+info.aa         info.ac         info.ae         info.mtree
+
+ +

The CHECKSUM.MD5 file contains + MD5 signatures for each file, should data corruption be + suspected, and is purely for reference. It is not used by + the actual installation and does not need to be copied with + the rest of the distribution files. The info.a* files are split, gzip'd tar + files, the contents of which can be viewed by doing:

+
+# cat info.a* | tar tvzf -
+
+ +

During installation, they are automatically concatenated + and extracted by the installation procedure.

+ +

The info.inf file is also + necessary since it is read by the installation program in + order to figure out how many pieces to look for when + fetching and concatenating the distribution. When putting + distributions onto floppies, the .inf file must occupy the first floppy of + each distribution set!

+ +

The info.mtree file is another + non-essential file which is provided for user reference. It + contains the MD5 signatures of the unpacked + distribution files and can be later used with the + mtree(8) program to + verify the installation permissions and checksums against + any possible modifications to the file. When used with the + base distribution, this can be an + excellent way of detecting trojan horse attacks on your + system.

+ +

Finally, the install.sh file + is for use by those who want to install the distribution + after installation time. To install the info distribution + from CDROM after a system was installed, for example, you'd + do:

+
+# cd /cdrom/info
+# sh install.sh
+
+
+ +
+
+ +

3 + Upgrading FreeBSD

+ +

These instructions describe a procedure for doing a + binary upgrade from an older version of FreeBSD.

+ +
+
+

Warning: While the FreeBSD upgrade procedure + does its best to safeguard against accidental loss of + data, it is still more than possible to wipe out your + entire disk with this installation! Please + do not accept the final confirmation request unless you + have adequately backed up any important data files.

+
+
+ +
+
+

Important: These notes assume that you are + using the version of + sysinstall(8) + supplied with the version of FreeBSD to which you + intend to upgrade. Using a mismatched version of + sysinstall(8) + is almost guaranteed to cause problems and has been + known to leave systems in an unusable state. The most + commonly made mistake in this regard is the use of an + old copy of + sysinstall(8) + from an existing installation to upgrade to a newer + version of FreeBSD. This is not recommended.

+
+
+ +
+
+

Warning: Binary upgrades to FreeBSD + 5.1-RELEASE from FreeBSD 4-STABLE are not supported at + this time. There are some files present in a FreeBSD + 4-STABLE whose presence can be disruptive, but are not + removed by a binary upgrade. One notable example is + that an old /usr/include/g++ + directory will cause C++ programs to compile + incorrectly (or not at all).

+ +

+ +

These upgrade instructions are provided for the use + of users upgrading from relatively recent FreeBSD + 5-CURRENT snapshots.

+
+
+ +
+
+ +

3.1 + Introduction

+ +

The upgrade procedure replaces distributions selected + by the user with those corresponding to the new FreeBSD + release. It preserves standard system configuration data, + as well as user data, installed packages and other + software.

+ +

Administrators contemplating an upgrade are encouraged + to study this section in its entirety before commencing + an upgrade. Failure to do so may result in a failed + upgrade or loss of data.

+ +
+
+ +

3.1.1 + Upgrade Overview

+ +

Upgrading of a distribution is performed by + extracting the new version of the component over the + top of the previous version. Files belonging to the old + distribution are not deleted.

+ +

System configuration is preserved by retaining and + restoring the previous version of the following + files:

+ +

Xaccel.ini, XF86Config, adduser.conf, aliases, aliases.db, amd.map, crontab, csh.cshrc, csh.login, csh.logout, cvsupfile, dhclient.conf, disktab, dm.conf, dumpdates, exports, fbtab, fstab, ftpusers, gettytab, gnats, group, hosts, hosts.allow, hosts.equiv, hosts.lpd, inetd.conf, localtime, login.access, login.conf, mail, mail.rc, make.conf, manpath.config, master.passwd, motd, namedb, networks, newsyslog.conf, nsmb.conf, nsswitch.conf, pam.conf, passwd, periodic, ppp, printcap, profile, pwd.db, rc.conf, rc.conf.local, rc.firewall, rc.local, remote, resolv.conf, rmt, sendmail.cf, sendmail.cw, services, shells, skeykeys, spwd.db, ssh, syslog.conf, ttys, uucp

+ +

The versions of these files which correspond to the + new version are moved to /etc/upgrade/. The system + administrator may peruse these new versions and merge + components as desired. Note that many of these files + are interdependent, and the best merge procedure is to + copy all site-specific data from the current files into + the new.

+ +

During the upgrade procedure, the administrator is + prompted for a location into which all files from /etc/ are saved. In the event + that local modifications have been made to other files, + they may be subsequently retrieved from this + location.

+
+
+ +
+
+ +

3.2 + Procedure

+ +

This section details the upgrade procedure. Particular + attention is given to items which substantially differ + from a normal installation.

+ +
+
+ +

3.2.1 + Backup

+ +

User data and system configuration should be backed + up before upgrading. While the upgrade procedure does + its best to prevent accidental mistakes, it is possible + to partially or completely destroy data and + configuration information.

+
+ +
+
+ +

3.2.2 + Mount Filesystems

+ +

The disklabel editor is entered with the nominated + disk's filesystem devices listed. Prior to commencing + the upgrade, the administrator should make a note of + the device names and corresponding mountpoints. These + mountpoints should be entered here. Do not + set the ``newfs flag'' for any filesystems, as this + will cause data loss.

+
+ +
+
+ +

3.2.3 + Select Distributions

+ +

When selecting distributions, there are no + constraints on which must be selected. As a general + rule, the base distribution + should be selected for an update, and the man distribution if manpages are + already installed. Other distributions may be selected + beyond those originally installed if the administrator + wishes to add additional functionality.

+
+ +
+
+ +

3.2.4 + After Installation

+ +

Once the installation procedure has completed, the + administrator is prompted to examine the new + configuration files. At this point, checks should be + made to ensure that the system configuration is valid. + In particular, the /etc/rc.conf and /etc/fstab files should be + checked.

+
+
+ +
+
+ +

3.3 + Upgrading from Source Code

+ +

Those interested in an upgrade method that allows more + flexibility and sophistication should take a look at The Cutting Edge in the FreeBSD + Handbook. This procedure involves rebuilding all of + FreeBSD from source code. It requires reliable network + connectivity, extra disk space, and time, but has + advantages for networks and other more complex + installations. This is roughly the same procedure as is + used for track the -STABLE or -CURRENT development + branches.

+ +

/usr/src/UPDATING contains + important information on updating a FreeBSD system from + source code. It lists various issues resulting from + changes in FreeBSD that may affect an upgrade.

+ +

+
+
+ +
+
+ +

4 + Troubleshooting

+ +
+

4.1 + Repairing an Existing FreeBSD Installation

+ +

FreeBSD features a ``Fixit'' option in the top menu of + the boot floppy. To use it, you will also need either a + fixit.flp image floppy, + generated in the same fashion as the boot floppy, or the + ``live filesystem'' CDROM; typically the second CDROM in + a multi-disc FreeBSD distribution.

+ +

To invoke fixit, simply boot the kern.flp floppy, choose the + ``Fixit'' item and insert the fixit floppy or CDROM when + asked. You will then be placed into a shell with a wide + variety of commands available (in the /stand and /mnt2/stand directories) for + checking, repairing and examining filesystems and their + contents. Some UNIX administration experience is + required to use the fixit option.

+
+ +
+
+ +

4.2 Common + Installation Problems for IA-64 Architecture + Users

+
+
+
+
+ +

This file, and other release-related + documents, can be downloaded from ftp://ftp.FreeBSD.org/.

+ +

For questions about FreeBSD, read the + documentation + before contacting <questions@FreeBSD.org>.

+ +

All users of FreeBSD 5-CURRENT + should subscribe to the <current@FreeBSD.org> + mailing list.

+ +

For questions about this documentation, + e-mail <doc@FreeBSD.org>.

+
+
+ + + diff --git a/en/releases/5.1R/installation-pc98.html b/en/releases/5.1R/installation-pc98.html new file mode 100644 index 0000000000..7d71d3c4a1 --- /dev/null +++ b/en/releases/5.1R/installation-pc98.html @@ -0,0 +1,1346 @@ + + + + + FreeBSD/pc98 5.1-RELEASE Installation + Instructions + + + + + +
+
+

FreeBSD/pc98 + 5.1-RELEASE Installation Instructions

+ +

The FreeBSD Project

+ +

Copyright © 2000, 2001, 2002, + 2003 by The FreeBSD Documentation Project

+
+
+ +
+
+ + +

This article gives some brief instructions on + installing FreeBSD/pc98 5.1-RELEASE, with particular + emphasis given to obtaining a FreeBSD distribution. Some + notes on troubleshooting and frequently-asked questions + are also given.

+
+
+ +
+
+ +

1 + Installing FreeBSD

+ +

This section documents the process of installing a new + distribution of FreeBSD. These instructions pay particular + emphasis to the process of obtaining the FreeBSD + 5.1-RELEASE distribution and to beginning the installation + procedure. The ``Installing FreeBSD'' chapter of the FreeBSD Handbook provides more in-depth + information about the installation program itself, + including a guided walkthrough with screenshots.

+ +

If you are upgrading from a previous release of FreeBSD, + please see Section 3 for + instructions on upgrading.

+ +
+
+ +

1.1 Getting Started

+ +

Probably the most important pre-installation step that + can be taken is that of reading the various instruction + documents provided with FreeBSD. A roadmap of documents + pertaining to this release of FreeBSD can be found in README.TXT, which can usually be + found in the same location as this file; most of these + documents, such as the release notes and the hardware + compatibility list, are also accessible in the + Documentation menu of the installer.

+ +

Note that on-line versions of the FreeBSD FAQ and Handbook are also available from the + FreeBSD + Project Web site, if you have an Internet + connection.

+ +

This collection of documents may seem daunting, but + the time spent reading them will likely be saved many + times over. Being familiar with what resources are + available can also be helpful in the event of problems + during installation.

+ +

The best laid plans sometimes go awry, so if you run + into trouble take a look at Section + 4, which contains valuable troubleshooting + information. You should also read an updated copy of ERRATA.TXT before installing, since + this will alert you to any problems which have reported + in the interim for your particular release.

+ +
+
+

Important: While FreeBSD does its best to + safeguard against accidental loss of data, it's still + more than possible to wipe out your entire disk + with this installation if you make a mistake. Please + do not proceed to the final FreeBSD installation menu + unless you've adequately backed up any important data + first.

+
+
+
+ +
+
+ +

1.2 Hardware + Requirements

+ +

FreeBSD for the NEC PC-98x1 requires a 386 or better + processor to run (sorry, there is no support for 286 + processors) and at least 5 megs of RAM to install and 4 + megs of RAM to run. You will need at least 100MB of free + hard drive space for the most minimal installation. See + below for ways of shrinking existing DOS partitions in + order to install FreeBSD.

+ +

If you are not familiar with configuring hardware for + FreeBSD, you should be sure to read the HARDWARE.TXT file; it contains + important information on what hardware is supported by + FreeBSD.

+
+ +
+
+ +

1.3 + Floppy Disk Image Instructions

+ +

Depending on how you choose to install FreeBSD, you + may need to create a set of floppy disks (usually two) to + begin the installation process. This section briefly + describes how to create these disks, either from a CDROM + installation or from the Internet. Note that in the + common case of installing FreeBSD from CDROM, on a + machine that supports bootable CDROMs, the steps outlined + in this section will not be needed and can be + skipped.

+ +

For a normal CDROM or network installation, all you + need to copy onto actual floppies from the floppies/ directory are the kern.flp and mfsroot.flp images (for 1.44MB + floppies) or kern-small.flp and + mfsroot-small.flp images (for + 1.2MB floppies).

+ +

Getting these images over the network is easy. Simply + fetch the release/floppies/kern.flp, release/floppies/mfsroot.flp, and release/floppies/drivers.flp files from ftp://ftp.FreeBSD.org/ or one of the + many mirrors listed at FTP Sites section of the Handbook, or + on the http://www.freebsdmirrors.org/ Web + pages.

+ +

Get two blank, freshly formatted floppies and image + copy kern.flp onto one and mfsroot.flp onto the other. These + images are not DOS files. You cannot + simply copy them to a DOS or UFS floppy as regular files, + you need to ``image'' copy them to the floppy with rawrite.exe under DOS (see the tools directory on your CDROM or + FreeBSD FTP mirror) or the + dd(1) command in + UNIX.

+ +

For example, to create the kernel floppy image from + DOS, you'd do something like this:

+
+A> rawrite
+
+ +

Assuming that you'd copied rawrite.exe and kern.flp into a directory + somewhere. You would do the same for mfsroot.flp, of course.

+ +

If you're creating the boot floppy from a UNIX + machine, you may find that:

+
+# dd if=floppies/kern.flp of=/dev/rfd0.1440
+
+ +

or

+
+# dd if=floppies/kern-small.flp of=/dev/rfd0.1200
+
+ +

work well, depending on your hardware and operating + system environment (different versions of UNIX have + different names for the floppy drive).

+
+ +
+
+ +

1.4 Installing FreeBSD from + CDROM or the Internet

+ +

The easiest type of installation is from CDROM. If you + have a supported CDROM drive and a FreeBSD installation + CDROM, there is a next way of starting the installation + from it:

+ +
    +
  • +

    Build a set of FreeBSD boot floppies from the floppies/ directory in every + FreeBSD distribution. Read Section 1.3 for more information + on creating the bootable floppies under different + operating systems. Then you simply boot from the + first floppy and you should soon be in the FreeBSD + installation.

    +
    • +
+
+
+ +

If you don't have a CDROM and would like to simply + install over the net using PPP, SLIP or a dedicated + connection. You should start the installation by building + a set of FreeBSD boot floppies from the files floppies/kern.flp and floppies/mfsroot.flp using the + instructions found in Section + 1.3. Restart your computer using the kern.flp disk; when prompted, + insert the mfsroot.flp disk. + Then, please go to Section 1.5.5 + for additional tips on installing via FTP or NFS.

+
+ +
+
+ +

1.5 Detail + on various installation types

+ +

Once you've gotten yourself to the initial + installation screen somehow, you should be able to follow + the various menu prompts and go from there. If you've + never used the FreeBSD installation before, you are also + encouraged to read some of the documentation in the + Documentation submenu as well as the general ``Usage'' + instructions on the first menu.

+ +
+
+

Note: If you get stuck at a screen, press + the F1 key for online + documentation relevant to that specific section.

+
+
+ +

If you've never installed FreeBSD before, or even if + you have, the ``Standard'' installation mode is the most + recommended since it makes sure that you'll visit all the + various important checklist items along the way. If + you're much more comfortable with the FreeBSD + installation process and know exactly what you want to do, + use the ``Express'' or ``Custom'' installation options. + If you're upgrading an existing system, use the + ``Upgrade'' option.

+ +

The FreeBSD installer supports the direct use of + floppy, DOS, tape, CDROM, FTP, NFS and UFS partitions as + installation media; further tips on installing from each + type of media are listed below.

+ +
+
+ +

1.5.1 + Installing from a Network CDROM

+ +

If you simply wish to install from a local CDROM + drive then see Section + 1.4. If you don't have a CDROM drive on your system + and wish to use a FreeBSD distribution CD in the CDROM + drive of another system to which you have network + connectivity, there are also several ways of going + about it:

+ +
    +
  • +

    If you would be able to FTP install FreeBSD + directly from the CDROM drive in some FreeBSD + machine, it's quite easy: You simply add the + following line to the password file (using the + vipw(8) + command):

    +
    +ftp:*:99:99::0:0:FTP:/cdrom:/sbin/nologin
+
    + +

    On the machine on which you are running the + install, go to the Options menu and set Release + Name to any. You may then + choose a Media type of FTP + and type in ftp://machine after + picking ``URL'' in the ftp sites menu.

    + +
    +
    +

    Warning: This may allow anyone on the + local network (or Internet) to make ``anonymous + FTP'' connections to this machine, which may + not be desirable.

    +
    +
    +
    • + +
  • +

    If you would rather use NFS to export the CDROM + directly to the machine(s) you'll be installing + from, you need to first add an entry to the /etc/exports file (on the + machine with the CDROM drive). The example below + allows the machine ziggy.foo.com to mount the + CDROM directly via NFS during installation:

    +
    +/cdrom          -ro             ziggy.foo.com
+
    + +

    The machine with the CDROM must also be + configured as an NFS server, of course, and if + you're not sure how to do that then an NFS + installation is probably not the best choice for + you unless you're willing to read up on + rc.conf(5) + and configure things appropriately. Assuming that + this part goes smoothly, you should be able to + enter: cdrom-host:/cdrom + as the path for an NFS installation when the target + machine is installed, e.g. wiggy:/cdrom.

    +
    • +
+
+ +
+
+ +

1.5.2 + Installing from Floppies

+ +

If you must install from floppy disks, either due to + unsupported hardware or just because you enjoy doing + things the hard way, you must first prepare some + floppies for the install.

+ +

First, make your boot floppies as described in Section 1.3.

+ +

Second, peruse Section 2 and + pay special attention to the ``Distribution Format'' + section since it describes which files you're going to + need to put onto floppy and which you can safely + skip.

+ +

Next you will need, at minimum, as many 1.44MB + floppies as it takes to hold all files in the bin (binary distribution) + directory. If you're preparing these floppies under + DOS, then these floppies must be formatted using the + MS-DOS FORMAT command. If + you're using Windows, use the Windows File Manager + format command.

+ +
+
+

Important: Frequently, floppy disks come + ``factory preformatted''. While convenient, many + problems reported by users in the past have + resulted from the use of improperly formatted + media. Re-format them yourself, just to make + sure.

+
+
+ +

If you're creating the floppies from another FreeBSD + machine, a format is still not a bad idea though you + don't need to put a DOS filesystem on each floppy. You + can use the + disklabel(8) + and + newfs(8) + commands to put a UFS filesystem on a floppy, as the + following sequence of commands illustrates:

+
+# fdformat -f 1440 fd0.1440
+# disklabel -w -r fd0.1440 floppy3
+# newfs -t 2 -u 18 -l 1 -i 65536 /dev/fd0
+
+ +

After you've formatted the floppies for DOS or UFS, + you'll need to copy the files onto them. The + distribution files are split into chunks conveniently + sized so that 5 of them will fit on a conventional + 1.44MB floppy. Go through all your floppies, packing as + many files as will fit on each one, until you've got + all the distributions you want packed up in this + fashion. Each distribution should go into its own + subdirectory on the floppy, e.g.: a:\bin\bin.inf, a:\bin\bin.aa, a:\bin\bin.ab, ...

+ +
+
+

Important: The bin.inf file also needs to go + on the first floppy of the bin set since it is read by + the installation program in order to figure out how + many additional pieces to look for when fetching + and concatenating the distribution. When putting + distributions onto floppies, the distname.inf file must occupy the first + floppy of each distribution set. This is also + covered in README.TXT.

+
+
+ +

Once you come to the Media screen of the install, + select ``Floppy'' and you'll be prompted for the + rest.

+
+ +
+
+ +

1.5.3 + Installing from a DOS partition

+ +

To prepare for installation from an MS-DOS partition + you should simply copy the files from the distribution + into a directory called FREEBSD on the Primary DOS + partition (A:). For + example, to do a minimal installation of FreeBSD from + DOS using files copied from the CDROM, you might do + something like this:

+
+A:\> MD A:\FREEBSD
+A:\> XCOPY /S E:\BASE A:\FREEBSD\BASE
+
+ +

Assuming that E: was + where your CD was mounted.

+ +

For as many distributions as you wish to install + from DOS (and you have free space for), install each + one in a directory under A:\FREEBSD - the BIN dist is only the minimal + requirement.

+ +

Once you've copied the directories, you can simply + launch the installation from floppies as normal and + select ``DOS'' as your media type when the time + comes.

+
+ +
+
+ +

1.5.4 + Installing from QIC/SCSI Tape

+ +

When installing from tape, the installation program + expects the files to be simply tar'ed onto it, so after + fetching all of the files for the distributions you're + interested in, simply use + tar(1) to get + them onto the tape with a command something like + this:

+
+# cd /where/you/have/your/dists
+# tar cvf /dev/rsa0 dist1 .. dist2
+
+ +

When you go to do the installation, you should also + make sure that you leave enough room in some temporary + directory (which you'll be allowed to choose) to + accommodate the full contents of the tape + you've created. Due to the non-random access nature of + tapes, this method of installation requires quite a bit + of temporary storage. You should expect to require as + much temporary storage as you have stuff written on + tape.

+ +
+
+

Note: When going to do the installation, + the tape must be in the drive before booting from the + boot floppies. The installation ``probe'' may + otherwise fail to find it.

+
+
+ +

Now create a boot floppy as described in Section 1.3 and proceed with the + installation.

+
+ +
+
+ +

1.5.5 + Installing over a Network using FTP or NFS

+ +

After making the boot floppies as described in the + first section, you can load the rest of the + installation over a network using one of 3 types of + connections: serial port, parallel port, or + Ethernet.

+ +
+
+ +

1.5.5.1 Serial Port

+ +

SLIP support is rather primitive, and is limited + primarily to hard-wired links, such as a serial cable + running between two computers. The link must be + hard-wired because the SLIP installation doesn't + currently offer a dialing capability. If you need to + dial out with a modem or otherwise dialog with the + link before connecting to it, then I recommend that + the PPP utility be used instead.

+ +

If you're using PPP, make sure that you have your + Internet Service Provider's IP address and DNS + information handy as you'll need to know it fairly + early in the installation process. You may also need + to know your own IP address, though PPP supports + dynamic address negotiation and may be able to pick + up this information directly from your ISP if they + support it.

+ +

You will also need to know how to use the various + ``AT commands'' for dialing out with your particular + brand of modem as the PPP dialer provides only a very + simple terminal emulator.

+
+ +
+
+ +

1.5.5.2 Parallel Port

+ +

If a hard-wired connection to another FreeBSD or + Linux machine is available, you might also consider + installing over a ``laplink'' style parallel port + cable. The data rate over the parallel port is much + higher than what is typically possible over a serial + line (up to 50k/sec), thus resulting in a quicker + installation. It's not typically necessary to use + ``real'' IP addresses when using a point-to-point + parallel cable in this way and you can generally just + use RFC 1918 style addresses for the ends of the link + (e.g. 10.0.0.1, 10.0.0.2, etc).

+ +
+
+

Important: If you use a Linux machine + rather than a FreeBSD machine as your PLIP peer, + you will also have to specify link0 in the TCP/IP setup + screen's ``extra options for ifconfig'' field in + order to be compatible with Linux's slightly + different PLIP protocol.

+
+
+
+ +
+
+ +

1.5.5.3 Ethernet

+ +

FreeBSD supports many common Ethernet cards; a + table of supported cards is provided as part of the + FreeBSD Hardware Notes (see HARDWARE.TXT in the + Documentation menu on the boot floppy or the top + level directory of the CDROM). If you are using one + of the supported PCMCIA Ethernet cards, also be sure + that it's plugged in before the laptop is + powered on. FreeBSD does not, unfortunately, + currently support ``hot insertion'' of PCMCIA cards + during installation.

+ +

You will also need to know your IP address on the + network, the netmask value + for your subnet and the name of your machine. Your + system administrator can tell you which values are + appropriate to your particular network setup. If you + will be referring to other hosts by name rather than + IP address, you'll also need a name server and + possibly the address of a gateway (if you're using + PPP, it's your provider's IP address) to use in + talking to it. If you want to install by FTP via an + HTTP proxy (see below), you will also need the + proxy's address.

+ +

If you do not know the answers to these questions + then you should really probably talk to your system + administrator first before trying this + type of installation. Using a randomly chosen IP + address or netmask on a live network is almost + guaranteed not to work, and will probably result in a + lecture from said system administrator.

+ +

Once you have a network connection of some sort + working, the installation can continue over NFS or + FTP.

+
+ +
+
+ +

1.5.5.4 NFS installation tips

+ +

NFS installation is fairly straight-forward: + Simply copy the FreeBSD distribution files you want + onto a server somewhere and then point the NFS media + selection at it.

+ +

If this server supports only ``privileged port'' + access (this is generally the default for Sun and + Linux workstations), you will need to set this option + in the Options menu before installation can + proceed.

+ +

If you have a poor quality Ethernet card which + suffers from very slow transfer rates, you may also + wish to toggle the appropriate Options flag.

+ +

In order for NFS installation to work, the server + must also support ``subdir mounts'', e.g. if your + FreeBSD distribution directory lives on wiggy:/usr/archive/stuff/FreeBSD, + then wiggy will have to allow + the direct mounting of /usr/archive/stuff/FreeBSD, not + just /usr or /usr/archive/stuff.

+ +

In FreeBSD's /etc/exports file this is + controlled by the -alldirs + option. Other NFS servers may have different + conventions. If you are getting Permission Denied messages from + the server then it's likely that you don't have this + properly enabled.

+
+ +
+
+ +

1.5.5.5 FTP Installation tips

+ +

FTP installation may be done from any mirror site + containing a reasonably up-to-date version of + FreeBSD. A full menu of reasonable choices for almost + any location in the world is provided in the FTP site + menu during installation.

+ +

If you are installing from some other FTP site not + listed in this menu, or you are having troubles + getting your name server configured properly, you can + also specify your own URL by selecting the ``URL'' + choice in that menu. A URL can contain a hostname or + an IP address, so something like the following would + work in the absence of a name server:

+
+ftp://216.66.64.162/pub/FreeBSD/releases/pc98/4.2-RELEASE
+
+ +

There are three FTP installation modes you can + use:

+ +
    +
  • +

    FTP: This method uses the standard ``Active'' + mode for transfers, in which the server initiates + a connection to the client. This will not work + through most firewalls but will often work best + with older FTP servers that do not support + passive mode. If your connection hangs with + passive mode, try this one.

    +
    • + +
  • +

    FTP Passive: This sets the FTP "Passive" mode + which prevents the server from opening + connections to the client. This option is best + for users to pass through firewalls that do not + allow incoming connections on random port + addresses.

    +
    • + +
  • +

    FTP via an HTTP proxy: This option instructs + FreeBSD to use HTTP to connect to a proxy for all + FTP operations. The proxy will translate the + requests and send them to the FTP server. This + allows the user to pass through firewalls that do + not allow FTP at all, but offer an HTTP proxy. + You must specify the hostname of the proxy in + addition to the FTP server.

    + +

    In the rare case that you have an FTP proxy + that does not go through HTTP, you can specify + the URL as something like:

    +
    +ftp://foo.bar.com:port/pub/FreeBSD
+
    + +

    In the URL above, port is the port + number of the proxy FTP server.

    +
    • +
+
+
+
+
+
+ +
+
+ +

1.6 + Question and Answer Section for NEC PC-98x1 Architecture + Users

+
+
+ +
+
+ +

2 + Distribution Format

+ +

A typical FreeBSD distribution directory looks something + like this (exact details may vary depending on version, + architecture, and other factors):

+
+ERRATA.HTM      README.TXT      compat1x        dict            kernel
+ERRATA.TXT      RELNOTES.HTM    compat20        doc             manpages
+HARDWARE.HTM    RELNOTES.TXT    compat21        docbook.css     packages
+HARDWARE.TXT    base            compat22        filename.txt    ports
+INSTALL.HTM     boot            compat3x        floppies        proflibs
+INSTALL.TXT     catpages        compat4x        games           src
+README.HTM      cdrom.inf       crypto          info            tools
+
+ +

If you want to do a CDROM, FTP or NFS installation from + this distribution directory, all you need to do is make the + 1.44MB boot floppies from the floppies directory (see Section 1.3 for instructions on how to + do this), boot them and follow the instructions. The rest + of the data needed during the installation will be obtained + automatically based on your selections. If you've never + installed FreeBSD before, you also want to read the + entirety of this document (the installation instructions) + file.

+ +

If you're trying to do some other type of installation + or are merely curious about how a distribution is + organized, what follows is a more thorough description of + some of these items in more detail:

+ +
    +
  1. +

    The *.TXT and *.HTM files contain documentation + (for example, this document is contained in both INSTALL.TXT and INSTALL.HTM) and should be read + before starting an installation. The *.TXT files are plain text, while + the *.HTM files are HTML + files that can be read by almost any Web browser. Some + distributions may contain documentation in other + formats as well, such as PDF or PostScript.

    +
    2. + +
  2. +

    docbook.css is a Cascading + Style Sheet (CSS) file used by some Web browsers for + formatting the HTML documentation.

    +
    3. + +
  3. +

    The base, catpages, crypto, dict, doc, games, info, manpages, proflibs, and src directories contain the + primary distribution components of FreeBSD itself and + are split into smaller files for easy packing onto + floppies (should that be necessary).

    +
    4. + +
  4. +

    The compat1x, compat20, compat21, compat22, compat3x, and compat4x directories contain + distributions for compatibility with older releases and + are distributed as single gzip'd tar files - they can + be installed during release time or later by running + their install.sh scripts.

    +
    5. + +
  5. +

    The floppies/ subdirectory + contains the floppy installation images; further + information on using them can be found in Section 1.3.

    +
    6. + +
  6. +

    The packages and ports directories contain the + FreeBSD Packages and Ports Collections. Packages may be + installed from the packages directory by running the + command:

    +
    +#/stand/sysinstall configPackages
+
    + +

    Packages can also be installed by feeding individual + filenames in packages/ to the + + pkg_add(1) + command.

    + +

    The Ports Collection may be installed like any other + distribution and requires about 100MB unpacked. More + information on the ports collection may be obtained + from http://www.FreeBSD.org/ports/ or + locally from /usr/share/doc/handbook if you've + installed the doc + distribution.

    +
    7. + +
  7. +

    Last of all, the tools + directory contains various DOS tools for discovering + disk geometries, installing boot managers and the like. + It is purely optional and provided only for user + convenience.

    +
    8. +
+
+
+ +

A typical distribution directory (for example, the info distribution) looks like this + internally:

+
+CHECKSUM.MD5    info.ab         info.ad         info.inf        install.sh
+info.aa         info.ac         info.ae         info.mtree
+
+ +

The CHECKSUM.MD5 file contains + MD5 signatures for each file, should data corruption be + suspected, and is purely for reference. It is not used by + the actual installation and does not need to be copied with + the rest of the distribution files. The info.a* files are split, gzip'd tar + files, the contents of which can be viewed by doing:

+
+# cat info.a* | tar tvzf -
+
+ +

During installation, they are automatically concatenated + and extracted by the installation procedure.

+ +

The info.inf file is also + necessary since it is read by the installation program in + order to figure out how many pieces to look for when + fetching and concatenating the distribution. When putting + distributions onto floppies, the .inf file must occupy the first floppy of + each distribution set!

+ +

The info.mtree file is another + non-essential file which is provided for user reference. It + contains the MD5 signatures of the unpacked + distribution files and can be later used with the + mtree(8) program to + verify the installation permissions and checksums against + any possible modifications to the file. When used with the + base distribution, this can be an + excellent way of detecting trojan horse attacks on your + system.

+ +

Finally, the install.sh file + is for use by those who want to install the distribution + after installation time. To install the info distribution + from CDROM after a system was installed, for example, you'd + do:

+
+# cd /cdrom/info
+# sh install.sh
+
+
+ +
+
+ +

3 + Upgrading FreeBSD

+ +

These instructions describe a procedure for doing a + binary upgrade from an older version of FreeBSD.

+ +
+
+

Warning: While the FreeBSD upgrade procedure + does its best to safeguard against accidental loss of + data, it is still more than possible to wipe out your + entire disk with this installation! Please + do not accept the final confirmation request unless you + have adequately backed up any important data files.

+
+
+ +
+
+

Important: These notes assume that you are + using the version of + sysinstall(8) + supplied with the version of FreeBSD to which you + intend to upgrade. Using a mismatched version of + sysinstall(8) + is almost guaranteed to cause problems and has been + known to leave systems in an unusable state. The most + commonly made mistake in this regard is the use of an + old copy of + sysinstall(8) + from an existing installation to upgrade to a newer + version of FreeBSD. This is not recommended.

+
+
+ +
+
+

Warning: Binary upgrades to FreeBSD + 5.1-RELEASE from FreeBSD 4-STABLE are not supported at + this time. There are some files present in a FreeBSD + 4-STABLE whose presence can be disruptive, but are not + removed by a binary upgrade. One notable example is + that an old /usr/include/g++ + directory will cause C++ programs to compile + incorrectly (or not at all).

+ +

+ +

These upgrade instructions are provided for the use + of users upgrading from relatively recent FreeBSD + 5-CURRENT snapshots.

+
+
+ +
+
+ +

3.1 + Introduction

+ +

The upgrade procedure replaces distributions selected + by the user with those corresponding to the new FreeBSD + release. It preserves standard system configuration data, + as well as user data, installed packages and other + software.

+ +

Administrators contemplating an upgrade are encouraged + to study this section in its entirety before commencing + an upgrade. Failure to do so may result in a failed + upgrade or loss of data.

+ +
+
+ +

3.1.1 + Upgrade Overview

+ +

Upgrading of a distribution is performed by + extracting the new version of the component over the + top of the previous version. Files belonging to the old + distribution are not deleted.

+ +

System configuration is preserved by retaining and + restoring the previous version of the following + files:

+ +

Xaccel.ini, XF86Config, adduser.conf, aliases, aliases.db, amd.map, crontab, csh.cshrc, csh.login, csh.logout, cvsupfile, dhclient.conf, disktab, dm.conf, dumpdates, exports, fbtab, fstab, ftpusers, gettytab, gnats, group, hosts, hosts.allow, hosts.equiv, hosts.lpd, inetd.conf, localtime, login.access, login.conf, mail, mail.rc, make.conf, manpath.config, master.passwd, motd, namedb, networks, newsyslog.conf, nsmb.conf, nsswitch.conf, pam.conf, passwd, periodic, ppp, printcap, profile, pwd.db, rc.conf, rc.conf.local, rc.firewall, rc.local, remote, resolv.conf, rmt, sendmail.cf, sendmail.cw, services, shells, skeykeys, spwd.db, ssh, syslog.conf, ttys, uucp

+ +

The versions of these files which correspond to the + new version are moved to /etc/upgrade/. The system + administrator may peruse these new versions and merge + components as desired. Note that many of these files + are interdependent, and the best merge procedure is to + copy all site-specific data from the current files into + the new.

+ +

During the upgrade procedure, the administrator is + prompted for a location into which all files from /etc/ are saved. In the event + that local modifications have been made to other files, + they may be subsequently retrieved from this + location.

+
+
+ +
+
+ +

3.2 + Procedure

+ +

This section details the upgrade procedure. Particular + attention is given to items which substantially differ + from a normal installation.

+ +
+
+ +

3.2.1 + Backup

+ +

User data and system configuration should be backed + up before upgrading. While the upgrade procedure does + its best to prevent accidental mistakes, it is possible + to partially or completely destroy data and + configuration information.

+
+ +
+
+ +

3.2.2 + Mount Filesystems

+ +

The disklabel editor is entered with the nominated + disk's filesystem devices listed. Prior to commencing + the upgrade, the administrator should make a note of + the device names and corresponding mountpoints. These + mountpoints should be entered here. Do not + set the ``newfs flag'' for any filesystems, as this + will cause data loss.

+
+ +
+
+ +

3.2.3 + Select Distributions

+ +

When selecting distributions, there are no + constraints on which must be selected. As a general + rule, the base distribution + should be selected for an update, and the man distribution if manpages are + already installed. Other distributions may be selected + beyond those originally installed if the administrator + wishes to add additional functionality.

+
+ +
+
+ +

3.2.4 + After Installation

+ +

Once the installation procedure has completed, the + administrator is prompted to examine the new + configuration files. At this point, checks should be + made to ensure that the system configuration is valid. + In particular, the /etc/rc.conf and /etc/fstab files should be + checked.

+
+
+ +
+
+ +

3.3 + Upgrading from Source Code

+ +

Those interested in an upgrade method that allows more + flexibility and sophistication should take a look at The Cutting Edge in the FreeBSD + Handbook. This procedure involves rebuilding all of + FreeBSD from source code. It requires reliable network + connectivity, extra disk space, and time, but has + advantages for networks and other more complex + installations. This is roughly the same procedure as is + used for track the -STABLE or -CURRENT development + branches.

+ +

/usr/src/UPDATING contains + important information on updating a FreeBSD system from + source code. It lists various issues resulting from + changes in FreeBSD that may affect an upgrade.

+ +

+
+
+ +
+
+ +

4 + Troubleshooting

+ +
+

4.1 + Repairing an Existing FreeBSD Installation

+ +

FreeBSD features a ``Fixit'' option in the top menu of + the boot floppy. To use it, you will also need either a + fixit.flp image floppy, + generated in the same fashion as the boot floppy, or the + ``live filesystem'' CDROM; typically the second CDROM in + a multi-disc FreeBSD distribution.

+ +

To invoke fixit, simply boot the kern.flp floppy, choose the + ``Fixit'' item and insert the fixit floppy or CDROM when + asked. You will then be placed into a shell with a wide + variety of commands available (in the /stand and /mnt2/stand directories) for + checking, repairing and examining filesystems and their + contents. Some UNIX administration experience is + required to use the fixit option.

+
+ +
+
+ +

4.2 Common + Installation Problems for NEC PC-98x1 Architecture + Users

+
+
+
+
+ +

This file, and other release-related + documents, can be downloaded from ftp://ftp.FreeBSD.org/.

+ +

For questions about FreeBSD, read the + documentation + before contacting <questions@FreeBSD.org>.

+ +

All users of FreeBSD 5-CURRENT + should subscribe to the <current@FreeBSD.org> + mailing list.

+ +

For questions about this documentation, + e-mail <doc@FreeBSD.org>.

+
+
+ + + diff --git a/en/releases/5.1R/installation-sparc64.html b/en/releases/5.1R/installation-sparc64.html new file mode 100644 index 0000000000..0b72295699 --- /dev/null +++ b/en/releases/5.1R/installation-sparc64.html @@ -0,0 +1,1248 @@ + + + + + FreeBSD/sparc64 5.1-RELEASE Installation + Instructions + + + + + +
+
+

FreeBSD/sparc64 + 5.1-RELEASE Installation Instructions

+ +

The FreeBSD Project

+ +

Copyright © 2000, 2001, 2002, + 2003 by The FreeBSD Documentation Project

+
+
+ +
+
+ + +

This article gives some brief instructions on + installing FreeBSD/sparc64 5.1-RELEASE, with particular + emphasis given to obtaining a FreeBSD distribution. Some + notes on troubleshooting and frequently-asked questions + are also given.

+
+
+ +
+
+ +

1 + Installing FreeBSD

+ +

This section documents the process of installing a new + distribution of FreeBSD. These instructions pay particular + emphasis to the process of obtaining the FreeBSD + 5.1-RELEASE distribution and to beginning the installation + procedure. The ``Installing FreeBSD'' chapter of the FreeBSD Handbook provides more in-depth + information about the installation program itself, + including a guided walkthrough with screenshots.

+ +

If you are upgrading from a previous release of FreeBSD, + please see Section 3 for + instructions on upgrading.

+ +
+
+ +

1.1 Getting Started

+ +

Probably the most important pre-installation step that + can be taken is that of reading the various instruction + documents provided with FreeBSD. A roadmap of documents + pertaining to this release of FreeBSD can be found in README.TXT, which can usually be + found in the same location as this file; most of these + documents, such as the release notes and the hardware + compatibility list, are also accessible in the + Documentation menu of the installer.

+ +

Note that on-line versions of the FreeBSD FAQ and Handbook are also available from the + FreeBSD + Project Web site, if you have an Internet + connection.

+ +

This collection of documents may seem daunting, but + the time spent reading them will likely be saved many + times over. Being familiar with what resources are + available can also be helpful in the event of problems + during installation.

+ +

The best laid plans sometimes go awry, so if you run + into trouble take a look at Section + 4, which contains valuable troubleshooting + information. You should also read an updated copy of ERRATA.TXT before installing, since + this will alert you to any problems which have reported + in the interim for your particular release.

+ +
+
+

Important: While FreeBSD does its best to + safeguard against accidental loss of data, it's still + more than possible to wipe out your entire disk + with this installation if you make a mistake. Please + do not proceed to the final FreeBSD installation menu + unless you've adequately backed up any important data + first.

+
+
+
+ +
+
+ +

1.2 Hardware + Requirements

+ +

FreeBSD for the UltraSPARC supports the platforms + described in HARDWARE.TXT.

+ +

You will need a dedicated disk for FreeBSD/sparc64. It + is not possible to share a disk with another operating + system at this time.

+ +

If you are not familiar with configuring hardware for + FreeBSD, you should be sure to read the HARDWARE.TXT file; it contains + important information on what hardware is supported by + FreeBSD.

+
+ +
+
+ +

1.3 + Floppy Disk Image Instructions

+
+ +
+
+ +

1.4 Installing FreeBSD from + CDROM or the Internet

+ +

Most sparc64 systems are set up to boot automatically + from disk. To install FreeBSD, you need to boot over the + network or from a CDROM, which requires you to break into + the PROM (OpenFirmware).

+ +

To do this, reboot the system, and wait until the boot + message appears. It depends on the model, but should look + about like:

+
+Sun Blade 100 (UltraSPARC-IIe), Keyboard Present
+Copyright 1998-2001 Sun Microsystems, Inc.  All rights reserved.
+OpenBoot 4.2, 128 MB memory installed, Serial #51090132.
+Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.
+
+ +

If your system proceeds to boot from disk at this + point, you need to press L1+A or Stop+A on the keyboard, or send a BREAK over the serial console (using + for example ~# in + tip(1) or + cu(1)) to get to + the PROM prompt. It looks like this:

+
+ok         (1)
+ok {0}     (2)
+
+ +
+
+
(1)
+ +
This is the prompt used on systems with just one + CPU.
+ +
(2)
+ +
This is the prompt used on SMP systems, the digit + indicates the number of the active CPU.
+
+
+ +

At this point, place the CDROM into your drive, and + from the PROM prompt, type boot + cdrom.

+
+ +
+
+ +

1.5 Detail + on various installation types

+ +

Once you've gotten yourself to the initial + installation screen somehow, you should be able to follow + the various menu prompts and go from there. If you've + never used the FreeBSD installation before, you are also + encouraged to read some of the documentation in the + Documentation submenu as well as the general ``Usage'' + instructions on the first menu.

+ +
+
+

Note: If you get stuck at a screen, press + the F1 key for online + documentation relevant to that specific section.

+
+
+ +

If you've never installed FreeBSD before, or even if + you have, the ``Standard'' installation mode is the most + recommended since it makes sure that you'll visit all the + various important checklist items along the way. If + you're much more comfortable with the FreeBSD + installation process and know exactly what you want to do, + use the ``Express'' or ``Custom'' installation options. + If you're upgrading an existing system, use the + ``Upgrade'' option.

+ +

The FreeBSD installer supports the direct use of + floppy, DOS, tape, CDROM, FTP, NFS and UFS partitions as + installation media; further tips on installing from each + type of media are listed below.

+ +
+
+ +

1.5.1 + Installing from a Network CDROM

+ +

If you simply wish to install from a local CDROM + drive then see Section + 1.4. If you don't have a CDROM drive on your system + and wish to use a FreeBSD distribution CD in the CDROM + drive of another system to which you have network + connectivity, there are also several ways of going + about it:

+ +
    +
  • +

    If you would be able to FTP install FreeBSD + directly from the CDROM drive in some FreeBSD + machine, it's quite easy: You simply add the + following line to the password file (using the + vipw(8) + command):

    +
    +ftp:*:99:99::0:0:FTP:/cdrom:/sbin/nologin
+
    + +

    On the machine on which you are running the + install, go to the Options menu and set Release + Name to any. You may then + choose a Media type of FTP + and type in ftp://machine after + picking ``URL'' in the ftp sites menu.

    + +
    +
    +

    Warning: This may allow anyone on the + local network (or Internet) to make ``anonymous + FTP'' connections to this machine, which may + not be desirable.

    +
    +
    +
    • + +
  • +

    If you would rather use NFS to export the CDROM + directly to the machine(s) you'll be installing + from, you need to first add an entry to the /etc/exports file (on the + machine with the CDROM drive). The example below + allows the machine ziggy.foo.com to mount the + CDROM directly via NFS during installation:

    +
    +/cdrom          -ro             ziggy.foo.com
+
    + +

    The machine with the CDROM must also be + configured as an NFS server, of course, and if + you're not sure how to do that then an NFS + installation is probably not the best choice for + you unless you're willing to read up on + rc.conf(5) + and configure things appropriately. Assuming that + this part goes smoothly, you should be able to + enter: cdrom-host:/cdrom + as the path for an NFS installation when the target + machine is installed, e.g. wiggy:/cdrom.

    +
    • +
+
+ +
+
+ +

1.5.2 + Installing from Floppies

+ +

If you must install from floppy disks, either due to + unsupported hardware or just because you enjoy doing + things the hard way, you must first prepare some + floppies for the install.

+ +

First, make your boot floppies as described in Section 1.3.

+ +

Second, peruse Section 2 and + pay special attention to the ``Distribution Format'' + section since it describes which files you're going to + need to put onto floppy and which you can safely + skip.

+ +

Next you will need, at minimum, as many 1.44MB + floppies as it takes to hold all files in the bin (binary distribution) + directory. If you're preparing these floppies under + DOS, then these floppies must be formatted using the + MS-DOS FORMAT command. If + you're using Windows, use the Windows File Manager + format command.

+ +
+
+

Important: Frequently, floppy disks come + ``factory preformatted''. While convenient, many + problems reported by users in the past have + resulted from the use of improperly formatted + media. Re-format them yourself, just to make + sure.

+
+
+ +

If you're creating the floppies from another FreeBSD + machine, a format is still not a bad idea though you + don't need to put a DOS filesystem on each floppy. You + can use the + disklabel(8) + and + newfs(8) + commands to put a UFS filesystem on a floppy, as the + following sequence of commands illustrates:

+
+# fdformat -f 1440 fd0.1440
+# disklabel -w -r fd0.1440 floppy3
+# newfs -t 2 -u 18 -l 1 -i 65536 /dev/fd0
+
+ +

After you've formatted the floppies for DOS or UFS, + you'll need to copy the files onto them. The + distribution files are split into chunks conveniently + sized so that 5 of them will fit on a conventional + 1.44MB floppy. Go through all your floppies, packing as + many files as will fit on each one, until you've got + all the distributions you want packed up in this + fashion. Each distribution should go into its own + subdirectory on the floppy, e.g.: a:\bin\bin.inf, a:\bin\bin.aa, a:\bin\bin.ab, ...

+ +
+
+

Important: The bin.inf file also needs to go + on the first floppy of the bin set since it is read by + the installation program in order to figure out how + many additional pieces to look for when fetching + and concatenating the distribution. When putting + distributions onto floppies, the distname.inf file must occupy the first + floppy of each distribution set. This is also + covered in README.TXT.

+
+
+ +

Once you come to the Media screen of the install, + select ``Floppy'' and you'll be prompted for the + rest.

+
+ +
+
+ +

1.5.4 + Installing from QIC/SCSI Tape

+ +

When installing from tape, the installation program + expects the files to be simply tar'ed onto it, so after + fetching all of the files for the distributions you're + interested in, simply use + tar(1) to get + them onto the tape with a command something like + this:

+
+# cd /where/you/have/your/dists
+# tar cvf /dev/rsa0 dist1 .. dist2
+
+ +

When you go to do the installation, you should also + make sure that you leave enough room in some temporary + directory (which you'll be allowed to choose) to + accommodate the full contents of the tape + you've created. Due to the non-random access nature of + tapes, this method of installation requires quite a bit + of temporary storage. You should expect to require as + much temporary storage as you have stuff written on + tape.

+ +
+
+

Note: When going to do the installation, + the tape must be in the drive before booting from the + boot floppies. The installation ``probe'' may + otherwise fail to find it.

+
+
+ +

Now create a boot floppy as described in Section 1.3 and proceed with the + installation.

+
+ +
+
+ +

1.5.5 + Installing over a Network using FTP or NFS

+ +

After making the boot floppies as described in the + first section, you can load the rest of the + installation over a network using one of 3 types of + connections: serial port, parallel port, or + Ethernet.

+ +
+
+ +

1.5.5.1 Serial Port

+ +

SLIP support is rather primitive, and is limited + primarily to hard-wired links, such as a serial cable + running between two computers. The link must be + hard-wired because the SLIP installation doesn't + currently offer a dialing capability. If you need to + dial out with a modem or otherwise dialog with the + link before connecting to it, then I recommend that + the PPP utility be used instead.

+ +

If you're using PPP, make sure that you have your + Internet Service Provider's IP address and DNS + information handy as you'll need to know it fairly + early in the installation process. You may also need + to know your own IP address, though PPP supports + dynamic address negotiation and may be able to pick + up this information directly from your ISP if they + support it.

+ +

You will also need to know how to use the various + ``AT commands'' for dialing out with your particular + brand of modem as the PPP dialer provides only a very + simple terminal emulator.

+
+ +
+
+ +

1.5.5.2 Parallel Port

+ +

If a hard-wired connection to another FreeBSD or + Linux machine is available, you might also consider + installing over a ``laplink'' style parallel port + cable. The data rate over the parallel port is much + higher than what is typically possible over a serial + line (up to 50k/sec), thus resulting in a quicker + installation. It's not typically necessary to use + ``real'' IP addresses when using a point-to-point + parallel cable in this way and you can generally just + use RFC 1918 style addresses for the ends of the link + (e.g. 10.0.0.1, 10.0.0.2, etc).

+ +
+
+

Important: If you use a Linux machine + rather than a FreeBSD machine as your PLIP peer, + you will also have to specify link0 in the TCP/IP setup + screen's ``extra options for ifconfig'' field in + order to be compatible with Linux's slightly + different PLIP protocol.

+
+
+
+ +
+
+ +

1.5.5.3 Ethernet

+ +

FreeBSD supports many common Ethernet cards; a + table of supported cards is provided as part of the + FreeBSD Hardware Notes (see HARDWARE.TXT in the + Documentation menu on the boot floppy or the top + level directory of the CDROM). If you are using one + of the supported PCMCIA Ethernet cards, also be sure + that it's plugged in before the laptop is + powered on. FreeBSD does not, unfortunately, + currently support ``hot insertion'' of PCMCIA cards + during installation.

+ +

You will also need to know your IP address on the + network, the netmask value + for your subnet and the name of your machine. Your + system administrator can tell you which values are + appropriate to your particular network setup. If you + will be referring to other hosts by name rather than + IP address, you'll also need a name server and + possibly the address of a gateway (if you're using + PPP, it's your provider's IP address) to use in + talking to it. If you want to install by FTP via an + HTTP proxy (see below), you will also need the + proxy's address.

+ +

If you do not know the answers to these questions + then you should really probably talk to your system + administrator first before trying this + type of installation. Using a randomly chosen IP + address or netmask on a live network is almost + guaranteed not to work, and will probably result in a + lecture from said system administrator.

+ +

Once you have a network connection of some sort + working, the installation can continue over NFS or + FTP.

+
+ +
+
+ +

1.5.5.4 NFS installation tips

+ +

NFS installation is fairly straight-forward: + Simply copy the FreeBSD distribution files you want + onto a server somewhere and then point the NFS media + selection at it.

+ +

If this server supports only ``privileged port'' + access (this is generally the default for Sun and + Linux workstations), you will need to set this option + in the Options menu before installation can + proceed.

+ +

If you have a poor quality Ethernet card which + suffers from very slow transfer rates, you may also + wish to toggle the appropriate Options flag.

+ +

In order for NFS installation to work, the server + must also support ``subdir mounts'', e.g. if your + FreeBSD distribution directory lives on wiggy:/usr/archive/stuff/FreeBSD, + then wiggy will have to allow + the direct mounting of /usr/archive/stuff/FreeBSD, not + just /usr or /usr/archive/stuff.

+ +

In FreeBSD's /etc/exports file this is + controlled by the -alldirs + option. Other NFS servers may have different + conventions. If you are getting Permission Denied messages from + the server then it's likely that you don't have this + properly enabled.

+
+ +
+
+ +

1.5.5.5 FTP Installation tips

+ +

FTP installation may be done from any mirror site + containing a reasonably up-to-date version of + FreeBSD. A full menu of reasonable choices for almost + any location in the world is provided in the FTP site + menu during installation.

+ +

If you are installing from some other FTP site not + listed in this menu, or you are having troubles + getting your name server configured properly, you can + also specify your own URL by selecting the ``URL'' + choice in that menu. A URL can contain a hostname or + an IP address, so something like the following would + work in the absence of a name server:

+
+ftp://216.66.64.162/pub/FreeBSD/releases/sparc64/4.2-RELEASE
+
+ +

There are three FTP installation modes you can + use:

+ +
    +
  • +

    FTP: This method uses the standard ``Active'' + mode for transfers, in which the server initiates + a connection to the client. This will not work + through most firewalls but will often work best + with older FTP servers that do not support + passive mode. If your connection hangs with + passive mode, try this one.

    +
    • + +
  • +

    FTP Passive: This sets the FTP "Passive" mode + which prevents the server from opening + connections to the client. This option is best + for users to pass through firewalls that do not + allow incoming connections on random port + addresses.

    +
    • + +
  • +

    FTP via an HTTP proxy: This option instructs + FreeBSD to use HTTP to connect to a proxy for all + FTP operations. The proxy will translate the + requests and send them to the FTP server. This + allows the user to pass through firewalls that do + not allow FTP at all, but offer an HTTP proxy. + You must specify the hostname of the proxy in + addition to the FTP server.

    + +

    In the rare case that you have an FTP proxy + that does not go through HTTP, you can specify + the URL as something like:

    +
    +ftp://foo.bar.com:port/pub/FreeBSD
+
    + +

    In the URL above, port is the port + number of the proxy FTP server.

    +
    • +
+
+
+
+
+
+ +
+
+ +

1.6 + Question and Answer Section for UltraSPARC Architecture + Users

+
+
+ +
+
+ +

2 + Distribution Format

+ +

A typical FreeBSD distribution directory looks something + like this (exact details may vary depending on version, + architecture, and other factors):

+
+ERRATA.HTM      README.TXT      compat1x        dict            kernel
+ERRATA.TXT      RELNOTES.HTM    compat20        doc             manpages
+HARDWARE.HTM    RELNOTES.TXT    compat21        docbook.css     packages
+HARDWARE.TXT    base            compat22        filename.txt    ports
+INSTALL.HTM     boot            compat3x        floppies        proflibs
+INSTALL.TXT     catpages        compat4x        games           src
+README.HTM      cdrom.inf       crypto          info            tools
+
+ +

If you want to do a CDROM, FTP or NFS installation from + this distribution directory, all you need to do is make the + 1.44MB boot floppies from the floppies directory (see Section 1.3 for instructions on how to + do this), boot them and follow the instructions. The rest + of the data needed during the installation will be obtained + automatically based on your selections. If you've never + installed FreeBSD before, you also want to read the + entirety of this document (the installation instructions) + file.

+ +

If you're trying to do some other type of installation + or are merely curious about how a distribution is + organized, what follows is a more thorough description of + some of these items in more detail:

+ +
    +
  1. +

    The *.TXT and *.HTM files contain documentation + (for example, this document is contained in both INSTALL.TXT and INSTALL.HTM) and should be read + before starting an installation. The *.TXT files are plain text, while + the *.HTM files are HTML + files that can be read by almost any Web browser. Some + distributions may contain documentation in other + formats as well, such as PDF or PostScript.

    +
    2. + +
  2. +

    docbook.css is a Cascading + Style Sheet (CSS) file used by some Web browsers for + formatting the HTML documentation.

    +
    3. + +
  3. +

    The base, catpages, crypto, dict, doc, games, info, manpages, proflibs, and src directories contain the + primary distribution components of FreeBSD itself and + are split into smaller files for easy packing onto + floppies (should that be necessary).

    +
    4. + +
  4. +

    The compat1x, compat20, compat21, compat22, compat3x, and compat4x directories contain + distributions for compatibility with older releases and + are distributed as single gzip'd tar files - they can + be installed during release time or later by running + their install.sh scripts.

    +
    5. + +
  5. +

    The floppies/ subdirectory + contains the floppy installation images; further + information on using them can be found in Section 1.3.

    +
    6. + +
  6. +

    The packages and ports directories contain the + FreeBSD Packages and Ports Collections. Packages may be + installed from the packages directory by running the + command:

    +
    +#/stand/sysinstall configPackages
+
    + +

    Packages can also be installed by feeding individual + filenames in packages/ to the + + pkg_add(1) + command.

    + +

    The Ports Collection may be installed like any other + distribution and requires about 100MB unpacked. More + information on the ports collection may be obtained + from http://www.FreeBSD.org/ports/ or + locally from /usr/share/doc/handbook if you've + installed the doc + distribution.

    +
    7. + +
  7. +

    Last of all, the tools + directory contains various DOS tools for discovering + disk geometries, installing boot managers and the like. + It is purely optional and provided only for user + convenience.

    +
    8. +
+
+
+ +

A typical distribution directory (for example, the info distribution) looks like this + internally:

+
+CHECKSUM.MD5    info.ab         info.ad         info.inf        install.sh
+info.aa         info.ac         info.ae         info.mtree
+
+ +

The CHECKSUM.MD5 file contains + MD5 signatures for each file, should data corruption be + suspected, and is purely for reference. It is not used by + the actual installation and does not need to be copied with + the rest of the distribution files. The info.a* files are split, gzip'd tar + files, the contents of which can be viewed by doing:

+
+# cat info.a* | tar tvzf -
+
+ +

During installation, they are automatically concatenated + and extracted by the installation procedure.

+ +

The info.inf file is also + necessary since it is read by the installation program in + order to figure out how many pieces to look for when + fetching and concatenating the distribution. When putting + distributions onto floppies, the .inf file must occupy the first floppy of + each distribution set!

+ +

The info.mtree file is another + non-essential file which is provided for user reference. It + contains the MD5 signatures of the unpacked + distribution files and can be later used with the + mtree(8) program to + verify the installation permissions and checksums against + any possible modifications to the file. When used with the + base distribution, this can be an + excellent way of detecting trojan horse attacks on your + system.

+ +

Finally, the install.sh file + is for use by those who want to install the distribution + after installation time. To install the info distribution + from CDROM after a system was installed, for example, you'd + do:

+
+# cd /cdrom/info
+# sh install.sh
+
+
+ +
+
+ +

3 + Upgrading FreeBSD

+ +

These instructions describe a procedure for doing a + binary upgrade from an older version of FreeBSD.

+ +
+
+

Warning: While the FreeBSD upgrade procedure + does its best to safeguard against accidental loss of + data, it is still more than possible to wipe out your + entire disk with this installation! Please + do not accept the final confirmation request unless you + have adequately backed up any important data files.

+
+
+ +
+
+

Important: These notes assume that you are + using the version of + sysinstall(8) + supplied with the version of FreeBSD to which you + intend to upgrade. Using a mismatched version of + sysinstall(8) + is almost guaranteed to cause problems and has been + known to leave systems in an unusable state. The most + commonly made mistake in this regard is the use of an + old copy of + sysinstall(8) + from an existing installation to upgrade to a newer + version of FreeBSD. This is not recommended.

+
+
+ +
+
+

Warning: Binary upgrades to FreeBSD + 5.1-RELEASE from FreeBSD 4-STABLE are not supported at + this time. There are some files present in a FreeBSD + 4-STABLE whose presence can be disruptive, but are not + removed by a binary upgrade. One notable example is + that an old /usr/include/g++ + directory will cause C++ programs to compile + incorrectly (or not at all).

+ +

+ +

These upgrade instructions are provided for the use + of users upgrading from relatively recent FreeBSD + 5-CURRENT snapshots.

+
+
+ +
+
+ +

3.1 + Introduction

+ +

The upgrade procedure replaces distributions selected + by the user with those corresponding to the new FreeBSD + release. It preserves standard system configuration data, + as well as user data, installed packages and other + software.

+ +

Administrators contemplating an upgrade are encouraged + to study this section in its entirety before commencing + an upgrade. Failure to do so may result in a failed + upgrade or loss of data.

+ +
+
+ +

3.1.1 + Upgrade Overview

+ +

Upgrading of a distribution is performed by + extracting the new version of the component over the + top of the previous version. Files belonging to the old + distribution are not deleted.

+ +

System configuration is preserved by retaining and + restoring the previous version of the following + files:

+ +

Xaccel.ini, XF86Config, adduser.conf, aliases, aliases.db, amd.map, crontab, csh.cshrc, csh.login, csh.logout, cvsupfile, dhclient.conf, disktab, dm.conf, dumpdates, exports, fbtab, fstab, ftpusers, gettytab, gnats, group, hosts, hosts.allow, hosts.equiv, hosts.lpd, inetd.conf, localtime, login.access, login.conf, mail, mail.rc, make.conf, manpath.config, master.passwd, motd, namedb, networks, newsyslog.conf, nsmb.conf, nsswitch.conf, pam.conf, passwd, periodic, ppp, printcap, profile, pwd.db, rc.conf, rc.conf.local, rc.firewall, rc.local, remote, resolv.conf, rmt, sendmail.cf, sendmail.cw, services, shells, skeykeys, spwd.db, ssh, syslog.conf, ttys, uucp

+ +

The versions of these files which correspond to the + new version are moved to /etc/upgrade/. The system + administrator may peruse these new versions and merge + components as desired. Note that many of these files + are interdependent, and the best merge procedure is to + copy all site-specific data from the current files into + the new.

+ +

During the upgrade procedure, the administrator is + prompted for a location into which all files from /etc/ are saved. In the event + that local modifications have been made to other files, + they may be subsequently retrieved from this + location.

+
+
+ +
+
+ +

3.2 + Procedure

+ +

This section details the upgrade procedure. Particular + attention is given to items which substantially differ + from a normal installation.

+ +
+
+ +

3.2.1 + Backup

+ +

User data and system configuration should be backed + up before upgrading. While the upgrade procedure does + its best to prevent accidental mistakes, it is possible + to partially or completely destroy data and + configuration information.

+
+ +
+
+ +

3.2.2 + Mount Filesystems

+ +

The disklabel editor is entered with the nominated + disk's filesystem devices listed. Prior to commencing + the upgrade, the administrator should make a note of + the device names and corresponding mountpoints. These + mountpoints should be entered here. Do not + set the ``newfs flag'' for any filesystems, as this + will cause data loss.

+
+ +
+
+ +

3.2.3 + Select Distributions

+ +

When selecting distributions, there are no + constraints on which must be selected. As a general + rule, the base distribution + should be selected for an update, and the man distribution if manpages are + already installed. Other distributions may be selected + beyond those originally installed if the administrator + wishes to add additional functionality.

+
+ +
+
+ +

3.2.4 + After Installation

+ +

Once the installation procedure has completed, the + administrator is prompted to examine the new + configuration files. At this point, checks should be + made to ensure that the system configuration is valid. + In particular, the /etc/rc.conf and /etc/fstab files should be + checked.

+
+
+ +
+
+ +

3.3 + Upgrading from Source Code

+ +

Those interested in an upgrade method that allows more + flexibility and sophistication should take a look at The Cutting Edge in the FreeBSD + Handbook. This procedure involves rebuilding all of + FreeBSD from source code. It requires reliable network + connectivity, extra disk space, and time, but has + advantages for networks and other more complex + installations. This is roughly the same procedure as is + used for track the -STABLE or -CURRENT development + branches.

+ +

/usr/src/UPDATING contains + important information on updating a FreeBSD system from + source code. It lists various issues resulting from + changes in FreeBSD that may affect an upgrade.

+ +

+
+
+ +
+
+ +

4 + Troubleshooting

+ +
+

4.1 + Repairing an Existing FreeBSD Installation

+ +

FreeBSD features a ``Fixit'' option in the top menu of + the boot floppy. To use it, you will also need either a + fixit.flp image floppy, + generated in the same fashion as the boot floppy, or the + ``live filesystem'' CDROM; typically the second CDROM in + a multi-disc FreeBSD distribution.

+ +

To invoke fixit, simply boot the kern.flp floppy, choose the + ``Fixit'' item and insert the fixit floppy or CDROM when + asked. You will then be placed into a shell with a wide + variety of commands available (in the /stand and /mnt2/stand directories) for + checking, repairing and examining filesystems and their + contents. Some UNIX administration experience is + required to use the fixit option.

+
+ +
+
+ +

4.2 Common + Installation Problems for UltraSPARC Architecture + Users

+
+
+
+
+ +

This file, and other release-related + documents, can be downloaded from ftp://ftp.FreeBSD.org/pub/FreeBSD/development/sparc64/.

+ +

For questions about FreeBSD, read the + documentation + before contacting <questions@FreeBSD.org>.

+ +

All users of FreeBSD 5-CURRENT + should subscribe to the <current@FreeBSD.org> + mailing list.

+ +

For questions about this documentation, + e-mail <doc@FreeBSD.org>.

+
+
+ + + diff --git a/en/releases/5.1R/installation.sgml b/en/releases/5.1R/installation.sgml new file mode 100644 index 0000000000..82bf1e6233 --- /dev/null +++ b/en/releases/5.1R/installation.sgml @@ -0,0 +1,29 @@ + + + + %includes; +]> + + &header; + +

The installation notes for FreeBSD are customized for different + platforms, as the procedures for installing FreeBSD are highly + dependent on the hardware platform.

+ +

Installation notes for FreeBSD 5.1-RELEASE are available for the following + platforms:

+ + + +

A list of all platforms currently under development can be found + on the Supported + Platforms page.

+ + diff --git a/en/releases/5.1R/readme.html b/en/releases/5.1R/readme.html new file mode 100644 index 0000000000..498039c6f8 --- /dev/null +++ b/en/releases/5.1R/readme.html @@ -0,0 +1,540 @@ + + + + + FreeBSD 5.1-RELEASE README + + + + + +
+
+

FreeBSD + 5.1-RELEASE README

+ +

The FreeBSD Project

+ +

Copyright © 2000, 2001, 2002, + 2003 by The FreeBSD Documentation Project

+ +

$FreeBSD: + src/release/doc/en_US.ISO8859-1/readme/article.sgml,v 1.26 + 2003/05/06 20:01:07 bmah Exp $
+

+
+
+ +
+
+ + +

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.

+
+
+ +
+
+ +

1 + Introduction

+ +

This distribution is a release of FreeBSD 5.1-RELEASE, + the latest point along the 5-CURRENT branch.

+ +
+
+ +

1.1 About + FreeBSD

+ +

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.

+ +

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.

+ +

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 UNIX® 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 UNIX®. Most ports are also + available as pre-compiled ``packages'', which can be + quickly installed from the installation program.

+
+ +
+
+ +

1.2 Target + Audience

+ +

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.

+
+
+ +
+
+ +

2 Obtaining + FreeBSD

+ +

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.

+ +
+
+ +

2.1 CDROM + and DVD

+ +

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.

+ +

A list of the CDROM and DVD publishers known to the + project are listed in the ``Obtaining FreeBSD'' appendix to the + Handbook.

+
+ +
+
+ +

2.2 + FTP

+ +

You can use FTP to retrieve FreeBSD and any or all of + its optional packages from ftp://ftp.FreeBSD.org/, which is the + official FreeBSD release site, or any of its + ``mirrors''.

+ +

Lists of locations that mirror FreeBSD can be found in + the FTP Sites section of the Handbook, or + on the http://www.freebsdmirrors.org/ Web + pages. Finding a close (in networking terms) mirror from + which to download the distribution is highly + recommended.

+ +

Additional mirror sites are always welcome. Contact + + for more details on becoming an official mirror site. You + can also find useful information for mirror sites at the + Mirroring FreeBSD article.

+ +

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.

+
+
+ +
+
+ +

3 + Contacting the FreeBSD Project

+ +
+

3.1 Email + and Mailing Lists

+ +

For any questions or general technical support issues, + please send mail to the FreeBSD general questions mailing + list.

+ +

If you're tracking the 5-CURRENT development efforts, + you must join the FreeBSD-CURRENT mailing list, in order + to keep abreast of recent developments and changes that + may affect the way you use and maintain the system.

+ +

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 FreeBSD technical discussions mailing + list.

+ +

Please note that these mailing lists can experience + significant 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 FreeBSD announcements mailing + list.

+ +

All of the mailing lists can be freely joined by + anyone wishing to do so. Visit the FreeBSD Mailman Info Page. 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 mailing lists section of the FreeBSD + Web site.

+ +
+
+

Important: Do not send email to the + lists asking to be subscribed. Use the Mailman + interface instead.

+
+
+
+ +
+
+ +

3.2 + Submitting Problem Reports

+ +

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.

+ +

The preferred method to submit bug reports from a + machine with Internet mail connectivity is to use the + send-pr(1) + 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 list of all active PRs is available + on the FreeBSD Web site; this list is useful to see what + potential problems other users have encountered.

+ +

Note that + send-pr(1) 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 + send-pr(1) to + submit a bug report, you can try to send it to the FreeBSD problem reports mailing + list.

+ +

For more information, ``Writing FreeBSD Problem Reports'', + available on the FreeBSD Web site, has a number of + helpful hints on writing and submitting effective problem + reports.

+
+
+ +
+
+ +

4 Further + Reading

+ +

There are many sources of information about FreeBSD; + some are included with this distribution, while others are + available on-line or in print versions.

+ +
+
+ +

4.1 Release Documentation

+ +

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 (.TXT) + and HTML (.HTM) renditions. + Some distributions may also include other formats such as + PostScript (.PS) or Portable + Document Format (.PDF).

+ +
    +
  • +

    README.TXT: This file, + which gives some general information about FreeBSD as + well as some cursory notes about obtaining a + distribution.

    +
    • + +
  • +

    EARLY.TXT: A guide for + early adopters of FreeBSD 5.1-RELEASE. Highly + recommended reading for users new to FreeBSD + 5-CURRENT and/or the 5.X series of + releases.

    +
    • + +
  • +

    RELNOTES.TXT: The + release notes, showing what's new and different in + FreeBSD 5.1-RELEASE compared to the previous release + (FreeBSD 5.0-RELEASE).

    +
    • + +
  • +

    HARDWARE.TXT: The + hardware compatibility list, showing devices with + which FreeBSD has been tested and is known to + work.

    +
    • + +
  • +

    INSTALL.TXT: + Installation instructions for installing FreeBSD from + its distribution media.

    +
    • + +
  • +

    ERRATA.TXT: 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.

    +
    • +
+ +
+
+

Note: Several of these documents (in + particular, RELNOTES.TXT, + HARDWARE.TXT, and INSTALL.TXT) 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.

+
+
+
+
+ +

On platforms that support + sysinstall(8) + (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 + sysinstall(8) + utility.

+ +
+
+

Note: 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 http://www.FreeBSD.org/releases/ + (as well as any sites which keep up-to-date mirrors + of this location).

+
+
+
+ +
+
+ +

4.2 Manual + Pages

+ +

As with almost all UNIX®-like operating + systems, FreeBSD comes with a set of on-line manual + pages, accessed through the + man(1) command or + through the hypertext manual pages gateway on the + FreeBSD Web site. In general, the manual pages provide + information on the different commands and APIs available + to the FreeBSD user.

+ +

In some cases, manual pages are written to give + information on particular topics. Notable examples of + such manual pages are + tuning(7) (a + guide to performance tuning), + security(7) (an + introduction to FreeBSD security), and + style(9) (a style + guide to kernel coding).

+
+ +
+
+ +

4.3 Books + and Articles

+ +

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 Handbook and FAQ are always available from the FreeBSD Documentation page or its + mirrors. If you install the doc + distribution set, you can use a Web browser to read the + Handbook and FAQ locally.

+ +

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 doc distribution set.

+ +

A listing of other books and documents about FreeBSD + can be found in the bibliography of the FreeBSD Handbook. + Because of FreeBSD's strong UNIX® heritage, many other + articles and books written for UNIX® systems are applicable + as well, some of which are also listed in the + bibliography.

+
+
+ +
+
+ +

5 Acknowledgments

+ +

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 ``Contributors to FreeBSD'' on the + FreeBSD Web site or any of its mirrors.

+ +

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.

+
+
+
+ +

This file, and other release-related + documents, can be downloaded from ftp://ftp.FreeBSD.org/.

+ +

For questions about FreeBSD, read the + documentation + before contacting <questions@FreeBSD.org>.

+ +

All users of FreeBSD 5-CURRENT + should subscribe to the <current@FreeBSD.org> + mailing list.

+ +

For questions about this documentation, + e-mail <doc@FreeBSD.org>.

+
+
+ + + diff --git a/en/releases/5.1R/relnotes-alpha.html b/en/releases/5.1R/relnotes-alpha.html new file mode 100644 index 0000000000..cd45c619e4 --- /dev/null +++ b/en/releases/5.1R/relnotes-alpha.html @@ -0,0 +1,1563 @@ + + + + + FreeBSD/alpha 5.1-RELEASE Release Notes + + + + + +
+
+

FreeBSD/alpha + 5.1-RELEASE Release Notes

+ +

The FreeBSD Project

+ +

Copyright © 2000, 2001, 2002, + 2003 by The FreeBSD Documentation Project

+ +

$FreeBSD: + src/release/doc/en_US.ISO8859-1/relnotes/common/new.sgml,v + 1.573 2003/05/28 21:01:22 hrs Exp $
+

+ +
+
+ + +

The release notes for FreeBSD 5.1-RELEASE contain a + summary of recent changes made to the FreeBSD base + system on the 5-CURRENT development branch. This + document lists applicable security advisories that were + issued since the last release, as well as significant + changes to the FreeBSD kernel and userland. Some brief + remarks on upgrading are also presented.

+
+
+
+
+ +
+
+
Table of Contents
+ +
1 Introduction
+ +
2 What's New
+ +
+
+
2.1 Security + Advisories
+ +
2.2 Kernel Changes
+ +
+
+
2.2.1 Processor/Motherboard + Support
+ +
2.2.2 Boot Loader + Changes
+ +
2.2.3 Network Interface + Support
+ +
2.2.4 Network + Protocols
+ +
2.2.5 Disks and + Storage
+ +
2.2.6 File Systems
+ +
2.2.7 PCCARD + Support
+ +
2.2.8 Multimedia + Support
+
+
+ +
2.3 Userland Changes
+ +
2.4 Contributed + Software
+ +
2.5 Ports/Packages Collection + Infrastructure
+ +
2.6 Release Engineering and + Integration
+ +
2.7 Documentation
+
+
+ +
3 Upgrading from previous releases + of FreeBSD
+
+
+ +
+
+ +

1 + Introduction

+ +

This document contains the release notes for FreeBSD + 5.1-RELEASE on the Alpha/AXP hardware platform. It + describes recently added, changed, or deleted features of + FreeBSD. It also provides some notes on upgrading from + previous versions of FreeBSD.

+ +

This distribution of FreeBSD 5.1-RELEASE is a release + distribution. It can be found at ftp://ftp.FreeBSD.org/ or any of its + mirrors. More information on obtaining this (or other) + release distributions of FreeBSD can be found in the ``Obtaining FreeBSD'' appendix to the FreeBSD Handbook.

+ +

Users who are new to the 5-CURRENT series of FreeBSD + releases should also read the ``Early Adopters Guide to + FreeBSD 5.1-RELEASE''. This document can generally be found + in the same location as the release notes (either as a part + of a FreeBSD distribution or on the FreeBSD Web site). It + contains important information regarding the advantages and + disadvantages of using FreeBSD 5.1-RELEASE, as opposed to + releases based on the FreeBSD 4-STABLE development + branch.

+ +

All users are encouraged to consult the release errata + before installing FreeBSD. The errata document is updated + with ``late-breaking'' information discovered late in the + release cycle or after the release. Typically, it contains + information on known bugs, security advisories, and + corrections to documentation. An up-to-date copy of the + errata for FreeBSD 5.1-RELEASE can be found on the FreeBSD + Web site.

+
+ +
+
+ +

2 What's + New

+ +

This section describes many of the user-visible new or + changed features in FreeBSD since 5.0-RELEASE. It includes + items that are unique to the 5-CURRENT branch, as well as + some features that may have been recently merged to other + branches (after FreeBSD 5.0-RELEASE). The latter items are + marked as [MERGED].

+ +

Typical release note items document recent security + advisories issued after 5.0-RELEASE, new drivers or + hardware support, new commands or options, major bug fixes, + or contributed software upgrades. They may also list + changes to major ports/packages or release engineering + practices. Clearly the release notes cannot list every + single change made to FreeBSD between releases; this + document focuses primarily on security advisories, + user-visible changes, and major architectural + improvements.

+ +
+
+ +

2.1 + Security Advisories

+ +

A remotely exploitable vulnerability in CVS has been corrected with the + import of version 1.11.5. More details can be found in + security advisory FreeBSD-SA-03:01. [MERGED]

+ +

A timing-based attack on OpenSSL, which could allow a very + powerful attacker access to plaintext under certain + circumstances, has been prevented via an upgrade to OpenSSL 0.9.7. See security + advisory FreeBSD-SA-03:02 for more details. + [MERGED]

+ +

The security and performance of the ``syncookies'' + feature has been improved to decrease the chance of an + attacker being able to spoof connections. More details + are given in security advisory FreeBSD-SA-03:03. [MERGED]

+ +

Remotely-exploitable buffer overflow vulnerabilities + in sendmail have been fixed by + updating sendmail. For more + details, see security advisory FreeBSD-SA-03:04 and FreeBSD-SA-03:07. [MERGED]

+ +

A bounds-checking bug in the XDR implementation, which + could allow a remote attacker to cause a + denial-of-service, has been fixed. For more details see + security advisory FreeBSD-SA-03:05. [MERGED]

+ +

Two recently-publicized flaws in OpenSSL have been corrected. For + more details, see security advisory FreeBSD-SA-03:06. [MERGED]

+
+ +
+
+ +

2.2 Kernel + Changes

+ +

+ devfs(5) is now + mandatory; the NODEVFS option + has been removed from the set of possible kernel + configuration options.

+ +

A minor bug in the permissions handling of /dev/tty has been fixed. As a + result, + ssh(1) can now be + used after + su(1).

+ +

A bug that caused + fstat(2) to + return 0 as the number of bytes + available to read from a TCP socket has been fixed.

+ +

A bug that caused + kqueue(2) to + report 0 as the number of bytes + available to read from a TCP socket has been fixed. The + NOTE_LOWAT flag for EVFILT_READ has been fixed.

+ +

Linux emulation mode now supports IPv6.

+ +

+ madvise(2) now + supports a MADV_PROTECT + behavior, which informs the virtual memory system that a + process is critical and should not be killed when swap + space has been exhausted. The process must be owned by + the superuser.

+ +

A second process scheduler, designed to be a general + purpose scheduler with many SMP benefits, has been added + to the scheduler framework. Exactly one scheduler must be + specified in a kernel configuration. The original + scheduler may be selected using options SCHED_4BSD. The newer + (experimental) scheduler can be selected by using options SCHED_ULE.

+ +

Device major numbers are now allocated dynamically by + default. This change greatly decreases the need for a + static, centralized table of major number assignments to + device drivers (a few drivers retain their old static + major numbers for compatibility), and also reduces the + possibility of running out of device major numbers.

+ +
+
+ +

2.2.1 + Processor/Motherboard Support

+
+ +
+
+ +

2.2.2 Boot + Loader Changes

+ +

The alpha boot loader (boot1) can now be called boot for consistency with other + platforms.

+ +

The /modules directory + (once the default location for modules on FreeBSD 4.X) is no longer a part + of the default kern.module_path. Third-party + modules should be placed in /boot/modules.

+ +
+
+

Note: Modules designed for use with + FreeBSD 4.X are + likely to panic when loaded into a FreeBSD + 5.1-RELEASE kernel and should be used with extreme + caution.

+
+
+
+
+
+ +
+
+ +

2.2.3 + Network Interface Support

+ +

The cm driver now supports IPX. [MERGED]

+ +

A new + wlan(4) module + provides 802.11 link-layer support. The + wi(4) and + an(4) drivers + now use this facility.

+ +

A timing bug in the + xl(4) driver, + which could cause a kernel panic (or other problems) + when configuring an interface, has been fixed.

+
+ +
+
+ +

2.2.4 Network Protocols

+ +

+ ipfw(4) skipto rules can once again be + used with the log keyword. + ipfw(4) uid rules are once again + working.

+ +

It is now possible to build the FAST_IPSEC and INET6 options into the same + kernel. (They still cannot be used together, + however.)

+ +

A bug in TCP NewReno, which caused premature exit + from fast recovery when NewReno was enabled, has been + fixed. [MERGED]

+ +

TCP now has support for the ``Limited Transmit'' + mechanism proposed by RFC 3042. This feature is + intended to improve the effectiveness of TCP loss + recovery in certain circumstances. It is off by default + but can be enabled with the net.inet.tcp.rfc3042 sysctl + variable. More information can be found in + tcp(4).

+ +

TCP now has support for increased initial congestion + window sizes as described in RFC 3390. This feature can + improve the throughput of short transfers, as well as + high-bandwidth, large propagation-delay connections. It + is off by default but can be enabled with the net.inet.tcp.rfc3390 sysctl + variable. More information can be found in + tcp(4).

+ +

The IP fragment reassembly code behaves more + gracefully when receiving a large number of packet + fragments (it is designed to be more resistant to + fragment-based denial of service attacks). [MERGED]

+ +

TCP connections in the TIME_WAIT state now use a special + protocol control block that uses less space than a + full-blown TCP PCB. This allows some of the data + structures and resources used by such a connection to + be freed earlier.

+ +

It is now possible to specify the range of + ``privileged ports'' (TCP and UDP ports that require + superuser access to + bind(2) to). + The range is now specified with the net.inet.ip.portrange.reservedlow + and net.inet.ip.portrange.reservedhigh + sysctl variables, defaulting to the traditional UNIX + behavior. This feature is intended to help network + servers bind to traditionally privileged ports without + requiring superuser access. + ip(4) has more + details.

+ +

Some bugs in the non-blocking RPC code has been + fixed. As a result, + amd(8) users + are now able to mount volumes from a 5.1-RELEASE + server.

+ +

Support for XNS networking, which has not worked + correctly for almost seven years, has been removed.

+
+ +
+
+ +

2.2.5 + Disks and Storage

+ +

The + aac(4) driver + now runs free of the Giant kernel lock. This change has + given a nearly 20% performance speedup on an SMP system + running multiple I/O intensive loads.

+ +

The + ata(4) driver + now supports all known SiS chipsets. (More details can + be found in the Hardware Notes.)

+ +

The + ata(4) driver + now supports the Promise SATA150 TX2 and TX4 Serial + ATA/150 controllers.

+ +

The + ata(4) driver + now flushes devices on shutdown. This change may result + in failure messages being printed on the console for + devices that do not support flushing.

+ +

The CAM layer now has support for devices with more + than 232 blocks. (Assuming 512-byte blocks, + this means support for devices larger than 2TB.)

+ +
+
+

Note: For users upgrading across this + change, note that all userland applications that + talk to + pass(4) or + + xpt(4) + devices must be recompiled. Examples of such + programs are + camcontrol(8) + in the base system, the sysutils/cdrtools port, and + the multimedia/xmms + port.

+
+
+
+
+ +

A number of changes have been made to the + cd(4) driver. + The primary user-visible change is improved + compatibility with ATAPI/USB/Firewire CDROM drives.

+ +

+ geom(4) is now + mandatory; the NO_GEOM has + been removed from the set of kernel configuration + options.

+ +

The + iir(4) driver + has been updated; this update is believed to fix + problems detecting attached disks during + installation.

+ +

A bug in the + mly(4) driver + that caused hangs has been corrected.

+ +

Support has been added for volume labels on UFS and + UFS2 file systems. These labels are strings that can be + used to identify a volume, regardless of what device it + appears on. Labels can be set with the -L options to + newfs(8) or + tunefs(8). With + the GEOM_VOL module, volumes + can be accessed using their labels under /dev/vol.

+ +

The root file system can now be located on a + vinum(4) + volume. More information can be found in the + vinum(4) manual + page.

+
+ +
+
+ +

2.2.6 File + Systems

+ +

A new DIRECTIO kernel + option enables support for read operations that bypass + the buffer cache and put data directly into a userland + buffer. This feature requires that the O_DIRECT flag is set on the file + descriptor and that both the offset and length for the + read operation are multiples of the physical media + sector size. [MERGED]

+ +

NETNCP and Netware File System Support (nwfs) are + once again working.

+ +

Bugs that could cause the unmounting of a smbfs + share to fail or cause a kernel panic have been + fixed.

+
+ +
+
+ +

2.2.7 + PCCARD Support

+
+ +
+
+ +

2.2.8 Multimedia + Support

+
+
+ +
+
+ +

2.3 + Userland Changes

+ +

+ adduser(8) now + correctly handles setting user passwords containing + special shell characters.

+ +

+ adduser(8) now + supports a -g option to set a + user's default login group.

+ +

The + bsdlabel(8) + utility is a replacement for the older disklabel utility. + Like its predecessor, it installs, examines, or modifies + the BSD label on a disk partition, and can install + bootstrap code. Compared to disklabel, a number of + obsolete options and parameters have been retired. A new + -m option instructs + bsdlabel(8) to + use the layout suitable for a specific machine.

+ +

The compat4x distribution + now includes the libcrypto.so.2, libgmp.so.3, and libssl.so.2 libraries from FreeBSD + 4.7-RELEASE.

+ +

+ chgrp(1) and + chown(8) now, + when the owner/group is modified, print the old and new + uid/gid if the -v option is + specified more than once.

+ +

+ config(8) now + implements a nodevice kernel + configuration file directive that cancels the effect of a + device directive. The new nooption and nomakeoption directives cancel prior + options and makeoptions directives, + respectively.

+ +

The + diskinfo(8) + utility has been added to show information about a disk + device and optionally to run a naive performance + test.

+ +

The disklabel utility has been replaced by + bsdlabel(8). On + the alpha, i386, and pc98 platforms, disklabel is a link + to + bsdlabel(8).

+ +

+ dump(8) now + supports caching of disk blocks with the -C option. This can improve dump + performance at the cost of possibly missing file system + updates that occur between passes.

+ +

+ dumpfs(8) now + supports a -m flag to print file + system parameters in the form of a + newfs(8) + command.

+ +

+ elfdump(1), a + utility to display information about + elf(5) format + executable files, has been added.

+ +

+ fetch(1) uses the + .netrc support in + fetch(3) and also + supports a -N to specify an + alternate .netrc file.

+ +

+ fetch(3) now has + support for .netrc files (see + + ftp(1) for more + details).

+ +

+ ftpd(8) now + supports a -h option to disable + printing any host-specific information, such as the + ftpd(8) version + or hostname, in server messages. [MERGED]

+ +

+ ftpd(8) now + supports a -P option to specify a + port on which to listen in daemon mode. The default data + port number is now set to be one less than the control + port number, rather than being hard-coded. [MERGED]

+ +

+ ftpd(8) now + supports an extended format of the /etc/ftpchroot file. Please refer + to the + ftpchroot(5) + manpage, which is now available, for details. + [MERGED]

+ +

+ ftpd(8) now + supports login directory pathnames that specify + simultaneously a directory for + chroot(2) and + that to change to in the chrooted environment. The /./ separator is used for this + purpose, like in other FTP daemons having this feature. + It may be used in both + ftpchroot(5) and + + passwd(5). + [MERGED]

+ +

+ fwcontrol(8) now + supports -R and -S options for receiving and sending + DV streams. [MERGED]

+ +

The + gstat(8) utility + has been added to show the disk activity inside the + geom(4) + subsystem.

+ +

+ ipfw(8) now + supports enable and disable commands to control various + aspects of the operation of + ipfw(4) + (including enabling and disabling the firewall itself). + These provide a more convenient and visible interface + than the existing sysctl variables. [MERGED]

+ +

+ jail(8) now + supports a -i flag to output an + identifier for a newly-created jail.

+ +

The + jexec(8) utility + has been added to execute a command inside an existing + jail.

+ +

The + jls(8) utility + has been added to list existing jails.

+ +

+ kenv(1) has been + moved from /usr/bin to /bin to make it available at times + during system startup when only the root file system is + mounted.

+ +

+ killall(1) now + supports a -j option to kill all + processes inside a jail.

+ +

The + libgeom(3) + library has been added to allow some userland access to + the + geom(4) + subsystem.

+ +

The mac_portacl MAC policy module has been added. It + provides a simple ACL mechanism to permit users and + groups to bind ports for TCP or UDP, and is intended to + be used in conjunction with the recently-added net.inet.ip.portrange.reservedhigh + sysctl.

+ +

The MAKEDEV script is now + unnecessary, due to the mandatory presence of + devfs(5), and has + been removed.

+ +

+ mergemaster(8) + now supports a -P option to + preserve the contents of files being replaced.

+ +

+ mixer(8) can now + implement relative volume adjustments.

+ +

The + mksnap_ffs(8) + program has been added to allow easier creation of FFS + snapshots. It is a SUID-root + executable designed for use by members of the operator group.

+ +

+ mount(8) and + umount(8) now + accept a -F option to specify an + alternate + fstab(5) + file.

+ +

+ mount_nfs(8) now + supports a -c flag to avoid doing + a + connect(2) for + UDP mount points. This option must be used if the server + does not reply to requests from the standard NFS port + number 2049 or if it replies to requests using a + different IP address (which can occur if the server is + multi-homed). Setting the vfs.nfs.nfs_ip_paranoia sysctl to + 0 will make this option the + default. [MERGED]

+ +

+ mount_nfs(8) now + supports the noinet4 and noinet6 mount options to prevent NFS + mounts from using IPv4 or IPv6 respectively.

+ +

+ newfs(8) will now + create UFS2 file systems by default, unless UFS1 is + specifically requested with the -O1 option.

+ +

+ newsyslog(8) has + a number of new features. Among them:

+ +
    +
  • +

    A W flag forces + previously-started compression jobs for an entry (or + group of entries specified with the G flag) to finish before + beginning a new one. This feature is designed to + prevent system overloads caused by starting several + compression jobs on big files simultaneously. + [MERGED]

    +
    • + +
  • +

    A ``default rotate action'', to be used for files + specified for rotation but not specified in the + configuration file. [MERGED]

    +
    • + +
  • +

    A -s command-line flag to + disable sending signals to processes when rotating + files. [MERGED]

    +
    • + +
  • +

    A N configuration file + flag to indicate that no process needs to be signaled + when rotating a file. [MERGED]

    +
    • + +
  • +

    A U configuration file + flag to specify that a process group (rather than a + single process) should be signaled when rotating + files. [MERGED]

    +
    • +
+
+
+ +

+ nsdispatch(3) is + now thread-safe and implements support for Name Service + Switch (NSS) modules. NSS modules may be statically built + into libc or dynamically loaded + via + dlopen(3). They + are loaded/initialized at configuration time (i.e. when + + nsdispatch(3) is + called and + nsswitch.conf(5) + is read or re-read).

+ +

A new + pam_chroot(8) + module has been added, which does a + chroot(2) + operation for users into either a predetermined directory + or one derived from their home directory.

+ +

+ pam_ssh(8) has + been rewritten. One side effect of the rewrite is that it + now starts a separate instance of + ssh-agent(1) for + each session instead of trying to connect each session to + the agent started by the first session.

+ +

+ ping(8) now + supports a -D flag to set the + ``Don't Fragment'' bit on outgoing packets.

+ +

+ ping(8) now + supports a -M option to use ICMP + mask request or timestamp request messages instead of + ICMP echo requests.

+ +

+ ping(8) now + supports a -z flag to set the + Type of Service bits in outgoing packets.

+ +

+ pw(8) can now add + a user whose name ends with a $ + character; this change is intended to help administration + of Samba services. + [MERGED]

+ +

The format of the /etc/pwd.db and /etc/spwd.db password databases + created by + pwd_mkdb(8) is + now byte-order independent. The pre-processed password + databases can now be moved between machines of different + architectures. The format includes version numbers on + entries to ensure compatibility with old binaries.

+ +

A bug in + rand(3) that + could cause a sequence to remain stuck at 0 has been fixed. ( + rand(3) remains + unsuitable for all but trivial uses.)

+ +

+ rtld(1) now has + support for the dynamic mapping of shared object + dependencies. This optional feature is especially useful + when experimenting with different threading libraries. It + is not, however, built by default. More information on + enabling and using this feature can be found in + libmap.conf(5).

+ +

+ sem_open(3) now + correctly handles multiple opens of the same semaphore; + as a result, + sem_close(3) no + longer crashes calling programs.

+ +

The seeding algorithm used by + srandom(3) has + been strengthened.

+ +

+ sysinstall(8) + will now select UFS2 as the default layout for new file + systems unless specifically requested in the disk + labeler.

+ +

The + swapoff(8) + command has been added to disable paging and swapping on + a device. A related + swapctl(8) + command has been added to provide an interface to + swapon(8) and + swapoff(8) + similar to other BSDs.

+ +
+
+

Note: The + swapoff(8) + feature should be considered experimental.

+
+
+
+
+ +

+ syslogd(8) now + allows multiple hosts or programs to be named in host or + program specifications in + syslog.conf(5) + files.

+ +

+ systat(1) now + includes an -ifstat display mode + that displays the network traffic going through active + interfaces on the system.

+ +

The + usbhidaction(1) + command has been added; it performs actions according to + its configuration in response to USB HID controls.

+ +

+ uudecode(1) and + + b64decode(1) now + support a -r flag for decoding + raw (or broken) files that may be missing the initial and + possibly final framing lines. [MERGED]

+ +

+ vmstat(8) has + re-implemented the -f flag, which + displays statistics on fork operations.

+ +

+ xargs(1) now + supports a -P option to execute + multiple copies of the same utility in parallel.

+ +

+ xargs(1) now + supports a -o flag to reopen /dev/tty for the child process + before executing the command. This is useful when the + child process is an interactive application.

+ +

The historic BSD boot scripts in /etc have been removed, in favor of + the rc.d system imported from + NetBSD (sometimes referred to + as ``rcNG''). All functionality of the historic system + has been preserved. In particular, files such as /etc/rc.conf continue to be the + recommended means of configuring the system startup. The + rc.d system has been the + default since FreeBSD 5.0-RELEASE, so this change should + be largely transparent for the vast majority of users. + Users who have customized their historic-style startup + scripts should be aware that the following files have + been removed from /etc: rc.atm, rc.devfs, rc.diskless1, rc.diskless2, rc.i386, rc.alpha, rc.amd64, rc.ia64, rc.sparc64, rc.isdn, rc.network, rc.network6, rc.pccard, rc.serial, rc.syscons, rc.sysctl. + mergemaster(8), + when run, will offer to move these files out of the way + for convenience. More details can be found in + rc.subr(8).

+
+ +
+
+ +

2.4 + Contributed Software

+ +

The ACPI-CA code has been + updated from the 20021118 snapshot to the 20030228 + snapshot.

+ +

awk from Bell Labs has been + updated to a 14 March 2003 snapshot.

+ +

BIND has been updated to + version 8.3.4. [MERGED]

+ +

All of the bzip2 suite of + applications is now installed in the base system (in + particular, bzip2recover is now + built and installed). [MERGED]

+ +

CVS has been updated to + 1.11.5. [MERGED]

+ +

FILE has been updated to + 3.41. [MERGED]

+ +

GCC has been updated to + 3.2.2 (release version).

+ +

The gdtoa library, for + conversions between strings and floating point, has been + imported. These sources were dated 24 March 2003.

+ +

groff (and related + utilities) have been updated from 1.18.1 to 1.19.

+ +

IPFilter has been updated + to 3.4.31. [MERGED]

+ +

The ISC DHCP client has + been updated to 3.0.1RC11. [MERGED]

+ +

The ISC DHCP client now + includes the + omshell(1) + utility and the + dhcpctl(3) + library for run-time control of the client.

+ +

Kerberos IV support (in the + form of KTH eBones) has been + removed. Users requiring this functionality can still get + it from the security/krb4 port + (or package). Kerberos IV compatibility mode for Kerberos + 5 has been removed, and the k5program userland + utilities have been renamed to kprogram.

+ +

Kerberos 5 is now built by + default in buildworld + operations. Setting MAKE_KERBEROS5 no longer has any + effect. Disabling the base system Kerberos 5 now requires + the NO_KERBEROS Makefile + variable to be set.

+ +

libpcap now has support for + selecting among multiple data link types on an + interface.

+ +

lukemftpd (not built or + installed by default) has been updated to a snapshot from + 22 January 2003.

+ +

OpenPAM has been updated + from the ``Citronella'' release to the ``Dianthus'' + release.

+ +

OpenSSH has been updated to + 3.6.1p1.

+ +

OpenSSL has been updated to + release 0.9.7a. Among other features, this release + includes support for AES and takes advantage of + crypto(4) + devices. [MERGED]

+ +

sendmail has been updated + to version 8.12.9. [MERGED]

+ +

+ tcpdump(1) has + been updated to version 3.7.2. [MERGED] It also now + supports a -L flag to list the + data link types available on an interface and a -y option to specify the data link + type to use while capturing packets.

+ +

texinfo has been updated + from 4.2 to 4.5.

+ +

The timezone database has been updated from tzdata2002d to tzdata2003a. [MERGED]

+
+ +
+
+ +

2.5 + Ports/Packages Collection Infrastructure

+ +

The one-line pkg-comment + files have been eliminated from each port skeleton; their + contents have been moved into each port's Makefile. This change reduces the + disk space and inodes used by the ports tree. + [MERGED]

+ +

When fetching distfiles for building a port, the FETCH_REGET Makefile variable can be used to + specify the number of times to try continuing to fetch a + distfile if it fails its MD5 checksum. The port + infrastructure also supports re-fetching interrupted + distfiles.

+ +

+ pkg_create(1) now + supports a -C option, which + allows packages to register a list of other packages with + which they conflict. They will refuse to install (via + pkg_add(1)) if + one of the listed packages is already present. The -f flag to + pkg_add(1) + overrides this conflict-checking.

+ +

+ pkg_info(1) now + honors the BLOCKSIZE environment + variable in its output when the -b flag is given.

+ +

+ pkg_info(1) now + implements a -Q option, which is + similar to the -q ``quiet'' + option except that it prefixes the output with the + package name.

+
+ +
+
+ +

2.6 + Release Engineering and Integration

+ +

The supported release of GNOME has been updated to 2.2.1. + [MERGED]

+ +

The supported release of KDE has been updated to 3.1.2. + [MERGED]

+ +

There is no longer a separate krb5 distribution. The Kerberos 5 + libraries and utilities have been incorporated into the + crypto distribution.

+ +

+ sysinstall(8) + once again supports installing individual components of + XFree86. Supporting changes + (not user-visible) generalize the concept of installing + parts of distributions as packages.

+ +

The supported release of XFree86 has been updated to + 4.3.0. [MERGED]

+ +

Several upgrade mechanisms designed to permit major + version upgrades from FreeBSD 2.X to 3.X and from FreeBSD 3.X to 4.X have been removed.

+
+ +
+
+ +

2.7 + Documentation

+ +

The following new articles have been added to the + documentation set: ``FreeBSD From Scratch'', ``The + Roadmap for 5-STABLE''.

+ +

A new Danish (da_DK.ISO8859-1) translation + project has been started.

+
+
+ +
+
+ +

3 + Upgrading from previous releases of FreeBSD

+ +

Users with existing FreeBSD systems are highly + encouraged to read the ``Early Adopter's Guide to FreeBSD + 5.1-RELEASE''. This document generally has the filename EARLY.TXT on the distribution media, + or any other place that the release notes can be found. It + offers some notes on upgrading, but more importantly, also + discusses some of the relative merits of upgrading to + FreeBSD 5.X versus + running FreeBSD 4.X.

+ +
+
+

Important: Upgrading FreeBSD should, of + course, only be attempted after backing up all + data and configuration files.

+
+
+
+
+
+ +

This file, and other release-related + documents, can be downloaded from ftp://ftp.FreeBSD.org/.

+ +

For questions about FreeBSD, read the + documentation + before contacting <questions@FreeBSD.org>.

+ +

All users of FreeBSD 5-CURRENT + should subscribe to the <current@FreeBSD.org> + mailing list.

+ +

For questions about this documentation, + e-mail <doc@FreeBSD.org>.

+
+
+ + + diff --git a/en/releases/5.1R/relnotes-i386.html b/en/releases/5.1R/relnotes-i386.html new file mode 100644 index 0000000000..4cb9c05fef --- /dev/null +++ b/en/releases/5.1R/relnotes-i386.html @@ -0,0 +1,1740 @@ + + + + + FreeBSD/i386 5.1-RELEASE Release Notes + + + + + +
+
+

FreeBSD/i386 + 5.1-RELEASE Release Notes

+ +

The FreeBSD Project

+ +

Copyright © 2000, 2001, 2002, + 2003 by The FreeBSD Documentation Project

+ +

$FreeBSD: + src/release/doc/en_US.ISO8859-1/relnotes/common/new.sgml,v + 1.573 2003/05/28 21:01:22 hrs Exp $
+

+ +
+
+ + +

The release notes for FreeBSD 5.1-RELEASE contain a + summary of recent changes made to the FreeBSD base + system on the 5-CURRENT development branch. This + document lists applicable security advisories that were + issued since the last release, as well as significant + changes to the FreeBSD kernel and userland. Some brief + remarks on upgrading are also presented.

+
+
+
+
+ +
+
+
Table of Contents
+ +
1 Introduction
+ +
2 What's New
+ +
+
+
2.1 Security + Advisories
+ +
2.2 Kernel Changes
+ +
+
+
2.2.1 Processor/Motherboard + Support
+ +
2.2.2 Boot Loader + Changes
+ +
2.2.3 Network Interface + Support
+ +
2.2.4 Network + Protocols
+ +
2.2.5 Disks and + Storage
+ +
2.2.6 File Systems
+ +
2.2.7 PCCARD + Support
+ +
2.2.8 Multimedia + Support
+
+
+ +
2.3 Userland Changes
+ +
2.4 Contributed + Software
+ +
2.5 Ports/Packages Collection + Infrastructure
+ +
2.6 Release Engineering and + Integration
+ +
2.7 Documentation
+
+
+ +
3 Upgrading from previous releases + of FreeBSD
+
+
+ +
+
+ +

1 + Introduction

+ +

This document contains the release notes for FreeBSD + 5.1-RELEASE on the i386 hardware platform. It describes + recently added, changed, or deleted features of FreeBSD. It + also provides some notes on upgrading from previous + versions of FreeBSD.

+ +

This distribution of FreeBSD 5.1-RELEASE is a release + distribution. It can be found at ftp://ftp.FreeBSD.org/ or any of its + mirrors. More information on obtaining this (or other) + release distributions of FreeBSD can be found in the ``Obtaining FreeBSD'' appendix to the FreeBSD Handbook.

+ +

Users who are new to the 5-CURRENT series of FreeBSD + releases should also read the ``Early Adopters Guide to + FreeBSD 5.1-RELEASE''. This document can generally be found + in the same location as the release notes (either as a part + of a FreeBSD distribution or on the FreeBSD Web site). It + contains important information regarding the advantages and + disadvantages of using FreeBSD 5.1-RELEASE, as opposed to + releases based on the FreeBSD 4-STABLE development + branch.

+ +

All users are encouraged to consult the release errata + before installing FreeBSD. The errata document is updated + with ``late-breaking'' information discovered late in the + release cycle or after the release. Typically, it contains + information on known bugs, security advisories, and + corrections to documentation. An up-to-date copy of the + errata for FreeBSD 5.1-RELEASE can be found on the FreeBSD + Web site.

+
+ +
+
+ +

2 What's + New

+ +

This section describes many of the user-visible new or + changed features in FreeBSD since 5.0-RELEASE. It includes + items that are unique to the 5-CURRENT branch, as well as + some features that may have been recently merged to other + branches (after FreeBSD 5.0-RELEASE). The latter items are + marked as [MERGED].

+ +

Typical release note items document recent security + advisories issued after 5.0-RELEASE, new drivers or + hardware support, new commands or options, major bug fixes, + or contributed software upgrades. They may also list + changes to major ports/packages or release engineering + practices. Clearly the release notes cannot list every + single change made to FreeBSD between releases; this + document focuses primarily on security advisories, + user-visible changes, and major architectural + improvements.

+ +
+
+ +

2.1 + Security Advisories

+ +

A remotely exploitable vulnerability in CVS has been corrected with the + import of version 1.11.5. More details can be found in + security advisory FreeBSD-SA-03:01. [MERGED]

+ +

A timing-based attack on OpenSSL, which could allow a very + powerful attacker access to plaintext under certain + circumstances, has been prevented via an upgrade to OpenSSL 0.9.7. See security + advisory FreeBSD-SA-03:02 for more details. + [MERGED]

+ +

The security and performance of the ``syncookies'' + feature has been improved to decrease the chance of an + attacker being able to spoof connections. More details + are given in security advisory FreeBSD-SA-03:03. [MERGED]

+ +

Remotely-exploitable buffer overflow vulnerabilities + in sendmail have been fixed by + updating sendmail. For more + details, see security advisory FreeBSD-SA-03:04 and FreeBSD-SA-03:07. [MERGED]

+ +

A bounds-checking bug in the XDR implementation, which + could allow a remote attacker to cause a + denial-of-service, has been fixed. For more details see + security advisory FreeBSD-SA-03:05. [MERGED]

+ +

Two recently-publicized flaws in OpenSSL have been corrected. For + more details, see security advisory FreeBSD-SA-03:06. [MERGED]

+
+ +
+
+ +

2.2 Kernel + Changes

+ +

+ devfs(5) is now + mandatory; the NODEVFS option + has been removed from the set of possible kernel + configuration options.

+ +

An + ehci(4) driver + has been added; it supports the USB Enhanced Host + Controller Interface used by USB 2.0 controllers.

+ +

A minor bug in the permissions handling of /dev/tty has been fixed. As a + result, + ssh(1) can now be + used after + su(1).

+ +

A bug that caused + fstat(2) to + return 0 as the number of bytes + available to read from a TCP socket has been fixed.

+ +

A bug that caused + kqueue(2) to + report 0 as the number of bytes + available to read from a TCP socket has been fixed. The + NOTE_LOWAT flag for EVFILT_READ has been fixed.

+ +

Linux emulation mode now supports IPv6.

+ +

+ madvise(2) now + supports a MADV_PROTECT + behavior, which informs the virtual memory system that a + process is critical and should not be killed when swap + space has been exhausted. The process must be owned by + the superuser.

+ +

The tw driver for TW-523 power line interfaces (used + by X-10 home control products) has been removed. It is + currently non-functional, and would require a + considerable amount of work to make it work under + 5-CURRENT. The xten and xtend userland control programs + have also been removed.

+ +

A second process scheduler, designed to be a general + purpose scheduler with many SMP benefits, has been added + to the scheduler framework. Exactly one scheduler must be + specified in a kernel configuration. The original + scheduler may be selected using options SCHED_4BSD. The newer + (experimental) scheduler can be selected by using options SCHED_ULE.

+ +

Device major numbers are now allocated dynamically by + default. This change greatly decreases the need for a + static, centralized table of major number assignments to + device drivers (a few drivers retain their old static + major numbers for compatibility), and also reduces the + possibility of running out of device major numbers.

+ +

A partial lazy switch mechanism for in-kernel threads + has been implemented; it is designed to reduce the + overhead of short context switches (such as for interrupt + handlers) that do not involve another process. This + feature can be enabled with options LAZY_SWITCH.

+ +
+
+ +

2.2.1 + Processor/Motherboard Support

+ +

SMP kernels now have + rudimentary support for HyperThreading (HTT). The + scheduler treats the logical CPUs as if they were + additional physical CPUs. This can actually cause + suboptimal performance in some cases due to contention + for resources. Therefore, logical CPUs are halted by + default at startup. They can be enabled with the machdep.hlt_logical_cpus sysctl + variable. It is also possible to halt any CPU in the + idle loop with the machdep.hlt_cpus sysctl variable. + The + smp(4) manual + page has more details.

+ +
+
+

Note: Some other versions of FreeBSD, + including early 5.0-CURRENT snapshots and + 4.8-RELEASE, used options HTT to enable + HyperThreading support at kernel configuration + time. This option is no longer necessary.

+
+
+
+
+ +

Support for the Physical Address Extensions (PAE) + capability on Intel Pentium Pro and higher processors + has been added. This allows the use of up to 64GB of + RAM in a machine, although the amount of memory usable + by any single process (or the FreeBSD kernel) is + unchanged. For more information, see the + pae(4) manual + page. Work on this feature was sponsored by DARPA and + Network Associates Laboratories.

+ +

A new + vpd(4) driver + has been added to read hardware information from the + Vital Product Data structure on IBM ThinkPad + machines.

+
+ +
+
+ +

2.2.2 Boot + Loader Changes

+ +

The two parts of the boot loader (boot1 and boot2) have been combined into a + single boot file, to simplify + programs that need to write or otherwise manipulate the + boot loader.

+ +

The /modules directory + (once the default location for modules on FreeBSD 4.X) is no longer a part + of the default kern.module_path. Third-party + modules should be placed in /boot/modules.

+ +
+
+

Note: Modules designed for use with + FreeBSD 4.X are + likely to panic when loaded into a FreeBSD + 5.1-RELEASE kernel and should be used with extreme + caution.

+
+
+
+
+ +

Due to code size limitations, the i386 boot loader + can only load kernels from root file systems that are + 1.5TB or smaller in size.

+
+ +
+
+ +

2.2.3 + Network Interface Support

+ +

A new + axe(4) network + driver has been added. It provides support for USB + Ethernet adapters based on the ASIX Electronics AX88172 + USB 2.0 chipset.

+ +

The cm driver now supports IPX. [MERGED]

+ +

The + rue(4) network + driver has been added, providing support for Ethernet + adapters based on the RealTek RTL8150 USB to Fast + Ethernet controller chip.

+ +

The + sbsh(4) driver + for the Granch SBNI16 SHDSL modem has been added. + [MERGED]

+ +

A new + wlan(4) module + provides 802.11 link-layer support. The + wi(4) and + an(4) drivers + now use this facility.

+ +

A timing bug in the + xl(4) driver, + which could cause a kernel panic (or other problems) + when configuring an interface, has been fixed.

+
+ +
+
+ +

2.2.4 Network Protocols

+ +

+ ipfw(4) skipto rules can once again be + used with the log keyword. + ipfw(4) uid rules are once again + working.

+ +

It is now possible to build the FAST_IPSEC and INET6 options into the same + kernel. (They still cannot be used together, + however.)

+ +

A bug in TCP NewReno, which caused premature exit + from fast recovery when NewReno was enabled, has been + fixed. [MERGED]

+ +

TCP now has support for the ``Limited Transmit'' + mechanism proposed by RFC 3042. This feature is + intended to improve the effectiveness of TCP loss + recovery in certain circumstances. It is off by default + but can be enabled with the net.inet.tcp.rfc3042 sysctl + variable. More information can be found in + tcp(4).

+ +

TCP now has support for increased initial congestion + window sizes as described in RFC 3390. This feature can + improve the throughput of short transfers, as well as + high-bandwidth, large propagation-delay connections. It + is off by default but can be enabled with the net.inet.tcp.rfc3390 sysctl + variable. More information can be found in + tcp(4).

+ +

The IP fragment reassembly code behaves more + gracefully when receiving a large number of packet + fragments (it is designed to be more resistant to + fragment-based denial of service attacks). [MERGED]

+ +

TCP connections in the TIME_WAIT state now use a special + protocol control block that uses less space than a + full-blown TCP PCB. This allows some of the data + structures and resources used by such a connection to + be freed earlier.

+ +

It is now possible to specify the range of + ``privileged ports'' (TCP and UDP ports that require + superuser access to + bind(2) to). + The range is now specified with the net.inet.ip.portrange.reservedlow + and net.inet.ip.portrange.reservedhigh + sysctl variables, defaulting to the traditional UNIX + behavior. This feature is intended to help network + servers bind to traditionally privileged ports without + requiring superuser access. + ip(4) has more + details.

+ +

Some bugs in the non-blocking RPC code has been + fixed. As a result, + amd(8) users + are now able to mount volumes from a 5.1-RELEASE + server.

+ +

Support for XNS networking, which has not worked + correctly for almost seven years, has been removed.

+
+ +
+
+ +

2.2.5 + Disks and Storage

+ +

The + aac(4) driver + now runs free of the Giant kernel lock. This change has + given a nearly 20% performance speedup on an SMP system + running multiple I/O intensive loads.

+ +

The + ata(4) driver + now supports all known SiS chipsets. (More details can + be found in the Hardware Notes.)

+ +

The + ata(4) driver + now supports the Promise SATA150 TX2 and TX4 Serial + ATA/150 controllers.

+ +

The + ata(4) driver + now flushes devices on shutdown. This change may result + in failure messages being printed on the console for + devices that do not support flushing.

+ +

The CAM layer now has support for devices with more + than 232 blocks. (Assuming 512-byte blocks, + this means support for devices larger than 2TB.)

+ +
+
+

Note: For users upgrading across this + change, note that all userland applications that + talk to + pass(4) or + + xpt(4) + devices must be recompiled. Examples of such + programs are + camcontrol(8) + in the base system, the sysutils/cdrtools port, and + the multimedia/xmms + port.

+
+
+
+
+ +

A number of changes have been made to the + cd(4) driver. + The primary user-visible change is improved + compatibility with ATAPI/USB/Firewire CDROM drives.

+ +

+ geom(4) is now + mandatory; the NO_GEOM has + been removed from the set of kernel configuration + options.

+ +

The + iir(4) driver + has been updated; this update is believed to fix + problems detecting attached disks during + installation.

+ +

The ips driver, which supports the IBM (now Adaptec) + ServeRAID series, has been added.

+ +

A bug in the + mly(4) driver + that caused hangs has been corrected.

+ +

Support has been added for volume labels on UFS and + UFS2 file systems. These labels are strings that can be + used to identify a volume, regardless of what device it + appears on. Labels can be set with the -L options to + newfs(8) or + tunefs(8). With + the GEOM_VOL module, volumes + can be accessed using their labels under /dev/vol.

+ +

The root file system can now be located on a + vinum(4) + volume. More information can be found in the + vinum(4) manual + page.

+
+ +
+
+ +

2.2.6 File + Systems

+ +

A new DIRECTIO kernel + option enables support for read operations that bypass + the buffer cache and put data directly into a userland + buffer. This feature requires that the O_DIRECT flag is set on the file + descriptor and that both the offset and length for the + read operation are multiples of the physical media + sector size. [MERGED]

+ +

NETNCP and Netware File System Support (nwfs) are + once again working.

+ +

Bugs that could cause the unmounting of a smbfs + share to fail or cause a kernel panic have been + fixed.

+
+ +
+
+ +

2.2.7 + PCCARD Support

+
+ +
+
+ +

2.2.8 Multimedia + Support

+ +

The atspeaker.ko and pcspeaker.ko modules for the + speaker(4) + device have been renamed speaker.ko.

+
+
+ +
+
+ +

2.3 + Userland Changes

+ +

+ adduser(8) now + correctly handles setting user passwords containing + special shell characters.

+ +

+ adduser(8) now + supports a -g option to set a + user's default login group.

+ +

The + bsdlabel(8) + utility is a replacement for the older disklabel utility. + Like its predecessor, it installs, examines, or modifies + the BSD label on a disk partition, and can install + bootstrap code. Compared to disklabel, a number of + obsolete options and parameters have been retired. A new + -m option instructs + bsdlabel(8) to + use the layout suitable for a specific machine.

+ +

The compat4x distribution + now includes the libcrypto.so.2, libgmp.so.3, and libssl.so.2 libraries from FreeBSD + 4.7-RELEASE.

+ +

+ chgrp(1) and + chown(8) now, + when the owner/group is modified, print the old and new + uid/gid if the -v option is + specified more than once.

+ +

+ config(8) now + implements a nodevice kernel + configuration file directive that cancels the effect of a + device directive. The new nooption and nomakeoption directives cancel prior + options and makeoptions directives, + respectively.

+ +

The + diskinfo(8) + utility has been added to show information about a disk + device and optionally to run a naive performance + test.

+ +

The disklabel utility has been replaced by + bsdlabel(8). On + the alpha, i386, and pc98 platforms, disklabel is a link + to + bsdlabel(8).

+ +

+ dump(8) now + supports caching of disk blocks with the -C option. This can improve dump + performance at the cost of possibly missing file system + updates that occur between passes.

+ +

+ dumpfs(8) now + supports a -m flag to print file + system parameters in the form of a + newfs(8) + command.

+ +

+ elfdump(1), a + utility to display information about + elf(5) format + executable files, has been added.

+ +

+ fetch(1) uses the + .netrc support in + fetch(3) and also + supports a -N to specify an + alternate .netrc file.

+ +

+ fetch(3) now has + support for .netrc files (see + + ftp(1) for more + details).

+ +

+ ftpd(8) now + supports a -h option to disable + printing any host-specific information, such as the + ftpd(8) version + or hostname, in server messages. [MERGED]

+ +

+ ftpd(8) now + supports a -P option to specify a + port on which to listen in daemon mode. The default data + port number is now set to be one less than the control + port number, rather than being hard-coded. [MERGED]

+ +

+ ftpd(8) now + supports an extended format of the /etc/ftpchroot file. Please refer + to the + ftpchroot(5) + manpage, which is now available, for details. + [MERGED]

+ +

+ ftpd(8) now + supports login directory pathnames that specify + simultaneously a directory for + chroot(2) and + that to change to in the chrooted environment. The /./ separator is used for this + purpose, like in other FTP daemons having this feature. + It may be used in both + ftpchroot(5) and + + passwd(5). + [MERGED]

+ +

+ fwcontrol(8) now + supports -R and -S options for receiving and sending + DV streams. [MERGED]

+ +

The + gstat(8) utility + has been added to show the disk activity inside the + geom(4) + subsystem.

+ +

+ ipfw(8) now + supports enable and disable commands to control various + aspects of the operation of + ipfw(4) + (including enabling and disabling the firewall itself). + These provide a more convenient and visible interface + than the existing sysctl variables. [MERGED]

+ +

+ jail(8) now + supports a -i flag to output an + identifier for a newly-created jail.

+ +

The + jexec(8) utility + has been added to execute a command inside an existing + jail.

+ +

The + jls(8) utility + has been added to list existing jails.

+ +

+ kenv(1) has been + moved from /usr/bin to /bin to make it available at times + during system startup when only the root file system is + mounted.

+ +

+ killall(1) now + supports a -j option to kill all + processes inside a jail.

+ +

The + libgeom(3) + library has been added to allow some userland access to + the + geom(4) + subsystem.

+ +

The mac_portacl MAC policy module has been added. It + provides a simple ACL mechanism to permit users and + groups to bind ports for TCP or UDP, and is intended to + be used in conjunction with the recently-added net.inet.ip.portrange.reservedhigh + sysctl.

+ +

The MAKEDEV script is now + unnecessary, due to the mandatory presence of + devfs(5), and has + been removed.

+ +

+ mergemaster(8) + now supports a -P option to + preserve the contents of files being replaced.

+ +

+ mixer(8) can now + implement relative volume adjustments.

+ +

The + mksnap_ffs(8) + program has been added to allow easier creation of FFS + snapshots. It is a SUID-root + executable designed for use by members of the operator group.

+ +

+ mount(8) and + umount(8) now + accept a -F option to specify an + alternate + fstab(5) + file.

+ +

+ mount_nfs(8) now + supports a -c flag to avoid doing + a + connect(2) for + UDP mount points. This option must be used if the server + does not reply to requests from the standard NFS port + number 2049 or if it replies to requests using a + different IP address (which can occur if the server is + multi-homed). Setting the vfs.nfs.nfs_ip_paranoia sysctl to + 0 will make this option the + default. [MERGED]

+ +

+ mount_nfs(8) now + supports the noinet4 and noinet6 mount options to prevent NFS + mounts from using IPv4 or IPv6 respectively.

+ +

+ newfs(8) will now + create UFS2 file systems by default, unless UFS1 is + specifically requested with the -O1 option.

+ +

+ newsyslog(8) has + a number of new features. Among them:

+ +
    +
  • +

    A W flag forces + previously-started compression jobs for an entry (or + group of entries specified with the G flag) to finish before + beginning a new one. This feature is designed to + prevent system overloads caused by starting several + compression jobs on big files simultaneously. + [MERGED]

    +
    • + +
  • +

    A ``default rotate action'', to be used for files + specified for rotation but not specified in the + configuration file. [MERGED]

    +
    • + +
  • +

    A -s command-line flag to + disable sending signals to processes when rotating + files. [MERGED]

    +
    • + +
  • +

    A N configuration file + flag to indicate that no process needs to be signaled + when rotating a file. [MERGED]

    +
    • + +
  • +

    A U configuration file + flag to specify that a process group (rather than a + single process) should be signaled when rotating + files. [MERGED]

    +
    • +
+
+
+ +

+ nsdispatch(3) is + now thread-safe and implements support for Name Service + Switch (NSS) modules. NSS modules may be statically built + into libc or dynamically loaded + via + dlopen(3). They + are loaded/initialized at configuration time (i.e. when + + nsdispatch(3) is + called and + nsswitch.conf(5) + is read or re-read).

+ +

A new + pam_chroot(8) + module has been added, which does a + chroot(2) + operation for users into either a predetermined directory + or one derived from their home directory.

+ +

+ pam_ssh(8) has + been rewritten. One side effect of the rewrite is that it + now starts a separate instance of + ssh-agent(1) for + each session instead of trying to connect each session to + the agent started by the first session.

+ +

+ ping(8) now + supports a -D flag to set the + ``Don't Fragment'' bit on outgoing packets.

+ +

+ ping(8) now + supports a -M option to use ICMP + mask request or timestamp request messages instead of + ICMP echo requests.

+ +

+ ping(8) now + supports a -z flag to set the + Type of Service bits in outgoing packets.

+ +

+ pw(8) can now add + a user whose name ends with a $ + character; this change is intended to help administration + of Samba services. + [MERGED]

+ +

The format of the /etc/pwd.db and /etc/spwd.db password databases + created by + pwd_mkdb(8) is + now byte-order independent. The pre-processed password + databases can now be moved between machines of different + architectures. The format includes version numbers on + entries to ensure compatibility with old binaries.

+ +

A bug in + rand(3) that + could cause a sequence to remain stuck at 0 has been fixed. ( + rand(3) remains + unsuitable for all but trivial uses.)

+ +

+ rtld(1) now has + support for the dynamic mapping of shared object + dependencies. This optional feature is especially useful + when experimenting with different threading libraries. It + is not, however, built by default. More information on + enabling and using this feature can be found in + libmap.conf(5).

+ +

+ sem_open(3) now + correctly handles multiple opens of the same semaphore; + as a result, + sem_close(3) no + longer crashes calling programs.

+ +

The seeding algorithm used by + srandom(3) has + been strengthened.

+ +

+ sysinstall(8) + will now select UFS2 as the default layout for new file + systems unless specifically requested in the disk + labeler.

+ +
+
+

Note: Due to i386 boot loader limitations, + the root file system must be 1.5TB or smaller in + size.

+
+
+
+
+ +

The + swapoff(8) + command has been added to disable paging and swapping on + a device. A related + swapctl(8) + command has been added to provide an interface to + swapon(8) and + swapoff(8) + similar to other BSDs.

+ +
+
+

Note: The + swapoff(8) + feature should be considered experimental.

+
+
+
+
+ +

+ syslogd(8) now + allows multiple hosts or programs to be named in host or + program specifications in + syslog.conf(5) + files.

+ +

+ systat(1) now + includes an -ifstat display mode + that displays the network traffic going through active + interfaces on the system.

+ +

The + usbhidaction(1) + command has been added; it performs actions according to + its configuration in response to USB HID controls.

+ +

+ uudecode(1) and + + b64decode(1) now + support a -r flag for decoding + raw (or broken) files that may be missing the initial and + possibly final framing lines. [MERGED]

+ +

+ vmstat(8) has + re-implemented the -f flag, which + displays statistics on fork operations.

+ +

+ xargs(1) now + supports a -P option to execute + multiple copies of the same utility in parallel.

+ +

+ xargs(1) now + supports a -o flag to reopen /dev/tty for the child process + before executing the command. This is useful when the + child process is an interactive application.

+ +

The libkse library, + providing POSIX threading support using KSE, is now + enabled and installed by default. This library currently + supports M:N threading. Both process and system scope + threads are supported, as well as getting/setting the + concurrency level. By default, the library sets the + concurrency level to the number of CPUs in the system. + Each concurrency level correlates to a KSE, and all + process scope threads run in these KSEs. Each system + scope thread gets its own KSE in addition to those + corresponding to concurrency levels. libkse is still considered a + work-in-progress, and is not used by default. However, it + can be used as a replacement for the libc_r thread library, by + substituting -lkse instead of -pthread when linking programs.

+ +

A 1:1 threading package (where for every pthread in an + application there is one KSE and thread) has been + implemented. Under this model, the kernel handles all + thread scheduling decisions and all signal delivery. This + uses some of the common KSE code, and is a restricted + case of the M:N threading work still in progress. The libthr library implementing the + userland portion of this functionality is a drop-in + replacement for the libc_r + library. Note that libthr is + not (at this time) built by default.

+ +

The historic BSD boot scripts in /etc have been removed, in favor of + the rc.d system imported from + NetBSD (sometimes referred to + as ``rcNG''). All functionality of the historic system + has been preserved. In particular, files such as /etc/rc.conf continue to be the + recommended means of configuring the system startup. The + rc.d system has been the + default since FreeBSD 5.0-RELEASE, so this change should + be largely transparent for the vast majority of users. + Users who have customized their historic-style startup + scripts should be aware that the following files have + been removed from /etc: rc.atm, rc.devfs, rc.diskless1, rc.diskless2, rc.i386, rc.alpha, rc.amd64, rc.ia64, rc.sparc64, rc.isdn, rc.network, rc.network6, rc.pccard, rc.serial, rc.syscons, rc.sysctl. + mergemaster(8), + when run, will offer to move these files out of the way + for convenience. More details can be found in + rc.subr(8).

+
+ +
+
+ +

2.4 + Contributed Software

+ +

The ACPI-CA code has been + updated from the 20021118 snapshot to the 20030228 + snapshot.

+ +

awk from Bell Labs has been + updated to a 14 March 2003 snapshot.

+ +

BIND has been updated to + version 8.3.4. [MERGED]

+ +

All of the bzip2 suite of + applications is now installed in the base system (in + particular, bzip2recover is now + built and installed). [MERGED]

+ +

CVS has been updated to + 1.11.5. [MERGED]

+ +

The DRM kernel modules have + been updated to a snapshot from the DRI CVS repository, + as of 24 April 2003. The DRM_LINUX kernel option hsa been + removed because the handler is now provided by the Linux + compatibility code.

+ +

FILE has been updated to + 3.41. [MERGED]

+ +

GCC has been updated to + 3.2.2 (release version).

+ +
+
+

Note: GCC is + known to produce broken code with the -march=pentium4 option set. As a + workaround to avoid this problem, setting the CPUTYPE=p4 Makefile variable + (for example, in + make.conf(5)) + enables GCC's -march=pentium3 + option instead. This situation is expected to be + resolved when GCC 3.3 is imported.

+
+
+
+
+ +

The gdtoa library, for + conversions between strings and floating point, has been + imported. These sources were dated 24 March 2003.

+ +

groff (and related + utilities) have been updated from 1.18.1 to 1.19.

+ +

IPFilter has been updated + to 3.4.31. [MERGED]

+ +

The ISC DHCP client has + been updated to 3.0.1RC11. [MERGED]

+ +

The ISC DHCP client now + includes the + omshell(1) + utility and the + dhcpctl(3) + library for run-time control of the client.

+ +

Kerberos IV support (in the + form of KTH eBones) has been + removed. Users requiring this functionality can still get + it from the security/krb4 port + (or package). Kerberos IV compatibility mode for Kerberos + 5 has been removed, and the k5program userland + utilities have been renamed to kprogram.

+ +

Kerberos 5 is now built by + default in buildworld + operations. Setting MAKE_KERBEROS5 no longer has any + effect. Disabling the base system Kerberos 5 now requires + the NO_KERBEROS Makefile + variable to be set.

+ +

libpcap now has support for + selecting among multiple data link types on an + interface.

+ +

lukemftpd (not built or + installed by default) has been updated to a snapshot from + 22 January 2003.

+ +

OpenPAM has been updated + from the ``Citronella'' release to the ``Dianthus'' + release.

+ +

OpenSSH has been updated to + 3.6.1p1.

+ +

OpenSSL has been updated to + release 0.9.7a. Among other features, this release + includes support for AES and takes advantage of + crypto(4) + devices. [MERGED]

+ +

sendmail has been updated + to version 8.12.9. [MERGED]

+ +

+ tcpdump(1) has + been updated to version 3.7.2. [MERGED] It also now + supports a -L flag to list the + data link types available on an interface and a -y option to specify the data link + type to use while capturing packets.

+ +

texinfo has been updated + from 4.2 to 4.5.

+ +

The timezone database has been updated from tzdata2002d to tzdata2003a. [MERGED]

+
+ +
+
+ +

2.5 + Ports/Packages Collection Infrastructure

+ +

The one-line pkg-comment + files have been eliminated from each port skeleton; their + contents have been moved into each port's Makefile. This change reduces the + disk space and inodes used by the ports tree. + [MERGED]

+ +

When fetching distfiles for building a port, the FETCH_REGET Makefile variable can be used to + specify the number of times to try continuing to fetch a + distfile if it fails its MD5 checksum. The port + infrastructure also supports re-fetching interrupted + distfiles.

+ +

+ pkg_create(1) now + supports a -C option, which + allows packages to register a list of other packages with + which they conflict. They will refuse to install (via + pkg_add(1)) if + one of the listed packages is already present. The -f flag to + pkg_add(1) + overrides this conflict-checking.

+ +

+ pkg_info(1) now + honors the BLOCKSIZE environment + variable in its output when the -b flag is given.

+ +

+ pkg_info(1) now + implements a -Q option, which is + similar to the -q ``quiet'' + option except that it prefixes the output with the + package name.

+
+ +
+
+ +

2.6 + Release Engineering and Integration

+ +

The supported release of GNOME has been updated to 2.2.1. + [MERGED]

+ +

The supported release of KDE has been updated to 3.1.2. + [MERGED]

+ +

There is no longer a separate krb5 distribution. The Kerberos 5 + libraries and utilities have been incorporated into the + crypto distribution.

+ +

+ sysinstall(8) + once again supports installing individual components of + XFree86. Supporting changes + (not user-visible) generalize the concept of installing + parts of distributions as packages.

+ +

The supported release of XFree86 has been updated to + 4.3.0. [MERGED]

+ +

Several upgrade mechanisms designed to permit major + version upgrades from FreeBSD 2.X to 3.X and from FreeBSD 3.X to 4.X have been removed.

+
+ +
+
+ +

2.7 + Documentation

+ +

The following new articles have been added to the + documentation set: ``FreeBSD From Scratch'', ``The + Roadmap for 5-STABLE''.

+ +

A new Danish (da_DK.ISO8859-1) translation + project has been started.

+
+
+ +
+
+ +

3 + Upgrading from previous releases of FreeBSD

+ +

Users with existing FreeBSD systems are highly + encouraged to read the ``Early Adopter's Guide to FreeBSD + 5.1-RELEASE''. This document generally has the filename EARLY.TXT on the distribution media, + or any other place that the release notes can be found. It + offers some notes on upgrading, but more importantly, also + discusses some of the relative merits of upgrading to + FreeBSD 5.X versus + running FreeBSD 4.X.

+ +
+
+

Important: Upgrading FreeBSD should, of + course, only be attempted after backing up all + data and configuration files.

+
+
+
+
+
+ +

This file, and other release-related + documents, can be downloaded from ftp://ftp.FreeBSD.org/.

+ +

For questions about FreeBSD, read the + documentation + before contacting <questions@FreeBSD.org>.

+ +

All users of FreeBSD 5-CURRENT + should subscribe to the <current@FreeBSD.org> + mailing list.

+ +

For questions about this documentation, + e-mail <doc@FreeBSD.org>.

+
+
+ + + diff --git a/en/releases/5.1R/relnotes-ia64.html b/en/releases/5.1R/relnotes-ia64.html new file mode 100644 index 0000000000..62162ededa --- /dev/null +++ b/en/releases/5.1R/relnotes-ia64.html @@ -0,0 +1,1563 @@ + + + + + FreeBSD/ia64 5.1-RELEASE Release Notes + + + + + +
+
+

FreeBSD/ia64 + 5.1-RELEASE Release Notes

+ +

The FreeBSD Project

+ +

Copyright © 2000, 2001, 2002, + 2003 by The FreeBSD Documentation Project

+ +

$FreeBSD: + src/release/doc/en_US.ISO8859-1/relnotes/common/new.sgml,v + 1.573 2003/05/28 21:01:22 hrs Exp $
+

+ +
+
+ + +

The release notes for FreeBSD 5.1-RELEASE contain a + summary of recent changes made to the FreeBSD base + system on the 5-CURRENT development branch. This + document lists applicable security advisories that were + issued since the last release, as well as significant + changes to the FreeBSD kernel and userland. Some brief + remarks on upgrading are also presented.

+
+
+
+
+ +
+
+
Table of Contents
+ +
1 Introduction
+ +
2 What's New
+ +
+
+
2.1 Security + Advisories
+ +
2.2 Kernel Changes
+ +
+
+
2.2.1 Processor/Motherboard + Support
+ +
2.2.2 Boot Loader + Changes
+ +
2.2.3 Network Interface + Support
+ +
2.2.4 Network + Protocols
+ +
2.2.5 Disks and + Storage
+ +
2.2.6 File Systems
+ +
2.2.7 PCCARD + Support
+ +
2.2.8 Multimedia + Support
+
+
+ +
2.3 Userland Changes
+ +
2.4 Contributed + Software
+ +
2.5 Ports/Packages Collection + Infrastructure
+ +
2.6 Release Engineering and + Integration
+ +
2.7 Documentation
+
+
+ +
3 Upgrading from previous releases + of FreeBSD
+
+
+ +
+
+ +

1 + Introduction

+ +

This document contains the release notes for FreeBSD + 5.1-RELEASE on the IA-64 hardware platform. It describes + recently added, changed, or deleted features of FreeBSD. It + also provides some notes on upgrading from previous + versions of FreeBSD.

+ +

This distribution of FreeBSD 5.1-RELEASE is a release + distribution. It can be found at ftp://ftp.FreeBSD.org/ or any of its + mirrors. More information on obtaining this (or other) + release distributions of FreeBSD can be found in the ``Obtaining FreeBSD'' appendix to the FreeBSD Handbook.

+ +

Users who are new to the 5-CURRENT series of FreeBSD + releases should also read the ``Early Adopters Guide to + FreeBSD 5.1-RELEASE''. This document can generally be found + in the same location as the release notes (either as a part + of a FreeBSD distribution or on the FreeBSD Web site). It + contains important information regarding the advantages and + disadvantages of using FreeBSD 5.1-RELEASE, as opposed to + releases based on the FreeBSD 4-STABLE development + branch.

+ +

All users are encouraged to consult the release errata + before installing FreeBSD. The errata document is updated + with ``late-breaking'' information discovered late in the + release cycle or after the release. Typically, it contains + information on known bugs, security advisories, and + corrections to documentation. An up-to-date copy of the + errata for FreeBSD 5.1-RELEASE can be found on the FreeBSD + Web site.

+
+ +
+
+ +

2 What's + New

+ +

This section describes many of the user-visible new or + changed features in FreeBSD since 5.0-RELEASE. It includes + items that are unique to the 5-CURRENT branch, as well as + some features that may have been recently merged to other + branches (after FreeBSD 5.0-RELEASE). The latter items are + marked as [MERGED].

+ +

Typical release note items document recent security + advisories issued after 5.0-RELEASE, new drivers or + hardware support, new commands or options, major bug fixes, + or contributed software upgrades. They may also list + changes to major ports/packages or release engineering + practices. Clearly the release notes cannot list every + single change made to FreeBSD between releases; this + document focuses primarily on security advisories, + user-visible changes, and major architectural + improvements.

+ +
+
+ +

2.1 + Security Advisories

+ +

A remotely exploitable vulnerability in CVS has been corrected with the + import of version 1.11.5. More details can be found in + security advisory FreeBSD-SA-03:01. [MERGED]

+ +

A timing-based attack on OpenSSL, which could allow a very + powerful attacker access to plaintext under certain + circumstances, has been prevented via an upgrade to OpenSSL 0.9.7. See security + advisory FreeBSD-SA-03:02 for more details. + [MERGED]

+ +

The security and performance of the ``syncookies'' + feature has been improved to decrease the chance of an + attacker being able to spoof connections. More details + are given in security advisory FreeBSD-SA-03:03. [MERGED]

+ +

Remotely-exploitable buffer overflow vulnerabilities + in sendmail have been fixed by + updating sendmail. For more + details, see security advisory FreeBSD-SA-03:04 and FreeBSD-SA-03:07. [MERGED]

+ +

A bounds-checking bug in the XDR implementation, which + could allow a remote attacker to cause a + denial-of-service, has been fixed. For more details see + security advisory FreeBSD-SA-03:05. [MERGED]

+ +

Two recently-publicized flaws in OpenSSL have been corrected. For + more details, see security advisory FreeBSD-SA-03:06. [MERGED]

+
+ +
+
+ +

2.2 Kernel + Changes

+ +

+ devfs(5) is now + mandatory; the NODEVFS option + has been removed from the set of possible kernel + configuration options.

+ +

An + ehci(4) driver + has been added; it supports the USB Enhanced Host + Controller Interface used by USB 2.0 controllers.

+ +

A minor bug in the permissions handling of /dev/tty has been fixed. As a + result, + ssh(1) can now be + used after + su(1).

+ +

A bug that caused + fstat(2) to + return 0 as the number of bytes + available to read from a TCP socket has been fixed.

+ +

A bug that caused + kqueue(2) to + report 0 as the number of bytes + available to read from a TCP socket has been fixed. The + NOTE_LOWAT flag for EVFILT_READ has been fixed.

+ +

Linux emulation mode now supports IPv6.

+ +

+ madvise(2) now + supports a MADV_PROTECT + behavior, which informs the virtual memory system that a + process is critical and should not be killed when swap + space has been exhausted. The process must be owned by + the superuser.

+ +

A second process scheduler, designed to be a general + purpose scheduler with many SMP benefits, has been added + to the scheduler framework. Exactly one scheduler must be + specified in a kernel configuration. The original + scheduler may be selected using options SCHED_4BSD. The newer + (experimental) scheduler can be selected by using options SCHED_ULE.

+ +

Device major numbers are now allocated dynamically by + default. This change greatly decreases the need for a + static, centralized table of major number assignments to + device drivers (a few drivers retain their old static + major numbers for compatibility), and also reduces the + possibility of running out of device major numbers.

+ +
+
+ +

2.2.1 + Processor/Motherboard Support

+
+ +
+
+ +

2.2.2 Boot + Loader Changes

+ +

The /modules directory + (once the default location for modules on FreeBSD 4.X) is no longer a part + of the default kern.module_path. Third-party + modules should be placed in /boot/modules.

+ +
+
+

Note: Modules designed for use with + FreeBSD 4.X are + likely to panic when loaded into a FreeBSD + 5.1-RELEASE kernel and should be used with extreme + caution.

+
+
+
+
+
+ +
+
+ +

2.2.3 + Network Interface Support

+ +

The cm driver now supports IPX. [MERGED]

+ +

A new + wlan(4) module + provides 802.11 link-layer support. The + wi(4) and + an(4) drivers + now use this facility.

+
+ +
+
+ +

2.2.4 Network Protocols

+ +

+ ipfw(4) skipto rules can once again be + used with the log keyword. + ipfw(4) uid rules are once again + working.

+ +

It is now possible to build the FAST_IPSEC and INET6 options into the same + kernel. (They still cannot be used together, + however.)

+ +

A bug in TCP NewReno, which caused premature exit + from fast recovery when NewReno was enabled, has been + fixed. [MERGED]

+ +

TCP now has support for the ``Limited Transmit'' + mechanism proposed by RFC 3042. This feature is + intended to improve the effectiveness of TCP loss + recovery in certain circumstances. It is off by default + but can be enabled with the net.inet.tcp.rfc3042 sysctl + variable. More information can be found in + tcp(4).

+ +

TCP now has support for increased initial congestion + window sizes as described in RFC 3390. This feature can + improve the throughput of short transfers, as well as + high-bandwidth, large propagation-delay connections. It + is off by default but can be enabled with the net.inet.tcp.rfc3390 sysctl + variable. More information can be found in + tcp(4).

+ +

The IP fragment reassembly code behaves more + gracefully when receiving a large number of packet + fragments (it is designed to be more resistant to + fragment-based denial of service attacks). [MERGED]

+ +

TCP connections in the TIME_WAIT state now use a special + protocol control block that uses less space than a + full-blown TCP PCB. This allows some of the data + structures and resources used by such a connection to + be freed earlier.

+ +

It is now possible to specify the range of + ``privileged ports'' (TCP and UDP ports that require + superuser access to + bind(2) to). + The range is now specified with the net.inet.ip.portrange.reservedlow + and net.inet.ip.portrange.reservedhigh + sysctl variables, defaulting to the traditional UNIX + behavior. This feature is intended to help network + servers bind to traditionally privileged ports without + requiring superuser access. + ip(4) has more + details.

+ +

Some bugs in the non-blocking RPC code has been + fixed. As a result, + amd(8) users + are now able to mount volumes from a 5.1-RELEASE + server.

+ +

Support for XNS networking, which has not worked + correctly for almost seven years, has been removed.

+
+ +
+
+ +

2.2.5 + Disks and Storage

+ +

The + aac(4) driver + now runs free of the Giant kernel lock. This change has + given a nearly 20% performance speedup on an SMP system + running multiple I/O intensive loads.

+ +

The + ata(4) driver + now supports all known SiS chipsets. (More details can + be found in the Hardware Notes.)

+ +

The + ata(4) driver + now supports the Promise SATA150 TX2 and TX4 Serial + ATA/150 controllers.

+ +

The + ata(4) driver + now flushes devices on shutdown. This change may result + in failure messages being printed on the console for + devices that do not support flushing.

+ +

The CAM layer now has support for devices with more + than 232 blocks. (Assuming 512-byte blocks, + this means support for devices larger than 2TB.)

+ +
+
+

Note: For users upgrading across this + change, note that all userland applications that + talk to + pass(4) or + + xpt(4) + devices must be recompiled. Examples of such + programs are + camcontrol(8) + in the base system, the sysutils/cdrtools port, and + the multimedia/xmms + port.

+
+
+
+
+ +

A number of changes have been made to the + cd(4) driver. + The primary user-visible change is improved + compatibility with ATAPI/USB/Firewire CDROM drives.

+ +

+ geom(4) is now + mandatory; the NO_GEOM has + been removed from the set of kernel configuration + options.

+ +

The + iir(4) driver + has been updated; this update is believed to fix + problems detecting attached disks during + installation.

+ +

A bug in the + mly(4) driver + that caused hangs has been corrected.

+ +

Support has been added for volume labels on UFS and + UFS2 file systems. These labels are strings that can be + used to identify a volume, regardless of what device it + appears on. Labels can be set with the -L options to + newfs(8) or + tunefs(8). With + the GEOM_VOL module, volumes + can be accessed using their labels under /dev/vol.

+ +

The root file system can now be located on a + vinum(4) + volume. More information can be found in the + vinum(4) manual + page.

+
+ +
+
+ +

2.2.6 File + Systems

+ +

A new DIRECTIO kernel + option enables support for read operations that bypass + the buffer cache and put data directly into a userland + buffer. This feature requires that the O_DIRECT flag is set on the file + descriptor and that both the offset and length for the + read operation are multiples of the physical media + sector size. [MERGED]

+ +

NETNCP and Netware File System Support (nwfs) are + once again working.

+ +

Bugs that could cause the unmounting of a smbfs + share to fail or cause a kernel panic have been + fixed.

+
+ +
+
+ +

2.2.7 + PCCARD Support

+
+ +
+
+ +

2.2.8 Multimedia + Support

+
+
+ +
+
+ +

2.3 + Userland Changes

+ +

+ adduser(8) now + correctly handles setting user passwords containing + special shell characters.

+ +

+ adduser(8) now + supports a -g option to set a + user's default login group.

+ +

The + bsdlabel(8) + utility is a replacement for the older disklabel utility. + Like its predecessor, it installs, examines, or modifies + the BSD label on a disk partition, and can install + bootstrap code. Compared to disklabel, a number of + obsolete options and parameters have been retired. A new + -m option instructs + bsdlabel(8) to + use the layout suitable for a specific machine.

+ +

+ chgrp(1) and + chown(8) now, + when the owner/group is modified, print the old and new + uid/gid if the -v option is + specified more than once.

+ +

+ config(8) now + implements a nodevice kernel + configuration file directive that cancels the effect of a + device directive. The new nooption and nomakeoption directives cancel prior + options and makeoptions directives, + respectively.

+ +

The + diskinfo(8) + utility has been added to show information about a disk + device and optionally to run a naive performance + test.

+ +

The disklabel utility has been replaced by + bsdlabel(8). On + the alpha, i386, and pc98 platforms, disklabel is a link + to + bsdlabel(8).

+ +

+ dump(8) now + supports caching of disk blocks with the -C option. This can improve dump + performance at the cost of possibly missing file system + updates that occur between passes.

+ +

+ dumpfs(8) now + supports a -m flag to print file + system parameters in the form of a + newfs(8) + command.

+ +

+ elfdump(1), a + utility to display information about + elf(5) format + executable files, has been added.

+ +

+ fetch(1) uses the + .netrc support in + fetch(3) and also + supports a -N to specify an + alternate .netrc file.

+ +

+ fetch(3) now has + support for .netrc files (see + + ftp(1) for more + details).

+ +

+ ftpd(8) now + supports a -h option to disable + printing any host-specific information, such as the + ftpd(8) version + or hostname, in server messages. [MERGED]

+ +

+ ftpd(8) now + supports a -P option to specify a + port on which to listen in daemon mode. The default data + port number is now set to be one less than the control + port number, rather than being hard-coded. [MERGED]

+ +

+ ftpd(8) now + supports an extended format of the /etc/ftpchroot file. Please refer + to the + ftpchroot(5) + manpage, which is now available, for details. + [MERGED]

+ +

+ ftpd(8) now + supports login directory pathnames that specify + simultaneously a directory for + chroot(2) and + that to change to in the chrooted environment. The /./ separator is used for this + purpose, like in other FTP daemons having this feature. + It may be used in both + ftpchroot(5) and + + passwd(5). + [MERGED]

+ +

+ fwcontrol(8) now + supports -R and -S options for receiving and sending + DV streams. [MERGED]

+ +

The + gstat(8) utility + has been added to show the disk activity inside the + geom(4) + subsystem.

+ +

+ ipfw(8) now + supports enable and disable commands to control various + aspects of the operation of + ipfw(4) + (including enabling and disabling the firewall itself). + These provide a more convenient and visible interface + than the existing sysctl variables. [MERGED]

+ +

+ jail(8) now + supports a -i flag to output an + identifier for a newly-created jail.

+ +

The + jexec(8) utility + has been added to execute a command inside an existing + jail.

+ +

The + jls(8) utility + has been added to list existing jails.

+ +

+ kenv(1) has been + moved from /usr/bin to /bin to make it available at times + during system startup when only the root file system is + mounted.

+ +

+ killall(1) now + supports a -j option to kill all + processes inside a jail.

+ +

The + libgeom(3) + library has been added to allow some userland access to + the + geom(4) + subsystem.

+ +

The mac_portacl MAC policy module has been added. It + provides a simple ACL mechanism to permit users and + groups to bind ports for TCP or UDP, and is intended to + be used in conjunction with the recently-added net.inet.ip.portrange.reservedhigh + sysctl.

+ +

The MAKEDEV script is now + unnecessary, due to the mandatory presence of + devfs(5), and has + been removed.

+ +

+ mergemaster(8) + now supports a -P option to + preserve the contents of files being replaced.

+ +

+ mixer(8) can now + implement relative volume adjustments.

+ +

The + mksnap_ffs(8) + program has been added to allow easier creation of FFS + snapshots. It is a SUID-root + executable designed for use by members of the operator group.

+ +

+ mount(8) and + umount(8) now + accept a -F option to specify an + alternate + fstab(5) + file.

+ +

+ mount_nfs(8) now + supports a -c flag to avoid doing + a + connect(2) for + UDP mount points. This option must be used if the server + does not reply to requests from the standard NFS port + number 2049 or if it replies to requests using a + different IP address (which can occur if the server is + multi-homed). Setting the vfs.nfs.nfs_ip_paranoia sysctl to + 0 will make this option the + default. [MERGED]

+ +

+ mount_nfs(8) now + supports the noinet4 and noinet6 mount options to prevent NFS + mounts from using IPv4 or IPv6 respectively.

+ +

+ newfs(8) will now + create UFS2 file systems by default, unless UFS1 is + specifically requested with the -O1 option.

+ +

+ newsyslog(8) has + a number of new features. Among them:

+ +
    +
  • +

    A W flag forces + previously-started compression jobs for an entry (or + group of entries specified with the G flag) to finish before + beginning a new one. This feature is designed to + prevent system overloads caused by starting several + compression jobs on big files simultaneously. + [MERGED]

    +
    • + +
  • +

    A ``default rotate action'', to be used for files + specified for rotation but not specified in the + configuration file. [MERGED]

    +
    • + +
  • +

    A -s command-line flag to + disable sending signals to processes when rotating + files. [MERGED]

    +
    • + +
  • +

    A N configuration file + flag to indicate that no process needs to be signaled + when rotating a file. [MERGED]

    +
    • + +
  • +

    A U configuration file + flag to specify that a process group (rather than a + single process) should be signaled when rotating + files. [MERGED]

    +
    • +
+
+
+ +

+ nsdispatch(3) is + now thread-safe and implements support for Name Service + Switch (NSS) modules. NSS modules may be statically built + into libc or dynamically loaded + via + dlopen(3). They + are loaded/initialized at configuration time (i.e. when + + nsdispatch(3) is + called and + nsswitch.conf(5) + is read or re-read).

+ +

A new + pam_chroot(8) + module has been added, which does a + chroot(2) + operation for users into either a predetermined directory + or one derived from their home directory.

+ +

+ pam_ssh(8) has + been rewritten. One side effect of the rewrite is that it + now starts a separate instance of + ssh-agent(1) for + each session instead of trying to connect each session to + the agent started by the first session.

+ +

+ ping(8) now + supports a -D flag to set the + ``Don't Fragment'' bit on outgoing packets.

+ +

+ ping(8) now + supports a -M option to use ICMP + mask request or timestamp request messages instead of + ICMP echo requests.

+ +

+ ping(8) now + supports a -z flag to set the + Type of Service bits in outgoing packets.

+ +

+ pw(8) can now add + a user whose name ends with a $ + character; this change is intended to help administration + of Samba services. + [MERGED]

+ +

The format of the /etc/pwd.db and /etc/spwd.db password databases + created by + pwd_mkdb(8) is + now byte-order independent. The pre-processed password + databases can now be moved between machines of different + architectures. The format includes version numbers on + entries to ensure compatibility with old binaries.

+ +

A bug in + rand(3) that + could cause a sequence to remain stuck at 0 has been fixed. ( + rand(3) remains + unsuitable for all but trivial uses.)

+ +

+ rtld(1) now has + support for the dynamic mapping of shared object + dependencies. This optional feature is especially useful + when experimenting with different threading libraries. It + is not, however, built by default. More information on + enabling and using this feature can be found in + libmap.conf(5).

+ +

+ sem_open(3) now + correctly handles multiple opens of the same semaphore; + as a result, + sem_close(3) no + longer crashes calling programs.

+ +

The seeding algorithm used by + srandom(3) has + been strengthened.

+ +

+ sysinstall(8) + will now select UFS2 as the default layout for new file + systems unless specifically requested in the disk + labeler.

+ +

The + swapoff(8) + command has been added to disable paging and swapping on + a device. A related + swapctl(8) + command has been added to provide an interface to + swapon(8) and + swapoff(8) + similar to other BSDs.

+ +
+
+

Note: The + swapoff(8) + feature should be considered experimental.

+
+
+
+
+ +

+ syslogd(8) now + allows multiple hosts or programs to be named in host or + program specifications in + syslog.conf(5) + files.

+ +

+ systat(1) now + includes an -ifstat display mode + that displays the network traffic going through active + interfaces on the system.

+ +

The + usbhidaction(1) + command has been added; it performs actions according to + its configuration in response to USB HID controls.

+ +

+ uudecode(1) and + + b64decode(1) now + support a -r flag for decoding + raw (or broken) files that may be missing the initial and + possibly final framing lines. [MERGED]

+ +

+ vmstat(8) has + re-implemented the -f flag, which + displays statistics on fork operations.

+ +

+ xargs(1) now + supports a -P option to execute + multiple copies of the same utility in parallel.

+ +

+ xargs(1) now + supports a -o flag to reopen /dev/tty for the child process + before executing the command. This is useful when the + child process is an interactive application.

+ +

A 1:1 threading package (where for every pthread in an + application there is one KSE and thread) has been + implemented. Under this model, the kernel handles all + thread scheduling decisions and all signal delivery. This + uses some of the common KSE code, and is a restricted + case of the M:N threading work still in progress. The libthr library implementing the + userland portion of this functionality is a drop-in + replacement for the libc_r + library. Note that libthr is + not (at this time) built by default.

+ +

The historic BSD boot scripts in /etc have been removed, in favor of + the rc.d system imported from + NetBSD (sometimes referred to + as ``rcNG''). All functionality of the historic system + has been preserved. In particular, files such as /etc/rc.conf continue to be the + recommended means of configuring the system startup. The + rc.d system has been the + default since FreeBSD 5.0-RELEASE, so this change should + be largely transparent for the vast majority of users. + Users who have customized their historic-style startup + scripts should be aware that the following files have + been removed from /etc: rc.atm, rc.devfs, rc.diskless1, rc.diskless2, rc.i386, rc.alpha, rc.amd64, rc.ia64, rc.sparc64, rc.isdn, rc.network, rc.network6, rc.pccard, rc.serial, rc.syscons, rc.sysctl. + mergemaster(8), + when run, will offer to move these files out of the way + for convenience. More details can be found in + rc.subr(8).

+
+ +
+
+ +

2.4 + Contributed Software

+ +

The ACPI-CA code has been + updated from the 20021118 snapshot to the 20030228 + snapshot.

+ +

awk from Bell Labs has been + updated to a 14 March 2003 snapshot.

+ +

BIND has been updated to + version 8.3.4. [MERGED]

+ +

All of the bzip2 suite of + applications is now installed in the base system (in + particular, bzip2recover is now + built and installed). [MERGED]

+ +

CVS has been updated to + 1.11.5. [MERGED]

+ +

FILE has been updated to + 3.41. [MERGED]

+ +

GCC has been updated to + 3.2.2 (release version).

+ +

The gdtoa library, for + conversions between strings and floating point, has been + imported. These sources were dated 24 March 2003.

+ +

groff (and related + utilities) have been updated from 1.18.1 to 1.19.

+ +

IPFilter has been updated + to 3.4.31. [MERGED]

+ +

The ISC DHCP client has + been updated to 3.0.1RC11. [MERGED]

+ +

The ISC DHCP client now + includes the + omshell(1) + utility and the + dhcpctl(3) + library for run-time control of the client.

+ +

Kerberos IV support (in the + form of KTH eBones) has been + removed. Users requiring this functionality can still get + it from the security/krb4 port + (or package). Kerberos IV compatibility mode for Kerberos + 5 has been removed, and the k5program userland + utilities have been renamed to kprogram.

+ +

Kerberos 5 is now built by + default in buildworld + operations. Setting MAKE_KERBEROS5 no longer has any + effect. Disabling the base system Kerberos 5 now requires + the NO_KERBEROS Makefile + variable to be set.

+ +

libpcap now has support for + selecting among multiple data link types on an + interface.

+ +

lukemftpd (not built or + installed by default) has been updated to a snapshot from + 22 January 2003.

+ +

OpenPAM has been updated + from the ``Citronella'' release to the ``Dianthus'' + release.

+ +

OpenSSH has been updated to + 3.6.1p1.

+ +

OpenSSL has been updated to + release 0.9.7a. Among other features, this release + includes support for AES and takes advantage of + crypto(4) + devices. [MERGED]

+ +

sendmail has been updated + to version 8.12.9. [MERGED]

+ +

+ tcpdump(1) has + been updated to version 3.7.2. [MERGED] It also now + supports a -L flag to list the + data link types available on an interface and a -y option to specify the data link + type to use while capturing packets.

+ +

texinfo has been updated + from 4.2 to 4.5.

+ +

The timezone database has been updated from tzdata2002d to tzdata2003a. [MERGED]

+
+ +
+
+ +

2.5 + Ports/Packages Collection Infrastructure

+ +

The one-line pkg-comment + files have been eliminated from each port skeleton; their + contents have been moved into each port's Makefile. This change reduces the + disk space and inodes used by the ports tree. + [MERGED]

+ +

When fetching distfiles for building a port, the FETCH_REGET Makefile variable can be used to + specify the number of times to try continuing to fetch a + distfile if it fails its MD5 checksum. The port + infrastructure also supports re-fetching interrupted + distfiles.

+ +

+ pkg_create(1) now + supports a -C option, which + allows packages to register a list of other packages with + which they conflict. They will refuse to install (via + pkg_add(1)) if + one of the listed packages is already present. The -f flag to + pkg_add(1) + overrides this conflict-checking.

+ +

+ pkg_info(1) now + honors the BLOCKSIZE environment + variable in its output when the -b flag is given.

+ +

+ pkg_info(1) now + implements a -Q option, which is + similar to the -q ``quiet'' + option except that it prefixes the output with the + package name.

+
+ +
+
+ +

2.6 + Release Engineering and Integration

+ +

The supported release of GNOME has been updated to 2.2.1. + [MERGED]

+ +

The supported release of KDE has been updated to 3.1.2. + [MERGED]

+ +

There is no longer a separate krb5 distribution. The Kerberos 5 + libraries and utilities have been incorporated into the + crypto distribution.

+ +

+ sysinstall(8) + once again supports installing individual components of + XFree86. Supporting changes + (not user-visible) generalize the concept of installing + parts of distributions as packages.

+ +

The supported release of XFree86 has been updated to + 4.3.0. [MERGED]

+ +

Several upgrade mechanisms designed to permit major + version upgrades from FreeBSD 2.X to 3.X and from FreeBSD 3.X to 4.X have been removed.

+
+ +
+
+ +

2.7 + Documentation

+ +

The following new articles have been added to the + documentation set: ``FreeBSD From Scratch'', ``The + Roadmap for 5-STABLE''.

+ +

A new Danish (da_DK.ISO8859-1) translation + project has been started.

+
+
+ +
+
+ +

3 + Upgrading from previous releases of FreeBSD

+ +

Users with existing FreeBSD systems are highly + encouraged to read the ``Early Adopter's Guide to FreeBSD + 5.1-RELEASE''. This document generally has the filename EARLY.TXT on the distribution media, + or any other place that the release notes can be found. It + offers some notes on upgrading, but more importantly, also + discusses some of the relative merits of upgrading to + FreeBSD 5.X versus + running FreeBSD 4.X.

+ +
+
+

Important: Upgrading FreeBSD should, of + course, only be attempted after backing up all + data and configuration files.

+
+
+
+
+
+ +

This file, and other release-related + documents, can be downloaded from ftp://ftp.FreeBSD.org/.

+ +

For questions about FreeBSD, read the + documentation + before contacting <questions@FreeBSD.org>.

+ +

All users of FreeBSD 5-CURRENT + should subscribe to the <current@FreeBSD.org> + mailing list.

+ +

For questions about this documentation, + e-mail <doc@FreeBSD.org>.

+
+
+ + + diff --git a/en/releases/5.1R/relnotes-pc98.html b/en/releases/5.1R/relnotes-pc98.html new file mode 100644 index 0000000000..a8ac8c9413 --- /dev/null +++ b/en/releases/5.1R/relnotes-pc98.html @@ -0,0 +1,1641 @@ + + + + + FreeBSD/pc98 5.1-RELEASE Release Notes + + + + + +
+
+

FreeBSD/pc98 + 5.1-RELEASE Release Notes

+ +

The FreeBSD Project

+ +

Copyright © 2000, 2001, 2002, + 2003 by The FreeBSD Documentation Project

+ +

$FreeBSD: + src/release/doc/en_US.ISO8859-1/relnotes/common/new.sgml,v + 1.573 2003/05/28 21:01:22 hrs Exp $
+

+ +
+
+ + +

The release notes for FreeBSD 5.1-RELEASE contain a + summary of recent changes made to the FreeBSD base + system on the 5-CURRENT development branch. This + document lists applicable security advisories that were + issued since the last release, as well as significant + changes to the FreeBSD kernel and userland. Some brief + remarks on upgrading are also presented.

+
+
+
+
+ +
+
+
Table of Contents
+ +
1 Introduction
+ +
2 What's New
+ +
+
+
2.1 Security + Advisories
+ +
2.2 Kernel Changes
+ +
+
+
2.2.1 Processor/Motherboard + Support
+ +
2.2.2 Boot Loader + Changes
+ +
2.2.3 Network Interface + Support
+ +
2.2.4 Network + Protocols
+ +
2.2.5 Disks and + Storage
+ +
2.2.6 File Systems
+ +
2.2.7 PCCARD + Support
+ +
2.2.8 Multimedia + Support
+
+
+ +
2.3 Userland Changes
+ +
2.4 Contributed + Software
+ +
2.5 Ports/Packages Collection + Infrastructure
+ +
2.6 Release Engineering and + Integration
+ +
2.7 Documentation
+
+
+ +
3 Upgrading from previous releases + of FreeBSD
+
+
+ +
+
+ +

1 + Introduction

+ +

This document contains the release notes for FreeBSD + 5.1-RELEASE on the NEC PC-98x1 hardware platform. It + describes recently added, changed, or deleted features of + FreeBSD. It also provides some notes on upgrading from + previous versions of FreeBSD.

+ +

This distribution of FreeBSD 5.1-RELEASE is a release + distribution. It can be found at ftp://ftp.FreeBSD.org/ or any of its + mirrors. More information on obtaining this (or other) + release distributions of FreeBSD can be found in the ``Obtaining FreeBSD'' appendix to the FreeBSD Handbook.

+ +

Users who are new to the 5-CURRENT series of FreeBSD + releases should also read the ``Early Adopters Guide to + FreeBSD 5.1-RELEASE''. This document can generally be found + in the same location as the release notes (either as a part + of a FreeBSD distribution or on the FreeBSD Web site). It + contains important information regarding the advantages and + disadvantages of using FreeBSD 5.1-RELEASE, as opposed to + releases based on the FreeBSD 4-STABLE development + branch.

+ +

All users are encouraged to consult the release errata + before installing FreeBSD. The errata document is updated + with ``late-breaking'' information discovered late in the + release cycle or after the release. Typically, it contains + information on known bugs, security advisories, and + corrections to documentation. An up-to-date copy of the + errata for FreeBSD 5.1-RELEASE can be found on the FreeBSD + Web site.

+
+ +
+
+ +

2 What's + New

+ +

This section describes many of the user-visible new or + changed features in FreeBSD since 5.0-RELEASE. It includes + items that are unique to the 5-CURRENT branch, as well as + some features that may have been recently merged to other + branches (after FreeBSD 5.0-RELEASE). The latter items are + marked as [MERGED].

+ +

Typical release note items document recent security + advisories issued after 5.0-RELEASE, new drivers or + hardware support, new commands or options, major bug fixes, + or contributed software upgrades. They may also list + changes to major ports/packages or release engineering + practices. Clearly the release notes cannot list every + single change made to FreeBSD between releases; this + document focuses primarily on security advisories, + user-visible changes, and major architectural + improvements.

+ +
+
+ +

2.1 + Security Advisories

+ +

A remotely exploitable vulnerability in CVS has been corrected with the + import of version 1.11.5. More details can be found in + security advisory FreeBSD-SA-03:01. [MERGED]

+ +

A timing-based attack on OpenSSL, which could allow a very + powerful attacker access to plaintext under certain + circumstances, has been prevented via an upgrade to OpenSSL 0.9.7. See security + advisory FreeBSD-SA-03:02 for more details. + [MERGED]

+ +

The security and performance of the ``syncookies'' + feature has been improved to decrease the chance of an + attacker being able to spoof connections. More details + are given in security advisory FreeBSD-SA-03:03. [MERGED]

+ +

Remotely-exploitable buffer overflow vulnerabilities + in sendmail have been fixed by + updating sendmail. For more + details, see security advisory FreeBSD-SA-03:04 and FreeBSD-SA-03:07. [MERGED]

+ +

A bounds-checking bug in the XDR implementation, which + could allow a remote attacker to cause a + denial-of-service, has been fixed. For more details see + security advisory FreeBSD-SA-03:05. [MERGED]

+ +

Two recently-publicized flaws in OpenSSL have been corrected. For + more details, see security advisory FreeBSD-SA-03:06. [MERGED]

+
+ +
+
+ +

2.2 Kernel + Changes

+ +

Support for the CanBe power management controller has + been added. [MERGED]

+ +

+ devfs(5) is now + mandatory; the NODEVFS option + has been removed from the set of possible kernel + configuration options.

+ +

An + ehci(4) driver + has been added; it supports the USB Enhanced Host + Controller Interface used by USB 2.0 controllers.

+ +

A minor bug in the permissions handling of /dev/tty has been fixed. As a + result, + ssh(1) can now be + used after + su(1).

+ +

A bug that caused + fstat(2) to + return 0 as the number of bytes + available to read from a TCP socket has been fixed.

+ +

A bug that caused + kqueue(2) to + report 0 as the number of bytes + available to read from a TCP socket has been fixed. The + NOTE_LOWAT flag for EVFILT_READ has been fixed.

+ +

Linux emulation mode now supports IPv6.

+ +

+ madvise(2) now + supports a MADV_PROTECT + behavior, which informs the virtual memory system that a + process is critical and should not be killed when swap + space has been exhausted. The process must be owned by + the superuser.

+ +

The tw driver for TW-523 power line interfaces (used + by X-10 home control products) has been removed. It is + currently non-functional, and would require a + considerable amount of work to make it work under + 5-CURRENT. The xten and xtend userland control programs + have also been removed.

+ +

A second process scheduler, designed to be a general + purpose scheduler with many SMP benefits, has been added + to the scheduler framework. Exactly one scheduler must be + specified in a kernel configuration. The original + scheduler may be selected using options SCHED_4BSD. The newer + (experimental) scheduler can be selected by using options SCHED_ULE.

+ +

Device major numbers are now allocated dynamically by + default. This change greatly decreases the need for a + static, centralized table of major number assignments to + device drivers (a few drivers retain their old static + major numbers for compatibility), and also reduces the + possibility of running out of device major numbers.

+ +

A partial lazy switch mechanism for in-kernel threads + has been implemented; it is designed to reduce the + overhead of short context switches (such as for interrupt + handlers) that do not involve another process. This + feature can be enabled with options LAZY_SWITCH.

+ +
+
+ +

2.2.1 + Processor/Motherboard Support

+
+ +
+
+ +

2.2.2 Boot + Loader Changes

+ +

The two parts of the boot loader (boot1 and boot2) have been combined into a + single boot file, to simplify + programs that need to write or otherwise manipulate the + boot loader.

+ +

The PC98 boot loader now has support for booting + from SCSI MO media. [MERGED]

+ +

The /modules directory + (once the default location for modules on FreeBSD 4.X) is no longer a part + of the default kern.module_path. Third-party + modules should be placed in /boot/modules.

+ +
+
+

Note: Modules designed for use with + FreeBSD 4.X are + likely to panic when loaded into a FreeBSD + 5.1-RELEASE kernel and should be used with extreme + caution.

+
+
+
+
+
+ +
+
+ +

2.2.3 + Network Interface Support

+ +

A new + axe(4) network + driver has been added. It provides support for USB + Ethernet adapters based on the ASIX Electronics AX88172 + USB 2.0 chipset.

+ +

The cm driver now supports IPX. [MERGED]

+ +

The + rue(4) network + driver has been added, providing support for Ethernet + adapters based on the RealTek RTL8150 USB to Fast + Ethernet controller chip.

+ +

A new + wlan(4) module + provides 802.11 link-layer support. The + wi(4) and + an(4) drivers + now use this facility.

+ +

A timing bug in the + xl(4) driver, + which could cause a kernel panic (or other problems) + when configuring an interface, has been fixed.

+
+ +
+
+ +

2.2.4 Network Protocols

+ +

+ ipfw(4) skipto rules can once again be + used with the log keyword. + ipfw(4) uid rules are once again + working.

+ +

It is now possible to build the FAST_IPSEC and INET6 options into the same + kernel. (They still cannot be used together, + however.)

+ +

A bug in TCP NewReno, which caused premature exit + from fast recovery when NewReno was enabled, has been + fixed. [MERGED]

+ +

TCP now has support for the ``Limited Transmit'' + mechanism proposed by RFC 3042. This feature is + intended to improve the effectiveness of TCP loss + recovery in certain circumstances. It is off by default + but can be enabled with the net.inet.tcp.rfc3042 sysctl + variable. More information can be found in + tcp(4).

+ +

TCP now has support for increased initial congestion + window sizes as described in RFC 3390. This feature can + improve the throughput of short transfers, as well as + high-bandwidth, large propagation-delay connections. It + is off by default but can be enabled with the net.inet.tcp.rfc3390 sysctl + variable. More information can be found in + tcp(4).

+ +

The IP fragment reassembly code behaves more + gracefully when receiving a large number of packet + fragments (it is designed to be more resistant to + fragment-based denial of service attacks). [MERGED]

+ +

TCP connections in the TIME_WAIT state now use a special + protocol control block that uses less space than a + full-blown TCP PCB. This allows some of the data + structures and resources used by such a connection to + be freed earlier.

+ +

It is now possible to specify the range of + ``privileged ports'' (TCP and UDP ports that require + superuser access to + bind(2) to). + The range is now specified with the net.inet.ip.portrange.reservedlow + and net.inet.ip.portrange.reservedhigh + sysctl variables, defaulting to the traditional UNIX + behavior. This feature is intended to help network + servers bind to traditionally privileged ports without + requiring superuser access. + ip(4) has more + details.

+ +

Some bugs in the non-blocking RPC code has been + fixed. As a result, + amd(8) users + are now able to mount volumes from a 5.1-RELEASE + server.

+ +

Support for XNS networking, which has not worked + correctly for almost seven years, has been removed.

+
+ +
+
+ +

2.2.5 + Disks and Storage

+ +

The + aac(4) driver + now runs free of the Giant kernel lock. This change has + given a nearly 20% performance speedup on an SMP system + running multiple I/O intensive loads.

+ +

The + ata(4) driver + now supports all known SiS chipsets. (More details can + be found in the Hardware Notes.)

+ +

The + ata(4) driver + now supports the Promise SATA150 TX2 and TX4 Serial + ATA/150 controllers.

+ +

The + ata(4) driver + now flushes devices on shutdown. This change may result + in failure messages being printed on the console for + devices that do not support flushing.

+ +

The CAM layer now has support for devices with more + than 232 blocks. (Assuming 512-byte blocks, + this means support for devices larger than 2TB.)

+ +
+
+

Note: For users upgrading across this + change, note that all userland applications that + talk to + pass(4) or + + xpt(4) + devices must be recompiled. Examples of such + programs are + camcontrol(8) + in the base system, the sysutils/cdrtools port, and + the multimedia/xmms + port.

+
+
+
+
+ +

A number of changes have been made to the + cd(4) driver. + The primary user-visible change is improved + compatibility with ATAPI/USB/Firewire CDROM drives.

+ +

+ geom(4) is now + mandatory; the NO_GEOM has + been removed from the set of kernel configuration + options.

+ +

The + iir(4) driver + has been updated; this update is believed to fix + problems detecting attached disks during + installation.

+ +

A bug in the + mly(4) driver + that caused hangs has been corrected.

+ +

Support has been added for volume labels on UFS and + UFS2 file systems. These labels are strings that can be + used to identify a volume, regardless of what device it + appears on. Labels can be set with the -L options to + newfs(8) or + tunefs(8). With + the GEOM_VOL module, volumes + can be accessed using their labels under /dev/vol.

+ +

The root file system can now be located on a + vinum(4) + volume. More information can be found in the + vinum(4) manual + page.

+ +

The wfd and wst drivers, which have been broken for + some time, have been removed.

+
+ +
+
+ +

2.2.6 File + Systems

+ +

A new DIRECTIO kernel + option enables support for read operations that bypass + the buffer cache and put data directly into a userland + buffer. This feature requires that the O_DIRECT flag is set on the file + descriptor and that both the offset and length for the + read operation are multiples of the physical media + sector size. [MERGED]

+ +

NETNCP and Netware File System Support (nwfs) are + once again working.

+ +

Bugs that could cause the unmounting of a smbfs + share to fail or cause a kernel panic have been + fixed.

+
+ +
+
+ +

2.2.7 + PCCARD Support

+
+ +
+
+ +

2.2.8 Multimedia + Support

+ +

The atspeaker.ko and pcspeaker.ko modules for the + speaker(4) + device have been renamed speaker.ko.

+
+
+ +
+
+ +

2.3 + Userland Changes

+ +

+ adduser(8) now + correctly handles setting user passwords containing + special shell characters.

+ +

+ adduser(8) now + supports a -g option to set a + user's default login group.

+ +

The + bsdlabel(8) + utility is a replacement for the older disklabel utility. + Like its predecessor, it installs, examines, or modifies + the BSD label on a disk partition, and can install + bootstrap code. Compared to disklabel, a number of + obsolete options and parameters have been retired. A new + -m option instructs + bsdlabel(8) to + use the layout suitable for a specific machine.

+ +

+ chgrp(1) and + chown(8) now, + when the owner/group is modified, print the old and new + uid/gid if the -v option is + specified more than once.

+ +

+ config(8) now + implements a nodevice kernel + configuration file directive that cancels the effect of a + device directive. The new nooption and nomakeoption directives cancel prior + options and makeoptions directives, + respectively.

+ +

The + diskinfo(8) + utility has been added to show information about a disk + device and optionally to run a naive performance + test.

+ +

The disklabel utility has been replaced by + bsdlabel(8). On + the alpha, i386, and pc98 platforms, disklabel is a link + to + bsdlabel(8).

+ +

+ dump(8) now + supports caching of disk blocks with the -C option. This can improve dump + performance at the cost of possibly missing file system + updates that occur between passes.

+ +

+ dumpfs(8) now + supports a -m flag to print file + system parameters in the form of a + newfs(8) + command.

+ +

+ elfdump(1), a + utility to display information about + elf(5) format + executable files, has been added.

+ +

+ fetch(1) uses the + .netrc support in + fetch(3) and also + supports a -N to specify an + alternate .netrc file.

+ +

+ fetch(3) now has + support for .netrc files (see + + ftp(1) for more + details).

+ +

+ ftpd(8) now + supports a -h option to disable + printing any host-specific information, such as the + ftpd(8) version + or hostname, in server messages. [MERGED]

+ +

+ ftpd(8) now + supports a -P option to specify a + port on which to listen in daemon mode. The default data + port number is now set to be one less than the control + port number, rather than being hard-coded. [MERGED]

+ +

+ ftpd(8) now + supports an extended format of the /etc/ftpchroot file. Please refer + to the + ftpchroot(5) + manpage, which is now available, for details. + [MERGED]

+ +

+ ftpd(8) now + supports login directory pathnames that specify + simultaneously a directory for + chroot(2) and + that to change to in the chrooted environment. The /./ separator is used for this + purpose, like in other FTP daemons having this feature. + It may be used in both + ftpchroot(5) and + + passwd(5). + [MERGED]

+ +

+ fwcontrol(8) now + supports -R and -S options for receiving and sending + DV streams. [MERGED]

+ +

The + gstat(8) utility + has been added to show the disk activity inside the + geom(4) + subsystem.

+ +

+ ipfw(8) now + supports enable and disable commands to control various + aspects of the operation of + ipfw(4) + (including enabling and disabling the firewall itself). + These provide a more convenient and visible interface + than the existing sysctl variables. [MERGED]

+ +

+ jail(8) now + supports a -i flag to output an + identifier for a newly-created jail.

+ +

The + jexec(8) utility + has been added to execute a command inside an existing + jail.

+ +

The + jls(8) utility + has been added to list existing jails.

+ +

+ kenv(1) has been + moved from /usr/bin to /bin to make it available at times + during system startup when only the root file system is + mounted.

+ +

+ killall(1) now + supports a -j option to kill all + processes inside a jail.

+ +

The + libgeom(3) + library has been added to allow some userland access to + the + geom(4) + subsystem.

+ +

The mac_portacl MAC policy module has been added. It + provides a simple ACL mechanism to permit users and + groups to bind ports for TCP or UDP, and is intended to + be used in conjunction with the recently-added net.inet.ip.portrange.reservedhigh + sysctl.

+ +

The MAKEDEV script is now + unnecessary, due to the mandatory presence of + devfs(5), and has + been removed.

+ +

+ mergemaster(8) + now supports a -P option to + preserve the contents of files being replaced.

+ +

+ mixer(8) can now + implement relative volume adjustments.

+ +

The + mksnap_ffs(8) + program has been added to allow easier creation of FFS + snapshots. It is a SUID-root + executable designed for use by members of the operator group.

+ +

+ mount(8) and + umount(8) now + accept a -F option to specify an + alternate + fstab(5) + file.

+ +

+ mount_nfs(8) now + supports a -c flag to avoid doing + a + connect(2) for + UDP mount points. This option must be used if the server + does not reply to requests from the standard NFS port + number 2049 or if it replies to requests using a + different IP address (which can occur if the server is + multi-homed). Setting the vfs.nfs.nfs_ip_paranoia sysctl to + 0 will make this option the + default. [MERGED]

+ +

+ mount_nfs(8) now + supports the noinet4 and noinet6 mount options to prevent NFS + mounts from using IPv4 or IPv6 respectively.

+ +

+ newfs(8) will now + create UFS2 file systems by default, unless UFS1 is + specifically requested with the -O1 option.

+ +

+ newsyslog(8) has + a number of new features. Among them:

+ +
    +
  • +

    A W flag forces + previously-started compression jobs for an entry (or + group of entries specified with the G flag) to finish before + beginning a new one. This feature is designed to + prevent system overloads caused by starting several + compression jobs on big files simultaneously. + [MERGED]

    +
    • + +
  • +

    A ``default rotate action'', to be used for files + specified for rotation but not specified in the + configuration file. [MERGED]

    +
    • + +
  • +

    A -s command-line flag to + disable sending signals to processes when rotating + files. [MERGED]

    +
    • + +
  • +

    A N configuration file + flag to indicate that no process needs to be signaled + when rotating a file. [MERGED]

    +
    • + +
  • +

    A U configuration file + flag to specify that a process group (rather than a + single process) should be signaled when rotating + files. [MERGED]

    +
    • +
+
+
+ +

+ nsdispatch(3) is + now thread-safe and implements support for Name Service + Switch (NSS) modules. NSS modules may be statically built + into libc or dynamically loaded + via + dlopen(3). They + are loaded/initialized at configuration time (i.e. when + + nsdispatch(3) is + called and + nsswitch.conf(5) + is read or re-read).

+ +

A new + pam_chroot(8) + module has been added, which does a + chroot(2) + operation for users into either a predetermined directory + or one derived from their home directory.

+ +

+ pam_ssh(8) has + been rewritten. One side effect of the rewrite is that it + now starts a separate instance of + ssh-agent(1) for + each session instead of trying to connect each session to + the agent started by the first session.

+ +

+ ping(8) now + supports a -D flag to set the + ``Don't Fragment'' bit on outgoing packets.

+ +

+ ping(8) now + supports a -M option to use ICMP + mask request or timestamp request messages instead of + ICMP echo requests.

+ +

+ ping(8) now + supports a -z flag to set the + Type of Service bits in outgoing packets.

+ +

+ pw(8) can now add + a user whose name ends with a $ + character; this change is intended to help administration + of Samba services. + [MERGED]

+ +

The format of the /etc/pwd.db and /etc/spwd.db password databases + created by + pwd_mkdb(8) is + now byte-order independent. The pre-processed password + databases can now be moved between machines of different + architectures. The format includes version numbers on + entries to ensure compatibility with old binaries.

+ +

A bug in + rand(3) that + could cause a sequence to remain stuck at 0 has been fixed. ( + rand(3) remains + unsuitable for all but trivial uses.)

+ +

+ rtld(1) now has + support for the dynamic mapping of shared object + dependencies. This optional feature is especially useful + when experimenting with different threading libraries. It + is not, however, built by default. More information on + enabling and using this feature can be found in + libmap.conf(5).

+ +

+ sem_open(3) now + correctly handles multiple opens of the same semaphore; + as a result, + sem_close(3) no + longer crashes calling programs.

+ +

The seeding algorithm used by + srandom(3) has + been strengthened.

+ +

The + swapoff(8) + command has been added to disable paging and swapping on + a device. A related + swapctl(8) + command has been added to provide an interface to + swapon(8) and + swapoff(8) + similar to other BSDs.

+ +
+
+

Note: The + swapoff(8) + feature should be considered experimental.

+
+
+
+
+ +

+ syslogd(8) now + allows multiple hosts or programs to be named in host or + program specifications in + syslog.conf(5) + files.

+ +

+ systat(1) now + includes an -ifstat display mode + that displays the network traffic going through active + interfaces on the system.

+ +

The + usbhidaction(1) + command has been added; it performs actions according to + its configuration in response to USB HID controls.

+ +

+ uudecode(1) and + + b64decode(1) now + support a -r flag for decoding + raw (or broken) files that may be missing the initial and + possibly final framing lines. [MERGED]

+ +

+ vmstat(8) has + re-implemented the -f flag, which + displays statistics on fork operations.

+ +

+ xargs(1) now + supports a -P option to execute + multiple copies of the same utility in parallel.

+ +

+ xargs(1) now + supports a -o flag to reopen /dev/tty for the child process + before executing the command. This is useful when the + child process is an interactive application.

+ +

The libkse library, + providing POSIX threading support using KSE, is now + enabled and installed by default. This library currently + supports M:N threading. Both process and system scope + threads are supported, as well as getting/setting the + concurrency level. By default, the library sets the + concurrency level to the number of CPUs in the system. + Each concurrency level correlates to a KSE, and all + process scope threads run in these KSEs. Each system + scope thread gets its own KSE in addition to those + corresponding to concurrency levels. libkse is still considered a + work-in-progress, and is not used by default. However, it + can be used as a replacement for the libc_r thread library, by + substituting -lkse instead of -pthread when linking programs.

+ +

A 1:1 threading package (where for every pthread in an + application there is one KSE and thread) has been + implemented. Under this model, the kernel handles all + thread scheduling decisions and all signal delivery. This + uses some of the common KSE code, and is a restricted + case of the M:N threading work still in progress. The libthr library implementing the + userland portion of this functionality is a drop-in + replacement for the libc_r + library. Note that libthr is + not (at this time) built by default.

+ +

The historic BSD boot scripts in /etc have been removed, in favor of + the rc.d system imported from + NetBSD (sometimes referred to + as ``rcNG''). All functionality of the historic system + has been preserved. In particular, files such as /etc/rc.conf continue to be the + recommended means of configuring the system startup. The + rc.d system has been the + default since FreeBSD 5.0-RELEASE, so this change should + be largely transparent for the vast majority of users. + Users who have customized their historic-style startup + scripts should be aware that the following files have + been removed from /etc: rc.atm, rc.devfs, rc.diskless1, rc.diskless2, rc.i386, rc.alpha, rc.amd64, rc.ia64, rc.sparc64, rc.isdn, rc.network, rc.network6, rc.pccard, rc.serial, rc.syscons, rc.sysctl. + mergemaster(8), + when run, will offer to move these files out of the way + for convenience. More details can be found in + rc.subr(8).

+
+ +
+
+ +

2.4 + Contributed Software

+ +

The ACPI-CA code has been + updated from the 20021118 snapshot to the 20030228 + snapshot.

+ +

awk from Bell Labs has been + updated to a 14 March 2003 snapshot.

+ +

BIND has been updated to + version 8.3.4. [MERGED]

+ +

All of the bzip2 suite of + applications is now installed in the base system (in + particular, bzip2recover is now + built and installed). [MERGED]

+ +

CVS has been updated to + 1.11.5. [MERGED]

+ +

The DRM kernel modules have + been updated to a snapshot from the DRI CVS repository, + as of 24 April 2003. The DRM_LINUX kernel option hsa been + removed because the handler is now provided by the Linux + compatibility code.

+ +

FILE has been updated to + 3.41. [MERGED]

+ +

GCC has been updated to + 3.2.2 (release version).

+ +

The gdtoa library, for + conversions between strings and floating point, has been + imported. These sources were dated 24 March 2003.

+ +

groff (and related + utilities) have been updated from 1.18.1 to 1.19.

+ +

IPFilter has been updated + to 3.4.31. [MERGED]

+ +

The ISC DHCP client has + been updated to 3.0.1RC11. [MERGED]

+ +

The ISC DHCP client now + includes the + omshell(1) + utility and the + dhcpctl(3) + library for run-time control of the client.

+ +

Kerberos IV support (in the + form of KTH eBones) has been + removed. Users requiring this functionality can still get + it from the security/krb4 port + (or package). Kerberos IV compatibility mode for Kerberos + 5 has been removed, and the k5program userland + utilities have been renamed to kprogram.

+ +

Kerberos 5 is now built by + default in buildworld + operations. Setting MAKE_KERBEROS5 no longer has any + effect. Disabling the base system Kerberos 5 now requires + the NO_KERBEROS Makefile + variable to be set.

+ +

libpcap now has support for + selecting among multiple data link types on an + interface.

+ +

lukemftpd (not built or + installed by default) has been updated to a snapshot from + 22 January 2003.

+ +

OpenPAM has been updated + from the ``Citronella'' release to the ``Dianthus'' + release.

+ +

OpenSSH has been updated to + 3.6.1p1.

+ +

OpenSSL has been updated to + release 0.9.7a. Among other features, this release + includes support for AES and takes advantage of + crypto(4) + devices. [MERGED]

+ +

sendmail has been updated + to version 8.12.9. [MERGED]

+ +

+ tcpdump(1) has + been updated to version 3.7.2. [MERGED] It also now + supports a -L flag to list the + data link types available on an interface and a -y option to specify the data link + type to use while capturing packets.

+ +

texinfo has been updated + from 4.2 to 4.5.

+ +

The timezone database has been updated from tzdata2002d to tzdata2003a. [MERGED]

+
+ +
+
+ +

2.5 + Ports/Packages Collection Infrastructure

+ +

The one-line pkg-comment + files have been eliminated from each port skeleton; their + contents have been moved into each port's Makefile. This change reduces the + disk space and inodes used by the ports tree. + [MERGED]

+ +

When fetching distfiles for building a port, the FETCH_REGET Makefile variable can be used to + specify the number of times to try continuing to fetch a + distfile if it fails its MD5 checksum. The port + infrastructure also supports re-fetching interrupted + distfiles.

+ +

+ pkg_create(1) now + supports a -C option, which + allows packages to register a list of other packages with + which they conflict. They will refuse to install (via + pkg_add(1)) if + one of the listed packages is already present. The -f flag to + pkg_add(1) + overrides this conflict-checking.

+ +

+ pkg_info(1) now + honors the BLOCKSIZE environment + variable in its output when the -b flag is given.

+ +

+ pkg_info(1) now + implements a -Q option, which is + similar to the -q ``quiet'' + option except that it prefixes the output with the + package name.

+
+ +
+
+ +

2.6 + Release Engineering and Integration

+ +

The supported release of GNOME has been updated to 2.2.1. + [MERGED]

+ +

The supported release of KDE has been updated to 3.1.2. + [MERGED]

+ +

There is no longer a separate krb5 distribution. The Kerberos 5 + libraries and utilities have been incorporated into the + crypto distribution.

+ +

+ sysinstall(8) + once again supports installing individual components of + XFree86. Supporting changes + (not user-visible) generalize the concept of installing + parts of distributions as packages.

+ +

The supported release of XFree86 has been updated to + 4.3.0. [MERGED]

+ +

Several upgrade mechanisms designed to permit major + version upgrades from FreeBSD 2.X to 3.X and from FreeBSD 3.X to 4.X have been removed.

+
+ +
+
+ +

2.7 + Documentation

+ +

The following new articles have been added to the + documentation set: ``FreeBSD From Scratch'', ``The + Roadmap for 5-STABLE''.

+ +

A new Danish (da_DK.ISO8859-1) translation + project has been started.

+
+
+ +
+
+ +

3 + Upgrading from previous releases of FreeBSD

+ +

Users with existing FreeBSD systems are highly + encouraged to read the ``Early Adopter's Guide to FreeBSD + 5.1-RELEASE''. This document generally has the filename EARLY.TXT on the distribution media, + or any other place that the release notes can be found. It + offers some notes on upgrading, but more importantly, also + discusses some of the relative merits of upgrading to + FreeBSD 5.X versus + running FreeBSD 4.X.

+ +
+
+

Important: Upgrading FreeBSD should, of + course, only be attempted after backing up all + data and configuration files.

+
+
+
+
+
+ +

This file, and other release-related + documents, can be downloaded from ftp://ftp.FreeBSD.org/.

+ +

For questions about FreeBSD, read the + documentation + before contacting <questions@FreeBSD.org>.

+ +

All users of FreeBSD 5-CURRENT + should subscribe to the <current@FreeBSD.org> + mailing list.

+ +

For questions about this documentation, + e-mail <doc@FreeBSD.org>.

+
+
+ + + diff --git a/en/releases/5.1R/relnotes-sparc64.html b/en/releases/5.1R/relnotes-sparc64.html new file mode 100644 index 0000000000..1565c115d2 --- /dev/null +++ b/en/releases/5.1R/relnotes-sparc64.html @@ -0,0 +1,1570 @@ + + + + + FreeBSD/sparc64 5.1-RELEASE Release Notes + + + + + +
+
+

FreeBSD/sparc64 + 5.1-RELEASE Release Notes

+ +

The FreeBSD Project

+ +

Copyright © 2000, 2001, 2002, + 2003 by The FreeBSD Documentation Project

+ +

$FreeBSD: + src/release/doc/en_US.ISO8859-1/relnotes/common/new.sgml,v + 1.573 2003/05/28 21:01:22 hrs Exp $
+

+ +
+
+ + +

The release notes for FreeBSD 5.1-RELEASE contain a + summary of recent changes made to the FreeBSD base + system on the 5-CURRENT development branch. This + document lists applicable security advisories that were + issued since the last release, as well as significant + changes to the FreeBSD kernel and userland. Some brief + remarks on upgrading are also presented.

+
+
+
+
+ +
+
+
Table of Contents
+ +
1 Introduction
+ +
2 What's New
+ +
+
+
2.1 Security + Advisories
+ +
2.2 Kernel Changes
+ +
+
+
2.2.1 Processor/Motherboard + Support
+ +
2.2.2 Boot Loader + Changes
+ +
2.2.3 Network Interface + Support
+ +
2.2.4 Network + Protocols
+ +
2.2.5 Disks and + Storage
+ +
2.2.6 File Systems
+ +
2.2.7 PCCARD + Support
+ +
2.2.8 Multimedia + Support
+
+
+ +
2.3 Userland Changes
+ +
2.4 Contributed + Software
+ +
2.5 Ports/Packages Collection + Infrastructure
+ +
2.6 Release Engineering and + Integration
+ +
2.7 Documentation
+
+
+ +
3 Upgrading from previous releases + of FreeBSD
+
+
+ +
+
+ +

1 + Introduction

+ +

This document contains the release notes for FreeBSD + 5.1-RELEASE on the UltraSPARC hardware platform. It + describes recently added, changed, or deleted features of + FreeBSD. It also provides some notes on upgrading from + previous versions of FreeBSD.

+ +

This distribution of FreeBSD 5.1-RELEASE is a release + distribution. It can be found at ftp://ftp.FreeBSD.org/pub/FreeBSD/development/sparc64/ + or any of its mirrors. More information on obtaining this + (or other) release distributions of FreeBSD can be found in + the ``Obtaining FreeBSD'' appendix to the FreeBSD Handbook.

+ +

Users who are new to the 5-CURRENT series of FreeBSD + releases should also read the ``Early Adopters Guide to + FreeBSD 5.1-RELEASE''. This document can generally be found + in the same location as the release notes (either as a part + of a FreeBSD distribution or on the FreeBSD Web site). It + contains important information regarding the advantages and + disadvantages of using FreeBSD 5.1-RELEASE, as opposed to + releases based on the FreeBSD 4-STABLE development + branch.

+ +

All users are encouraged to consult the release errata + before installing FreeBSD. The errata document is updated + with ``late-breaking'' information discovered late in the + release cycle or after the release. Typically, it contains + information on known bugs, security advisories, and + corrections to documentation. An up-to-date copy of the + errata for FreeBSD 5.1-RELEASE can be found on the FreeBSD + Web site.

+
+ +
+
+ +

2 What's + New

+ +

This section describes many of the user-visible new or + changed features in FreeBSD since 5.0-RELEASE. It includes + items that are unique to the 5-CURRENT branch, as well as + some features that may have been recently merged to other + branches (after FreeBSD 5.0-RELEASE). The latter items are + marked as [MERGED].

+ +

Typical release note items document recent security + advisories issued after 5.0-RELEASE, new drivers or + hardware support, new commands or options, major bug fixes, + or contributed software upgrades. They may also list + changes to major ports/packages or release engineering + practices. Clearly the release notes cannot list every + single change made to FreeBSD between releases; this + document focuses primarily on security advisories, + user-visible changes, and major architectural + improvements.

+ +
+
+ +

2.1 + Security Advisories

+ +

A remotely exploitable vulnerability in CVS has been corrected with the + import of version 1.11.5. More details can be found in + security advisory FreeBSD-SA-03:01. [MERGED]

+ +

A timing-based attack on OpenSSL, which could allow a very + powerful attacker access to plaintext under certain + circumstances, has been prevented via an upgrade to OpenSSL 0.9.7. See security + advisory FreeBSD-SA-03:02 for more details. + [MERGED]

+ +

The security and performance of the ``syncookies'' + feature has been improved to decrease the chance of an + attacker being able to spoof connections. More details + are given in security advisory FreeBSD-SA-03:03. [MERGED]

+ +

Remotely-exploitable buffer overflow vulnerabilities + in sendmail have been fixed by + updating sendmail. For more + details, see security advisory FreeBSD-SA-03:04 and FreeBSD-SA-03:07. [MERGED]

+ +

A bounds-checking bug in the XDR implementation, which + could allow a remote attacker to cause a + denial-of-service, has been fixed. For more details see + security advisory FreeBSD-SA-03:05. [MERGED]

+ +

Two recently-publicized flaws in OpenSSL have been corrected. For + more details, see security advisory FreeBSD-SA-03:06. [MERGED]

+
+ +
+
+ +

2.2 Kernel + Changes

+ +

+ devfs(5) is now + mandatory; the NODEVFS option + has been removed from the set of possible kernel + configuration options.

+ +

A minor bug in the permissions handling of /dev/tty has been fixed. As a + result, + ssh(1) can now be + used after + su(1).

+ +

A bug that caused + fstat(2) to + return 0 as the number of bytes + available to read from a TCP socket has been fixed.

+ +

A bug that caused + kqueue(2) to + report 0 as the number of bytes + available to read from a TCP socket has been fixed. The + NOTE_LOWAT flag for EVFILT_READ has been fixed.

+ +

Linux emulation mode now supports IPv6.

+ +

+ madvise(2) now + supports a MADV_PROTECT + behavior, which informs the virtual memory system that a + process is critical and should not be killed when swap + space has been exhausted. The process must be owned by + the superuser.

+ +

A second process scheduler, designed to be a general + purpose scheduler with many SMP benefits, has been added + to the scheduler framework. Exactly one scheduler must be + specified in a kernel configuration. The original + scheduler may be selected using options SCHED_4BSD. The newer + (experimental) scheduler can be selected by using options SCHED_ULE.

+ +

Device major numbers are now allocated dynamically by + default. This change greatly decreases the need for a + static, centralized table of major number assignments to + device drivers (a few drivers retain their old static + major numbers for compatibility), and also reduces the + possibility of running out of device major numbers.

+ +
+
+ +

2.2.1 + Processor/Motherboard Support

+
+ +
+
+ +

2.2.2 Boot + Loader Changes

+ +

The /modules directory + (once the default location for modules on FreeBSD 4.X) is no longer a part + of the default kern.module_path. Third-party + modules should be placed in /boot/modules.

+ +
+
+

Note: Modules designed for use with + FreeBSD 4.X are + likely to panic when loaded into a FreeBSD + 5.1-RELEASE kernel and should be used with extreme + caution.

+
+
+
+
+
+ +
+
+ +

2.2.3 + Network Interface Support

+ +

The cm driver now supports IPX. [MERGED]

+ +

A new + wlan(4) module + provides 802.11 link-layer support. The + wi(4) and + an(4) drivers + now use this facility.

+ +

A timing bug in the + xl(4) driver, + which could cause a kernel panic (or other problems) + when configuring an interface, has been fixed.

+
+ +
+
+ +

2.2.4 Network Protocols

+ +

+ ipfw(4) skipto rules can once again be + used with the log keyword. + ipfw(4) uid rules are once again + working.

+ +

It is now possible to build the FAST_IPSEC and INET6 options into the same + kernel. (They still cannot be used together, + however.)

+ +

A bug in TCP NewReno, which caused premature exit + from fast recovery when NewReno was enabled, has been + fixed. [MERGED]

+ +

TCP now has support for the ``Limited Transmit'' + mechanism proposed by RFC 3042. This feature is + intended to improve the effectiveness of TCP loss + recovery in certain circumstances. It is off by default + but can be enabled with the net.inet.tcp.rfc3042 sysctl + variable. More information can be found in + tcp(4).

+ +

TCP now has support for increased initial congestion + window sizes as described in RFC 3390. This feature can + improve the throughput of short transfers, as well as + high-bandwidth, large propagation-delay connections. It + is off by default but can be enabled with the net.inet.tcp.rfc3390 sysctl + variable. More information can be found in + tcp(4).

+ +

The IP fragment reassembly code behaves more + gracefully when receiving a large number of packet + fragments (it is designed to be more resistant to + fragment-based denial of service attacks). [MERGED]

+ +

TCP connections in the TIME_WAIT state now use a special + protocol control block that uses less space than a + full-blown TCP PCB. This allows some of the data + structures and resources used by such a connection to + be freed earlier.

+ +

It is now possible to specify the range of + ``privileged ports'' (TCP and UDP ports that require + superuser access to + bind(2) to). + The range is now specified with the net.inet.ip.portrange.reservedlow + and net.inet.ip.portrange.reservedhigh + sysctl variables, defaulting to the traditional UNIX + behavior. This feature is intended to help network + servers bind to traditionally privileged ports without + requiring superuser access. + ip(4) has more + details.

+ +

Some bugs in the non-blocking RPC code has been + fixed. As a result, + amd(8) users + are now able to mount volumes from a 5.1-RELEASE + server.

+ +

Support for XNS networking, which has not worked + correctly for almost seven years, has been removed.

+
+ +
+
+ +

2.2.5 + Disks and Storage

+ +

The + aac(4) driver + now runs free of the Giant kernel lock. This change has + given a nearly 20% performance speedup on an SMP system + running multiple I/O intensive loads.

+ +

The + ata(4) driver + now supports all known SiS chipsets. (More details can + be found in the Hardware Notes.)

+ +

The + ata(4) driver + now supports the Promise SATA150 TX2 and TX4 Serial + ATA/150 controllers.

+ +

The + ata(4) driver + now flushes devices on shutdown. This change may result + in failure messages being printed on the console for + devices that do not support flushing.

+ +

The CAM layer now has support for devices with more + than 232 blocks. (Assuming 512-byte blocks, + this means support for devices larger than 2TB.)

+ +
+
+

Note: For users upgrading across this + change, note that all userland applications that + talk to + pass(4) or + + xpt(4) + devices must be recompiled. Examples of such + programs are + camcontrol(8) + in the base system, the sysutils/cdrtools port, and + the multimedia/xmms + port.

+
+
+
+
+ +

A number of changes have been made to the + cd(4) driver. + The primary user-visible change is improved + compatibility with ATAPI/USB/Firewire CDROM drives.

+ +

+ geom(4) is now + mandatory; the NO_GEOM has + been removed from the set of kernel configuration + options.

+ +

The + iir(4) driver + has been updated; this update is believed to fix + problems detecting attached disks during + installation.

+ +

A bug in the + mly(4) driver + that caused hangs has been corrected.

+ +

Support has been added for volume labels on UFS and + UFS2 file systems. These labels are strings that can be + used to identify a volume, regardless of what device it + appears on. Labels can be set with the -L options to + newfs(8) or + tunefs(8). With + the GEOM_VOL module, volumes + can be accessed using their labels under /dev/vol.

+ +

The root file system can now be located on a + vinum(4) + volume. More information can be found in the + vinum(4) manual + page.

+
+ +
+
+ +

2.2.6 File + Systems

+ +

A new DIRECTIO kernel + option enables support for read operations that bypass + the buffer cache and put data directly into a userland + buffer. This feature requires that the O_DIRECT flag is set on the file + descriptor and that both the offset and length for the + read operation are multiples of the physical media + sector size. [MERGED]

+ +

NETNCP and Netware File System Support (nwfs) are + once again working.

+ +

Bugs that could cause the unmounting of a smbfs + share to fail or cause a kernel panic have been + fixed.

+
+ +
+
+ +

2.2.7 + PCCARD Support

+
+ +
+
+ +

2.2.8 Multimedia + Support

+
+
+ +
+
+ +

2.3 + Userland Changes

+ +

+ adduser(8) now + correctly handles setting user passwords containing + special shell characters.

+ +

+ adduser(8) now + supports a -g option to set a + user's default login group.

+ +

The + bsdlabel(8) + utility is a replacement for the older disklabel utility. + Like its predecessor, it installs, examines, or modifies + the BSD label on a disk partition, and can install + bootstrap code. Compared to disklabel, a number of + obsolete options and parameters have been retired. A new + -m option instructs + bsdlabel(8) to + use the layout suitable for a specific machine.

+ +

+ chgrp(1) and + chown(8) now, + when the owner/group is modified, print the old and new + uid/gid if the -v option is + specified more than once.

+ +

+ config(8) now + implements a nodevice kernel + configuration file directive that cancels the effect of a + device directive. The new nooption and nomakeoption directives cancel prior + options and makeoptions directives, + respectively.

+ +

The + diskinfo(8) + utility has been added to show information about a disk + device and optionally to run a naive performance + test.

+ +

The disklabel utility has been replaced by + bsdlabel(8). On + the alpha, i386, and pc98 platforms, disklabel is a link + to + bsdlabel(8).

+ +

+ dump(8) now + supports caching of disk blocks with the -C option. This can improve dump + performance at the cost of possibly missing file system + updates that occur between passes.

+ +

+ dumpfs(8) now + supports a -m flag to print file + system parameters in the form of a + newfs(8) + command.

+ +

+ elfdump(1), a + utility to display information about + elf(5) format + executable files, has been added.

+ +

+ fetch(1) uses the + .netrc support in + fetch(3) and also + supports a -N to specify an + alternate .netrc file.

+ +

+ fetch(3) now has + support for .netrc files (see + + ftp(1) for more + details).

+ +

+ ftpd(8) now + supports a -h option to disable + printing any host-specific information, such as the + ftpd(8) version + or hostname, in server messages. [MERGED]

+ +

+ ftpd(8) now + supports a -P option to specify a + port on which to listen in daemon mode. The default data + port number is now set to be one less than the control + port number, rather than being hard-coded. [MERGED]

+ +

+ ftpd(8) now + supports an extended format of the /etc/ftpchroot file. Please refer + to the + ftpchroot(5) + manpage, which is now available, for details. + [MERGED]

+ +

+ ftpd(8) now + supports login directory pathnames that specify + simultaneously a directory for + chroot(2) and + that to change to in the chrooted environment. The /./ separator is used for this + purpose, like in other FTP daemons having this feature. + It may be used in both + ftpchroot(5) and + + passwd(5). + [MERGED]

+ +

+ fwcontrol(8) now + supports -R and -S options for receiving and sending + DV streams. [MERGED]

+ +

The + gstat(8) utility + has been added to show the disk activity inside the + geom(4) + subsystem.

+ +

+ ipfw(8) now + supports enable and disable commands to control various + aspects of the operation of + ipfw(4) + (including enabling and disabling the firewall itself). + These provide a more convenient and visible interface + than the existing sysctl variables. [MERGED]

+ +

+ jail(8) now + supports a -i flag to output an + identifier for a newly-created jail.

+ +

The + jexec(8) utility + has been added to execute a command inside an existing + jail.

+ +

The + jls(8) utility + has been added to list existing jails.

+ +

+ kenv(1) has been + moved from /usr/bin to /bin to make it available at times + during system startup when only the root file system is + mounted.

+ +

+ killall(1) now + supports a -j option to kill all + processes inside a jail.

+ +

The + libgeom(3) + library has been added to allow some userland access to + the + geom(4) + subsystem.

+ +

The mac_portacl MAC policy module has been added. It + provides a simple ACL mechanism to permit users and + groups to bind ports for TCP or UDP, and is intended to + be used in conjunction with the recently-added net.inet.ip.portrange.reservedhigh + sysctl.

+ +

The MAKEDEV script is now + unnecessary, due to the mandatory presence of + devfs(5), and has + been removed.

+ +

+ mergemaster(8) + now supports a -P option to + preserve the contents of files being replaced.

+ +

+ mixer(8) can now + implement relative volume adjustments.

+ +

The + mksnap_ffs(8) + program has been added to allow easier creation of FFS + snapshots. It is a SUID-root + executable designed for use by members of the operator group.

+ +

+ mount(8) and + umount(8) now + accept a -F option to specify an + alternate + fstab(5) + file.

+ +

+ mount_nfs(8) now + supports a -c flag to avoid doing + a + connect(2) for + UDP mount points. This option must be used if the server + does not reply to requests from the standard NFS port + number 2049 or if it replies to requests using a + different IP address (which can occur if the server is + multi-homed). Setting the vfs.nfs.nfs_ip_paranoia sysctl to + 0 will make this option the + default. [MERGED]

+ +

+ mount_nfs(8) now + supports the noinet4 and noinet6 mount options to prevent NFS + mounts from using IPv4 or IPv6 respectively.

+ +

+ newfs(8) will now + create UFS2 file systems by default, unless UFS1 is + specifically requested with the -O1 option.

+ +

+ newsyslog(8) has + a number of new features. Among them:

+ +
    +
  • +

    A W flag forces + previously-started compression jobs for an entry (or + group of entries specified with the G flag) to finish before + beginning a new one. This feature is designed to + prevent system overloads caused by starting several + compression jobs on big files simultaneously. + [MERGED]

    +
    • + +
  • +

    A ``default rotate action'', to be used for files + specified for rotation but not specified in the + configuration file. [MERGED]

    +
    • + +
  • +

    A -s command-line flag to + disable sending signals to processes when rotating + files. [MERGED]

    +
    • + +
  • +

    A N configuration file + flag to indicate that no process needs to be signaled + when rotating a file. [MERGED]

    +
    • + +
  • +

    A U configuration file + flag to specify that a process group (rather than a + single process) should be signaled when rotating + files. [MERGED]

    +
    • +
+
+
+ +

+ nsdispatch(3) is + now thread-safe and implements support for Name Service + Switch (NSS) modules. NSS modules may be statically built + into libc or dynamically loaded + via + dlopen(3). They + are loaded/initialized at configuration time (i.e. when + + nsdispatch(3) is + called and + nsswitch.conf(5) + is read or re-read).

+ +

A new + pam_chroot(8) + module has been added, which does a + chroot(2) + operation for users into either a predetermined directory + or one derived from their home directory.

+ +

+ pam_ssh(8) has + been rewritten. One side effect of the rewrite is that it + now starts a separate instance of + ssh-agent(1) for + each session instead of trying to connect each session to + the agent started by the first session.

+ +

+ ping(8) now + supports a -D flag to set the + ``Don't Fragment'' bit on outgoing packets.

+ +

+ ping(8) now + supports a -M option to use ICMP + mask request or timestamp request messages instead of + ICMP echo requests.

+ +

+ ping(8) now + supports a -z flag to set the + Type of Service bits in outgoing packets.

+ +

+ pw(8) can now add + a user whose name ends with a $ + character; this change is intended to help administration + of Samba services. + [MERGED]

+ +

The format of the /etc/pwd.db and /etc/spwd.db password databases + created by + pwd_mkdb(8) is + now byte-order independent. The pre-processed password + databases can now be moved between machines of different + architectures. The format includes version numbers on + entries to ensure compatibility with old binaries.

+ +

A bug in + rand(3) that + could cause a sequence to remain stuck at 0 has been fixed. ( + rand(3) remains + unsuitable for all but trivial uses.)

+ +

+ rtld(1) now has + support for the dynamic mapping of shared object + dependencies. This optional feature is especially useful + when experimenting with different threading libraries. It + is not, however, built by default. More information on + enabling and using this feature can be found in + libmap.conf(5).

+ +

+ sem_open(3) now + correctly handles multiple opens of the same semaphore; + as a result, + sem_close(3) no + longer crashes calling programs.

+ +

The seeding algorithm used by + srandom(3) has + been strengthened.

+ +

The sunlabel utility, a program analogous to + bsdlabel(8) that + works on Sun disk labels, has been added.

+ +

+ sysinstall(8) + will now select UFS2 as the default layout for new file + systems unless specifically requested in the disk + labeler.

+ +

The + swapoff(8) + command has been added to disable paging and swapping on + a device. A related + swapctl(8) + command has been added to provide an interface to + swapon(8) and + swapoff(8) + similar to other BSDs.

+ +
+
+

Note: The + swapoff(8) + feature should be considered experimental.

+
+
+
+
+ +

+ syslogd(8) now + allows multiple hosts or programs to be named in host or + program specifications in + syslog.conf(5) + files.

+ +

+ systat(1) now + includes an -ifstat display mode + that displays the network traffic going through active + interfaces on the system.

+ +

The + usbhidaction(1) + command has been added; it performs actions according to + its configuration in response to USB HID controls.

+ +

+ uudecode(1) and + + b64decode(1) now + support a -r flag for decoding + raw (or broken) files that may be missing the initial and + possibly final framing lines. [MERGED]

+ +

+ vmstat(8) has + re-implemented the -f flag, which + displays statistics on fork operations.

+ +

+ xargs(1) now + supports a -P option to execute + multiple copies of the same utility in parallel.

+ +

+ xargs(1) now + supports a -o flag to reopen /dev/tty for the child process + before executing the command. This is useful when the + child process is an interactive application.

+ +

A 1:1 threading package (where for every pthread in an + application there is one KSE and thread) has been + implemented. Under this model, the kernel handles all + thread scheduling decisions and all signal delivery. This + uses some of the common KSE code, and is a restricted + case of the M:N threading work still in progress. The libthr library implementing the + userland portion of this functionality is a drop-in + replacement for the libc_r + library. Note that libthr is + not (at this time) built by default.

+ +

The historic BSD boot scripts in /etc have been removed, in favor of + the rc.d system imported from + NetBSD (sometimes referred to + as ``rcNG''). All functionality of the historic system + has been preserved. In particular, files such as /etc/rc.conf continue to be the + recommended means of configuring the system startup. The + rc.d system has been the + default since FreeBSD 5.0-RELEASE, so this change should + be largely transparent for the vast majority of users. + Users who have customized their historic-style startup + scripts should be aware that the following files have + been removed from /etc: rc.atm, rc.devfs, rc.diskless1, rc.diskless2, rc.i386, rc.alpha, rc.amd64, rc.ia64, rc.sparc64, rc.isdn, rc.network, rc.network6, rc.pccard, rc.serial, rc.syscons, rc.sysctl. + mergemaster(8), + when run, will offer to move these files out of the way + for convenience. More details can be found in + rc.subr(8).

+
+ +
+
+ +

2.4 + Contributed Software

+ +

The ACPI-CA code has been + updated from the 20021118 snapshot to the 20030228 + snapshot.

+ +

awk from Bell Labs has been + updated to a 14 March 2003 snapshot.

+ +

BIND has been updated to + version 8.3.4. [MERGED]

+ +

All of the bzip2 suite of + applications is now installed in the base system (in + particular, bzip2recover is now + built and installed). [MERGED]

+ +

CVS has been updated to + 1.11.5. [MERGED]

+ +

FILE has been updated to + 3.41. [MERGED]

+ +

GCC has been updated to + 3.2.2 (release version).

+ +

The gdtoa library, for + conversions between strings and floating point, has been + imported. These sources were dated 24 March 2003.

+ +

groff (and related + utilities) have been updated from 1.18.1 to 1.19.

+ +

IPFilter has been updated + to 3.4.31. [MERGED]

+ +

The ISC DHCP client has + been updated to 3.0.1RC11. [MERGED]

+ +

The ISC DHCP client now + includes the + omshell(1) + utility and the + dhcpctl(3) + library for run-time control of the client.

+ +

Kerberos IV support (in the + form of KTH eBones) has been + removed. Users requiring this functionality can still get + it from the security/krb4 port + (or package). Kerberos IV compatibility mode for Kerberos + 5 has been removed, and the k5program userland + utilities have been renamed to kprogram.

+ +

Kerberos 5 is now built by + default in buildworld + operations. Setting MAKE_KERBEROS5 no longer has any + effect. Disabling the base system Kerberos 5 now requires + the NO_KERBEROS Makefile + variable to be set.

+ +

libpcap now has support for + selecting among multiple data link types on an + interface.

+ +

lukemftpd (not built or + installed by default) has been updated to a snapshot from + 22 January 2003.

+ +

OpenPAM has been updated + from the ``Citronella'' release to the ``Dianthus'' + release.

+ +

OpenSSH has been updated to + 3.6.1p1.

+ +

OpenSSL has been updated to + release 0.9.7a. Among other features, this release + includes support for AES and takes advantage of + crypto(4) + devices. [MERGED]

+ +

sendmail has been updated + to version 8.12.9. [MERGED]

+ +

+ tcpdump(1) has + been updated to version 3.7.2. [MERGED] It also now + supports a -L flag to list the + data link types available on an interface and a -y option to specify the data link + type to use while capturing packets.

+ +

texinfo has been updated + from 4.2 to 4.5.

+ +

The timezone database has been updated from tzdata2002d to tzdata2003a. [MERGED]

+
+ +
+
+ +

2.5 + Ports/Packages Collection Infrastructure

+ +

The one-line pkg-comment + files have been eliminated from each port skeleton; their + contents have been moved into each port's Makefile. This change reduces the + disk space and inodes used by the ports tree. + [MERGED]

+ +

When fetching distfiles for building a port, the FETCH_REGET Makefile variable can be used to + specify the number of times to try continuing to fetch a + distfile if it fails its MD5 checksum. The port + infrastructure also supports re-fetching interrupted + distfiles.

+ +

+ pkg_create(1) now + supports a -C option, which + allows packages to register a list of other packages with + which they conflict. They will refuse to install (via + pkg_add(1)) if + one of the listed packages is already present. The -f flag to + pkg_add(1) + overrides this conflict-checking.

+ +

+ pkg_info(1) now + honors the BLOCKSIZE environment + variable in its output when the -b flag is given.

+ +

+ pkg_info(1) now + implements a -Q option, which is + similar to the -q ``quiet'' + option except that it prefixes the output with the + package name.

+
+ +
+
+ +

2.6 + Release Engineering and Integration

+ +

The supported release of GNOME has been updated to 2.2.1. + [MERGED]

+ +

The supported release of KDE has been updated to 3.1.2. + [MERGED]

+ +

There is no longer a separate krb5 distribution. The Kerberos 5 + libraries and utilities have been incorporated into the + crypto distribution.

+ +

+ sysinstall(8) + once again supports installing individual components of + XFree86. Supporting changes + (not user-visible) generalize the concept of installing + parts of distributions as packages.

+ +

The supported release of XFree86 has been updated to + 4.3.0. [MERGED]

+ +

Several upgrade mechanisms designed to permit major + version upgrades from FreeBSD 2.X to 3.X and from FreeBSD 3.X to 4.X have been removed.

+
+ +
+
+ +

2.7 + Documentation

+ +

The following new articles have been added to the + documentation set: ``FreeBSD From Scratch'', ``The + Roadmap for 5-STABLE''.

+ +

A new Danish (da_DK.ISO8859-1) translation + project has been started.

+
+
+ +
+
+ +

3 + Upgrading from previous releases of FreeBSD

+ +

Users with existing FreeBSD systems are highly + encouraged to read the ``Early Adopter's Guide to FreeBSD + 5.1-RELEASE''. This document generally has the filename EARLY.TXT on the distribution media, + or any other place that the release notes can be found. It + offers some notes on upgrading, but more importantly, also + discusses some of the relative merits of upgrading to + FreeBSD 5.X versus + running FreeBSD 4.X.

+ +
+
+

Important: Upgrading FreeBSD should, of + course, only be attempted after backing up all + data and configuration files.

+
+
+
+
+
+ +

This file, and other release-related + documents, can be downloaded from ftp://ftp.FreeBSD.org/pub/FreeBSD/development/sparc64/.

+ +

For questions about FreeBSD, read the + documentation + before contacting <questions@FreeBSD.org>.

+ +

All users of FreeBSD 5-CURRENT + should subscribe to the <current@FreeBSD.org> + mailing list.

+ +

For questions about this documentation, + e-mail <doc@FreeBSD.org>.

+
+
+ + + diff --git a/en/releases/5.1R/relnotes.sgml b/en/releases/5.1R/relnotes.sgml new file mode 100644 index 0000000000..7bc32ff59e --- /dev/null +++ b/en/releases/5.1R/relnotes.sgml @@ -0,0 +1,29 @@ + + + + %includes; +]> + + &header; + +

The release notes for FreeBSD are customized for different + platforms, as some of the changes made to FreeBSD apply only to + specific processor architectures.

+ +

Release notes for FreeBSD 5.1-RELEASE are available for the following + platforms:

+ + + +

A list of all platforms currently under development can be found + on the Supported + Platforms page.

+ +