xref: /freebsd/sys/conf/NOTES (revision 38d8a113a9f15a10e66027a9baef5e02f6897364)
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#
538d8a113SPoul-Henning Kamp#	$Id: LINT,v 1.352 1997/07/20 05:27:59 bde Exp $
62365e64fSRodney W. Grimes#
73aa06999SGarrett Wollman# NB: You probably don't want to try running a kernel built from this
83aa06999SGarrett Wollman# file.  Instead, you should start from GENERIC, and add options from
93aa06999SGarrett Wollman# this file as required.
102365e64fSRodney W. Grimes#
112365e64fSRodney W. Grimes
126a8d6623SGarrett Wollman#
136a8d6623SGarrett Wollman# This directive is mandatory; it defines the architecture to be
1456be1833SKATO Takenori# configured for; in this case, the 386 family based IBM-PC and
1556be1833SKATO Takenori# compatibles.
166a8d6623SGarrett Wollman#
172365e64fSRodney W. Grimesmachine		"i386"
182365e64fSRodney W. Grimes
196a8d6623SGarrett Wollman#
206a8d6623SGarrett Wollman# This is the ``identification'' of the kernel.  Usually this should
216a8d6623SGarrett Wollman# be the same as the name of your kernel.
226a8d6623SGarrett Wollman#
236a8d6623SGarrett Wollmanident		LINT
246a8d6623SGarrett Wollman
256a8d6623SGarrett Wollman#
266a8d6623SGarrett Wollman# The `maxusers' parameter controls the static sizing of a number of
276a8d6623SGarrett Wollman# internal system tables by a complicated formula defined in param.c.
286a8d6623SGarrett Wollman#
296a8d6623SGarrett Wollmanmaxusers	10
306a8d6623SGarrett Wollman
316a8d6623SGarrett Wollman#
32d43f0f0aSJohn Dyson# Certain applications can grow to be larger than the 128M limit
33d43f0f0aSJohn Dyson# that FreeBSD initially imposes.  Below are some options to
34d43f0f0aSJohn Dyson# allow that limit to grow to 256MB, and can be increased further
35d43f0f0aSJohn Dyson# with changing the parameters.  MAXDSIZ is the maximum that the
36d43f0f0aSJohn Dyson# limit can be set to, and the DFLDSIZ is the default value for
37d43f0f0aSJohn Dyson# the limit.  You might want to set the default lower than the
38d43f0f0aSJohn Dyson# max, and explicitly set the maximum with a shell command for processes
39d43f0f0aSJohn Dyson# that regularly exceed the limit like INND.
40d43f0f0aSJohn Dyson#
41392cefd1SBruce Evansoptions		"MAXDSIZ=(256*1024*1024)"
42392cefd1SBruce Evansoptions		"DFLDSIZ=(256*1024*1024)"
43d43f0f0aSJohn Dyson
4425cf9d99SJordan K. Hubbard# When this is set, be extra conservative in various parts of the kernel
4525cf9d99SJordan K. Hubbard# and choose functionality over speed (on the widest variety of systems).
4625cf9d99SJordan K. Hubbardoptions		FAILSAFE
4725cf9d99SJordan K. Hubbard
48827d623eSJordan K. Hubbard# This allows you to actually store this configuration file into
49827d623eSJordan K. Hubbard# the kernel binary itself, where it may be later read by saying:
50827d623eSJordan K. Hubbard#    strings /kernel | grep ^___ | sed -e 's/^___//' > MYKERNEL
51827d623eSJordan K. Hubbard#
52827d623eSJordan K. Hubbardoptions         INCLUDE_CONFIG_FILE     # Include this file in kernel
53827d623eSJordan K. Hubbard
546a8d6623SGarrett Wollman#
556a8d6623SGarrett Wollman# This directive defines a number of things:
566a8d6623SGarrett Wollman#  - The compiled kernel is to be called `kernel'
576a8d6623SGarrett Wollman#  - The root filesystem might be on partition wd0a
58b8e91dabSDavid Greenman#  - Crash dumps will be written to wd0b, if possible.  Specifying the
59b8e91dabSDavid Greenman#    dump device here is not recommended.  Use dumpon(8).
606a8d6623SGarrett Wollman#
61b8e91dabSDavid Greenmanconfig		kernel	root on wd0 dumps on wd0
622365e64fSRodney W. Grimes
636a8d6623SGarrett Wollman
646a8d6623SGarrett Wollman#####################################################################
65477a642cSPeter Wemm# SMP OPTIONS:
66477a642cSPeter Wemm#
67477a642cSPeter Wemm# SMP enables building of a Symmetric MultiProcessor Kernel.
68477a642cSPeter Wemm# APIC_IO enables the use of the IO APIC for Symmetric I/O.
69477a642cSPeter Wemm# NCPU sets the number of CPUs, defaults to 2.
70477a642cSPeter Wemm# NBUS sets the number of busses, defaults to 4.
71477a642cSPeter Wemm# NAPIC sets the number of IO APICs on the motherboard, defaults to 1.
72477a642cSPeter Wemm# NINTR sets the total number of INTs provided by the motherboard.
73477a642cSPeter Wemm#
74477a642cSPeter Wemm# SMP_TIMER_NC is for motherboards that claim 8254 connectivity to the IO APIC,
75477a642cSPeter Wemm#  when in fact it is NOT connected.
76477a642cSPeter Wemm#
77477a642cSPeter Wemm# Notes:
78477a642cSPeter Wemm#
79477a642cSPeter Wemm#  An SMP kernel will ONLY run on an Intel MP spec. qualified motherboard.
80477a642cSPeter Wemm#
81477a642cSPeter Wemm#  Be sure to disable 'cpu "I386_CPU"' && 'cpu "I486_CPU"' for SMP kernels.
82477a642cSPeter Wemm#
83477a642cSPeter Wemm#  Check the 'Rogue SMP hardware' section to see if additional options
84477a642cSPeter Wemm#   are required by your hardware.
85477a642cSPeter Wemm#
86477a642cSPeter Wemm
87477a642cSPeter Wemm# Mandatory:
88477a642cSPeter Wemmoptions		SMP			# Symmetric MultiProcessor Kernel
89477a642cSPeter Wemmoptions		APIC_IO			# Symmetric (APIC) I/O
90477a642cSPeter Wemm
9106daa051SBruce Evans# Optional, these are the defaults plus 1:
9206daa051SBruce Evansoptions		NCPU=3			# number of CPUs
9306daa051SBruce Evansoptions		NBUS=5			# number of busses
9406daa051SBruce Evansoptions		NAPIC=2			# number of IO APICs
9506daa051SBruce Evansoptions		NINTR=25		# number of INTs
96477a642cSPeter Wemm
97477a642cSPeter Wemm#
98477a642cSPeter Wemm# Rogue SMP hardware:
99477a642cSPeter Wemm#
100477a642cSPeter Wemm
101477a642cSPeter Wemm# Tyan Tomcat II:
102477a642cSPeter Wemm#options                SMP_TIMER_NC            # 8254 NOT connected to APIC
103477a642cSPeter Wemm
104477a642cSPeter Wemm# SuperMicro P6DNE:
105477a642cSPeter Wemm#options                SMP_TIMER_NC            # 8254 NOT connected to APIC
106477a642cSPeter Wemm
107477a642cSPeter Wemm# Bridged PCI cards:
108477a642cSPeter Wemm#
109477a642cSPeter Wemm# The MP tables of most of the current generation MP motherboards
110477a642cSPeter Wemm#  do NOT properly support bridged PCI cards.  To use one of these
111477a642cSPeter Wemm#  cards you should refer to ???
112477a642cSPeter Wemm
113477a642cSPeter Wemm
114477a642cSPeter Wemm#####################################################################
11556be1833SKATO Takenori# CPU OPTIONS
11656be1833SKATO Takenori
11756be1833SKATO Takenori#
11856be1833SKATO Takenori# You must specify at least one CPU (the one you intend to run on);
11956be1833SKATO Takenori# deleting the specification for CPUs you don't need to use may make
12056be1833SKATO Takenori# parts of the system run faster.  This is especially true removing
12156be1833SKATO Takenori# I386_CPU.
12256be1833SKATO Takenori#
12356be1833SKATO Takenoricpu		"I386_CPU"
12456be1833SKATO Takenoricpu		"I486_CPU"
12556be1833SKATO Takenoricpu		"I586_CPU"		# aka Pentium(tm)
12656be1833SKATO Takenoricpu		"I686_CPU"		# aka Pentium Pro(tm)
12756be1833SKATO Takenori
12856be1833SKATO Takenori#
12956be1833SKATO Takenori# Options for CPU features.
13056be1833SKATO Takenori#
13156be1833SKATO Takenori# CPU_BLUELIGHTNING_FPU_OP_CACHE enables FPU operand cache on IBM
13256be1833SKATO Takenori# BlueLightning CPU.  It works only with Cyrix FPU, and this option
13356be1833SKATO Takenori# should not be used with Intel FPU.
13456be1833SKATO Takenori#
13556be1833SKATO Takenori# CPU_BLUELIGHTNING_3X enables triple-clock mode on IBM Blue Lightning
13656be1833SKATO Takenori# CPU if CPU supports it. The default is double-clock mode on
13756be1833SKATO Takenori# BlueLightning CPU box.
13856be1833SKATO Takenori#
13956be1833SKATO Takenori# CPU_BTB_EN enables branch target buffer on Cyrix 5x86 (NOTE 1).
14056be1833SKATO Takenori#
1414962d938SKATO Takenori# CPU_DIRECT_MAPPED_CACHE sets L1 cache of Cyrix 486DLC CPU in direct
1424962d938SKATO Takenori# mapped mode.  Default is 2-way set associative mode.
1434962d938SKATO 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#
16656be1833SKATO Takenori# CYRIX_CACHE_WORKS enables CPU cache on Cyrix 486 CPUs with cache
16756be1833SKATO Takenori# flush at hold state.
16856be1833SKATO Takenori#
16956be1833SKATO Takenori# CYRIX_CACHE_REALLY_WORKS enables (1) CPU cache on Cyrix 486 CPUs
17056be1833SKATO Takenori# without cache flush at hold state, and (2) write-back CPU cache on
17156be1833SKATO Takenori# Cyrix 6x86 whose revision < 2.7 (NOTE 2).
17256be1833SKATO Takenori#
17356be1833SKATO Takenori# NOTE 1: The options, CPU_BTB_EN, CPU_LOOP_EN, CPU_IORT,
17456be1833SKATO Takenori# CPU_LOOP_ENand CPU_RSTK_EN should no be used becasue of CPU bugs.
17556be1833SKATO Takenori# These options may crash your system.
17656be1833SKATO Takenori#
17756be1833SKATO Takenori# NOTE 2: If CYRIX_CACHE_REALLY_WORKS is not set, CPU cache is enabled
17856be1833SKATO Takenori# in write-through mode when revision < 2.7.  If revision of Cyrix
17956be1833SKATO Takenori# 6x86 >= 2.7, CPU cache is always enabled in write-back mode.
18056be1833SKATO Takenori#
18156be1833SKATO Takenorioptions		"CPU_BLUELIGHTNING_FPU_OP_CACHE"
18256be1833SKATO Takenorioptions		"CPU_BLUELIGHTNING_3X"
18356be1833SKATO Takenorioptions		"CPU_BTB_EN"
1844962d938SKATO Takenorioptions		"CPU_DIRECT_MAPPED_CACHE"
18556be1833SKATO Takenorioptions		"CPU_DISABLE_5X86_LSSER"
18656be1833SKATO Takenorioptions		"CPU_FASTER_5X86_FPU"
18756be1833SKATO Takenorioptions		"CPU_I486_ON_386"
18856be1833SKATO Takenorioptions		"CPU_IORT"
18956be1833SKATO Takenorioptions		"CPU_LOOP_EN"
19056be1833SKATO Takenorioptions		"CPU_RSTK_EN"
19156be1833SKATO Takenorioptions		"CPU_SUSP_HLT"
19256be1833SKATO Takenorioptions		"CYRIX_CACHE_WORKS"
19356be1833SKATO Takenorioptions		"CYRIX_CACHE_REALLY_WORKS"
19456be1833SKATO Takenori
19556be1833SKATO Takenori#
19656be1833SKATO Takenori# A math emulator is mandatory if you wish to run on hardware which
19756be1833SKATO Takenori# does not have a floating-point processor.  Pick either the original,
19856be1833SKATO Takenori# bogus (but freely-distributable) math emulator, or a much more
19956be1833SKATO Takenori# fully-featured but GPL-licensed emulator taken from Linux.
20056be1833SKATO Takenori#
20156be1833SKATO Takenorioptions		MATH_EMULATE		#Support for x87 emulation
20256be1833SKATO Takenori# Don't enable both of these in a real config.
20356be1833SKATO Takenorioptions		GPL_MATH_EMULATE	#Support for x87 emulation via
20456be1833SKATO Takenori					#new math emulator
20556be1833SKATO Takenori
20656be1833SKATO Takenori
20756be1833SKATO Takenori#####################################################################
2086a8d6623SGarrett Wollman# COMPATIBILITY OPTIONS
209690f540cSAndrey A. Chernov
2106a8d6623SGarrett Wollman#
2116a8d6623SGarrett Wollman# Implement system calls compatible with 4.3BSD and older versions of
21256c7a48cSJordan K. Hubbard# FreeBSD.  You probably do NOT want to remove this as much current code
21356c7a48cSJordan K. Hubbard# still relies on the 4.3 emulation.
2146a8d6623SGarrett Wollman#
2156a8d6623SGarrett Wollmanoptions		"COMPAT_43"
2166a8d6623SGarrett Wollman
2176a8d6623SGarrett Wollman#
2186c5e9bbdSMike Pritchard# Allow user-mode programs to manipulate their local descriptor tables.
2196a8d6623SGarrett Wollman# This option is required for the WINE Windows(tm) emulator, and is
2206a8d6623SGarrett Wollman# not used by anything else (that we know of).
2216a8d6623SGarrett Wollman#
2226a8d6623SGarrett Wollmanoptions		USER_LDT		#allow user-level control of i386 ldt
2236a8d6623SGarrett Wollman
2246a8d6623SGarrett Wollman#
2256a8d6623SGarrett Wollman# These three options provide support for System V Interface
2266a8d6623SGarrett Wollman# Definition-style interprocess communication, in the form of shared
2276a8d6623SGarrett Wollman# memory, semaphores, and message queues, respectively.
2286a8d6623SGarrett Wollman#
2296a8d6623SGarrett Wollmanoptions		SYSVSHM
2306a8d6623SGarrett Wollmanoptions		SYSVSEM
2316a8d6623SGarrett Wollmanoptions		SYSVMSG
2326a8d6623SGarrett Wollman
23394801746SPoul-Henning Kamp#
23494801746SPoul-Henning Kamp# This option includes a MD5 routine in the kernel, this is used for
23594801746SPoul-Henning Kamp# various authentication and privacy uses.
23694801746SPoul-Henning Kamp#
23794801746SPoul-Henning Kampoptions		"MD5"
23894801746SPoul-Henning Kamp
2396a8d6623SGarrett Wollman
2406a8d6623SGarrett Wollman#####################################################################
2416a8d6623SGarrett Wollman# DEBUGGING OPTIONS
2426a8d6623SGarrett Wollman
2436a8d6623SGarrett Wollman#
244b5d89ca8SBruce Evans# Enable the kernel debugger.
2456a8d6623SGarrett Wollman#
246b5d89ca8SBruce Evansoptions		DDB
247b5d89ca8SBruce Evans
248b5d89ca8SBruce Evans#
2495ccab2afSGary Palmer# Don't drop into DDB for a panic. Intended for unattended operation
2505ccab2afSGary Palmer# where you may want to drop to DDB from the console, but still want
2515ccab2afSGary Palmer# the machine to recover from a panic
2525ccab2afSGary Palmer#
2535ccab2afSGary Palmeroptions		DDB_UNATTENDED
2545ccab2afSGary Palmer
2555ccab2afSGary Palmer#
256562d05dfSPaul Traina# If using GDB remote mode to debug the kernel, there's a non-standard
257562d05dfSPaul Traina# extension to the remote protocol that can be used to use the serial
258562d05dfSPaul Traina# port as both the debugging port and the system console.  It's non-
259562d05dfSPaul Traina# standard and you're on your own if you enable it.  See also the
260562d05dfSPaul Traina# "remotechat" variables in the FreeBSD specific version of gdb.
261562d05dfSPaul Traina#
262562d05dfSPaul Trainaoptions		GDB_REMOTE_CHAT
263562d05dfSPaul Traina
264562d05dfSPaul Traina#
2656a8d6623SGarrett Wollman# KTRACE enables the system-call tracing facility ktrace(2).
2666a8d6623SGarrett Wollman#
2672365e64fSRodney W. Grimesoptions		KTRACE			#kernel tracing
26821c64a07SAndrey A. Chernov
2696a8d6623SGarrett Wollman#
2706a8d6623SGarrett Wollman# The DIAGNOSTIC option is used in a number of source files to enable
2716a8d6623SGarrett Wollman# extra sanity checking of internal structures.  This support is not
2726a8d6623SGarrett Wollman# enabled by default because of the extra time it would take to check
2736a8d6623SGarrett Wollman# for these conditions, which can only occur as a result of
2746a8d6623SGarrett Wollman# programming errors.
2756a8d6623SGarrett Wollman#
2760dc7d907SPoul-Henning Kampoptions		DIAGNOSTIC
277da59a31cSDavid Greenman
2780dd1eea1SJordan K. Hubbard#
279348acd94SGarrett Wollman# PERFMON causes the driver for Pentium/Pentium Pro performance counters
280348acd94SGarrett Wollman# to be compiled.  See perfmon(4) for more information.
281348acd94SGarrett Wollman#
282348acd94SGarrett Wollmanoptions		PERFMON
283348acd94SGarrett Wollman
284348acd94SGarrett Wollman# XXX - this doesn't belong here.
2850dd1eea1SJordan K. Hubbard# Allow ordinary users to take the console - this is useful for X.
2860dd1eea1SJordan K. Hubbardoptions		UCONSOLE
2870dd1eea1SJordan K. Hubbard
28896fc6efbSPoul-Henning Kamp# XXX - this doesn't belong here either
28996fc6efbSPoul-Henning Kampoptions		USERCONFIG		#boot -c editor
2908996308bSJordan K. Hubbardoptions		USERCONFIG_BOOT		#imply -c and parse info area
29196fc6efbSPoul-Henning Kampoptions		VISUAL_USERCONFIG	#visual boot -c editor
2926a8d6623SGarrett Wollman
2936a8d6623SGarrett Wollman#####################################################################
2946a8d6623SGarrett Wollman# NETWORKING OPTIONS
29570c0b54cSAndrey A. Chernov
2966a8d6623SGarrett Wollman#
2976a8d6623SGarrett Wollman# Protocol families:
2986a8d6623SGarrett Wollman#  Only the INET (Internet) family is officially supported in FreeBSD.
29911bfa65aSBruce Evans#  Source code for the NS (Xerox Network Service) is provided for amusement
30011bfa65aSBruce Evans#  value.
3016a8d6623SGarrett Wollman#
3026a8d6623SGarrett Wollmanoptions		INET			#Internet communications protocols
303f73bbaf2SDavid Greenman
304cc6a66f2SJulian Elischeroptions		IPX			#IPX/SPX communications protocols
305cc6a66f2SJulian Elischeroptions		IPXIP			#IPX in IP encapsulation (not available)
306cc6a66f2SJulian Elischeroptions		IPTUNNEL		#IP in IPX encapsulation (not available)
307cc6a66f2SJulian Elischer
30834b5fca7SJulian Elischeroptions		NETATALK		#Appletalk communications protocols
30934b5fca7SJulian Elischer
31011bfa65aSBruce Evans# These are currently broken but are shipped due to interest.
31111bfa65aSBruce Evans#options		NS			#Xerox NS protocols
31211bfa65aSBruce Evans
313bba9a7a0SGarrett Wollman# These are currently broken and are no longer shipped due to lack
314bba9a7a0SGarrett Wollman# of interest.
315bba9a7a0SGarrett Wollman#options		CCITT			#X.25 network layer
316f73bbaf2SDavid Greenman#options		ISO
317f73bbaf2SDavid Greenman#options		TPIP			#ISO TP class 4 over IP
318f73bbaf2SDavid Greenman#options		TPCONS			#ISO TP class 0 over X.25
319bba9a7a0SGarrett Wollman#options		LLC			#X.25 link layer for Ethernets
320bba9a7a0SGarrett Wollman#options		HDLC			#X.25 link layer for serial lines
321bba9a7a0SGarrett Wollman#options		EON			#ISO CLNP over IP
322dc915e7cSGarrett Wollman#options		NSIP			#XNS over IP
32363a74862SSteven Wallace
3246a8d6623SGarrett Wollman#
3256a8d6623SGarrett Wollman# Network interfaces:
32656c7a48cSJordan K. Hubbard#  The `loop' pseudo-device is MANDATORY when networking is enabled.
3276a8d6623SGarrett Wollman#  The `ether' pseudo-device provides generic code to handle
32856c7a48cSJordan K. Hubbard#  Ethernets; it is MANDATORY when a Ethernet device driver is
3296a8d6623SGarrett Wollman#  configured.
330d41f24e7SDavid Greenman#  The 'fddi' pseudo-device provides generic code to support FDDI.
33183401efaSGarrett Wollman#  The `sppp' pseudo-device serves a similar role for certain types
332e7c234a1SPeter Wemm#  of synchronous PPP links (like `cx', `ar').
3336a8d6623SGarrett Wollman#  The `sl' pseudo-device implements the Serial Line IP (SLIP) service.
3346a8d6623SGarrett Wollman#  The `ppp' pseudo-device implements the Point-to-Point Protocol.
335d29895dcSGarrett Wollman#  The `bpfilter' pseudo-device enables the Berkeley Packet Filter.  Be
336d29895dcSGarrett Wollman#  aware of the legal and administrative consequences of enabling this
337d29895dcSGarrett Wollman#  option.  The number of devices determines the maximum number of
338d29895dcSGarrett Wollman#  simultaneous BPF clients programs runnable.
33959d8d13fSGarrett Wollman#  The `disc' pseudo-device implements a minimal network interface,
34059d8d13fSGarrett Wollman#  which throws away all packets sent and never receives any.  It is
34159d8d13fSGarrett Wollman#  included for testing purposes.
342b60d4a5dSAtsushi Murai#  The `tun' pseudo-device implements the User Process PPP (iijppp)
3436a8d6623SGarrett Wollman#
3446a8d6623SGarrett Wollmanpseudo-device	ether			#Generic Ethernet
345d41f24e7SDavid Greenmanpseudo-device	fddi			#Generic FDDI
34683401efaSGarrett Wollmanpseudo-device	sppp			#Generic Synchronous PPP
3476a8d6623SGarrett Wollmanpseudo-device	loop			#Network loopback device
3486a8d6623SGarrett Wollmanpseudo-device	sl	2		#Serial Line IP
3496a8d6623SGarrett Wollmanpseudo-device	ppp	2		#Point-to-point protocol
350d29895dcSGarrett Wollmanpseudo-device	bpfilter	4	#Berkeley packet filter
35159d8d13fSGarrett Wollmanpseudo-device	disc			#Discard device
3522d3f9865SAtsushi Muraipseudo-device	tun	1		#Tunnel driver(user process ppp)
353d29895dcSGarrett Wollman
3546a8d6623SGarrett Wollman#
3556a8d6623SGarrett Wollman# Internet family options:
3566a8d6623SGarrett Wollman#
3576a8d6623SGarrett Wollman# TCP_COMPAT_42 causes the TCP code to emulate certain bugs present in
3586a8d6623SGarrett Wollman# 4.2BSD.  This option should not be used unless you have a 4.2BSD
3596a8d6623SGarrett Wollman# machine and TCP connections fail.
3606a8d6623SGarrett Wollman#
3616a8d6623SGarrett Wollman# MROUTING enables the kernel multicast packet forwarder, which works
3626a8d6623SGarrett Wollman# with mrouted(8).
3636a8d6623SGarrett Wollman#
364d29895dcSGarrett Wollman# IPFIREWALL enables support for IP firewall construction, in
365ff6f025aSAlexander Langer# conjunction with the `ipfw' program.  IPFIREWALL_VERBOSE sends
366ff6f025aSAlexander Langer# logged packets to the system logger.  IPFIREWALL_VERBOSE_LIMIT
367ff6f025aSAlexander Langer# limits the number of times a matching entry can be logged.
368d29895dcSGarrett Wollman#
36993e0e116SJulian Elischer# IPDIVERT enables the divert IP sockets, used by ``ipfw divert''
37093e0e116SJulian Elischer#
37165e8111fSBruce Evans# TCPDEBUG is undocumented.
37265e8111fSBruce Evans#
3736a8d6623SGarrett Wollmanoptions		"TCP_COMPAT_42"		#emulate 4.2BSD TCP bugs
374e3178a06SJordan K. Hubbardoptions		MROUTING		# Multicast routing
375d29895dcSGarrett Wollmanoptions         IPFIREWALL              #firewall
376d29895dcSGarrett Wollmanoptions         IPFIREWALL_VERBOSE      #print information about
377d29895dcSGarrett Wollman					# dropped packets
378ff6f025aSAlexander Langeroptions		"IPFIREWALL_VERBOSE_LIMIT=100" #limit verbosity
37993e0e116SJulian Elischeroptions		IPDIVERT		#divert sockets
38065e8111fSBruce Evansoptions		TCPDEBUG
3816a8d6623SGarrett Wollman
3826a8d6623SGarrett Wollman
3836a8d6623SGarrett Wollman#####################################################################
3846a8d6623SGarrett Wollman# FILESYSTEM OPTIONS
385e3178a06SJordan K. Hubbard
3862365e64fSRodney W. Grimes#
3876a8d6623SGarrett Wollman# Only the root, /usr, and /tmp filesystems need be statically
3886a8d6623SGarrett Wollman# compiled; everything else will be automatically loaded at mount
3896a8d6623SGarrett Wollman# time.  (Exception: the UFS family---FFS, MFS, and LFS---cannot
3906a8d6623SGarrett Wollman# currently be demand-loaded.)  Some people still prefer to statically
3916a8d6623SGarrett Wollman# compile other filesystems as well.
3926a8d6623SGarrett Wollman#
3936a8d6623SGarrett Wollman# NB: The LFS, PORTAL, and UNION filesystems are known to be buggy,
3946a8d6623SGarrett Wollman# and WILL panic your system if you attempt to do anything with them.
3956a8d6623SGarrett Wollman# They are included here as an incentive for some enterprising soul to
3966a8d6623SGarrett Wollman# sit down and fix them.
3972365e64fSRodney W. Grimes#
398e5e60905SDavid Greenman# Note: 4.4BSD NQNFS lease checking has relatively high cost for
399e5e60905SDavid Greenman# _local_ I/O as well as remote I/O. Don't use it unless you will
400e5e60905SDavid Greenman# using NQNFS.
401e5e60905SDavid Greenman#
402f1a9c715SDavid Greenman
4036a8d6623SGarrett Wollman# One of these is mandatory:
4046a8d6623SGarrett Wollmanoptions		FFS			#Fast filesystem
4056a8d6623SGarrett Wollmanoptions		NFS			#Network File System
4066a8d6623SGarrett Wollman
4076a8d6623SGarrett Wollman# The rest are optional:
408e5e60905SDavid Greenmanoptions		NQNFS			#Enable NQNFS lease checking
4097c115697SPoul-Henning Kamp# options	NFS_NOSERVER		#Disable the NFS-server code.
410f1a9c715SDavid Greenmanoptions		"CD9660"		#ISO 9660 filesystem
411f1a9c715SDavid Greenmanoptions		FDESC			#File descriptor filesystem
412f1a9c715SDavid Greenmanoptions		KERNFS			#Kernel filesystem
413f1a9c715SDavid Greenmanoptions		LFS			#Log filesystem
414f1a9c715SDavid Greenmanoptions		MFS			#Memory File System
4153f9a6982SDoug Rabsonoptions		MSDOSFS			#MS DOS File System
416f1a9c715SDavid Greenmanoptions		NULLFS			#NULL filesystem
417f1a9c715SDavid Greenmanoptions		PORTAL			#Portal filesystem
418f1a9c715SDavid Greenmanoptions		PROCFS			#Process filesystem
419f1a9c715SDavid Greenmanoptions		UMAPFS			#UID map filesystem
420f1a9c715SDavid Greenmanoptions		UNION			#Union filesystem
421114a8cffSPeter Wemm# This DEVFS is experimental but seems to work
42246746c3bSJulian Elischeroptions		DEVFS			#devices filesystem
423f1a9c715SDavid Greenman
424d52d7365SPoul-Henning Kamp# Make space in the kernel for a MFS root filesystem.  Define to the number
425d52d7365SPoul-Henning Kamp# of kilobytes to reserve for the filesystem.
426b1529bdaSPeter Wemmoptions		MFS_ROOT=10
427b1529bdaSPeter Wemm# Allow the MFS_ROOT code to load the MFS image from floppy if it is missing.
428b1529bdaSPeter Wemmoptions		MFS_AUTOLOAD
429d52d7365SPoul-Henning Kamp
430a401ebbeSDavid Greenman# Allow this many swap-devices.
431b1529bdaSPeter Wemmoptions		NSWAPDEV=20
432a401ebbeSDavid Greenman
4336a8d6623SGarrett Wollman# Disk quotas are supported when this option is enabled.  If you
4346a8d6623SGarrett Wollman# change the value of this option, you must do a `make clean' in your
4356a8d6623SGarrett Wollman# kernel compile directory in order to get a working kernel.
4366a8d6623SGarrett Wollman#
4372365e64fSRodney W. Grimesoptions		QUOTA			#enable disk quotas
4386a8d6623SGarrett Wollman
43923d048eeSGary Palmer# Add more checking code to various filesystems
44023d048eeSGary Palmer#options		NULLFS_DIAGNOSTIC
44123d048eeSGary Palmer#options		KERNFS_DIAGNOSTIC
44223d048eeSGary Palmer#options		UMAPFS_DIAGNOSTIC
44323d048eeSGary Palmer#options		UNION_DIAGNOSTIC
44423d048eeSGary Palmer
4455a9714deSJoerg Wunsch# In particular multi-session CD-Rs might require a huge amount of
4465a9714deSJoerg Wunsch# time in order to "settle".  If we are about mounting them as the
4475a9714deSJoerg Wunsch# root f/s, we gotta wait a little.
4485a9714deSJoerg Wunsch#
4495a9714deSJoerg Wunsch# The number is supposed to be in seconds.
4505a9714deSJoerg Wunschoptions		"CD9660_ROOTDELAY=20"
4515a9714deSJoerg Wunsch
45223d048eeSGary Palmer# Add some error checking code to the null_bypass routine
453c85cfdb2SDavid E. O'Brien# in the NULL filesystem
45423d048eeSGary Palmer#options		SAFETY
45523d048eeSGary Palmer
4566a8d6623SGarrett Wollman
4576a8d6623SGarrett Wollman#####################################################################
458de6a307eSPeter Dufault# SCSI DEVICES
459de6a307eSPeter Dufault
4606a8d6623SGarrett Wollman# SCSI DEVICE CONFIGURATION
4616a8d6623SGarrett Wollman
4626a8d6623SGarrett Wollman# The SCSI subsystem consists of the `base' SCSI code, a number of
463ebc1a0e2SPeter Dufault# high-level SCSI device `type' drivers, and the low-level host-adapter
4646a8d6623SGarrett Wollman# device drivers.  The host adapters are listed in the ISA and PCI
4656a8d6623SGarrett Wollman# device configuration sections below.
4666a8d6623SGarrett Wollman#
467265368d4SRodney W. Grimes# Beginning with FreeBSD 2.0.5 you can wire down your SCSI devices so
468ebc1a0e2SPeter Dufault# that a given bus, target, and LUN always come on line as the same
469ebc1a0e2SPeter Dufault# device unit.  In earlier versions the unit numbers were assigned
470ebc1a0e2SPeter Dufault# in the order that the devices were probed on the SCSI bus.  This
471ebc1a0e2SPeter Dufault# means that if you removed a disk drive, you may have had to rewrite
472ebc1a0e2SPeter Dufault# your /etc/fstab file, and also that you had to be careful when adding
473ebc1a0e2SPeter Dufault# a new disk as it may have been probed earlier and moved your device
474ebc1a0e2SPeter Dufault# configuration around.
475ebc1a0e2SPeter Dufault
476ebc1a0e2SPeter Dufault# This old behavior is maintained as the default behavior.  The unit
477ebc1a0e2SPeter Dufault# assignment begins with the first non-wired down unit for a device
478ebc1a0e2SPeter Dufault# type.  For example, if you wire a disk as "sd3" then the first
479ebc1a0e2SPeter Dufault# non-wired disk will be assigned sd4.
480ebc1a0e2SPeter Dufault
481ebc1a0e2SPeter Dufault# The syntax for wiring down devices is:
482ebc1a0e2SPeter Dufault
4834fbaf9a7SJustin T. Gibbs# controller	scbus0 at ahc0		# Single bus device
4844fbaf9a7SJustin T. Gibbs# controller	scbus1 at ahc1 bus 0	# Single bus device
4854fbaf9a7SJustin T. Gibbs# controller	scbus3 at ahc2 bus 0	# Twin bus device
4864fbaf9a7SJustin T. Gibbs# controller	scbus2 at ahc2 bus 1	# Twin bus device
487ebc1a0e2SPeter Dufault# disk 		sd0 at scbus0 target 0 unit 0
4884fbaf9a7SJustin T. Gibbs# disk		sd1 at scbus3 target 1
4894fbaf9a7SJustin T. Gibbs# disk		sd2 at scbus2 target 3
4904fbaf9a7SJustin T. Gibbs# tape		st1 at scbus1 target 6
491ebc1a0e2SPeter Dufault# device	cd0 at scbus?
492ebc1a0e2SPeter Dufault
493ebc1a0e2SPeter Dufault# "units" (SCSI logical unit number) that are not specified are
494ebc1a0e2SPeter Dufault# treated as if specified as LUN 0.
495ebc1a0e2SPeter Dufault
496ebc1a0e2SPeter Dufault# All SCSI devices allocate as many units as are required.
497ebc1a0e2SPeter Dufault
498265368d4SRodney W. Grimes# The "unknown" device (uk? in pre-2.0.5) is now part of the base SCSI
499ebc1a0e2SPeter Dufault# configuration and doesn't have to be explicitly configured.
500ebc1a0e2SPeter Dufault
5016a8d6623SGarrett Wollmancontroller	scbus0	#base SCSI code
5026a8d6623SGarrett Wollmandevice		ch0	#SCSI media changers
5036a8d6623SGarrett Wollmandevice		sd0	#SCSI disks
5046a8d6623SGarrett Wollmandevice		st0	#SCSI tapes
5056a8d6623SGarrett Wollmandevice		cd0	#SCSI CD-ROMs
50649bdb5b8SJoerg Wunschdevice		od0	#SCSI optical disk
5076a8d6623SGarrett Wollman
508265368d4SRodney W. Grimes# The previous devices (ch, sd, st, cd) are recognized by config.
509265368d4SRodney W. Grimes# config doesn't (and shouldn't) know about these newer ones,
510265368d4SRodney W. Grimes# so we have to specify that they are on a SCSI bus with the "at scbus?"
511265368d4SRodney W. Grimes# clause.
512265368d4SRodney W. Grimes
5138909a72bSPeter Dufaultdevice worm0 at scbus?	# SCSI worm
5148909a72bSPeter Dufaultdevice pt0 at scbus?	# SCSI processor type
5158909a72bSPeter Dufaultdevice sctarg0 at scbus? # SCSI target
5168909a72bSPeter Dufault
5171a7c583cSGarrett Wollman# SCSI OPTIONS:
5181a7c583cSGarrett Wollman
5191a7c583cSGarrett Wollman# SCSIDEBUG: When defined enables debugging macros
5201a7c583cSGarrett Wollman# NO_SCSI_SENSE: When defined disables sense descriptions (about 4k)
5211a7c583cSGarrett Wollman# SCSI_REPORT_GEOMETRY: Always report disk geometry at boot up instead
522265368d4SRodney W. Grimes#                       of only when booting verbosely.
5231a7c583cSGarrett Wollmanoptions		SCSIDEBUG
5241a7c583cSGarrett Wollman#options	NO_SCSI_SENSE
5251a7c583cSGarrett Wollmanoptions		SCSI_REPORT_GEOMETRY
5261a7c583cSGarrett Wollman
52793063432SJoerg Wunsch# Options for the `od' optical disk driver:
52893063432SJoerg Wunsch#
52993063432SJoerg Wunsch# If drive returns sense key as 0x02 with vendor specific additional
53093063432SJoerg Wunsch# sense code (ASC) and additional sense code qualifier (ASCQ), or
53193063432SJoerg Wunsch# illegal ASC and ASCQ. This cause an error (NOT READY) and retrying.
53293063432SJoerg Wunsch# To suppress this, use the following option.
53393063432SJoerg Wunsch#
53493063432SJoerg Wunschoptions		OD_BOGUS_NOT_READY
53593063432SJoerg Wunsch#
53635846a81SMike Pritchard# For an automatic spindown, try this.  Again, preferably as an
53793063432SJoerg Wunsch# option in your config file.
53893063432SJoerg Wunsch# WARNING!  Use at your own risk.  Joerg's ancient SONY SMO drive
53993063432SJoerg Wunsch# groks it fine, while Shunsuke's Fujitsu chokes on it and times
54093063432SJoerg Wunsch# out.
54193063432SJoerg Wunsch#
54293063432SJoerg Wunschoptions		OD_AUTO_TURNOFF
54393063432SJoerg Wunsch
54493063432SJoerg Wunsch
5456a8d6623SGarrett Wollman
5466a8d6623SGarrett Wollman#####################################################################
5476a8d6623SGarrett Wollman# MISCELLANEOUS DEVICES AND OPTIONS
5486a8d6623SGarrett Wollman
5492365e64fSRodney W. Grimes#
5506a8d6623SGarrett Wollman# Of these, only the `log' device is truly mandatory.  The `pty'
5516a8d6623SGarrett Wollman# device usually turns out to be ``effectively mandatory'', as it is
5526a8d6623SGarrett Wollman# required for `telnetd', `rlogind', `screen', `emacs', and `xterm',
553bd7ea4dcSPoul-Henning Kamp# among others.
554bd7ea4dcSPoul-Henning Kamp# If you wish to run certain
55556c7a48cSJordan K. Hubbard# system utilities which are compressed by default (like /stand/sysinstall)
55656c7a48cSJordan K. Hubbard# then `gzip' becomes mandatory too.
5576a8d6623SGarrett Wollman#
5582aba17b3SGary Palmerpseudo-device	pty	16	#Pseudo ttys - can go as high as 256
5596a8d6623SGarrett Wollmanpseudo-device	speaker		#Play IBM BASIC-style noises out your speaker
5606a8d6623SGarrett Wollmanpseudo-device	log		#Kernel syslog interface (/dev/klog)
5616a8d6623SGarrett Wollmanpseudo-device	gzip		#Exec gzipped a.out's
562784cf072SPoul-Henning Kamppseudo-device	vn		#Vnode driver (turns a file into a device)
5634cba4555SUgen J.S. Antsilevichpseudo-device	snp	3	#Snoop device - to look at pty/vty/etc..
56403b225a3SSatoshi Asamipseudo-device	ccd	4	#Concatenated disk driver
5659ba0e7c3SBruce Evans
56665e8111fSBruce Evans# These are only for watching for bitrot in old tty code.
56765e8111fSBruce Evans# broken
56865e8111fSBruce Evans#pseudo-device	tb
56965e8111fSBruce Evans
57065e8111fSBruce Evans# These are only for watching for bitrot in old SCSI code.
57165e8111fSBruce Evanspseudo-device	su		#scsi user
57265e8111fSBruce Evanspseudo-device	ssc		#super scsi
57365e8111fSBruce Evans
5746a8d6623SGarrett Wollman
5756a8d6623SGarrett Wollman#####################################################################
5766a8d6623SGarrett Wollman# HARDWARE DEVICE CONFIGURATION
5776a8d6623SGarrett Wollman
5786a8d6623SGarrett Wollman# ISA and EISA devices:
579c37ddbb8SJoerg Wunsch# EISA support is available for some device, so they can be auto-probed.
5806a8d6623SGarrett Wollman# Micro Channel is not supported at all.
5816a8d6623SGarrett Wollman
5826a8d6623SGarrett Wollman#
5831a7c583cSGarrett Wollman# Mandatory ISA devices: isa, sc or vt, npx
5846a8d6623SGarrett Wollman#
5852365e64fSRodney W. Grimescontroller	isa0
5862365e64fSRodney W. Grimes
5876a8d6623SGarrett Wollman#
5886a8d6623SGarrett Wollman# Options for `isa':
5896a8d6623SGarrett Wollman#
590d72ee36fSBruce Evans# AUTO_EOI_1 enables the `automatic EOI' feature for the master 8259A
591d72ee36fSBruce Evans# interrupt controller.  This saves about 0.7-1.25 usec for each interrupt.
592d72ee36fSBruce Evans# This option breaks suspend/resume on some portables.
593d72ee36fSBruce Evans#
5949ba0e7c3SBruce Evans# AUTO_EOI_2 enables the `automatic EOI' feature for the slave 8259A
595d72ee36fSBruce Evans# interrupt controller.  This saves about 0.7-1.25 usec for each interrupt.
5969ba0e7c3SBruce Evans# Automatic EOI is documented not to work for for the slave with the
5979ba0e7c3SBruce Evans# original i8259A, but it works for some clones and some integrated
5989ba0e7c3SBruce Evans# versions.
5999ba0e7c3SBruce Evans#
6006a8d6623SGarrett Wollman# BOUNCE_BUFFERS provides support for ISA DMA on machines with more
6016a8d6623SGarrett Wollman# than 16 megabytes of memory.  It doesn't hurt on other machines.
6026a8d6623SGarrett Wollman# Some broken EISA and VLB hardware may need this, too.
6033339606dSAndreas Schulz#
604b2796687SNate Williams# MAXMEM specifies the amount of RAM on the machine; if this is not
605a675c0c6SBruce Evans# specified, FreeBSD will read the amount of memory from the CMOS RAM,
606a675c0c6SBruce Evans# so the amount of memory will be limited to 64MB or 16MB depending on
607a675c0c6SBruce Evans# the BIOS.  The amount is in kilobytes, so for a machine with 128MB of
608a675c0c6SBruce Evans# RAM, it would be 131072 (128 * 1024).
609b2796687SNate Williams#
6103339606dSAndreas Schulz# TUNE_1542 enables the automatic ISA bus speed selection for the
6113339606dSAndreas Schulz# Adaptec 1542 boards. Does not work for all boards, use it with caution.
6123339606dSAndreas Schulz#
6135eb46edfSDavid Greenman# BROKEN_KEYBOARD_RESET disables the use of the keyboard controller to
6145eb46edfSDavid Greenman# reset the CPU for reboot.  This is needed on some systems with broken
6155eb46edfSDavid Greenman# keyboard controllers.
6163eafdedeSBruce Evans#
61777959e8eSMarc G. Fournier# PAS_JOYSTICK_ENABLE enables the gameport on the ProAudio Spectrum
61877959e8eSMarc G. Fournier
619d72ee36fSBruce Evansoptions		"AUTO_EOI_1"
6209ba0e7c3SBruce Evans#options	"AUTO_EOI_2"
6216a8d6623SGarrett Wollmanoptions		BOUNCE_BUFFERS
622a675c0c6SBruce Evansoptions		"MAXMEM=(128*1024)"
623b6b8f81eSAndrey A. Chernov#options        "TUNE_1542"
624b1529bdaSPeter Wemm#options	BROKEN_KEYBOARD_RESET
62577959e8eSMarc G. Fournier#options	PAS_JOYSTICK_ENABLE
6263af6b652SDavid Greenman
6274530be52SJordan K. Hubbard# Enable this and PCVT_FREEBSD for pcvt vt220 compatible console driver
6287fbcd76bSBruce Evansdevice		vt0	at isa? port "IO_KBD" tty irq 1 vector pcrint
629b1529bdaSPeter Wemmoptions		PCVT_FREEBSD=210	# pcvt running on FreeBSD >= 2.0.5
630818de095SJordan K. Hubbardoptions		XSERVER			# support for running an X server.
6317fbcd76bSBruce Evansoptions		FAT_CURSOR		# start with block cursor
632e9aaac99SNate Williams# This PCVT option is for keyboards such as those used on IBM ThinkPad laptops
633b1529bdaSPeter Wemmoptions		PCVT_SCANSET=2 		# IBM keyboards are non-std
6344530be52SJordan K. Hubbard
6354530be52SJordan K. Hubbard# The syscons console driver (sco color console compatible) - default.
6366a8d6623SGarrett Wollmandevice		sc0	at isa? port "IO_KBD" tty irq 1 vector scintr
637683cbdf4SBruce Evansoptions		MAXCONS=16		# number of virtual consoles
638683cbdf4SBruce Evansoptions		SLOW_VGA		# do byte-wide i/o's to TS and GDC regs
63938d8a113SPoul-Henning Kampoptions		"STD8X16FONT"		# Compile font in
64038d8a113SPoul-Henning Kampmakeoptions	"STD8X16FONT"="cp850"
6416620cf78SNate Williams
6426620cf78SNate Williams#
6436620cf78SNate Williams# `flags' for sc0:
6446620cf78SNate Williams#       0x01    Use a 'visual' bell
6456620cf78SNate Williams#       0x02    Use a 'blink' cursor
6465d3b1465SKazutaka YOKOTA#       0x04    Use a 'underline' cursor
6475d3b1465SKazutaka YOKOTA#       0x06    Use a 'blinking underline' (destructive) cursor
6486620cf78SNate Williams#       0x08    Force detection of keyboard, else we always assume a keyboard
6496620cf78SNate Williams#       0x10    Old-style (XT) keyboard support, useful for older ThinkPads
6505d3b1465SKazutaka YOKOTA#       0x20    Don't reset keyboard, useful for some newer ThinkPads
6512ac8be82SAndreas Schulz
6526a8d6623SGarrett Wollman#
65325292acbSBruce Evans# The Numeric Processing eXtension driver.  This should be configured if
65425292acbSBruce Evans# your machine has a math co-processor, unless the coprocessor is very
65525292acbSBruce Evans# buggy. If it is not configured then you *must* configure math emulation
65625292acbSBruce Evans# (see above).  If both npx0 and emulation are configured, then only npx0
65725292acbSBruce Evans# is used (provided it works).
6581fe04850SBruce Evansdevice		npx0	at isa? port "IO_NPX" iosiz 0x0 flags 0x0 irq 13 vector npxintr
6591fe04850SBruce Evans
66098e9e66cSNate Williams#
6611fe04850SBruce Evans# `flags' for npx0:
6621fe04850SBruce Evans#	0x01	don't use the npx registers to optimize bcopy
6631fe04850SBruce Evans#	0x02	don't use the npx registers to optimize bzero
6641fe04850SBruce Evans#	0x04	don't use the npx registers to optimize copyin or copyout.
6651fe04850SBruce Evans# The npx registers are normally used to optimize copying and zeroing when
6661fe04850SBruce Evans# all of the following conditions are satisfied:
6671fe04850SBruce Evans#	"I586_CPU" is an option
6681fe04850SBruce Evans#	the cpu is an i586 (perhaps not a Pentium)
6691fe04850SBruce Evans#	the probe for npx0 succeeds
6701fe04850SBruce Evans#	INT 16 exception handling works.
6711fe04850SBruce Evans# Then copying and zeroing using the npx registers is normally 30-100% faster.
6721fe04850SBruce Evans# The flags can be used to control cases where it doesn't work or is slower.
6731fe04850SBruce Evans# Setting them at boot time using userconfig works right (the optimizations
6741fe04850SBruce Evans# are not used until later in the bootstrap when npx0 is attached).
6751fe04850SBruce Evans#
6761fe04850SBruce Evans
6771fe04850SBruce Evans#
6781fe04850SBruce Evans# `iosiz' for npx0:
6791fe04850SBruce Evans# This can be used instead of the MAXMEM option to set the memory size.  If
6801fe04850SBruce Evans# it is nonzero, then it overrides both the MAXMEM option and the memory
6811fe04850SBruce Evans# size reported by the BIOS.  Setting it at boot time using userconfig takes
6821fe04850SBruce Evans# effect on the next reboot after the change has been recorded in the kernel
6831fe04850SBruce Evans# binary (the size is used early in the boot before userconfig has a chance
6841fe04850SBruce Evans# to change it).
6851fe04850SBruce Evans#
6866a8d6623SGarrett Wollman
6876a8d6623SGarrett Wollman#
6886a8d6623SGarrett Wollman# Optional ISA and EISA devices:
6896a8d6623SGarrett Wollman#
6906a8d6623SGarrett Wollman
6916a8d6623SGarrett Wollman#
692e56e7036SJustin T. Gibbs# SCSI host adapters: `aha', `aic', `bt', `nca'
6936a8d6623SGarrett Wollman#
6946a8d6623SGarrett Wollman# aha: Adaptec 154x
6959829c3edSJordan K. Hubbard# ahc: Adaptec 274x/284x/294x
6966a8d6623SGarrett Wollman# aic: Adaptec 152x and sound cards using the Adaptec AIC-6360 (slow!)
6976a8d6623SGarrett Wollman# bt: Most Buslogic controllers
698e05407d8SPoul-Henning Kamp# nca: ProAudioSpectrum cards using the NCR 5380 or Trantor T130
6996a8d6623SGarrett Wollman# uha: UltraStore 14F and 34F
7003c43212aSSøren Schmidt# sea: Seagate ST01/02 8 bit controller (slow!)
7013691d2b9SJordan K. Hubbard# wds: Western Digital WD7000 controller (no scatter/gather!).
7026a8d6623SGarrett Wollman#
7036a8d6623SGarrett Wollman# Note that the order is important in order for Buslogic cards to be
7046a8d6623SGarrett Wollman# probed correctly.
7056a8d6623SGarrett Wollman#
7066a8d6623SGarrett Wollman
707a1d01dafSJustin T. Gibbscontroller	bt0	at isa? port "IO_BT0" bio irq ? vector bt_isa_intr
7086a8d6623SGarrett Wollmancontroller	aha0	at isa? port "IO_AHA0" bio irq ? drq 5 vector ahaintr
7096a8d6623SGarrett Wollmancontroller	uha0	at isa? port "IO_UHA0" bio irq ? drq 5 vector uhaintr
7106a8d6623SGarrett Wollman
7116a8d6623SGarrett Wollmancontroller      aic0    at isa? port 0x340 bio irq 11 vector aicintr
712e05407d8SPoul-Henning Kampcontroller	nca0	at isa? port 0x1f88 bio irq 10 vector ncaintr
713e05407d8SPoul-Henning Kampcontroller	nca1	at isa? port 0x1f84
714e05407d8SPoul-Henning Kampcontroller	nca2	at isa? port 0x1f8c
715e05407d8SPoul-Henning Kampcontroller	nca3	at isa? port 0x1e88
716e05407d8SPoul-Henning Kampcontroller	nca4	at isa? port 0x350 bio irq 5 vector ncaintr
71745b4c36fSJordan K. Hubbard
7183c43212aSSøren Schmidtcontroller	sea0	at isa? bio irq 5 iomem 0xdc000 iosiz 0x2000 vector seaintr
7193691d2b9SJordan K. Hubbardcontroller	wds0	at isa? port 0x350 bio irq 15 drq 6 vector wdsintr
7203c43212aSSøren Schmidt
7216a8d6623SGarrett Wollman#
7226a8d6623SGarrett Wollman# ST-506, ESDI, and IDE hard disks: `wdc' and `wd'
7236a8d6623SGarrett Wollman#
7246a8d6623SGarrett Wollman# NB: ``Enhanced IDE'' is NOT supported at this time.
7256a8d6623SGarrett Wollman#
726e3dd3158SJohn Dyson# The flags fields are used to enable the multi-sector I/O and
727e3dd3158SJohn Dyson# the 32BIT I/O modes.  The flags may be used in either the controller
728e3dd3158SJohn Dyson# definition or in the individual disk definitions.  The controller
729e3dd3158SJohn Dyson# definition is supported for the boot configuration stuff.
730e3dd3158SJohn Dyson#
731e3dd3158SJohn Dyson# Each drive has a 16 bit flags value defined:
732e3dd3158SJohn Dyson#	The low 8 bits are the maximum value for the multi-sector I/O,
733e3dd3158SJohn Dyson#	where 0xff defaults to the maximum that the drive can handle.
734e3dd3158SJohn Dyson#	The high bit of the 16 bit flags (0x8000) allows probing for
735e3dd3158SJohn Dyson#	32 bit transfers.
736e3dd3158SJohn Dyson#
737e3dd3158SJohn Dyson# The flags field for the drives can be specified in the controller
738e3dd3158SJohn Dyson# specification with the low 16 bits for drive 0, and the high 16 bits
739e3dd3158SJohn Dyson# for drive 1.
740e3dd3158SJohn Dyson# e.g.:
741e3dd3158SJohn Dyson#controller	wdc0	at isa? port "IO_WD1" bio irq 14 flags 0x00ff8004 vector wdintr
742e3dd3158SJohn Dyson#
743e3dd3158SJohn Dyson# specifies that drive 0 will be allowed to probe for 32 bit transfers and
744e3dd3158SJohn Dyson# a maximum multi-sector transfer of 4 sectors, and drive 1 will not be
745e3dd3158SJohn Dyson# allowed to probe for 32 bit transfers, but will allow multi-sector
746e3dd3158SJohn Dyson# transfers up to the maximum that the drive supports.
747e3dd3158SJohn Dyson#
748e3dd3158SJohn Dyson
749e3dd3158SJohn Dyson#
7502620c42eSNate Williamscontroller	wdc0	at isa? port "IO_WD1" bio irq 14 vector wdintr
7512620c42eSNate Williamsdisk		wd0	at wdc0 drive 0
7522620c42eSNate Williamsdisk		wd1	at wdc0 drive 1
7532620c42eSNate Williamscontroller	wdc1	at isa? port "IO_WD2" bio irq 15 vector wdintr
7542620c42eSNate Williamsdisk		wd2	at wdc1 drive 0
7552620c42eSNate Williamsdisk		wd3	at wdc1 drive 1
7562365e64fSRodney W. Grimes
7576a8d6623SGarrett Wollman#
7586788ce49SJordan K. Hubbard# Options for `wdc':
7596788ce49SJordan K. Hubbard#
7602928e6b5SStefan Eßer# CMD640 enables serializing access to primary and secondary channel
7612928e6b5SStefan Eßer# of the CMD640B IDE Chip. The serializing will only take place
7622928e6b5SStefan Eßer# if this option is set *and* the chip is probed by the pci-system.
7632928e6b5SStefan Eßer#
7642928e6b5SStefan Eßeroptions         "CMD640"	#Enable work around for CMD640 h/w bug
7652928e6b5SStefan Eßer#
7666788ce49SJordan K. Hubbard# ATAPI enables the support for ATAPI-compatible IDE devices
7676788ce49SJordan K. Hubbard#
7686788ce49SJordan K. Hubbardoptions         ATAPI   #Enable ATAPI support for IDE bus
7697b2305f7SAndrey A. Chernovoptions		ATAPI_STATIC	#Don't do it as an LKM
7706788ce49SJordan K. Hubbard
7716788ce49SJordan K. Hubbard# IDE CD-ROM driver - requires wdc controller and ATAPI option
7726788ce49SJordan K. Hubbarddevice          wcd0
7736788ce49SJordan K. Hubbard
7746788ce49SJordan K. Hubbard#
7756a8d6623SGarrett Wollman# Standard floppy disk controllers and floppy tapes: `fdc', `fd', and `ft'
7766a8d6623SGarrett Wollman#
7776a8d6623SGarrett Wollmancontroller	fdc0	at isa? port "IO_FD1" bio irq 6 drq 2 vector fdintr
77885827d9cSJoerg Wunsch#
77985827d9cSJoerg Wunsch# Activate this line instead of the fdc0 line above if you happen to
78085827d9cSJoerg Wunsch# have an Insight floppy tape.  Probing them proved to be dangerous
78185827d9cSJoerg Wunsch# for people with floppy disks only, so it's "hidden" behind a flag:
78285827d9cSJoerg Wunsch#controller fdc0 at isa? port "IO_FD1" bio flags 1 irq 6 drq 2 vector fdintr
78385827d9cSJoerg Wunsch
7846a8d6623SGarrett Wollmandisk		fd0	at fdc0 drive 0
7856a8d6623SGarrett Wollmandisk		fd1	at fdc0 drive 1
7866a8d6623SGarrett Wollmantape		ft0	at fdc0 drive 2
7876a8d6623SGarrett Wollman
78885827d9cSJoerg Wunsch
7896a8d6623SGarrett Wollman#
790d29895dcSGarrett Wollman# Options for `fd':
79195b926abSJoerg Wunsch#
792d29895dcSGarrett Wollman# FDSEEKWAIT selects a non-default head-settle time (i.e., the time to
793d29895dcSGarrett Wollman# wait after a seek is performed).  The default value (1/32 s) is
794d29895dcSGarrett Wollman# usually sufficient.  The units are inverse seconds, so a value of 16
795d29895dcSGarrett Wollman# here means to wait 1/16th of a second; you should choose a power of
796d29895dcSGarrett Wollman# two.
797b1529bdaSPeter Wemm# XXX: this seems to be missing!
798b1529bdaSPeter Wemmoptions	FDSEEKWAIT=16
79995b926abSJoerg Wunsch
80095b926abSJoerg Wunsch#
8012f6df264SJordan K. Hubbard# Other standard PC hardware: `lpt', `mse', `psm', `sio', etc.
8026a8d6623SGarrett Wollman#
8036a8d6623SGarrett Wollman# lpt: printer port
8047fe369dcSJoerg Wunsch#	lpt specials:
8057fe369dcSJoerg Wunsch#		port can be specified as ?, this will cause the driver to scan
8067fe369dcSJoerg Wunsch#		the BIOS port list;
8077fe369dcSJoerg Wunsch#		the irq and vector clauses may be omitted, this
8087fe369dcSJoerg Wunsch#		will force the port into polling mode.
8096a8d6623SGarrett Wollman# mse: Logitech and ATI InPort bus mouse ports
8109cc34748SJordan K. Hubbard# psm: PS/2 mouse port [note: conflicts with sc0/vt0, thus "conflicts" keywd]
8116a8d6623SGarrett Wollman# sio: serial ports (see sio(4))
8126a8d6623SGarrett Wollman
8137fe369dcSJoerg Wunschdevice		lpt0	at isa? port? tty irq 7 vector lptintr
8147fe369dcSJoerg Wunschdevice		lpt1	at isa? port "IO_LPT3" tty irq 5 vector lptintr
8156a8d6623SGarrett Wollmandevice		mse0	at isa? port 0x23c tty irq 5 vector mseintr
8169cc34748SJordan K. Hubbarddevice		psm0	at isa? port "IO_KBD" conflicts tty irq 12 vector psmintr
817975c53c7SDoug Rabson# Options for psm:
81850c193ebSKazutaka YOKOTAoptions		PSM_CHECKSYNC		#checks the header byte for sync.
8195d3b1465SKazutaka YOKOTAoptions		PSM_HOOKAPM		#hook the APM resume event, useful
8205d3b1465SKazutaka YOKOTA					#for some laptops
8215d3b1465SKazutaka YOKOTAoptions		PSM_RESETAFTERSUSPEND	#reset the device at the resume event
822975c53c7SDoug Rabson
8239546766aSBruce Evansdevice		sio0	at isa? port "IO_COM1" tty flags 0x10 irq 4 vector siointr
8249546766aSBruce Evans
8259546766aSBruce Evans#
8269546766aSBruce Evans# `flags' for serial drivers that support consoles (only for sio now):
8279546766aSBruce Evans#	0x10	enable console support for this unit.  The other console flags
8289546766aSBruce Evans#		are ignored unless this is set.  Enabling console support does
8299546766aSBruce Evans#		not make the unit the preferred console - boot with -h or set
8309546766aSBruce Evans#		the 0x20 flag for that.  Currently, at most one unit can have
8319546766aSBruce Evans#		console support; the first one (in config file order) with
8329546766aSBruce Evans#		this flag set is preferred.  Setting this flag for sio0 gives
8339546766aSBruce Evans#		the old behaviour.
8349546766aSBruce Evans#	0x20	force this unit to be the console (unless there is another
8359546766aSBruce Evans#		higher priority console).  This replaces the COMCONSOLE option.
8369546766aSBruce Evans#	0x40	reserve this unit for low level console operations.  Do not
8379546766aSBruce Evans#
8389546766aSBruce Evans
8399546766aSBruce Evans# Options for serial drivers that support consoles (only for sio now):
8409546766aSBruce Evansoptions		BREAK_TO_DEBUGGER	#a BREAK on a comconsole goes to
8419546766aSBruce Evans					#DDB, if available.
8425ea6cb03SPaul Trainaoptions		CONSPEED=9600		#default speed for serial console (default 9600)
8436a8d6623SGarrett Wollman
8446a8d6623SGarrett Wollman# Options for sio:
845768fd661SBruce Evansoptions		COM_ESP			#code for Hayes ESP
8469ba0e7c3SBruce Evansoptions		COM_MULTIPORT		#code for some cards with shared IRQs
8476a8d6623SGarrett Wollmanoptions		DSI_SOFT_MODEM		#code for DSI Softmodems
8486a8d6623SGarrett Wollman
84996b89afcSBruce Evans# Other flags for sio that aren't documented in the man page.
85096b89afcSBruce Evans#	0x20000	enable hardware RTS/CTS and larger FIFOs.  Only works for
85196b89afcSBruce Evans#		ST16650A-compatible UARTs.
85296b89afcSBruce Evans
8536a8d6623SGarrett Wollman#
85483401efaSGarrett Wollman# Network interfaces: `cx', `ed', `el', `ep', `ie', `is', `le', `lnc'
8556a8d6623SGarrett Wollman#
8566c5e9bbdSMike Pritchard# ar: Arnet SYNC/570i hdlc sync 2/4 port V.35/X.21 serial driver (requires sppp)
85783401efaSGarrett Wollman# cx: Cronyx/Sigma multiport sync/async (with Cisco or PPP framing)
8586a8d6623SGarrett Wollman# ed: Western Digital and SMC 80xx; Novell NE1000 and NE2000; 3Com 3C503
8596a8d6623SGarrett Wollman# el: 3Com 3C501 (slow!)
8606a8d6623SGarrett Wollman# ep: 3Com 3C509 (buggy)
8611a7c583cSGarrett Wollman# fe: Fujitsu MB86960A/MB86965A Ethernet
8626a8d6623SGarrett Wollman# ie: AT&T StarLAN 10 and EN100; 3Com 3C507; unknown NI5210
8636a8d6623SGarrett Wollman# le: Digital Equipment EtherWorks 2 and EtherWorks 3 (DEPCA, DE100,
8646a8d6623SGarrett Wollman#     DE101, DE200, DE201, DE202, DE203, DE204, DE205, DE422)
86594187a78SPaul Richards# lnc: Lance/PCnet cards (Isolan, Novell NE2100, NE32-VL)
866d805b866SJohn Hay# sr: RISCom/N2 hdlc sync 1/2 port V.35/X.21 serial driver (requires sppp)
86798d46ad0SMike Smith# wl: Lucent Wavelan (ISA card only).
868648c711bSPoul-Henning Kamp# ze: IBM/National Semiconductor PCMCIA ethernet controller.
869648c711bSPoul-Henning Kamp# zp: 3Com PCMCIA Etherlink III (It does not require shared memory for
870648c711bSPoul-Henning Kamp#     send/receive operation, but it needs 'iomem' to read/write the
871648c711bSPoul-Henning Kamp#     attribute memory)
8726a8d6623SGarrett Wollman#
8736a8d6623SGarrett Wollman
874e7c234a1SPeter Wemmdevice ar0 at isa? port 0x300 net irq 10 iomem 0xd0000 vector arintr
87583401efaSGarrett Wollmandevice cx0 at isa? port 0x240 net irq 15 drq 7 vector cxintr
8766a8d6623SGarrett Wollmandevice ed0 at isa? port 0x280 net irq 5 iomem 0xd8000 vector edintr
87712cfa436SPoul-Henning Kampdevice eg0 at isa? port 0x310 net irq 5 vector egintr
8786a8d6623SGarrett Wollmandevice el0 at isa? port 0x300 net irq 9 vector elintr
879d41f24e7SDavid Greenmandevice ep0 at isa? port 0x300 net irq 10 vector epintr
8800942673fSJordan K. Hubbarddevice ex0 at isa? port? net irq? vector exintr
881a732b754SJordan K. Hubbarddevice fe0 at isa? port 0x300 net irq ? vector feintr
882c1aa7eb5SJustin T. Gibbsdevice ie0 at isa? port 0x300 net irq 5 iomem 0xd0000 vector ieintr
883c1aa7eb5SJustin T. Gibbsdevice ie1 at isa? port 0x360 net irq 7 iomem 0xd0000 vector ieintr
8846a8d6623SGarrett Wollmandevice le0 at isa? port 0x300 net irq 5 iomem 0xd0000 vector le_intr
88563373752SPoul-Henning Kampdevice lnc0 at isa? port 0x300 net irq 10 drq 0 vector lncintr
886d805b866SJohn Haydevice sr0 at isa? port 0x300 net irq 5 iomem 0xd0000 vector srintr
8872321ce34SPeter Wemmdevice wl0 at isa? port 0x300 net irq ? vector wlintr
888ec0ae37dSNate Williams# Needed so that we can (bogusly) include both the dedicated PCCARD
889ec0ae37dSNate Williams# drivers and the generic support
890ec0ae37dSNate Williamsoptions	LINT_PCCARD_HACK
891ada9d061SJordan K. Hubbarddevice ze0 at isa? port 0x300 net irq 5 iomem 0xd8000 vector zeintr
892648c711bSPoul-Henning Kampdevice zp0 at isa? port 0x300 net irq 10 iomem 0xd8000 vector zpintr
893648c711bSPoul-Henning Kamp
89468713f97SKenjiro Cho#
89568713f97SKenjiro Cho# ATM related options
89668713f97SKenjiro Cho#
89768713f97SKenjiro Cho# The `en' device provides support for Efficient Networks (ENI)
89868713f97SKenjiro Cho# ENI-155 PCI midway cards, and the Adaptec 155Mbps PCI ATM cards (ANA-59x0).
89968713f97SKenjiro Cho#
9003cbceb82SKenjiro Cho# atm pseudo-device provides generic atm functions and is required for
90168713f97SKenjiro Cho# atm devices.
9023cbceb82SKenjiro Cho# NATM enables the netnatm protocol family that can be used to
90368713f97SKenjiro Cho# bypass TCP/IP.
90468713f97SKenjiro Cho#
90568713f97SKenjiro Cho# the current driver supports only PVC operations (no atm-arp, no multicast).
90668713f97SKenjiro Cho# for more details, please read the original documents at
90768713f97SKenjiro Cho# http://www.ccrc.wustl.edu/pub/chuck/bsdatm/wucs.html
90868713f97SKenjiro Cho#
90968713f97SKenjiro Chopseudo-device	atm
91068713f97SKenjiro Chodevice en0
91168713f97SKenjiro Chodevice en1
9123cbceb82SKenjiro Chooptions		NATM			#native ATM
913f4567b9cSJulian Elischer
9141a7c583cSGarrett Wollman#
9151a7c583cSGarrett Wollman# Audio drivers: `snd', `sb', `pas', `gus', `pca'
9166a8d6623SGarrett Wollman#
9171a7c583cSGarrett Wollman# snd: Voxware sound support code
9181a7c583cSGarrett Wollman# sb: SoundBlaster PCM - SoundBlaster, SB Pro, SB16, ProAudioSpectrum
9191a7c583cSGarrett Wollman# sbxvi: SoundBlaster 16
9201a7c583cSGarrett Wollman# sbmidi: SoundBlaster 16 MIDI interface
9211a7c583cSGarrett Wollman# pas: ProAudioSpectrum PCM and MIDI
9221a7c583cSGarrett Wollman# gus: Gravis Ultrasound - Ultrasound, Ultrasound 16, Ultrasound MAX
923a2048b9cSJordan K. Hubbard# gusxvi: Gravis Ultrasound 16-bit PCM	(do not use)
9241a7c583cSGarrett Wollman# mss: Microsoft Sound System
9251a7c583cSGarrett Wollman# opl: Yamaha OPL-2 and OPL-3 FM - SB, SB Pro, SB 16, ProAudioSpectrum
9261a7c583cSGarrett Wollman# uart: stand-alone 6850 UART for MIDI
9271a7c583cSGarrett Wollman# mpu: Roland MPU-401 stand-alone card
9281a7c583cSGarrett Wollman#
9291a7c583cSGarrett Wollman# Beware!  The addresses specified below are also hard-coded in
9301a7c583cSGarrett Wollman# i386/isa/sound/sound_config.h.  If you change the values here, you
9311a7c583cSGarrett Wollman# must also change the values in the include file.
9321a7c583cSGarrett Wollman#
9336a8d6623SGarrett Wollman# pca: PCM audio through your PC speaker
9346a8d6623SGarrett Wollman#
9359cc34748SJordan K. Hubbard# If you don't have a lpt0 device at IRQ 7, you can remove the
9369cc34748SJordan K. Hubbard# ``conflicts'' specification in the appropriate device entries below.
9379cc34748SJordan K. Hubbard#
938d1a599c2SJordan K. Hubbard# If you have a GUS-MAX card and want to use the CS4231 codec on the
939d1a599c2SJordan K. Hubbard# card the drqs for the gus max must be 8 bit (1, 2, or 3).
940d1a599c2SJordan K. Hubbard#
941d1a599c2SJordan K. Hubbard# If you would like to use the full duplex option on the gus, then define
942d1a599c2SJordan K. Hubbard# flags to be the ``read dma channel''.
943d1a599c2SJordan K. Hubbard#
944d1a599c2SJordan K. Hubbard# options BROKEN_BUS_CLOCK	#PAS-16 isn't working and OPTI chipset
945d1a599c2SJordan K. Hubbard# options SYMPHONY_PAS		#PAS-16 isn't working and SYMPHONY chipset
946d1a599c2SJordan K. Hubbard# options EXCLUDE_SBPRO		#PAS-16
947b1529bdaSPeter Wemm# options SBC_IRQ=5		#PAS-16. Must match irq on sb0 line.
948d1a599c2SJordan K. Hubbard# PAS16: The order of the pas0/sb0/opl0 is important since the
949d1a599c2SJordan K. Hubbard#	sb emulation is enabled in the pas-16 attach.
950d1a599c2SJordan K. Hubbard#
951d1a599c2SJordan K. Hubbard# The i386/isa/sound/sound.doc has more information.
952a2048b9cSJordan K. Hubbard
95312fd0853SSteven Wallace# Controls all sound devices
95412fd0853SSteven Wallacecontroller	snd0
955d1a599c2SJordan K. Hubbarddevice pas0     at isa? port 0x388 irq 10 drq 6 vector pasintr
95629a4cf6dSAndrey A. Chernovdevice sb0      at isa? port 0x220 irq 5 drq 1 vector sbintr
95729a4cf6dSAndrey A. Chernovdevice sbxvi0   at isa? drq 5
95829a4cf6dSAndrey A. Chernovdevice sbmidi0  at isa? port 0x330
95929a4cf6dSAndrey A. Chernovdevice awe0     at isa? port 0x620
9608e411548SJordan K. Hubbarddevice gus0 at isa? port 0x220 irq 12 drq 1 vector gusintr
9618e411548SJordan K. Hubbard#device gus0 at isa? port 0x220 irq 12 drq 1 flags 0x3 vector gusintr
96212fd0853SSteven Wallacedevice mss0 at isa? port 0x530 irq 10 drq 1 vector adintr
96329a4cf6dSAndrey A. Chernovdevice opl0     at isa? port 0x388
964a91ccb55SSteven Wallacedevice mpu0     at isa? port 0x330 irq 6 drq 0
96512fd0853SSteven Wallacedevice uart0 at isa? port 0x330 irq 5 vector "m6850intr"
9660897a95dSAndrey A. Chernov
96765e8111fSBruce Evans# More undocumented sound devices with bogus configurations for linting.
96865e8111fSBruce Evans# broken
96965e8111fSBruce Evans#device sscape0  at isa? port 0x330 irq 6 drq 0
97065e8111fSBruce Evans#device trix0    at isa? port 0x330 irq 6 drq 0 vector sscapeintr
97165e8111fSBruce Evans
9721a7c583cSGarrett Wollman# Not controlled by `snd'
973017e602cSAndrey A. Chernovdevice pca0 at isa? port IO_TIMER1 tty
9749ad380abSGarrett Wollman
9756a8d6623SGarrett Wollman#
976567e21c2SBruce Evans# Miscellaneous hardware:
9776a8d6623SGarrett Wollman#
9786a8d6623SGarrett Wollman# mcd: Mitsumi CD-ROM
9792d859864SAndreas Schulz# scd: Sony CD-ROM
98005e1d9d4SJordan K. Hubbard# matcd: Matsushita/Panasonic CD-ROM
9816a8d6623SGarrett Wollman# wt: Wangtek and Archive QIC-02/QIC-36 tape drives
9826a8d6623SGarrett Wollman# ctx: Cortex-I frame grabber
9836a8d6623SGarrett Wollman# apm: Laptop Advanced Power Management (experimental)
9846c5e9bbdSMike Pritchard# spigot: The Creative Labs Video Spigot video-acquisition board
9851d86961eSJordan K. Hubbard# meteor: Matrox Meteor video capture board
9866baab376SJohn-Mark Gurney# bktr: Bt848 capture boards (http://www.freebsd.org/~fsmp/HomeAuto/Bt848.html)
98765e8111fSBruce Evans# cy: Cyclades serial driver
988a50cd483SJordan K. Hubbard# dgb: Digiboard PC/Xi and PC/Xe series driver (ALPHA QUALITY!)
9891a7c583cSGarrett Wollman# gp:  National Instruments AT-GPIB and AT-GPIB/TNT board
990a800f455SJulian Elischer# asc: GI1904-based hand scanners, e.g. the Trust Amiscan Grey
9911a7c583cSGarrett Wollman# gsc: Genius GS-4500 hand scanner.
9921a7c583cSGarrett Wollman# joy: joystick
993657e73c4SPeter Dufault# labpc: National Instrument's Lab-PC and Lab-PC+
994d0930614SAndrey A. Chernov# rc: RISCom/8 multiport card
995567e21c2SBruce Evans# tw: TW-523 power line interface for use with X-10 home control products
9960d04cf6aSPeter Wemm# si: Specialix SI/XIO 4-32 port terminal multiplexor
997c9da1b81SPeter Wemm# stl: Stallion EasyIO and EasyConnection 8/32 (cd1400 based)
998c9da1b81SPeter Wemm# stli: Stallion EasyConnection 8/64, ONboard, Brumby (intelligent)
999657e73c4SPeter Dufault
10006a8d6623SGarrett Wollman#
1001e597b497SNate Williams# Notes on APM
10023d4d8fe9SPoul-Henning Kamp#  The flags takes the following meaning for apm0:
10033d4d8fe9SPoul-Henning Kamp#    0x0020  Statclock is broken.
10043d4d8fe9SPoul-Henning Kamp#    0x0011  Limit APM protocol to 1.1 or 1.0
10053d4d8fe9SPoul-Henning Kamp#    0x0010  Limit APM protocol to 1.0
1006e597b497SNate Williams#
1007e597b497SNate Williams#
10082cd01159SJordan K. Hubbard# Notes on the spigot:
10092cd01159SJordan K. Hubbard#  The video spigot is at 0xad6.  This port address can not be changed.
10102cd01159SJordan K. Hubbard#  The irq values may only be 10, 11, or 15
10112cd01159SJordan K. Hubbard#  I/O memory is an 8kb region.  Possible values are:
10122cd01159SJordan K. Hubbard#    0a0000, 0a2000, ..., 0fffff, f00000, f02000, ..., ffffff
1013d01b6680SJordan K. Hubbard#    The start address must be on an even boundary.
1014d01b6680SJordan K. Hubbard#  Add the following option if you want to allow non-root users to be able
1015d01b6680SJordan K. Hubbard#  to access the spigot.  This option is not secure because it allows users
1016d01b6680SJordan K. Hubbard#  direct access to the I/O page.
1017d01b6680SJordan K. Hubbard#  	options SPIGOT_UNSECURE
1018d01b6680SJordan K. Hubbard#
10198819d6ecSPoul-Henning Kamp
1020a50cd483SJordan K. Hubbard# Notes on the Digiboard driver:
1021a50cd483SJordan K. Hubbard#
1022a50cd483SJordan K. Hubbard# The following flag values have special meanings:
1023a50cd483SJordan K. Hubbard#	0x01 - alternate layout of pins
1024a50cd483SJordan K. Hubbard#	0x02 - use the windowed PC/Xe in 64K mode
10250d04cf6aSPeter Wemm
10260d04cf6aSPeter Wemm# Notes on the Specialix SI/XIO driver:
1027c4823710SPeter Wemm#  **This is NOT a Specialix supported Driver!**
1028c4823710SPeter Wemm#  The host card is memory, not IO mapped.
1029c4823710SPeter Wemm#  The Rev 1 host cards use a 64K chunk, on a 32K boundary.
1030c4823710SPeter Wemm#  The Rev 2 host cards use a 32K chunk, on a 32K boundary.
1031c4823710SPeter Wemm#  The cards can use an IRQ of 11, 12 or 15.
1032c4823710SPeter Wemm
1033c9da1b81SPeter Wemm# Notes on the Stallion stl and stli drivers:
1034c9da1b81SPeter Wemm#  See src/i386/isa/README.stl for complete instructions.
1035c9da1b81SPeter Wemm#  This is version 0.0.5alpha, unsupported by Stallion.
1036c9da1b81SPeter Wemm#  The stl driver has a secondary IO port hard coded at 0x280.  You need
1037c9da1b81SPeter Wemm#     to change src/i386/isa/stallion.c if you reconfigure this on the boards.
1038c9da1b81SPeter Wemm#  The "flags" and "iosiz" settings on the stli driver depend on the board:
1039c9da1b81SPeter Wemm#	EasyConnection 8/64 ISA:     flags 23         iosiz 0x1000
1040c9da1b81SPeter Wemm#	EasyConnection 8/64 EISA:    flags 24         iosiz 0x10000
1041c9da1b81SPeter Wemm#	EasyConnection 8/64 MCA:     flags 25         iosiz 0x1000
1042c9da1b81SPeter Wemm#	ONboard ISA:                 flags 4          iosiz 0x10000
1043c9da1b81SPeter Wemm#	ONboard EISA:                flags 7          iosiz 0x10000
1044c9da1b81SPeter Wemm#	ONboard MCA:                 flags 3          iosiz 0x10000
1045c9da1b81SPeter Wemm#	Brumby:                      flags 2          iosiz 0x4000
1046c9da1b81SPeter Wemm#	Stallion:                    flags 1          iosiz 0x10000
1047c9da1b81SPeter Wemm
10486a8d6623SGarrett Wollmandevice		mcd0	at isa? port 0x300 bio irq 10 vector mcdintr
104905e1d9d4SJordan K. Hubbard# for the Sony CDU31/33A CDROM
10502d859864SAndreas Schulzdevice		scd0	at isa? port 0x230 bio
10516c5e9bbdSMike Pritchard# for the SoundBlaster 16 multicd - up to 4 devices
10529720b084SJordan K. Hubbardcontroller      matcd0  at isa? port 0x230 bio
10536a8d6623SGarrett Wollmandevice		wt0	at isa? port 0x300 bio irq 5 drq 1 vector wtintr
10546a8d6623SGarrett Wollmandevice		ctx0	at isa? port 0x230 iomem 0xd0000
10552cd01159SJordan K. Hubbarddevice		spigot0 at isa? port 0xad6 irq 15 iomem 0xee000 vector spigintr
10564cf62360SPaul Trainadevice		qcam0	at isa? port "IO_LPT3" tty
10576a8d6623SGarrett Wollmandevice		apm0	at isa?
10581a7c583cSGarrett Wollmandevice		gp0	at isa? port 0x2c0 tty
10591a7c583cSGarrett Wollmandevice		gsc0	at isa? port "IO_GSC1" tty drq 3
10601a7c583cSGarrett Wollmandevice		joy0	at isa? port "IO_GAME"
106165e8111fSBruce Evansdevice		cy0	at isa? tty irq 10 iomem 0xd4000 iosiz 0x2000 vector cyintr
1062a50cd483SJordan K. Hubbarddevice		dgb0	at isa? port 0x220 iomem 0xfc0000 iosiz ? tty
1063657e73c4SPeter Dufaultdevice		labpc0	at isa? port 0x260 tty irq 5 vector labpcintr
1064d0930614SAndrey A. Chernovdevice          rc0     at isa? port 0x220 tty irq 12 vector rcintr
1065567e21c2SBruce Evans# the port and irq for tw0 are fictitious
1066567e21c2SBruce Evansdevice          tw0     at isa? port 0x380 tty irq 11 vector twintr
1067c4823710SPeter Wemmdevice		si0	at isa? iomem 0xd0000 tty irq 12 vector siintr
1068a800f455SJulian Elischerdevice		asc0	at isa? port IO_ASC1 tty drq 3 irq 10 vector ascintr
106965e8111fSBruce Evansdevice		bqu0	at isa? port 0x150
1070c9da1b81SPeter Wemmdevice		stl0	at isa? port 0x2a0 tty irq 10 vector stlintr
1071c9da1b81SPeter Wemmdevice		stli0	at isa? port 0x2a0 tty iomem 0xcc000 flags 23 iosiz 0x1000
1072a800f455SJulian Elischer
1073eeb706c0SJustin T. Gibbs#
1074eeb706c0SJustin T. Gibbs# EISA devices:
1075eeb706c0SJustin T. Gibbs#
1076eeb706c0SJustin T. Gibbs# The EISA bus device is eisa0.  It provides auto-detection and
1077eeb706c0SJustin T. Gibbs# configuration support for all devices on the EISA bus.
1078eeb706c0SJustin T. Gibbs#
1079e56e7036SJustin T. Gibbs# The `ahb' device provides support for the Adaptec 174X adapter.
1080e56e7036SJustin T. Gibbs#
1081eeb706c0SJustin T. Gibbs# The `ahc' device provides support for the Adaptec 274X and 284X
1082eeb706c0SJustin T. Gibbs# adapters.  The 284X, although a VLB card responds to EISA probes.
1083eeb706c0SJustin T. Gibbs#
1084c37ddbb8SJoerg Wunsch# fea: DEC DEFEA EISA FDDI adapter
1085c37ddbb8SJoerg Wunsch#
1086eeb706c0SJustin T. Gibbscontroller	eisa0
1087e56e7036SJustin T. Gibbscontroller	ahb0
1088eeb706c0SJustin T. Gibbscontroller	ahc0
1089c37ddbb8SJoerg Wunschdevice		fea0
10906a8d6623SGarrett Wollman
109135846a81SMike Pritchard# enable tagged command queuing, which is a major performance win on
10926e702c99SPaul Traina# devices that support it (and controllers with enough SCB's)
10936e702c99SPaul Trainaoptions	AHC_TAGENABLE
10946e702c99SPaul Traina
10956fb5e0faSJustin T. Gibbs# enable SCB paging - See the ahc.4 man page
10966fb5e0faSJustin T. Gibbsoptions	AHC_SCBPAGING_ENABLE
10976e702c99SPaul Traina
10986fb5e0faSJustin T. Gibbs# The aic7xxx driver will attempt to use memory mapped I/O for all PCI
109911b5ea72SJustin T. Gibbs# controllers that have it configured only if this option is set. Unfortunately,
110011b5ea72SJustin T. Gibbs# this doesn't work on some motherboards, which prevents it from being the
110111b5ea72SJustin T. Gibbs# default.
110211b5ea72SJustin T. Gibbsoptions AHC_ALLOW_MEMIO
11036e702c99SPaul Traina
11041b0d3143SJoerg Wunsch# By default, only 10 EISA slots are probed, since the slot numbers
11051b0d3143SJoerg Wunsch# above clash with the configuration address space of the PCI subsystem,
11061b0d3143SJoerg Wunsch# and the EISA probe is not very smart about this.  This is sufficient
11071b0d3143SJoerg Wunsch# for most machines, but in particular the HP NetServer LC series comes
11081b0d3143SJoerg Wunsch# with an onboard AIC7770 dual-channel SCSI controller on EISA slot #11,
11091b0d3143SJoerg Wunsch# thus you need to bump this figure to 12 for them.
11101b0d3143SJoerg Wunschoptions	"EISA_SLOTS=12"
11111b0d3143SJoerg Wunsch
11126a8d6623SGarrett Wollman#
11136a8d6623SGarrett Wollman# PCI devices:
11146a8d6623SGarrett Wollman#
11156a8d6623SGarrett Wollman# The main PCI bus device is `pci'.  It provides auto-detection and
11166a8d6623SGarrett Wollman# configuration support for all devices on the PCI bus, using either
11176a8d6623SGarrett Wollman# configuration mode defined in the PCI specification.
11186a8d6623SGarrett Wollman#
1119eeb706c0SJustin T. Gibbs# The `ahc' device provides support for the Adaptec 29/3940(U)(W)
1120eeb706c0SJustin T. Gibbs# and motherboard based AIC7870/AIC7880 adapters.
1121eeb706c0SJustin T. Gibbs#
11226a8d6623SGarrett Wollman# The `ncr' device provides support for the NCR 53C810 and 53C825
11236a8d6623SGarrett Wollman# self-contained SCSI host adapters.
11246a8d6623SGarrett Wollman#
1125e69742d7SStefan Eßer# The `amd' device provides support for the Tekram DC-390 and 390T
1126e69742d7SStefan Eßer# SCSI host adapters, but is expected to work with any AMD 53c974
1127e69742d7SStefan Eßer# PCI SCSI chip and the AMD Ethernet+SCSI Combo chip, after some
1128e69742d7SStefan Eßer# local patches were applied to the sources (that had originally
1129e69742d7SStefan Eßer# been written by Tekram and limited to work with their SCSI cards).
1130e69742d7SStefan Eßer#
11316a8d6623SGarrett Wollman# The `de' device provides support for the Digital Equipment DC21040
11326a8d6623SGarrett Wollman# self-contained Ethernet adapter.
11336a8d6623SGarrett Wollman#
113456086e0dSSatoshi Asami# The `fxp' device provides support for the Intel EtherExpress Pro/100B
113556086e0dSSatoshi Asami# PCI Fast Ethernet adapters.
113656086e0dSSatoshi Asami#
11375ccfdea2SAndreas Schulz# The `vx' device provides support for the 3Com 3C590 and 3C595
1138f4567b9cSJulian Elischer# early support
1139f4567b9cSJulian Elischer#
1140d41f24e7SDavid Greenman# The `fpa' device provides support for the Digital DEFPA PCI FDDI
1141d41f24e7SDavid Greenman# adapter. pseudo-device fddi is also needed.
1142d41f24e7SDavid Greenman#
1143bba9a7a0SGarrett Wollman# The `meteor' device is a PCI video capture board. It can also have the
11441d86961eSJordan K. Hubbard# following options:
1145b1529bdaSPeter Wemm#   options METEOR_ALLOC_PAGES=xxx	preallocate kernel pages for data entry
11461d86961eSJordan K. Hubbard#	figure (ROWS*COLUMN*BYTES_PER_PIXEL*FRAME+PAGE_SIZE-1)/PAGE_SIZE
11471d86961eSJordan K. Hubbard#   options METEOR_DEALLOC_PAGES	remove all allocated pages on close(2)
1148b1529bdaSPeter Wemm#   options METEOR_DEALLOC_ABOVE=xxx	remove all allocated pages above the
11491d86961eSJordan K. Hubbard#	specified amount. If this value is below the allocated amount no action
11501d86961eSJordan K. Hubbard#	taken
1151734d08a2SJordan K. Hubbard#   option METEOR_SYSTEM_DEFAULT={METEOR_PAL|METEOR_NTSC|METEOR_SECAM}, used
1152734d08a2SJordan K. Hubbard#	for initialization of fps routine when a signal is not present.
11531d86961eSJordan K. Hubbard#
11545719a93cSJohn-Mark Gurney# The 'bktr' device is a PCI video capture board. It also has a TV tuner
11555719a93cSJohn-Mark Gurney# on board.
11565719a93cSJohn-Mark Gurney#
11576a8d6623SGarrett Wollmancontroller	pci0
1158eeb706c0SJustin T. Gibbscontroller	ahc1
115911bfa65aSBruce Evanscontroller	ncr0
1160e69742d7SStefan Eßercontroller	amd0
11616a8d6623SGarrett Wollmandevice		de0
116217acc2b2SDavid Greenmandevice		fxp0
11635ccfdea2SAndreas Schulzdevice		vx0
1164d41f24e7SDavid Greenmandevice		fpa0
11651d86961eSJordan K. Hubbarddevice		meteor0
11665719a93cSJohn-Mark Gurneydevice		bktr0
1167446cee6eSJoerg Wunsch
1168dc9deb29SPoul-Henning Kamp
1169dc9deb29SPoul-Henning Kamp#
1170dc9deb29SPoul-Henning Kamp# PCCARD/PCMCIA
1171dc9deb29SPoul-Henning Kamp#
117213cbd355SNate Williams# crd: slot controller
117313cbd355SNate Williams# pcic: slots
1174dc9deb29SPoul-Henning Kampcontroller	crd0
1175dc9deb29SPoul-Henning Kampcontroller	pcic0 at crd?
117613cbd355SNate Williamscontroller	pcic1 at crd?
1177dc9deb29SPoul-Henning Kamp
1178446cee6eSJoerg Wunsch#
1179446cee6eSJoerg Wunsch# Laptop/Notebook options:
1180446cee6eSJoerg Wunsch#
1181446cee6eSJoerg Wunsch# See also:
11826c5e9bbdSMike Pritchard#  apm under `Miscellaneous hardware'
1183446cee6eSJoerg Wunsch# above.
1184446cee6eSJoerg Wunsch
1185446cee6eSJoerg Wunsch# For older notebooks that signal a powerfail condition (external
1186446cee6eSJoerg Wunsch# power supply dropped, or battery state low) by issuing an NMI:
1187446cee6eSJoerg Wunsch
1188446cee6eSJoerg Wunschoptions		POWERFAIL_NMI	# make it beep instead of panicing
118965e8111fSBruce Evans
1190432aad0eSTor Egge# Kernel BOOTP support
1191432aad0eSTor Egge
1192432aad0eSTor Eggeoptions		BOOTP		# Use BOOTP to obtain IP address/hostname
1193432aad0eSTor Eggeoptions		BOOTP_NFSROOT	# NFS mount root filesystem using BOOTP info
1194432aad0eSTor Eggeoptions		"BOOTP_NFSV3"	# Use NFS v3 to NFS mount root
1195432aad0eSTor Eggeoptions		BOOTP_COMPAT	# Workaround for broken bootp daemons.
1196432aad0eSTor Egge
119725292acbSBruce Evans#
119825292acbSBruce Evans# An obsolete option to test kern_opt.c.
119925292acbSBruce Evans#
120025292acbSBruce Evansoptions		GATEWAY
120125292acbSBruce Evans
120265e8111fSBruce Evans# More undocumented options for linting.
120394c94804SBruce Evans
1204d656e316SBruce Evansoptions		CLK_CALIBRATION_LOOP
1205d656e316SBruce Evansoptions		"CLK_USE_I8254_CALIBRATION"
1206d656e316SBruce Evansoptions		"CLK_USE_I586_CALIBRATION"
12079546766aSBruce Evansoptions		CLUSTERDEBUG
1208f3e002a8SPoul-Henning Kampoptions		COMPAT_LINUX
120996b89afcSBruce Evansoptions		CPU_UPGRADE_HW_CACHE
121011bfa65aSBruce Evansoptions		DEBUG
121111bfa65aSBruce Evansoptions		DEVFS_ROOT
121211bfa65aSBruce Evansoptions		"EXT2FS"
121311bfa65aSBruce Evansoptions		"I586_CTR_GUPROF"
121411bfa65aSBruce Evansoptions		"I586_PMC_GUPROF=0x70000"
121511bfa65aSBruce Evansoptions		"IBCS2"
121625292acbSBruce Evansoptions		LOCKF_DEBUG
12174bc24b97SBruce Evansoptions		KBD_MAXRETRY=4
12184bc24b97SBruce Evansoptions		KBD_MAXWAIT=6
12194bc24b97SBruce Evansoptions		KBD_RESETDELAY=201
12204bc24b97SBruce Evansoptions		KBDIO_DEBUG=2
12214bc24b97SBruce Evansoptions		MSGMNB=2049
12224bc24b97SBruce Evansoptions		MSGMNI=41
12234bc24b97SBruce Evansoptions		MSGSEG=2049
122456a956e5SBruce Evansoptions		MSGSSZ=16
12254bc24b97SBruce Evansoptions		MSGTQL=41
12264bc24b97SBruce Evansoptions		NBUF=512
12274bc24b97SBruce Evansoptions		NMBCLUSTERS=1024
12289546766aSBruce Evansoptions		NPX_DEBUG
12294bc24b97SBruce Evansoptions		PSM_ACCEL=1
12304bc24b97SBruce Evansoptions		PSM_DEBUG=1
12314bc24b97SBruce Evansoptions		PSM_EMULATION
1232c01db44aSBruce Evansoptions		"SCSI_2_DEF"
1233078d4ac9SBruce Evansoptions		SCSI_DELAY=8	# Be pessimistic about Joe SCSI device
1234078d4ac9SBruce Evansoptions		SCSI_NCR_DEBUG
1235078d4ac9SBruce Evansoptions		SCSI_NCR_DFLT_TAGS=4
1236078d4ac9SBruce Evansoptions		SCSI_NCR_MAX_SYNC=10000
1237078d4ac9SBruce Evansoptions		SCSI_NCR_MAX_WIDE=1
1238078d4ac9SBruce Evansoptions		SCSI_NCR_MYADDR=7
12394bc24b97SBruce Evansoptions		SEMMAP=31
12404bc24b97SBruce Evansoptions		SEMMNI=11
12414bc24b97SBruce Evansoptions		SEMMNS=61
12424bc24b97SBruce Evansoptions		SEMMNU=31
12434bc24b97SBruce Evansoptions		SEMMSL=61
12444bc24b97SBruce Evansoptions		SEMOPM=101
12454bc24b97SBruce Evansoptions		SEMUME=11
1246b1529bdaSPeter Wemmoptions		SHOW_BUSYBUFS	# List buffers that prevent root unmount
12474bc24b97SBruce Evansoptions		SHMALL=1025
12484bc24b97SBruce Evansoptions		"SHMMAX=(SHMMAXPGS*PAGE_SIZE+1)"
12494bc24b97SBruce Evansoptions		SHMMAXPGS=1025
12504bc24b97SBruce Evansoptions		SHMMIN=2
12514bc24b97SBruce Evansoptions		SHMMNI=33
12524bc24b97SBruce Evansoptions		SHMSEG=9
1253d656e316SBruce Evansoptions		SI_DEBUG
125425292acbSBruce Evansoptions		SIMPLELOCK_DEBUG
1255cefdbb04SBruce Evansoptions		SPX_HACK
125696b89afcSBruce Evansoptions		WLDEBUG
1257