xref: /freebsd/sys/i386/conf/NOTES (revision 6aae3517ed2500fb963ba0a4264b4756088dd0f4)
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 NETGRAPH
494# igc:	Intel I225 2.5G Ethernet adapter
495# ipw:	Intel PRO/Wireless 2100 IEEE 802.11 adapter
496# iwi:	Intel PRO/Wireless 2200BG/2225BG/2915ABG IEEE 802.11 adapters
497#	Requires the iwi firmware module
498# iwn:	Intel Wireless WiFi Link 1000/105/135/2000/4965/5000/6000/6050 abgn
499#	802.11 network adapters
500#	Requires the iwn firmware module
501# mthca: Mellanox HCA InfiniBand
502# mlx4ib: Mellanox ConnectX HCA InfiniBand
503# mlx4en: Mellanox ConnectX HCA Ethernet
504# nfe:	nVidia nForce MCP on-board Ethernet Networking (BSD open source)
505# sbni: Granch SBNI12-xx ISA and PCI adapters
506# vmx:	VMware VMXNET3 Ethernet (BSD open source)
507# wpi:	Intel 3945ABG Wireless LAN controller
508#	Requires the wpi firmware module
509
510# Order for ISA/EISA devices is important here
511
512device          bxe             # Broadcom NetXtreme II BCM5771X/BCM578XX 10GbE
513device		ce
514envvar		hint.cs.0.at="isa"
515envvar		hint.cs.0.port="0x300"
516options 	ED_3C503
517options 	ED_HPP
518options 	ED_SIC
519envvar		hint.ed.0.at="isa"
520envvar		hint.ed.0.port="0x280"
521envvar		hint.ed.0.irq="5"
522envvar		hint.ed.0.maddr="0xd8000"
523device		igc		# Intel I225 2.5G Ethernet
524device		ipw		# Intel 2100 wireless NICs.
525device		iwi		# Intel 2200BG/2225BG/2915ABG wireless NICs.
526device		iwn		# Intel 4965/1000/5000/6000 wireless NICs.
527# Hint for the i386-only ISA front-end of le(4).
528envvar		hint.le.0.at="isa"
529envvar		hint.le.0.port="0x280"
530envvar		hint.le.0.irq="10"
531envvar		hint.le.0.drq="0"
532device  	mthca		# Mellanox HCA InfiniBand
533device		mlx4		# Shared code module between IB and Ethernet
534device  	mlx4ib		# Mellanox ConnectX HCA InfiniBand
535device  	mlx4en		# Mellanox ConnectX HCA Ethernet
536device		nfe		# nVidia nForce MCP on-board Ethernet
537device		sbni
538envvar		hint.sbni.0.at="isa"
539envvar		hint.sbni.0.port="0x210"
540envvar		hint.sbni.0.irq="0xefdead"
541envvar		hint.sbni.0.flags="0"
542device		vmx		# VMware VMXNET3 Ethernet
543device		wpi		# Intel 3945ABG wireless NICs.
544
545# IEEE 802.11 adapter firmware modules
546
547# Intel PRO/Wireless 2100 firmware:
548#   ipwfw:		BSS/IBSS/monitor mode firmware
549#   ipwbssfw:		BSS mode firmware
550#   ipwibssfw:		IBSS mode firmware
551#   ipwmonitorfw:	Monitor mode firmware
552# Intel PRO/Wireless 2200BG/2225BG/2915ABG firmware:
553#   iwifw:		BSS/IBSS/monitor mode firmware
554#   iwibssfw:		BSS mode firmware
555#   iwiibssfw:		IBSS mode firmware
556#   iwimonitorfw:	Monitor mode firmware
557# Intel Wireless WiFi Link 4965/1000/5000/6000 series firmware:
558#   iwnfw:		Single module to support all devices
559#   iwn1000fw:		Specific module for the 1000 only
560#   iwn105fw:		Specific module for the 105 only
561#   iwn135fw:		Specific module for the 135 only
562#   iwn2000fw:		Specific module for the 2000 only
563#   iwn2030fw:		Specific module for the 2030 only
564#   iwn4965fw:		Specific module for the 4965 only
565#   iwn5000fw:		Specific module for the 5000 only
566#   iwn5150fw:		Specific module for the 5150 only
567#   iwn6000fw:		Specific module for the 6000 only
568#   iwn6000g2afw:	Specific module for the 6000g2a only
569#   iwn6000g2bfw:	Specific module for the 6000g2b only
570#   iwn6050fw:		Specific module for the 6050 only
571# wpifw:	Intel 3945ABG Wireless LAN Controller firmware
572
573device		iwifw
574device		iwibssfw
575device		iwiibssfw
576device		iwimonitorfw
577device		ipwfw
578device		ipwbssfw
579device		ipwibssfw
580device		ipwmonitorfw
581device		iwnfw
582device		iwn1000fw
583device		iwn105fw
584device		iwn135fw
585device		iwn2000fw
586device		iwn2030fw
587device		iwn4965fw
588device		iwn5000fw
589device		iwn5150fw
590device		iwn6000fw
591device		iwn6000g2afw
592device		iwn6000g2bfw
593device		iwn6050fw
594device		wpifw
595
596#
597# Non-Transparent Bridge (NTB) drivers
598#
599device		if_ntb		# Virtual NTB network interface
600device		ntb_transport	# NTB packet transport driver
601device		ntb		# NTB hardware interface
602device		ntb_hw_amd	# AMD NTB hardware driver
603device		ntb_hw_intel	# Intel NTB hardware driver
604device		ntb_hw_plx	# PLX NTB hardware driver
605
606#
607# ATA raid adapters
608#
609device		pst
610
611#
612# Areca 11xx and 12xx series of SATA II RAID controllers.
613# CAM is required.
614#
615device		arcmsr		# Areca SATA II RAID
616
617#
618# 3ware 9000 series PATA/SATA RAID controller driver and options.
619# The driver is implemented as a SIM, and so, needs the CAM infrastructure.
620#
621options 	TWA_DEBUG		# 0-10; 10 prints the most messages.
622device		twa			# 3ware 9000 series PATA/SATA RAID
623
624#
625# Adaptec FSA RAID controllers, including integrated DELL controllers,
626# the Dell PERC 2/QC and the HP NetRAID-4M
627device		aac
628device		aacp	# SCSI Passthrough interface (optional, CAM required)
629
630#
631# Adaptec by PMC RAID controllers, Series 6/7/8 and upcoming families
632device		aacraid		# Container interface, CAM required
633
634#
635# Highpoint RocketRAID 27xx.
636device		hpt27xx
637
638#
639# Highpoint RocketRAID 182x.
640device		hptmv
641
642#
643# Highpoint DC7280 and R750.
644device		hptnr
645
646#
647# Highpoint RocketRAID.  Supports RR172x, RR222x, RR2240, RR232x, RR2340,
648# RR2210, RR174x, RR2522, RR231x, RR230x.
649device		hptrr
650
651#
652# Highpoint RocketRaid 3xxx series SATA RAID
653device		hptiop
654
655#
656# Intel integrated Memory Controller (iMC) SMBus controller
657#	Sandybridge-Xeon, Ivybridge-Xeon, Haswell-Xeon, Broadwell-Xeon
658device		imcsmb
659
660#
661# IBM (now Adaptec) ServeRAID controllers
662device		ips
663
664#
665# Intel C600 (Patsburg) integrated SAS controller
666device		isci
667options 	ISCI_LOGGING	# enable debugging in isci HAL
668
669#
670# NVM Express (NVMe) support
671device         nvme    # base NVMe driver
672device         nvd     # expose NVMe namespaces as disks, depends on nvme
673
674#
675# Intel Volume Management Device (VMD) support
676device		vmd
677
678#
679# PMC-Sierra SAS/SATA controller
680device		pmspcv
681#
682# SafeNet crypto driver: can be moved to the MI NOTES as soon as
683# it's tested on a big-endian machine
684#
685device		safe		# SafeNet 1141
686options 	SAFE_DEBUG	# enable debugging support: hw.safe.debug
687options 	SAFE_RNDTEST	# enable rndtest support
688
689#
690# glxiic is an I2C driver for the AMD Geode LX CS5536 System Management Bus
691# controller.  Requires 'device iicbus'.
692#
693device		glxiic		# AMD Geode LX CS5536 System Management Bus
694
695#
696# glxsb is a driver for the Security Block in AMD Geode LX processors.
697# Requires 'device crypto'.
698#
699device		glxsb		# AMD Geode LX Security Block
700
701#
702# VirtIO support
703#
704# The virtio entry provides a generic bus for use by the device drivers.
705# It must be combined with an interface that communicates with the host.
706# Multiple such interfaces defined by the VirtIO specification. FreeBSD
707# only has support for PCI. Therefore, virtio_pci must be statically
708# compiled in or loaded as a module for the device drivers to function.
709#
710device		virtio		# Generic VirtIO bus (required)
711device		virtio_pci	# VirtIO PCI Interface
712device		vtnet		# VirtIO Ethernet device
713device		virtio_blk	# VirtIO Block device
714device		virtio_scsi	# VirtIO SCSI device
715device		virtio_balloon	# VirtIO Memory Balloon device
716device		virtio_random	# VirtIO Entropy device
717device		virtio_console	# VirtIO Console device
718
719# Linux KVM paravirtualization support
720device 		kvm_clock	# KVM paravirtual clock driver
721
722options 	HYPERV
723device		hyperv		# HyperV drivers
724
725#####################################################################
726
727#
728# Miscellaneous hardware:
729#
730# ipmi: Intelligent Platform Management Interface
731# smapi: System Management Application Program Interface driver
732# smbios: DMI/SMBIOS entry point
733# vpd: Vital Product Data kernel interface
734# pbio: Parallel (8255 PPI) basic I/O (mode 0) port (e.g. Advantech PCL-724)
735# asmc: Apple System Management Controller
736# si: Specialix International SI/XIO or SX intelligent serial card driver
737# tpm: Trusted Platform Module
738
739# Notes on the Specialix SI/XIO driver:
740#  The host card is memory, not IO mapped.
741#  The Rev 1 host cards use a 64K chunk, on a 32K boundary.
742#  The Rev 2 host cards use a 32K chunk, on a 32K boundary.
743#  The cards can use an IRQ of 11, 12 or 15.
744
745# Notes on the Sony Programmable I/O controller
746#  This is a temporary driver that should someday be replaced by something
747#  that hooks into the ACPI layer.  The device is hooked to the PIIX4's
748#  General Device 10 decoder, which means you have to fiddle with PCI
749#  registers to map it in, even though it is otherwise treated here as
750#  an ISA device.  At the moment, the driver polls, although the device
751#  is capable of generating interrupts.  It largely undocumented.
752#  The port location in the hint is where you WANT the device to be
753#  mapped.  0x10a0 seems to be traditional.  At the moment the jogdial
754#  is the only thing truly supported, but apparently a fair percentage
755#  of the Vaio extra features are controlled by this device.
756
757device		ipmi
758device		smapi
759device		smbios
760device		vpd
761device		pbio
762envvar		hint.pbio.0.at="isa"
763envvar		hint.pbio.0.port="0x360"
764device		asmc
765device		tpm
766device		padlock_rng	# VIA Padlock RNG
767device		rdrand_rng	# Intel Bull Mountain RNG
768device		aesni		# AES-NI OpenCrypto module
769device		ossl		# OpenSSL OpenCrypto module
770
771#
772# Laptop/Notebook options:
773#
774# See also:
775#  apm under `Miscellaneous hardware'
776# above.
777
778device		backlight
779
780# For older notebooks that signal a powerfail condition (external
781# power supply dropped, or battery state low) by issuing an NMI:
782
783options 	POWERFAIL_NMI	# make it beep instead of panicing
784
785#
786# I2C Bus
787#
788# Philips i2c bus support is provided by the `iicbus' device.
789#
790# Supported interfaces:
791# pcf	Philips PCF8584 ISA-bus controller
792#
793device		pcf
794envvar		hint.pcf.0.at="isa"
795envvar		hint.pcf.0.port="0x320"
796envvar		hint.pcf.0.irq="5"
797
798#
799# Hardware watchdog timers:
800#
801# ichwd: Intel ICH watchdog timer
802# amdsbwd: AMD SB7xx watchdog timer
803# viawd: VIA south bridge watchdog timer
804# wbwd: Winbond watchdog timer
805# itwd: ITE Super I/O watchdog timer
806#
807device		ichwd
808device		amdsbwd
809device		viawd
810device		wbwd
811device		itwd
812
813#
814# Temperature sensors:
815#
816# coretemp: on-die sensor on Intel Core and newer CPUs
817# amdtemp: on-die sensor on AMD K8/K10/K11 CPUs
818#
819device		coretemp
820device		amdtemp
821
822#
823# CPU control pseudo-device. Provides access to MSRs, CPUID info and
824# microcode update feature.
825#
826device		cpuctl
827
828#
829# SuperIO driver.
830#
831device		superio
832
833#
834# System Management Bus (SMB)
835#
836options 	ENABLE_ALART		# Control alarm on Intel intpm driver
837
838#
839# Set the number of PV entries per process.  Increasing this can
840# stop panics related to heavy use of shared memory.  However, that can
841# (combined with large amounts of physical memory) cause panics at
842# boot time due the kernel running out of VM space.
843#
844# If you're tweaking this, you might also want to increase the sysctls
845# "vm.v_free_min", "vm.v_free_reserved", and "vm.v_free_target".
846#
847# The value below is the one more than the default.
848#
849options 	PMAP_SHPGPERPROC=201
850
851#
852# Number of initial kernel page table pages used for early bootstrap.
853# This number should include enough pages to map the kernel, any
854# modules or other data loaded with the kernel by the loader, and data
855# structures allocated before the VM system is initialized such as the
856# vm_page_t array.  Each page table page maps 4MB (2MB with PAE).
857#
858options 	NKPT=31
859
860#
861# HID-over-I2C support
862#
863device		iichid		# HID-over-I2C support
864options 	IICHID_DEBUG	# Enable HID-over-I2C debug messages
865options 	IICHID_SAMPLING	# Workaround missing GPIO INTR support
866
867#####################################################################
868# ABI Emulation
869
870# Enable (32-bit) a.out binary support
871options 	COMPAT_AOUT
872
873#####################################################################
874# VM OPTIONS
875
876# KSTACK_PAGES is the number of memory pages to assign to the kernel
877# stack of each thread.
878
879options 	KSTACK_PAGES=5
880
881# Enable detailed accounting by the PV entry allocator.
882
883options 	PV_STATS
884
885#####################################################################
886
887# More undocumented options for linting.
888# Note that documenting these are not considered an affront.
889
890options 	FB_INSTALL_CDEV		# install a CDEV entry in /dev
891
892options 	KBDIO_DEBUG=2
893options 	KBD_MAXRETRY=4
894options 	KBD_MAXWAIT=6
895options 	KBD_RESETDELAY=201
896
897options 	PSM_DEBUG=1
898
899options 	TIMER_FREQ=((14318182+6)/12)
900
901options 	VM_KMEM_SIZE
902options 	VM_KMEM_SIZE_MAX
903options 	VM_KMEM_SIZE_SCALE
904
905
906