xref: /freebsd/sys/conf/NOTES (revision d02c233129d1b4b253de9119de660a3269c6eb71)
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#
5d02c2331SBill Paul#	$Id: LINT,v 1.574 1999/03/31 15:23:31 eivind 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:
5571c1bf9fSJoseph Koshy#    strings -aout -n 3 /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#
1664536af6aSKATO Takenori# CPU_WT_ALLOC enables write allocation on Cyrix 6x86/6x86MX and AMD
1674536af6aSKATO Takenori# K5/K6/K6-2 cpus.
1686593be60SKATO Takenori#
16956be1833SKATO Takenori# CYRIX_CACHE_WORKS enables CPU cache on Cyrix 486 CPUs with cache
17056be1833SKATO Takenori# flush at hold state.
17156be1833SKATO Takenori#
17256be1833SKATO Takenori# CYRIX_CACHE_REALLY_WORKS enables (1) CPU cache on Cyrix 486 CPUs
17356be1833SKATO Takenori# without cache flush at hold state, and (2) write-back CPU cache on
17456be1833SKATO Takenori# Cyrix 6x86 whose revision < 2.7 (NOTE 2).
17556be1833SKATO Takenori#
176b0050656SJohn-Mark Gurney# NO_F00F_HACK disables the hack that prevents Pentiums (and ONLY
177b0050656SJohn-Mark Gurney# Pentiums) from locking up when a LOCK CMPXCHG8B instruction is
178b0050656SJohn-Mark Gurney# executed.  This should be included for ALL kernels that won't run
179b0050656SJohn-Mark Gurney# on a Pentium.
180b0050656SJohn-Mark Gurney#
181925f3681SMike Smith# NO_MEMORY_HOLE is an optimisation for systems with AMD K6 processors
182925f3681SMike Smith# which indicates that the 15-16MB range is *definitely* not being
183925f3681SMike Smith# occupied by an ISA memory hole.
184925f3681SMike Smith#
18556be1833SKATO Takenori# NOTE 1: The options, CPU_BTB_EN, CPU_LOOP_EN, CPU_IORT,
1864536af6aSKATO Takenori# CPU_LOOP_ENand CPU_RSTK_EN should not be used becasue of CPU bugs.
18756be1833SKATO Takenori# These options may crash your system.
18856be1833SKATO Takenori#
18956be1833SKATO Takenori# NOTE 2: If CYRIX_CACHE_REALLY_WORKS is not set, CPU cache is enabled
19056be1833SKATO Takenori# in write-through mode when revision < 2.7.  If revision of Cyrix
19156be1833SKATO Takenori# 6x86 >= 2.7, CPU cache is always enabled in write-back mode.
19256be1833SKATO Takenori#
1936593be60SKATO Takenori# NOTE 3: This option may cause failures for software that requires
1946593be60SKATO Takenori# locked cycles in order to operate correctly.
1956593be60SKATO Takenori#
19656be1833SKATO Takenorioptions		"CPU_BLUELIGHTNING_FPU_OP_CACHE"
19756be1833SKATO Takenorioptions		"CPU_BLUELIGHTNING_3X"
19856be1833SKATO Takenorioptions		"CPU_BTB_EN"
1994962d938SKATO Takenorioptions		"CPU_DIRECT_MAPPED_CACHE"
20056be1833SKATO Takenorioptions		"CPU_DISABLE_5X86_LSSER"
20156be1833SKATO Takenorioptions		"CPU_FASTER_5X86_FPU"
20256be1833SKATO Takenorioptions		"CPU_I486_ON_386"
20356be1833SKATO Takenorioptions		"CPU_IORT"
20456be1833SKATO Takenorioptions		"CPU_LOOP_EN"
20556be1833SKATO Takenorioptions		"CPU_RSTK_EN"
20656be1833SKATO Takenorioptions		"CPU_SUSP_HLT"
2074536af6aSKATO Takenorioptions		"CPU_WT_ALLOC"
20856be1833SKATO Takenorioptions		"CYRIX_CACHE_WORKS"
20956be1833SKATO Takenorioptions		"CYRIX_CACHE_REALLY_WORKS"
210b0050656SJohn-Mark Gurney#options	"NO_F00F_HACK"
21156be1833SKATO Takenori
21256be1833SKATO Takenori#
21356be1833SKATO Takenori# A math emulator is mandatory if you wish to run on hardware which
21456be1833SKATO Takenori# does not have a floating-point processor.  Pick either the original,
21556be1833SKATO Takenori# bogus (but freely-distributable) math emulator, or a much more
21656be1833SKATO Takenori# fully-featured but GPL-licensed emulator taken from Linux.
21756be1833SKATO Takenori#
21856be1833SKATO Takenorioptions		MATH_EMULATE		#Support for x87 emulation
21956be1833SKATO Takenori# Don't enable both of these in a real config.
22056be1833SKATO Takenorioptions		GPL_MATH_EMULATE	#Support for x87 emulation via
22156be1833SKATO Takenori					#new math emulator
22256be1833SKATO Takenori
22356be1833SKATO Takenori
22456be1833SKATO Takenori#####################################################################
2256a8d6623SGarrett Wollman# COMPATIBILITY OPTIONS
226690f540cSAndrey A. Chernov
2276a8d6623SGarrett Wollman#
2286a8d6623SGarrett Wollman# Implement system calls compatible with 4.3BSD and older versions of
22956c7a48cSJordan K. Hubbard# FreeBSD.  You probably do NOT want to remove this as much current code
23056c7a48cSJordan K. Hubbard# still relies on the 4.3 emulation.
2316a8d6623SGarrett Wollman#
2326a8d6623SGarrett Wollmanoptions		"COMPAT_43"
2336a8d6623SGarrett Wollman
2346a8d6623SGarrett Wollman#
23590b66aadSPeter Wemm# Statically compile in the i386 a.out LKM compatability support.
23690b66aadSPeter Wemm# Also available as an KLD module.
23790b66aadSPeter Wemm#
23890b66aadSPeter Wemmoptions 	LKM
23990b66aadSPeter Wemm
24090b66aadSPeter Wemm#
2416c5e9bbdSMike Pritchard# Allow user-mode programs to manipulate their local descriptor tables.
2426a8d6623SGarrett Wollman# This option is required for the WINE Windows(tm) emulator, and is
2436a8d6623SGarrett Wollman# not used by anything else (that we know of).
2446a8d6623SGarrett Wollman#
2456a8d6623SGarrett Wollmanoptions		USER_LDT		#allow user-level control of i386 ldt
2466a8d6623SGarrett Wollman
2476a8d6623SGarrett Wollman#
2486a8d6623SGarrett Wollman# These three options provide support for System V Interface
2496a8d6623SGarrett Wollman# Definition-style interprocess communication, in the form of shared
2506a8d6623SGarrett Wollman# memory, semaphores, and message queues, respectively.
2516a8d6623SGarrett Wollman#
2526a8d6623SGarrett Wollmanoptions		SYSVSHM
2536a8d6623SGarrett Wollmanoptions		SYSVSEM
2546a8d6623SGarrett Wollmanoptions		SYSVMSG
2556a8d6623SGarrett Wollman
25694801746SPoul-Henning Kamp#
25794801746SPoul-Henning Kamp# This option includes a MD5 routine in the kernel, this is used for
25894801746SPoul-Henning Kamp# various authentication and privacy uses.
25994801746SPoul-Henning Kamp#
26094801746SPoul-Henning Kampoptions		"MD5"
26194801746SPoul-Henning Kamp
262adeb9a12SJonathan Lemon#
263adeb9a12SJonathan Lemon# Allow processes to switch to vm86 mode, as well as enabling direct
264adeb9a12SJonathan Lemon# user-mode access to the I/O port space.  This option is necessary for
265adeb9a12SJonathan Lemon# the doscmd emulator to run.
266adeb9a12SJonathan Lemon#
267adeb9a12SJonathan Lemonoptions		"VM86"
268adeb9a12SJonathan Lemon
2696a8d6623SGarrett Wollman
2706a8d6623SGarrett Wollman#####################################################################
2716a8d6623SGarrett Wollman# DEBUGGING OPTIONS
2726a8d6623SGarrett Wollman
2736a8d6623SGarrett Wollman#
274b5d89ca8SBruce Evans# Enable the kernel debugger.
2756a8d6623SGarrett Wollman#
276b5d89ca8SBruce Evansoptions		DDB
277b5d89ca8SBruce Evans
278b5d89ca8SBruce Evans#
2795ccab2afSGary Palmer# Don't drop into DDB for a panic. Intended for unattended operation
2805ccab2afSGary Palmer# where you may want to drop to DDB from the console, but still want
2815ccab2afSGary Palmer# the machine to recover from a panic
2825ccab2afSGary Palmer#
2835ccab2afSGary Palmeroptions		DDB_UNATTENDED
2845ccab2afSGary Palmer
2855ccab2afSGary Palmer#
286562d05dfSPaul Traina# If using GDB remote mode to debug the kernel, there's a non-standard
287562d05dfSPaul Traina# extension to the remote protocol that can be used to use the serial
288562d05dfSPaul Traina# port as both the debugging port and the system console.  It's non-
289562d05dfSPaul Traina# standard and you're on your own if you enable it.  See also the
290562d05dfSPaul Traina# "remotechat" variables in the FreeBSD specific version of gdb.
291562d05dfSPaul Traina#
292562d05dfSPaul Trainaoptions		GDB_REMOTE_CHAT
293562d05dfSPaul Traina
294562d05dfSPaul Traina#
2956a8d6623SGarrett Wollman# KTRACE enables the system-call tracing facility ktrace(2).
2966a8d6623SGarrett Wollman#
2972365e64fSRodney W. Grimesoptions		KTRACE			#kernel tracing
29821c64a07SAndrey A. Chernov
2996a8d6623SGarrett Wollman#
3005526d2d9SEivind Eklund# The INVARIANTS option is used in a number of source files to enable
3016a8d6623SGarrett Wollman# extra sanity checking of internal structures.  This support is not
3026a8d6623SGarrett Wollman# enabled by default because of the extra time it would take to check
3036a8d6623SGarrett Wollman# for these conditions, which can only occur as a result of
3046a8d6623SGarrett Wollman# programming errors.
3056a8d6623SGarrett Wollman#
3065526d2d9SEivind Eklundoptions		INVARIANTS
3075526d2d9SEivind Eklund
3085526d2d9SEivind Eklund#
3095526d2d9SEivind Eklund# The INVARIANT_SUPPORT option makes us compile in support for
3105526d2d9SEivind Eklund# verifying some of the internal structures.  It is a prerequisite for
3115526d2d9SEivind Eklund# 'INVARIANTS', as enabling 'INVARIANTS' will make these functions be
3125526d2d9SEivind Eklund# called.  The intent is that you can set 'INVARIANTS' for single
3135526d2d9SEivind Eklund# source files (by changing the source file or specifying it on the
3145526d2d9SEivind Eklund# command line) if you have 'INVARIANT_SUPPORT' enabled.
3155526d2d9SEivind Eklund#
3165526d2d9SEivind Eklundoptions		INVARIANT_SUPPORT
3175526d2d9SEivind Eklund
3185526d2d9SEivind Eklund#
3195526d2d9SEivind Eklund# The DIAGNOSTIC option is used to enable extra debugging information
3205526d2d9SEivind Eklund# from some parts of the kernel.  As this makes everything more noisy,
3215526d2d9SEivind Eklund# it is disabled by default.
3225526d2d9SEivind Eklund#
3230dc7d907SPoul-Henning Kampoptions		DIAGNOSTIC
324da59a31cSDavid Greenman
3250dd1eea1SJordan K. Hubbard#
326348acd94SGarrett Wollman# PERFMON causes the driver for Pentium/Pentium Pro performance counters
327348acd94SGarrett Wollman# to be compiled.  See perfmon(4) for more information.
328348acd94SGarrett Wollman#
329348acd94SGarrett Wollmanoptions		PERFMON
330348acd94SGarrett Wollman
331346ebe51SEivind Eklund
332346ebe51SEivind Eklund#
333346ebe51SEivind Eklund# This option let some drivers co-exist that can't co-exist in a running
334346ebe51SEivind Eklund# system.  This is used to be able to compile all kernel code in one go for
335346ebe51SEivind Eklund# quality assurance purposes (like this file, which the option takes it name
336346ebe51SEivind Eklund# from.)
337346ebe51SEivind Eklund#
338346ebe51SEivind Eklundoptions COMPILING_LINT
339346ebe51SEivind Eklund
340346ebe51SEivind Eklund
341348acd94SGarrett Wollman# XXX - this doesn't belong here.
3420dd1eea1SJordan K. Hubbard# Allow ordinary users to take the console - this is useful for X.
3430dd1eea1SJordan K. Hubbardoptions		UCONSOLE
3440dd1eea1SJordan K. Hubbard
34596fc6efbSPoul-Henning Kamp# XXX - this doesn't belong here either
34696fc6efbSPoul-Henning Kampoptions		USERCONFIG		#boot -c editor
347ed91f3baSMike Smithoptions		INTRO_USERCONFIG	#imply -c and show intro screen
34896fc6efbSPoul-Henning Kampoptions		VISUAL_USERCONFIG	#visual boot -c editor
3496a8d6623SGarrett Wollman
3506a8d6623SGarrett Wollman#####################################################################
3516a8d6623SGarrett Wollman# NETWORKING OPTIONS
35270c0b54cSAndrey A. Chernov
3536a8d6623SGarrett Wollman#
3546a8d6623SGarrett Wollman# Protocol families:
3556a8d6623SGarrett Wollman#  Only the INET (Internet) family is officially supported in FreeBSD.
35611bfa65aSBruce Evans#  Source code for the NS (Xerox Network Service) is provided for amusement
35711bfa65aSBruce Evans#  value.
3586a8d6623SGarrett Wollman#
3596a8d6623SGarrett Wollmanoptions		INET			#Internet communications protocols
360f73bbaf2SDavid Greenman
361cc6a66f2SJulian Elischeroptions		IPX			#IPX/SPX communications protocols
362cc6a66f2SJulian Elischeroptions		IPXIP			#IPX in IP encapsulation (not available)
363cc6a66f2SJulian Elischeroptions		IPTUNNEL		#IP in IPX encapsulation (not available)
364cc6a66f2SJulian Elischer
36534b5fca7SJulian Elischeroptions		NETATALK		#Appletalk communications protocols
36634b5fca7SJulian Elischer
36711bfa65aSBruce Evans# These are currently broken but are shipped due to interest.
36811bfa65aSBruce Evans#options		NS			#Xerox NS protocols
36911bfa65aSBruce Evans
370bba9a7a0SGarrett Wollman# These are currently broken and are no longer shipped due to lack
371bba9a7a0SGarrett Wollman# of interest.
372bba9a7a0SGarrett Wollman#options		CCITT			#X.25 network layer
373f73bbaf2SDavid Greenman#options		ISO
374f73bbaf2SDavid Greenman#options		TPIP			#ISO TP class 4 over IP
375f73bbaf2SDavid Greenman#options		TPCONS			#ISO TP class 0 over X.25
376bba9a7a0SGarrett Wollman#options		LLC			#X.25 link layer for Ethernets
377bba9a7a0SGarrett Wollman#options		HDLC			#X.25 link layer for serial lines
378bba9a7a0SGarrett Wollman#options		EON			#ISO CLNP over IP
379dc915e7cSGarrett Wollman#options		NSIP			#XNS over IP
38063a74862SSteven Wallace
3816a8d6623SGarrett Wollman#
3826a8d6623SGarrett Wollman# Network interfaces:
38356c7a48cSJordan K. Hubbard#  The `loop' pseudo-device is MANDATORY when networking is enabled.
3846a8d6623SGarrett Wollman#  The `ether' pseudo-device provides generic code to handle
38556c7a48cSJordan K. Hubbard#  Ethernets; it is MANDATORY when a Ethernet device driver is
386722012ccSJulian Elischer#  configured or token-ring is enabled.
387d41f24e7SDavid Greenman#  The 'fddi' pseudo-device provides generic code to support FDDI.
38883401efaSGarrett Wollman#  The `sppp' pseudo-device serves a similar role for certain types
389e7c234a1SPeter Wemm#  of synchronous PPP links (like `cx', `ar').
3906a8d6623SGarrett Wollman#  The `sl' pseudo-device implements the Serial Line IP (SLIP) service.
391829b5d55SPeter Wemm#  The `ppp' pseudo-device implements the Point-to-Point Protocol.
392fb46af4fSDag-Erling Smørgrav#  The `bpfilter' pseudo-device enables the Berkeley Packet Filter.  Be
393d29895dcSGarrett Wollman#  aware of the legal and administrative consequences of enabling this
394d29895dcSGarrett Wollman#  option.  The number of devices determines the maximum number of
395d29895dcSGarrett Wollman#  simultaneous BPF clients programs runnable.
39659d8d13fSGarrett Wollman#  The `disc' pseudo-device implements a minimal network interface,
39759d8d13fSGarrett Wollman#  which throws away all packets sent and never receives any.  It is
39859d8d13fSGarrett Wollman#  included for testing purposes.
399b60d4a5dSAtsushi Murai#  The `tun' pseudo-device implements the User Process PPP (iijppp)
400d1721fe1SMark Newton#  The `streams' pseudo-device implements SysVR4 STREAMS emulation.
4016a8d6623SGarrett Wollman#
402829b5d55SPeter Wemm# The PPP_BSDCOMP option enables support for compress(1) style entire
403829b5d55SPeter Wemm# packet compression, the PPP_DEFLATE is for zlib/gzip style compression.
404829b5d55SPeter Wemm# PPP_FILTER enables code for filtering the ppp data stream and selecting
405829b5d55SPeter Wemm# events for resetting the demand dial activity timer - requires bpfilter.
406829b5d55SPeter Wemm# See pppd(8) for more details.
40789327d27SPeter Wemm#
4086a8d6623SGarrett Wollmanpseudo-device	ether			#Generic Ethernet
409722012ccSJulian Elischerpseudo-device	token			#Generic TokenRing
410d41f24e7SDavid Greenmanpseudo-device	fddi			#Generic FDDI
41183401efaSGarrett Wollmanpseudo-device	sppp			#Generic Synchronous PPP
4126a8d6623SGarrett Wollmanpseudo-device	loop			#Network loopback device
413fb46af4fSDag-Erling Smørgravpseudo-device	bpfilter 4		#Berkeley packet filter
414829b5d55SPeter Wemmpseudo-device	disc			#Discard device
415829b5d55SPeter Wemmpseudo-device	tun	1		#Tunnel driver (user process ppp(8))
4166a8d6623SGarrett Wollmanpseudo-device	sl	2		#Serial Line IP
4176a8d6623SGarrett Wollmanpseudo-device	ppp	2		#Point-to-point protocol
418d1721fe1SMark Newtonpseudo-device	streams
41989327d27SPeter Wemmoptions PPP_BSDCOMP			#PPP BSD-compress support
42089327d27SPeter Wemmoptions PPP_DEFLATE			#PPP zlib/deflate/gzip support
42196be526aSPeter Wemmoptions PPP_FILTER			#enable bpf filtering (needs bpfilter)
422d29895dcSGarrett Wollman
4236a8d6623SGarrett Wollman#
4246a8d6623SGarrett Wollman# Internet family options:
4256a8d6623SGarrett Wollman#
4266a8d6623SGarrett Wollman# TCP_COMPAT_42 causes the TCP code to emulate certain bugs present in
4276a8d6623SGarrett Wollman# 4.2BSD.  This option should not be used unless you have a 4.2BSD
4286a8d6623SGarrett Wollman# machine and TCP connections fail.
4296a8d6623SGarrett Wollman#
4306a8d6623SGarrett Wollman# MROUTING enables the kernel multicast packet forwarder, which works
4316a8d6623SGarrett Wollman# with mrouted(8).
4326a8d6623SGarrett Wollman#
433d29895dcSGarrett Wollman# IPFIREWALL enables support for IP firewall construction, in
434ff6f025aSAlexander Langer# conjunction with the `ipfw' program.  IPFIREWALL_VERBOSE sends
435ff6f025aSAlexander Langer# logged packets to the system logger.  IPFIREWALL_VERBOSE_LIMIT
436ff6f025aSAlexander Langer# limits the number of times a matching entry can be logged.
437ab6e02daSJordan K. Hubbard#
438ab6e02daSJordan K. Hubbard# WARNING:  IPFIREWALL defaults to a policy of "deny ip from any to any"
439ab6e02daSJordan K. Hubbard# and if you do not add other rules during startup to allow access,
440ab6e02daSJordan K. Hubbard# YOU WILL LOCK YOURSELF OUT.  It is suggested that you set firewall=open
441ab6e02daSJordan K. Hubbard# in /etc/rc.conf when first enabling this feature, then refining the
442ab6e02daSJordan K. Hubbard# firewall rules in /etc/rc.firewall after you've tested that the new kernel
443ab6e02daSJordan K. Hubbard# feature works properly.
4448dd4744eSJordan K. Hubbard#
445ffdd472dSPeter Wemm# IPFIREWALL_DEFAULT_TO_ACCEPT causes the default rule (at boot) to
446ffdd472dSPeter Wemm# allow everything.  Use with care, if a cracker can crash your
447ffdd472dSPeter Wemm# firewall machine, they can get to your protected machines.  However,
448ffdd472dSPeter Wemm# if you are using it as an as-needed filter for specific problems as
449ffdd472dSPeter Wemm# they arise, then this may be for you.  Changing the default to 'allow'
450ffdd472dSPeter Wemm# means that you won't get stuck if the kernel and /sbin/ipfw binary get
451ffdd472dSPeter Wemm# out of sync.
452d29895dcSGarrett Wollman#
45393e0e116SJulian Elischer# IPDIVERT enables the divert IP sockets, used by ``ipfw divert''
45493e0e116SJulian Elischer#
4551689d8bdSPeter Wemm# IPFILTER enables Darren Reed's ipfilter package.
4561689d8bdSPeter Wemm# IPFILTER_LOG enables ipfilter's logging.
4571689d8bdSPeter Wemm# IPFILTER_LKM enables LKM support for an ipfilter module (untested).
4581689d8bdSPeter Wemm#
4591b968362SDag-Erling Smørgrav# IPSTEALTH enables code to support stealth forwarding (i.e., forwarding
4601b968362SDag-Erling Smørgrav# packets without touching the ttl).  This can be useful to hide firewalls
4611b968362SDag-Erling Smørgrav# from traceroute and similar tools.
4621b968362SDag-Erling Smørgrav#
46365e8111fSBruce Evans# TCPDEBUG is undocumented.
46465e8111fSBruce Evans#
4656a8d6623SGarrett Wollmanoptions		"TCP_COMPAT_42"		#emulate 4.2BSD TCP bugs
466e3178a06SJordan K. Hubbardoptions		MROUTING		# Multicast routing
467d29895dcSGarrett Wollmanoptions         IPFIREWALL              #firewall
468d29895dcSGarrett Wollmanoptions         IPFIREWALL_VERBOSE      #print information about
469d29895dcSGarrett Wollman					# dropped packets
4701857b6feSDag-Erling Smørgravoptions         IPFIREWALL_FORWARD      #enable transparent proxy support
471ff6f025aSAlexander Langeroptions		"IPFIREWALL_VERBOSE_LIMIT=100" #limit verbosity
472e43a9900SAlexander Langeroptions		IPFIREWALL_DEFAULT_TO_ACCEPT #allow everything by default
47393e0e116SJulian Elischeroptions		IPDIVERT		#divert sockets
4741689d8bdSPeter Wemmoptions		IPFILTER		#kernel ipfilter support
4751689d8bdSPeter Wemmoptions		IPFILTER_LOG		#ipfilter logging
4761689d8bdSPeter Wemm#options	IPFILTER_LKM		#kernel support for ip_fil.o LKM
4771b968362SDag-Erling Smørgravoptions		IPSTEALTH		#support for stealth forwarding
47865e8111fSBruce Evansoptions		TCPDEBUG
4796a8d6623SGarrett Wollman
4803b60b6acSMatthew Dillon# ICMP_BANDLIM enables icmp error response bandwidth limiting.   You
4813b60b6acSMatthew Dillon# typically want this option as it will help protect the machine from
4823b60b6acSMatthew Dillon# D.O.S. packet attacks.
4833b60b6acSMatthew Dillon#
4843b60b6acSMatthew Dillonoptions         "ICMP_BANDLIM"
4853b60b6acSMatthew Dillon
48668e9d934SLuigi Rizzo# DUMMYNET enables the "dummynet" bandwidth limiter. You need
48768e9d934SLuigi Rizzo# IPFIREWALL as well. See the dummynet(4) manpage for more info.
48868e9d934SLuigi Rizzo# BRIDGE enables bridging between ethernet cards -- see bridge(4).
48968e9d934SLuigi Rizzo# You can use IPFIREWALL and dummynet together with bridging.
49068ec4eb6SLuigi Rizzooptions	DUMMYNET
49168ec4eb6SLuigi Rizzooptions	BRIDGE
49268e9d934SLuigi Rizzo
4933f8c4506SPoul-Henning Kamp#
4943f8c4506SPoul-Henning Kamp# ATM (HARP version) options
4953f8c4506SPoul-Henning Kamp#
4963f8c4506SPoul-Henning Kamp# ATM_CORE includes the base ATM functionality code.  This must be included
4973f8c4506SPoul-Henning Kamp#	for ATM support.
4983f8c4506SPoul-Henning Kamp#
4993f8c4506SPoul-Henning Kamp# ATM_IP includes support for running IP over ATM.
5003f8c4506SPoul-Henning Kamp#
5013f8c4506SPoul-Henning Kamp# At least one (and usually only one) of the following signalling managers
5023f8c4506SPoul-Henning Kamp# must be included (note that all signalling managers include PVC support):
5033f8c4506SPoul-Henning Kamp# ATM_SIGPVC includes support for the PVC-only signalling manager `sigpvc'.
5043f8c4506SPoul-Henning Kamp# ATM_SPANS includes support for the `spans' signalling manager, which runs
5053f8c4506SPoul-Henning Kamp#	the FORE Systems's proprietary SPANS signalling protocol.
5063f8c4506SPoul-Henning Kamp# ATM_UNI includes support for the `uni30' and `uni31' signalling managers,
5073f8c4506SPoul-Henning Kamp#	which run the ATM Forum UNI 3.x signalling protocols.
5083f8c4506SPoul-Henning Kamp#
5093f8c4506SPoul-Henning Kamp# The `hea' driver provides support for the Efficient Networks, Inc.
5103f8c4506SPoul-Henning Kamp# ENI-155p ATM PCI Adapter.
5113f8c4506SPoul-Henning Kamp#
5123f8c4506SPoul-Henning Kamp# The `hfa' driver provides support for the FORE Systems, Inc.
5133f8c4506SPoul-Henning Kamp# PCA-200E ATM PCI Adapter.
5143f8c4506SPoul-Henning Kamp#
5153f8c4506SPoul-Henning Kampoptions		ATM_CORE		#core ATM protocol family
5163f8c4506SPoul-Henning Kampoptions		ATM_IP			#IP over ATM support
5173f8c4506SPoul-Henning Kampoptions		ATM_SIGPVC		#SIGPVC signalling manager
5183f8c4506SPoul-Henning Kampoptions		ATM_SPANS		#SPANS signalling manager
5193f8c4506SPoul-Henning Kampoptions		ATM_UNI			#UNI signalling manager
5203f8c4506SPoul-Henning Kampdevice		hea0			#Efficient ENI-155p ATM PCI
5213f8c4506SPoul-Henning Kampdevice		hfa0			#FORE PCA-200E ATM PCI
5223f8c4506SPoul-Henning Kamp
5236a8d6623SGarrett Wollman
5246a8d6623SGarrett Wollman#####################################################################
5256a8d6623SGarrett Wollman# FILESYSTEM OPTIONS
526e3178a06SJordan K. Hubbard
5272365e64fSRodney W. Grimes#
5286a8d6623SGarrett Wollman# Only the root, /usr, and /tmp filesystems need be statically
5296a8d6623SGarrett Wollman# compiled; everything else will be automatically loaded at mount
530c5b193bfSPoul-Henning Kamp# time.  (Exception: the UFS family---FFS, and MFS --- cannot
5316a8d6623SGarrett Wollman# currently be demand-loaded.)  Some people still prefer to statically
5326a8d6623SGarrett Wollman# compile other filesystems as well.
5336a8d6623SGarrett Wollman#
534a5b88b01SKATO Takenori# NB: The NULL, PORTAL, UMAP and UNION filesystems are known to be
535a5b88b01SKATO Takenori# buggy, and WILL panic your system if you attempt to do anything with
536a5b88b01SKATO Takenori# them.  They are included here as an incentive for some enterprising
537a5b88b01SKATO Takenori# soul to sit down and fix them.
5382365e64fSRodney W. Grimes#
539f1a9c715SDavid Greenman
5406a8d6623SGarrett Wollman# One of these is mandatory:
5416a8d6623SGarrett Wollmanoptions		FFS			#Fast filesystem
54232a023dcSDavid E. O'Brienoptions		MFS			#Memory File System
5436a8d6623SGarrett Wollmanoptions		NFS			#Network File System
5446a8d6623SGarrett Wollman
5456a8d6623SGarrett Wollman# The rest are optional:
5467c115697SPoul-Henning Kamp# options	NFS_NOSERVER		#Disable the NFS-server code.
547abd931ffSDavid E. O'Brienoptions		"CD9660"		#ISO 9660 filesystem
548f1a9c715SDavid Greenmanoptions		FDESC			#File descriptor filesystem
549f1a9c715SDavid Greenmanoptions		KERNFS			#Kernel filesystem
5503f9a6982SDoug Rabsonoptions		MSDOSFS			#MS DOS File System
5513ee9bf69SEivind Eklundoptions		NTFS			#NT File System
552f1a9c715SDavid Greenmanoptions		NULLFS			#NULL filesystem
553f1a9c715SDavid Greenmanoptions		PORTAL			#Portal filesystem
554f1a9c715SDavid Greenmanoptions		PROCFS			#Process filesystem
555f1a9c715SDavid Greenmanoptions		UMAPFS			#UID map filesystem
556f1a9c715SDavid Greenmanoptions		UNION			#Union filesystem
557a788bdc4SDavid E. O'Brien# The xFS_ROOT options REQUIRE the associated ``options xFS''
558abd931ffSDavid E. O'Brienoptions		"CD9660_ROOT"		#CD-ROM usable as root device
5597b778b5eSEivind Eklundoptions		FFS_ROOT		#FFS usable as root device
56032a023dcSDavid E. O'Brienoptions		MFS_ROOT		#MFS usable as root device
5617b778b5eSEivind Eklundoptions		NFS_ROOT		#NFS usable as root device
562c796cfa1SAndrzej Bialecki# This code is still experimental (e.g. doesn't handle disk slices well).
563c796cfa1SAndrzej Bialecki# Also, 'options MFS' is currently incompatible with DEVFS.
56446746c3bSJulian Elischeroptions		DEVFS			#devices filesystem
565f1a9c715SDavid Greenman
566f8f8d7afSEivind Eklund# Soft updates is technique for improving file system speed and
567f8f8d7afSEivind Eklund# making abrupt shutdown less risky.  It is not enabled by default due
568f8f8d7afSEivind Eklund# to copyright restraints on the code that implement it.
569f8f8d7afSEivind Eklund#
570a29a2986SRobert Nordier# Read ../../ufs/ffs/README.softupdates to learn what you need to
571f8f8d7afSEivind Eklund# do to enable this.  ../../../contrib/sys/softupdates/README gives
572f8f8d7afSEivind Eklund# more details on how they actually work.
573f8f8d7afSEivind Eklund#
574b1897c19SJulian Elischer#options		SOFTUPDATES
575b1897c19SJulian Elischer
576d52d7365SPoul-Henning Kamp# Make space in the kernel for a MFS root filesystem.  Define to the number
577d52d7365SPoul-Henning Kamp# of kilobytes to reserve for the filesystem.
5781315dabdSBruce Evansoptions		MFS_ROOT_SIZE=10
579a9c94e9bSJohn-Mark Gurney# Allows MFS filesystems to be exported via nfs
580a9c94e9bSJohn-Mark Gurneyoptions		EXPORTMFS
581d52d7365SPoul-Henning Kamp
582a401ebbeSDavid Greenman# Allow this many swap-devices.
583b1529bdaSPeter Wemmoptions		NSWAPDEV=20
584a401ebbeSDavid Greenman
585495967e4SEivind Eklund# Disk quotas are supported when this option is enabled.
5862365e64fSRodney W. Grimesoptions		QUOTA			#enable disk quotas
5876a8d6623SGarrett Wollman
58823d048eeSGary Palmer# Add more checking code to various filesystems
58923d048eeSGary Palmer#options		NULLFS_DIAGNOSTIC
59023d048eeSGary Palmer#options		KERNFS_DIAGNOSTIC
59123d048eeSGary Palmer#options		UMAPFS_DIAGNOSTIC
59223d048eeSGary Palmer#options		UNION_DIAGNOSTIC
59323d048eeSGary Palmer
5945a9714deSJoerg Wunsch# In particular multi-session CD-Rs might require a huge amount of
5955a9714deSJoerg Wunsch# time in order to "settle".  If we are about mounting them as the
5965a9714deSJoerg Wunsch# root f/s, we gotta wait a little.
5975a9714deSJoerg Wunsch#
5985a9714deSJoerg Wunsch# The number is supposed to be in seconds.
5995a9714deSJoerg Wunschoptions		"CD9660_ROOTDELAY=20"
6005a9714deSJoerg Wunsch
601276756a4SDag-Erling Smørgrav# If you are running a machine just as a fileserver for PC and MAC
602276756a4SDag-Erling Smørgrav# users, using SAMBA or Netatalk, you may consider setting this option
603276756a4SDag-Erling Smørgrav# and keeping all those users' directories on a filesystem that is
604276756a4SDag-Erling Smørgrav# mounted with the suiddir option. This gives new files the same
605276756a4SDag-Erling Smørgrav# ownership as the directory (similiar to group). It's a security hole
6066110161fSDag-Erling Smørgrav# if you let these users run programs, so confine it to file-servers
607276756a4SDag-Erling Smørgrav# (but it'll save you lots of headaches in those cases). Root owned
608276756a4SDag-Erling Smørgrav# directories are exempt and X bits are cleared. The suid bit must be
609276756a4SDag-Erling Smørgrav# set on the directory as well; see chmod(1) PC owners can't see/set
610276756a4SDag-Erling Smørgrav# ownerships so they keep getting their toes trodden on. This saves
611276756a4SDag-Erling Smørgrav# you all the support calls as the filesystem it's used on will act as
612276756a4SDag-Erling Smørgrav# they expect: "It's my dir so it must be my file".
613cb800e34SJulian Elischer#
614cb800e34SJulian Elischeroptions		SUIDDIR
615cb800e34SJulian Elischer
616cb800e34SJulian Elischer
61723d048eeSGary Palmer# Add some error checking code to the null_bypass routine
618c85cfdb2SDavid E. O'Brien# in the NULL filesystem
61923d048eeSGary Palmer#options		SAFETY
62023d048eeSGary Palmer
621df394affSJohn-Mark Gurney
622df394affSJohn-Mark Gurney# NFS options:
623df394affSJohn-Mark Gurneyoptions		"NFS_MINATTRTIMO=3"	# VREG attrib cache timeout in sec
624df394affSJohn-Mark Gurneyoptions		"NFS_MAXATTRTIMO=60"
625df394affSJohn-Mark Gurneyoptions		"NFS_MINDIRATTRTIMO=30"	# VDIR attrib cache timeout in sec
626df394affSJohn-Mark Gurneyoptions		"NFS_MAXDIRATTRTIMO=60"
627df394affSJohn-Mark Gurneyoptions		"NFS_GATHERDELAY=10"	# Default write gather delay (msec)
628df394affSJohn-Mark Gurneyoptions		"NFS_UIDHASHSIZ=29"	# Tune the size of nfssvc_sock with this
629df394affSJohn-Mark Gurneyoptions		"NFS_WDELAYHASHSIZ=16"	# and with this
630df394affSJohn-Mark Gurneyoptions		"NFS_MUIDHASHSIZ=63"	# Tune the size of nfsmount with this
631df394affSJohn-Mark Gurneyoptions		NFS_DEBUG		# Enable NFS Debugging
632df394affSJohn-Mark Gurney
6339afcea2fSRobert V. Baron# Coda stuff:
6349afcea2fSRobert V. Baronoptions		CODA			#CODA filesystem.
6359afcea2fSRobert V. Baronpseudo-device	vcoda	4		#coda minicache <-> venus comm.
636a1d55890SJordan K. Hubbard
637053a2b61SEivind Eklund#
638053a2b61SEivind Eklund# Add support for the EXT2FS filesystem of Linux fame.  Be a bit
639053a2b61SEivind Eklund# careful with this - the ext2fs code has a tendency to lag behind
640053a2b61SEivind Eklund# changes and not be exercised very much, so mounting read/write could
641053a2b61SEivind Eklund# be dangerous (and even mounting read only could result in panics.)
642053a2b61SEivind Eklund#
643053a2b61SEivind Eklundoptions		"EXT2FS"
644053a2b61SEivind Eklund
645053a2b61SEivind Eklund
6466a8d6623SGarrett Wollman
6476a8d6623SGarrett Wollman#####################################################################
648abc97a06SBruce Evans# POSIX P1003.1B
649abc97a06SBruce Evans
650abc97a06SBruce Evans# Real time extensions added int the 1993 Posix
651abc97a06SBruce Evans# P1003_1B: Infrastructure
652abc97a06SBruce Evans# _KPOSIX_PRIORITY_SCHEDULING: Build in _POSIX_PRIORITY_SCHEDULING
653abc97a06SBruce Evans# _KPOSIX_VERSION:             Version kernel is built for
654abc97a06SBruce Evans
655abc97a06SBruce Evansoptions		"P1003_1B"
656abc97a06SBruce Evansoptions		"_KPOSIX_PRIORITY_SCHEDULING"
657abc97a06SBruce Evansoptions		"_KPOSIX_VERSION=199309L"
658abc97a06SBruce Evans
659abc97a06SBruce Evans
660abc97a06SBruce Evans#####################################################################
661de6a307eSPeter Dufault# SCSI DEVICES
662de6a307eSPeter Dufault
6636a8d6623SGarrett Wollman# SCSI DEVICE CONFIGURATION
6646a8d6623SGarrett Wollman
6656a8d6623SGarrett Wollman# The SCSI subsystem consists of the `base' SCSI code, a number of
666ebc1a0e2SPeter Dufault# high-level SCSI device `type' drivers, and the low-level host-adapter
6676a8d6623SGarrett Wollman# device drivers.  The host adapters are listed in the ISA and PCI
6686a8d6623SGarrett Wollman# device configuration sections below.
6696a8d6623SGarrett Wollman#
670265368d4SRodney W. Grimes# Beginning with FreeBSD 2.0.5 you can wire down your SCSI devices so
671ebc1a0e2SPeter Dufault# that a given bus, target, and LUN always come on line as the same
672ebc1a0e2SPeter Dufault# device unit.  In earlier versions the unit numbers were assigned
673ebc1a0e2SPeter Dufault# in the order that the devices were probed on the SCSI bus.  This
674ebc1a0e2SPeter Dufault# means that if you removed a disk drive, you may have had to rewrite
675ebc1a0e2SPeter Dufault# your /etc/fstab file, and also that you had to be careful when adding
676ebc1a0e2SPeter Dufault# a new disk as it may have been probed earlier and moved your device
677ebc1a0e2SPeter Dufault# configuration around.
678ebc1a0e2SPeter Dufault
679ebc1a0e2SPeter Dufault# This old behavior is maintained as the default behavior.  The unit
680ebc1a0e2SPeter Dufault# assignment begins with the first non-wired down unit for a device
681700daf5eSJustin T. Gibbs# type.  For example, if you wire a disk as "da3" then the first
682700daf5eSJustin T. Gibbs# non-wired disk will be assigned da4.
683ebc1a0e2SPeter Dufault
684ebc1a0e2SPeter Dufault# The syntax for wiring down devices is:
685ebc1a0e2SPeter Dufault
6864fbaf9a7SJustin T. Gibbs# controller	scbus0 at ahc0		# Single bus device
6874fbaf9a7SJustin T. Gibbs# controller	scbus1 at ahc1 bus 0	# Single bus device
6884fbaf9a7SJustin T. Gibbs# controller	scbus3 at ahc2 bus 0	# Twin bus device
6894fbaf9a7SJustin T. Gibbs# controller	scbus2 at ahc2 bus 1	# Twin bus device
690700daf5eSJustin T. Gibbs# disk 		da0 at scbus0 target 0 unit 0
691700daf5eSJustin T. Gibbs# disk		da1 at scbus3 target 1
692700daf5eSJustin T. Gibbs# disk		da2 at scbus2 target 3
6934fbaf9a7SJustin T. Gibbs# tape		st1 at scbus1 target 6
694ebc1a0e2SPeter Dufault# device	cd0 at scbus?
695ebc1a0e2SPeter Dufault
696ebc1a0e2SPeter Dufault# "units" (SCSI logical unit number) that are not specified are
697ebc1a0e2SPeter Dufault# treated as if specified as LUN 0.
698ebc1a0e2SPeter Dufault
699ebc1a0e2SPeter Dufault# All SCSI devices allocate as many units as are required.
700ebc1a0e2SPeter Dufault
701265368d4SRodney W. Grimes# The "unknown" device (uk? in pre-2.0.5) is now part of the base SCSI
702ebc1a0e2SPeter Dufault# configuration and doesn't have to be explicitly configured.
703ebc1a0e2SPeter Dufault
7046a8d6623SGarrett Wollmancontroller	scbus0	#base SCSI code
7056a8d6623SGarrett Wollmandevice		ch0	#SCSI media changers
706700daf5eSJustin T. Gibbsdevice		da0	#SCSI direct access devices (aka disks)
707700daf5eSJustin T. Gibbsdevice		sa0	#SCSI tapes
7086a8d6623SGarrett Wollmandevice		cd0	#SCSI CD-ROMs
709700daf5eSJustin T. Gibbs#device		od0	#SCSI optical disk
710700daf5eSJustin T. Gibbsdevice		pass0	#CAM passthrough driver
7116a8d6623SGarrett Wollman
712700daf5eSJustin T. Gibbs# The previous devices (ch, da, st, cd) are recognized by config.
713265368d4SRodney W. Grimes# config doesn't (and shouldn't) know about these newer ones,
714265368d4SRodney W. Grimes# so we have to specify that they are on a SCSI bus with the "at scbus?"
715265368d4SRodney W. Grimes# clause.
716265368d4SRodney W. Grimes
7178909a72bSPeter Dufaultdevice pt0 at scbus?	# SCSI processor type
7188909a72bSPeter Dufaultdevice sctarg0 at scbus? # SCSI target
7198909a72bSPeter Dufault
720700daf5eSJustin T. Gibbs# CAM OPTIONS:
721700daf5eSJustin T. Gibbs# debugging options:
722700daf5eSJustin T. Gibbs# -- NOTE --  If you specify one of the bus/target/lun options, you must
723700daf5eSJustin T. Gibbs#             specify them all!
724700daf5eSJustin T. Gibbs# CAMDEBUG: When defined enables debugging macros
725700daf5eSJustin T. Gibbs# CAM_DEBUG_BUS:  Debug the given bus.  Use -1 to debug all busses.
726700daf5eSJustin T. Gibbs# CAM_DEBUG_TARGET:  Debug the given target.  Use -1 to debug all targets.
727700daf5eSJustin T. Gibbs# CAM_DEBUG_LUN:  Debug the given lun.  Use -1 to debug all luns.
728d05caa00SKenneth D. Merry# CAM_DEBUG_FLAGS:  OR together CAM_DEBUG_INFO, CAM_DEBUG_TRACE,
729d05caa00SKenneth D. Merry#                   CAM_DEBUG_SUBTRACE, and CAM_DEBUG_CDB
730700daf5eSJustin T. Gibbs#
731700daf5eSJustin T. Gibbs# CAM_MAX_HIGHPOWER: Maximum number of concurrent high power (start unit) cmds
732700daf5eSJustin T. Gibbs# SCSI_NO_SENSE_STRINGS: When defined disables sense descriptions
733700daf5eSJustin T. Gibbs# SCSI_NO_OP_STRINGS: When defined disables opcode descriptions
7341a7c583cSGarrett Wollman# SCSI_REPORT_GEOMETRY: Always report disk geometry at boot up instead
735265368d4SRodney W. Grimes#                       of only when booting verbosely.
73656234437SKenneth D. Merry# SCSI_DELAY: The number of MILLISECONDS to freeze the SIM (scsi adapter)
73756234437SKenneth D. Merry#             queue after a bus reset, and the number of milliseconds to
73856234437SKenneth D. Merry#             freeze the device queue after a bus device reset.
739700daf5eSJustin T. Gibbsoptions		CAMDEBUG
740700daf5eSJustin T. Gibbsoptions		"CAM_DEBUG_BUS=-1"
741700daf5eSJustin T. Gibbsoptions		"CAM_DEBUG_TARGET=-1"
742700daf5eSJustin T. Gibbsoptions		"CAM_DEBUG_LUN=-1"
743d05caa00SKenneth D. Merryoptions		"CAM_DEBUG_FLAGS=CAM_DEBUG_INFO|CAM_DEBUG_TRACE|CAM_DEBUG_CDB"
744700daf5eSJustin T. Gibbsoptions		"CAM_MAX_HIGHPOWER=4"
745700daf5eSJustin T. Gibbsoptions		SCSI_NO_SENSE_STRINGS
746700daf5eSJustin T. Gibbsoptions		SCSI_NO_OP_STRINGS
7471a7c583cSGarrett Wollmanoptions		SCSI_REPORT_GEOMETRY
74856234437SKenneth D. Merryoptions		SCSI_DELAY=8000	# Be pessimistic about Joe SCSI device
7491a7c583cSGarrett Wollman
750700daf5eSJustin T. Gibbs# Options for the CAM CDROM driver:
751700daf5eSJustin T. Gibbs# CHANGER_MIN_BUSY_SECONDS: Guaranteed minimum time quantum for a changer LUN
752700daf5eSJustin T. Gibbs# CHANGER_MAX_BUSY_SECONDS: Maximum time quantum per changer LUN, only
753700daf5eSJustin T. Gibbs#                           enforced if there is I/O waiting for another LUN
754700daf5eSJustin T. Gibbs# The compiled in defaults for these variables are 2 and 10 seconds,
755700daf5eSJustin T. Gibbs# respectively.
75693063432SJoerg Wunsch#
757700daf5eSJustin T. Gibbs# These can also be changed on the fly with the following sysctl variables:
758700daf5eSJustin T. Gibbs# kern.cam.cd.changer.min_busy_seconds
759700daf5eSJustin T. Gibbs# kern.cam.cd.changer.max_busy_seconds
76093063432SJoerg Wunsch#
761700daf5eSJustin T. Gibbsoptions		"CHANGER_MIN_BUSY_SECONDS=2"
762700daf5eSJustin T. Gibbsoptions		"CHANGER_MAX_BUSY_SECONDS=10"
76393063432SJoerg Wunsch
7649dfb4471SKenneth D. Merry# Options for the CAM sequential access driver:
7659dfb4471SKenneth D. Merry# SA_SPACE_TIMEOUT: Timeout for space operations, in minutes
7669dfb4471SKenneth D. Merry# SA_REWIND_TIMEOUT: Timeout for rewind operations, in minutes
7679dfb4471SKenneth D. Merry# SA_ERASE_TIMEOUT: Timeout for erase operations, in minutes
7689dfb4471SKenneth D. Merryoptions		"SA_SPACE_TIMEOUT=(60)"
7699dfb4471SKenneth D. Merryoptions		"SA_REWIND_TIMEOUT=(2*60)"
7709dfb4471SKenneth D. Merryoptions		"SA_ERASE_TIMEOUT=(4*60)"
7719dfb4471SKenneth D. Merry
7726a8d6623SGarrett Wollman
7736a8d6623SGarrett Wollman#####################################################################
7746a8d6623SGarrett Wollman# MISCELLANEOUS DEVICES AND OPTIONS
7756a8d6623SGarrett Wollman
7761160da92SJoerg Wunsch# The `pty' device usually turns out to be ``effectively mandatory'',
7771160da92SJoerg Wunsch# as it is required for `telnetd', `rlogind', `screen', `emacs', and
7781160da92SJoerg Wunsch# `xterm', among others.
7791160da92SJoerg Wunsch
7802aba17b3SGary Palmerpseudo-device	pty	16	#Pseudo ttys - can go as high as 256
7816a8d6623SGarrett Wollmanpseudo-device	speaker		#Play IBM BASIC-style noises out your speaker
7826a8d6623SGarrett Wollmanpseudo-device	gzip		#Exec gzipped a.out's
783784cf072SPoul-Henning Kamppseudo-device	vn		#Vnode driver (turns a file into a device)
7844cba4555SUgen J.S. Antsilevichpseudo-device	snp	3	#Snoop device - to look at pty/vty/etc..
78503b225a3SSatoshi Asamipseudo-device	ccd	4	#Concatenated disk driver
786be174c7eSGreg Lehey
787be174c7eSGreg Lehey# Configuring Vinum into the kernel is not necessary, since the kld
788be174c7eSGreg Lehey# module gets started automatically when vinum(8) starts.  This
789be174c7eSGreg Lehey# device is also untested.  Use at your own risk.
7904cc4752cSGreg Lehey#
7914cc4752cSGreg Lehey# The option VINUMDEBUG must match the value set in CFLAGS
792c867b0e5SPoul-Henning Kamp# in /usr/src/sbin/vinum/Makefile.  Failure to do so will result in
7934cc4752cSGreg Lehey# the following message from vinum(8):
7944cc4752cSGreg Lehey#
7954cc4752cSGreg Lehey# Can't get vinum config: Invalid argument
7964cc4752cSGreg Lehey#
7974cc4752cSGreg Lehey# see vinum(4) for more reasons not to use these options.
7983ea799d5SPeter Wemmpseudo-device	vinum		#Vinum concat/mirror/raid driver
7993ea799d5SPeter Wemmoptions 	VINUMDEBUG	#enable Vinum debugging hooks
8009ba0e7c3SBruce Evans
80165e8111fSBruce Evans# These are only for watching for bitrot in old tty code.
80265e8111fSBruce Evans# broken
80365e8111fSBruce Evans#pseudo-device	tb
80465e8111fSBruce Evans
80558067a99SPoul-Henning Kamp# Size of the kernel message buffer.  Should be N * pagesize.
80658067a99SPoul-Henning Kampoptions		"MSGBUF_SIZE=40960"
80758067a99SPoul-Henning Kamp
8086a8d6623SGarrett Wollman
8096a8d6623SGarrett Wollman#####################################################################
8106a8d6623SGarrett Wollman# HARDWARE DEVICE CONFIGURATION
8116a8d6623SGarrett Wollman
8126a8d6623SGarrett Wollman# ISA and EISA devices:
813c37ddbb8SJoerg Wunsch# EISA support is available for some device, so they can be auto-probed.
8146a8d6623SGarrett Wollman# Micro Channel is not supported at all.
8156a8d6623SGarrett Wollman
8166a8d6623SGarrett Wollman#
81716e164e3SBruce Evans# Mandatory ISA devices: isa, npx
8186a8d6623SGarrett Wollman#
8192365e64fSRodney W. Grimescontroller	isa0
8202365e64fSRodney W. Grimes
8216a8d6623SGarrett Wollman#
8226a8d6623SGarrett Wollman# Options for `isa':
8236a8d6623SGarrett Wollman#
824d72ee36fSBruce Evans# AUTO_EOI_1 enables the `automatic EOI' feature for the master 8259A
825d72ee36fSBruce Evans# interrupt controller.  This saves about 0.7-1.25 usec for each interrupt.
826d72ee36fSBruce Evans# This option breaks suspend/resume on some portables.
827d72ee36fSBruce Evans#
8289ba0e7c3SBruce Evans# AUTO_EOI_2 enables the `automatic EOI' feature for the slave 8259A
829d72ee36fSBruce Evans# interrupt controller.  This saves about 0.7-1.25 usec for each interrupt.
8309ba0e7c3SBruce Evans# Automatic EOI is documented not to work for for the slave with the
8319ba0e7c3SBruce Evans# original i8259A, but it works for some clones and some integrated
8329ba0e7c3SBruce Evans# versions.
8339ba0e7c3SBruce Evans#
834b2796687SNate Williams# MAXMEM specifies the amount of RAM on the machine; if this is not
8359bc192deSDavid E. O'Brien# specified, FreeBSD will first read the amount of memory from the CMOS
8369bc192deSDavid E. O'Brien# RAM, so the amount of memory will initially be limited to 64MB or 16MB
8379bc192deSDavid E. O'Brien# depending on the BIOS.  If the BIOS reports 64MB, a memory probe will
8389bc192deSDavid E. O'Brien# then attempt to detect the installed amount of RAM.  If this probe
8399bc192deSDavid E. O'Brien# fails to detect >64MB RAM you will have to use the MAXMEM option.
8409bc192deSDavid E. O'Brien# The amount is in kilobytes, so for a machine with 128MB of RAM, it would
8419bc192deSDavid E. O'Brien# be 131072 (128 * 1024).
842b2796687SNate Williams#
8433339606dSAndreas Schulz# TUNE_1542 enables the automatic ISA bus speed selection for the
8443339606dSAndreas Schulz# Adaptec 1542 boards. Does not work for all boards, use it with caution.
8453339606dSAndreas Schulz#
8465eb46edfSDavid Greenman# BROKEN_KEYBOARD_RESET disables the use of the keyboard controller to
8475eb46edfSDavid Greenman# reset the CPU for reboot.  This is needed on some systems with broken
8485eb46edfSDavid Greenman# keyboard controllers.
8493eafdedeSBruce Evans#
85077959e8eSMarc G. Fournier# PAS_JOYSTICK_ENABLE enables the gameport on the ProAudio Spectrum
85177959e8eSMarc G. Fournier
852d72ee36fSBruce Evansoptions		"AUTO_EOI_1"
8539ba0e7c3SBruce Evans#options	"AUTO_EOI_2"
854a675c0c6SBruce Evansoptions		"MAXMEM=(128*1024)"
855c2469addSEivind Eklundoptions 	"TUNE_1542"
856b1529bdaSPeter Wemm#options	BROKEN_KEYBOARD_RESET
85777959e8eSMarc G. Fournier#options	PAS_JOYSTICK_ENABLE
8583af6b652SDavid Greenman
859595f6341SPoul-Henning Kamp# Enable support for the kernel PLL to use an external PPS signal,
860595f6341SPoul-Henning Kamp# under supervision of [x]ntpd(8)
861a2210fe1SPoul-Henning Kamp# More info in ntpd documentation: http://www.eecis.udel.edu/~ntp
862595f6341SPoul-Henning Kamp
863595f6341SPoul-Henning Kampoptions		PPS_SYNC
864595f6341SPoul-Henning Kamp
865c2906d55SPoul-Henning Kamp# If you see the "calcru: negative time of %ld usec for pid %d (%s)\n"
866c2906d55SPoul-Henning Kamp# message you probably have some broken sw/hw which disables interrupts
867c2906d55SPoul-Henning Kamp# for too long.  You can make the system more resistant to this by
868c2906d55SPoul-Henning Kamp# choosing a high value for NTIMECOUNTER.  The default is 5, there
869c2906d55SPoul-Henning Kamp# is no upper limit but more than a couple of hundred are not productive.
870a2210fe1SPoul-Henning Kamp# A better strategy may be to sysctl -w kern.timecounter.method=1
871c2906d55SPoul-Henning Kamp
872c2906d55SPoul-Henning Kampoptions		"NTIMECOUNTER=20"
873c2906d55SPoul-Henning Kamp
87453a7a570SJohn-Mark Gurney# Enable PnP support in the kernel.  This allows you to automaticly
87553a7a570SJohn-Mark Gurney# attach to PnP cards for drivers that support it and allows you to
87653a7a570SJohn-Mark Gurney# configure cards from USERCONFIG.  See pnp(4) for more info.
87753a7a570SJohn-Mark Gurneycontroller	pnp0
87853a7a570SJohn-Mark Gurney
8792ad872c5SKazutaka YOKOTA# The keyboard controller; it controlls the keyboard and the PS/2 mouse.
8802ad872c5SKazutaka YOKOTAcontroller	atkbdc0	at isa? port IO_KBD tty
8812ad872c5SKazutaka YOKOTA
8822ad872c5SKazutaka YOKOTA# The AT keyboard
8832ad872c5SKazutaka YOKOTAdevice		atkbd0	at isa? tty irq 1
8842ad872c5SKazutaka YOKOTA
8850a0319c2SKazutaka YOKOTA# Options for atkbd:
8860a0319c2SKazutaka YOKOTAoptions		ATKBD_DFLT_KEYMAP	# specify the built-in keymap
8870a0319c2SKazutaka YOKOTAmakeoptions	ATKBD_DFLT_KEYMAP="jp.106"
8880a0319c2SKazutaka YOKOTA
8890a0319c2SKazutaka YOKOTA# These options are valid for other keyboard drivers as well.
8900a0319c2SKazutaka YOKOTAoptions		KBD_DISABLE_KEYMAP_LOAD	# refuse to load a keymap
8910a0319c2SKazutaka YOKOTAoptions		KBD_INSTALL_CDEV	# install a CDEV entry in /dev
8920a0319c2SKazutaka YOKOTA
893e1b5fc4cSKazutaka YOKOTA# `flags' for atkbd:
894e1b5fc4cSKazutaka YOKOTA#       0x01    Force detection of keyboard, else we always assume a keyboard
895e1b5fc4cSKazutaka YOKOTA#       0x02    Don't reset keyboard, useful for some newer ThinkPads
896e1b5fc4cSKazutaka YOKOTA#       0x04    Old-style (XT) keyboard support, useful for older ThinkPads
897e1b5fc4cSKazutaka YOKOTA
8982ad872c5SKazutaka YOKOTA# PS/2 mouse
8992ad872c5SKazutaka YOKOTAdevice		psm0	at isa? tty irq 12
9002ad872c5SKazutaka YOKOTA
9012ad872c5SKazutaka YOKOTA# Options for psm:
9022ad872c5SKazutaka YOKOTAoptions		PSM_HOOKAPM		#hook the APM resume event, useful
9032ad872c5SKazutaka YOKOTA					#for some laptops
9042ad872c5SKazutaka YOKOTAoptions		PSM_RESETAFTERSUSPEND	#reset the device at the resume event
9052ad872c5SKazutaka YOKOTA
9062ad872c5SKazutaka YOKOTA# The video card driver.
9072ad872c5SKazutaka YOKOTAdevice		vga0	at isa? port ? conflicts
9082ad872c5SKazutaka YOKOTA
909c619f2acSKazutaka YOKOTA# Options for vga:
910c619f2acSKazutaka YOKOTA# Try the following option if the mouse pointer is not drawn correctly
911c619f2acSKazutaka YOKOTA# or font does not seem to be loaded properly.  May cause flicker on
912c619f2acSKazutaka YOKOTA# some systems.
913c619f2acSKazutaka YOKOTAoptions		VGA_ALT_SEQACCESS
914c619f2acSKazutaka YOKOTA
915c619f2acSKazutaka YOKOTA# If you can dispense with some vga driver features, you may want to
916c619f2acSKazutaka YOKOTA# use the following options to save some memory.
917c619f2acSKazutaka YOKOTAoptions		VGA_NO_FONT_LOADING	# don't save/load font
918c619f2acSKazutaka YOKOTAoptions		VGA_NO_MODE_CHANGE	# don't change video modes
919c619f2acSKazutaka YOKOTA
920c619f2acSKazutaka YOKOTA# Older video cards may require this option for proper operation.
921c619f2acSKazutaka YOKOTAoptions		VGA_SLOW_IOACCESS	# do byte-wide i/o's to TS and GDC regs
922c619f2acSKazutaka YOKOTA
9230a0319c2SKazutaka YOKOTA# To include support for VESA video modes
9240a0319c2SKazutaka YOKOTAoptions		VESA			# needs VM86 defined too!!
9250a0319c2SKazutaka YOKOTA
9262ad872c5SKazutaka YOKOTA# Splash screen at start up!  Screen savers require this too.
9272ad872c5SKazutaka YOKOTApseudo-device	splash
9282ad872c5SKazutaka YOKOTA
929c19da41eSPeter Wemm# The pcvt console driver (vt220 compatible).
9302ad872c5SKazutaka YOKOTAdevice		vt0	at isa? tty
931c19da41eSPeter Wemmoptions		XSERVER			# support for running an X server.
932c19da41eSPeter Wemmoptions		FAT_CURSOR		# start with block cursor
933c19da41eSPeter Wemm# This PCVT option is for keyboards such as those used on IBM ThinkPad laptops
934c19da41eSPeter Wemmoptions		PCVT_SCANSET=2 		# IBM keyboards are non-std
935a467384bSJoerg Wunsch# Other PCVT options are documented in pcvt(4).
936a467384bSJoerg Wunschoptions		"PCVT_24LINESDEF"
937a467384bSJoerg Wunschoptions		PCVT_CTRL_ALT_DEL
938a467384bSJoerg Wunschoptions		PCVT_EMU_MOUSE
939a467384bSJoerg Wunschoptions		PCVT_FREEBSD=211
940a467384bSJoerg Wunschoptions		PCVT_META_ESC
941a467384bSJoerg Wunschoptions		PCVT_NSCREENS=9
942a467384bSJoerg Wunschoptions		PCVT_PRETTYSCRNS
943a467384bSJoerg Wunschoptions		PCVT_SCREENSAVER
944a467384bSJoerg Wunschoptions		PCVT_USEKBDSEC
945a467384bSJoerg Wunschoptions		"PCVT_VT220KEYB"
946c19da41eSPeter Wemm
947ee16b430SBruce Evans# The syscons console driver (sco color console compatible).
9482ad872c5SKazutaka YOKOTAdevice		sc0	at isa? tty
949683cbdf4SBruce Evansoptions		MAXCONS=16		# number of virtual consoles
95038d8a113SPoul-Henning Kampoptions		"STD8X16FONT"		# Compile font in
95138d8a113SPoul-Henning Kampmakeoptions	"STD8X16FONT"="cp850"
952297976f7SKazutaka YOKOTAoptions		SC_HISTORY_SIZE=200	# number of history buffer lines
953c4118fc0SKazutaka YOKOTAoptions		SC_DISABLE_REBOOT	# disable reboot key sequence
95485e36760SJordan K. Hubbard
9556620cf78SNate Williams#
9566620cf78SNate Williams# `flags' for sc0:
9576620cf78SNate Williams#       0x01    Use a 'visual' bell
9586620cf78SNate Williams#       0x02    Use a 'blink' cursor
9595d3b1465SKazutaka YOKOTA#       0x04    Use a 'underline' cursor
9605d3b1465SKazutaka YOKOTA#       0x06    Use a 'blinking underline' (destructive) cursor
961c0fad1a4SKazutaka YOKOTA#	0x40	Make the bell quiet if it is rung in the backgroud vty.
9622ac8be82SAndreas Schulz
9636a8d6623SGarrett Wollman#
96425292acbSBruce Evans# The Numeric Processing eXtension driver.  This should be configured if
96525292acbSBruce Evans# your machine has a math co-processor, unless the coprocessor is very
96625292acbSBruce Evans# buggy. If it is not configured then you *must* configure math emulation
96725292acbSBruce Evans# (see above).  If both npx0 and emulation are configured, then only npx0
96825292acbSBruce Evans# is used (provided it works).
9694a04f6f6SBruce Evansdevice		npx0	at isa? port IO_NPX iosiz 0x0 flags 0x0 irq 13
9701fe04850SBruce Evans
97198e9e66cSNate Williams#
9721fe04850SBruce Evans# `flags' for npx0:
9731fe04850SBruce Evans#	0x01	don't use the npx registers to optimize bcopy
9741fe04850SBruce Evans#	0x02	don't use the npx registers to optimize bzero
9751fe04850SBruce Evans#	0x04	don't use the npx registers to optimize copyin or copyout.
9761fe04850SBruce Evans# The npx registers are normally used to optimize copying and zeroing when
9771fe04850SBruce Evans# all of the following conditions are satisfied:
9781fe04850SBruce Evans#	"I586_CPU" is an option
9791fe04850SBruce Evans#	the cpu is an i586 (perhaps not a Pentium)
9801fe04850SBruce Evans#	the probe for npx0 succeeds
9811fe04850SBruce Evans#	INT 16 exception handling works.
9821fe04850SBruce Evans# Then copying and zeroing using the npx registers is normally 30-100% faster.
9831fe04850SBruce Evans# The flags can be used to control cases where it doesn't work or is slower.
9841fe04850SBruce Evans# Setting them at boot time using userconfig works right (the optimizations
9851fe04850SBruce Evans# are not used until later in the bootstrap when npx0 is attached).
9861fe04850SBruce Evans#
9871fe04850SBruce Evans
9881fe04850SBruce Evans#
9891fe04850SBruce Evans# `iosiz' for npx0:
9901fe04850SBruce Evans# This can be used instead of the MAXMEM option to set the memory size.  If
9911fe04850SBruce Evans# it is nonzero, then it overrides both the MAXMEM option and the memory
9921fe04850SBruce Evans# size reported by the BIOS.  Setting it at boot time using userconfig takes
9931fe04850SBruce Evans# effect on the next reboot after the change has been recorded in the kernel
9941fe04850SBruce Evans# binary (the size is used early in the boot before userconfig has a chance
9951fe04850SBruce Evans# to change it).
9961fe04850SBruce Evans#
9976a8d6623SGarrett Wollman
9986a8d6623SGarrett Wollman#
9996a8d6623SGarrett Wollman# Optional ISA and EISA devices:
10006a8d6623SGarrett Wollman#
10016a8d6623SGarrett Wollman
10026a8d6623SGarrett Wollman#
10034a64714fSKenneth D. Merry# SCSI host adapters: `aha', `bt'
10046a8d6623SGarrett Wollman#
1005859244a6SJustin T. Gibbs# adv: All Narrow SCSI bus AdvanSys controllers.
1006859244a6SJustin T. Gibbs# adw: Second Generation AdvanSys controllers including the ADV940UW.
10076a8d6623SGarrett Wollman# aha: Adaptec 154x
10089829c3edSJordan K. Hubbard# ahc: Adaptec 274x/284x/294x
10096a8d6623SGarrett Wollman# bt: Most Buslogic controllers
10106a8d6623SGarrett Wollman#
10116a8d6623SGarrett Wollman# Note that the order is important in order for Buslogic cards to be
10126a8d6623SGarrett Wollman# probed correctly.
10136a8d6623SGarrett Wollman#
10146a8d6623SGarrett Wollman
1015700daf5eSJustin T. Gibbscontroller	bt0	at isa? port "IO_BT0" cam irq ?
10163e82ad76SJustin T. Gibbscontroller	adv0	at isa? port ? cam irq ?
1017859244a6SJustin T. Gibbscontroller	adw0
10187c0daaa8SEivind Eklundcontroller      aha0    at isa? port ? cam irq ?
10196a8d6623SGarrett Wollman
10208b89ef0aSSøren Schmidt#
10218b89ef0aSSøren Schmidt# ATA and ATAPI devices
10228b89ef0aSSøren Schmidt# This is work in progress, use at your own risk.
1023c867b0e5SPoul-Henning Kamp# It currently reuses the majors of wd.c and friends.
10248b89ef0aSSøren Schmidt# It cannot co-exist with the old system in one kernel.
10258b89ef0aSSøren Schmidt# You only need one "controller ata0" for it to find all
10268b89ef0aSSøren Schmidt# PCI devices on modern machines.
10278b89ef0aSSøren Schmidt#controller	ata0
10288b89ef0aSSøren Schmidt#device		atadisk0	# ATA disk drives
10298b89ef0aSSøren Schmidt#device		atapicd0	# ATAPI CDROM drives
103061f625f0SSøren Schmidt#device		atapifd0	# ATAPI floppy drives
10318b89ef0aSSøren Schmidt#device		atapist0	# ATAPI tape drives
10328b89ef0aSSøren Schmidt#
10338b89ef0aSSøren Schmidt# If you need ISA only devices, this is the lines to add:
10348b89ef0aSSøren Schmidt#controller	ata1	at isa? port "IO_WD1" bio irq 14
10358b89ef0aSSøren Schmidt#controller	ata2	at isa? port "IO_WD2" bio irq 15
10368b89ef0aSSøren Schmidt#
10378b89ef0aSSøren Schmidt# All the controller lines can coexist, the driver will
10388b89ef0aSSøren Schmidt# find out which ones are there.
10393c43212aSSøren Schmidt
10406a8d6623SGarrett Wollman#
10416a8d6623SGarrett Wollman# ST-506, ESDI, and IDE hard disks: `wdc' and `wd'
10426a8d6623SGarrett Wollman#
1043e3dd3158SJohn Dyson# The flags fields are used to enable the multi-sector I/O and
1044e3dd3158SJohn Dyson# the 32BIT I/O modes.  The flags may be used in either the controller
1045e3dd3158SJohn Dyson# definition or in the individual disk definitions.  The controller
1046e3dd3158SJohn Dyson# definition is supported for the boot configuration stuff.
1047e3dd3158SJohn Dyson#
1048e3dd3158SJohn Dyson# Each drive has a 16 bit flags value defined:
1049e3dd3158SJohn Dyson#	The low 8 bits are the maximum value for the multi-sector I/O,
1050e3dd3158SJohn Dyson#	where 0xff defaults to the maximum that the drive can handle.
1051e3dd3158SJohn Dyson#	The high bit of the 16 bit flags (0x8000) allows probing for
10521f7727a9SSøren Schmidt#	32 bit transfers.  Bit 14 (0x4000) enables a hack to wake
10531f7727a9SSøren Schmidt#	up powered-down laptop drives.  Bit 13 (0x2000) allows
10541f7727a9SSøren Schmidt#	probing for PCI IDE DMA controllers, such as Intel's PIIX
1055f559a836SSøren Schmidt#	south bridges. Bit 12 (0x1000) sets LBA mode instead of the
1056f559a836SSøren Schmidt#	default CHS mode for accessing the drive. See the wd.4 man page.
1057e3dd3158SJohn Dyson#
1058e3dd3158SJohn Dyson# The flags field for the drives can be specified in the controller
1059e3dd3158SJohn Dyson# specification with the low 16 bits for drive 0, and the high 16 bits
1060e3dd3158SJohn Dyson# for drive 1.
1061e3dd3158SJohn Dyson# e.g.:
106278e33712SBruce Evans#controller	wdc0	at isa? port "IO_WD1" bio irq 14 flags 0x00ff8004
1063e3dd3158SJohn Dyson#
1064e3dd3158SJohn Dyson# specifies that drive 0 will be allowed to probe for 32 bit transfers and
1065e3dd3158SJohn Dyson# a maximum multi-sector transfer of 4 sectors, and drive 1 will not be
1066e3dd3158SJohn Dyson# allowed to probe for 32 bit transfers, but will allow multi-sector
1067e3dd3158SJohn Dyson# transfers up to the maximum that the drive supports.
1068e3dd3158SJohn Dyson#
1069e871e61fSJohn Dyson# If you are using a PCI controller that is not running in compatibility
1070e871e61fSJohn Dyson# mode (for example, it is a 2nd IDE PCI interface), then use config line(s)
1071e871e61fSJohn Dyson# such as:
1072e3dd3158SJohn Dyson#
107378e33712SBruce Evans#controller	wdc2	at isa? port "0" bio irq ? flags 0xa0ffa0ff
1074e871e61fSJohn Dyson#disk		wd4	at wdc2 drive 0
1075e871e61fSJohn Dyson#disk		wd5	at wdc2 drive 1
1076e871e61fSJohn Dyson#
107778e33712SBruce Evans#controller	wdc3	at isa? port "0" bio irq ? flags 0xa0ffa0ff
1078e871e61fSJohn Dyson#disk		wd6	at wdc3 drive 0
1079e871e61fSJohn Dyson#disk		wd7	at wdc3 drive 1
1080e871e61fSJohn Dyson#
1081e871e61fSJohn Dyson# Note that the above config would be useful for a Promise card, when used
1082e871e61fSJohn Dyson# on a MB that already has a PIIX controller.  Note the bogus irq and port
1083e871e61fSJohn Dyson# entries.  These are automatically filled in by the IDE/PCI support.
1084e871e61fSJohn Dyson#
1085e871e61fSJohn Dyson
108678e33712SBruce Evanscontroller	wdc0	at isa? port "IO_WD1" bio irq 14
10872620c42eSNate Williamsdisk		wd0	at wdc0 drive 0
10882620c42eSNate Williamsdisk		wd1	at wdc0 drive 1
108978e33712SBruce Evanscontroller	wdc1	at isa? port "IO_WD2" bio irq 15
10902620c42eSNate Williamsdisk		wd2	at wdc1 drive 0
10912620c42eSNate Williamsdisk		wd3	at wdc1 drive 1
10922365e64fSRodney W. Grimes
10936a8d6623SGarrett Wollman#
10946788ce49SJordan K. Hubbard# Options for `wdc':
10956788ce49SJordan K. Hubbard#
10962928e6b5SStefan Eßer# CMD640 enables serializing access to primary and secondary channel
10972928e6b5SStefan Eßer# of the CMD640B IDE Chip. The serializing will only take place
10982928e6b5SStefan Eßer# if this option is set *and* the chip is probed by the pci-system.
10992928e6b5SStefan Eßer#
11002928e6b5SStefan Eßeroptions         "CMD640"	#Enable work around for CMD640 h/w bug
11012928e6b5SStefan Eßer#
11026788ce49SJordan K. Hubbard# ATAPI enables the support for ATAPI-compatible IDE devices
11036788ce49SJordan K. Hubbard#
11046788ce49SJordan K. Hubbardoptions         ATAPI   #Enable ATAPI support for IDE bus
11057b2305f7SAndrey A. Chernovoptions		ATAPI_STATIC	#Don't do it as an LKM
11066788ce49SJordan K. Hubbard
1107340fe9aeSEivind Eklund#
1108340fe9aeSEivind Eklund# This option allow you to override the default probe time for IDE
1109340fe9aeSEivind Eklund# devices, to get a faster probe.  Setting this below 10000 violate
1110340fe9aeSEivind Eklund# the IDE specs, but may still work for you (it will work for most
1111340fe9aeSEivind Eklund# people).
1112340fe9aeSEivind Eklund#
1113340fe9aeSEivind Eklundoptions		IDE_DELAY=8000	# Be optimistic about Joe IDE device
1114340fe9aeSEivind Eklund
1115eeded4d8SSøren Schmidt# IDE CD-ROM & CD-R/RW  driver - requires wdc controller and ATAPI option
1116d99434fbSSøren Schmidtdevice          wcd0
1117eeded4d8SSøren Schmidt
1118aaf86206SPaul Traina# IDE floppy driver - requires wdc controller and ATAPI option
1119aaf86206SPaul Trainadevice          wfd0
1120aaf86206SPaul Traina
1121ea0be999SBruce Evans# IDE tape driver - requires wdc controller and ATAPI option
1122ea0be999SBruce Evansdevice          wst0
1123ea0be999SBruce Evans
1124aaf86206SPaul Traina
11256788ce49SJordan K. Hubbard#
11266a8d6623SGarrett Wollman# Standard floppy disk controllers and floppy tapes: `fdc', `fd', and `ft'
11276a8d6623SGarrett Wollman#
112878e33712SBruce Evanscontroller	fdc0	at isa? port "IO_FD1" bio irq 6 drq 2
112985827d9cSJoerg Wunsch#
1130d2fb4892SJoerg Wunsch# FDC_DEBUG enables floppy debugging.  Since the debug output is huge, you
1131d2fb4892SJoerg Wunsch# gotta turn it actually on by setting the variable fd_debug with DDB,
1132d2fb4892SJoerg Wunsch# however.
1133d2fb4892SJoerg Wunschoptions		FDC_DEBUG
113469acd21dSWarner Losh# FDC_YE enables support for the floppies used on the Libretto.  This is a
113569acd21dSWarner Losh# pcmcia floppy.  You will also need to add
113669acd21dSWarner Losh#card "Y-E DATA" "External FDD"
113769acd21dSWarner Losh#        config 0x4 "fdc0" 10
113869acd21dSWarner Losh# to your pccard.conf file.
113969acd21dSWarner Loshoptions		FDC_YE
1140d2fb4892SJoerg Wunsch# This option is undocumented on purpose.
1141d2fb4892SJoerg Wunschoptions		FDC_PRINT_BOGUS_CHIPTYPE
1142d2fb4892SJoerg Wunsch#
114385827d9cSJoerg Wunsch# Activate this line instead of the fdc0 line above if you happen to
114485827d9cSJoerg Wunsch# have an Insight floppy tape.  Probing them proved to be dangerous
114585827d9cSJoerg Wunsch# for people with floppy disks only, so it's "hidden" behind a flag:
114678e33712SBruce Evans#controller fdc0 at isa? port "IO_FD1" bio flags 1 irq 6 drq 2
114785827d9cSJoerg Wunsch
11486a8d6623SGarrett Wollmandisk		fd0	at fdc0 drive 0
11496a8d6623SGarrett Wollmandisk		fd1	at fdc0 drive 1
115085827d9cSJoerg Wunsch
11516a8d6623SGarrett Wollman#
1152807ef708SDag-Erling Smørgrav# Other standard PC hardware: `mse', `sio', etc.
11536a8d6623SGarrett Wollman#
11546a8d6623SGarrett Wollman# mse: Logitech and ATI InPort bus mouse ports
11556a8d6623SGarrett Wollman# sio: serial ports (see sio(4))
11566a8d6623SGarrett Wollman
115778e33712SBruce Evansdevice		mse0	at isa? port 0x23c tty irq 5
1158975c53c7SDoug Rabson
115978e33712SBruce Evansdevice		sio0	at isa? port "IO_COM1" tty flags 0x10 irq 4
11609546766aSBruce Evans
11619546766aSBruce Evans#
11629546766aSBruce Evans# `flags' for serial drivers that support consoles (only for sio now):
11639546766aSBruce Evans#	0x10	enable console support for this unit.  The other console flags
11649546766aSBruce Evans#		are ignored unless this is set.  Enabling console support does
11659546766aSBruce Evans#		not make the unit the preferred console - boot with -h or set
11669546766aSBruce Evans#		the 0x20 flag for that.  Currently, at most one unit can have
11679546766aSBruce Evans#		console support; the first one (in config file order) with
11689546766aSBruce Evans#		this flag set is preferred.  Setting this flag for sio0 gives
11699546766aSBruce Evans#		the old behaviour.
11709546766aSBruce Evans#	0x20	force this unit to be the console (unless there is another
11719546766aSBruce Evans#		higher priority console).  This replaces the COMCONSOLE option.
11729546766aSBruce Evans#	0x40	reserve this unit for low level console operations.  Do not
117304fb8e53SAlexander Langer#		access the device in any normal way.
11749546766aSBruce Evans#
11756a796ce0SJohn-Mark Gurney# PnP `flags' (set via userconfig using pnp x flags y)
11766a796ce0SJohn-Mark Gurney#	0x1	disable probing of this device.  Used to prevent your modem
11776a796ce0SJohn-Mark Gurney#		from being attached as a PnP modem.
11786a796ce0SJohn-Mark Gurney#
11799546766aSBruce Evans
11809546766aSBruce Evans# Options for serial drivers that support consoles (only for sio now):
11819546766aSBruce Evansoptions		BREAK_TO_DEBUGGER	#a BREAK on a comconsole goes to
11829546766aSBruce Evans					#DDB, if available.
11835ea6cb03SPaul Trainaoptions		CONSPEED=9600		#default speed for serial console (default 9600)
11846a8d6623SGarrett Wollman
11856a8d6623SGarrett Wollman# Options for sio:
1186768fd661SBruce Evansoptions		COM_ESP			#code for Hayes ESP
11879ba0e7c3SBruce Evansoptions		COM_MULTIPORT		#code for some cards with shared IRQs
11886a796ce0SJohn-Mark Gurneyoptions		"EXTRA_SIO=2"		#number of extra sio ports to allocate
11896a8d6623SGarrett Wollman
119096b89afcSBruce Evans# Other flags for sio that aren't documented in the man page.
119196b89afcSBruce Evans#	0x20000	enable hardware RTS/CTS and larger FIFOs.  Only works for
119296b89afcSBruce Evans#		ST16650A-compatible UARTs.
119396b89afcSBruce Evans
11946a8d6623SGarrett Wollman#
119583401efaSGarrett Wollman# Network interfaces: `cx', `ed', `el', `ep', `ie', `is', `le', `lnc'
11966a8d6623SGarrett Wollman#
11976c5e9bbdSMike Pritchard# ar: Arnet SYNC/570i hdlc sync 2/4 port V.35/X.21 serial driver (requires sppp)
1198b16d163dSMike Smith# cs: IBM Etherjet and other Crystal Semi CS89x0-based adapters
119983401efaSGarrett Wollman# cx: Cronyx/Sigma multiport sync/async (with Cisco or PPP framing)
12006a8d6623SGarrett Wollman# ed: Western Digital and SMC 80xx; Novell NE1000 and NE2000; 3Com 3C503
12016a8d6623SGarrett Wollman# el: 3Com 3C501 (slow!)
12026a8d6623SGarrett Wollman# ep: 3Com 3C509 (buggy)
1203903a1a16SDag-Erling Smørgrav# ex: Intel EtherExpress Pro/10 and other i82595-based adapters
12041a7c583cSGarrett Wollman# fe: Fujitsu MB86960A/MB86965A Ethernet
12050f1d6a82SSteve Price# ie: AT&T StarLAN 10 and EN100; 3Com 3C507; unknown NI5210; Intel EtherExpress
12066a8d6623SGarrett Wollman# le: Digital Equipment EtherWorks 2 and EtherWorks 3 (DEPCA, DE100,
12076a8d6623SGarrett Wollman#     DE101, DE200, DE201, DE202, DE203, DE204, DE205, DE422)
12089a093170SDavid E. O'Brien# lnc: Lance/PCnet cards (Isolan, Novell NE2100, NE32-VL, AMD Am7990 & Am79C960)
120930cfb5b6SJoerg Wunsch# rdp: RealTek RTL 8002-based pocket ethernet adapters
1210d805b866SJohn Hay# sr: RISCom/N2 hdlc sync 1/2 port V.35/X.21 serial driver (requires sppp)
121198d46ad0SMike Smith# wl: Lucent Wavelan (ISA card only).
1212648c711bSPoul-Henning Kamp# ze: IBM/National Semiconductor PCMCIA ethernet controller.
1213648c711bSPoul-Henning Kamp# zp: 3Com PCMCIA Etherlink III (It does not require shared memory for
1214648c711bSPoul-Henning Kamp#     send/receive operation, but it needs 'iomem' to read/write the
1215648c711bSPoul-Henning Kamp#     attribute memory)
1216722012ccSJulian Elischer# oltr: Olicom ISA token-ring adapters OC-3115, OC-3117, OC-3118 and OC-3133
1217722012ccSJulian Elischer#       (no options needed)
12186a8d6623SGarrett Wollman#
121978e33712SBruce Evansdevice ar0 at isa? port 0x300 net irq 10 iomem 0xd0000
122078e33712SBruce Evansdevice cs0 at isa? port 0x300 net irq ?
122178e33712SBruce Evansdevice cx0 at isa? port 0x240 net irq 15 drq 7
122278e33712SBruce Evansdevice ed0 at isa? port 0x280 net irq 5 iomem 0xd8000
122378e33712SBruce Evansdevice el0 at isa? port 0x300 net irq 9
122478e33712SBruce Evansdevice ep0 at isa? port 0x300 net irq 10
122578e33712SBruce Evansdevice ex0 at isa? port? net irq?
122678e33712SBruce Evansdevice fe0 at isa? port 0x300 net irq ?
122778e33712SBruce Evansdevice ie0 at isa? port 0x300 net irq 5 iomem 0xd0000
122878e33712SBruce Evansdevice ie1 at isa? port 0x360 net irq 7 iomem 0xd0000
122978e33712SBruce Evansdevice le0 at isa? port 0x300 net irq 5 iomem 0xd0000
12309e22648bSDavid E. O'Briendevice lnc0 at isa? port 0x280 net irq 10 drq 0
123130cfb5b6SJoerg Wunschdevice rdp0 at isa? port 0x378 net irq 7 flags 2
123278e33712SBruce Evansdevice sr0 at isa? port 0x300 net irq 5 iomem 0xd0000
12333476cdb9SMike Smithoptions		WLCACHE		# enables the signal-strength cache
12343476cdb9SMike Smithoptions		WLDEBUG		# enables verbose debugging output
123578e33712SBruce Evansdevice wl0 at isa? port 0x300 net irq ?
1236346ebe51SEivind Eklund# We can (bogusly) include both the dedicated PCCARD drivers and the generic
1237346ebe51SEivind Eklund# support when COMPILING_LINT.
123878e33712SBruce Evansdevice ze0 at isa? port 0x300 net irq 5 iomem 0xd8000
123978e33712SBruce Evansdevice zp0 at isa? port 0x300 net irq 10 iomem 0xd8000
1240648c711bSPoul-Henning Kamp
1241722012ccSJulian Elischerdevice oltr0 at isa?
1242722012ccSJulian Elischer
124368713f97SKenjiro Cho#
124468713f97SKenjiro Cho# ATM related options
124568713f97SKenjiro Cho#
124668713f97SKenjiro Cho# The `en' device provides support for Efficient Networks (ENI)
124768713f97SKenjiro Cho# ENI-155 PCI midway cards, and the Adaptec 155Mbps PCI ATM cards (ANA-59x0).
124868713f97SKenjiro Cho#
12493cbceb82SKenjiro Cho# atm pseudo-device provides generic atm functions and is required for
125068713f97SKenjiro Cho# atm devices.
12513cbceb82SKenjiro Cho# NATM enables the netnatm protocol family that can be used to
125268713f97SKenjiro Cho# bypass TCP/IP.
125368713f97SKenjiro Cho#
125468713f97SKenjiro Cho# the current driver supports only PVC operations (no atm-arp, no multicast).
125568713f97SKenjiro Cho# for more details, please read the original documents at
125668713f97SKenjiro Cho# http://www.ccrc.wustl.edu/pub/chuck/bsdatm/wucs.html
125768713f97SKenjiro Cho#
125868713f97SKenjiro Chopseudo-device	atm
125968713f97SKenjiro Chodevice en0
126068713f97SKenjiro Chodevice en1
12613cbceb82SKenjiro Chooptions		NATM			#native ATM
1262f4567b9cSJulian Elischer
1263c19da41eSPeter Wemm#
1264c19da41eSPeter Wemm# Audio drivers: `snd', `sb', `pas', `gus', `pca'
1265c19da41eSPeter Wemm#
1266c19da41eSPeter Wemm# snd: Voxware sound support code
1267c19da41eSPeter Wemm# sb: SoundBlaster PCM - SoundBlaster, SB Pro, SB16, ProAudioSpectrum
1268c19da41eSPeter Wemm# sbxvi: SoundBlaster 16
1269c19da41eSPeter Wemm# sbmidi: SoundBlaster 16 MIDI interface
1270c19da41eSPeter Wemm# pas: ProAudioSpectrum PCM and MIDI
1271c19da41eSPeter Wemm# gus: Gravis Ultrasound - Ultrasound, Ultrasound 16, Ultrasound MAX
1272c19da41eSPeter Wemm# gusxvi: Gravis Ultrasound 16-bit PCM	(do not use)
1273c19da41eSPeter Wemm# mss: Microsoft Sound System
1274c19da41eSPeter Wemm# css: Crystal Sound System (CSS 423x PnP)
1275c19da41eSPeter Wemm# sscape: Ensoniq Soundscape MIDI interface
1276c19da41eSPeter Wemm# sscape_mss: Ensoniq Soundscape PCM (requires sscape)
1277c19da41eSPeter Wemm# opl: Yamaha OPL-2 and OPL-3 FM - SB, SB Pro, SB 16, ProAudioSpectrum
1278c19da41eSPeter Wemm# uart: stand-alone 6850 UART for MIDI
1279c19da41eSPeter Wemm# mpu: Roland MPU-401 stand-alone card
1280c19da41eSPeter Wemm#
1281c19da41eSPeter Wemm# Beware!  The addresses specified below are also hard-coded in
1282c19da41eSPeter Wemm# i386/isa/sound/sound_config.h.  If you change the values here, you
1283c19da41eSPeter Wemm# must also change the values in the include file.
1284c19da41eSPeter Wemm#
1285c7406082SJohn-Mark Gurney# pcm: PCM audio through various sound cards.
1286c7406082SJohn-Mark Gurney#
128768ec4eb6SLuigi Rizzo# This has support for a large number of new audio cards, based on
128868ec4eb6SLuigi Rizzo# CS423x, OPTi931, Yamaha OPL-SAx, and also for SB16, GusPnP.
128968ec4eb6SLuigi Rizzo# For more information about this driver and supported cards,
129068ec4eb6SLuigi Rizzo# see the pcm.4 man page and /sys/i386/isa/snd/CARDS.
1291c7406082SJohn-Mark Gurney#
1292c7406082SJohn-Mark Gurney# The flags of the device tells the device a bit more info about the
1293c7406082SJohn-Mark Gurney# device that normally is obtained through the PnP interface.
1294c7406082SJohn-Mark Gurney#	bit  2..0   secondary DMA channel;
1295c7406082SJohn-Mark Gurney#	bit  4      set if the board uses two dma channels;
1296c7406082SJohn-Mark Gurney#	bit 15..8   board type, overrides autodetection; leave it
1297c7406082SJohn-Mark Gurney#		    zero if don't know what to put in (and you don't,
1298c7406082SJohn-Mark Gurney#		    since this is unsupported at the moment...).
1299c7406082SJohn-Mark Gurney#
1300c19da41eSPeter Wemm# This driver will use the new PnP code if it's available.
1301c19da41eSPeter Wemm#
13026a8d6623SGarrett Wollman# pca: PCM audio through your PC speaker
13038b8cd792SJordan K. Hubbard#
1304c19da41eSPeter Wemm# If you have a GUS-MAX card and want to use the CS4231 codec on the
1305c19da41eSPeter Wemm# card the drqs for the gus max must be 8 bit (1, 2, or 3).
1306c19da41eSPeter Wemm#
1307c19da41eSPeter Wemm# If you would like to use the full duplex option on the gus, then define
1308c19da41eSPeter Wemm# flags to be the ``read dma channel''.
1309c19da41eSPeter Wemm#
1310c19da41eSPeter Wemm# options BROKEN_BUS_CLOCK	#PAS-16 isn't working and OPTI chipset
1311c19da41eSPeter Wemm# options SYMPHONY_PAS		#PAS-16 isn't working and SYMPHONY chipset
1312c19da41eSPeter Wemm# options EXCLUDE_SBPRO		#PAS-16
1313c19da41eSPeter Wemm# options SBC_IRQ=5		#PAS-16. Must match irq on sb0 line.
1314c19da41eSPeter Wemm# PAS16: The order of the pas0/sb0/opl0 is important since the
1315c19da41eSPeter Wemm#	sb emulation is enabled in the pas-16 attach.
1316c19da41eSPeter Wemm#
1317c19da41eSPeter Wemm# To overide the GUS defaults use:
1318c19da41eSPeter Wemm# options GUS_DMA2
1319c19da41eSPeter Wemm# options GUS_DMA
1320c19da41eSPeter Wemm# options GUS_IRQ
1321c19da41eSPeter Wemm#
1322c19da41eSPeter Wemm# The i386/isa/sound/sound.doc has more information.
1323c19da41eSPeter Wemm
1324c19da41eSPeter Wemm# Controls all "VOXWARE" driver sound devices.  See Luigi's driver
1325c19da41eSPeter Wemm# below for an alternate which may work better for some cards.
1326c19da41eSPeter Wemm#
1327c19da41eSPeter Wemmcontroller	snd0
1328c19da41eSPeter Wemmdevice pas0     at isa? port 0x388 irq 10 drq 6
1329c19da41eSPeter Wemmdevice sb0      at isa? port 0x220 irq 5 drq 1
1330c19da41eSPeter Wemmdevice sbxvi0   at isa? drq 5
1331c19da41eSPeter Wemmdevice sbmidi0  at isa? port 0x330
1332c19da41eSPeter Wemmdevice awe0     at isa? port 0x620
1333c19da41eSPeter Wemmdevice gus0 at isa? port 0x220 irq 12 drq 1
1334c19da41eSPeter Wemm#device gus0 at isa? port 0x220 irq 12 drq 1 flags 0x3
1335c19da41eSPeter Wemmdevice mss0 at isa? port 0x530 irq 10 drq 1
1336c19da41eSPeter Wemmdevice css0	at isa? port 0x534 irq 5 drq 1 flags 0x08
1337c19da41eSPeter Wemmdevice sscape0  at isa? port 0x330 irq 9 drq 0
1338c19da41eSPeter Wemmdevice trix0    at isa? port 0x330 irq 6 drq 0
1339c19da41eSPeter Wemmdevice sscape_mss0  at isa? port 0x534 irq 5 drq 1
1340c19da41eSPeter Wemmdevice opl0     at isa? port 0x388
1341c19da41eSPeter Wemmdevice mpu0     at isa? port 0x330 irq 6 drq 0
1342c19da41eSPeter Wemmdevice uart0 at isa? port 0x330 irq 5
1343c19da41eSPeter Wemm
1344c19da41eSPeter Wemm# Luigi's snd code (use INSTEAD of snd0 and all VOXWARE drivers!).
1345c19da41eSPeter Wemm# You may also wish to enable the pnp controller with this, for pnp
1346c19da41eSPeter Wemm# sound cards.
1347c19da41eSPeter Wemm#
1348c19da41eSPeter Wemm#device pcm0 at isa? port ? tty irq 10 drq 1 flags 0x0
1349c19da41eSPeter Wemm
13501a7c583cSGarrett Wollman# Not controlled by `snd'
13514a04f6f6SBruce Evansdevice pca0 at isa? port "IO_TIMER1" tty
13529ad380abSGarrett Wollman
13536a8d6623SGarrett Wollman#
1354567e21c2SBruce Evans# Miscellaneous hardware:
13556a8d6623SGarrett Wollman#
13566a8d6623SGarrett Wollman# mcd: Mitsumi CD-ROM
13572d859864SAndreas Schulz# scd: Sony CD-ROM
135805e1d9d4SJordan K. Hubbard# matcd: Matsushita/Panasonic CD-ROM
13596a8d6623SGarrett Wollman# wt: Wangtek and Archive QIC-02/QIC-36 tape drives
13606a8d6623SGarrett Wollman# ctx: Cortex-I frame grabber
13616a8d6623SGarrett Wollman# apm: Laptop Advanced Power Management (experimental)
13626c5e9bbdSMike Pritchard# spigot: The Creative Labs Video Spigot video-acquisition board
13631d86961eSJordan K. Hubbard# meteor: Matrox Meteor video capture board
13646773d00eSSøren Schmidt# bktr: Brooktree bt848/848a/849/878/879 family video capture and TV Tuner board
136565e8111fSBruce Evans# cy: Cyclades serial driver
1366a50cd483SJordan K. Hubbard# dgb: Digiboard PC/Xi and PC/Xe series driver (ALPHA QUALITY!)
1367c35bda94SBrian Somers# dgm: Digiboard PC/Xem driver
13681a7c583cSGarrett Wollman# gp:  National Instruments AT-GPIB and AT-GPIB/TNT board
1369a800f455SJulian Elischer# asc: GI1904-based hand scanners, e.g. the Trust Amiscan Grey
13701a7c583cSGarrett Wollman# gsc: Genius GS-4500 hand scanner.
13711a7c583cSGarrett Wollman# joy: joystick
1372657e73c4SPeter Dufault# labpc: National Instrument's Lab-PC and Lab-PC+
1373d0930614SAndrey A. Chernov# rc: RISCom/8 multiport card
13743b577e1fSJordan K. Hubbard# rp: Comtrol Rocketport(ISA) - single card
1375567e21c2SBruce Evans# tw: TW-523 power line interface for use with X-10 home control products
13760d04cf6aSPeter Wemm# si: Specialix SI/XIO 4-32 port terminal multiplexor
1377c9da1b81SPeter Wemm# stl: Stallion EasyIO and EasyConnection 8/32 (cd1400 based)
1378c9da1b81SPeter Wemm# stli: Stallion EasyConnection 8/64, ONboard, Brumby (intelligent)
1379657e73c4SPeter Dufault
1380e597b497SNate Williams# Notes on APM
13813d4d8fe9SPoul-Henning Kamp#  The flags takes the following meaning for apm0:
13823d4d8fe9SPoul-Henning Kamp#    0x0020  Statclock is broken.
13833d4d8fe9SPoul-Henning Kamp#    0x0011  Limit APM protocol to 1.1 or 1.0
13843d4d8fe9SPoul-Henning Kamp#    0x0010  Limit APM protocol to 1.0
138538ebe562SAdam David#  If apm is omitted, some systems require sysctl -w kern.timcounter.method=1
138638ebe562SAdam David#  for correct timekeeping.
138738ebe562SAdam David
13882cd01159SJordan K. Hubbard# Notes on the spigot:
13892cd01159SJordan K. Hubbard#  The video spigot is at 0xad6.  This port address can not be changed.
13902cd01159SJordan K. Hubbard#  The irq values may only be 10, 11, or 15
13912cd01159SJordan K. Hubbard#  I/O memory is an 8kb region.  Possible values are:
13922cd01159SJordan K. Hubbard#    0a0000, 0a2000, ..., 0fffff, f00000, f02000, ..., ffffff
1393d01b6680SJordan K. Hubbard#    The start address must be on an even boundary.
1394d01b6680SJordan K. Hubbard#  Add the following option if you want to allow non-root users to be able
1395d01b6680SJordan K. Hubbard#  to access the spigot.  This option is not secure because it allows users
1396d01b6680SJordan K. Hubbard#  direct access to the I/O page.
1397d01b6680SJordan K. Hubbard#  	options SPIGOT_UNSECURE
13988819d6ecSPoul-Henning Kamp
13993b577e1fSJordan K. Hubbard# Notes on the Comtrol Rocketport driver:
14003b577e1fSJordan K. Hubbard#
14013b577e1fSJordan K. Hubbard# The exact values used for rp0 depend on how many boards you have
14023b577e1fSJordan K. Hubbard# in the system.  The manufacturer's sample configs are listed as:
14033b577e1fSJordan K. Hubbard#
14043b577e1fSJordan K. Hubbard#   Comtrol Rocketport ISA single card
14053b577e1fSJordan K. Hubbard#               device  rp0     at isa? port 0x280 tty
14063b577e1fSJordan K. Hubbard#
14073b577e1fSJordan K. Hubbard#   If instead you have two ISA cards, one installed at 0x100 and the
14083b577e1fSJordan K. Hubbard#   second installed at 0x180, then you should add the following to
14093b577e1fSJordan K. Hubbard#   your kernel configuration file:
14103b577e1fSJordan K. Hubbard#
14113b577e1fSJordan K. Hubbard#               device  rp0     at isa? port 0x100 tty
14123b577e1fSJordan K. Hubbard#               device  rp1     at isa? port 0x180 tty
14133b577e1fSJordan K. Hubbard#
14143b577e1fSJordan K. Hubbard#   For 4 ISA cards, it might be something like this:
14153b577e1fSJordan K. Hubbard#
14163b577e1fSJordan K. Hubbard#               device  rp0     at isa? port 0x180 tty
14173b577e1fSJordan K. Hubbard#               device  rp1     at isa? port 0x100 tty
14183b577e1fSJordan K. Hubbard#               device  rp2     at isa? port 0x340 tty
14193b577e1fSJordan K. Hubbard#               device  rp3     at isa? port 0x240 tty
14203b577e1fSJordan K. Hubbard#
14213b577e1fSJordan K. Hubbard#   And for PCI cards, you only need say:
14223b577e1fSJordan K. Hubbard#
14233b577e1fSJordan K. Hubbard#               device rp0
14243b577e1fSJordan K. Hubbard#               device rp1
14253b577e1fSJordan K. Hubbard#               ...
14263b577e1fSJordan K. Hubbard#   Note: Make sure that any Rocketport PCI devices are specified BEFORE the
14273b577e1fSJordan K. Hubbard#   ISA Rocketport devices.
14283b577e1fSJordan K. Hubbard
1429a50cd483SJordan K. Hubbard# Notes on the Digiboard driver:
1430a50cd483SJordan K. Hubbard#
1431a50cd483SJordan K. Hubbard# The following flag values have special meanings:
1432c35bda94SBrian Somers#	0x01 - alternate layout of pins (dgb & dgm)
1433c35bda94SBrian Somers#	0x02 - use the windowed PC/Xe in 64K mode (dgb only)
14340d04cf6aSPeter Wemm
14350d04cf6aSPeter Wemm# Notes on the Specialix SI/XIO driver:
1436c4823710SPeter Wemm#  **This is NOT a Specialix supported Driver!**
1437c4823710SPeter Wemm#  The host card is memory, not IO mapped.
1438c4823710SPeter Wemm#  The Rev 1 host cards use a 64K chunk, on a 32K boundary.
1439c4823710SPeter Wemm#  The Rev 2 host cards use a 32K chunk, on a 32K boundary.
1440c4823710SPeter Wemm#  The cards can use an IRQ of 11, 12 or 15.
1441c4823710SPeter Wemm
1442c9da1b81SPeter Wemm# Notes on the Stallion stl and stli drivers:
1443c9da1b81SPeter Wemm#  See src/i386/isa/README.stl for complete instructions.
1444c9da1b81SPeter Wemm#  This is version 0.0.5alpha, unsupported by Stallion.
1445c9da1b81SPeter Wemm#  The stl driver has a secondary IO port hard coded at 0x280.  You need
1446c9da1b81SPeter Wemm#     to change src/i386/isa/stallion.c if you reconfigure this on the boards.
1447c9da1b81SPeter Wemm#  The "flags" and "iosiz" settings on the stli driver depend on the board:
1448c9da1b81SPeter Wemm#	EasyConnection 8/64 ISA:     flags 23         iosiz 0x1000
1449c9da1b81SPeter Wemm#	EasyConnection 8/64 EISA:    flags 24         iosiz 0x10000
1450c9da1b81SPeter Wemm#	EasyConnection 8/64 MCA:     flags 25         iosiz 0x1000
1451c9da1b81SPeter Wemm#	ONboard ISA:                 flags 4          iosiz 0x10000
1452c9da1b81SPeter Wemm#	ONboard EISA:                flags 7          iosiz 0x10000
1453c9da1b81SPeter Wemm#	ONboard MCA:                 flags 3          iosiz 0x10000
1454c9da1b81SPeter Wemm#	Brumby:                      flags 2          iosiz 0x4000
1455c9da1b81SPeter Wemm#	Stallion:                    flags 1          iosiz 0x10000
1456c9da1b81SPeter Wemm
145778e33712SBruce Evansdevice		mcd0	at isa? port 0x300 bio irq 10
145805e1d9d4SJordan K. Hubbard# for the Sony CDU31/33A CDROM
14592d859864SAndreas Schulzdevice		scd0	at isa? port 0x230 bio
14606c5e9bbdSMike Pritchard# for the SoundBlaster 16 multicd - up to 4 devices
14619720b084SJordan K. Hubbardcontroller      matcd0  at isa? port 0x230 bio
146278e33712SBruce Evansdevice		wt0	at isa? port 0x300 bio irq 5 drq 1
14636a8d6623SGarrett Wollmandevice		ctx0	at isa? port 0x230 iomem 0xd0000
146478e33712SBruce Evansdevice		spigot0 at isa? port 0xad6 irq 15 iomem 0xee000
14656a8d6623SGarrett Wollmandevice		apm0	at isa?
14661a7c583cSGarrett Wollmandevice		gp0	at isa? port 0x2c0 tty
14671a7c583cSGarrett Wollmandevice		gsc0	at isa? port "IO_GSC1" tty drq 3
14684a04f6f6SBruce Evansdevice		joy0	at isa? port IO_GAME
146978e33712SBruce Evansdevice		cy0	at isa? tty irq 10 iomem 0xd4000 iosiz 0x2000
1470b8cf6ea7SBruce Evansoptions		CY_PCI_FASTINTR		# Use with cy_pci unless irq is shared
1471a360b6bdSBrian Somersdevice		dgb0	at isa? port 0x220 iomem 0xfc000 iosiz ? tty
1472aae5936eSJoerg Wunschoptions		"NDGBPORTS=16"		# Defaults to 16*NDGB
1473a360b6bdSBrian Somersdevice		dgm0	at isa? port 0x104 iomem 0xd0000 iosiz ? tty
147478e33712SBruce Evansdevice		labpc0	at isa? port 0x260 tty irq 5
147578e33712SBruce Evansdevice          rc0     at isa? port 0x220 tty irq 12
14763b577e1fSJordan K. Hubbarddevice          rp0     at isa? port 0x280 tty
1477567e21c2SBruce Evans# the port and irq for tw0 are fictitious
147878e33712SBruce Evansdevice          tw0     at isa? port 0x380 tty irq 11
1479c0a3aab8SPeter Wemmdevice		si0	at isa? iomem 0xd0000 tty irq 12
14804a04f6f6SBruce Evansdevice		asc0	at isa? port "IO_ASC1" tty drq 3 irq 10
148178e33712SBruce Evansdevice		stl0	at isa? port 0x2a0 tty irq 10
1482c9da1b81SPeter Wemmdevice		stli0	at isa? port 0x2a0 tty iomem 0xcc000 flags 23 iosiz 0x1000
14835db3b831SPoul-Henning Kamp# You are unlikely to have the hardware for loran0 <phk@FreeBSD.org>
148478e33712SBruce Evansdevice		loran0	at isa? port ? tty irq 5
14855db3b831SPoul-Henning Kamp# HOT1 Xilinx 6200 card (www.vcc.com)
14865db3b831SPoul-Henning Kampdevice		xrpu0
1487a800f455SJulian Elischer
1488eeb706c0SJustin T. Gibbs#
1489eeb706c0SJustin T. Gibbs# EISA devices:
1490eeb706c0SJustin T. Gibbs#
1491eeb706c0SJustin T. Gibbs# The EISA bus device is eisa0.  It provides auto-detection and
1492eeb706c0SJustin T. Gibbs# configuration support for all devices on the EISA bus.
1493eeb706c0SJustin T. Gibbs#
1494e56e7036SJustin T. Gibbs# The `ahb' device provides support for the Adaptec 174X adapter.
1495e56e7036SJustin T. Gibbs#
1496eeb706c0SJustin T. Gibbs# The `ahc' device provides support for the Adaptec 274X and 284X
1497eeb706c0SJustin T. Gibbs# adapters.  The 284X, although a VLB card responds to EISA probes.
1498eeb706c0SJustin T. Gibbs#
1499c37ddbb8SJoerg Wunsch# fea: DEC DEFEA EISA FDDI adapter
1500c37ddbb8SJoerg Wunsch#
1501eeb706c0SJustin T. Gibbscontroller	eisa0
1502e56e7036SJustin T. Gibbscontroller	ahb0
1503eeb706c0SJustin T. Gibbscontroller	ahc0
1504c37ddbb8SJoerg Wunschdevice		fea0
15056a8d6623SGarrett Wollman
15066fb5e0faSJustin T. Gibbs# The aic7xxx driver will attempt to use memory mapped I/O for all PCI
150711b5ea72SJustin T. Gibbs# controllers that have it configured only if this option is set. Unfortunately,
150811b5ea72SJustin T. Gibbs# this doesn't work on some motherboards, which prevents it from being the
150911b5ea72SJustin T. Gibbs# default.
151011b5ea72SJustin T. Gibbsoptions AHC_ALLOW_MEMIO
15116e702c99SPaul Traina
15121b0d3143SJoerg Wunsch# By default, only 10 EISA slots are probed, since the slot numbers
15131b0d3143SJoerg Wunsch# above clash with the configuration address space of the PCI subsystem,
15141b0d3143SJoerg Wunsch# and the EISA probe is not very smart about this.  This is sufficient
15151b0d3143SJoerg Wunsch# for most machines, but in particular the HP NetServer LC series comes
15161b0d3143SJoerg Wunsch# with an onboard AIC7770 dual-channel SCSI controller on EISA slot #11,
15171b0d3143SJoerg Wunsch# thus you need to bump this figure to 12 for them.
15181b0d3143SJoerg Wunschoptions	"EISA_SLOTS=12"
15191b0d3143SJoerg Wunsch
15206a8d6623SGarrett Wollman#
152116e164e3SBruce Evans# PCI devices & PCI options:
15226a8d6623SGarrett Wollman#
15236a8d6623SGarrett Wollman# The main PCI bus device is `pci'.  It provides auto-detection and
15246a8d6623SGarrett Wollman# configuration support for all devices on the PCI bus, using either
15256a8d6623SGarrett Wollman# configuration mode defined in the PCI specification.
15266a8d6623SGarrett Wollman#
1527eeb706c0SJustin T. Gibbs# The `ahc' device provides support for the Adaptec 29/3940(U)(W)
1528eeb706c0SJustin T. Gibbs# and motherboard based AIC7870/AIC7880 adapters.
1529eeb706c0SJustin T. Gibbs#
15306a8d6623SGarrett Wollman# The `ncr' device provides support for the NCR 53C810 and 53C825
15316a8d6623SGarrett Wollman# self-contained SCSI host adapters.
15326a8d6623SGarrett Wollman#
15338bafc245SMatt Jacob# The `isp' device provides support for the Qlogic ISP 1020, 1040
15348bafc245SMatt Jacob# nd 1040B PCI SCSI host adapters, as well as the Qlogic ISP 2100
15358bafc245SMatt Jacob# FC/AL Host Adapter.
15368bafc245SMatt Jacob#
153731188d61SBill Paul# The `ax' device provides support for PCI fast ethernet adapters
153831188d61SBill Paul# based on the ASIX Electronics AX88140A chip, including the Alfa
153931188d61SBill Paul# Inc. GFC2204.
154031188d61SBill Paul#
15416a8d6623SGarrett Wollman# The `de' device provides support for the Digital Equipment DC21040
15426a8d6623SGarrett Wollman# self-contained Ethernet adapter.
15436a8d6623SGarrett Wollman#
154456086e0dSSatoshi Asami# The `fxp' device provides support for the Intel EtherExpress Pro/100B
154556086e0dSSatoshi Asami# PCI Fast Ethernet adapters.
154656086e0dSSatoshi Asami#
1547726ff6a1SBill Paul# The `mx' device provides support for various fast ethernet adapters
1548726ff6a1SBill Paul# based on the Macronix 98713, 987615 ans 98725 series chips.
1549726ff6a1SBill Paul#
1550726ff6a1SBill Paul# The `pn' device provides support for various fast ethernet adapters
1551726ff6a1SBill Paul# based on the Lite-On 82c168 and 82c169 PNIC chips, including the
1552726ff6a1SBill Paul# LinkSys LNE100TX, the NetGear FA310TX rev. D1 and the Matrox
1553726ff6a1SBill Paul# FastNIC 10/100.
1554726ff6a1SBill Paul#
1555589e38a6SBill Paul# The 'rl' device provides support for PCI fast ethernet adapters based
1556589e38a6SBill Paul# on the RealTek 8129/8139 chipset. Note that the RealTek driver defaults
1557589e38a6SBill Paul# to useing programmed I/O to do register accesses because memory mapped
1558726ff6a1SBill Paul# mode seems to cause severe lockups on SMP hardware. This driver also
1559726ff6a1SBill Paul# supports the Accton EN1207D `Cheetah' adapter, which uses a chip called
1560726ff6a1SBill Paul# the MPX 5030/5038, which is either a RealTek in disguise or a RealTek
1561726ff6a1SBill Paul# workalike.
1562589e38a6SBill Paul#
1563d02c2331SBill Paul# The 'ti' device provides support for PCI gigabit ethernet NICs based
1564d02c2331SBill Paul# on the Alteon Networks Tigon 1 and Tigon 2 chipsets. This includes the
1565d02c2331SBill Paul# Alteon AceNIC, the 3Com 3c985, the Netgear GA620 and various others.
1566d02c2331SBill Paul# Note that you will probably want to bump up NBMCLUSTERS a lot to use
1567d02c2331SBill Paul# this driver.
1568d02c2331SBill Paul#
1569e21faf3eSBill Paul# The 'tl' device provides support for the Texas Instruments TNETE100
1570e21faf3eSBill Paul# series 'ThunderLAN' cards and integrated ethernet controllers. This
1571e21faf3eSBill Paul# includes several Compaq Netelligent 10/100 cards and the built-in
1572e21faf3eSBill Paul# ethernet controllers in several Compaq Prosignia, Proliant and
1573e30938ceSBill Paul# Deskpro systems. It also supports several Olicom 10Mbps and 10/100
1574e30938ceSBill Paul# boards.
1575e21faf3eSBill Paul#
1576ec4f65d2SJordan K. Hubbard# The `tx' device provides support for the SMC 9432TX cards.
1577ec4f65d2SJordan K. Hubbard#
1578726ff6a1SBill Paul# The `vr' device provides support for various fast ethernet adapters
1579726ff6a1SBill Paul# based on the VIA Technologies VT3043 `Rhine I' and VT86C100A `Rhine II'
1580726ff6a1SBill Paul# chips, including the D-Link DFE530TX.
1581726ff6a1SBill Paul#
15825ccfdea2SAndreas Schulz# The `vx' device provides support for the 3Com 3C590 and 3C595
1583f4567b9cSJulian Elischer# early support
1584f4567b9cSJulian Elischer#
1585726ff6a1SBill Paul# The `wb' device provides support for various fast ethernet adapters
1586726ff6a1SBill Paul# based on the Winbond W89C840F chip. Note: this is not the same as
1587726ff6a1SBill Paul# the Winbond W89C940F, which is an NE2000 clone.
1588726ff6a1SBill Paul#
1589726ff6a1SBill Paul# The `xl' device provides support for the 3Com 3c900, 3c905 and
1590e30938ceSBill Paul# 3c905B (Fast) Etherlink XL cards and integrated controllers. This
1591e30938ceSBill Paul# includes the integrated 3c905B-TX chips in certain Dell Optiplex and
1592e30938ceSBill Paul# Dell Precision desktop machines and the integrated 3c905-TX chips
1593e30938ceSBill Paul# in Dell Latitude laptop docking stations.
1594e30938ceSBill Paul#
1595d41f24e7SDavid Greenman# The `fpa' device provides support for the Digital DEFPA PCI FDDI
1596d41f24e7SDavid Greenman# adapter. pseudo-device fddi is also needed.
1597d41f24e7SDavid Greenman#
1598bba9a7a0SGarrett Wollman# The `meteor' device is a PCI video capture board. It can also have the
15991d86961eSJordan K. Hubbard# following options:
1600b1529bdaSPeter Wemm#   options METEOR_ALLOC_PAGES=xxx	preallocate kernel pages for data entry
16011d86961eSJordan K. Hubbard#	figure (ROWS*COLUMN*BYTES_PER_PIXEL*FRAME+PAGE_SIZE-1)/PAGE_SIZE
16021d86961eSJordan K. Hubbard#   options METEOR_DEALLOC_PAGES	remove all allocated pages on close(2)
1603b1529bdaSPeter Wemm#   options METEOR_DEALLOC_ABOVE=xxx	remove all allocated pages above the
16041d86961eSJordan K. Hubbard#	specified amount. If this value is below the allocated amount no action
16051d86961eSJordan K. Hubbard#	taken
16064f5f3f07SBrian Somers#   options METEOR_SYSTEM_DEFAULT={METEOR_PAL|METEOR_NTSC|METEOR_SECAM}, used
1607734d08a2SJordan K. Hubbard#	for initialization of fps routine when a signal is not present.
16081d86961eSJordan K. Hubbard#
1609a9c5b8d0SSøren Schmidt# The 'bktr' device is a PCI video capture device using the Brooktree
1610a9c5b8d0SSøren Schmidt# bt848/bt848a/bt849/bt878/bt879 chipset. When used with a TV Tuner it forms a
1611a9c5b8d0SSøren Schmidt# TV card, eg Miro PC/TV,Hauppauge WinCast/TV WinTV, VideoLogic Captivator,
1612a9c5b8d0SSøren Schmidt# Intel Smart Video III, AverMedia, IMS Turbo.
1613a9c5b8d0SSøren Schmidt# The following options can be used to override the auto detection
1614a9c5b8d0SSøren Schmidt#   options OVERRIDE_CARD=xxx
1615a9c5b8d0SSøren Schmidt#   options OVERRIDE_TUNER=xxx
1616a9c5b8d0SSøren Schmidt#   options OVERRIDE_MSP=1
1617a9c5b8d0SSøren Schmidt#   options OVERRIDE_DBX=1
16189ff07e32SAmancio Hasty# The current values are found in /usr/src/sys/pci/brooktree848.c
16199ff07e32SAmancio Hasty#
16204f5f3f07SBrian Somers#   options BROOKTREE_SYSTEM_DEFAULT=BROOKTREE_PAL
1621a9c5b8d0SSøren Schmidt# This is required for Dual Crystal (28&35Mhz) boards where PAL is used
1622a9c5b8d0SSøren Schmidt# to prevent hangs during initialisation.  eg VideoLogic Captivator PCI.
1623a9c5b8d0SSøren Schmidt#
1624a9c5b8d0SSøren Schmidt# PAL or SECAM users who have a 28Mhz crystal (and no 35Mhz crystal)
1625a9c5b8d0SSøren Schmidt# must enable PLL mode with this option. eg some new Hauppauge cards.
16264f5f3f07SBrian Somers#   options BKTR_USE_PLL
1627a9c5b8d0SSøren Schmidt#
1628a9c5b8d0SSøren Schmidt# Using sysctl(8) run-time overrides on a per-card basis can be made
16295719a93cSJohn-Mark Gurney#
1630722012ccSJulian Elischer# The "oltr" driver supports the following Olicom PCI token-ring adapters
1631722012ccSJulian Elischer# OC-3136, OC-3137, OC-3139, OC-3140, OC-3141, OC-3540, OC-3250
1632722012ccSJulian Elischer#
16336a8d6623SGarrett Wollmancontroller	pci0
1634eeb706c0SJustin T. Gibbscontroller	ahc1
163511bfa65aSBruce Evanscontroller	ncr0
16368bafc245SMatt Jacobcontroller	isp0
1637017b0edcSMatt Jacob#
1638017b0edcSMatt Jacob# Options for ISP
1639017b0edcSMatt Jacob#
1640017b0edcSMatt Jacob#	SCSI_ISP_NO_FWLOAD_MASK	- mask of isp unit numbers (obviously
1641017b0edcSMatt Jacob#				  a max of 32) that you wish to disable
1642017b0edcSMatt Jacob#				  to disable the loading of firmware on.
1643017b0edcSMatt Jacob#	SCSI_ISP_NO_NVRAM_MASK	- mask of isp unit numbers (obviously
1644017b0edcSMatt Jacob#				  a max of 32) that you wish to disable
1645017b0edcSMatt Jacob#				  them picking up information from NVRAM
1646017b0edcSMatt Jacob#				  (for broken cards you can't fix the NVRAM
1647017b0edcSMatt Jacob#				  on- very rare, or for systems you can't
1648017b0edcSMatt Jacob#				  change NVRAM on (e.g. alpha) and you don't
1649017b0edcSMatt Jacob#				  like what's in there)
1650017b0edcSMatt Jacob#	SCSI_ISP_PREFER_MEM_MAP	- control preference for using memory mappings
1651017b0edcSMatt Jacob#				  instead of I/O space mappings. It defaults
1652017b0edcSMatt Jacob#				  to 1 for i386, 0 for alpha. Set to 1 to
1653017b0edcSMatt Jacob#				  unconditionally prefer mapping memory,
1654017b0edcSMatt Jacob#				  else it will use I/O space mappings. Of
1655017b0edcSMatt Jacob#				  course, this can fail if the PCI implement-
1656017b0edcSMatt Jacob#				  ation doesn't support what you want.
16571afb37efSMatt Jacob#
16581afb37efSMatt Jacob#	SCSI_ISP_FABRIC		  enable loading of Fabric f/w flavor (2100).
16591afb37efSMatt Jacob#	SCSI_ISP_SCCLUN		  enable loading of expanded lun f/w (2100).
16601afb37efSMatt Jacob#
16611afb37efSMatt Jacob#	ISP_DISABLE_1020_SUPPORT	Disable support for 1020/1040 cards
16621afb37efSMatt Jacob#	ISP_DISABLE_1080_SUPPORT	Disable support for 1080/1240 cards
16631afb37efSMatt Jacob#	ISP_DISABLE_2100_SUPPORT	Disable support for 2100 cards
16641afb37efSMatt Jacob#	(these really just to save code space)
16651afb37efSMatt Jacob#	(use of all three will cause the driver to not compile)
1666017b0edcSMatt Jacoboptions	SCSI_ISP_NO_FWLOAD_MASK="0x12"	# disable FW load for isp1 and isp4
1667017b0edcSMatt Jacoboptions SCSI_ISP_NO_NVRAM_MASK="0x1"	# disable NVRAM for isp0
1668017b0edcSMatt Jacoboptions SCSI_ISP_PREFER_MEM_MAP="0"	# prefer I/O mapping
1669f4694a87SDmitrij Tejblum#options	"ISP_DISABLE_1020_SUPPORT"
1670f4694a87SDmitrij Tejblum#options	"ISP_DISABLE_1080_SUPPORT"
1671f4694a87SDmitrij Tejblum#options	"ISP_DISABLE_2100_SUPPORT"
1672017b0edcSMatt Jacob
167331188d61SBill Pauldevice		ax0
16746a8d6623SGarrett Wollmandevice		de0
167517acc2b2SDavid Greenmandevice		fxp0
1676726ff6a1SBill Pauldevice		mx0
1677726ff6a1SBill Pauldevice		pn0
1678589e38a6SBill Pauldevice		rl0
1679d02c2331SBill Pauldevice		ti0
1680e21faf3eSBill Pauldevice		tl0
1681ec4f65d2SJordan K. Hubbarddevice		tx0
1682726ff6a1SBill Pauldevice		vr0
16835ccfdea2SAndreas Schulzdevice		vx0
1684726ff6a1SBill Pauldevice		wb0
168516e164e3SBruce Evansdevice		xl0
1686d41f24e7SDavid Greenmandevice		fpa0
16871d86961eSJordan K. Hubbarddevice		meteor0
1688722012ccSJulian Elischerdevice		oltr0
168928ebb692SNicolas Souchu
169028ebb692SNicolas Souchu# Brooktree driver has been ported to the new I2C framework. Thus,
169128ebb692SNicolas Souchu# you'll need at least iicbus, iicbb and smbus. iic/smb are only needed if you
169228ebb692SNicolas Souchu# want to control other I2C slaves connected to the external connector of
169328ebb692SNicolas Souchu# some cards.
169428ebb692SNicolas Souchu#
16955719a93cSJohn-Mark Gurneydevice		bktr0
1696446cee6eSJoerg Wunsch
1697dc9deb29SPoul-Henning Kamp#
169816e164e3SBruce Evans# PCI options
1699e261d589SJohn-Mark Gurney#
1700e261d589SJohn-Mark Gurney#options	PCI_QUIET	#quiets PCI code on chipset settings
1701e261d589SJohn-Mark Gurney
1702e261d589SJohn-Mark Gurney#
1703dc9deb29SPoul-Henning Kamp# PCCARD/PCMCIA
1704dc9deb29SPoul-Henning Kamp#
1705e7e437dbSNate Williams# card: slot controller
170613cbd355SNate Williams# pcic: slots
1707e7e437dbSNate Williamscontroller	card0
170894316d1dSWolfgang Helbigdevice		pcic0 at card?
170994316d1dSWolfgang Helbigdevice		pcic1 at card?
1710dc9deb29SPoul-Henning Kamp
17118aa25588SBrian Somers# You may need to reset all pccards after resuming
17128aa25588SBrian Somersoptions		PCIC_RESUME_RESET	# reset after resume
17138aa25588SBrian Somers
1714446cee6eSJoerg Wunsch#
1715446cee6eSJoerg Wunsch# Laptop/Notebook options:
1716446cee6eSJoerg Wunsch#
1717446cee6eSJoerg Wunsch# See also:
17186c5e9bbdSMike Pritchard#  apm under `Miscellaneous hardware'
1719446cee6eSJoerg Wunsch# above.
1720446cee6eSJoerg Wunsch
1721446cee6eSJoerg Wunsch# For older notebooks that signal a powerfail condition (external
1722446cee6eSJoerg Wunsch# power supply dropped, or battery state low) by issuing an NMI:
1723446cee6eSJoerg Wunsch
1724446cee6eSJoerg Wunschoptions		POWERFAIL_NMI	# make it beep instead of panicing
172565e8111fSBruce Evans
1726ab4c624bSMike Smith#
17278afa373cSNicolas Souchu# SMB bus
17288afa373cSNicolas Souchu#
17298afa373cSNicolas Souchu# System Management Bus support provided by the 'smbus' device.
17308afa373cSNicolas Souchu#
17318afa373cSNicolas Souchu# Supported devices:
17328afa373cSNicolas Souchu# smb	standard io
17338afa373cSNicolas Souchu#
17348afa373cSNicolas Souchu# Supported interfaces:
173528ebb692SNicolas Souchu# iicsmb I2C to SMB bridge with any iicbus interface
173628ebb692SNicolas Souchu# bktr	brooktree848 I2C hardware interface
173704fb1490SNicolas Souchu# intpm	Intel PIIX4 Power Management Unit
1738c5ea635cSNicolas Souchu# alpm	Acer Aladdin-IV/V/Pro2 Power Management Unit
17398afa373cSNicolas Souchu#
17408afa373cSNicolas Souchucontroller smbus0
174104fb1490SNicolas Souchucontroller intpm0
1742c5ea635cSNicolas Souchucontroller alpm0
17438afa373cSNicolas Souchu
17448afa373cSNicolas Souchudevice smb0	at smbus?
17458afa373cSNicolas Souchu
17468afa373cSNicolas Souchu#
17478afa373cSNicolas Souchu# I2C Bus
17488afa373cSNicolas Souchu#
17498afa373cSNicolas Souchu# Philips i2c bus support is provided by the `iicbus' device.
17508afa373cSNicolas Souchu#
17518afa373cSNicolas Souchu# Supported devices:
17528afa373cSNicolas Souchu# ic	i2c network interface
17538afa373cSNicolas Souchu# iic	i2c standard io
1754f7d09fbaSNicolas Souchu# iicsmb i2c to smb bridge. Allow i2c i/o with smb commands.
17558afa373cSNicolas Souchu#
17568afa373cSNicolas Souchu# Supported interfaces:
17578afa373cSNicolas Souchu# pcf	Philips PCF8584 ISA-bus controller
175828ebb692SNicolas Souchu# bktr	brooktree848 I2C software interface
175928ebb692SNicolas Souchu#
176028ebb692SNicolas Souchu# Other:
176128ebb692SNicolas Souchu# iicbb	generic I2C bit-banging code (needed by lpbb, bktr)
17628afa373cSNicolas Souchu#
17638afa373cSNicolas Souchucontroller iicbus0
176428ebb692SNicolas Souchucontroller iicbb0
17658afa373cSNicolas Souchu
17668afa373cSNicolas Souchudevice ic0	at iicbus?
17678afa373cSNicolas Souchudevice iic0	at iicbus?
17688afa373cSNicolas Souchudevice iicsmb0	at iicbus?
17698afa373cSNicolas Souchu
177078e33712SBruce Evanscontroller pcf0	at isa? port 0x320 net irq 5
17718afa373cSNicolas Souchu
177219c74962SPoul-Henning Kamp# ISDN4BSD section
177319c74962SPoul-Henning Kamp
177419c74962SPoul-Henning Kamp# i4b passive ISDN cards support (isic - I4b Siemens Isdn Chipset driver)
177519c74962SPoul-Henning Kamp# note that the ``options'' and ``device'' lines must BOTH be defined !
17768afa373cSNicolas Souchu#
177719c74962SPoul-Henning Kamp# Non-PnP Cards:
177819c74962SPoul-Henning Kamp# --------------
177919c74962SPoul-Henning Kamp#
178019c74962SPoul-Henning Kamp# Teles S0/8 or Niccy 1008
178119c74962SPoul-Henning Kampoptions "TEL_S0_8"
17824dfe8ba8SPoul-Henning Kamp#device	isic0 at isa? iomem 0xd0000 net irq 5 flags 1
178319c74962SPoul-Henning Kamp#
178419c74962SPoul-Henning Kamp# Teles S0/16 or Creatix ISDN-S0 or Niccy 1016
178519c74962SPoul-Henning Kampoptions "TEL_S0_16"
17864dfe8ba8SPoul-Henning Kamp#device	isic0 at isa? port 0xd80 iomem 0xd0000 net irq 5 flags 2
178719c74962SPoul-Henning Kamp#
178819c74962SPoul-Henning Kamp# Teles S0/16.3
178919c74962SPoul-Henning Kampoptions "TEL_S0_16_3"
17904dfe8ba8SPoul-Henning Kamp#device	isic0 at isa? port 0xd80 net irq 5 flags 3
179119c74962SPoul-Henning Kamp#
179219c74962SPoul-Henning Kamp# AVM A1 or AVM Fritz!Card
179319c74962SPoul-Henning Kampoptions "AVM_A1"
17944dfe8ba8SPoul-Henning Kamp#device	isic0 at isa? port 0x340 net irq 5 flags 4
179519c74962SPoul-Henning Kamp#
179619c74962SPoul-Henning Kamp# USRobotics Sportster ISDN TA intern
179719c74962SPoul-Henning Kampoptions "USR_STI"
17984dfe8ba8SPoul-Henning Kamp#device isic0 at isa? port 0x268 net irq 5 flags 7
179919c74962SPoul-Henning Kamp#
180019c74962SPoul-Henning Kamp# ITK ix1 Micro
180119c74962SPoul-Henning Kampoptions "ITKIX1"
18024dfe8ba8SPoul-Henning Kamp#device isic0 at isa? port 0x398 net irq 10 flags 18
180319c74962SPoul-Henning Kamp#
180419c74962SPoul-Henning Kamp# PnP-Cards:
180519c74962SPoul-Henning Kamp# ----------
180619c74962SPoul-Henning Kamp#
180719c74962SPoul-Henning Kamp# Teles S0/16.3 PnP
180819c74962SPoul-Henning Kampoptions "TEL_S0_16_3_P"
18094dfe8ba8SPoul-Henning Kamp#device	isic0 at isa? port ? net irq ?
181019c74962SPoul-Henning Kamp#
181119c74962SPoul-Henning Kamp# Creatix ISDN-S0 P&P
181219c74962SPoul-Henning Kampoptions "CRTX_S0_P"
18134dfe8ba8SPoul-Henning Kamp#device	isic0 at isa? port ? net irq ?
181419c74962SPoul-Henning Kamp#
181519c74962SPoul-Henning Kamp# Dr. Neuhaus Niccy Go@
181619c74962SPoul-Henning Kampoptions "DRN_NGO"
18174dfe8ba8SPoul-Henning Kamp#device	isic0 at isa? port ? net irq ?
181819c74962SPoul-Henning Kamp#
181919c74962SPoul-Henning Kamp# Sedlbauer Win Speed
182019c74962SPoul-Henning Kampoptions "SEDLBAUER"
18214dfe8ba8SPoul-Henning Kamp#device	isic0 at isa? port ? net irq ?
182219c74962SPoul-Henning Kamp#
182319c74962SPoul-Henning Kamp# Dynalink IS64PH
182419c74962SPoul-Henning Kampoptions "DYNALINK"
18254dfe8ba8SPoul-Henning Kamp#device	isic0 at isa? port ? net irq ?
182619c74962SPoul-Henning Kamp#
182719c74962SPoul-Henning Kamp# ELSA QuickStep 1000pro ISA
182819c74962SPoul-Henning Kampoptions "ELSA_QS1ISA"
18294dfe8ba8SPoul-Henning Kamp#device	isic0 at isa? port ? net irq ?
183019c74962SPoul-Henning Kamp#
183119c74962SPoul-Henning Kamp# PCI-Cards:
183219c74962SPoul-Henning Kamp# ----------
183319c74962SPoul-Henning Kamp#
183419c74962SPoul-Henning Kamp# ELSA QuickStep 1000pro PCI
183519c74962SPoul-Henning Kampoptions "ELSA_QS1PCI"
183619c74962SPoul-Henning Kamp#device  isic0
183719c74962SPoul-Henning Kamp#
183819c74962SPoul-Henning Kamp# PCMCIA-Cards:
183919c74962SPoul-Henning Kamp# -------------
184019c74962SPoul-Henning Kamp#
184119c74962SPoul-Henning Kamp# AVM PCMCIA Fritz!Card
184219c74962SPoul-Henning Kampoptions "AVM_A1_PCMCIA"
18434dfe8ba8SPoul-Henning Kampdevice	isic0 at isa? port 0x340 net irq 5 flags 10
184419c74962SPoul-Henning Kamp#
184519c74962SPoul-Henning Kamp# Active Cards:
184619c74962SPoul-Henning Kamp# -------------
184719c74962SPoul-Henning Kamp#
184819c74962SPoul-Henning Kamp# Stollmann Tina-dd control device
18494dfe8ba8SPoul-Henning Kampdevice tina0 at isa? port 0x260 net irq 10
185019c74962SPoul-Henning Kamp#
185119c74962SPoul-Henning Kamp# ISDN Protocol Stack
185219c74962SPoul-Henning Kamp# -------------------
185319c74962SPoul-Henning Kamp#
185419c74962SPoul-Henning Kamp# Q.921 / layer 2 - i4b passive cards D channel handling
185519c74962SPoul-Henning Kamppseudo-device	"i4bq921"
185619c74962SPoul-Henning Kamp#
185719c74962SPoul-Henning Kamp# Q.931 / layer 3 - i4b passive cards D channel handling
185819c74962SPoul-Henning Kamppseudo-device	"i4bq931"
185919c74962SPoul-Henning Kamp#
186019c74962SPoul-Henning Kamp# layer 4 - i4b common passive and active card handling
186119c74962SPoul-Henning Kamppseudo-device	"i4b"
186219c74962SPoul-Henning Kamp#
186319c74962SPoul-Henning Kamp# ISDN devices
186419c74962SPoul-Henning Kamp# ------------
186519c74962SPoul-Henning Kamp#
186619c74962SPoul-Henning Kamp# userland driver to do ISDN tracing (for passive cards only)
186719c74962SPoul-Henning Kamppseudo-device   "i4btrc"	4
186819c74962SPoul-Henning Kamp#
186919c74962SPoul-Henning Kamp# userland driver to control the whole thing
187019c74962SPoul-Henning Kamppseudo-device   "i4bctl"
187119c74962SPoul-Henning Kamp#
187219c74962SPoul-Henning Kamp# userland driver for access to raw B channel
187319c74962SPoul-Henning Kamppseudo-device   "i4brbch"       4
187419c74962SPoul-Henning Kamp#
187519c74962SPoul-Henning Kamp# userland driver for telephony
187619c74962SPoul-Henning Kamppseudo-device   "i4btel"        2
187719c74962SPoul-Henning Kamp#
187819c74962SPoul-Henning Kamp# network driver for IP over raw HDLC ISDN
187919c74962SPoul-Henning Kamppseudo-device   "i4bipr"	4
188019c74962SPoul-Henning Kamp# enable VJ header compression detection for ipr i/f
188119c74962SPoul-Henning Kampoptions		IPR_VJ
188219c74962SPoul-Henning Kamp#
188319c74962SPoul-Henning Kamp# network driver for sync PPP over ISDN
188419c74962SPoul-Henning Kamppseudo-device	"i4bisppp"	4
188519c74962SPoul-Henning Kamp
188619c74962SPoul-Henning Kamp
1887ab4c624bSMike Smith# Parallel-Port Bus
1888ab4c624bSMike Smith#
1889ab4c624bSMike Smith# Parallel port bus support is provided by the `ppbus' device.
1890ab4c624bSMike Smith# Multiple devices may be attached to the parallel port, devices
1891ab4c624bSMike Smith# are automatically probed and attached when found.
1892ab4c624bSMike Smith#
1893ab4c624bSMike Smith# Supported devices:
1894ab4c624bSMike Smith# vpo	Iomega Zip Drive
1895f7d09fbaSNicolas Souchu#	Requires SCSI disk support ('scbus' and 'da'), best
1896f88c1346SMike Smith#	performance is achieved with ports in EPP 1.9 mode.
1897fdf94d1aSNicolas Souchu# lpt	Parallel Printer
189846f3ff79SMike Smith# plip	Parallel network interface
1899fdf94d1aSNicolas Souchu# ppi	General-purpose I/O ("Geek Port") + IEEE1284 I/O
1900f7d09fbaSNicolas Souchu# pps	Pulse per second Timing Interface
190128ebb692SNicolas Souchu# lpbb	Philips official parallel port I2C bit-banging interface
1902ab4c624bSMike Smith#
1903ab4c624bSMike Smith# Supported interfaces:
1904ab4c624bSMike Smith# ppc	ISA-bus parallel port interfaces.
1905ab4c624bSMike Smith#
1906ef8f7626SNicolas Souchu
1907ef8f7626SNicolas Souchuoptions		"DEBUG_1284"	# IEEE1284 signaling protocol debug
1908ef8f7626SNicolas Souchuoptions		"PERIPH_1284"	# Makes your computer act as a IEEE1284
1909ef8f7626SNicolas Souchu				# compliant peripheral
1910ef8f7626SNicolas Souchuoptions		"DONTPROBE_1284"# Avoid boot detection of PnP parallel devices
1911ef8f7626SNicolas Souchuoptions		"VP0_DEBUG"	# ZIP/ZIP+ debug
1912fdf94d1aSNicolas Souchuoptions		"LPT_DEBUG"	# Printer driver debug
1913ef8f7626SNicolas Souchuoptions		"PPC_DEBUG"	# Parallel chipset level debug
1914ef8f7626SNicolas Souchuoptions		"PLIP_DEBUG"	# Parallel network IP interface debug
1915ef8f7626SNicolas Souchu
1916ab4c624bSMike Smithcontroller	ppbus0
191758bcaed0SNicolas Souchucontroller	vpo0	at ppbus?
1918fdf94d1aSNicolas Souchudevice		lpt0	at ppbus?
191946f3ff79SMike Smithdevice		plip0	at ppbus?
1920ab4c624bSMike Smithdevice		ppi0	at ppbus?
1921507e2e44SPoul-Henning Kampdevice		pps0	at ppbus?
192228ebb692SNicolas Souchudevice		lpbb0	at ppbus?
1923ab4c624bSMike Smith
1924bca70763SNicolas Souchudevice		ppc0	at isa? port? tty irq 7
1925ab4c624bSMike Smith
1926432aad0eSTor Egge# Kernel BOOTP support
1927432aad0eSTor Egge
1928432aad0eSTor Eggeoptions		BOOTP		# Use BOOTP to obtain IP address/hostname
1929432aad0eSTor Eggeoptions		BOOTP_NFSROOT	# NFS mount root filesystem using BOOTP info
1930432aad0eSTor Eggeoptions		"BOOTP_NFSV3"	# Use NFS v3 to NFS mount root
1931432aad0eSTor Eggeoptions		BOOTP_COMPAT	# Workaround for broken bootp daemons.
19328f7030a7STor Eggeoptions		"BOOTP_WIRED_TO=fxp0" # Use interface fxp0 for BOOTP
1933432aad0eSTor Egge
1934d94f38acSEivind Eklund#
1935d94f38acSEivind Eklund# Add tie-ins for a hardware watchdog.  This only enable the hooks;
1936d94f38acSEivind Eklund# the user must still supply the actual driver.
1937d94f38acSEivind Eklund#
1938d94f38acSEivind Eklundoptions		HW_WDOG
1939d94f38acSEivind Eklund
1940005092bbSEivind Eklund#
1941005092bbSEivind Eklund# Set the number of PV entries per process.  Increasing this can
1942005092bbSEivind Eklund# stop panics related to heavy use of shared memory. However, that can
1943005092bbSEivind Eklund# (combined with large amounts of physical memory) cause panics at
1944005092bbSEivind Eklund# boot time due the kernel running out of VM space.
1945005092bbSEivind Eklund#
1946005092bbSEivind Eklund# If you're tweaking this, you might also want to increase the sysctls
1947005092bbSEivind Eklund# "vm.v_free_min", "vm.v_free_reserved", and "vm.v_free_target".
1948005092bbSEivind Eklund#
194904fa1e6cSEivind Eklund# The value below is the one more than the default.
1950005092bbSEivind Eklund#
195104fa1e6cSEivind Eklundoptions         "PMAP_SHPGPERPROC=201"
1952005092bbSEivind Eklund
1953c796cfa1SAndrzej Bialecki#
1954c796cfa1SAndrzej Bialecki# Disable swapping. This option removes all code which actually performs
1955c796cfa1SAndrzej Bialecki# swapping, so it's not possible to turn it back on at run-time.
1956c796cfa1SAndrzej Bialecki#
1957c796cfa1SAndrzej Bialecki# This is sometimes usable for systems which don't have any swap space
1958c796cfa1SAndrzej Bialecki# (see also sysctls "vm.defer_swapspace_pageouts" and
1959c796cfa1SAndrzej Bialecki# "vm.disable_swapspace_pageouts")
1960c796cfa1SAndrzej Bialecki#
1961c796cfa1SAndrzej Bialecki#options	NO_SWAPPING
1962c796cfa1SAndrzej Bialecki
19639dab0776SDavid Greenman# Set the number of sf_bufs to allocate. sf_bufs are virtual buffers
19649dab0776SDavid Greenman# for sendfile(2) that are used to map file VM pages, and normally
19659dab0776SDavid Greenman# default to a quantity that is roughly 16*MAXUSERS+512. You would
19669dab0776SDavid Greenman# typically want about 4 of these for each simultaneous file send.
19679dab0776SDavid Greenman#
19689dab0776SDavid Greenmanoptions		"NSFBUFS=1024"
19699dab0776SDavid Greenman
197015a1057cSEivind Eklund#
1971053a2b61SEivind Eklund# Enable extra debugging code for locks.  This stores the filename and
1972053a2b61SEivind Eklund# line of whatever aquired the lock in the lock itself, and change a
1973053a2b61SEivind Eklund# number of function calls to pass around the relevant data.  This is
1974053a2b61SEivind Eklund# not at all useful unless you are debugging lock code.  Also note
1975053a2b61SEivind Eklund# that it is likely to break e.g. fstat(1) unless you recompile your
1976053a2b61SEivind Eklund# userland with -DDEBUG_LOCKS as well.
197715a1057cSEivind Eklund#
197815a1057cSEivind Eklundoptions		DEBUG_LOCKS
197915a1057cSEivind Eklund
198065e8111fSBruce Evans# More undocumented options for linting.
198194c94804SBruce Evans
1982d656e316SBruce Evansoptions		CLK_CALIBRATION_LOOP
1983d656e316SBruce Evansoptions		"CLK_USE_I8254_CALIBRATION"
1984d46e059fSPoul-Henning Kampoptions		CLK_USE_TSC_CALIBRATION
1985a2210fe1SPoul-Henning Kampoptions		"TIMER_FREQ=((14318182+6)/12)"
19869546766aSBruce Evansoptions		CLUSTERDEBUG
1987f3e002a8SPoul-Henning Kampoptions		COMPAT_LINUX
198896b89afcSBruce Evansoptions		CPU_UPGRADE_HW_CACHE
198911bfa65aSBruce Evansoptions		DEBUG
199015a1057cSEivind Eklundoptions		DEBUG_VFS_LOCKS
1991c6de6a69SEivind Eklund#options	DISABLE_PSE
199211bfa65aSBruce Evansoptions		"I586_PMC_GUPROF=0x70000"
199311bfa65aSBruce Evansoptions		"IBCS2"
1994751bf650SJun-ichiro itojun Haginooptions		KEY
1995751bf650SJun-ichiro itojun Haginooptions		KEY_DEBUG
199625292acbSBruce Evansoptions		LOCKF_DEBUG
1997c6de6a69SEivind Eklundoptions		LOUTB
19984bc24b97SBruce Evansoptions		KBD_MAXRETRY=4
19994bc24b97SBruce Evansoptions		KBD_MAXWAIT=6
20004bc24b97SBruce Evansoptions		KBD_RESETDELAY=201
20014bc24b97SBruce Evansoptions		KBDIO_DEBUG=2
20024bc24b97SBruce Evansoptions		MSGMNB=2049
20034bc24b97SBruce Evansoptions		MSGMNI=41
20044bc24b97SBruce Evansoptions		MSGSEG=2049
200556a956e5SBruce Evansoptions		MSGSSZ=16
20064bc24b97SBruce Evansoptions		MSGTQL=41
20074bc24b97SBruce Evansoptions		NBUF=512
2008c6de6a69SEivind Eklundoptions		NETATALKDEBUG
20094bc24b97SBruce Evansoptions		NMBCLUSTERS=1024
20109546766aSBruce Evansoptions		NPX_DEBUG
2011c6de6a69SEivind Eklundoptions		PANIC_REBOOT_WAIT_TIME=16
20124bc24b97SBruce Evansoptions		PSM_DEBUG=1
2013078d4ac9SBruce Evansoptions		SCSI_NCR_DEBUG
2014078d4ac9SBruce Evansoptions		SCSI_NCR_DFLT_TAGS=4
2015078d4ac9SBruce Evansoptions		SCSI_NCR_MAX_SYNC=10000
2016078d4ac9SBruce Evansoptions		SCSI_NCR_MAX_WIDE=1
2017078d4ac9SBruce Evansoptions		SCSI_NCR_MYADDR=7
20184bc24b97SBruce Evansoptions		SEMMAP=31
20194bc24b97SBruce Evansoptions		SEMMNI=11
20204bc24b97SBruce Evansoptions		SEMMNS=61
20214bc24b97SBruce Evansoptions		SEMMNU=31
20224bc24b97SBruce Evansoptions		SEMMSL=61
20234bc24b97SBruce Evansoptions		SEMOPM=101
20244bc24b97SBruce Evansoptions		SEMUME=11
2025b1529bdaSPeter Wemmoptions		SHOW_BUSYBUFS	# List buffers that prevent root unmount
20264bc24b97SBruce Evansoptions		SHMALL=1025
20274bc24b97SBruce Evansoptions		"SHMMAX=(SHMMAXPGS*PAGE_SIZE+1)"
20284bc24b97SBruce Evansoptions		SHMMAXPGS=1025
20294bc24b97SBruce Evansoptions		SHMMIN=2
20304bc24b97SBruce Evansoptions		SHMMNI=33
20314bc24b97SBruce Evansoptions		SHMSEG=9
2032d656e316SBruce Evansoptions		SI_DEBUG
203325292acbSBruce Evansoptions		SIMPLELOCK_DEBUG
2034cefdbb04SBruce Evansoptions		SPX_HACK
20355526d2d9SEivind Eklundoptions		VFS_BIO_DEBUG
203604fb1490SNicolas Souchuoptions		ENABLE_ALART
203716094866SJulian Elischer
2038f909c15bSEivind Eklund# The 'dpt' driver provides support for DPT controllers (http://www.dpt.com/).
2039f909c15bSEivind Eklund# These have hardware RAID-{0,1,5} support, and do multi-initiator I/O.
2040b755b885SEivind Eklund# The DPT controllers are commonly re-licensed under other brand-names -
2041b755b885SEivind Eklund# some controllers by Olivetti, Dec, HP, AT&T, SNI, AST, Alphatronic, NEC and
2042b755b885SEivind Eklund# Compaq are actually DPT controllers.
2043b755b885SEivind Eklund#
204416094866SJulian Elischer# See sys/dev/dpt for debugging and other subtle options.
204516094866SJulian Elischer#   DPT_VERIFY_HINTR        Performs some strict hardware interrupts testing.
204616094866SJulian Elischer#                           Only use if you suspect PCI bus corruption problems
204716094866SJulian Elischer#   DPT_RESTRICTED_FREELIST Normally, the freelisat used by the DPT for queue
204816094866SJulian Elischer#                           will grow to accomodate increased use.  This growth
204916094866SJulian Elischer#                           will NOT shrink.  To restrict the number of queue
205016094866SJulian Elischer#                           slots to exactly what the DPT can hold at one time,
205116094866SJulian Elischer#                           enable this option.
205216094866SJulian Elischer#   DPT_MEASURE_PERFORMANCE Enables a set of (semi)invasive metrics. Various
2053b755b885SEivind Eklund#                           instruments are enabled.  The tools in
2054b755b885SEivind Eklund#                           /usr/sbin/dpt_* assume these to be enabled.
2055b755b885SEivind Eklund#   DPT_FREELIST_IS_STACK   For optimal L{1,2} CPU cache utilization, enable
205616094866SJulian Elischer#                           this option.  Otherwise, the transaction queue is
205716094866SJulian Elischer#                           a LIFO.  I cannot measure the performance gain.
205816094866SJulian Elischer#   DPT_HANDLE_TIMEOUTS     Normally device timeouts are handled by the DPT.
205916094866SJulian Elischer#                           If you ant the driver to handle timeouts, enable
206016094866SJulian Elischer#                           this option.  If your system is very busy, this
206116094866SJulian Elischer#                           option will create more trouble than solve.
206216094866SJulian Elischer#   DPT_TIMEOUT_FACTOR      Used to compute the excessive amount of time to
206316094866SJulian Elischer#                           wait when timing out with the above option.
206416094866SJulian Elischer#  DPT_DEBUG_xxxx           These are controllable from sys/dev/dpt/dpt.h
206516094866SJulian Elischer#  DPT_LOST_IRQ             When enabled, will try, once per second, to catch
206616094866SJulian Elischer#                           any interrupt that got lost.  Seems to help in some
206716094866SJulian Elischer#                           DPT-firmware/Motherboard combinations.  Minimal
206816094866SJulian Elischer#                           cost, great benefit.
2069b755b885SEivind Eklund#  DPT_RESET_HBA            Make "reset" actually reset the controller
2070b755b885SEivind Eklund#                           instead of fudging it.  Only enable this if you
2071b755b885SEivind Eklund#			    are 100% certain you need it.
2072b755b885SEivind Eklund#  DPT_SHUTDOWN_SLEEP       Reset controller if a request take more than
2073b755b885SEivind Eklund#                           this number of seconds.  Do NOT enable this
2074b755b885SEivind Eklund#			    unless you are really, really, really certain
2075b755b885SEivind Eklund#			    you need it.  You are advised to call Simon (the
2076b755b885SEivind Eklund#			    driver author) before setting it, and NEVER,
2077b755b885SEivind Eklund#			    EVER set it to less than 300s (5 minutes).
207816094866SJulian Elischer
207916094866SJulian Elischercontroller      dpt0
208016094866SJulian Elischer
208116094866SJulian Elischer# DPT options
208216094866SJulian Elischeroptions DPT_VERIFY_HINTR
208316094866SJulian Elischeroptions DPT_RESTRICTED_FREELIST
20847c0daaa8SEivind Eklund#!CAM# options DPT_MEASURE_PERFORMANCE
208516094866SJulian Elischeroptions DPT_FREELIST_IS_STACK
20867c0daaa8SEivind Eklund#!CAM# options DPT_HANDLE_TIMEOUTS
208716094866SJulian Elischeroptions DPT_TIMEOUT_FACTOR=4
208816094866SJulian Elischeroptions	DPT_INTR_DELAY=200      # Some motherboards need that
208916094866SJulian Elischeroptions DPT_LOST_IRQ
2090b755b885SEivind Eklundoptions DPT_RESET_HBA
2091b755b885SEivind Eklund
2092b755b885SEivind Eklund# Don't EVER set this without having talked to Simon Shapiro on the phone
2093b755b885SEivind Eklund# first.
2094b755b885SEivind Eklundoptions DPT_SHUTDOWN_SLEEP=500
20951d33cf3dSNick Hibma
20961d33cf3dSNick Hibma# USB support
20971d33cf3dSNick Hibma# UHCI controller
2098b4e36adfSMatthew Dillon#controller    uhci0
20991d33cf3dSNick Hibma# OHCI controller
21001d33cf3dSNick Hibmacontroller    ohci0
21011d33cf3dSNick Hibma# General USB code (mandatory for USB)
21021d33cf3dSNick Hibmacontroller    usb0
21031d33cf3dSNick Hibma#
21041d33cf3dSNick Hibma# for the moment we have to specify the priorities of the device
21051d33cf3dSNick Hibma# drivers explicitly by the ordering in the list below. This will
21061d33cf3dSNick Hibma# be changed in the future.
21071d33cf3dSNick Hibma#
21081d33cf3dSNick Hibma# USB mouse
21091d33cf3dSNick Hibmadevice        ums0
21101d33cf3dSNick Hibma# USB keyboard
21111d33cf3dSNick Hibmadevice        ukbd0
21121d33cf3dSNick Hibma# USB printer
21131d33cf3dSNick Hibmadevice        ulpt0
21141d33cf3dSNick Hibma# USB communications driver
21151d33cf3dSNick Hibmadevice        ucom0
21161d33cf3dSNick Hibma# USB modem driver
21171d33cf3dSNick Hibmadevice        umodem0
21181d33cf3dSNick Hibma# Human Interface Device (anything with buttons and dials)
21191571f899SNick Hibmadevice        uhid0
21201d33cf3dSNick Hibma# Generic USB device driver
21211d33cf3dSNick Hibmadevice        ugen0
21221d33cf3dSNick Hibma#
21231d33cf3dSNick Hibmaoptions       USB_DEBUG
21241d33cf3dSNick Hibmaoptions       USBVERBOSE
2125