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