NOTES revision 128221
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 128221 2004-04-14 02:25:31Z imp $
8111314Snyan#
9111314Snyan
10111314Snyan#
11111314Snyan# This directive is mandatory; it defines the architecture to be
12111314Snyan# configured for; in this case, the 386 family based PC-98 and
13111314Snyan# compatibles.
14111314Snyan#
15111314Snyanmachine		pc98
16111314Snyanoptions 	PC98
17111314Snyan
18125234Snyan#
19127520Snyan# We want LINT to cover profiling as well.
20111314Snyanprofile         2
21111314Snyan
22111314Snyan
23111314Snyan#####################################################################
24111314Snyan# SMP OPTIONS:
25111314Snyan#
26122755Snyan# The apic device enables the use of the I/O APIC for interrupt delivery.
27122755Snyan# The apic device can be used in both UP and SMP kernels, but is required
28122755Snyan# for SMP kernels.  Thus, the apic device is not strictly an SMP option,
29122755Snyan# but it is a prerequisite for SMP.
30111314Snyan#
31111314Snyan# Notes:
32111314Snyan#
33122755Snyan# Be sure to disable 'cpu I386_CPU' for SMP kernels.
34111314Snyan#
35122755Snyan# By default, mixed mode is used to route IRQ0 from the AT timer via
36122755Snyan# the 8259A master PIC through the ExtINT pin on the first I/O APIC.
37122755Snyan# This can be disabled via the NO_MIXED_MODE option.  In that case,
38122755Snyan# IRQ0 will be routed via an intpin on the first I/O APIC.  Not all
39122755Snyan# motherboards hook IRQ0 up to the first I/O APIC even though their
40122755Snyan# MP table or MADT may claim to do so.  That is why mixed mode is
41122755Snyan# enabled by default.
42111314Snyan#
43111314Snyan
44111314Snyan# Mandatory:
45122056Snyandevice		apic			# I/O apic
46124795Snyan
47124795Snyan# Optional:
48122755Snyanoptions 	NO_MIXED_MODE		# Disable use of mixed mode
49111314Snyan
50111314Snyan
51111314Snyan#####################################################################
52111314Snyan# CPU OPTIONS
53111314Snyan
54111314Snyan#
55111314Snyan# You must specify at least one CPU (the one you intend to run on);
56111314Snyan# deleting the specification for CPUs you don't need to use may make
57111314Snyan# parts of the system run faster.
58111314Snyan# I386_CPU is mutually exclusive with the other CPU types.
59111314Snyan#
60125234Snyan#cpu		I386_CPU
61111314Snyancpu		I486_CPU
62111314Snyancpu		I586_CPU		# aka Pentium(tm)
63111314Snyancpu		I686_CPU		# aka Pentium Pro(tm)
64111314Snyan
65111314Snyan#
66111314Snyan# Options for CPU features.
67111314Snyan#
68124795Snyan# CPU_BLUELIGHTNING_3X enables triple-clock mode on IBM Blue Lightning
69124795Snyan# CPU if CPU supports it.  The default is double-clock mode on
70124795Snyan# BlueLightning CPU box.
71124795Snyan#
72111314Snyan# CPU_BLUELIGHTNING_FPU_OP_CACHE enables FPU operand cache on IBM
73111314Snyan# BlueLightning CPU.  It works only with Cyrix FPU, and this option
74111314Snyan# should not be used with Intel FPU.
75111314Snyan#
76111314Snyan# CPU_BTB_EN enables branch target buffer on Cyrix 5x86 (NOTE 1).
77111314Snyan#
78111314Snyan# CPU_CYRIX_NO_LOCK enables weak locking for the entire address space
79111314Snyan# of Cyrix 6x86 and 6x86MX CPUs by setting the NO_LOCK bit of CCR1.
80111314Snyan# Otherwise, the NO_LOCK bit of CCR1 is cleared.  (NOTE 3)
81111314Snyan#
82124795Snyan# CPU_DIRECT_MAPPED_CACHE sets L1 cache of Cyrix 486DLC CPU in direct
83124795Snyan# mapped mode.  Default is 2-way set associative mode.
84124795Snyan#
85127520Snyan# CPU_DISABLE_5X86_LSSER disables load store serialize (i.e., enables
86111314Snyan# reorder).  This option should not be used if you use memory mapped
87111314Snyan# I/O device(s).
88111314Snyan#
89125234Snyan# CPU_DISABLE_CMPXCHG disables the CMPXCHG instruction on > i386 IA32
90125234Snyan# machines.  VmWare seems to emulate this instruction poorly, causing
91127520Snyan# the guest OS to run very slowly.  Enabling this with an SMP kernel
92124795Snyan# will cause the kernel to be unusable.
93124795Snyan#
94127520Snyan# CPU_DISABLE_SSE explicitly prevents I686_CPU from turning on SSE.
95124795Snyan#
96111314Snyan# CPU_ENABLE_SSE enables SSE/MMX2 instructions support.  This is default
97111314Snyan# on I686_CPU and above.
98111314Snyan#
99111314Snyan# CPU_FASTER_5X86_FPU enables faster FPU exception handler.
100111314Snyan#
101111314Snyan# CPU_I486_ON_386 enables CPU cache on i486 based CPU upgrade products
102111314Snyan# for i386 machines.
103111314Snyan#
104111314Snyan# CPU_IORT defines I/O clock delay time (NOTE 1).  Default values of
105111314Snyan# I/O clock delay time on Cyrix 5x86 and 6x86 are 0 and 7,respectively
106111314Snyan# (no clock delay).
107111314Snyan#
108125234Snyan# CPU_L2_LATENCY specifies the L2 cache latency value.  This option is used
109111314Snyan# only when CPU_PPRO2CELERON is defined and Mendocino Celeron is detected.
110111314Snyan# The default value is 5.
111111314Snyan#
112111314Snyan# CPU_LOOP_EN prevents flushing the prefetch buffer if the destination
113111314Snyan# of a jump is already present in the prefetch buffer on Cyrix 5x86(NOTE
114111314Snyan# 1).
115111314Snyan#
116111314Snyan# CPU_PPRO2CELERON enables L2 cache of Mendocino Celeron CPUs.  This option
117111314Snyan# is useful when you use Socket 8 to Socket 370 converter, because most Pentium
118111314Snyan# Pro BIOSs do not enable L2 cache of Mendocino Celeron CPUs.
119111314Snyan#
120111314Snyan# CPU_RSTK_EN enables return stack on Cyrix 5x86 (NOTE 1).
121111314Snyan#
122111314Snyan# CPU_SUSP_HLT enables suspend on HALT.  If this option is set, CPU
123111314Snyan# enters suspend mode following execution of HALT instruction.
124111314Snyan#
125111314Snyan# CPU_UPGRADE_HW_CACHE eliminates unneeded cache flush instruction(s).
126111314Snyan#
127111314Snyan# CPU_WT_ALLOC enables write allocation on Cyrix 6x86/6x86MX and AMD
128125234Snyan# K5/K6/K6-2 CPUs.
129111314Snyan#
130111314Snyan# CYRIX_CACHE_WORKS enables CPU cache on Cyrix 486 CPUs with cache
131111314Snyan# flush at hold state.
132111314Snyan#
133111314Snyan# CYRIX_CACHE_REALLY_WORKS enables (1) CPU cache on Cyrix 486 CPUs
134111314Snyan# without cache flush at hold state, and (2) write-back CPU cache on
135111314Snyan# Cyrix 6x86 whose revision < 2.7 (NOTE 2).
136111314Snyan#
137111314Snyan# NO_F00F_HACK disables the hack that prevents Pentiums (and ONLY
138111314Snyan# Pentiums) from locking up when a LOCK CMPXCHG8B instruction is
139111314Snyan# executed.  This option is only needed if I586_CPU is also defined,
140111314Snyan# and should be included for any non-Pentium CPU that defines it.
141111314Snyan#
142111314Snyan# NO_MEMORY_HOLE is an optimisation for systems with AMD K6 processors
143111314Snyan# which indicates that the 15-16MB range is *definitely* not being
144111314Snyan# occupied by an ISA memory hole.
145111314Snyan#
146111314Snyan# NOTE 1: The options, CPU_BTB_EN, CPU_LOOP_EN, CPU_IORT,
147111314Snyan# CPU_LOOP_EN and CPU_RSTK_EN should not be used because of CPU bugs.
148111314Snyan# These options may crash your system.
149111314Snyan#
150111314Snyan# NOTE 2: If CYRIX_CACHE_REALLY_WORKS is not set, CPU cache is enabled
151111314Snyan# in write-through mode when revision < 2.7.  If revision of Cyrix
152111314Snyan# 6x86 >= 2.7, CPU cache is always enabled in write-back mode.
153111314Snyan#
154111314Snyan# NOTE 3: This option may cause failures for software that requires
155111314Snyan# locked cycles in order to operate correctly.
156111314Snyan#
157124795Snyanoptions 	CPU_BLUELIGHTNING_3X
158111314Snyanoptions 	CPU_BLUELIGHTNING_FPU_OP_CACHE
159111314Snyanoptions 	CPU_BTB_EN
160111314Snyanoptions 	CPU_DIRECT_MAPPED_CACHE
161111314Snyanoptions 	CPU_DISABLE_5X86_LSSER
162124795Snyanoptions 	CPU_DISABLE_CMPXCHG
163124795Snyan#options 	CPU_DISABLE_SSE
164111314Snyanoptions 	CPU_ENABLE_SSE
165111314Snyanoptions 	CPU_FASTER_5X86_FPU
166111314Snyanoptions 	CPU_I486_ON_386
167111314Snyanoptions 	CPU_IORT
168111314Snyanoptions 	CPU_L2_LATENCY=5
169111314Snyanoptions 	CPU_LOOP_EN
170111314Snyanoptions 	CPU_PPRO2CELERON
171111314Snyanoptions 	CPU_RSTK_EN
172111314Snyanoptions 	CPU_SUSP_HLT
173111314Snyanoptions 	CPU_UPGRADE_HW_CACHE
174111314Snyanoptions 	CPU_WT_ALLOC
175111314Snyanoptions 	CYRIX_CACHE_WORKS
176111314Snyanoptions 	CYRIX_CACHE_REALLY_WORKS
177111314Snyan#options 	NO_F00F_HACK
178111314Snyan
179111314Snyan# Debug options
180124795Snyanoptions 	NPX_DEBUG	# enable npx debugging
181111314Snyan
182111314Snyan#
183111314Snyan# PERFMON causes the driver for Pentium/Pentium Pro performance counters
184111314Snyan# to be compiled.  See perfmon(4) for more information.
185111314Snyan#
186111314Snyanoptions 	PERFMON
187111314Snyan
188111314Snyan
189111314Snyan#####################################################################
190111314Snyan# NETWORKING OPTIONS
191111314Snyan
192111314Snyan#
193111314Snyan# DEVICE_POLLING adds support for mixed interrupt-polling handling
194111314Snyan# of network device drivers, which has significant benefits in terms
195111314Snyan# of robustness to overloads and responsivity, as well as permitting
196111314Snyan# accurate scheduling of the CPU time between kernel network processing
197124795Snyan# and other activities.  The drawback is a moderate (up to 1/HZ seconds)
198111314Snyan# potential increase in response times.
199111314Snyan# It is strongly recommended to use HZ=1000 or 2000 with DEVICE_POLLING
200111314Snyan# to achieve smoother behaviour.
201111314Snyan# Additionally, you can enable/disable polling at runtime with the
202111314Snyan# sysctl variable kern.polling.enable (defaults off), and select
203111314Snyan# the CPU fraction reserved to userland with the sysctl variable
204111314Snyan# kern.polling.user_frac (default 50, range 0..100).
205111314Snyan#
206124408Snyan# Not all device drivers support this mode of operation at the time of
207124408Snyan# this writing.  See polling(4) for more details.
208111314Snyan
209111314Snyanoptions 	DEVICE_POLLING
210111314Snyan
211111314Snyan
212111314Snyan#####################################################################
213111314Snyan# CLOCK OPTIONS
214111314Snyan
215111314Snyan# The following options are used for debugging clock behavior only, and
216111314Snyan# should not be used for production systems.
217111314Snyan
218123984Sbde# CLK_CALIBRATION_LOOP causes clock calibration to be run in a loop at
219123984Sbde# startup until the user presses a key.  (The i8254 clock is always
220123984Sbde# calibrated relative to the RTC (mc146818a) and this option causes the
221123984Sbde# calibration to be repeated.)
222111314Snyanoptions 	CLK_CALIBRATION_LOOP
223111314Snyan
224123984Sbde# CLK_USE_I8254_CALIBRATION causes the calibrated frequency of the i8254
225123984Sbde# clock to actually be used.
226111314Snyanoptions 	CLK_USE_I8254_CALIBRATION
227111314Snyan
228111314Snyan
229111314Snyan#####################################################################
230111314Snyan# MISCELLANEOUS DEVICES AND OPTIONS
231111314Snyan
232111314Snyandevice		speaker		#Play IBM BASIC-style noises out your speaker
233111314Snyanhint.speaker.0.at="isa"
234111314Snyanhint.speaker.0.port="0x35"
235124795Snyandevice		gzip		#Exec gzipped a.out's.  REQUIRES COMPAT_AOUT!
236111314Snyandevice		apm_saver	# Requires APM
237111314Snyan
238111314Snyan
239111314Snyan#####################################################################
240111314Snyan# HARDWARE BUS CONFIGURATION
241111314Snyan
242111314Snyan#
243111314Snyan# ISA bus
244111314Snyan#
245111314Snyandevice		isa
246111314Snyan
247111314Snyan#
248111314Snyan# Options for `isa':
249111314Snyan#
250111314Snyan# AUTO_EOI_1 enables the `automatic EOI' feature for the master 8259A
251111314Snyan# interrupt controller.  This saves about 0.7-1.25 usec for each interrupt.
252111314Snyan# This option breaks suspend/resume on some portables.
253111314Snyan#
254111314Snyan# MAXMEM specifies the amount of RAM on the machine; if this is not
255111314Snyan# specified, FreeBSD will first read the amount of memory from the CMOS
256111314Snyan# RAM, so the amount of memory will initially be limited to 64MB or 16MB
257111314Snyan# depending on the BIOS.  If the BIOS reports 64MB, a memory probe will
258111314Snyan# then attempt to detect the installed amount of RAM.  If this probe
259111314Snyan# fails to detect >64MB RAM you will have to use the MAXMEM option.
260111314Snyan# The amount is in kilobytes, so for a machine with 128MB of RAM, it would
261111314Snyan# be 131072 (128 * 1024).
262111314Snyan#
263111314Snyan# BROKEN_KEYBOARD_RESET disables the use of the keyboard controller to
264111314Snyan# reset the CPU for reboot.  This is needed on some systems with broken
265111314Snyan# keyboard controllers.
266111314Snyan
267111314Snyanoptions 	AUTO_EOI_1
268111314Snyan
269111314Snyanoptions 	MAXMEM=(128*1024)
270111314Snyan#options 	BROKEN_KEYBOARD_RESET
271111314Snyanoptions 	EPSON_BOUNCEDMA
272111314Snyanoptions 	EPSON_MEMWIN
273111314Snyan
274111314Snyan#
275111314Snyan# PCI bus & PCI options:
276111314Snyan#
277111314Snyandevice		pci
278111314Snyan
279111314Snyan#
280111314Snyan# AGP GART support
281111314Snyandevice		agp
282111314Snyan
283111314Snyan
284111314Snyan#####################################################################
285111314Snyan# HARDWARE DEVICE CONFIGURATION
286111314Snyan
287111314Snyan# PC98 keyboard
288111314Snyandevice		pckbd
289111314Snyanhint.pckbd.0.at="isa"
290111314Snyanhint.pckbd.0.port="0x041"
291111314Snyanhint.pckbd.0.irq="1"
292111314Snyan
293111314Snyan# These options are valid for other keyboard drivers as well.
294111314Snyanoptions 	KBD_DISABLE_KEYMAP_LOAD	# refuse to load a keymap
295111314Snyanoptions 	KBD_INSTALL_CDEV	# install a CDEV entry in /dev
296111314Snyan
297111314Snyan# GDC screen
298111314Snyandevice		gdc
299111314Snyanhint.gdc.0.at="isa"
300111314Snyanoptions 	LINE30
301111314Snyan
302111314Snyan#
303111314Snyan# The Numeric Processing eXtension driver.  In addition to this, you
304111314Snyan# may configure a math emulator (see above).  If your machine has a
305111314Snyan# hardware FPU and the kernel configuration includes the npx device
306111314Snyan# *and* a math emulator compiled into the kernel, the hardware FPU
307111314Snyan# will be used, unless it is found to be broken or unless "flags" to
308111314Snyan# npx0 includes "0x08", which requests preference for the emulator.
309111314Snyandevice		npx
310111314Snyan
311111314Snyan#
312111314Snyan# `flags' for npx0:
313111314Snyan#	0x01	don't use the npx registers to optimize bcopy.
314111314Snyan#	0x02	don't use the npx registers to optimize bzero.
315111314Snyan#	0x04	don't use the npx registers to optimize copyin or copyout.
316111314Snyan#	0x08	use emulator even if hardware FPU is available.
317111314Snyan# The npx registers are normally used to optimize copying and zeroing when
318111314Snyan# all of the following conditions are satisfied:
319111314Snyan#	I586_CPU is an option
320111314Snyan#	the cpu is an i586 (perhaps not a Pentium)
321111314Snyan#	the probe for npx0 succeeds
322111314Snyan#	INT 16 exception handling works.
323111314Snyan# Then copying and zeroing using the npx registers is normally 30-100% faster.
324111314Snyan# The flags can be used to control cases where it doesn't work or is slower.
325111314Snyan# Setting them at boot time using userconfig works right (the optimizations
326111314Snyan# are not used until later in the bootstrap when npx0 is attached).
327111314Snyan# Flag 0x08 automatically disables the i586 optimized routines.
328111314Snyan#
329111314Snyan
330111314Snyan#
331111314Snyan# Optional devices:
332111314Snyan#
333111314Snyan
334124795Snyan# 3Dfx Voodoo Graphics, Voodoo II /dev/3dfx CDEV support.  This will create
335124795Snyan# the /dev/3dfx0 device to work with glide implementations.  This should get
336124795Snyan# linked to /dev/3dfx and /dev/voodoo.  Note that this is not the same as
337111314Snyan# the tdfx DRI module from XFree86 and is completely unrelated.
338111314Snyan#
339111314Snyan# To enable Linuxulator support, one must also include COMPAT_LINUX in the
340124795Snyan# config as well, or you will not have the dependencies.  The other option
341111314Snyan# is to load both as modules.
342111314Snyan
343126708Snyandevice		tdfx			# Enable 3Dfx Voodoo support
344111314Snyanoptions 	TDFX_LINUX		# Enable Linuxulator support
345111314Snyan
346111314Snyan# DRM options:
347111314Snyan# mgadrm:    AGP Matrox G200, G400, G450, G550
348112034Snyan# r128drm:   ATI Rage 128
349112034Snyan# radeondrm: ATI Radeon up to 9000/9100
350119985Snyan# sisdrm:    SiS 300/305,540,630
351119985Snyan# tdfxdrm:   3dfx Voodoo 3/4/5 and Banshee
352112034Snyan# DRM_DEBUG: include debug printfs, very slow
353111314Snyan#
354112034Snyan# mga requires AGP in the kernel, and it is recommended
355112034Snyan# for AGP r128 and radeon cards.
356111314Snyan
357111314Snyandevice		mgadrm
358111314Snyandevice		"r128drm"
359111314Snyandevice		radeondrm
360119985Snyandevice		sisdrm
361111314Snyandevice		tdfxdrm
362111314Snyan
363111314Snyanoptions 	DRM_DEBUG
364111314Snyan
365111314Snyan#
366111314Snyan# Bus mouse
367111314Snyan#
368111314Snyandevice		mse
369111314Snyanhint.mse.0.at="isa"
370111314Snyanhint.mse.0.port="0x7fd9"
371111314Snyanhint.mse.0.irq="13"
372111314Snyan
373111314Snyan#
374111314Snyan# Network interfaces:
375111314Snyan#
376111314Snyan
377111314Snyan# ar:   Arnet SYNC/570i hdlc sync 2/4 port V.35/X.21 serial driver
378111314Snyan#       (requires sppp)
379111314Snyan# ed:   Western Digital and SMC 80xx; Novell NE1000 and NE2000; 3Com 3C503
380125234Snyan#       HP PC Lan+, various PC Card devices (refer to etc/defaults/pccard.conf)
381111314Snyan#       (requires miibus)
382111314Snyan# ie:   AT&T StarLAN 10 and EN100; 3Com 3C507; unknown NI5210;
383111314Snyan#       Intel EtherExpress
384111314Snyan# lnc:  Lance/PCnet cards (Isolan, Novell NE2100, NE32-VL, AMD Am7990 and
385111314Snyan#       Am79C960)
386126708Snyan# oltr: Olicom ISA token-ring adapters OC-3115, OC-3117, OC-3118 and OC-3133.
387111314Snyan#       Olicom PCI token-ring adapters OC-3136, OC-3137, OC-3139, OC-3140,
388126708Snyan#       OC-3141, OC-3540 and OC-3250.
389126708Snyan# sbni: Granch SBNI12-xx ISA and PCI adapters
390111314Snyan# sr:   RISCom/N2 hdlc sync 1/2 port V.35/X.21 serial driver (requires sppp)
391126708Snyan# wl:   Lucent Wavelan (ISA card only).
392111314Snyan
393111314Snyan# Order for ISA/EISA devices is important here
394111314Snyan
395111314Snyandevice		ar
396111314Snyandevice		ed
397111314Snyan#options 	ED_NO_MIIBUS		# Disable ed miibus support
398111314Snyanhint.ed.0.at="isa"
399111314Snyanhint.ed.0.port="0x280"
400111314Snyanhint.ed.0.irq="5"
401111314Snyanhint.ed.0.maddr="0xd8000"
402112840Smdodddevice		ie			# Hints only required for Starlan
403112840Smdoddhint.ie.2.at="isa"
404112840Smdoddhint.ie.2.port="0x300"
405112840Smdoddhint.ie.2.irq="5"
406112840Smdoddhint.ie.2.maddr="0xd0000"
407111314Snyandevice		lnc
408111314Snyanhint.lnc.0.at="isa"
409111314Snyanhint.lnc.0.port="0x280"
410111314Snyanhint.lnc.0.irq="10"
411111314Snyanhint.lnc.0.drq="0"
412111314Snyandevice		sbni
413111314Snyanhint.sbni.0.at="isa"
414111314Snyanhint.sbni.0.port="0x210"
415111314Snyanhint.sbni.0.irq="0xefdead"
416111314Snyanhint.sbni.0.flags="0"
417111314Snyandevice		snc
418111314Snyanhint.snc.0.at="isa"
419111314Snyanhint.snc.0.port="0x888"
420111314Snyanhint.snc.0.irq="6"
421111314Snyanhint.snc.0.maddr="0xc0000"
422111314Snyandevice		sr
423111314Snyandevice		oltr
424111314Snyandevice		wl
425111314Snyanhint.wl.0.at="isa"
426111314Snyanhint.wl.0.port="0x300"
427111314Snyanoptions 	WLCACHE		# enables the signal-strength cache
428111314Snyanoptions 	WLDEBUG		# enables verbose debugging output
429111314Snyan
430125234Snyan#
431111314Snyan# SCSI host adapters:
432125234Snyan#
433111314Snyan# ct: WD33C93[ABC] based SCSI host adapters.
434111314Snyan# ncv: NCR 53C500 based SCSI host adapters.
435111314Snyan# nsp: Workbit Ninja SCSI-3 based PC Card SCSI host adapters.
436111314Snyan# stg: TMC 18C30, 18C50 based SCSI host adapters.
437111314Snyan
438111314Snyandevice		ct
439111314Snyanhint.ct.0.at="isa"
440126708Snyandevice		ncv
441126708Snyandevice		nsp
442126708Snyandevice		stg
443111314Snyan
444111314Snyan#
445117918Snyan# SafeNet crypto driver: can be moved to the MI NOTES as soon as
446117918Snyan# it's tested on a big-endian machine
447117918Snyan#
448117918Snyandevice		safe		# SafeNet 1141
449117918Snyanoptions		SAFE_DEBUG	# enable debugging support: hw.safe.debug
450117918Snyanoptions		SAFE_RNDTEST	# enable rndtest support
451117918Snyan
452117918Snyan#####################################################################
453117918Snyan
454117918Snyan#
455111314Snyan# Miscellaneous hardware:
456111314Snyan#
457111314Snyan# apm: Laptop Advanced Power Management (experimental)
458111314Snyan# pmtimer: Timer device driver for power management events (APM or ACPI)
459124795Snyan# cy: Cyclades serial driver
460111314Snyan# digi: Digiboard driver
461111314Snyan
462111314Snyan# Notes on APM
463111314Snyan#  The flags takes the following meaning for apm0:
464111314Snyan#    0x0020  Statclock is broken.
465111314Snyan
466111314Snyandevice		apm
467111314Snyanhint.apm.0.flags="0x20"
468111314Snyandevice		canbus
469111314Snyandevice		canbepm
470127945Snyandevice		cy	1
471127945Snyanoptions 	CY_PCI_FASTINTR		# Use with cy_pci unless irq is shared
472111314Snyandevice		digi
473111314Snyan# BIOS & FEP/OS components of device digi.
474111314Snyandevice		digi_CX
475111314Snyandevice		digi_CX_PCI
476111314Snyandevice		digi_EPCX
477111314Snyandevice		digi_EPCX_PCI
478111314Snyandevice		digi_Xe
479111314Snyandevice		digi_Xem
480111314Snyandevice		digi_Xr
481124795Snyandevice		olpt
482124795Snyanhint.olpt.0.at="isa"
483124795Snyanhint.olpt.0.port="0x040"
484128221Simpdevice		pmc
485128221Simphint.pmc.0.at="isa"
486128221Simphint.pmc.0.port="0x8f0"
487128221Simpdevice		pmtimer			# Adjust system timer at wakeup time
488128221Simp# sx device is i386 and pc98 only at the moment.
489128221Simpdevice		sx
490128221Simpoptions 	SX_DEBUG
491111314Snyan
492111314Snyan#
493111314Snyan# Laptop/Notebook options:
494111314Snyan#
495111314Snyan# See also:
496111314Snyan#  apm under `Miscellaneous hardware'
497111314Snyan# above.
498111314Snyan
499111314Snyan# For older notebooks that signal a powerfail condition (external
500111314Snyan# power supply dropped, or battery state low) by issuing an NMI:
501111314Snyan
502111314Snyanoptions 	POWERFAIL_NMI	# make it beep instead of panicing
503111314Snyan
504111314Snyan#
505111314Snyan# PC Card/PCMCIA
506111314Snyan# (OLDCARD)
507111314Snyan#
508111314Snyan# card: pccard slots
509111314Snyan# pcic: isa/pccard bridge
510111314Snyandevice		pcic
511111314Snyanhint.pcic.0.at="isa"
512111314Snyan#hint.pcic.1.at="isa"
513111314Snyandevice		card	1
514111314Snyan
515111314Snyan#---------------------------------------------------------------------------
516111314Snyan# ISDN4BSD
517111314Snyan#
518111314Snyan# See /usr/share/examples/isdn/ROADMAP for an introduction to isdn4bsd.
519111314Snyan#
520111314Snyan# i4b passive ISDN cards support contains the following hardware drivers:
521111314Snyan#
522111314Snyan#	isic  - Siemens/Infineon ISDN ISAC/HSCX/IPAC chipset driver
523111314Snyan#	iwic  - Winbond W6692 PCI bus ISDN S/T interface controller
524111314Snyan#	ifpi  - AVM Fritz!Card PCI driver
525111314Snyan#	ifpi2  - AVM Fritz!Card PCI version 2 driver
526111314Snyan#	ihfc  - Cologne Chip HFC ISA/ISA-PnP chipset driver
527125234Snyan#	ifpnp - AVM Fritz!Card PnP driver
528111314Snyan#	itjc  - Siemens ISAC / TJNet Tiger300/320 chipset
529111314Snyan#
530111314Snyan# i4b active ISDN cards support contains the following hardware drivers:
531111314Snyan#
532111314Snyan#	iavc  - AVM B1 PCI, AVM B1 ISA, AVM T1
533111314Snyan#
534111314Snyan# Note that the ``options'' (if given) and ``device'' lines must BOTH
535111314Snyan# be uncommented to enable support for a given card !
536111314Snyan#
537111314Snyan# In addition to a hardware driver (and probably an option) the mandatory
538125234Snyan# ISDN protocol stack devices and the mandatory support device must be
539111314Snyan# enabled as well as one or more devices from the optional devices section.
540111314Snyan#
541111314Snyan#---------------------------------------------------------------------------
542111314Snyan#	isic driver (Siemens/Infineon chipsets)
543111314Snyan#
544111314Snyandevice	isic
545111314Snyan#
546111314Snyan# PCI bus Cards:
547111314Snyan# --------------
548111314Snyan#
549111314Snyan# ELSA MicroLink ISDN/PCI (same as ELSA QuickStep 1000pro PCI)
550111314Snyanoptions 	ELSA_QS1PCI
551111314Snyan#
552111314Snyan#---------------------------------------------------------------------------
553111314Snyan#	ifpnp driver for AVM Fritz!Card PnP
554111314Snyan#
555111314Snyan# AVM Fritz!Card PnP
556126708Snyandevice		ifpnp
557111314Snyan#
558111314Snyan#---------------------------------------------------------------------------
559111314Snyan#	ihfc driver for Cologne Chip ISA chipsets (experimental!)
560111314Snyan#
561111314Snyan# Teles 16.3c ISA PnP
562111314Snyan# AcerISDN P10 ISA PnP
563111314Snyan# TELEINT ISDN SPEED No.1
564126708Snyandevice		ihfc
565111314Snyan#
566111314Snyan#---------------------------------------------------------------------------
567111314Snyan#	ifpi driver for AVM Fritz!Card PCI
568111314Snyan#
569111314Snyan# AVM Fritz!Card PCI
570126708Snyandevice		ifpi
571111314Snyan#
572111314Snyan#---------------------------------------------------------------------------
573111314Snyan#	ifpi2 driver for AVM Fritz!Card PCI version 2
574111314Snyan#
575111314Snyan# AVM Fritz!Card PCI version 2
576126708Snyandevice		"ifpi2"
577111314Snyan#
578111314Snyan#---------------------------------------------------------------------------
579111314Snyan#	iwic driver for Winbond W6692 chipset
580111314Snyan#
581111314Snyan# ASUSCOM P-IN100-ST-D (and other Winbond W6692 based cards)
582126708Snyandevice		iwic
583111314Snyan#
584111314Snyan#---------------------------------------------------------------------------
585125234Snyan#	itjc driver for Siemens ISAC / TJNet Tiger300/320 chipset
586111314Snyan#
587111314Snyan# Traverse Technologies NETjet-S
588111314Snyan# Teles PCI-TJ
589126708Snyandevice		itjc
590111314Snyan#
591111314Snyan#---------------------------------------------------------------------------
592111314Snyan#	iavc driver (AVM active cards, needs i4bcapi driver!)
593111314Snyan#
594126708Snyandevice		iavc
595111314Snyan#
596111314Snyan#---------------------------------------------------------------------------
597111314Snyan#	ISDN Protocol Stack - mandatory for all hardware drivers
598111314Snyan#
599111314Snyan# Q.921 / layer 2 - i4b passive cards D channel handling
600111314Snyandevice		"i4bq921"
601111314Snyan#
602111314Snyan# Q.931 / layer 3 - i4b passive cards D channel handling
603111314Snyandevice		"i4bq931"
604111314Snyan#
605111314Snyan# layer 4 - i4b common passive and active card handling
606111314Snyandevice		"i4b"
607111314Snyan#
608111314Snyan#---------------------------------------------------------------------------
609111314Snyan#	ISDN devices - mandatory for all hardware drivers
610111314Snyan#
611111314Snyan# userland driver to do ISDN tracing (for passive cards only)
612111314Snyandevice		"i4btrc"	4
613111314Snyan#
614111314Snyan# userland driver to control the whole thing
615111314Snyandevice		"i4bctl"
616111314Snyan#
617111314Snyan#---------------------------------------------------------------------------
618111314Snyan#	ISDN devices - optional
619111314Snyan#
620111314Snyan# userland driver for access to raw B channel
621111314Snyandevice		"i4brbch"	4
622111314Snyan#
623111314Snyan# userland driver for telephony
624111314Snyandevice		"i4btel"	2
625111314Snyan#
626111314Snyan# network driver for IP over raw HDLC ISDN
627111314Snyandevice		"i4bipr"	4
628111314Snyan# enable VJ header compression detection for ipr i/f
629111314Snyanoptions 	IPR_VJ
630111314Snyan# enable logging of the first n IP packets to isdnd (n=32 here)
631111314Snyanoptions 	IPR_LOG=32
632111314Snyan#
633111314Snyan# network driver for sync PPP over ISDN; requires an equivalent
634111314Snyan# number of sppp device to be configured
635111314Snyandevice		"i4bisppp"	4
636111314Snyan#
637111314Snyan# B-channel interface to the netgraph subsystem
638111314Snyandevice		"i4bing"	2
639111314Snyan#
640111314Snyan# CAPI driver needed for active ISDN cards (see iavc driver above)
641111314Snyandevice		"i4bcapi"
642111314Snyan#
643111314Snyan#---------------------------------------------------------------------------
644111314Snyan
645111314Snyan#
646111314Snyan# Set the number of PV entries per process.  Increasing this can
647124795Snyan# stop panics related to heavy use of shared memory.  However, that can
648111314Snyan# (combined with large amounts of physical memory) cause panics at
649111314Snyan# boot time due the kernel running out of VM space.
650111314Snyan#
651111314Snyan# If you're tweaking this, you might also want to increase the sysctls
652111314Snyan# "vm.v_free_min", "vm.v_free_reserved", and "vm.v_free_target".
653111314Snyan#
654111314Snyan# The value below is the one more than the default.
655111314Snyan#
656111314Snyanoptions 	PMAP_SHPGPERPROC=201
657111314Snyan
658111314Snyan#
659111314Snyan# Change the size of the kernel virtual address space.  Due to
660111314Snyan# constraints in loader(8) on i386, this must be a multiple of 4.
661111314Snyan# 256 = 1 GB of kernel address space.  Increasing this also causes
662111314Snyan# a reduction of the address space in user processes.  512 splits
663111314Snyan# the 4GB cpu address space in half (2GB user, 2GB kernel).
664111314Snyan#
665111314Snyanoptions 	KVA_PAGES=260
666111314Snyan
667111314Snyan
668111314Snyan#####################################################################
669111314Snyan# ABI Emulation
670111314Snyan
671111314Snyan# Enable iBCS2 runtime support for SCO and ISC binaries
672111314Snyanoptions 	IBCS2
673111314Snyan
674111314Snyan# Emulate spx device for client side of SVR3 local X interface
675111314Snyanoptions 	SPX_HACK
676111314Snyan
677111314Snyan# Enable Linux ABI emulation
678111314Snyanoptions 	COMPAT_LINUX
679111314Snyan
680111314Snyan# Enable i386 a.out binary support
681111314Snyanoptions 	COMPAT_AOUT
682111314Snyan
683111314Snyan# Enable the linux-like proc filesystem support (requires COMPAT_LINUX
684111314Snyan# and PSEUDOFS)
685111314Snyanoptions 	LINPROCFS
686111314Snyan
687111314Snyan#
688111314Snyan# SysVR4 ABI emulation
689111314Snyan#
690111314Snyan# The svr4 ABI emulator can be statically compiled into the kernel or loaded as
691125234Snyan# a KLD module.
692125234Snyan# The STREAMS network emulation code can also be compiled statically or as a
693111314Snyan# module.  If loaded as a module, it must be loaded before the svr4 module
694111314Snyan# (the /usr/sbin/svr4 script does this for you).  If compiling statically,
695111314Snyan# the `streams' device must be configured into any kernel which also
696125234Snyan# specifies COMPAT_SVR4.  It is possible to have a statically-configured
697111314Snyan# STREAMS device and a dynamically loadable svr4 emulator;  the /usr/sbin/svr4
698111314Snyan# script understands that it doesn't need to load the `streams' module under
699111314Snyan# those circumstances.
700111314Snyan# Caveat:  At this time, `options KTRACE' is required for the svr4 emulator
701125234Snyan# (whether static or dynamic).
702125234Snyan#
703111314Snyanoptions 	COMPAT_SVR4	# build emulator statically
704111314Snyanoptions 	DEBUG_SVR4	# enable verbose debugging
705111314Snyandevice		streams		# STREAMS network driver (required for svr4).
706111314Snyan
707111314Snyan
708111314Snyan#####################################################################
709111314Snyan# VM OPTIONS
710111314Snyan
711111314Snyan# Disable the 4 MByte page PSE CPU feature.  The PSE feature allows the
712111314Snyan# kernel to use a 4 MByte pages to map the kernel instead of 4k pages.
713111314Snyan# This saves on the amount of memory needed for page tables needed to
714111314Snyan# map the kernel.  You should only disable this feature as a temporary
715111314Snyan# workaround if you are having problems with it enabled.
716111314Snyan#
717111314Snyan#options 	DISABLE_PSE
718111314Snyan
719111314Snyan# Disable the global pages PGE CPU feature.  The PGE feature allows pages
720111314Snyan# to be marked with the PG_G bit.  TLB entries for these pages are not
721111314Snyan# flushed from the cache when %cr3 is reloaded.  This can make context
722111314Snyan# switches less expensive.  You should only disable this feature as a
723111314Snyan# temporary workaround if you are having problems with it enabled.
724111314Snyan#
725111314Snyan#options 	DISABLE_PG_G
726111314Snyan
727111314Snyan# KSTACK_PAGES is the number of memory pages to assign to the kernel
728111314Snyan# stack of each thread.
729111314Snyan
730111314Snyanoptions 	KSTACK_PAGES=3
731111314Snyan
732111314Snyan#####################################################################
733111314Snyan
734111314Snyan# More undocumented options for linting.
735111314Snyan# Note that documenting these are not considered an affront.
736111314Snyan
737111314Snyanoptions 	FB_INSTALL_CDEV		# install a CDEV entry in /dev
738111314Snyan
739111314Snyan# PECOFF module (Win32 Execution Format)
740111314Snyanoptions 	PECOFF_SUPPORT
741111314Snyanoptions 	PECOFF_DEBUG
742111314Snyan
743111314Snyanoptions 	I4B_SMP_WORKAROUND
744111314Snyanoptions 	I586_PMC_GUPROF=0x70000
745111314Snyanoptions 	KBDIO_DEBUG=2
746111314Snyanoptions 	KBD_MAXRETRY=4
747111314Snyanoptions 	KBD_MAXWAIT=6
748111314Snyanoptions 	KBD_RESETDELAY=201
749111314Snyan
750111314Snyanoptions 	TIMER_FREQ=((14318182+6)/12)
751111314Snyan
752111314Snyanoptions 	VM_KMEM_SIZE
753111314Snyanoptions 	VM_KMEM_SIZE_MAX
754111314Snyanoptions 	VM_KMEM_SIZE_SCALE
755111314Snyan
756111500Sobrien
757111500Sobrien#####################################################################
758111500Sobrien# Devices we don't want to deal with
759111500Sobrien
760111500Sobriennodevice	atkbdc
761111500Sobriennodevice	atkbd
762111500Sobriennodevice	psm
763111500Sobriennodevice	vga
764116382Snyannodevice	bt
765116382Snyannodevice	adw
766111500Sobriennodevice	aha
767116382Snyannodevice	ahb
768116382Snyannodevice	ahd
769116382Snyannodevice	mpt
770116382Snyannodevice	trm
771111500Sobriennodevice	wds
772111500Sobriennodevice	asr
773111500Sobriennodevice	dpt
774111500Sobriennodevice	ciss
775111500Sobriennodevice	iir
776111500Sobriennodevice	mly
777111500Sobriennodevice	ida		# Compaq Smart RAID
778111500Sobriennodevice	mlx		# Mylex DAC960
779111500Sobriennodevice	amr		# AMI MegaRAID
780111500Sobriennodevice	twe		# 3ware ATA RAID
781125086Snyannodevice	ataraid
782116382Snyannodevice	cm
783116382Snyannodevice	cs
784116382Snyannodevice	ex
785116382Snyannodevice	fea
786111500Sobriennodevice	cbb
787111500Sobriennodevice	pccard
788111500Sobriennodevice	cardbus
789116382Snyannodevice	intpm
790116382Snyannodevice	alpm
791116382Snyannodevice	ichsmb
792116382Snyannodevice	viapm
793116382Snyannodevice	amdpm
794116382Snyannodevice	nfpm
795111582Sru
796111582Sru
797111582Sru#####################################################################
798111582Sru# Options we don't want to deal with
799111582Sru
800111582Srunooption	VGA_DEBUG
801111582Srunooption	VGA_WIDTH90
802111582Srunooption	VGA_SLOW_IOACCESS
803111582Srunooption	VGA_ALT_SEQACCESS
804111582Srunooption	PSM_RESETAFTERSUSPEND
805111582Srunooption	PSM_HOOKRESUME
806111582Srunooption	ATKBD_DFLT_KEYMAP
807116382Snyannooption	AHD_DEBUG
808116382Snyannooption	AHD_DEBUG_OPTS
809116382Snyannooption	AHD_REG_PRETTY_PRINT
810116382Snyannooption	ADW_ALLOW_MEMIO
811111582Srunooption	DPT_LOST_IRQ
812111582Srunooption	DPT_RESET_HBA
813111582Srunooption	DPT_TIMEOUT_FACTOR
814116382Snyannooption	AAC_DEBUG
815116382Snyannooption	ACPI_MAX_THREADS
816111582Sru
817111582Sru
818111582Sru#####################################################################
819111582Sru# Make options we don't want to deal with
820111582Sru
821111582Srunomakeoption	ATKBD_DFLT_KEYMAP
822