xref: /freebsd/sys/amd64/conf/NOTES (revision 8e5e2c391059eaa0280a32b951e3ab1fac278364)
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.  For notes shared
6# with i386, look in /sys/x86/conf/NOTES.
7#
8#
9
10# GCOV (code coverage) support
11
12options 	LINDEBUGFS
13options 	GCOV
14
15
16#####################################################################
17# SMP OPTIONS:
18
19# Optional:
20device		atpic			# Optional legacy pic support
21device		mptable			# Optional MPSPEC mptable support
22
23
24#####################################################################
25# CPU OPTIONS
26
27#
28# You must specify at least one CPU (the one you intend to run on);
29# deleting the specification for CPUs you don't need to use may make
30# parts of the system run faster.
31#
32cpu		HAMMER			# aka K8, aka Opteron & Athlon64
33
34#
35# Options for CPU features.
36#
37
38
39#####################################################################
40# HARDWARE DEVICE CONFIGURATION
41
42#
43# Optional devices:
44#
45
46# vt(4) drivers.
47device		vt_efifb	# EFI framebuffer
48
49# 3Dfx Voodoo Graphics, Voodoo II /dev/3dfx CDEV support.  This will create
50# the /dev/3dfx0 device to work with glide implementations.  This should get
51# linked to /dev/3dfx and /dev/voodoo.  Note that this is not the same as
52# the tdfx DRI module from XFree86 and is completely unrelated.
53#
54
55device		tdfx			# Enable 3Dfx Voodoo support
56
57#
58# RAID adapters
59#
60
61#XXX this stores pointers in a 32bit field that is defined by the hardware
62#device	pst
63
64# Thunderbolt (USB 4.0) support
65device		thunderbolt
66options		THUNDERBOLT_DEBUG
67
68#
69# Microsemi smartpqi controllers.
70# These controllers have a SCSI-like interface, and require the
71# CAM infrastructure.
72#
73device		smartpqi
74
75# Broadcom MPT Fusion, version 4, is 64-bit only
76device		mpi3mr			# LSI-Logic MPT-Fusion 4
77
78# Universal Flash Storage Host Controller Interface support
79device 		ufshci			# UFS host controller
80
81#
82# Network interfaces:
83#
84
85# axp: AMD EPYC integrated NIC
86#	Requires the miibus module
87# ice:	Intel 800 Series Physical Function
88#	Requires the ice_ddp module for full functionality
89# irdma: Intel 800 Series RDMA driver
90#        Requires the ice module
91# qlxgb: QLogic 3200 and 8200 series 10 Gigabit Ethernet & CNA Adapter
92# qlxgbe: QLogic 8300 series 10 Gigabit Ethernet & CNA Adapter
93# qlxge: QLogic 8100 series 10 Gigabit Ethernet & CNA Adapter
94# qlnxe: Cavium QLogic 41000/45000 series 10/25/40/100 Gigabit Ethernet & CNA Adapter
95# sfxge: Solarflare SFC9000 family 10Gb Ethernet adapters
96
97device		axp		# AMD EPYC integrated NIC
98device		ixl		# Intel 700 Series Physical Function
99device		iavf		# Intel Adaptive Virtual Function
100device		ice		# Intel 800 Series Physical Function
101device		ice_ddp		# Intel 800 Series DDP Package
102device		irdma		# Intel 800 Series RDMA driver
103device		qlxgb		# QLogic 3200/8200 Ethernet
104device		qlxgbe		# QLogic 8300 Ethernet
105device		qlxge		# QLogic 8100 Ethernet
106device		qlnxe		# QLogic 41000/45000 Ethernet
107device		sfxge		# Solarflare SFC9000 10Gb Ethernet
108
109#####################################################################
110
111#
112# Miscellaneous hardware:
113#
114
115device		ioat		# Intel I/OAT DMA engine
116
117# Intel ME Host Firmware Status (HFSTS) debug probe
118device		hfsts
119
120# EFI Runtime Services support
121options 	EFIRT
122
123# EFI pseudo-device
124device		efidev
125
126# EFI RTC
127device		efirtc
128
129# Apple System Management Controller (SMC)
130device		asmc
131options		ASMC_DEBUG	# Enable asmc(4)-specific debug logic.
132
133#
134# Intel QuickAssist driver with OpenCrypto support
135#
136# Only for legacy Atom C2XXX chipsets.
137device		qat_c2xxx
138
139# Xen HVM Guest Optimizations
140options 	XENHVM		# Xen HVM kernel infrastructure
141device		xenefi		# Xen EFI timer device
142device 		xenpci		# Xen HVM Hypervisor services driver
143device		xentimer	# Xen x86 PV timer device
144
145#####################################################################
146# ABI Emulation
147
148# Enable 32-bit runtime support for FreeBSD/i386 binaries.
149options 	COMPAT_FREEBSD32
150
151# Enable (32-bit) a.out binary support
152options 	COMPAT_AOUT
153
154#####################################################################
155# ZFS support
156
157# NB: This depends on crypto, cryptodev and ZSTDIO
158options 	ZFS
159
160#####################################################################
161# VM OPTIONS
162
163#
164# Number of initial kernel page table pages used for early bootstrap.
165# This number should include enough pages to map the kernel and any
166# modules or other data loaded with the kernel by the loader.  Each
167# page table page maps 2MB.
168#
169options 	NKPT=31
170
171# KSTACK_PAGES is the number of memory pages to assign to the kernel
172# stack of each thread.
173
174options 	KSTACK_PAGES=5
175
176# Enable detailed accounting by the PV entry allocator.
177
178options 	PV_STATS
179
180#####################################################################
181# Kernel sanitizers
182
183#options	COVERAGE		# Generic kernel coverage. Used by KCOV
184#options	KCOV			# Kernel Coverage Sanitizer
185# Warning: KUBSAN can result in a kernel too large for loader to load
186#options	KUBSAN			# Kernel Undefined Behavior Sanitizer
187#options	KCSAN			# Kernel Concurrency Sanitizer
188#options	KASAN			# Kernel Address Sanitizer
189#options	KMSAN			# Kernel Memory Sanitizer
190