Welcome to 3.2-RELEASE, a full follow-on to the 3.1-RELEASE
released February 1999 and which marked the beginning of the
3.0-STABLE branch. In the 4 months since 3.1 was released, many
hundreds of bug fixes and general enhancements were made to the
system. Please see relevant details below.
Any installation failures or crashes should be reported by using the
send-pr command (those preferring a WEB based interface can also see
For information about FreeBSD and the layout of the 3.2-RELEASE
directory (especially if you're installing from floppies!), see
ABOUT.TXT. For installation instructions, see the INSTALL.TXT and
Table of contents:
1. What's new since 3.1-RELEASE
1.1 KERNEL CHANGES
1.2 SECURITY FIXES
1.3 USERLAND CHANGES
2. Supported Configurations
2.1 Disk Controllers
2.2 Ethernet cards
3. Obtaining FreeBSD
4. Upgrading from previous releases of FreeBSD
5. Reporting problems, making suggestions, submitting code
1. What's new since 3.1-RELEASE
1.1. KERNEL CHANGES
Added driver support for PCI gigabit ethernet adapters based on
the Alteon Networks Tigon 1 and Tigon 2 chipsets, including the
Alteon AceNIC, 3Com 3c985 and Netgear GA620.
Support for USB devices further improved.
Support has been added for direct access to NTFS filesystems.
Support has been added for Joliet extensions on ISO 9660 filesystems.
Only iso8859-1 characters (latin-1) are supported at this time, though.
Support has been added for Adaptec 2930U2 and 3950U2 SCSI cards.
There have been a couple of kernel changes that will break the binary
interface for clients of the CAM passthrough interface or the devstat(9)
statistics interface. These changes were made to fix some interface
deficiencies. We regret any inconvenience this will cause, but we
anticipate that this will have minimal impact as there are no known
commercial binary-only applications that use either interface. This will
require that programs that use those two interfaces be recompiled. Ports
that use the CAM interface include xmcd, tosha, SANE, cdrecord and cdda2wav.
Ports that use the devstat interface include xsysinfo and xperfmon.
1.2. SECURITY FIXES
Descriptor leak bug which was potentially open to a denial of service attack
(by local users) was closed. REF: KKIS.05051999.003b
1.3. USERLAND CHANGES
The Internet Software Consortium's DHCP client has been added to the
Sendmail upgraded to version 8.9.3.
Tar now supports compressing via bzip2 with the new
TCP Wrappers is now part of the base system. inetd, the port mapper,
and sendmail are now linked agaist libwrap. The "PROCESS_OPTIONS"
syntax is the default. Note that you do not need to use tcpd in
/etc/inetd.conf. See `man 5 hosts_options' and `man 8 inetd` for
Gdb has been updated to version 4.18 and is now part of the standard
release for FreeBSD/alpha.
Camcontrol now allows users to view the number of tagged openings for
any given device, and allows users to set the number of tagged openings
for any device that supports tagged queueing.
Camcontrol also now allows users to change SCSI negotiation parameters
(e.g. sync rate, offset, bus width, disconnection) for devices on certain
controllers. Note that this feature is only fully functional for Adaptec
7xxx series controllers, Advansys narrow controllers and NCR/Symbios
Systat, vmstat, and iostat now print out statistics in a more "interesting"
order based on "importance" of the device vs. the probe order.
And quite a number of bugs, both in the user and kernel, fixed as
a result of user feedback for 3.1-RELEASE.
2. Supported Configurations
FreeBSD currently runs on a wide variety of ISA, VLB, EISA and PCI bus
based PC's, ranging from 386sx to Pentium class machines (though the
386sx is not recommended). Support for generic IDE or ESDI drive
configurations, various SCSI controller, network and serial cards is
What follows is a list of all peripherals currently known to work with
FreeBSD. Other configurations may also work, we have simply not as yet
received confirmation of this.
2.1. Disk Controllers
WD1003 (any generic MFM/RLL)
WD1007 (any generic IDE/ESDI)
Adaptec 1535 ISA SCSI controllers
Adaptec 154x series ISA SCSI controllers
Adaptec 174x series EISA SCSI controller in standard and enhanced mode.
Adaptec 274X/284X/2920C/2930U2/294x/2950/3940/3950 (Narrow/Wide/Twin) series
EISA/VLB/PCI SCSI controllers.
Adaptec AIC7850, AIC7860, AIC7880, AIC789x, on-board SCSI controllers.
AdvanSys SCSI controllers (all models).
BusLogic MultiMaster controllers:
[ Please note that BusLogic/Mylex "Flashpoint" adapters are NOT yet supported ]
BusLogic MultiMaster "W" Series Host Adapters:
BT-948, BT-958, BT-958D
BusLogic MultiMaster "C" Series Host Adapters:
BT-946C, BT-956C, BT-956CD, BT-445C, BT-747C, BT-757C, BT-757CD, BT-545C,
BusLogic MultiMaster "S" Series Host Adapters:
BT-445S, BT-747S, BT-747D, BT-757S, BT-757D, BT-545S, BT-542D, BT-742A,
BusLogic MultiMaster "A" Series Host Adapters:
AMI FastDisk controllers that are true BusLogic MultiMaster clones are also
DPT SmartCACHE Plus, SmartCACHE III, SmartRAID III, SmartCACHE IV and
SmartRAID IV SCSI/RAID controllers are supported. The DPT SmartRAID/CACHE V
is not yet supported.
SymBios (formerly NCR) 53C810, 53C810a, 53C815, 53C820, 53C825a,
53C860, 53C875, 53C875j, 53C885, 53C895 and 53C896 PCI SCSI controllers:
Data Technology DTC3130 (all variants)
Diamond FirePort (all)
NCR cards (all)
Symbios cards (all)
Tekram DC390W, 390U and 390F
QLogic 1020, 1040, 1040B, 1080 and 1240 SCSI Host Adapters.
QLogic 2100 Fibre Channel Adapters (private loop only).
DTC 3290 EISA SCSI controller in 1542 emulation mode.
With all supported SCSI controllers, full support is provided for
SCSI-I & SCSI-II peripherals, including hard disks, optical disks,
tape drives (including DAT and 8mm Exabyte), medium changers, processor
target devices and CDROM drives. WORM devices that support CDROM commands
are supported for read-only access by the CDROM driver. WORM/CD-R/CD-RW
writing support is provided by cdrecord, which is in the ports tree.
The following CD-ROM type systems are supported at this time:
(cd) SCSI interface (also includes ProAudio Spectrum and
(matcd) Matsushita/Panasonic (Creative SoundBlaster) proprietary
interface (562/563 models)
(scd) Sony proprietary interface (all models)
(wcd) ATAPI IDE interface
The following drivers were supported under the old SCSI subsystem, but are
NOT YET supported under the new CAM SCSI subsystem:
Tekram DC390 and DC390T controllers (maybe other cards based on the
AMD 53c974 as well).
NCR5380/NCR53400 ("ProAudio Spectrum") SCSI controller.
UltraStor 14F, 24F and 34F SCSI controllers.
Seagate ST01/02 SCSI controllers.
Future Domain 8xx/950 series SCSI controllers.
WD7000 SCSI controller.
Adaptec 1510 series ISA SCSI controllers (not for bootable devices)
Adaptec 152x series ISA SCSI controllers
Adaptec AIC-6260 and AIC-6360 based boards, which includes the AHA-152x
and SoundBlaster SCSI cards.
[ Note: There is work-in-progress to port the AIC-6260/6360 and
UltraStor drivers to the new CAM SCSI framework, but no estimates on
when or if they will be completed. ]
Unmaintained drivers, they might or might not work for your hardware:
Floppy tape interface (Colorado/Mountain/Insight)
(mcd) Mitsumi proprietary CD-ROM interface (all models)
2.2. Ethernet cards
Allied-Telesis AT1700 and RE2000 cards
Alteon Networks PCI gigabit ethernet NICs based on the Tigon 1 and Tigon 2
chipsets, including the following:
Alteon AceNIC (Tigon 1 and 2)
3Com 3c985-SX (Tigon 1 and 2)
Netgear GA620 (Tigon 2)
Silicon Graphics Gigabit Ethernet
DEC/Compaq EtherWORKS 1000
NEC Gigabit Ethernet
AMD PCnet/PCI (79c970 & 53c974 or 79c974)
SMC Elite 16 WD8013 ethernet interface, and most other WD8003E,
WD8003EBT, WD8003W, WD8013W, WD8003S, WD8003SBT and WD8013EBT
based clones. SMC Elite Ultra. SMC Etherpower II.
RealTek 8129/8139 fast ethernet NICs including the following:
Allied Telesyn AT2550
Allied Telesyn AT2500TX
Genius GF100TXR (RTL8139)
NDC Communications NE100TX-E
Netronix Inc. EA-1210 NetEther 10/100
KTX-9130TX 10/100 Fast Ethernet
Accton "Cheetah" EN1027D (MPX 5030/5038; RealTek 8139 clone?)
SMC EZ Card 10/100 PCI 1211-TX
Lite-On 82c168/82c169 PNIC fast ethernet NICs including the following:
LinkSys EtherFast LNE100TX
NetGear FA310-TX Rev. D1
Matrox FastNIC 10/100
Macronix 98713, 98713A, 98715, 98715A and 98725 fast ethernet NICs
NDC Communications SFA100A (98713A)
CNet Pro120A (98713 or 98713A)
CNet Pro120B (98715)
SVEC PN102TX (98713)
Winbond W89C840F fast ethernet NICs including the following:
VIA Technologies VT3043 "Rhine I" and VT86C100A "Rhine II" fast ethernet
NICs including the following:
Hawking Technologies PN102TX
Texas Instruments ThunderLAN PCI NICs, including the following:
Compaq Netelligent 10, 10/100, 10/100 Proliant, 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
ASIX Electronics AX88140A PCI NICs, including the following:
Alfa Inc. GFC2204
DEC EtherWORKS III NICs (DE203, DE204, and DE205)
DEC EtherWORKS II NICs (DE200, DE201, DE202, and DE422)
DEC DC21040, DC21041, or DC21140 based NICs (SMC Etherpower 8432T, DE245, etc)
DEC FDDI (DEFPA/DEFEA) NICs
HP PC Lan+ cards (model numbers: 27247B and 27252A).
Intel EtherExpress 16
Intel EtherExpress Pro/10
Intel EtherExpress Pro/100B PCI Fast Ethernet
Isolan AT 4141-0 (16 bit)
Isolink 4110 (8 bit)
Novell NE1000, NE2000, and NE2100 ethernet interface.
PCI network cards emulating the NE2000: RealTek 8029, NetVin 5000,
Winbond W89C940, Surecom NE-34, VIA VT86C926.
3Com 3C501 cards
3Com 3C503 Etherlink II
3Com 3c505 Etherlink/+
3Com 3C507 Etherlink 16/TP
3Com 3C509, 3C579, 3C589 (PCMCIA), 3C590/592/595/900/905/905B PCI and EISA
(Fast) Etherlink III / (Fast) Etherlink XL
3Com 3c980 Fast Etherlink XL server adapter
Toshiba ethernet cards
Crystal Semiconductor CS89x0-based NICs, including:
IBM Etherjet ISA
PCMCIA ethernet cards from IBM and National Semiconductor are also
Note that NO token ring cards are supported at this time as we're
still waiting for someone to donate a driver for one of them. Any
o ATM Host Interfaces
- FORE Systems, Inc. PCA-200E ATM PCI Adapters
- Efficient Networks, Inc. ENI-155p ATM PCI Adapters
o ATM Signalling Protocols
- The ATM Forum UNI 3.1 signalling protocol
- The ATM Forum UNI 3.0 signalling protocol
- The ATM Forum ILMI address registration
- FORE Systems's proprietary SPANS signalling protocol
- Permanent Virtual Channels (PVCs)
o IETF "Classical IP and ARP over ATM" model
- 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"
o ATM Sockets interface
AST 4 port serial card using shared IRQ.
ARNET 8 port serial card using shared IRQ.
ARNET (now Digiboard) Sync 570/i high-speed serial.
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.
Cyclades Cyclom-y Serial Board.
STB 4 port card using shared IRQ.
SDL Communications Riscom/8 Serial Board.
SDL Communications RISCom/N2 and N2pci high-speed sync serial boards.
Stallion multiport serial boards: EasyIO, EasyConnection 8/32 & 8/64,
ONboard 4/16 and Brumby.
Specialix SI/XIO/SX ISA, EISA and PCI serial expansion cards/modules.
Adlib, SoundBlaster, SoundBlaster Pro, ProAudioSpectrum, Gravis UltraSound
and Roland MPU-401 sound cards. (snd driver)
Most ISA audio codecs manufactured by Crystal Semiconductors, OPTi, Creative
Labs, Avance, Yamaha and ENSONIQ. (pcm driver)
Matrox Meteor Video frame grabber
Creative Labs Video Spigot frame grabber
Cortex1 frame grabber
Hauppauge Wincast/TV boards (PCI)
STB TV PCI
Intel Smart Video Recorder III
Various Frame grabbers based on Brooktree Bt848 and Bt878 chip.
HP4020, HP6020, Philips CDD2000/CDD2660 and Plasmon CD-R drives.
Standard PC Joystick
X-10 power controllers
GPIB and Transputer drivers.
Genius and Mustek hand scanners.
Xilinx XC6200 based reconfigurable hardware cards compatible with
the HOT1 from Virtual Computers (www.vcc.com)
Support for Dave Mills experimental Loran-C receiver.
FreeBSD currently does NOT support IBM's microchannel (MCA) bus.
3. Obtaining FreeBSD
You may obtain FreeBSD in a variety of ways:
You can ftp FreeBSD and any or all of its optional packages from
`ftp.FreeBSD.org' - the official FreeBSD release site.
For other locations that mirror the FreeBSD software see the file
MIRROR.SITES. Please ftp the distribution from the site closest (in
networking terms) to you. Additional mirror sites are always welcome!
Contact freebsd-admin@FreeBSD.org for more details if you'd like to
become an official mirror site.
FreeBSD 3.2-RELEASE CDs may be ordered on CDROM from:
Walnut Creek CDROM
4041 Pike Lane, Suite F
Concord CA 94520
1-800-786-9907, +1-925-674-0783, +1-925-674-0821 (FAX)
Or via the Internet from firstname.lastname@example.org or http://www.freebsdmall.com.
Their current catalog can be obtained via ftp from:
Cost per -RELEASE CD is $39.95 or $24.95 with a FreeBSD subscription.
FreeBSD SNAPshot CDs, when available, are $39.95 or $14.95 with a
FreeBSD-SNAP subscription (-RELEASE and -SNAP subscriptions are entirely
separate). With a subscription, you will automatically receive updates as
they are released. Your credit card will be billed when each disk is
shipped and you may cancel your subscription at any time without further
Shipping (per order not per disc) is $5 in the US, Canada or Mexico
and $9.00 overseas. They accept Visa, Mastercard, Discover, American
Express or checks in U.S. Dollars and ship COD within the United
States. California residents please add 8.25% sales tax.
Should you be dissatisfied for any reason, the CD comes with an
unconditional return policy.
4. Upgrading from previous releases of FreeBSD
If you're upgrading from a previous release of FreeBSD, most likely
it's 2.2.x or 2.1.x (in some lesser number of cases) and some of the
following issues may affect you, depending of course on your chosen
method of upgrading. There are two popular ways of upgrading
o Using sources, via /usr/src
o Using sysinstall's (binary) upgrade option.
In the case of using sources, there are simply two targets you need to
be aware of: The standard ``upgrade'' target, which will upgrade a 2.x
or 3.0 system to 3.2 and the ``world'' target, which will take an
already upgraded system and keep it in sync with whatever changes have
happened since the initial upgrade.
In the case of using the binary upgrade option, the system will go
straight to 3.2/ELF but also populate the /<basepath>/lib/aout
directories for backwards compatibility with older binaries.
In either case, going to ELF will mean that you'll have somewhat
smaller binaries and access to a lot more compiler goodies which have
been already been ported to other ELF environments (our older and
somewhat crufty a.out format being largely unsupported by most other
software projects). Those who wish to retain access to the older
a.out dynamic executables should be sure and install the compat22
distribution. Notice that the a.out libraries won't be accessible
until the system is rebooted, which may cause trouble with certain
Also, do not use install disks or sysinstall from previous versions,
as version 3.1 introduced a new bootstrapping procedure, requiring
new boot blocks to be installed (because of elf kernels), and version
3.2 has further modifications to the bootstrapping procedure.
[ other important upgrading notes should go here]
5. Reporting problems, making suggestions, submitting code.
Your suggestions, bug reports and contributions of code are always
valued - please do not hesitate to report any problems you may find
(preferably with a fix attached, if you can!).
The preferred method to submit bug reports from a machine with
Internet mail connectivity is to use the send-pr command or use the CGI
script at http://www.FreeBSD.org/send-pr.html. Bug reports
will be dutifully filed by our faithful bugfiler program and you can
be sure that we'll do our best to respond to all reported bugs as soon
as possible. Bugs filed in this way are also visible on our WEB site
in the support section and are therefore valuable both as bug reports
and as "signposts" for other users concerning potential problems to
watch out for.
If, for some reason, you are unable to use the send-pr command to
submit a bug report, you can try to send it to:
Note that send-pr itself is a shell script that should be easy to move
even onto a totally different system. We much prefer if you could use
this interface, since it make it easier to keep track of the problem
reports. However, before submitting, please try to make sure whether
the problem might have already been fixed since.
Otherwise, for any questions or tech support issues, please send mail to:
Additionally, being a volunteer effort, we are always happy to have
extra hands willing to help - there are already far more desired
enhancements than we'll ever be able to manage by ourselves! To
contact us on technical matters, or with offers of help, please send
Please note that these mailing lists can experience *significant*
amounts of traffic and if you have slow or expensive mail access and
are only interested in keeping up with significant FreeBSD events, you
may find it preferable to subscribe instead to:
All of the mailing lists can be freely joined by anyone wishing
to do so. Send mail to MajorDomo@FreeBSD.org and include the keyword
`help' on a line by itself somewhere in the body of the message. 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, so send mail to majordomo
and ask about them!
FreeBSD represents the cumulative work of many dozens, if not
hundreds, of individuals from around the world who have worked very
hard to bring you this release. For a complete list of FreeBSD
project staffers, please see:
or, if you've loaded the doc distribution:
Special mention to:
The donors listed at http://www.FreeBSD.org/handbook/donors.html
And to the many thousands of FreeBSD users and testers all over the
world, without whom this release simply would not have been possible.
We sincerely hope you enjoy this release of FreeBSD!
The FreeBSD Project