summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--ChangeLog7
-rw-r--r--doc/mach.texi652
-rw-r--r--i386/README-Drivers297
3 files changed, 329 insertions, 627 deletions
diff --git a/ChangeLog b/ChangeLog
index 8c2371d..6de4aa8 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -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