xref: /freebsd/sys/i386/conf/NOTES (revision 10ff414c)
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# Enable the kernel DTrace hooks which are required to load the DTrace
12# kernel modules.
13#
14options 	KDTRACE_HOOKS
15
16# DTrace core
17# NOTE: introduces CDDL-licensed components into the kernel
18#device		dtrace
19
20# DTrace modules
21#device		dtrace_profile
22#device		dtrace_sdt
23#device		dtrace_fbt
24#device		dtrace_systrace
25#device		dtrace_prototype
26#device		dtnfscl
27#device		dtmalloc
28
29# Alternatively include all the DTrace modules
30#device		dtraceall
31
32
33#####################################################################
34# SMP OPTIONS:
35#
36# The apic device enables the use of the I/O APIC for interrupt delivery.
37# The apic device can be used in both UP and SMP kernels, but is required
38# for SMP kernels.  Thus, the apic device is not strictly an SMP option,
39# but it is a prerequisite for SMP.
40#
41# Notes:
42#
43# HTT CPUs should only be used if they are enabled in the BIOS.  For
44# the ACPI case, ACPI only correctly tells us about any HTT CPUs if
45# they are enabled.  However, most HTT systems do not list HTT CPUs
46# in the MP Table if they are enabled, thus we guess at the HTT CPUs
47# for the MP Table case.  However, we shouldn't try to guess and use
48# these CPUs if HTT is disabled.  Thus, HTT guessing is only enabled
49# for the MP Table if the user explicitly asks for it via the
50# MPTABLE_FORCE_HTT option.  Do NOT use this option if you have HTT
51# disabled in your BIOS.
52#
53# IPI_PREEMPTION instructs the kernel to preempt threads running on other
54# CPUS if needed.  Relies on the PREEMPTION option
55
56# Mandatory:
57device		apic			# I/O apic
58
59# Optional:
60options 	MPTABLE_FORCE_HTT	# Enable HTT CPUs with the MP Table
61options 	IPI_PREEMPTION
62
63#
64# Watchdog routines.
65#
66options 	MP_WATCHDOG
67
68# Debugging options.
69#
70options 	COUNT_XINVLTLB_HITS	# Counters for TLB events
71options 	COUNT_IPIS		# Per-CPU IPI interrupt counters
72
73
74
75#####################################################################
76# CPU OPTIONS
77
78#
79# You must specify at least one CPU (the one you intend to run on);
80# deleting the specification for CPUs you don't need to use may make
81# parts of the system run faster.
82#
83cpu		I486_CPU
84cpu		I586_CPU		# aka Pentium(tm)
85cpu		I686_CPU		# aka Pentium Pro(tm)
86
87#
88# Options for CPU features.
89#
90# CPU_ATHLON_SSE_HACK tries to enable SSE instructions when the BIOS has
91# forgotten to enable them.
92#
93# CPU_BLUELIGHTNING_3X enables triple-clock mode on IBM Blue Lightning
94# CPU if CPU supports it.  The default is double-clock mode on
95# BlueLightning CPU box.
96#
97# CPU_BLUELIGHTNING_FPU_OP_CACHE enables FPU operand cache on IBM
98# BlueLightning CPU.  It works only with Cyrix FPU, and this option
99# should not be used with Intel FPU.
100#
101# CPU_BTB_EN enables branch target buffer on Cyrix 5x86 (NOTE 1).
102#
103# CPU_CYRIX_NO_LOCK enables weak locking for the entire address space
104# of Cyrix 6x86 and 6x86MX CPUs by setting the NO_LOCK bit of CCR1.
105# Otherwise, the NO_LOCK bit of CCR1 is cleared.  (NOTE 3)
106#
107# CPU_DIRECT_MAPPED_CACHE sets L1 cache of Cyrix 486DLC CPU in direct
108# mapped mode.  Default is 2-way set associative mode.
109#
110# CPU_DISABLE_5X86_LSSER disables load store serialize (i.e., enables
111# reorder).  This option should not be used if you use memory mapped
112# I/O device(s).
113#
114# CPU_ELAN enables support for AMDs ElanSC520 CPU.
115#    CPU_ELAN_PPS enables precision timestamp code.
116#    CPU_ELAN_XTAL sets the clock crystal frequency in Hz.
117#
118# CPU_ENABLE_LONGRUN enables support for Transmeta Crusoe LongRun
119# technology which allows to restrict power consumption of the CPU by
120# using group of hw.crusoe.* sysctls.
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 specifies 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_ELAN
192options 	CPU_ELAN_PPS
193options 	CPU_ELAN_XTAL=32768000
194options 	CPU_ENABLE_LONGRUN
195options 	CPU_FASTER_5X86_FPU
196options 	CPU_GEODE
197options 	CPU_I486_ON_386
198options 	CPU_IORT
199options 	CPU_L2_LATENCY=5
200options 	CPU_LOOP_EN
201options 	CPU_PPRO2CELERON
202options 	CPU_RSTK_EN
203options 	CPU_SOEKRIS
204options 	CPU_SUSP_HLT
205options 	CPU_UPGRADE_HW_CACHE
206options 	CPU_WT_ALLOC
207options 	CYRIX_CACHE_WORKS
208options 	CYRIX_CACHE_REALLY_WORKS
209#options 	NO_F00F_HACK
210
211# Debug options
212options 	NPX_DEBUG	# enable npx debugging
213
214#
215# PERFMON causes the driver for Pentium/Pentium Pro performance counters
216# to be compiled.  See perfmon(4) for more information.
217#
218options 	PERFMON
219
220
221#####################################################################
222# NETWORKING OPTIONS
223
224#
225# DEVICE_POLLING adds support for mixed interrupt-polling handling
226# of network device drivers, which has significant benefits in terms
227# of robustness to overloads and responsivity, as well as permitting
228# accurate scheduling of the CPU time between kernel network processing
229# and other activities.  The drawback is a moderate (up to 1/HZ seconds)
230# potential increase in response times.
231# It is strongly recommended to use HZ=1000 or 2000 with DEVICE_POLLING
232# to achieve smoother behaviour.
233# Additionally, you can enable/disable polling at runtime with help of
234# the ifconfig(8) utility, and select the CPU fraction reserved to
235# userland with the sysctl variable kern.polling.user_frac
236# (default 50, range 0..100).
237#
238# Not all device drivers support this mode of operation at the time of
239# this writing.  See polling(4) for more details.
240
241options 	DEVICE_POLLING
242
243# BPF_JITTER adds support for BPF just-in-time compiler.
244
245options 	BPF_JITTER
246
247# OpenFabrics Enterprise Distribution (Infiniband).
248options 	OFED
249options 	OFED_DEBUG_INIT
250
251# Sockets Direct Protocol
252options 	SDP
253options 	SDP_DEBUG
254
255# IP over Infiniband
256options 	IPOIB
257options 	IPOIB_DEBUG
258options 	IPOIB_CM
259
260
261#####################################################################
262# CLOCK OPTIONS
263
264# Provide read/write access to the memory in the clock chip.
265device		nvram		# Access to rtc cmos via /dev/nvram
266
267
268#####################################################################
269# MISCELLANEOUS DEVICES AND OPTIONS
270
271device		speaker		#Play IBM BASIC-style noises out your speaker
272envvar		hint.speaker.0.at="isa"
273envvar		hint.speaker.0.port="0x61"
274
275
276#####################################################################
277# HARDWARE BUS CONFIGURATION
278
279#
280# ISA bus
281#
282device		isa
283
284#
285# Options for `isa':
286#
287# AUTO_EOI_1 enables the `automatic EOI' feature for the master 8259A
288# interrupt controller.  This saves about 0.7-1.25 usec for each interrupt.
289# This option breaks suspend/resume on some portables.
290#
291# AUTO_EOI_2 enables the `automatic EOI' feature for the slave 8259A
292# interrupt controller.  This saves about 0.7-1.25 usec for each interrupt.
293# Automatic EOI is documented not to work for for the slave with the
294# original i8259A, but it works for some clones and some integrated
295# versions.
296#
297# MAXMEM specifies the amount of RAM on the machine; if this is not
298# specified, FreeBSD will first read the amount of memory from the CMOS
299# RAM, so the amount of memory will initially be limited to 64MB or 16MB
300# depending on the BIOS.  If the BIOS reports 64MB, a memory probe will
301# then attempt to detect the installed amount of RAM.  If this probe
302# fails to detect >64MB RAM you will have to use the MAXMEM option.
303# The amount is in kilobytes, so for a machine with 128MB of RAM, it would
304# be 131072 (128 * 1024).
305#
306# BROKEN_KEYBOARD_RESET disables the use of the keyboard controller to
307# reset the CPU for reboot.  This is needed on some systems with broken
308# keyboard controllers.
309
310options 	AUTO_EOI_1
311#options 	AUTO_EOI_2
312
313options 	MAXMEM=(128*1024)
314#options 	BROKEN_KEYBOARD_RESET
315
316#
317# AGP GART support
318device		agp
319
320# AGP debugging.
321options 	AGP_DEBUG
322
323
324#####################################################################
325# HARDWARE DEVICE CONFIGURATION
326
327# To include support for VGA VESA video modes
328options 	VESA
329
330# Turn on extra debugging checks and output for VESA support.
331options 	VESA_DEBUG
332
333device		dpms		# DPMS suspend & resume via VESA BIOS
334
335# x86 real mode BIOS emulator, required by atkbdc/dpms/vesa
336options 	X86BIOS
337
338#
339# Hints for the non-optional Numeric Processing eXtension driver.
340envvar		hint.npx.0.flags="0x0"
341envvar		hint.npx.0.irq="13"
342
343#
344# `flags' for npx0:
345#	0x01	don't use the npx registers to optimize bcopy.
346#	0x02	don't use the npx registers to optimize bzero.
347#	0x04	don't use the npx registers to optimize copyin or copyout.
348# The npx registers are normally used to optimize copying and zeroing when
349# all of the following conditions are satisfied:
350#	I586_CPU is an option
351#	the cpu is an i586 (perhaps not a Pentium)
352#	the probe for npx0 succeeds
353#	INT 16 exception handling works.
354# Then copying and zeroing using the npx registers is normally 30-100% faster.
355# The flags can be used to control cases where it doesn't work or is slower.
356# Setting them at boot time using hints works right (the optimizations
357# are not used until later in the bootstrap when npx0 is attached).
358# Flag 0x08 automatically disables the i586 optimized routines.
359#
360
361#
362# Optional devices:
363#
364
365# PS/2 mouse
366device		psm
367envvar		hint.psm.0.at="atkbdc"
368envvar		hint.psm.0.irq="12"
369
370# Options for psm:
371options 	PSM_HOOKRESUME		#hook the system resume event, useful
372					#for some laptops
373options 	PSM_RESETAFTERSUSPEND	#reset the device at the resume event
374
375# The keyboard controller; it controls the keyboard and the PS/2 mouse.
376device		atkbdc
377envvar		hint.atkbdc.0.at="isa"
378envvar		hint.atkbdc.0.port="0x060"
379
380# The AT keyboard
381device		atkbd
382envvar		hint.atkbd.0.at="atkbdc"
383envvar		hint.atkbd.0.irq="1"
384
385# Options for atkbd:
386options 	ATKBD_DFLT_KEYMAP	# specify the built-in keymap
387makeoptions	ATKBD_DFLT_KEYMAP=fr.dvorak
388
389# `flags' for atkbd:
390#       0x01    Force detection of keyboard, else we always assume a keyboard
391#       0x02    Don't reset keyboard, useful for some newer ThinkPads
392#	0x03	Force detection and avoid reset, might help with certain
393#		dockingstations
394#       0x04    Old-style (XT) keyboard support, useful for older ThinkPads
395
396# Video card driver for VGA adapters.
397device		vga
398envvar		hint.vga.0.at="isa"
399
400# Options for vga:
401# Try the following option if the mouse pointer is not drawn correctly
402# or font does not seem to be loaded properly.  May cause flicker on
403# some systems.
404options 	VGA_ALT_SEQACCESS
405
406# If you can dispense with some vga driver features, you may want to
407# use the following options to save some memory.
408#options 	VGA_NO_FONT_LOADING	# don't save/load font
409#options 	VGA_NO_MODE_CHANGE	# don't change video modes
410
411# Older video cards may require this option for proper operation.
412options 	VGA_SLOW_IOACCESS	# do byte-wide i/o's to TS and GDC regs
413
414# The following option probably won't work with the LCD displays.
415options 	VGA_WIDTH90		# support 90 column modes
416
417# Debugging.
418options 	VGA_DEBUG
419
420# vt(4) drivers.
421device		vt_vga
422device		vt_vbefb
423
424# Linear framebuffer driver for S3 VESA 1.2 cards. Works on top of VESA.
425device		s3pci
426
427# 3Dfx Voodoo Graphics, Voodoo II /dev/3dfx CDEV support.  This will create
428# the /dev/3dfx0 device to work with glide implementations.  This should get
429# linked to /dev/3dfx and /dev/voodoo.  Note that this is not the same as
430# the tdfx DRI module from XFree86 and is completely unrelated.
431#
432# To enable Linuxulator support, one must also load linux.ko and tdfx_linux.ko.
433
434device		tdfx			# Enable 3Dfx Voodoo support
435
436options 	IOMMU			# Enable IOMMU support
437
438#
439# ACPI support using the Intel ACPI Component Architecture reference
440# implementation.
441#
442# ACPI_DEBUG enables the use of the debug.acpi.level and debug.acpi.layer
443# kernel environment variables to select initial debugging levels for the
444# Intel ACPICA code.  (Note that the Intel code must also have USE_DEBUGGER
445# defined when it is built).
446
447device		acpi
448options 	ACPI_DEBUG
449
450# ACPI WMI Mapping driver
451device		acpi_wmi
452
453# ACPI Asus Extras (LCD backlight/brightness, video output, etc.)
454device		acpi_asus
455
456# ACPI Fujitsu Extras (Buttons)
457device		acpi_fujitsu
458
459# ACPI extras driver for HP laptops
460device		acpi_hp
461
462# ACPI extras driver for IBM laptops
463device		acpi_ibm
464
465# ACPI Panasonic Extras (LCD backlight/brightness, video output, etc.)
466device		acpi_panasonic
467
468# ACPI Sony extra (LCD brightness)
469device		acpi_sony
470
471# ACPI Toshiba Extras (LCD backlight/brightness, video output, etc.)
472device		acpi_toshiba
473
474# ACPI Video Extensions (LCD backlight/brightness, video output, etc.)
475device		acpi_video
476
477# ACPI Docking Station
478device		acpi_dock
479
480# ACPI ASOC ATK0110 ASUSTeK AI Booster (voltage, temperature and fan sensors)
481device		aibs
482
483# The cpufreq(4) driver provides support for non-ACPI CPU frequency control
484device		cpufreq
485
486#
487# Network interfaces:
488#
489
490# bxe:  Broadcom NetXtreme II (BCM5771X/BCM578XX) PCIe 10Gb Ethernet
491#       adapters.
492# ce:   Cronyx Tau-PCI/32 sync single/dual port G.703/E1 serial adaptor
493#       with 32 HDLC subchannels (requires sppp (default), or NETGRAPH if
494#       NETGRAPH_CRONYX is configured)
495# cp:   Cronyx Tau-PCI sync single/dual/four port
496#       V.35/RS-232/RS-530/RS-449/X.21/G.703/E1/E3/T3/STS-1
497#       serial adaptor (requires sppp (default), or NETGRAPH if
498#       NETGRAPH_CRONYX is configured)
499# igc:	Intel I225 2.5G Ethernet adapter
500# ipw:	Intel PRO/Wireless 2100 IEEE 802.11 adapter
501# iwi:	Intel PRO/Wireless 2200BG/2225BG/2915ABG IEEE 802.11 adapters
502#	Requires the iwi firmware module
503# iwn:	Intel Wireless WiFi Link 1000/105/135/2000/4965/5000/6000/6050 abgn
504#	802.11 network adapters
505#	Requires the iwn firmware module
506# mthca: Mellanox HCA InfiniBand
507# mlx4ib: Mellanox ConnectX HCA InfiniBand
508# mlx4en: Mellanox ConnectX HCA Ethernet
509# nfe:	nVidia nForce MCP on-board Ethernet Networking (BSD open source)
510# sbni: Granch SBNI12-xx ISA and PCI adapters
511# vmx:	VMware VMXNET3 Ethernet (BSD open source)
512# wpi:	Intel 3945ABG Wireless LAN controller
513#	Requires the wpi firmware module
514
515# Order for ISA/EISA devices is important here
516
517device          bxe             # Broadcom NetXtreme II BCM5771X/BCM578XX 10GbE
518device		ce
519device		cp
520envvar		hint.cs.0.at="isa"
521envvar		hint.cs.0.port="0x300"
522#options 	NETGRAPH_CRONYX		# Enable NETGRAPH support for Cronyx adapter(s)
523options 	ED_3C503
524options 	ED_HPP
525options 	ED_SIC
526envvar		hint.ed.0.at="isa"
527envvar		hint.ed.0.port="0x280"
528envvar		hint.ed.0.irq="5"
529envvar		hint.ed.0.maddr="0xd8000"
530device		igc		# Intel I225 2.5G Ethernet
531device		ipw		# Intel 2100 wireless NICs.
532device		iwi		# Intel 2200BG/2225BG/2915ABG wireless NICs.
533device		iwn		# Intel 4965/1000/5000/6000 wireless NICs.
534# Hint for the i386-only ISA front-end of le(4).
535envvar		hint.le.0.at="isa"
536envvar		hint.le.0.port="0x280"
537envvar		hint.le.0.irq="10"
538envvar		hint.le.0.drq="0"
539device  	mthca		# Mellanox HCA InfiniBand
540device		mlx4		# Shared code module between IB and Ethernet
541device  	mlx4ib		# Mellanox ConnectX HCA InfiniBand
542device  	mlx4en		# Mellanox ConnectX HCA Ethernet
543device		nfe		# nVidia nForce MCP on-board Ethernet
544device		sbni
545envvar		hint.sbni.0.at="isa"
546envvar		hint.sbni.0.port="0x210"
547envvar		hint.sbni.0.irq="0xefdead"
548envvar		hint.sbni.0.flags="0"
549device		vmx		# VMware VMXNET3 Ethernet
550device		wpi		# Intel 3945ABG wireless NICs.
551
552# IEEE 802.11 adapter firmware modules
553
554# Intel PRO/Wireless 2100 firmware:
555#   ipwfw:		BSS/IBSS/monitor mode firmware
556#   ipwbssfw:		BSS mode firmware
557#   ipwibssfw:		IBSS mode firmware
558#   ipwmonitorfw:	Monitor mode firmware
559# Intel PRO/Wireless 2200BG/2225BG/2915ABG firmware:
560#   iwifw:		BSS/IBSS/monitor mode firmware
561#   iwibssfw:		BSS mode firmware
562#   iwiibssfw:		IBSS mode firmware
563#   iwimonitorfw:	Monitor mode firmware
564# Intel Wireless WiFi Link 4965/1000/5000/6000 series firmware:
565#   iwnfw:		Single module to support all devices
566#   iwn1000fw:		Specific module for the 1000 only
567#   iwn105fw:		Specific module for the 105 only
568#   iwn135fw:		Specific module for the 135 only
569#   iwn2000fw:		Specific module for the 2000 only
570#   iwn2030fw:		Specific module for the 2030 only
571#   iwn4965fw:		Specific module for the 4965 only
572#   iwn5000fw:		Specific module for the 5000 only
573#   iwn5150fw:		Specific module for the 5150 only
574#   iwn6000fw:		Specific module for the 6000 only
575#   iwn6000g2afw:	Specific module for the 6000g2a only
576#   iwn6000g2bfw:	Specific module for the 6000g2b only
577#   iwn6050fw:		Specific module for the 6050 only
578# wpifw:	Intel 3945ABG Wireless LAN Controller firmware
579
580device		iwifw
581device		iwibssfw
582device		iwiibssfw
583device		iwimonitorfw
584device		ipwfw
585device		ipwbssfw
586device		ipwibssfw
587device		ipwmonitorfw
588device		iwnfw
589device		iwn1000fw
590device		iwn105fw
591device		iwn135fw
592device		iwn2000fw
593device		iwn2030fw
594device		iwn4965fw
595device		iwn5000fw
596device		iwn5150fw
597device		iwn6000fw
598device		iwn6000g2afw
599device		iwn6000g2bfw
600device		iwn6050fw
601device		wpifw
602
603#
604# Non-Transparent Bridge (NTB) drivers
605#
606device		if_ntb		# Virtual NTB network interface
607device		ntb_transport	# NTB packet transport driver
608device		ntb		# NTB hardware interface
609device		ntb_hw_amd	# AMD NTB hardware driver
610device		ntb_hw_intel	# Intel NTB hardware driver
611device		ntb_hw_plx	# PLX NTB hardware driver
612
613#
614# ATA raid adapters
615#
616device		pst
617
618#
619# Areca 11xx and 12xx series of SATA II RAID controllers.
620# CAM is required.
621#
622device		arcmsr		# Areca SATA II RAID
623
624#
625# 3ware 9000 series PATA/SATA RAID controller driver and options.
626# The driver is implemented as a SIM, and so, needs the CAM infrastructure.
627#
628options 	TWA_DEBUG		# 0-10; 10 prints the most messages.
629device		twa			# 3ware 9000 series PATA/SATA RAID
630
631#
632# Adaptec FSA RAID controllers, including integrated DELL controllers,
633# the Dell PERC 2/QC and the HP NetRAID-4M
634device		aac
635device		aacp	# SCSI Passthrough interface (optional, CAM required)
636
637#
638# Adaptec by PMC RAID controllers, Series 6/7/8 and upcoming families
639device		aacraid		# Container interface, CAM required
640
641#
642# Highpoint RocketRAID 27xx.
643device		hpt27xx
644
645#
646# Highpoint RocketRAID 182x.
647device		hptmv
648
649#
650# Highpoint DC7280 and R750.
651device		hptnr
652
653#
654# Highpoint RocketRAID.  Supports RR172x, RR222x, RR2240, RR232x, RR2340,
655# RR2210, RR174x, RR2522, RR231x, RR230x.
656device		hptrr
657
658#
659# Highpoint RocketRaid 3xxx series SATA RAID
660device		hptiop
661
662#
663# Intel integrated Memory Controller (iMC) SMBus controller
664#	Sandybridge-Xeon, Ivybridge-Xeon, Haswell-Xeon, Broadwell-Xeon
665device		imcsmb
666
667#
668# IBM (now Adaptec) ServeRAID controllers
669device		ips
670
671#
672# Intel C600 (Patsburg) integrated SAS controller
673device		isci
674options 	ISCI_LOGGING	# enable debugging in isci HAL
675
676#
677# NVM Express (NVMe) support
678device         nvme    # base NVMe driver
679device         nvd     # expose NVMe namespaces as disks, depends on nvme
680
681#
682# Intel Volume Management Device (VMD) support
683device		vmd
684
685#
686# PMC-Sierra SAS/SATA controller
687device		pmspcv
688#
689# SafeNet crypto driver: can be moved to the MI NOTES as soon as
690# it's tested on a big-endian machine
691#
692device		safe		# SafeNet 1141
693options 	SAFE_DEBUG	# enable debugging support: hw.safe.debug
694options 	SAFE_RNDTEST	# enable rndtest support
695
696#
697# glxiic is an I2C driver for the AMD Geode LX CS5536 System Management Bus
698# controller.  Requires 'device iicbus'.
699#
700device		glxiic		# AMD Geode LX CS5536 System Management Bus
701
702#
703# glxsb is a driver for the Security Block in AMD Geode LX processors.
704# Requires 'device crypto'.
705#
706device		glxsb		# AMD Geode LX Security Block
707
708#
709# VirtIO support
710#
711# The virtio entry provides a generic bus for use by the device drivers.
712# It must be combined with an interface that communicates with the host.
713# Multiple such interfaces defined by the VirtIO specification. FreeBSD
714# only has support for PCI. Therefore, virtio_pci must be statically
715# compiled in or loaded as a module for the device drivers to function.
716#
717device		virtio		# Generic VirtIO bus (required)
718device		virtio_pci	# VirtIO PCI Interface
719device		vtnet		# VirtIO Ethernet device
720device		virtio_blk	# VirtIO Block device
721device		virtio_scsi	# VirtIO SCSI device
722device		virtio_balloon	# VirtIO Memory Balloon device
723device		virtio_random	# VirtIO Entropy device
724device		virtio_console	# VirtIO Console device
725
726# Linux KVM paravirtualization support
727device 		kvm_clock	# KVM paravirtual clock driver
728
729options 	HYPERV
730device		hyperv		# HyperV drivers
731
732#####################################################################
733
734#
735# Miscellaneous hardware:
736#
737# ipmi: Intelligent Platform Management Interface
738# smapi: System Management Application Program Interface driver
739# smbios: DMI/SMBIOS entry point
740# vpd: Vital Product Data kernel interface
741# pbio: Parallel (8255 PPI) basic I/O (mode 0) port (e.g. Advantech PCL-724)
742# asmc: Apple System Management Controller
743# si: Specialix International SI/XIO or SX intelligent serial card driver
744# tpm: Trusted Platform Module
745
746# Notes on the Specialix SI/XIO driver:
747#  The host card is memory, not IO mapped.
748#  The Rev 1 host cards use a 64K chunk, on a 32K boundary.
749#  The Rev 2 host cards use a 32K chunk, on a 32K boundary.
750#  The cards can use an IRQ of 11, 12 or 15.
751
752# Notes on the Sony Programmable I/O controller
753#  This is a temporary driver that should someday be replaced by something
754#  that hooks into the ACPI layer.  The device is hooked to the PIIX4's
755#  General Device 10 decoder, which means you have to fiddle with PCI
756#  registers to map it in, even though it is otherwise treated here as
757#  an ISA device.  At the moment, the driver polls, although the device
758#  is capable of generating interrupts.  It largely undocumented.
759#  The port location in the hint is where you WANT the device to be
760#  mapped.  0x10a0 seems to be traditional.  At the moment the jogdial
761#  is the only thing truly supported, but apparently a fair percentage
762#  of the Vaio extra features are controlled by this device.
763
764device		ipmi
765device		smapi
766device		smbios
767device		vpd
768device		pbio
769envvar		hint.pbio.0.at="isa"
770envvar		hint.pbio.0.port="0x360"
771device		asmc
772device		tpm
773device		padlock_rng	# VIA Padlock RNG
774device		rdrand_rng	# Intel Bull Mountain RNG
775device		aesni		# AES-NI OpenCrypto module
776device		ossl		# OpenSSL OpenCrypto module
777
778#
779# Laptop/Notebook options:
780#
781# See also:
782#  apm under `Miscellaneous hardware'
783# above.
784
785device		backlight
786
787# For older notebooks that signal a powerfail condition (external
788# power supply dropped, or battery state low) by issuing an NMI:
789
790options 	POWERFAIL_NMI	# make it beep instead of panicing
791
792#
793# I2C Bus
794#
795# Philips i2c bus support is provided by the `iicbus' device.
796#
797# Supported interfaces:
798# pcf	Philips PCF8584 ISA-bus controller
799#
800device		pcf
801envvar		hint.pcf.0.at="isa"
802envvar		hint.pcf.0.port="0x320"
803envvar		hint.pcf.0.irq="5"
804
805#
806# Hardware watchdog timers:
807#
808# ichwd: Intel ICH watchdog timer
809# amdsbwd: AMD SB7xx watchdog timer
810# viawd: VIA south bridge watchdog timer
811# wbwd: Winbond watchdog timer
812# itwd: ITE Super I/O watchdog timer
813#
814device		ichwd
815device		amdsbwd
816device		viawd
817device		wbwd
818device		itwd
819
820#
821# Temperature sensors:
822#
823# coretemp: on-die sensor on Intel Core and newer CPUs
824# amdtemp: on-die sensor on AMD K8/K10/K11 CPUs
825#
826device		coretemp
827device		amdtemp
828
829#
830# CPU control pseudo-device. Provides access to MSRs, CPUID info and
831# microcode update feature.
832#
833device		cpuctl
834
835#
836# SuperIO driver.
837#
838device		superio
839
840#
841# System Management Bus (SMB)
842#
843options 	ENABLE_ALART		# Control alarm on Intel intpm driver
844
845#
846# Set the number of PV entries per process.  Increasing this can
847# stop panics related to heavy use of shared memory.  However, that can
848# (combined with large amounts of physical memory) cause panics at
849# boot time due the kernel running out of VM space.
850#
851# If you're tweaking this, you might also want to increase the sysctls
852# "vm.v_free_min", "vm.v_free_reserved", and "vm.v_free_target".
853#
854# The value below is the one more than the default.
855#
856options 	PMAP_SHPGPERPROC=201
857
858#
859# Number of initial kernel page table pages used for early bootstrap.
860# This number should include enough pages to map the kernel, any
861# modules or other data loaded with the kernel by the loader, and data
862# structures allocated before the VM system is initialized such as the
863# vm_page_t array.  Each page table page maps 4MB (2MB with PAE).
864#
865options 	NKPT=31
866
867#
868# HID-over-I2C support
869#
870device		iichid		# HID-over-I2C support
871options 	IICHID_DEBUG	# Enable HID-over-I2C debug messages
872options 	IICHID_SAMPLING	# Workaround missing GPIO INTR support
873
874#####################################################################
875# ABI Emulation
876
877# Enable (32-bit) a.out binary support
878options 	COMPAT_AOUT
879
880#####################################################################
881# VM OPTIONS
882
883# KSTACK_PAGES is the number of memory pages to assign to the kernel
884# stack of each thread.
885
886options 	KSTACK_PAGES=5
887
888# Enable detailed accounting by the PV entry allocator.
889
890options 	PV_STATS
891
892#####################################################################
893
894# More undocumented options for linting.
895# Note that documenting these are not considered an affront.
896
897options 	FB_INSTALL_CDEV		# install a CDEV entry in /dev
898
899options 	KBDIO_DEBUG=2
900options 	KBD_MAXRETRY=4
901options 	KBD_MAXWAIT=6
902options 	KBD_RESETDELAY=201
903
904options 	PSM_DEBUG=1
905
906options 	TIMER_FREQ=((14318182+6)/12)
907
908options 	VM_KMEM_SIZE
909options 	VM_KMEM_SIZE_MAX
910options 	VM_KMEM_SIZE_SCALE
911
912
913