xref: /freebsd/sys/conf/NOTES (revision 9306343284b086c3e1aad4632c4616f246cec8fb)
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#
593063432SJoerg Wunsch#	$Id: LINT,v 1.264 1996/06/14 09:42:52 asami 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
146a8d6623SGarrett Wollman# configured for; in this case, the 386 family.  You must also specify
156a8d6623SGarrett Wollman# at least one CPU (the one you intend to run on); deleting the
166a8d6623SGarrett Wollman# specification for CPUs you don't need to use may make parts of the
176a8d6623SGarrett Wollman# system run faster
186a8d6623SGarrett Wollman#
192365e64fSRodney W. Grimesmachine		"i386"
20f87a3269SRodney W. Grimescpu		"I386_CPU"
21f87a3269SRodney W. Grimescpu		"I486_CPU"
22ca83dc2dSJordan K. Hubbardcpu		"I586_CPU"		# aka Pentium(tm)
237059cdf2SDavid Greenmancpu		"I686_CPU"		# aka Pentium Pro(tm)
242365e64fSRodney W. Grimes
256a8d6623SGarrett Wollman#
266a8d6623SGarrett Wollman# This is the ``identification'' of the kernel.  Usually this should
276a8d6623SGarrett Wollman# be the same as the name of your kernel.
286a8d6623SGarrett Wollman#
296a8d6623SGarrett Wollmanident		LINT
306a8d6623SGarrett Wollman
316a8d6623SGarrett Wollman#
326a8d6623SGarrett Wollman# The `maxusers' parameter controls the static sizing of a number of
336a8d6623SGarrett Wollman# internal system tables by a complicated formula defined in param.c.
346a8d6623SGarrett Wollman#
356a8d6623SGarrett Wollmanmaxusers	10
366a8d6623SGarrett Wollman
376a8d6623SGarrett Wollman#
38663afbc3SScott Mace# Under some circumstances it is necessary to make the default max
39f73bbaf2SDavid Greenman# number of processes per user and open files per user more than the
40663afbc3SScott Mace# defaults on bootup.  (an example is a large news server in which
410f700bfdSJoerg Wunsch# the uid, news, can sometimes need > 100 simultaneous processes running,
420f700bfdSJoerg Wunsch# or perhaps a user using lots of windows under X).
43b1529bdaSPeter Wemmoptions		CHILD_MAX=128
44b1529bdaSPeter Wemmoptions		OPEN_MAX=128
45663afbc3SScott Mace
46663afbc3SScott Mace#
47114a8cffSPeter Wemm# Under some circumstances it is useful to have an extra number of
48114a8cffSPeter Wemm# vnode data structures allocated at boot time.  In particular,
49114a8cffSPeter Wemm# usenet news servers can benefit if there are enough vnodes to
50114a8cffSPeter Wemm# cache the busiest newsgroup and overview directories.  Beware that
51114a8cffSPeter Wemm# this is an expensive option, it consumes physical non-pageable ram.
52114a8cffSPeter Wemm# A busy news server may benefit from 10,000 extra vnodes or so.
53114a8cffSPeter Wemm#
54b8484eb3SPeter Wemmoptions		EXTRAVNODES=1
55114a8cffSPeter Wemm
56114a8cffSPeter Wemm#
576a8d6623SGarrett Wollman# A math emulator is mandatory if you wish to run on hardware which
586a8d6623SGarrett Wollman# does not have a floating-point processor.  Pick either the original,
596a8d6623SGarrett Wollman# bogus (but freely-distributable) math emulator, or a much more
606a8d6623SGarrett Wollman# fully-featured but GPL-licensed emulator taken from Linux.
616a8d6623SGarrett Wollman#
626a8d6623SGarrett Wollmanoptions		MATH_EMULATE		#Support for x87 emulation
6394c94804SBruce Evans# Don't enable both of these in a real config.
646c5e9bbdSMike Pritchardoptions		GPL_MATH_EMULATE	#Support for x87 emulation via
65cfecaf32SGary Clark II					#new math emulator
66cfecaf32SGary Clark II
6725cf9d99SJordan K. Hubbard# When this is set, be extra conservative in various parts of the kernel
6825cf9d99SJordan K. Hubbard# and choose functionality over speed (on the widest variety of systems).
6925cf9d99SJordan K. Hubbardoptions		FAILSAFE
7025cf9d99SJordan K. Hubbard
7125cf9d99SJordan K. Hubbard
72f7ef42a0SSatoshi Asami# When this is set, copyin/copyout will use an unrolled loop using
73f7ef42a0SSatoshi Asami# floating point registers.  It makes copyin/copyout run 30-100%
74f7ef42a0SSatoshi Asami# faster on Pentiums and makes no difference or slower on non-Pentium
75f7ef42a0SSatoshi Asami# (including P6) systems.
76f7ef42a0SSatoshi Asami#
77f7ef42a0SSatoshi Asami# However, even when this is set, there is a run-time check for CPU
78f7ef42a0SSatoshi Asami# type so the routine will never be invoked for a wrong architecture.
79f7ef42a0SSatoshi Asami# It will become the default after some testing period.
80f7ef42a0SSatoshi Asamioptions		"I586_FAST_BCOPY"
81f7ef42a0SSatoshi Asami
826a8d6623SGarrett Wollman#
836a8d6623SGarrett Wollman# This directive defines a number of things:
846a8d6623SGarrett Wollman#  - The compiled kernel is to be called `kernel'
856a8d6623SGarrett Wollman#  - The root filesystem might be on partition wd0a
86b8e91dabSDavid Greenman#  - Crash dumps will be written to wd0b, if possible.  Specifying the
87b8e91dabSDavid Greenman#    dump device here is not recommended.  Use dumpon(8).
886a8d6623SGarrett Wollman#
89b8e91dabSDavid Greenmanconfig		kernel	root on wd0 dumps on wd0
902365e64fSRodney W. Grimes
916a8d6623SGarrett Wollman
926a8d6623SGarrett Wollman#####################################################################
936a8d6623SGarrett Wollman# COMPATIBILITY OPTIONS
94690f540cSAndrey A. Chernov
956a8d6623SGarrett Wollman#
966a8d6623SGarrett Wollman# Implement system calls compatible with 4.3BSD and older versions of
9756c7a48cSJordan K. Hubbard# FreeBSD.  You probably do NOT want to remove this as much current code
9856c7a48cSJordan K. Hubbard# still relies on the 4.3 emulation.
996a8d6623SGarrett Wollman#
1006a8d6623SGarrett Wollmanoptions		"COMPAT_43"
1016a8d6623SGarrett Wollman
1026a8d6623SGarrett Wollman#
1036c5e9bbdSMike Pritchard# Allow user-mode programs to manipulate their local descriptor tables.
1046a8d6623SGarrett Wollman# This option is required for the WINE Windows(tm) emulator, and is
1056a8d6623SGarrett Wollman# not used by anything else (that we know of).
1066a8d6623SGarrett Wollman#
1076a8d6623SGarrett Wollmanoptions		USER_LDT		#allow user-level control of i386 ldt
1086a8d6623SGarrett Wollman
1096a8d6623SGarrett Wollman#
1106a8d6623SGarrett Wollman# These three options provide support for System V Interface
1116a8d6623SGarrett Wollman# Definition-style interprocess communication, in the form of shared
1126a8d6623SGarrett Wollman# memory, semaphores, and message queues, respectively.
1136a8d6623SGarrett Wollman#
1146a8d6623SGarrett Wollmanoptions		SYSVSHM
1156a8d6623SGarrett Wollmanoptions		SYSVSEM
1166a8d6623SGarrett Wollmanoptions		SYSVMSG
1176a8d6623SGarrett Wollman
1186a8d6623SGarrett Wollman
1196a8d6623SGarrett Wollman#####################################################################
1206a8d6623SGarrett Wollman# DEBUGGING OPTIONS
1216a8d6623SGarrett Wollman
1226a8d6623SGarrett Wollman#
123b5d89ca8SBruce Evans# Enable the kernel debugger.
1246a8d6623SGarrett Wollman#
125b5d89ca8SBruce Evansoptions		DDB
126b5d89ca8SBruce Evans
127b5d89ca8SBruce Evans#
1285ccab2afSGary Palmer# Don't drop into DDB for a panic. Intended for unattended operation
1295ccab2afSGary Palmer# where you may want to drop to DDB from the console, but still want
1305ccab2afSGary Palmer# the machine to recover from a panic
1315ccab2afSGary Palmer#
1325ccab2afSGary Palmeroptions		DDB_UNATTENDED
1335ccab2afSGary Palmer
1345ccab2afSGary Palmer#
1356a8d6623SGarrett Wollman# KTRACE enables the system-call tracing facility ktrace(2).
1366a8d6623SGarrett Wollman#
1372365e64fSRodney W. Grimesoptions		KTRACE			#kernel tracing
13821c64a07SAndrey A. Chernov
1396a8d6623SGarrett Wollman#
1406a8d6623SGarrett Wollman# The DIAGNOSTIC option is used in a number of source files to enable
1416a8d6623SGarrett Wollman# extra sanity checking of internal structures.  This support is not
1426a8d6623SGarrett Wollman# enabled by default because of the extra time it would take to check
1436a8d6623SGarrett Wollman# for these conditions, which can only occur as a result of
1446a8d6623SGarrett Wollman# programming errors.
1456a8d6623SGarrett Wollman#
1460dc7d907SPoul-Henning Kampoptions		DIAGNOSTIC
147da59a31cSDavid Greenman
1480dd1eea1SJordan K. Hubbard#
149348acd94SGarrett Wollman# PERFMON causes the driver for Pentium/Pentium Pro performance counters
150348acd94SGarrett Wollman# to be compiled.  See perfmon(4) for more information.
151348acd94SGarrett Wollman#
152348acd94SGarrett Wollmanoptions		PERFMON
153348acd94SGarrett Wollman
154348acd94SGarrett Wollman# XXX - this doesn't belong here.
1550dd1eea1SJordan K. Hubbard# Allow ordinary users to take the console - this is useful for X.
1560dd1eea1SJordan K. Hubbardoptions		UCONSOLE
1570dd1eea1SJordan K. Hubbard
1586a8d6623SGarrett Wollman
1596a8d6623SGarrett Wollman#####################################################################
1606a8d6623SGarrett Wollman# NETWORKING OPTIONS
16170c0b54cSAndrey A. Chernov
1626a8d6623SGarrett Wollman#
1636a8d6623SGarrett Wollman# Protocol families:
1646a8d6623SGarrett Wollman#  Only the INET (Internet) family is officially supported in FreeBSD.
1656a8d6623SGarrett Wollman#  Source code for the NS (Xerox Network Service), ISO (OSI), and
1666a8d6623SGarrett Wollman#  CCITT (X.25) families is provided for amusement value, although we
1676a8d6623SGarrett Wollman#  try to ensure that it actually compiles.
1686a8d6623SGarrett Wollman#
1696a8d6623SGarrett Wollmanoptions		INET			#Internet communications protocols
170f73bbaf2SDavid Greenman
171cc6a66f2SJulian Elischeroptions		IPX			#IPX/SPX communications protocols
172cc6a66f2SJulian Elischeroptions		IPXIP			#IPX in IP encapsulation (not available)
173cc6a66f2SJulian Elischeroptions		IPTUNNEL		#IP in IPX encapsulation (not available)
174b1529bdaSPeter Wemmoptions		IPXPRINTFS=0		#IPX/SPX Console Debugging Information
175b1529bdaSPeter Wemmoptions		IPX_ERRPRINTFS=0	#IPX/SPX Console Debugging Information
176cc6a66f2SJulian Elischer
177bba9a7a0SGarrett Wollman# These are currently broken and are no longer shipped due to lack
178bba9a7a0SGarrett Wollman# of interest.
179bba9a7a0SGarrett Wollman#options		CCITT			#X.25 network layer
180f73bbaf2SDavid Greenman#options		ISO
181f73bbaf2SDavid Greenman#options		TPIP			#ISO TP class 4 over IP
182f73bbaf2SDavid Greenman#options		TPCONS			#ISO TP class 0 over X.25
183bba9a7a0SGarrett Wollman#options		LLC			#X.25 link layer for Ethernets
184bba9a7a0SGarrett Wollman#options		HDLC			#X.25 link layer for serial lines
185bba9a7a0SGarrett Wollman#options		EON			#ISO CLNP over IP
186dc915e7cSGarrett Wollman#options		NS			#Xerox NS protocols
187dc915e7cSGarrett Wollman#options		NSIP			#XNS over IP
18863a74862SSteven Wallace
1896a8d6623SGarrett Wollman#
1906a8d6623SGarrett Wollman# Network interfaces:
19156c7a48cSJordan K. Hubbard#  The `loop' pseudo-device is MANDATORY when networking is enabled.
1926a8d6623SGarrett Wollman#  The `ether' pseudo-device provides generic code to handle
19356c7a48cSJordan K. Hubbard#  Ethernets; it is MANDATORY when a Ethernet device driver is
1946a8d6623SGarrett Wollman#  configured.
195d41f24e7SDavid Greenman#  The 'fddi' pseudo-device provides generic code to support FDDI.
19683401efaSGarrett Wollman#  The `sppp' pseudo-device serves a similar role for certain types
197e7c234a1SPeter Wemm#  of synchronous PPP links (like `cx', `ar').
1986a8d6623SGarrett Wollman#  The `sl' pseudo-device implements the Serial Line IP (SLIP) service.
1996a8d6623SGarrett Wollman#  The `ppp' pseudo-device implements the Point-to-Point Protocol.
200d29895dcSGarrett Wollman#  The `bpfilter' pseudo-device enables the Berkeley Packet Filter.  Be
201d29895dcSGarrett Wollman#  aware of the legal and administrative consequences of enabling this
202d29895dcSGarrett Wollman#  option.  The number of devices determines the maximum number of
203d29895dcSGarrett Wollman#  simultaneous BPF clients programs runnable.
20459d8d13fSGarrett Wollman#  The `disc' pseudo-device implements a minimal network interface,
20559d8d13fSGarrett Wollman#  which throws away all packets sent and never receives any.  It is
20659d8d13fSGarrett Wollman#  included for testing purposes.
207b60d4a5dSAtsushi Murai#  The `tun' pseudo-device implements the User Process PPP (iijppp)
2086a8d6623SGarrett Wollman#
2096a8d6623SGarrett Wollmanpseudo-device	ether			#Generic Ethernet
210d41f24e7SDavid Greenmanpseudo-device	fddi			#Generic FDDI
21183401efaSGarrett Wollmanpseudo-device	sppp			#Generic Synchronous PPP
2126a8d6623SGarrett Wollmanpseudo-device	loop			#Network loopback device
2136a8d6623SGarrett Wollmanpseudo-device	sl	2		#Serial Line IP
2146a8d6623SGarrett Wollmanpseudo-device	ppp	2		#Point-to-point protocol
215d29895dcSGarrett Wollmanpseudo-device	bpfilter	4	#Berkeley packet filter
21659d8d13fSGarrett Wollmanpseudo-device	disc			#Discard device
2172d3f9865SAtsushi Muraipseudo-device	tun	1		#Tunnel driver(user process ppp)
218d29895dcSGarrett Wollman
2196a8d6623SGarrett Wollman#
2206a8d6623SGarrett Wollman# Internet family options:
2216a8d6623SGarrett Wollman#
2226a8d6623SGarrett Wollman# TCP_COMPAT_42 causes the TCP code to emulate certain bugs present in
2236a8d6623SGarrett Wollman# 4.2BSD.  This option should not be used unless you have a 4.2BSD
2246a8d6623SGarrett Wollman# machine and TCP connections fail.
2256a8d6623SGarrett Wollman#
2266a8d6623SGarrett Wollman# MROUTING enables the kernel multicast packet forwarder, which works
2276a8d6623SGarrett Wollman# with mrouted(8).
2286a8d6623SGarrett Wollman#
229d29895dcSGarrett Wollman# IPFIREWALL enables support for IP firewall construction, in
230ff6f025aSAlexander Langer# conjunction with the `ipfw' program.  IPFIREWALL_VERBOSE sends
231ff6f025aSAlexander Langer# logged packets to the system logger.  IPFIREWALL_VERBOSE_LIMIT
232ff6f025aSAlexander Langer# limits the number of times a matching entry can be logged.
233d29895dcSGarrett Wollman#
23465e8111fSBruce Evans# TCPDEBUG is undocumented.
23565e8111fSBruce Evans#
2366a8d6623SGarrett Wollmanoptions		"TCP_COMPAT_42"		#emulate 4.2BSD TCP bugs
237e3178a06SJordan K. Hubbardoptions		MROUTING		# Multicast routing
238d29895dcSGarrett Wollmanoptions         IPFIREWALL              #firewall
239d29895dcSGarrett Wollmanoptions         IPFIREWALL_VERBOSE      #print information about
240d29895dcSGarrett Wollman					# dropped packets
241ff6f025aSAlexander Langeroptions		"IPFIREWALL_VERBOSE_LIMIT=100" #limit verbosity
24265e8111fSBruce Evansoptions		TCPDEBUG
2436a8d6623SGarrett Wollman
2446a8d6623SGarrett Wollman
2456a8d6623SGarrett Wollman#####################################################################
2466a8d6623SGarrett Wollman# FILESYSTEM OPTIONS
247e3178a06SJordan K. Hubbard
2482365e64fSRodney W. Grimes#
2496a8d6623SGarrett Wollman# Only the root, /usr, and /tmp filesystems need be statically
2506a8d6623SGarrett Wollman# compiled; everything else will be automatically loaded at mount
2516a8d6623SGarrett Wollman# time.  (Exception: the UFS family---FFS, MFS, and LFS---cannot
2526a8d6623SGarrett Wollman# currently be demand-loaded.)  Some people still prefer to statically
2536a8d6623SGarrett Wollman# compile other filesystems as well.
2546a8d6623SGarrett Wollman#
2556a8d6623SGarrett Wollman# NB: The LFS, PORTAL, and UNION filesystems are known to be buggy,
2566a8d6623SGarrett Wollman# and WILL panic your system if you attempt to do anything with them.
2576a8d6623SGarrett Wollman# They are included here as an incentive for some enterprising soul to
2586a8d6623SGarrett Wollman# sit down and fix them.
2592365e64fSRodney W. Grimes#
260e5e60905SDavid Greenman# Note: 4.4BSD NQNFS lease checking has relatively high cost for
261e5e60905SDavid Greenman# _local_ I/O as well as remote I/O. Don't use it unless you will
262e5e60905SDavid Greenman# using NQNFS.
263e5e60905SDavid Greenman#
264f1a9c715SDavid Greenman
2656a8d6623SGarrett Wollman# One of these is mandatory:
2666a8d6623SGarrett Wollmanoptions		FFS			#Fast filesystem
2676a8d6623SGarrett Wollmanoptions		NFS			#Network File System
2686a8d6623SGarrett Wollman
2696a8d6623SGarrett Wollman# The rest are optional:
270e5e60905SDavid Greenmanoptions		NQNFS			#Enable NQNFS lease checking
2717c115697SPoul-Henning Kamp# options	NFS_NOSERVER		#Disable the NFS-server code.
272f1a9c715SDavid Greenmanoptions		"CD9660"		#ISO 9660 filesystem
273f1a9c715SDavid Greenmanoptions		FDESC			#File descriptor filesystem
274f1a9c715SDavid Greenmanoptions		KERNFS			#Kernel filesystem
275f1a9c715SDavid Greenmanoptions		LFS			#Log filesystem
276f1a9c715SDavid Greenmanoptions		MFS			#Memory File System
2773f9a6982SDoug Rabsonoptions		MSDOSFS			#MS DOS File System
278f1a9c715SDavid Greenmanoptions		NULLFS			#NULL filesystem
279f1a9c715SDavid Greenmanoptions		PORTAL			#Portal filesystem
280f1a9c715SDavid Greenmanoptions		PROCFS			#Process filesystem
281f1a9c715SDavid Greenmanoptions		UMAPFS			#UID map filesystem
282f1a9c715SDavid Greenmanoptions		UNION			#Union filesystem
283114a8cffSPeter Wemm# This DEVFS is experimental but seems to work
28446746c3bSJulian Elischeroptions		DEVFS			#devices filesystem
285f1a9c715SDavid Greenman
286d52d7365SPoul-Henning Kamp# Make space in the kernel for a MFS root filesystem.  Define to the number
287d52d7365SPoul-Henning Kamp# of kilobytes to reserve for the filesystem.
288b1529bdaSPeter Wemmoptions		MFS_ROOT=10
289b1529bdaSPeter Wemm# Allow the MFS_ROOT code to load the MFS image from floppy if it is missing.
290b1529bdaSPeter Wemmoptions		MFS_AUTOLOAD
291d52d7365SPoul-Henning Kamp
292a401ebbeSDavid Greenman# Allow this many swap-devices.
293b1529bdaSPeter Wemmoptions		NSWAPDEV=20
294a401ebbeSDavid Greenman
2956a8d6623SGarrett Wollman# Disk quotas are supported when this option is enabled.  If you
2966a8d6623SGarrett Wollman# change the value of this option, you must do a `make clean' in your
2976a8d6623SGarrett Wollman# kernel compile directory in order to get a working kernel.
2986a8d6623SGarrett Wollman#
2992365e64fSRodney W. Grimesoptions		QUOTA			#enable disk quotas
3006a8d6623SGarrett Wollman
30123d048eeSGary Palmer# Add more checking code to various filesystems
30223d048eeSGary Palmer#options		NULLFS_DIAGNOSTIC
30323d048eeSGary Palmer#options		KERNFS_DIAGNOSTIC
30423d048eeSGary Palmer#options		UMAPFS_DIAGNOSTIC
30523d048eeSGary Palmer#options		UNION_DIAGNOSTIC
30623d048eeSGary Palmer
30723d048eeSGary Palmer# Add some error checking code to the null_bypass routine
30823d048eeSGary Palmer# in nthe NULL filesystem
30923d048eeSGary Palmer#options		SAFETY
31023d048eeSGary Palmer
3116a8d6623SGarrett Wollman
3126a8d6623SGarrett Wollman#####################################################################
313de6a307eSPeter Dufault# SCSI DEVICES
314de6a307eSPeter Dufault
3156a8d6623SGarrett Wollman# SCSI DEVICE CONFIGURATION
3166a8d6623SGarrett Wollman
3176a8d6623SGarrett Wollman# The SCSI subsystem consists of the `base' SCSI code, a number of
318ebc1a0e2SPeter Dufault# high-level SCSI device `type' drivers, and the low-level host-adapter
3196a8d6623SGarrett Wollman# device drivers.  The host adapters are listed in the ISA and PCI
3206a8d6623SGarrett Wollman# device configuration sections below.
3216a8d6623SGarrett Wollman#
322265368d4SRodney W. Grimes# Beginning with FreeBSD 2.0.5 you can wire down your SCSI devices so
323ebc1a0e2SPeter Dufault# that a given bus, target, and LUN always come on line as the same
324ebc1a0e2SPeter Dufault# device unit.  In earlier versions the unit numbers were assigned
325ebc1a0e2SPeter Dufault# in the order that the devices were probed on the SCSI bus.  This
326ebc1a0e2SPeter Dufault# means that if you removed a disk drive, you may have had to rewrite
327ebc1a0e2SPeter Dufault# your /etc/fstab file, and also that you had to be careful when adding
328ebc1a0e2SPeter Dufault# a new disk as it may have been probed earlier and moved your device
329ebc1a0e2SPeter Dufault# configuration around.
330ebc1a0e2SPeter Dufault
331ebc1a0e2SPeter Dufault# This old behavior is maintained as the default behavior.  The unit
332ebc1a0e2SPeter Dufault# assignment begins with the first non-wired down unit for a device
333ebc1a0e2SPeter Dufault# type.  For example, if you wire a disk as "sd3" then the first
334ebc1a0e2SPeter Dufault# non-wired disk will be assigned sd4.
335ebc1a0e2SPeter Dufault
336ebc1a0e2SPeter Dufault# The syntax for wiring down devices is:
337ebc1a0e2SPeter Dufault
3384fbaf9a7SJustin T. Gibbs# controller	scbus0 at ahc0		# Single bus device
3394fbaf9a7SJustin T. Gibbs# controller	scbus1 at ahc1 bus 0	# Single bus device
3404fbaf9a7SJustin T. Gibbs# controller	scbus3 at ahc2 bus 0	# Twin bus device
3414fbaf9a7SJustin T. Gibbs# controller	scbus2 at ahc2 bus 1	# Twin bus device
342ebc1a0e2SPeter Dufault# disk 		sd0 at scbus0 target 0 unit 0
3434fbaf9a7SJustin T. Gibbs# disk		sd1 at scbus3 target 1
3444fbaf9a7SJustin T. Gibbs# disk		sd2 at scbus2 target 3
3454fbaf9a7SJustin T. Gibbs# tape		st1 at scbus1 target 6
346ebc1a0e2SPeter Dufault# device	cd0 at scbus?
347ebc1a0e2SPeter Dufault
348ebc1a0e2SPeter Dufault# "units" (SCSI logical unit number) that are not specified are
349ebc1a0e2SPeter Dufault# treated as if specified as LUN 0.
350ebc1a0e2SPeter Dufault
351ebc1a0e2SPeter Dufault# All SCSI devices allocate as many units as are required.
352ebc1a0e2SPeter Dufault
353265368d4SRodney W. Grimes# The "unknown" device (uk? in pre-2.0.5) is now part of the base SCSI
354ebc1a0e2SPeter Dufault# configuration and doesn't have to be explicitly configured.
355ebc1a0e2SPeter Dufault
3566a8d6623SGarrett Wollmancontroller	scbus0	#base SCSI code
3576a8d6623SGarrett Wollmandevice		ch0	#SCSI media changers
3586a8d6623SGarrett Wollmandevice		sd0	#SCSI disks
3596a8d6623SGarrett Wollmandevice		st0	#SCSI tapes
3606a8d6623SGarrett Wollmandevice		cd0	#SCSI CD-ROMs
36149bdb5b8SJoerg Wunschdevice		od0	#SCSI optical disk
3626a8d6623SGarrett Wollman
363265368d4SRodney W. Grimes# The previous devices (ch, sd, st, cd) are recognized by config.
364265368d4SRodney W. Grimes# config doesn't (and shouldn't) know about these newer ones,
365265368d4SRodney W. Grimes# so we have to specify that they are on a SCSI bus with the "at scbus?"
366265368d4SRodney W. Grimes# clause.
367265368d4SRodney W. Grimes
3688909a72bSPeter Dufaultdevice worm0 at scbus?	# SCSI worm
3698909a72bSPeter Dufaultdevice pt0 at scbus?	# SCSI processor type
3708909a72bSPeter Dufaultdevice sctarg0 at scbus? # SCSI target
3718909a72bSPeter Dufault
3721a7c583cSGarrett Wollman# SCSI OPTIONS:
3731a7c583cSGarrett Wollman
3741a7c583cSGarrett Wollman# SCSIDEBUG: When defined enables debugging macros
3751a7c583cSGarrett Wollman# NO_SCSI_SENSE: When defined disables sense descriptions (about 4k)
3761a7c583cSGarrett Wollman# SCSI_REPORT_GEOMETRY: Always report disk geometry at boot up instead
377265368d4SRodney W. Grimes#                       of only when booting verbosely.
3781a7c583cSGarrett Wollmanoptions		SCSIDEBUG
3791a7c583cSGarrett Wollman#options	NO_SCSI_SENSE
3801a7c583cSGarrett Wollmanoptions		SCSI_REPORT_GEOMETRY
3811a7c583cSGarrett Wollman
38293063432SJoerg Wunsch# Options for the `od' optical disk driver:
38393063432SJoerg Wunsch#
38493063432SJoerg Wunsch# If drive returns sense key as 0x02 with vendor specific additional
38593063432SJoerg Wunsch# sense code (ASC) and additional sense code qualifier (ASCQ), or
38693063432SJoerg Wunsch# illegal ASC and ASCQ. This cause an error (NOT READY) and retrying.
38793063432SJoerg Wunsch# To suppress this, use the following option.
38893063432SJoerg Wunsch#
38993063432SJoerg Wunschoptions		OD_BOGUS_NOT_READY
39093063432SJoerg Wunsch#
39193063432SJoerg Wunsch# For an automatic spindown, try this.  Again, preferrably as an
39293063432SJoerg Wunsch# option in your config file.
39393063432SJoerg Wunsch# WARNING!  Use at your own risk.  Joerg's ancient SONY SMO drive
39493063432SJoerg Wunsch# groks it fine, while Shunsuke's Fujitsu chokes on it and times
39593063432SJoerg Wunsch# out.
39693063432SJoerg Wunsch#
39793063432SJoerg Wunschoptions		OD_AUTO_TURNOFF
39893063432SJoerg Wunsch
39993063432SJoerg Wunsch
4006a8d6623SGarrett Wollman
4016a8d6623SGarrett Wollman#####################################################################
4026a8d6623SGarrett Wollman# MISCELLANEOUS DEVICES AND OPTIONS
4036a8d6623SGarrett Wollman
4042365e64fSRodney W. Grimes#
4056a8d6623SGarrett Wollman# Of these, only the `log' device is truly mandatory.  The `pty'
4066a8d6623SGarrett Wollman# device usually turns out to be ``effectively mandatory'', as it is
4076a8d6623SGarrett Wollman# required for `telnetd', `rlogind', `screen', `emacs', and `xterm',
4081a7c583cSGarrett Wollman# among others.  The `isdn', `ii', `ity', `itel', and `ispy' devices
40956c7a48cSJordan K. Hubbard# are all required when ISDN support is used.  If you wish to run certain
41056c7a48cSJordan K. Hubbard# system utilities which are compressed by default (like /stand/sysinstall)
41156c7a48cSJordan K. Hubbard# then `gzip' becomes mandatory too.
4126a8d6623SGarrett Wollman#
4139da6a15aSJordan K. Hubbardpseudo-device	pty	16	#Pseudo ttys - can go as high as 64
4146a8d6623SGarrett Wollmanpseudo-device	speaker		#Play IBM BASIC-style noises out your speaker
4156a8d6623SGarrett Wollmanpseudo-device	log		#Kernel syslog interface (/dev/klog)
4166a8d6623SGarrett Wollmanpseudo-device	gzip		#Exec gzipped a.out's
417784cf072SPoul-Henning Kamppseudo-device	vn		#Vnode driver (turns a file into a device)
4184cba4555SUgen J.S. Antsilevichpseudo-device	snp	3	#Snoop device - to look at pty/vty/etc..
41903b225a3SSatoshi Asamipseudo-device	ccd	4	#Concatenated disk driver
4209ba0e7c3SBruce Evans
4211a7c583cSGarrett Wollman# These are non-optional for ISDN
4221a7c583cSGarrett Wollmanpseudo-device   isdn
4231a7c583cSGarrett Wollmanpseudo-device   ii      4
4241a7c583cSGarrett Wollmanpseudo-device   ity     4
4251a7c583cSGarrett Wollmanpseudo-device   itel    2
4261a7c583cSGarrett Wollmanpseudo-device   ispy    1
4271a7c583cSGarrett Wollman
42865e8111fSBruce Evans# These are only for watching for bitrot in old tty code.
42965e8111fSBruce Evans# broken
43065e8111fSBruce Evans#pseudo-device	tb
43165e8111fSBruce Evans
43265e8111fSBruce Evans# These are only for watching for bitrot in old SCSI code.
43365e8111fSBruce Evanspseudo-device	su		#scsi user
43465e8111fSBruce Evanspseudo-device	ssc		#super scsi
43565e8111fSBruce Evans
4366a8d6623SGarrett Wollman
4376a8d6623SGarrett Wollman#####################################################################
4386a8d6623SGarrett Wollman# HARDWARE DEVICE CONFIGURATION
4396a8d6623SGarrett Wollman
4406a8d6623SGarrett Wollman# ISA and EISA devices:
4416a8d6623SGarrett Wollman# Currently there is no separate support for EISA.  There should be.
4426a8d6623SGarrett Wollman# Micro Channel is not supported at all.
4436a8d6623SGarrett Wollman
4446a8d6623SGarrett Wollman#
4451a7c583cSGarrett Wollman# Mandatory ISA devices: isa, sc or vt, npx
4466a8d6623SGarrett Wollman#
4472365e64fSRodney W. Grimescontroller	isa0
4482365e64fSRodney W. Grimes
4496a8d6623SGarrett Wollman#
4506a8d6623SGarrett Wollman# Options for `isa':
4516a8d6623SGarrett Wollman#
452d72ee36fSBruce Evans# AUTO_EOI_1 enables the `automatic EOI' feature for the master 8259A
453d72ee36fSBruce Evans# interrupt controller.  This saves about 0.7-1.25 usec for each interrupt.
454d72ee36fSBruce Evans# This option breaks suspend/resume on some portables.
455d72ee36fSBruce Evans#
4569ba0e7c3SBruce Evans# AUTO_EOI_2 enables the `automatic EOI' feature for the slave 8259A
457d72ee36fSBruce Evans# interrupt controller.  This saves about 0.7-1.25 usec for each interrupt.
4589ba0e7c3SBruce Evans# Automatic EOI is documented not to work for for the slave with the
4599ba0e7c3SBruce Evans# original i8259A, but it works for some clones and some integrated
4609ba0e7c3SBruce Evans# versions.
4619ba0e7c3SBruce Evans#
4626a8d6623SGarrett Wollman# BOUNCE_BUFFERS provides support for ISA DMA on machines with more
4636a8d6623SGarrett Wollman# than 16 megabytes of memory.  It doesn't hurt on other machines.
4646a8d6623SGarrett Wollman# Some broken EISA and VLB hardware may need this, too.
4653339606dSAndreas Schulz#
4663339606dSAndreas Schulz# TUNE_1542 enables the automatic ISA bus speed selection for the
4673339606dSAndreas Schulz# Adaptec 1542 boards. Does not work for all boards, use it with caution.
4683339606dSAndreas Schulz#
4695eb46edfSDavid Greenman# BROKEN_KEYBOARD_RESET disables the use of the keyboard controller to
4705eb46edfSDavid Greenman# reset the CPU for reboot.  This is needed on some systems with broken
4715eb46edfSDavid Greenman# keyboard controllers.
4723eafdedeSBruce Evans#
47377959e8eSMarc G. Fournier# PAS_JOYSTICK_ENABLE enables the gameport on the ProAudio Spectrum
47477959e8eSMarc G. Fournier
475d72ee36fSBruce Evansoptions		"AUTO_EOI_1"
4769ba0e7c3SBruce Evans#options	"AUTO_EOI_2"
4776a8d6623SGarrett Wollmanoptions		BOUNCE_BUFFERS
478b6b8f81eSAndrey A. Chernov#options        "TUNE_1542"
479b1529bdaSPeter Wemm#options	BROKEN_KEYBOARD_RESET
48077959e8eSMarc G. Fournier#options	PAS_JOYSTICK_ENABLE
4813af6b652SDavid Greenman
4824530be52SJordan K. Hubbard# Enable this and PCVT_FREEBSD for pcvt vt220 compatible console driver
4837fbcd76bSBruce Evansdevice		vt0	at isa? port "IO_KBD" tty irq 1 vector pcrint
484b1529bdaSPeter Wemmoptions		PCVT_FREEBSD=210	# pcvt running on FreeBSD >= 2.0.5
4857fbcd76bSBruce Evansoptions		XSERVER			# include code for XFree86
4867fbcd76bSBruce Evansoptions		FAT_CURSOR		# start with block cursor
487e9aaac99SNate Williams# This PCVT option is for keyboards such as those used on IBM ThinkPad laptops
488b1529bdaSPeter Wemmoptions		PCVT_SCANSET=2 		# IBM keyboards are non-std
4894530be52SJordan K. Hubbard
4904530be52SJordan K. Hubbard# The syscons console driver (sco color console compatible) - default.
4916a8d6623SGarrett Wollmandevice		sc0	at isa? port "IO_KBD" tty irq 1 vector scintr
4922ac8be82SAndreas Schulz
4936a8d6623SGarrett Wollman#
49498e9e66cSNate Williams# This device is mandatory.
49598e9e66cSNate Williams#
49698e9e66cSNate Williams# The Numeric Processing eXtension is used to either enable the
49798e9e66cSNate Williams# coprocessor or enable math emulation.  If your machine doesn't contain
49898e9e66cSNate Williams# a math co-processor, you must *also* add the option "MATH_EMULATE".
49946746c3bSJulian Elischer# THIS IS NOT AN OPTIONAL ENTRY, DO NOT REMOVE IT
50098e9e66cSNate Williams#
5012365e64fSRodney W. Grimesdevice		npx0	at isa? port "IO_NPX" irq 13 vector npxintr
5026a8d6623SGarrett Wollman
5036a8d6623SGarrett Wollman#
5046a8d6623SGarrett Wollman# Optional ISA and EISA devices:
5056a8d6623SGarrett Wollman#
5066a8d6623SGarrett Wollman
5076a8d6623SGarrett Wollman#
508e56e7036SJustin T. Gibbs# SCSI host adapters: `aha', `aic', `bt', `nca'
5096a8d6623SGarrett Wollman#
5106a8d6623SGarrett Wollman# aha: Adaptec 154x
5119829c3edSJordan K. Hubbard# ahc: Adaptec 274x/284x/294x
5126a8d6623SGarrett Wollman# aic: Adaptec 152x and sound cards using the Adaptec AIC-6360 (slow!)
5136a8d6623SGarrett Wollman# bt: Most Buslogic controllers
514e05407d8SPoul-Henning Kamp# nca: ProAudioSpectrum cards using the NCR 5380 or Trantor T130
5156a8d6623SGarrett Wollman# uha: UltraStore 14F and 34F
5163c43212aSSøren Schmidt# sea: Seagate ST01/02 8 bit controller (slow!)
5173691d2b9SJordan K. Hubbard# wds: Western Digital WD7000 controller (no scatter/gather!).
5186a8d6623SGarrett Wollman#
5196a8d6623SGarrett Wollman# Note that the order is important in order for Buslogic cards to be
5206a8d6623SGarrett Wollman# probed correctly.
5216a8d6623SGarrett Wollman#
5226a8d6623SGarrett Wollman
523a1d01dafSJustin T. Gibbscontroller	bt0	at isa? port "IO_BT0" bio irq ? vector bt_isa_intr
5246a8d6623SGarrett Wollmancontroller	aha0	at isa? port "IO_AHA0" bio irq ? drq 5 vector ahaintr
5256a8d6623SGarrett Wollmancontroller	uha0	at isa? port "IO_UHA0" bio irq ? drq 5 vector uhaintr
5266a8d6623SGarrett Wollman
5276a8d6623SGarrett Wollmancontroller      aic0    at isa? port 0x340 bio irq 11 vector aicintr
528e05407d8SPoul-Henning Kampcontroller	nca0	at isa? port 0x1f88 bio irq 10 vector ncaintr
529e05407d8SPoul-Henning Kampcontroller	nca1	at isa? port 0x1f84
530e05407d8SPoul-Henning Kampcontroller	nca2	at isa? port 0x1f8c
531e05407d8SPoul-Henning Kampcontroller	nca3	at isa? port 0x1e88
532e05407d8SPoul-Henning Kampcontroller	nca4	at isa? port 0x350 bio irq 5 vector ncaintr
53345b4c36fSJordan K. Hubbard
5343c43212aSSøren Schmidtcontroller	sea0	at isa? bio irq 5 iomem 0xdc000 iosiz 0x2000 vector seaintr
5353691d2b9SJordan K. Hubbardcontroller	wds0	at isa? port 0x350 bio irq 15 drq 6 vector wdsintr
5363c43212aSSøren Schmidt
5376a8d6623SGarrett Wollman#
5386a8d6623SGarrett Wollman# ST-506, ESDI, and IDE hard disks: `wdc' and `wd'
5396a8d6623SGarrett Wollman#
5406a8d6623SGarrett Wollman# NB: ``Enhanced IDE'' is NOT supported at this time.
5416a8d6623SGarrett Wollman#
542e3dd3158SJohn Dyson# The flags fields are used to enable the multi-sector I/O and
543e3dd3158SJohn Dyson# the 32BIT I/O modes.  The flags may be used in either the controller
544e3dd3158SJohn Dyson# definition or in the individual disk definitions.  The controller
545e3dd3158SJohn Dyson# definition is supported for the boot configuration stuff.
546e3dd3158SJohn Dyson#
547e3dd3158SJohn Dyson# Each drive has a 16 bit flags value defined:
548e3dd3158SJohn Dyson#	The low 8 bits are the maximum value for the multi-sector I/O,
549e3dd3158SJohn Dyson#	where 0xff defaults to the maximum that the drive can handle.
550e3dd3158SJohn Dyson#	The high bit of the 16 bit flags (0x8000) allows probing for
551e3dd3158SJohn Dyson#	32 bit transfers.
552e3dd3158SJohn Dyson#
553e3dd3158SJohn Dyson# The flags field for the drives can be specified in the controller
554e3dd3158SJohn Dyson# specification with the low 16 bits for drive 0, and the high 16 bits
555e3dd3158SJohn Dyson# for drive 1.
556e3dd3158SJohn Dyson# e.g.:
557e3dd3158SJohn Dyson#controller	wdc0	at isa? port "IO_WD1" bio irq 14 flags 0x00ff8004 vector wdintr
558e3dd3158SJohn Dyson#
559e3dd3158SJohn Dyson# specifies that drive 0 will be allowed to probe for 32 bit transfers and
560e3dd3158SJohn Dyson# a maximum multi-sector transfer of 4 sectors, and drive 1 will not be
561e3dd3158SJohn Dyson# allowed to probe for 32 bit transfers, but will allow multi-sector
562e3dd3158SJohn Dyson# transfers up to the maximum that the drive supports.
563e3dd3158SJohn Dyson#
564e3dd3158SJohn Dyson
565e3dd3158SJohn Dyson#
5662620c42eSNate Williamscontroller	wdc0	at isa? port "IO_WD1" bio irq 14 vector wdintr
5672620c42eSNate Williamsdisk		wd0	at wdc0 drive 0
5682620c42eSNate Williamsdisk		wd1	at wdc0 drive 1
5692620c42eSNate Williamscontroller	wdc1	at isa? port "IO_WD2" bio irq 15 vector wdintr
5702620c42eSNate Williamsdisk		wd2	at wdc1 drive 0
5712620c42eSNate Williamsdisk		wd3	at wdc1 drive 1
5722365e64fSRodney W. Grimes
5736a8d6623SGarrett Wollman#
5746788ce49SJordan K. Hubbard# Options for `wdc':
5756788ce49SJordan K. Hubbard#
5766788ce49SJordan K. Hubbard# ATAPI enables the support for ATAPI-compatible IDE devices
5776788ce49SJordan K. Hubbard#
5786788ce49SJordan K. Hubbardoptions         ATAPI   #Enable ATAPI support for IDE bus
5797b2305f7SAndrey A. Chernovoptions		ATAPI_STATIC	#Don't do it as an LKM
5806788ce49SJordan K. Hubbard
5816788ce49SJordan K. Hubbard# IDE CD-ROM driver - requires wdc controller and ATAPI option
5826788ce49SJordan K. Hubbarddevice          wcd0
5836788ce49SJordan K. Hubbard
5846788ce49SJordan K. Hubbard#
5856a8d6623SGarrett Wollman# Standard floppy disk controllers and floppy tapes: `fdc', `fd', and `ft'
5866a8d6623SGarrett Wollman#
5876a8d6623SGarrett Wollmancontroller	fdc0	at isa? port "IO_FD1" bio irq 6 drq 2 vector fdintr
58885827d9cSJoerg Wunsch#
58985827d9cSJoerg Wunsch# Activate this line instead of the fdc0 line above if you happen to
59085827d9cSJoerg Wunsch# have an Insight floppy tape.  Probing them proved to be dangerous
59185827d9cSJoerg Wunsch# for people with floppy disks only, so it's "hidden" behind a flag:
59285827d9cSJoerg Wunsch#controller fdc0 at isa? port "IO_FD1" bio flags 1 irq 6 drq 2 vector fdintr
59385827d9cSJoerg Wunsch
5946a8d6623SGarrett Wollmandisk		fd0	at fdc0 drive 0
5956a8d6623SGarrett Wollmandisk		fd1	at fdc0 drive 1
5966a8d6623SGarrett Wollmantape		ft0	at fdc0 drive 2
5976a8d6623SGarrett Wollman
59885827d9cSJoerg Wunsch
5996a8d6623SGarrett Wollman#
600d29895dcSGarrett Wollman# Options for `fd':
60195b926abSJoerg Wunsch#
602d29895dcSGarrett Wollman# FDSEEKWAIT selects a non-default head-settle time (i.e., the time to
603d29895dcSGarrett Wollman# wait after a seek is performed).  The default value (1/32 s) is
604d29895dcSGarrett Wollman# usually sufficient.  The units are inverse seconds, so a value of 16
605d29895dcSGarrett Wollman# here means to wait 1/16th of a second; you should choose a power of
606d29895dcSGarrett Wollman# two.
607b1529bdaSPeter Wemm# XXX: this seems to be missing!
608b1529bdaSPeter Wemmoptions	FDSEEKWAIT=16
60995b926abSJoerg Wunsch
61095b926abSJoerg Wunsch#
6112f6df264SJordan K. Hubbard# Other standard PC hardware: `lpt', `mse', `psm', `sio', etc.
6126a8d6623SGarrett Wollman#
6136a8d6623SGarrett Wollman# lpt: printer port
6147fe369dcSJoerg Wunsch#	lpt specials:
6157fe369dcSJoerg Wunsch#		port can be specified as ?, this will cause the driver to scan
6167fe369dcSJoerg Wunsch#		the BIOS port list;
6177fe369dcSJoerg Wunsch#		the irq and vector clauses may be omitted, this
6187fe369dcSJoerg Wunsch#		will force the port into polling mode.
6196a8d6623SGarrett Wollman# mse: Logitech and ATI InPort bus mouse ports
6209cc34748SJordan K. Hubbard# psm: PS/2 mouse port [note: conflicts with sc0/vt0, thus "conflicts" keywd]
6216a8d6623SGarrett Wollman# sio: serial ports (see sio(4))
6226a8d6623SGarrett Wollman
6237fe369dcSJoerg Wunschdevice		lpt0	at isa? port? tty irq 7 vector lptintr
6247fe369dcSJoerg Wunschdevice		lpt1	at isa? port "IO_LPT3" tty irq 5 vector lptintr
6256a8d6623SGarrett Wollmandevice		mse0	at isa? port 0x23c tty irq 5 vector mseintr
6269cc34748SJordan K. Hubbarddevice		psm0	at isa? port "IO_KBD" conflicts tty irq 12 vector psmintr
627975c53c7SDoug Rabson# Options for psm:
628975c53c7SDoug Rabsonoptions		PSM_NO_RESET		#don't reset mouse hardware (some laptops)
629975c53c7SDoug Rabson
6306a8d6623SGarrett Wollmandevice		sio0	at isa? port "IO_COM1" tty irq 4 vector siointr
6316a8d6623SGarrett Wollman
6326a8d6623SGarrett Wollman# Options for sio:
6339ba0e7c3SBruce Evansoptions		COMCONSOLE		#prefer serial console to video console
634768fd661SBruce Evansoptions		COM_ESP			#code for Hayes ESP
6359ba0e7c3SBruce Evansoptions		COM_MULTIPORT		#code for some cards with shared IRQs
6366a8d6623SGarrett Wollmanoptions		DSI_SOFT_MODEM		#code for DSI Softmodems
637e5f2c8f6SPoul-Henning Kampoptions		BREAK_TO_DEBUGGER	#a BREAK on a comconsole goes to
638e5f2c8f6SPoul-Henning Kamp					#DDB, if available.
6396a8d6623SGarrett Wollman
6406a8d6623SGarrett Wollman#
64183401efaSGarrett Wollman# Network interfaces: `cx', `ed', `el', `ep', `ie', `is', `le', `lnc'
6426a8d6623SGarrett Wollman#
6436c5e9bbdSMike Pritchard# ar: Arnet SYNC/570i hdlc sync 2/4 port V.35/X.21 serial driver (requires sppp)
64483401efaSGarrett Wollman# cx: Cronyx/Sigma multiport sync/async (with Cisco or PPP framing)
6456a8d6623SGarrett Wollman# ed: Western Digital and SMC 80xx; Novell NE1000 and NE2000; 3Com 3C503
6466a8d6623SGarrett Wollman# el: 3Com 3C501 (slow!)
6476a8d6623SGarrett Wollman# ep: 3Com 3C509 (buggy)
6481a7c583cSGarrett Wollman# fe: Fujitsu MB86960A/MB86965A Ethernet
649d41f24e7SDavid Greenman# fea: DEC DEFEA EISA FDDI adapter
6506a8d6623SGarrett Wollman# ie: AT&T StarLAN 10 and EN100; 3Com 3C507; unknown NI5210
6516a8d6623SGarrett Wollman# le: Digital Equipment EtherWorks 2 and EtherWorks 3 (DEPCA, DE100,
6526a8d6623SGarrett Wollman#     DE101, DE200, DE201, DE202, DE203, DE204, DE205, DE422)
65394187a78SPaul Richards# lnc: Lance/PCnet cards (Isolan, Novell NE2100, NE32-VL)
654648c711bSPoul-Henning Kamp# ze: IBM/National Semiconductor PCMCIA ethernet controller.
655648c711bSPoul-Henning Kamp# zp: 3Com PCMCIA Etherlink III (It does not require shared memory for
656648c711bSPoul-Henning Kamp#     send/receive operation, but it needs 'iomem' to read/write the
657648c711bSPoul-Henning Kamp#     attribute memory)
6586a8d6623SGarrett Wollman#
6596a8d6623SGarrett Wollman
660e7c234a1SPeter Wemmdevice ar0 at isa? port 0x300 net irq 10 iomem 0xd0000 vector arintr
66183401efaSGarrett Wollmandevice cx0 at isa? port 0x240 net irq 15 drq 7 vector cxintr
6626a8d6623SGarrett Wollmandevice ed0 at isa? port 0x280 net irq 5 iomem 0xd8000 vector edintr
66312cfa436SPoul-Henning Kampdevice eg0 at isa? port 0x310 net irq 5 vector egintr
6646a8d6623SGarrett Wollmandevice el0 at isa? port 0x300 net irq 9 vector elintr
665d41f24e7SDavid Greenmandevice ep0 at isa? port 0x300 net irq 10 vector epintr
666a732b754SJordan K. Hubbarddevice fe0 at isa? port 0x300 net irq ? vector feintr
667d41f24e7SDavid Greenmandevice fea0 at isa? net irq ? vector feaintr
668d41f24e7SDavid Greenmandevice ie0 at isa? port 0x360 net irq 7 iomem 0xd0000 vector ieintr
669ad0c439aSRodney W. Grimesdevice ix0 at isa? port 0x300 net irq 10 iomem 0xd0000 iosiz 32768 vector ixintr
6706a8d6623SGarrett Wollmandevice le0 at isa? port 0x300 net irq 5 iomem 0xd0000 vector le_intr
67163373752SPoul-Henning Kampdevice lnc0 at isa? port 0x300 net irq 10 drq 0 vector lncintr
672ada9d061SJordan K. Hubbarddevice ze0 at isa? port 0x300 net irq 5 iomem 0xd8000 vector zeintr
673648c711bSPoul-Henning Kampdevice zp0 at isa? port 0x300 net irq 10 iomem 0xd8000 vector zpintr
674648c711bSPoul-Henning Kamp
675f4567b9cSJulian Elischer
6761a7c583cSGarrett Wollman#
6776f96f72bSJordan K. Hubbard# ISDN drivers - `isdn'.
6786f96f72bSJordan K. Hubbard#
6791a7c583cSGarrett Wollman# Uncomment one (and only one) of the following two drivers for the appropriate
6806f96f72bSJordan K. Hubbard# ISDN device you have.  For more information on what's considered appropriate
6816f96f72bSJordan K. Hubbard# for your given set of circumstances, please read
6823852c308SAndreas Schulz# /usr/src/gnu/usr.sbin/isdn/docs/INSTALL.  It's a bit sparse at present, but
6833852c308SAndreas Schulz# it's the best we have right now.  The snic driver is also disabled at present,
684a46a6df7SJordan K. Hubbard# waiting for someone to upgrade the driver to 2.0 (it's in /sys/gnu/scsi/).
685a46a6df7SJordan K. Hubbard#
6866f96f72bSJordan K. Hubbarddevice nic0 at isa? port "IO_COM3" iomem 0xe0000 tty irq 9 vector nicintr
6876f96f72bSJordan K. Hubbarddevice nnic0 at isa? port 0x150 iomem 0xe0000 tty irq 12 vector nnicintr
6886f96f72bSJordan K. Hubbard
6896a8d6623SGarrett Wollman#
6901a7c583cSGarrett Wollman# Audio drivers: `snd', `sb', `pas', `gus', `pca'
6916a8d6623SGarrett Wollman#
6921a7c583cSGarrett Wollman# snd: Voxware sound support code
6931a7c583cSGarrett Wollman# sb: SoundBlaster PCM - SoundBlaster, SB Pro, SB16, ProAudioSpectrum
6941a7c583cSGarrett Wollman# sbxvi: SoundBlaster 16
6951a7c583cSGarrett Wollman# sbmidi: SoundBlaster 16 MIDI interface
6961a7c583cSGarrett Wollman# pas: ProAudioSpectrum PCM and MIDI
6971a7c583cSGarrett Wollman# gus: Gravis Ultrasound - Ultrasound, Ultrasound 16, Ultrasound MAX
698a2048b9cSJordan K. Hubbard# gusxvi: Gravis Ultrasound 16-bit PCM	(do not use)
6991a7c583cSGarrett Wollman# mss: Microsoft Sound System
7001a7c583cSGarrett Wollman# opl: Yamaha OPL-2 and OPL-3 FM - SB, SB Pro, SB 16, ProAudioSpectrum
7011a7c583cSGarrett Wollman# uart: stand-alone 6850 UART for MIDI
7021a7c583cSGarrett Wollman# mpu: Roland MPU-401 stand-alone card
7031a7c583cSGarrett Wollman#
7041a7c583cSGarrett Wollman# Beware!  The addresses specified below are also hard-coded in
7051a7c583cSGarrett Wollman# i386/isa/sound/sound_config.h.  If you change the values here, you
7061a7c583cSGarrett Wollman# must also change the values in the include file.
7071a7c583cSGarrett Wollman#
7086a8d6623SGarrett Wollman# pca: PCM audio through your PC speaker
7096a8d6623SGarrett Wollman#
7109cc34748SJordan K. Hubbard# If you don't have a lpt0 device at IRQ 7, you can remove the
7119cc34748SJordan K. Hubbard# ``conflicts'' specification in the appropriate device entries below.
7129cc34748SJordan K. Hubbard#
713d1a599c2SJordan K. Hubbard# If you have a GUS-MAX card and want to use the CS4231 codec on the
714d1a599c2SJordan K. Hubbard# card the drqs for the gus max must be 8 bit (1, 2, or 3).
715d1a599c2SJordan K. Hubbard#
716d1a599c2SJordan K. Hubbard# If you would like to use the full duplex option on the gus, then define
717d1a599c2SJordan K. Hubbard# flags to be the ``read dma channel''.
718d1a599c2SJordan K. Hubbard#
719d1a599c2SJordan K. Hubbard# options BROKEN_BUS_CLOCK	#PAS-16 isn't working and OPTI chipset
720d1a599c2SJordan K. Hubbard# options SYMPHONY_PAS		#PAS-16 isn't working and SYMPHONY chipset
721d1a599c2SJordan K. Hubbard# options EXCLUDE_SBPRO		#PAS-16
722b1529bdaSPeter Wemm# options SBC_IRQ=5		#PAS-16. Must match irq on sb0 line.
723d1a599c2SJordan K. Hubbard# PAS16: The order of the pas0/sb0/opl0 is important since the
724d1a599c2SJordan K. Hubbard#	sb emulation is enabled in the pas-16 attach.
725d1a599c2SJordan K. Hubbard#
726d1a599c2SJordan K. Hubbard# The i386/isa/sound/sound.doc has more information.
727a2048b9cSJordan K. Hubbard
72812fd0853SSteven Wallace# Controls all sound devices
72912fd0853SSteven Wallacecontroller	snd0
730d1a599c2SJordan K. Hubbarddevice pas0     at isa? port 0x388 irq 10 drq 6 vector pasintr
7319cc34748SJordan K. Hubbarddevice sb0      at isa? port 0x220 irq 7 conflicts drq 1 vector sbintr
73212fd0853SSteven Wallacedevice sbxvi0   at isa? drq 5
7330264a8a9SJordan K. Hubbarddevice sbmidi0  at isa? port 0x330
7348e411548SJordan K. Hubbarddevice gus0 at isa? port 0x220 irq 12 drq 1 vector gusintr
7358e411548SJordan K. Hubbard#device gus0 at isa? port 0x220 irq 12 drq 1 flags 0x3 vector gusintr
73612fd0853SSteven Wallacedevice mss0 at isa? port 0x530 irq 10 drq 1 vector adintr
737d1a599c2SJordan K. Hubbarddevice opl0     at isa? port 0x388 conflicts
738a91ccb55SSteven Wallacedevice mpu0     at isa? port 0x330 irq 6 drq 0
73912fd0853SSteven Wallacedevice uart0 at isa? port 0x330 irq 5 vector "m6850intr"
7400897a95dSAndrey A. Chernov
74165e8111fSBruce Evans# More undocumented sound devices with bogus configurations for linting.
74265e8111fSBruce Evans# broken
74365e8111fSBruce Evans#device sscape0  at isa? port 0x330 irq 6 drq 0
74465e8111fSBruce Evans#device trix0    at isa? port 0x330 irq 6 drq 0 vector sscapeintr
74565e8111fSBruce Evans
7461a7c583cSGarrett Wollman# Not controlled by `snd'
747017e602cSAndrey A. Chernovdevice pca0 at isa? port IO_TIMER1 tty
7489ad380abSGarrett Wollman
7496a8d6623SGarrett Wollman#
750567e21c2SBruce Evans# Miscellaneous hardware:
7516a8d6623SGarrett Wollman#
7526a8d6623SGarrett Wollman# mcd: Mitsumi CD-ROM
7532d859864SAndreas Schulz# scd: Sony CD-ROM
75405e1d9d4SJordan K. Hubbard# matcd: Matsushita/Panasonic CD-ROM
7556a8d6623SGarrett Wollman# wt: Wangtek and Archive QIC-02/QIC-36 tape drives
7566a8d6623SGarrett Wollman# ctx: Cortex-I frame grabber
7576a8d6623SGarrett Wollman# apm: Laptop Advanced Power Management (experimental)
7586c5e9bbdSMike Pritchard# spigot: The Creative Labs Video Spigot video-acquisition board
7591d86961eSJordan K. Hubbard# meteor: Matrox Meteor video capture board
76065e8111fSBruce Evans# cy: Cyclades serial driver
761a50cd483SJordan K. Hubbard# dgb: Digiboard PC/Xi and PC/Xe series driver (ALPHA QUALITY!)
7621a7c583cSGarrett Wollman# gp:  National Instruments AT-GPIB and AT-GPIB/TNT board
763a800f455SJulian Elischer# asc: GI1904-based hand scanners, e.g. the Trust Amiscan Grey
7641a7c583cSGarrett Wollman# gsc: Genius GS-4500 hand scanner.
7651a7c583cSGarrett Wollman# joy: joystick
766657e73c4SPeter Dufault# labpc: National Instrument's Lab-PC and Lab-PC+
767d0930614SAndrey A. Chernov# rc: RISCom/8 multiport card
768567e21c2SBruce Evans# tw: TW-523 power line interface for use with X-10 home control products
7690d04cf6aSPeter Wemm# si: Specialix SI/XIO 4-32 port terminal multiplexor
770c9da1b81SPeter Wemm# stl: Stallion EasyIO and EasyConnection 8/32 (cd1400 based)
771c9da1b81SPeter Wemm# stli: Stallion EasyConnection 8/64, ONboard, Brumby (intelligent)
772657e73c4SPeter Dufault
7736a8d6623SGarrett Wollman#
774e597b497SNate Williams# Notes on APM
775e597b497SNate Williams#  Some APM implementations will not work with the `statistics clock'
776e597b497SNate Williams#  enabled, so it's disabled by default if the APM driver is enabled.
777e597b497SNate Williams#  However, this is not true for all laptops.  Try removing the option
778e597b497SNate Williams#  APM_BROKEN_STATCLOCK and see if suspend/resume work
779e597b497SNate Williams#
780e597b497SNate Williams
781e597b497SNate Williams#
7822cd01159SJordan K. Hubbard# Notes on the spigot:
7832cd01159SJordan K. Hubbard#  The video spigot is at 0xad6.  This port address can not be changed.
7842cd01159SJordan K. Hubbard#  The irq values may only be 10, 11, or 15
7852cd01159SJordan K. Hubbard#  I/O memory is an 8kb region.  Possible values are:
7862cd01159SJordan K. Hubbard#    0a0000, 0a2000, ..., 0fffff, f00000, f02000, ..., ffffff
787d01b6680SJordan K. Hubbard#    The start address must be on an even boundary.
788d01b6680SJordan K. Hubbard#  Add the following option if you want to allow non-root users to be able
789d01b6680SJordan K. Hubbard#  to access the spigot.  This option is not secure because it allows users
790d01b6680SJordan K. Hubbard#  direct access to the I/O page.
791d01b6680SJordan K. Hubbard#  	options SPIGOT_UNSECURE
792d01b6680SJordan K. Hubbard#
7938819d6ecSPoul-Henning Kamp
794a50cd483SJordan K. Hubbard# Notes on the Digiboard driver:
795a50cd483SJordan K. Hubbard#
796a50cd483SJordan K. Hubbard# The following flag values have special meanings:
797a50cd483SJordan K. Hubbard#	0x01 - alternate layout of pins
798a50cd483SJordan K. Hubbard#	0x02 - use the windowed PC/Xe in 64K mode
7990d04cf6aSPeter Wemm
8000d04cf6aSPeter Wemm# Notes on the Specialix SI/XIO driver:
801c4823710SPeter Wemm#  **This is NOT a Specialix supported Driver!**
802c4823710SPeter Wemm#  The host card is memory, not IO mapped.
803c4823710SPeter Wemm#  The Rev 1 host cards use a 64K chunk, on a 32K boundary.
804c4823710SPeter Wemm#  The Rev 2 host cards use a 32K chunk, on a 32K boundary.
805c4823710SPeter Wemm#  The cards can use an IRQ of 11, 12 or 15.
806c4823710SPeter Wemm
807c9da1b81SPeter Wemm# Notes on the Stallion stl and stli drivers:
808c9da1b81SPeter Wemm#  See src/i386/isa/README.stl for complete instructions.
809c9da1b81SPeter Wemm#  This is version 0.0.5alpha, unsupported by Stallion.
810c9da1b81SPeter Wemm#  The stl driver has a secondary IO port hard coded at 0x280.  You need
811c9da1b81SPeter Wemm#     to change src/i386/isa/stallion.c if you reconfigure this on the boards.
812c9da1b81SPeter Wemm#  The "flags" and "iosiz" settings on the stli driver depend on the board:
813c9da1b81SPeter Wemm#	EasyConnection 8/64 ISA:     flags 23         iosiz 0x1000
814c9da1b81SPeter Wemm#	EasyConnection 8/64 EISA:    flags 24         iosiz 0x10000
815c9da1b81SPeter Wemm#	EasyConnection 8/64 MCA:     flags 25         iosiz 0x1000
816c9da1b81SPeter Wemm#	ONboard ISA:                 flags 4          iosiz 0x10000
817c9da1b81SPeter Wemm#	ONboard EISA:                flags 7          iosiz 0x10000
818c9da1b81SPeter Wemm#	ONboard MCA:                 flags 3          iosiz 0x10000
819c9da1b81SPeter Wemm#	Brumby:                      flags 2          iosiz 0x4000
820c9da1b81SPeter Wemm#	Stallion:                    flags 1          iosiz 0x10000
821c9da1b81SPeter Wemm
8226a8d6623SGarrett Wollmandevice		mcd0	at isa? port 0x300 bio irq 10 vector mcdintr
82305e1d9d4SJordan K. Hubbard# for the Sony CDU31/33A CDROM
8242d859864SAndreas Schulzdevice		scd0	at isa? port 0x230 bio
8256c5e9bbdSMike Pritchard# for the SoundBlaster 16 multicd - up to 4 devices
8269720b084SJordan K. Hubbardcontroller      matcd0  at isa? port 0x230 bio
8276a8d6623SGarrett Wollmandevice		wt0	at isa? port 0x300 bio irq 5 drq 1 vector wtintr
8286a8d6623SGarrett Wollmandevice		ctx0	at isa? port 0x230 iomem 0xd0000
8292cd01159SJordan K. Hubbarddevice		spigot0 at isa? port 0xad6 irq 15 iomem 0xee000 vector spigintr
8304cf62360SPaul Trainadevice		qcam0	at isa? port "IO_LPT3" tty
8316a8d6623SGarrett Wollmandevice		apm0	at isa?
832e597b497SNate Williamsoptions		APM_BROKEN_STATCLOCK
8331a7c583cSGarrett Wollmandevice		gp0	at isa? port 0x2c0 tty
8341a7c583cSGarrett Wollmandevice		gsc0	at isa? port "IO_GSC1" tty drq 3
8351a7c583cSGarrett Wollmandevice		joy0	at isa? port "IO_GAME"
83665e8111fSBruce Evansdevice		cy0	at isa? tty irq 10 iomem 0xd4000 iosiz 0x2000 vector cyintr
837a50cd483SJordan K. Hubbarddevice		dgb0	at isa? port 0x220 iomem 0xfc0000 iosiz ? tty
838657e73c4SPeter Dufaultdevice		labpc0	at isa? port 0x260 tty irq 5 vector labpcintr
839d0930614SAndrey A. Chernovdevice          rc0     at isa? port 0x220 tty irq 12 vector rcintr
840567e21c2SBruce Evans# the port and irq for tw0 are fictitious
841567e21c2SBruce Evansdevice          tw0     at isa? port 0x380 tty irq 11 vector twintr
842c4823710SPeter Wemmdevice		si0	at isa? iomem 0xd0000 tty irq 12 vector siintr
843a800f455SJulian Elischerdevice		asc0	at isa? port IO_ASC1 tty drq 3 irq 10 vector ascintr
84465e8111fSBruce Evansdevice		bqu0	at isa? port 0x150
845c9da1b81SPeter Wemmdevice		stl0	at isa? port 0x2a0 tty irq 10 vector stlintr
846c9da1b81SPeter Wemmdevice		stli0	at isa? port 0x2a0 tty iomem 0xcc000 flags 23 iosiz 0x1000
847a800f455SJulian Elischer
848eeb706c0SJustin T. Gibbs#
849eeb706c0SJustin T. Gibbs# EISA devices:
850eeb706c0SJustin T. Gibbs#
851eeb706c0SJustin T. Gibbs# The EISA bus device is eisa0.  It provides auto-detection and
852eeb706c0SJustin T. Gibbs# configuration support for all devices on the EISA bus.
853eeb706c0SJustin T. Gibbs#
854e56e7036SJustin T. Gibbs# The `ahb' device provides support for the Adaptec 174X adapter.
855e56e7036SJustin T. Gibbs#
856eeb706c0SJustin T. Gibbs# The `ahc' device provides support for the Adaptec 274X and 284X
857eeb706c0SJustin T. Gibbs# adapters.  The 284X, although a VLB card responds to EISA probes.
858eeb706c0SJustin T. Gibbs#
859eeb706c0SJustin T. Gibbscontroller	eisa0
860e56e7036SJustin T. Gibbscontroller	ahb0
861eeb706c0SJustin T. Gibbscontroller	ahc0
8626a8d6623SGarrett Wollman
8636a8d6623SGarrett Wollman#
8646a8d6623SGarrett Wollman# PCI devices:
8656a8d6623SGarrett Wollman#
8666a8d6623SGarrett Wollman# The main PCI bus device is `pci'.  It provides auto-detection and
8676a8d6623SGarrett Wollman# configuration support for all devices on the PCI bus, using either
8686a8d6623SGarrett Wollman# configuration mode defined in the PCI specification.
8696a8d6623SGarrett Wollman#
870eeb706c0SJustin T. Gibbs# The `ahc' device provides support for the Adaptec 29/3940(U)(W)
871eeb706c0SJustin T. Gibbs# and motherboard based AIC7870/AIC7880 adapters.
872eeb706c0SJustin T. Gibbs#
8736a8d6623SGarrett Wollman# The `ncr' device provides support for the NCR 53C810 and 53C825
8746a8d6623SGarrett Wollman# self-contained SCSI host adapters.
8756a8d6623SGarrett Wollman#
8766a8d6623SGarrett Wollman# The `de' device provides support for the Digital Equipment DC21040
8776a8d6623SGarrett Wollman# self-contained Ethernet adapter.
8786a8d6623SGarrett Wollman#
8795ccfdea2SAndreas Schulz# The `vx' device provides support for the 3Com 3C590 and 3C595
880f4567b9cSJulian Elischer# early support
881f4567b9cSJulian Elischer#
882d41f24e7SDavid Greenman# The `fpa' device provides support for the Digital DEFPA PCI FDDI
883d41f24e7SDavid Greenman# adapter. pseudo-device fddi is also needed.
884d41f24e7SDavid Greenman#
885bba9a7a0SGarrett Wollman# The `meteor' device is a PCI video capture board. It can also have the
8861d86961eSJordan K. Hubbard# following options:
887b1529bdaSPeter Wemm#   options METEOR_ALLOC_PAGES=xxx	preallocate kernel pages for data entry
8881d86961eSJordan K. Hubbard#	figure (ROWS*COLUMN*BYTES_PER_PIXEL*FRAME+PAGE_SIZE-1)/PAGE_SIZE
8891d86961eSJordan K. Hubbard#   options METEOR_DEALLOC_PAGES	remove all allocated pages on close(2)
890b1529bdaSPeter Wemm#   options METEOR_DEALLOC_ABOVE=xxx	remove all allocated pages above the
8911d86961eSJordan K. Hubbard#	specified amount. If this value is below the allocated amount no action
8921d86961eSJordan K. Hubbard#	taken
893734d08a2SJordan K. Hubbard#   option METEOR_SYSTEM_DEFAULT={METEOR_PAL|METEOR_NTSC|METEOR_SECAM}, used
894734d08a2SJordan K. Hubbard#	for initialization of fps routine when a signal is not present.
8951d86961eSJordan K. Hubbard#
8966a8d6623SGarrett Wollmancontroller	pci0
897eeb706c0SJustin T. Gibbscontroller	ahc1
8986a8d6623SGarrett Wollmandevice		ncr0
8996a8d6623SGarrett Wollmandevice		de0
90017acc2b2SDavid Greenmandevice		fxp0
9015ccfdea2SAndreas Schulzdevice		vx0
902d41f24e7SDavid Greenmandevice		fpa0
9031d86961eSJordan K. Hubbarddevice		meteor0
904446cee6eSJoerg Wunsch
905dc9deb29SPoul-Henning Kamp
906dc9deb29SPoul-Henning Kamp#
907dc9deb29SPoul-Henning Kamp# PCCARD/PCMCIA
908dc9deb29SPoul-Henning Kamp#
90913cbd355SNate Williams# crd: slot controller
91013cbd355SNate Williams# pcic: slots
911dc9deb29SPoul-Henning Kampcontroller	crd0
912dc9deb29SPoul-Henning Kampcontroller	pcic0 at crd?
91313cbd355SNate Williamscontroller	pcic1 at crd?
914dc9deb29SPoul-Henning Kamp
915446cee6eSJoerg Wunsch#
916446cee6eSJoerg Wunsch# Laptop/Notebook options:
917446cee6eSJoerg Wunsch#
918446cee6eSJoerg Wunsch# See also:
9196c5e9bbdSMike Pritchard#  apm under `Miscellaneous hardware'
920446cee6eSJoerg Wunsch#  options		PSM_NO_RESET  for the `psm' driver
921446cee6eSJoerg Wunsch# above.
922446cee6eSJoerg Wunsch
923446cee6eSJoerg Wunsch# For older notebooks that signal a powerfail condition (external
924446cee6eSJoerg Wunsch# power supply dropped, or battery state low) by issuing an NMI:
925446cee6eSJoerg Wunsch
926446cee6eSJoerg Wunschoptions		POWERFAIL_NMI	# make it beep instead of panicing
92765e8111fSBruce Evans
92865e8111fSBruce Evans# More undocumented options for linting.
92994c94804SBruce Evans
930439187deSBruce Evansoptions		DEBUG
93194c94804SBruce Evansoptions		"EXT2FS"
93265e8111fSBruce Evansoptions		"IBCS2"
933f3e002a8SPoul-Henning Kampoptions		COMPAT_LINUX
934c01db44aSBruce Evansoptions		"SCSI_2_DEF"
935b1529bdaSPeter Wemmoptions		SHOW_BUSYBUFS	# List buffers that prevent root unmount
936