Next: , Previous: Compilation, Up: Installing

2.3 Configuration

See the following tables for the options can be passed to the configure script as command line arguments to control what components are built into the kernel, how certain things are configured and so on.

See the top-level INSTALL file for information about generic configure options, like under which paths to install the package's components. It also describes how to control the process by setting environment variables.

The 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.

2.3.1 Table of configure switches not related to device drivers

--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. See Kernel Debugger.

2.3.2 Turning device drivers on or off

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 `--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 individual `--enable-*' switches to enable only those you actually want to have enabled.

2.3.3 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. Also follow this route to find the file(s) which are implementing a certain device driver.

2.3.4 Table of configure switches related to device drivers

(`%d' in the following denotes a unit number, starting with `0'.)

--disable-kmsg
Disables the kernel message device `kmsg'.
--disable-lpr
Disables the parallel port device driver for the `lpr%d' devices.
--disable-floppy
Disables the PC floppy disk controller device driver for the `fd%d' devices.
--disable-ide
Disables the IDE controller device driver for the `hd%d' and `hd%ds%d' (disks and their partitions) devices.

The following options control drivers for various SCSI controller. SCSI devices are named `sd%d' and `sd%ds$d' (disks and their partitions) or `cd%d' (CD ROMs).

--disable-advansys
Disables the AdvanSys SCSI controller device driver.
--disable-buslogic
Disables the BusLogic SCSI controller device driver.
--enable-flashpoint
Only meaningful in conjunction with the above BusLogic SCSI controller device driver. Enable the FlashPoint support.
--disable-u14-34f
Disables the UltraStor 14F/34F SCSI controller device driver.
--disable-ultrastor
Disables the UltraStor SCSI controller device driver.
--disable-aha152x
Disables the Adaptec AHA-152x/2825 SCSI controller device driver.
--disable-aha1542
Disables the Adaptec AHA-1542 SCSI controller device driver.
--disable-aha1740
Disables the Adaptec AHA-1740 SCSI controller device driver.
--disable-aic7xxx
Disables the Adaptec AIC7xxx SCSI controller device driver.
--disable-fdomain
Disables the Future Domain 16xx SCSI controller device driver.
--disable-in2000
Disables the Always IN 2000 SCSI controller device driver.
--enable-g_NCR5380
Enables the generic NCR5380/53c400 SCSI controller device driver.
--enable-ncr53c406a
Enables the NCR53c406a SCSI controller device driver.
--disable-pas16
Disables the PAS16 SCSI controller device driver.
--disable-seagate
Disables the Seagate ST02 and Future Domain TMC-8xx SCSI controller device driver.
--disable-t128
Disables the Trantor T128/T128F/T228 SCSI controller device driver.
--Disable-53c78xx
Disables the NCR53C7,8xx SCSI controller device driver.
--enable-eata_dma
Enables the EATA-DMA (DPT, NEC, AT&T, SNI, AST, Olivetti, Alphatronix) SCSI controller device driver.
--disable-eata_pio
Disables the EATA-PIO (old DPT PM2001, PM2012A) SCSI controller device driver.
--disable-wd7000
Disables the WD 7000 SCSI controller device driver.
--disable-eata
Disables the EATA ISA/EISA/PCI (DPT and generic EATA/DMA-compliant boards) SCSI controller device driver.
--disable-am53c974
Disables the AM53/79C974 SCSI controller device driver.
--disable-dtc
Disables the DTC3180/3280 SCSI controller device driver.
--disable-ncr53c8xx
Disables the NCR53C8XX, dc390w, dc390u, dc390f SCSI controller device driver.
--disable-tmscsim
Enables the Tekram DC-390(T) SCSI controller device driver.
--disable-ppa
Disables the IOMEGA Parallel Port ZIP drive device driver.
--disable-qlogicfas
Disables the Qlogic FAS SCSI controller device driver.
--disable-qlogicisp
Disables the Qlogic ISP SCSI controller device driver.
--disable-gdth
Disables the GDT SCSI Disk Array controller device driver.

The following options enable drivers for various ethernet cards. NIC devices are usually named `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.

--disable-ne
Disables the NE2000/NE1000 ISA network card device driver.
--disable-3c503
Disables the 3Com 503 (Etherlink II) network card device driver.
--disable-3c509
Disables the 3Com 509/579 (Etherlink III) network card device driver.
--disable-wd
Disables the WD80X3 network card device driver.
--disable-3c501
Disables the 3COM 501/Etherlink I network card device driver.
--disable-smc-ultra
Disables the SMC Ultra network card device driver.
--disable-smc-ultra32
Disables the SMC Ultra 32 network card device driver.
--disable-hp-plus
Disables the HP PCLAN+ (27247B and 27252A) network card device driver.
--disable-hp
Disables the HP PCLAN (27245 and other 27xxx series) network card device driver.
--disable-3c59x
Disables the 3Com 590/900 series (592/595/597/900/905) "Vortex/Boomerang" network card device driver.
--disable-seeq8005
Disables the Seeq8005 network card device driver.
--disable-hp100
Disables the HP 10/100VG PCLAN (ISA, EISA, PCI) network card device driver.
--disable-ac3200
Disables the Ansel Communications EISA 3200 network card device driver.
--disable-e2100
Disables the Cabletron E21xx network card device driver.
--disable-at1700
Disables the AT1700 (Fujitsu 86965) network card device driver.
--disable-eth16i
Disables the ICL EtherTeam 16i/32 network card device driver.
--disable-znet
Disables the Zenith Z-Note network card device driver.
--disable-eexpress
Disables the EtherExpress 16 network card device driver.
--disable-eepro
Disables the EtherExpressPro network card device driver.
--disable-eepro100
Disables the Intel EtherExpressPro PCI 10+/100B/100+ network card device driver.
--disable-depca
Disables the DEPCA, DE10x, DE200, DE201, DE202, DE210, DE422 network card device driver.
--disable-ewrk3
Disables the EtherWORKS 3 (DE203, DE204, DE205) network card device driver.
--disable-de4x5
Enables the DE425, DE434, DE435, DE450, DE500 network card device driver.
--disable-apricot
Disables the Apricot XEN-II on board ethernet network card device driver.
--enable-wavelan
Enables the AT&T WaveLAN & DEC RoamAbout DS network card device driver.
--disable-3c507
Disables the 3Com 507 network card device driver.
--disable-3c505
Disables the 3Com 505/Etherlink II network card device driver.
--disable-de600
Disables the D-Link DE-600 network card device driver.
--disable-de620
Disables the D-Link DE-620 network card device driver.
--disable-sk_g16
Disables the Schneider & Koch G16 network card device driver.
--disable-ni52
Disables the NI5210 network card device driver.
--disable-ni65
Disables the NI6510 network card device driver.
--enable-atp
Enables the AT-LAN-TEC/RealTek pocket adaptor network card device driver for the `atp%d' devices.
--disable-lance
Disables the AMD LANCE and PCnet (AT1500 and NE2100) network card device driver.
--disable-tulip
Disables the DECchip Tulip (dc21x4x) PCI network card device driver.
--disable-fmv18x
Disables the FMV-181/182/183/184 network card device driver.
--disable-3c515
Disables the 3Com 515 ISA Fast EtherLink network card device driver.
--disable-pcnet32
Disables the AMD PCI PCnet32 (PCI bus NE2100 cards) network card device driver.
--disable-ne2k-pci
Disables the PCI NE2000 network card device driver.
--disable-yellowfin
Disables the Packet Engines Yellowfin Gigabit-NIC network card device driver.
--disable-rtl8139
Disables the RealTek 8129/8139 (not 8019/8029!) network card device driver.
--disable-epic100
Disables the SMC 83c170/175 EPIC/100 (EtherPower II) network card device driver.
--disable-tlan
Disables the TI ThunderLAN network card device driver.
--disable-via-rhine
Disables the VIA Rhine network card device driver.
--disable-hamachi
Disables the Packet Engines "Hamachi" GNIC-2 Gigabit Ethernet device driver.
--disable-intel-gige
Disables the Intel PCI Gigabit Ethernet device driver.
--disable-myson803
Disables the Myson MTD803 Ethernet adapter series device driver.
--disable-natsemi
Disables the National Semiconductor DP8381x series PCI Ethernet device driver.
--disable-ns820
Disables the National Semiconductor DP8382x series PCI Ethernet device driver.
--disable-starfire
Disables the Adaptec Starfire network adapter device driver.
--disable-sundance
Disables the Sundance ST201 "Alta" PCI Ethernet device driver.
--disable-winbond-840
Disables the Winbond W89c840 PCI Ethernet device driver.

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.

--disable-i82365
Disables the device driver for the Intel 82365 and compatible PC Card controllers, and Yenta-compatible PCI-to-CardBus controllers.
--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.

The following options control device drivers for supported PCMCIA Ethernet controllers. NIC devices are usually named `eth%d'.

--disable-3c574_cs
Disables the PCMCIA ethernet driver for the 3Com 3c574 “RoadRunner”.
--disable-3c589_cs
Disables the driver for the 3Com 3c589 PCMCIA card.
--disable-axnet_cs
Disables the driver for the Asix AX88190-based PCMCIA cards.
--disable-fmvj18x_cs
Disables the driver for PCMCIA cards with the fmvj18x chipset.
--disable-nmclan_cs
Disables the driver for the New Media Ethernet LAN PCMCIA cards.
--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.

--disable-smc91c92_cs
Disables the driver for SMC91c92-based PCMCIA cards.
--disable-xirc2ps_cs
Disables the driver for Xircom CreditCard and Realport PCMCIA ethernet adapters.

The following options control device drivers for supported PCMCIA Wireless LAN network controllers. NIC devices are usually named `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.

--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.