docs/70674: [PATCH] Update handbook to match 5.3R (8.4 - The Configuration File)
Joel Dahl
joel at automatvapen.se
Fri Aug 20 16:51:30 UTC 2004
The following reply was made to PR docs/70674; it has been noted by GNATS.
From: Joel Dahl <joel at automatvapen.se>
To: freebsd-gnats-submit at FreeBSD.org
Cc:
Subject: Re: docs/70674: [PATCH] Update handbook to match 5.3R (8.4 - The
Configuration File)
Date: Fri, 20 Aug 2004 18:43:58 +0200
--=-JG2MxxHv2V9gFmzE28+T
Content-Type: text/plain
Content-Transfer-Encoding: 7bit
Attach patch since URL's makes PR's difficult to work with.
--
Joel
--=-JG2MxxHv2V9gFmzE28+T
Content-Disposition: attachment; filename=kernconf.diff
Content-Type: text/x-patch; name=kernconf.diff; charset=iso-8859-1
Content-Transfer-Encoding: 7bit
--- chapter.sgml Thu Aug 19 16:05:42 2004
+++ new.chapter.sgml Thu Aug 19 21:16:12 2004
@@ -426,19 +426,18 @@
some related keywords have been grouped together in a single section
(such as Networking) even though they are actually scattered
throughout the <filename>GENERIC</filename> file. <anchor
- id="kernelconfig-options"> An exhaustive list of options and more
- detailed explanations of the device lines is present in the
- <filename>LINT</filename> configuration file, located in the same
- directory as <filename>GENERIC</filename>. If you are in doubt as
- to the purpose or necessity of a line, check first in
- <filename>LINT</filename>.</para>
-
- <note><para>In &os; 5.X and above the <filename>LINT</filename> is
- non-existent. See the <filename>NOTES</filename> file for
- architecture dependent options. Some options, mainly
- architecture independent ones, are stored in the
- <filename>/usr/src/sys/conf/NOTES</filename> file. It is
- advisable to review the options in here also.</para></note>
+ id="kernelconfig-options"> An exhaustive list of architecure
+ dependent options and more detailed explanations of the device lines
+ is present in the <filename>NOTES</filename> configuration file,
+ located in the same directory as <filename>GENERIC</filename>. If you
+ are in doubt as to the purpose or necessity of a line, check first in
+ <filename>NOTES</filename>. Architecure independent options are
+ stored in <filename>/usr/src/sys/conf/NOTES</filename>.</para>
+
+ <note><para>In &os; 4.X and earlier <filename>NOTES</filename> is
+ non-existent. Instead, see the <filename>LINT</filename> file for
+ detailed explanations of options in <filename>GENERIC</filename>.
+ </para></note>
<indexterm>
<primary>kernel</primary>
@@ -450,27 +449,27 @@
clarity. This example should match your copy in
<filename>/usr/src/sys/i386/conf/GENERIC</filename> fairly
closely. For details of all the possible kernel options, see
- <filename>/usr/src/sys/i386/conf/LINT</filename>.</para>
+ <filename>/usr/src/sys/i386/conf/NOTES</filename>.</para>
<programlisting>#
-# GENERIC -- Generic kernel configuration file for &os;/i386
+# GENERIC -- Generic kernel configuration file for FreeBSD/i386
#
# For more information on this file, please read the handbook section on
# Kernel Configuration Files:
#
-# http://www.&os;.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig-config.html
+# http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig-config.html
#
# The handbook is also available locally in /usr/share/doc/handbook
# if you've installed the doc distribution, otherwise always see the
-# &os; World Wide Web server (http://www.FreeBSD.org/) for the
+# FreeBSD World Wide Web server (http://www.FreeBSD.org/) for the
# latest information.
#
# An exhaustive list of options and more detailed explanations of the
-# device lines is also present in the ../../conf/NOTES and NOTES files.
-# If you are in doubt as to the purpose or necessity of a line, check first
+# device lines is also present in the ../../conf/NOTES and NOTES files.
+# If you are in doubt as to the purpose or necessity of a line, check first
# in NOTES.
#
-# $FreeBSD: src/sys/i386/conf/GENERIC,v 1.380 2003/03/29 13:36:41 mdodd Exp $</programlisting>
+# $FreeBSD: /repoman/r/ncvs/src/sys/i386/conf/GENERIC,v 1.413 2004/08/11 01:34:18 rwatson Exp $</programlisting>
<para>The following are the mandatory keywords required in
<emphasis>every</emphasis> kernel you build:</para>
@@ -606,14 +605,14 @@
</note>
<programlisting># Floating point support - do not disable.
-device npx0 at nexus? port IO_NPX irq 13</programlisting>
+device npx0</programlisting>
<para><literal>npx0</literal> is the interface to the floating point
math unit in &os;, which is either the hardware co-processor or
the software math emulator. This is <emphasis>not</emphasis>
optional.</para>
- <programlisting># Pseudo devices - the number indicates how many units to allocate.
+ <programlisting># Pseudo devices
device loop # Network loopback</programlisting>
<para>This is the generic loopback device for TCP/IP. If you telnet
@@ -654,26 +653,10 @@
you are using the <quote>traditional</quote> way for building your kernels (See the <xref linkend="kernelconfig-building">
for more informations.).</para>
- <programlisting>options MATH_EMULATE #Support for x87 emulation</programlisting>
-
- <para>This line allows the kernel to simulate a math co-processor if
- your computer does not have one (386 or 486SX). If you have a
- 486DX, or a 386 or 486SX (with a separate 387 or 487 chip), or
- higher (&pentium;, &pentium; II, etc.), you can comment this line
- out.</para>
+ <programlisting>options SCHED_ULE # ULE scheduler</programlisting>
- <note>
- <para>The normal math co-processor emulation routines that come with
- &os; are <emphasis>not</emphasis> very accurate. If you do not
- have a math co-processor, and you need the best accuracy, it is
- recommended that you change this option to
- <literal>GPL_MATH_EMULATE</literal> to use the GNU math support,
- which is not included by default for licensing reasons.</para>
-
- <para>In &os; 5.X, math emulation is disabled by default,
- as older CPUs that do not have native floating point math support
- are far less common, and in many cases not supported by the
- <filename>GENERIC</filename> kernel without other additional options.</para></note>
+ <para>The new scheduler for &os; that has been designed for SMP, but
+ will work just fine on UP systems too.</para>
<programlisting>options INET #InterNETworking</programlisting>
@@ -686,15 +669,11 @@
<para>This enables the IPv6 communication protocols.</para>
- <programlisting>options FFS #Berkeley Fast Filesystem
-options FFS_ROOT #FFS usable as root device [keep this!]</programlisting>
+ <programlisting>options FFS #Berkeley Fast Filesystem</programlisting>
<para>This is the basic hard drive Filesystem. Leave it in if you
boot from the hard disk.</para>
- <note><para>In &os; 5.X, <literal>FFS_ROOT</literal> is no longer
- required.</para></note>
-
<programlisting>options UFS_ACL #Support for access control lists</programlisting>
<para>This option, present only in &os; 5.X, enables kernel support
@@ -726,29 +705,10 @@
filesystems) or &man.newfs.8; (for new filesystems)
commands.</para>
- <programlisting>options MFS #Memory Filesystem
-options MD_ROOT #MD is a potential root device</programlisting>
+ <programlisting>options MD_ROOT #MD is a potential root device</programlisting>
- <para>This is the memory-mapped Filesystem. This is basically a RAM
- disk for fast storage of temporary files, useful if you have a lot
- of swap space that you want to take advantage of. A perfect place
- to mount an MFS partition is on the <filename>/tmp</filename>
- directory, since many programs store temporary data here. To mount
- an MFS RAM disk on <filename>/tmp</filename>, add the following line
- to <filename>/etc/fstab</filename>:</para>
-
- <informalexample>
- <programlisting>/dev/ad1s2b /tmp mfs rw 0 0</programlisting>
- </informalexample>
-
- <para>Now you simply need to either reboot, or run the command
- <command>mount /tmp</command>.</para>
-
- <note><para>In &os; 5.X, &man.md.4;-backed UFS file systems are
- used for memory file systems rather than MFS. Information on
- configuring memory-backed file systems may be found in the manual pages
- for &man.mdconfig.8; and &man.mdmfs.8;, and in <xref linkend="disks-virtual">. As a result, the
- <literal>MFS</literal> option is no longer supported.</para></note>
+ <para>This is option enables support for a memory backed virtual disk
+ as root device.</para>
<indexterm>
<primary>kernel options</primary>
@@ -758,8 +718,9 @@
<primary>kernel options</primary>
<secondary>NFS_ROOT</secondary>
</indexterm>
- <programlisting>options NFS #Network Filesystem
-options NFS_ROOT #NFS usable as root device, NFS required</programlisting>
+ <programlisting>options NFSCLIENT # Network Filesystem Client
+options NFSSERVER # Network Filesystem Server
+options NFS_ROOT # NFS usable as /, requires NFSCLIENT</programlisting>
<para>The network Filesystem. Unless you plan to mount partitions
from a &unix; file server over TCP/IP, you can comment these
@@ -780,8 +741,7 @@
unmount them (and does not require <literal>MSDOSFS</literal> at
all).</para>
- <programlisting>options CD9660 #ISO 9660 Filesystem
-options CD9660_ROOT #CD-ROM usable as root, CD9660 required</programlisting>
+ <programlisting>options CD9660 #ISO 9660 Filesystem</programlisting>
<para>The ISO 9660 Filesystem for CDROMs. Comment it out if you do
not have a CDROM drive or only mount data CDs occasionally (since it
@@ -793,10 +753,10 @@
<para>The process filesystem. This is a <quote>pretend</quote>
filesystem mounted on <filename>/proc</filename> which allows
programs like &man.ps.1; to give you more information on what
- processes are running. In &os; 5.X, use of <literal>PROCFS</literal>
- is not required under most circumstances, as most
- debugging and monitoring tools have been adapted to run without
- <literal>PROCFS</literal>. In addition, 5.X-CURRENT kernels
+ processes are running. In &os; 5.X and above, use of
+ <literal>PROCFS</literal> is not required under most circumstances,
+ as most debugging and monitoring tools have been adapted to run
+ without <literal>PROCFS</literal>. In addition, 6.X-CURRENT kernels
making use of <literal>PROCFS</literal> must now also include
support for <literal>PSEUDOFS</literal>:</para>
@@ -829,32 +789,10 @@
you do this, and &os; has trouble recognizing your SCSI devices,
you will have to raise it back up.</para>
- <programlisting>options UCONSOLE #Allow users to grab the console</programlisting>
-
- <para>Allow users to grab the console, which is useful for X users.
- For example, you can create a console <application>xterm</application>
- by typing <command>xterm
- -C</command>, which will display any &man.write.1;,
- &man.talk.1;, and any other messages you receive, as well
- as any console messages sent by the kernel.</para>
-
- <note><para>In &os; 5.X, <literal>UCONSOLE</literal> is no
- longer required.</para></note>
-
- <programlisting>options USERCONFIG #boot -c editor</programlisting>
-
- <para>This option allows you to boot the configuration editor from the
- boot menu.</para>
-
- <programlisting>options VISUAL_USERCONFIG #visual boot -c editor</programlisting>
-
- <para>This option allows you to boot the visual configuration editor
- from the boot menu.</para>
+ <programlisting>options GEOM_GPT # GUID Partition Tables.</programlisting>
- <note><para>From &os; versions 5.0 and later, the <literal>USERCONFIG</literal> options has
- been deprecated in favor of the new &man.device.hints.5;
- method. For more information on &man.device.hints.5; please
- visit <xref linkend="device-hints">.</para></note>
+ <para>This option brings the ability to have a large number of
+ partitions on a single disk.</para>
<programlisting>options KTRACE #ktrace(1) support</programlisting>
@@ -884,42 +822,29 @@
these System V facilities.</para>
</note>
- <programlisting>options P1003_1B #Posix P1003_1B real-time extensions
-options _KPOSIX_PRIORITY_SCHEDULING</programlisting>
+ <programlisting>options _KPOSIX_PRIORITY_SCHEDULING</programlisting>
<para>Real-time extensions added in the 1993 &posix;. Certain
applications in the ports collection use these
(such as <application>&staroffice;</application>).</para>
- <note><para>In &os; 5.X, all of this functionality is now
- provided by the <literal>_KPOSIX_PRIORITY_SCHEDULING</literal>
- option, and <literal>P1003_1B</literal> is no longer
- required.</para></note>
+ <programlisting>options PFIL_HOOKS # pfil(9) framework</programlisting>
- <indexterm>
- <primary>kernel options</primary>
- <secondary>ICMP_BANDLIM</secondary>
- </indexterm>
- <indexterm>
- <primary>Denial of Service (DoS)</primary>
- </indexterm>
- <programlisting>options ICMP_BANDLIM #Rate limit bad replies</programlisting>
+ <para>The pfil framework is required by the IPFILTER and IPFIREWALL
+ options.</para>
- <para>This option enables ICMP error response bandwidth limiting. You
- typically want this option as it will help protect the machine from
- denial of service packet attacks.</para>
+ <programlisting>options ADAPTIVE_GIANT # Giant mutex is adaptive.</programlisting>
- <note><para>In &os; 5.X, this feature is enabled by default and
- the <literal>ICMP_BANDLIM</literal> option is not required.
- </para></note>
+ <para>This option causes Giant to be included in the set of mutexes
+ adaptively spun on.</para>
<indexterm>
<primary>kernel options</primary>
<secondary>SMP</secondary>
</indexterm>
<programlisting># To make an SMP kernel, the next two are needed
-#options SMP # Symmetric MultiProcessor Kernel
-#options APIC_IO # Symmetric (APIC) I/O</programlisting>
+options SMP # Symmetric MultiProcessor Kernel
+device apic # I/O APIC</programlisting>
<para>The above are both required for SMP support.</para>
@@ -930,7 +855,7 @@
IBM PS/2 (Micro Channel Architecture), &os; provides some
limited support at this time. For more information about the
MCA support, see
- <filename>/usr/src/sys/i386/conf/LINT</filename>.</para>
+ <filename>/usr/src/sys/i386/conf/NOTES</filename>.</para>
<programlisting>device eisa</programlisting>
@@ -951,14 +876,9 @@
have these features.</para>
<programlisting># Floppy drives
-device fdc0 at isa? port IO_FD1 irq 6 drq 2
-device fd0 at fdc0 drive 0
-device fd1 at fdc0 drive 1</programlisting>
-
- <para>This is the floppy drive controller. <literal>fd0</literal> is
- the <devicename>A:</devicename> floppy drive, and
- <literal>fd1</literal> is the <devicename>B:</devicename>
- drive.</para>
+device fdc</programlisting>
+
+ <para>This is the floppy drive controller.</para>
<programlisting>device ata</programlisting>
@@ -971,6 +891,11 @@
<para>This is needed along with <literal>device ata</literal> for
ATA disk drives.</para>
+ <programlisting>device ataraid # ATA RAID drives</programlisting>
+
+ <para>This is needed along with <literal>device ata</literal> for
+ ATA RAID drives.</para>
+
<programlisting><anchor id="kernelconfig-atapi">
device atapicd # ATAPI CDROM drives</programlisting>
@@ -992,26 +917,26 @@
<para>This makes the controller number static (like the old driver) or
else the device numbers are dynamically allocated.</para>
- <programlisting># ATA and ATAPI devices
-device ata0 at isa? port IO_WD1 irq 14
-device ata1 at isa? port IO_WD2 irq 15</programlisting>
-
- <para>Use the above for older, non-PCI systems.</para>
-
<programlisting># SCSI Controllers
device ahb # EISA AHA1742 family
device ahc # AHA2940 and onboard AIC7xxx devices
+device ahd # AHA39320/29320 and onboard AIC79xx devices
device amd # AMD 53C974 (Teckram DC-390(T))
-device dpt # DPT Smartcache - See LINT for options!
device isp # Qlogic family
+device mpt # LSI-Logic MPT-Fusion
device ncr # NCR/Symbios Logic
-device sym # NCR/Symbios Logic (newer chipsets)
+device sym # NCR/Symbios Logic (newer chipsets + those of `ncr')
+device trm # Tekram DC395U/UW/F DC315U adapters
-device adv0 at isa?
-device adw
-device bt0 at isa?
-device aha0 at isa?
-device aic0 at isa?</programlisting>
+device adv # Advansys SCSI adapters
+device adw # Advansys wide SCSI adapters
+device aha # Adaptec 154x SCSI adapters
+device aic # Adaptec 15[012]x SCSI adapters, AIC-6[23]60.
+device bt # Buslogic/Mylex MultiMaster SCSI adapters
+
+device ncv # NCR 53C500
+device nsp # Workbit Ninja SCSI-3
+device stg # TMC 18C30/18C50</programlisting>
<para>SCSI controllers. Comment out any you do not have in your
system. If you have an IDE only system, you can remove these
@@ -1019,11 +944,12 @@
<programlisting># SCSI peripherals
device scbus # SCSI bus (required)
+device ch # SCSI media changers
device da # Direct Access (disks)
device sa # Sequential Access (tape etc)
device cd # CD
-device pass # Passthrough device (direct SCSI
-access)</programlisting>
+device pass # Passthrough device (direct SCSI access)
+device ses # SCSI Environmental Services (and SAF-TE)</programlisting>
<para>SCSI peripherals. Again, comment out any you do not have, or if
you have only IDE hardware, you can remove them completely.</para>
@@ -1035,16 +961,28 @@
drivers are included in the kernel configuration.</para>
</note>
- <programlisting># RAID controllers
-device ida # Compaq Smart RAID
+ <programlisting># RAID controllers interfaced to the SCSI subsystem
device amr # AMI MegaRAID
-device mlx # Mylex DAC960 family</programlisting>
+device asr # DPT SmartRAID V, VI and Adaptec SCSI RAID
+device ciss # Compaq Smart RAID 5*
+device dpt # DPT Smartcache III, IV - See NOTES for options
+device iir # Intel Integrated RAID
+device ips # IBM (Adaptec) ServeRAID
+device mly # Mylex AcceleRAID/eXtremeRAID
+device twa # 3ware 9000 series PATA/SATA RAID
+
+# RAID controllers
+device aac # Adaptec FSA RAID
+device aacp # SCSI passthrough for aac (requires CAM)
+device ida # Compaq Smart RAID
+device mlx # Mylex DAC960 family
+device pst # Promise Supertrak SX6000
+device twe # 3ware ATA RAID</programlisting>
<para>Supported RAID controllers. If you do not have any of these,
you can comment them out or remove them.</para>
- <programlisting># atkbdc0 controls both the keyboard and the PS/2 mouse
-device atkbdc0 at isa? port IO_KBD</programlisting>
+ <programlisting>device atkbdc # AT keyboard controller</programlisting>
<para>The keyboard controller (<literal>atkbdc</literal>) provides I/O
services for the AT keyboard and PS/2 style pointing devices. This
@@ -1052,79 +990,86 @@
(<literal>atkbd</literal>) and the PS/2 pointing device driver
(<literal>psm</literal>).</para>
- <programlisting>device atkbd0 at atkbdc? irq 1</programlisting>
+ <programlisting>device atkbd # AT keyboard</programlisting>
<para>The <literal>atkbd</literal> driver, together with
<literal>atkbdc</literal> controller, provides access to the AT 84
keyboard or the AT enhanced keyboard which is connected to the AT
keyboard controller.</para>
- <programlisting>device psm0 at atkbdc? irq 12</programlisting>
+ <programlisting>device psm # PS/2 mouse</programlisting>
<para>Use this device if your mouse plugs into the PS/2 mouse
port.</para>
- <programlisting>device vga0 at isa?</programlisting>
+ <programlisting>device vga # VGA video card driver</programlisting>
<para>The video card driver.</para>
- <programlisting># splash screen/screen saver
-device splash</programlisting>
+ <programlisting>device splash # Splash screen and screen saver support</programlisting>
<para>Splash screen at start up! Screen savers require this
too. Use the line <literal>pseudo-device splash</literal> with
&os; 4.X.</para>
<programlisting># syscons is the default console driver, resembling an SCO console
-device sc0 at isa?</programlisting>
+device sc</programlisting>
- <para><literal>sc0</literal> is the default console driver, which
+ <para><literal>sc</literal> is the default console driver, which
resembles a SCO console. Since most full-screen programs access the
console through a terminal database library like
<filename>termcap</filename>, it should not matter whether you use
- this or <literal>vt0</literal>, the <literal>VT220</literal>
+ this or <literal>vt</literal>, the <literal>VT220</literal>
compatible console driver. When you log in, set your
<envar>TERM</envar> variable to <literal>scoansi</literal> if
full-screen programs have trouble running under this console.</para>
<programlisting># Enable this and PCVT_FREEBSD for pcvt vt220 compatible console driver
-#device vt0 at isa?
+#device vt
#options XSERVER # support for X server on a vt console
-#options FAT_CURSOR # start with block cursor
-# If you have a ThinkPAD, uncomment this along with the rest of the PCVT lines
-#options PCVT_SCANSET=2 # IBM keyboards are non-std</programlisting>
+#options FAT_CURSOR # start with block cursor</programlisting>
<para>This is a VT220-compatible console driver, backward compatible to
VT100/102. It works well on some laptops which have hardware
- incompatibilities with <literal>sc0</literal>. Also set your
+ incompatibilities with <literal>sc</literal>. Also set your
<envar>TERM</envar> variable to <literal>vt100</literal> or
<literal>vt220</literal> when you log in. This driver might also
prove useful when connecting to a large number of different machines
over the network, where <filename>termcap</filename> or
- <filename>terminfo</filename> entries for the <literal>sc0</literal>
+ <filename>terminfo</filename> entries for the <literal>sc</literal>
device are often not available — <literal>vt100</literal>
should be available on virtually any platform.</para>
- <programlisting># Power management support (see LINT for more options)
-device apm0 at nexus? disable flags 0x20 # Advanced Power Management</programlisting>
+ <programlisting># Power management support (see NOTES for more options)
+#device apm</programlisting>
<para>Advanced Power Management support. Useful for laptops.</para>
+ <note>
+ <para>In &os; 5.X and above this is disabled in
+ <filename>GENERIC</filename> by default.</para>
+ </note>
+
+ <programlisting>#Add suspend/resume support for the i8254.
+device pmtimer</programlisting>
+
+ <para>Timer device driver for power management events, such as APM and
+ ACPI.</para>
+
+
<programlisting># PCCARD (PCMCIA) support
-device card
-device pcic0 at isa? irq 10 port 0x3e0 iomem 0xd0000
-device pcic1 at isa? irq 11 port 0x3e2 iomem 0xd4000 disable</programlisting>
+# PCMCIA and cardbus bridge support
+device cbb # cardbus (yenta) bridge
+device pccard # PC Card (16-bit) bus
+device cardbus # CardBus (32-bit) bus</programlisting>
<para>PCMCIA support. You want this if you are using a
laptop.</para>
<programlisting># Serial (COM) ports
-device sio0 at isa? port IO_COM1 flags 0x10 irq 4
-device sio1 at isa? port IO_COM2 irq 3
-device sio2 at isa? disable port IO_COM3 irq 5
-device sio3 at isa? disable port IO_COM4 irq 9</programlisting>
+device sio # 8250, 16[45]50 based serial ports</programlisting>
- <para>These are the four serial ports referred to as <devicename>COM1</devicename> through <devicename>COM4</devicename>
+ <para>These are the serial ports referred to as <devicename>COM</devicename> ports
in the &ms-dos/&windows; world.</para>
<note>
@@ -1146,7 +1091,7 @@
</note>
<programlisting># Parallel port
-device ppc0 at isa? irq 7</programlisting>
+device ppc</programlisting>
<para>This is the ISA-bus parallel port interface.</para>
@@ -1179,12 +1124,18 @@
<literal>scbus</literal> and <literal>da</literal> support. Best
performance is achieved with ports in EPP 1.9 mode.</para>
+ <programlisting>#device puc</programlisting>
+
+ <para>Uncomment this device if you have a <quote>dumb</quote> serial or
+ parallel PCI card that is supported by the &man.puc.4 glue driver.
+ </para>
+
<programlisting># PCI Ethernet NICs.
device de # DEC/Intel DC21x4x (<quote>Tulip</quote>)
-device fxp # Intel EtherExpress PRO/100B (82557, 82558)
-device tx # SMC 9432TX (83c170 <quote>EPIC</quote>)
-device vx # 3Com 3c590, 3c595 (<quote>Vortex</quote>)
-device wx # Intel Gigabit Ethernet Card (<quote>Wiseman</quote>)</programlisting>
+device em # Intel PRO/1000 adapter Gigabit Ethernet Card
+device ixgb # Intel PRO/10GbE Ethernet Card
+device txp # 3Com 3cR990 (<quote>Typhoon</quote>)
+device vx # 3Com 3c590, 3c595 (<quote>Vortex</quote>)</programlisting>
<para>Various PCI network card drivers. Comment out or remove any of
these not present in your system.</para>
@@ -1201,43 +1152,43 @@
by an individual driver.</para>
<programlisting>device dc # DEC/Intel 21143 and various workalikes
+device bfe # Broadcom BCM440x 10/100 Ethernet
+device bge # Broadcom BCM570xx Gigabit Ethernet
+device dc # DEC/Intel 21143 and various workalikes
+device fxp # Intel EtherExpress PRO/100B (82557, 82558)
+device pcn # AMD Am79C97x PCI 10/100 (precedence over 'lnc')
+device re # RealTek 8139C+/8169/8169S/8110S
device rl # RealTek 8129/8139
device sf # Adaptec AIC-6915 (<quote>Starfire</quote>)
device sis # Silicon Integrated Systems SiS 900/SiS 7016
+device sk # SysKonnect SK-984x & SK-982x gigabit Ethernet
device ste # Sundance ST201 (D-Link DFE-550TX)
+device ti # Alteon Networks Tigon I/II gigabit Ethernet
device tl # Texas Instruments ThunderLAN
+device tx # SMC EtherPower II (83c170 <quote>EPIC</quote>)
device vr # VIA Rhine, Rhine II
device wb # Winbond W89C840F
device xl # 3Com 3c90x (<quote>Boomerang</quote>, <quote>Cyclone</quote>)</programlisting>
<para>Drivers that use the MII bus controller code.</para>
- <programlisting># ISA Ethernet NICs.
-device ed0 at isa? port 0x280 irq 10 iomem 0xd8000
-device ex
-device ep
-# WaveLAN/IEEE 802.11 wireless NICs. Note: the WaveLAN/IEEE really
-# exists only as a PCMCIA device, so there is no ISA attachment needed
-# and resources will always be dynamically assigned by the pccard code.
-device wi
-# Aironet 4500/4800 802.11 wireless NICs. Note: the declaration below will
-# work for PCMCIA and PCI cards, as well as ISA cards set to ISA PnP
-# mode (the factory default). If you set the switches on your ISA
-# card for a manually chosen I/O address and IRQ, you must specify
-# those parameters here.
-device an
-# The probe order of these is presently determined by i386/isa/isa_compat.c.
-device ie0 at isa? port 0x300 irq 10 iomem 0xd0000
-device fe0 at isa? port 0x300
-device le0 at isa? port 0x300 irq 5 iomem 0xd0000
-device lnc0 at isa? port 0x280 irq 10 drq 0
-device cs0 at isa? port 0x300
-device sn0 at isa? port 0x300 irq 10
-# requires PCCARD (PCMCIA) support to be activated
-#device xe0 at isa?</programlisting>
+ <programlisting># ISA Ethernet NICs. pccard NICs included.
+device cs # Crystal Semiconductor CS89x0 NIC
+# 'device ed' requires 'device miibus'
+device ed # NE[12]000, SMC Ultra, 3c503, DS8390 cards
+device ex # Intel EtherExpress Pro/10 and Pro/10+
+device ep # Etherlink III based cards
+device fe # Fujitsu MB8696x based cards
+device ie # EtherExpress 8/16, 3C507, StarLAN 10 etc.
+device lnc # NE2100, NE32-VL Lance Ethernet cards
+device sn # SMC's 9000 series of Ethernet chips
+device xe # Xircom pccard Ethernet
+
+# ISA devices that use the old ISA shims
+#device le</programlisting>
<para>ISA Ethernet drivers. See
- <filename>/usr/src/sys/i386/conf/LINT</filename> for which cards are
+ <filename>/usr/src/sys/i386/conf/NOTES</filename> for which cards are
supported by which driver.</para>
<programlisting>device ether # Ethernet support</programlisting>
@@ -1247,7 +1198,21 @@
&os; 4.X use the line <literal>pseudo-device
ether</literal>.</para>
- <programlisting>device sl 1 # Kernel SLIP</programlisting>
+ <programlisting>device mem # Memory and kernel memory devices</programlisting>
+
+ <para>The system memory devices.</para>
+
+ <programlisting>device io # I/O device</programlisting>
+
+ <para>This is a controlled security hole that allows a process to gain
+ I/O privileges. This is useful in order to write userland programs
+ that can handle hardware directly.</para>
+
+ <programlisting>device random # Entropy device</programlisting>
+
+ <para>Cryptographically secure random number generator.</para>
+
+ <programlisting>device sl # Kernel SLIP</programlisting>
<para><literal>sl</literal> is for SLIP support. This has been almost
entirely supplanted by PPP, which is easier to set up, better suited
@@ -1257,7 +1222,7 @@
With &os; 4.X use the line <literal>pseudo-device
sl</literal>.</para>
- <programlisting>device ppp 1 # Kernel PPP</programlisting>
+ <programlisting>device ppp # Kernel PPP</programlisting>
<para>This is for kernel PPP support for dial-up connections. There
is also a version of PPP implemented as a userland application that
@@ -1334,25 +1299,37 @@
</note>
<programlisting># USB support
-#device uhci # UHCI PCI->USB interface
-#device ohci # OHCI PCI->USB interface
-#device usb # USB Bus (required)
-#device ugen # Generic
-#device uhid # <quote>Human Interface Devices</quote>
-#device ukbd # Keyboard
-#device ulpt # Printer
-#device umass # Disks/Mass storage - Requires scbus and da
-#device ums # Mouse
+#device uhci # UHCI PCI->USB interface
+#device ohci # OHCI PCI->USB interface
+device usb # USB Bus (required)
+#device udbp # USB Double Bulk Pipe devices
+device ugen # Generic
+device uhid # <quote>Human Interface Devices</quote>
+device ukbd # Keyboard
+device ulpt # Printer
+device umass # Disks/Mass storage - Requires scbus and da
+device ums # Mouse
+device urio # Diamond Rio 500 MP3 player
+device uscanner # Scanners
# USB Ethernet, requires mii
-#device aue # ADMtek USB ethernet
-#device cue # CATC USB ethernet
-#device kue # Kawasaki LSI USB ethernet</programlisting>
+device aue # ADMtek USB Ethernet
+device axe # ASIX Electronics USB Ethernet
+device cue # CATC USB Ethernet
+device kue # Kawasaki LSI USB Ethernet
+device rue # RealTek RTL8150 USB Ethernet</programlisting>
<para>Support for various USB devices.</para>
+ <programlisting># FireWire support
+device firewire # FireWire bus code
+device sbp # SCSI over FireWire (Requires scbus and da)
+device fwe # Ethernet over FireWire (non-standard!)</programlisting>
+
+ <para>Support for Firewire devices.</para>
+
<para>For more information and additional devices supported by
&os;, see
- <filename>/usr/src/sys/i386/conf/LINT</filename>.</para>
+ <filename>/usr/src/sys/i386/conf/NOTES</filename>.</para>
<sect2>
<title>Large Memory Configurations (<acronym>PAE</acronym>)</title>
--=-JG2MxxHv2V9gFmzE28+T--
More information about the freebsd-doc
mailing list