xref: /freebsd/sys/conf/NOTES (revision e30938ce3ae692ea90225b7c76fa08d292d8a6bf)
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#
5e30938ceSBill Paul#	$Id: LINT,v 1.451 1998/08/10 08:40:26 yokota 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
4820f71813SJohn-Mark Gurney# Options for the VM subsystem
4920f71813SJohn-Mark Gurney#options	PQ_NOOPT		# No coloring
5020f71813SJohn-Mark Gurneyoptions		PQ_LARGECACHE		# color for 512k/16k cache
5120f71813SJohn-Mark Gurney#options	PQ_HUGECACHE		# color for 1024k/16k cache
5220f71813SJohn-Mark Gurney
53827d623eSJordan K. Hubbard# This allows you to actually store this configuration file into
54827d623eSJordan K. Hubbard# the kernel binary itself, where it may be later read by saying:
55827d623eSJordan K. Hubbard#    strings /kernel | grep ^___ | sed -e 's/^___//' > MYKERNEL
56827d623eSJordan K. Hubbard#
57827d623eSJordan K. Hubbardoptions         INCLUDE_CONFIG_FILE     # Include this file in kernel
58827d623eSJordan K. Hubbard
596a8d6623SGarrett Wollman#
606a8d6623SGarrett Wollman# This directive defines a number of things:
616a8d6623SGarrett Wollman#  - The compiled kernel is to be called `kernel'
626a8d6623SGarrett Wollman#  - The root filesystem might be on partition wd0a
63b8e91dabSDavid Greenman#  - Crash dumps will be written to wd0b, if possible.  Specifying the
64b8e91dabSDavid Greenman#    dump device here is not recommended.  Use dumpon(8).
656a8d6623SGarrett Wollman#
66b8e91dabSDavid Greenmanconfig		kernel	root on wd0 dumps on wd0
672365e64fSRodney W. Grimes
686a8d6623SGarrett Wollman
696a8d6623SGarrett Wollman#####################################################################
70477a642cSPeter Wemm# SMP OPTIONS:
71477a642cSPeter Wemm#
72477a642cSPeter Wemm# SMP enables building of a Symmetric MultiProcessor Kernel.
73477a642cSPeter Wemm# APIC_IO enables the use of the IO APIC for Symmetric I/O.
74477a642cSPeter Wemm# NCPU sets the number of CPUs, defaults to 2.
75477a642cSPeter Wemm# NBUS sets the number of busses, defaults to 4.
76477a642cSPeter Wemm# NAPIC sets the number of IO APICs on the motherboard, defaults to 1.
77477a642cSPeter Wemm# NINTR sets the total number of INTs provided by the motherboard.
78477a642cSPeter Wemm#
79477a642cSPeter Wemm# Notes:
80477a642cSPeter Wemm#
81477a642cSPeter Wemm#  An SMP kernel will ONLY run on an Intel MP spec. qualified motherboard.
82477a642cSPeter Wemm#
83477a642cSPeter Wemm#  Be sure to disable 'cpu "I386_CPU"' && 'cpu "I486_CPU"' for SMP kernels.
84477a642cSPeter Wemm#
85477a642cSPeter Wemm#  Check the 'Rogue SMP hardware' section to see if additional options
86477a642cSPeter Wemm#   are required by your hardware.
87477a642cSPeter Wemm#
88477a642cSPeter Wemm
89477a642cSPeter Wemm# Mandatory:
90477a642cSPeter Wemmoptions		SMP			# Symmetric MultiProcessor Kernel
91477a642cSPeter Wemmoptions		APIC_IO			# Symmetric (APIC) I/O
92477a642cSPeter Wemm
9306daa051SBruce Evans# Optional, these are the defaults plus 1:
9425717e99SSteve Passeoptions		NCPU=5			# number of CPUs
9506daa051SBruce Evansoptions		NBUS=5			# number of busses
9606daa051SBruce Evansoptions		NAPIC=2			# number of IO APICs
9706daa051SBruce Evansoptions		NINTR=25		# number of INTs
98477a642cSPeter Wemm
99477a642cSPeter Wemm#
100477a642cSPeter Wemm# Rogue SMP hardware:
101477a642cSPeter Wemm#
102477a642cSPeter Wemm
103477a642cSPeter Wemm# Bridged PCI cards:
104477a642cSPeter Wemm#
105477a642cSPeter Wemm# The MP tables of most of the current generation MP motherboards
106477a642cSPeter Wemm#  do NOT properly support bridged PCI cards.  To use one of these
107477a642cSPeter Wemm#  cards you should refer to ???
108477a642cSPeter Wemm
109477a642cSPeter Wemm
110477a642cSPeter Wemm#####################################################################
11156be1833SKATO Takenori# CPU OPTIONS
11256be1833SKATO Takenori
11356be1833SKATO Takenori#
11456be1833SKATO Takenori# You must specify at least one CPU (the one you intend to run on);
11556be1833SKATO Takenori# deleting the specification for CPUs you don't need to use may make
11656be1833SKATO Takenori# parts of the system run faster.  This is especially true removing
11756be1833SKATO Takenori# I386_CPU.
11856be1833SKATO Takenori#
11956be1833SKATO Takenoricpu		"I386_CPU"
12056be1833SKATO Takenoricpu		"I486_CPU"
12156be1833SKATO Takenoricpu		"I586_CPU"		# aka Pentium(tm)
12256be1833SKATO Takenoricpu		"I686_CPU"		# aka Pentium Pro(tm)
12356be1833SKATO Takenori
12456be1833SKATO Takenori#
12556be1833SKATO Takenori# Options for CPU features.
12656be1833SKATO Takenori#
12756be1833SKATO Takenori# CPU_BLUELIGHTNING_FPU_OP_CACHE enables FPU operand cache on IBM
12856be1833SKATO Takenori# BlueLightning CPU.  It works only with Cyrix FPU, and this option
12956be1833SKATO Takenori# should not be used with Intel FPU.
13056be1833SKATO Takenori#
13156be1833SKATO Takenori# CPU_BLUELIGHTNING_3X enables triple-clock mode on IBM Blue Lightning
13256be1833SKATO Takenori# CPU if CPU supports it. The default is double-clock mode on
13356be1833SKATO Takenori# BlueLightning CPU box.
13456be1833SKATO Takenori#
13556be1833SKATO Takenori# CPU_BTB_EN enables branch target buffer on Cyrix 5x86 (NOTE 1).
13656be1833SKATO Takenori#
1374962d938SKATO Takenori# CPU_DIRECT_MAPPED_CACHE sets L1 cache of Cyrix 486DLC CPU in direct
1384962d938SKATO Takenori# mapped mode.  Default is 2-way set associative mode.
1394962d938SKATO Takenori#
1406593be60SKATO Takenori# CPU_CYRIX_NO_LOCK enables weak locking for the entire address space
1416593be60SKATO Takenori# of Cyrix 6x86 and 6x86MX CPUs.  If this option is not set and
1426593be60SKATO Takenori# FAILESAFE is defined, NO_LOCK bit of CCR1 is cleared.  (NOTE 3)
1436593be60SKATO Takenori#
14456be1833SKATO Takenori# CPU_DISABLE_5X86_LSSER disables load store serialize (i.e. enables
14556be1833SKATO Takenori# reorder).  This option should not be used if you use memory mapped
14656be1833SKATO Takenori# I/O device(s).
14756be1833SKATO Takenori#
14856be1833SKATO Takenori# CPU_FASTER_5X86_FPU enables faster FPU exception handler.
14956be1833SKATO Takenori#
15056be1833SKATO Takenori# CPU_I486_ON_386 enables CPU cache on i486 based CPU upgrade products
15156be1833SKATO Takenori# for i386 machines.
1524962d938SKATO Takenori#
15356be1833SKATO Takenori# CPU_IORT defines I/O clock delay time (NOTE 1).  Default vaules of
15456be1833SKATO Takenori# I/O clock delay time on Cyrix 5x86 and 6x86 are 0 and 7,respectively
15556be1833SKATO Takenori# (no clock delay).
15656be1833SKATO Takenori#
15756be1833SKATO Takenori# CPU_LOOP_EN prevents flushing the prefetch buffer if the destination
15856be1833SKATO Takenori# of a jump is already present in the prefetch buffer on Cyrix 5x86(NOTE
15956be1833SKATO Takenori# 1).
16056be1833SKATO Takenori#
16156be1833SKATO Takenori# CPU_RSTK_EN enables return stack on Cyrix 5x86 (NOTE 1).
16256be1833SKATO Takenori#
16356be1833SKATO Takenori# CPU_SUSP_HLT enables suspend on HALT.  If this option is set, CPU
16456be1833SKATO Takenori# enters suspend mode following execution of HALT instruction.
16556be1833SKATO Takenori#
1666593be60SKATO Takenori# CPU_WT_ALLOC enables write-through allocation.
1676593be60SKATO Takenori#
16856be1833SKATO Takenori# CYRIX_CACHE_WORKS enables CPU cache on Cyrix 486 CPUs with cache
16956be1833SKATO Takenori# flush at hold state.
17056be1833SKATO Takenori#
17156be1833SKATO Takenori# CYRIX_CACHE_REALLY_WORKS enables (1) CPU cache on Cyrix 486 CPUs
17256be1833SKATO Takenori# without cache flush at hold state, and (2) write-back CPU cache on
17356be1833SKATO Takenori# Cyrix 6x86 whose revision < 2.7 (NOTE 2).
17456be1833SKATO Takenori#
175b0050656SJohn-Mark Gurney# NO_F00F_HACK disables the hack that prevents Pentiums (and ONLY
176b0050656SJohn-Mark Gurney# Pentiums) from locking up when a LOCK CMPXCHG8B instruction is
177b0050656SJohn-Mark Gurney# executed.  This should be included for ALL kernels that won't run
178b0050656SJohn-Mark Gurney# on a Pentium.
179b0050656SJohn-Mark Gurney#
18056be1833SKATO Takenori# NOTE 1: The options, CPU_BTB_EN, CPU_LOOP_EN, CPU_IORT,
18156be1833SKATO Takenori# CPU_LOOP_ENand CPU_RSTK_EN should no be used becasue of CPU bugs.
18256be1833SKATO Takenori# These options may crash your system.
18356be1833SKATO Takenori#
18456be1833SKATO Takenori# NOTE 2: If CYRIX_CACHE_REALLY_WORKS is not set, CPU cache is enabled
18556be1833SKATO Takenori# in write-through mode when revision < 2.7.  If revision of Cyrix
18656be1833SKATO Takenori# 6x86 >= 2.7, CPU cache is always enabled in write-back mode.
18756be1833SKATO Takenori#
1886593be60SKATO Takenori# NOTE 3: This option may cause failures for software that requires
1896593be60SKATO Takenori# locked cycles in order to operate correctly.
1906593be60SKATO Takenori#
19156be1833SKATO Takenorioptions		"CPU_BLUELIGHTNING_FPU_OP_CACHE"
19256be1833SKATO Takenorioptions		"CPU_BLUELIGHTNING_3X"
19356be1833SKATO Takenorioptions		"CPU_BTB_EN"
1944962d938SKATO Takenorioptions		"CPU_DIRECT_MAPPED_CACHE"
19556be1833SKATO Takenorioptions		"CPU_DISABLE_5X86_LSSER"
19656be1833SKATO Takenorioptions		"CPU_FASTER_5X86_FPU"
19756be1833SKATO Takenorioptions		"CPU_I486_ON_386"
19856be1833SKATO Takenorioptions		"CPU_IORT"
19956be1833SKATO Takenorioptions		"CPU_LOOP_EN"
20056be1833SKATO Takenorioptions		"CPU_RSTK_EN"
20156be1833SKATO Takenorioptions		"CPU_SUSP_HLT"
20256be1833SKATO Takenorioptions		"CYRIX_CACHE_WORKS"
20356be1833SKATO Takenorioptions		"CYRIX_CACHE_REALLY_WORKS"
204b0050656SJohn-Mark Gurney#options	"NO_F00F_HACK"
20556be1833SKATO Takenori
20656be1833SKATO Takenori#
20756be1833SKATO Takenori# A math emulator is mandatory if you wish to run on hardware which
20856be1833SKATO Takenori# does not have a floating-point processor.  Pick either the original,
20956be1833SKATO Takenori# bogus (but freely-distributable) math emulator, or a much more
21056be1833SKATO Takenori# fully-featured but GPL-licensed emulator taken from Linux.
21156be1833SKATO Takenori#
21256be1833SKATO Takenorioptions		MATH_EMULATE		#Support for x87 emulation
21356be1833SKATO Takenori# Don't enable both of these in a real config.
21456be1833SKATO Takenorioptions		GPL_MATH_EMULATE	#Support for x87 emulation via
21556be1833SKATO Takenori					#new math emulator
21656be1833SKATO Takenori
21756be1833SKATO Takenori
21856be1833SKATO Takenori#####################################################################
2196a8d6623SGarrett Wollman# COMPATIBILITY OPTIONS
220690f540cSAndrey A. Chernov
2216a8d6623SGarrett Wollman#
2226a8d6623SGarrett Wollman# Implement system calls compatible with 4.3BSD and older versions of
22356c7a48cSJordan K. Hubbard# FreeBSD.  You probably do NOT want to remove this as much current code
22456c7a48cSJordan K. Hubbard# still relies on the 4.3 emulation.
2256a8d6623SGarrett Wollman#
2266a8d6623SGarrett Wollmanoptions		"COMPAT_43"
2276a8d6623SGarrett Wollman
2286a8d6623SGarrett Wollman#
2296c5e9bbdSMike Pritchard# Allow user-mode programs to manipulate their local descriptor tables.
2306a8d6623SGarrett Wollman# This option is required for the WINE Windows(tm) emulator, and is
2316a8d6623SGarrett Wollman# not used by anything else (that we know of).
2326a8d6623SGarrett Wollman#
2336a8d6623SGarrett Wollmanoptions		USER_LDT		#allow user-level control of i386 ldt
2346a8d6623SGarrett Wollman
2356a8d6623SGarrett Wollman#
2366a8d6623SGarrett Wollman# These three options provide support for System V Interface
2376a8d6623SGarrett Wollman# Definition-style interprocess communication, in the form of shared
2386a8d6623SGarrett Wollman# memory, semaphores, and message queues, respectively.
2396a8d6623SGarrett Wollman#
2406a8d6623SGarrett Wollmanoptions		SYSVSHM
2416a8d6623SGarrett Wollmanoptions		SYSVSEM
2426a8d6623SGarrett Wollmanoptions		SYSVMSG
2436a8d6623SGarrett Wollman
24494801746SPoul-Henning Kamp#
24594801746SPoul-Henning Kamp# This option includes a MD5 routine in the kernel, this is used for
24694801746SPoul-Henning Kamp# various authentication and privacy uses.
24794801746SPoul-Henning Kamp#
24894801746SPoul-Henning Kampoptions		"MD5"
24994801746SPoul-Henning Kamp
250adeb9a12SJonathan Lemon#
251adeb9a12SJonathan Lemon# Allow processes to switch to vm86 mode, as well as enabling direct
252adeb9a12SJonathan Lemon# user-mode access to the I/O port space.  This option is necessary for
253adeb9a12SJonathan Lemon# the doscmd emulator to run.
254adeb9a12SJonathan Lemon#
255adeb9a12SJonathan Lemonoptions		"VM86"
256adeb9a12SJonathan Lemon
2576a8d6623SGarrett Wollman
2586a8d6623SGarrett Wollman#####################################################################
2596a8d6623SGarrett Wollman# DEBUGGING OPTIONS
2606a8d6623SGarrett Wollman
2616a8d6623SGarrett Wollman#
262b5d89ca8SBruce Evans# Enable the kernel debugger.
2636a8d6623SGarrett Wollman#
264b5d89ca8SBruce Evansoptions		DDB
265b5d89ca8SBruce Evans
266b5d89ca8SBruce Evans#
2675ccab2afSGary Palmer# Don't drop into DDB for a panic. Intended for unattended operation
2685ccab2afSGary Palmer# where you may want to drop to DDB from the console, but still want
2695ccab2afSGary Palmer# the machine to recover from a panic
2705ccab2afSGary Palmer#
2715ccab2afSGary Palmeroptions		DDB_UNATTENDED
2725ccab2afSGary Palmer
2735ccab2afSGary Palmer#
274562d05dfSPaul Traina# If using GDB remote mode to debug the kernel, there's a non-standard
275562d05dfSPaul Traina# extension to the remote protocol that can be used to use the serial
276562d05dfSPaul Traina# port as both the debugging port and the system console.  It's non-
277562d05dfSPaul Traina# standard and you're on your own if you enable it.  See also the
278562d05dfSPaul Traina# "remotechat" variables in the FreeBSD specific version of gdb.
279562d05dfSPaul Traina#
280562d05dfSPaul Trainaoptions		GDB_REMOTE_CHAT
281562d05dfSPaul Traina
282562d05dfSPaul Traina#
2836a8d6623SGarrett Wollman# KTRACE enables the system-call tracing facility ktrace(2).
2846a8d6623SGarrett Wollman#
2852365e64fSRodney W. Grimesoptions		KTRACE			#kernel tracing
28621c64a07SAndrey A. Chernov
2876a8d6623SGarrett Wollman#
2886a8d6623SGarrett Wollman# The DIAGNOSTIC option is used in a number of source files to enable
2896a8d6623SGarrett Wollman# extra sanity checking of internal structures.  This support is not
2906a8d6623SGarrett Wollman# enabled by default because of the extra time it would take to check
2916a8d6623SGarrett Wollman# for these conditions, which can only occur as a result of
2926a8d6623SGarrett Wollman# programming errors.
2936a8d6623SGarrett Wollman#
2940dc7d907SPoul-Henning Kampoptions		DIAGNOSTIC
295da59a31cSDavid Greenman
2960dd1eea1SJordan K. Hubbard#
297348acd94SGarrett Wollman# PERFMON causes the driver for Pentium/Pentium Pro performance counters
298348acd94SGarrett Wollman# to be compiled.  See perfmon(4) for more information.
299348acd94SGarrett Wollman#
300348acd94SGarrett Wollmanoptions		PERFMON
301348acd94SGarrett Wollman
302346ebe51SEivind Eklund
303346ebe51SEivind Eklund#
304346ebe51SEivind Eklund# This option let some drivers co-exist that can't co-exist in a running
305346ebe51SEivind Eklund# system.  This is used to be able to compile all kernel code in one go for
306346ebe51SEivind Eklund# quality assurance purposes (like this file, which the option takes it name
307346ebe51SEivind Eklund# from.)
308346ebe51SEivind Eklund#
309346ebe51SEivind Eklundoptions COMPILING_LINT
310346ebe51SEivind Eklund
311346ebe51SEivind Eklund
312348acd94SGarrett Wollman# XXX - this doesn't belong here.
3130dd1eea1SJordan K. Hubbard# Allow ordinary users to take the console - this is useful for X.
3140dd1eea1SJordan K. Hubbardoptions		UCONSOLE
3150dd1eea1SJordan K. Hubbard
31696fc6efbSPoul-Henning Kamp# XXX - this doesn't belong here either
31796fc6efbSPoul-Henning Kampoptions		USERCONFIG		#boot -c editor
3188996308bSJordan K. Hubbardoptions		USERCONFIG_BOOT		#imply -c and parse info area
31996fc6efbSPoul-Henning Kampoptions		VISUAL_USERCONFIG	#visual boot -c editor
3206a8d6623SGarrett Wollman
3216a8d6623SGarrett Wollman#####################################################################
3226a8d6623SGarrett Wollman# NETWORKING OPTIONS
32370c0b54cSAndrey A. Chernov
3246a8d6623SGarrett Wollman#
3256a8d6623SGarrett Wollman# Protocol families:
3266a8d6623SGarrett Wollman#  Only the INET (Internet) family is officially supported in FreeBSD.
32711bfa65aSBruce Evans#  Source code for the NS (Xerox Network Service) is provided for amusement
32811bfa65aSBruce Evans#  value.
3296a8d6623SGarrett Wollman#
3306a8d6623SGarrett Wollmanoptions		INET			#Internet communications protocols
331f73bbaf2SDavid Greenman
332cc6a66f2SJulian Elischeroptions		IPX			#IPX/SPX communications protocols
333cc6a66f2SJulian Elischeroptions		IPXIP			#IPX in IP encapsulation (not available)
334cc6a66f2SJulian Elischeroptions		IPTUNNEL		#IP in IPX encapsulation (not available)
335cc6a66f2SJulian Elischer
33634b5fca7SJulian Elischeroptions		NETATALK		#Appletalk communications protocols
33734b5fca7SJulian Elischer
33811bfa65aSBruce Evans# These are currently broken but are shipped due to interest.
33911bfa65aSBruce Evans#options		NS			#Xerox NS protocols
34011bfa65aSBruce Evans
341bba9a7a0SGarrett Wollman# These are currently broken and are no longer shipped due to lack
342bba9a7a0SGarrett Wollman# of interest.
343bba9a7a0SGarrett Wollman#options		CCITT			#X.25 network layer
344f73bbaf2SDavid Greenman#options		ISO
345f73bbaf2SDavid Greenman#options		TPIP			#ISO TP class 4 over IP
346f73bbaf2SDavid Greenman#options		TPCONS			#ISO TP class 0 over X.25
347bba9a7a0SGarrett Wollman#options		LLC			#X.25 link layer for Ethernets
348bba9a7a0SGarrett Wollman#options		HDLC			#X.25 link layer for serial lines
349bba9a7a0SGarrett Wollman#options		EON			#ISO CLNP over IP
350dc915e7cSGarrett Wollman#options		NSIP			#XNS over IP
35163a74862SSteven Wallace
3526a8d6623SGarrett Wollman#
3536a8d6623SGarrett Wollman# Network interfaces:
35456c7a48cSJordan K. Hubbard#  The `loop' pseudo-device is MANDATORY when networking is enabled.
3556a8d6623SGarrett Wollman#  The `ether' pseudo-device provides generic code to handle
35656c7a48cSJordan K. Hubbard#  Ethernets; it is MANDATORY when a Ethernet device driver is
3576a8d6623SGarrett Wollman#  configured.
358d41f24e7SDavid Greenman#  The 'fddi' pseudo-device provides generic code to support FDDI.
35983401efaSGarrett Wollman#  The `sppp' pseudo-device serves a similar role for certain types
360e7c234a1SPeter Wemm#  of synchronous PPP links (like `cx', `ar').
3616a8d6623SGarrett Wollman#  The `sl' pseudo-device implements the Serial Line IP (SLIP) service.
362829b5d55SPeter Wemm#  The `ppp' pseudo-device implements the Point-to-Point Protocol.
363d29895dcSGarrett Wollman#  The `bpfilter' pseudo-device enables the Berkeley Packet Filter.  Be
364d29895dcSGarrett Wollman#  aware of the legal and administrative consequences of enabling this
365d29895dcSGarrett Wollman#  option.  The number of devices determines the maximum number of
366d29895dcSGarrett Wollman#  simultaneous BPF clients programs runnable.
36759d8d13fSGarrett Wollman#  The `disc' pseudo-device implements a minimal network interface,
36859d8d13fSGarrett Wollman#  which throws away all packets sent and never receives any.  It is
36959d8d13fSGarrett Wollman#  included for testing purposes.
370b60d4a5dSAtsushi Murai#  The `tun' pseudo-device implements the User Process PPP (iijppp)
3716a8d6623SGarrett Wollman#
372829b5d55SPeter Wemm# The PPP_BSDCOMP option enables support for compress(1) style entire
373829b5d55SPeter Wemm# packet compression, the PPP_DEFLATE is for zlib/gzip style compression.
374829b5d55SPeter Wemm# PPP_FILTER enables code for filtering the ppp data stream and selecting
375829b5d55SPeter Wemm# events for resetting the demand dial activity timer - requires bpfilter.
376829b5d55SPeter Wemm# See pppd(8) for more details.
37789327d27SPeter Wemm#
3786a8d6623SGarrett Wollmanpseudo-device	ether			#Generic Ethernet
379d41f24e7SDavid Greenmanpseudo-device	fddi			#Generic FDDI
38083401efaSGarrett Wollmanpseudo-device	sppp			#Generic Synchronous PPP
3816a8d6623SGarrett Wollmanpseudo-device	loop			#Network loopback device
382829b5d55SPeter Wemmpseudo-device	bpfilter	4	#Berkeley packet filter
383829b5d55SPeter Wemmpseudo-device	disc			#Discard device
384829b5d55SPeter Wemmpseudo-device	tun	1		#Tunnel driver (user process ppp(8))
3856a8d6623SGarrett Wollmanpseudo-device	sl	2		#Serial Line IP
3866a8d6623SGarrett Wollmanpseudo-device	ppp	2		#Point-to-point protocol
38789327d27SPeter Wemmoptions PPP_BSDCOMP			#PPP BSD-compress support
38889327d27SPeter Wemmoptions PPP_DEFLATE			#PPP zlib/deflate/gzip support
38996be526aSPeter Wemmoptions PPP_FILTER			#enable bpf filtering (needs bpfilter)
390d29895dcSGarrett Wollman
3916a8d6623SGarrett Wollman#
3926a8d6623SGarrett Wollman# Internet family options:
3936a8d6623SGarrett Wollman#
3946a8d6623SGarrett Wollman# TCP_COMPAT_42 causes the TCP code to emulate certain bugs present in
3956a8d6623SGarrett Wollman# 4.2BSD.  This option should not be used unless you have a 4.2BSD
3966a8d6623SGarrett Wollman# machine and TCP connections fail.
3976a8d6623SGarrett Wollman#
3986a8d6623SGarrett Wollman# MROUTING enables the kernel multicast packet forwarder, which works
3996a8d6623SGarrett Wollman# with mrouted(8).
4006a8d6623SGarrett Wollman#
401d29895dcSGarrett Wollman# IPFIREWALL enables support for IP firewall construction, in
402ff6f025aSAlexander Langer# conjunction with the `ipfw' program.  IPFIREWALL_VERBOSE sends
403ff6f025aSAlexander Langer# logged packets to the system logger.  IPFIREWALL_VERBOSE_LIMIT
404ff6f025aSAlexander Langer# limits the number of times a matching entry can be logged.
405ab6e02daSJordan K. Hubbard#
406ab6e02daSJordan K. Hubbard# WARNING:  IPFIREWALL defaults to a policy of "deny ip from any to any"
407ab6e02daSJordan K. Hubbard# and if you do not add other rules during startup to allow access,
408ab6e02daSJordan K. Hubbard# YOU WILL LOCK YOURSELF OUT.  It is suggested that you set firewall=open
409ab6e02daSJordan K. Hubbard# in /etc/rc.conf when first enabling this feature, then refining the
410ab6e02daSJordan K. Hubbard# firewall rules in /etc/rc.firewall after you've tested that the new kernel
411ab6e02daSJordan K. Hubbard# feature works properly.
4128dd4744eSJordan K. Hubbard#
413ffdd472dSPeter Wemm# IPFIREWALL_DEFAULT_TO_ACCEPT causes the default rule (at boot) to
414ffdd472dSPeter Wemm# allow everything.  Use with care, if a cracker can crash your
415ffdd472dSPeter Wemm# firewall machine, they can get to your protected machines.  However,
416ffdd472dSPeter Wemm# if you are using it as an as-needed filter for specific problems as
417ffdd472dSPeter Wemm# they arise, then this may be for you.  Changing the default to 'allow'
418ffdd472dSPeter Wemm# means that you won't get stuck if the kernel and /sbin/ipfw binary get
419ffdd472dSPeter Wemm# out of sync.
420d29895dcSGarrett Wollman#
42193e0e116SJulian Elischer# IPDIVERT enables the divert IP sockets, used by ``ipfw divert''
42293e0e116SJulian Elischer#
4231689d8bdSPeter Wemm# IPFILTER enables Darren Reed's ipfilter package.
4241689d8bdSPeter Wemm# IPFILTER_LOG enables ipfilter's logging.
4251689d8bdSPeter Wemm# IPFILTER_LKM enables LKM support for an ipfilter module (untested).
4261689d8bdSPeter Wemm#
42765e8111fSBruce Evans# TCPDEBUG is undocumented.
42865e8111fSBruce Evans#
4296a8d6623SGarrett Wollmanoptions		"TCP_COMPAT_42"		#emulate 4.2BSD TCP bugs
430e3178a06SJordan K. Hubbardoptions		MROUTING		# Multicast routing
431d29895dcSGarrett Wollmanoptions         IPFIREWALL              #firewall
432d29895dcSGarrett Wollmanoptions         IPFIREWALL_VERBOSE      #print information about
433d29895dcSGarrett Wollman					# dropped packets
434e06ccb17SJulian Elischeroptions         IPFIREWALL_FORWARD      #enable xparent proxy support
435ff6f025aSAlexander Langeroptions		"IPFIREWALL_VERBOSE_LIMIT=100" #limit verbosity
436e43a9900SAlexander Langeroptions		IPFIREWALL_DEFAULT_TO_ACCEPT #allow everything by default
43793e0e116SJulian Elischeroptions		IPDIVERT		#divert sockets
4381689d8bdSPeter Wemmoptions		IPFILTER		#kernel ipfilter support
4391689d8bdSPeter Wemmoptions		IPFILTER_LOG		#ipfilter logging
4401689d8bdSPeter Wemm#options	IPFILTER_LKM		#kernel support for ip_fil.o LKM
44165e8111fSBruce Evansoptions		TCPDEBUG
4426a8d6623SGarrett Wollman
4436a8d6623SGarrett Wollman
4446a8d6623SGarrett Wollman#####################################################################
4456a8d6623SGarrett Wollman# FILESYSTEM OPTIONS
446e3178a06SJordan K. Hubbard
4472365e64fSRodney W. Grimes#
4486a8d6623SGarrett Wollman# Only the root, /usr, and /tmp filesystems need be statically
4496a8d6623SGarrett Wollman# compiled; everything else will be automatically loaded at mount
450c5b193bfSPoul-Henning Kamp# time.  (Exception: the UFS family---FFS, and MFS --- cannot
4516a8d6623SGarrett Wollman# currently be demand-loaded.)  Some people still prefer to statically
4526a8d6623SGarrett Wollman# compile other filesystems as well.
4536a8d6623SGarrett Wollman#
454a5b88b01SKATO Takenori# NB: The NULL, PORTAL, UMAP and UNION filesystems are known to be
455a5b88b01SKATO Takenori# buggy, and WILL panic your system if you attempt to do anything with
456a5b88b01SKATO Takenori# them.  They are included here as an incentive for some enterprising
457a5b88b01SKATO Takenori# soul to sit down and fix them.
4582365e64fSRodney W. Grimes#
459f1a9c715SDavid Greenman
4606a8d6623SGarrett Wollman# One of these is mandatory:
4616a8d6623SGarrett Wollmanoptions		FFS			#Fast filesystem
4626a8d6623SGarrett Wollmanoptions		NFS			#Network File System
4636a8d6623SGarrett Wollman
4646a8d6623SGarrett Wollman# The rest are optional:
4657c115697SPoul-Henning Kamp# options	NFS_NOSERVER		#Disable the NFS-server code.
466f1a9c715SDavid Greenmanoptions		"CD9660"		#ISO 9660 filesystem
467f1a9c715SDavid Greenmanoptions		FDESC			#File descriptor filesystem
468f1a9c715SDavid Greenmanoptions		KERNFS			#Kernel filesystem
469f1a9c715SDavid Greenmanoptions		MFS			#Memory File System
4703f9a6982SDoug Rabsonoptions		MSDOSFS			#MS DOS File System
471f1a9c715SDavid Greenmanoptions		NULLFS			#NULL filesystem
472f1a9c715SDavid Greenmanoptions		PORTAL			#Portal filesystem
473f1a9c715SDavid Greenmanoptions		PROCFS			#Process filesystem
474f1a9c715SDavid Greenmanoptions		UMAPFS			#UID map filesystem
475f1a9c715SDavid Greenmanoptions		UNION			#Union filesystem
4767b778b5eSEivind Eklundoptions		"CD9660_ROOT"		#CD-ROM usable as root device
4777b778b5eSEivind Eklundoptions		FFS_ROOT		#FFS usable as root device
4787b778b5eSEivind Eklundoptions		NFS_ROOT		#NFS usable as root device
479992109b5SJulian Elischer# DEVFS and SLICE are experimental but work.
4803e425b96SJulian Elischer# SLICE disables too much old code so enabling it in LINT would be bad
48146746c3bSJulian Elischeroptions		DEVFS			#devices filesystem
4823e425b96SJulian Elischer#options		SLICE			#devfs based disk handling
483f1a9c715SDavid Greenman
484b1897c19SJulian Elischer# Allow the FFS to use Softupdates technology.
4850346e0feSJulian Elischer# To do this you need to copy the two files
486b1897c19SJulian Elischer# /sys/ufs/ffs/softdep.h and /sys/ufs/ffs/ffs_softdep.c
4870346e0feSJulian Elischer# from /usr/src/contrib/sys/softupdates
4880346e0feSJulian Elischer# and understand the licensing restrictions.
4890346e0feSJulian Elischer# You should also check on the FreeBSD website for newer versions.
490b1897c19SJulian Elischer#options		SOFTUPDATES
491b1897c19SJulian Elischer# (we can't actually enable it because the files may not be present)
492b1897c19SJulian Elischer
493d52d7365SPoul-Henning Kamp# Make space in the kernel for a MFS root filesystem.  Define to the number
494d52d7365SPoul-Henning Kamp# of kilobytes to reserve for the filesystem.
495b1529bdaSPeter Wemmoptions		MFS_ROOT=10
496b1529bdaSPeter Wemm# Allow the MFS_ROOT code to load the MFS image from floppy if it is missing.
497b1529bdaSPeter Wemmoptions		MFS_AUTOLOAD
498a9c94e9bSJohn-Mark Gurney# Allows MFS filesystems to be exported via nfs
499a9c94e9bSJohn-Mark Gurneyoptions		EXPORTMFS
500d52d7365SPoul-Henning Kamp
501a401ebbeSDavid Greenman# Allow this many swap-devices.
502b1529bdaSPeter Wemmoptions		NSWAPDEV=20
503a401ebbeSDavid Greenman
5046a8d6623SGarrett Wollman# Disk quotas are supported when this option is enabled.  If you
5056a8d6623SGarrett Wollman# change the value of this option, you must do a `make clean' in your
5066a8d6623SGarrett Wollman# kernel compile directory in order to get a working kernel.
5076a8d6623SGarrett Wollman#
5082365e64fSRodney W. Grimesoptions		QUOTA			#enable disk quotas
5096a8d6623SGarrett Wollman
51023d048eeSGary Palmer# Add more checking code to various filesystems
51123d048eeSGary Palmer#options		NULLFS_DIAGNOSTIC
51223d048eeSGary Palmer#options		KERNFS_DIAGNOSTIC
51323d048eeSGary Palmer#options		UMAPFS_DIAGNOSTIC
51423d048eeSGary Palmer#options		UNION_DIAGNOSTIC
51523d048eeSGary Palmer
5165a9714deSJoerg Wunsch# In particular multi-session CD-Rs might require a huge amount of
5175a9714deSJoerg Wunsch# time in order to "settle".  If we are about mounting them as the
5185a9714deSJoerg Wunsch# root f/s, we gotta wait a little.
5195a9714deSJoerg Wunsch#
5205a9714deSJoerg Wunsch# The number is supposed to be in seconds.
5215a9714deSJoerg Wunschoptions		"CD9660_ROOTDELAY=20"
5225a9714deSJoerg Wunsch
523276756a4SDag-Erling Smørgrav# If you are running a machine just as a fileserver for PC and MAC
524276756a4SDag-Erling Smørgrav# users, using SAMBA or Netatalk, you may consider setting this option
525276756a4SDag-Erling Smørgrav# and keeping all those users' directories on a filesystem that is
526276756a4SDag-Erling Smørgrav# mounted with the suiddir option. This gives new files the same
527276756a4SDag-Erling Smørgrav# ownership as the directory (similiar to group). It's a security hole
5286110161fSDag-Erling Smørgrav# if you let these users run programs, so confine it to file-servers
529276756a4SDag-Erling Smørgrav# (but it'll save you lots of headaches in those cases). Root owned
530276756a4SDag-Erling Smørgrav# directories are exempt and X bits are cleared. The suid bit must be
531276756a4SDag-Erling Smørgrav# set on the directory as well; see chmod(1) PC owners can't see/set
532276756a4SDag-Erling Smørgrav# ownerships so they keep getting their toes trodden on. This saves
533276756a4SDag-Erling Smørgrav# you all the support calls as the filesystem it's used on will act as
534276756a4SDag-Erling Smørgrav# they expect: "It's my dir so it must be my file".
535cb800e34SJulian Elischer#
536cb800e34SJulian Elischeroptions		SUIDDIR
537cb800e34SJulian Elischer
538cb800e34SJulian Elischer
53923d048eeSGary Palmer# Add some error checking code to the null_bypass routine
540c85cfdb2SDavid E. O'Brien# in the NULL filesystem
54123d048eeSGary Palmer#options		SAFETY
54223d048eeSGary Palmer
543df394affSJohn-Mark Gurney
544df394affSJohn-Mark Gurney# NFS options:
545df394affSJohn-Mark Gurneyoptions		"NFS_MINATTRTIMO=3"	# VREG attrib cache timeout in sec
546df394affSJohn-Mark Gurneyoptions		"NFS_MAXATTRTIMO=60"
547df394affSJohn-Mark Gurneyoptions		"NFS_MINDIRATTRTIMO=30"	# VDIR attrib cache timeout in sec
548df394affSJohn-Mark Gurneyoptions		"NFS_MAXDIRATTRTIMO=60"
549df394affSJohn-Mark Gurneyoptions		"NFS_GATHERDELAY=10"	# Default write gather delay (msec)
550df394affSJohn-Mark Gurneyoptions		"NFS_UIDHASHSIZ=29"	# Tune the size of nfssvc_sock with this
551df394affSJohn-Mark Gurneyoptions		"NFS_WDELAYHASHSIZ=16"	# and with this
552df394affSJohn-Mark Gurneyoptions		"NFS_MUIDHASHSIZ=63"	# Tune the size of nfsmount with this
553df394affSJohn-Mark Gurneyoptions		NFS_DEBUG		# Enable NFS Debugging
554df394affSJohn-Mark Gurney
5556a8d6623SGarrett Wollman
5566a8d6623SGarrett Wollman#####################################################################
557abc97a06SBruce Evans# POSIX P1003.1B
558abc97a06SBruce Evans
559abc97a06SBruce Evans# Real time extensions added int the 1993 Posix
560abc97a06SBruce Evans# P1003_1B: Infrastructure
561abc97a06SBruce Evans# _KPOSIX_PRIORITY_SCHEDULING: Build in _POSIX_PRIORITY_SCHEDULING
562abc97a06SBruce Evans# _KPOSIX_VERSION:             Version kernel is built for
563abc97a06SBruce Evans
564abc97a06SBruce Evansoptions		"P1003_1B"
565abc97a06SBruce Evansoptions		"_KPOSIX_PRIORITY_SCHEDULING"
566abc97a06SBruce Evansoptions		"_KPOSIX_VERSION=199309L"
567abc97a06SBruce Evans
568abc97a06SBruce Evans
569abc97a06SBruce Evans#####################################################################
570de6a307eSPeter Dufault# SCSI DEVICES
571de6a307eSPeter Dufault
5726a8d6623SGarrett Wollman# SCSI DEVICE CONFIGURATION
5736a8d6623SGarrett Wollman
5746a8d6623SGarrett Wollman# The SCSI subsystem consists of the `base' SCSI code, a number of
575ebc1a0e2SPeter Dufault# high-level SCSI device `type' drivers, and the low-level host-adapter
5766a8d6623SGarrett Wollman# device drivers.  The host adapters are listed in the ISA and PCI
5776a8d6623SGarrett Wollman# device configuration sections below.
5786a8d6623SGarrett Wollman#
579265368d4SRodney W. Grimes# Beginning with FreeBSD 2.0.5 you can wire down your SCSI devices so
580ebc1a0e2SPeter Dufault# that a given bus, target, and LUN always come on line as the same
581ebc1a0e2SPeter Dufault# device unit.  In earlier versions the unit numbers were assigned
582ebc1a0e2SPeter Dufault# in the order that the devices were probed on the SCSI bus.  This
583ebc1a0e2SPeter Dufault# means that if you removed a disk drive, you may have had to rewrite
584ebc1a0e2SPeter Dufault# your /etc/fstab file, and also that you had to be careful when adding
585ebc1a0e2SPeter Dufault# a new disk as it may have been probed earlier and moved your device
586ebc1a0e2SPeter Dufault# configuration around.
587ebc1a0e2SPeter Dufault
588ebc1a0e2SPeter Dufault# This old behavior is maintained as the default behavior.  The unit
589ebc1a0e2SPeter Dufault# assignment begins with the first non-wired down unit for a device
590ebc1a0e2SPeter Dufault# type.  For example, if you wire a disk as "sd3" then the first
591ebc1a0e2SPeter Dufault# non-wired disk will be assigned sd4.
592ebc1a0e2SPeter Dufault
593ebc1a0e2SPeter Dufault# The syntax for wiring down devices is:
594ebc1a0e2SPeter Dufault
5954fbaf9a7SJustin T. Gibbs# controller	scbus0 at ahc0		# Single bus device
5964fbaf9a7SJustin T. Gibbs# controller	scbus1 at ahc1 bus 0	# Single bus device
5974fbaf9a7SJustin T. Gibbs# controller	scbus3 at ahc2 bus 0	# Twin bus device
5984fbaf9a7SJustin T. Gibbs# controller	scbus2 at ahc2 bus 1	# Twin bus device
599ebc1a0e2SPeter Dufault# disk 		sd0 at scbus0 target 0 unit 0
6004fbaf9a7SJustin T. Gibbs# disk		sd1 at scbus3 target 1
6014fbaf9a7SJustin T. Gibbs# disk		sd2 at scbus2 target 3
6024fbaf9a7SJustin T. Gibbs# tape		st1 at scbus1 target 6
603ebc1a0e2SPeter Dufault# device	cd0 at scbus?
604ebc1a0e2SPeter Dufault
605ebc1a0e2SPeter Dufault# "units" (SCSI logical unit number) that are not specified are
606ebc1a0e2SPeter Dufault# treated as if specified as LUN 0.
607ebc1a0e2SPeter Dufault
608ebc1a0e2SPeter Dufault# All SCSI devices allocate as many units as are required.
609ebc1a0e2SPeter Dufault
610265368d4SRodney W. Grimes# The "unknown" device (uk? in pre-2.0.5) is now part of the base SCSI
611ebc1a0e2SPeter Dufault# configuration and doesn't have to be explicitly configured.
612ebc1a0e2SPeter Dufault
6136a8d6623SGarrett Wollmancontroller	scbus0	#base SCSI code
6146a8d6623SGarrett Wollmandevice		ch0	#SCSI media changers
6156a8d6623SGarrett Wollmandevice		sd0	#SCSI disks
6166a8d6623SGarrett Wollmandevice		st0	#SCSI tapes
6176a8d6623SGarrett Wollmandevice		cd0	#SCSI CD-ROMs
61849bdb5b8SJoerg Wunschdevice		od0	#SCSI optical disk
6196a8d6623SGarrett Wollman
620265368d4SRodney W. Grimes# The previous devices (ch, sd, st, cd) are recognized by config.
621265368d4SRodney W. Grimes# config doesn't (and shouldn't) know about these newer ones,
622265368d4SRodney W. Grimes# so we have to specify that they are on a SCSI bus with the "at scbus?"
623265368d4SRodney W. Grimes# clause.
624265368d4SRodney W. Grimes
6258909a72bSPeter Dufaultdevice worm0 at scbus?	# SCSI worm
6268909a72bSPeter Dufaultdevice pt0 at scbus?	# SCSI processor type
6278909a72bSPeter Dufaultdevice sctarg0 at scbus? # SCSI target
6288909a72bSPeter Dufault
6291a7c583cSGarrett Wollman# SCSI OPTIONS:
6301a7c583cSGarrett Wollman
6311a7c583cSGarrett Wollman# SCSIDEBUG: When defined enables debugging macros
6321a7c583cSGarrett Wollman# NO_SCSI_SENSE: When defined disables sense descriptions (about 4k)
6331a7c583cSGarrett Wollman# SCSI_REPORT_GEOMETRY: Always report disk geometry at boot up instead
634265368d4SRodney W. Grimes#                       of only when booting verbosely.
6351a7c583cSGarrett Wollmanoptions		SCSIDEBUG
6361a7c583cSGarrett Wollman#options	NO_SCSI_SENSE
6371a7c583cSGarrett Wollmanoptions		SCSI_REPORT_GEOMETRY
6381a7c583cSGarrett Wollman
63993063432SJoerg Wunsch# Options for the `od' optical disk driver:
64093063432SJoerg Wunsch#
64193063432SJoerg Wunsch# If drive returns sense key as 0x02 with vendor specific additional
64293063432SJoerg Wunsch# sense code (ASC) and additional sense code qualifier (ASCQ), or
64393063432SJoerg Wunsch# illegal ASC and ASCQ. This cause an error (NOT READY) and retrying.
64493063432SJoerg Wunsch# To suppress this, use the following option.
64593063432SJoerg Wunsch#
64693063432SJoerg Wunschoptions		OD_BOGUS_NOT_READY
64793063432SJoerg Wunsch#
64835846a81SMike Pritchard# For an automatic spindown, try this.  Again, preferably as an
64993063432SJoerg Wunsch# option in your config file.
65093063432SJoerg Wunsch# WARNING!  Use at your own risk.  Joerg's ancient SONY SMO drive
65193063432SJoerg Wunsch# groks it fine, while Shunsuke's Fujitsu chokes on it and times
65293063432SJoerg Wunsch# out.
65393063432SJoerg Wunsch#
65493063432SJoerg Wunschoptions		OD_AUTO_TURNOFF
65593063432SJoerg Wunsch
65693063432SJoerg Wunsch
6576a8d6623SGarrett Wollman
6586a8d6623SGarrett Wollman#####################################################################
6596a8d6623SGarrett Wollman# MISCELLANEOUS DEVICES AND OPTIONS
6606a8d6623SGarrett Wollman
6611160da92SJoerg Wunsch# The `pty' device usually turns out to be ``effectively mandatory'',
6621160da92SJoerg Wunsch# as it is required for `telnetd', `rlogind', `screen', `emacs', and
6631160da92SJoerg Wunsch# `xterm', among others.
6641160da92SJoerg Wunsch
6652aba17b3SGary Palmerpseudo-device	pty	16	#Pseudo ttys - can go as high as 256
6666a8d6623SGarrett Wollmanpseudo-device	speaker		#Play IBM BASIC-style noises out your speaker
6676a8d6623SGarrett Wollmanpseudo-device	gzip		#Exec gzipped a.out's
668784cf072SPoul-Henning Kamppseudo-device	vn		#Vnode driver (turns a file into a device)
6694cba4555SUgen J.S. Antsilevichpseudo-device	snp	3	#Snoop device - to look at pty/vty/etc..
67003b225a3SSatoshi Asamipseudo-device	ccd	4	#Concatenated disk driver
6719ba0e7c3SBruce Evans
67265e8111fSBruce Evans# These are only for watching for bitrot in old tty code.
67365e8111fSBruce Evans# broken
67465e8111fSBruce Evans#pseudo-device	tb
67565e8111fSBruce Evans
67665e8111fSBruce Evans# These are only for watching for bitrot in old SCSI code.
67765e8111fSBruce Evanspseudo-device	su		#scsi user
67865e8111fSBruce Evanspseudo-device	ssc		#super scsi
67965e8111fSBruce Evans
68058067a99SPoul-Henning Kamp# Size of the kernel message buffer.  Should be N * pagesize.
68158067a99SPoul-Henning Kampoptions		"MSGBUF_SIZE=40960"
68258067a99SPoul-Henning Kamp
6836a8d6623SGarrett Wollman
6846a8d6623SGarrett Wollman#####################################################################
6856a8d6623SGarrett Wollman# HARDWARE DEVICE CONFIGURATION
6866a8d6623SGarrett Wollman
6876a8d6623SGarrett Wollman# ISA and EISA devices:
688c37ddbb8SJoerg Wunsch# EISA support is available for some device, so they can be auto-probed.
6896a8d6623SGarrett Wollman# Micro Channel is not supported at all.
6906a8d6623SGarrett Wollman
6916a8d6623SGarrett Wollman#
692343b84b4SJoerg Wunsch# Mandatory ISA devices: isa, npx
6936a8d6623SGarrett Wollman#
6942365e64fSRodney W. Grimescontroller	isa0
6952365e64fSRodney W. Grimes
6966a8d6623SGarrett Wollman#
6976a8d6623SGarrett Wollman# Options for `isa':
6986a8d6623SGarrett Wollman#
699d72ee36fSBruce Evans# AUTO_EOI_1 enables the `automatic EOI' feature for the master 8259A
700d72ee36fSBruce Evans# interrupt controller.  This saves about 0.7-1.25 usec for each interrupt.
701d72ee36fSBruce Evans# This option breaks suspend/resume on some portables.
702d72ee36fSBruce Evans#
7039ba0e7c3SBruce Evans# AUTO_EOI_2 enables the `automatic EOI' feature for the slave 8259A
704d72ee36fSBruce Evans# interrupt controller.  This saves about 0.7-1.25 usec for each interrupt.
7059ba0e7c3SBruce Evans# Automatic EOI is documented not to work for for the slave with the
7069ba0e7c3SBruce Evans# original i8259A, but it works for some clones and some integrated
7079ba0e7c3SBruce Evans# versions.
7089ba0e7c3SBruce Evans#
7096a8d6623SGarrett Wollman# BOUNCE_BUFFERS provides support for ISA DMA on machines with more
7106a8d6623SGarrett Wollman# than 16 megabytes of memory.  It doesn't hurt on other machines.
7116a8d6623SGarrett Wollman# Some broken EISA and VLB hardware may need this, too.
7123339606dSAndreas Schulz#
713b2796687SNate Williams# MAXMEM specifies the amount of RAM on the machine; if this is not
7149bc192deSDavid E. O'Brien# specified, FreeBSD will first read the amount of memory from the CMOS
7159bc192deSDavid E. O'Brien# RAM, so the amount of memory will initially be limited to 64MB or 16MB
7169bc192deSDavid E. O'Brien# depending on the BIOS.  If the BIOS reports 64MB, a memory probe will
7179bc192deSDavid E. O'Brien# then attempt to detect the installed amount of RAM.  If this probe
7189bc192deSDavid E. O'Brien# fails to detect >64MB RAM you will have to use the MAXMEM option.
7199bc192deSDavid E. O'Brien# The amount is in kilobytes, so for a machine with 128MB of RAM, it would
7209bc192deSDavid E. O'Brien# be 131072 (128 * 1024).
721b2796687SNate Williams#
7223339606dSAndreas Schulz# TUNE_1542 enables the automatic ISA bus speed selection for the
7233339606dSAndreas Schulz# Adaptec 1542 boards. Does not work for all boards, use it with caution.
7243339606dSAndreas Schulz#
7255eb46edfSDavid Greenman# BROKEN_KEYBOARD_RESET disables the use of the keyboard controller to
7265eb46edfSDavid Greenman# reset the CPU for reboot.  This is needed on some systems with broken
7275eb46edfSDavid Greenman# keyboard controllers.
7283eafdedeSBruce Evans#
72977959e8eSMarc G. Fournier# PAS_JOYSTICK_ENABLE enables the gameport on the ProAudio Spectrum
73077959e8eSMarc G. Fournier
731d72ee36fSBruce Evansoptions		"AUTO_EOI_1"
7329ba0e7c3SBruce Evans#options	"AUTO_EOI_2"
7336a8d6623SGarrett Wollmanoptions		BOUNCE_BUFFERS
734a675c0c6SBruce Evansoptions		"MAXMEM=(128*1024)"
735c2469addSEivind Eklundoptions 	"TUNE_1542"
736b1529bdaSPeter Wemm#options	BROKEN_KEYBOARD_RESET
73777959e8eSMarc G. Fournier#options	PAS_JOYSTICK_ENABLE
7383af6b652SDavid Greenman
739595f6341SPoul-Henning Kamp# Enable support for the kernel PLL to use an external PPS signal,
740595f6341SPoul-Henning Kamp# under supervision of [x]ntpd(8)
741595f6341SPoul-Henning Kamp# More info in ftp://ftp.udel.edu/pub/ntp/kernel.tar.Z
742595f6341SPoul-Henning Kamp
743595f6341SPoul-Henning Kampoptions		PPS_SYNC
744595f6341SPoul-Henning Kamp
74553a7a570SJohn-Mark Gurney# Enable PnP support in the kernel.  This allows you to automaticly
74653a7a570SJohn-Mark Gurney# attach to PnP cards for drivers that support it and allows you to
74753a7a570SJohn-Mark Gurney# configure cards from USERCONFIG.  See pnp(4) for more info.
74853a7a570SJohn-Mark Gurneycontroller	pnp0
74953a7a570SJohn-Mark Gurney
750ee16b430SBruce Evans# The pcvt console driver (vt220 compatible).
7517fbcd76bSBruce Evansdevice		vt0	at isa? port "IO_KBD" tty irq 1 vector pcrint
752818de095SJordan K. Hubbardoptions		XSERVER			# support for running an X server.
7537fbcd76bSBruce Evansoptions		FAT_CURSOR		# start with block cursor
754e9aaac99SNate Williams# This PCVT option is for keyboards such as those used on IBM ThinkPad laptops
755b1529bdaSPeter Wemmoptions		PCVT_SCANSET=2 		# IBM keyboards are non-std
7564530be52SJordan K. Hubbard
757ee16b430SBruce Evans# The syscons console driver (sco color console compatible).
7586a8d6623SGarrett Wollmandevice		sc0	at isa? port "IO_KBD" tty irq 1 vector scintr
759683cbdf4SBruce Evansoptions		MAXCONS=16		# number of virtual consoles
760683cbdf4SBruce Evansoptions		SLOW_VGA		# do byte-wide i/o's to TS and GDC regs
76138d8a113SPoul-Henning Kampoptions		"STD8X16FONT"		# Compile font in
76238d8a113SPoul-Henning Kampmakeoptions	"STD8X16FONT"="cp850"
763297976f7SKazutaka YOKOTAoptions		SC_HISTORY_SIZE=200	# number of history buffer lines
764c4118fc0SKazutaka YOKOTAoptions		SC_DISABLE_REBOOT	# disable reboot key sequence
765c0fad1a4SKazutaka YOKOTA# If the screen flickers badly when the mouse pointer is moved, try this.
766c0fad1a4SKazutaka YOKOTAoptions		SC_BAD_FLICKER
7676620cf78SNate Williams
7686620cf78SNate Williams#
7696620cf78SNate Williams# `flags' for sc0:
7706620cf78SNate Williams#       0x01    Use a 'visual' bell
7716620cf78SNate Williams#       0x02    Use a 'blink' cursor
7725d3b1465SKazutaka YOKOTA#       0x04    Use a 'underline' cursor
7735d3b1465SKazutaka YOKOTA#       0x06    Use a 'blinking underline' (destructive) cursor
7746620cf78SNate Williams#       0x08    Force detection of keyboard, else we always assume a keyboard
7756620cf78SNate Williams#       0x10    Old-style (XT) keyboard support, useful for older ThinkPads
7765d3b1465SKazutaka YOKOTA#       0x20    Don't reset keyboard, useful for some newer ThinkPads
777c0fad1a4SKazutaka YOKOTA#	0x40	Make the bell quiet if it is rung in the backgroud vty.
7782ac8be82SAndreas Schulz
7796a8d6623SGarrett Wollman#
78025292acbSBruce Evans# The Numeric Processing eXtension driver.  This should be configured if
78125292acbSBruce Evans# your machine has a math co-processor, unless the coprocessor is very
78225292acbSBruce Evans# buggy. If it is not configured then you *must* configure math emulation
78325292acbSBruce Evans# (see above).  If both npx0 and emulation are configured, then only npx0
78425292acbSBruce Evans# is used (provided it works).
7851fe04850SBruce Evansdevice		npx0	at isa? port "IO_NPX" iosiz 0x0 flags 0x0 irq 13 vector npxintr
7861fe04850SBruce Evans
78798e9e66cSNate Williams#
7881fe04850SBruce Evans# `flags' for npx0:
7891fe04850SBruce Evans#	0x01	don't use the npx registers to optimize bcopy
7901fe04850SBruce Evans#	0x02	don't use the npx registers to optimize bzero
7911fe04850SBruce Evans#	0x04	don't use the npx registers to optimize copyin or copyout.
7921fe04850SBruce Evans# The npx registers are normally used to optimize copying and zeroing when
7931fe04850SBruce Evans# all of the following conditions are satisfied:
7941fe04850SBruce Evans#	"I586_CPU" is an option
7951fe04850SBruce Evans#	the cpu is an i586 (perhaps not a Pentium)
7961fe04850SBruce Evans#	the probe for npx0 succeeds
7971fe04850SBruce Evans#	INT 16 exception handling works.
7981fe04850SBruce Evans# Then copying and zeroing using the npx registers is normally 30-100% faster.
7991fe04850SBruce Evans# The flags can be used to control cases where it doesn't work or is slower.
8001fe04850SBruce Evans# Setting them at boot time using userconfig works right (the optimizations
8011fe04850SBruce Evans# are not used until later in the bootstrap when npx0 is attached).
8021fe04850SBruce Evans#
8031fe04850SBruce Evans
8041fe04850SBruce Evans#
8051fe04850SBruce Evans# `iosiz' for npx0:
8061fe04850SBruce Evans# This can be used instead of the MAXMEM option to set the memory size.  If
8071fe04850SBruce Evans# it is nonzero, then it overrides both the MAXMEM option and the memory
8081fe04850SBruce Evans# size reported by the BIOS.  Setting it at boot time using userconfig takes
8091fe04850SBruce Evans# effect on the next reboot after the change has been recorded in the kernel
8101fe04850SBruce Evans# binary (the size is used early in the boot before userconfig has a chance
8111fe04850SBruce Evans# to change it).
8121fe04850SBruce Evans#
8136a8d6623SGarrett Wollman
8146a8d6623SGarrett Wollman#
8156a8d6623SGarrett Wollman# Optional ISA and EISA devices:
8166a8d6623SGarrett Wollman#
8176a8d6623SGarrett Wollman
8186a8d6623SGarrett Wollman#
819e56e7036SJustin T. Gibbs# SCSI host adapters: `aha', `aic', `bt', `nca'
8206a8d6623SGarrett Wollman#
8216a8d6623SGarrett Wollman# aha: Adaptec 154x
8229829c3edSJordan K. Hubbard# ahc: Adaptec 274x/284x/294x
8236a8d6623SGarrett Wollman# aic: Adaptec 152x and sound cards using the Adaptec AIC-6360 (slow!)
8246a8d6623SGarrett Wollman# bt: Most Buslogic controllers
825e05407d8SPoul-Henning Kamp# nca: ProAudioSpectrum cards using the NCR 5380 or Trantor T130
826a2ba45e5SAndreas Klemm# uha: UltraStor ULTRA 14F/24F/34F
8273c43212aSSøren Schmidt# sea: Seagate ST01/02 8 bit controller (slow!)
8283691d2b9SJordan K. Hubbard# wds: Western Digital WD7000 controller (no scatter/gather!).
8296a8d6623SGarrett Wollman#
8306a8d6623SGarrett Wollman# Note that the order is important in order for Buslogic cards to be
8316a8d6623SGarrett Wollman# probed correctly.
8326a8d6623SGarrett Wollman#
8336a8d6623SGarrett Wollman
834a1d01dafSJustin T. Gibbscontroller	bt0	at isa? port "IO_BT0" bio irq ? vector bt_isa_intr
8356a8d6623SGarrett Wollmancontroller	aha0	at isa? port "IO_AHA0" bio irq ? drq 5 vector ahaintr
8366a8d6623SGarrett Wollmancontroller	uha0	at isa? port "IO_UHA0" bio irq ? drq 5 vector uhaintr
8376a8d6623SGarrett Wollman
8386a8d6623SGarrett Wollmancontroller      aic0    at isa? port 0x340 bio irq 11 vector aicintr
839e05407d8SPoul-Henning Kampcontroller	nca0	at isa? port 0x1f88 bio irq 10 vector ncaintr
840e05407d8SPoul-Henning Kampcontroller	nca1	at isa? port 0x1f84
841e05407d8SPoul-Henning Kampcontroller	nca2	at isa? port 0x1f8c
842e05407d8SPoul-Henning Kampcontroller	nca3	at isa? port 0x1e88
843e05407d8SPoul-Henning Kampcontroller	nca4	at isa? port 0x350 bio irq 5 vector ncaintr
84445b4c36fSJordan K. Hubbard
8453c43212aSSøren Schmidtcontroller	sea0	at isa? bio irq 5 iomem 0xdc000 iosiz 0x2000 vector seaintr
8463691d2b9SJordan K. Hubbardcontroller	wds0	at isa? port 0x350 bio irq 15 drq 6 vector wdsintr
8473c43212aSSøren Schmidt
8486a8d6623SGarrett Wollman#
8496a8d6623SGarrett Wollman# ST-506, ESDI, and IDE hard disks: `wdc' and `wd'
8506a8d6623SGarrett Wollman#
851e3dd3158SJohn Dyson# The flags fields are used to enable the multi-sector I/O and
852e3dd3158SJohn Dyson# the 32BIT I/O modes.  The flags may be used in either the controller
853e3dd3158SJohn Dyson# definition or in the individual disk definitions.  The controller
854e3dd3158SJohn Dyson# definition is supported for the boot configuration stuff.
855e3dd3158SJohn Dyson#
856e3dd3158SJohn Dyson# Each drive has a 16 bit flags value defined:
857e3dd3158SJohn Dyson#	The low 8 bits are the maximum value for the multi-sector I/O,
858e3dd3158SJohn Dyson#	where 0xff defaults to the maximum that the drive can handle.
859e3dd3158SJohn Dyson#	The high bit of the 16 bit flags (0x8000) allows probing for
8601f7727a9SSøren Schmidt#	32 bit transfers.  Bit 14 (0x4000) enables a hack to wake
8611f7727a9SSøren Schmidt#	up powered-down laptop drives.  Bit 13 (0x2000) allows
8621f7727a9SSøren Schmidt#	probing for PCI IDE DMA controllers, such as Intel's PIIX
863f559a836SSøren Schmidt#	south bridges. Bit 12 (0x1000) sets LBA mode instead of the
864f559a836SSøren Schmidt#	default CHS mode for accessing the drive. See the wd.4 man page.
865e3dd3158SJohn Dyson#
866e3dd3158SJohn Dyson# The flags field for the drives can be specified in the controller
867e3dd3158SJohn Dyson# specification with the low 16 bits for drive 0, and the high 16 bits
868e3dd3158SJohn Dyson# for drive 1.
869e3dd3158SJohn Dyson# e.g.:
870e3dd3158SJohn Dyson#controller	wdc0	at isa? port "IO_WD1" bio irq 14 flags 0x00ff8004 vector wdintr
871e3dd3158SJohn Dyson#
872e3dd3158SJohn Dyson# specifies that drive 0 will be allowed to probe for 32 bit transfers and
873e3dd3158SJohn Dyson# a maximum multi-sector transfer of 4 sectors, and drive 1 will not be
874e3dd3158SJohn Dyson# allowed to probe for 32 bit transfers, but will allow multi-sector
875e3dd3158SJohn Dyson# transfers up to the maximum that the drive supports.
876e3dd3158SJohn Dyson#
877e871e61fSJohn Dyson# If you are using a PCI controller that is not running in compatibility
878e871e61fSJohn Dyson# mode (for example, it is a 2nd IDE PCI interface), then use config line(s)
879e871e61fSJohn Dyson# such as:
880e3dd3158SJohn Dyson#
881e871e61fSJohn Dyson#controller	wdc2	at isa? port "0" bio irq ? flags 0xa0ffa0ff vector wdintr
882e871e61fSJohn Dyson#disk		wd4	at wdc2 drive 0
883e871e61fSJohn Dyson#disk		wd5	at wdc2 drive 1
884e871e61fSJohn Dyson#
885e871e61fSJohn Dyson#controller	wdc3	at isa? port "0" bio irq ? flags 0xa0ffa0ff vector wdintr
886e871e61fSJohn Dyson#disk		wd6	at wdc3 drive 0
887e871e61fSJohn Dyson#disk		wd7	at wdc3 drive 1
888e871e61fSJohn Dyson#
889e871e61fSJohn Dyson# Note that the above config would be useful for a Promise card, when used
890e871e61fSJohn Dyson# on a MB that already has a PIIX controller.  Note the bogus irq and port
891e871e61fSJohn Dyson# entries.  These are automatically filled in by the IDE/PCI support.
892e871e61fSJohn Dyson#
893e871e61fSJohn Dyson
8942620c42eSNate Williamscontroller	wdc0	at isa? port "IO_WD1" bio irq 14 vector wdintr
8952620c42eSNate Williamsdisk		wd0	at wdc0 drive 0
8962620c42eSNate Williamsdisk		wd1	at wdc0 drive 1
8972620c42eSNate Williamscontroller	wdc1	at isa? port "IO_WD2" bio irq 15 vector wdintr
8982620c42eSNate Williamsdisk		wd2	at wdc1 drive 0
8992620c42eSNate Williamsdisk		wd3	at wdc1 drive 1
9002365e64fSRodney W. Grimes
9016a8d6623SGarrett Wollman#
9026788ce49SJordan K. Hubbard# Options for `wdc':
9036788ce49SJordan K. Hubbard#
9042928e6b5SStefan Eßer# CMD640 enables serializing access to primary and secondary channel
9052928e6b5SStefan Eßer# of the CMD640B IDE Chip. The serializing will only take place
9062928e6b5SStefan Eßer# if this option is set *and* the chip is probed by the pci-system.
9072928e6b5SStefan Eßer#
9082928e6b5SStefan Eßeroptions         "CMD640"	#Enable work around for CMD640 h/w bug
9092928e6b5SStefan Eßer#
9106788ce49SJordan K. Hubbard# ATAPI enables the support for ATAPI-compatible IDE devices
9116788ce49SJordan K. Hubbard#
9126788ce49SJordan K. Hubbardoptions         ATAPI   #Enable ATAPI support for IDE bus
9137b2305f7SAndrey A. Chernovoptions		ATAPI_STATIC	#Don't do it as an LKM
9146788ce49SJordan K. Hubbard
9156788ce49SJordan K. Hubbard# IDE CD-ROM driver - requires wdc controller and ATAPI option
9166788ce49SJordan K. Hubbarddevice          wcd0
9176788ce49SJordan K. Hubbard
918aaf86206SPaul Traina# IDE floppy driver - requires wdc controller and ATAPI option
919aaf86206SPaul Trainadevice          wfd0
920aaf86206SPaul Traina
921ea0be999SBruce Evans# IDE tape driver - requires wdc controller and ATAPI option
922ea0be999SBruce Evansdevice          wst0
923ea0be999SBruce Evans
924aaf86206SPaul Traina
9256788ce49SJordan K. Hubbard#
9266a8d6623SGarrett Wollman# Standard floppy disk controllers and floppy tapes: `fdc', `fd', and `ft'
9276a8d6623SGarrett Wollman#
9286a8d6623SGarrett Wollmancontroller	fdc0	at isa? port "IO_FD1" bio irq 6 drq 2 vector fdintr
92985827d9cSJoerg Wunsch#
930d2fb4892SJoerg Wunsch# FDC_DEBUG enables floppy debugging.  Since the debug output is huge, you
931d2fb4892SJoerg Wunsch# gotta turn it actually on by setting the variable fd_debug with DDB,
932d2fb4892SJoerg Wunsch# however.
933d2fb4892SJoerg Wunschoptions		FDC_DEBUG
934d2fb4892SJoerg Wunsch# This option is undocumented on purpose.
935d2fb4892SJoerg Wunschoptions		FDC_PRINT_BOGUS_CHIPTYPE
936d2fb4892SJoerg Wunsch#
93785827d9cSJoerg Wunsch# Activate this line instead of the fdc0 line above if you happen to
93885827d9cSJoerg Wunsch# have an Insight floppy tape.  Probing them proved to be dangerous
93985827d9cSJoerg Wunsch# for people with floppy disks only, so it's "hidden" behind a flag:
94085827d9cSJoerg Wunsch#controller fdc0 at isa? port "IO_FD1" bio flags 1 irq 6 drq 2 vector fdintr
94185827d9cSJoerg Wunsch
9426a8d6623SGarrett Wollmandisk		fd0	at fdc0 drive 0
9436a8d6623SGarrett Wollmandisk		fd1	at fdc0 drive 1
9446a8d6623SGarrett Wollmantape		ft0	at fdc0 drive 2
9456a8d6623SGarrett Wollman
94685827d9cSJoerg Wunsch
9476a8d6623SGarrett Wollman#
9482f6df264SJordan K. Hubbard# Other standard PC hardware: `lpt', `mse', `psm', `sio', etc.
9496a8d6623SGarrett Wollman#
9506a8d6623SGarrett Wollman# lpt: printer port
9517fe369dcSJoerg Wunsch#	lpt specials:
9527fe369dcSJoerg Wunsch#		port can be specified as ?, this will cause the driver to scan
9537fe369dcSJoerg Wunsch#		the BIOS port list;
9547fe369dcSJoerg Wunsch#		the irq and vector clauses may be omitted, this
9557fe369dcSJoerg Wunsch#		will force the port into polling mode.
9566a8d6623SGarrett Wollman# mse: Logitech and ATI InPort bus mouse ports
9579cc34748SJordan K. Hubbard# psm: PS/2 mouse port [note: conflicts with sc0/vt0, thus "conflicts" keywd]
9586a8d6623SGarrett Wollman# sio: serial ports (see sio(4))
9596a8d6623SGarrett Wollman
9607fe369dcSJoerg Wunschdevice		lpt0	at isa? port? tty irq 7 vector lptintr
9617fe369dcSJoerg Wunschdevice		lpt1	at isa? port "IO_LPT3" tty irq 5 vector lptintr
9626a8d6623SGarrett Wollmandevice		mse0	at isa? port 0x23c tty irq 5 vector mseintr
9639cc34748SJordan K. Hubbarddevice		psm0	at isa? port "IO_KBD" conflicts tty irq 12 vector psmintr
9643e176bdfSKazutaka YOKOTA
965975c53c7SDoug Rabson# Options for psm:
9665d3b1465SKazutaka YOKOTAoptions		PSM_HOOKAPM		#hook the APM resume event, useful
9675d3b1465SKazutaka YOKOTA					#for some laptops
9685d3b1465SKazutaka YOKOTAoptions		PSM_RESETAFTERSUSPEND	#reset the device at the resume event
969975c53c7SDoug Rabson
9709546766aSBruce Evansdevice		sio0	at isa? port "IO_COM1" tty flags 0x10 irq 4 vector siointr
9719546766aSBruce Evans
9729546766aSBruce Evans#
9739546766aSBruce Evans# `flags' for serial drivers that support consoles (only for sio now):
9749546766aSBruce Evans#	0x10	enable console support for this unit.  The other console flags
9759546766aSBruce Evans#		are ignored unless this is set.  Enabling console support does
9769546766aSBruce Evans#		not make the unit the preferred console - boot with -h or set
9779546766aSBruce Evans#		the 0x20 flag for that.  Currently, at most one unit can have
9789546766aSBruce Evans#		console support; the first one (in config file order) with
9799546766aSBruce Evans#		this flag set is preferred.  Setting this flag for sio0 gives
9809546766aSBruce Evans#		the old behaviour.
9819546766aSBruce Evans#	0x20	force this unit to be the console (unless there is another
9829546766aSBruce Evans#		higher priority console).  This replaces the COMCONSOLE option.
9839546766aSBruce Evans#	0x40	reserve this unit for low level console operations.  Do not
9849546766aSBruce Evans#
9856a796ce0SJohn-Mark Gurney# PnP `flags' (set via userconfig using pnp x flags y)
9866a796ce0SJohn-Mark Gurney#	0x1	disable probing of this device.  Used to prevent your modem
9876a796ce0SJohn-Mark Gurney#		from being attached as a PnP modem.
9886a796ce0SJohn-Mark Gurney#
9899546766aSBruce Evans
9909546766aSBruce Evans# Options for serial drivers that support consoles (only for sio now):
9919546766aSBruce Evansoptions		BREAK_TO_DEBUGGER	#a BREAK on a comconsole goes to
9929546766aSBruce Evans					#DDB, if available.
9935ea6cb03SPaul Trainaoptions		CONSPEED=9600		#default speed for serial console (default 9600)
9946a8d6623SGarrett Wollman
9956a8d6623SGarrett Wollman# Options for sio:
996768fd661SBruce Evansoptions		COM_ESP			#code for Hayes ESP
9979ba0e7c3SBruce Evansoptions		COM_MULTIPORT		#code for some cards with shared IRQs
9986a8d6623SGarrett Wollmanoptions		DSI_SOFT_MODEM		#code for DSI Softmodems
9996a796ce0SJohn-Mark Gurneyoptions		"EXTRA_SIO=2"		#number of extra sio ports to allocate
10006a8d6623SGarrett Wollman
100196b89afcSBruce Evans# Other flags for sio that aren't documented in the man page.
100296b89afcSBruce Evans#	0x20000	enable hardware RTS/CTS and larger FIFOs.  Only works for
100396b89afcSBruce Evans#		ST16650A-compatible UARTs.
100496b89afcSBruce Evans
10056a8d6623SGarrett Wollman#
100683401efaSGarrett Wollman# Network interfaces: `cx', `ed', `el', `ep', `ie', `is', `le', `lnc'
10076a8d6623SGarrett Wollman#
10086c5e9bbdSMike Pritchard# ar: Arnet SYNC/570i hdlc sync 2/4 port V.35/X.21 serial driver (requires sppp)
1009b16d163dSMike Smith# cs: IBM Etherjet and other Crystal Semi CS89x0-based adapters
101083401efaSGarrett Wollman# cx: Cronyx/Sigma multiport sync/async (with Cisco or PPP framing)
10116a8d6623SGarrett Wollman# ed: Western Digital and SMC 80xx; Novell NE1000 and NE2000; 3Com 3C503
10126a8d6623SGarrett Wollman# el: 3Com 3C501 (slow!)
10136a8d6623SGarrett Wollman# ep: 3Com 3C509 (buggy)
10141a7c583cSGarrett Wollman# fe: Fujitsu MB86960A/MB86965A Ethernet
10150f1d6a82SSteve Price# ie: AT&T StarLAN 10 and EN100; 3Com 3C507; unknown NI5210; Intel EtherExpress
10166a8d6623SGarrett Wollman# le: Digital Equipment EtherWorks 2 and EtherWorks 3 (DEPCA, DE100,
10176a8d6623SGarrett Wollman#     DE101, DE200, DE201, DE202, DE203, DE204, DE205, DE422)
101894187a78SPaul Richards# lnc: Lance/PCnet cards (Isolan, Novell NE2100, NE32-VL)
1019d805b866SJohn Hay# sr: RISCom/N2 hdlc sync 1/2 port V.35/X.21 serial driver (requires sppp)
102098d46ad0SMike Smith# wl: Lucent Wavelan (ISA card only).
1021648c711bSPoul-Henning Kamp# ze: IBM/National Semiconductor PCMCIA ethernet controller.
1022648c711bSPoul-Henning Kamp# zp: 3Com PCMCIA Etherlink III (It does not require shared memory for
1023648c711bSPoul-Henning Kamp#     send/receive operation, but it needs 'iomem' to read/write the
1024648c711bSPoul-Henning Kamp#     attribute memory)
10256a8d6623SGarrett Wollman#
10266a8d6623SGarrett Wollman
1027e7c234a1SPeter Wemmdevice ar0 at isa? port 0x300 net irq 10 iomem 0xd0000 vector arintr
1028b16d163dSMike Smithdevice cs0 at isa? port 0x300 net irq ? vector csintr
102983401efaSGarrett Wollmandevice cx0 at isa? port 0x240 net irq 15 drq 7 vector cxintr
10306a8d6623SGarrett Wollmandevice ed0 at isa? port 0x280 net irq 5 iomem 0xd8000 vector edintr
103112cfa436SPoul-Henning Kampdevice eg0 at isa? port 0x310 net irq 5 vector egintr
10326a8d6623SGarrett Wollmandevice el0 at isa? port 0x300 net irq 9 vector elintr
1033d41f24e7SDavid Greenmandevice ep0 at isa? port 0x300 net irq 10 vector epintr
10340942673fSJordan K. Hubbarddevice ex0 at isa? port? net irq? vector exintr
1035a732b754SJordan K. Hubbarddevice fe0 at isa? port 0x300 net irq ? vector feintr
1036c1aa7eb5SJustin T. Gibbsdevice ie0 at isa? port 0x300 net irq 5 iomem 0xd0000 vector ieintr
1037c1aa7eb5SJustin T. Gibbsdevice ie1 at isa? port 0x360 net irq 7 iomem 0xd0000 vector ieintr
10386a8d6623SGarrett Wollmandevice le0 at isa? port 0x300 net irq 5 iomem 0xd0000 vector le_intr
103963373752SPoul-Henning Kampdevice lnc0 at isa? port 0x300 net irq 10 drq 0 vector lncintr
1040d805b866SJohn Haydevice sr0 at isa? port 0x300 net irq 5 iomem 0xd0000 vector srintr
10413476cdb9SMike Smithoptions		WLCACHE		# enables the signal-strength cache
10423476cdb9SMike Smithoptions		WLDEBUG		# enables verbose debugging output
10432321ce34SPeter Wemmdevice wl0 at isa? port 0x300 net irq ? vector wlintr
1044346ebe51SEivind Eklund# We can (bogusly) include both the dedicated PCCARD drivers and the generic
1045346ebe51SEivind Eklund# support when COMPILING_LINT.
1046ada9d061SJordan K. Hubbarddevice ze0 at isa? port 0x300 net irq 5 iomem 0xd8000 vector zeintr
1047648c711bSPoul-Henning Kampdevice zp0 at isa? port 0x300 net irq 10 iomem 0xd8000 vector zpintr
1048648c711bSPoul-Henning Kamp
104968713f97SKenjiro Cho#
105068713f97SKenjiro Cho# ATM related options
105168713f97SKenjiro Cho#
105268713f97SKenjiro Cho# The `en' device provides support for Efficient Networks (ENI)
105368713f97SKenjiro Cho# ENI-155 PCI midway cards, and the Adaptec 155Mbps PCI ATM cards (ANA-59x0).
105468713f97SKenjiro Cho#
10553cbceb82SKenjiro Cho# atm pseudo-device provides generic atm functions and is required for
105668713f97SKenjiro Cho# atm devices.
10573cbceb82SKenjiro Cho# NATM enables the netnatm protocol family that can be used to
105868713f97SKenjiro Cho# bypass TCP/IP.
105968713f97SKenjiro Cho#
106068713f97SKenjiro Cho# the current driver supports only PVC operations (no atm-arp, no multicast).
106168713f97SKenjiro Cho# for more details, please read the original documents at
106268713f97SKenjiro Cho# http://www.ccrc.wustl.edu/pub/chuck/bsdatm/wucs.html
106368713f97SKenjiro Cho#
106468713f97SKenjiro Chopseudo-device	atm
106568713f97SKenjiro Chodevice en0
106668713f97SKenjiro Chodevice en1
10673cbceb82SKenjiro Chooptions		NATM			#native ATM
1068f4567b9cSJulian Elischer
10691a7c583cSGarrett Wollman#
10701a7c583cSGarrett Wollman# Audio drivers: `snd', `sb', `pas', `gus', `pca'
10716a8d6623SGarrett Wollman#
10721a7c583cSGarrett Wollman# snd: Voxware sound support code
10731a7c583cSGarrett Wollman# sb: SoundBlaster PCM - SoundBlaster, SB Pro, SB16, ProAudioSpectrum
10741a7c583cSGarrett Wollman# sbxvi: SoundBlaster 16
10751a7c583cSGarrett Wollman# sbmidi: SoundBlaster 16 MIDI interface
10761a7c583cSGarrett Wollman# pas: ProAudioSpectrum PCM and MIDI
10771a7c583cSGarrett Wollman# gus: Gravis Ultrasound - Ultrasound, Ultrasound 16, Ultrasound MAX
1078a2048b9cSJordan K. Hubbard# gusxvi: Gravis Ultrasound 16-bit PCM	(do not use)
10791a7c583cSGarrett Wollman# mss: Microsoft Sound System
10805eaf45f6SPeter Wemm# css: Crystal Sound System (CSS 423x PnP)
108161ca8499SMark Murray# sscape: Ensoniq Soundscape MIDI interface
108261ca8499SMark Murray# sscape_mss: Ensoniq Soundscape PCM (requires sscape)
10831a7c583cSGarrett Wollman# opl: Yamaha OPL-2 and OPL-3 FM - SB, SB Pro, SB 16, ProAudioSpectrum
10841a7c583cSGarrett Wollman# uart: stand-alone 6850 UART for MIDI
10851a7c583cSGarrett Wollman# mpu: Roland MPU-401 stand-alone card
10861a7c583cSGarrett Wollman#
10871a7c583cSGarrett Wollman# Beware!  The addresses specified below are also hard-coded in
10881a7c583cSGarrett Wollman# i386/isa/sound/sound_config.h.  If you change the values here, you
10891a7c583cSGarrett Wollman# must also change the values in the include file.
10901a7c583cSGarrett Wollman#
1091c7406082SJohn-Mark Gurney# pcm: PCM audio through various sound cards.
1092c7406082SJohn-Mark Gurney#
1093c7406082SJohn-Mark Gurney# This is the work in progress from Luigi Rizzo.  This has support for
1094c7406082SJohn-Mark Gurney# CS423x based cards, OPTi931, SB16 PnP, GusPnP.  For more information
1095c7406082SJohn-Mark Gurney# about this driver, take a look at sys/i386/isa/snd/README.
1096c7406082SJohn-Mark Gurney#
1097c7406082SJohn-Mark Gurney# The flags of the device tells the device a bit more info about the
1098c7406082SJohn-Mark Gurney# device that normally is obtained through the PnP interface.
1099c7406082SJohn-Mark Gurney#	bit  2..0   secondary DMA channel;
1100c7406082SJohn-Mark Gurney#	bit  4      set if the board uses two dma channels;
1101c7406082SJohn-Mark Gurney#	bit 15..8   board type, overrides autodetection; leave it
1102c7406082SJohn-Mark Gurney#		    zero if don't know what to put in (and you don't,
1103c7406082SJohn-Mark Gurney#		    since this is unsupported at the moment...).
1104c7406082SJohn-Mark Gurney#
1105c7406082SJohn-Mark Gurney# This driver will use the new PnP code if it's available.
1106c7406082SJohn-Mark Gurney#
11076a8d6623SGarrett Wollman# pca: PCM audio through your PC speaker
11086a8d6623SGarrett Wollman#
1109d1a599c2SJordan K. Hubbard# If you have a GUS-MAX card and want to use the CS4231 codec on the
1110d1a599c2SJordan K. Hubbard# card the drqs for the gus max must be 8 bit (1, 2, or 3).
1111d1a599c2SJordan K. Hubbard#
1112d1a599c2SJordan K. Hubbard# If you would like to use the full duplex option on the gus, then define
1113d1a599c2SJordan K. Hubbard# flags to be the ``read dma channel''.
1114d1a599c2SJordan K. Hubbard#
1115d1a599c2SJordan K. Hubbard# options BROKEN_BUS_CLOCK	#PAS-16 isn't working and OPTI chipset
1116d1a599c2SJordan K. Hubbard# options SYMPHONY_PAS		#PAS-16 isn't working and SYMPHONY chipset
1117d1a599c2SJordan K. Hubbard# options EXCLUDE_SBPRO		#PAS-16
1118b1529bdaSPeter Wemm# options SBC_IRQ=5		#PAS-16. Must match irq on sb0 line.
1119d1a599c2SJordan K. Hubbard# PAS16: The order of the pas0/sb0/opl0 is important since the
1120d1a599c2SJordan K. Hubbard#	sb emulation is enabled in the pas-16 attach.
1121d1a599c2SJordan K. Hubbard#
1122a9e837f4SJohn-Mark Gurney# To overide the GUS defaults use:
1123a9e837f4SJohn-Mark Gurney# options GUS_DMA2
1124a9e837f4SJohn-Mark Gurney# options GUS_DMA
1125a9e837f4SJohn-Mark Gurney# options GUS_IRQ
1126a9e837f4SJohn-Mark Gurney#
1127d1a599c2SJordan K. Hubbard# The i386/isa/sound/sound.doc has more information.
1128a2048b9cSJordan K. Hubbard
11298b8cd792SJordan K. Hubbard# Controls all "VOXWARE" driver sound devices.  See Luigi's driver
11308b8cd792SJordan K. Hubbard# below for an alternate which may work better for some cards.
11318b8cd792SJordan K. Hubbard#
113212fd0853SSteven Wallacecontroller	snd0
1133d1a599c2SJordan K. Hubbarddevice pas0     at isa? port 0x388 irq 10 drq 6 vector pasintr
113429a4cf6dSAndrey A. Chernovdevice sb0      at isa? port 0x220 irq 5 drq 1 vector sbintr
113529a4cf6dSAndrey A. Chernovdevice sbxvi0   at isa? drq 5
113629a4cf6dSAndrey A. Chernovdevice sbmidi0  at isa? port 0x330
113729a4cf6dSAndrey A. Chernovdevice awe0     at isa? port 0x620
11388e411548SJordan K. Hubbarddevice gus0 at isa? port 0x220 irq 12 drq 1 vector gusintr
11398e411548SJordan K. Hubbard#device gus0 at isa? port 0x220 irq 12 drq 1 flags 0x3 vector gusintr
114012fd0853SSteven Wallacedevice mss0 at isa? port 0x530 irq 10 drq 1 vector adintr
1141ee16b430SBruce Evansdevice css0	at isa? port 0x534 irq 5 drq 1 flags 0x08 vector adintr
114261ca8499SMark Murraydevice sscape0  at isa? port 0x330 irq 9 drq 0 vector sscapeintr
1143ee16b430SBruce Evansdevice trix0    at isa? port 0x330 irq 6 drq 0 vector sscapeintr
114461ca8499SMark Murraydevice sscape_mss0  at isa? port 0x534 irq 5 drq 1 vector sndintr
114529a4cf6dSAndrey A. Chernovdevice opl0     at isa? port 0x388
1146a91ccb55SSteven Wallacedevice mpu0     at isa? port 0x330 irq 6 drq 0
114712fd0853SSteven Wallacedevice uart0 at isa? port 0x330 irq 5 vector "m6850intr"
11480897a95dSAndrey A. Chernov
11498b8cd792SJordan K. Hubbard# Luigi's snd code (use INSTEAD of snd0 and all VOXWARE drivers!).
11508b8cd792SJordan K. Hubbard# You may also wish to enable the pnp controller with this, for pnp
11518b8cd792SJordan K. Hubbard# sound cards.
11528b8cd792SJordan K. Hubbard#
1153c7406082SJohn-Mark Gurney#device pcm0 at isa? port ? tty irq 10 drq 1 flags 0x0 vector pcmintr
1154c7406082SJohn-Mark Gurney
11551a7c583cSGarrett Wollman# Not controlled by `snd'
1156017e602cSAndrey A. Chernovdevice pca0 at isa? port IO_TIMER1 tty
11579ad380abSGarrett Wollman
11586a8d6623SGarrett Wollman#
1159567e21c2SBruce Evans# Miscellaneous hardware:
11606a8d6623SGarrett Wollman#
11616a8d6623SGarrett Wollman# mcd: Mitsumi CD-ROM
11622d859864SAndreas Schulz# scd: Sony CD-ROM
116305e1d9d4SJordan K. Hubbard# matcd: Matsushita/Panasonic CD-ROM
11646a8d6623SGarrett Wollman# wt: Wangtek and Archive QIC-02/QIC-36 tape drives
11656a8d6623SGarrett Wollman# ctx: Cortex-I frame grabber
11666a8d6623SGarrett Wollman# apm: Laptop Advanced Power Management (experimental)
11676c5e9bbdSMike Pritchard# spigot: The Creative Labs Video Spigot video-acquisition board
11681d86961eSJordan K. Hubbard# meteor: Matrox Meteor video capture board
1169a1e9e308SJamil J. Weatherbee# alog: Industrial Computer Source AIO8-P driver
11706baab376SJohn-Mark Gurney# bktr: Bt848 capture boards (http://www.freebsd.org/~fsmp/HomeAuto/Bt848.html)
117165e8111fSBruce Evans# cy: Cyclades serial driver
1172a50cd483SJordan K. Hubbard# dgb: Digiboard PC/Xi and PC/Xe series driver (ALPHA QUALITY!)
1173c35bda94SBrian Somers# dgm: Digiboard PC/Xem driver
11741a7c583cSGarrett Wollman# gp:  National Instruments AT-GPIB and AT-GPIB/TNT board
1175a800f455SJulian Elischer# asc: GI1904-based hand scanners, e.g. the Trust Amiscan Grey
11761a7c583cSGarrett Wollman# gsc: Genius GS-4500 hand scanner.
11771a7c583cSGarrett Wollman# joy: joystick
1178657e73c4SPeter Dufault# labpc: National Instrument's Lab-PC and Lab-PC+
1179d0930614SAndrey A. Chernov# rc: RISCom/8 multiport card
11803b577e1fSJordan K. Hubbard# rp: Comtrol Rocketport(ISA) - single card
1181567e21c2SBruce Evans# tw: TW-523 power line interface for use with X-10 home control products
11820d04cf6aSPeter Wemm# si: Specialix SI/XIO 4-32 port terminal multiplexor
1183c9da1b81SPeter Wemm# stl: Stallion EasyIO and EasyConnection 8/32 (cd1400 based)
1184c9da1b81SPeter Wemm# stli: Stallion EasyConnection 8/64, ONboard, Brumby (intelligent)
1185657e73c4SPeter Dufault
11866a8d6623SGarrett Wollman#
1187e597b497SNate Williams# Notes on APM
11883d4d8fe9SPoul-Henning Kamp#  The flags takes the following meaning for apm0:
11893d4d8fe9SPoul-Henning Kamp#    0x0020  Statclock is broken.
11903d4d8fe9SPoul-Henning Kamp#    0x0011  Limit APM protocol to 1.1 or 1.0
11913d4d8fe9SPoul-Henning Kamp#    0x0010  Limit APM protocol to 1.0
1192e597b497SNate Williams#
1193e597b497SNate Williams#
11942cd01159SJordan K. Hubbard# Notes on the spigot:
11952cd01159SJordan K. Hubbard#  The video spigot is at 0xad6.  This port address can not be changed.
11962cd01159SJordan K. Hubbard#  The irq values may only be 10, 11, or 15
11972cd01159SJordan K. Hubbard#  I/O memory is an 8kb region.  Possible values are:
11982cd01159SJordan K. Hubbard#    0a0000, 0a2000, ..., 0fffff, f00000, f02000, ..., ffffff
1199d01b6680SJordan K. Hubbard#    The start address must be on an even boundary.
1200d01b6680SJordan K. Hubbard#  Add the following option if you want to allow non-root users to be able
1201d01b6680SJordan K. Hubbard#  to access the spigot.  This option is not secure because it allows users
1202d01b6680SJordan K. Hubbard#  direct access to the I/O page.
1203d01b6680SJordan K. Hubbard#  	options SPIGOT_UNSECURE
1204d01b6680SJordan K. Hubbard#
12058819d6ecSPoul-Henning Kamp
12063b577e1fSJordan K. Hubbard# Notes on the Comtrol Rocketport driver:
12073b577e1fSJordan K. Hubbard#
12083b577e1fSJordan K. Hubbard# The exact values used for rp0 depend on how many boards you have
12093b577e1fSJordan K. Hubbard# in the system.  The manufacturer's sample configs are listed as:
12103b577e1fSJordan K. Hubbard#
12113b577e1fSJordan K. Hubbard#   Comtrol Rocketport ISA single card
12123b577e1fSJordan K. Hubbard#               device  rp0     at isa? port 0x280 tty
12133b577e1fSJordan K. Hubbard#
12143b577e1fSJordan K. Hubbard#   If instead you have two ISA cards, one installed at 0x100 and the
12153b577e1fSJordan K. Hubbard#   second installed at 0x180, then you should add the following to
12163b577e1fSJordan K. Hubbard#   your kernel configuration file:
12173b577e1fSJordan K. Hubbard#
12183b577e1fSJordan K. Hubbard#               device  rp0     at isa? port 0x100 tty
12193b577e1fSJordan K. Hubbard#               device  rp1     at isa? port 0x180 tty
12203b577e1fSJordan K. Hubbard#
12213b577e1fSJordan K. Hubbard#   For 4 ISA cards, it might be something like this:
12223b577e1fSJordan K. Hubbard#
12233b577e1fSJordan K. Hubbard#               device  rp0     at isa? port 0x180 tty
12243b577e1fSJordan K. Hubbard#               device  rp1     at isa? port 0x100 tty
12253b577e1fSJordan K. Hubbard#               device  rp2     at isa? port 0x340 tty
12263b577e1fSJordan K. Hubbard#               device  rp3     at isa? port 0x240 tty
12273b577e1fSJordan K. Hubbard#
12283b577e1fSJordan K. Hubbard#   And for PCI cards, you only need say:
12293b577e1fSJordan K. Hubbard#
12303b577e1fSJordan K. Hubbard#               device rp0
12313b577e1fSJordan K. Hubbard#               device rp1
12323b577e1fSJordan K. Hubbard#               ...
12333b577e1fSJordan K. Hubbard#   Note: Make sure that any Rocketport PCI devices are specified BEFORE the
12343b577e1fSJordan K. Hubbard#   ISA Rocketport devices.
12353b577e1fSJordan K. Hubbard
1236a50cd483SJordan K. Hubbard# Notes on the Digiboard driver:
1237a50cd483SJordan K. Hubbard#
1238a50cd483SJordan K. Hubbard# The following flag values have special meanings:
1239c35bda94SBrian Somers#	0x01 - alternate layout of pins (dgb & dgm)
1240c35bda94SBrian Somers#	0x02 - use the windowed PC/Xe in 64K mode (dgb only)
12410d04cf6aSPeter Wemm
12420d04cf6aSPeter Wemm# Notes on the Specialix SI/XIO driver:
1243c4823710SPeter Wemm#  **This is NOT a Specialix supported Driver!**
1244c4823710SPeter Wemm#  The host card is memory, not IO mapped.
1245c4823710SPeter Wemm#  The Rev 1 host cards use a 64K chunk, on a 32K boundary.
1246c4823710SPeter Wemm#  The Rev 2 host cards use a 32K chunk, on a 32K boundary.
1247c4823710SPeter Wemm#  The cards can use an IRQ of 11, 12 or 15.
1248c4823710SPeter Wemm
1249c9da1b81SPeter Wemm# Notes on the Stallion stl and stli drivers:
1250c9da1b81SPeter Wemm#  See src/i386/isa/README.stl for complete instructions.
1251c9da1b81SPeter Wemm#  This is version 0.0.5alpha, unsupported by Stallion.
1252c9da1b81SPeter Wemm#  The stl driver has a secondary IO port hard coded at 0x280.  You need
1253c9da1b81SPeter Wemm#     to change src/i386/isa/stallion.c if you reconfigure this on the boards.
1254c9da1b81SPeter Wemm#  The "flags" and "iosiz" settings on the stli driver depend on the board:
1255c9da1b81SPeter Wemm#	EasyConnection 8/64 ISA:     flags 23         iosiz 0x1000
1256c9da1b81SPeter Wemm#	EasyConnection 8/64 EISA:    flags 24         iosiz 0x10000
1257c9da1b81SPeter Wemm#	EasyConnection 8/64 MCA:     flags 25         iosiz 0x1000
1258c9da1b81SPeter Wemm#	ONboard ISA:                 flags 4          iosiz 0x10000
1259c9da1b81SPeter Wemm#	ONboard EISA:                flags 7          iosiz 0x10000
1260c9da1b81SPeter Wemm#	ONboard MCA:                 flags 3          iosiz 0x10000
1261c9da1b81SPeter Wemm#	Brumby:                      flags 2          iosiz 0x4000
1262c9da1b81SPeter Wemm#	Stallion:                    flags 1          iosiz 0x10000
1263c9da1b81SPeter Wemm
12646a8d6623SGarrett Wollmandevice		mcd0	at isa? port 0x300 bio irq 10 vector mcdintr
126505e1d9d4SJordan K. Hubbard# for the Sony CDU31/33A CDROM
12662d859864SAndreas Schulzdevice		scd0	at isa? port 0x230 bio
12676c5e9bbdSMike Pritchard# for the SoundBlaster 16 multicd - up to 4 devices
12689720b084SJordan K. Hubbardcontroller      matcd0  at isa? port 0x230 bio
12696a8d6623SGarrett Wollmandevice		wt0	at isa? port 0x300 bio irq 5 drq 1 vector wtintr
12706a8d6623SGarrett Wollmandevice		ctx0	at isa? port 0x230 iomem 0xd0000
12712cd01159SJordan K. Hubbarddevice		spigot0 at isa? port 0xad6 irq 15 iomem 0xee000 vector spigintr
12726a8d6623SGarrett Wollmandevice		apm0	at isa?
12731a7c583cSGarrett Wollmandevice		gp0	at isa? port 0x2c0 tty
12741a7c583cSGarrett Wollmandevice		gsc0	at isa? port "IO_GSC1" tty drq 3
12751a7c583cSGarrett Wollmandevice		joy0	at isa? port "IO_GAME"
1276a1e9e308SJamil J. Weatherbeedevice          alog0   at isa? port 0x260 tty irq 5 vector alogintr
127765e8111fSBruce Evansdevice		cy0	at isa? tty irq 10 iomem 0xd4000 iosiz 0x2000 vector cyintr
1278a50cd483SJordan K. Hubbarddevice		dgb0	at isa? port 0x220 iomem 0xfc0000 iosiz ? tty
1279c35bda94SBrian Somersdevice		dgm0	at isa? port 0x104 iomem 0xd00000 iosiz ? tty
1280657e73c4SPeter Dufaultdevice		labpc0	at isa? port 0x260 tty irq 5 vector labpcintr
1281d0930614SAndrey A. Chernovdevice          rc0     at isa? port 0x220 tty irq 12 vector rcintr
12823b577e1fSJordan K. Hubbarddevice          rp0     at isa? port 0x280 tty
1283567e21c2SBruce Evans# the port and irq for tw0 are fictitious
1284567e21c2SBruce Evansdevice          tw0     at isa? port 0x380 tty irq 11 vector twintr
1285c0a3aab8SPeter Wemmdevice		si0	at isa? iomem 0xd0000 tty irq 12
1286a800f455SJulian Elischerdevice		asc0	at isa? port IO_ASC1 tty drq 3 irq 10 vector ascintr
128765e8111fSBruce Evansdevice		bqu0	at isa? port 0x150
1288c9da1b81SPeter Wemmdevice		stl0	at isa? port 0x2a0 tty irq 10 vector stlintr
1289c9da1b81SPeter Wemmdevice		stli0	at isa? port 0x2a0 tty iomem 0xcc000 flags 23 iosiz 0x1000
12905db3b831SPoul-Henning Kamp# You are unlikely to have the hardware for loran0 <phk@FreeBSD.org>
1291828c63aeSPoul-Henning Kampdevice		loran0	at isa? port ? tty irq 5 vector loranintr
12925db3b831SPoul-Henning Kamp# HOT1 Xilinx 6200 card (www.vcc.com)
12935db3b831SPoul-Henning Kampdevice		xrpu0
1294a800f455SJulian Elischer
1295eeb706c0SJustin T. Gibbs#
1296eeb706c0SJustin T. Gibbs# EISA devices:
1297eeb706c0SJustin T. Gibbs#
1298eeb706c0SJustin T. Gibbs# The EISA bus device is eisa0.  It provides auto-detection and
1299eeb706c0SJustin T. Gibbs# configuration support for all devices on the EISA bus.
1300eeb706c0SJustin T. Gibbs#
1301e56e7036SJustin T. Gibbs# The `ahb' device provides support for the Adaptec 174X adapter.
1302e56e7036SJustin T. Gibbs#
1303eeb706c0SJustin T. Gibbs# The `ahc' device provides support for the Adaptec 274X and 284X
1304eeb706c0SJustin T. Gibbs# adapters.  The 284X, although a VLB card responds to EISA probes.
1305eeb706c0SJustin T. Gibbs#
1306c37ddbb8SJoerg Wunsch# fea: DEC DEFEA EISA FDDI adapter
1307c37ddbb8SJoerg Wunsch#
1308eeb706c0SJustin T. Gibbscontroller	eisa0
1309e56e7036SJustin T. Gibbscontroller	ahb0
1310eeb706c0SJustin T. Gibbscontroller	ahc0
1311c37ddbb8SJoerg Wunschdevice		fea0
13126a8d6623SGarrett Wollman
131335846a81SMike Pritchard# enable tagged command queuing, which is a major performance win on
13146e702c99SPaul Traina# devices that support it (and controllers with enough SCB's)
13156e702c99SPaul Trainaoptions	AHC_TAGENABLE
13166e702c99SPaul Traina
13176fb5e0faSJustin T. Gibbs# enable SCB paging - See the ahc.4 man page
13186fb5e0faSJustin T. Gibbsoptions	AHC_SCBPAGING_ENABLE
13196e702c99SPaul Traina
13206fb5e0faSJustin T. Gibbs# The aic7xxx driver will attempt to use memory mapped I/O for all PCI
132111b5ea72SJustin T. Gibbs# controllers that have it configured only if this option is set. Unfortunately,
132211b5ea72SJustin T. Gibbs# this doesn't work on some motherboards, which prevents it from being the
132311b5ea72SJustin T. Gibbs# default.
132411b5ea72SJustin T. Gibbsoptions AHC_ALLOW_MEMIO
13256e702c99SPaul Traina
13261b0d3143SJoerg Wunsch# By default, only 10 EISA slots are probed, since the slot numbers
13271b0d3143SJoerg Wunsch# above clash with the configuration address space of the PCI subsystem,
13281b0d3143SJoerg Wunsch# and the EISA probe is not very smart about this.  This is sufficient
13291b0d3143SJoerg Wunsch# for most machines, but in particular the HP NetServer LC series comes
13301b0d3143SJoerg Wunsch# with an onboard AIC7770 dual-channel SCSI controller on EISA slot #11,
13311b0d3143SJoerg Wunsch# thus you need to bump this figure to 12 for them.
13321b0d3143SJoerg Wunschoptions	"EISA_SLOTS=12"
13331b0d3143SJoerg Wunsch
13346a8d6623SGarrett Wollman#
1335e261d589SJohn-Mark Gurney# PCI devices & PCI options:
13366a8d6623SGarrett Wollman#
13376a8d6623SGarrett Wollman# The main PCI bus device is `pci'.  It provides auto-detection and
13386a8d6623SGarrett Wollman# configuration support for all devices on the PCI bus, using either
13396a8d6623SGarrett Wollman# configuration mode defined in the PCI specification.
13406a8d6623SGarrett Wollman#
1341eeb706c0SJustin T. Gibbs# The `ahc' device provides support for the Adaptec 29/3940(U)(W)
1342eeb706c0SJustin T. Gibbs# and motherboard based AIC7870/AIC7880 adapters.
1343eeb706c0SJustin T. Gibbs#
13446a8d6623SGarrett Wollman# The `ncr' device provides support for the NCR 53C810 and 53C825
13456a8d6623SGarrett Wollman# self-contained SCSI host adapters.
13466a8d6623SGarrett Wollman#
13478bafc245SMatt Jacob# The `isp' device provides support for the Qlogic ISP 1020, 1040
13488bafc245SMatt Jacob# nd 1040B PCI SCSI host adapters, as well as the Qlogic ISP 2100
13498bafc245SMatt Jacob# FC/AL Host Adapter.
13508bafc245SMatt Jacob#
1351e69742d7SStefan Eßer# The `amd' device provides support for the Tekram DC-390 and 390T
1352e69742d7SStefan Eßer# SCSI host adapters, but is expected to work with any AMD 53c974
1353e69742d7SStefan Eßer# PCI SCSI chip and the AMD Ethernet+SCSI Combo chip, after some
1354e69742d7SStefan Eßer# local patches were applied to the sources (that had originally
1355e69742d7SStefan Eßer# been written by Tekram and limited to work with their SCSI cards).
1356e69742d7SStefan Eßer#
13576a8d6623SGarrett Wollman# The `de' device provides support for the Digital Equipment DC21040
13586a8d6623SGarrett Wollman# self-contained Ethernet adapter.
13596a8d6623SGarrett Wollman#
136056086e0dSSatoshi Asami# The `fxp' device provides support for the Intel EtherExpress Pro/100B
136156086e0dSSatoshi Asami# PCI Fast Ethernet adapters.
136256086e0dSSatoshi Asami#
1363e21faf3eSBill Paul# The 'tl' device provides support for the Texas Instruments TNETE100
1364e21faf3eSBill Paul# series 'ThunderLAN' cards and integrated ethernet controllers. This
1365e21faf3eSBill Paul# includes several Compaq Netelligent 10/100 cards and the built-in
1366e21faf3eSBill Paul# ethernet controllers in several Compaq Prosignia, Proliant and
1367e30938ceSBill Paul# Deskpro systems. It also supports several Olicom 10Mbps and 10/100
1368e30938ceSBill Paul# boards.
1369e21faf3eSBill Paul#
1370ec4f65d2SJordan K. Hubbard# The `tx' device provides support for the SMC 9432TX cards.
1371ec4f65d2SJordan K. Hubbard#
13725ccfdea2SAndreas Schulz# The `vx' device provides support for the 3Com 3C590 and 3C595
1373f4567b9cSJulian Elischer# early support
1374f4567b9cSJulian Elischer#
1375e30938ceSBill Paul# The `xl' driver provides support for the 3Com 3c900, 3c905 and
1376e30938ceSBill Paul# 3c905B (Fast) Etherlink XL cards and integrated controllers. This
1377e30938ceSBill Paul# includes the integrated 3c905B-TX chips in certain Dell Optiplex and
1378e30938ceSBill Paul# Dell Precision desktop machines and the integrated 3c905-TX chips
1379e30938ceSBill Paul# in Dell Latitude laptop docking stations.
1380e30938ceSBill Paul#
1381d41f24e7SDavid Greenman# The `fpa' device provides support for the Digital DEFPA PCI FDDI
1382d41f24e7SDavid Greenman# adapter. pseudo-device fddi is also needed.
1383d41f24e7SDavid Greenman#
1384bba9a7a0SGarrett Wollman# The `meteor' device is a PCI video capture board. It can also have the
13851d86961eSJordan K. Hubbard# following options:
1386b1529bdaSPeter Wemm#   options METEOR_ALLOC_PAGES=xxx	preallocate kernel pages for data entry
13871d86961eSJordan K. Hubbard#	figure (ROWS*COLUMN*BYTES_PER_PIXEL*FRAME+PAGE_SIZE-1)/PAGE_SIZE
13881d86961eSJordan K. Hubbard#   options METEOR_DEALLOC_PAGES	remove all allocated pages on close(2)
1389b1529bdaSPeter Wemm#   options METEOR_DEALLOC_ABOVE=xxx	remove all allocated pages above the
13901d86961eSJordan K. Hubbard#	specified amount. If this value is below the allocated amount no action
13911d86961eSJordan K. Hubbard#	taken
1392734d08a2SJordan K. Hubbard#   option METEOR_SYSTEM_DEFAULT={METEOR_PAL|METEOR_NTSC|METEOR_SECAM}, used
1393734d08a2SJordan K. Hubbard#	for initialization of fps routine when a signal is not present.
13941d86961eSJordan K. Hubbard#
13955719a93cSJohn-Mark Gurney# The 'bktr' device is a PCI video capture board. It also has a TV tuner
13969ff07e32SAmancio Hasty# on board. To override the tuner detection use
13979ff07e32SAmancio Hasty#   options OVERRIDE_TUNER=x
13989ff07e32SAmancio Hasty# The current values are found in /usr/src/sys/pci/brooktree848.c
13999ff07e32SAmancio Hasty#
14005719a93cSJohn-Mark Gurney#
14016a8d6623SGarrett Wollmancontroller	pci0
1402eeb706c0SJustin T. Gibbscontroller	ahc1
140311bfa65aSBruce Evanscontroller	ncr0
14048bafc245SMatt Jacobcontroller	isp0
1405e69742d7SStefan Eßercontroller	amd0
14066a8d6623SGarrett Wollmandevice		de0
140717acc2b2SDavid Greenmandevice		fxp0
1408e21faf3eSBill Pauldevice		tl0
1409ec4f65d2SJordan K. Hubbarddevice		tx0
14105ccfdea2SAndreas Schulzdevice		vx0
1411e30938ceSBill Pauldevixe		xl0
1412d41f24e7SDavid Greenmandevice		fpa0
14131d86961eSJordan K. Hubbarddevice		meteor0
14145719a93cSJohn-Mark Gurneydevice		bktr0
1415446cee6eSJoerg Wunsch
1416abc97a06SBruce Evansoptions         OVERRIDE_TUNER=NO_TUNER
1417dc9deb29SPoul-Henning Kamp
1418dc9deb29SPoul-Henning Kamp#
1419e261d589SJohn-Mark Gurney# PCI options
1420e261d589SJohn-Mark Gurney#
1421e261d589SJohn-Mark Gurney#options	PCI_QUIET	#quiets PCI code on chipset settings
1422e261d589SJohn-Mark Gurney
1423e261d589SJohn-Mark Gurney#
1424dc9deb29SPoul-Henning Kamp# PCCARD/PCMCIA
1425dc9deb29SPoul-Henning Kamp#
1426e7e437dbSNate Williams# card: slot controller
142713cbd355SNate Williams# pcic: slots
1428e7e437dbSNate Williamscontroller	card0
142994316d1dSWolfgang Helbigdevice		pcic0 at card?
143094316d1dSWolfgang Helbigdevice		pcic1 at card?
1431dc9deb29SPoul-Henning Kamp
1432446cee6eSJoerg Wunsch#
1433446cee6eSJoerg Wunsch# Laptop/Notebook options:
1434446cee6eSJoerg Wunsch#
1435446cee6eSJoerg Wunsch# See also:
14366c5e9bbdSMike Pritchard#  apm under `Miscellaneous hardware'
1437446cee6eSJoerg Wunsch# above.
1438446cee6eSJoerg Wunsch
1439446cee6eSJoerg Wunsch# For older notebooks that signal a powerfail condition (external
1440446cee6eSJoerg Wunsch# power supply dropped, or battery state low) by issuing an NMI:
1441446cee6eSJoerg Wunsch
1442446cee6eSJoerg Wunschoptions		POWERFAIL_NMI	# make it beep instead of panicing
144365e8111fSBruce Evans
1444ab4c624bSMike Smith#
1445ab4c624bSMike Smith# Parallel-Port Bus
1446ab4c624bSMike Smith#
1447ab4c624bSMike Smith# Parallel port bus support is provided by the `ppbus' device.
1448ab4c624bSMike Smith# Multiple devices may be attached to the parallel port, devices
1449ab4c624bSMike Smith# are automatically probed and attached when found.
1450ab4c624bSMike Smith#
1451ab4c624bSMike Smith# Supported devices:
1452ab4c624bSMike Smith# vpo	Iomega Zip Drive
1453f88c1346SMike Smith#	Requires SCSI disk support ('scbus' and 'sd'), best
1454f88c1346SMike Smith#	performance is achieved with ports in EPP 1.9 mode.
1455ab4c624bSMike Smith# nlpt	Parallel Printer
145646f3ff79SMike Smith# plip	Parallel network interface
1457ab4c624bSMike Smith# ppi	General-purpose I/O ("Geek Port")
1458ab4c624bSMike Smith#
1459ab4c624bSMike Smith# Supported interfaces:
1460ab4c624bSMike Smith# ppc	ISA-bus parallel port interfaces.
1461ab4c624bSMike Smith#
1462ab4c624bSMike Smithcontroller	ppbus0
1463ab4c624bSMike Smithcontroller	vpo0	at ppbus?
1464ab4c624bSMike Smithdevice		nlpt0	at ppbus?
146546f3ff79SMike Smithdevice		plip0	at ppbus?
1466ab4c624bSMike Smithdevice		ppi0	at ppbus?
1467507e2e44SPoul-Henning Kampdevice		pps0	at ppbus?
1468ab4c624bSMike Smith
1469324bac9fSMike Smithcontroller	ppc0	at isa? disable port ? tty irq 7 vector ppcintr
1470ab4c624bSMike Smith
1471432aad0eSTor Egge# Kernel BOOTP support
1472432aad0eSTor Egge
1473432aad0eSTor Eggeoptions		BOOTP		# Use BOOTP to obtain IP address/hostname
1474432aad0eSTor Eggeoptions		BOOTP_NFSROOT	# NFS mount root filesystem using BOOTP info
1475432aad0eSTor Eggeoptions		"BOOTP_NFSV3"	# Use NFS v3 to NFS mount root
1476432aad0eSTor Eggeoptions		BOOTP_COMPAT	# Workaround for broken bootp daemons.
14778f7030a7STor Eggeoptions		"BOOTP_WIRED_TO=fxp0" # Use interface fxp0 for BOOTP
1478432aad0eSTor Egge
1479bd45deefSDima Ruban# If you want to disable loadable kernel modules (LKM), you
1480bd45deefSDima Ruban# might want to use this option.
1481ee16b430SBruce Evans#options		NO_LKM
1482bd45deefSDima Ruban
1483d94f38acSEivind Eklund#
1484d94f38acSEivind Eklund# Add tie-ins for a hardware watchdog.  This only enable the hooks;
1485d94f38acSEivind Eklund# the user must still supply the actual driver.
1486d94f38acSEivind Eklund#
1487d94f38acSEivind Eklundoptions		HW_WDOG
1488d94f38acSEivind Eklund
1489005092bbSEivind Eklund#
1490005092bbSEivind Eklund# Set the number of PV entries per process.  Increasing this can
1491005092bbSEivind Eklund# stop panics related to heavy use of shared memory. However, that can
1492005092bbSEivind Eklund# (combined with large amounts of physical memory) cause panics at
1493005092bbSEivind Eklund# boot time due the kernel running out of VM space.
1494005092bbSEivind Eklund#
1495005092bbSEivind Eklund# If you're tweaking this, you might also want to increase the sysctls
1496005092bbSEivind Eklund# "vm.v_free_min", "vm.v_free_reserved", and "vm.v_free_target".
1497005092bbSEivind Eklund#
149804fa1e6cSEivind Eklund# The value below is the one more than the default.
1499005092bbSEivind Eklund#
150004fa1e6cSEivind Eklundoptions         "PMAP_SHPGPERPROC=201"
1501005092bbSEivind Eklund
150265e8111fSBruce Evans# More undocumented options for linting.
150394c94804SBruce Evans
1504d656e316SBruce Evansoptions		CLK_CALIBRATION_LOOP
1505d656e316SBruce Evansoptions		"CLK_USE_I8254_CALIBRATION"
1506d46e059fSPoul-Henning Kampoptions		CLK_USE_TSC_CALIBRATION
15079546766aSBruce Evansoptions		CLUSTERDEBUG
1508f3e002a8SPoul-Henning Kampoptions		COMPAT_LINUX
150996b89afcSBruce Evansoptions		CPU_UPGRADE_HW_CACHE
151011bfa65aSBruce Evansoptions		DEBUG
1511c6de6a69SEivind Eklundoptions		"DEBUG_1284"
1512c6de6a69SEivind Eklund#options	DISABLE_PSE
151311bfa65aSBruce Evansoptions		"EXT2FS"
151411bfa65aSBruce Evansoptions		"I586_PMC_GUPROF=0x70000"
151511bfa65aSBruce Evansoptions		"IBCS2"
1516751bf650SJun-ichiro itojun Haginooptions		KEY
1517751bf650SJun-ichiro itojun Haginooptions		KEY_DEBUG
151825292acbSBruce Evansoptions		LOCKF_DEBUG
1519c6de6a69SEivind Eklundoptions		LOUTB
15204bc24b97SBruce Evansoptions		KBD_MAXRETRY=4
15214bc24b97SBruce Evansoptions		KBD_MAXWAIT=6
15224bc24b97SBruce Evansoptions		KBD_RESETDELAY=201
15234bc24b97SBruce Evansoptions		KBDIO_DEBUG=2
15244bc24b97SBruce Evansoptions		MSGMNB=2049
15254bc24b97SBruce Evansoptions		MSGMNI=41
15264bc24b97SBruce Evansoptions		MSGSEG=2049
152756a956e5SBruce Evansoptions		MSGSSZ=16
15284bc24b97SBruce Evansoptions		MSGTQL=41
15294bc24b97SBruce Evansoptions		NBUF=512
1530c6de6a69SEivind Eklundoptions		NETATALKDEBUG
15314bc24b97SBruce Evansoptions		NMBCLUSTERS=1024
15329546766aSBruce Evansoptions		NPX_DEBUG
1533c6de6a69SEivind Eklundoptions		NULLFS_DIAGNOSTIC
1534c6de6a69SEivind Eklundoptions		PANIC_REBOOT_WAIT_TIME=16
1535c6de6a69SEivind Eklundoptions		"PCVT_24LINESDEF"
1536c6de6a69SEivind Eklundoptions		PCVT_CTRL_ALT_DEL
1537c6de6a69SEivind Eklundoptions		PCVT_EMU_MOUSE
1538c6de6a69SEivind Eklundoptions		PCVT_FREEBSD=211
1539c6de6a69SEivind Eklundoptions		PCVT_META_ESC
1540c6de6a69SEivind Eklundoptions		PCVT_NSCREENS=9
1541c6de6a69SEivind Eklundoptions		PCVT_PRETTYSCRNS
1542c6de6a69SEivind Eklundoptions		PCVT_SCANSET=2
1543c6de6a69SEivind Eklundoptions		PCVT_SCREENSAVER
1544c6de6a69SEivind Eklundoptions		PCVT_USEKBDSEC
1545c6de6a69SEivind Eklundoptions		"PCVT_VT220KEYB"
15464bc24b97SBruce Evansoptions		PSM_DEBUG=1
1547c01db44aSBruce Evansoptions		"SCSI_2_DEF"
1548078d4ac9SBruce Evansoptions		SCSI_DELAY=8	# Be pessimistic about Joe SCSI device
1549078d4ac9SBruce Evansoptions		SCSI_NCR_DEBUG
1550078d4ac9SBruce Evansoptions		SCSI_NCR_DFLT_TAGS=4
1551078d4ac9SBruce Evansoptions		SCSI_NCR_MAX_SYNC=10000
1552078d4ac9SBruce Evansoptions		SCSI_NCR_MAX_WIDE=1
1553078d4ac9SBruce Evansoptions		SCSI_NCR_MYADDR=7
15544bc24b97SBruce Evansoptions		SEMMAP=31
15554bc24b97SBruce Evansoptions		SEMMNI=11
15564bc24b97SBruce Evansoptions		SEMMNS=61
15574bc24b97SBruce Evansoptions		SEMMNU=31
15584bc24b97SBruce Evansoptions		SEMMSL=61
15594bc24b97SBruce Evansoptions		SEMOPM=101
15604bc24b97SBruce Evansoptions		SEMUME=11
1561b1529bdaSPeter Wemmoptions		SHOW_BUSYBUFS	# List buffers that prevent root unmount
15624bc24b97SBruce Evansoptions		SHMALL=1025
15634bc24b97SBruce Evansoptions		"SHMMAX=(SHMMAXPGS*PAGE_SIZE+1)"
15644bc24b97SBruce Evansoptions		SHMMAXPGS=1025
15654bc24b97SBruce Evansoptions		SHMMIN=2
15664bc24b97SBruce Evansoptions		SHMMNI=33
15674bc24b97SBruce Evansoptions		SHMSEG=9
1568d656e316SBruce Evansoptions		SI_DEBUG
156925292acbSBruce Evansoptions		SIMPLELOCK_DEBUG
1570cefdbb04SBruce Evansoptions		SPX_HACK
157116094866SJulian Elischer
1572f909c15bSEivind Eklund# The 'dpt' driver provides support for DPT controllers (http://www.dpt.com/).
1573f909c15bSEivind Eklund# These have hardware RAID-{0,1,5} support, and do multi-initiator I/O.
1574b755b885SEivind Eklund# The DPT controllers are commonly re-licensed under other brand-names -
1575b755b885SEivind Eklund# some controllers by Olivetti, Dec, HP, AT&T, SNI, AST, Alphatronic, NEC and
1576b755b885SEivind Eklund# Compaq are actually DPT controllers.
1577b755b885SEivind Eklund#
157816094866SJulian Elischer# See sys/dev/dpt for debugging and other subtle options.
157916094866SJulian Elischer#   DPT_VERIFY_HINTR        Performs some strict hardware interrupts testing.
158016094866SJulian Elischer#                           Only use if you suspect PCI bus corruption problems
158116094866SJulian Elischer#   DPT_RESTRICTED_FREELIST Normally, the freelisat used by the DPT for queue
158216094866SJulian Elischer#                           will grow to accomodate increased use.  This growth
158316094866SJulian Elischer#                           will NOT shrink.  To restrict the number of queue
158416094866SJulian Elischer#                           slots to exactly what the DPT can hold at one time,
158516094866SJulian Elischer#                           enable this option.
158616094866SJulian Elischer#   DPT_MEASURE_PERFORMANCE Enables a set of (semi)invasive metrics. Various
1587b755b885SEivind Eklund#                           instruments are enabled.  The tools in
1588b755b885SEivind Eklund#                           /usr/sbin/dpt_* assume these to be enabled.
1589b755b885SEivind Eklund#   DPT_FREELIST_IS_STACK   For optimal L{1,2} CPU cache utilization, enable
159016094866SJulian Elischer#                           this option.  Otherwise, the transaction queue is
159116094866SJulian Elischer#                           a LIFO.  I cannot measure the performance gain.
159216094866SJulian Elischer#   DPT_HANDLE_TIMEOUTS     Normally device timeouts are handled by the DPT.
159316094866SJulian Elischer#                           If you ant the driver to handle timeouts, enable
159416094866SJulian Elischer#                           this option.  If your system is very busy, this
159516094866SJulian Elischer#                           option will create more trouble than solve.
159616094866SJulian Elischer#   DPT_TIMEOUT_FACTOR      Used to compute the excessive amount of time to
159716094866SJulian Elischer#                           wait when timing out with the above option.
159816094866SJulian Elischer#  DPT_DEBUG_xxxx           These are controllable from sys/dev/dpt/dpt.h
159916094866SJulian Elischer#  DPT_LOST_IRQ             When enabled, will try, once per second, to catch
160016094866SJulian Elischer#                           any interrupt that got lost.  Seems to help in some
160116094866SJulian Elischer#                           DPT-firmware/Motherboard combinations.  Minimal
160216094866SJulian Elischer#                           cost, great benefit.
1603b755b885SEivind Eklund#  DPT_RESET_HBA            Make "reset" actually reset the controller
1604b755b885SEivind Eklund#                           instead of fudging it.  Only enable this if you
1605b755b885SEivind Eklund#			    are 100% certain you need it.
1606b755b885SEivind Eklund#  DPT_SHUTDOWN_SLEEP       Reset controller if a request take more than
1607b755b885SEivind Eklund#                           this number of seconds.  Do NOT enable this
1608b755b885SEivind Eklund#			    unless you are really, really, really certain
1609b755b885SEivind Eklund#			    you need it.  You are advised to call Simon (the
1610b755b885SEivind Eklund#			    driver author) before setting it, and NEVER,
1611b755b885SEivind Eklund#			    EVER set it to less than 300s (5 minutes).
161216094866SJulian Elischer
161316094866SJulian Elischercontroller      dpt0
161416094866SJulian Elischer
161516094866SJulian Elischer# DPT options
161616094866SJulian Elischeroptions DPT_VERIFY_HINTR
161716094866SJulian Elischeroptions DPT_RESTRICTED_FREELIST
161816094866SJulian Elischeroptions DPT_MEASURE_PERFORMANCE
161916094866SJulian Elischeroptions DPT_FREELIST_IS_STACK
162016094866SJulian Elischeroptions DPT_HANDLE_TIMEOUTS
162116094866SJulian Elischeroptions DPT_TIMEOUT_FACTOR=4
162216094866SJulian Elischeroptions	DPT_INTR_DELAY=200      # Some motherboards need that
162316094866SJulian Elischeroptions DPT_LOST_IRQ
1624b755b885SEivind Eklundoptions DPT_RESET_HBA
1625b755b885SEivind Eklund
1626b755b885SEivind Eklund# Don't EVER set this without having talked to Simon Shapiro on the phone
1627b755b885SEivind Eklund# first.
1628b755b885SEivind Eklundoptions DPT_SHUTDOWN_SLEEP=500
1629