diff options
author | jkh <jkh@FreeBSD.org> | 1998-11-03 03:21:09 +0000 |
---|---|---|
committer | jkh <jkh@FreeBSD.org> | 1998-11-03 03:21:09 +0000 |
commit | 46de8d9aba1dd9309ae4af04b50a2cdb5befcb4d (patch) | |
tree | d12b28b9119919c3c8472a80e7d53d39530dd681 /release/texts | |
parent | bea6b236e28d2a7af41d36e3307937621a076b53 (diff) | |
download | FreeBSD-src-46de8d9aba1dd9309ae4af04b50a2cdb5befcb4d.zip FreeBSD-src-46de8d9aba1dd9309ae4af04b50a2cdb5befcb4d.tar.gz |
Stage 1: Move a bunch of docs out from under sysinstall and other
less than accessible places.
Diffstat (limited to 'release/texts')
-rw-r--r-- | release/texts/ABOUT.TXT | 197 | ||||
-rw-r--r-- | release/texts/ERRATA.TXT | 25 | ||||
-rw-r--r-- | release/texts/FLOPPIES.TXT | 60 | ||||
-rw-r--r-- | release/texts/HARDWARE.TXT | 514 | ||||
-rw-r--r-- | release/texts/INSTALL.TXT | 513 | ||||
-rw-r--r-- | release/texts/LAYOUT.TXT | 98 | ||||
-rw-r--r-- | release/texts/README.TXT | 110 | ||||
-rw-r--r-- | release/texts/RELNOTES.TXT | 514 | ||||
-rw-r--r-- | release/texts/TROUBLE.TXT | 374 | ||||
-rw-r--r-- | release/texts/UPGRADE.TXT | 168 | ||||
-rw-r--r-- | release/texts/XFREE86.TXT | 1580 | ||||
-rw-r--r-- | release/texts/i386/HARDWARE.TXT | 514 | ||||
-rw-r--r-- | release/texts/i386/INSTALL.TXT | 513 | ||||
-rw-r--r-- | release/texts/i386/RELNOTES.TXT | 514 |
14 files changed, 5694 insertions, 0 deletions
diff --git a/release/texts/ABOUT.TXT b/release/texts/ABOUT.TXT new file mode 100644 index 0000000..008a60c --- /dev/null +++ b/release/texts/ABOUT.TXT @@ -0,0 +1,197 @@ +o About FreeBSD: + +What is FreeBSD? FreeBSD is an operating system based on 4.4 BSD Lite +for Intel, AMD, Cyrix or NexGen "x86" based PC hardware. It works +with a very wide variety of PC peripherals and configurations and can +be used for everything from software development to Internet Service +Provision. + +This release of FreeBSD contains everything you need to run such a +system, including full source code for everything. With the source +distribution installed you can literally recompile the entire system +from scratch with one command, making it ideal for students, +researchers or folks who simply want to see how it all works. + +A large collection of 3rd party ported software (the "ports +collection") is also provided to make it easier for you to obtain and +install all your favorite traditional UNIX utilities for FreeBSD. +Over 1000 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. + +For more documentation on this system it is recommended that you +purchase the 4.4BSD Document Set from O'Reilly Associates and the +USENIX Association, ISBN 1-56592-082-1. We have no connection with +O'Reilly, we're just satisfied customers! + +If you're new to FreeBSD then you should also read EVERYTHING listed +in the Documentation menu on the boot floppy. It may seem like a lot +to read, but you should at least acquaint yourself with the types of +information available should you later get stuck. Once the system is +installed, you can also revisit this menu and use a WEB browser to +read the installed FAQ (Frequently Asked Questions) and Handbook HTML +documentation sets for FreeBSD. You can also use the browser to visit +other WEB sites on the net (such as http://www.freebsd.org) if you +have an Internet connection. + + +DISCLAIMER: 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! Please do not proceed to the +final FreeBSD installation menu unless you've adequately backed up any +important data first! We really mean it! + + +o E-mail addresses and tech support info: + +For general questions, please send email to : + + freebsd-questions@FreeBSD.org + +Please also have patience if your questions are not answered right +away - this mailing list is staffed purely by volunteers and they also +have real life schedules to contend with. Questions which are asked +intelligently (e.g. not "My system doesn't work! What's wrong!?") +also stand a far greater chance of being answered. If your question +does not contain enough information to allow the responder to generate +a meaningful answer, they generally won't. + +Bug reports submitted with the send-pr command are also logged and +tracked in our bugs database, and you'll be kept informed of any +changes in status during the life of the bug (or feature request). + +Technical comments on this release should be sent (in English!) to: + + freebsd-hackers@FreeBSD.org + +Bug reports should be sent using the `send-pr' command or the Web page +at http://www.freebsd.org/send-pr.html. If you cannot use either of +these two methods, you may also send mail to: + + freebsd-bugs@FreeBSD.org + + +PLEASE ALSO BE SURE TO INDICATE WHICH VERSION OF FREEBSD YOU'RE +RUNNING IN ANY BUG REPORTS OR QUESTIONS! + +Sorry for the caps, but you'd be amazed at how many times people +forget this and there are many different release versions of FreeBSD +out there now. It's imperative that we know what you're running so +that we tell if you're suffering from a bug which has already been +fixed. + + +o WWW Resources: + +Our WEB site, http://www.freebsd.org, is also a very good source for +updated information and provides a number of advanced documentation +searching facilities. If you wish to use Netscape as your browser, +several versions may be found in the ports collection under +/usr/ports/www if you've installed the ports collection on your +machine (always a good idea). + +Several other non-commercial browsers are also available in +/usr/ports/www and may be compiled and installed in the same fashion. +Many are also available as pre-compiled packages - see the Packages +entry in the Configuration menu for more details. + +The Handbook and FAQ are also available as on-line documents in +/usr/share/doc and can be read using the ``file:/usr/share/doc'' +syntax in any HTML capable browser. + + +o Distributions: + +A typical FreeBSD distribution directory looks like this: + +ABOUT.TXT bin dict manpages tools +HARDWARE.TXT compat1x des doc packages +INSTALL.TXT compat20 floppies ports +README.TXT compat21 games proflibs +RELNOTES.TXT info src +XF86332 + +If you want to do a CDROM, FTP or NFS installation from this +distribution directory, all you need to do is make a 1.44Mb floppy +from the floppies/boot.flp image file (see floppies/README.TXT for +instructions on how to do this), boot it and follow the instructions. + +If you're trying to do some other type of installation, or are just +curious about how the distribution is organized in general, what +follows is a more thorough description of each item in more detail: + +The *.TXT files obviously contain documentation (ABOUT.TXT being what +you're reading now). + +The XF86332 directory contains the XFree86 project's 3.3.2 release and +consists of a series of gzip'd tar files which contain each component +of the XFree86 distribution. + +The bin, dict, des, 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). + +The compat1x, compat20 and compat21 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. + +A typical distribution (we'll use the info distribution as an example) +looks like this: + +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(1) program +to verify the installation permissions and checksums against any possible +modifications to the file. When used with the bin 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 + +And that's all there is to it! Each distribution contains its own +install.sh file for this. + + +The floppies subdirectory contains the floppy installation images and +the floppies/README.TXT file should be read for further information +on them. + +The packages and ports directories contain the FreeBSD packages and +ports collections. Packages may be installed from the packages directory +by running the /stand/sysinstall utility with the argument ``configPackages'' +or by feeding the individual filenames to the pkg_add(1) command. + +The ports collection may be installed like any other distribution +and requires about 30MB unpacked. More information on the ports collection +may be obtained from http://www.freebsd.org/ports or locally from +file:/usr/share/doc/handbook if you've installed the doc distribution. + +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. diff --git a/release/texts/ERRATA.TXT b/release/texts/ERRATA.TXT new file mode 100644 index 0000000..239787f --- /dev/null +++ b/release/texts/ERRATA.TXT @@ -0,0 +1,25 @@ +This file contains post-release ERRATA for 3.0 and should always +be considered the definitive place to look *first* before reporting +a problem with this release. This file will also be periodically +updated as new issues are reported so even if you've checked this +file recently, check it again before filing a bug report. +The latest revision of this file can be viewed at: + + http://www.freebsd.org/releases/3.0/errata.html + +Any changes to this file are also automatically emailed to: + + freebsd-current@freebsd.org + +For 3.0 security advisories, see: + + ftp://ftp.freebsd.org/pub/FreeBSD/CERT/ + +For the latest information. + +---- Security Advisories: + +Current active security advisories for 3.0: None + +---- System Update Information: + diff --git a/release/texts/FLOPPIES.TXT b/release/texts/FLOPPIES.TXT new file mode 100644 index 0000000..2d3e9a4 --- /dev/null +++ b/release/texts/FLOPPIES.TXT @@ -0,0 +1,60 @@ +For a normal CDROM or network installation, all you need to copy onto an +actual floppy from this directory is the boot.flp image (for 1.44MB floppies). + +If you're on the ALPHA then the boot.flp image is probably larger +than any kind of floppy you have available and you will need to +either netboot it, load it from some other type of media (such +as a jaz drive) or use the kern.flp image described below. + +This release still uses only one installation floppy, the boot.flp +image. For convenience (and for the DEC ALPHA architecture, on which +binaries are quite a bit larger), however, we also provide the +functionality of boot.flp now "decoupled" into a kern.flp image, +which contains just the boot kernel, and mfsroot.gz, which contains +the compressed MFS root image that is normally stored as part of +the kernel itself on the boot.flp image. This allows you to boot +from kern.flp, which will fit on a 1.44MB floppy even on the alpha, +and then load mfsroot.gz from a 2nd floppy. This also allows you +to easily make your own boot or MFS floppies should you need to customize +some aspect of the installation process. As long as the kernel is compiled +with ``options MFS'' and ``options MFS_ROOT'', it will properly +boot an mfsroot.gz image when run. The mfsroot.gz image is simply +a gzip'd filesystem image, something which can be made rather +easily using vnconfig(8). If none of this makes any sense to you, +don't worry about it - just use the boot.flp image as always; nothing +has changed there. + + +NOTE: The *.flp 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 or `dd' under UNIX. + +For example: + +To create the boot floppy image from DOS, you'd do something like +this: + +C> fdimage boot.flp a: + +Assuming that you'd copied fdimage.exe and boot.flp into a directory +somewhere. If you were doing this from the base of a CD distribution, +then the *exact* command would be: + +E> tools\fdimage floppies\boot.flp a: + + +If you're creating the boot floppy from a UNIX machine, you may find +that: + + dd if=floppies/boot.flp of=/dev/rfd0 + +or + + dd if=floppies/boot.flp of=/dev/floppy + +work well, depending on your hardware and operating system environment +(different versions of UNIX have totally different names for the +floppy drive - neat, huh? :-). + +The only image which is copied onto a floppy as an ordinary file is +mfsroot.gz, should you actually be using that image for something. diff --git a/release/texts/HARDWARE.TXT b/release/texts/HARDWARE.TXT new file mode 100644 index 0000000..4916da2 --- /dev/null +++ b/release/texts/HARDWARE.TXT @@ -0,0 +1,514 @@ +Table of Contents +----------------- +0. Document Conventions +1. Default Configuration (GENERIC kernel) +2. Using UserConfig to change FreeBSD kernel settings +3. LINT - other possible configurations +4. 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 ADP-9xx SCSI controller +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 +amd0 n/a n/a n/a n/a Tekram DC-390(T) / AMD 53c974 PCI SCSI +dpt n/a n/a n/a n/a DPT RAID SCSI controllers. +nca0* 1f88 10 dyn dyn ProAudioSpectrum cards +sea0* dyn 5 dyn c8000 Seagate ST01/02 8 bit controller + +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 + +de0 n/a n/a n/a n/a DEC DC21x40 PCI based cards + (including 21140 100bT 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-Telesis AT1700, RE2000 and + Fujitsu FMV-180 series cards. +fxp0 dyn dyn n/a dyn Intel EtherExpress Pro/100B +rl0 dyn dyn n/a dyn RealTek 8129/8139 fast ethernet +tl0 dyn dyn n/a dyn TI TNET100 'ThunderLAN' cards. +ie0 300 10 dyn d0000 AT&T StarLAN 10 and EN100; + 3Com 3C507; NI5210 +ix0 300 10 dyn d0000 Intel EtherExpress cards +ex0 dyn dyn dyn dyn Intel EtherExpress Pro/10 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) +vx0 dyn dyn n/a dyn 3Com 3c59x ((Fast) Etherlink III) +xl0 dyn dyn n/a dyn 3Com 3c900, 3c905 and 3c905B + ((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. Using UserConfig to change FreeBSD kernel settings +-- -------------------------------------------------- + +The FreeBSD kernel on the install floppy contains drivers for every +piece of hardware that could conceivably be used to install the rest +of the system with. Unfortunately, PC hardware being what it is, some +of these devices can be difficult to detect accurately, and for some, +the process of detecting another can cause irreversible confusion. + +To make this process easier, FreeBSD provides UserConfig. With this +UserConfig, the user can configure and disable device drivers before +the kernel is loaded, avoiding potential conflicts, and eliminating +the need to reconfigure hardware to suit the default driver settings. + +Once FreeBSD is installed, it will remember the changes made using +UserConfig, so that they only need be made once. + +It is important to disable drivers that are not relevant to a system +in order to minimize the possibility of interference, which can cause +problems that are difficult to track down. + +UserConfig features a command line interface for users with serial +consoles or a need to type commands, and a full screen 'visual' +interface, which provides point-and-shoot configuration functionality. + +Here is a sample UserConfig screen shot in 'visual' mode: + +---Active Drivers---------------------------10 Conflicts------Dev---IRQ--Port-- + Storage : (Collapsed) + Network : + NE1000,NE2000,3C503,WD/SMC80xx Ethernet adapters CONF ed0 5 0x280 + NE1000,NE2000,3C503,WD/SMC80xx Ethernet adapters CONF ed1 5 0x300 + Communications : (Collapsed) + Input : (Collapsed) + Multimedia : +---Inactive Drivers-------------------------------------------Dev-------------- + Storage : + Network : (Collapsed) + Communications : + Input : + Multimedia : + PCI : + +---Parameters-for-device-ed0--------------------------------------------------- + Port address : 0x280 Memory address : 0xd8000 + IRQ number : 5 Memory size : 0x2000 + Flags : 0x0000 +------------------------------------------------------------------------------- + IO Port address (Hexadecimal, 0x1-0x2000) + [TAB] Change fields [Q] Save device parameters + + + The screen is divided into four sections : + + - Active Drivers. Listed here are the device drivers that are currently + enabled, and their basic parameters. + - Inactive Drivers. These drivers are present, but are disabled. + - Parameter edit field. This area is used for editing driver parameters. + - Help area. Keystroke help is displayed here. + +One of the Active and Inactive lists is always in use, and the current +entry in the list will be shown with a highlight bar. If there are +more entries in a list than can be shown, it will scroll. The bar can +be moved up and down using the cursor keys, and moved between lists +with the TAB key. + +Drivers in the Active list may be marked "CONF". This indicates that +one or more of their parameters conflicts with another device, and +indicates a potential for problems. The total number of conflicts is +displayed at the top of the screen. + +As a general rule, conflicts should be avoided, either by disabling +conflicting devices that are not present in the system, or by altering +their configuration so that they match the installed hardware. + +In the list areas, drivers are grouped by their basic function. +Groups can be 'Collapsed' to simplify the display (this is the default +state for all groups). If a group is collapsed, it will be shown with +'(Collapsed)' in the list, as above. To Expand a Collapsed group, +position the highlight bar over the group heading and press Enter. To +Collapse it again, repeat the process. + +When a device driver in the Active list is highlighted, its full +parameters are displayed in the Parameter edit area. Note that not +all drivers use all possible parameters, and some hardware supported +by drivers may not use all the parameters the driver supports. + +To disable a driver, go to the Active list, Expand the group it is in, +highlight the driver and press Del. The driver will move to its group +in the Inactive list. (If the group is collapsed or off the screen, +you may not see the driver in its new location.) + +To enable a driver, go to the Inactive list, Expand the group it is +in, highlight the driver and press Enter. The highlight will move to +the Active list, and the driver you have just enabled will be +highlighted, ready to be configured. + +To configure a driver, go to the Active list, Expand the group it is +in, highlight the driver and press Enter. The cursor will move to the +Parameter edit area, and the device's parameters may be edited. + +While editing parameters, the TAB and cursor keys can be used to move +between fields. Most numeric values (except IRQ) are entered in +hexadecimal, as indicated by the '0x' at the beginning of the field. +The allowable values for a given field are show in the Key Help area +when the field is active. + +To finish configuring a driver, press 'Q'. + +Note that PCI and EISA devices can be probed reliably, therefore they +are not shown in the table above nor can their settings be changed +using UserConfig. PCI drivers may be seen in the "PCI Devices" section +in the Active Devices list, if you wish to check for their presence. + + +3. 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: DEV 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 +joy: Joystick +labpc: National Instrument's Lab-PC and Lab-PC+ +meteor: Matrox Meteor frame-grabber card +bktr: Brooktree Bt848 based frame-grabber cards. +mpu: Roland MPU-401 stand-alone card +mse: Microsoft, Logitech, ATI bus mouse ports +mss: Microsoft Sound System +nic: Dr Neuhaus NICCY 3008, 3009 & 5000 ISDN cards +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 --- + + +4. Supported Hardware +-- ------------------ + +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. + + +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/2940/3940 (Narrow/Wide/Twin) series ISA/EISA/PCI SCSI +controllers. +Adaptec AIC7850/AIC7895 on-board SCSI controllers. + +Support for the following controllers is rather weak: +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: You cannot boot from the SoundBlaster cards as they have no + on-board BIOS, such being necessary for mapping the boot device into the + system BIOS I/O vectors. They're perfectly usable for external tapes, + CDROMs, etc, however. The same goes for any other AIC-6x60 based card + without a boot ROM. Some systems DO have a boot ROM, which is generally + indicated by some sort of message when the system is first powered up + or reset, and in such cases you *will* also be able to boot from them. + Check your system/board documentation for more details. + + +AdvanSys (Advanced Systems) ABP510/542/5150 ISA and ABP5140/5142 ISA PnP +cards, ABP842/852 VLB cards, and ABP920/930/930U/930UA/950/960/960U/970/970U +PCI cards. + +** Note: The ADP510/5140/5150 boards were shipped by HP with the 4020i + CD-R drive but with NO BIOS, so these models cannot control boot devices + though they can be used for any secondary SCSI device. Also note that the + ABP5140/5142 boards were rebadged by SIIG as the "SpeedMaster i540/i542" + + +Buslogic 545S & 545c +Buslogic 445S/445c VLB SCSI controller +Buslogic 742A, 747S, 747c EISA SCSI controller. +Buslogic 946c PCI SCSI controller +Buslogic 956c PCI SCSI controller + +SymBios (formerly NCR) 53C810, 53C825, 53c860 and 53c875 PCI SCSI +controllers: + ASUS SC-200 + Data Technology DTC3130 (all variants) + NCR cards (all) + Symbios cards (all) + Tekram DC390W, 390U and 390F + Tyan S1365 + +Tekram DC390 and DC390T controllers (maybe other cards based on the +AMD 53c974 as well). + +NCR5380/NCR53400 ("ProAudio Spectrum") SCSI controller. + +DTC 3290 EISA SCSI controller in 1542 emulation mode. + +UltraStor 14F, 24F and 34F SCSI controllers. + +Seagate ST01/02 SCSI controllers. + +Future Domain 8xx/950 series SCSI controllers. + +WD7000 SCSI controller. + +With all supported SCSI controllers, full support is provided for +SCSI-I & SCSI-II peripherals, including Disks, tape drives (including +DAT and 8mm Exabyte) and CD ROM drives. + +The following CD-ROM type systems are supported at this time: +(cd) SCSI interface (also includes ProAudio Spectrum and + SoundBlaster SCSI) +(mcd) Mitsumi proprietary interface (all models, driver is rather stale) +(matcd) Matsushita/Panasonic (Creative SoundBlaster) proprietary + interface (562/563 models) +(scd) Sony proprietary interface (all models) +(wcd) ATAPI IDE interface. + + +4.2. Network cards +---- ------------- + +Allied-Telesis AT1700 and RE2000 cards + +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. + +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 + +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 + +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. + +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 + +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. 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 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) + + +FreeBSD currently does NOT support IBM's microchannel (MCA) bus. diff --git a/release/texts/INSTALL.TXT b/release/texts/INSTALL.TXT new file mode 100644 index 0000000..dfc1697 --- /dev/null +++ b/release/texts/INSTALL.TXT @@ -0,0 +1,513 @@ ++===================== Installing FreeBSD ==========================+ +| | +| Table of Contents: | +| | +| 0.0 Quick Start: | +| 0.1 Installing FreeBSD from CDROM or the Internet. | +| | +| 1.0 Detail on various installation types: | +| 1.1 Installing from a network CDROM | +| 1.2 Installing from Floppies | +| 1.3 Installing from a DOS partition | +| 1.4 Installing from QIC/SCSI tape | +| 1.5 Installing over a network using NFS or FTP | +| 1.5.1 NFS Installation tips | +| 1.5.2 FTP Installation tips | +| | +| 2.0 DOS User's Q&A section. | +| 2.1 How do I make space for FreeBSD? | +| 2.2 Can I use compressed DOS filesystems from FreeBSD? | +| 2.3 Can I use DOS extended partitions? | +| 2.4 Can I run DOS executables under FreeBSD? | +| | ++=====================================================================+ + +Author: Jordan K. Hubbard +Last updated: Tue Mar 24 00:56:14 PST 1998 + +0.0 Quick Start +--- ----------- + +This manual documents the process of making a new installation of +FreeBSD on your machine. If you are upgrading from a previous +release of FreeBSD, please see the file UPGRADE.TXT for important +information on upgrading. If you are not familiar with configuring +PC hardware for FreeBSD, you should also read the HARDWARE.TXT file - +it contains important information which may save you a lot of grief. + +If you're new to FreeBSD then you should also read EVERYTHING listed +in the Documentation menu on the boot floppy. It may seem like a lot +to read, but the time you spend now reading the documents will be made +up many times over because you were adequately prepared. Also, you will +know the types of information available should you get stuck later. +Once the system is installed, you can also revisit this menu and use a +WEB browser to read the installed FAQ (Frequently Asked Questions) and +Handbook HTML documentation sets for FreeBSD. You can also use the +browser to visit other WEB sites on the net (like http://www.freebsd.org) +if you have an Internet connection. See ABOUT.TXT for more information +on the resources available to you. + +The best laid plans sometimes go awry, so if you run into trouble take a +look at TROUBLE.TXT which contains valuable troubleshooting information. + +DISCLAIMER: 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! Please do not proceed to the +final FreeBSD installation menu unless you've adequately backed up any +important data first! We really mean it! + +FreeBSD requires a 386 or better processor to run (sorry, there is no +support for '286 processors), 5 megs of RAM to install and 4 megs of +ram to run. You will need at least 80 megs of free hard drive space. +See below for ways of shrinking existing DOS partitions in order to +install FreeBSD. + + +0.1 Installing FreeBSD from CDROM or the Internet +--- --------------------------------------------- + +The easiest type of installation is from CD. If you have a supported +CDROM drive and a FreeBSD installation CD from Walnut Creek CDROM, +there are 3 ways of starting the installation from it: + + 1. 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 2.2.1 and later CDs support the "El Torrito" bootable + CD standard. Simply put the installation CD in your CDROM drive + and boot the system to begin installation. + + 2. If you have drivers which allow you to see your CDROM drive + from from DOS, first disable any fancy memory managers you may + have configured, change directory to the CDROM (E:\ in the example + below) and then type this: + + E> install + + and you should boot directly into the FreeBSD installation. + + If either steps fail, please go on to step 3. + + 3. Build a FreeBSD boot floppy from the floppies/boot.flp + file in a FreeBSD distribution. Either simply use the + ``makeflp.bat'' script from DOS or read floppies/README.TXT + for more information on creating bootable floppies under + different operating systems. Then you simply boot + from the floppy and you should go into 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, simply fetch the +<FreeBSD-release>/floppies/boot.flp file from: + + ftp://ftp.freebsd.org/pub/FreeBSD + +or one of its many mirrors (http://www.freebsd.org/handbook/mirrors.html) +and follow step 3 above. You should also read the floppies/README.TXT +file as it contains important information for downloaders. + +Once you have a boot floppy made, please go to section 1.5 of this +document for additional tips on installing via FTP or NFS. + + +1.0 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 the +Documentation submenu as well as the general "Usage" instructions on +the first menu. + + REMEMBER: If you get stuck at a screen, hit F1 for the online + documentation for that section. + +If you've never installed FreeBSD before, or even if you have, the +"Novice" 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 listed below. + + +1.1 Installing from a network CDROM +--- ------------------------------- + +If you simply wish to install from a local CDROM drive then see the +Quick Start section. 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 +several ways of going about it: + +1. 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 command): + + ftp:*:99:99::0:0:FTP:/cdrom:/sbin/nologin + +And anyone else on your network will now be able to chose a Media type +of FTP and type in: ``ftp://<machine with CDROM drive>'' after picking +"Other" in the ftp sites menu. + +2. 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) + which looks something like this: + + /cdrom -ro ziggy.foo.com + + To allow the machine "ziggy.foo.com" to mount the CDROM directly + via NFS during installation. 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. + + +1.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 a boot floppy as described in floppies/README.TXT + +Second, read the file LAYOUT.TXT 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. + +Don't trust Factory Preformatted floppies! Format them again +yourself, just to make sure. Many problems reported by our users in +the past have resulted from the use of improperly formatted media, +which is why I'm taking such special care to mention it here! + +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' and `newfs' 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/rfd0 + +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 NOTE: 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! + +Once you come to the Media screen of the install, select "Floppy" and +you'll be prompted for the rest. + + +1.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 ("Drive 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:\BIN C:\FREEBSD\BIN + +Assuming that `E:' was where your CD was mounted. + +For as many `DISTS' 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. + +IMPORTANT NOTE: Though you can do all of the above by hand if you +really want to, all of it is much more easily accomplished now by +Robert Nordier's "setup.exe" program. It will give you a menu of +distribution choices, verify that you have enough free space and do +all the copying to C:\FREEBSD for you automatically. + +Once you've copied the directories or run setup.exe and let it do all +the work for you, you can simply launch the installation from DOS by +running the install.bat script (NOTE: Some memory managers don't like +this - disable QEMM or EMM386 if they're running before trying this) +or making a boot floppy as described in section 0.1. + + +1.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 tar them onto the tape +with a command something like this: + + cd /where/you/have/your/dists + tar cvf /dev/rwt0 (or /dev/rst0) 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. + +SPECIAL NOTE: When going to do the installation, the tape must be in +the drive *before* booting from the boot floppy. The installation +"probe" may otherwise fail to find it. + +Now create a boot floppy as described in section 0.1 and proceed with +the installation. + + +1.5 Installing over a network using FTP or NFS +--- ------------------------------------------ + +After making a boot floppy 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: SLIP / PPP + Parallel port: PLIP (using ``laplink'' style cable) + Ethernet: A standard Ethernet controller (including + certain PCCARD devices). + +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. + + +Parallel Port +------------- + +If a hard-wired connection to another FreeBSD (2.0R or later) 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 NOTE: 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. + + +Ethernet +-------- + +FreeBSD supports most common PC Ethernet cards, a table of supported +cards (and their required settings) being provided as part of the +FreeBSD Hardware Guide (see 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 address class 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 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 will almost certainly get you shot at +dawn. + +Once you have a network connection of some sort working, the +installation can continue over NFS or FTP. + + +1.5.1 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 (as 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 2.2 distribution directory + lives on: ziggy:/usr/archive/stuff/FreeBSD + Then ziggy 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.2 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 ``Other'' choice in that menu. A URL can + contain a hostname or an IP address, so the following would + work in the absence of a name server: + + ftp://192.216.191.11/pub/FreeBSD/2.2-RELEASE + + There are two FTP installation modes you can use: + + o FTP: + + For all FTP transfers, use the standard "Active" mode for + transfers. 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! + + o FTP Passive: + + For all FTP transfers, use "Passive" mode. This allows + the user to pass through firewalls that do not allow + incoming connections on random port addresses. + + NOTE: ACTIVE AND PASSIVE MODES ARE NOT THE SAME AS A `PROXY' + CONNECTIONS, WHERE A PROXY FTP SERVER IS LISTENING ON A + DIFFERENT PORT! + + In such instances, you should specify the URL as something like: + + ftp://foo.bar.com:1234/pub/FreeBSD + + Where "1234" is the port number of the proxy ftp server. + + +2.0 DOS user's Question and Answer section +--- -------------------------------------- + +2.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! :) + +NOTE: FIPS does NOT currently work with FAT32 or VFAT style partitions +as used by newer versions of Windows 95. To split up such a +partition, you will need a commercial product such as Partition Magic +3.0. 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. + +2.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. + + +2.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/sd0s5, your E: +drive /dev/sd0s6, and so on. This example assumes, of course, that +your extended partition is on SCSI drive 0. For IDE drives, substitute +``wd'' for ``sd'' appropriately. You otherwise mount extended +partitions exactly like you would mount any other DOS drive, e.g.: + +mount -t msdos /dev/sd0s5 /dos_d + + +2.4 Can I run DOS binaries under FreeBSD? +--- ------------------------------------- + +Ongoing work with BSDI's doscmd utility is bringing this much closer to +being a reality in FreeBSD 3.0, though it still has some rough edges. +If you're interested in working on this, please send mail to +emulation@FreeBSD.org and indicate that you're interested in joining +this ongoing effort! + +There is also a neat utility called "pcemu" in the ports collection +which emulates an 8088 and enough BIOS services to run DOS text mode +applications. It requires the X Window System (provided as XFree86 +3.2) to operate. + + +---- End of Installation Guide --- diff --git a/release/texts/LAYOUT.TXT b/release/texts/LAYOUT.TXT new file mode 100644 index 0000000..ece4acb --- /dev/null +++ b/release/texts/LAYOUT.TXT @@ -0,0 +1,98 @@ +=================== +Distribution format +=================== + +A typical FreeBSD distribution directory looks something like this: + +ABOUT.TXT bin dict manpages tools +HARDWARE.TXT compat1x des doc packages +INSTALL.TXT compat20 floppies ports +README.TXT compat21 games proflibs +RELNOTES.TXT info src +LAYOUT.TXT XF86332 + +If you want to do a CDROM, FTP or NFS installation from this +distribution directory, all you need to do is make a 1.44Mb floppy +from the floppies/boot.flp image file (see floppies/README.TXT for +instructions on how to do this), boot it and follow the instructions. +See INSTALL.TXT for more information. + +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 each item in more detail: + +1. The *.TXT files obviously contain documentation (this file is + LAYOUT.TXT) and should be read before starting an installation. + +2. The XF86332 directory contains the XFree86 project's 3.3.2 release and + consists of a series of gzip'd tar files which contain each component + of the XFree86 distribution. + +3. The bin, dict, des, 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. The compat1x, compat20 and compat21 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. The floppies subdirectory also contains the floppy installation images + and the floppies/README.TXT file should be read for further + information on using them. + +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'' + or 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 30MB unpacked. More information on the ports + collection may be obtained from http://www.freebsd.org/ports or + locally from ``file:/usr/share/doc/handbook'' if you've installed + the doc distribution. + +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. + +A typical distribution (we'll use the info distribution as an example) +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(1) program +to verify the installation permissions and checksums against any possible +modifications to the file. When used with the bin 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 + +And that's all there is to it! Each distribution contains its own +install.sh file for this. diff --git a/release/texts/README.TXT b/release/texts/README.TXT new file mode 100644 index 0000000..5167040 --- /dev/null +++ b/release/texts/README.TXT @@ -0,0 +1,110 @@ + ----------------------------------------- + FreeBSD 3.0 --- SNAPSHOT Version , , + ----------------------------------------- /( )` + \ \___ / | +This is a binary snapshot of 3.0-current, the /- _ `-/ ' +(HEAD) branch which is currently moving towards (/\/ \ \ /\ +the follow-on release to 3.0. / / | ` \ + O O ) / | + `-^--'`< ' + (_.) _ ) / + `.___/` / + `-----' / +Feedback or offers to help with anything <----. __ / __ \ +you see in this release are most welcome <----|====O)))==) \) /==== +and should be sent to one of the approp- <----' `--' `.__,' \ +riate mailing lists - please see the | | +ABOUT.TXT file for more information. \ / /\ + ______( (_ / \______/ + ,' ,-----' | + `--{__________) + +TARGET AUDIENCE: +---------------- +This release is aimed primarily at early-adopters and the various +other folks who want to get involved with the ongoing development +of FreeBSD and are willing to deal with a few bumps in the road. +We do our best to ensure that each snapshot works as advertised, +but tracking -current is a process which frequently has its off +days. + +If you're both technically proficient and know exactly what you're +getting into here (e.g. you've been following -current) then this +snapshot is probably for you. If you're more interested in doing +business with FreeBSD than in playing with the cutting edge of +technology, however, then 2.2.x is almost certainly your best bet. + + +ROAD MAP: + Most files here are also in the Documentation + Menu of the boot floppy + + README.TXT This file + + ABOUT.TXT All about FreeBSD, including contact information + + RELNOTES.TXT Release Notes - what's new & different in this + release + + LAYOUT.TXT Information about the layout of the release + directory. If you are installing from floppies, + it is especially important that you + *read this section!* + + ERRATA.TXT Any late-breaking errata information for this + release. On FTP sites, this file may be frequently + updated so it's a good idea to check it first + (the master copy is always on ftp.freebsd.org) + before reporting problems + + HARDWARE.TXT Information about the configuration of the + GENERIC kernel and supported hardware + + INSTALL.TXT How to make a new installation of FreeBSD + on your PC using the data you see here + + UPGRADE.TXT How to upgrade an existing FreeBSD + installation + + TROUBLE.TXT Troubleshooting information + + +o For new installation instructions, see the INSTALL.TXT + and HARDWARE.TXT files. + +o If you are upgrading from a previous FreeBSD version, + please take a look at UPGRADE.TXT. + +o It is also important to check the ERRATA.TXT file for any + late-breaking issues with this release. This file contains + the latest information on upgrade, security or other problems + which an administrator should be aware of. + +o Information regarding problems which arise after the CD + is printed can be found at: + ftp://ftp.freebsd.org/pub/FreeBSD/3.0-RELEASE/ERRATA.TXT + +For the most up-to-date software along the RELENG_2_2 branch +(also known as -Stable) which is now proceeding onwards toward +the release of FreeBSD 2.2.8, please install from: + + ftp://releng22.freebsd.org/pub/FreeBSD/ + +Or for the latest 3.0-Current (HEAD branch) snapshot releases, +please install from: + + ftp://current.freebsd.org/pub/FreeBSD + +If you plan to run either -Stable or -Current you MUST be +subscribed to the appropriate mailing list, either +freebsd-stable or freebsd-current. For information on +subscribing to either list (or both), send an e-mail to +majordomo@freebsd.org with the following in the body, not +the subject of the letter as appropriate: + +subscribe freebsd-stable +subscribe freebsd-current +end + +We hope you enjoy using FreeBSD as much as we enjoyed +creating it! diff --git a/release/texts/RELNOTES.TXT b/release/texts/RELNOTES.TXT new file mode 100644 index 0000000..0d50346 --- /dev/null +++ b/release/texts/RELNOTES.TXT @@ -0,0 +1,514 @@ + RELEASE NOTES + FreeBSD Release 3.0-SNAP + +This is a 3.0-CURRENT release SNAPshot of FreeBSD, currently +on its way to a follow-on release for 3.0 which was released +on October 16th, 1998. + +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 3.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 3.0-current snapshots, you should always see: + + ftp://current.freebsd.org/pub/FreeBSD + +If you wish to get the latest post-3.0-RELEASE technology. + +Table of contents: +------------------ +1. What's new since 3.0-RELEASE + 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 3.0-RELEASE +--------------------------------- +All changes described here are unique to the 3.0 branch unless +specifically marked as [MERGED] features. + +1.1. KERNEL CHANGES +------------------- + +1.2. SECURITY FIXES +------------------- + +1.3. USERLAND CHANGES +--------------------- + +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/2920/2940/2950/3940/3950 (Narrow/Wide/Twin) series +EISA/VLB/PCI SCSI controllers. +Adaptec AIC7850, AIC7880, AIC789x, on-board SCSI controllers. + +AdvanSys SCSI controllers (all models). + +Buslogic 545S & 545c +Buslogic 445S/445c VLB SCSI controller +Buslogic 742A, 747S, 747c EISA SCSI controller. +Buslogic 946c PCI SCSI controller +Buslogic 956c PCI SCSI controller + +DPT SCSI/RAID controllers (most variants). + +SymBios (formerly NCR) 53C810, 53C825, 53c860 and 53c875 PCI SCSI +controllers: + ASUS SC-200 + Data Technology DTC3130 (all variants) + NCR cards (all) + Symbios cards (all) + Tekram DC390W, 390U and 390F + Tyan S1365 + + +QLogic SCSI and Fibre Channel controllers. + +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) +(wcd) ATAPI IDE interface + +SCSI TAPE SUPPORT: + + The CAM SCSI tape driver doesn't yet handle older (and many times broken) + tape drives very well. If you've got an older SCSI-1 tape drive, like an + Exabyte 8200 or older QIC-type tape drive, it may not work properly with + the CAM tape driver. This is obviously a known problem, and we're + working on it. + + Newer tape drives that are mostly SCSI-2 compliant should work fine. + e.g., DAT (DDS-1, 2 and 3), DLT, and newer Exabyte 8mm drives should + work fine. + + If you want to find out if your particular tape drive is supported, the + best way to find out is to try it! + +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 + +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 + 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 + +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 + +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 + +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. + +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 + +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. + +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 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. + +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 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 +FreeBSD distributions: + + 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 ``world'' target, which will upgrade a 2.x +system to 3.0, or the ``aout-to-elf'' target, which will both upgrade +and convert the system to ELF binary format. +In the case of using the binary upgrade option, the system will go +straight to 3.0/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), but on the downside you'll also have access to far +fewer ports and packages since many of those have not been adapted to +ELF yet. This will occur in time, but those who wish to retain access +to the greatest number of packages and 3rd-party binaries should +probably stick with a.out. + +The kernel is also still in a.out format at this time so that older +LKMs and library interfaces can continue to work, but a full +transition to ELF will occur at some point after 3.0-RELEASE. Those +wishing to generate dynamic kernel components should therefore use the +newer KLD mechanism rather than the older LKM format - the LKM format +is not long for this world and will soon be unsupported! + +[ 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: + + 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 diff --git a/release/texts/TROUBLE.TXT b/release/texts/TROUBLE.TXT new file mode 100644 index 0000000..ca374ca --- /dev/null +++ b/release/texts/TROUBLE.TXT @@ -0,0 +1,374 @@ +=============== +Troubleshooting +=============== + + Table of Contents: + + Repairing an Existing FreeBSD Installation + + Common Installation Problems, Q&A + + Common Hardware Problems, Q&A + +Repairing an Existing FreeBSD Installation +------------------------------------------ + +FreeBSD releases 2.2.1 and later feature 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 2nd CDROM from Walnut Creek CDROM's FreeBSD +distribution. + +To invoke fixit, simply boot the boot floppy, chose 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 file systems and their contents. Some UNIX administration +experience *is* required to use the fixit option! + +Common Installation Problems, Q&A +--------------------------------- + +Q: 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 wd1s1a + panic: cannot mount root + + What is wrong? What can I do? + +Q: What is this 'bios_drive:interface(unit,partition)kernel_name' thing + that is displayed with the boot help? + +A: 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 wd0 and wd2. + + FreeBSD is on BIOS disk 1, of type 'wd' and the FreeBSD disk number + is 2, so you would say: + + 1:wd(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. + +Q: 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. + +A: 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 work- + station 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. + + +Known Hardware Problems, Q & A +------------------------------ + +Q: mcd0 keeps thinking that it has found a device and this stops my Intel + EtherExpress card from working. + +A: 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. + + +Q: FreeBSD claims to support the 3Com PCMCIA card, but my card isn't + recognized when it's plugged into my laptop. + +A: There are a couple of possible problems. First of all, FreeBSD does + not support multi-function cards, so if you have a combo + ethernet/modem card (such as the 3C562), it won't work. The + default driver for the 3C589 card was written just like all of the + other drivers in FreeBSD, and depend on the card's own configuration + data stored in NVRAM to work. You must correctly configure FreeBSD's + driver to match the IRQ, port, and IOMEM stored in NVRAM. + Unfortunately, the only program capable of reading them is the + 3COM supplied DOS program. This program must be run on a absolutely + clean system (no other drivers must be running), and the program will + whine about CARD-Services not being found, but it will continue. + This is necessary to read the NVRAM values. You want to know the + IRQ, port, and IOMEM values (the latter is called the CIS tuple by + 3COM). The first two can be set in the program, the third is + un-settable, and can only be read. Once you have these values, set + them in UserConfig and your card will be recognized. + + +Q: FreeBSD finds my PCMCIA network card, but no packets appear to + be sent even though it claims to be working. + +A: Many PCMCIA cards have the ability to use either the 10-Base2 (BNC) + or 10-BaseT connectors for connecting to the network. The driver is + unable to 'auto-select' the correct connector, so you must tell it + which connector to use. In order to switch between the two + connectors, the link flags must be set. Depending on the model of + the card, '-link0 link1' or 'link0 -link1' will choose the correct + network connector. You can set these in sysinstall by using the + 'Extra options to ifconfig:' field in the network setup screen. + + +Q: The system finds my ed network card, but I keep getting device + timeout errors. + +A: 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. + + +Q: I have a Matsushita/Panasonic drive but it isn't recognized by the + system. + +A: Make certain that the I/O port that the matcd driver is set to is + correct for the host interface card you have. (Some SoundBlaster DOS + drivers report a hardware I/O port address for the CD-ROM interface + that is 0x10 lower than it really is.) + + If you are unable to determine the settings for the card by examining + the board or documentation, you can use UserConfig to change the 'port' + address (I/O port) to -1 and start the system. This setting causes the + driver to look at a number of I/O ports that various manufacturers + use for their Matsushita/Panasonic/Creative CD-ROM interfaces. + Once the driver locates the address, you should run UserConfig again + and specify the correct address. Leaving the 'port' parameter set to -1 + increases the amount of time that it takes the system to boot, and + this could interfere with other devices. + + The double-speed Matsushita CR-562 and CR-563 are the only drives + that are supported. + + +Q: I booted the install floppy on my IBM ThinkPad (tm) laptop, and the + keyboard is all messed up. + +A: Older IBM laptops use a non-standard keyboard controller, so you must + tell the console driver (sc0) to go into a special mode which works + on the ThinkPads. Change the sc0 'Flags' to 0x10 in UserConfig and + it should work fine. (Look in the Input Menu for 'Syscons Console + Driver'.) + + +Q: I have a Matsushita/Panasonic CR-522, a Matsushita/Panasonic CR-523 or + a TEAC CD55a drive, but it is not recognized even when the correct I/O + port is set. + +A: These CD-ROM drives are currently not supported by FreeBSD. The command + sets for these drives are not compatible with the double-speed CR-562 + and CR-563 drives. + + The single-speed CR-522 and CR-523 drives can be identified by their + use of a CD-caddy. + + +Q: I'm trying to install from a tape drive but all I get is something like: + st0(aha0:1:0) NOT READY csi 40,0,0,0 + on the screen. Help! + +A: There's a limitation in the current sysinstall that the tape MUST + be in the drive while sysinstall is started or it won't be detected. + Try again with the tape in the drive the whole time. + + +Q: I've installed FreeBSD onto my system, but it hangs when booting from + the hard drive with the message: ``Changing root to /dev/sd0a''. + +A: This problem may occur in a system with a 3com 3c509 Ethernet adaptor. + The ep0 device driver appears to be sensitive to probes for other + devices that also use address 0x300. Boot your FreeBSD system by power + cycling the machine (turn off and on). At the ``Boot:'' prompt specify + the ``-c''. This will invoke UserConfig (see Section 1. above). Use + the ``disable'' command to disable the device probes for all devices + at address 0x300 except the ep0 driver. On exit, your machine should + successfully boot FreeBSD. + + +Q: My system hangs during boot, right after the "fd0: [my floppy drive]" + line. + +A: This is not actually a hang, simply a very LONG "wdc0" probe that + often takes a long time to complete on certain systems (where there + usually _isn't_ a WD controller). Be patient, your system will boot! + To eliminate the problem, boot with the -c flag and eliminate the wdc0 + device, or compile a custom kernel. + + +Q: My system can not find my Intel EtherExpress 16 card. + +A: 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. + + +Q: When installing on an EISA HP Netserver, my on-board AIC-7xxx + SCSI controller isn't detected. + +A: 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 + + there 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(8) 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. + + +Q: 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. + +A: 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. + + +Q: I have this CMD640 IDE controller that is said to be broken. + +A: Yes, it is. There's a workaround available now and it is enabled + automatically if this chip is used on your system. + For the details refer to the manual page of the disk driver (man 4 wd). + + +Q: On a Compaq Aero notebook, I get the message "No floppy devices found! + Please check ..." when trying to install from floppy. + +A: 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. + + +Q: When I go to boot my Intel AL440LX ("Atlanta") -based system from the + hard disk the first time, it stops with a "Read Error" message. + +A: There appears to be a bug in the BIOS on at least some of these boards, + this bug results in the FreeBSD bootloader thinking that it is booting + from a floppy disk. + This is only a problem if you are not using the BootEasy boot manager. + Slice the disk in 'compatible' mode and install BootEasy during the + FreeBSD installation to avoid the bug, or upgrade the BIOS (see Intel's + website for details). + +Q: When installing on an Dell Poweredge XE, Dell proprietary RAID controller + DSA (Dell SCSI Array) isn't recognized. + +A: Configure DSA to use AHA-1540 emulation using EISA configuration utility. + After that FreeBSD detects DSA as 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. + + +Q: My Ethernet adapter is detected as an AMD PCnet-FAST (or similar) but + it doesn't work. (Eg. onboard Ethernet on IBM Netfinity 5xxx or 7xxx) + +A: The 'lnc' driver is currently faulty, and will often not work correctly + with the PCnet-FAST and PCnet-FAST+. You need to install a different + Ethernet adapter. + + +Q: I have an IBM EtherJet PCI card, it is detected by the 'fxp' driver + correctly, but the lights on the card don't come on and it doesn't + connect to the network. + +A: 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. + + +Q: When I configure the network during installation on an IBM Netfinity + 3500, the system freezes. + +A: 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. + + +Q: Why does my CD-220E (rev 1.0D) IDE CD-ROM lock up the system when + I use it? + +A: There are apparently firmware problems with this drive and, + though a fix may soon be forthcoming, it should probably be avoided + for now. + +[ Please send hardware tips for this Q&A section to jkh@freebsd.org ] diff --git a/release/texts/UPGRADE.TXT b/release/texts/UPGRADE.TXT new file mode 100644 index 0000000..8b7b893 --- /dev/null +++ b/release/texts/UPGRADE.TXT @@ -0,0 +1,168 @@ ++===================== Upgrading FreeBSD ==========================+ +| | +| 0.0 Preface | +| 0.1 DISCLAIMER | +| 0.2 IMPORTANT NOTE | +| | +| 1.0 Introduction | +| 1.1 Upgrade Overview | +| | +| 2.0 Procedure | +| 2.1 Backup | +| 2.2 Mount Filesystems | +| 2.3 Select Distributions | +| 2.4 After Installation | +| | +| 3.0 Alternative Upgrade Techniques | +| | ++=====================================================================+ + +0.1 DISCLAIMER +--- ---------- + +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. + +0.2 IMPORTANT NOTE +--- -------------- + +If you are upgrading from FreeBSD 2.2.5 or earlier, see +section 2.4 for important details regarding changes to the +/etc/fstab file required during the upgrade procedure. + +1.0 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 +document in its entirety before commencing an upgrade. Failure to do so +may result in a failed upgrade or loss of data. + +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, adduser.conf, aliases, aliases.db, amd.map, crontab, + csh.cshrc, csh.login, csh.logout, daily, disktab, dm.conf, exports, + fbtab, fstab, ftpusers, gettytab, gnats, group, host.conf, hosts, + hosts.equiv, hosts.lpd, inetd.conf, kerberosIV, localtime, login.access, + mail.rc, make.conf, manpath.config, master.passwd, mib.txt, modems, + monthly, motd, namedb, networks, passwd, phones, ppp, printcap, + profile, protocols, pwd.db, rc, rc.firewall, rc.i386, rc.local, + rc.network, rc.conf, remote, resolv.conf, rmt, security, sendmail.cf, + services, shells, skeykeys, spwd.db, supfile, syslog.conf, termcap, + ttys, uucp, weekly + +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. + +2.0 Procedure +--- --------- + +This section details the upgrade procedure. Particular attention is +given to items which substantially differ from a normal installation. + +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. + +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. + +2.3 Select Distributions +--- -------------------- + +When selecting distributions, there are no constraints on which must be +selected. As a general rule, the 'bin' 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. + +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. + +Read the following, but DO NOT update /etc/fstab as described below +until the new system has booted correctly. The upgrade procedure +replaces the previous FreeBSD kernel with a GENERIC kernel, and a custom +kernel may need to be generated to suit the local system configuration. + +IMPORTANT NOTE: +============== +FreeBSD 2.2.6 introduced a change in the naming of the device from +which the root filesystem is mounted. This change affects all systems, +however user intervention is only required for systems undergoing an +upgrade installation from a version prior to FreeBSD 2.2.6. + +Previously, the root filesystem was always mounted from the +compatibility slice, while other partitions on the same disk were +mounted from their true slice. This might, for example, have resulted +in an /etc/fstab file like: + +# Device Mountpoint FStype Options Dump Pass# +/dev/wd0s2b none swap sw 0 0 +/dev/wd0a / ufs rw 1 1 +/dev/wd0s2f /local0 ufs rw 1 1 +/dev/wd0s2e /usr ufs rw 1 1 + +For FreeBSD 2.2.6 and later, this format changes so that the device for +'/' is consistent with others, ie. + +# Device Mountpoint FStype Options Dump Pass# +/dev/wd0s2b none swap sw 0 0 +/dev/wd0s2a / ufs rw 1 1 +/dev/wd0s2f /local0 ufs rw 1 1 +/dev/wd0s2e /usr ufs rw 1 1 + + +If /etc/fstab is not updated manually in this case, the system will +issue a warning message whenever / is mounted (normally at startup) +indicating the change that must be made. In addition, trouble may be +experienced if the root filesystem is not correctly unmounted, whereby +the root filesystem will not be marked clean at the next reboot. + +This change should be made as soon as the upgraded system has been +successfully rebooted. + +3.0 Alternative Upgrade Techniques +--- ------------------------------ + +Those interested in an upgrade method that allows more flexibility and +sophistication should take a look at the "Upgrading FreeBSD from source" +tutorial found at http://www.freebsd.org/docs.html. This method +requires reliable network connectivity, extra disk space and spare time, +but has advantages for networks and other more complex installations. diff --git a/release/texts/XFREE86.TXT b/release/texts/XFREE86.TXT new file mode 100644 index 0000000..4757fb0 --- /dev/null +++ b/release/texts/XFREE86.TXT @@ -0,0 +1,1580 @@ + + README for XFree86[tm] 3.3.2.3 + + + The XFree86 Project, Inc + + + 20 July 1998 + + + + Abstract + + XFree86 is a port of X11R6.3 that supports several Unix and Unix-like + operating systems on Intel and other platforms. This release is a + maintenance release, fixing bugs found in XFree86 3.3.1. The release + is available as source patches against the X Consortium X11R6.3 code + and the XFree86 3.3.1 release. Binary distributions for many archi- + tectures are also available. + + +[ FreeBSD Project Note: 3.3.2.3 is a security release relative to 3.3.2. + Where 3.3.2 is referred to below, understand that "3.3.2.3" is actually + being referred to. ] + +1. What's new in XFree86 3.3.2 + +For a summary of new features in this release, please refer to the RELNOTES +file. For a detailed list of changes, refer to the CHANGELOG file in the +source distribution. + + +2. Systems XFree86 has been tested on + +Note: Not all systems listed here have been tested with the current release. + + SVR4.0: + + o Esix: 4.0.3A, 4.0.4, 4.0.4.1 + + o Microport: 2.2, 3.1, 4.1, 4.2 + + o Dell: 2.1, 2.2, 2.2.1 + + o UHC: 2.0, 3.6 + + o Consensys: 1.2 + + o MST: 4.0.3 (Load 2.07 and Load 3.02) + + o ISC: 4.0.3 + + o AT&T: 2.1, 4.0 + + + + +README for XFree86[tm] 3.3.2 + + + + + +README for XFree86[tm] 3.3.2 + + + + o NCR: MP-RAS + + o SunSoft: Solaris x86 2.1, 2.4, 2.5, 2.5.1, 2.6 + + o PANIX 5.0 for AT + + + SVR4.2: + + o Consensys + + o Novell UnixWare + + + SVR3: + + o ISC: 3.0, 4.0, 4.1 + + + Others: + + o NetBSD 1.0, 1.1, 1.2, 1.2.1, 1.3 + + o OpenBSD 2.0, 2.1 + + o FreeBSD 2.0.5, 2.1, 2.1.5, 2.1.6, 2.1.7, 2.1.7.1, 2.2, 2.2.1, + 2.2.2, 2.2.5, 3.0-current + + o Linux (Intel x86, DEC Alpha/AXP and m68k) + + o LynxOS AT 2.3.0, 2.4.0, 2.5.0 + + o LynxOS microSPARC 2.4.0, 2.5.0 + + o LynxOS PowerPC 2.4.0, 2.5.0 + + o OS/2 Warp 3 FP5/17/22, Warp 4 -/FP1 + + + PC98: + + o FreeBSD(98) 2.0.5, 2.1, 2.1.5, 2.1.7.1, 2.2, 2.2.1, 2.2.2, + 2.2.5 + + o NetBSD/pc98 (based on NetBSD 1.2, 1.2.1) + + o PANIX 5.0 for 98 + + o Linux/98 + + +3. Supported video-card chip-sets + +At this time, XFree86 3.3.2 supports the following chipsets: + + + + + + + + +README for XFree86[tm] 3.3.2 + + + + Ark Logic + ARK1000PV, ARK1000VL, ARK2000PV, ARK2000MT + + Alliance + AP6422, AT24 + + ATI + 18800, 18800-1, 28800-2, 28800-4, 28800-5, 28800-6, 68800-3, + 68800-6, 68800AX, 68800LX, 88800GX-C, 88800GX-D, 88800GX-E, + 88800GX-F, 88800CX, 264CT, 264ET, 264VT, 264GT, 264VT-B, 264VT3, + 264GT-B, 264GT3 (this list includes the Mach8, Mach32, Mach64, 3D + Rage, 3D Rage II and 3D Rage Pro) + + Avance Logic + ALG2101, ALG2228, ALG2301, ALG2302, ALG2308, ALG2401 + + Chips & Technologies + 65520, 65530, 65540, 65545, 65520, 65530, 65540, 65545, 65546, + 65548, 65550, 65554, 65555, 68554, 64200, 64300 + + Cirrus Logic + CLGD5420, CLGD5422, CLGD5424, CLGD5426, CLGD5428, CLGD5429, + CLGD5430, CLGD5434, CLGD5436, CLGD5440, CLGD5446, CLGD5462, + CLGD5464, CLGD5465, CLGD5480, CLGD6205, CLGD6215, CLGD6225, + CLGD6235, CLGD6410, CLGD6412, CLGD6420, CLGD6440, CLGD7541(*), + CLGD7543(*), CLGD7548(*), CLGD7555(*) + + Digital Equipment Corporation + TGA + + Compaq + AVGA + + Genoa + GVGA + + IBM + 8514/A (and true clones), XGA-2 + + IIT + AGX-014, AGX-015, AGX-016 + + Matrox + MGA2064W (Millennium), MGA1064SG (Mystique and Mystique 220), + MGA2164W (Millennium II PCI and AGP) + + MX + MX68000(*), MX680010(*) + + NCR + 77C22(*), 77C22E(*), 77C22E+(*) + + Number Nine + I128 (series I and II), Revolution 3D (T2R) + + + + + + + + +README for XFree86[tm] 3.3.2 + + + + NVidia/SGS Thomson + NV1, STG2000, RIVA128 + + OAK + OTI067, OTI077, OTI087 + + RealTek + RTG3106(*) + + S3 + 86C911, 86C924, 86C801, 86C805, 86C805i, 86C928, 86C864, 86C964, + 86C732, 86C764, 86C765, 86C767, 86C775, 86C785, 86C868, 86C968, + 86C325, 86C357, 86C375, 86C375, 86C385, 86C988, 86CM65, 86C260 + + SiS + 86C201, 86C202, 86C205 + + Tseng + ET3000, ET4000AX, ET4000/W32, ET4000/W32i, ET4000/W32p, ET6000, + ET6100 + + Trident + TVGA8800CS, TVGA8900B, TVGA8900C, TVGA8900CL, TVGA9000, TVGA9000i, + TVGA9100B, TVGA9200CXR, Cyber9320(*), TVGA9400CXi, TVGA9420, + TGUI9420DGi, TGUI9430DGi, TGUI9440AGi, TGUI9660XGi, TGUI9680, Pro- + Vidia 9682, ProVidia 9685(*), Cyber 9382, Cyber 9385, Cyber 9388, + 3DImage975(PCI), 3DImage985(AGP), Cyber 9397, Cyber 9520 + + Video 7/Headland Technologies + HT216-32(*) + + Weitek + P9000 + + Western Digital/Paradise + PVGA1 + + Western Digital + WD90C00, WD90C10, WD90C11, WD90C24, WD90C24A, WD90C30, WD90C31, + WD90C33 + +(*) Note, chips marked in this way have either limited support or the drivers +for them are not actively maintained. + +All of the above are supported in both 256 color, and some are supported in +mono and 16 color modes, and some are supported an higher color depths. + +Refer to the chipset-specific README files (currently for TGA, Matrox, Mach32, +Mach64, NVidia, Oak, P9000, S3 (except ViRGE), S3 ViRGE, SiS, Video7, Western +Digital, Tseng (W32), Tseng (all), AGX/XGA, ARK, ATI (SVGA server), Chips and +Technologies, Cirrus, Trident) for more information about using those chipsets. + +The monochrome server also supports generic VGA cards, using 64k of video mem- +ory in a single bank, the Hercules monochrome card, the Hyundai HGC1280, Sigma + + + + + + + + +README for XFree86[tm] 3.3.2 + + + +LaserView, Visa and Apollo monochrome cards. + +The VGA16 server supports memory banking with the ET4000, Trident, ATI, NCR, +OAK and Cirrus 6420 chipsets allowing virtual display sizes up to about +1600x1200 (with 1MB of video memory). For other chipsets the display size is +limited to approximately 800x600. + +Notes: The Diamond SpeedStar 24 (and possibly some SpeedStar+) boards are NOT +supported, even though they use the ET4000. + +The Weitek 9100 and 9130 chipsets are not supported (these are used on the Dia- +mond Viper Pro and Viper SE boards). Most other Diamond boards will work with +this release of XFree86. Diamond is actively supporting The XFree86 Project, +Inc. + +3DLabs GLINT, Permedia and Permedia 2 support could unfortunately not be +included in XFree86 3.3.2 since there are open issues regarding the documenta- +tion and whether or not they were provided to us under NDA. + +S.u.S.E. will continue to make available binary only servers for these cards. +These servers can be freely distributed just like XFree86, but sources cannot +be made available. S.u.S.E. will continue to develop these servers and will +continue to try to donate the code back to XFree86. For the time being S.u.S.E. +will try to not only make Linux binaries available, but binaries for other +platforms as well. + +Please contact x@suse.de with further questions. You can find the servers at +http://www.suse.de/XSuSE/XSuSE_E.html + + +4. Where to get more information + +Additional documentation is available in the XFree86(1), XF86Config(4/5), +XF86_SVGA(1), XF86_Mono(1), XF86_VGA16(1), XF86_Accel(1), XF86Setup(1) and +xvidtune(1) manual pages. In addition, several README files and tutorial docu- +ments are provided. These are available in /usr/X11R6/lib/X11/doc in the +binary distributions, and in xc/programs/Xserver/hw/xfree86/doc in the source +distribution. + +The files QuickStart.doc and README.Config should be consulted for information +on how to set up the XFree86 servers. All supplied documents, manual pages, +and the XFree86 FAQ <URL:http://www.XFree86.org/FAQ> should be read before con- +tacting the XFree86 team for assistance. + +Documentation on SVGA driver development can be found in the directory +/usr/X11R6/lib/Server/VGADriverDoc in the binary distribution, and in the +directory xc/programs/Xserver/hw/xfree86/VGADriverDoc in the source distribu- +tion. + +If you are totally at a loss, you can contact the XFree86 Support Team at +<XFree86@XFree86.Org>. Before doing so, please make sure that you are using +the latest release of XFree86. Check the versions listed on +ftp://ftp.xfree86.org/pub/XFree86. + + + + + + + + + +README for XFree86[tm] 3.3.2 + + + +There is a Usenet news group comp.windows.x.i386unix that contains mostly dis- +cussions about XFree86 and related topics. Many questions can be answered +there. + + +5. Thanks + +The XFree86 Project wants to express a special thanks to S.u.S.E. GmbH, Fuerth, +Germany, for the long and successful cooperation over the last few years. +S.u.S.E. GmbH at one point hired our Core Team member and Vice President Dirk +Hohndel as an employee and allowed him to work more or less full time on +XFree86 for almost nine months. S.u.S.E. continues to be a significant source +of input and help to XFree86. This manifested itself in the XSuSE series of X +servers that have all except for the GLINT server (due to unresolved legal +issues) been integrated into XFree86 3.3.2. + + +6. Credits + +XFree86 was originally put together by: + + o David Dawes <dawes@XFree86.org> + + o Glenn Lai <glenn@cs.utexas.edu> + + o Jim Tsillas <jtsilla@ccs.neu.edu> + + o David Wexelblat <dwex@XFree86.org> + +XFree86 support was integrated into the base X11R6 distribution by: + + o Stuart Anderson <anderson@metrolink.com> + + o Doug Anson <danson@lgc.com> + + o Gertjan Akkerman <akkerman@dutiba.twi.tudelft.nl> + + o Mike Bernson <mike@mbsun.mlb.org> + + o Robin Cutshaw <robin@XFree86.org> + + o David Dawes <dawes@XFree86.org> + + o Marc Evans <marc@XFree86.org> + + o Pascal Haible <haible@izfm.uni-stuttgart.de> + + o Matthieu Herrb <Matthieu.Herrb@laas.fr> + + o Dirk Hohndel <hohndel@XFree86.org> + + o David Holland <davidh@use.com> + + + + + + + + + + +README for XFree86[tm] 3.3.2 + + + + o Alan Hourihane <alanh@fairlite.demon.co.uk> + + o Jeffrey Hsu <hsu@soda.berkeley.edu> + + o Glenn Lai <glenn@cs.utexas.edu> + + o Ted Lemon <mellon@ncd.com> + + o Rich Murphey <rich@XFree86.org> + + o Hans Nasten <nasten@everyware.se> + + o Mark Snitily <mark@sgcs.com> + + o Randy Terbush <randyt@cse.unl.edu> + + o Jon Tombs <tombs@XFree86.org> + + o Kees Verstoep <versto@cs.vu.nl> + + o Paul Vixie <paul@vix.com> + + o Mark Weaver <Mark_Weaver@brown.edu> + + o David Wexelblat <dwex@XFree86.org> + + o Philip Wheatley <Philip.Wheatley@ColumbiaSC.NCR.COM> + + o Thomas Wolfram <wolf@prz.tu-berlin.de> + + o Orest Zborowski <orestz@eskimo.com> + + 386BSD, FreeBSD, NetBSD support by: + + o Rich Murphey <Rich@XFree86.org> + + NetBSD, OpenBSD support by: + + o Matthieu Herrb <Matthieu.Herrb.@laas.fr> + + Original 386BSD port by: + + o Pace Willison, + + o Amancio Hasty Jr <hasty@netcom.com> + + Mach 386 support by: + + o Robert Baron <Robert.Baron@ernst.mach.cs.cmu.edu> + + Linux support by: + + o Orest Zborowski <orestz@eskimo.com> + + + + + + + + + +README for XFree86[tm] 3.3.2 + + + + SCO Unix support by: + + o David McCullough <davidm@stallion.oz.au> + + Amoeba support by: + + o Kees Verstoep <versto@cs.vu.nl> + + Minix-386 support by: + + o Philip Homburg <philip@cs.vu.nl> + + OSF/1 support by: + + o Marc Evans <Marc@XFree86.org> + + BSD/OS support by: + + o Hans Nasten <nasten@everyware.se>, + + o Paul Vixie <paul@vix.com> + + Solaris support by: + + o Doug Anson <danson@lgc.com>, + + o David Holland <davidh@use.com> + + ISC SVR3 support by: + + o Michael Rohleder <michael.rohleder@stadt-frankfurt.de> + + LynxOS support by: + + o Thomas Mueller <tmueller@sysgo.de> + + OS/2 support by: + + o Holger Veit <Holger.Veit@gmd.de> + + o Sebastien Marineau <s521936@aix1.uottawa.ca> + + Linux shared libraries by: + + o Orest Zborowski <orestz@eskimo.com>, + + o Dirk Hohndel <hohndel@XFree86.org> + + PC98 support by: + + o Toyonori Fujiura <toyo@ibbsal.or.jp>, + + o Hiroyuki Aizu <aizu@jaist.ac.jp>, + + + + + + + + + +README for XFree86[tm] 3.3.2 + + + + o Tetsuya Kakefuda <kakefuda@tag.iijnet.or.jp>, + + o Takefumi Tsukada <tsuka@linkt.imasy.or.jp>, + + o H.Komatsuzaki, + + o Naoki Katsurakawa <katsura@prc.tsukuba.ac.jp>, + + o Shuichiro Urata <s-urata@nmit.tmg.nec.co.jp>, + + o Yasuyuki Kato <yasuyuki@acaets0.anritsu.co.jp>, + + o Michio Jinbo <karl@spnet.ne.jp>, + + o Tatsuya Koike <koiket@focus.rim.or.jp>, + + o Koichiro Suzuki <s-koichi@nims.nec.co.jp>, + + o Tsuyoshi Tamaki <tamaki@sail.t.u-tokyo.ac.jp>, + + o Isao Ohishi <ohishi@hf.rim.or.jp>, + + o Kohji Ohishi <atena@njk.co.jp>, + + o Shin'ichi Yairo <QZR00522@niftyserve.or.jp>, + + o Kazuo Ito <ft4k-itu@asahi-net.or.jp>, + + o Jun Sakuma <i931361@jks.is.tsukuba.ac.jp>, + + o Shuichi Ueno <uenos@ppp.bekkoame.or.jp>, + + o Ishida Kazuo <ishidakz@obp.cl.nec.co.jp>, + + o Takaaki Nomura <amadeus@yk.rim.or.jp>, + + o Tadaaki Nagao <nagao@cs.titech.ac.jp>, + + o Minoru Noda <mnoda@cv.tottori-u.ac.jp>, + + o Naofumi Honda <honda@Kururu.math.hokudai.ac.jp>, + + o Akio Morita <amorita@bird.scphys.kyoto-u.ac.jp>, + + o Takashi Sakamoto <sakamoto@yajima.kuis.kyoto-u.ac.jp>, + + o Yasuhiro Ichikawa <cs94006@mbox.sist.ac.jp>, + + o Kazunori Ueno <jagarl@creator.club.or.jp>, + + o Yasushi Suzuki <suz@d2.bs1.fc.nec.co.jp>, + + o Satoshi Kimura <KFB03633@niftyserve.or.jp>, + + + + + + + + + +README for XFree86[tm] 3.3.2 + + + + o Kazuhiko Uno <Kazuhiko.Uno@softvision.co.jp>, + + o Tomiharu Takigami <takigami@elsd.mt.nec.co.jp>, + + o Tomomi Suzuki <suzuki@grelot.elec.ryukoku.ac.jp>, + + o Toshihiko Yagi <j2297222@ed.kagu.sut.ac.jp>, + + o Masato Yoshida (Contributor of PW805i support) + + Original accelerated code by: + + o Kevin Martin <martin@cs.unc.edu>, + + o Rik Faith <faith@cs.unc.edu>, + + o Jon Tombs <tombs@XFree86.org> + + XFree86 Acceleration Architecture (XAA) by: + + o Harm Hanemaayer <H.Hanemaayer@inter.nl.net>, + + S3 accelerated code by: + + o Jon Tombs <tombs@XFree86.org>, + + o Harald Koenig <koenig@tat.physik.uni-tuebingen.de>, + + o David Wexelblat <dwex@XFree86.org>, + + o David Dawes <dawes@XFree86.org>, + + o Robin Cutshaw <robin@XFree86.org>, + + o Amancio Hasty <hasty@netcom.com>, + + o Norbert Distler <Norbert.Distler@physik.tu-muenchen.de>, + + o Leonard N. Zubkoff <lnz@dandelion.com>, + + o Bernhard Bender <br@elsa.mhs.compuserve.com>, + + o Dirk Hohndel <hohndel@XFree86.org>, + + o Joe Moss <joe@XFree86.org> + + S3V accelerated code by: + + o Harald Koenig <koenig@tat.physik.uni-tuebingen.de>, + + o Kevin Brosius <Cobra@compuserve.com> + + o Berry Dijk <berry_dijk@tasking.nl> + + + + + + + + + +README for XFree86[tm] 3.3.2 + + + + o Dirk Hohndel <hohndel@XFree86.org> + + o Huver Hu <huver@amgraf.com> + + o Dirk Vangestel <gesteld@sh.bel.alcatel.be> + + Mach32 accelerated code by: + + o Kevin Martin <martin@cs.unc.edu>, + + o Rik Faith <faith@cs.unc.edu>, + + o Mike Bernson <mike@mbsun.mlb.org>, + + o Mark Weaver <Mark_Weaver@brown.edu>, + + o Craig Groeschel <craig@metrolink.com> + + o Bryan Feir <jenora@istar.ca> + + Mach64 accelerated code by: + + o Kevin Martin <martin@cs.unc.edu>, + + Mach8, 8514 accelerated code by: + + o Kevin Martin <martin@cs.unc.edu>, + + o Rik Faith <faith@cs.unc.edu>, + + o Tiago Gons <tiago@comosjn.hobby.nl>, + + o Hans Nasten <nasten@everyware.se>, + + o Scott Laird <scott@laird.com> + + Cirrus accelerated code by: + + o Simon Cooper <scooper@vizlab.rutgers.edu>, + + o Harm Hanemaayer <H.Hanemaayer@inter.nl.net>, + + o Bill Reynolds <bill@goshawk.lanl.gov>, + + o Corin Anderson <corina@the4cs.com> + + Western Digital accelerated code by: + + o Mike Tierney <floyd@pepsi.eng.umd.edu>, + + o Bill Conn <conn@bnr.ca> + + P9000 accelerated code by: + + + + + + + + + +README for XFree86[tm] 3.3.2 + + + + o Erik Nygren <nygren@mit.edu>, + + o Harry Langenbacher <harry@brain.jpl.nasa.gov> + + o Chris Mason <mason@mail.csh.rit.edu> + + o Henrik Harmsen <harmsen@eritel.se> + + AGX accelerated code by: + + o Henry Worth <haworth@wco.com>, + + Number Nine I128 driver by: + + o Robin Cutshaw <robin@XFree86.org>, + + ET4000/W32 accelerated code by: + + o Glenn Lai <glenn@cs.utexas.edu>, + + ET6000 SVGA and accelerated support (both based on the existing W32 code) by: + + o Koen Gadeyne <koen.gadeyne@barco.com>, + + Oak Technologies Inc. accelerated code by: + + o Jorge Delgado <ernar@dit.upm.es>, + + 16 color VGA server by: + + o Gertjan Akkerman <akkerman@dutiba.twi.tudelft.nl> + + 2 color VGA and non-VGA mono servers by: + + o Pascal Haible <haible@izfm.uni-stuttgart.de> + + ATI SVGA driver by: + + o Per Lindqvist <pgd@compuram.bbt.se> and Doug Evans + <dje@cygnus.com>. + + o Ported to X11R5 by Rik Faith <faith@cs.unc.edu>. + + o Rewritten by Marc Aurele La France <tsi@ualberta.ca> + + WD90C24 support by: + + o Brad Bosch <brad@lachman.com> + + Trident SVGA driver by: + + o Alan Hourihane <alanh@fairlite.demon.co.uk> + + + + + + + + + + +README for XFree86[tm] 3.3.2 + + + + SiS SVGA driver by: + + o Alan Hourihane <alanh@fairlite.demon.co.uk> + + o Xavier Ducoin <xavier@rd.lectra.fr> + + DEC 21030 (TGA) server by: + + o Alan Hourihane <alanh@fairlite.demon.co.uk> + + o Harald Koenig <koenig@tat.physik.uni-tuebingen.de> + + NCR SVGA driver by: + + o Stuart Anderson <anderson@metrolink.com> with the permission + of NCR Corporation + + Cirrus SVGA driver by: + + o Bill Reynolds <bill@goshawk.lanl.gov>, + + o Hank Dietz <hankd@ecn.purdue.edu>, + + o Simon Cooper <scooper@vizlab.rutgers.edu>, + + o Harm Hanemaayer <H.Hanemaayer@inter.nl.net>, + + o Corin Anderson <corina@the4cs.com> + + Cirrus CL64xx driver by: + + o Manfred Brands <mb@oceonics.nl> + + o Randy Hendry <randy@sgi.com> + + o Jeff Kirk <jeff@bambam.dsd.ES.COM> + + Compaq SVGA driver by: + + o Hans Oey <hans@mo.hobby.nl> + + o Ming Yu <yum@itp.ac.cn> + + o Gerry Toll <gtoll@tc.cornell.edu> + + Oak SVGA driver by: + + o Steve Goldman <sgoldman@encore.com> + + o Jorge Delgado <ernar@dit.upm.es> + + ARK Logic SVGA driver by: + + + + + + + + + + +README for XFree86[tm] 3.3.2 + + + + o Harm Hanemaayer <H.Hanemaayer@inter.nl.net> + + o Leon Bottou <bottou@laforia.ibp.fr> + + AL2101 SVGA driver by: + + o Paolo Severini <lendl@dist.dist.unige.it> + + Avance Logic ``ali'' SVGA driver by: + + o Ching-Tai Chiu <cchiu@netcom.com> + + Chips & Technologies SVGA driver by: + + o Regis Cridlig <cridlig@dmi.ens.fr> + + o Jon Block <block@frc.com> + + o Mike Hollick <hollick@graphics.cis.upenn.edu> + + o Nozomi Ytow + + o Egbert Eich <Egbert.Eich@Physik.TH-Darmstadt.DE> + + o David Bateman <dbateman@ee.uts.edu.au> + + o Xavier Ducoin <xavier@rd.lectra.fr> + + MX SVGA driver by: + + o Frank Dikker <dikker@cs.utwente.nl> + + Video7 SVGA driver by: + + o Craig Struble <cstruble@acm.vt.edu> + + RealTek SVGA driver by: + + o Peter Trattler <peter@sbox.tu-graz.ac.at> + + Apollo Mono driver by: + + o Hamish Coleman <hamish@zot.apana.org.au> + + Matrox SVGA driver by: + + o Guy Desbief <g.desbief@aix.pacwan.net> + + o Radoslaw Kapitan <kapitan@student.uci.agh.edu.pl> + + o Andrew Vanderstock <vanderaj@mail2.svhm.org.au> + + o Angsar Hockmann <Ansgar.Hockmann@hrz.uni-dortmund.de> + + + + + + + + + +README for XFree86[tm] 3.3.2 + + + + o Michael Will <Michael.Will@student.uni-tuebingen.de> + + o Andrew Mileski <aem@ott.hookup.net> + + o Stephen Pitts <pitts2@memphisonline.com> + + o Dirk Hohndel <hohndel@XFree86.Org> + + o Leonard N. Zubkoff <lnz@dandelion.com> + + ViRGE SVGA driver by: + + o Sebastien Marineau <marineau@genie.uottawa.ca>, + + o Harald Koenig <koenig@tat.physik.uni-tuebingen.de> + + Linux/m68k Frame Buffer Device driver by: + + o Martin Schaller + + o Geert Uytterhoeven <Geert.Uytterhoeven@cs.kuleuven.ac.be> + + o Andreas Schwab <schwab@issan.informatik.uni-dortmund.de> + + o Guenther Kelleter <guenther@Pool.Informatik.RWTH-Aachen.de> + + Tseng ET4000 and ET6000 SVGA driver by: + + o [Unknown authors] + + o Dirk Hohndel <hohndel@XFree86.Org> + + o Koen Gadeyne <koen.gadeyne@barco.com> + + o ... and others + + XFree86-VidModeExtension and xvidtune client by: + + o Kaleb S. Keithley <kaleb@x.org> + + o David Dawes <dawes@XFree86.org> + + o Jon Tombs <tombs@XFree86.org> + + o Joe Moss <joe@XFree86.org> + + XFree86-Misc extension by: + + o Joe Moss <joe@XFree86.org> + + o David Dawes <dawes@XFree86.org> + + XFree86-DGA extension by: + + + + + + + + + +README for XFree86[tm] 3.3.2 + + + + o Jon Tombs <tombs@XFree86.org> + + o Mark Vojkovich <mvojkovi@ucsd.edu> + + o Harm Hanemaayer <H.Hanemaayer@inter.nl.net>, + + o David Dawes <dawes@XFree86.org> + + XInput integration, devices and clients by: + + o Frederic Lepied <lepied@XFree86.Org> (XInput integration, + Wacom tablet, Joystick and extended mouse devices, xsetpointer + and xsetmode clients) + + o Patrick Lecoanet <lecoanet@cena.dgac.fr> (Elographics touch- + screen device) + + o Steven Lang <tiger@tyger.org> (Summagraphics tablet device) + + Other contributors: + + o Joerg Wunsch <joerg_wunsch@uriah.sax.de> (ET3000 banked mono), + + o Thomas Dickey <dickey@clark.net> (xterm "new" model ANSI col- + ors and VT220, VT520 emulation). + + o Eric Raymond <esr@snark.thyrsus.com> (new video mode documen- + tation), + + o and an entire horde of beta-testers around the world! + + +7. Contact information + +Ongoing development planning and support is coordinated by the XFree86 Core +Team. At this time the Core Team consists of (in alphabetical order): + + o Robin Cutshaw <robin@XFree86.org> + + o David Dawes <dawes@XFree86.org> + + o Marc Evans <marc@XFree86.org> + + o Harm Hanemaayer <H.Hanemaayer@inter.nl.net> + + o Dirk Hohndel <hohndel@XFree86.org> + + o Harald Koenig <koenig@XFree86.org> + + o Rich Murphey <rich@XFree86.org> + + o Jon Tombs <tombs@XFree86.org> + + + + + + + + + + +README for XFree86[tm] 3.3.2 + + + + o David Wexelblat <dwex@XFree86.org> + +Mail sent to <Core@XFree86.org> will reach the core team. Please note that +support questions should be sent to <XFree86@XFree86.org>. + + +8. The XFree86 Project, Inc. + +The XFree86 Project, Inc, was founded to accomplish two major goals: + + 1. To provide a vehicle by which XFree86 can be represented in X Consortium, + Inc, the organization responsible for the design, development, and + release of The X Window System. + + 2. To provide some basic funding for acquisition of facilities for ongoing + XFree86 development, largely to consist of new video hardware and basic + computing facilities. + +The first of these was the primary motivation. We have held discussions with +the X Consortium on and off for many months, attempting to find an avenue by +which our loosely-organized free software project could be given a voice within +the X Consortium. The bylaws of the Consortium would not recognize such an +organization. After an initial investigation about funding, we decided to form +our own corporation to provide the avenue we needed to meet the requirements of +the X Consortium bylaws. + +By doing this, we were able to be involved in the beta-test interval for X11R6, +and have contributed the majority of XFree86 to the X11R6 and X11R6.1 core +release. The version of XFree86 in the initial X11R6 core is 3.0. The version +of XFree86 in the current X11R6.3 release is 3.2. + +An additional benefit of this incorporation is that The XFree86 Project, Inc +has obtained outside financial support for our work. This will hopefully give +us the freedom to be more pro-active in obtaining new video hardware, and +enable us to release better products more quickly, as we will be able to go and +get what we need, and get it into the hands of the people who can do the work. + +The current Board of Directors and Officers of the The XFree86 Project, Inc, +are: + + o David Dawes, President and Secretary + + o Dirk Hohndel, Vice-President + + o Glenn Lai, Director + + o Rich Murphey, Treasurer + + o Jim Tsillas, Director + + o Jon Tombs, Director + + o David Wexelblat, Director + + + + + + + + + +README for XFree86[tm] 3.3.2 + + + +Email to <BOD@XFree86.org> reaches the board of directors. + +Our bylaws have been crafted in such a way to ensure that XFree86 is and always +will be a free software project. There is no personal financial benefit to any +member of the Core Team or any other XFree86 participant. All assets of the +corporation remain with the corporation, and, in the event of the dissolution +of the corporation, all assets will be turned over to the X Consortium, Inc. +It is hoped that by doing this, our corporation will be merely a formalization +of what we have been doing in the past, rather than something entirely new. + +As of March 1997, The XFree86 Project has revised its source/binary access and +release policy. The main points of the new policy are: + + o There will be no more time-limited public binary-only beta releases. + Instead we plan to increase the frequency of full public releases to about + four releases per year. + + o The source access/use is divided into three categories: + + o End users. End users have access to only the source of full public + releases. The main reason for this restriction is that our develop- + ment code often contains code from other sources which cannot be + released to the public immediately. + + o Active developers (members of the XFree86 ``developer team''). + Active developers must formally become non-voting members of the + XFree86 Project, and have full access to our internal development + source. They are permitted to make time-limited binaries (in coordi- + nation with the Core Team) of the servers they are actively working + on available to external testers for specific testing. + + o Commercial members. Commercial members are non-voting members of The + XFree86 Project who donate US$5000/year to the Project. Addition- + ally, companies who contribute significantly to the development + effort of XFree86 can be awarded commercial membership by the Core + Team on a yearly bases. Commercial members can use the internal + XFree86 development source for derived binary-only products providing + that they take full responsibility for supporting the product, and + don't call it ``XFree86'' (although the derivation of the product + must be acknowledged in any accompanying documentation). Binary + packages for the OSs we support which are simply compiled from our + internal source without significant added value are explicitly NOT + allowed. + +Here is a list of the organizations and individuals who have provided sponsor- +ship to The XFree86 Project, Inc, either by financial contribution or by the +donation of equipment and resources. The XFree86 Project, Inc gratefully +acknowledges these contributions, and hopes that we can do justice to them by +continuing to release high-quality free software for the betterment of the +Internet community as a whole. + + o UUNET Communications Services, Inc. <URL:http://www.uu.net/> + +UUNET Communications Services, Inc, deserves special mention. This + + + + + + + + +README for XFree86[tm] 3.3.2 + + + +organization stepped forward and contributed the entire 1994 X Consortium mem- +bership fee on a moment's notice. This single act ensured XFree86's involve- +ment in X11R6. + + o GUUG -- 1st German Linux Congress + +Also deserving of special mention are the organizers and attendees of the 1st +German Linux Congress in Heidelberg. Significant funding to The XFree86 Pro- +ject has been provided from its proceeds. + + o AIB Software Corporation <URL:http://www.aib.com/>, Herndon, VA + + o Roland Alder, Armin Fessler, Patrick Seemann, Martin Wunderli + + o American Micro Group + + o ATI Technologies Inc <URL:http://www.atitech.ca/> + + o Andrew Burgess + + o Berkeley Software Design, Inc <URL:http://www.bsdi.com/>, Falls Church, VA + + o Caldera, Inc. <URL:http://www.caldera.com/> + + o Delix Computer GmbH <URL:http://www.delix.de/>, Stuttgart, Germany + + o The Destek Group, Inc. <URL:http://www.destek.net/Destek/>, Nashua, NH + (formerly Synergytics) + + o Diamond Multimedia Systems, Inc. <URL:http://www.diamondmm.com/> + + o Digital Equipment Corporation <URL:http://www.digital.com/> + + o Elsa GmbH <URL:http://www.elsa.de/>, Aachen, Germany + + o Genoa Systems Corporation + + o Helius, Inc. <URL:http://www.helius.com/> + + o Hercules Computer Technology, Inc. <URL:http://www.hercules.com/> + + o Ralf Hockens + + o Dirk Hohndel + + o InfoMagic <URL:http://www.infomagic.com/>, Flagstaff, AZ + + o Daniel Kraemer + + o Epoch Networks, Inc. <URL:http://www.eni.net/>, Irvine, CA + + o Frank & Paige McCormick + + + + + + + + + + +README for XFree86[tm] 3.3.2 + + + + o Internet Labs, Inc. + + o Linux International + + o Linux Support Team, Erlangen, Germany + + o LunetIX Softfair <URL:http://www.lunetix.de>, Berlin, Germany + + o Morse Telecommunications <URL:http://www.morse.net>, Long Beach, NY + + o MELCO, Inc <URL:http://www.melcoinc.co.jp> + + o MIRO Computer Products AG, Braunschweig, Germany + + o Rich & Amy Murphey + + o NCR Corp <URL:http://www.ncr.com/> + + o Brett Neumeier + + o Number Nine, Lexington, MA + + o Kazuyuki Okamoto, Japan + + o Prime Time Freeware <URL:http://www.ptf.com/>, San Bruno, CA + + o Red Hat Software <URL:http://www.redhat.com/>, Chapel Hill, NC + + o Norbert Reithinger + + o SPEA Software AG, Starnberg, Germany + + o STB Systems + + o Clifford M Stein + + o Joel Storm + + o S.u.S.E. GmbH <URL:http://www.suse.de>, Fuerth, Germany + + o Tekelec Airtronic GmbH <URL:http://www.tekelec.com>, Muenchen, Germany + + o Jim Tsillas + + o Trans-Ameritech Enterprises, Inc., Santa Clara, CA + + o Unifix Software GmbH, Braunschweig, Germany + + o Vixie Enterprises <URL:http://www.vix.com/>, La Honda, CA + + o Walnut Creek CDROM <URL:http://www.cdrom.com/>, Concord, CA + + o Xtreme s.a.s. <URL:http://www.xfree86.org/xtreme>, Livorno, Italy + + + + + + + + + +README for XFree86[tm] 3.3.2 + + + +The XFree86 Project, Inc, welcomes the additional contribution of funding +and/or equipment. Such contributions should be tax-deductible; we will know +for certain when the lawyers get finished with the papers. For more informa- +tion, contact The XFree86 Project, Inc, at <BOD@XFree86.org> + + +9. Source and binary archive sites + +Source patches are available to upgrade X11R6.3 PL2 from the X Consortium (now +The Open Group) to XFree86 3.3.2. Binaries for many OSs are also available. +The distribution is available from: + + o ftp://ftp.XFree86.org/pub/XFree86 + +and the following mirror sites: + + o North America: + + o ftp://ftp2.XFree86.org/pub/XFree86 (source and binaries) + + o ftp://ftp.infomagic.com/pub/mirrors/XFree86-current (source and bina- + ries) + + o ftp://ftp.rge.com/pub/X/XFree86 and http://www.rge.com/pub/X/XFree86 + (source and binaries) + + o ftp://ftp.varesearch.com/pub/mirrors/xfree86 (source and binaries) + + o ftp://ftp.cs.umn.edu/pub/XFree86 (source and binaries) + + o ftp://ftp.kernel.org/pub/mirrors/xfree86 (source and binaries) + + + o Europe: + + o ftp://fvkma.tu-graz.ac.at/pub/XFree86 (source and binaries) + + o ftp://gd.tuwien.ac.at/hci/X11/XFree86 and + http://gd.tuwien.ac.at/hci/X11/XFree86 (source and binaries) + + o ftp://ftp.fee.vutbr.cz/pub/XFree86 (source patches and binaries) + + o ftp://ftp.gwdg.de/pub/xfree86/XFree86 (source and binaries) + + o ftp://ftp.mpi-sb.mpg.de/pub/X/mirror/ftp.xfree86.org (source and + binaries) + + o ftp://ftp.cs.tu-berlin.de/pub/X/XFree86 (source and binaries) + + o ftp://ftp.uni-erlangen.de/pub/Linux/MIRROR.xfree86 (source and Linux + binaries) + + o ftp://ftp.uni-stuttgart.de/pub/X11/Xfree86 (source and binaries) + + + + + + + + + +README for XFree86[tm] 3.3.2 + + + + o ftp://ftp.funet.fi/pub/X11/XFree86 (source and binaries) + + o ftp://ftp.ibp.fr/pub/X11/XFree86 (source and binaries) + + o ftp://ftp.unina.it/pub/XFree86 (source and binaries) + + o ftp://ftp.pvv.unit.no/pub/XFree86 (source and binaries) + + o ftp://sunsite.doc.ic.ac.uk/packages/XFree86 (source and binaries) + + + + + o Asia/Australia: + + o ftp://x.physics.usyd.edu.au/pub/XFree86 (source and binaries) + + o ftp://ftp.netlab.is.tsukuba.ac.jp/pub/XFree86 (source and binaries) + + o ftp://ftp.iij.ad.jp/pub/X/XFree86/XFree86 (source and binaries) + + o ftp://ftp.kreonet.re.kr/pub/Linux/xfree86 (source and binaries) + + +Ensure that you are getting XFree86 3.3.2 - some of these sites may archive +older releases as well. Check the RELNOTES to find which files you need to +take from the archive. + + Generated from XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/README.sgml,v 3.75.2.33 1998/02/28 15:49:46 robin Exp $ + + + + + + $XConsortium: README.sgml /main/31 1996/10/28 05:43:24 kaleb $ + + + + + + + + + + + + + + + + + + + + + + + + + + + +README for XFree86[tm] 3.3.2 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + CONTENTS + + + +1. What's new in XFree86 3.3.2 .............................................. 1 + +2. Systems XFree86 has been tested on ....................................... 1 + +3. Supported video-card chip-sets ........................................... 2 + +4. Where to get more information ............................................ 5 + +5. Thanks ................................................................... 6 + +6. Credits .................................................................. 6 + +7. Contact information ..................................................... 16 + +8. The XFree86 Project, Inc. ............................................... 17 + +9. Source and binary archive sites ......................................... 21 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + i + + + +$XFree86: xc/programs/Xserver/hw/xfree86/doc/README,v 3.76.2.28 1998/03/01 13:58:20 dawes Exp $ diff --git a/release/texts/i386/HARDWARE.TXT b/release/texts/i386/HARDWARE.TXT new file mode 100644 index 0000000..4916da2 --- /dev/null +++ b/release/texts/i386/HARDWARE.TXT @@ -0,0 +1,514 @@ +Table of Contents +----------------- +0. Document Conventions +1. Default Configuration (GENERIC kernel) +2. Using UserConfig to change FreeBSD kernel settings +3. LINT - other possible configurations +4. 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 ADP-9xx SCSI controller +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 +amd0 n/a n/a n/a n/a Tekram DC-390(T) / AMD 53c974 PCI SCSI +dpt n/a n/a n/a n/a DPT RAID SCSI controllers. +nca0* 1f88 10 dyn dyn ProAudioSpectrum cards +sea0* dyn 5 dyn c8000 Seagate ST01/02 8 bit controller + +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 + +de0 n/a n/a n/a n/a DEC DC21x40 PCI based cards + (including 21140 100bT 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-Telesis AT1700, RE2000 and + Fujitsu FMV-180 series cards. +fxp0 dyn dyn n/a dyn Intel EtherExpress Pro/100B +rl0 dyn dyn n/a dyn RealTek 8129/8139 fast ethernet +tl0 dyn dyn n/a dyn TI TNET100 'ThunderLAN' cards. +ie0 300 10 dyn d0000 AT&T StarLAN 10 and EN100; + 3Com 3C507; NI5210 +ix0 300 10 dyn d0000 Intel EtherExpress cards +ex0 dyn dyn dyn dyn Intel EtherExpress Pro/10 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) +vx0 dyn dyn n/a dyn 3Com 3c59x ((Fast) Etherlink III) +xl0 dyn dyn n/a dyn 3Com 3c900, 3c905 and 3c905B + ((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. Using UserConfig to change FreeBSD kernel settings +-- -------------------------------------------------- + +The FreeBSD kernel on the install floppy contains drivers for every +piece of hardware that could conceivably be used to install the rest +of the system with. Unfortunately, PC hardware being what it is, some +of these devices can be difficult to detect accurately, and for some, +the process of detecting another can cause irreversible confusion. + +To make this process easier, FreeBSD provides UserConfig. With this +UserConfig, the user can configure and disable device drivers before +the kernel is loaded, avoiding potential conflicts, and eliminating +the need to reconfigure hardware to suit the default driver settings. + +Once FreeBSD is installed, it will remember the changes made using +UserConfig, so that they only need be made once. + +It is important to disable drivers that are not relevant to a system +in order to minimize the possibility of interference, which can cause +problems that are difficult to track down. + +UserConfig features a command line interface for users with serial +consoles or a need to type commands, and a full screen 'visual' +interface, which provides point-and-shoot configuration functionality. + +Here is a sample UserConfig screen shot in 'visual' mode: + +---Active Drivers---------------------------10 Conflicts------Dev---IRQ--Port-- + Storage : (Collapsed) + Network : + NE1000,NE2000,3C503,WD/SMC80xx Ethernet adapters CONF ed0 5 0x280 + NE1000,NE2000,3C503,WD/SMC80xx Ethernet adapters CONF ed1 5 0x300 + Communications : (Collapsed) + Input : (Collapsed) + Multimedia : +---Inactive Drivers-------------------------------------------Dev-------------- + Storage : + Network : (Collapsed) + Communications : + Input : + Multimedia : + PCI : + +---Parameters-for-device-ed0--------------------------------------------------- + Port address : 0x280 Memory address : 0xd8000 + IRQ number : 5 Memory size : 0x2000 + Flags : 0x0000 +------------------------------------------------------------------------------- + IO Port address (Hexadecimal, 0x1-0x2000) + [TAB] Change fields [Q] Save device parameters + + + The screen is divided into four sections : + + - Active Drivers. Listed here are the device drivers that are currently + enabled, and their basic parameters. + - Inactive Drivers. These drivers are present, but are disabled. + - Parameter edit field. This area is used for editing driver parameters. + - Help area. Keystroke help is displayed here. + +One of the Active and Inactive lists is always in use, and the current +entry in the list will be shown with a highlight bar. If there are +more entries in a list than can be shown, it will scroll. The bar can +be moved up and down using the cursor keys, and moved between lists +with the TAB key. + +Drivers in the Active list may be marked "CONF". This indicates that +one or more of their parameters conflicts with another device, and +indicates a potential for problems. The total number of conflicts is +displayed at the top of the screen. + +As a general rule, conflicts should be avoided, either by disabling +conflicting devices that are not present in the system, or by altering +their configuration so that they match the installed hardware. + +In the list areas, drivers are grouped by their basic function. +Groups can be 'Collapsed' to simplify the display (this is the default +state for all groups). If a group is collapsed, it will be shown with +'(Collapsed)' in the list, as above. To Expand a Collapsed group, +position the highlight bar over the group heading and press Enter. To +Collapse it again, repeat the process. + +When a device driver in the Active list is highlighted, its full +parameters are displayed in the Parameter edit area. Note that not +all drivers use all possible parameters, and some hardware supported +by drivers may not use all the parameters the driver supports. + +To disable a driver, go to the Active list, Expand the group it is in, +highlight the driver and press Del. The driver will move to its group +in the Inactive list. (If the group is collapsed or off the screen, +you may not see the driver in its new location.) + +To enable a driver, go to the Inactive list, Expand the group it is +in, highlight the driver and press Enter. The highlight will move to +the Active list, and the driver you have just enabled will be +highlighted, ready to be configured. + +To configure a driver, go to the Active list, Expand the group it is +in, highlight the driver and press Enter. The cursor will move to the +Parameter edit area, and the device's parameters may be edited. + +While editing parameters, the TAB and cursor keys can be used to move +between fields. Most numeric values (except IRQ) are entered in +hexadecimal, as indicated by the '0x' at the beginning of the field. +The allowable values for a given field are show in the Key Help area +when the field is active. + +To finish configuring a driver, press 'Q'. + +Note that PCI and EISA devices can be probed reliably, therefore they +are not shown in the table above nor can their settings be changed +using UserConfig. PCI drivers may be seen in the "PCI Devices" section +in the Active Devices list, if you wish to check for their presence. + + +3. 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: DEV 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 +joy: Joystick +labpc: National Instrument's Lab-PC and Lab-PC+ +meteor: Matrox Meteor frame-grabber card +bktr: Brooktree Bt848 based frame-grabber cards. +mpu: Roland MPU-401 stand-alone card +mse: Microsoft, Logitech, ATI bus mouse ports +mss: Microsoft Sound System +nic: Dr Neuhaus NICCY 3008, 3009 & 5000 ISDN cards +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 --- + + +4. Supported Hardware +-- ------------------ + +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. + + +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/2940/3940 (Narrow/Wide/Twin) series ISA/EISA/PCI SCSI +controllers. +Adaptec AIC7850/AIC7895 on-board SCSI controllers. + +Support for the following controllers is rather weak: +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: You cannot boot from the SoundBlaster cards as they have no + on-board BIOS, such being necessary for mapping the boot device into the + system BIOS I/O vectors. They're perfectly usable for external tapes, + CDROMs, etc, however. The same goes for any other AIC-6x60 based card + without a boot ROM. Some systems DO have a boot ROM, which is generally + indicated by some sort of message when the system is first powered up + or reset, and in such cases you *will* also be able to boot from them. + Check your system/board documentation for more details. + + +AdvanSys (Advanced Systems) ABP510/542/5150 ISA and ABP5140/5142 ISA PnP +cards, ABP842/852 VLB cards, and ABP920/930/930U/930UA/950/960/960U/970/970U +PCI cards. + +** Note: The ADP510/5140/5150 boards were shipped by HP with the 4020i + CD-R drive but with NO BIOS, so these models cannot control boot devices + though they can be used for any secondary SCSI device. Also note that the + ABP5140/5142 boards were rebadged by SIIG as the "SpeedMaster i540/i542" + + +Buslogic 545S & 545c +Buslogic 445S/445c VLB SCSI controller +Buslogic 742A, 747S, 747c EISA SCSI controller. +Buslogic 946c PCI SCSI controller +Buslogic 956c PCI SCSI controller + +SymBios (formerly NCR) 53C810, 53C825, 53c860 and 53c875 PCI SCSI +controllers: + ASUS SC-200 + Data Technology DTC3130 (all variants) + NCR cards (all) + Symbios cards (all) + Tekram DC390W, 390U and 390F + Tyan S1365 + +Tekram DC390 and DC390T controllers (maybe other cards based on the +AMD 53c974 as well). + +NCR5380/NCR53400 ("ProAudio Spectrum") SCSI controller. + +DTC 3290 EISA SCSI controller in 1542 emulation mode. + +UltraStor 14F, 24F and 34F SCSI controllers. + +Seagate ST01/02 SCSI controllers. + +Future Domain 8xx/950 series SCSI controllers. + +WD7000 SCSI controller. + +With all supported SCSI controllers, full support is provided for +SCSI-I & SCSI-II peripherals, including Disks, tape drives (including +DAT and 8mm Exabyte) and CD ROM drives. + +The following CD-ROM type systems are supported at this time: +(cd) SCSI interface (also includes ProAudio Spectrum and + SoundBlaster SCSI) +(mcd) Mitsumi proprietary interface (all models, driver is rather stale) +(matcd) Matsushita/Panasonic (Creative SoundBlaster) proprietary + interface (562/563 models) +(scd) Sony proprietary interface (all models) +(wcd) ATAPI IDE interface. + + +4.2. Network cards +---- ------------- + +Allied-Telesis AT1700 and RE2000 cards + +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. + +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 + +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 + +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. + +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 + +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. 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 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) + + +FreeBSD currently does NOT support IBM's microchannel (MCA) bus. diff --git a/release/texts/i386/INSTALL.TXT b/release/texts/i386/INSTALL.TXT new file mode 100644 index 0000000..dfc1697 --- /dev/null +++ b/release/texts/i386/INSTALL.TXT @@ -0,0 +1,513 @@ ++===================== Installing FreeBSD ==========================+ +| | +| Table of Contents: | +| | +| 0.0 Quick Start: | +| 0.1 Installing FreeBSD from CDROM or the Internet. | +| | +| 1.0 Detail on various installation types: | +| 1.1 Installing from a network CDROM | +| 1.2 Installing from Floppies | +| 1.3 Installing from a DOS partition | +| 1.4 Installing from QIC/SCSI tape | +| 1.5 Installing over a network using NFS or FTP | +| 1.5.1 NFS Installation tips | +| 1.5.2 FTP Installation tips | +| | +| 2.0 DOS User's Q&A section. | +| 2.1 How do I make space for FreeBSD? | +| 2.2 Can I use compressed DOS filesystems from FreeBSD? | +| 2.3 Can I use DOS extended partitions? | +| 2.4 Can I run DOS executables under FreeBSD? | +| | ++=====================================================================+ + +Author: Jordan K. Hubbard +Last updated: Tue Mar 24 00:56:14 PST 1998 + +0.0 Quick Start +--- ----------- + +This manual documents the process of making a new installation of +FreeBSD on your machine. If you are upgrading from a previous +release of FreeBSD, please see the file UPGRADE.TXT for important +information on upgrading. If you are not familiar with configuring +PC hardware for FreeBSD, you should also read the HARDWARE.TXT file - +it contains important information which may save you a lot of grief. + +If you're new to FreeBSD then you should also read EVERYTHING listed +in the Documentation menu on the boot floppy. It may seem like a lot +to read, but the time you spend now reading the documents will be made +up many times over because you were adequately prepared. Also, you will +know the types of information available should you get stuck later. +Once the system is installed, you can also revisit this menu and use a +WEB browser to read the installed FAQ (Frequently Asked Questions) and +Handbook HTML documentation sets for FreeBSD. You can also use the +browser to visit other WEB sites on the net (like http://www.freebsd.org) +if you have an Internet connection. See ABOUT.TXT for more information +on the resources available to you. + +The best laid plans sometimes go awry, so if you run into trouble take a +look at TROUBLE.TXT which contains valuable troubleshooting information. + +DISCLAIMER: 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! Please do not proceed to the +final FreeBSD installation menu unless you've adequately backed up any +important data first! We really mean it! + +FreeBSD requires a 386 or better processor to run (sorry, there is no +support for '286 processors), 5 megs of RAM to install and 4 megs of +ram to run. You will need at least 80 megs of free hard drive space. +See below for ways of shrinking existing DOS partitions in order to +install FreeBSD. + + +0.1 Installing FreeBSD from CDROM or the Internet +--- --------------------------------------------- + +The easiest type of installation is from CD. If you have a supported +CDROM drive and a FreeBSD installation CD from Walnut Creek CDROM, +there are 3 ways of starting the installation from it: + + 1. 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 2.2.1 and later CDs support the "El Torrito" bootable + CD standard. Simply put the installation CD in your CDROM drive + and boot the system to begin installation. + + 2. If you have drivers which allow you to see your CDROM drive + from from DOS, first disable any fancy memory managers you may + have configured, change directory to the CDROM (E:\ in the example + below) and then type this: + + E> install + + and you should boot directly into the FreeBSD installation. + + If either steps fail, please go on to step 3. + + 3. Build a FreeBSD boot floppy from the floppies/boot.flp + file in a FreeBSD distribution. Either simply use the + ``makeflp.bat'' script from DOS or read floppies/README.TXT + for more information on creating bootable floppies under + different operating systems. Then you simply boot + from the floppy and you should go into 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, simply fetch the +<FreeBSD-release>/floppies/boot.flp file from: + + ftp://ftp.freebsd.org/pub/FreeBSD + +or one of its many mirrors (http://www.freebsd.org/handbook/mirrors.html) +and follow step 3 above. You should also read the floppies/README.TXT +file as it contains important information for downloaders. + +Once you have a boot floppy made, please go to section 1.5 of this +document for additional tips on installing via FTP or NFS. + + +1.0 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 the +Documentation submenu as well as the general "Usage" instructions on +the first menu. + + REMEMBER: If you get stuck at a screen, hit F1 for the online + documentation for that section. + +If you've never installed FreeBSD before, or even if you have, the +"Novice" 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 listed below. + + +1.1 Installing from a network CDROM +--- ------------------------------- + +If you simply wish to install from a local CDROM drive then see the +Quick Start section. 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 +several ways of going about it: + +1. 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 command): + + ftp:*:99:99::0:0:FTP:/cdrom:/sbin/nologin + +And anyone else on your network will now be able to chose a Media type +of FTP and type in: ``ftp://<machine with CDROM drive>'' after picking +"Other" in the ftp sites menu. + +2. 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) + which looks something like this: + + /cdrom -ro ziggy.foo.com + + To allow the machine "ziggy.foo.com" to mount the CDROM directly + via NFS during installation. 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. + + +1.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 a boot floppy as described in floppies/README.TXT + +Second, read the file LAYOUT.TXT 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. + +Don't trust Factory Preformatted floppies! Format them again +yourself, just to make sure. Many problems reported by our users in +the past have resulted from the use of improperly formatted media, +which is why I'm taking such special care to mention it here! + +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' and `newfs' 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/rfd0 + +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 NOTE: 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! + +Once you come to the Media screen of the install, select "Floppy" and +you'll be prompted for the rest. + + +1.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 ("Drive 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:\BIN C:\FREEBSD\BIN + +Assuming that `E:' was where your CD was mounted. + +For as many `DISTS' 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. + +IMPORTANT NOTE: Though you can do all of the above by hand if you +really want to, all of it is much more easily accomplished now by +Robert Nordier's "setup.exe" program. It will give you a menu of +distribution choices, verify that you have enough free space and do +all the copying to C:\FREEBSD for you automatically. + +Once you've copied the directories or run setup.exe and let it do all +the work for you, you can simply launch the installation from DOS by +running the install.bat script (NOTE: Some memory managers don't like +this - disable QEMM or EMM386 if they're running before trying this) +or making a boot floppy as described in section 0.1. + + +1.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 tar them onto the tape +with a command something like this: + + cd /where/you/have/your/dists + tar cvf /dev/rwt0 (or /dev/rst0) 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. + +SPECIAL NOTE: When going to do the installation, the tape must be in +the drive *before* booting from the boot floppy. The installation +"probe" may otherwise fail to find it. + +Now create a boot floppy as described in section 0.1 and proceed with +the installation. + + +1.5 Installing over a network using FTP or NFS +--- ------------------------------------------ + +After making a boot floppy 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: SLIP / PPP + Parallel port: PLIP (using ``laplink'' style cable) + Ethernet: A standard Ethernet controller (including + certain PCCARD devices). + +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. + + +Parallel Port +------------- + +If a hard-wired connection to another FreeBSD (2.0R or later) 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 NOTE: 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. + + +Ethernet +-------- + +FreeBSD supports most common PC Ethernet cards, a table of supported +cards (and their required settings) being provided as part of the +FreeBSD Hardware Guide (see 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 address class 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 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 will almost certainly get you shot at +dawn. + +Once you have a network connection of some sort working, the +installation can continue over NFS or FTP. + + +1.5.1 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 (as 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 2.2 distribution directory + lives on: ziggy:/usr/archive/stuff/FreeBSD + Then ziggy 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.2 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 ``Other'' choice in that menu. A URL can + contain a hostname or an IP address, so the following would + work in the absence of a name server: + + ftp://192.216.191.11/pub/FreeBSD/2.2-RELEASE + + There are two FTP installation modes you can use: + + o FTP: + + For all FTP transfers, use the standard "Active" mode for + transfers. 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! + + o FTP Passive: + + For all FTP transfers, use "Passive" mode. This allows + the user to pass through firewalls that do not allow + incoming connections on random port addresses. + + NOTE: ACTIVE AND PASSIVE MODES ARE NOT THE SAME AS A `PROXY' + CONNECTIONS, WHERE A PROXY FTP SERVER IS LISTENING ON A + DIFFERENT PORT! + + In such instances, you should specify the URL as something like: + + ftp://foo.bar.com:1234/pub/FreeBSD + + Where "1234" is the port number of the proxy ftp server. + + +2.0 DOS user's Question and Answer section +--- -------------------------------------- + +2.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! :) + +NOTE: FIPS does NOT currently work with FAT32 or VFAT style partitions +as used by newer versions of Windows 95. To split up such a +partition, you will need a commercial product such as Partition Magic +3.0. 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. + +2.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. + + +2.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/sd0s5, your E: +drive /dev/sd0s6, and so on. This example assumes, of course, that +your extended partition is on SCSI drive 0. For IDE drives, substitute +``wd'' for ``sd'' appropriately. You otherwise mount extended +partitions exactly like you would mount any other DOS drive, e.g.: + +mount -t msdos /dev/sd0s5 /dos_d + + +2.4 Can I run DOS binaries under FreeBSD? +--- ------------------------------------- + +Ongoing work with BSDI's doscmd utility is bringing this much closer to +being a reality in FreeBSD 3.0, though it still has some rough edges. +If you're interested in working on this, please send mail to +emulation@FreeBSD.org and indicate that you're interested in joining +this ongoing effort! + +There is also a neat utility called "pcemu" in the ports collection +which emulates an 8088 and enough BIOS services to run DOS text mode +applications. It requires the X Window System (provided as XFree86 +3.2) to operate. + + +---- End of Installation Guide --- diff --git a/release/texts/i386/RELNOTES.TXT b/release/texts/i386/RELNOTES.TXT new file mode 100644 index 0000000..0d50346 --- /dev/null +++ b/release/texts/i386/RELNOTES.TXT @@ -0,0 +1,514 @@ + RELEASE NOTES + FreeBSD Release 3.0-SNAP + +This is a 3.0-CURRENT release SNAPshot of FreeBSD, currently +on its way to a follow-on release for 3.0 which was released +on October 16th, 1998. + +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 3.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 3.0-current snapshots, you should always see: + + ftp://current.freebsd.org/pub/FreeBSD + +If you wish to get the latest post-3.0-RELEASE technology. + +Table of contents: +------------------ +1. What's new since 3.0-RELEASE + 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 3.0-RELEASE +--------------------------------- +All changes described here are unique to the 3.0 branch unless +specifically marked as [MERGED] features. + +1.1. KERNEL CHANGES +------------------- + +1.2. SECURITY FIXES +------------------- + +1.3. USERLAND CHANGES +--------------------- + +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/2920/2940/2950/3940/3950 (Narrow/Wide/Twin) series +EISA/VLB/PCI SCSI controllers. +Adaptec AIC7850, AIC7880, AIC789x, on-board SCSI controllers. + +AdvanSys SCSI controllers (all models). + +Buslogic 545S & 545c +Buslogic 445S/445c VLB SCSI controller +Buslogic 742A, 747S, 747c EISA SCSI controller. +Buslogic 946c PCI SCSI controller +Buslogic 956c PCI SCSI controller + +DPT SCSI/RAID controllers (most variants). + +SymBios (formerly NCR) 53C810, 53C825, 53c860 and 53c875 PCI SCSI +controllers: + ASUS SC-200 + Data Technology DTC3130 (all variants) + NCR cards (all) + Symbios cards (all) + Tekram DC390W, 390U and 390F + Tyan S1365 + + +QLogic SCSI and Fibre Channel controllers. + +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) +(wcd) ATAPI IDE interface + +SCSI TAPE SUPPORT: + + The CAM SCSI tape driver doesn't yet handle older (and many times broken) + tape drives very well. If you've got an older SCSI-1 tape drive, like an + Exabyte 8200 or older QIC-type tape drive, it may not work properly with + the CAM tape driver. This is obviously a known problem, and we're + working on it. + + Newer tape drives that are mostly SCSI-2 compliant should work fine. + e.g., DAT (DDS-1, 2 and 3), DLT, and newer Exabyte 8mm drives should + work fine. + + If you want to find out if your particular tape drive is supported, the + best way to find out is to try it! + +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 + +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 + 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 + +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 + +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 + +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. + +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 + +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. + +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 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. + +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 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 +FreeBSD distributions: + + 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 ``world'' target, which will upgrade a 2.x +system to 3.0, or the ``aout-to-elf'' target, which will both upgrade +and convert the system to ELF binary format. +In the case of using the binary upgrade option, the system will go +straight to 3.0/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), but on the downside you'll also have access to far +fewer ports and packages since many of those have not been adapted to +ELF yet. This will occur in time, but those who wish to retain access +to the greatest number of packages and 3rd-party binaries should +probably stick with a.out. + +The kernel is also still in a.out format at this time so that older +LKMs and library interfaces can continue to work, but a full +transition to ELF will occur at some point after 3.0-RELEASE. Those +wishing to generate dynamic kernel components should therefore use the +newer KLD mechanism rather than the older LKM format - the LKM format +is not long for this world and will soon be unsupported! + +[ 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: + + 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 |