VERY preliminary versions of these documents for the Alpha. I've

made only the most superficial changes so far to HARDWARE.TXT and
eliminated the stuff I absolutely knew didn't work.  That still leaves
a lot of work to do and this is mostly just a place-holder for now.
This commit is contained in:
jkh 1999-09-06 15:10:54 +00:00
parent 6a139b5982
commit 2dd43ec810
2 changed files with 1266 additions and 0 deletions

View File

@ -0,0 +1,619 @@
Table of Contents
-----------------
0. Document Conventions
1. Default Configuration (GENERIC kernel)
2. LINT - other possible configurations
3. Supported Hardware
See TROUBLE.TXT for Q&A on known hardware problems.
=========================================================================
0. Document Conventions
-- --------------------
We have `underlined' text which represents user input with `-' symbols
throughout this document to differentiate it from the machine output.
1. Default (GENERIC) Configuration
-- -------------------------------
The following table contains a list of all of the devices that are
present in the GENERIC kernel. This is the essential part of the
operating system that is placed in your root partition during the
installation process. A compressed version of the GENERIC kernel is
also used on the installation floppy diskette and DOS boot image.
The table describes the various parameters used by the driver to
communicate with the hardware in your system. There are four
parameters in the table, though not all are used by each and every
device:
Port The starting I/O port used by the device, shown in hexadecimal.
IOMem The lowest (or starting) memory address used by the device,
also shown in hexadecimal.
IRQ The interrupt the device uses to alert the driver to an event,
given in decimal.
DRQ The DMA (direct memory access) channel the device uses to move
data to and from main memory, also given in decimal.
If an entry in the table has `n/a' for a value then it means that the
parameter in question does not apply to that device. A value of `dyn'
means that the correct value should be determined automatically by the
kernel when the system boots and that you don't need to worry about
it.
If an entry is marked with an *, it means that support is currently
not available for it but should be back as soon as someone converts
the driver to work within the new 3.0 framework.
FreeBSD GENERIC kernel:
Port IRQ DRQ IOMem Description
---- --- --- ----- ---------------------------------
fdc0 3f0 6 2 n/a Floppy disk controller
wdc0 1f0 14 n/a n/a IDE/MFM/RLL disk controller
wdc1 170 15 n/a n/a IDE/MFM/RLL disk controller
adv0 n/a n/a n/a n/a AdvanSys Narrow SCSI controllers
adw0 n/a n/a n/a n/a AdvanSys Wide SCSI controllers
ncr0 n/a n/a n/a n/a NCR PCI SCSI controller
bt0 330 dyn dyn dyn Buslogic SCSI controller
uha0* 330 dyn 6 dyn Ultrastore 14f
aha0 330 dyn 5 dyn Adaptec 154x/1535 SCSI controller
ahb0 dyn dyn dyn dyn Adaptec 174x SCSI controller
ahc0 dyn dyn dyn dyn Adaptec 274x/284x/294x SCSI controller
aic0* 340 11 dyn dyn Adaptec 152x/AIC-6360 SCSI
controller
isp0 dyn dyn dyn dyn QLogic 10X0, 2100 SCSI/FC controllers
dpt n/a n/a n/a n/a DPT RAID SCSI controllers.
wt0 300 5 1 dyn Wangtek and Archive QIC-02/QIC-36
psm0 60 12 n/a n/a PS/2 Mouse
mcd0 300 10 n/a n/a Mitsumi CD-ROM
matcd0 230 n/a n/a n/a Matsushita/Panasonic CD-ROM
scd0 230 n/a n/a n/a Sony CD-ROM
sio0 3f8 4 n/a n/a Serial Port 0 (COM1)
sio1 2f8 3 n/a n/a Serial Port 1 (COM2)
lpt0 dyn 7 n/a n/a Printer Port 0
lpt1 dyn dyn n/a n/a Printer Port 1
al0 dyn dyn n/a dyn ADMtek AL981 PCI based cards
ax0 dyn dyn n/a dyn ASIX AX88140A PCI based cards
de0 n/a n/a n/a n/a DEC DC21x40 PCI based cards
(including 21140 100bT cards)
dm0 n/a n/a n/a n/a Davicom DM9100/DM9102 PCI based cards
ed0 280 10 dyn d8000 WD & SMC 80xx; Novell NE1000 &
NE2000; 3Com 3C503; HP PC Lan+
eg0 310 5 dyn dyn 3Com 3C505
ep0 300 10 dyn dyn 3Com 3C509
ex0 dyn dyn dyn n/a Intel EtherExpress Pro/10 cards
fe0 300 dyn n/a n/a Allied-Telesyn AT1700, RE2000 and
Fujitsu FMV-180 series cards.
fxp0 dyn dyn n/a dyn Intel EtherExpress Pro/100B
ie0 300 10 dyn d0000 AT&T StarLAN 10 and EN100;
3Com 3C507; NI5210;
Intel EtherExpress (8/16,16[TP]) cards
le0 300 5 dyn d0000 Digital Equipment EtherWorks
2 and EtherWorks 3
lnc0 280 10 n/a dyn Lance/PCnet cards
(Isolan, Novell NE2100, NE32-VL,
some PCnet-PCI cards)
mx0 dyn dyn n/a dyn Macronix 98713/15/25 PCI based cards
pn0 dyn dyn n/a dyn Lite-On PNIC PCI based cards
rl0 dyn dyn n/a dyn RealTek 8129/8139 fast ethernet
sf0 dyn dyn n/a dyn Adaptec AIC-6915 fast ethernet
sis0 dyn dyn n/a dyn SiS 900/SiS 7016 fast ethernet
ste0 dyn dyn n/a dyn Sundance ST201 fast ethernet
tl0 dyn dyn n/a dyn TI TNET100 'ThunderLAN' cards.
wb0 dyn dyn n/a dyn Winbond W89C840F PCI based cards.
vr0 dyn dyn n/a dyn VIA VT3043/VT86C100A PCI based cards.
vx0 dyn dyn n/a dyn 3Com 3c59x ((Fast) Etherlink III)
xl0 dyn dyn n/a dyn 3Com 3c900, 3c905, 3c905B, 3c905C,
3c980, 3cSOHO100 ((Fast) Etherlink XL)
cs0 0x300 dyn n/a n/a Crystal Semiconductor CS89x0-based
cards.
ze0 300 5 n/a d8000 IBM/National Semiconductor
PCMCIA Ethernet Controller
zp0 300 10 n/a d8000 3Com 3c589 Etherlink III
PCMCIA Ethernet Controller
--- End of table ---
If the hardware in your computer is not set to the same settings as
those shown in the table and the item in conflict is not marked 'dyn',
you will have to either reconfigure your hardware or use UserConfig
to reconfigure the kernel to match the way your hardware is currently set
(see the next section).
If the settings do not match, the kernel may be unable to locate
or reliably access the devices in your system.
2. LINT - other possible configurations
-- ------------------------------------
The following drivers are not in the GENERIC kernel but remain
available to those who do not mind compiling a custom kernel (see
section 6 of FreeBSD.FAQ). The LINT configuration file
(/sys/i386/conf/LINT) also contains prototype entries for just about
every device supported by FreeBSD and is a good general reference.
The device names and a short description of each are listed below. The port
numbers, etc, are not meaningful here since you will need to compile a
custom kernel to gain access to these devices anyway and can thus
adjust the addresses to match the hardware in your computer in the process.
The LINT file contains prototype entries for all of the below which you
can easily cut-and-paste into your own file (or simply copy LINT and edit
it to taste):
ctx: Cortex-I frame grabber
cx: Cronyx/Sigma multiport sync/async
cy: Cyclades high-speed serial driver
el: 3Com 3C501
fea: DEC DEFEA EISA FDDI adapter
fpa: DEC DEFPA PCI FDDI adapter
gp: National Instruments AT-GPIB and AT-GPIB/TNT board
gsc: Genius GS-4500 hand scanner
gus: Gravis Ultrasound - Ultrasound, Ultrasound 16, Ultrasound MAX
gusxvi: Gravis Ultrasound 16-bit PCM
hea: Efficient ENI-155p ATM PCI adapter
hfa: FORE PCA-200E ATM PCI adapter
isic: isdn4bsd Siemens ISDN Chipset driver
joy: Joystick
labpc: National Instrument's Lab-PC and Lab-PC+
meteor: Matrox Meteor frame-grabber card
bktr: Brooktree Bt848 / Bt 878 based frame-grabber cards.
mpu: Roland MPU-401 stand-alone card
mse: Microsoft, Logitech, ATI bus mouse ports
mss: Microsoft Sound System
opl: Yamaha OPL-2 and OPL-3 FM - SB, SB Pro, SB 16, ProAudioSpectrum
pas: ProAudioSpectrum PCM and MIDI
pca: PCM audio ("/dev/audio") through your PC speaker
pcm: PCM audio on most modern ISA audio codecs
psm: PS/2 mouse port
rc: RISCom/8 multiport card
sb: SoundBlaster PCM - SoundBlaster, SB Pro, SB16, ProAudioSpectrum
sbmidi: SoundBlaster 16 MIDI interface
sbxvi: SoundBlaster 16
si: Specialix SI/XIO/SX (old and enhanced ISA, PCI, EISA) serial
spigot: Creative Labs Video Spigot video-acquisition board
uart: Stand-alone 6850 UART for MIDI
wds: Western Digital WD7000 IDE
--- end of list ---
3. Supported Hardware
-- ------------------
FreeBSD currently runs on a wide variety of ISA and PCI bus based
Alphas's. Support for generic IDE or ESDI drive configurations is
somewhat marginal and a SCSI controller is therefore recommended.
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.
4.1. Disk Controllers
---- ----------------
WD1003 (any generic MFM/RLL)
WD1007 (any generic IDE/ESDI)
IDE
ATA
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/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,
BT-540CF
BusLogic MultiMaster "S" Series Host Adapters:
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-742A, BT-542B
AMI FastDisk controllers that are true BusLogic MultiMaster clones are also
supported.
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:
ASUS SC-200
Data Technology DTC3130 (all variants)
Diamond FirePort (all)
NCR cards (all)
Symbios cards (all)
Tekram DC390W, 390U and 390F
Tyan S1365
QLogic 1020, 1040, 1040B and 2100 SCSI and Fibre Channel Adapters
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 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. ]
4.2. Network cards
---- -------------
Adaptec Duralink PCI fast ethernet adapters based on the Adaptec
AIC-6915 fast ethernet controller chip, including the following:
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-Telesyn 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 is also supported.
RealTek 8129/8139 fast ethernet NICs including the following:
Allied Telesyn AT2550
Allied Telesyn AT2500TX
Genius GF100TXR (RTL8139)
NDC Communications NE100TX-E
OvisLink LEF-8129TX
OvisLink LEF-8139TX
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
Kingston KNE110TX
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)
Macronix/Lite-On PNIC II LC82C115 fast ethernet NICs including the following:
LinkSys EtherFast LNE100TX Version 2
Winbond W89C840F fast ethernet NICs including the following:
Trendware TE100-PCIE
VIA Technologies VT3043 "Rhine I" and VT86C100A "Rhine II" fast ethernet
NICs including the following:
Hawking Technologies PN102TX
D-Link DFE-530TX
Silicon Integrated Systems SiS 900 and SiS 7016 PCI fast ethernet NICs
Sundance Technologies ST201 PCI fast ethernet NICs including
the following:
D-Link DFE-550TX
SysKonnect SK-984x PCI gigabit ethernet cards including the following:
SK-9841 1000baseLX single mode fiber, single port
SK-9842 1000baseSX multimode fiber, single port
SK-9843 1000baseLX single mode fiber, dual port
SK-9844 1000baseSX multimode fiber, dual port
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
ADMtek AL981-based PCI fast ethernet NICs
ASIX Electronics AX88140A PCI NICs, including the following:
Alfa Inc. GFC2204
CNet Pro110B
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
Davicom DM9100 and DM9102 PCI fast ethernet NICs, including the
following:
Jaton Corporation XPressNet
Efficient ENI-155p ATM PCI
FORE PCA-200E ATM PCI
Fujitsu MB86960A/MB86965A
HP PC Lan+ cards (model numbers: 27247B and 27252A).
Intel EtherExpress (not recommended due to driver instability)
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/905C PCI
and EISA (Fast) Etherlink III / (Fast) Etherlink XL
3Com 3c980/3c980B Fast Etherlink XL server adapter
3Com 3cSOHO100-TX OfficeConnect adapter
Toshiba ethernet cards
PCMCIA ethernet cards from IBM and National Semiconductor are also
supported.
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
takers?
4.3. USB
---- ---
A range of USB peripherals are supported. 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.
USB keyboards.
USB mice.
USB printers and USB to parallel printer conversion cables.
USB hubs.
Motherboards chipsets:
ALi Aladdin-V.
Intel 82371SB (PIIX3).
Intel 82371AB and EB chipsets (PIIX4).
NEC uPD 9210 Host Controller.
VIA 83C572 USB Host Controller
and any other UHCI or OHCI compliant motherboard chipset (no exceptions
known).
PCI plug-in USB host controllers:
ADS Electronics PCI plug-in card (2 ports).
Entrega PCI plug-in card (4 ports).
Specific devices reported to be working:
Agiler Mouse 29UO.
Andromeda hub.
Apple iMac mouse.
Apple iMac keyboard.
ATen parallel printer adapter.
Belkin F5U002 parallel printer adapter.
Belkin Mouse.
BTC BTC7935 keyboard with mouse port.
Cherry G81-3504 keyboard.
Chic mouse.
Cypress mouse.
Entrega USB-to-parallel printer adapter.
Genius Niche mouse.
Iomega USB Zip 100Mb.
Kensington Mouse-in-a-Box.
Logitech M2452 keyboard.
Logitech wheel mouse (3 buttons).
Logitech PS/2 / USB mouse (3 buttons).
MacAlly mouse (3 buttons).
MacAlly self powered hub (4 ports).
Microsoft IntelliMouse (3 buttons).
Microsoft keyboard.
NEC hub.
Trust Ami Mouse (3 buttons).
4.4. ISDN (European DSS1 [Q.921/Q.931] protocol)
---- -------------------------------------------
Asuscom I-IN100-ST-DV (experimental, may work)
Asuscom ISDNlink 128K PnP
AVM A1
AVM Fritz!Card classic
AVM Fritz!Card PnP
AVM Fritz!Card PCI
AVM Fritz!Card PCMCIA
Creatix ISDN-S0/8
Creatix ISDN-S0/16
Creatix ISDN-S0 PnP
Dr.Neuhaus Niccy 1008
Dr.Neuhaus Niccy 1016
Dr.Neuhaus Niccy GO@ (ISA PnP)
Dynalink IS64PH (no longer maintained)
ELSA 1000pro ISA
ELSA 1000pro PCI
ELSA PCC-16
ITK ix1 micro
ITK ix1 micro PnP
Sagem Cybermod (ISA PnP, may work)
Sedlbauer Win Speed
Siemens I-Surf 2.0
Stollmann Tina-pp (under development)
Teles S0/8
Teles S0/16
Teles S0/16.3 (the "c" Versions - like 16.3c - are unsupported !)
Teles S0 PnP (experimental, may work)
3Com/USRobotics Sportster ISDN TA intern (non-PnP version)
4.5. Misc
---- ----
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)
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.
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.
Stallion multiport serial boards: EasyIO, EasyConnection 8/32 & 8/64,
ONboard 4/16 and Brumby.
Adlib, SoundBlaster, SoundBlaster Pro, ProAudioSpectrum, Gravis UltraSound
and Roland MPU-401 sound cards.
Connectix QuickCam
Matrox Meteor Video frame grabber
Creative Labs Video Spigot frame grabber
Cortex1 frame grabber
Various Frame grabbers based on Brooktree Bt848 and Bt878 chip.
HP4020, HP6020, Philips CDD2000/CDD2660 and Plasmon CD-R drives.
Bus mice
PS/2 mice
Standard PC Joystick
X-10 power controllers
GPIB and Transputer drivers.
Genius and Mustek hand scanners.
Floppy tape drives (some rather old models only, driver rather stale)
Lucent Technologies WaveLAN/IEEE 802.11 PCMCIA and ISA standard speed
(2Mbps) and turbo speed (6Mbps) wireless network adapters and workalikes
(NCR WaveLAN/IEEE 802.11, Cabletron RoamAbout 802.11 DS). 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.

View File

@ -0,0 +1,647 @@
RELEASE NOTES
FreeBSD Release 4.0-SNAP
This is a 4.0-CURRENT release SNAPshot of FreeBSD, an active
development branch which is not expected to produce a release for
some time. This line of development branched from the 3.x line
on January 20, 1999; that branch will see continuing releases and
some features of 4.0 will be back-ported.
Any installation failures or crashes should be reported by using the
send-pr command (those preferring a Web-based interface can also see
http://www.freebsd.org/send-pr.html).
For information about FreeBSD and the layout of the 4.0-RELEASE
directory (especially if you're installing from floppies!), see
ABOUT.TXT. For installation instructions, see the INSTALL.TXT and
HARDWARE.TXT files.
For the latest of these 4.0-current snapshots, you should always see:
ftp://current.freebsd.org/pub/FreeBSD
If you wish to get the latest post-3.x-RELEASE technology.
Table of contents:
------------------
1. What's new since the 3.1/4.0 branch
1.1 KERNEL CHANGES
1.2 SECURITY FIXES
1.3 USERLAND CHANGES
2. Supported Configurations
2.1 Disk Controllers
2.2 Ethernet cards
2.3 ATM
2.4 Misc
3. Obtaining FreeBSD
3.1 FTP/Mail
3.2 CDROM
4. Upgrading from previous releases of FreeBSD
5. Reporting problems, making suggestions, submitting code
6. Acknowledgements
1. What's new since the 3.1/4.0 branch
--------------------------------------
All changes described here are unique to the 4.0 branch unless
specifically marked as [MERGED] features.
1.1. KERNEL CHANGES
-------------------
The VM system's anonymous storage subsystem (the ``swap pager'') has
been completely revamped.
An emulator for SVR4 binaries has been added.
Support has been added for direct access to NTFS filesystems.
Driver support has been added 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. [MERGED]
Driver support has been added for IEEE 802.11 PCMCIA wireless network
adapters based on the Lucent Hermes chipset, including the Lucent
WaveLAN/IEEE 802.11 and the Cabletron RoamAbout. Both 2Mbps and
6Mbps Turbo adapters are supported. [MERGED]
Driver support has been added for PCI fast ethernet cards based
on the ADMtek Inc. AL981 Comet chipset. [MERGED]
Support has been added for the Rise mP6 processor. [MERGED]
Driver support has been added for SysKonnect SK-984x PCI gigabit
ethernet adapters.
Driver support has been added for Adaptec Duralink PCI ethernet adapters
based on the Adaptec AIC-6915 fast ethernet controller.
Driver support has been added for PCI fast ethernet adapters based on
the Sundance Technologies ST201 controller, including the D-Link DFE-550TX.
Driver support has been added for the 3Com 3c905C-TX. [MERGED]
User- and group-based IPFW firewalling has been added. [MERGED]
Support for probabalistic rule matching has been added to IPFW. [MERGED]
IPFW logging is now dynamic. IPFW logging counts can be reset, and any
given rule can be given an arbitrary logging limit. [MERGED]
The top-level category "security" has been added, and IPFW now uses
syslog(3) to log all messages to /var/log/security.
Driver support has been added for PCI fast ethernet adapters based on
the Silicon Integrated Systems SiS 900 and SiS 7016 ethernet controllers.
Driver support has been added for PCI fast ethernet adapters based on
the Davicom DM9100 and DM9102 ethernet controllers, including the Jaton
Corporation XpressNet.
1.2. SECURITY FIXES
-------------------
A new jail(2) system call and admin command (jail(8)) have been added for
additional flexibility in creating secure process execution environments.
1.3. USERLAND CHANGES
---------------------
The base C/C++ compiler has been upgraded from GCC 2.7.2 to EGCS 1.1.2.
This gives users full ISO C++ support.
The timezone database has been updated to catch all of the recent changes
in Europe, the former Soviet Union, and Central and South America.
The timezone data files now contain a magic number allowing for easy
identification.
The f77 emulation via f2c has been updated to a current version.
The Internet Software Consortium's DHCP client has been added to the
base system.
Groff/troff/eqn has been updated to version 1.11.
Gdb has been updated to version 4.18 and is now part of the standard
release for FreeBSD/alpha.
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
also provided.
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)
IDE
ATA
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/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,
BT-540CF
BusLogic MultiMaster "S" Series Host Adapters:
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-742A, BT-542B
AMI FastDisk controllers that are true BusLogic MultiMaster clones are also
supported.
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:
ASUS SC-200
Data Technology DTC3130 (all variants)
Diamond FirePort (all)
NCR cards (all)
Symbios cards (all)
Tekram DC390W, 390U and 390F
Tyan S1365
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
SoundBlaster SCSI)
(matcd) Matsushita/Panasonic (Creative SoundBlaster) proprietary
interface (562/563 models)
(scd) Sony proprietary interface (all models)
(acd) 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
-------------------
Adaptec Duralink PCI fast ethernet adapters based on the Adaptec
AIC-6915 fast ethernet controller chip, including the following:
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
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
OvisLink LEF-8129TX
OvisLink LEF-8139TX
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
Kingston KNE110TX
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)
Macronix/Lite-On PNIC II LC82C115 fast ethernet NICs including the following:
LinkSys EtherFast LNE100TX Version 2
Winbond W89C840F fast ethernet NICs including the following:
Trendware TE100-PCIE
VIA Technologies VT3043 "Rhine I" and VT86C100A "Rhine II" fast ethernet
NICs including the following:
Hawking Technologies PN102TX
D-Link DFE-530TX
Silicon Integrated Systems SiS 900 and SiS 7016 PCI fast ethernet NICs
Sundance Technologies ST201 PCI fast ethernet NICs including
the following:
D-Link DFE-550TX
SysKonnect SK-984x PCI gigabit ethernet cards including the following:
SK-9841 1000baseLX single mode fiber, single port
SK-9842 1000baseSX multimode fiber, single port
SK-9843 1000baseLX single mode fiber, dual port
SK-9844 1000baseSX multimode fiber, dual port
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
ADMtek Inc. AL981-based PCI fast ethernet NICs
ASIX Electronics AX88140A PCI NICs, including the following:
Alfa Inc. GFC2204
CNet Pro110B
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
Davicom DM9100 and DM9102 PCI fast ethernet NICs, including the
following:
Jaton Corporation XpressNet
Fujitsu MB86960A/MB86965A
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/905C PCI
and EISA (Fast) Etherlink III / (Fast) Etherlink XL
3Com 3c980/3c980B Fast Etherlink XL server adapter
3Com 3cSOHO100-TX OfficeConnect adapter
Toshiba ethernet cards
Crystal Semiconductor CS89x0-based NICs, including:
IBM Etherjet ISA
PCMCIA ethernet cards from IBM and National Semiconductor are also
supported.
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
takers?
2.3 ATM
-------
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
2.4. Misc
---------
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)
Connectix QuickCam
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 / Bt878 chip.
HP4020, HP6020, Philips CDD2000/CDD2660 and Plasmon CD-R drives.
PS/2 mice
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.
Lucent Technologies WaveLAN/IEEE 802.11 PCMCIA and ISA standard speed
(2Mbps) and turbo speed (6Mbps) wireless network adapters and workalikes
(NCR WaveLAN/IEEE 802.11, Cabletron RoamAbout 802.11 DS). 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.
FreeBSD currently does NOT support IBM's microchannel (MCA) bus.
3. Obtaining FreeBSD
--------------------
You may obtain FreeBSD in a variety of ways:
3.1. FTP/Mail
-------------
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.
If you do not have access to the Internet and electronic mail is your
only recourse, then you may still fetch the files by sending mail to
`ftpmail@ftpmail.vix.com' - putting the keyword "help" in your message
to get more information on how to fetch files using this mechanism.
Please do note, however, that this will end up sending many *tens of
megabytes* through the mail and should only be employed as an absolute
LAST resort!
3.2. CDROM
----------
FreeBSD 3.0-RELEASE and 2.2.x-RELEASE CDs may be ordered on CDROM from:
Walnut Creek CDROM
4041 Pike Lane, Suite D
Concord CA 94520
1-800-786-9907, +1-925-674-0783, +1-925-674-0821 (FAX)
Or via the Internet from orders@cdrom.com or http://www.cdrom.com.
Their current catalog can be obtained via ftp from:
ftp://ftp.cdrom.com/cdrom/catalog
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
obligation.
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 3.0 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 FreeBSD distributions:
o Using sources, via /usr/src
o Using sysinstall's (binary) upgrade option.
[insert other notes 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:
freebsd-bugs@FreeBSD.org
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:
freebsd-questions@FreeBSD.org
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
mail to:
freebsd-hackers@FreeBSD.org
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:
freebsd-announce@FreeBSD.org
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!
6. Acknowledgements
-------------------
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:
http://www.freebsd.org/handbook/staff.html
or, if you've loaded the doc distribution:
file:/usr/share/doc/handbook/staff.html
Special mention to:
The donors listed at http://www.freebsd.org/handbook/donors.html
Justin M. Seger <jseger@freebsd.org> for almost single-handedly
converting the ports collection to ELF.
Doug Rabson <dfr@freebsd.org> and John Birrell <jb@freebsd.org>
for making FreeBSD/alpha happen and to the NetBSD project for
substantial indirect aid.
Peter Wemm <peter@freebsd.org> for the new kernel module system
(with substantial aid from Doug Rabson).
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