diff options
| -rw-r--r-- | ChangeLog | 7 | ||||
| -rw-r--r-- | doc/mach.texi | 652 | ||||
| -rw-r--r-- | i386/README-Drivers | 297 |
3 files changed, 329 insertions, 627 deletions
@@ -1,3 +1,10 @@ +2006-11-17 Constantine Kousoulos <wuwei@freemail.gr> + Thomas Schwinge <tschwinge@gnu.org> + + * i386/README-Drivers: Move most of the text into... + * doc/mach.texi: ... here and update a number of things. + (UPDATED): Don't override. + 2006-11-13 Samuel Thibault <samuel.thibault@ens-lyon.org> * i386/i386at/iopl.c (ioplmmap): Add `int' return type. diff --git a/doc/mach.texi b/doc/mach.texi index 33a6110..4d2589d 100644 --- a/doc/mach.texi +++ b/doc/mach.texi @@ -18,16 +18,15 @@ @c Get the Mach version we are documenting. @include version.texi @set EDITION 0.4 -@set UPDATED 2001-09-01 @c @set ISBN X-XXXXXX-XX-X @ifinfo This file documents the GNU Mach microkernel. -This is Edition @value{EDITION}, last updated @value{UPDATED}, of -@cite{The GNU Mach Reference Manual}, for Version @value{VERSION}. +This is edition @value{EDITION}, last updated on @value{UPDATED}, of @cite{The +GNU Mach Reference Manual}, for version @value{VERSION}. -Copyright @copyright{} 2001 Free Software Foundation, Inc. +Copyright @copyright{} 2001, 2006 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or @@ -86,7 +85,7 @@ ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE. @center for version @value{VERSION} @page @vskip 0pt plus 1filll -Copyright @copyright{} 2001 Free Software Foundation, Inc. +Copyright @copyright{} 2001, 2006 Free Software Foundation, Inc. @c @sp 2 @c Published by the Free Software Foundation @* @c 59 Temple Place -- Suite 330, @* @@ -160,9 +159,9 @@ ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE. @ifnottex @node Top @top Main Menu -This is Edition @value{EDITION}, last updated @value{UPDATED}, of -@cite{The GNU Mach Reference Manual}, for Version @value{VERSION} of the -GNU Mach microkernel. +This is edition @value{EDITION}, last updated on @value{UPDATED}, of @cite{The +GNU Mach Reference Manual}, for version @value{VERSION} of the GNU Mach +microkernel. @end ifnottex @menu @@ -506,7 +505,7 @@ info manual. If you already have a running GNU system, and only want to recompile the kernel, for example to select a different set of included hardware drivers, you can easily do this. You need the GNU C compiler and -MiG, the Mach interface generator, which both come in their own +MIG, the Mach interface generator, which both come in their own packages. Building and installing the kernel is as easy as with any other GNU @@ -523,438 +522,421 @@ To install the kernel and its header files, just enter the command: make install @end example -This will install the kernel into $(prefix)/boot/gnumach and the header -files into $(prefix)/include. You can also only install the kernel or -the header files. For this, the two targets install-kernel and -install-headers are provided. +This will install the kernel as @file{EXEC_PREFIX/boot/gnumach}, the header +files into @file{PREFIX/include/}, the list of message ids as +@file{PREFIX/share/msgids/gnumach.msgids} and the documentation into +@file{PREFIX/share/info/}. +Note that there is also a way to only install the header and documentation +files without having to actually build the whole package: run @command{make +install-data} after having ran @command{configure} to do so. (This is needed +for bootstrapping a cross compiler and similar procedures.) @node Configuration @section Configuration -The following options can be passed to the configure script as command -line arguments and control what components are built into the kernel, or -where it is installed. +See the following tables for the options can be passed to the +@command{configure} script as command line arguments to control what components +are built into the kernel, how certain things are configured and so on. -The default for an option is to be disabled, unless otherwise noted. +See the top-level @file{INSTALL} file for information about generic +@command{configure} options, like under which paths to install the package's +components. It also describes how to control the process by setting +environment variables. -This table is out-dated. Please see the file @file{i386/README-Drivers} -and the output of @code{[GNU Mach]/configure --help=recursive}. +The file @file{i386/README-Drivers} has some i386-specific information for +device drivers. You should only need to consult this file in case a device +driver is not working for you. -@table @code -@item --prefix @var{prefix} -Sets the prefix to PREFIX. The default prefix is the empty string, which -is the correct value for the GNU system. The prefix is prepended to all -file names at installation time. +@subsection Table of configure switches not related to device drivers +@table @code @item --enable-kdb -Enables the in-kernel debugger. This is only useful if you actually -anticipate debugging the kernel. It is not enabled by default because -it adds considerably to the unpageable memory footprint of the kernel. -@xref{Kernel Debugger}. +Enables the in-kernel debugger. This is only useful if you actually anticipate +debugging the kernel. It is not enabled by default because it adds +considerably to the unpageable memory footprint of the kernel. @xref{Kernel +Debugger}. +@end table + +@subsection Turning device drivers on or off -@item --enable-kmsg -Enables the kernel message device kmsg. +Each device driver has an associated configure switch. The following table +indicates whether a device driver is enabled by default or not. It also gives +--- if possible at all --- the configure switches to use for disabling or +enabling device drivers, in case you're not satisfied with the default choices. +Where a @samp{--disable-*} switch is given in the table, the device driver is +enabled by default and you have to use the switch to disable it and vice versa +for the @samp{--enable-*} switches, the device driver is disabled by default +and you have to us the switch to enable it. To have all device drivers +disabled that can be disabled and would otherwise have been enabled by default +you can specify the @samp{--disable-default-device-drivers} switch and then use +individual @samp{--enable-*} switches to enable only those you actually want to +have enabled. -@item --enable-lpr -Enables the parallel port devices lpr%d. +@subsection What the configure switches do -@item --enable-floppy -Enables the PC floppy disk controller devices fd%d. +Each configure switch has two effects. First, it defines a @acronym{CPP} +symbol that turns on or off the hooks that autoconfigure the device and add it +to the list of available devices. Second, it adds the source code for the +driver to a make variable so that the code for the driver is compiled and +linked into the kernel. Also follow this route to find the file(s) which are +implementing a certain device driver. + +@subsection Table of configure switches related to device drivers + +(@samp{%d} in the following denotes a unit number, starting with @samp{0}.) + +@table @code +@item --disable-kmsg +Disables the kernel message device @samp{kmsg}. -@item --enable-ide -Enables the IDE controller devices hd%d, hd%ds%d. +@item --disable-lpr +Disables the parallel port device driver for the @samp{lpr%d} devices. + +@item --disable-floppy +Disables the PC floppy disk controller device driver for the @samp{fd%d} +devices. + +@item --disable-ide +Disables the IDE controller device driver for the @samp{hd%d} and +@samp{hd%ds%d} (disks and their partitions) devices. @end table -The following options enable drivers for various SCSI controller. -SCSI devices are named sd%d (disks) or cd%d (CD ROMs). +The following options control drivers for various SCSI controller. SCSI +devices are named @samp{sd%d} and @samp{sd%ds$d} (disks and their partitions) +or @samp{cd%d} (CD ROMs). @table @code -@item --enable-advansys -Enables the AdvanSys SCSI controller devices sd%d, cd%d. +@item --disable-advansys +Disables the AdvanSys SCSI controller device driver. -@item --enable-buslogic -Enables the BusLogic SCSI controller devices sd%d, cd%d. +@item --disable-buslogic +Disables the BusLogic SCSI controller device driver. -@item --disable-flashpoint -Only meaningful in conjunction with @option{--enable-buslogic}. Omits the -FlshPoint support. This option is enabled by default if -@option{--enable-buslogic} is specified. +@item --enable-flashpoint +Only meaningful in conjunction with the above BusLogic SCSI controller device +driver. Enable the FlashPoint support. -@item --enable-u1434f -Enables the UltraStor 14F/34F SCSI controller devices sd%d, cd%d. +@item --disable-u14-34f +Disables the UltraStor 14F/34F SCSI controller device driver. -@item --enable-ultrastor -Enables the UltraStor SCSI controller devices sd%d, cd%d. +@item --disable-ultrastor +Disables the UltraStor SCSI controller device driver. -@item --enable-aha152x -@itemx --enable-aha2825 -Enables the Adaptec AHA-152x/2825 SCSI controller devices sd%d, cd%d. +@item --disable-aha152x +Disables the Adaptec AHA-152x/2825 SCSI controller device driver. -@item --enable-aha1542 -Enables the Adaptec AHA-1542 SCSI controller devices sd%d, cd%d. +@item --disable-aha1542 +Disables the Adaptec AHA-1542 SCSI controller device driver. -@item --enable-aha1740 -Enables the Adaptec AHA-1740 SCSI controller devices sd%d, cd%d. +@item --disable-aha1740 +Disables the Adaptec AHA-1740 SCSI controller device driver. -@item --enable-aic7xxx -Enables the Adaptec AIC7xxx SCSI controller devices sd%d, cd%d. +@item --disable-aic7xxx +Disables the Adaptec AIC7xxx SCSI controller device driver. -@item --enable-futuredomain -Enables the Future Domain 16xx SCSI controller devices sd%d, cd%d. +@item --disable-fdomain +Disables the Future Domain 16xx SCSI controller device driver. -@item --enable-in2000 -Enables the Always IN 2000 SCSI controller devices sd%d, cd%d. +@item --disable-in2000 +Disables the Always IN 2000 SCSI controller device driver. -@item --enable-ncr5380 -@itemx --enable-ncr53c400 -Enables the generic NCR5380/53c400 SCSI controller devices sd%d, cd%d. +@item --enable-g_NCR5380 +Enables the generic NCR5380/53c400 SCSI controller device driver. @item --enable-ncr53c406a -Enables the NCR53c406a SCSI controller devices sd%d, cd%d. +Enables the NCR53c406a SCSI controller device driver. -@item --enable-pas16 -Enables the PAS16 SCSI controller devices sd%d, cd%d. +@item --disable-pas16 +Disables the PAS16 SCSI controller device driver. -@item --enable-seagate -Enables the Seagate ST02 and Future Domain TMC-8xx SCSI controller -devices sd%d, cd%d. +@item --disable-seagate +Disables the Seagate ST02 and Future Domain TMC-8xx SCSI controller +device driver. -@item --enable-t128 -@itemx --enable-t128f -@itemx --enable-t228 -Enables the Trantor T128/T128F/T228 SCSI controller devices sd%d, cd%d. +@item --disable-t128 +Disables the Trantor T128/T128F/T228 SCSI controller device driver. -@item --enable-ncr53c7xx -Enables the NCR53C7,8xx SCSI controller devices sd%d, cd%d. +@item --Disable-53c78xx +Disables the NCR53C7,8xx SCSI controller device driver. -@item --enable-eatadma -Enables the EATA-DMA (DPT, NEC, AT&T, SNI, AST, Olivetti, Alphatronix) -SCSI controller devices sd%d, cd%d. +@item --enable-eata_dma +Enables the EATA-DMA (DPT, NEC, AT&T, SNI, AST, Olivetti, Alphatronix) SCSI +controller device driver. -@item --enable-eatapio -Enables the EATA-PIO (old DPT PM2001, PM2012A) SCSI controller devices -sd%d, cd%d. +@item --disable-eata_pio +Disables the EATA-PIO (old DPT PM2001, PM2012A) SCSI controller device driver. -@item --enable-wd7000 -Enables the WD 7000 SCSI controller devices sd%d, cd%d. +@item --disable-wd7000 +Disables the WD 7000 SCSI controller device driver. -@item --enable-eata -Enables the EATA ISA/EISA/PCI (DPT and generic EATA/DMA-compliant boards) -SCSI controller devices sd%d, cd%d. +@item --disable-eata +Disables the EATA ISA/EISA/PCI (DPT and generic EATA/DMA-compliant boards) SCSI +controller device driver. -@item --enable-am53c974 -@itemx --enable-am79c974 -Enables the AM53/79C974 SCSI controller devices sd%d, cd%d. +@item --disable-am53c974 +Disables the AM53/79C974 SCSI controller device driver. -@item --enable-dtc3280 -@itemx --enable-dtc3180 -Enables the DTC3180/3280 SCSI controller devices sd%d, cd%d. +@item --disable-dtc +Disables the DTC3180/3280 SCSI controller device driver. -@item --enable-ncr53c8xx -@itemx --enable-dc390w -@itemx --enable-dc390u -@itemx --enable-dc390f -Enables the NCR53C8XX SCSI controller devices sd%d, cd%d. +@item --disable-ncr53c8xx +Disables the NCR53C8XX, dc390w, dc390u, dc390f SCSI controller device driver. -@item --enable-dc390t -@itemx --enable-dc390 -Enables the Tekram DC-390(T) SCSI controller devices sd%d, cd%d. +@item --disable-tmscsim +Enables the Tekram DC-390(T) SCSI controller device driver. -@item --enable-ppa -Enables the IOMEGA Parallel Port ZIP drive device sd%d. +@item --disable-ppa +Disables the IOMEGA Parallel Port ZIP drive device driver. -@item --enable-qlogicfas -Enables the Qlogic FAS SCSI controller devices sd%d, cd%d. +@item --disable-qlogicfas +Disables the Qlogic FAS SCSI controller device driver. -@item --enable-qlogicisp -Enables the Qlogic ISP SCSI controller devices sd%d, cd%d. +@item --disable-qlogicisp +Disables the Qlogic ISP SCSI controller device driver. -@item --enable-gdth -Enables the GDT SCSI Disk Array controller devices sd%d, cd%d. +@item --disable-gdth +Disables the GDT SCSI Disk Array controller device driver. @end table -The following options enable drivers for various ethernet cards. -NIC device names are usually eth%d, except for the pocket adaptors. +The following options enable drivers for various ethernet cards. NIC devices +are usually named @samp{eth%d}, except for the pocket adaptors. -GNU Mach does only autodetect one ethernet card. To enable any further -cards, the source code has to be edited. +GNU Mach does only autodetect one ethernet card. To enable any further cards, +the source code has to be edited. @c XXX Reference to the source code. @table @code -@item --enable-ne2000 -@itemx --enable-ne1000 -Enables the NE2000/NE1000 ISA netword card devices eth%d. - -@item --enable-3c503 -@itemx --enable-el2 -Enables the 3Com 503 (Etherlink II) netword card devices eth%d. - -@item --enable-3c509 -@itemx --enable-3c579 -@itemx --enable-el3 -Enables the 3Com 509/579 (Etherlink III) netword card devices eth%d. - -@item --enable-wd80x3 -Enables the WD80X3 netword card devices eth%d. - -@item --enable-3c501 -@itemx --enable-el1 -Enables the 3COM 501 netword card devices eth%d. - -@item --enable-ul -Enables the SMC Ultra netword card devices eth%d. - -@item --enable-ul32 -Enables the SMC Ultra 32 netword card devices eth%d. - -@item --enable-hplanplus -Enables the HP PCLAN+ (27247B and 27252A) netword card devices eth%d. - -@item --enable-hplan -Enables the HP PCLAN (27245 and other 27xxx series) netword card devices eth%d. - -@item --enable-3c59x -@itemx --enable-3c90x -@itemx --enable-vortex -Enables the 3Com 590/900 series (592/595/597/900/905) "Vortex/Boomerang" -netword card devices eth%d. - -@item --enable-seeq8005 -Enables the Seeq8005 netword card devices eth%d. - -@item --enable-hp100 -@itemx --enable-hpj2577 -@itemx --enable-hpj2573 -@itemx --enable-hp27248b -@itemx --enable-hp2585 -Enables the HP 10/100VG PCLAN (ISA, EISA, PCI) netword card devices -eth%d. - -@item --enable-ac3200 -Enables the Ansel Communications EISA 3200 netword card devices eth%d. - -@item --enable-e2100 -Enables the Cabletron E21xx netword card devices eth%d. - -@item --enable-at1700 -Enables the AT1700 (Fujitsu 86965) netword card devices eth%d. - -@item --enable-eth16i -@itemx --enable-eth32 -Enables the ICL EtherTeam 16i/32 netword card devices eth%d. - -@item --enable-znet -@itemx --enable-znote -Enables the Zenith Z-Note netword card devices eth%d. - -@item --enable-eexpress -Enables the EtherExpress 16 netword card devices eth%d. - -@item --enable-eexpresspro -Enables the EtherExpressPro netword card devices eth%d. - -@item --enable-eexpresspro100 -Enables the Intel EtherExpressPro PCI 10+/100B/100+ netword card devices -eth%d. - -@item --enable-depca -@itemx --enable-de100 -@itemx --enable-de101 -@itemx --enable-de200 -@itemx --enable-de201 -@itemx --enable-de202 -@itemx --enable-de210 -@itemx --enable-de422 -Enables the DEPCA, DE10x, DE200, DE201, DE202, DE210, DE422 netword card -devices eth%d. - -@item --enable-ewrk3 -@itemx --enable-de203 -@itemx --enable-de204 -@itemx --enable-de205 -Enables the EtherWORKS 3 (DE203, DE204, DE205) netword card devices -eth%d. - -@item --enable-de4x5 -@itemx --enable-de425 -@itemx --enable-de434 -@itemx --enable-435 -@itemx --enable-de450 -@itemx --enable-500 -Enables the DE425, DE434, DE435, DE450, DE500 netword card devices -eth%d. - -@item --enable-apricot -Enables the Apricot XEN-II on board ethernet netword card devices eth%d. +@item --disable-ne +Disables the NE2000/NE1000 ISA netword card device driver. + +@item --disable-3c503 +Dsables the 3Com 503 (Etherlink II) netword card device driver. + +@item --disable-3c509 +Disables the 3Com 509/579 (Etherlink III) netword card device driver. + +@item --disable-wd +Disables the WD80X3 netword card device driver. + +@item --disable-3c501 +Disables the 3COM 501/Etherlink I netword card device driver. + +@item --disable-smc-ultra +Disables the SMC Ultra netword card device driver. + +@item --disable-smc-ultra32 +Disables the SMC Ultra 32 netword card device driver. + +@item --disable-hp-plus +Disables the HP PCLAN+ (27247B and 27252A) netword card device driver. + +@item --disable-hp +Disables the HP PCLAN (27245 and other 27xxx series) netword card device driver. + +@item --disable-3c59x +Disables the 3Com 590/900 series (592/595/597/900/905) "Vortex/Boomerang" +netword card device driver. + +@item --disable-seeq8005 +Disables the Seeq8005 netword card device driver. + +@item --disable-hp100 +Disables the HP 10/100VG PCLAN (ISA, EISA, PCI) netword card device driver. + +@item --disable-ac3200 +Disables the Ansel Communications EISA 3200 netword card device driver. + +@item --disable-e2100 +Disables the Cabletron E21xx netword card device driver. + +@item --disable-at1700 +Disables the AT1700 (Fujitsu 86965) netword card device driver. + +@item --disable-eth16i +Disables the ICL EtherTeam 16i/32 netword card device driver. + +@item --disable-znet +Disables the Zenith Z-Note netword card device driver. + +@item --disable-eexpress +Disables the EtherExpress 16 netword card device driver. + +@item --disable-eepro +Disables the EtherExpressPro netword card device driver. + +@item --disable-eepro100 +Disables the Intel EtherExpressPro PCI 10+/100B/100+ netword card device +driver. + +@item --disable-depca +Disables the DEPCA, DE10x, DE200, DE201, DE202, DE210, DE422 netword card +device driver. + +@item --disable-ewrk3 +Disables the EtherWORKS 3 (DE203, DE204, DE205) netword card device driver. + +@item --disable-de4x5 +Enables the DE425, DE434, DE435, DE450, DE500 netword card device driver. + +@item --disable-apricot +Disables the Apricot XEN-II on board ethernet netword card device driver. @item --enable-wavelan -Enables the AT&T WaveLAN & DEC RoamAbout DS netword card devices eth%d. +Enables the AT&T WaveLAN & DEC RoamAbout DS netword card device driver. -@item --enable-3c507 -@itemx --enable-el16 -Enables the 3Com 507 netword card devices eth%d. +@item --disable-3c507 +Disables the 3Com 507 netword card device driver. -@item --enable-3c505 -@itemx --enable-elplus -Enables the 3Com 505 netword card devices eth%d. +@item --disable-3c505 +Disables the 3Com 505/Etherlink II netword card device driver. -@item --enable-de600 -Enables the D-Link DE-600 netword card devices eth%d. +@item --disable-de600 +Disables the D-Link DE-600 netword card device driver. -@item --enable-de620 -Enables the D-Link DE-620 netword card devices eth%d. +@item --disable-de620 +Disables the D-Link DE-620 netword card device driver. -@item --enable-skg16 -Enables the Schneider & Koch G16 netword card devices eth%d. +@item --disable-sk_g16 +Disables the Schneider & Koch G16 netword card device driver. -@item --enable-ni52 -Enables the NI5210 netword card devices eth%d. +@item --disable-ni52 +Disables the NI5210 netword card device driver. -@item --enable-ni65 -Enables the NI6510 netword card devices eth%d. +@item --disable-ni65 +Disables the NI6510 netword card device driver. @item --enable-atp -Enables the AT-LAN-TEC/RealTek pocket adaptor netword card devices atp%d. +Enables the AT-LAN-TEC/RealTek pocket adaptor netword card device driver for +the @samp{atp%d} devices. -@item --enable-lance -@itemx --enable-at1500 -@itemx --enable-ne2100 -Enables the AMD LANCE and PCnet (AT1500 and NE2100) netword card devices eth%d. +@item --disable-lance +Disables the AMD LANCE and PCnet (AT1500 and NE2100) netword card device driver. -@item --enable-elcp -@itemx --enable-tulip -Enables the DECchip Tulip (dc21x4x) PCI netword card devices eth%d. +@itemx --disable-tulip +Disables the DECchip Tulip (dc21x4x) PCI netword card device driver. -@item --enable-fmv18x -Enables the FMV-181/182/183/184 netword card devices eth%d. +@item --disable-fmv18x +Disables the FMV-181/182/183/184 netword card device driver. -@item --enable-3c515 -Enables the 3Com 515 ISA Fast EtherLink netword card devices eth%d. +@item --disable-3c515 +Disables the 3Com 515 ISA Fast EtherLink netword card device driver. -@item --enable-pcnet32 -Enables the AMD PCI PCnet32 (PCI bus NE2100 cards) netword card devices -eth%d. +@item --disable-pcnet32 +Disables the AMD PCI PCnet32 (PCI bus NE2100 cards) netword card device driver. -@item --enable-ne2kpci -Enables the PCI NE2000 netword card devices eth%d. +@item --disable-ne2k-pci +Disables the PCI NE2000 netword card device driver. -@item --enable-yellowfin -Enables the Packet Engines Yellowfin Gigabit-NIC netword card devices -eth%d. +@item --disable-yellowfin +Disables the Packet Engines Yellowfin Gigabit-NIC netword card device driver. -@item --enable-rtl8139 -@itemx --enable-rtl8129 -Enables the RealTek 8129/8139 (not 8019/8029!) netword card devices -eth%d. +@item --disable-rtl8139 +Disables the RealTek 8129/8139 (not 8019/8029!) netword card device driver. -@item --enable-epic -@itemx --enable-epic100 -Enables the SMC 83c170/175 EPIC/100 (EtherPower II) netword card devices eth%d. +@itemx --disable-epic100 +Disables the SMC 83c170/175 EPIC/100 (EtherPower II) netword card device driver. -@item --enable-tlan -Enables the TI ThunderLAN netword card devices eth%d. +@item --disable-tlan +Disables the TI ThunderLAN netword card device driver. -@item --enable-viarhine -Enables the VIA Rhine netword card devices eth%d. +@item --disable-via-rhine +Disables the VIA Rhine netword card device driver. -@item --enable-hamachi -Enables the Packet Engines "Hamachi" GNIC-2 Gigabit Ethernet devices eth%d. +@item --disable-hamachi +Disables the Packet Engines "Hamachi" GNIC-2 Gigabit Ethernet device driver. -@item --enable-intel-gige -Enables the Intel PCI Gigabit Ethernet devices eth%d. +@item --disable-intel-gige +Disables the Intel PCI Gigabit Ethernet device driver. -@item --enable-myson803 -Enables the Myson MTD803 Ethernet adapter series devices eth%d. +@item --disable-myson803 +Disables the Myson MTD803 Ethernet adapter series device driver. -@item --enable-natsemi -Enables the National Semiconductor DP8381x series PCI Ethernet devices eth%d. +@item --disable-natsemi +Disables the National Semiconductor DP8381x series PCI Ethernet device driver. -@item --enable-ns820 -Enables the National Semiconductor DP8382x series PCI Ethernet devices eth%d. +@item --disable-ns820 +Disables the National Semiconductor DP8382x series PCI Ethernet device driver. -@item --enable-starfire -Enables the Adaptec Starfire network adapter devices eth%d. +@item --disable-starfire +Disables the Adaptec Starfire network adapter device driver. -@item --enable-sundance -Enables the Sundance ST201 "Alta" PCI Ethernet devices eth%d. +@item --disable-sundance +Disables the Sundance ST201 "Alta" PCI Ethernet device driver. -@item --enable-winbond-840 -Enables the Winbond W89c840 PCI Ethernet devices eth%d. +@item --disable-winbond-840 +Disables the Winbond W89c840 PCI Ethernet device driver. @end table -The following options either enable drivers for supported PCMCIA -bridges or control the overall behaviour of the GNU Mach PCMCIA core. -To make use of GNU Mach PCMCIA support you need to have the -corresponding userland applications (GNU Mach Card Services) -installed. +The following options either control device drivers for supported PCMCIA +bridges or control the overall behaviour of the GNU Mach PCMCIA core. To make +use of GNU Mach PCMCIA support you need to have the corresponding userland +applications (GNU Mach Card Services) installed. @table @code -@item --enable-i82365 -Enables the driver for the Intel 82365 and compatible PC Card +@item --disable-i82365 +Disables the device driver for the Intel 82365 and compatible PC Card controllers, and Yenta-compatible PCI-to-CardBus controllers. -@item --enable-pcmcia-isa -Enables ISA-bus related bits in the GNU Mach PCMCIA core. This is -generally a good idea, since it does not only have effect if your -PC Card bridge is attached to the ISA bus, but provides more (ISA) -interrupts to the Card Services for it to assign to the cards in turn. +@item --disable-pcmcia-isa +Disables ISA bus related bits in the GNU Mach PCMCIA core. Keeping it enabled +is generally a good idea, since it does not only have effect if your PC Card +bridge is attached to the ISA bus, but provides more (ISA) interrupts to the +Card Services for it to assign to the cards in turn. @end table -The following options enable drivers for supported PCMCIA Ethernet -controllers. NIC device names are usually eth%d. +The following options control device drivers for supported PCMCIA Ethernet +controllers. NIC devices are usually named @samp{eth%d}. @table @code -@item --enable-3c574_cs -Enables the PCMCIA ethernet driver for the 3Com 3c574 ``RoadRunner''. +@item --disable-3c574_cs +Disables the PCMCIA ethernet driver for the 3Com 3c574 ``RoadRunner''. -@item --enable-3c589_cs -Enables the driver for the 3Com 3c589 PCMCIA card. +@item --disable-3c589_cs +Disables the driver for the 3Com 3c589 PCMCIA card. -@item --enable-axnet_cs -Enables the driver for the Asix AX88190-based PCMCIA cards. +@item --disable-axnet_cs +Disables the driver for the Asix AX88190-based PCMCIA cards. -@item --enable-fmvj18x_cs -Enables the driver for PCMCIA cards with the fmvj18x chipset. +@item --disable-fmvj18x_cs +Disables the driver for PCMCIA cards with the fmvj18x chipset. -@item --enable-nmclan_cs -Enables the driver for the New Media Ethernet LAN PCMCIA cards. +@item --disable-nmclan_cs +Disables the driver for the New Media Ethernet LAN PCMCIA cards. -@item --enable-pcnet_cs -Enables the driver for NS8390-based PCMCIA cards. +@item --disable-pcnet_cs +Disables the driver for NS8390-based PCMCIA cards. -This driver supports the D-Link DE-650 and Linksys EthernetCard cards, -the newer D-Link and Linksys combo cards, Accton EN2212 cards, the -RPTI EP400, and the PreMax PE-200 in non-shared-memory mode, and the -IBM Credit Card Adapter, the NE4100, the Thomas Conrad ethernet card, -and the Kingston KNE-PCM/x in shared-memory mode. It will also handle -the Socket EA card in either mode. +This driver supports the D-Link DE-650 and Linksys EthernetCard cards, the +newer D-Link and Linksys combo cards, Accton EN2212 cards, the RPTI EP400, and +the PreMax PE-200 in non-shared-memory mode, and the IBM Credit Card Adapter, +the NE4100, the Thomas Conrad ethernet card, and the Kingston KNE-PCM/x in +shared-memory mode. It will also handle the Socket EA card in either mode. -@item --enable-smc91c92_cs -Enables the driver for SMC91c92-based PCMCIA cards. +@item --disable-smc91c92_cs +Disables the driver for SMC91c92-based PCMCIA cards. -@item --enable-xirc2ps_cs -Enables the driver for Xircom CreditCard and Realport PCMCIA ethernet -adapters. +@item --disable-xirc2ps_cs +Disables the driver for Xircom CreditCard and Realport PCMCIA ethernet +adapters. @end table -The following options enable drivers for supported PCMCIA Wireless LAN -network controllers. NIC device names are usually eth%d. +The following options control device drivers for supported PCMCIA Wireless LAN +network controllers. NIC devices are usually named @samp{eth%d}. -Please mind, that you need to have some userland applications (the GNU -Mach Wireless Tools) installed, in order to make use of these devices. +Please mind, that you need to have some userland applications (the GNU Mach +Wireless Tools) installed, in order to make use of these devices. @table @code -@item --enable-orinoco_cs -Enables the driver for the Hermes or Prism 2 chipset based PCMCIA -wireless adapters, with Lucent/Agere, Intersil or Symbol firmware. - -This driver is suitable for PCMCIA wireless adapters, such as the -Lucent WavelanIEEE/Orinoco cards and their OEM (Cabletron/EnteraSys -RoamAbout 802.11, ELSA Airlancer, Melco Buffalo and others). -It should also be usable on various Prism II based cards such as the -Linksys, D-Link and Farallon Skyline. It should also work on Symbol -cards such as the 3Com AirConnect and Ericsson WLAN. +@item --disable-orinoco_cs +Disables the driver for the Hermes or Prism 2 chipset based PCMCIA wireless +adapters, with Lucent/Agere, Intersil or Symbol firmware. + +This driver is suitable for PCMCIA wireless adapters, such as the Lucent +WavelanIEEE/Orinoco cards and their OEM (Cabletron/EnteraSys RoamAbout 802.11, +ELSA Airlancer, Melco Buffalo and others). It should also be usable on various +Prism II based cards such as the Linksys, D-Link and Farallon Skyline. It +should also work on Symbol cards such as the 3Com AirConnect and Ericsson WLAN. @end table diff --git a/i386/README-Drivers b/i386/README-Drivers index 042d048..3d1066c 100644 --- a/i386/README-Drivers +++ b/i386/README-Drivers @@ -1,46 +1,12 @@ -*- text -*- -** Turning on or off device drivers +Here some i386 specific details of the device drivers are explained. -Each device driver has an associated configure switch. The table at the -end of this file indicates whether a device driver is enabled by default -or not. It also gives --- if possible at all --- the configure switches -to use for disabling or enabling device drivers, in case you're not -satisfied with the default choices. Where a `--disable-*' switch is -given in the table, the device driver is enabled by default and you have -to use the switch to disable it and vice versa for the `--enable-*' -switches, the device driver is disabled by default and you have to us the -switch to enable it. To have all device drivers disabled that can be -disabled and would otherwise have been enabled by default you can specify -the `--disable-default-device-drivers' switch and then use the -`--enable-*' switches to enable only those you actually want to have -enabled. +Each driver is followed by one or more triplets of three numbers. These +triplets specify combinations of I/O address, spl, and, pic that are believed +to work. - -** What the configure switches do - -Each configure switch has two effects. First, it defines a CPP symbol -that turns on or off the hooks that autoconfigure the device and add -it to the list of available devices. Second, it adds the source code -for the driver to a make variable so that the code for the driver is -compiled and linked into the kernel. - - -** What are those extra numbers - -Each driver is followed by one or more triplets of three numbers. -These triplets specify combinations of I/O address, spl, and, pic that -are believed to work. - - -** Then comes the name of the device to users. %d is a unit number. - - -** Source files - -All source file names are relative to [GNU Mach]/i386/i386at/ for -Mach drivers, and the Linux drivers's files can be found below -[GNU Mach]/linux/. +Then comes the name of the device to users. `%d' is a unit number. ** Table @@ -52,7 +18,6 @@ PC com ports (always enabled) com%d Parallel port - --disable-lpr lpr.c lpr%d System Console (always enabled) @@ -82,328 +47,76 @@ Interface to setting up IO port access for users (always enabled) *** Disk controllers (except for SCSI) PC floppy - --disable-floppy block/floppy.c 0x3f0, 370 fd%d -IDE disks - --disable-ide block/{cmd640,ide-cd,ide,rz1000,triton}.c - hd%d (disks) - wcd%d (cdroms) - - -*** SCSI disks - -Disks all show up as `sd%d'. CD Roms all show up as `cd%d'. Tapes and -generic are not currently supported. - -AdvanSys - --disable-advansys scsi/advansys.c - -BusLogic - --disable-BusLogic scsi/{BusLogic,FlashPoint}.c - --enable-flashpoint (if you want to omit FlashPoint support) - -UltraStor 14F/34F - --disable-u14-34f scsi/u14-34f.c - -UlstraStor - --disable-ultrastor scsi/ultrastor.c - -Adaptec AHA-152x/2825 (aha152x, aha2825) - --disable-aha152x scsi/aha152x.c - -Adaptec AHA-1542 - --disable-aha1542 scsi/aha1540.c - -Adaptec AHA-1740 - --disable-aha1740 scsi/aha1740.c - -Adaptec AIC7xxx - --disable-aic7xxx scsi/aic7xxx.c - -Future Domain 16xx - --disable-fdomain scsi/fdomain.c - -Always IN 2000 - --disable-in2000 scsi/in2000.c - -Generic NCR5380/53c400 (ncr5380, ncr53c400) - --enable-g_NCR5380 scsi/g_NCR5380.c - -NCR53c406a chip - --enable-NCR53c406a scsi/NCR53c406a.c - -PAS16 - --disable-pas16 scsi/pas16.c - -Seagate ST02, Future Domain TMC-8xx - --disable-seagate scsi/seagate.c - -Trantor T128/T128F/T228 (t128, t128f, t228) - --disable-t128 scsi/t128.c - -NCR 53C7,8xx - --disable-ncr53c78xx scsi/53c78xx.c - -EATA-DMA (DPT, NEC, AT&T, SNI, AST, Olivetti, Alphatronix) - --enable-eata_dma scsi/eata_dma.c - -EATA-PIO (old DPT PM2001, PM2012A) - --disable-eata_pio scsi/eata_pio.c - -WD 7000 - --disable-wd7000 scsi/wd7000.c - -EATA ISA/EISA/PCI (DPT and generic EATA/DMA-compliant boards) - --disable-eata scsi/eata.c - -AM53/79C974 (am53c974, am79c974) - --disable-AM53C974 scsi/AM53C974.c - -DTC3180/3280 (dtc3180, dtc3280) - --disable-dtc scsi/dtc.c - -NCR53C8XX (ncr53c8xx, dc390f, dc390u, dc390w) - --disable-ncr53c8xx scsi/ncr53c8xx.c - -Tekram DC-390(T) (dc390, dc390t) - --disable-tmscsim scsi/tmscsim.c - -IOMEGA Parallel Port ZIP drive - --disable-ppa scsi/ppa.c - -Qlogic FAS - --disable-qlogicfas scsi/qlogicfas.c - -Qlogic ISP - --disable-qlogicisp scsi/qlogicisp.c - -GDT SCSI Disk Array Controller - --disable-gdth scsi/gdth.c - *** Ethernet controllers These all show up as `eth%d' except the atp device. NE2000/NE1000 ISA (ne, ne1000, ne2000) - --disable-ne net/ne.c net/8390.c 0x300,280,320,340,360 3Com 503 (3c503) / Etherlink II - --disable-3c503 net/3c503.c net/8390.c 0x300,310,330,350,250,280,2a0,2e0 -3Com 509/579 (3c509, 3c579) / Etherlink III - --disable-3c509 net/3c509.c - WD80x3 - --disable-wd net/wd.c, net/8390.c 0x300,280,380,240 3COM 501 (3c501) / Etherlink I - --disable-3c501 net/3c501.c 0x280,300 SMC Ultra - --disable-smc-ultra net/smc-ultra.c net/8390.c 0x200,220,240,280,300,340,380 -SMC Ultra32 - --disable-smc-ultra32 net/smc-ultra32.c net/8390.c - HP PCLAN+ (27247B and 27252A) - --disable-hp-plus net/hp-plus.c net/8390.c 0x200,240,280,2c0,300,320,340 HP PCLAN (27245 and other 27xxx series) - --disable-hp net/hp.c, net/8390.c 0x300,320,340,280,2c0,200,240 -3Com 59x/90x (3c59x, 3c590, 3c592, 3c595, 3c597, 3c90x, 3c900, 3c905) "Vortex/Boomerang" - --disable-3c59x net/3c59x.c - Seeq8005 - --disable-seeq8005 net/seeq8005.c 0x300,320,340,360 -HP 10/100VG PCLAN (ISA, EISA, PCI) (hp100, hpj2577, hpj2573, hpj2585, hp27248b) - --disable-hp100 net/hp100.c - -Ansel Communications EISA 3200 - --disable-ac3200 net/ac3200.c, net/8390.c - Cabletron E21xx - --disable-e2100 net/e2100.c, net/8390.c 0x300,280,380,220 AT1700 (Fujitsu 86965) - --disable-at1700 net/at1700.c 0x260,280,2a0,240,340,320,380,300 ICL EtherTeam 16i/32 (eth16i, eth32) - --disable-eth16i net/eth16i.c 0x260,280,2a0,240,340,320,380,300 (16i) -Zenith Z-Note (znet, znote) - --disable-znet net/znet.c - EtherExpress 16 - --disable-eexpress net/eexpress.c 0x300,270,320,340 EtherExpressPro - --disable-eepro net/eepro.c 0x200,240,280,2c0,300,320,340,360 -Intel EtherExpressPro PCI 10+/100B/100+ - --disable-eepro100 net/eepro100.c - -DEPCA (de100, de101, de200, de201, de202, de210, de422) - --disable-depca net/depca.c - -EtherWORKS 3 (ewrk3, de203, de204, de205) - --disable-ewrk3 net/ewrk3.c - -DE4x5 (de4x5, de425, de434, de435, de450, de500) - --disable-de4x5 net/de4x5.c - -Apricot XEN-II on board ethernet - --disable-apricot net/apricot.c - AT&T WaveLAN & DEC RoamAbout DS - --enable-wavelan net/wavelan.c 0x390 3Com 507 (3c507, el16) - --disable-3c507 net/3c507.c 0x300,320,340,280 3Com 505 (3c505, elplus) - --disable-3c505 net/3c505.c 0x300,280,310 D-Link DE-600 - --disable-de600 net/de600.c 0x378 D-Link DE-620 - --disable-de620 net/de620.c 0x378 Schneider & Koch G16 - --disable-sk_g16 net/sk_g16.c 0x100,180,208,220,288,320,328,390 NI5210 - --disable-ni52 net/ni52.c 0x300,280,360,320,340 NI6510 - --disable-ni65 net/ni65.c 0x300/320/340/360 AT-LAN-TEC/RealTek pocket adaptor - --enable-atp net/atp.c 0x378,278,3bc atp%d - -AMD LANCE and PCnet (at1500, ne2100) - --disable-lance net/lance.c - -DECchip Tulip (dc21x4x) PCI (elcp, tulip) - --disable-tulip net/tulip.c - -FMV-181/182/183/184 - --disable-fmv18x net/fmv18x.c - -3Com 515 ISA Fast EtherLink - --disable-3c515 net/3c515.c - -AMD PCI PCnet32 (PCI bus NE2100 cards) - --disable-pcnet32 net/pcnet32.c - -PCI NE2000 - --disable-ne2k-pci net/ne2k-pci.c - -Packet Engines Yellowfin Gigabit-NIC - --disable-yellowfin net/yellowfin.c - -RealTek 8129/8139 (rtl8129, rtl8139) (not 8019/8029!) - --disable-rtl8139 net/rtl8139.c - -SMC 83c170/175 EPIC/100 (epic, epic100) / EtherPower II - --disable-epic100 net/epic100.c - -TI ThunderLAN - --disable-tlan net/tlan.c - -VIA Rhine - --disable-via-rhine net/via-rhine.c - -Packet Engines "Hamachi" GNIC-2 Gigabit Ethernet - --disable-hamachi net/hamachi.c - -Intel PCI Gigabit Ethernet - --disable-intel-gige net/intel-gige.c - -Myson MTD803 Ethernet adapter series - --disable-myson803 net/myson803.c - -National Semiconductor DP8381x series PCI Ethernet - --disable-natsemi net/natsemi.c - -National Semiconductor DP8382x series PCI Ethernet - --disable-ns820 net/ns820.c - -Adaptec Starfire network adapter - --disable-starfire net/starfire.c - -Sundance ST201 "Alta" PCI Ethernet - --disable-sundance net/sundance.c - -Winbond W89c840 PCI Ethernet - --disable-winbond-840 net/winbond-840.c - -*** pcmcia bridge drivers - -All source files are relative to [GNU Mach]/linux/pcmcia-cs. - -Intel 82365 PC Card controller - --disable-i82365 modules/i82365.c - -Disable scan for ISA interrupts at startup - --disable-pcmcia-isa - -*** pcmcia device drivers - -These all show up as `eth%d'. - -All source files are relative to [GNU Mach]/linux/pcmcia-cs. - -3Com 3c574 ``RoadRunner'' PCMCIA Ethernet - --disable-3c574_cs clients/3c574_cs.c - -3Com 3c589 PCMCIA Ethernet card - --disable-3c589_cs clients/3c589_cs.c - -Asix AX88190-based PCMCIA Ethernet adapters - --disable-axnet_cs clients/axnet_cs.c - -fmvj18x chipset based PCMCIA Ethernet cards - --disable-fmvj18x_cs clients/fmvj18x_cs.c - -New Media Ethernet LAN PCMCIA cards - --disable-nmclan_cs clients/nmclan_cs.c - -NS8390-based PCMCIA cards - --disable-pcnet_cs clients/pcnet_cs.c - -SMC91c92-based PCMCIA cards - --disable-smc91c92_cs clients/smc91c92_cs.c - -Xircom CreditCard and Realport PCMCIA ethernet - --disable-xirc2ps_cs clients/xirc2ps_cs.c - -Hermes or Prism 2 PCMCIA Wireless adapters (Orinoco) - --disable-orinoco_cs wireless/orinoco_cs.c |