xref: /freebsd/sys/conf/NOTES (revision c6de6a69a10a2a4075a5dbf55b95429ce1e3ade6)
12365e64fSRodney W. Grimes#
22365e64fSRodney W. Grimes# LINT -- config file for checking all the sources, tries to pull in
32365e64fSRodney W. Grimes#	as much of the source tree as it can.
42365e64fSRodney W. Grimes#
5c6de6a69SEivind Eklund#	$Id: LINT,v 1.397 1998/01/30 11:32:34 phk Exp $
62365e64fSRodney W. Grimes#
73aa06999SGarrett Wollman# NB: You probably don't want to try running a kernel built from this
83aa06999SGarrett Wollman# file.  Instead, you should start from GENERIC, and add options from
93aa06999SGarrett Wollman# this file as required.
102365e64fSRodney W. Grimes#
112365e64fSRodney W. Grimes
126a8d6623SGarrett Wollman#
136a8d6623SGarrett Wollman# This directive is mandatory; it defines the architecture to be
1456be1833SKATO Takenori# configured for; in this case, the 386 family based IBM-PC and
1556be1833SKATO Takenori# compatibles.
166a8d6623SGarrett Wollman#
172365e64fSRodney W. Grimesmachine		"i386"
182365e64fSRodney W. Grimes
196a8d6623SGarrett Wollman#
206a8d6623SGarrett Wollman# This is the ``identification'' of the kernel.  Usually this should
216a8d6623SGarrett Wollman# be the same as the name of your kernel.
226a8d6623SGarrett Wollman#
236a8d6623SGarrett Wollmanident		LINT
246a8d6623SGarrett Wollman
256a8d6623SGarrett Wollman#
266a8d6623SGarrett Wollman# The `maxusers' parameter controls the static sizing of a number of
276a8d6623SGarrett Wollman# internal system tables by a complicated formula defined in param.c.
286a8d6623SGarrett Wollman#
296a8d6623SGarrett Wollmanmaxusers	10
306a8d6623SGarrett Wollman
316a8d6623SGarrett Wollman#
32d43f0f0aSJohn Dyson# Certain applications can grow to be larger than the 128M limit
33d43f0f0aSJohn Dyson# that FreeBSD initially imposes.  Below are some options to
34d43f0f0aSJohn Dyson# allow that limit to grow to 256MB, and can be increased further
35d43f0f0aSJohn Dyson# with changing the parameters.  MAXDSIZ is the maximum that the
36d43f0f0aSJohn Dyson# limit can be set to, and the DFLDSIZ is the default value for
37d43f0f0aSJohn Dyson# the limit.  You might want to set the default lower than the
38d43f0f0aSJohn Dyson# max, and explicitly set the maximum with a shell command for processes
39d43f0f0aSJohn Dyson# that regularly exceed the limit like INND.
40d43f0f0aSJohn Dyson#
41392cefd1SBruce Evansoptions		"MAXDSIZ=(256*1024*1024)"
42392cefd1SBruce Evansoptions		"DFLDSIZ=(256*1024*1024)"
43d43f0f0aSJohn Dyson
4425cf9d99SJordan K. Hubbard# When this is set, be extra conservative in various parts of the kernel
4525cf9d99SJordan K. Hubbard# and choose functionality over speed (on the widest variety of systems).
4625cf9d99SJordan K. Hubbardoptions		FAILSAFE
4725cf9d99SJordan K. Hubbard
48827d623eSJordan K. Hubbard# This allows you to actually store this configuration file into
49827d623eSJordan K. Hubbard# the kernel binary itself, where it may be later read by saying:
50827d623eSJordan K. Hubbard#    strings /kernel | grep ^___ | sed -e 's/^___//' > MYKERNEL
51827d623eSJordan K. Hubbard#
52827d623eSJordan K. Hubbardoptions         INCLUDE_CONFIG_FILE     # Include this file in kernel
53827d623eSJordan K. Hubbard
546a8d6623SGarrett Wollman#
556a8d6623SGarrett Wollman# This directive defines a number of things:
566a8d6623SGarrett Wollman#  - The compiled kernel is to be called `kernel'
576a8d6623SGarrett Wollman#  - The root filesystem might be on partition wd0a
58b8e91dabSDavid Greenman#  - Crash dumps will be written to wd0b, if possible.  Specifying the
59b8e91dabSDavid Greenman#    dump device here is not recommended.  Use dumpon(8).
606a8d6623SGarrett Wollman#
61b8e91dabSDavid Greenmanconfig		kernel	root on wd0 dumps on wd0
622365e64fSRodney W. Grimes
636a8d6623SGarrett Wollman
646a8d6623SGarrett Wollman#####################################################################
65477a642cSPeter Wemm# SMP OPTIONS:
66477a642cSPeter Wemm#
67477a642cSPeter Wemm# SMP enables building of a Symmetric MultiProcessor Kernel.
68477a642cSPeter Wemm# APIC_IO enables the use of the IO APIC for Symmetric I/O.
69477a642cSPeter Wemm# NCPU sets the number of CPUs, defaults to 2.
70477a642cSPeter Wemm# NBUS sets the number of busses, defaults to 4.
71477a642cSPeter Wemm# NAPIC sets the number of IO APICs on the motherboard, defaults to 1.
72477a642cSPeter Wemm# NINTR sets the total number of INTs provided by the motherboard.
73477a642cSPeter Wemm#
74477a642cSPeter Wemm# Notes:
75477a642cSPeter Wemm#
76477a642cSPeter Wemm#  An SMP kernel will ONLY run on an Intel MP spec. qualified motherboard.
77477a642cSPeter Wemm#
78477a642cSPeter Wemm#  Be sure to disable 'cpu "I386_CPU"' && 'cpu "I486_CPU"' for SMP kernels.
79477a642cSPeter Wemm#
80477a642cSPeter Wemm#  Check the 'Rogue SMP hardware' section to see if additional options
81477a642cSPeter Wemm#   are required by your hardware.
82477a642cSPeter Wemm#
83477a642cSPeter Wemm
84477a642cSPeter Wemm# Mandatory:
85477a642cSPeter Wemmoptions		SMP			# Symmetric MultiProcessor Kernel
86477a642cSPeter Wemmoptions		APIC_IO			# Symmetric (APIC) I/O
87477a642cSPeter Wemm
8806daa051SBruce Evans# Optional, these are the defaults plus 1:
8925717e99SSteve Passeoptions		NCPU=5			# number of CPUs
9006daa051SBruce Evansoptions		NBUS=5			# number of busses
9106daa051SBruce Evansoptions		NAPIC=2			# number of IO APICs
9206daa051SBruce Evansoptions		NINTR=25		# number of INTs
93477a642cSPeter Wemm
94477a642cSPeter Wemm#
95477a642cSPeter Wemm# Rogue SMP hardware:
96477a642cSPeter Wemm#
97477a642cSPeter Wemm
98477a642cSPeter Wemm# Bridged PCI cards:
99477a642cSPeter Wemm#
100477a642cSPeter Wemm# The MP tables of most of the current generation MP motherboards
101477a642cSPeter Wemm#  do NOT properly support bridged PCI cards.  To use one of these
102477a642cSPeter Wemm#  cards you should refer to ???
103477a642cSPeter Wemm
104477a642cSPeter Wemm
105477a642cSPeter Wemm#####################################################################
10656be1833SKATO Takenori# CPU OPTIONS
10756be1833SKATO Takenori
10856be1833SKATO Takenori#
10956be1833SKATO Takenori# You must specify at least one CPU (the one you intend to run on);
11056be1833SKATO Takenori# deleting the specification for CPUs you don't need to use may make
11156be1833SKATO Takenori# parts of the system run faster.  This is especially true removing
11256be1833SKATO Takenori# I386_CPU.
11356be1833SKATO Takenori#
11456be1833SKATO Takenoricpu		"I386_CPU"
11556be1833SKATO Takenoricpu		"I486_CPU"
11656be1833SKATO Takenoricpu		"I586_CPU"		# aka Pentium(tm)
11756be1833SKATO Takenoricpu		"I686_CPU"		# aka Pentium Pro(tm)
11856be1833SKATO Takenori
11956be1833SKATO Takenori#
12056be1833SKATO Takenori# Options for CPU features.
12156be1833SKATO Takenori#
12256be1833SKATO Takenori# CPU_BLUELIGHTNING_FPU_OP_CACHE enables FPU operand cache on IBM
12356be1833SKATO Takenori# BlueLightning CPU.  It works only with Cyrix FPU, and this option
12456be1833SKATO Takenori# should not be used with Intel FPU.
12556be1833SKATO Takenori#
12656be1833SKATO Takenori# CPU_BLUELIGHTNING_3X enables triple-clock mode on IBM Blue Lightning
12756be1833SKATO Takenori# CPU if CPU supports it. The default is double-clock mode on
12856be1833SKATO Takenori# BlueLightning CPU box.
12956be1833SKATO Takenori#
13056be1833SKATO Takenori# CPU_BTB_EN enables branch target buffer on Cyrix 5x86 (NOTE 1).
13156be1833SKATO Takenori#
1324962d938SKATO Takenori# CPU_DIRECT_MAPPED_CACHE sets L1 cache of Cyrix 486DLC CPU in direct
1334962d938SKATO Takenori# mapped mode.  Default is 2-way set associative mode.
1344962d938SKATO Takenori#
1356593be60SKATO Takenori# CPU_CYRIX_NO_LOCK enables weak locking for the entire address space
1366593be60SKATO Takenori# of Cyrix 6x86 and 6x86MX CPUs.  If this option is not set and
1376593be60SKATO Takenori# FAILESAFE is defined, NO_LOCK bit of CCR1 is cleared.  (NOTE 3)
1386593be60SKATO Takenori#
13956be1833SKATO Takenori# CPU_DISABLE_5X86_LSSER disables load store serialize (i.e. enables
14056be1833SKATO Takenori# reorder).  This option should not be used if you use memory mapped
14156be1833SKATO Takenori# I/O device(s).
14256be1833SKATO Takenori#
14356be1833SKATO Takenori# CPU_FASTER_5X86_FPU enables faster FPU exception handler.
14456be1833SKATO Takenori#
14556be1833SKATO Takenori# CPU_I486_ON_386 enables CPU cache on i486 based CPU upgrade products
14656be1833SKATO Takenori# for i386 machines.
1474962d938SKATO Takenori#
14856be1833SKATO Takenori# CPU_IORT defines I/O clock delay time (NOTE 1).  Default vaules of
14956be1833SKATO Takenori# I/O clock delay time on Cyrix 5x86 and 6x86 are 0 and 7,respectively
15056be1833SKATO Takenori# (no clock delay).
15156be1833SKATO Takenori#
15256be1833SKATO Takenori# CPU_LOOP_EN prevents flushing the prefetch buffer if the destination
15356be1833SKATO Takenori# of a jump is already present in the prefetch buffer on Cyrix 5x86(NOTE
15456be1833SKATO Takenori# 1).
15556be1833SKATO Takenori#
15656be1833SKATO Takenori# CPU_RSTK_EN enables return stack on Cyrix 5x86 (NOTE 1).
15756be1833SKATO Takenori#
15856be1833SKATO Takenori# CPU_SUSP_HLT enables suspend on HALT.  If this option is set, CPU
15956be1833SKATO Takenori# enters suspend mode following execution of HALT instruction.
16056be1833SKATO Takenori#
1616593be60SKATO Takenori# CPU_WT_ALLOC enables write-through allocation.
1626593be60SKATO Takenori#
16356be1833SKATO Takenori# CYRIX_CACHE_WORKS enables CPU cache on Cyrix 486 CPUs with cache
16456be1833SKATO Takenori# flush at hold state.
16556be1833SKATO Takenori#
16656be1833SKATO Takenori# CYRIX_CACHE_REALLY_WORKS enables (1) CPU cache on Cyrix 486 CPUs
16756be1833SKATO Takenori# without cache flush at hold state, and (2) write-back CPU cache on
16856be1833SKATO Takenori# Cyrix 6x86 whose revision < 2.7 (NOTE 2).
16956be1833SKATO Takenori#
170b0050656SJohn-Mark Gurney# NO_F00F_HACK disables the hack that prevents Pentiums (and ONLY
171b0050656SJohn-Mark Gurney# Pentiums) from locking up when a LOCK CMPXCHG8B instruction is
172b0050656SJohn-Mark Gurney# executed.  This should be included for ALL kernels that won't run
173b0050656SJohn-Mark Gurney# on a Pentium.
174b0050656SJohn-Mark Gurney#
17556be1833SKATO Takenori# NOTE 1: The options, CPU_BTB_EN, CPU_LOOP_EN, CPU_IORT,
17656be1833SKATO Takenori# CPU_LOOP_ENand CPU_RSTK_EN should no be used becasue of CPU bugs.
17756be1833SKATO Takenori# These options may crash your system.
17856be1833SKATO Takenori#
17956be1833SKATO Takenori# NOTE 2: If CYRIX_CACHE_REALLY_WORKS is not set, CPU cache is enabled
18056be1833SKATO Takenori# in write-through mode when revision < 2.7.  If revision of Cyrix
18156be1833SKATO Takenori# 6x86 >= 2.7, CPU cache is always enabled in write-back mode.
18256be1833SKATO Takenori#
1836593be60SKATO Takenori# NOTE 3: This option may cause failures for software that requires
1846593be60SKATO Takenori# locked cycles in order to operate correctly.
1856593be60SKATO Takenori#
18656be1833SKATO Takenorioptions		"CPU_BLUELIGHTNING_FPU_OP_CACHE"
18756be1833SKATO Takenorioptions		"CPU_BLUELIGHTNING_3X"
18856be1833SKATO Takenorioptions		"CPU_BTB_EN"
1894962d938SKATO Takenorioptions		"CPU_DIRECT_MAPPED_CACHE"
19056be1833SKATO Takenorioptions		"CPU_DISABLE_5X86_LSSER"
19156be1833SKATO Takenorioptions		"CPU_FASTER_5X86_FPU"
19256be1833SKATO Takenorioptions		"CPU_I486_ON_386"
19356be1833SKATO Takenorioptions		"CPU_IORT"
19456be1833SKATO Takenorioptions		"CPU_LOOP_EN"
19556be1833SKATO Takenorioptions		"CPU_RSTK_EN"
19656be1833SKATO Takenorioptions		"CPU_SUSP_HLT"
19756be1833SKATO Takenorioptions		"CYRIX_CACHE_WORKS"
19856be1833SKATO Takenorioptions		"CYRIX_CACHE_REALLY_WORKS"
199b0050656SJohn-Mark Gurney#options	"NO_F00F_HACK"
20056be1833SKATO Takenori
20156be1833SKATO Takenori#
20256be1833SKATO Takenori# A math emulator is mandatory if you wish to run on hardware which
20356be1833SKATO Takenori# does not have a floating-point processor.  Pick either the original,
20456be1833SKATO Takenori# bogus (but freely-distributable) math emulator, or a much more
20556be1833SKATO Takenori# fully-featured but GPL-licensed emulator taken from Linux.
20656be1833SKATO Takenori#
20756be1833SKATO Takenorioptions		MATH_EMULATE		#Support for x87 emulation
20856be1833SKATO Takenori# Don't enable both of these in a real config.
20956be1833SKATO Takenorioptions		GPL_MATH_EMULATE	#Support for x87 emulation via
21056be1833SKATO Takenori					#new math emulator
21156be1833SKATO Takenori
21256be1833SKATO Takenori
21356be1833SKATO Takenori#####################################################################
2146a8d6623SGarrett Wollman# COMPATIBILITY OPTIONS
215690f540cSAndrey A. Chernov
2166a8d6623SGarrett Wollman#
2176a8d6623SGarrett Wollman# Implement system calls compatible with 4.3BSD and older versions of
21856c7a48cSJordan K. Hubbard# FreeBSD.  You probably do NOT want to remove this as much current code
21956c7a48cSJordan K. Hubbard# still relies on the 4.3 emulation.
2206a8d6623SGarrett Wollman#
2216a8d6623SGarrett Wollmanoptions		"COMPAT_43"
2226a8d6623SGarrett Wollman
2236a8d6623SGarrett Wollman#
2246c5e9bbdSMike Pritchard# Allow user-mode programs to manipulate their local descriptor tables.
2256a8d6623SGarrett Wollman# This option is required for the WINE Windows(tm) emulator, and is
2266a8d6623SGarrett Wollman# not used by anything else (that we know of).
2276a8d6623SGarrett Wollman#
2286a8d6623SGarrett Wollmanoptions		USER_LDT		#allow user-level control of i386 ldt
2296a8d6623SGarrett Wollman
2306a8d6623SGarrett Wollman#
2316a8d6623SGarrett Wollman# These three options provide support for System V Interface
2326a8d6623SGarrett Wollman# Definition-style interprocess communication, in the form of shared
2336a8d6623SGarrett Wollman# memory, semaphores, and message queues, respectively.
2346a8d6623SGarrett Wollman#
2356a8d6623SGarrett Wollmanoptions		SYSVSHM
2366a8d6623SGarrett Wollmanoptions		SYSVSEM
2376a8d6623SGarrett Wollmanoptions		SYSVMSG
2386a8d6623SGarrett Wollman
23994801746SPoul-Henning Kamp#
24094801746SPoul-Henning Kamp# This option includes a MD5 routine in the kernel, this is used for
24194801746SPoul-Henning Kamp# various authentication and privacy uses.
24294801746SPoul-Henning Kamp#
24394801746SPoul-Henning Kampoptions		"MD5"
24494801746SPoul-Henning Kamp
245adeb9a12SJonathan Lemon#
246adeb9a12SJonathan Lemon# Allow processes to switch to vm86 mode, as well as enabling direct
247adeb9a12SJonathan Lemon# user-mode access to the I/O port space.  This option is necessary for
248adeb9a12SJonathan Lemon# the doscmd emulator to run.
249adeb9a12SJonathan Lemon#
250adeb9a12SJonathan Lemonoptions		"VM86"
251adeb9a12SJonathan Lemon
2526a8d6623SGarrett Wollman
2536a8d6623SGarrett Wollman#####################################################################
2546a8d6623SGarrett Wollman# DEBUGGING OPTIONS
2556a8d6623SGarrett Wollman
2566a8d6623SGarrett Wollman#
257b5d89ca8SBruce Evans# Enable the kernel debugger.
2586a8d6623SGarrett Wollman#
259b5d89ca8SBruce Evansoptions		DDB
260b5d89ca8SBruce Evans
261b5d89ca8SBruce Evans#
2625ccab2afSGary Palmer# Don't drop into DDB for a panic. Intended for unattended operation
2635ccab2afSGary Palmer# where you may want to drop to DDB from the console, but still want
2645ccab2afSGary Palmer# the machine to recover from a panic
2655ccab2afSGary Palmer#
2665ccab2afSGary Palmeroptions		DDB_UNATTENDED
2675ccab2afSGary Palmer
2685ccab2afSGary Palmer#
269562d05dfSPaul Traina# If using GDB remote mode to debug the kernel, there's a non-standard
270562d05dfSPaul Traina# extension to the remote protocol that can be used to use the serial
271562d05dfSPaul Traina# port as both the debugging port and the system console.  It's non-
272562d05dfSPaul Traina# standard and you're on your own if you enable it.  See also the
273562d05dfSPaul Traina# "remotechat" variables in the FreeBSD specific version of gdb.
274562d05dfSPaul Traina#
275562d05dfSPaul Trainaoptions		GDB_REMOTE_CHAT
276562d05dfSPaul Traina
277562d05dfSPaul Traina#
2786a8d6623SGarrett Wollman# KTRACE enables the system-call tracing facility ktrace(2).
2796a8d6623SGarrett Wollman#
2802365e64fSRodney W. Grimesoptions		KTRACE			#kernel tracing
28121c64a07SAndrey A. Chernov
2826a8d6623SGarrett Wollman#
2836a8d6623SGarrett Wollman# The DIAGNOSTIC option is used in a number of source files to enable
2846a8d6623SGarrett Wollman# extra sanity checking of internal structures.  This support is not
2856a8d6623SGarrett Wollman# enabled by default because of the extra time it would take to check
2866a8d6623SGarrett Wollman# for these conditions, which can only occur as a result of
2876a8d6623SGarrett Wollman# programming errors.
2886a8d6623SGarrett Wollman#
2890dc7d907SPoul-Henning Kampoptions		DIAGNOSTIC
290da59a31cSDavid Greenman
2910dd1eea1SJordan K. Hubbard#
292348acd94SGarrett Wollman# PERFMON causes the driver for Pentium/Pentium Pro performance counters
293348acd94SGarrett Wollman# to be compiled.  See perfmon(4) for more information.
294348acd94SGarrett Wollman#
295348acd94SGarrett Wollmanoptions		PERFMON
296348acd94SGarrett Wollman
297348acd94SGarrett Wollman# XXX - this doesn't belong here.
2980dd1eea1SJordan K. Hubbard# Allow ordinary users to take the console - this is useful for X.
2990dd1eea1SJordan K. Hubbardoptions		UCONSOLE
3000dd1eea1SJordan K. Hubbard
30196fc6efbSPoul-Henning Kamp# XXX - this doesn't belong here either
30296fc6efbSPoul-Henning Kampoptions		USERCONFIG		#boot -c editor
3038996308bSJordan K. Hubbardoptions		USERCONFIG_BOOT		#imply -c and parse info area
30496fc6efbSPoul-Henning Kampoptions		VISUAL_USERCONFIG	#visual boot -c editor
3056a8d6623SGarrett Wollman
3066a8d6623SGarrett Wollman#####################################################################
3076a8d6623SGarrett Wollman# NETWORKING OPTIONS
30870c0b54cSAndrey A. Chernov
3096a8d6623SGarrett Wollman#
3106a8d6623SGarrett Wollman# Protocol families:
3116a8d6623SGarrett Wollman#  Only the INET (Internet) family is officially supported in FreeBSD.
31211bfa65aSBruce Evans#  Source code for the NS (Xerox Network Service) is provided for amusement
31311bfa65aSBruce Evans#  value.
3146a8d6623SGarrett Wollman#
3156a8d6623SGarrett Wollmanoptions		INET			#Internet communications protocols
316f73bbaf2SDavid Greenman
317cc6a66f2SJulian Elischeroptions		IPX			#IPX/SPX communications protocols
318cc6a66f2SJulian Elischeroptions		IPXIP			#IPX in IP encapsulation (not available)
319cc6a66f2SJulian Elischeroptions		IPTUNNEL		#IP in IPX encapsulation (not available)
320cc6a66f2SJulian Elischer
32134b5fca7SJulian Elischeroptions		NETATALK		#Appletalk communications protocols
32234b5fca7SJulian Elischer
32311bfa65aSBruce Evans# These are currently broken but are shipped due to interest.
32411bfa65aSBruce Evans#options		NS			#Xerox NS protocols
32511bfa65aSBruce Evans
326bba9a7a0SGarrett Wollman# These are currently broken and are no longer shipped due to lack
327bba9a7a0SGarrett Wollman# of interest.
328bba9a7a0SGarrett Wollman#options		CCITT			#X.25 network layer
329f73bbaf2SDavid Greenman#options		ISO
330f73bbaf2SDavid Greenman#options		TPIP			#ISO TP class 4 over IP
331f73bbaf2SDavid Greenman#options		TPCONS			#ISO TP class 0 over X.25
332bba9a7a0SGarrett Wollman#options		LLC			#X.25 link layer for Ethernets
333bba9a7a0SGarrett Wollman#options		HDLC			#X.25 link layer for serial lines
334bba9a7a0SGarrett Wollman#options		EON			#ISO CLNP over IP
335dc915e7cSGarrett Wollman#options		NSIP			#XNS over IP
33663a74862SSteven Wallace
3376a8d6623SGarrett Wollman#
3386a8d6623SGarrett Wollman# Network interfaces:
33956c7a48cSJordan K. Hubbard#  The `loop' pseudo-device is MANDATORY when networking is enabled.
3406a8d6623SGarrett Wollman#  The `ether' pseudo-device provides generic code to handle
34156c7a48cSJordan K. Hubbard#  Ethernets; it is MANDATORY when a Ethernet device driver is
3426a8d6623SGarrett Wollman#  configured.
343d41f24e7SDavid Greenman#  The 'fddi' pseudo-device provides generic code to support FDDI.
34483401efaSGarrett Wollman#  The `sppp' pseudo-device serves a similar role for certain types
345e7c234a1SPeter Wemm#  of synchronous PPP links (like `cx', `ar').
3466a8d6623SGarrett Wollman#  The `sl' pseudo-device implements the Serial Line IP (SLIP) service.
347829b5d55SPeter Wemm#  The `ppp' pseudo-device implements the Point-to-Point Protocol.
348d29895dcSGarrett Wollman#  The `bpfilter' pseudo-device enables the Berkeley Packet Filter.  Be
349d29895dcSGarrett Wollman#  aware of the legal and administrative consequences of enabling this
350d29895dcSGarrett Wollman#  option.  The number of devices determines the maximum number of
351d29895dcSGarrett Wollman#  simultaneous BPF clients programs runnable.
35259d8d13fSGarrett Wollman#  The `disc' pseudo-device implements a minimal network interface,
35359d8d13fSGarrett Wollman#  which throws away all packets sent and never receives any.  It is
35459d8d13fSGarrett Wollman#  included for testing purposes.
355b60d4a5dSAtsushi Murai#  The `tun' pseudo-device implements the User Process PPP (iijppp)
3566a8d6623SGarrett Wollman#
357829b5d55SPeter Wemm# The PPP_BSDCOMP option enables support for compress(1) style entire
358829b5d55SPeter Wemm# packet compression, the PPP_DEFLATE is for zlib/gzip style compression.
359829b5d55SPeter Wemm# PPP_FILTER enables code for filtering the ppp data stream and selecting
360829b5d55SPeter Wemm# events for resetting the demand dial activity timer - requires bpfilter.
361829b5d55SPeter Wemm# See pppd(8) for more details.
36289327d27SPeter Wemm#
3636a8d6623SGarrett Wollmanpseudo-device	ether			#Generic Ethernet
364d41f24e7SDavid Greenmanpseudo-device	fddi			#Generic FDDI
36583401efaSGarrett Wollmanpseudo-device	sppp			#Generic Synchronous PPP
3666a8d6623SGarrett Wollmanpseudo-device	loop			#Network loopback device
367829b5d55SPeter Wemmpseudo-device	bpfilter	4	#Berkeley packet filter
368829b5d55SPeter Wemmpseudo-device	disc			#Discard device
369829b5d55SPeter Wemmpseudo-device	tun	1		#Tunnel driver (user process ppp(8))
3706a8d6623SGarrett Wollmanpseudo-device	sl	2		#Serial Line IP
3716a8d6623SGarrett Wollmanpseudo-device	ppp	2		#Point-to-point protocol
37289327d27SPeter Wemmoptions PPP_BSDCOMP			#PPP BSD-compress support
37389327d27SPeter Wemmoptions PPP_DEFLATE			#PPP zlib/deflate/gzip support
37496be526aSPeter Wemmoptions PPP_FILTER			#enable bpf filtering (needs bpfilter)
375d29895dcSGarrett Wollman
3766a8d6623SGarrett Wollman#
3776a8d6623SGarrett Wollman# Internet family options:
3786a8d6623SGarrett Wollman#
3796a8d6623SGarrett Wollman# TCP_COMPAT_42 causes the TCP code to emulate certain bugs present in
3806a8d6623SGarrett Wollman# 4.2BSD.  This option should not be used unless you have a 4.2BSD
3816a8d6623SGarrett Wollman# machine and TCP connections fail.
3826a8d6623SGarrett Wollman#
3836a8d6623SGarrett Wollman# MROUTING enables the kernel multicast packet forwarder, which works
3846a8d6623SGarrett Wollman# with mrouted(8).
3856a8d6623SGarrett Wollman#
386d29895dcSGarrett Wollman# IPFIREWALL enables support for IP firewall construction, in
387ff6f025aSAlexander Langer# conjunction with the `ipfw' program.  IPFIREWALL_VERBOSE sends
388ff6f025aSAlexander Langer# logged packets to the system logger.  IPFIREWALL_VERBOSE_LIMIT
389ff6f025aSAlexander Langer# limits the number of times a matching entry can be logged.
390ab6e02daSJordan K. Hubbard#
391ab6e02daSJordan K. Hubbard# WARNING:  IPFIREWALL defaults to a policy of "deny ip from any to any"
392ab6e02daSJordan K. Hubbard# and if you do not add other rules during startup to allow access,
393ab6e02daSJordan K. Hubbard# YOU WILL LOCK YOURSELF OUT.  It is suggested that you set firewall=open
394ab6e02daSJordan K. Hubbard# in /etc/rc.conf when first enabling this feature, then refining the
395ab6e02daSJordan K. Hubbard# firewall rules in /etc/rc.firewall after you've tested that the new kernel
396ab6e02daSJordan K. Hubbard# feature works properly.
3978dd4744eSJordan K. Hubbard#
398ffdd472dSPeter Wemm# IPFIREWALL_DEFAULT_TO_ACCEPT causes the default rule (at boot) to
399ffdd472dSPeter Wemm# allow everything.  Use with care, if a cracker can crash your
400ffdd472dSPeter Wemm# firewall machine, they can get to your protected machines.  However,
401ffdd472dSPeter Wemm# if you are using it as an as-needed filter for specific problems as
402ffdd472dSPeter Wemm# they arise, then this may be for you.  Changing the default to 'allow'
403ffdd472dSPeter Wemm# means that you won't get stuck if the kernel and /sbin/ipfw binary get
404ffdd472dSPeter Wemm# out of sync.
405d29895dcSGarrett Wollman#
40693e0e116SJulian Elischer# IPDIVERT enables the divert IP sockets, used by ``ipfw divert''
40793e0e116SJulian Elischer#
40865e8111fSBruce Evans# TCPDEBUG is undocumented.
40965e8111fSBruce Evans#
4106a8d6623SGarrett Wollmanoptions		"TCP_COMPAT_42"		#emulate 4.2BSD TCP bugs
411e3178a06SJordan K. Hubbardoptions		MROUTING		# Multicast routing
412d29895dcSGarrett Wollmanoptions         IPFIREWALL              #firewall
413d29895dcSGarrett Wollmanoptions         IPFIREWALL_VERBOSE      #print information about
414d29895dcSGarrett Wollman					# dropped packets
415ff6f025aSAlexander Langeroptions		"IPFIREWALL_VERBOSE_LIMIT=100" #limit verbosity
416e43a9900SAlexander Langeroptions		IPFIREWALL_DEFAULT_TO_ACCEPT #allow everything by default
41793e0e116SJulian Elischeroptions		IPDIVERT		#divert sockets
41865e8111fSBruce Evansoptions		TCPDEBUG
4196a8d6623SGarrett Wollman
4206a8d6623SGarrett Wollman
4216a8d6623SGarrett Wollman#####################################################################
4226a8d6623SGarrett Wollman# FILESYSTEM OPTIONS
423e3178a06SJordan K. Hubbard
4242365e64fSRodney W. Grimes#
4256a8d6623SGarrett Wollman# Only the root, /usr, and /tmp filesystems need be statically
4266a8d6623SGarrett Wollman# compiled; everything else will be automatically loaded at mount
427c5b193bfSPoul-Henning Kamp# time.  (Exception: the UFS family---FFS, and MFS --- cannot
4286a8d6623SGarrett Wollman# currently be demand-loaded.)  Some people still prefer to statically
4296a8d6623SGarrett Wollman# compile other filesystems as well.
4306a8d6623SGarrett Wollman#
431c5b193bfSPoul-Henning Kamp# NB: The PORTAL, and UNION filesystems are known to be buggy,
4326a8d6623SGarrett Wollman# and WILL panic your system if you attempt to do anything with them.
4336a8d6623SGarrett Wollman# They are included here as an incentive for some enterprising soul to
4346a8d6623SGarrett Wollman# sit down and fix them.
4352365e64fSRodney W. Grimes#
436f1a9c715SDavid Greenman
4376a8d6623SGarrett Wollman# One of these is mandatory:
4386a8d6623SGarrett Wollmanoptions		FFS			#Fast filesystem
4396a8d6623SGarrett Wollmanoptions		NFS			#Network File System
4406a8d6623SGarrett Wollman
4416a8d6623SGarrett Wollman# The rest are optional:
4427c115697SPoul-Henning Kamp# options	NFS_NOSERVER		#Disable the NFS-server code.
443f1a9c715SDavid Greenmanoptions		"CD9660"		#ISO 9660 filesystem
444f1a9c715SDavid Greenmanoptions		FDESC			#File descriptor filesystem
445f1a9c715SDavid Greenmanoptions		KERNFS			#Kernel filesystem
446f1a9c715SDavid Greenmanoptions		MFS			#Memory File System
4473f9a6982SDoug Rabsonoptions		MSDOSFS			#MS DOS File System
448f1a9c715SDavid Greenmanoptions		NULLFS			#NULL filesystem
449f1a9c715SDavid Greenmanoptions		PORTAL			#Portal filesystem
450f1a9c715SDavid Greenmanoptions		PROCFS			#Process filesystem
451f1a9c715SDavid Greenmanoptions		UMAPFS			#UID map filesystem
452f1a9c715SDavid Greenmanoptions		UNION			#Union filesystem
4537b778b5eSEivind Eklundoptions		"CD9660_ROOT"		#CD-ROM usable as root device
4547b778b5eSEivind Eklundoptions		FFS_ROOT		#FFS usable as root device
4557b778b5eSEivind Eklundoptions		NFS_ROOT		#NFS usable as root device
456114a8cffSPeter Wemm# This DEVFS is experimental but seems to work
45746746c3bSJulian Elischeroptions		DEVFS			#devices filesystem
458f1a9c715SDavid Greenman
459d52d7365SPoul-Henning Kamp# Make space in the kernel for a MFS root filesystem.  Define to the number
460d52d7365SPoul-Henning Kamp# of kilobytes to reserve for the filesystem.
461b1529bdaSPeter Wemmoptions		MFS_ROOT=10
462b1529bdaSPeter Wemm# Allow the MFS_ROOT code to load the MFS image from floppy if it is missing.
463b1529bdaSPeter Wemmoptions		MFS_AUTOLOAD
464d52d7365SPoul-Henning Kamp
465a401ebbeSDavid Greenman# Allow this many swap-devices.
466b1529bdaSPeter Wemmoptions		NSWAPDEV=20
467a401ebbeSDavid Greenman
4686a8d6623SGarrett Wollman# Disk quotas are supported when this option is enabled.  If you
4696a8d6623SGarrett Wollman# change the value of this option, you must do a `make clean' in your
4706a8d6623SGarrett Wollman# kernel compile directory in order to get a working kernel.
4716a8d6623SGarrett Wollman#
4722365e64fSRodney W. Grimesoptions		QUOTA			#enable disk quotas
4736a8d6623SGarrett Wollman
47423d048eeSGary Palmer# Add more checking code to various filesystems
47523d048eeSGary Palmer#options		NULLFS_DIAGNOSTIC
47623d048eeSGary Palmer#options		KERNFS_DIAGNOSTIC
47723d048eeSGary Palmer#options		UMAPFS_DIAGNOSTIC
47823d048eeSGary Palmer#options		UNION_DIAGNOSTIC
47923d048eeSGary Palmer
4805a9714deSJoerg Wunsch# In particular multi-session CD-Rs might require a huge amount of
4815a9714deSJoerg Wunsch# time in order to "settle".  If we are about mounting them as the
4825a9714deSJoerg Wunsch# root f/s, we gotta wait a little.
4835a9714deSJoerg Wunsch#
4845a9714deSJoerg Wunsch# The number is supposed to be in seconds.
4855a9714deSJoerg Wunschoptions		"CD9660_ROOTDELAY=20"
4865a9714deSJoerg Wunsch
48723d048eeSGary Palmer# Add some error checking code to the null_bypass routine
488c85cfdb2SDavid E. O'Brien# in the NULL filesystem
48923d048eeSGary Palmer#options		SAFETY
49023d048eeSGary Palmer
4916a8d6623SGarrett Wollman
4926a8d6623SGarrett Wollman#####################################################################
493de6a307eSPeter Dufault# SCSI DEVICES
494de6a307eSPeter Dufault
4956a8d6623SGarrett Wollman# SCSI DEVICE CONFIGURATION
4966a8d6623SGarrett Wollman
4976a8d6623SGarrett Wollman# The SCSI subsystem consists of the `base' SCSI code, a number of
498ebc1a0e2SPeter Dufault# high-level SCSI device `type' drivers, and the low-level host-adapter
4996a8d6623SGarrett Wollman# device drivers.  The host adapters are listed in the ISA and PCI
5006a8d6623SGarrett Wollman# device configuration sections below.
5016a8d6623SGarrett Wollman#
502265368d4SRodney W. Grimes# Beginning with FreeBSD 2.0.5 you can wire down your SCSI devices so
503ebc1a0e2SPeter Dufault# that a given bus, target, and LUN always come on line as the same
504ebc1a0e2SPeter Dufault# device unit.  In earlier versions the unit numbers were assigned
505ebc1a0e2SPeter Dufault# in the order that the devices were probed on the SCSI bus.  This
506ebc1a0e2SPeter Dufault# means that if you removed a disk drive, you may have had to rewrite
507ebc1a0e2SPeter Dufault# your /etc/fstab file, and also that you had to be careful when adding
508ebc1a0e2SPeter Dufault# a new disk as it may have been probed earlier and moved your device
509ebc1a0e2SPeter Dufault# configuration around.
510ebc1a0e2SPeter Dufault
511ebc1a0e2SPeter Dufault# This old behavior is maintained as the default behavior.  The unit
512ebc1a0e2SPeter Dufault# assignment begins with the first non-wired down unit for a device
513ebc1a0e2SPeter Dufault# type.  For example, if you wire a disk as "sd3" then the first
514ebc1a0e2SPeter Dufault# non-wired disk will be assigned sd4.
515ebc1a0e2SPeter Dufault
516ebc1a0e2SPeter Dufault# The syntax for wiring down devices is:
517ebc1a0e2SPeter Dufault
5184fbaf9a7SJustin T. Gibbs# controller	scbus0 at ahc0		# Single bus device
5194fbaf9a7SJustin T. Gibbs# controller	scbus1 at ahc1 bus 0	# Single bus device
5204fbaf9a7SJustin T. Gibbs# controller	scbus3 at ahc2 bus 0	# Twin bus device
5214fbaf9a7SJustin T. Gibbs# controller	scbus2 at ahc2 bus 1	# Twin bus device
522ebc1a0e2SPeter Dufault# disk 		sd0 at scbus0 target 0 unit 0
5234fbaf9a7SJustin T. Gibbs# disk		sd1 at scbus3 target 1
5244fbaf9a7SJustin T. Gibbs# disk		sd2 at scbus2 target 3
5254fbaf9a7SJustin T. Gibbs# tape		st1 at scbus1 target 6
526ebc1a0e2SPeter Dufault# device	cd0 at scbus?
527ebc1a0e2SPeter Dufault
528ebc1a0e2SPeter Dufault# "units" (SCSI logical unit number) that are not specified are
529ebc1a0e2SPeter Dufault# treated as if specified as LUN 0.
530ebc1a0e2SPeter Dufault
531ebc1a0e2SPeter Dufault# All SCSI devices allocate as many units as are required.
532ebc1a0e2SPeter Dufault
533265368d4SRodney W. Grimes# The "unknown" device (uk? in pre-2.0.5) is now part of the base SCSI
534ebc1a0e2SPeter Dufault# configuration and doesn't have to be explicitly configured.
535ebc1a0e2SPeter Dufault
5366a8d6623SGarrett Wollmancontroller	scbus0	#base SCSI code
5376a8d6623SGarrett Wollmandevice		ch0	#SCSI media changers
5386a8d6623SGarrett Wollmandevice		sd0	#SCSI disks
5396a8d6623SGarrett Wollmandevice		st0	#SCSI tapes
5406a8d6623SGarrett Wollmandevice		cd0	#SCSI CD-ROMs
54149bdb5b8SJoerg Wunschdevice		od0	#SCSI optical disk
5426a8d6623SGarrett Wollman
543265368d4SRodney W. Grimes# The previous devices (ch, sd, st, cd) are recognized by config.
544265368d4SRodney W. Grimes# config doesn't (and shouldn't) know about these newer ones,
545265368d4SRodney W. Grimes# so we have to specify that they are on a SCSI bus with the "at scbus?"
546265368d4SRodney W. Grimes# clause.
547265368d4SRodney W. Grimes
5488909a72bSPeter Dufaultdevice worm0 at scbus?	# SCSI worm
5498909a72bSPeter Dufaultdevice pt0 at scbus?	# SCSI processor type
5508909a72bSPeter Dufaultdevice sctarg0 at scbus? # SCSI target
5518909a72bSPeter Dufault
5521a7c583cSGarrett Wollman# SCSI OPTIONS:
5531a7c583cSGarrett Wollman
5541a7c583cSGarrett Wollman# SCSIDEBUG: When defined enables debugging macros
5551a7c583cSGarrett Wollman# NO_SCSI_SENSE: When defined disables sense descriptions (about 4k)
5561a7c583cSGarrett Wollman# SCSI_REPORT_GEOMETRY: Always report disk geometry at boot up instead
557265368d4SRodney W. Grimes#                       of only when booting verbosely.
5581a7c583cSGarrett Wollmanoptions		SCSIDEBUG
5591a7c583cSGarrett Wollman#options	NO_SCSI_SENSE
5601a7c583cSGarrett Wollmanoptions		SCSI_REPORT_GEOMETRY
5611a7c583cSGarrett Wollman
56293063432SJoerg Wunsch# Options for the `od' optical disk driver:
56393063432SJoerg Wunsch#
56493063432SJoerg Wunsch# If drive returns sense key as 0x02 with vendor specific additional
56593063432SJoerg Wunsch# sense code (ASC) and additional sense code qualifier (ASCQ), or
56693063432SJoerg Wunsch# illegal ASC and ASCQ. This cause an error (NOT READY) and retrying.
56793063432SJoerg Wunsch# To suppress this, use the following option.
56893063432SJoerg Wunsch#
56993063432SJoerg Wunschoptions		OD_BOGUS_NOT_READY
57093063432SJoerg Wunsch#
57135846a81SMike Pritchard# For an automatic spindown, try this.  Again, preferably as an
57293063432SJoerg Wunsch# option in your config file.
57393063432SJoerg Wunsch# WARNING!  Use at your own risk.  Joerg's ancient SONY SMO drive
57493063432SJoerg Wunsch# groks it fine, while Shunsuke's Fujitsu chokes on it and times
57593063432SJoerg Wunsch# out.
57693063432SJoerg Wunsch#
57793063432SJoerg Wunschoptions		OD_AUTO_TURNOFF
57893063432SJoerg Wunsch
57993063432SJoerg Wunsch
5806a8d6623SGarrett Wollman
5816a8d6623SGarrett Wollman#####################################################################
5826a8d6623SGarrett Wollman# MISCELLANEOUS DEVICES AND OPTIONS
5836a8d6623SGarrett Wollman
5841160da92SJoerg Wunsch# The `pty' device usually turns out to be ``effectively mandatory'',
5851160da92SJoerg Wunsch# as it is required for `telnetd', `rlogind', `screen', `emacs', and
5861160da92SJoerg Wunsch# `xterm', among others.
5871160da92SJoerg Wunsch
5882aba17b3SGary Palmerpseudo-device	pty	16	#Pseudo ttys - can go as high as 256
5896a8d6623SGarrett Wollmanpseudo-device	speaker		#Play IBM BASIC-style noises out your speaker
5906a8d6623SGarrett Wollmanpseudo-device	gzip		#Exec gzipped a.out's
591784cf072SPoul-Henning Kamppseudo-device	vn		#Vnode driver (turns a file into a device)
5924cba4555SUgen J.S. Antsilevichpseudo-device	snp	3	#Snoop device - to look at pty/vty/etc..
59303b225a3SSatoshi Asamipseudo-device	ccd	4	#Concatenated disk driver
5949ba0e7c3SBruce Evans
59565e8111fSBruce Evans# These are only for watching for bitrot in old tty code.
59665e8111fSBruce Evans# broken
59765e8111fSBruce Evans#pseudo-device	tb
59865e8111fSBruce Evans
59965e8111fSBruce Evans# These are only for watching for bitrot in old SCSI code.
60065e8111fSBruce Evanspseudo-device	su		#scsi user
60165e8111fSBruce Evanspseudo-device	ssc		#super scsi
60265e8111fSBruce Evans
6036a8d6623SGarrett Wollman
6046a8d6623SGarrett Wollman#####################################################################
6056a8d6623SGarrett Wollman# HARDWARE DEVICE CONFIGURATION
6066a8d6623SGarrett Wollman
6076a8d6623SGarrett Wollman# ISA and EISA devices:
608c37ddbb8SJoerg Wunsch# EISA support is available for some device, so they can be auto-probed.
6096a8d6623SGarrett Wollman# Micro Channel is not supported at all.
6106a8d6623SGarrett Wollman
6116a8d6623SGarrett Wollman#
612343b84b4SJoerg Wunsch# Mandatory ISA devices: isa, npx
6136a8d6623SGarrett Wollman#
6142365e64fSRodney W. Grimescontroller	isa0
6152365e64fSRodney W. Grimes
6166a8d6623SGarrett Wollman#
6176a8d6623SGarrett Wollman# Options for `isa':
6186a8d6623SGarrett Wollman#
619d72ee36fSBruce Evans# AUTO_EOI_1 enables the `automatic EOI' feature for the master 8259A
620d72ee36fSBruce Evans# interrupt controller.  This saves about 0.7-1.25 usec for each interrupt.
621d72ee36fSBruce Evans# This option breaks suspend/resume on some portables.
622d72ee36fSBruce Evans#
6239ba0e7c3SBruce Evans# AUTO_EOI_2 enables the `automatic EOI' feature for the slave 8259A
624d72ee36fSBruce Evans# interrupt controller.  This saves about 0.7-1.25 usec for each interrupt.
6259ba0e7c3SBruce Evans# Automatic EOI is documented not to work for for the slave with the
6269ba0e7c3SBruce Evans# original i8259A, but it works for some clones and some integrated
6279ba0e7c3SBruce Evans# versions.
6289ba0e7c3SBruce Evans#
6296a8d6623SGarrett Wollman# BOUNCE_BUFFERS provides support for ISA DMA on machines with more
6306a8d6623SGarrett Wollman# than 16 megabytes of memory.  It doesn't hurt on other machines.
6316a8d6623SGarrett Wollman# Some broken EISA and VLB hardware may need this, too.
6323339606dSAndreas Schulz#
633b2796687SNate Williams# MAXMEM specifies the amount of RAM on the machine; if this is not
6349bc192deSDavid E. O'Brien# specified, FreeBSD will first read the amount of memory from the CMOS
6359bc192deSDavid E. O'Brien# RAM, so the amount of memory will initially be limited to 64MB or 16MB
6369bc192deSDavid E. O'Brien# depending on the BIOS.  If the BIOS reports 64MB, a memory probe will
6379bc192deSDavid E. O'Brien# then attempt to detect the installed amount of RAM.  If this probe
6389bc192deSDavid E. O'Brien# fails to detect >64MB RAM you will have to use the MAXMEM option.
6399bc192deSDavid E. O'Brien# The amount is in kilobytes, so for a machine with 128MB of RAM, it would
6409bc192deSDavid E. O'Brien# be 131072 (128 * 1024).
641b2796687SNate Williams#
6423339606dSAndreas Schulz# TUNE_1542 enables the automatic ISA bus speed selection for the
6433339606dSAndreas Schulz# Adaptec 1542 boards. Does not work for all boards, use it with caution.
6443339606dSAndreas Schulz#
6455eb46edfSDavid Greenman# BROKEN_KEYBOARD_RESET disables the use of the keyboard controller to
6465eb46edfSDavid Greenman# reset the CPU for reboot.  This is needed on some systems with broken
6475eb46edfSDavid Greenman# keyboard controllers.
6483eafdedeSBruce Evans#
64977959e8eSMarc G. Fournier# PAS_JOYSTICK_ENABLE enables the gameport on the ProAudio Spectrum
65077959e8eSMarc G. Fournier
651d72ee36fSBruce Evansoptions		"AUTO_EOI_1"
6529ba0e7c3SBruce Evans#options	"AUTO_EOI_2"
6536a8d6623SGarrett Wollmanoptions		BOUNCE_BUFFERS
654a675c0c6SBruce Evansoptions		"MAXMEM=(128*1024)"
655b6b8f81eSAndrey A. Chernov#options        "TUNE_1542"
656b1529bdaSPeter Wemm#options	BROKEN_KEYBOARD_RESET
65777959e8eSMarc G. Fournier#options	PAS_JOYSTICK_ENABLE
6583af6b652SDavid Greenman
659595f6341SPoul-Henning Kamp# Enable support for the kernel PLL to use an external PPS signal,
660595f6341SPoul-Henning Kamp# under supervision of [x]ntpd(8)
661595f6341SPoul-Henning Kamp# More info in ftp://ftp.udel.edu/pub/ntp/kernel.tar.Z
662595f6341SPoul-Henning Kamp
663595f6341SPoul-Henning Kampoptions		PPS_SYNC
664595f6341SPoul-Henning Kamp
66553a7a570SJohn-Mark Gurney# Enable PnP support in the kernel.  This allows you to automaticly
66653a7a570SJohn-Mark Gurney# attach to PnP cards for drivers that support it and allows you to
66753a7a570SJohn-Mark Gurney# configure cards from USERCONFIG.  See pnp(4) for more info.
66853a7a570SJohn-Mark Gurneycontroller	pnp0
66953a7a570SJohn-Mark Gurney
6704530be52SJordan K. Hubbard# Enable this and PCVT_FREEBSD for pcvt vt220 compatible console driver
6717fbcd76bSBruce Evansdevice		vt0	at isa? port "IO_KBD" tty irq 1 vector pcrint
672818de095SJordan K. Hubbardoptions		XSERVER			# support for running an X server.
6737fbcd76bSBruce Evansoptions		FAT_CURSOR		# start with block cursor
674e9aaac99SNate Williams# This PCVT option is for keyboards such as those used on IBM ThinkPad laptops
675b1529bdaSPeter Wemmoptions		PCVT_SCANSET=2 		# IBM keyboards are non-std
6764530be52SJordan K. Hubbard
6774530be52SJordan K. Hubbard# The syscons console driver (sco color console compatible) - default.
6786a8d6623SGarrett Wollmandevice		sc0	at isa? port "IO_KBD" tty irq 1 vector scintr
679683cbdf4SBruce Evansoptions		MAXCONS=16		# number of virtual consoles
680683cbdf4SBruce Evansoptions		SLOW_VGA		# do byte-wide i/o's to TS and GDC regs
68138d8a113SPoul-Henning Kampoptions		"STD8X16FONT"		# Compile font in
68238d8a113SPoul-Henning Kampmakeoptions	"STD8X16FONT"="cp850"
683297976f7SKazutaka YOKOTAoptions		SC_HISTORY_SIZE=200	# number of history buffer lines
6846620cf78SNate Williams
6856620cf78SNate Williams#
6866620cf78SNate Williams# `flags' for sc0:
6876620cf78SNate Williams#       0x01    Use a 'visual' bell
6886620cf78SNate Williams#       0x02    Use a 'blink' cursor
6895d3b1465SKazutaka YOKOTA#       0x04    Use a 'underline' cursor
6905d3b1465SKazutaka YOKOTA#       0x06    Use a 'blinking underline' (destructive) cursor
6916620cf78SNate Williams#       0x08    Force detection of keyboard, else we always assume a keyboard
6926620cf78SNate Williams#       0x10    Old-style (XT) keyboard support, useful for older ThinkPads
6935d3b1465SKazutaka YOKOTA#       0x20    Don't reset keyboard, useful for some newer ThinkPads
6942ac8be82SAndreas Schulz
6956a8d6623SGarrett Wollman#
69625292acbSBruce Evans# The Numeric Processing eXtension driver.  This should be configured if
69725292acbSBruce Evans# your machine has a math co-processor, unless the coprocessor is very
69825292acbSBruce Evans# buggy. If it is not configured then you *must* configure math emulation
69925292acbSBruce Evans# (see above).  If both npx0 and emulation are configured, then only npx0
70025292acbSBruce Evans# is used (provided it works).
7011fe04850SBruce Evansdevice		npx0	at isa? port "IO_NPX" iosiz 0x0 flags 0x0 irq 13 vector npxintr
7021fe04850SBruce Evans
70398e9e66cSNate Williams#
7041fe04850SBruce Evans# `flags' for npx0:
7051fe04850SBruce Evans#	0x01	don't use the npx registers to optimize bcopy
7061fe04850SBruce Evans#	0x02	don't use the npx registers to optimize bzero
7071fe04850SBruce Evans#	0x04	don't use the npx registers to optimize copyin or copyout.
7081fe04850SBruce Evans# The npx registers are normally used to optimize copying and zeroing when
7091fe04850SBruce Evans# all of the following conditions are satisfied:
7101fe04850SBruce Evans#	"I586_CPU" is an option
7111fe04850SBruce Evans#	the cpu is an i586 (perhaps not a Pentium)
7121fe04850SBruce Evans#	the probe for npx0 succeeds
7131fe04850SBruce Evans#	INT 16 exception handling works.
7141fe04850SBruce Evans# Then copying and zeroing using the npx registers is normally 30-100% faster.
7151fe04850SBruce Evans# The flags can be used to control cases where it doesn't work or is slower.
7161fe04850SBruce Evans# Setting them at boot time using userconfig works right (the optimizations
7171fe04850SBruce Evans# are not used until later in the bootstrap when npx0 is attached).
7181fe04850SBruce Evans#
7191fe04850SBruce Evans
7201fe04850SBruce Evans#
7211fe04850SBruce Evans# `iosiz' for npx0:
7221fe04850SBruce Evans# This can be used instead of the MAXMEM option to set the memory size.  If
7231fe04850SBruce Evans# it is nonzero, then it overrides both the MAXMEM option and the memory
7241fe04850SBruce Evans# size reported by the BIOS.  Setting it at boot time using userconfig takes
7251fe04850SBruce Evans# effect on the next reboot after the change has been recorded in the kernel
7261fe04850SBruce Evans# binary (the size is used early in the boot before userconfig has a chance
7271fe04850SBruce Evans# to change it).
7281fe04850SBruce Evans#
7296a8d6623SGarrett Wollman
7306a8d6623SGarrett Wollman#
7316a8d6623SGarrett Wollman# Optional ISA and EISA devices:
7326a8d6623SGarrett Wollman#
7336a8d6623SGarrett Wollman
7346a8d6623SGarrett Wollman#
735e56e7036SJustin T. Gibbs# SCSI host adapters: `aha', `aic', `bt', `nca'
7366a8d6623SGarrett Wollman#
7376a8d6623SGarrett Wollman# aha: Adaptec 154x
7389829c3edSJordan K. Hubbard# ahc: Adaptec 274x/284x/294x
7396a8d6623SGarrett Wollman# aic: Adaptec 152x and sound cards using the Adaptec AIC-6360 (slow!)
7406a8d6623SGarrett Wollman# bt: Most Buslogic controllers
741e05407d8SPoul-Henning Kamp# nca: ProAudioSpectrum cards using the NCR 5380 or Trantor T130
7426a8d6623SGarrett Wollman# uha: UltraStore 14F and 34F
7433c43212aSSøren Schmidt# sea: Seagate ST01/02 8 bit controller (slow!)
7443691d2b9SJordan K. Hubbard# wds: Western Digital WD7000 controller (no scatter/gather!).
7456a8d6623SGarrett Wollman#
7466a8d6623SGarrett Wollman# Note that the order is important in order for Buslogic cards to be
7476a8d6623SGarrett Wollman# probed correctly.
7486a8d6623SGarrett Wollman#
7496a8d6623SGarrett Wollman
750a1d01dafSJustin T. Gibbscontroller	bt0	at isa? port "IO_BT0" bio irq ? vector bt_isa_intr
7516a8d6623SGarrett Wollmancontroller	aha0	at isa? port "IO_AHA0" bio irq ? drq 5 vector ahaintr
7526a8d6623SGarrett Wollmancontroller	uha0	at isa? port "IO_UHA0" bio irq ? drq 5 vector uhaintr
7536a8d6623SGarrett Wollman
7546a8d6623SGarrett Wollmancontroller      aic0    at isa? port 0x340 bio irq 11 vector aicintr
755e05407d8SPoul-Henning Kampcontroller	nca0	at isa? port 0x1f88 bio irq 10 vector ncaintr
756e05407d8SPoul-Henning Kampcontroller	nca1	at isa? port 0x1f84
757e05407d8SPoul-Henning Kampcontroller	nca2	at isa? port 0x1f8c
758e05407d8SPoul-Henning Kampcontroller	nca3	at isa? port 0x1e88
759e05407d8SPoul-Henning Kampcontroller	nca4	at isa? port 0x350 bio irq 5 vector ncaintr
76045b4c36fSJordan K. Hubbard
7613c43212aSSøren Schmidtcontroller	sea0	at isa? bio irq 5 iomem 0xdc000 iosiz 0x2000 vector seaintr
7623691d2b9SJordan K. Hubbardcontroller	wds0	at isa? port 0x350 bio irq 15 drq 6 vector wdsintr
7633c43212aSSøren Schmidt
7646a8d6623SGarrett Wollman#
7656a8d6623SGarrett Wollman# ST-506, ESDI, and IDE hard disks: `wdc' and `wd'
7666a8d6623SGarrett Wollman#
767e3dd3158SJohn Dyson# The flags fields are used to enable the multi-sector I/O and
768e3dd3158SJohn Dyson# the 32BIT I/O modes.  The flags may be used in either the controller
769e3dd3158SJohn Dyson# definition or in the individual disk definitions.  The controller
770e3dd3158SJohn Dyson# definition is supported for the boot configuration stuff.
771e3dd3158SJohn Dyson#
772e3dd3158SJohn Dyson# Each drive has a 16 bit flags value defined:
773e3dd3158SJohn Dyson#	The low 8 bits are the maximum value for the multi-sector I/O,
774e3dd3158SJohn Dyson#	where 0xff defaults to the maximum that the drive can handle.
775e3dd3158SJohn Dyson#	The high bit of the 16 bit flags (0x8000) allows probing for
7761f7727a9SSøren Schmidt#	32 bit transfers.  Bit 14 (0x4000) enables a hack to wake
7771f7727a9SSøren Schmidt#	up powered-down laptop drives.  Bit 13 (0x2000) allows
7781f7727a9SSøren Schmidt#	probing for PCI IDE DMA controllers, such as Intel's PIIX
7791f7727a9SSøren Schmidt#	south bridges.  See the wd.4 man page.
780e3dd3158SJohn Dyson#
781e3dd3158SJohn Dyson# The flags field for the drives can be specified in the controller
782e3dd3158SJohn Dyson# specification with the low 16 bits for drive 0, and the high 16 bits
783e3dd3158SJohn Dyson# for drive 1.
784e3dd3158SJohn Dyson# e.g.:
785e3dd3158SJohn Dyson#controller	wdc0	at isa? port "IO_WD1" bio irq 14 flags 0x00ff8004 vector wdintr
786e3dd3158SJohn Dyson#
787e3dd3158SJohn Dyson# specifies that drive 0 will be allowed to probe for 32 bit transfers and
788e3dd3158SJohn Dyson# a maximum multi-sector transfer of 4 sectors, and drive 1 will not be
789e3dd3158SJohn Dyson# allowed to probe for 32 bit transfers, but will allow multi-sector
790e3dd3158SJohn Dyson# transfers up to the maximum that the drive supports.
791e3dd3158SJohn Dyson#
792e871e61fSJohn Dyson# If you are using a PCI controller that is not running in compatibility
793e871e61fSJohn Dyson# mode (for example, it is a 2nd IDE PCI interface), then use config line(s)
794e871e61fSJohn Dyson# such as:
795e3dd3158SJohn Dyson#
796e871e61fSJohn Dyson#controller	wdc2	at isa? port "0" bio irq ? flags 0xa0ffa0ff vector wdintr
797e871e61fSJohn Dyson#disk		wd4	at wdc2 drive 0
798e871e61fSJohn Dyson#disk		wd5	at wdc2 drive 1
799e871e61fSJohn Dyson#
800e871e61fSJohn Dyson#controller	wdc3	at isa? port "0" bio irq ? flags 0xa0ffa0ff vector wdintr
801e871e61fSJohn Dyson#disk		wd6	at wdc3 drive 0
802e871e61fSJohn Dyson#disk		wd7	at wdc3 drive 1
803e871e61fSJohn Dyson#
804e871e61fSJohn Dyson# Note that the above config would be useful for a Promise card, when used
805e871e61fSJohn Dyson# on a MB that already has a PIIX controller.  Note the bogus irq and port
806e871e61fSJohn Dyson# entries.  These are automatically filled in by the IDE/PCI support.
807e871e61fSJohn Dyson#
808e871e61fSJohn Dyson
8092620c42eSNate Williamscontroller	wdc0	at isa? port "IO_WD1" bio irq 14 vector wdintr
8102620c42eSNate Williamsdisk		wd0	at wdc0 drive 0
8112620c42eSNate Williamsdisk		wd1	at wdc0 drive 1
8122620c42eSNate Williamscontroller	wdc1	at isa? port "IO_WD2" bio irq 15 vector wdintr
8132620c42eSNate Williamsdisk		wd2	at wdc1 drive 0
8142620c42eSNate Williamsdisk		wd3	at wdc1 drive 1
8152365e64fSRodney W. Grimes
8166a8d6623SGarrett Wollman#
8176788ce49SJordan K. Hubbard# Options for `wdc':
8186788ce49SJordan K. Hubbard#
8192928e6b5SStefan Eßer# CMD640 enables serializing access to primary and secondary channel
8202928e6b5SStefan Eßer# of the CMD640B IDE Chip. The serializing will only take place
8212928e6b5SStefan Eßer# if this option is set *and* the chip is probed by the pci-system.
8222928e6b5SStefan Eßer#
8232928e6b5SStefan Eßeroptions         "CMD640"	#Enable work around for CMD640 h/w bug
8242928e6b5SStefan Eßer#
8256788ce49SJordan K. Hubbard# ATAPI enables the support for ATAPI-compatible IDE devices
8266788ce49SJordan K. Hubbard#
8276788ce49SJordan K. Hubbardoptions         ATAPI   #Enable ATAPI support for IDE bus
8287b2305f7SAndrey A. Chernovoptions		ATAPI_STATIC	#Don't do it as an LKM
8296788ce49SJordan K. Hubbard
8306788ce49SJordan K. Hubbard# IDE CD-ROM driver - requires wdc controller and ATAPI option
8316788ce49SJordan K. Hubbarddevice          wcd0
8326788ce49SJordan K. Hubbard
833aaf86206SPaul Traina# IDE floppy driver - requires wdc controller and ATAPI option
834aaf86206SPaul Trainadevice          wfd0
835aaf86206SPaul Traina
836aaf86206SPaul Traina
8376788ce49SJordan K. Hubbard#
8386a8d6623SGarrett Wollman# Standard floppy disk controllers and floppy tapes: `fdc', `fd', and `ft'
8396a8d6623SGarrett Wollman#
8406a8d6623SGarrett Wollmancontroller	fdc0	at isa? port "IO_FD1" bio irq 6 drq 2 vector fdintr
84185827d9cSJoerg Wunsch#
842d2fb4892SJoerg Wunsch# FDC_DEBUG enables floppy debugging.  Since the debug output is huge, you
843d2fb4892SJoerg Wunsch# gotta turn it actually on by setting the variable fd_debug with DDB,
844d2fb4892SJoerg Wunsch# however.
845d2fb4892SJoerg Wunschoptions		FDC_DEBUG
846d2fb4892SJoerg Wunsch# This option is undocumented on purpose.
847d2fb4892SJoerg Wunschoptions		FDC_PRINT_BOGUS_CHIPTYPE
848d2fb4892SJoerg Wunsch#
84985827d9cSJoerg Wunsch# Activate this line instead of the fdc0 line above if you happen to
85085827d9cSJoerg Wunsch# have an Insight floppy tape.  Probing them proved to be dangerous
85185827d9cSJoerg Wunsch# for people with floppy disks only, so it's "hidden" behind a flag:
85285827d9cSJoerg Wunsch#controller fdc0 at isa? port "IO_FD1" bio flags 1 irq 6 drq 2 vector fdintr
85385827d9cSJoerg Wunsch
8546a8d6623SGarrett Wollmandisk		fd0	at fdc0 drive 0
8556a8d6623SGarrett Wollmandisk		fd1	at fdc0 drive 1
8566a8d6623SGarrett Wollmantape		ft0	at fdc0 drive 2
8576a8d6623SGarrett Wollman
85885827d9cSJoerg Wunsch
8596a8d6623SGarrett Wollman#
8602f6df264SJordan K. Hubbard# Other standard PC hardware: `lpt', `mse', `psm', `sio', etc.
8616a8d6623SGarrett Wollman#
8626a8d6623SGarrett Wollman# lpt: printer port
8637fe369dcSJoerg Wunsch#	lpt specials:
8647fe369dcSJoerg Wunsch#		port can be specified as ?, this will cause the driver to scan
8657fe369dcSJoerg Wunsch#		the BIOS port list;
8667fe369dcSJoerg Wunsch#		the irq and vector clauses may be omitted, this
8677fe369dcSJoerg Wunsch#		will force the port into polling mode.
8686a8d6623SGarrett Wollman# mse: Logitech and ATI InPort bus mouse ports
8699cc34748SJordan K. Hubbard# psm: PS/2 mouse port [note: conflicts with sc0/vt0, thus "conflicts" keywd]
8706a8d6623SGarrett Wollman# sio: serial ports (see sio(4))
8716a8d6623SGarrett Wollman
8727fe369dcSJoerg Wunschdevice		lpt0	at isa? port? tty irq 7 vector lptintr
8737fe369dcSJoerg Wunschdevice		lpt1	at isa? port "IO_LPT3" tty irq 5 vector lptintr
8746a8d6623SGarrett Wollmandevice		mse0	at isa? port 0x23c tty irq 5 vector mseintr
8759cc34748SJordan K. Hubbarddevice		psm0	at isa? port "IO_KBD" conflicts tty irq 12 vector psmintr
8763e176bdfSKazutaka YOKOTA
8773e176bdfSKazutaka YOKOTA#
8783e176bdfSKazutaka YOKOTA# `flags' for psm:
8793e176bdfSKazutaka YOKOTA#	0x000R	set resolution to R (1..4). Some MouseSystems PS/2 mice
8803e176bdfSKazutaka YOKOTA#		require this value to be 4.
8813e176bdfSKazutaka YOKOTA#	0x00N0	set accelaration factor to N (1..15).
8823e176bdfSKazutaka YOKOTA#	0x0100	disable synchronization check. This replaces the option
8833e176bdfSKazutaka YOKOTA#		PSM_CHECKSYNC in previous versions.
8843e176bdfSKazutaka YOKOTA#
8853e176bdfSKazutaka YOKOTA
886975c53c7SDoug Rabson# Options for psm:
8875d3b1465SKazutaka YOKOTAoptions		PSM_HOOKAPM		#hook the APM resume event, useful
8885d3b1465SKazutaka YOKOTA					#for some laptops
8895d3b1465SKazutaka YOKOTAoptions		PSM_RESETAFTERSUSPEND	#reset the device at the resume event
890975c53c7SDoug Rabson
8919546766aSBruce Evansdevice		sio0	at isa? port "IO_COM1" tty flags 0x10 irq 4 vector siointr
8929546766aSBruce Evans
8939546766aSBruce Evans#
8949546766aSBruce Evans# `flags' for serial drivers that support consoles (only for sio now):
8959546766aSBruce Evans#	0x10	enable console support for this unit.  The other console flags
8969546766aSBruce Evans#		are ignored unless this is set.  Enabling console support does
8979546766aSBruce Evans#		not make the unit the preferred console - boot with -h or set
8989546766aSBruce Evans#		the 0x20 flag for that.  Currently, at most one unit can have
8999546766aSBruce Evans#		console support; the first one (in config file order) with
9009546766aSBruce Evans#		this flag set is preferred.  Setting this flag for sio0 gives
9019546766aSBruce Evans#		the old behaviour.
9029546766aSBruce Evans#	0x20	force this unit to be the console (unless there is another
9039546766aSBruce Evans#		higher priority console).  This replaces the COMCONSOLE option.
9049546766aSBruce Evans#	0x40	reserve this unit for low level console operations.  Do not
9059546766aSBruce Evans#
9066a796ce0SJohn-Mark Gurney# PnP `flags' (set via userconfig using pnp x flags y)
9076a796ce0SJohn-Mark Gurney#	0x1	disable probing of this device.  Used to prevent your modem
9086a796ce0SJohn-Mark Gurney#		from being attached as a PnP modem.
9096a796ce0SJohn-Mark Gurney#
9109546766aSBruce Evans
9119546766aSBruce Evans# Options for serial drivers that support consoles (only for sio now):
9129546766aSBruce Evansoptions		BREAK_TO_DEBUGGER	#a BREAK on a comconsole goes to
9139546766aSBruce Evans					#DDB, if available.
9145ea6cb03SPaul Trainaoptions		CONSPEED=9600		#default speed for serial console (default 9600)
9156a8d6623SGarrett Wollman
9166a8d6623SGarrett Wollman# Options for sio:
917768fd661SBruce Evansoptions		COM_ESP			#code for Hayes ESP
9189ba0e7c3SBruce Evansoptions		COM_MULTIPORT		#code for some cards with shared IRQs
9196a8d6623SGarrett Wollmanoptions		DSI_SOFT_MODEM		#code for DSI Softmodems
9206a796ce0SJohn-Mark Gurneyoptions		"EXTRA_SIO=2"		#number of extra sio ports to allocate
9216a8d6623SGarrett Wollman
92296b89afcSBruce Evans# Other flags for sio that aren't documented in the man page.
92396b89afcSBruce Evans#	0x20000	enable hardware RTS/CTS and larger FIFOs.  Only works for
92496b89afcSBruce Evans#		ST16650A-compatible UARTs.
92596b89afcSBruce Evans
9266a8d6623SGarrett Wollman#
92783401efaSGarrett Wollman# Network interfaces: `cx', `ed', `el', `ep', `ie', `is', `le', `lnc'
9286a8d6623SGarrett Wollman#
9296c5e9bbdSMike Pritchard# ar: Arnet SYNC/570i hdlc sync 2/4 port V.35/X.21 serial driver (requires sppp)
93083401efaSGarrett Wollman# cx: Cronyx/Sigma multiport sync/async (with Cisco or PPP framing)
9316a8d6623SGarrett Wollman# ed: Western Digital and SMC 80xx; Novell NE1000 and NE2000; 3Com 3C503
9326a8d6623SGarrett Wollman# el: 3Com 3C501 (slow!)
9336a8d6623SGarrett Wollman# ep: 3Com 3C509 (buggy)
9341a7c583cSGarrett Wollman# fe: Fujitsu MB86960A/MB86965A Ethernet
9350f1d6a82SSteve Price# ie: AT&T StarLAN 10 and EN100; 3Com 3C507; unknown NI5210; Intel EtherExpress
9366a8d6623SGarrett Wollman# le: Digital Equipment EtherWorks 2 and EtherWorks 3 (DEPCA, DE100,
9376a8d6623SGarrett Wollman#     DE101, DE200, DE201, DE202, DE203, DE204, DE205, DE422)
93894187a78SPaul Richards# lnc: Lance/PCnet cards (Isolan, Novell NE2100, NE32-VL)
939d805b866SJohn Hay# sr: RISCom/N2 hdlc sync 1/2 port V.35/X.21 serial driver (requires sppp)
94098d46ad0SMike Smith# wl: Lucent Wavelan (ISA card only).
941648c711bSPoul-Henning Kamp# ze: IBM/National Semiconductor PCMCIA ethernet controller.
942648c711bSPoul-Henning Kamp# zp: 3Com PCMCIA Etherlink III (It does not require shared memory for
943648c711bSPoul-Henning Kamp#     send/receive operation, but it needs 'iomem' to read/write the
944648c711bSPoul-Henning Kamp#     attribute memory)
9456a8d6623SGarrett Wollman#
9466a8d6623SGarrett Wollman
947e7c234a1SPeter Wemmdevice ar0 at isa? port 0x300 net irq 10 iomem 0xd0000 vector arintr
94883401efaSGarrett Wollmandevice cx0 at isa? port 0x240 net irq 15 drq 7 vector cxintr
9496a8d6623SGarrett Wollmandevice ed0 at isa? port 0x280 net irq 5 iomem 0xd8000 vector edintr
95012cfa436SPoul-Henning Kampdevice eg0 at isa? port 0x310 net irq 5 vector egintr
9516a8d6623SGarrett Wollmandevice el0 at isa? port 0x300 net irq 9 vector elintr
952d41f24e7SDavid Greenmandevice ep0 at isa? port 0x300 net irq 10 vector epintr
9530942673fSJordan K. Hubbarddevice ex0 at isa? port? net irq? vector exintr
954a732b754SJordan K. Hubbarddevice fe0 at isa? port 0x300 net irq ? vector feintr
955c1aa7eb5SJustin T. Gibbsdevice ie0 at isa? port 0x300 net irq 5 iomem 0xd0000 vector ieintr
956c1aa7eb5SJustin T. Gibbsdevice ie1 at isa? port 0x360 net irq 7 iomem 0xd0000 vector ieintr
9576a8d6623SGarrett Wollmandevice le0 at isa? port 0x300 net irq 5 iomem 0xd0000 vector le_intr
95863373752SPoul-Henning Kampdevice lnc0 at isa? port 0x300 net irq 10 drq 0 vector lncintr
959d805b866SJohn Haydevice sr0 at isa? port 0x300 net irq 5 iomem 0xd0000 vector srintr
9603476cdb9SMike Smithoptions		WLCACHE		# enables the signal-strength cache
9613476cdb9SMike Smithoptions		WLDEBUG		# enables verbose debugging output
9622321ce34SPeter Wemmdevice wl0 at isa? port 0x300 net irq ? vector wlintr
963ec0ae37dSNate Williams# Needed so that we can (bogusly) include both the dedicated PCCARD
964ec0ae37dSNate Williams# drivers and the generic support
965ec0ae37dSNate Williamsoptions	LINT_PCCARD_HACK
966ada9d061SJordan K. Hubbarddevice ze0 at isa? port 0x300 net irq 5 iomem 0xd8000 vector zeintr
967648c711bSPoul-Henning Kampdevice zp0 at isa? port 0x300 net irq 10 iomem 0xd8000 vector zpintr
968648c711bSPoul-Henning Kamp
96968713f97SKenjiro Cho#
97068713f97SKenjiro Cho# ATM related options
97168713f97SKenjiro Cho#
97268713f97SKenjiro Cho# The `en' device provides support for Efficient Networks (ENI)
97368713f97SKenjiro Cho# ENI-155 PCI midway cards, and the Adaptec 155Mbps PCI ATM cards (ANA-59x0).
97468713f97SKenjiro Cho#
9753cbceb82SKenjiro Cho# atm pseudo-device provides generic atm functions and is required for
97668713f97SKenjiro Cho# atm devices.
9773cbceb82SKenjiro Cho# NATM enables the netnatm protocol family that can be used to
97868713f97SKenjiro Cho# bypass TCP/IP.
97968713f97SKenjiro Cho#
98068713f97SKenjiro Cho# the current driver supports only PVC operations (no atm-arp, no multicast).
98168713f97SKenjiro Cho# for more details, please read the original documents at
98268713f97SKenjiro Cho# http://www.ccrc.wustl.edu/pub/chuck/bsdatm/wucs.html
98368713f97SKenjiro Cho#
98468713f97SKenjiro Chopseudo-device	atm
98568713f97SKenjiro Chodevice en0
98668713f97SKenjiro Chodevice en1
9873cbceb82SKenjiro Chooptions		NATM			#native ATM
988f4567b9cSJulian Elischer
9891a7c583cSGarrett Wollman#
9901a7c583cSGarrett Wollman# Audio drivers: `snd', `sb', `pas', `gus', `pca'
9916a8d6623SGarrett Wollman#
9921a7c583cSGarrett Wollman# snd: Voxware sound support code
9931a7c583cSGarrett Wollman# sb: SoundBlaster PCM - SoundBlaster, SB Pro, SB16, ProAudioSpectrum
9941a7c583cSGarrett Wollman# sbxvi: SoundBlaster 16
9951a7c583cSGarrett Wollman# sbmidi: SoundBlaster 16 MIDI interface
9961a7c583cSGarrett Wollman# pas: ProAudioSpectrum PCM and MIDI
9971a7c583cSGarrett Wollman# gus: Gravis Ultrasound - Ultrasound, Ultrasound 16, Ultrasound MAX
998a2048b9cSJordan K. Hubbard# gusxvi: Gravis Ultrasound 16-bit PCM	(do not use)
9991a7c583cSGarrett Wollman# mss: Microsoft Sound System
10005eaf45f6SPeter Wemm# css: Crystal Sound System (CSS 423x PnP)
100161ca8499SMark Murray# sscape: Ensoniq Soundscape MIDI interface
100261ca8499SMark Murray# sscape_mss: Ensoniq Soundscape PCM (requires sscape)
10031a7c583cSGarrett Wollman# opl: Yamaha OPL-2 and OPL-3 FM - SB, SB Pro, SB 16, ProAudioSpectrum
10041a7c583cSGarrett Wollman# uart: stand-alone 6850 UART for MIDI
10051a7c583cSGarrett Wollman# mpu: Roland MPU-401 stand-alone card
10061a7c583cSGarrett Wollman#
10071a7c583cSGarrett Wollman# Beware!  The addresses specified below are also hard-coded in
10081a7c583cSGarrett Wollman# i386/isa/sound/sound_config.h.  If you change the values here, you
10091a7c583cSGarrett Wollman# must also change the values in the include file.
10101a7c583cSGarrett Wollman#
1011c7406082SJohn-Mark Gurney# pcm: PCM audio through various sound cards.
1012c7406082SJohn-Mark Gurney#
1013c7406082SJohn-Mark Gurney# This is the work in progress from Luigi Rizzo.  This has support for
1014c7406082SJohn-Mark Gurney# CS423x based cards, OPTi931, SB16 PnP, GusPnP.  For more information
1015c7406082SJohn-Mark Gurney# about this driver, take a look at sys/i386/isa/snd/README.
1016c7406082SJohn-Mark Gurney#
1017c7406082SJohn-Mark Gurney# The flags of the device tells the device a bit more info about the
1018c7406082SJohn-Mark Gurney# device that normally is obtained through the PnP interface.
1019c7406082SJohn-Mark Gurney#	bit  2..0   secondary DMA channel;
1020c7406082SJohn-Mark Gurney#	bit  4      set if the board uses two dma channels;
1021c7406082SJohn-Mark Gurney#	bit 15..8   board type, overrides autodetection; leave it
1022c7406082SJohn-Mark Gurney#		    zero if don't know what to put in (and you don't,
1023c7406082SJohn-Mark Gurney#		    since this is unsupported at the moment...).
1024c7406082SJohn-Mark Gurney#
1025c7406082SJohn-Mark Gurney# This driver will use the new PnP code if it's available.
1026c7406082SJohn-Mark Gurney#
10276a8d6623SGarrett Wollman# pca: PCM audio through your PC speaker
10286a8d6623SGarrett Wollman#
1029d1a599c2SJordan K. Hubbard# If you have a GUS-MAX card and want to use the CS4231 codec on the
1030d1a599c2SJordan K. Hubbard# card the drqs for the gus max must be 8 bit (1, 2, or 3).
1031d1a599c2SJordan K. Hubbard#
1032d1a599c2SJordan K. Hubbard# If you would like to use the full duplex option on the gus, then define
1033d1a599c2SJordan K. Hubbard# flags to be the ``read dma channel''.
1034d1a599c2SJordan K. Hubbard#
1035d1a599c2SJordan K. Hubbard# options BROKEN_BUS_CLOCK	#PAS-16 isn't working and OPTI chipset
1036d1a599c2SJordan K. Hubbard# options SYMPHONY_PAS		#PAS-16 isn't working and SYMPHONY chipset
1037d1a599c2SJordan K. Hubbard# options EXCLUDE_SBPRO		#PAS-16
1038b1529bdaSPeter Wemm# options SBC_IRQ=5		#PAS-16. Must match irq on sb0 line.
1039d1a599c2SJordan K. Hubbard# PAS16: The order of the pas0/sb0/opl0 is important since the
1040d1a599c2SJordan K. Hubbard#	sb emulation is enabled in the pas-16 attach.
1041d1a599c2SJordan K. Hubbard#
1042d1a599c2SJordan K. Hubbard# The i386/isa/sound/sound.doc has more information.
1043a2048b9cSJordan K. Hubbard
104412fd0853SSteven Wallace# Controls all sound devices
104512fd0853SSteven Wallacecontroller	snd0
1046d1a599c2SJordan K. Hubbarddevice pas0     at isa? port 0x388 irq 10 drq 6 vector pasintr
104729a4cf6dSAndrey A. Chernovdevice sb0      at isa? port 0x220 irq 5 drq 1 vector sbintr
104829a4cf6dSAndrey A. Chernovdevice sbxvi0   at isa? drq 5
104929a4cf6dSAndrey A. Chernovdevice sbmidi0  at isa? port 0x330
105029a4cf6dSAndrey A. Chernovdevice awe0     at isa? port 0x620
10518e411548SJordan K. Hubbarddevice gus0 at isa? port 0x220 irq 12 drq 1 vector gusintr
10528e411548SJordan K. Hubbard#device gus0 at isa? port 0x220 irq 12 drq 1 flags 0x3 vector gusintr
105312fd0853SSteven Wallacedevice mss0 at isa? port 0x530 irq 10 drq 1 vector adintr
10545eaf45f6SPeter Wemm#device css0	at isa? port 0x534 irq 5 drq 1 flags 0x08 vector adintr
105561ca8499SMark Murraydevice sscape0  at isa? port 0x330 irq 9 drq 0 vector sscapeintr
105661ca8499SMark Murraydevice sscape_mss0  at isa? port 0x534 irq 5 drq 1 vector sndintr
105729a4cf6dSAndrey A. Chernovdevice opl0     at isa? port 0x388
1058a91ccb55SSteven Wallacedevice mpu0     at isa? port 0x330 irq 6 drq 0
105912fd0853SSteven Wallacedevice uart0 at isa? port 0x330 irq 5 vector "m6850intr"
10600897a95dSAndrey A. Chernov
106165e8111fSBruce Evans# More undocumented sound devices with bogus configurations for linting.
106265e8111fSBruce Evans# broken
106365e8111fSBruce Evans#device trix0    at isa? port 0x330 irq 6 drq 0 vector sscapeintr
106465e8111fSBruce Evans
1065c7406082SJohn-Mark Gurney# Luigi's snd code
1066c7406082SJohn-Mark Gurney# device pcm0 at isa? port ? tty irq 10 drq 1 flags 0x0 vector pcmintr
1067c7406082SJohn-Mark Gurney
10681a7c583cSGarrett Wollman# Not controlled by `snd'
1069017e602cSAndrey A. Chernovdevice pca0 at isa? port IO_TIMER1 tty
10709ad380abSGarrett Wollman
10716a8d6623SGarrett Wollman#
1072567e21c2SBruce Evans# Miscellaneous hardware:
10736a8d6623SGarrett Wollman#
10746a8d6623SGarrett Wollman# mcd: Mitsumi CD-ROM
10752d859864SAndreas Schulz# scd: Sony CD-ROM
107605e1d9d4SJordan K. Hubbard# matcd: Matsushita/Panasonic CD-ROM
10776a8d6623SGarrett Wollman# wt: Wangtek and Archive QIC-02/QIC-36 tape drives
10786a8d6623SGarrett Wollman# ctx: Cortex-I frame grabber
10796a8d6623SGarrett Wollman# apm: Laptop Advanced Power Management (experimental)
10806c5e9bbdSMike Pritchard# spigot: The Creative Labs Video Spigot video-acquisition board
10811d86961eSJordan K. Hubbard# meteor: Matrox Meteor video capture board
1082a1e9e308SJamil J. Weatherbee# alog: Industrial Computer Source AIO8-P driver
10836baab376SJohn-Mark Gurney# bktr: Bt848 capture boards (http://www.freebsd.org/~fsmp/HomeAuto/Bt848.html)
108465e8111fSBruce Evans# cy: Cyclades serial driver
1085a50cd483SJordan K. Hubbard# dgb: Digiboard PC/Xi and PC/Xe series driver (ALPHA QUALITY!)
10861a7c583cSGarrett Wollman# gp:  National Instruments AT-GPIB and AT-GPIB/TNT board
1087a800f455SJulian Elischer# asc: GI1904-based hand scanners, e.g. the Trust Amiscan Grey
10881a7c583cSGarrett Wollman# gsc: Genius GS-4500 hand scanner.
10891a7c583cSGarrett Wollman# joy: joystick
1090657e73c4SPeter Dufault# labpc: National Instrument's Lab-PC and Lab-PC+
1091d0930614SAndrey A. Chernov# rc: RISCom/8 multiport card
10923b577e1fSJordan K. Hubbard# rp: Comtrol Rocketport(ISA) - single card
1093567e21c2SBruce Evans# tw: TW-523 power line interface for use with X-10 home control products
10940d04cf6aSPeter Wemm# si: Specialix SI/XIO 4-32 port terminal multiplexor
1095c9da1b81SPeter Wemm# stl: Stallion EasyIO and EasyConnection 8/32 (cd1400 based)
1096c9da1b81SPeter Wemm# stli: Stallion EasyConnection 8/64, ONboard, Brumby (intelligent)
1097657e73c4SPeter Dufault
10986a8d6623SGarrett Wollman#
1099e597b497SNate Williams# Notes on APM
11003d4d8fe9SPoul-Henning Kamp#  The flags takes the following meaning for apm0:
11013d4d8fe9SPoul-Henning Kamp#    0x0020  Statclock is broken.
11023d4d8fe9SPoul-Henning Kamp#    0x0011  Limit APM protocol to 1.1 or 1.0
11033d4d8fe9SPoul-Henning Kamp#    0x0010  Limit APM protocol to 1.0
1104e597b497SNate Williams#
1105e597b497SNate Williams#
11062cd01159SJordan K. Hubbard# Notes on the spigot:
11072cd01159SJordan K. Hubbard#  The video spigot is at 0xad6.  This port address can not be changed.
11082cd01159SJordan K. Hubbard#  The irq values may only be 10, 11, or 15
11092cd01159SJordan K. Hubbard#  I/O memory is an 8kb region.  Possible values are:
11102cd01159SJordan K. Hubbard#    0a0000, 0a2000, ..., 0fffff, f00000, f02000, ..., ffffff
1111d01b6680SJordan K. Hubbard#    The start address must be on an even boundary.
1112d01b6680SJordan K. Hubbard#  Add the following option if you want to allow non-root users to be able
1113d01b6680SJordan K. Hubbard#  to access the spigot.  This option is not secure because it allows users
1114d01b6680SJordan K. Hubbard#  direct access to the I/O page.
1115d01b6680SJordan K. Hubbard#  	options SPIGOT_UNSECURE
1116d01b6680SJordan K. Hubbard#
11178819d6ecSPoul-Henning Kamp
11183b577e1fSJordan K. Hubbard# Notes on the Comtrol Rocketport driver:
11193b577e1fSJordan K. Hubbard#
11203b577e1fSJordan K. Hubbard# The exact values used for rp0 depend on how many boards you have
11213b577e1fSJordan K. Hubbard# in the system.  The manufacturer's sample configs are listed as:
11223b577e1fSJordan K. Hubbard#
11233b577e1fSJordan K. Hubbard#   Comtrol Rocketport ISA single card
11243b577e1fSJordan K. Hubbard#               device  rp0     at isa? port 0x280 tty
11253b577e1fSJordan K. Hubbard#
11263b577e1fSJordan K. Hubbard#   If instead you have two ISA cards, one installed at 0x100 and the
11273b577e1fSJordan K. Hubbard#   second installed at 0x180, then you should add the following to
11283b577e1fSJordan K. Hubbard#   your kernel configuration file:
11293b577e1fSJordan K. Hubbard#
11303b577e1fSJordan K. Hubbard#               device  rp0     at isa? port 0x100 tty
11313b577e1fSJordan K. Hubbard#               device  rp1     at isa? port 0x180 tty
11323b577e1fSJordan K. Hubbard#
11333b577e1fSJordan K. Hubbard#   For 4 ISA cards, it might be something like this:
11343b577e1fSJordan K. Hubbard#
11353b577e1fSJordan K. Hubbard#               device  rp0     at isa? port 0x180 tty
11363b577e1fSJordan K. Hubbard#               device  rp1     at isa? port 0x100 tty
11373b577e1fSJordan K. Hubbard#               device  rp2     at isa? port 0x340 tty
11383b577e1fSJordan K. Hubbard#               device  rp3     at isa? port 0x240 tty
11393b577e1fSJordan K. Hubbard#
11403b577e1fSJordan K. Hubbard#   And for PCI cards, you only need say:
11413b577e1fSJordan K. Hubbard#
11423b577e1fSJordan K. Hubbard#               device rp0
11433b577e1fSJordan K. Hubbard#               device rp1
11443b577e1fSJordan K. Hubbard#               ...
11453b577e1fSJordan K. Hubbard#   Note: Make sure that any Rocketport PCI devices are specified BEFORE the
11463b577e1fSJordan K. Hubbard#   ISA Rocketport devices.
11473b577e1fSJordan K. Hubbard
1148a50cd483SJordan K. Hubbard# Notes on the Digiboard driver:
1149a50cd483SJordan K. Hubbard#
1150a50cd483SJordan K. Hubbard# The following flag values have special meanings:
1151a50cd483SJordan K. Hubbard#	0x01 - alternate layout of pins
1152a50cd483SJordan K. Hubbard#	0x02 - use the windowed PC/Xe in 64K mode
11530d04cf6aSPeter Wemm
11540d04cf6aSPeter Wemm# Notes on the Specialix SI/XIO driver:
1155c4823710SPeter Wemm#  **This is NOT a Specialix supported Driver!**
1156c4823710SPeter Wemm#  The host card is memory, not IO mapped.
1157c4823710SPeter Wemm#  The Rev 1 host cards use a 64K chunk, on a 32K boundary.
1158c4823710SPeter Wemm#  The Rev 2 host cards use a 32K chunk, on a 32K boundary.
1159c4823710SPeter Wemm#  The cards can use an IRQ of 11, 12 or 15.
1160c4823710SPeter Wemm
1161c9da1b81SPeter Wemm# Notes on the Stallion stl and stli drivers:
1162c9da1b81SPeter Wemm#  See src/i386/isa/README.stl for complete instructions.
1163c9da1b81SPeter Wemm#  This is version 0.0.5alpha, unsupported by Stallion.
1164c9da1b81SPeter Wemm#  The stl driver has a secondary IO port hard coded at 0x280.  You need
1165c9da1b81SPeter Wemm#     to change src/i386/isa/stallion.c if you reconfigure this on the boards.
1166c9da1b81SPeter Wemm#  The "flags" and "iosiz" settings on the stli driver depend on the board:
1167c9da1b81SPeter Wemm#	EasyConnection 8/64 ISA:     flags 23         iosiz 0x1000
1168c9da1b81SPeter Wemm#	EasyConnection 8/64 EISA:    flags 24         iosiz 0x10000
1169c9da1b81SPeter Wemm#	EasyConnection 8/64 MCA:     flags 25         iosiz 0x1000
1170c9da1b81SPeter Wemm#	ONboard ISA:                 flags 4          iosiz 0x10000
1171c9da1b81SPeter Wemm#	ONboard EISA:                flags 7          iosiz 0x10000
1172c9da1b81SPeter Wemm#	ONboard MCA:                 flags 3          iosiz 0x10000
1173c9da1b81SPeter Wemm#	Brumby:                      flags 2          iosiz 0x4000
1174c9da1b81SPeter Wemm#	Stallion:                    flags 1          iosiz 0x10000
1175c9da1b81SPeter Wemm
11766a8d6623SGarrett Wollmandevice		mcd0	at isa? port 0x300 bio irq 10 vector mcdintr
117705e1d9d4SJordan K. Hubbard# for the Sony CDU31/33A CDROM
11782d859864SAndreas Schulzdevice		scd0	at isa? port 0x230 bio
11796c5e9bbdSMike Pritchard# for the SoundBlaster 16 multicd - up to 4 devices
11809720b084SJordan K. Hubbardcontroller      matcd0  at isa? port 0x230 bio
11816a8d6623SGarrett Wollmandevice		wt0	at isa? port 0x300 bio irq 5 drq 1 vector wtintr
11826a8d6623SGarrett Wollmandevice		ctx0	at isa? port 0x230 iomem 0xd0000
11832cd01159SJordan K. Hubbarddevice		spigot0 at isa? port 0xad6 irq 15 iomem 0xee000 vector spigintr
11844cf62360SPaul Trainadevice		qcam0	at isa? port "IO_LPT3" tty
11856a8d6623SGarrett Wollmandevice		apm0	at isa?
11861a7c583cSGarrett Wollmandevice		gp0	at isa? port 0x2c0 tty
11871a7c583cSGarrett Wollmandevice		gsc0	at isa? port "IO_GSC1" tty drq 3
11881a7c583cSGarrett Wollmandevice		joy0	at isa? port "IO_GAME"
1189a1e9e308SJamil J. Weatherbeedevice          alog0   at isa? port 0x260 tty irq 5 vector alogintr
119065e8111fSBruce Evansdevice		cy0	at isa? tty irq 10 iomem 0xd4000 iosiz 0x2000 vector cyintr
1191a50cd483SJordan K. Hubbarddevice		dgb0	at isa? port 0x220 iomem 0xfc0000 iosiz ? tty
1192657e73c4SPeter Dufaultdevice		labpc0	at isa? port 0x260 tty irq 5 vector labpcintr
1193d0930614SAndrey A. Chernovdevice          rc0     at isa? port 0x220 tty irq 12 vector rcintr
11943b577e1fSJordan K. Hubbarddevice          rp0     at isa? port 0x280 tty
1195567e21c2SBruce Evans# the port and irq for tw0 are fictitious
1196567e21c2SBruce Evansdevice          tw0     at isa? port 0x380 tty irq 11 vector twintr
1197c4823710SPeter Wemmdevice		si0	at isa? iomem 0xd0000 tty irq 12 vector siintr
1198a800f455SJulian Elischerdevice		asc0	at isa? port IO_ASC1 tty drq 3 irq 10 vector ascintr
119965e8111fSBruce Evansdevice		bqu0	at isa? port 0x150
1200c9da1b81SPeter Wemmdevice		stl0	at isa? port 0x2a0 tty irq 10 vector stlintr
1201c9da1b81SPeter Wemmdevice		stli0	at isa? port 0x2a0 tty iomem 0xcc000 flags 23 iosiz 0x1000
1202a800f455SJulian Elischer
1203eeb706c0SJustin T. Gibbs#
1204eeb706c0SJustin T. Gibbs# EISA devices:
1205eeb706c0SJustin T. Gibbs#
1206eeb706c0SJustin T. Gibbs# The EISA bus device is eisa0.  It provides auto-detection and
1207eeb706c0SJustin T. Gibbs# configuration support for all devices on the EISA bus.
1208eeb706c0SJustin T. Gibbs#
1209e56e7036SJustin T. Gibbs# The `ahb' device provides support for the Adaptec 174X adapter.
1210e56e7036SJustin T. Gibbs#
1211eeb706c0SJustin T. Gibbs# The `ahc' device provides support for the Adaptec 274X and 284X
1212eeb706c0SJustin T. Gibbs# adapters.  The 284X, although a VLB card responds to EISA probes.
1213eeb706c0SJustin T. Gibbs#
1214c37ddbb8SJoerg Wunsch# fea: DEC DEFEA EISA FDDI adapter
1215c37ddbb8SJoerg Wunsch#
1216eeb706c0SJustin T. Gibbscontroller	eisa0
1217e56e7036SJustin T. Gibbscontroller	ahb0
1218eeb706c0SJustin T. Gibbscontroller	ahc0
1219c37ddbb8SJoerg Wunschdevice		fea0
12206a8d6623SGarrett Wollman
122135846a81SMike Pritchard# enable tagged command queuing, which is a major performance win on
12226e702c99SPaul Traina# devices that support it (and controllers with enough SCB's)
12236e702c99SPaul Trainaoptions	AHC_TAGENABLE
12246e702c99SPaul Traina
12256fb5e0faSJustin T. Gibbs# enable SCB paging - See the ahc.4 man page
12266fb5e0faSJustin T. Gibbsoptions	AHC_SCBPAGING_ENABLE
12276e702c99SPaul Traina
12286fb5e0faSJustin T. Gibbs# The aic7xxx driver will attempt to use memory mapped I/O for all PCI
122911b5ea72SJustin T. Gibbs# controllers that have it configured only if this option is set. Unfortunately,
123011b5ea72SJustin T. Gibbs# this doesn't work on some motherboards, which prevents it from being the
123111b5ea72SJustin T. Gibbs# default.
123211b5ea72SJustin T. Gibbsoptions AHC_ALLOW_MEMIO
12336e702c99SPaul Traina
12341b0d3143SJoerg Wunsch# By default, only 10 EISA slots are probed, since the slot numbers
12351b0d3143SJoerg Wunsch# above clash with the configuration address space of the PCI subsystem,
12361b0d3143SJoerg Wunsch# and the EISA probe is not very smart about this.  This is sufficient
12371b0d3143SJoerg Wunsch# for most machines, but in particular the HP NetServer LC series comes
12381b0d3143SJoerg Wunsch# with an onboard AIC7770 dual-channel SCSI controller on EISA slot #11,
12391b0d3143SJoerg Wunsch# thus you need to bump this figure to 12 for them.
12401b0d3143SJoerg Wunschoptions	"EISA_SLOTS=12"
12411b0d3143SJoerg Wunsch
12426a8d6623SGarrett Wollman#
12436a8d6623SGarrett Wollman# PCI devices:
12446a8d6623SGarrett Wollman#
12456a8d6623SGarrett Wollman# The main PCI bus device is `pci'.  It provides auto-detection and
12466a8d6623SGarrett Wollman# configuration support for all devices on the PCI bus, using either
12476a8d6623SGarrett Wollman# configuration mode defined in the PCI specification.
12486a8d6623SGarrett Wollman#
1249eeb706c0SJustin T. Gibbs# The `ahc' device provides support for the Adaptec 29/3940(U)(W)
1250eeb706c0SJustin T. Gibbs# and motherboard based AIC7870/AIC7880 adapters.
1251eeb706c0SJustin T. Gibbs#
12526a8d6623SGarrett Wollman# The `ncr' device provides support for the NCR 53C810 and 53C825
12536a8d6623SGarrett Wollman# self-contained SCSI host adapters.
12546a8d6623SGarrett Wollman#
1255e69742d7SStefan Eßer# The `amd' device provides support for the Tekram DC-390 and 390T
1256e69742d7SStefan Eßer# SCSI host adapters, but is expected to work with any AMD 53c974
1257e69742d7SStefan Eßer# PCI SCSI chip and the AMD Ethernet+SCSI Combo chip, after some
1258e69742d7SStefan Eßer# local patches were applied to the sources (that had originally
1259e69742d7SStefan Eßer# been written by Tekram and limited to work with their SCSI cards).
1260e69742d7SStefan Eßer#
12616a8d6623SGarrett Wollman# The `de' device provides support for the Digital Equipment DC21040
12626a8d6623SGarrett Wollman# self-contained Ethernet adapter.
12636a8d6623SGarrett Wollman#
126456086e0dSSatoshi Asami# The `fxp' device provides support for the Intel EtherExpress Pro/100B
126556086e0dSSatoshi Asami# PCI Fast Ethernet adapters.
126656086e0dSSatoshi Asami#
1267ec4f65d2SJordan K. Hubbard# The `tx' device provides support for the SMC 9432TX cards.
1268ec4f65d2SJordan K. Hubbard#
12695ccfdea2SAndreas Schulz# The `vx' device provides support for the 3Com 3C590 and 3C595
1270f4567b9cSJulian Elischer# early support
1271f4567b9cSJulian Elischer#
1272d41f24e7SDavid Greenman# The `fpa' device provides support for the Digital DEFPA PCI FDDI
1273d41f24e7SDavid Greenman# adapter. pseudo-device fddi is also needed.
1274d41f24e7SDavid Greenman#
1275bba9a7a0SGarrett Wollman# The `meteor' device is a PCI video capture board. It can also have the
12761d86961eSJordan K. Hubbard# following options:
1277b1529bdaSPeter Wemm#   options METEOR_ALLOC_PAGES=xxx	preallocate kernel pages for data entry
12781d86961eSJordan K. Hubbard#	figure (ROWS*COLUMN*BYTES_PER_PIXEL*FRAME+PAGE_SIZE-1)/PAGE_SIZE
12791d86961eSJordan K. Hubbard#   options METEOR_DEALLOC_PAGES	remove all allocated pages on close(2)
1280b1529bdaSPeter Wemm#   options METEOR_DEALLOC_ABOVE=xxx	remove all allocated pages above the
12811d86961eSJordan K. Hubbard#	specified amount. If this value is below the allocated amount no action
12821d86961eSJordan K. Hubbard#	taken
1283734d08a2SJordan K. Hubbard#   option METEOR_SYSTEM_DEFAULT={METEOR_PAL|METEOR_NTSC|METEOR_SECAM}, used
1284734d08a2SJordan K. Hubbard#	for initialization of fps routine when a signal is not present.
12851d86961eSJordan K. Hubbard#
12865719a93cSJohn-Mark Gurney# The 'bktr' device is a PCI video capture board. It also has a TV tuner
12875719a93cSJohn-Mark Gurney# on board.
12885719a93cSJohn-Mark Gurney#
12896a8d6623SGarrett Wollmancontroller	pci0
1290eeb706c0SJustin T. Gibbscontroller	ahc1
129111bfa65aSBruce Evanscontroller	ncr0
1292e69742d7SStefan Eßercontroller	amd0
12936a8d6623SGarrett Wollmandevice		de0
129417acc2b2SDavid Greenmandevice		fxp0
1295ec4f65d2SJordan K. Hubbarddevice		tx0
12965ccfdea2SAndreas Schulzdevice		vx0
1297d41f24e7SDavid Greenmandevice		fpa0
12981d86961eSJordan K. Hubbarddevice		meteor0
12995719a93cSJohn-Mark Gurneydevice		bktr0
1300446cee6eSJoerg Wunsch
1301dc9deb29SPoul-Henning Kamp
1302dc9deb29SPoul-Henning Kamp#
1303dc9deb29SPoul-Henning Kamp# PCCARD/PCMCIA
1304dc9deb29SPoul-Henning Kamp#
1305e7e437dbSNate Williams# card: slot controller
130613cbd355SNate Williams# pcic: slots
1307e7e437dbSNate Williamscontroller	card0
1308e7e437dbSNate Williamscontroller	pcic0 at card?
1309e7e437dbSNate Williamscontroller	pcic1 at card?
1310dc9deb29SPoul-Henning Kamp
1311446cee6eSJoerg Wunsch#
1312446cee6eSJoerg Wunsch# Laptop/Notebook options:
1313446cee6eSJoerg Wunsch#
1314446cee6eSJoerg Wunsch# See also:
13156c5e9bbdSMike Pritchard#  apm under `Miscellaneous hardware'
1316446cee6eSJoerg Wunsch# above.
1317446cee6eSJoerg Wunsch
1318446cee6eSJoerg Wunsch# For older notebooks that signal a powerfail condition (external
1319446cee6eSJoerg Wunsch# power supply dropped, or battery state low) by issuing an NMI:
1320446cee6eSJoerg Wunsch
1321446cee6eSJoerg Wunschoptions		POWERFAIL_NMI	# make it beep instead of panicing
132265e8111fSBruce Evans
1323ab4c624bSMike Smith#
1324ab4c624bSMike Smith# Parallel-Port Bus
1325ab4c624bSMike Smith#
1326ab4c624bSMike Smith# Parallel port bus support is provided by the `ppbus' device.
1327ab4c624bSMike Smith# Multiple devices may be attached to the parallel port, devices
1328ab4c624bSMike Smith# are automatically probed and attached when found.
1329ab4c624bSMike Smith#
1330ab4c624bSMike Smith# Supported devices:
1331ab4c624bSMike Smith# vpo	Iomega Zip Drive
1332f88c1346SMike Smith#	Requires SCSI disk support ('scbus' and 'sd'), best
1333f88c1346SMike Smith#	performance is achieved with ports in EPP 1.9 mode.
1334ab4c624bSMike Smith# nlpt	Parallel Printer
1335ab4c624bSMike Smith# ppi	General-purpose I/O ("Geek Port")
1336ab4c624bSMike Smith#
1337ab4c624bSMike Smith# Supported interfaces:
1338ab4c624bSMike Smith# ppc	ISA-bus parallel port interfaces.
1339ab4c624bSMike Smith#
1340ab4c624bSMike Smithcontroller	ppbus0
1341ab4c624bSMike Smithcontroller	vpo0	at ppbus?
1342ab4c624bSMike Smithdevice		nlpt0	at ppbus?
1343ab4c624bSMike Smithdevice		ppi0	at ppbus?
1344ab4c624bSMike Smith
1345ab4c624bSMike Smithcontroller	ppc0	at isa? disable port ? irq 7 vector ppcintr
1346ab4c624bSMike Smith
1347432aad0eSTor Egge# Kernel BOOTP support
1348432aad0eSTor Egge
1349432aad0eSTor Eggeoptions		BOOTP		# Use BOOTP to obtain IP address/hostname
1350432aad0eSTor Eggeoptions		BOOTP_NFSROOT	# NFS mount root filesystem using BOOTP info
1351432aad0eSTor Eggeoptions		"BOOTP_NFSV3"	# Use NFS v3 to NFS mount root
1352432aad0eSTor Eggeoptions		BOOTP_COMPAT	# Workaround for broken bootp daemons.
1353432aad0eSTor Egge
135425292acbSBruce Evans#
135525292acbSBruce Evans# An obsolete option to test kern_opt.c.
135625292acbSBruce Evans#
135725292acbSBruce Evansoptions		GATEWAY
135825292acbSBruce Evans
135965e8111fSBruce Evans# More undocumented options for linting.
136094c94804SBruce Evans
1361d656e316SBruce Evansoptions		CLK_CALIBRATION_LOOP
1362d656e316SBruce Evansoptions		"CLK_USE_I8254_CALIBRATION"
1363d46e059fSPoul-Henning Kampoptions		CLK_USE_TSC_CALIBRATION
13649546766aSBruce Evansoptions		CLUSTERDEBUG
1365f3e002a8SPoul-Henning Kampoptions		COMPAT_LINUX
136696b89afcSBruce Evansoptions		CPU_UPGRADE_HW_CACHE
136711bfa65aSBruce Evansoptions		DEBUG
1368c6de6a69SEivind Eklundoptions		"DEBUG_1284"
136911bfa65aSBruce Evansoptions		DEVFS_ROOT
1370c6de6a69SEivind Eklund#options	DISABLE_PSE
137111bfa65aSBruce Evansoptions		"EXT2FS"
137211bfa65aSBruce Evansoptions		"I586_PMC_GUPROF=0x70000"
137311bfa65aSBruce Evansoptions		"IBCS2"
1374c6de6a69SEivind Eklund# broken:
1375c6de6a69SEivind Eklund#options		IPFILTER
1376c6de6a69SEivind Eklund# broken:
1377c6de6a69SEivind Eklund#options		KEY
137825292acbSBruce Evansoptions		LOCKF_DEBUG
1379c6de6a69SEivind Eklundoptions		LOUTB
13804bc24b97SBruce Evansoptions		KBD_MAXRETRY=4
13814bc24b97SBruce Evansoptions		KBD_MAXWAIT=6
13824bc24b97SBruce Evansoptions		KBD_RESETDELAY=201
13834bc24b97SBruce Evansoptions		KBDIO_DEBUG=2
13844bc24b97SBruce Evansoptions		MSGMNB=2049
13854bc24b97SBruce Evansoptions		MSGMNI=41
13864bc24b97SBruce Evansoptions		MSGSEG=2049
138756a956e5SBruce Evansoptions		MSGSSZ=16
13884bc24b97SBruce Evansoptions		MSGTQL=41
13894bc24b97SBruce Evansoptions		NBUF=512
1390c6de6a69SEivind Eklundoptions		NETATALKDEBUG
13914bc24b97SBruce Evansoptions		NMBCLUSTERS=1024
13929546766aSBruce Evansoptions		NPX_DEBUG
1393c6de6a69SEivind Eklundoptions		NULLFS_DIAGNOSTIC
1394c6de6a69SEivind Eklundoptions		PANIC_REBOOT_WAIT_TIME=16
1395c6de6a69SEivind Eklundoptions		"PCVT_24LINESDEF"
1396c6de6a69SEivind Eklundoptions		PCVT_CTRL_ALT_DEL
1397c6de6a69SEivind Eklundoptions		PCVT_EMU_MOUSE
1398c6de6a69SEivind Eklundoptions		PCVT_FREEBSD=211
1399c6de6a69SEivind Eklundoptions		PCVT_META_ESC
1400c6de6a69SEivind Eklundoptions		PCVT_NSCREENS=9
1401c6de6a69SEivind Eklundoptions		PCVT_PRETTYSCRNS
1402c6de6a69SEivind Eklundoptions		PCVT_SCANSET=2
1403c6de6a69SEivind Eklundoptions		PCVT_SCREENSAVER
1404c6de6a69SEivind Eklundoptions		PCVT_USEKBDSEC
1405c6de6a69SEivind Eklundoptions		"PCVT_VT220KEYB"
14064bc24b97SBruce Evansoptions		PSM_DEBUG=1
1407c01db44aSBruce Evansoptions		"SCSI_2_DEF"
1408078d4ac9SBruce Evansoptions		SCSI_DELAY=8	# Be pessimistic about Joe SCSI device
1409078d4ac9SBruce Evansoptions		SCSI_NCR_DEBUG
1410078d4ac9SBruce Evansoptions		SCSI_NCR_DFLT_TAGS=4
1411078d4ac9SBruce Evansoptions		SCSI_NCR_MAX_SYNC=10000
1412078d4ac9SBruce Evansoptions		SCSI_NCR_MAX_WIDE=1
1413078d4ac9SBruce Evansoptions		SCSI_NCR_MYADDR=7
14144bc24b97SBruce Evansoptions		SEMMAP=31
14154bc24b97SBruce Evansoptions		SEMMNI=11
14164bc24b97SBruce Evansoptions		SEMMNS=61
14174bc24b97SBruce Evansoptions		SEMMNU=31
14184bc24b97SBruce Evansoptions		SEMMSL=61
14194bc24b97SBruce Evansoptions		SEMOPM=101
14204bc24b97SBruce Evansoptions		SEMUME=11
1421b1529bdaSPeter Wemmoptions		SHOW_BUSYBUFS	# List buffers that prevent root unmount
14224bc24b97SBruce Evansoptions		SHMALL=1025
14234bc24b97SBruce Evansoptions		"SHMMAX=(SHMMAXPGS*PAGE_SIZE+1)"
14244bc24b97SBruce Evansoptions		SHMMAXPGS=1025
14254bc24b97SBruce Evansoptions		SHMMIN=2
14264bc24b97SBruce Evansoptions		SHMMNI=33
14274bc24b97SBruce Evansoptions		SHMSEG=9
1428d656e316SBruce Evansoptions		SI_DEBUG
142925292acbSBruce Evansoptions		SIMPLELOCK_DEBUG
1430c6de6a69SEivind Eklund#options		SUIDDIR
1431cefdbb04SBruce Evansoptions		SPX_HACK
143216094866SJulian Elischer
143316094866SJulian Elischer# The 'dpt' driver provides hardware RAID-{0,1,5} support, multi-initiator I/O
143416094866SJulian Elischer# See sys/dev/dpt for debugging and other subtle options.
143516094866SJulian Elischer#   DPT_VERIFY_HINTR        Performs some strict hardware interrupts testing.
143616094866SJulian Elischer#                           Only use if you suspect PCI bus corruption problems
143716094866SJulian Elischer#   DPT_RESTRICTED_FREELIST Normally, the freelisat used by the DPT for queue
143816094866SJulian Elischer#                           will grow to accomodate increased use.  This growth
143916094866SJulian Elischer#                           will NOT shrink.  To restrict the number of queue
144016094866SJulian Elischer#                           slots to exactly what the DPT can hold at one time,
144116094866SJulian Elischer#                           enable this option.
144216094866SJulian Elischer#   DPT_TRACK_CCB_STATES    Enabling thos option will try to enforce strict
144316094866SJulian Elischer#                           sanity checking in the queue management.  Rarely,
144416094866SJulian Elischer#                           if ever, needed.
144516094866SJulian Elischer#   DPT_MEASURE_PERFORMANCE Enables a set of (semi)invasive metrics. Various
144616094866SJulian Elischer#                           instruments are enabled.  Assumed to be enabled by
144716094866SJulian Elischer#                           /usr/sbin/dpt_* tools.
144816094866SJulian Elischer#   DPT_FREELIST_IS_STACK   For optimat L{1,2} CPU cache utilization, enable
144916094866SJulian Elischer#                           this option.  Otherwise, the transaction queue is
145016094866SJulian Elischer#                           a LIFO.  I cannot measure the performance gain.
145116094866SJulian Elischer#   DPT_HANDLE_TIMEOUTS     Normally device timeouts are handled by the DPT.
145216094866SJulian Elischer#                           If you ant the driver to handle timeouts, enable
145316094866SJulian Elischer#                           this option.  If your system is very busy, this
145416094866SJulian Elischer#                           option will create more trouble than solve.
145516094866SJulian Elischer#   DPT_TIMEOUT_FACTOR      Used to compute the excessive amount of time to
145616094866SJulian Elischer#                           wait when timing out with the above option.
145716094866SJulian Elischer#  DPT_DEBUG_xxxx           These are controllable from sys/dev/dpt/dpt.h
145816094866SJulian Elischer#  DPT_LOST_IRQ             When enabled, will try, once per second, to catch
145916094866SJulian Elischer#                           any interrupt that got lost.  Seems to help in some
146016094866SJulian Elischer#                           DPT-firmware/Motherboard combinations.  Minimal
146116094866SJulian Elischer#                           cost, great benefit.
146216094866SJulian Elischer
146316094866SJulian Elischercontroller      dpt0
146416094866SJulian Elischer
146516094866SJulian Elischer# DPT options
146616094866SJulian Elischeroptions DPT_VERIFY_HINTR
146716094866SJulian Elischeroptions DPT_RESTRICTED_FREELIST
146816094866SJulian Elischeroptions DPT_TRACK_CCB_STATES
146916094866SJulian Elischeroptions DPT_MEASURE_PERFORMANCE
147016094866SJulian Elischeroptions DPT_FREELIST_IS_STACK
147116094866SJulian Elischeroptions DPT_HANDLE_TIMEOUTS
147216094866SJulian Elischeroptions DPT_TIMEOUT_FACTOR=4
147316094866SJulian Elischeroptions	DPT_INTR_DELAY=200      # Some motherboards need that
147416094866SJulian Elischeroptions DPT_LOST_IRQ
1475