2 # NOTES -- Lines that can be cut/pasted into kernel and hints configs.
4 # This file contains machine dependent kernel configuration notes. For
5 # machine independent notes, look in /sys/conf/NOTES.
10 # Enable the kernel DTrace hooks which are required to load the DTrace
16 # NOTE: introduces CDDL-licensed components into the kernel
20 #device dtrace_profile
23 #device dtrace_systrace
24 #device dtrace_prototype
28 # Alternatively include all the DTrace modules
32 #####################################################################
37 # IPI_PREEMPTION instructs the kernel to preempt threads running on other
38 # CPUS if needed. Relies on the PREEMPTION option
41 options IPI_PREEMPTION
42 device atpic # Optional legacy pic support
43 device mptable # Optional MPSPEC mptable support
47 options COUNT_XINVLTLB_HITS # Counters for TLB events
48 options COUNT_IPIS # Per-CPU IPI interrupt counters
52 #####################################################################
56 # You must specify at least one CPU (the one you intend to run on);
57 # deleting the specification for CPUs you don't need to use may make
58 # parts of the system run faster.
60 cpu HAMMER # aka K8, aka Opteron & Athlon64
63 # Options for CPU features.
67 #####################################################################
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).
84 # Not all device drivers support this mode of operation at the time of
85 # this writing. See polling(4) for more details.
87 options DEVICE_POLLING
89 # BPF_JITTER adds support for BPF just-in-time compiler.
94 #####################################################################
97 # Provide read/write access to the memory in the clock chip.
98 device nvram # Access to rtc cmos via /dev/nvram
101 #####################################################################
102 # MISCELLANEOUS DEVICES AND OPTIONS
104 device speaker #Play IBM BASIC-style noises out your speaker
105 envvar hint.speaker.0.at="isa"
106 envvar hint.speaker.0.port="0x61"
109 #####################################################################
110 # HARDWARE BUS CONFIGURATION
120 # AUTO_EOI_1 enables the `automatic EOI' feature for the master 8259A
121 # interrupt controller. This saves about 0.7-1.25 usec for each interrupt.
122 # This option breaks suspend/resume on some portables.
124 # AUTO_EOI_2 enables the `automatic EOI' feature for the slave 8259A
125 # interrupt controller. This saves about 0.7-1.25 usec for each interrupt.
126 # Automatic EOI is documented not to work for the slave with the
127 # original i8259A, but it works for some clones and some integrated
130 # MAXMEM specifies the amount of RAM on the machine; if this is not
131 # specified, FreeBSD will first read the amount of memory from the CMOS
132 # RAM, so the amount of memory will initially be limited to 64MB or 16MB
133 # depending on the BIOS. If the BIOS reports 64MB, a memory probe will
134 # then attempt to detect the installed amount of RAM. If this probe
135 # fails to detect >64MB RAM you will have to use the MAXMEM option.
136 # The amount is in kilobytes, so for a machine with 128MB of RAM, it would
137 # be 131072 (128 * 1024).
139 # BROKEN_KEYBOARD_RESET disables the use of the keyboard controller to
140 # reset the CPU for reboot. This is needed on some systems with broken
141 # keyboard controllers.
146 options MAXMEM=(128*1024)
147 #options BROKEN_KEYBOARD_RESET
159 #####################################################################
160 # HARDWARE DEVICE CONFIGURATION
162 # To include support for VGA VESA video modes
165 # Turn on extra debugging checks and output for VESA support.
168 device dpms # DPMS suspend & resume via VESA BIOS
170 # x86 real mode BIOS emulator, required by atkbdc/dpms/vesa
179 envvar hint.psm.0.at="atkbdc"
180 envvar hint.psm.0.irq="12"
183 options PSM_HOOKRESUME #hook the system resume event, useful
185 options PSM_RESETAFTERSUSPEND #reset the device at the resume event
187 # The keyboard controller; it controls the keyboard and the PS/2 mouse.
189 envvar hint.atkbdc.0.at="isa"
190 envvar hint.atkbdc.0.port="0x060"
194 envvar hint.atkbd.0.at="atkbdc"
195 envvar hint.atkbd.0.irq="1"
198 options ATKBD_DFLT_KEYMAP # specify the built-in keymap
199 makeoptions ATKBD_DFLT_KEYMAP=fr.dvorak
202 # 0x01 Force detection of keyboard, else we always assume a keyboard
203 # 0x02 Don't reset keyboard, useful for some newer ThinkPads
204 # 0x03 Force detection and avoid reset, might help with certain
206 # 0x04 Old-style (XT) keyboard support, useful for older ThinkPads
208 # Video card driver for VGA adapters.
210 envvar hint.vga.0.at="isa"
213 # Try the following option if the mouse pointer is not drawn correctly
214 # or font does not seem to be loaded properly. May cause flicker on
216 options VGA_ALT_SEQACCESS
218 # If you can dispense with some vga driver features, you may want to
219 # use the following options to save some memory.
220 #options VGA_NO_FONT_LOADING # don't save/load font
221 #options VGA_NO_MODE_CHANGE # don't change video modes
223 # Older video cards may require this option for proper operation.
224 options VGA_SLOW_IOACCESS # do byte-wide i/o's to TS and GDC regs
226 # The following option probably won't work with the LCD displays.
227 options VGA_WIDTH90 # support 90 column modes
234 device vt_efifb # EFI framebuffer
235 device vt_vbefb # VBE framebuffer
237 # Linear framebuffer driver for S3 VESA 1.2 cards. Works on top of VESA.
240 # 3Dfx Voodoo Graphics, Voodoo II /dev/3dfx CDEV support. This will create
241 # the /dev/3dfx0 device to work with glide implementations. This should get
242 # linked to /dev/3dfx and /dev/voodoo. Note that this is not the same as
243 # the tdfx DRI module from XFree86 and is completely unrelated.
246 device tdfx # Enable 3Dfx Voodoo support
249 # ACPI support using the Intel ACPI Component Architecture reference
252 # ACPI_DEBUG enables the use of the debug.acpi.level and debug.acpi.layer
253 # kernel environment variables to select initial debugging levels for the
254 # Intel ACPICA code. (Note that the Intel code must also have USE_DEBUGGER
255 # defined when it is built).
260 # The cpufreq(4) driver provides support for non-ACPI CPU frequency control
264 # Network interfaces:
267 # axp: AMD EPYC integrated NIC
268 # Requires the miibus module
269 # bxe: Broadcom NetXtreme II (BCM5771X/BCM578XX) PCIe 10Gb Ethernet
271 # ice: Intel 800 Series Physical Function
272 # Requires the ice_ddp module for full functionality
273 # igc: Intel I225 2.5Gb Ethernet adapter
274 # ipw: Intel PRO/Wireless 2100 IEEE 802.11 adapter
275 # Requires the ipw firmware module
276 # irdma: Intel 800 Series RDMA driver
277 # Requires the ice module
278 # iwi: Intel PRO/Wireless 2200BG/2225BG/2915ABG IEEE 802.11 adapters
279 # Requires the iwi firmware module
280 # iwn: Intel Wireless WiFi Link 1000/105/135/2000/4965/5000/6000/6050 abgn
281 # 802.11 network adapters
282 # Requires the iwn firmware module
283 # mthca: Mellanox HCA InfiniBand
284 # mlx4ib: Mellanox ConnectX HCA InfiniBand
285 # mlx4en: Mellanox ConnectX HCA Ethernet
286 # nfe: nVidia nForce MCP on-board Ethernet Networking (BSD open source)
287 # qlxgb: QLogic 3200 and 8200 series 10 Gigabit Ethernet & CNA Adapter
288 # qlxgbe: QLogic 8300 series 10 Gigabit Ethernet & CNA Adapter
289 # qlxge: QLogic 8100 series 10 Gigabit Ethernet & CNA Adapter
290 # qlnxe: Cavium QLogic 41000/45000 series 10/25/40/100 Gigabit Ethernet & CNA Adapter
291 # sfxge: Solarflare SFC9000 family 10Gb Ethernet adapters
292 # vmx: VMware VMXNET3 Ethernet (BSD open source)
293 # wpi: Intel 3945ABG Wireless LAN controller
294 # Requires the wpi firmware module
296 device axp # AMD EPYC integrated NIC
297 device bxe # Broadcom NetXtreme II BCM5771X/BCM578XX 10GbE
298 device igc # Intel I225 2.5G Ethernet
299 device ipw # Intel 2100 wireless NICs.
300 device iwi # Intel 2200BG/2225BG/2915ABG wireless NICs.
301 device iwn # Intel 4965/1000/5000/6000 wireless NICs.
302 device ixl # Intel 700 Series Physical Function
303 device iavf # Intel Adaptive Virtual Function
304 device ice # Intel 800 Series Physical Function
305 device ice_ddp # Intel 800 Series DDP Package
306 device irdma # Intel 800 Series RDMA driver
307 device mthca # Mellanox HCA InfiniBand
308 device mlx4 # Shared code module between IB and Ethernet
309 device mlx4ib # Mellanox ConnectX HCA InfiniBand
310 device mlx4en # Mellanox ConnectX HCA Ethernet
311 device nfe # nVidia nForce MCP on-board Ethernet
312 device qlxgb # QLogic 3200/8200 Ethernet
313 device qlxgbe # QLogic 8300 Ethernet
314 device qlxge # QLogic 8100 Ethernet
315 device qlnxe # QLogic 41000/45000 Ethernet
316 device sfxge # Solarflare SFC9000 10Gb Ethernet
317 device vmx # VMware VMXNET3 Ethernet
318 device wpi # Intel 3945ABG wireless NICs.
320 # IEEE 802.11 adapter firmware modules
322 # Intel PRO/Wireless 2100 firmware:
323 # ipwfw: BSS/IBSS/monitor mode firmware
324 # ipwbssfw: BSS mode firmware
325 # ipwibssfw: IBSS mode firmware
326 # ipwmonitorfw: Monitor mode firmware
327 # Intel PRO/Wireless 2200BG/2225BG/2915ABG firmware:
328 # iwifw: BSS/IBSS/monitor mode firmware
329 # iwibssfw: BSS mode firmware
330 # iwiibssfw: IBSS mode firmware
331 # iwimonitorfw: Monitor mode firmware
332 # Intel Wireless WiFi Link 4965/1000/5000/6000 series firmware:
333 # iwnfw: Single module to support all devices
334 # iwn1000fw: Specific module for the 1000 only
335 # iwn105fw: Specific module for the 105 only
336 # iwn135fw: Specific module for the 135 only
337 # iwn2000fw: Specific module for the 2000 only
338 # iwn2030fw: Specific module for the 2030 only
339 # iwn4965fw: Specific module for the 4965 only
340 # iwn5000fw: Specific module for the 5000 only
341 # iwn5150fw: Specific module for the 5150 only
342 # iwn6000fw: Specific module for the 6000 only
343 # iwn6000g2afw: Specific module for the 6000g2a only
344 # iwn6000g2bfw: Specific module for the 6000g2b only
345 # iwn6050fw: Specific module for the 6050 only
346 # wpifw: Intel 3945ABG Wireless LAN Controller firmware
372 # Non-Transparent Bridge (NTB) drivers
374 device if_ntb # Virtual NTB network interface
375 device ntb_transport # NTB packet transport driver
376 device ntb # NTB hardware interface
377 device ntb_hw_amd # AMD NTB hardware driver
378 device ntb_hw_intel # Intel NTB hardware driver
379 device ntb_hw_plx # PLX NTB hardware driver
382 #XXX this stores pointers in a 32bit field that is defined by the hardware
386 # Areca 11xx and 12xx series of SATA II RAID controllers.
389 device arcmsr # Areca SATA II RAID
392 # Microsemi smartpqi controllers.
393 # These controllers have a SCSI-like interface, and require the
394 # CAM infrastructure.
399 # Adaptec FSA RAID controllers, including integrated DELL controllers,
400 # the Dell PERC 2/QC and the HP NetRAID-4M
402 device aacp # SCSI Passthrough interface (optional, CAM required)
405 # Highpoint RocketRAID 27xx.
409 # Highpoint RocketRAID 182x.
413 # Highpoint DC7280 and R750.
417 # Highpoint RocketRAID. Supports RR172x, RR222x, RR2240, RR232x, RR2340,
418 # RR2210, RR174x, RR2522, RR231x, RR230x.
422 # Highpoint RocketRaid 3xxx series SATA RAID
426 # IBM (now Adaptec) ServeRAID controllers
430 # Intel integrated Memory Controller (iMC) SMBus controller
431 # Sandybridge-Xeon, Ivybridge-Xeon, Haswell-Xeon, Broadwell-Xeon
435 # Intel C600 (Patsburg) integrated SAS controller
437 options ISCI_LOGGING # enable debugging in isci HAL
440 # Intel Volume Management Device (VMD) support
444 # PMC-Sierra SAS/SATA controller
448 # Intel QuickAssist driver with OpenCrypto support
450 # Only for legacy Atom C2XXX chipsets.
453 # Linux KVM paravirtualization support
454 device kvm_clock # KVM paravirtual clock driver
457 device gve # Google Virtual NIC (gVNIC) driver
459 # Microsoft Hyper-V enhancement support
460 device hyperv # HyperV drivers
461 device hvhid # HyperV HID device
463 # Xen HVM Guest Optimizations
464 options XENHVM # Xen HVM kernel infrastructure
465 device xenefi # Xen EFI timer device
466 device xenpci # Xen HVM Hypervisor services driver
467 device xentimer # Xen x86 PV timer device
469 #####################################################################
472 # Miscellaneous hardware:
474 # ipmi: Intelligent Platform Management Interface
475 # pbio: Parallel (8255 PPI) basic I/O (mode 0) port (e.g. Advantech PCL-724)
476 # smbios: DMI/SMBIOS entry point (requires EFIRT option)
477 # vpd: Vital Product Data kernel interface
478 # asmc: Apple System Management Controller
479 # si: Specialix International SI/XIO or SX intelligent serial card
480 # tpm: Trusted Platform Module
482 # Notes on the Specialix SI/XIO driver:
483 # The host card is memory, not IO mapped.
484 # The Rev 1 host cards use a 64K chunk, on a 32K boundary.
485 # The Rev 2 host cards use a 32K chunk, on a 32K boundary.
486 # The cards can use an IRQ of 11, 12 or 15.
490 envvar hint.pbio.0.at="isa"
491 envvar hint.pbio.0.port="0x360"
496 device padlock_rng # VIA Padlock RNG
497 device rdrand_rng # Intel Bull Mountain RNG
498 device aesni # AES-NI OpenCrypto module
499 device ossl # OpenSSL OpenCrypto module
500 device ioat # Intel I/OAT DMA engine
503 # Laptop/Notebook options:
513 # Hardware watchdog timers:
515 # ichwd: Intel ICH watchdog timer
516 # amdsbwd: AMD SB7xx watchdog timer
517 # viawd: VIA south bridge watchdog timer
518 # wbwd: Winbond watchdog timer
519 # itwd: ITE Super I/O watchdog timer
528 # Temperature sensors:
530 # coretemp: on-die sensor on Intel Core and newer CPUs
531 # amdtemp: on-die sensor on AMD K8/K10/K11 CPUs
537 # CPU control pseudo-device. Provides access to MSRs, CPUID info and
538 # microcode update feature.
548 # System Management Bus (SMB)
550 options ENABLE_ALART # Control alarm on Intel intpm driver
553 # AMD System Management Network (SMN)
558 # Number of initial kernel page table pages used for early bootstrap.
559 # This number should include enough pages to map the kernel and any
560 # modules or other data loaded with the kernel by the loader. Each
561 # page table page maps 2MB.
565 # EFI Runtime Services support
575 # HID-over-I2C support
577 device iichid # HID-over-I2C support
578 options IICHID_DEBUG # Enable HID-over-I2C debug messages
579 options IICHID_SAMPLING # Workaround missing GPIO INTR support
581 #####################################################################
584 # Enable 32-bit runtime support for FreeBSD/i386 binaries.
585 options COMPAT_FREEBSD32
587 # Enable (32-bit) a.out binary support
590 #####################################################################
593 # NB: This depends on crypto, cryptodev and ZSTDIO
596 #####################################################################
599 # KSTACK_PAGES is the number of memory pages to assign to the kernel
600 # stack of each thread.
602 options KSTACK_PAGES=5
604 # Enable detailed accounting by the PV entry allocator.
608 #####################################################################
610 # More undocumented options for linting.
611 # Note that documenting these are not considered an affront.
613 options KBDIO_DEBUG=2
614 options KBD_MAXRETRY=4
615 options KBD_MAXWAIT=6
616 options KBD_RESETDELAY=201
620 options TIMER_FREQ=((14318182+6)/12)
623 options VM_KMEM_SIZE_MAX
624 options VM_KMEM_SIZE_SCALE
626 # GCOV (code coverage) support