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

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.

--enable-pae

PAE (Physical Address Extension) feature (‘ix86’-only), which is available on modern ‘ix86’ processors; on ‘ix86-at’ disabled by default, on ‘ix86-xen’ enabled by default.

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. You can specify ‘--enable-device-drivers=WHICH’ (where WHICH on ‘ix86-at’ must be one of ‘default’, ‘qemu’, ‘none’) to preset a certain subset of all available device drivers. ‘--enable-device-drivers’ is sugar for ‘--enable-device-drivers=default’ (and is the implicit default nevertheless) and ‘--disable-device-drivers’ is short for ‘--enable-device-drivers=none’. ‘qemu’ will include only the set of device drivers that is useful when using the resulting kernel binary to drive a Hurd system in the QEMU system emulator. This is only useful for reducing the kernel build time and the kernel image size.

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

Kernel message device ‘kmsg’.

--enable-lpr

Parallel port device driver for the ‘lpr%d’ devices. On ‘ix86-at’ enabled by ‘default’.

--enable-floppy

PC floppy disk controller device driver for the ‘fd%d’ devices. On ‘ix86-at’ enabled by ‘default’ and for ‘qemu’.

--enable-ide

IDE controller device driver for the ‘hd%d’ and ‘hd%ds%d’ (disks and their partitions) devices. On ‘ix86-at’ enabled by ‘default’ and for ‘qemu’.

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

--enable-advansys

AdvanSys SCSI controller device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-buslogic

BusLogic SCSI controller device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-flashpoint

Only meaningful in conjunction with the above BusLogic SCSI controller device driver. Enable the FlashPoint support.

--enable-u14-34f

UltraStor 14F/34F SCSI controller device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-ultrastor

UltraStor SCSI controller device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-aha152x

Adaptec AHA-152x/2825 SCSI controller device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-aha1542

Adaptec AHA-1542 SCSI controller device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-aha1740

Adaptec AHA-1740 SCSI controller device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-aic7xxx

Adaptec AIC7xxx SCSI controller device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-fdomain

Future Domain 16xx SCSI controller device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-in2000

Always IN 2000 SCSI controller device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-g_NCR5380

Generic NCR5380/53c400 SCSI controller device driver.

--enable-NCR53c406a

NCR53c406a SCSI controller device driver.

--enable-pas16

PAS16 SCSI controller device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-seagate

Seagate ST02 and Future Domain TMC-8xx SCSI controller device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-t128

Trantor T128/T128F/T228 SCSI controller device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-53c78xx

NCR53C7,8xx SCSI controller device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-eata_dma

EATA-DMA (DPT, NEC, AT&T, SNI, AST, Olivetti, Alphatronix) SCSI controller device driver.

--enable-eata_pio

EATA-PIO (old DPT PM2001, PM2012A) SCSI controller device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-wd7000

WD 7000 SCSI controller device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-eata

EATA ISA/EISA/PCI (DPT and generic EATA/DMA-compliant boards) SCSI controller device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-am53c974

AM53/79C974 SCSI controller device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-dtc

DTC3180/3280 SCSI controller device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-ncr53c8xx

NCR53C8XX, dc390w, dc390u, dc390f SCSI controller device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-tmscsim

Tekram DC-390(T) SCSI controller device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-ppa

IOMEGA Parallel Port ZIP drive device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-qlogicfas

Qlogic FAS SCSI controller device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-qlogicisp

Qlogic ISP SCSI controller device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-gdth

GDT SCSI Disk Array controller device driver. On ‘ix86-at’ enabled by ‘default’.

The following options enable drivers for various ethernet cards. NIC devices are usually named ‘eth%d’, except for the pocket adaptors.

--enable-ne

NE2000/NE1000 ISA network card device driver. On ‘ix86-at’ enabled by ‘default’ and for ‘qemu’.

--enable-3c503

3Com 503 (Etherlink II) network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-3c509

3Com 509/579 (Etherlink III) network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-wd

WD80X3 network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-3c501

3COM 501/Etherlink I network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-smc-ultra

SMC Ultra network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-smc-ultra32

SMC Ultra 32 network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-hp-plus

HP PCLAN+ (27247B and 27252A) network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-hp

HP PCLAN (27245 and other 27xxx series) network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-3c59x

3Com 590/900 series (592/595/597/900/905) "Vortex/Boomerang" network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-seeq8005

Seeq8005 network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-hp100

HP 10/100VG PCLAN (ISA, EISA, PCI) network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-ac3200

Ansel Communications EISA 3200 network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-e2100

Cabletron E21xx network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-at1700

AT1700 (Fujitsu 86965) network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-eth16i

ICL EtherTeam 16i/32 network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-znet

Zenith Z-Note network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-eexpress

EtherExpress 16 network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-eepro

EtherExpressPro network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-eepro100

Intel EtherExpressPro PCI 10+/100B/100+ network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-depca

DEPCA, DE10x, DE200, DE201, DE202, DE210, DE422 network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-ewrk3

EtherWORKS 3 (DE203, DE204, DE205) network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-de4x5

DE425, DE434, DE435, DE450, DE500 network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-apricot

Apricot XEN-II on board ethernet network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-wavelan

AT&T WaveLAN & DEC RoamAbout DS network card device driver.

--enable-3c507

3Com 507 network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-3c505

3Com 505/Etherlink II network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-de600

D-Link DE-600 network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-de620

D-Link DE-620 network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-sk_g16

Schneider & Koch G16 network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-ni52

NI5210 network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-ni65

NI6510 network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-atp

AT-LAN-TEC/RealTek pocket adaptor network card device driver for the ‘atp%d’ devices.

--enable-lance

AMD LANCE and PCnet (AT1500 and NE2100) network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-tulip

DECchip Tulip (dc21x4x) PCI network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-fmv18x

FMV-181/182/183/184 network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-3c515

3Com 515 ISA Fast EtherLink network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-pcnet32

AMD PCI PCnet32 (PCI bus NE2100 cards) network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-ne2k-pci

PCI NE2000 network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-yellowfin

Packet Engines Yellowfin Gigabit-NIC network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-rtl8139

RealTek 8129/8139 (not 8019/8029!) network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-epic100

SMC 83c170/175 EPIC/100 (EtherPower II) network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-tlan

TI ThunderLAN network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-via-rhine

VIA Rhine network card device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-hamachi

Packet Engines "Hamachi" GNIC-2 Gigabit Ethernet device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-intel-gige

Intel PCI Gigabit Ethernet device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-myson803

Myson MTD803 Ethernet adapter series device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-natsemi

National Semiconductor DP8381x series PCI Ethernet device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-ns820

National Semiconductor DP8382x series PCI Ethernet device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-starfire

Adaptec Starfire network adapter device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-sundance

Sundance ST201 "Alta" PCI Ethernet device driver. On ‘ix86-at’ enabled by ‘default’.

--enable-winbond-840

Winbond W89c840 PCI Ethernet device driver. On ‘ix86-at’ enabled by ‘default’.

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.

--enable-i82365

Device driver for the Intel 82365 and compatible PC Card controllers, and Yenta-compatible PCI-to-CardBus controllers. On ‘ix86-at’ enabled by ‘default’.

--enable-pcmcia-isa

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. On ‘ix86-at’ enabled by ‘default’.

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

--enable-3c574_cs

PCMCIA ethernet driver for the 3Com 3c574 “RoadRunner”. On ‘ix86-at’ enabled by ‘default’.

--enable-3c589_cs

Driver for the 3Com 3c589 PCMCIA card. On ‘ix86-at’ enabled by ‘default’.

--enable-axnet_cs

Driver for the Asix AX88190-based PCMCIA cards. On ‘ix86-at’ enabled by ‘default’.

--enable-fmvj18x_cs

Driver for PCMCIA cards with the fmvj18x chipset. On ‘ix86-at’ enabled by ‘default’.

--enable-nmclan_cs

Driver for the New Media Ethernet LAN PCMCIA cards. On ‘ix86-at’ enabled by ‘default’.

--enable-pcnet_cs

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. On ‘ix86-at’ enabled by ‘default’.

--enable-smc91c92_cs

Driver for SMC91c92-based PCMCIA cards. On ‘ix86-at’ enabled by ‘default’.

--enable-xirc2ps_cs

Driver for Xircom CreditCard and Realport PCMCIA ethernet adapters. On ‘ix86-at’ enabled by ‘default’.

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.

--enable-orinoco_cs

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. On ‘ix86-at’ enabled by ‘default’.