xref: /freebsd/sys/amd64/conf/NOTES (revision dd6f6030cc2981ce860b664e54bf17cf9fc80668)
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# Notes:
37#
38# IPI_PREEMPTION instructs the kernel to preempt threads running on other
39#	  CPUS if needed.  Relies on the PREEMPTION option
40
41# Optional:
42options 	IPI_PREEMPTION
43device		atpic			# Optional legacy pic support
44device		mptable			# Optional MPSPEC mptable support
45
46# Debugging options.
47#
48options 	COUNT_XINVLTLB_HITS	# Counters for TLB events
49options 	COUNT_IPIS		# Per-CPU IPI interrupt counters
50
51
52
53#####################################################################
54# CPU OPTIONS
55
56#
57# You must specify at least one CPU (the one you intend to run on);
58# deleting the specification for CPUs you don't need to use may make
59# parts of the system run faster.
60#
61cpu		HAMMER			# aka K8, aka Opteron & Athlon64
62
63#
64# Options for CPU features.
65#
66
67
68#####################################################################
69# NETWORKING OPTIONS
70
71#
72# DEVICE_POLLING adds support for mixed interrupt-polling handling
73# of network device drivers, which has significant benefits in terms
74# of robustness to overloads and responsivity, as well as permitting
75# accurate scheduling of the CPU time between kernel network processing
76# and other activities.  The drawback is a moderate (up to 1/HZ seconds)
77# potential increase in response times.
78# It is strongly recommended to use HZ=1000 or 2000 with DEVICE_POLLING
79# to achieve smoother behaviour.
80# Additionally, you can enable/disable polling at runtime with help of
81# the ifconfig(8) utility, and select the CPU fraction reserved to
82# userland with the sysctl variable kern.polling.user_frac
83# (default 50, range 0..100).
84#
85# Not all device drivers support this mode of operation at the time of
86# this writing.  See polling(4) for more details.
87
88options 	DEVICE_POLLING
89
90# BPF_JITTER adds support for BPF just-in-time compiler.
91
92options 	BPF_JITTER
93
94# OpenFabrics Enterprise Distribution (Infiniband).
95options 	OFED
96options 	OFED_DEBUG_INIT
97
98# Sockets Direct Protocol
99options 	SDP
100options 	SDP_DEBUG
101
102# IP over Infiniband
103options 	IPOIB
104options 	IPOIB_DEBUG
105options 	IPOIB_CM
106
107
108#####################################################################
109# CLOCK OPTIONS
110
111# Provide read/write access to the memory in the clock chip.
112device		nvram		# Access to rtc cmos via /dev/nvram
113
114
115#####################################################################
116# MISCELLANEOUS DEVICES AND OPTIONS
117
118device		speaker		#Play IBM BASIC-style noises out your speaker
119envvar		hint.speaker.0.at="isa"
120envvar		hint.speaker.0.port="0x61"
121
122
123#####################################################################
124# HARDWARE BUS CONFIGURATION
125
126#
127# ISA bus
128#
129device		isa
130
131#
132# Options for `isa':
133#
134# AUTO_EOI_1 enables the `automatic EOI' feature for the master 8259A
135# interrupt controller.  This saves about 0.7-1.25 usec for each interrupt.
136# This option breaks suspend/resume on some portables.
137#
138# AUTO_EOI_2 enables the `automatic EOI' feature for the slave 8259A
139# interrupt controller.  This saves about 0.7-1.25 usec for each interrupt.
140# Automatic EOI is documented not to work for the slave with the
141# original i8259A, but it works for some clones and some integrated
142# versions.
143#
144# MAXMEM specifies the amount of RAM on the machine; if this is not
145# specified, FreeBSD will first read the amount of memory from the CMOS
146# RAM, so the amount of memory will initially be limited to 64MB or 16MB
147# depending on the BIOS.  If the BIOS reports 64MB, a memory probe will
148# then attempt to detect the installed amount of RAM.  If this probe
149# fails to detect >64MB RAM you will have to use the MAXMEM option.
150# The amount is in kilobytes, so for a machine with 128MB of RAM, it would
151# be 131072 (128 * 1024).
152#
153# BROKEN_KEYBOARD_RESET disables the use of the keyboard controller to
154# reset the CPU for reboot.  This is needed on some systems with broken
155# keyboard controllers.
156
157options 	AUTO_EOI_1
158#options 	AUTO_EOI_2
159
160options 	MAXMEM=(128*1024)
161#options 	BROKEN_KEYBOARD_RESET
162
163#
164# AGP GART support
165device		agp
166
167#
168# AGP debugging.
169#
170options 	AGP_DEBUG
171
172
173#####################################################################
174# HARDWARE DEVICE CONFIGURATION
175
176# To include support for VGA VESA video modes
177options 	VESA
178
179# Turn on extra debugging checks and output for VESA support.
180options 	VESA_DEBUG
181
182device		dpms		# DPMS suspend & resume via VESA BIOS
183
184# x86 real mode BIOS emulator, required by atkbdc/dpms/vesa
185options 	X86BIOS
186
187#
188# Optional devices:
189#
190
191# PS/2 mouse
192device		psm
193envvar		hint.psm.0.at="atkbdc"
194envvar		hint.psm.0.irq="12"
195
196# Options for psm:
197options 	PSM_HOOKRESUME		#hook the system resume event, useful
198					#for some laptops
199options 	PSM_RESETAFTERSUSPEND	#reset the device at the resume event
200
201# The keyboard controller; it controls the keyboard and the PS/2 mouse.
202device		atkbdc
203envvar		hint.atkbdc.0.at="isa"
204envvar		hint.atkbdc.0.port="0x060"
205
206# The AT keyboard
207device		atkbd
208envvar		hint.atkbd.0.at="atkbdc"
209envvar		hint.atkbd.0.irq="1"
210
211# Options for atkbd:
212options 	ATKBD_DFLT_KEYMAP	# specify the built-in keymap
213makeoptions	ATKBD_DFLT_KEYMAP=fr.dvorak
214
215# `flags' for atkbd:
216#       0x01    Force detection of keyboard, else we always assume a keyboard
217#       0x02    Don't reset keyboard, useful for some newer ThinkPads
218#	0x03	Force detection and avoid reset, might help with certain
219#		dockingstations
220#       0x04    Old-style (XT) keyboard support, useful for older ThinkPads
221
222# Video card driver for VGA adapters.
223device		vga
224envvar		hint.vga.0.at="isa"
225
226# Options for vga:
227# Try the following option if the mouse pointer is not drawn correctly
228# or font does not seem to be loaded properly.  May cause flicker on
229# some systems.
230options 	VGA_ALT_SEQACCESS
231
232# If you can dispense with some vga driver features, you may want to
233# use the following options to save some memory.
234#options 	VGA_NO_FONT_LOADING	# don't save/load font
235#options 	VGA_NO_MODE_CHANGE	# don't change video modes
236
237# Older video cards may require this option for proper operation.
238options 	VGA_SLOW_IOACCESS	# do byte-wide i/o's to TS and GDC regs
239
240# The following option probably won't work with the LCD displays.
241options 	VGA_WIDTH90		# support 90 column modes
242
243# Debugging.
244options 	VGA_DEBUG
245
246# vt(4) drivers.
247device		vt_vga		# VGA
248device		vt_efifb	# EFI framebuffer
249device		vt_vbefb	# VBE framebuffer
250
251# Linear framebuffer driver for S3 VESA 1.2 cards. Works on top of VESA.
252device		s3pci
253
254# 3Dfx Voodoo Graphics, Voodoo II /dev/3dfx CDEV support.  This will create
255# the /dev/3dfx0 device to work with glide implementations.  This should get
256# linked to /dev/3dfx and /dev/voodoo.  Note that this is not the same as
257# the tdfx DRI module from XFree86 and is completely unrelated.
258#
259
260device		tdfx			# Enable 3Dfx Voodoo support
261
262#
263# ACPI support using the Intel ACPI Component Architecture reference
264# implementation.
265#
266# ACPI_DEBUG enables the use of the debug.acpi.level and debug.acpi.layer
267# kernel environment variables to select initial debugging levels for the
268# Intel ACPICA code.  (Note that the Intel code must also have USE_DEBUGGER
269# defined when it is built).
270
271device		acpi
272options 	ACPI_DEBUG
273
274# The cpufreq(4) driver provides support for non-ACPI CPU frequency control
275device		cpufreq
276
277#
278# Network interfaces:
279#
280
281# axp: AMD EPYC integrated NIC
282#	Requires the miibus module
283# bxe:  Broadcom NetXtreme II (BCM5771X/BCM578XX) PCIe 10Gb Ethernet
284#       adapters.
285# ice:	Intel 800 Series Physical Function
286#	Requires the ice_ddp module for full functionality
287# igc:	Intel I225 2.5Gb Ethernet adapter
288# ipw:	Intel PRO/Wireless 2100 IEEE 802.11 adapter
289#	Requires the ipw firmware module
290# irdma: Intel 800 Series RDMA driver
291#        Requires the ice module
292# iwi:	Intel PRO/Wireless 2200BG/2225BG/2915ABG IEEE 802.11 adapters
293#	Requires the iwi firmware module
294# iwn:	Intel Wireless WiFi Link 1000/105/135/2000/4965/5000/6000/6050 abgn
295#	802.11 network adapters
296#	Requires the iwn firmware module
297# mthca: Mellanox HCA InfiniBand
298# mlx4ib: Mellanox ConnectX HCA InfiniBand
299# mlx4en: Mellanox ConnectX HCA Ethernet
300# nfe:	nVidia nForce MCP on-board Ethernet Networking (BSD open source)
301# qlxgb: QLogic 3200 and 8200 series 10 Gigabit Ethernet & CNA Adapter
302# qlxgbe: QLogic 8300 series 10 Gigabit Ethernet & CNA Adapter
303# qlxge: QLogic 8100 series 10 Gigabit Ethernet & CNA Adapter
304# sfxge: Solarflare SFC9000 family 10Gb Ethernet adapters
305# vmx:	VMware VMXNET3 Ethernet (BSD open source)
306# wpi:	Intel 3945ABG Wireless LAN controller
307#	Requires the wpi firmware module
308
309device		axp		# AMD EPYC integrated NIC
310device		bxe		# Broadcom NetXtreme II BCM5771X/BCM578XX 10GbE
311device		igc		# Intel I225 2.5G Ethernet
312device		ipw		# Intel 2100 wireless NICs.
313device		iwi		# Intel 2200BG/2225BG/2915ABG wireless NICs.
314device		iwn		# Intel 4965/1000/5000/6000 wireless NICs.
315device		ixl		# Intel 700 Series Physical Function
316device		iavf		# Intel Adaptive Virtual Function
317device		ice		# Intel 800 Series Physical Function
318device		ice_ddp		# Intel 800 Series DDP Package
319device		irdma		# Intel 800 Series RDMA driver
320device  	mthca		# Mellanox HCA InfiniBand
321device  	mlx4		# Shared code module between IB and Ethernet
322device  	mlx4ib		# Mellanox ConnectX HCA InfiniBand
323device  	mlx4en		# Mellanox ConnectX HCA Ethernet
324device		nfe		# nVidia nForce MCP on-board Ethernet
325device		qlxgb		# QLogic 3200/8200 Ethernet
326device		qlxgbe		# QLogic 8300 Ethernet
327device		qlxge		# QLogic 8100 Ethernet
328device		sfxge		# Solarflare SFC9000 10Gb Ethernet
329device		vmx		# VMware VMXNET3 Ethernet
330device		wpi		# Intel 3945ABG wireless NICs.
331
332# IEEE 802.11 adapter firmware modules
333
334# Intel PRO/Wireless 2100 firmware:
335#   ipwfw:		BSS/IBSS/monitor mode firmware
336#   ipwbssfw:		BSS mode firmware
337#   ipwibssfw:		IBSS mode firmware
338#   ipwmonitorfw:	Monitor mode firmware
339# Intel PRO/Wireless 2200BG/2225BG/2915ABG firmware:
340#   iwifw:		BSS/IBSS/monitor mode firmware
341#   iwibssfw:		BSS mode firmware
342#   iwiibssfw:		IBSS mode firmware
343#   iwimonitorfw:	Monitor mode firmware
344# Intel Wireless WiFi Link 4965/1000/5000/6000 series firmware:
345#   iwnfw:		Single module to support all devices
346#   iwn1000fw:		Specific module for the 1000 only
347#   iwn105fw:		Specific module for the 105 only
348#   iwn135fw:		Specific module for the 135 only
349#   iwn2000fw:		Specific module for the 2000 only
350#   iwn2030fw:		Specific module for the 2030 only
351#   iwn4965fw:		Specific module for the 4965 only
352#   iwn5000fw:		Specific module for the 5000 only
353#   iwn5150fw:		Specific module for the 5150 only
354#   iwn6000fw:		Specific module for the 6000 only
355#   iwn6000g2afw:	Specific module for the 6000g2a only
356#   iwn6000g2bfw:	Specific module for the 6000g2b only
357#   iwn6050fw:		Specific module for the 6050 only
358# wpifw:	Intel 3945ABG Wireless LAN Controller firmware
359
360device		iwifw
361device		iwibssfw
362device		iwiibssfw
363device		iwimonitorfw
364device		ipwfw
365device		ipwbssfw
366device		ipwibssfw
367device		ipwmonitorfw
368device		iwnfw
369device		iwn1000fw
370device		iwn105fw
371device		iwn135fw
372device		iwn2000fw
373device		iwn2030fw
374device		iwn4965fw
375device		iwn5000fw
376device		iwn5150fw
377device		iwn6000fw
378device		iwn6000g2afw
379device		iwn6000g2bfw
380device		iwn6050fw
381device		wpifw
382
383# net80211 options
384options 	IEEE80211_DEBUG_REFCNT
385
386#
387# Non-Transparent Bridge (NTB) drivers
388#
389device		if_ntb		# Virtual NTB network interface
390device		ntb_transport	# NTB packet transport driver
391device		ntb		# NTB hardware interface
392device		ntb_hw_amd	# AMD NTB hardware driver
393device		ntb_hw_intel	# Intel NTB hardware driver
394device		ntb_hw_plx	# PLX NTB hardware driver
395
396#
397#XXX this stores pointers in a 32bit field that is defined by the hardware
398#device	pst
399
400#
401# Areca 11xx and 12xx series of SATA II RAID controllers.
402# CAM is required.
403#
404device		arcmsr		# Areca SATA II RAID
405
406#
407# Microsemi smartpqi controllers.
408# These controllers have a SCSI-like interface, and require the
409# CAM infrastructure.
410#
411device		smartpqi
412
413#
414# Adaptec FSA RAID controllers, including integrated DELL controllers,
415# the Dell PERC 2/QC and the HP NetRAID-4M
416device		aac
417device		aacp	# SCSI Passthrough interface (optional, CAM required)
418
419#
420# Highpoint RocketRAID 27xx.
421device		hpt27xx
422
423#
424# Highpoint RocketRAID 182x.
425device		hptmv
426
427#
428# Highpoint DC7280 and R750.
429device		hptnr
430
431#
432# Highpoint RocketRAID.  Supports RR172x, RR222x, RR2240, RR232x, RR2340,
433# RR2210, RR174x, RR2522, RR231x, RR230x.
434device		hptrr
435
436#
437# Highpoint RocketRaid 3xxx series SATA RAID
438device		hptiop
439
440#
441# IBM (now Adaptec) ServeRAID controllers
442device		ips
443
444#
445# Intel integrated Memory Controller (iMC) SMBus controller
446#	Sandybridge-Xeon, Ivybridge-Xeon, Haswell-Xeon, Broadwell-Xeon
447device		imcsmb
448
449#
450# Intel C600 (Patsburg) integrated SAS controller
451device		isci
452options 	ISCI_LOGGING	# enable debugging in isci HAL
453
454#
455# NVM Express (NVMe) support
456device         nvme    # base NVMe driver
457device         nvd     # expose NVMe namespaces as disks, depends on nvme
458
459#
460# Intel Volume Management Device (VMD) support
461device		vmd
462
463#
464# PMC-Sierra SAS/SATA controller
465device		pmspcv
466
467#
468# Intel QuickAssist driver with OpenCrypto support
469#
470# Only for legacy Atom C2XXX chipsets.
471device		qat_c2xxx
472
473#
474# SafeNet crypto driver: can be moved to the MI NOTES as soon as
475# it's tested on a big-endian machine
476#
477device		safe		# SafeNet 1141
478options 	SAFE_DEBUG	# enable debugging support: hw.safe.debug
479options 	SAFE_RNDTEST	# enable rndtest support
480
481#
482# VirtIO support
483#
484# The virtio entry provides a generic bus for use by the device drivers.
485# It must be combined with an interface that communicates with the host.
486# Multiple such interfaces are defined by the VirtIO specification. FreeBSD
487# only has support for PCI. Therefore, virtio_pci must be statically
488# compiled in or loaded as a module for the device drivers to function.
489#
490device		virtio		# Generic VirtIO bus (required)
491device		virtio_pci	# VirtIO PCI Interface
492device		vtnet		# VirtIO Ethernet device
493device		virtio_blk	# VirtIO Block device
494device		virtio_scsi	# VirtIO SCSI device
495device		virtio_balloon	# VirtIO Memory Balloon device
496device		virtio_random	# VirtIO Entropy device
497device		virtio_console	# VirtIO Console device
498
499# Linux KVM paravirtualization support
500device		kvm_clock	# KVM paravirtual clock driver
501
502# Microsoft Hyper-V enhancement support
503device 		hyperv		# HyperV drivers
504device		hvhid		# HyperV HID device
505
506# Xen HVM Guest Optimizations
507options 	XENHVM		# Xen HVM kernel infrastructure
508device 		xenpci		# Xen HVM Hypervisor services driver
509device		xentimer	# Xen x86 PV timer device
510
511#####################################################################
512
513#
514# Miscellaneous hardware:
515#
516# ipmi: Intelligent Platform Management Interface
517# pbio: Parallel (8255 PPI) basic I/O (mode 0) port (e.g. Advantech PCL-724)
518# smbios: DMI/SMBIOS entry point (requires EFIRT option)
519# vpd: Vital Product Data kernel interface
520# asmc: Apple System Management Controller
521# si: Specialix International SI/XIO or SX intelligent serial card
522# tpm: Trusted Platform Module
523
524# Notes on the Specialix SI/XIO driver:
525#  The host card is memory, not IO mapped.
526#  The Rev 1 host cards use a 64K chunk, on a 32K boundary.
527#  The Rev 2 host cards use a 32K chunk, on a 32K boundary.
528#  The cards can use an IRQ of 11, 12 or 15.
529
530device		ipmi
531device		pbio
532envvar		hint.pbio.0.at="isa"
533envvar		hint.pbio.0.port="0x360"
534device		smbios
535device		vpd
536device		asmc
537device		tpm
538device		padlock_rng	# VIA Padlock RNG
539device		rdrand_rng	# Intel Bull Mountain RNG
540device		aesni		# AES-NI OpenCrypto module
541device		ossl		# OpenSSL OpenCrypto module
542device		ioat		# Intel I/OAT DMA engine
543
544#
545# Laptop/Notebook options:
546#
547
548device backlight
549
550#
551# I2C Bus
552#
553
554#
555# Hardware watchdog timers:
556#
557# ichwd: Intel ICH watchdog timer
558# amdsbwd: AMD SB7xx watchdog timer
559# viawd: VIA south bridge watchdog timer
560# wbwd: Winbond watchdog timer
561# itwd: ITE Super I/O watchdog timer
562#
563device		ichwd
564device		amdsbwd
565device		viawd
566device		wbwd
567device		itwd
568
569#
570# Temperature sensors:
571#
572# coretemp: on-die sensor on Intel Core and newer CPUs
573# amdtemp: on-die sensor on AMD K8/K10/K11 CPUs
574#
575device		coretemp
576device		amdtemp
577
578#
579# CPU control pseudo-device. Provides access to MSRs, CPUID info and
580# microcode update feature.
581#
582device		cpuctl
583
584#
585# SuperIO driver.
586#
587device		superio
588
589#
590# System Management Bus (SMB)
591#
592options 	ENABLE_ALART		# Control alarm on Intel intpm driver
593
594#
595# AMD System Management Network (SMN)
596#
597device		amdsmn
598
599#
600# Number of initial kernel page table pages used for early bootstrap.
601# This number should include enough pages to map the kernel and any
602# modules or other data loaded with the kernel by the loader.  Each
603# page table page maps 2MB.
604#
605options 	NKPT=31
606
607# EFI Runtime Services support
608options 	EFIRT
609
610#
611# HID-over-I2C support
612#
613device		iichid		# HID-over-I2C support
614options 	IICHID_DEBUG	# Enable HID-over-I2C debug messages
615options 	IICHID_SAMPLING	# Workaround missing GPIO INTR support
616
617#####################################################################
618# ABI Emulation
619
620#XXX keep these here for now and reactivate when support for emulating
621#XXX these 32 bit binaries is added.
622
623# Enable 32-bit runtime support for FreeBSD/i386 binaries.
624options 	COMPAT_FREEBSD32
625
626# Enable (32-bit) a.out binary support
627options 	COMPAT_AOUT
628
629#####################################################################
630# ZFS support
631
632# NB: This depends on crypto, cryptodev and ZSTDIO
633options 	ZFS
634
635#####################################################################
636# VM OPTIONS
637
638# KSTACK_PAGES is the number of memory pages to assign to the kernel
639# stack of each thread.
640
641options 	KSTACK_PAGES=5
642
643# Enable detailed accounting by the PV entry allocator.
644
645options 	PV_STATS
646
647#####################################################################
648
649# More undocumented options for linting.
650# Note that documenting these are not considered an affront.
651
652options 	KBDIO_DEBUG=2
653options 	KBD_MAXRETRY=4
654options 	KBD_MAXWAIT=6
655options 	KBD_RESETDELAY=201
656
657options 	PSM_DEBUG=1
658
659options 	TIMER_FREQ=((14318182+6)/12)
660
661options 	VM_KMEM_SIZE
662options 	VM_KMEM_SIZE_MAX
663options 	VM_KMEM_SIZE_SCALE
664
665# GCOV (code coverage) support
666
667options 	LINDEBUGFS
668options 	GCOV
669