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