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