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