NOTES revision 171196
1111314Snyan#
2111314Snyan# NOTES -- Lines that can be cut/pasted into kernel and hints configs.
3111314Snyan#
4111314Snyan# This file contains machine dependent kernel configuration notes.  For
5111314Snyan# machine independent notes, look in /sys/conf/NOTES.
6111314Snyan#
7111314Snyan# $FreeBSD: head/sys/pc98/conf/NOTES 171196 2007-07-04 00:18:39Z bz $
8111314Snyan#
9111314Snyan
10125234Snyan#
11127520Snyan# We want LINT to cover profiling as well.
12111314Snyanprofile         2
13111314Snyan
14111314Snyan
15111314Snyan#####################################################################
16111314Snyan# SMP OPTIONS:
17111314Snyan#
18122755Snyan# The apic device enables the use of the I/O APIC for interrupt delivery.
19122755Snyan# The apic device can be used in both UP and SMP kernels, but is required
20122755Snyan# for SMP kernels.  Thus, the apic device is not strictly an SMP option,
21122755Snyan# but it is a prerequisite for SMP.
22111314Snyan#
23111314Snyan
24111314Snyan# Mandatory:
25122056Snyandevice		apic			# I/O apic
26124795Snyan
27142783Snyan#
28142783Snyan# Watchdog routines.
29142783Snyan#
30142783Snyanoptions 	MP_WATCHDOG
31142783Snyan
32145743Snyan# Debugging options.
33145743Snyan#
34151634Sjhboptions		STOP_NMI		# Stop CPUS using NMI instead of IPI
35145743Snyan
36145743Snyan
37111314Snyan
38111314Snyan#####################################################################
39111314Snyan# CPU OPTIONS
40111314Snyan
41111314Snyan#
42111314Snyan# You must specify at least one CPU (the one you intend to run on);
43111314Snyan# deleting the specification for CPUs you don't need to use may make
44111314Snyan# parts of the system run faster.
45111314Snyan#
46111314Snyancpu		I486_CPU
47111314Snyancpu		I586_CPU		# aka Pentium(tm)
48111314Snyancpu		I686_CPU		# aka Pentium Pro(tm)
49111314Snyan
50111314Snyan#
51111314Snyan# Options for CPU features.
52111314Snyan#
53124795Snyan# CPU_BLUELIGHTNING_3X enables triple-clock mode on IBM Blue Lightning
54124795Snyan# CPU if CPU supports it.  The default is double-clock mode on
55124795Snyan# BlueLightning CPU box.
56124795Snyan#
57111314Snyan# CPU_BLUELIGHTNING_FPU_OP_CACHE enables FPU operand cache on IBM
58111314Snyan# BlueLightning CPU.  It works only with Cyrix FPU, and this option
59111314Snyan# should not be used with Intel FPU.
60111314Snyan#
61111314Snyan# CPU_BTB_EN enables branch target buffer on Cyrix 5x86 (NOTE 1).
62111314Snyan#
63111314Snyan# CPU_CYRIX_NO_LOCK enables weak locking for the entire address space
64111314Snyan# of Cyrix 6x86 and 6x86MX CPUs by setting the NO_LOCK bit of CCR1.
65111314Snyan# Otherwise, the NO_LOCK bit of CCR1 is cleared.  (NOTE 3)
66111314Snyan#
67124795Snyan# CPU_DIRECT_MAPPED_CACHE sets L1 cache of Cyrix 486DLC CPU in direct
68124795Snyan# mapped mode.  Default is 2-way set associative mode.
69124795Snyan#
70127520Snyan# CPU_DISABLE_5X86_LSSER disables load store serialize (i.e., enables
71111314Snyan# reorder).  This option should not be used if you use memory mapped
72111314Snyan# I/O device(s).
73111314Snyan#
74125234Snyan# CPU_DISABLE_CMPXCHG disables the CMPXCHG instruction on > i386 IA32
75137526Snyan# machines.  VmWare 3.x seems to emulate this instruction poorly, causing
76137526Snyan# the guest OS to run very slowly.  This problem appears to be fixed in
77137526Snyan# VmWare 4.x, at least in version 4.5.2, so that enabling this option with
78137526Snyan# VmWare 4.x will result in locking operations to be 20-30 times slower.
79137526Snyan# Enabling this with an SMP kernel will cause the kernel to be unusable.
80124795Snyan#
81127520Snyan# CPU_DISABLE_SSE explicitly prevents I686_CPU from turning on SSE.
82124795Snyan#
83111314Snyan# CPU_FASTER_5X86_FPU enables faster FPU exception handler.
84111314Snyan#
85111314Snyan# CPU_I486_ON_386 enables CPU cache on i486 based CPU upgrade products
86111314Snyan# for i386 machines.
87111314Snyan#
88111314Snyan# CPU_IORT defines I/O clock delay time (NOTE 1).  Default values of
89111314Snyan# I/O clock delay time on Cyrix 5x86 and 6x86 are 0 and 7,respectively
90111314Snyan# (no clock delay).
91111314Snyan#
92125234Snyan# CPU_L2_LATENCY specifies the L2 cache latency value.  This option is used
93111314Snyan# only when CPU_PPRO2CELERON is defined and Mendocino Celeron is detected.
94111314Snyan# The default value is 5.
95111314Snyan#
96111314Snyan# CPU_LOOP_EN prevents flushing the prefetch buffer if the destination
97111314Snyan# of a jump is already present in the prefetch buffer on Cyrix 5x86(NOTE
98111314Snyan# 1).
99111314Snyan#
100111314Snyan# CPU_PPRO2CELERON enables L2 cache of Mendocino Celeron CPUs.  This option
101111314Snyan# is useful when you use Socket 8 to Socket 370 converter, because most Pentium
102111314Snyan# Pro BIOSs do not enable L2 cache of Mendocino Celeron CPUs.
103111314Snyan#
104111314Snyan# CPU_RSTK_EN enables return stack on Cyrix 5x86 (NOTE 1).
105111314Snyan#
106111314Snyan# CPU_SUSP_HLT enables suspend on HALT.  If this option is set, CPU
107111314Snyan# enters suspend mode following execution of HALT instruction.
108111314Snyan#
109111314Snyan# CPU_UPGRADE_HW_CACHE eliminates unneeded cache flush instruction(s).
110111314Snyan#
111111314Snyan# CPU_WT_ALLOC enables write allocation on Cyrix 6x86/6x86MX and AMD
112125234Snyan# K5/K6/K6-2 CPUs.
113111314Snyan#
114111314Snyan# CYRIX_CACHE_WORKS enables CPU cache on Cyrix 486 CPUs with cache
115111314Snyan# flush at hold state.
116111314Snyan#
117111314Snyan# CYRIX_CACHE_REALLY_WORKS enables (1) CPU cache on Cyrix 486 CPUs
118111314Snyan# without cache flush at hold state, and (2) write-back CPU cache on
119111314Snyan# Cyrix 6x86 whose revision < 2.7 (NOTE 2).
120111314Snyan#
121111314Snyan# NO_F00F_HACK disables the hack that prevents Pentiums (and ONLY
122111314Snyan# Pentiums) from locking up when a LOCK CMPXCHG8B instruction is
123111314Snyan# executed.  This option is only needed if I586_CPU is also defined,
124111314Snyan# and should be included for any non-Pentium CPU that defines it.
125111314Snyan#
126111314Snyan# NO_MEMORY_HOLE is an optimisation for systems with AMD K6 processors
127111314Snyan# which indicates that the 15-16MB range is *definitely* not being
128111314Snyan# occupied by an ISA memory hole.
129111314Snyan#
130111314Snyan# NOTE 1: The options, CPU_BTB_EN, CPU_LOOP_EN, CPU_IORT,
131111314Snyan# CPU_LOOP_EN and CPU_RSTK_EN should not be used because of CPU bugs.
132111314Snyan# These options may crash your system.
133111314Snyan#
134111314Snyan# NOTE 2: If CYRIX_CACHE_REALLY_WORKS is not set, CPU cache is enabled
135111314Snyan# in write-through mode when revision < 2.7.  If revision of Cyrix
136111314Snyan# 6x86 >= 2.7, CPU cache is always enabled in write-back mode.
137111314Snyan#
138111314Snyan# NOTE 3: This option may cause failures for software that requires
139111314Snyan# locked cycles in order to operate correctly.
140111314Snyan#
141124795Snyanoptions 	CPU_BLUELIGHTNING_3X
142111314Snyanoptions 	CPU_BLUELIGHTNING_FPU_OP_CACHE
143111314Snyanoptions 	CPU_BTB_EN
144111314Snyanoptions 	CPU_DIRECT_MAPPED_CACHE
145111314Snyanoptions 	CPU_DISABLE_5X86_LSSER
146124795Snyanoptions 	CPU_DISABLE_CMPXCHG
147124795Snyan#options 	CPU_DISABLE_SSE
148111314Snyanoptions 	CPU_FASTER_5X86_FPU
149111314Snyanoptions 	CPU_I486_ON_386
150111314Snyanoptions 	CPU_IORT
151111314Snyanoptions 	CPU_L2_LATENCY=5
152111314Snyanoptions 	CPU_LOOP_EN
153111314Snyanoptions 	CPU_PPRO2CELERON
154111314Snyanoptions 	CPU_RSTK_EN
155111314Snyanoptions 	CPU_SUSP_HLT
156111314Snyanoptions 	CPU_UPGRADE_HW_CACHE
157111314Snyanoptions 	CPU_WT_ALLOC
158111314Snyanoptions 	CYRIX_CACHE_WORKS
159111314Snyanoptions 	CYRIX_CACHE_REALLY_WORKS
160111314Snyan#options 	NO_F00F_HACK
161111314Snyan
162111314Snyan# Debug options
163124795Snyanoptions 	NPX_DEBUG	# enable npx debugging
164111314Snyan
165111314Snyan#
166111314Snyan# PERFMON causes the driver for Pentium/Pentium Pro performance counters
167111314Snyan# to be compiled.  See perfmon(4) for more information.
168111314Snyan#
169111314Snyanoptions 	PERFMON
170111314Snyan
171111314Snyan
172111314Snyan#####################################################################
173111314Snyan# NETWORKING OPTIONS
174111314Snyan
175111314Snyan#
176111314Snyan# DEVICE_POLLING adds support for mixed interrupt-polling handling
177111314Snyan# of network device drivers, which has significant benefits in terms
178111314Snyan# of robustness to overloads and responsivity, as well as permitting
179111314Snyan# accurate scheduling of the CPU time between kernel network processing
180124795Snyan# and other activities.  The drawback is a moderate (up to 1/HZ seconds)
181111314Snyan# potential increase in response times.
182111314Snyan# It is strongly recommended to use HZ=1000 or 2000 with DEVICE_POLLING
183111314Snyan# to achieve smoother behaviour.
184151051Sglebius# Additionally, you can enable/disable polling at runtime with help of
185151051Sglebius# the ifconfig(8) utility, and select the CPU fraction reserved to
186151051Sglebius# userland with the sysctl variable kern.polling.user_frac
187151051Sglebius# (default 50, range 0..100).
188111314Snyan#
189124408Snyan# Not all device drivers support this mode of operation at the time of
190124408Snyan# this writing.  See polling(4) for more details.
191111314Snyan
192111314Snyanoptions 	DEVICE_POLLING
193111314Snyan
194111314Snyan
195111314Snyan#####################################################################
196111314Snyan# CLOCK OPTIONS
197111314Snyan
198111314Snyan# The following options are used for debugging clock behavior only, and
199111314Snyan# should not be used for production systems.
200111314Snyan
201123984Sbde# CLK_CALIBRATION_LOOP causes clock calibration to be run in a loop at
202123984Sbde# startup until the user presses a key.  (The i8254 clock is always
203123984Sbde# calibrated relative to the RTC (mc146818a) and this option causes the
204123984Sbde# calibration to be repeated.)
205111314Snyanoptions 	CLK_CALIBRATION_LOOP
206111314Snyan
207123984Sbde# CLK_USE_I8254_CALIBRATION causes the calibrated frequency of the i8254
208123984Sbde# clock to actually be used.
209111314Snyanoptions 	CLK_USE_I8254_CALIBRATION
210111314Snyan
211111314Snyan
212111314Snyan#####################################################################
213111314Snyan# MISCELLANEOUS DEVICES AND OPTIONS
214111314Snyan
215160813Smarcel# 
216160813Smarcel# sio: serial ports (see sio(4)), including support for various
217163494Simp#      PC Card devices, such as Modem and NICs
218160813Smarcel#
219160813Smarceldevice		sio
220160813Smarcelhint.sio.0.at="isa"
221160813Smarcelhint.sio.0.port="0x3F8"
222160813Smarcelhint.sio.0.flags="0x10"
223160813Smarcelhint.sio.0.irq="4"
224160813Smarcel
225160813Smarcel# `flags' specific to sio(4).
226160813Smarcel#	0x10	enable console support for this unit.  Other console flags
227160813Smarcel#		(if applicable) are ignored unless this is set.  Enabling
228160813Smarcel#		console support does not make the unit the preferred console.
229160813Smarcel#		Boot with -h or set boot_serial=YES in the loader.  For sio(4)
230160813Smarcel#		specifically, the 0x20 flag can also be set (see above).
231160813Smarcel#		Currently, at most one unit can have console support; the
232160813Smarcel#		first one (in config file order) with this flag set is
233160813Smarcel#		preferred.  Setting this flag for sio0 gives the old behaviour.
234160813Smarcel#	0x20	force this unit to be the console (unless there is another
235160813Smarcel#		higher priority console).  This replaces the COMCONSOLE option.
236160813Smarcel#	0x40	reserve this unit for low level console operations.  Do not
237160813Smarcel#		access the device in any normal way.
238160813Smarcel#	0x80	use this port for serial line gdb support in ddb.  Also known
239160813Smarcel#		as debug port.
240160813Smarcel# PnP `flags'
241160813Smarcel#	0x1	disable probing of this device.  Used to prevent your modem
242160813Smarcel#		from being attached as a PnP modem.
243160813Smarcel# Other flags for sio that aren't documented in the man page.
244160813Smarcel#	0x20000	enable hardware RTS/CTS and larger FIFOs.  Only works for
245160813Smarcel#		ST16650A-compatible UARTs.
246160813Smarcel
247160813Smarcel# Options for sio:
248160813Smarceloptions 	COM_ESP			# Code for Hayes ESP.
249160813Smarceloptions 	COM_MULTIPORT		# Code for some cards with shared IRQs.
250160813Smarceloptions 	CONSPEED=115200		# Speed for serial console
251160813Smarcel					# (default 9600).
252160813Smarcel
253111314Snyandevice		speaker		#Play IBM BASIC-style noises out your speaker
254111314Snyanhint.speaker.0.at="isa"
255111314Snyanhint.speaker.0.port="0x35"
256124795Snyandevice		gzip		#Exec gzipped a.out's.  REQUIRES COMPAT_AOUT!
257111314Snyandevice		apm_saver	# Requires APM
258111314Snyan
259111314Snyan
260111314Snyan#####################################################################
261111314Snyan# HARDWARE BUS CONFIGURATION
262111314Snyan
263111314Snyan#
264111314Snyan# ISA bus
265111314Snyan#
266111314Snyandevice		isa
267111314Snyan
268111314Snyan#
269111314Snyan# Options for `isa':
270111314Snyan#
271111314Snyan# AUTO_EOI_1 enables the `automatic EOI' feature for the master 8259A
272111314Snyan# interrupt controller.  This saves about 0.7-1.25 usec for each interrupt.
273111314Snyan# This option breaks suspend/resume on some portables.
274111314Snyan#
275111314Snyan# MAXMEM specifies the amount of RAM on the machine; if this is not
276111314Snyan# specified, FreeBSD will first read the amount of memory from the CMOS
277111314Snyan# RAM, so the amount of memory will initially be limited to 64MB or 16MB
278111314Snyan# depending on the BIOS.  If the BIOS reports 64MB, a memory probe will
279111314Snyan# then attempt to detect the installed amount of RAM.  If this probe
280111314Snyan# fails to detect >64MB RAM you will have to use the MAXMEM option.
281111314Snyan# The amount is in kilobytes, so for a machine with 128MB of RAM, it would
282111314Snyan# be 131072 (128 * 1024).
283111314Snyan#
284111314Snyan# BROKEN_KEYBOARD_RESET disables the use of the keyboard controller to
285111314Snyan# reset the CPU for reboot.  This is needed on some systems with broken
286111314Snyan# keyboard controllers.
287111314Snyan
288111314Snyanoptions 	AUTO_EOI_1
289111314Snyan
290111314Snyanoptions 	MAXMEM=(128*1024)
291111314Snyan#options 	BROKEN_KEYBOARD_RESET
292111314Snyanoptions 	EPSON_BOUNCEDMA
293111314Snyanoptions 	EPSON_MEMWIN
294111314Snyan
295111314Snyan#
296111314Snyan# PCI bus & PCI options:
297111314Snyan#
298111314Snyandevice		pci
299111314Snyan
300111314Snyan#
301111314Snyan# AGP GART support
302111314Snyandevice		agp
303111314Snyan
304111314Snyan
305111314Snyan#####################################################################
306111314Snyan# HARDWARE DEVICE CONFIGURATION
307111314Snyan
308111314Snyan# PC98 keyboard
309111314Snyandevice		pckbd
310111314Snyanhint.pckbd.0.at="isa"
311111314Snyanhint.pckbd.0.port="0x041"
312111314Snyanhint.pckbd.0.irq="1"
313111314Snyan
314111314Snyan# GDC screen
315111314Snyandevice		gdc
316111314Snyanhint.gdc.0.at="isa"
317111314Snyanoptions 	LINE30
318111314Snyan
319111314Snyan#
320131815Snyan# The Numeric Processing eXtension driver.  This is non-optional.
321111314Snyandevice		npx
322111314Snyan
323111314Snyan#
324111314Snyan# `flags' for npx0:
325111314Snyan#	0x01	don't use the npx registers to optimize bcopy.
326111314Snyan#	0x02	don't use the npx registers to optimize bzero.
327111314Snyan#	0x04	don't use the npx registers to optimize copyin or copyout.
328111314Snyan# The npx registers are normally used to optimize copying and zeroing when
329111314Snyan# all of the following conditions are satisfied:
330111314Snyan#	I586_CPU is an option
331111314Snyan#	the cpu is an i586 (perhaps not a Pentium)
332111314Snyan#	the probe for npx0 succeeds
333111314Snyan#	INT 16 exception handling works.
334111314Snyan# Then copying and zeroing using the npx registers is normally 30-100% faster.
335111314Snyan# The flags can be used to control cases where it doesn't work or is slower.
336140371Sru# Setting them at boot time using hints works right (the optimizations
337111314Snyan# are not used until later in the bootstrap when npx0 is attached).
338111314Snyan# Flag 0x08 automatically disables the i586 optimized routines.
339111314Snyan#
340111314Snyan
341111314Snyan#
342111314Snyan# Optional devices:
343111314Snyan#
344111314Snyan
345124795Snyan# 3Dfx Voodoo Graphics, Voodoo II /dev/3dfx CDEV support.  This will create
346124795Snyan# the /dev/3dfx0 device to work with glide implementations.  This should get
347124795Snyan# linked to /dev/3dfx and /dev/voodoo.  Note that this is not the same as
348111314Snyan# the tdfx DRI module from XFree86 and is completely unrelated.
349111314Snyan#
350111314Snyan# To enable Linuxulator support, one must also include COMPAT_LINUX in the
351156272Snyan# config as well.  The other option is to load both as modules.
352111314Snyan
353126708Snyandevice		tdfx			# Enable 3Dfx Voodoo support
354156272Snyandevice		tdfx_linux		# Enable Linuxulator support
355111314Snyan
356145183Snyan# Direct Rendering modules for 3D acceleration.
357145183Snyandevice		drm		# DRM core module required by DRM drivers
358145183Snyandevice		mach64drm	# ATI Rage Pro, Rage Mobility P/M, Rage XL
359145183Snyandevice		mgadrm		# AGP Matrox G200, G400, G450, G550
360145183Snyandevice		r128drm		# ATI Rage 128
361148235Snyandevice		radeondrm	# ATI Radeon
362152952Snyandevice		savagedrm	# S3 Savage3D, Savage4
363145183Snyandevice		sisdrm		# SiS 300/305, 540, 630
364145183Snyandevice		tdfxdrm		# 3dfx Voodoo 3/4/5 and Banshee
365145183Snyanoptions 	DRM_DEBUG	# Include debug printfs (slow)
366111314Snyan
367111314Snyan#
368111314Snyan# Bus mouse
369111314Snyan#
370111314Snyandevice		mse
371111314Snyanhint.mse.0.at="isa"
372111314Snyanhint.mse.0.port="0x7fd9"
373111314Snyanhint.mse.0.irq="13"
374111314Snyan
375111314Snyan#
376111314Snyan# Network interfaces:
377111314Snyan#
378111314Snyan
379111314Snyan# ar:   Arnet SYNC/570i hdlc sync 2/4 port V.35/X.21 serial driver
380111314Snyan#       (requires sppp)
381158357Snyan# ath:  Atheros a/b/g WiFi adapters (requires ath_hal and wlan)
382155215Snyan# ce:   Cronyx Tau-PCI/32 sync single/dual port G.703/E1 serial adaptor
383155215Snyan#       with 32 HDLC subchannels (requires sppp (default), or NETGRAPH if
384155215Snyan#       NETGRAPH_CRONYX is configured)
385129384Snyan# cp:   Cronyx Tau-PCI sync single/dual/four port
386129384Snyan#       V.35/RS-232/RS-530/RS-449/X.21/G.703/E1/E3/T3/STS-1
387129384Snyan#       serial adaptor (requires sppp (default), or NETGRAPH if
388129384Snyan#       NETGRAPH_CRONYX is configured)
389153581Simp# cs:   IBM Etherjet and other Crystal Semi CS89x0-based adapters and pccard
390111314Snyan# ed:   Western Digital and SMC 80xx; Novell NE1000 and NE2000; 3Com 3C503
391150555Simp#       HP PC Lan+, various PC Card devices
392111314Snyan#       (requires miibus)
393111314Snyan# ie:   AT&T StarLAN 10 and EN100; 3Com 3C507; unknown NI5210;
394111314Snyan#       Intel EtherExpress
395126708Snyan# oltr: Olicom ISA token-ring adapters OC-3115, OC-3117, OC-3118 and OC-3133.
396111314Snyan#       Olicom PCI token-ring adapters OC-3136, OC-3137, OC-3139, OC-3140,
397126708Snyan#       OC-3141, OC-3540 and OC-3250.
398159549Sjhb# ral:	Ralink Technology IEEE 802.11 wireless adapter
399126708Snyan# sbni: Granch SBNI12-xx ISA and PCI adapters
400111314Snyan# sr:   RISCom/N2 hdlc sync 1/2 port V.35/X.21 serial driver (requires sppp)
401159549Sjhb# ural:	Ralink Technology RT2500USB IEEE 802.11 wireless adapter
402111314Snyan
403111314Snyan# Order for ISA/EISA devices is important here
404111314Snyan
405111314Snyandevice		ar
406155215Snyandevice		ce
407129384Snyandevice		cp
408153581Simpdevice		cs
409111314Snyandevice		ed
410111314Snyanhint.ed.0.at="isa"
411111314Snyanhint.ed.0.port="0x280"
412111314Snyanhint.ed.0.irq="5"
413111314Snyanhint.ed.0.maddr="0xd8000"
414112840Smdodddevice		ie			# Hints only required for Starlan
415112840Smdoddhint.ie.2.at="isa"
416112840Smdoddhint.ie.2.port="0x300"
417112840Smdoddhint.ie.2.irq="5"
418112840Smdoddhint.ie.2.maddr="0xd0000"
419158712Smarius# Hint for the PC98-only C-NET(98)S C-bus front-end of le(4).
420158712Smariushint.le.0.at="isa"
421158712Smariushint.le.0.port="0x03d0"
422158712Smariushint.le.0.irq="6"
423159549Sjhbdevice		oltr
424159549Sjhbdevice		ral
425111314Snyandevice		sbni
426111314Snyanhint.sbni.0.at="isa"
427111314Snyanhint.sbni.0.port="0x210"
428111314Snyanhint.sbni.0.irq="0xefdead"
429111314Snyanhint.sbni.0.flags="0"
430111314Snyandevice		snc
431111314Snyanhint.snc.0.at="isa"
432111314Snyanhint.snc.0.port="0x888"
433111314Snyanhint.snc.0.irq="6"
434111314Snyanhint.snc.0.maddr="0xc0000"
435111314Snyandevice		sr
436159549Sjhbdevice		ural
437111314Snyan
438158357Snyandevice		ath
439158357Snyandevice		ath_hal		# Atheros HAL (includes binary component)
440158357Snyan#device		ath_rate_amrr	# AMRR rate control for ath driver
441158357Snyan#device		ath_rate_onoe	# Onoe rate control for ath driver
442158357Snyandevice		ath_rate_sample	# SampleRate rate control for the ath driver
443158357Snyan#device		wlan		# 802.11 layer
444158357Snyan
445125234Snyan#
446111314Snyan# SCSI host adapters:
447125234Snyan#
448111314Snyan# ct: WD33C93[ABC] based SCSI host adapters.
449111314Snyan# ncv: NCR 53C500 based SCSI host adapters.
450111314Snyan# nsp: Workbit Ninja SCSI-3 based PC Card SCSI host adapters.
451111314Snyan# stg: TMC 18C30, 18C50 based SCSI host adapters.
452111314Snyan
453111314Snyandevice		ct
454111314Snyanhint.ct.0.at="isa"
455126708Snyandevice		ncv
456126708Snyandevice		nsp
457126708Snyandevice		stg
458111314Snyan
459111314Snyan#
460117918Snyan# SafeNet crypto driver: can be moved to the MI NOTES as soon as
461117918Snyan# it's tested on a big-endian machine
462117918Snyan#
463117918Snyandevice		safe		# SafeNet 1141
464142783Snyanoptions 	SAFE_DEBUG	# enable debugging support: hw.safe.debug
465142783Snyanoptions 	SAFE_RNDTEST	# enable rndtest support
466117918Snyan
467117918Snyan#####################################################################
468117918Snyan
469117918Snyan#
470111314Snyan# Miscellaneous hardware:
471111314Snyan#
472111314Snyan# apm: Laptop Advanced Power Management (experimental)
473111314Snyan# pmtimer: Timer device driver for power management events (APM or ACPI)
474124795Snyan# cy: Cyclades serial driver
475111314Snyan# digi: Digiboard driver
476111314Snyan
477111314Snyan# Notes on APM
478111314Snyan#  The flags takes the following meaning for apm0:
479111314Snyan#    0x0020  Statclock is broken.
480111314Snyan
481111314Snyandevice		apm
482111314Snyanhint.apm.0.flags="0x20"
483111314Snyandevice		canbus
484111314Snyandevice		canbepm
485128876Sbdedevice		cy
486127945Snyanoptions 	CY_PCI_FASTINTR		# Use with cy_pci unless irq is shared
487111314Snyandevice		digi
488111314Snyan# BIOS & FEP/OS components of device digi.
489111314Snyandevice		digi_CX
490111314Snyandevice		digi_CX_PCI
491111314Snyandevice		digi_EPCX
492111314Snyandevice		digi_EPCX_PCI
493111314Snyandevice		digi_Xe
494111314Snyandevice		digi_Xem
495111314Snyandevice		digi_Xr
496124795Snyandevice		olpt
497124795Snyanhint.olpt.0.at="isa"
498124795Snyanhint.olpt.0.port="0x040"
499128221Simpdevice		pmc
500128221Simphint.pmc.0.at="isa"
501128221Simphint.pmc.0.port="0x8f0"
502128221Simpdevice		pmtimer			# Adjust system timer at wakeup time
503111314Snyan
504111314Snyan#
505111314Snyan# Laptop/Notebook options:
506111314Snyan#
507111314Snyan# See also:
508111314Snyan#  apm under `Miscellaneous hardware'
509111314Snyan# above.
510111314Snyan
511111314Snyan# For older notebooks that signal a powerfail condition (external
512111314Snyan# power supply dropped, or battery state low) by issuing an NMI:
513111314Snyan
514111314Snyanoptions 	POWERFAIL_NMI	# make it beep instead of panicing
515111314Snyan
516111314Snyan#---------------------------------------------------------------------------
517111314Snyan# ISDN4BSD
518111314Snyan#
519111314Snyan# See /usr/share/examples/isdn/ROADMAP for an introduction to isdn4bsd.
520111314Snyan#
521111314Snyan# i4b passive ISDN cards support contains the following hardware drivers:
522111314Snyan#
523111314Snyan#	isic  - Siemens/Infineon ISDN ISAC/HSCX/IPAC chipset driver
524111314Snyan#	iwic  - Winbond W6692 PCI bus ISDN S/T interface controller
525111314Snyan#	ifpi  - AVM Fritz!Card PCI driver
526111314Snyan#	ifpi2  - AVM Fritz!Card PCI version 2 driver
527111314Snyan#	ihfc  - Cologne Chip HFC ISA/ISA-PnP chipset driver
528125234Snyan#	ifpnp - AVM Fritz!Card PnP driver
529111314Snyan#	itjc  - Siemens ISAC / TJNet Tiger300/320 chipset
530111314Snyan#
531111314Snyan# i4b active ISDN cards support contains the following hardware drivers:
532111314Snyan#
533111314Snyan#	iavc  - AVM B1 PCI, AVM B1 ISA, AVM T1
534111314Snyan#
535111314Snyan# Note that the ``options'' (if given) and ``device'' lines must BOTH
536111314Snyan# be uncommented to enable support for a given card !
537111314Snyan#
538111314Snyan# In addition to a hardware driver (and probably an option) the mandatory
539125234Snyan# ISDN protocol stack devices and the mandatory support device must be
540111314Snyan# enabled as well as one or more devices from the optional devices section.
541111314Snyan#
542111314Snyan#---------------------------------------------------------------------------
543111314Snyan#	isic driver (Siemens/Infineon chipsets)
544111314Snyan#
545111314Snyandevice	isic
546111314Snyan#
547111314Snyan# PCI bus Cards:
548111314Snyan# --------------
549111314Snyan#
550111314Snyan# ELSA MicroLink ISDN/PCI (same as ELSA QuickStep 1000pro PCI)
551111314Snyanoptions 	ELSA_QS1PCI
552111314Snyan#
553111314Snyan#---------------------------------------------------------------------------
554111314Snyan#	ifpnp driver for AVM Fritz!Card PnP
555111314Snyan#
556111314Snyan# AVM Fritz!Card PnP
557126708Snyandevice		ifpnp
558111314Snyan#
559111314Snyan#---------------------------------------------------------------------------
560111314Snyan#	ihfc driver for Cologne Chip ISA chipsets (experimental!)
561111314Snyan#
562111314Snyan# Teles 16.3c ISA PnP
563111314Snyan# AcerISDN P10 ISA PnP
564111314Snyan# TELEINT ISDN SPEED No.1
565126708Snyandevice		ihfc
566111314Snyan#
567111314Snyan#---------------------------------------------------------------------------
568111314Snyan#	ifpi driver for AVM Fritz!Card PCI
569111314Snyan#
570111314Snyan# AVM Fritz!Card PCI
571126708Snyandevice		ifpi
572111314Snyan#
573111314Snyan#---------------------------------------------------------------------------
574111314Snyan#	ifpi2 driver for AVM Fritz!Card PCI version 2
575111314Snyan#
576111314Snyan# AVM Fritz!Card PCI version 2
577134634Srudevice		ifpi2
578111314Snyan#
579111314Snyan#---------------------------------------------------------------------------
580111314Snyan#	iwic driver for Winbond W6692 chipset
581111314Snyan#
582111314Snyan# ASUSCOM P-IN100-ST-D (and other Winbond W6692 based cards)
583126708Snyandevice		iwic
584111314Snyan#
585111314Snyan#---------------------------------------------------------------------------
586125234Snyan#	itjc driver for Siemens ISAC / TJNet Tiger300/320 chipset
587111314Snyan#
588111314Snyan# Traverse Technologies NETjet-S
589111314Snyan# Teles PCI-TJ
590126708Snyandevice		itjc
591111314Snyan#
592111314Snyan#---------------------------------------------------------------------------
593111314Snyan#	iavc driver (AVM active cards, needs i4bcapi driver!)
594111314Snyan#
595126708Snyandevice		iavc
596111314Snyan#
597111314Snyan#---------------------------------------------------------------------------
598111314Snyan#	ISDN Protocol Stack - mandatory for all hardware drivers
599111314Snyan#
600111314Snyan# Q.921 / layer 2 - i4b passive cards D channel handling
601134634Srudevice		i4bq921
602111314Snyan#
603111314Snyan# Q.931 / layer 3 - i4b passive cards D channel handling
604134634Srudevice		i4bq931
605111314Snyan#
606111314Snyan# layer 4 - i4b common passive and active card handling
607134634Srudevice		i4b
608111314Snyan#
609111314Snyan#---------------------------------------------------------------------------
610111314Snyan#	ISDN devices - mandatory for all hardware drivers
611111314Snyan#
612111314Snyan# userland driver to do ISDN tracing (for passive cards only)
613134634Srudevice		i4btrc
614142783Snyanoptions 	NI4BTRC=4
615111314Snyan#
616111314Snyan# userland driver to control the whole thing
617134634Srudevice		i4bctl
618111314Snyan#
619111314Snyan#---------------------------------------------------------------------------
620111314Snyan#	ISDN devices - optional
621111314Snyan#
622111314Snyan# userland driver for access to raw B channel
623134634Srudevice		i4brbch
624142783Snyanoptions 	NI4BRBCH=4
625111314Snyan#
626111314Snyan# userland driver for telephony
627134634Srudevice		i4btel
628134634Sruoptions 	NI4BTEL=2
629111314Snyan#
630171196Sbz#XXXBZ# IPR and ISPPP are not usable until I4B is locked.
631111314Snyan# network driver for IP over raw HDLC ISDN
632171196Sbz#XXXBZ#device		i4bipr
633171196Sbz#XXXBZ#options 	NI4BIPR=4
634111314Snyan# enable VJ header compression detection for ipr i/f
635171196Sbz#XXXBZ#options 	IPR_VJ
636111314Snyan# enable logging of the first n IP packets to isdnd (n=32 here)
637171196Sbz#XXXBZ#options 	IPR_LOG=32
638111314Snyan#
639111314Snyan# network driver for sync PPP over ISDN; requires an equivalent
640111314Snyan# number of sppp device to be configured
641171196Sbz#XXXBZ#device		i4bisppp
642171196Sbz#XXXBZ#options 	NI4BISPPP=4
643111314Snyan#
644111314Snyan# B-channel interface to the netgraph subsystem
645171196Sbz#XXXBZ#device		i4bing
646171196Sbz#XXXBZ#options 	NI4BING=2
647111314Snyan#
648111314Snyan# CAPI driver needed for active ISDN cards (see iavc driver above)
649134634Srudevice		i4bcapi
650111314Snyan#
651111314Snyan#---------------------------------------------------------------------------
652111314Snyan
653111314Snyan#
654111314Snyan# Set the number of PV entries per process.  Increasing this can
655124795Snyan# stop panics related to heavy use of shared memory.  However, that can
656111314Snyan# (combined with large amounts of physical memory) cause panics at
657111314Snyan# boot time due the kernel running out of VM space.
658111314Snyan#
659111314Snyan# If you're tweaking this, you might also want to increase the sysctls
660111314Snyan# "vm.v_free_min", "vm.v_free_reserved", and "vm.v_free_target".
661111314Snyan#
662111314Snyan# The value below is the one more than the default.
663111314Snyan#
664111314Snyanoptions 	PMAP_SHPGPERPROC=201
665111314Snyan
666111314Snyan#
667111314Snyan# Change the size of the kernel virtual address space.  Due to
668111314Snyan# constraints in loader(8) on i386, this must be a multiple of 4.
669111314Snyan# 256 = 1 GB of kernel address space.  Increasing this also causes
670111314Snyan# a reduction of the address space in user processes.  512 splits
671111314Snyan# the 4GB cpu address space in half (2GB user, 2GB kernel).
672111314Snyan#
673111314Snyanoptions 	KVA_PAGES=260
674111314Snyan
675111314Snyan
676111314Snyan#####################################################################
677111314Snyan# ABI Emulation
678111314Snyan
679111314Snyan# Enable iBCS2 runtime support for SCO and ISC binaries
680111314Snyanoptions 	IBCS2
681111314Snyan
682111314Snyan# Emulate spx device for client side of SVR3 local X interface
683111314Snyanoptions 	SPX_HACK
684111314Snyan
685111314Snyan# Enable Linux ABI emulation
686111314Snyanoptions 	COMPAT_LINUX
687111314Snyan
688111314Snyan# Enable i386 a.out binary support
689111314Snyanoptions 	COMPAT_AOUT
690111314Snyan
691111314Snyan# Enable the linux-like proc filesystem support (requires COMPAT_LINUX
692111314Snyan# and PSEUDOFS)
693111314Snyanoptions 	LINPROCFS
694111314Snyan
695158381Sambrisko# Enable the linux-like sys filesystem support (requires COMPAT_LINUX
696158381Sambrisko# and PSEUDOFS)
697158381Sambriskooptions 	LINSYSFS
698158381Sambrisko
699111314Snyan#
700111314Snyan# SysVR4 ABI emulation
701111314Snyan#
702111314Snyan# The svr4 ABI emulator can be statically compiled into the kernel or loaded as
703125234Snyan# a KLD module.
704125234Snyan# The STREAMS network emulation code can also be compiled statically or as a
705111314Snyan# module.  If loaded as a module, it must be loaded before the svr4 module
706111314Snyan# (the /usr/sbin/svr4 script does this for you).  If compiling statically,
707111314Snyan# the `streams' device must be configured into any kernel which also
708125234Snyan# specifies COMPAT_SVR4.  It is possible to have a statically-configured
709111314Snyan# STREAMS device and a dynamically loadable svr4 emulator;  the /usr/sbin/svr4
710111314Snyan# script understands that it doesn't need to load the `streams' module under
711111314Snyan# those circumstances.
712111314Snyan# Caveat:  At this time, `options KTRACE' is required for the svr4 emulator
713125234Snyan# (whether static or dynamic).
714125234Snyan#
715111314Snyanoptions 	COMPAT_SVR4	# build emulator statically
716111314Snyanoptions 	DEBUG_SVR4	# enable verbose debugging
717111314Snyandevice		streams		# STREAMS network driver (required for svr4).
718111314Snyan
719111314Snyan
720111314Snyan#####################################################################
721111314Snyan# VM OPTIONS
722111314Snyan
723111314Snyan# Disable the 4 MByte page PSE CPU feature.  The PSE feature allows the
724130596Snyan# kernel to use 4 MByte pages to map the kernel instead of 4k pages.
725111314Snyan# This saves on the amount of memory needed for page tables needed to
726111314Snyan# map the kernel.  You should only disable this feature as a temporary
727111314Snyan# workaround if you are having problems with it enabled.
728111314Snyan#
729111314Snyan#options 	DISABLE_PSE
730111314Snyan
731111314Snyan# Disable the global pages PGE CPU feature.  The PGE feature allows pages
732111314Snyan# to be marked with the PG_G bit.  TLB entries for these pages are not
733111314Snyan# flushed from the cache when %cr3 is reloaded.  This can make context
734111314Snyan# switches less expensive.  You should only disable this feature as a
735111314Snyan# temporary workaround if you are having problems with it enabled.
736111314Snyan#
737111314Snyan#options 	DISABLE_PG_G
738111314Snyan
739111314Snyan# KSTACK_PAGES is the number of memory pages to assign to the kernel
740111314Snyan# stack of each thread.
741111314Snyan
742111314Snyanoptions 	KSTACK_PAGES=3
743111314Snyan
744111314Snyan#####################################################################
745111314Snyan
746111314Snyan# More undocumented options for linting.
747111314Snyan# Note that documenting these are not considered an affront.
748111314Snyan
749111314Snyanoptions 	FB_INSTALL_CDEV		# install a CDEV entry in /dev
750111314Snyan
751111314Snyan# PECOFF module (Win32 Execution Format)
752111314Snyanoptions 	PECOFF_SUPPORT
753111314Snyanoptions 	PECOFF_DEBUG
754111314Snyan
755111314Snyanoptions 	I4B_SMP_WORKAROUND
756111314Snyanoptions 	I586_PMC_GUPROF=0x70000
757111314Snyanoptions 	KBDIO_DEBUG=2
758111314Snyanoptions 	KBD_MAXRETRY=4
759111314Snyanoptions 	KBD_MAXWAIT=6
760111314Snyanoptions 	KBD_RESETDELAY=201
761111314Snyan
762111314Snyanoptions 	TIMER_FREQ=((14318182+6)/12)
763111314Snyan
764111314Snyanoptions 	VM_KMEM_SIZE
765111314Snyanoptions 	VM_KMEM_SIZE_MAX
766111314Snyanoptions 	VM_KMEM_SIZE_SCALE
767111314Snyan
768111500Sobrien
769111500Sobrien#####################################################################
770111500Sobrien# Devices we don't want to deal with
771111500Sobrien
772116382Snyannodevice	bt
773116382Snyannodevice	adw
774111500Sobriennodevice	aha
775116382Snyannodevice	ahb
776116382Snyannodevice	ahd
777116382Snyannodevice	mpt
778116382Snyannodevice	trm
779111500Sobriennodevice	wds
780111500Sobriennodevice	dpt
781111500Sobriennodevice	ciss
782111500Sobriennodevice	iir
783111500Sobriennodevice	mly
784111500Sobriennodevice	ida		# Compaq Smart RAID
785111500Sobriennodevice	mlx		# Mylex DAC960
786111500Sobriennodevice	amr		# AMI MegaRAID
787111500Sobriennodevice	twe		# 3ware ATA RAID
788125086Snyannodevice	ataraid
789116382Snyannodevice	cm
790116382Snyannodevice	ex
791116382Snyannodevice	fea
792116382Snyannodevice	intpm
793116382Snyannodevice	alpm
794116382Snyannodevice	ichsmb
795116382Snyannodevice	viapm
796116382Snyannodevice	amdpm
797153643Snyannodevice	amdsmb
798116382Snyannodevice	nfpm
799153643Snyannodevice	nfsmb
800111582Sru
801111582Sru
802111582Sru#####################################################################
803111582Sru# Options we don't want to deal with
804111582Sru
805116382Snyannooption	AHD_DEBUG
806116382Snyannooption	AHD_DEBUG_OPTS
807116382Snyannooption	AHD_REG_PRETTY_PRINT
808116382Snyannooption	ADW_ALLOW_MEMIO
809111582Srunooption	DPT_LOST_IRQ
810111582Srunooption	DPT_RESET_HBA
811111582Srunooption	DPT_TIMEOUT_FACTOR
812116382Snyannooption	AAC_DEBUG
813111582Sru
814111582Sru
815111582Sru#####################################################################
816111582Sru# Make options we don't want to deal with
817