28.5 GENERIC 内核选项注解(AMD64)
GENERIC 是 FreeBSD amd64 架构的默认内核配置文件,其选项均可在机器无关和机器相关选项的 NOTES 文件中找到对应说明。本节列出 GENERIC 完整选项并逐项标注。
详细选项列表及设备行说明可参考对应的 NOTES 文件。
GENERIC 的本义是“通用的、一般的、普通的”。GENERIC 内核选项是 amd64 体系架构下所有镜像的默认构建选项(FreeBSD/amd64 通用内核配置文件),但 CURRENT(main 分支)会引入额外的调试选项。
为了便于说明,并避免引入对大多数非开发者无用的调试选项,本节以 15.0-RELEASE(releng/15.0 分支)的 GENERIC 内核选项为例说明。
首先介绍 CPU 相关的配置选项:
cpu HAMMERHAMMER 是 AMD K8 的研发代号,即 Opteron(皓龙)和 Athlon64(速龙)。
ident GENERIC这是内核的“标识符”。
通常应与内核的名称相同。该选项用于将内核名称设置为 GENERIC。至少需要一行 ident 条目。
makeoptions DEBUG=-g构建包含 gdb(1) 调试符号的内核。
makeoptions WITH_CTF=1为支持 DTrace,运行 ctfconvert(1) 将调试数据转换为 CTF 数据。
options SCHED_ULEULE 调度程序。
options NUMA非一致性内存访问(NUMA)支持。
options PREEMPTION启用内核线程抢占。
options EXTERR_STRINGS其曾用名为 BLOAT_KERNEL_WITH_EXTERR,用于启用内核扩展错误信息。参见:Extended errors from kernel[EB/OL]. [2026-03-26]. https://reviews.freebsd.org/D50483。
options VIMAGE用于子系统虚拟化,例如 VNET。
options INETIPv4 协议簇。IP 协议簇是一组协议,位于互联网协议(IP)之上,并使用互联网地址格式。该协议簇为 SOCK_STREAM、SOCK_DGRAM 和 SOCK_RAW 套接字类型提供协议支持;其中 SOCK_RAW 接口提供了对 IP 协议的访问。
options INET6IPv6 协议簇。
options IPSEC_SUPPORT允许通过 kldload 命令加载 ipsec 和 tcpmd5 模块。
options IPSEC_OFFLOAD内联 IPsec 卸载基础设施。
options ROUTE_MPATHMultipath 路由支持。
options FIB_ALGO模块化 FIB 查找支持。
options TCP_OFFLOADTCP 卸载支持。
options TCP_BLACKBOX增强的 TCP 事件日志功能。
options TCP_HHOOKTCP 的 hhook(9) 框架支持。
options TCP_RFC7413TCP 快速打开。
options SCTP_SUPPORT允许加载 SCTP KLD 模块支持。
options KERN_TLSTLS 发送和接收卸载。
options FFS伯克利快速文件系统(FFS)。
options SOFTUPDATES启用 FFS 软更新支持。
options UFS_ACL访问控制列表支持。
options UFS_DIRHASH提升大目录的性能。
options UFS_GJOURNAL启用基于 gjournal 的 UFS 日志。
options QUOTA启用 UFS 磁盘配额。
options MD_ROOT允许 MD 设备作为根设备。
options NFSCL网络文件系统(NFS)客户端。
options NFSD网络文件系统(NFS)服务器。
options NFSLOCKD网络锁管理器(NLM)。
options NFS_ROOT将 NFS 用作 /,依赖 NFSCL。
options MSDOSFSMS-DOS 文件系统。
options CD9660ISO 9660 文件系统。
options PROCFSProc 进程文件系统(需要 PSEUDOFS 支持)。
options PSEUDOFS伪文件系统框架。
options TMPFS高效的内存文件系统。
options GEOM_RAID软件 RAID 支持。
options GEOM_LABEL提供 GEOM 标签功能。
options EFIRTEFI 运行时服务支持。
options COMPAT_FREEBSD32兼容 i386 二进制程序。
options COMPAT_FREEBSD4兼容 FreeBSD 4。
options COMPAT_FREEBSD5兼容 FreeBSD 5。
options COMPAT_FREEBSD6兼容 FreeBSD 6。
options COMPAT_FREEBSD7兼容 FreeBSD 7。
options COMPAT_FREEBSD9兼容 FreeBSD 9。
options COMPAT_FREEBSD10兼容 FreeBSD 10。
options COMPAT_FREEBSD11兼容 FreeBSD 11。
options COMPAT_FREEBSD12兼容 FreeBSD 12。
options COMPAT_FREEBSD13兼容 FreeBSD 13。
options COMPAT_FREEBSD14兼容 FreeBSD 14。
options SCSI_DELAY=5000在探测 SCSI 设备前的延迟时间(毫秒)。
options KTRACEktrace(1) 支持。
options STACKstack(9) 支持。
options SYSVSHMSYSV 风格共享内存。
options SYSVMSGSYSV 风格消息队列。
options SYSVSEMSYSV 风格信号量。
options _KPOSIX_PRIORITY_SCHEDULINGPOSIX P1003_1B 实时扩展。
options PRINTF_BUFR_SIZE=128防止 printf 输出内容交错。
options KBD_INSTALL_CDEV在 /dev 中生成字符设备(CDEV)条目。
options HWPMC_HOOKShwpmc(4) 所需的内核钩子。
options AUDIT安全事件审计。
options CAPABILITY_MODECapsicum 能力模式。
options CAPABILITIESCapsicum 能力。
options MACTrustedBSD MAC 框架。
options KDTRACE_FRAME确保内核编译时包含栈帧信息。
options KDTRACE_HOOKS内核 DTrace 钩子。
options DDB_CTF允许内核 ELF 链接器加载 CTF 数据。
options INCLUDE_CONFIG_FILE在内核中包含配置文件 INCLUDE_CONFIG_FILE。可以方便地引入更多来自其他文件的选项。
options RACCT资源核算框架。
options RACCT_DEFAULT_TO_DISABLED默认设置 kern.racct.enable=0。
options RCTL资源限制框架。
28.5.1 调试支持(始终需要)
本小节介绍始终需要的调试支持的相关选项。
options KDB启用内核调试器支持。
options KDB_TRACE打印 Panic 的栈跟踪信息。
28.5.2 内核转储功能
本小节介绍内核转储相关配置选项。
options EKCD支持加密内核转储。
options GZIO支持使用 gzip 压缩的内核转储和用户转储。
options ZSTDIO支持使用 zstd 压缩的内核转储和用户转储。
options DEBUGNETdebugnet 网络支持。
options NETDUMPnetdump(4) 客户端支持。
options NETGDBnetgdb(4) 客户端支持。
options SMP默认生成支持 SMP(对称多处理器)的内核。
device cpufreqCPU 频率控制支持。
28.5.3 总线支持
本小节介绍各类总线的支持选项。
device acpiACPI 支持。
device smbiossmbios,即 System Management BIOS。提供系统管理 BIOS(System Management BIOS)的基本支持。
options IOMMU启用 IOMMU。
device pci通用 PCI/PCIe 总线驱动。
options PCI_HPPCIe 原生热插拔支持。
options PCI_IOVPCI SR-IOV 支持。
options COMPAT_LINUXKPI启用 Linux 内核编程接口(Linux Kernel Programming Interface,KPI)兼容层。
options PPS_SYNC启用内核 PLL 支持,以使用外部 PPS 信号,并由 ntpd(8) 监控。更多信息请参见 ntpd 文档:Welcome to the home of the Network Time Protocol (NTP) Project.[EB/OL]. [2026-03-26]. http://www.eecis.udel.edu/~ntp.
device fdc软盘驱动器支持。
28.5.4 ATA 控制器
本小节介绍 ATA 控制器相关选项。
device ahci兼容 AHCI 的 SATA 控制器支持。
device ata传统 ATA/SATA 控制器支持。
device mvsMarvell 88SX50XX/88SX60XX/88SX70XX 及 SoC SATA 控制器。
device siisSilicon Image SiI3124/SiI3132/SiI3531 SATA 控制器。
28.5.5 SCSI 控制器
本小节介绍 SCSI 控制器相关选项。
device ahcAHA2940 及板载 AIC7xxx SCSI 设备。
device ahdAHA39320/29320 及板载 AIC79xx 设备。
device hptiopHighpoint RocketRaid 3xxx 系列。
device ispQLogic 系列控制器。
#device ispfwQLogic HBA 的固件,通常以模块形式加载。
device mptLSI Logic MPT-Fusion 控制器。
device mpsLSI-Logic MPT-Fusion 2。
device mprLSI-Logic MPT-Fusion 3。
device mpi3mrLSI-Logic MPT-Fusion 4。
device symNCR/Symbios Logic SCSI 控制器。
device isciIntel C600 系列 SAS 控制器。
device ocs_fcEmulex 光纤通道(Fibre Channel)适配器。
device pvscsiVMware PVSCSI。
28.5.6 ATA/SCSI 外围设备
本小节介绍 ATA/SCSI 外围设备相关选项。
device scbusSCSI 总线(ATA/SCSI 设备所必需)。
device chSCSI 介质切换器。
device da直接访问设备(如磁盘)。
device sa顺序访问设备(如磁带)。
device cd光盘。
device pass直通设备(用于直接访问 ATA/SCSI)。
device ses机箱服务(SES 和 SAF-TE 协议)。
#device ctlCAM 目标层。
28.5.7 通过 SCSI 子系统连接的 RAID 控制器
本小节介绍通过 SCSI 子系统连接的 RAID 控制器相关选项。
device arcmsrAreca SATA II RAID。
device cissCompaq Smart RAID 5 系列控制器。
device ipsIBM (Adaptec) ServeRAID。
device smartpqiMicrosemi smartpqi 驱动。
device twsLSI 3ware 9750 SATA+SAS 6Gb/s RAID 控制器。
device aacRAID 控制器,Adaptec FSA RAID 系列。
device aacpaac 的 SCSI 直通支持(需要 CAM)。
device aacraidPMC 出品的 Adaptec RAID。
device idaCompaq Smart RAID。
device mfiLSI MegaRAID SAS。
device mlxMylex DAC960 系列。
device mrsasLSI/Avago MegaRAID SAS/SATA,支持 6Gb/s 和 12Gb/s。
#device pstPromise SuperTrak SX6000 RAID 控制器。
28.5.8 NVM Express (NVMe) 支持
本小节介绍 NVM Express(NVMe)相关支持选项。
device nvme基础 NVMe 驱动。
device nvd将 NVMe 命名空间作为磁盘设备提供,依赖 nvme。
device ufshci # UFS 主机控制器通用闪存存储(Universal Flash Storage,UFS)主机控制器接口支持。
device vmdIntel 卷管理设备(VMD)支持。
device atkbdcAT 键盘控制器。atkbdc0 同时控制键盘和 PS/2 鼠标。
device atkbdAT 键盘。
device psmPS/2 鼠标。
device kbdmux键盘多路复用器。
device vgaVGA 显卡驱动。
device splash启动画面和屏幕保护支持。
device scsyscons 是传统的控制台驱动,功能上类似于 SCO 控制台。
options SC_PIXEL_MODE添加对光栅化文本模式的支持。
device vt
device vt_vga
device vt_efifb
device vt_vbefbvt 是默认的视频控制台驱动程序。
device agp支持多种 AGP 芯片组。
28.5.9 CardBus 桥
本小节介绍 CardBus 桥相关选项。
device cbbCardBus(Yenta)桥。
device cardbusCardBus(32 位)总线。
28.5.10 串口(COM 端口)
本小节介绍串口(COM 端口)相关选项。
device uart通用 UART 驱动。
28.5.11 并行端口
本小节介绍并行端口相关选项。
device ppc并行端口。
device ppbus并行端口总线(必需)。
device lpt打印机。
device ppi并行端口设备。
#device vpo需要 scbus 和 da。
device puc多路 I/O 卡和多通道 UART 支持。
device iflib使用 iflib 基础设施的 PCI/PCI-X/PCIe 以太网网卡。
device emIntel PRO/1000 系列千兆以太网网卡。
device igcIntel I225 系列 2.5GbE 以太网网卡。
device ixIntel PRO/10GbE PCIe PF 以太网。
device ixvIntel PRO/10GbE PCIe VF 以太网。
device ixlIntel 700 系列物理功能(Physical Function,PF)。
device iavfIntel 自适应虚拟功能(Adaptive Virtual Function,AVF)。
device iceIntel 800 系列物理功能(Physical Function,PF)。
device vmxVMware VMXNET3 以太网。
device axpAMD EPYC 集成网卡(需要 miibus 支持)。
28.5.12 PCI 以太网卡
本小节介绍 PCI 以太网卡相关选项。
device bxeBroadcom NetXtreme II BCM5771X/BCM578XX 10GbE。
device leAMD Am7900 LANCE 和 Am79C9xx PCnet。
device tiAlteon Networks Tigon I/II 千兆以太网。
device mlx5基础驱动。
NVIDIA/Mellanox ConnectX-4 及之后型号,仅限以太网:
- 依赖
COMPAT_LINUXKPI和 xz(1) - mlx5ib 依赖 ibcore 基础设施,默认未内置
device mlxfw用于固件更新。
device mlx5en以太网驱动程序。
device miibusMII 总线支持。适用于使用通用 MII 总线控制器代码的 PCI 以太网卡。
注意
务必保留
device miibus此行,以便使用这些网卡
device aeAttansic/Atheros L2 快速以太网。
device ageAttansic/Atheros L1 千兆以太网。
device alcAtheros AR8131/AR8132 以太网。
device aleAtheros AR8121/AR8113/AR8114 以太网。
device bceBroadcom BCM5706/BCM5708 千兆以太网。
device bfeBroadcom BCM440x 10/100 以太网。
device bgeBroadcom BCM570xx 千兆以太网。
device casSun Cassini/Cassini+ 和 NS DP83065 Saturn。
device dcDEC/Intel 21143 及各种兼容芯片。
device etAgere ET1310 10/100/千兆以太网。
device fxpIntel EtherExpress PRO/100B (82557, 82558)。
device gemSun GEM/Sun ERI/Apple GMAC。
device jmeJMicron JMC250 千兆以太网 / JMC260 快速以太网。
device lgeLevel 1 LXT1001 千兆以太网。
device mskMarvell/SysKonnect Yukon II 千兆以太网。
device nfeNVIDIA nForce MCP 板载以太网。
device ngeNatSemi DP83820 千兆以太网。
device reRealTek 8139C+/8169/8169S/8110S。
device rlRealTek 8129/8139。
device sgeSilicon Integrated Systems SiS190/191。
device sisSilicon Integrated Systems SiS 900/SiS 7016。
device skSysKonnect SK-984x & SK-982x 千兆以太网。
device steSundance ST201 (D-Link DFE-550TX)。
device stgeSundance/Tamarack TC9021 千兆以太网。
device vgeVIA VT612x 千兆以太网。
device vrVIA Rhine, Rhine II。
device xl3Com 3c90x(“Boomerang”,“Cyclone”)。
28.5.13 无线网卡
本小节介绍无线网卡相关选项。
device wlanIEEE 802.11 支持。
options IEEE80211_DEBUG启用调试信息。
options IEEE80211_SUPPORT_MESH启用 IEEE 802.11s 草案支持。
device wlan_wep802.11 WEP 支持。
device wlan_tkip802.11 TKIP 支持。
device wlan_ccmp802.11 CCMP 支持。
device wlan_gcmp802.11 GCMP 支持。
device wlan_amrrAMRR 发送速率控制算法(Adaptive Multi Rate Retry)。
device athAtheros CardBus/PCI 网卡。
device ath_halAtheros CardBus/PCI 芯片支持。
options AH_AR5416_INTERRUPT_MITIGATIONAR5416 中断缓解。
device ath_rate_sampleath 的 SampleRate 发送速率控制算法。
#device bwiBroadcom BCM430x/BCM431x 无线网卡。
#device bwnBroadcom BCM43xx 无线网卡。
device ipwIntel 2100 无线网卡。
device iwiIntel 2200BG/2225BG/2915ABG 无线网卡。
device iwnIntel 4965/1000/5000/6000 无线网卡。
device maloMarvell Libertas 无线网卡。
device mwlMarvell 88W8363 802.11n 无线网卡。
device ralRalink Technology RT2500 无线网卡。
device wpiIntel 3945ABG 无线网卡。
28.5.14 伪设备
本小节介绍伪设备相关选项。
device crypto核心加密支持。
device aesniAES-NI OpenCrypto 加速模块。
device loop网络回环接口。
device padlock_rngVIA Padlock 随机数生成器。
device rdrand_rngIntel Bull Mountain 随机数生成器。
device ether以太网支持。
device vlan802.1Q VLAN 支持。
device tuntap数据包隧道接口。
device md内存“磁盘”。
device gifIPv6 和 IPv4 隧道。
device firmware固件辅助模块。
device xzLZMA 解压支持。
device bpf # 伯克利数据包过滤器bpf 设备用于启用伯克利数据包过滤器,启用时需注意其对系统管理的影响。
注意
DHCP 依赖
bpf。
28.5.15 USB 支持
本小节介绍 USB 支持的相关选项。
options USB_DEBUG启用 USB 调试信息。
device uhciUHCI PCI 到 USB 接口。
device ohciOHCI PCI 到 USB 接口。
device ehciEHCI PCI 到 USB 接口(USB 2.0)。
device xhcixHCI PCI 到 USB 接口(USB 3.0)。
device usbUSB 总线(必需)。
device usbhidUSB HID 传输。
device hkbdHID 键盘。
device ukbdUSB 键盘。
device umass磁盘 / 大容量存储,需要 scbus 和 da。
28.5.16 音频支持
本小节介绍音频支持的相关选项。
device sound通用声卡驱动(必需)。
device snd_cmiCMedia CMI8338/CMI8738。
device snd_csaCrystal Semiconductor CS461x/428x。
device snd_emu10kxCreative SoundBlaster Live! 和 Audigy。
device snd_es137xEnsoniq AudioPCI ES137x。
device snd_hdaIntel 高保真音频。
device snd_ichIntel、NVIDIA 及其他 ICH AC’97 音频。
device snd_via8233VIA VT8233x 音频。
28.5.17 MMC/SD
本小节介绍 MMC/SD 相关选项。
device mmcMMC/SD 总线。
device mmcsdMMC/SD 存储卡。
device sdhci通用 PCI SD 主控制器。
28.5.18 VirtIO
本小节介绍 VirtIO 相关选项。
device virtio通用 VirtIO 总线(必需)。
device virtio_pciVirtIO PCI 设备。
device vtnetVirtIO 以太网设备。
device virtio_blkVirtIO 块设备。
device virtio_scsiVirtIO SCSI 设备。
device virtio_balloonVirtIO 内存气球设备。
28.5.19 Linux KVM 半虚拟化支持
本小节介绍 Linux KVM 半虚拟化支持的相关选项。
device kvm_clockKVM 半虚拟化时钟驱动。
28.5.20 Hyper-V 驱动及增强支持
本小节介绍 Hyper-V 驱动及增强支持的相关选项。
device hypervHyper-V 驱动。
28.5.21 Xen HVM 客户机优化
本小节介绍 Xen HVM 客户机优化相关选项。
options XENHVMXen HVM 内核基础设施。
注意
XENHVM 依赖 xenpci 和 xentimer。它们必须同时存在或同时不存在。
device xenefiXen EFI 定时器设备。
device xenpciXen HVM 虚拟机管理器服务驱动。
device xentimerXen x86 PV 定时器设备。
28.5.22 netmap(4) 支持
本小节介绍 netmap(4) 支持的相关选项。
device netmapNetmap 提供了对受支持网卡发送 / 接收环路的直接访问支持。
28.5.23 evdev 接口
本小节介绍 evdev 接口的相关选项。
options EVDEV_SUPPORT在传统驱动中启用 evdev 接口支持。
device evdev输入事件设备支持。
device uinput安装字符设备(CDEV)/dev/uinput。
28.5.24 HID 支持
本小节介绍 HID 支持的相关选项。
options HID_DEBUG启用调试信息输出。
device hid通用 HID 支持。
device hidbus通用 HID 总线。
options IICHID_SAMPLING用于解决缺失 GPIO 中断支持问题的变通方法。
28.5.25 EFI 设备
本小节介绍 EFI 设备相关选项。
device efidevEFI 伪设备。
device efirtcEFI 实时时钟。