xref: /freebsd/sys/i386/conf/NOTES (revision 86c9d9918f1db7cdd968b60f8902466887bcd9e9)
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# We want LINT to cover profiling as well.
12profile         2
13
14#
15# Enable the kernel DTrace hooks which are required to load the DTrace
16# kernel modules.
17#
18options 	KDTRACE_HOOKS
19
20# DTrace core
21# NOTE: introduces CDDL-licensed components into the kernel
22#device		dtrace
23
24# DTrace modules
25#device		dtrace_profile
26#device		dtrace_sdt
27#device		dtrace_fbt
28#device		dtrace_systrace
29#device		dtrace_prototype
30#device		dtnfscl
31#device		dtmalloc
32
33# Alternatively include all the DTrace modules
34#device		dtraceall
35
36
37#####################################################################
38# SMP OPTIONS:
39#
40# The apic device enables the use of the I/O APIC for interrupt delivery.
41# The apic device can be used in both UP and SMP kernels, but is required
42# for SMP kernels.  Thus, the apic device is not strictly an SMP option,
43# but it is a prerequisite for SMP.
44#
45# Notes:
46#
47# HTT CPUs should only be used if they are enabled in the BIOS.  For
48# the ACPI case, ACPI only correctly tells us about any HTT CPUs if
49# they are enabled.  However, most HTT systems do not list HTT CPUs
50# in the MP Table if they are enabled, thus we guess at the HTT CPUs
51# for the MP Table case.  However, we shouldn't try to guess and use
52# these CPUs if HTT is disabled.  Thus, HTT guessing is only enabled
53# for the MP Table if the user explicitly asks for it via the
54# MPTABLE_FORCE_HTT option.  Do NOT use this option if you have HTT
55# disabled in your BIOS.
56#
57# IPI_PREEMPTION instructs the kernel to preempt threads running on other
58# CPUS if needed.  Relies on the PREEMPTION option
59
60# Mandatory:
61device		apic			# I/O apic
62
63# Optional:
64options 	MPTABLE_FORCE_HTT	# Enable HTT CPUs with the MP Table
65options 	IPI_PREEMPTION
66
67#
68# Watchdog routines.
69#
70options 	MP_WATCHDOG
71
72# Debugging options.
73#
74options 	COUNT_XINVLTLB_HITS	# Counters for TLB events
75options 	COUNT_IPIS		# Per-CPU IPI interrupt counters
76
77
78
79#####################################################################
80# CPU OPTIONS
81
82#
83# You must specify at least one CPU (the one you intend to run on);
84# deleting the specification for CPUs you don't need to use may make
85# parts of the system run faster.
86#
87cpu		I486_CPU
88cpu		I586_CPU		# aka Pentium(tm)
89cpu		I686_CPU		# aka Pentium Pro(tm)
90
91#
92# Options for CPU features.
93#
94# CPU_ATHLON_SSE_HACK tries to enable SSE instructions when the BIOS has
95# forgotten to enable them.
96#
97# CPU_BLUELIGHTNING_3X enables triple-clock mode on IBM Blue Lightning
98# CPU if CPU supports it.  The default is double-clock mode on
99# BlueLightning CPU box.
100#
101# CPU_BLUELIGHTNING_FPU_OP_CACHE enables FPU operand cache on IBM
102# BlueLightning CPU.  It works only with Cyrix FPU, and this option
103# should not be used with Intel FPU.
104#
105# CPU_BTB_EN enables branch target buffer on Cyrix 5x86 (NOTE 1).
106#
107# CPU_CYRIX_NO_LOCK enables weak locking for the entire address space
108# of Cyrix 6x86 and 6x86MX CPUs by setting the NO_LOCK bit of CCR1.
109# Otherwise, the NO_LOCK bit of CCR1 is cleared.  (NOTE 3)
110#
111# CPU_DIRECT_MAPPED_CACHE sets L1 cache of Cyrix 486DLC CPU in direct
112# mapped mode.  Default is 2-way set associative mode.
113#
114# CPU_DISABLE_5X86_LSSER disables load store serialize (i.e., enables
115# reorder).  This option should not be used if you use memory mapped
116# I/O device(s).
117#
118# CPU_DISABLE_CMPXCHG disables the CMPXCHG instruction on > i386 IA32
119# machines.  VmWare 3.x seems to emulate this instruction poorly, causing
120# the guest OS to run very slowly.  This problem appears to be fixed in
121# VmWare 4.x, at least in version 4.5.2, so that enabling this option with
122# VmWare 4.x will result in locking operations to be 20-30 times slower.
123# Enabling this with an SMP kernel will cause the kernel to be unusable.
124#
125# CPU_DISABLE_SSE explicitly prevents I686_CPU from turning on SSE.
126#
127# CPU_ELAN enables support for AMDs ElanSC520 CPU.
128#    CPU_ELAN_PPS enables precision timestamp code.
129#    CPU_ELAN_XTAL sets the clock crystal frequency in Hz.
130#
131# CPU_ENABLE_LONGRUN enables support for Transmeta Crusoe LongRun
132# technology which allows to restrict power consumption of the CPU by
133# using group of hw.crusoe.* sysctls.
134#
135# CPU_FASTER_5X86_FPU enables faster FPU exception handler.
136#
137# CPU_GEODE is for the SC1100 Geode embedded processor.  This option
138# is necessary because the i8254 timecounter is toast.
139#
140# CPU_I486_ON_386 enables CPU cache on i486 based CPU upgrade products
141# for i386 machines.
142#
143# CPU_IORT defines I/O clock delay time (NOTE 1).  Default values of
144# I/O clock delay time on Cyrix 5x86 and 6x86 are 0 and 7,respectively
145# (no clock delay).
146#
147# CPU_L2_LATENCY specifies the L2 cache latency value.  This option is used
148# only when CPU_PPRO2CELERON is defined and Mendocino Celeron is detected.
149# The default value is 5.
150#
151# CPU_LOOP_EN prevents flushing the prefetch buffer if the destination
152# of a jump is already present in the prefetch buffer on Cyrix 5x86(NOTE
153# 1).
154#
155# CPU_PPRO2CELERON enables L2 cache of Mendocino Celeron CPUs.  This option
156# is useful when you use Socket 8 to Socket 370 converter, because most Pentium
157# Pro BIOSs do not enable L2 cache of Mendocino Celeron CPUs.
158#
159# CPU_RSTK_EN enables return stack on Cyrix 5x86 (NOTE 1).
160#
161# CPU_SOEKRIS enables support www.soekris.com hardware.
162#
163# CPU_SUSP_HLT enables suspend on HALT.  If this option is set, CPU
164# enters suspend mode following execution of HALT instruction.
165#
166# CPU_UPGRADE_HW_CACHE eliminates unneeded cache flush instruction(s).
167#
168# CPU_WT_ALLOC enables write allocation on Cyrix 6x86/6x86MX and AMD
169# K5/K6/K6-2 CPUs.
170#
171# CYRIX_CACHE_WORKS enables CPU cache on Cyrix 486 CPUs with cache
172# flush at hold state.
173#
174# CYRIX_CACHE_REALLY_WORKS enables (1) CPU cache on Cyrix 486 CPUs
175# without cache flush at hold state, and (2) write-back CPU cache on
176# Cyrix 6x86 whose revision < 2.7 (NOTE 2).
177#
178# NO_F00F_HACK disables the hack that prevents Pentiums (and ONLY
179# Pentiums) from locking up when a LOCK CMPXCHG8B instruction is
180# executed.  This option is only needed if I586_CPU is also defined,
181# and should be included for any non-Pentium CPU that defines it.
182#
183# NO_MEMORY_HOLE is an optimisation for systems with AMD K6 processors
184# which indicates that the 15-16MB range is *definitely* not being
185# occupied by an ISA memory hole.
186#
187# NOTE 1: The options, CPU_BTB_EN, CPU_LOOP_EN, CPU_IORT,
188# CPU_LOOP_EN and CPU_RSTK_EN should not be used because of CPU bugs.
189# These options may crash your system.
190#
191# NOTE 2: If CYRIX_CACHE_REALLY_WORKS is not set, CPU cache is enabled
192# in write-through mode when revision < 2.7.  If revision of Cyrix
193# 6x86 >= 2.7, CPU cache is always enabled in write-back mode.
194#
195# NOTE 3: This option may cause failures for software that requires
196# locked cycles in order to operate correctly.
197#
198options 	CPU_ATHLON_SSE_HACK
199options 	CPU_BLUELIGHTNING_3X
200options 	CPU_BLUELIGHTNING_FPU_OP_CACHE
201options 	CPU_BTB_EN
202options 	CPU_DIRECT_MAPPED_CACHE
203options 	CPU_DISABLE_5X86_LSSER
204options 	CPU_DISABLE_CMPXCHG
205#options 	CPU_DISABLE_SSE
206options 	CPU_ELAN
207options 	CPU_ELAN_PPS
208options 	CPU_ELAN_XTAL=32768000
209options 	CPU_ENABLE_LONGRUN
210options 	CPU_FASTER_5X86_FPU
211options 	CPU_GEODE
212options 	CPU_I486_ON_386
213options 	CPU_IORT
214options 	CPU_L2_LATENCY=5
215options 	CPU_LOOP_EN
216options 	CPU_PPRO2CELERON
217options 	CPU_RSTK_EN
218options 	CPU_SOEKRIS
219options 	CPU_SUSP_HLT
220options 	CPU_UPGRADE_HW_CACHE
221options 	CPU_WT_ALLOC
222options 	CYRIX_CACHE_WORKS
223options 	CYRIX_CACHE_REALLY_WORKS
224#options 	NO_F00F_HACK
225
226# Debug options
227options 	NPX_DEBUG	# enable npx debugging
228
229#
230# PERFMON causes the driver for Pentium/Pentium Pro performance counters
231# to be compiled.  See perfmon(4) for more information.
232#
233options 	PERFMON
234
235#
236# XBOX causes the kernel to be bootable on the Microsoft XBox console system.
237# The resulting kernel will auto-detect whether it is being booted on a XBox,
238# so kernels compiled with this option will also work on an ordinary PC.
239# This option require I686_CPU.
240#
241# xboxfb includes support for the XBox frame buffer device. It is fully USB-
242# keyboard aware, and will only be used if an xbox is detected. This option
243# (obviously) requires XBOX support in your kernel.
244#
245# NOTE: xboxfb currently conflicts with syscons(4); if you have an XBOX and
246# include both in your kernel; you will not get any video output. Ordinary
247# PC's do not suffer from this.
248#
249options 	XBOX
250device		xboxfb
251
252
253#####################################################################
254# NETWORKING OPTIONS
255
256#
257# DEVICE_POLLING adds support for mixed interrupt-polling handling
258# of network device drivers, which has significant benefits in terms
259# of robustness to overloads and responsivity, as well as permitting
260# accurate scheduling of the CPU time between kernel network processing
261# and other activities.  The drawback is a moderate (up to 1/HZ seconds)
262# potential increase in response times.
263# It is strongly recommended to use HZ=1000 or 2000 with DEVICE_POLLING
264# to achieve smoother behaviour.
265# Additionally, you can enable/disable polling at runtime with help of
266# the ifconfig(8) utility, and select the CPU fraction reserved to
267# userland with the sysctl variable kern.polling.user_frac
268# (default 50, range 0..100).
269#
270# Not all device drivers support this mode of operation at the time of
271# this writing.  See polling(4) for more details.
272
273options 	DEVICE_POLLING
274
275# BPF_JITTER adds support for BPF just-in-time compiler.
276
277options 	BPF_JITTER
278
279# OpenFabrics Enterprise Distribution (Infiniband).
280options 	OFED
281options 	OFED_DEBUG_INIT
282
283# Sockets Direct Protocol
284options 	SDP
285options 	SDP_DEBUG
286
287# IP over Infiniband
288options 	IPOIB
289options 	IPOIB_DEBUG
290options 	IPOIB_CM
291
292
293#####################################################################
294# CLOCK OPTIONS
295
296# Provide read/write access to the memory in the clock chip.
297device		nvram		# Access to rtc cmos via /dev/nvram
298
299
300#####################################################################
301# MISCELLANEOUS DEVICES AND OPTIONS
302
303device		speaker		#Play IBM BASIC-style noises out your speaker
304hint.speaker.0.at="isa"
305hint.speaker.0.port="0x61"
306device		gzip		#Exec gzipped a.out's.  REQUIRES COMPAT_AOUT!
307device		apm_saver	# Requires APM
308
309
310#####################################################################
311# HARDWARE BUS CONFIGURATION
312
313#
314# ISA bus
315#
316device		isa		# Required by npx(4)
317
318#
319# Options for `isa':
320#
321# AUTO_EOI_1 enables the `automatic EOI' feature for the master 8259A
322# interrupt controller.  This saves about 0.7-1.25 usec for each interrupt.
323# This option breaks suspend/resume on some portables.
324#
325# AUTO_EOI_2 enables the `automatic EOI' feature for the slave 8259A
326# interrupt controller.  This saves about 0.7-1.25 usec for each interrupt.
327# Automatic EOI is documented not to work for for the slave with the
328# original i8259A, but it works for some clones and some integrated
329# versions.
330#
331# MAXMEM specifies the amount of RAM on the machine; if this is not
332# specified, FreeBSD will first read the amount of memory from the CMOS
333# RAM, so the amount of memory will initially be limited to 64MB or 16MB
334# depending on the BIOS.  If the BIOS reports 64MB, a memory probe will
335# then attempt to detect the installed amount of RAM.  If this probe
336# fails to detect >64MB RAM you will have to use the MAXMEM option.
337# The amount is in kilobytes, so for a machine with 128MB of RAM, it would
338# be 131072 (128 * 1024).
339#
340# BROKEN_KEYBOARD_RESET disables the use of the keyboard controller to
341# reset the CPU for reboot.  This is needed on some systems with broken
342# keyboard controllers.
343
344options 	AUTO_EOI_1
345#options 	AUTO_EOI_2
346
347options 	MAXMEM=(128*1024)
348#options 	BROKEN_KEYBOARD_RESET
349
350#
351# EISA bus
352#
353# The EISA bus device is `eisa'.  It provides auto-detection and
354# configuration support for all devices on the EISA bus.
355
356device		eisa
357
358# By default, only 10 EISA slots are probed, since the slot numbers
359# above clash with the configuration address space of the PCI subsystem,
360# and the EISA probe is not very smart about this.  This is sufficient
361# for most machines, but in particular the HP NetServer LC series comes
362# with an onboard AIC7770 dual-channel SCSI controller on EISA slot #11,
363# thus you need to bump this figure to 12 for them.
364options 	EISA_SLOTS=12
365
366#
367# MCA bus:
368#
369# The MCA bus device is `mca'.  It provides auto-detection and
370# configuration support for all devices on the MCA bus.
371# No hints are required for MCA.
372
373device		mca
374
375#
376# AGP GART support
377device		agp
378
379# AGP debugging.
380options 	AGP_DEBUG
381
382
383#####################################################################
384# HARDWARE DEVICE CONFIGURATION
385
386# To include support for VGA VESA video modes
387options 	VESA
388
389# Turn on extra debugging checks and output for VESA support.
390options 	VESA_DEBUG
391
392device		dpms		# DPMS suspend & resume via VESA BIOS
393
394# x86 real mode BIOS emulator, required by atkbdc/dpms/vesa
395options 	X86BIOS
396
397#
398# The Numeric Processing eXtension driver.  This is non-optional.
399device		npx
400hint.npx.0.flags="0x0"
401hint.npx.0.irq="13"
402
403#
404# `flags' for npx0:
405#	0x01	don't use the npx registers to optimize bcopy.
406#	0x02	don't use the npx registers to optimize bzero.
407#	0x04	don't use the npx registers to optimize copyin or copyout.
408# The npx registers are normally used to optimize copying and zeroing when
409# all of the following conditions are satisfied:
410#	I586_CPU is an option
411#	the cpu is an i586 (perhaps not a Pentium)
412#	the probe for npx0 succeeds
413#	INT 16 exception handling works.
414# Then copying and zeroing using the npx registers is normally 30-100% faster.
415# The flags can be used to control cases where it doesn't work or is slower.
416# Setting them at boot time using hints works right (the optimizations
417# are not used until later in the bootstrap when npx0 is attached).
418# Flag 0x08 automatically disables the i586 optimized routines.
419#
420
421#
422# Optional devices:
423#
424
425# PS/2 mouse
426device		psm
427hint.psm.0.at="atkbdc"
428hint.psm.0.irq="12"
429
430# Options for psm:
431options 	PSM_HOOKRESUME		#hook the system resume event, useful
432					#for some laptops
433options 	PSM_RESETAFTERSUSPEND	#reset the device at the resume event
434
435# The keyboard controller; it controls the keyboard and the PS/2 mouse.
436device		atkbdc
437hint.atkbdc.0.at="isa"
438hint.atkbdc.0.port="0x060"
439
440# The AT keyboard
441device		atkbd
442hint.atkbd.0.at="atkbdc"
443hint.atkbd.0.irq="1"
444
445# Options for atkbd:
446options 	ATKBD_DFLT_KEYMAP	# specify the built-in keymap
447makeoptions	ATKBD_DFLT_KEYMAP=fr.dvorak
448
449# `flags' for atkbd:
450#       0x01    Force detection of keyboard, else we always assume a keyboard
451#       0x02    Don't reset keyboard, useful for some newer ThinkPads
452#	0x03	Force detection and avoid reset, might help with certain
453#		dockingstations
454#       0x04    Old-style (XT) keyboard support, useful for older ThinkPads
455
456# Video card driver for VGA adapters.
457device		vga
458hint.vga.0.at="isa"
459
460# Options for vga:
461# Try the following option if the mouse pointer is not drawn correctly
462# or font does not seem to be loaded properly.  May cause flicker on
463# some systems.
464options 	VGA_ALT_SEQACCESS
465
466# If you can dispense with some vga driver features, you may want to
467# use the following options to save some memory.
468#options 	VGA_NO_FONT_LOADING	# don't save/load font
469#options 	VGA_NO_MODE_CHANGE	# don't change video modes
470
471# Older video cards may require this option for proper operation.
472options 	VGA_SLOW_IOACCESS	# do byte-wide i/o's to TS and GDC regs
473
474# The following option probably won't work with the LCD displays.
475options 	VGA_WIDTH90		# support 90 column modes
476
477# Debugging.
478options 	VGA_DEBUG
479
480# vt(4) drivers.
481device		vt_vga
482
483# Linear framebuffer driver for S3 VESA 1.2 cards. Works on top of VESA.
484device		s3pci
485
486# 3Dfx Voodoo Graphics, Voodoo II /dev/3dfx CDEV support.  This will create
487# the /dev/3dfx0 device to work with glide implementations.  This should get
488# linked to /dev/3dfx and /dev/voodoo.  Note that this is not the same as
489# the tdfx DRI module from XFree86 and is completely unrelated.
490#
491# To enable Linuxulator support, one must also include COMPAT_LINUX in the
492# config as well.  The other option is to load both as modules.
493
494device		tdfx			# Enable 3Dfx Voodoo support
495device		tdfx_linux		# Enable Linuxulator support
496
497#
498# ACPI support using the Intel ACPI Component Architecture reference
499# implementation.
500#
501# ACPI_DEBUG enables the use of the debug.acpi.level and debug.acpi.layer
502# kernel environment variables to select initial debugging levels for the
503# Intel ACPICA code.  (Note that the Intel code must also have USE_DEBUGGER
504# defined when it is built).
505
506device		acpi
507options 	ACPI_DEBUG
508options 	ACPI_DMAR
509
510# ACPI WMI Mapping driver
511device		acpi_wmi
512
513# ACPI Asus Extras (LCD backlight/brightness, video output, etc.)
514device		acpi_asus
515
516# ACPI Fujitsu Extras (Buttons)
517device		acpi_fujitsu
518
519# ACPI extras driver for HP laptops
520device		acpi_hp
521
522# ACPI extras driver for IBM laptops
523device		acpi_ibm
524
525# ACPI Panasonic Extras (LCD backlight/brightness, video output, etc.)
526device		acpi_panasonic
527
528# ACPI Sony extra (LCD brightness)
529device		acpi_sony
530
531# ACPI Toshiba Extras (LCD backlight/brightness, video output, etc.)
532device		acpi_toshiba
533
534# ACPI Video Extensions (LCD backlight/brightness, video output, etc.)
535device		acpi_video
536
537# ACPI Docking Station
538device		acpi_dock
539
540# ACPI ASOC ATK0110 ASUSTeK AI Booster (voltage, temperature and fan sensors)
541device		aibs
542
543# The cpufreq(4) driver provides support for non-ACPI CPU frequency control
544device		cpufreq
545
546# Direct Rendering modules for 3D acceleration.
547device		drm		# DRM core module required by DRM drivers
548device		i915drm		# Intel i830 through i915
549device		mach64drm	# ATI Rage Pro, Rage Mobility P/M, Rage XL
550device		mgadrm		# AGP Matrox G200, G400, G450, G550
551device		r128drm		# ATI Rage 128
552device		radeondrm	# ATI Radeon
553device		savagedrm	# S3 Savage3D, Savage4
554device		sisdrm		# SiS 300/305, 540, 630
555device		tdfxdrm		# 3dfx Voodoo 3/4/5 and Banshee
556device		viadrm		# VIA
557options 	DRM_DEBUG	# Include debug printfs (slow)
558
559#
560# mse: Logitech and ATI InPort bus mouse ports
561
562device		mse
563hint.mse.0.at="isa"
564hint.mse.0.port="0x23c"
565hint.mse.0.irq="5"
566
567#
568# Network interfaces:
569#
570
571# bxe:  Broadcom NetXtreme II (BCM5771X/BCM578XX) PCIe 10Gb Ethernet
572#       adapters.
573# ce:   Cronyx Tau-PCI/32 sync single/dual port G.703/E1 serial adaptor
574#       with 32 HDLC subchannels (requires sppp (default), or NETGRAPH if
575#       NETGRAPH_CRONYX is configured)
576# cp:   Cronyx Tau-PCI sync single/dual/four port
577#       V.35/RS-232/RS-530/RS-449/X.21/G.703/E1/E3/T3/STS-1
578#       serial adaptor (requires sppp (default), or NETGRAPH if
579#       NETGRAPH_CRONYX is configured)
580# cs:   IBM Etherjet and other Crystal Semi CS89x0-based adapters
581# ctau: Cronyx Tau sync dual port V.35/RS-232/RS-530/RS-449/X.21/G.703/E1
582#       serial adaptor (requires sppp (default), or NETGRAPH if
583#       NETGRAPH_CRONYX is configured)
584# ed:   Western Digital and SMC 80xx; Novell NE1000 and NE2000; 3Com 3C503
585#       HP PC Lan+, various PC Card devices
586#       (requires miibus)
587# ie:   AT&T StarLAN 10 and EN100; 3Com 3C507; unknown NI5210;
588#       Intel EtherExpress
589# ipw:	Intel PRO/Wireless 2100 IEEE 802.11 adapter
590# iwi:	Intel PRO/Wireless 2200BG/2225BG/2915ABG IEEE 802.11 adapters
591#	Requires the iwi firmware module
592# iwn:	Intel Wireless WiFi Link 1000/105/135/2000/4965/5000/6000/6050 abgn
593#	802.11 network adapters
594#	Requires the iwn firmware module
595# mlx4ib: Mellanox ConnectX HCA InfiniBand
596# mlxen: Mellanox ConnectX HCA Ethernet
597# mthca: Mellanox HCA InfiniBand
598# nfe:	nVidia nForce MCP on-board Ethernet Networking (BSD open source)
599# sbni: Granch SBNI12-xx ISA and PCI adapters
600# vmx:	VMware VMXNET3 Ethernet (BSD open source)
601# wl:   Lucent Wavelan (ISA card only).
602# wpi:	Intel 3945ABG Wireless LAN controller
603#	Requires the wpi firmware module
604
605# Order for ISA/EISA devices is important here
606
607device          bxe             # Broadcom NetXtreme II BCM5771X/BCM578XX 10GbE
608device		ce
609device		cp
610device		cs		# Crystal Semiconductor CS89x0 NIC
611hint.cs.0.at="isa"
612hint.cs.0.port="0x300"
613device		ctau
614hint.ctau.0.at="isa"
615hint.ctau.0.port="0x240"
616hint.ctau.0.irq="15"
617hint.ctau.0.drq="7"
618#options 	NETGRAPH_CRONYX		# Enable NETGRAPH support for Cronyx adapter(s)
619device		ed		# NE[12]000, SMC Ultra, 3c503, DS8390 cards
620options 	ED_3C503
621options 	ED_HPP
622options 	ED_SIC
623hint.ed.0.at="isa"
624hint.ed.0.port="0x280"
625hint.ed.0.irq="5"
626hint.ed.0.maddr="0xd8000"
627device		ie		# EtherExpress 8/16, 3C507, StarLAN 10 etc.
628# Hints only required for Starlan
629hint.ie.2.at="isa"
630hint.ie.2.port="0x300"
631hint.ie.2.irq="5"
632hint.ie.2.maddr="0xd0000"
633device		ipw		# Intel 2100 wireless NICs.
634device		iwi		# Intel 2200BG/2225BG/2915ABG wireless NICs.
635device		iwn		# Intel 4965/1000/5000/6000 wireless NICs.
636# Hint for the i386-only ISA front-end of le(4).
637hint.le.0.at="isa"
638hint.le.0.port="0x280"
639hint.le.0.irq="10"
640hint.le.0.drq="0"
641device  	mlx4ib		# Mellanox ConnectX HCA InfiniBand
642device  	mlxen		# Mellanox ConnectX HCA Ethernet
643device  	mthca		# Mellanox HCA InfiniBand
644device		nfe		# nVidia nForce MCP on-board Ethernet
645device		sbni
646hint.sbni.0.at="isa"
647hint.sbni.0.port="0x210"
648hint.sbni.0.irq="0xefdead"
649hint.sbni.0.flags="0"
650device		vmx		# VMware VMXNET3 Ethernet
651device		wl
652hint.wl.0.at="isa"
653hint.wl.0.port="0x300"
654options 	WLCACHE		# enables the signal-strength cache
655options 	WLDEBUG		# enables verbose debugging output
656device		wpi		# Intel 3945ABG wireless NICs.
657
658# IEEE 802.11 adapter firmware modules
659
660# Intel PRO/Wireless 2100 firmware:
661#   ipwfw:		BSS/IBSS/monitor mode firmware
662#   ipwbssfw:		BSS mode firmware
663#   ipwibssfw:		IBSS mode firmware
664#   ipwmonitorfw:	Monitor mode firmware
665# Intel PRO/Wireless 2200BG/2225BG/2915ABG firmware:
666#   iwifw:		BSS/IBSS/monitor mode firmware
667#   iwibssfw:		BSS mode firmware
668#   iwiibssfw:		IBSS mode firmware
669#   iwimonitorfw:	Monitor mode firmware
670# Intel Wireless WiFi Link 4965/1000/5000/6000 series firmware:
671#   iwnfw:		Single module to support all devices
672#   iwn1000fw:		Specific module for the 1000 only
673#   iwn105fw:		Specific module for the 105 only
674#   iwn135fw:		Specific module for the 135 only
675#   iwn2000fw:		Specific module for the 2000 only
676#   iwn2030fw:		Specific module for the 2030 only
677#   iwn4965fw:		Specific module for the 4965 only
678#   iwn5000fw:		Specific module for the 5000 only
679#   iwn5150fw:		Specific module for the 5150 only
680#   iwn6000fw:		Specific module for the 6000 only
681#   iwn6000g2afw:	Specific module for the 6000g2a only
682#   iwn6000g2bfw:	Specific module for the 6000g2b only
683#   iwn6050fw:		Specific module for the 6050 only
684# wpifw:	Intel 3945ABG Wireless LAN Controller firmware
685
686device		iwifw
687device		iwibssfw
688device		iwiibssfw
689device		iwimonitorfw
690device		ipwfw
691device		ipwbssfw
692device		ipwibssfw
693device		ipwmonitorfw
694device		iwnfw
695device		iwn1000fw
696device		iwn105fw
697device		iwn135fw
698device		iwn2000fw
699device		iwn2030fw
700device		iwn4965fw
701device		iwn5000fw
702device		iwn5150fw
703device		iwn6000fw
704device		iwn6000g2afw
705device		iwn6000g2bfw
706device		iwn6050fw
707device		wpifw
708
709#
710# ATA raid adapters
711#
712device		pst
713
714#
715# Areca 11xx and 12xx series of SATA II RAID controllers.
716# CAM is required.
717#
718device		arcmsr		# Areca SATA II RAID
719
720#
721# 3ware 9000 series PATA/SATA RAID controller driver and options.
722# The driver is implemented as a SIM, and so, needs the CAM infrastructure.
723#
724options 	TWA_DEBUG		# 0-10; 10 prints the most messages.
725options 	TWA_FLASH_FIRMWARE	# firmware image bundled when defined.
726device		twa			# 3ware 9000 series PATA/SATA RAID
727
728#
729# SCSI host adapters:
730#
731# ncv: NCR 53C500 based SCSI host adapters.
732# nsp: Workbit Ninja SCSI-3 based PC Card SCSI host adapters.
733# stg: TMC 18C30, 18C50 based SCSI host adapters.
734
735device		ncv
736device		nsp
737device		stg
738hint.stg.0.at="isa"
739hint.stg.0.port="0x140"
740hint.stg.0.port="11"
741
742#
743# Adaptec FSA RAID controllers, including integrated DELL controllers,
744# the Dell PERC 2/QC and the HP NetRAID-4M
745device		aac
746device		aacp	# SCSI Passthrough interface (optional, CAM required)
747
748#
749# Adaptec by PMC RAID controllers, Series 6/7/8 and upcoming families
750device		aacraid		# Container interface, CAM required
751
752#
753# Highpoint RocketRAID 27xx.
754device		hpt27xx
755
756#
757# Highpoint RocketRAID 182x.
758device		hptmv
759
760#
761# Highpoint DC7280 and R750.
762device		hptnr
763
764#
765# Highpoint RocketRAID.  Supports RR172x, RR222x, RR2240, RR232x, RR2340,
766# RR2210, RR174x, RR2522, RR231x, RR230x.
767device		hptrr
768
769#
770# Highpoint RocketRaid 3xxx series SATA RAID
771device		hptiop
772
773#
774# IBM (now Adaptec) ServeRAID controllers
775device		ips
776
777#
778# Intel C600 (Patsburg) integrated SAS controller
779device		isci
780options 	ISCI_LOGGING	# enable debugging in isci HAL
781
782#
783# NVM Express (NVMe) support
784device         nvme    # base NVMe driver
785device         nvd     # expose NVMe namespaces as disks, depends on nvme
786
787#
788# PMC-Sierra SAS/SATA controller
789device		pmspcv
790#
791# SafeNet crypto driver: can be moved to the MI NOTES as soon as
792# it's tested on a big-endian machine
793#
794device		safe		# SafeNet 1141
795options 	SAFE_DEBUG	# enable debugging support: hw.safe.debug
796options 	SAFE_RNDTEST	# enable rndtest support
797
798#
799# glxiic is an I2C driver for the AMD Geode LX CS5536 System Management Bus
800# controller.  Requires 'device iicbus'.
801#
802device		glxiic		# AMD Geode LX CS5536 System Management Bus
803
804#
805# glxsb is a driver for the Security Block in AMD Geode LX processors.
806# Requires 'device crypto'.
807#
808device		glxsb		# AMD Geode LX Security Block
809
810#
811# VirtIO support
812#
813# The virtio entry provides a generic bus for use by the device drivers.
814# It must be combined with an interface that communicates with the host.
815# Multiple such interfaces defined by the VirtIO specification. FreeBSD
816# only has support for PCI. Therefore, virtio_pci must be statically
817# compiled in or loaded as a module for the device drivers to function.
818#
819device		virtio		# Generic VirtIO bus (required)
820device		virtio_pci	# VirtIO PCI Interface
821device		vtnet		# VirtIO Ethernet device
822device		virtio_blk	# VirtIO Block device
823device		virtio_scsi	# VirtIO SCSI device
824device		virtio_balloon	# VirtIO Memory Balloon device
825device		virtio_random	# VirtIO Entropy device
826device		virtio_console	# VirtIO Console device
827
828device 		hyperv		# HyperV drivers
829
830#####################################################################
831
832#
833# Miscellaneous hardware:
834#
835# apm: Laptop Advanced Power Management (experimental)
836# ipmi: Intelligent Platform Management Interface
837# smapi: System Management Application Program Interface driver
838# smbios: DMI/SMBIOS entry point
839# vpd: Vital Product Data kernel interface
840# pmtimer: Adjust system timer at wakeup time
841# pbio: Parallel (8255 PPI) basic I/O (mode 0) port (e.g. Advantech PCL-724)
842# spic: Sony Programmable I/O controller (VAIO notebooks)
843# asmc: Apple System Management Controller
844# si: Specialix International SI/XIO or SX intelligent serial card driver
845# tpm: Trusted Platform Module
846
847# Notes on APM
848#  The flags takes the following meaning for apm0:
849#    0x0020  Statclock is broken.
850
851# Notes on the Specialix SI/XIO driver:
852#  The host card is memory, not IO mapped.
853#  The Rev 1 host cards use a 64K chunk, on a 32K boundary.
854#  The Rev 2 host cards use a 32K chunk, on a 32K boundary.
855#  The cards can use an IRQ of 11, 12 or 15.
856
857# Notes on the Sony Programmable I/O controller
858#  This is a temporary driver that should someday be replaced by something
859#  that hooks into the ACPI layer.  The device is hooked to the PIIX4's
860#  General Device 10 decoder, which means you have to fiddle with PCI
861#  registers to map it in, even though it is otherwise treated here as
862#  an ISA device.  At the moment, the driver polls, although the device
863#  is capable of generating interrupts.  It largely undocumented.
864#  The port location in the hint is where you WANT the device to be
865#  mapped.  0x10a0 seems to be traditional.  At the moment the jogdial
866#  is the only thing truly supported, but apparently a fair percentage
867#  of the Vaio extra features are controlled by this device.
868
869device		apm
870hint.apm.0.flags="0x20"
871device		ipmi
872device		smapi
873device		smbios
874device		vpd
875device		pmtimer
876device		pbio
877hint.pbio.0.at="isa"
878hint.pbio.0.port="0x360"
879device		spic
880hint.spic.0.at="isa"
881hint.spic.0.port="0x10a0"
882device		asmc
883device		si
884device		tpm
885device		padlock_rng	# VIA Padlock RNG
886device		rdrand_rng	# Intel Bull Mountain RNG
887device		aesni		# AES-NI OpenCrypto module
888
889#
890# Laptop/Notebook options:
891#
892# See also:
893#  apm under `Miscellaneous hardware'
894# above.
895
896# For older notebooks that signal a powerfail condition (external
897# power supply dropped, or battery state low) by issuing an NMI:
898
899options 	POWERFAIL_NMI	# make it beep instead of panicing
900
901#
902# I2C Bus
903#
904# Philips i2c bus support is provided by the `iicbus' device.
905#
906# Supported interfaces:
907# pcf	Philips PCF8584 ISA-bus controller
908#
909device		pcf
910hint.pcf.0.at="isa"
911hint.pcf.0.port="0x320"
912hint.pcf.0.irq="5"
913
914#
915# Hardware watchdog timers:
916#
917# ichwd: Intel ICH watchdog timer
918# amdsbwd: AMD SB7xx watchdog timer
919# viawd: VIA south bridge watchdog timer
920# wbwd: Winbond watchdog timer
921#
922device		ichwd
923device		amdsbwd
924device		viawd
925device		wbwd
926
927#
928# Temperature sensors:
929#
930# coretemp: on-die sensor on Intel Core and newer CPUs
931# amdtemp: on-die sensor on AMD K8/K10/K11 CPUs
932#
933device		coretemp
934device		amdtemp
935
936#
937# CPU control pseudo-device. Provides access to MSRs, CPUID info and
938# microcode update feature.
939#
940device		cpuctl
941
942#
943# System Management Bus (SMB)
944#
945options 	ENABLE_ALART		# Control alarm on Intel intpm driver
946
947#
948# Set the number of PV entries per process.  Increasing this can
949# stop panics related to heavy use of shared memory.  However, that can
950# (combined with large amounts of physical memory) cause panics at
951# boot time due the kernel running out of VM space.
952#
953# If you're tweaking this, you might also want to increase the sysctls
954# "vm.v_free_min", "vm.v_free_reserved", and "vm.v_free_target".
955#
956# The value below is the one more than the default.
957#
958options 	PMAP_SHPGPERPROC=201
959
960#
961# Change the size of the kernel virtual address space.  Due to
962# constraints in loader(8) on i386, this must be a multiple of 4.
963# 256 = 1 GB of kernel address space.  Increasing this also causes
964# a reduction of the address space in user processes.  512 splits
965# the 4GB cpu address space in half (2GB user, 2GB kernel).  For PAE
966# kernels, the value will need to be double non-PAE.  A value of 1024
967# for PAE kernels is necessary to split the address space in half.
968# This will likely need to be increased to handle memory sizes >4GB.
969# PAE kernels default to a value of 512.
970#
971options 	KVA_PAGES=260
972
973#
974# Number of initial kernel page table pages used for early bootstrap.
975# This number should include enough pages to map the kernel, any
976# modules or other data loaded with the kernel by the loader, and data
977# structures allocated before the VM system is initialized such as the
978# vm_page_t array.  Each page table page maps 4MB (2MB with PAE).
979#
980options 	NKPT=31
981
982
983#####################################################################
984# ABI Emulation
985
986# Enable iBCS2 runtime support for SCO and ISC binaries
987#options 	IBCS2
988
989# Emulate spx device for client side of SVR3 local X interface
990options 	SPX_HACK
991
992# Enable Linux ABI emulation
993options 	COMPAT_LINUX
994
995# Enable i386 a.out binary support
996options 	COMPAT_AOUT
997
998# Enable the linux-like proc filesystem support (requires COMPAT_LINUX
999# and PSEUDOFS)
1000options 	LINPROCFS
1001
1002#Enable the linux-like sys filesystem support (requires COMPAT_LINUX
1003# and PSEUDOFS)
1004options 	LINSYSFS
1005
1006#
1007# SysVR4 ABI emulation
1008#
1009# The svr4 ABI emulator can be statically compiled into the kernel or loaded as
1010# a KLD module.
1011# The STREAMS network emulation code can also be compiled statically or as a
1012# module.  If loaded as a module, it must be loaded before the svr4 module
1013# (the /usr/sbin/svr4 script does this for you).  If compiling statically,
1014# the `streams' device must be configured into any kernel which also
1015# specifies COMPAT_SVR4.  It is possible to have a statically-configured
1016# STREAMS device and a dynamically loadable svr4 emulator;  the /usr/sbin/svr4
1017# script understands that it doesn't need to load the `streams' module under
1018# those circumstances.
1019# Caveat:  At this time, `options KTRACE' is required for the svr4 emulator
1020# (whether static or dynamic).
1021#
1022options 	COMPAT_SVR4	# build emulator statically
1023options 	DEBUG_SVR4	# enable verbose debugging
1024device		streams		# STREAMS network driver (required for svr4).
1025
1026# Enable NDIS binary driver support
1027options 	NDISAPI
1028device		ndis
1029
1030
1031#####################################################################
1032# VM OPTIONS
1033
1034# Disable the 4 MByte page PSE CPU feature.  The PSE feature allows the
1035# kernel to use 4 MByte pages to map the kernel instead of 4k pages.
1036# This saves on the amount of memory needed for page tables needed to
1037# map the kernel.  You should only disable this feature as a temporary
1038# workaround if you are having problems with it enabled.
1039#
1040#options 	DISABLE_PSE
1041
1042# Disable the global pages PGE CPU feature.  The PGE feature allows pages
1043# to be marked with the PG_G bit.  TLB entries for these pages are not
1044# flushed from the cache when %cr3 is reloaded.  This can make context
1045# switches less expensive.  You should only disable this feature as a
1046# temporary workaround if you are having problems with it enabled.
1047#
1048#options 	DISABLE_PG_G
1049
1050# KSTACK_PAGES is the number of memory pages to assign to the kernel
1051# stack of each thread.
1052
1053options 	KSTACK_PAGES=3
1054
1055# Enable detailed accounting by the PV entry allocator.
1056
1057options 	PV_STATS
1058
1059#####################################################################
1060
1061# More undocumented options for linting.
1062# Note that documenting these are not considered an affront.
1063
1064options 	FB_INSTALL_CDEV		# install a CDEV entry in /dev
1065
1066options 	I586_PMC_GUPROF=0x70000
1067options 	KBDIO_DEBUG=2
1068options 	KBD_MAXRETRY=4
1069options 	KBD_MAXWAIT=6
1070options 	KBD_RESETDELAY=201
1071
1072options 	PSM_DEBUG=1
1073
1074options 	TIMER_FREQ=((14318182+6)/12)
1075
1076options 	VM_KMEM_SIZE
1077options 	VM_KMEM_SIZE_MAX
1078options 	VM_KMEM_SIZE_SCALE
1079
1080
1081