xref: /freebsd/sys/i386/conf/NOTES (revision 56c2b57a2d49452fcf733a38ee44abe87431645b)
1#
2# NOTES -- Lines that can be cut/pasted into kernel and hints configs.
3#
4# This file contains machine dependent kernel configuration notes.  For
5# machine independent notes, look in /sys/conf/NOTES.
6#
7# $FreeBSD$
8#
9
10#
11# This directive is mandatory; it defines the architecture to be
12# configured for; in this case, the 386 family based IBM-PC and
13# compatibles.
14#
15machine		i386
16
17#
18# We want LINT to cover profiling as well.
19profile         2
20
21
22#####################################################################
23# SMP OPTIONS:
24#
25# The apic device enables the use of the I/O APIC for interrupt delivery.
26# The apic device can be used in both UP and SMP kernels, but is required
27# for SMP kernels.  Thus, the apic device is not strictly an SMP option,
28# but it is a prerequisite for SMP.
29#
30# Notes:
31#
32# HTT CPUs should only be used if they are enabled in the BIOS.  For
33# the ACPI case, ACPI only correctly tells us about any HTT CPUs if
34# they are enabled.  However, most HTT systems do not list HTT CPUs
35# in the MP Table if they are enabled, thus we guess at the HTT CPUs
36# for the MP Table case.  However, we shouldn't try to guess and use
37# these CPUs if HTT is disabled.  Thus, HTT guessing is only enabled
38# for the MP Table if the user explicitly asks for it via the
39# MPTABLE_FORCE_HTT option.  Do NOT use this option if you have HTT
40# disabled in your BIOS.
41#
42# IPI_PREEMPTION instructs the kernel to preempt threads running on other
43# CPUS if needed.  Relies on the PREEMPTION option
44
45# Mandatory:
46device		apic			# I/O apic
47
48# Optional:
49options 	MPTABLE_FORCE_HTT	# Enable HTT CPUs with the MP Table
50options 	IPI_PREEMPTION
51
52#
53# Watchdog routines.
54#
55options 	MP_WATCHDOG
56
57# Debugging options.
58#
59options		KDB_STOP_NMI		# Stop CPUS using NMI instead of IPI
60
61
62
63#####################################################################
64# CPU OPTIONS
65
66#
67# You must specify at least one CPU (the one you intend to run on);
68# deleting the specification for CPUs you don't need to use may make
69# parts of the system run faster.
70#
71cpu		I486_CPU
72cpu		I586_CPU		# aka Pentium(tm)
73cpu		I686_CPU		# aka Pentium Pro(tm)
74
75#
76# Options for CPU features.
77#
78# CPU_ATHLON_SSE_HACK tries to enable SSE instructions when the BIOS has
79# forgotten to enable them.
80#
81# CPU_BLUELIGHTNING_3X enables triple-clock mode on IBM Blue Lightning
82# CPU if CPU supports it.  The default is double-clock mode on
83# BlueLightning CPU box.
84#
85# CPU_BLUELIGHTNING_FPU_OP_CACHE enables FPU operand cache on IBM
86# BlueLightning CPU.  It works only with Cyrix FPU, and this option
87# should not be used with Intel FPU.
88#
89# CPU_BTB_EN enables branch target buffer on Cyrix 5x86 (NOTE 1).
90#
91# CPU_CYRIX_NO_LOCK enables weak locking for the entire address space
92# of Cyrix 6x86 and 6x86MX CPUs by setting the NO_LOCK bit of CCR1.
93# Otherwise, the NO_LOCK bit of CCR1 is cleared.  (NOTE 3)
94#
95# CPU_DIRECT_MAPPED_CACHE sets L1 cache of Cyrix 486DLC CPU in direct
96# mapped mode.  Default is 2-way set associative mode.
97#
98# CPU_DISABLE_5X86_LSSER disables load store serialize (i.e., enables
99# reorder).  This option should not be used if you use memory mapped
100# I/O device(s).
101#
102# CPU_DISABLE_CMPXCHG disables the CMPXCHG instruction on > i386 IA32
103# machines.  VmWare 3.x seems to emulate this instruction poorly, causing
104# the guest OS to run very slowly.  This problem appears to be fixed in
105# VmWare 4.x, at least in version 4.5.2, so that enabling this option with
106# VmWare 4.x will result in locking operations to be 20-30 times slower.
107# Enabling this with an SMP kernel will cause the kernel to be unusable.
108#
109# CPU_DISABLE_SSE explicitly prevents I686_CPU from turning on SSE.
110#
111# CPU_ELAN enables support for AMDs ElanSC520 CPU.
112#    CPU_ELAN_PPS enables precision timestamp code.
113#    CPU_ELAN_XTAL sets the clock crystal frequency in Hz.
114#
115# CPU_ENABLE_LONGRUN enables support for Transmeta Crusoe LongRun
116# technology which allows to restrict power consumption of the CPU by
117# using group of hw.crusoe.* sysctls.
118#
119# CPU_FASTER_5X86_FPU enables faster FPU exception handler.
120#
121# CPU_GEODE is for the SC1100 Geode embedded processor.  This option
122# is necessary because the i8254 timecounter is toast.
123#
124# CPU_I486_ON_386 enables CPU cache on i486 based CPU upgrade products
125# for i386 machines.
126#
127# CPU_IORT defines I/O clock delay time (NOTE 1).  Default values of
128# I/O clock delay time on Cyrix 5x86 and 6x86 are 0 and 7,respectively
129# (no clock delay).
130#
131# CPU_L2_LATENCY specifies the L2 cache latency value.  This option is used
132# only when CPU_PPRO2CELERON is defined and Mendocino Celeron is detected.
133# The default value is 5.
134#
135# CPU_LOOP_EN prevents flushing the prefetch buffer if the destination
136# of a jump is already present in the prefetch buffer on Cyrix 5x86(NOTE
137# 1).
138#
139# CPU_PPRO2CELERON enables L2 cache of Mendocino Celeron CPUs.  This option
140# is useful when you use Socket 8 to Socket 370 converter, because most Pentium
141# Pro BIOSs do not enable L2 cache of Mendocino Celeron CPUs.
142#
143# CPU_RSTK_EN enables return stack on Cyrix 5x86 (NOTE 1).
144#
145# CPU_SOEKRIS enables support www.soekris.com hardware.
146#
147# CPU_SUSP_HLT enables suspend on HALT.  If this option is set, CPU
148# enters suspend mode following execution of HALT instruction.
149#
150# CPU_UPGRADE_HW_CACHE eliminates unneeded cache flush instruction(s).
151#
152# CPU_WT_ALLOC enables write allocation on Cyrix 6x86/6x86MX and AMD
153# K5/K6/K6-2 CPUs.
154#
155# CYRIX_CACHE_WORKS enables CPU cache on Cyrix 486 CPUs with cache
156# flush at hold state.
157#
158# CYRIX_CACHE_REALLY_WORKS enables (1) CPU cache on Cyrix 486 CPUs
159# without cache flush at hold state, and (2) write-back CPU cache on
160# Cyrix 6x86 whose revision < 2.7 (NOTE 2).
161#
162# NO_F00F_HACK disables the hack that prevents Pentiums (and ONLY
163# Pentiums) from locking up when a LOCK CMPXCHG8B instruction is
164# executed.  This option is only needed if I586_CPU is also defined,
165# and should be included for any non-Pentium CPU that defines it.
166#
167# NO_MEMORY_HOLE is an optimisation for systems with AMD K6 processors
168# which indicates that the 15-16MB range is *definitely* not being
169# occupied by an ISA memory hole.
170#
171# NOTE 1: The options, CPU_BTB_EN, CPU_LOOP_EN, CPU_IORT,
172# CPU_LOOP_EN and CPU_RSTK_EN should not be used because of CPU bugs.
173# These options may crash your system.
174#
175# NOTE 2: If CYRIX_CACHE_REALLY_WORKS is not set, CPU cache is enabled
176# in write-through mode when revision < 2.7.  If revision of Cyrix
177# 6x86 >= 2.7, CPU cache is always enabled in write-back mode.
178#
179# NOTE 3: This option may cause failures for software that requires
180# locked cycles in order to operate correctly.
181#
182options 	CPU_ATHLON_SSE_HACK
183options 	CPU_BLUELIGHTNING_3X
184options 	CPU_BLUELIGHTNING_FPU_OP_CACHE
185options 	CPU_BTB_EN
186options 	CPU_DIRECT_MAPPED_CACHE
187options 	CPU_DISABLE_5X86_LSSER
188options 	CPU_DISABLE_CMPXCHG
189#options 	CPU_DISABLE_SSE
190options 	CPU_ELAN
191options 	CPU_ELAN_PPS
192options 	CPU_ELAN_XTAL=32768000
193options 	CPU_ENABLE_LONGRUN
194options 	CPU_FASTER_5X86_FPU
195options 	CPU_GEODE
196options 	CPU_I486_ON_386
197options 	CPU_IORT
198options 	CPU_L2_LATENCY=5
199options 	CPU_LOOP_EN
200options 	CPU_PPRO2CELERON
201options 	CPU_RSTK_EN
202options 	CPU_SOEKRIS
203options 	CPU_SUSP_HLT
204options 	CPU_UPGRADE_HW_CACHE
205options 	CPU_WT_ALLOC
206options 	CYRIX_CACHE_WORKS
207options 	CYRIX_CACHE_REALLY_WORKS
208#options 	NO_F00F_HACK
209
210# Debug options
211options 	NPX_DEBUG	# enable npx debugging
212
213#
214# PERFMON causes the driver for Pentium/Pentium Pro performance counters
215# to be compiled.  See perfmon(4) for more information.
216#
217options 	PERFMON
218
219
220#####################################################################
221# NETWORKING OPTIONS
222
223#
224# DEVICE_POLLING adds support for mixed interrupt-polling handling
225# of network device drivers, which has significant benefits in terms
226# of robustness to overloads and responsivity, as well as permitting
227# accurate scheduling of the CPU time between kernel network processing
228# and other activities.  The drawback is a moderate (up to 1/HZ seconds)
229# potential increase in response times.
230# It is strongly recommended to use HZ=1000 or 2000 with DEVICE_POLLING
231# to achieve smoother behaviour.
232# Additionally, you can enable/disable polling at runtime with the
233# sysctl variable kern.polling.enable (defaults off), and select
234# the CPU fraction reserved to userland with the sysctl variable
235# kern.polling.user_frac (default 50, range 0..100).
236#
237# Not all device drivers support this mode of operation at the time of
238# this writing.  See polling(4) for more details.
239
240options 	DEVICE_POLLING
241
242
243#####################################################################
244# CLOCK OPTIONS
245
246# The following options are used for debugging clock behavior only, and
247# should not be used for production systems.
248
249# CLK_CALIBRATION_LOOP causes clock calibration to be run in a loop at
250# startup until the user presses a key.  (The i8254 clock is always
251# calibrated relative to the RTC (mc146818a) and this option causes the
252# calibration to be repeated.)
253options 	CLK_CALIBRATION_LOOP
254
255# CLK_USE_I8254_CALIBRATION causes the calibrated frequency of the i8254
256# clock to actually be used.
257options 	CLK_USE_I8254_CALIBRATION
258
259
260#####################################################################
261# MISCELLANEOUS DEVICES AND OPTIONS
262
263device		speaker		#Play IBM BASIC-style noises out your speaker
264hint.speaker.0.at="isa"
265hint.speaker.0.port="0x61"
266device		gzip		#Exec gzipped a.out's.  REQUIRES COMPAT_AOUT!
267device		apm_saver	# Requires APM
268
269
270#####################################################################
271# HARDWARE BUS CONFIGURATION
272
273#
274# ISA bus
275#
276device		isa		# Required by npx(4)
277
278#
279# Options for `isa':
280#
281# AUTO_EOI_1 enables the `automatic EOI' feature for the master 8259A
282# interrupt controller.  This saves about 0.7-1.25 usec for each interrupt.
283# This option breaks suspend/resume on some portables.
284#
285# AUTO_EOI_2 enables the `automatic EOI' feature for the slave 8259A
286# interrupt controller.  This saves about 0.7-1.25 usec for each interrupt.
287# Automatic EOI is documented not to work for for the slave with the
288# original i8259A, but it works for some clones and some integrated
289# versions.
290#
291# MAXMEM specifies the amount of RAM on the machine; if this is not
292# specified, FreeBSD will first read the amount of memory from the CMOS
293# RAM, so the amount of memory will initially be limited to 64MB or 16MB
294# depending on the BIOS.  If the BIOS reports 64MB, a memory probe will
295# then attempt to detect the installed amount of RAM.  If this probe
296# fails to detect >64MB RAM you will have to use the MAXMEM option.
297# The amount is in kilobytes, so for a machine with 128MB of RAM, it would
298# be 131072 (128 * 1024).
299#
300# BROKEN_KEYBOARD_RESET disables the use of the keyboard controller to
301# reset the CPU for reboot.  This is needed on some systems with broken
302# keyboard controllers.
303
304options 	AUTO_EOI_1
305#options 	AUTO_EOI_2
306
307options 	MAXMEM=(128*1024)
308#options 	BROKEN_KEYBOARD_RESET
309
310#
311# EISA bus
312#
313# The EISA bus device is `eisa'.  It provides auto-detection and
314# configuration support for all devices on the EISA bus.
315
316device		eisa
317
318# By default, only 10 EISA slots are probed, since the slot numbers
319# above clash with the configuration address space of the PCI subsystem,
320# and the EISA probe is not very smart about this.  This is sufficient
321# for most machines, but in particular the HP NetServer LC series comes
322# with an onboard AIC7770 dual-channel SCSI controller on EISA slot #11,
323# thus you need to bump this figure to 12 for them.
324options 	EISA_SLOTS=12
325
326#
327# MCA bus:
328#
329# The MCA bus device is `mca'.  It provides auto-detection and
330# configuration support for all devices on the MCA bus.
331# No hints are required for MCA.
332
333device		mca
334
335#
336# PCI bus & PCI options:
337#
338device		pci
339
340#
341# AGP GART support
342device		agp
343
344
345#####################################################################
346# HARDWARE DEVICE CONFIGURATION
347
348# To include support for VGA VESA video modes
349options 	VESA
350
351# Turn on extra debugging checks and output for VESA support.
352options 	VESA_DEBUG
353
354# The pcvt console driver (vt220 compatible).
355device		vt
356hint.vt.0.at="isa"
357options 	XSERVER			# support for running an X server on vt
358options 	FAT_CURSOR		# start with block cursor
359# This PCVT option is for keyboards such as those used on really old ThinkPads
360options 	PCVT_SCANSET=2
361# Other PCVT options are documented in pcvt(4).
362options 	PCVT_24LINESDEF
363options 	PCVT_CTRL_ALT_DEL
364options 	PCVT_META_ESC
365options 	PCVT_NSCREENS=9
366options 	PCVT_PRETTYSCRNS
367options 	PCVT_SCREENSAVER
368options 	PCVT_USEKBDSEC
369options 	PCVT_VT220KEYB
370options 	PCVT_GREENSAVER
371
372#
373# The Numeric Processing eXtension driver.  This is non-optional.
374device		npx
375hint.npx.0.flags="0x0"
376hint.npx.0.irq="13"
377
378#
379# `flags' for npx0:
380#	0x01	don't use the npx registers to optimize bcopy.
381#	0x02	don't use the npx registers to optimize bzero.
382#	0x04	don't use the npx registers to optimize copyin or copyout.
383# The npx registers are normally used to optimize copying and zeroing when
384# all of the following conditions are satisfied:
385#	I586_CPU is an option
386#	the cpu is an i586 (perhaps not a Pentium)
387#	the probe for npx0 succeeds
388#	INT 16 exception handling works.
389# Then copying and zeroing using the npx registers is normally 30-100% faster.
390# The flags can be used to control cases where it doesn't work or is slower.
391# Setting them at boot time using hints works right (the optimizations
392# are not used until later in the bootstrap when npx0 is attached).
393# Flag 0x08 automatically disables the i586 optimized routines.
394#
395
396#
397# Optional devices:
398#
399
400# 3Dfx Voodoo Graphics, Voodoo II /dev/3dfx CDEV support.  This will create
401# the /dev/3dfx0 device to work with glide implementations.  This should get
402# linked to /dev/3dfx and /dev/voodoo.  Note that this is not the same as
403# the tdfx DRI module from XFree86 and is completely unrelated.
404#
405# To enable Linuxulator support, one must also include COMPAT_LINUX in the
406# config as well, or you will not have the dependencies.  The other option
407# is to load both as modules.
408
409device		tdfx			# Enable 3Dfx Voodoo support
410options 	TDFX_LINUX		# Enable Linuxulator support
411
412#
413# ACPI support using the Intel ACPI Component Architecture reference
414# implementation.
415#
416# ACPI_DEBUG enables the use of the debug.acpi.level and debug.acpi.layer
417# kernel environment variables to select initial debugging levels for the
418# Intel ACPICA code.  (Note that the Intel code must also have USE_DEBUGGER
419# defined when it is built).
420#
421# ACPI_NO_SEMAPHORES makes the AcpiOs*Semaphore routines a no-op.
422#
423# ACPICA_PEDANTIC enables strict checking of AML.  Our default is to
424# relax these checks to allow code generated by the Microsoft compiler
425# to still execute.
426#
427# Note that building ACPI into the kernel is deprecated; the module is
428# normally loaded automatically by the loader.
429
430device		acpi
431options 	ACPI_DEBUG
432#!options 	ACPI_NO_SEMAPHORES
433#!options 	ACPICA_PEDANTIC
434
435# ACPI Asus Extras (LCD backlight/brightness, video output, etc.)
436device		acpi_asus
437
438# ACPI Fujitsu Extras (Buttons)
439device		acpi_fujitsu
440
441# ACPI Panasonic Extras (LCD backlight/brightness, video output, etc.)
442device		acpi_panasonic
443
444# ACPI Sony extra (LCD brightness)
445device		acpi_sony
446
447# ACPI Toshiba Extras (LCD backlight/brightness, video output, etc.)
448device		acpi_toshiba
449
450# ACPI Video Extensions (LCD backlight/brightness, video output, etc.)
451device		acpi_video
452
453# The cpufreq(4) driver provides support for non-ACPI CPU frequency control
454device		cpufreq
455
456# Direct Rendering modules for 3D acceleration.
457device		drm		# DRM core module required by DRM drivers
458device		mach64drm	# ATI Rage Pro, Rage Mobility P/M, Rage XL
459device		mgadrm		# AGP Matrox G200, G400, G450, G550
460device		r128drm		# ATI Rage 128
461device		radeondrm	# ATI Radeon up to 9200
462device		sisdrm		# SiS 300/305, 540, 630
463device		tdfxdrm		# 3dfx Voodoo 3/4/5 and Banshee
464options 	DRM_DEBUG	# Include debug printfs (slow)
465
466#
467# mse: Logitech and ATI InPort bus mouse ports
468
469device		mse
470hint.mse.0.at="isa"
471hint.mse.0.port="0x23c"
472hint.mse.0.irq="5"
473
474#
475# Network interfaces:
476#
477
478# ar:   Arnet SYNC/570i hdlc sync 2/4 port V.35/X.21 serial driver
479#       (requires sppp)
480# arl:	Aironet Arlan 655 wireless adapters.
481# ath:  Atheros a/b/g WiFi adapters (requires ath_hal and wlan)
482# cp:   Cronyx Tau-PCI sync single/dual/four port
483#       V.35/RS-232/RS-530/RS-449/X.21/G.703/E1/E3/T3/STS-1
484#       serial adaptor (requires sppp (default), or NETGRAPH if
485#       NETGRAPH_CRONYX is configured)
486# ctau: Cronyx Tau sync dual port V.35/RS-232/RS-530/RS-449/X.21/G.703/E1
487#       serial adaptor (requires sppp (default), or NETGRAPH if
488#       NETGRAPH_CRONYX is configured)
489# cx:   Cronyx Sigma multiport sync/async adapter (requires sppp (default),
490#       or NETGRAPH if NETGRAPH_CRONYX is configured)
491# ed:   Western Digital and SMC 80xx; Novell NE1000 and NE2000; 3Com 3C503
492#       HP PC Lan+, various PC Card devices (refer to etc/defaults/pccard.conf)
493#       (requires miibus)
494# el:   3Com 3C501 (slow!)
495# ie:   AT&T StarLAN 10 and EN100; 3Com 3C507; unknown NI5210;
496#       Intel EtherExpress
497# lnc:  Lance/PCnet cards (Isolan, Novell NE2100, NE32-VL, AMD Am7990 and
498#       Am79C960)
499# oltr: Olicom ISA token-ring adapters OC-3115, OC-3117, OC-3118 and OC-3133.
500#       Olicom PCI token-ring adapters OC-3136, OC-3137, OC-3139, OC-3140,
501#       OC-3141, OC-3540 and OC-3250.
502# sbni: Granch SBNI12-xx ISA and PCI adapters
503# sr:   RISCom/N2 hdlc sync 1/2 port V.35/X.21 serial driver (requires sppp)
504# wl:   Lucent Wavelan (ISA card only).
505
506# Order for ISA/EISA devices is important here
507
508device		ar
509hint.ar.0.at="isa"
510hint.ar.0.port="0x300"
511hint.ar.0.irq="10"
512hint.ar.0.maddr="0xd0000"
513device		arl
514hint.arl.0.at="isa"
515hint.arl.0.irq="9"
516hint.arl.0.maddr="0xd0000"
517device		cp
518device		ctau
519hint.ctau.0.at="isa"
520hint.ctau.0.port="0x240"
521hint.ctau.0.irq="15"
522hint.ctau.0.drq="7"
523device		cx
524hint.cx.0.at="isa"
525hint.cx.0.port="0x240"
526hint.cx.0.irq="15"
527hint.cx.0.drq="7"
528#options 	NETGRAPH_CRONYX		# Enable NETGRAPH support for Cronyx adapter(s)
529device		ed
530#options 	ED_NO_MIIBUS		# Disable ed miibus support
531options 	ED_3C503
532options 	ED_HPP
533options 	ED_SIC
534hint.ed.0.at="isa"
535hint.ed.0.port="0x280"
536hint.ed.0.irq="5"
537hint.ed.0.maddr="0xd8000"
538device		el
539hint.el.0.at="isa"
540hint.el.0.port="0x300"
541hint.el.0.irq="9"
542device		ie			# Hints only required for Starlan
543hint.ie.2.at="isa"
544hint.ie.2.port="0x300"
545hint.ie.2.irq="5"
546hint.ie.2.maddr="0xd0000"
547device		lnc
548hint.lnc.0.at="isa"
549hint.lnc.0.port="0x280"
550hint.lnc.0.irq="10"
551hint.lnc.0.drq="0"
552device		sbni
553hint.sbni.0.at="isa"
554hint.sbni.0.port="0x210"
555hint.sbni.0.irq="0xefdead"
556hint.sbni.0.flags="0"
557device		sr
558hint.sr.0.at="isa"
559hint.sr.0.port="0x300"
560hint.sr.0.irq="5"
561hint.sr.0.maddr="0xd0000"
562device		oltr
563hint.oltr.0.at="isa"
564device		wl
565hint.wl.0.at="isa"
566hint.wl.0.port="0x300"
567options 	WLCACHE		# enables the signal-strength cache
568options 	WLDEBUG		# enables verbose debugging output
569
570device		ath
571device		ath_hal		# Atheros HAL (includes binary component)
572device		ath_rate_onoe	# Onoe rate control for ath driver
573#device		ath_rate_amrr	# AMRR rate control for ath driver
574#device		ath_rate_sample	# SampleRate rate control for the ath driver
575#device		wlan		# 802.11 layer
576
577#
578# ATA raid adapters
579#
580device		pst
581
582#
583# Areca 11xx and 12xx series of SATA II RAID controllers.
584# CAM is required.
585#
586device		arcmsr		# Areca SATA II RAID
587
588#
589# 3ware 9000 series PATA/SATA RAID controller driver and options.
590# The driver is implemented as a SIM, and so, needs the CAM infrastructure.
591#
592options 	TWA_DEBUG		# 0-10; 10 prints the most messages.
593options 	TWA_FLASH_FIRMWARE	# firmware image bundled when defined.
594device		twa			# 3ware 9000 series PATA/SATA RAID
595
596#
597# SCSI host adapters:
598#
599# ncv: NCR 53C500 based SCSI host adapters.
600# nsp: Workbit Ninja SCSI-3 based PC Card SCSI host adapters.
601# stg: TMC 18C30, 18C50 based SCSI host adapters.
602
603device		ncv
604device		nsp
605device		stg
606hint.stg.0.at="isa"
607hint.stg.0.port="0x140"
608hint.stg.0.port="11"
609
610#
611# Adaptec FSA RAID controllers, including integrated DELL controllers,
612# the Dell PERC 2/QC and the HP NetRAID-4M
613device		aac
614device		aacp	# SCSI Passthrough interface (optional, CAM required)
615
616#
617# Highpoint RocketRAID 182x.  This is really just software RAID on a
618# Marvell SATA chip.
619device		hptmv
620
621#
622# IBM (now Adaptec) ServeRAID controllers
623device		ips
624
625#
626# SafeNet crypto driver: can be moved to the MI NOTES as soon as
627# it's tested on a big-endian machine
628#
629device		safe		# SafeNet 1141
630options 	SAFE_DEBUG	# enable debugging support: hw.safe.debug
631options 	SAFE_RNDTEST	# enable rndtest support
632
633#####################################################################
634
635#
636# Miscellaneous hardware:
637#
638# apm: Laptop Advanced Power Management (experimental)
639# pmtimer: Timer device driver for power management events (APM or ACPI)
640# smapi: System Management Application Program Interface driver
641# smbios: DMI/SMBIOS entry point
642# vpd: Vital Product Data kernel interface
643# cy: Cyclades serial driver
644# digi: Digiboard driver
645# spic: Sony Programmable I/O controller (VAIO notebooks)
646
647# Notes on APM
648#  The flags takes the following meaning for apm0:
649#    0x0020  Statclock is broken.
650
651# Notes on the Specialix SI/XIO driver:
652#  The host card is memory, not IO mapped.
653#  The Rev 1 host cards use a 64K chunk, on a 32K boundary.
654#  The Rev 2 host cards use a 32K chunk, on a 32K boundary.
655#  The cards can use an IRQ of 11, 12 or 15.
656
657# Notes on the Sony Programmable I/O controller
658#  This is a temporary driver that should someday be replaced by something
659#  that hooks into the ACPI layer.  The device is hooked to the PIIX4's
660#  General Device 10 decoder, which means you have to fiddle with PCI
661#  registers to map it in, even though it is otherwise treated here as
662#  an ISA device.  At the moment, the driver polls, although the device
663#  is capable of generating interrupts.  It largely undocumented.
664#  The port location in the hint is where you WANT the device to be
665#  mapped.  0x10a0 seems to be traditional.  At the moment the jogdial
666#  is the only thing truly supported, but apparently a fair percentage
667#  of the Vaio extra features are controlled by this device.
668
669device		apm
670hint.apm.0.flags="0x20"
671device		smapi
672device		smbios
673device		vpd
674device		pmtimer			# Adjust system timer at wakeup time
675device		cy
676options 	CY_PCI_FASTINTR		# Use with cy_pci unless irq is shared
677hint.cy.0.at="isa"
678hint.cy.0.irq="10"
679hint.cy.0.maddr="0xd4000"
680hint.cy.0.msize="0x2000"
681device		digi
682hint.digi.0.at="isa"
683hint.digi.0.port="0x104"
684hint.digi.0.maddr="0xd0000"
685# BIOS & FEP/OS components of device digi.
686device		digi_CX
687device		digi_CX_PCI
688device		digi_EPCX
689device		digi_EPCX_PCI
690device		digi_Xe
691device		digi_Xem
692device		digi_Xr
693# Parallel (8255 PPI) basic I/O (mode 0) port (e.g. Advantech PCL-724)
694device		pbio
695hint.pbio.0.at="isa"
696hint.pbio.0.port="0x360"
697device		spic
698hint.spic.0.at="isa"
699hint.spic.0.port="0x10a0"
700# sx device is i386 and pc98 only at the moment.
701device		sx
702options 	SX_DEBUG
703# HOT1 Xilinx 6200 card (http://www.vcc.com/)
704device		xrpu
705
706#
707# Laptop/Notebook options:
708#
709# See also:
710#  apm under `Miscellaneous hardware'
711# above.
712
713# For older notebooks that signal a powerfail condition (external
714# power supply dropped, or battery state low) by issuing an NMI:
715
716options 	POWERFAIL_NMI	# make it beep instead of panicing
717
718#
719# I2C Bus
720#
721# Philips i2c bus support is provided by the `iicbus' device.
722#
723# Supported interfaces:
724# pcf	Philips PCF8584 ISA-bus controller
725#
726device		pcf
727hint.pcf.0.at="isa"
728hint.pcf.0.port="0x320"
729hint.pcf.0.irq="5"
730
731#
732# Hardware watchdog timers:
733#
734# ichwd: Intel ICH watchdog timer
735#
736device		ichwd
737
738#---------------------------------------------------------------------------
739# ISDN4BSD
740#
741# See /usr/share/examples/isdn/ROADMAP for an introduction to isdn4bsd.
742#
743# i4b passive ISDN cards support contains the following hardware drivers:
744#
745#	isic  - Siemens/Infineon ISDN ISAC/HSCX/IPAC chipset driver
746#	iwic  - Winbond W6692 PCI bus ISDN S/T interface controller
747#	ifpi  - AVM Fritz!Card PCI driver
748#	ifpi2  - AVM Fritz!Card PCI version 2 driver
749#	ihfc  - Cologne Chip HFC ISA/ISA-PnP chipset driver
750#	ifpnp - AVM Fritz!Card PnP driver
751#	itjc  - Siemens ISAC / TJNet Tiger300/320 chipset
752#
753# i4b active ISDN cards support contains the following hardware drivers:
754#
755#	iavc  - AVM B1 PCI, AVM B1 ISA, AVM T1
756#
757# Note that the ``options'' (if given) and ``device'' lines must BOTH
758# be uncommented to enable support for a given card !
759#
760# In addition to a hardware driver (and probably an option) the mandatory
761# ISDN protocol stack devices and the mandatory support device must be
762# enabled as well as one or more devices from the optional devices section.
763#
764#---------------------------------------------------------------------------
765#	isic driver (Siemens/Infineon chipsets)
766#
767device	isic
768#
769# ISA bus non-PnP Cards:
770# ----------------------
771#
772# Teles S0/8 or Niccy 1008
773options 	TEL_S0_8
774hint.isic.0.at="isa"
775hint.isic.0.maddr="0xd0000"
776hint.isic.0.irq="5"
777hint.isic.0.flags="1"
778#
779# Teles S0/16 or Creatix ISDN-S0 or Niccy 1016
780options 	TEL_S0_16
781hint.isic.0.at="isa"
782hint.isic.0.port="0xd80"
783hint.isic.0.maddr="0xd0000"
784hint.isic.0.irq="5"
785hint.isic.0.flags="2"
786#
787# Teles S0/16.3
788options 	TEL_S0_16_3
789hint.isic.0.at="isa"
790hint.isic.0.port="0xd80"
791hint.isic.0.irq="5"
792hint.isic.0.flags="3"
793#
794# AVM A1 or AVM Fritz!Card
795options 	AVM_A1
796hint.isic.0.at="isa"
797hint.isic.0.port="0x340"
798hint.isic.0.irq="5"
799hint.isic.0.flags="4"
800#
801# USRobotics Sportster ISDN TA intern
802options 	USR_STI
803hint.isic.0.at="isa"
804hint.isic.0.port="0x268"
805hint.isic.0.irq="5"
806hint.isic.0.flags="7"
807#
808# ITK ix1 Micro ( < V.3, non-PnP version )
809options 	ITKIX1
810hint.isic.0.at="isa"
811hint.isic.0.port="0x398"
812hint.isic.0.irq="10"
813hint.isic.0.flags="18"
814#
815# ELSA PCC-16
816options 	ELSA_PCC16
817hint.isic.0.at="isa"
818hint.isic.0.port="0x360"
819hint.isic.0.irq="10"
820hint.isic.0.flags="20"
821#
822# ISA bus PnP Cards:
823# ------------------
824#
825# Teles S0/16.3 PnP
826options 	TEL_S0_16_3_P
827#
828# Creatix ISDN-S0 P&P
829options 	CRTX_S0_P
830#
831# Dr. Neuhaus Niccy Go@
832options 	DRN_NGO
833#
834# Sedlbauer Win Speed
835options 	SEDLBAUER
836#
837# Dynalink IS64PH
838options 	DYNALINK
839#
840# ELSA QuickStep 1000pro ISA
841options 	ELSA_QS1ISA
842#
843# Siemens I-Surf 2.0
844options 	SIEMENS_ISURF2
845#
846# Asuscom ISDNlink 128K ISA
847options 	ASUSCOM_IPAC
848#
849# Eicon Diehl DIVA 2.0 and 2.02
850options 	EICON_DIVA
851#
852# Compaq Microcom 610 ISDN card (Compaq series PSB2222I)
853options 	COMPAQ_M610
854#
855# PCI bus Cards:
856# --------------
857#
858# ELSA MicroLink ISDN/PCI (same as ELSA QuickStep 1000pro PCI)
859options 	ELSA_QS1PCI
860#
861#---------------------------------------------------------------------------
862#	ifpnp driver for AVM Fritz!Card PnP
863#
864# AVM Fritz!Card PnP
865device		ifpnp
866#
867#---------------------------------------------------------------------------
868#	ihfc driver for Cologne Chip ISA chipsets (experimental!)
869#
870# Teles 16.3c ISA PnP
871# AcerISDN P10 ISA PnP
872# TELEINT ISDN SPEED No.1
873device		ihfc
874#
875#---------------------------------------------------------------------------
876#	ifpi driver for AVM Fritz!Card PCI
877#
878# AVM Fritz!Card PCI
879device		ifpi
880#
881#---------------------------------------------------------------------------
882#	ifpi2 driver for AVM Fritz!Card PCI version 2
883#
884# AVM Fritz!Card PCI version 2
885device		ifpi2
886#
887#---------------------------------------------------------------------------
888#	iwic driver for Winbond W6692 chipset
889#
890# ASUSCOM P-IN100-ST-D (and other Winbond W6692 based cards)
891device		iwic
892#
893#---------------------------------------------------------------------------
894#	itjc driver for Siemens ISAC / TJNet Tiger300/320 chipset
895#
896# Traverse Technologies NETjet-S
897# Teles PCI-TJ
898device		itjc
899#
900#---------------------------------------------------------------------------
901#	iavc driver (AVM active cards, needs i4bcapi driver!)
902#
903device		iavc
904#
905# AVM B1 ISA bus (PnP mode not supported!)
906# ----------------------------------------
907hint.iavc.0.at="isa"
908hint.iavc.0.port="0x150"
909hint.iavc.0.irq="5"
910#
911#---------------------------------------------------------------------------
912#	ISDN Protocol Stack - mandatory for all hardware drivers
913#
914# Q.921 / layer 2 - i4b passive cards D channel handling
915device		i4bq921
916#
917# Q.931 / layer 3 - i4b passive cards D channel handling
918device		i4bq931
919#
920# layer 4 - i4b common passive and active card handling
921device		i4b
922#
923#---------------------------------------------------------------------------
924#	ISDN devices - mandatory for all hardware drivers
925#
926# userland driver to do ISDN tracing (for passive cards only)
927device		i4btrc
928options 	NI4BTRC=4
929#
930# userland driver to control the whole thing
931device		i4bctl
932#
933#---------------------------------------------------------------------------
934#	ISDN devices - optional
935#
936# userland driver for access to raw B channel
937device		i4brbch
938options 	NI4BRBCH=4
939#
940# userland driver for telephony
941device		i4btel
942options 	NI4BTEL=2
943#
944# network driver for IP over raw HDLC ISDN
945device		i4bipr
946options 	NI4BIPR=4
947# enable VJ header compression detection for ipr i/f
948options 	IPR_VJ
949# enable logging of the first n IP packets to isdnd (n=32 here)
950options 	IPR_LOG=32
951#
952# network driver for sync PPP over ISDN; requires an equivalent
953# number of sppp device to be configured
954device		i4bisppp
955options 	NI4BISPPP=4
956#
957# B-channel interface to the netgraph subsystem
958device		i4bing
959options 	NI4BING=2
960#
961# CAPI driver needed for active ISDN cards (see iavc driver above)
962device		i4bcapi
963#
964#---------------------------------------------------------------------------
965
966#
967# System Management Bus (SMB)
968#
969options 	ENABLE_ALART		# Control alarm on Intel intpm driver
970
971#
972# Set the number of PV entries per process.  Increasing this can
973# stop panics related to heavy use of shared memory.  However, that can
974# (combined with large amounts of physical memory) cause panics at
975# boot time due the kernel running out of VM space.
976#
977# If you're tweaking this, you might also want to increase the sysctls
978# "vm.v_free_min", "vm.v_free_reserved", and "vm.v_free_target".
979#
980# The value below is the one more than the default.
981#
982options 	PMAP_SHPGPERPROC=201
983
984#
985# Change the size of the kernel virtual address space.  Due to
986# constraints in loader(8) on i386, this must be a multiple of 4.
987# 256 = 1 GB of kernel address space.  Increasing this also causes
988# a reduction of the address space in user processes.  512 splits
989# the 4GB cpu address space in half (2GB user, 2GB kernel).
990#
991options 	KVA_PAGES=260
992
993
994#####################################################################
995# ABI Emulation
996
997# Enable iBCS2 runtime support for SCO and ISC binaries
998options 	IBCS2
999
1000# Emulate spx device for client side of SVR3 local X interface
1001options 	SPX_HACK
1002
1003# Enable Linux ABI emulation
1004options 	COMPAT_LINUX
1005
1006# Enable i386 a.out binary support
1007options 	COMPAT_AOUT
1008
1009# Enable the linux-like proc filesystem support (requires COMPAT_LINUX
1010# and PSEUDOFS)
1011options 	LINPROCFS
1012
1013#
1014# SysVR4 ABI emulation
1015#
1016# The svr4 ABI emulator can be statically compiled into the kernel or loaded as
1017# a KLD module.
1018# The STREAMS network emulation code can also be compiled statically or as a
1019# module.  If loaded as a module, it must be loaded before the svr4 module
1020# (the /usr/sbin/svr4 script does this for you).  If compiling statically,
1021# the `streams' device must be configured into any kernel which also
1022# specifies COMPAT_SVR4.  It is possible to have a statically-configured
1023# STREAMS device and a dynamically loadable svr4 emulator;  the /usr/sbin/svr4
1024# script understands that it doesn't need to load the `streams' module under
1025# those circumstances.
1026# Caveat:  At this time, `options KTRACE' is required for the svr4 emulator
1027# (whether static or dynamic).
1028#
1029options 	COMPAT_SVR4	# build emulator statically
1030options 	DEBUG_SVR4	# enable verbose debugging
1031device		streams		# STREAMS network driver (required for svr4).
1032
1033
1034#####################################################################
1035# VM OPTIONS
1036
1037# Disable the 4 MByte page PSE CPU feature.  The PSE feature allows the
1038# kernel to use 4 MByte pages to map the kernel instead of 4k pages.
1039# This saves on the amount of memory needed for page tables needed to
1040# map the kernel.  You should only disable this feature as a temporary
1041# workaround if you are having problems with it enabled.
1042#
1043#options 	DISABLE_PSE
1044
1045# Disable the global pages PGE CPU feature.  The PGE feature allows pages
1046# to be marked with the PG_G bit.  TLB entries for these pages are not
1047# flushed from the cache when %cr3 is reloaded.  This can make context
1048# switches less expensive.  You should only disable this feature as a
1049# temporary workaround if you are having problems with it enabled.
1050#
1051#options 	DISABLE_PG_G
1052
1053# KSTACK_PAGES is the number of memory pages to assign to the kernel
1054# stack of each thread.
1055
1056options 	KSTACK_PAGES=3
1057
1058#####################################################################
1059
1060# More undocumented options for linting.
1061# Note that documenting these are not considered an affront.
1062
1063options 	FB_INSTALL_CDEV		# install a CDEV entry in /dev
1064
1065# PECOFF module (Win32 Execution Format)
1066options 	PECOFF_SUPPORT
1067options 	PECOFF_DEBUG
1068
1069options 	I4B_SMP_WORKAROUND
1070options 	I586_PMC_GUPROF=0x70000
1071options 	KBDIO_DEBUG=2
1072options 	KBD_MAXRETRY=4
1073options 	KBD_MAXWAIT=6
1074options 	KBD_RESETDELAY=201
1075
1076options 	PSM_DEBUG=1
1077
1078options 	TIMER_FREQ=((14318182+6)/12)
1079
1080options 	VM_KMEM_SIZE
1081options 	VM_KMEM_SIZE_MAX
1082options 	VM_KMEM_SIZE_SCALE
1083
1084
1085# The I/O device
1086device		io
1087
1088# asr old ioctls support, needed by raidutils
1089
1090options		ASR_COMPAT
1091