release/texts/RELNOTES.TXT

   1                                  RELEASE NOTES
   2                             FreeBSD Release 3.0-SNAP
   3
   4 This is a 3.0-CURRENT release SNAPshot of FreeBSD, currently
   5 on its way to the next release after 3.0-RELEASE, which was
   6 released on October 16th, 1998.
   7
   8 Any installation failures or crashes should be reported by using the
   9 send-pr command (those preferring a WEB based interface can also see
  10 http://www.freebsd.org/send-pr.html).
  11
  12 For information about FreeBSD and the layout of the 3.0-RELEASE
  13 directory (especially if you're installing from floppies!), see
  14 ABOUT.TXT.  For installation instructions, see the INSTALL.TXT and
  15 HARDWARE.TXT files.
  16
  17 For the latest of these 3.0-current snapshots, you should always see:
  18
  19         ftp://current.freebsd.org/pub/FreeBSD
  20
  21 If you wish to get the latest post-3.0-RELEASE technology.
  22
  23 Table of contents:
  24 ------------------
  25 1. What's new since 3.0-RELEASE
  26    1.1 KERNEL CHANGES
  27    1.2 SECURITY FIXES
  28    1.3 USERLAND CHANGES
  29
  30 2. Supported Configurations
  31    2.1 Disk Controllers
  32    2.2 Ethernet cards
  33    2.3 ATM
  34    2.4 Misc
  35
  36 3. Obtaining FreeBSD
  37    3.1 FTP/Mail
  38    3.2 CDROM
  39
  40 4. Upgrading from previous releases of FreeBSD
  41
  42 5. Reporting problems, making suggestions, submitting code
  43 6. Acknowledgements
  44
  45
  46 1. What's new since 3.0-RELEASE
  47 ---------------------------------
  48 All changes described here are unique to the 3.0 branch unless
  49 specifically marked as [MERGED] features.
  50
  51 1.1. KERNEL CHANGES
  52 -------------------
  53
  54 Added driver support for fast ethernet adapters based on the
  55 RealTek 8129/8139 and Accton MPX 5030/5038 chips, including the
  56 SMC EZ Card 10/100 PCI 1211-TX.
  57
  58 Added driver support for Lite-On PNIC-based fast ethernet cards
  59 including the LinkSys LNE100TX, NetGear FA310TX Rev. D1 and
  60 Matrox FastNIC 10/100.
  61
  62 Added driver support for fast ethernet adapters based on the
  63 Macronix 98713, 98713A, 98715, 98715A and 98725 chips.
  64
  65 Added driver support for fast ethernet adapters based on the
  66 Winbond W89C840F chip.
  67
  68 Added driver support for fast ethernet adapters based on the
  69 VIA Technologies VT3043 "Rhine I" and VT86C100A "Rhine II" chips.
  70
  71 Added driver support for pocket ethernet adapters based on the
  72 RealTek RTL 8002 chip.
  73
  74 Added driver support for fast ethernet adapters based on the
  75 ASIX Electronics AX88140A chip.
  76
  77 Integrated isdn4bsd from the isdn4bsd project group into the
  78 regular system.
  79
  80
  81 1.2. SECURITY FIXES
  82 -------------------
  83
  84 1.3. USERLAND CHANGES
  85 ---------------------
  86
  87 When using ipfw(8) with the syntax of the first synopsis line from the
  88 man page (i. e., with a rules file), it can now optionally be run through
  89 a preprocessor (m4, cpp) so it's possible to use symbolic names and other
  90 constructs that make maintenance easier.
  91
  92
  93 2. Supported Configurations
  94 ---------------------------
  95 FreeBSD currently runs on a wide variety of ISA, VLB, EISA and PCI bus
  96 based PC's, ranging from 386sx to Pentium class machines (though the
  97 386sx is not recommended).  Support for generic IDE or ESDI drive
  98 configurations, various SCSI controller, network and serial cards is
  99 also provided.
 100
 101 What follows is a list of all peripherals currently known to work with
 102 FreeBSD.  Other configurations may also work, we have simply not as yet
 103 received confirmation of this.
 104
 105
 106 2.1. Disk Controllers
 107 ---------------------
 108 WD1003 (any generic MFM/RLL)
 109 WD1007 (any generic IDE/ESDI)
 110 IDE
 111 ATA
 112
 113 Adaptec 1535 ISA SCSI controllers
 114 Adaptec 154x series ISA SCSI controllers
 115 Adaptec 174x series EISA SCSI controller in standard and enhanced mode.
 116 Adaptec 274X/284X/2920/2940/2950/3940/3950 (Narrow/Wide/Twin) series
 117 EISA/VLB/PCI SCSI controllers.
 118 Adaptec AIC7850, AIC7880, AIC789x, on-board SCSI controllers.
 119
 120 AdvanSys SCSI controllers (all models).
 121
 122 Buslogic 545S & 545c
 123 Buslogic 445S/445c VLB SCSI controller
 124 Buslogic 742A, 747S, 747c EISA SCSI controller.
 125 Buslogic 946c PCI SCSI controller
 126 Buslogic 956c PCI SCSI controller
 127
 128 DPT SCSI/RAID controllers (most variants).
 129
 130 SymBios (formerly NCR) 53C810, 53C825, 53c860 and 53c875 PCI SCSI
 131 controllers:
 132         ASUS SC-200
 133         Data Technology DTC3130 (all variants)
 134         NCR cards (all)
 135         Symbios cards (all)
 136         Tekram DC390W, 390U and 390F
 137         Tyan S1365
 138
 139
 140 QLogic SCSI and Fibre Channel controllers.
 141
 142 DTC 3290 EISA SCSI controller in 1542 emulation mode.
 143
 144 With all supported SCSI controllers, full support is provided for
 145 SCSI-I & SCSI-II peripherals, including hard disks, optical disks,
 146 tape drives (including DAT and 8mm Exabyte), medium changers, processor
 147 target devices and CDROM drives.  WORM devices that support CDROM commands
 148 are supported for read-only access by the CDROM driver.  WORM/CD-R/CD-RW
 149 writing support is provided by cdrecord, which is in the ports tree.
 150
 151 The following CD-ROM type systems are supported at this time:
 152 (cd)    SCSI interface (also includes ProAudio Spectrum and
 153         SoundBlaster SCSI)
 154 (matcd) Matsushita/Panasonic (Creative SoundBlaster) proprietary
 155         interface (562/563 models)
 156 (scd)   Sony proprietary interface (all models)
 157 (wcd)   ATAPI IDE interface
 158
 159 SCSI TAPE SUPPORT:
 160
 161   The CAM SCSI tape driver doesn't yet handle older (and many times broken)
 162   tape drives very well.  If you've got an older SCSI-1 tape drive, like an
 163   Exabyte 8200 or older QIC-type tape drive, it may not work properly with
 164   the CAM tape driver.  This is obviously a known problem, and we're
 165   working on it.
 166
 167   Newer tape drives that are mostly SCSI-2 compliant should work fine.
 168   e.g., DAT (DDS-1, 2 and 3), DLT, and newer Exabyte 8mm drives should
 169   work fine.
 170
 171   If you want to find out if your particular tape drive is supported, the
 172   best way to find out is to try it!
 173
 174 The following drivers were supported under the old SCSI subsystem, but are
 175 NOT YET supported under the new CAM SCSI subsystem:
 176
 177   Tekram DC390 and DC390T controllers (maybe other cards based on the
 178   AMD 53c974 as well).
 179
 180   NCR5380/NCR53400 ("ProAudio Spectrum") SCSI controller.
 181
 182   UltraStor 14F, 24F and 34F SCSI controllers.
 183
 184   Seagate ST01/02 SCSI controllers.
 185
 186   Future Domain 8xx/950 series SCSI controllers.
 187
 188   WD7000 SCSI controller.
 189
 190   Adaptec 1510 series ISA SCSI controllers (not for bootable devices)
 191   Adaptec 152x series ISA SCSI controllers
 192   Adaptec AIC-6260 and AIC-6360 based boards, which includes the AHA-152x
 193   and SoundBlaster SCSI cards.
 194
 195   [ Note:  There is work-in-progress to port the AIC-6260/6360 and
 196     UltraStor drivers to the new CAM SCSI framework, but no estimates on
 197     when or if they will be completed. ]
 198
 199 Unmaintained drivers, they might or might not work for your hardware:
 200
 201   Floppy tape interface (Colorado/Mountain/Insight)
 202
 203   (mcd)   Mitsumi proprietary CD-ROM interface (all models)
 204
 205 2.2. Ethernet cards
 206 -------------------
 207 Allied-Telesis AT1700 and RE2000 cards
 208
 209 AMD PCnet/PCI (79c970 & 53c974 or 79c974)
 210
 211 SMC Elite 16 WD8013 ethernet interface, and most other WD8003E,
 212 WD8003EBT, WD8003W, WD8013W, WD8003S, WD8003SBT and WD8013EBT
 213 based clones.  SMC Elite Ultra.  SMC Etherpower II.
 214
 215 RealTek 8129/8139 fast ethernet NICs including the following:
 216   Allied Telesyn AT2550
 217   Allied Telesyn AT2500TX
 218   Genius GF100TXR (RTL8139)
 219   NDC Communications NE100TX-E
 220   OvisLink LEF-8129TX
 221   OvisLink LEF-8139TX
 222   Netronix Inc. EA-1210 NetEther 10/100
 223   KTX-9130TX 10/100 Fast Ethernet
 224   Accton "Cheetah" EN1027D (MPX 5030/5038; RealTek 8139 clone?)
 225   SMC EZ Card 10/100 PCI 1211-TX
 226
 227 Lite-On 82c168/82c169 PNIC fast ethernet NICs including the following:
 228   LinkSys EtherFast LNE100TX
 229   NetGear FA310-TX Rev. D1
 230   Matrox FastNIC 10/100
 231
 232 Macronix 98713, 98713A, 98715, 98715A and 98725 fast ethernet NICs
 233   NDC Communications SFA100A (98713A)
 234   CNet Pro120A (98713 or 98713A)
 235   CNet Pro120B (98715)
 236   SVEC PN102TX (98713)
 237
 238 Winbond W89C840F fast ethernet NICs including the following:
 239   Trendware TE100-PCIE
 240
 241 VIA Technologies VT3043 "Rhine I" and VT86C100A "Rhine II" fast ethernet
 242 NICs including the following:
 243   Hawking Technologies PN102TX
 244   D-Link DFE530TX
 245
 246 Texas Instruments ThunderLAN PCI NICs, including the following:
 247   Compaq Netelligent 10, 10/100, 10/100 Proliant, 10/100 Dual-Port
 248   Compaq Netelligent 10/100 TX Embedded UTP, 10 T PCI UTP/Coax, 10/100 TX UTP
 249   Compaq NetFlex 3P, 3P Integrated, 3P w/ BNC
 250   Olicom OC-2135/2138, OC-2325, OC-2326 10/100 TX UTP
 251
 252 ASIX Electronics AX88140A PCI NICs, including the following:
 253   Alfa Inc. GFC2204
 254
 255 DEC EtherWORKS III NICs (DE203, DE204, and DE205)
 256 DEC EtherWORKS II NICs (DE200, DE201, DE202, and DE422)
 257 DEC DC21040, DC21041, or DC21140 based NICs (SMC Etherpower 8432T, DE245, etc)
 258 DEC FDDI (DEFPA/DEFEA) NICs
 259
 260 Fujitsu MB86960A/MB86965A
 261
 262 HP PC Lan+ cards (model numbers: 27247B and 27252A).
 263
 264 Intel EtherExpress 16
 265 Intel EtherExpress Pro/10
 266 Intel EtherExpress Pro/100B PCI Fast Ethernet
 267
 268 Isolan AT 4141-0 (16 bit)
 269 Isolink 4110     (8 bit)
 270
 271 Novell NE1000, NE2000, and NE2100 ethernet interface.
 272
 273 3Com 3C501 cards
 274
 275 3Com 3C503 Etherlink II
 276
 277 3Com 3c505 Etherlink/+
 278
 279 3Com 3C507 Etherlink 16/TP
 280
 281 3Com 3C509, 3C579, 3C589 (PCMCIA), 3C590/592/595/900/905/905B PCI and EISA
 282 (Fast) Etherlink III / (Fast) Etherlink XL
 283
 284 3Com 3c980 Fast Etherlink XL server adapter
 285
 286 Toshiba ethernet cards
 287
 288 Crystal Semiconductor CS89x0-based NICs, including:
 289   IBM Etherjet ISA
 290
 291 PCMCIA ethernet cards from IBM and National Semiconductor are also
 292 supported.
 293
 294 Note that NO token ring cards are supported at this time as we're
 295 still waiting for someone to donate a driver for one of them.  Any
 296 takers?
 297
 298 2.3 ATM
 299 -------
 300
 301    o ATM Host Interfaces
 302         - FORE Systems, Inc. PCA-200E ATM PCI Adapters
 303         - Efficient Networks, Inc. ENI-155p ATM PCI Adapters
 304
 305    o ATM Signalling Protocols
 306         - The ATM Forum UNI 3.1 signalling protocol
 307         - The ATM Forum UNI 3.0 signalling protocol
 308         - The ATM Forum ILMI address registration
 309         - FORE Systems's proprietary SPANS signalling protocol
 310         - Permanent Virtual Channels (PVCs)
 311
 312    o IETF "Classical IP and ARP over ATM" model
 313         - RFC 1483, "Multiprotocol Encapsulation over ATM Adaptation Layer 5"
 314         - RFC 1577, "Classical IP and ARP over ATM"
 315         - RFC 1626, "Default IP MTU for use over ATM AAL5"
 316         - RFC 1755, "ATM Signaling Support for IP over ATM"
 317         - RFC 2225, "Classical IP and ARP over ATM"
 318         - RFC 2334, "Server Cache Synchronization Protocol (SCSP)"
 319         - Internet Draft draft-ietf-ion-scsp-atmarp-00.txt,
 320                 "A Distributed ATMARP Service Using SCSP"
 321
 322    o ATM Sockets interface
 323
 324 2.4. Misc
 325 ---------
 326
 327 AST 4 port serial card using shared IRQ.
 328
 329 ARNET 8 port serial card using shared IRQ.
 330 ARNET (now Digiboard) Sync 570/i high-speed serial.
 331
 332 Boca BB1004 4-Port serial card (Modems NOT supported)
 333 Boca IOAT66 6-Port serial card (Modems supported)
 334 Boca BB1008 8-Port serial card (Modems NOT supported)
 335 Boca BB2016 16-Port serial card (Modems supported)
 336
 337 Comtrol Rocketport card.
 338
 339 Cyclades Cyclom-y Serial Board.
 340
 341 STB 4 port card using shared IRQ.
 342
 343 SDL Communications Riscom/8 Serial Board.
 344 SDL Communications RISCom/N2 and N2pci high-speed sync serial boards.
 345
 346 Stallion multiport serial boards: EasyIO, EasyConnection 8/32 & 8/64,
 347 ONboard 4/16 and Brumby.
 348
 349 Adlib, SoundBlaster, SoundBlaster Pro, ProAudioSpectrum, Gravis UltraSound
 350 and Roland MPU-401 sound cards. (snd driver)
 351
 352 Most ISA audio codecs manufactured by Crystal Semiconductors, OPTi, Creative
 353 Labs, Avance, Yamaha and ENSONIQ. (pcm driver)
 354
 355 Connectix QuickCam
 356 Matrox Meteor Video frame grabber
 357 Creative Labs Video Spigot frame grabber
 358 Cortex1 frame grabber
 359 Hauppauge Wincast/TV boards (PCI)
 360 STB TV PCI
 361 Intel Smart Video Recorder III
 362 Various Frame grabbers based on Brooktree Bt848 chip.
 363
 364 HP4020, HP6020, Philips CDD2000/CDD2660 and Plasmon CD-R drives.
 365
 366 PS/2 mice
 367
 368 Standard PC Joystick
 369
 370 X-10 power controllers
 371
 372 GPIB and Transputer drivers.
 373
 374 Genius and Mustek hand scanners.
 375
 376 Xilinx XC6200 based reconfigurable hardware cards compatible with
 377 the HOT1 from Virtual Computers (www.vcc.com)
 378
 379 Support for Dave Mills experimental Loran-C receiver.
 380
 381 FreeBSD currently does NOT support IBM's microchannel (MCA) bus.
 382
 383 3. Obtaining FreeBSD
 384 --------------------
 385
 386 You may obtain FreeBSD in a variety of ways:
 387
 388 3.1. FTP/Mail
 389 -------------
 390
 391 You can ftp FreeBSD and any or all of its optional packages from
 392 `ftp.freebsd.org' - the official FreeBSD release site.
 393
 394 For other locations that mirror the FreeBSD software see the file
 395 MIRROR.SITES.  Please ftp the distribution from the site closest (in
 396 networking terms) to you.  Additional mirror sites are always welcome!
 397 Contact freebsd-admin@FreeBSD.org for more details if you'd like to
 398 become an official mirror site.
 399
 400 If you do not have access to the Internet and electronic mail is your
 401 only recourse, then you may still fetch the files by sending mail to
 402 `ftpmail@ftpmail.vix.com' - putting the keyword "help" in your message
 403 to get more information on how to fetch files using this mechanism.
 404 Please do note, however, that this will end up sending many *tens of
 405 megabytes* through the mail and should only be employed as an absolute
 406 LAST resort!
 407
 408
 409 3.2. CDROM
 410 ----------
 411
 412 FreeBSD 3.0-RELEASE and 2.2.x-RELEASE CDs may be ordered on CDROM from:
 413
 414         Walnut Creek CDROM
 415         4041 Pike Lane, Suite D
 416         Concord CA  94520
 417         1-800-786-9907, +1-925-674-0783, +1-925-674-0821 (FAX)
 418
 419 Or via the Internet from orders@cdrom.com or http://www.cdrom.com.
 420 Their current catalog can be obtained via ftp from:
 421
 422         ftp://ftp.cdrom.com/cdrom/catalog
 423
 424 Cost per -RELEASE CD is $39.95 or $24.95 with a FreeBSD subscription.
 425 FreeBSD SNAPshot CDs, when available, are $39.95 or $14.95 with a
 426 FreeBSD-SNAP subscription (-RELEASE and -SNAP subscriptions are entirely
 427 separate).  With a subscription, you will automatically receive updates as
 428 they are released.  Your credit card will be billed when each disk is
 429 shipped and you may cancel your subscription at any time without further
 430 obligation.
 431
 432 Shipping (per order not per disc) is $5 in the US, Canada or Mexico
 433 and $9.00 overseas.  They accept Visa, Mastercard, Discover, American
 434 Express or checks in U.S. Dollars and ship COD within the United
 435 States.  California residents please add 8.25% sales tax.
 436
 437 Should you be dissatisfied for any reason, the CD comes with an
 438 unconditional return policy.
 439
 440
 441 4. Upgrading from previous releases of FreeBSD
 442 ----------------------------------------------
 443
 444 If you're upgrading from a previous release of FreeBSD, most likely
 445 it's 2.2.x or 2.1.x (in some lesser number of cases) and some of the
 446 following issues may affect you, depending of course on your chosen
 447 method of upgrading.  There are two popular ways of upgrading
 448 FreeBSD distributions:
 449
 450         o Using sources, via /usr/src
 451         o Using sysinstall's (binary) upgrade option.
 452
 453 In the case of using sources, there are simply two targets you need to
 454 be aware of: The standard ``world'' target, which will upgrade a 2.x
 455 system to 3.0, or the ``aout-to-elf'' target, which will both upgrade
 456 and convert the system to ELF binary format.
 457 In the case of using the binary upgrade option, the system will go
 458 straight to 3.0/ELF but also populate the /<basepath>/lib/aout
 459 directories for backwards compatibility with older binaries.
 460
 461 In either case, going to ELF will mean that you'll have somewhat
 462 smaller binaries and access to a lot more compiler goodies which have
 463 been already been ported to other ELF environments (our older and
 464 somewhat crufty a.out format being largely unsupported by most other
 465 software projects), but on the downside you'll also have access to far
 466 fewer ports and packages since many of those have not been adapted to
 467 ELF yet.  This will occur in time, but those who wish to retain access
 468 to the greatest number of packages and 3rd-party binaries should
 469 probably stick with a.out.
 470
 471 The kernel is also still in a.out format at this time so that older
 472 LKMs and library interfaces can continue to work, but a full
 473 transition to ELF will occur at some point after 3.0-RELEASE.  Those
 474 wishing to generate dynamic kernel components should therefore use the
 475 newer KLD mechanism rather than the older LKM format - the LKM format
 476 is not long for this world and will soon be unsupported!
 477
 478 [ other important upgrading notes should go here]
 479
 480
 481 5. Reporting problems, making suggestions, submitting code.
 482 -----------------------------------------------------------
 483 Your suggestions, bug reports and contributions of code are always
 484 valued - please do not hesitate to report any problems you may find
 485 (preferably with a fix attached, if you can!).
 486
 487 The preferred method to submit bug reports from a machine with
 488 Internet mail connectivity is to use the send-pr command or use the CGI
 489 script at http://www.freebsd.org/send-pr.html.  Bug reports
 490 will be dutifully filed by our faithful bugfiler program and you can
 491 be sure that we'll do our best to respond to all reported bugs as soon
 492 as possible.  Bugs filed in this way are also visible on our WEB site
 493 in the support section and are therefore valuable both as bug reports
 494 and as "signposts" for other users concerning potential problems to
 495 watch out for.
 496
 497 If, for some reason, you are unable to use the send-pr command to
 498 submit a bug report, you can try to send it to:
 499
 500                 freebsd-bugs@FreeBSD.org
 501
 502 Note that send-pr itself is a shell script that should be easy to move
 503 even onto a totally different system.  We much prefer if you could use
 504 this interface, since it make it easier to keep track of the problem
 505 reports.  However, before submitting, please try to make sure whether
 506 the problem might have already been fixed since.
 507
 508
 509 Otherwise, for any questions or tech support issues, please send mail to:
 510
 511                 freebsd-questions@FreeBSD.org
 512
 513
 514 Additionally, being a volunteer effort, we are always happy to have
 515 extra hands willing to help - there are already far more desired
 516 enhancements than we'll ever be able to manage by ourselves!  To
 517 contact us on technical matters, or with offers of help, please send
 518 mail to:
 519
 520                 freebsd-hackers@FreeBSD.org
 521
 522
 523 Please note that these mailing lists can experience *significant*
 524 amounts of traffic and if you have slow or expensive mail access and
 525 are only interested in keeping up with significant FreeBSD events, you
 526 may find it preferable to subscribe instead to:
 527
 528                 freebsd-announce@FreeBSD.org
 529
 530
 531 All of the mailing lists can be freely joined by anyone wishing
 532 to do so.  Send mail to MajorDomo@FreeBSD.org and include the keyword
 533 `help' on a line by itself somewhere in the body of the message.  This
 534 will give you more information on joining the various lists, accessing
 535 archives, etc.  There are a number of mailing lists targeted at
 536 special interest groups not mentioned here, so send mail to majordomo
 537 and ask about them!
 538
 539
 540 6. Acknowledgements
 541 -------------------
 542
 543 FreeBSD represents the cumulative work of many dozens, if not
 544 hundreds, of individuals from around the world who have worked very
 545 hard to bring you this release.  For a complete list of FreeBSD
 546 project staffers, please see:
 547
 548         http://www.freebsd.org/handbook/staff.html
 549
 550 or, if you've loaded the doc distribution:
 551
 552         file:/usr/share/doc/handbook/staff.html
 553
 554
 555 Special mention to:
 556
 557         The donors listed at http://www.freebsd.org/handbook/donors.html
 558
 559         Justin M. Seger <jseger@freebsd.org> for almost single-handedly
 560         converting the ports collection to ELF.
 561
 562         Doug Rabson <dfr@freebsd.org> and John Birrell <jb@freebsd.org>
 563         for making FreeBSD/alpha happen and to the NetBSD project for
 564         substantial indirect aid.
 565
 566         Peter Wemm <peter@freebsd.org> for the new kernel module system
 567         (with substantial aid from Doug Rabson).
 568
 569         And to the many thousands of FreeBSD users and testers all over the
 570         world, without whom this release simply would not have been possible.
 571
 572 We sincerely hope you enjoy this release of FreeBSD!
 573
 574                         The FreeBSD Project