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