NOTES revision 127520
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 127520 2004-03-28 12:06:29Z nyan $
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
470124795Snyandevice		pmc
471111314Snyanhint.pmc.0.at="isa"
472111314Snyanhint.pmc.0.port="0x8f0"
473111314Snyandevice		pmtimer			# Adjust system timer at wakeup time
474127017Simp#device		cy	1
475127017Simp#options 	CY_PCI_FASTINTR		# Use with cy_pci unless irq is shared
476111314Snyandevice		digi
477111314Snyan# BIOS & FEP/OS components of device digi.
478111314Snyandevice		digi_CX
479111314Snyandevice		digi_CX_PCI
480111314Snyandevice		digi_EPCX
481111314Snyandevice		digi_EPCX_PCI
482111314Snyandevice		digi_Xe
483111314Snyandevice		digi_Xem
484111314Snyandevice		digi_Xr
485124795Snyandevice		olpt
486124795Snyanhint.olpt.0.at="isa"
487124795Snyanhint.olpt.0.port="0x040"
488111314Snyan
489111314Snyan#
490111314Snyan# Laptop/Notebook options:
491111314Snyan#
492111314Snyan# See also:
493111314Snyan#  apm under `Miscellaneous hardware'
494111314Snyan# above.
495111314Snyan
496111314Snyan# For older notebooks that signal a powerfail condition (external
497111314Snyan# power supply dropped, or battery state low) by issuing an NMI:
498111314Snyan
499111314Snyanoptions 	POWERFAIL_NMI	# make it beep instead of panicing
500111314Snyan
501111314Snyan#
502111314Snyan# PC Card/PCMCIA
503111314Snyan# (OLDCARD)
504111314Snyan#
505111314Snyan# card: pccard slots
506111314Snyan# pcic: isa/pccard bridge
507111314Snyandevice		pcic
508111314Snyanhint.pcic.0.at="isa"
509111314Snyan#hint.pcic.1.at="isa"
510111314Snyandevice		card	1
511111314Snyan
512111314Snyan#---------------------------------------------------------------------------
513111314Snyan# ISDN4BSD
514111314Snyan#
515111314Snyan# See /usr/share/examples/isdn/ROADMAP for an introduction to isdn4bsd.
516111314Snyan#
517111314Snyan# i4b passive ISDN cards support contains the following hardware drivers:
518111314Snyan#
519111314Snyan#	isic  - Siemens/Infineon ISDN ISAC/HSCX/IPAC chipset driver
520111314Snyan#	iwic  - Winbond W6692 PCI bus ISDN S/T interface controller
521111314Snyan#	ifpi  - AVM Fritz!Card PCI driver
522111314Snyan#	ifpi2  - AVM Fritz!Card PCI version 2 driver
523111314Snyan#	ihfc  - Cologne Chip HFC ISA/ISA-PnP chipset driver
524125234Snyan#	ifpnp - AVM Fritz!Card PnP driver
525111314Snyan#	itjc  - Siemens ISAC / TJNet Tiger300/320 chipset
526111314Snyan#
527111314Snyan# i4b active ISDN cards support contains the following hardware drivers:
528111314Snyan#
529111314Snyan#	iavc  - AVM B1 PCI, AVM B1 ISA, AVM T1
530111314Snyan#
531111314Snyan# Note that the ``options'' (if given) and ``device'' lines must BOTH
532111314Snyan# be uncommented to enable support for a given card !
533111314Snyan#
534111314Snyan# In addition to a hardware driver (and probably an option) the mandatory
535125234Snyan# ISDN protocol stack devices and the mandatory support device must be
536111314Snyan# enabled as well as one or more devices from the optional devices section.
537111314Snyan#
538111314Snyan#---------------------------------------------------------------------------
539111314Snyan#	isic driver (Siemens/Infineon chipsets)
540111314Snyan#
541111314Snyandevice	isic
542111314Snyan#
543111314Snyan# PCI bus Cards:
544111314Snyan# --------------
545111314Snyan#
546111314Snyan# ELSA MicroLink ISDN/PCI (same as ELSA QuickStep 1000pro PCI)
547111314Snyanoptions 	ELSA_QS1PCI
548111314Snyan#
549111314Snyan#---------------------------------------------------------------------------
550111314Snyan#	ifpnp driver for AVM Fritz!Card PnP
551111314Snyan#
552111314Snyan# AVM Fritz!Card PnP
553126708Snyandevice		ifpnp
554111314Snyan#
555111314Snyan#---------------------------------------------------------------------------
556111314Snyan#	ihfc driver for Cologne Chip ISA chipsets (experimental!)
557111314Snyan#
558111314Snyan# Teles 16.3c ISA PnP
559111314Snyan# AcerISDN P10 ISA PnP
560111314Snyan# TELEINT ISDN SPEED No.1
561126708Snyandevice		ihfc
562111314Snyan#
563111314Snyan#---------------------------------------------------------------------------
564111314Snyan#	ifpi driver for AVM Fritz!Card PCI
565111314Snyan#
566111314Snyan# AVM Fritz!Card PCI
567126708Snyandevice		ifpi
568111314Snyan#
569111314Snyan#---------------------------------------------------------------------------
570111314Snyan#	ifpi2 driver for AVM Fritz!Card PCI version 2
571111314Snyan#
572111314Snyan# AVM Fritz!Card PCI version 2
573126708Snyandevice		"ifpi2"
574111314Snyan#
575111314Snyan#---------------------------------------------------------------------------
576111314Snyan#	iwic driver for Winbond W6692 chipset
577111314Snyan#
578111314Snyan# ASUSCOM P-IN100-ST-D (and other Winbond W6692 based cards)
579126708Snyandevice		iwic
580111314Snyan#
581111314Snyan#---------------------------------------------------------------------------
582125234Snyan#	itjc driver for Siemens ISAC / TJNet Tiger300/320 chipset
583111314Snyan#
584111314Snyan# Traverse Technologies NETjet-S
585111314Snyan# Teles PCI-TJ
586126708Snyandevice		itjc
587111314Snyan#
588111314Snyan#---------------------------------------------------------------------------
589111314Snyan#	iavc driver (AVM active cards, needs i4bcapi driver!)
590111314Snyan#
591126708Snyandevice		iavc
592111314Snyan#
593111314Snyan#---------------------------------------------------------------------------
594111314Snyan#	ISDN Protocol Stack - mandatory for all hardware drivers
595111314Snyan#
596111314Snyan# Q.921 / layer 2 - i4b passive cards D channel handling
597111314Snyandevice		"i4bq921"
598111314Snyan#
599111314Snyan# Q.931 / layer 3 - i4b passive cards D channel handling
600111314Snyandevice		"i4bq931"
601111314Snyan#
602111314Snyan# layer 4 - i4b common passive and active card handling
603111314Snyandevice		"i4b"
604111314Snyan#
605111314Snyan#---------------------------------------------------------------------------
606111314Snyan#	ISDN devices - mandatory for all hardware drivers
607111314Snyan#
608111314Snyan# userland driver to do ISDN tracing (for passive cards only)
609111314Snyandevice		"i4btrc"	4
610111314Snyan#
611111314Snyan# userland driver to control the whole thing
612111314Snyandevice		"i4bctl"
613111314Snyan#
614111314Snyan#---------------------------------------------------------------------------
615111314Snyan#	ISDN devices - optional
616111314Snyan#
617111314Snyan# userland driver for access to raw B channel
618111314Snyandevice		"i4brbch"	4
619111314Snyan#
620111314Snyan# userland driver for telephony
621111314Snyandevice		"i4btel"	2
622111314Snyan#
623111314Snyan# network driver for IP over raw HDLC ISDN
624111314Snyandevice		"i4bipr"	4
625111314Snyan# enable VJ header compression detection for ipr i/f
626111314Snyanoptions 	IPR_VJ
627111314Snyan# enable logging of the first n IP packets to isdnd (n=32 here)
628111314Snyanoptions 	IPR_LOG=32
629111314Snyan#
630111314Snyan# network driver for sync PPP over ISDN; requires an equivalent
631111314Snyan# number of sppp device to be configured
632111314Snyandevice		"i4bisppp"	4
633111314Snyan#
634111314Snyan# B-channel interface to the netgraph subsystem
635111314Snyandevice		"i4bing"	2
636111314Snyan#
637111314Snyan# CAPI driver needed for active ISDN cards (see iavc driver above)
638111314Snyandevice		"i4bcapi"
639111314Snyan#
640111314Snyan#---------------------------------------------------------------------------
641111314Snyan
642111314Snyan#
643111314Snyan# Set the number of PV entries per process.  Increasing this can
644124795Snyan# stop panics related to heavy use of shared memory.  However, that can
645111314Snyan# (combined with large amounts of physical memory) cause panics at
646111314Snyan# boot time due the kernel running out of VM space.
647111314Snyan#
648111314Snyan# If you're tweaking this, you might also want to increase the sysctls
649111314Snyan# "vm.v_free_min", "vm.v_free_reserved", and "vm.v_free_target".
650111314Snyan#
651111314Snyan# The value below is the one more than the default.
652111314Snyan#
653111314Snyanoptions 	PMAP_SHPGPERPROC=201
654111314Snyan
655111314Snyan#
656111314Snyan# Change the size of the kernel virtual address space.  Due to
657111314Snyan# constraints in loader(8) on i386, this must be a multiple of 4.
658111314Snyan# 256 = 1 GB of kernel address space.  Increasing this also causes
659111314Snyan# a reduction of the address space in user processes.  512 splits
660111314Snyan# the 4GB cpu address space in half (2GB user, 2GB kernel).
661111314Snyan#
662111314Snyanoptions 	KVA_PAGES=260
663111314Snyan
664111314Snyan
665111314Snyan#####################################################################
666111314Snyan# ABI Emulation
667111314Snyan
668111314Snyan# Enable iBCS2 runtime support for SCO and ISC binaries
669111314Snyanoptions 	IBCS2
670111314Snyan
671111314Snyan# Emulate spx device for client side of SVR3 local X interface
672111314Snyanoptions 	SPX_HACK
673111314Snyan
674111314Snyan# Enable Linux ABI emulation
675111314Snyanoptions 	COMPAT_LINUX
676111314Snyan
677111314Snyan# Enable i386 a.out binary support
678111314Snyanoptions 	COMPAT_AOUT
679111314Snyan
680111314Snyan# Enable the linux-like proc filesystem support (requires COMPAT_LINUX
681111314Snyan# and PSEUDOFS)
682111314Snyanoptions 	LINPROCFS
683111314Snyan
684111314Snyan#
685111314Snyan# SysVR4 ABI emulation
686111314Snyan#
687111314Snyan# The svr4 ABI emulator can be statically compiled into the kernel or loaded as
688125234Snyan# a KLD module.
689125234Snyan# The STREAMS network emulation code can also be compiled statically or as a
690111314Snyan# module.  If loaded as a module, it must be loaded before the svr4 module
691111314Snyan# (the /usr/sbin/svr4 script does this for you).  If compiling statically,
692111314Snyan# the `streams' device must be configured into any kernel which also
693125234Snyan# specifies COMPAT_SVR4.  It is possible to have a statically-configured
694111314Snyan# STREAMS device and a dynamically loadable svr4 emulator;  the /usr/sbin/svr4
695111314Snyan# script understands that it doesn't need to load the `streams' module under
696111314Snyan# those circumstances.
697111314Snyan# Caveat:  At this time, `options KTRACE' is required for the svr4 emulator
698125234Snyan# (whether static or dynamic).
699125234Snyan#
700111314Snyanoptions 	COMPAT_SVR4	# build emulator statically
701111314Snyanoptions 	DEBUG_SVR4	# enable verbose debugging
702111314Snyandevice		streams		# STREAMS network driver (required for svr4).
703111314Snyan
704111314Snyan
705111314Snyan#####################################################################
706111314Snyan# VM OPTIONS
707111314Snyan
708111314Snyan# Disable the 4 MByte page PSE CPU feature.  The PSE feature allows the
709111314Snyan# kernel to use a 4 MByte pages to map the kernel instead of 4k pages.
710111314Snyan# This saves on the amount of memory needed for page tables needed to
711111314Snyan# map the kernel.  You should only disable this feature as a temporary
712111314Snyan# workaround if you are having problems with it enabled.
713111314Snyan#
714111314Snyan#options 	DISABLE_PSE
715111314Snyan
716111314Snyan# Disable the global pages PGE CPU feature.  The PGE feature allows pages
717111314Snyan# to be marked with the PG_G bit.  TLB entries for these pages are not
718111314Snyan# flushed from the cache when %cr3 is reloaded.  This can make context
719111314Snyan# switches less expensive.  You should only disable this feature as a
720111314Snyan# temporary workaround if you are having problems with it enabled.
721111314Snyan#
722111314Snyan#options 	DISABLE_PG_G
723111314Snyan
724111314Snyan# KSTACK_PAGES is the number of memory pages to assign to the kernel
725111314Snyan# stack of each thread.
726111314Snyan
727111314Snyanoptions 	KSTACK_PAGES=3
728111314Snyan
729111314Snyan#####################################################################
730111314Snyan
731111314Snyan# More undocumented options for linting.
732111314Snyan# Note that documenting these are not considered an affront.
733111314Snyan
734111314Snyanoptions 	FB_INSTALL_CDEV		# install a CDEV entry in /dev
735111314Snyan
736111314Snyan# PECOFF module (Win32 Execution Format)
737111314Snyanoptions 	PECOFF_SUPPORT
738111314Snyanoptions 	PECOFF_DEBUG
739111314Snyan
740111314Snyanoptions 	I4B_SMP_WORKAROUND
741111314Snyanoptions 	I586_PMC_GUPROF=0x70000
742111314Snyanoptions 	KBDIO_DEBUG=2
743111314Snyanoptions 	KBD_MAXRETRY=4
744111314Snyanoptions 	KBD_MAXWAIT=6
745111314Snyanoptions 	KBD_RESETDELAY=201
746111314Snyan
747111314Snyanoptions 	TIMER_FREQ=((14318182+6)/12)
748111314Snyan
749111314Snyanoptions 	VM_KMEM_SIZE
750111314Snyanoptions 	VM_KMEM_SIZE_MAX
751111314Snyanoptions 	VM_KMEM_SIZE_SCALE
752111314Snyan
753111500Sobrien
754111500Sobrien#####################################################################
755111500Sobrien# Devices we don't want to deal with
756111500Sobrien
757111500Sobriennodevice	atkbdc
758111500Sobriennodevice	atkbd
759111500Sobriennodevice	psm
760111500Sobriennodevice	vga
761116382Snyannodevice	bt
762116382Snyannodevice	adw
763111500Sobriennodevice	aha
764116382Snyannodevice	ahb
765116382Snyannodevice	ahd
766116382Snyannodevice	mpt
767116382Snyannodevice	trm
768111500Sobriennodevice	wds
769111500Sobriennodevice	asr
770111500Sobriennodevice	dpt
771111500Sobriennodevice	ciss
772111500Sobriennodevice	iir
773111500Sobriennodevice	mly
774111500Sobriennodevice	ida		# Compaq Smart RAID
775111500Sobriennodevice	mlx		# Mylex DAC960
776111500Sobriennodevice	amr		# AMI MegaRAID
777111500Sobriennodevice	twe		# 3ware ATA RAID
778125086Snyannodevice	ataraid
779116382Snyannodevice	cm
780116382Snyannodevice	cs
781116382Snyannodevice	ex
782116382Snyannodevice	fea
783111500Sobriennodevice	cbb
784111500Sobriennodevice	pccard
785111500Sobriennodevice	cardbus
786116382Snyannodevice	intpm
787116382Snyannodevice	alpm
788116382Snyannodevice	ichsmb
789116382Snyannodevice	viapm
790116382Snyannodevice	amdpm
791116382Snyannodevice	nfpm
792111582Sru
793111582Sru
794111582Sru#####################################################################
795111582Sru# Options we don't want to deal with
796111582Sru
797111582Srunooption	VGA_DEBUG
798111582Srunooption	VGA_WIDTH90
799111582Srunooption	VGA_SLOW_IOACCESS
800111582Srunooption	VGA_ALT_SEQACCESS
801111582Srunooption	PSM_RESETAFTERSUSPEND
802111582Srunooption	PSM_HOOKRESUME
803111582Srunooption	ATKBD_DFLT_KEYMAP
804116382Snyannooption	AHD_DEBUG
805116382Snyannooption	AHD_DEBUG_OPTS
806116382Snyannooption	AHD_REG_PRETTY_PRINT
807116382Snyannooption	ADW_ALLOW_MEMIO
808111582Srunooption	DPT_LOST_IRQ
809111582Srunooption	DPT_RESET_HBA
810111582Srunooption	DPT_TIMEOUT_FACTOR
811116382Snyannooption	AAC_DEBUG
812116382Snyannooption	ACPI_MAX_THREADS
813111582Sru
814111582Sru
815111582Sru#####################################################################
816111582Sru# Make options we don't want to deal with
817111582Sru
818111582Srunomakeoption	ATKBD_DFLT_KEYMAP
819