]> CyberLeo.Net >> Repos - FreeBSD/FreeBSD.git/blob - sys/i386/conf/NOTES
Import the skein hashing algorithm, based on the threefish block cipher
[FreeBSD/FreeBSD.git] / sys / i386 / conf / NOTES
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.
12 profile         2
13
14 #
15 # Enable the kernel DTrace hooks which are required to load the DTrace
16 # kernel modules.
17 #
18 options         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 \f
37 #####################################################################
38 # SMP OPTIONS:
39 #
40 # The apic device enables the use of the I/O APIC for interrupt delivery.
41 # The apic device can be used in both UP and SMP kernels, but is required
42 # for SMP kernels.  Thus, the apic device is not strictly an SMP option,
43 # but it is a prerequisite for SMP.
44 #
45 # Notes:
46 #
47 # HTT CPUs should only be used if they are enabled in the BIOS.  For
48 # the ACPI case, ACPI only correctly tells us about any HTT CPUs if
49 # they are enabled.  However, most HTT systems do not list HTT CPUs
50 # in the MP Table if they are enabled, thus we guess at the HTT CPUs
51 # for the MP Table case.  However, we shouldn't try to guess and use
52 # these CPUs if HTT is disabled.  Thus, HTT guessing is only enabled
53 # for the MP Table if the user explicitly asks for it via the
54 # MPTABLE_FORCE_HTT option.  Do NOT use this option if you have HTT
55 # disabled in your BIOS.
56 #
57 # IPI_PREEMPTION instructs the kernel to preempt threads running on other
58 # CPUS if needed.  Relies on the PREEMPTION option
59
60 # Mandatory:
61 device          apic                    # I/O apic
62
63 # Optional:
64 options         MPTABLE_FORCE_HTT       # Enable HTT CPUs with the MP Table
65 options         IPI_PREEMPTION
66
67 #
68 # Watchdog routines.
69 #
70 options         MP_WATCHDOG
71
72 # Debugging options.
73 #
74 options         COUNT_XINVLTLB_HITS     # Counters for TLB events
75 options         COUNT_IPIS              # Per-CPU IPI interrupt counters
76
77
78 \f
79 #####################################################################
80 # CPU OPTIONS
81
82 #
83 # You must specify at least one CPU (the one you intend to run on);
84 # deleting the specification for CPUs you don't need to use may make
85 # parts of the system run faster.
86 #
87 cpu             I486_CPU
88 cpu             I586_CPU                # aka Pentium(tm)
89 cpu             I686_CPU                # aka Pentium Pro(tm)
90
91 #
92 # Options for CPU features.
93 #
94 # CPU_ATHLON_SSE_HACK tries to enable SSE instructions when the BIOS has
95 # forgotten to enable them.
96 #
97 # CPU_BLUELIGHTNING_3X enables triple-clock mode on IBM Blue Lightning
98 # CPU if CPU supports it.  The default is double-clock mode on
99 # BlueLightning CPU box.
100 #
101 # CPU_BLUELIGHTNING_FPU_OP_CACHE enables FPU operand cache on IBM
102 # BlueLightning CPU.  It works only with Cyrix FPU, and this option
103 # should not be used with Intel FPU.
104 #
105 # CPU_BTB_EN enables branch target buffer on Cyrix 5x86 (NOTE 1).
106 #
107 # CPU_CYRIX_NO_LOCK enables weak locking for the entire address space
108 # of Cyrix 6x86 and 6x86MX CPUs by setting the NO_LOCK bit of CCR1.
109 # Otherwise, the NO_LOCK bit of CCR1 is cleared.  (NOTE 3)
110 #
111 # CPU_DIRECT_MAPPED_CACHE sets L1 cache of Cyrix 486DLC CPU in direct
112 # mapped mode.  Default is 2-way set associative mode.
113 #
114 # CPU_DISABLE_5X86_LSSER disables load store serialize (i.e., enables
115 # reorder).  This option should not be used if you use memory mapped
116 # I/O device(s).
117 #
118 # CPU_DISABLE_CMPXCHG disables the CMPXCHG instruction on > i386 IA32
119 # machines.  VmWare 3.x seems to emulate this instruction poorly, causing
120 # the guest OS to run very slowly.  This problem appears to be fixed in
121 # VmWare 4.x, at least in version 4.5.2, so that enabling this option with
122 # VmWare 4.x will result in locking operations to be 20-30 times slower.
123 # Enabling this with an SMP kernel will cause the kernel to be unusable.
124 #
125 # CPU_DISABLE_SSE explicitly prevents I686_CPU from turning on SSE.
126 #
127 # CPU_ELAN enables support for AMDs ElanSC520 CPU.
128 #    CPU_ELAN_PPS enables precision timestamp code.
129 #    CPU_ELAN_XTAL sets the clock crystal frequency in Hz.
130 #
131 # CPU_ENABLE_LONGRUN enables support for Transmeta Crusoe LongRun
132 # technology which allows to restrict power consumption of the CPU by
133 # using group of hw.crusoe.* sysctls.
134 #
135 # CPU_FASTER_5X86_FPU enables faster FPU exception handler.
136 #
137 # CPU_GEODE is for the SC1100 Geode embedded processor.  This option
138 # is necessary because the i8254 timecounter is toast.
139 #
140 # CPU_I486_ON_386 enables CPU cache on i486 based CPU upgrade products
141 # for i386 machines.
142 #
143 # CPU_IORT defines I/O clock delay time (NOTE 1).  Default values of
144 # I/O clock delay time on Cyrix 5x86 and 6x86 are 0 and 7,respectively
145 # (no clock delay).
146 #
147 # CPU_L2_LATENCY specifies the L2 cache latency value.  This option is used
148 # only when CPU_PPRO2CELERON is defined and Mendocino Celeron is detected.
149 # The default value is 5.
150 #
151 # CPU_LOOP_EN prevents flushing the prefetch buffer if the destination
152 # of a jump is already present in the prefetch buffer on Cyrix 5x86(NOTE
153 # 1).
154 #
155 # CPU_PPRO2CELERON enables L2 cache of Mendocino Celeron CPUs.  This option
156 # is useful when you use Socket 8 to Socket 370 converter, because most Pentium
157 # Pro BIOSs do not enable L2 cache of Mendocino Celeron CPUs.
158 #
159 # CPU_RSTK_EN enables return stack on Cyrix 5x86 (NOTE 1).
160 #
161 # CPU_SOEKRIS enables support www.soekris.com hardware.
162 #
163 # CPU_SUSP_HLT enables suspend on HALT.  If this option is set, CPU
164 # enters suspend mode following execution of HALT instruction.
165 #
166 # CPU_UPGRADE_HW_CACHE eliminates unneeded cache flush instruction(s).
167 #
168 # CPU_WT_ALLOC enables write allocation on Cyrix 6x86/6x86MX and AMD
169 # K5/K6/K6-2 CPUs.
170 #
171 # CYRIX_CACHE_WORKS enables CPU cache on Cyrix 486 CPUs with cache
172 # flush at hold state.
173 #
174 # CYRIX_CACHE_REALLY_WORKS enables (1) CPU cache on Cyrix 486 CPUs
175 # without cache flush at hold state, and (2) write-back CPU cache on
176 # Cyrix 6x86 whose revision < 2.7 (NOTE 2).
177 #
178 # NO_F00F_HACK disables the hack that prevents Pentiums (and ONLY
179 # Pentiums) from locking up when a LOCK CMPXCHG8B instruction is
180 # executed.  This option is only needed if I586_CPU is also defined,
181 # and should be included for any non-Pentium CPU that defines it.
182 #
183 # NO_MEMORY_HOLE is an optimisation for systems with AMD K6 processors
184 # which indicates that the 15-16MB range is *definitely* not being
185 # occupied by an ISA memory hole.
186 #
187 # NOTE 1: The options, CPU_BTB_EN, CPU_LOOP_EN, CPU_IORT,
188 # CPU_LOOP_EN and CPU_RSTK_EN should not be used because of CPU bugs.
189 # These options may crash your system.
190 #
191 # NOTE 2: If CYRIX_CACHE_REALLY_WORKS is not set, CPU cache is enabled
192 # in write-through mode when revision < 2.7.  If revision of Cyrix
193 # 6x86 >= 2.7, CPU cache is always enabled in write-back mode.
194 #
195 # NOTE 3: This option may cause failures for software that requires
196 # locked cycles in order to operate correctly.
197 #
198 options         CPU_ATHLON_SSE_HACK
199 options         CPU_BLUELIGHTNING_3X
200 options         CPU_BLUELIGHTNING_FPU_OP_CACHE
201 options         CPU_BTB_EN
202 options         CPU_DIRECT_MAPPED_CACHE
203 options         CPU_DISABLE_5X86_LSSER
204 options         CPU_DISABLE_CMPXCHG
205 #options        CPU_DISABLE_SSE
206 options         CPU_ELAN
207 options         CPU_ELAN_PPS
208 options         CPU_ELAN_XTAL=32768000
209 options         CPU_ENABLE_LONGRUN
210 options         CPU_FASTER_5X86_FPU
211 options         CPU_GEODE
212 options         CPU_I486_ON_386
213 options         CPU_IORT
214 options         CPU_L2_LATENCY=5
215 options         CPU_LOOP_EN
216 options         CPU_PPRO2CELERON
217 options         CPU_RSTK_EN
218 options         CPU_SOEKRIS
219 options         CPU_SUSP_HLT
220 options         CPU_UPGRADE_HW_CACHE
221 options         CPU_WT_ALLOC
222 options         CYRIX_CACHE_WORKS
223 options         CYRIX_CACHE_REALLY_WORKS
224 #options        NO_F00F_HACK
225
226 # Debug options
227 options         NPX_DEBUG       # enable npx debugging
228
229 #
230 # PERFMON causes the driver for Pentium/Pentium Pro performance counters
231 # to be compiled.  See perfmon(4) for more information.
232 #
233 options         PERFMON
234
235 #
236 # XBOX causes the kernel to be bootable on the Microsoft XBox console system.
237 # The resulting kernel will auto-detect whether it is being booted on a XBox,
238 # so kernels compiled with this option will also work on an ordinary PC.
239 # This option require I686_CPU.
240 #
241 # xboxfb includes support for the XBox frame buffer device. It is fully USB-
242 # keyboard aware, and will only be used if an xbox is detected. This option
243 # (obviously) requires XBOX support in your kernel.
244 #
245 # NOTE: xboxfb currently conflicts with syscons(4); if you have an XBOX and
246 # include both in your kernel; you will not get any video output. Ordinary
247 # PC's do not suffer from this.
248 #
249 options         XBOX
250 device          xboxfb
251
252 \f
253 #####################################################################
254 # NETWORKING OPTIONS
255
256 #
257 # DEVICE_POLLING adds support for mixed interrupt-polling handling
258 # of network device drivers, which has significant benefits in terms
259 # of robustness to overloads and responsivity, as well as permitting
260 # accurate scheduling of the CPU time between kernel network processing
261 # and other activities.  The drawback is a moderate (up to 1/HZ seconds)
262 # potential increase in response times.
263 # It is strongly recommended to use HZ=1000 or 2000 with DEVICE_POLLING
264 # to achieve smoother behaviour.
265 # Additionally, you can enable/disable polling at runtime with help of
266 # the ifconfig(8) utility, and select the CPU fraction reserved to
267 # userland with the sysctl variable kern.polling.user_frac
268 # (default 50, range 0..100).
269 #
270 # Not all device drivers support this mode of operation at the time of
271 # this writing.  See polling(4) for more details.
272
273 options         DEVICE_POLLING
274
275 # BPF_JITTER adds support for BPF just-in-time compiler.
276
277 options         BPF_JITTER
278
279 # OpenFabrics Enterprise Distribution (Infiniband).
280 options         OFED
281 options         OFED_DEBUG_INIT
282
283 # Sockets Direct Protocol
284 options         SDP
285 options         SDP_DEBUG
286
287 # IP over Infiniband
288 options         IPOIB
289 options         IPOIB_DEBUG
290 options         IPOIB_CM
291
292 \f
293 #####################################################################
294 # CLOCK OPTIONS
295
296 # Provide read/write access to the memory in the clock chip.
297 device          nvram           # Access to rtc cmos via /dev/nvram
298
299 \f
300 #####################################################################
301 # MISCELLANEOUS DEVICES AND OPTIONS
302
303 device          speaker         #Play IBM BASIC-style noises out your speaker
304 hint.speaker.0.at="isa"
305 hint.speaker.0.port="0x61"
306 device          gzip            #Exec gzipped a.out's.  REQUIRES COMPAT_AOUT!
307 device          apm_saver       # Requires APM
308
309 \f
310 #####################################################################
311 # HARDWARE BUS CONFIGURATION
312
313 #
314 # ISA bus
315 #
316 device          isa             # Required by npx(4)
317
318 #
319 # Options for `isa':
320 #
321 # AUTO_EOI_1 enables the `automatic EOI' feature for the master 8259A
322 # interrupt controller.  This saves about 0.7-1.25 usec for each interrupt.
323 # This option breaks suspend/resume on some portables.
324 #
325 # AUTO_EOI_2 enables the `automatic EOI' feature for the slave 8259A
326 # interrupt controller.  This saves about 0.7-1.25 usec for each interrupt.
327 # Automatic EOI is documented not to work for for the slave with the
328 # original i8259A, but it works for some clones and some integrated
329 # versions.
330 #
331 # MAXMEM specifies the amount of RAM on the machine; if this is not
332 # specified, FreeBSD will first read the amount of memory from the CMOS
333 # RAM, so the amount of memory will initially be limited to 64MB or 16MB
334 # depending on the BIOS.  If the BIOS reports 64MB, a memory probe will
335 # then attempt to detect the installed amount of RAM.  If this probe
336 # fails to detect >64MB RAM you will have to use the MAXMEM option.
337 # The amount is in kilobytes, so for a machine with 128MB of RAM, it would
338 # be 131072 (128 * 1024).
339 #
340 # BROKEN_KEYBOARD_RESET disables the use of the keyboard controller to
341 # reset the CPU for reboot.  This is needed on some systems with broken
342 # keyboard controllers.
343
344 options         AUTO_EOI_1
345 #options        AUTO_EOI_2
346
347 options         MAXMEM=(128*1024)
348 #options        BROKEN_KEYBOARD_RESET
349
350 #
351 # EISA bus
352 #
353 # The EISA bus device is `eisa'.  It provides auto-detection and
354 # configuration support for all devices on the EISA bus.
355
356 device          eisa
357
358 # By default, only 10 EISA slots are probed, since the slot numbers
359 # above clash with the configuration address space of the PCI subsystem,
360 # and the EISA probe is not very smart about this.  This is sufficient
361 # for most machines, but in particular the HP NetServer LC series comes
362 # with an onboard AIC7770 dual-channel SCSI controller on EISA slot #11,
363 # thus you need to bump this figure to 12 for them.
364 options         EISA_SLOTS=12
365
366 #
367 # MCA bus:
368 #
369 # The MCA bus device is `mca'.  It provides auto-detection and
370 # configuration support for all devices on the MCA bus.
371 # No hints are required for MCA.
372
373 device          mca
374
375 #
376 # AGP GART support
377 device          agp
378
379 # AGP debugging.
380 options         AGP_DEBUG
381
382 \f
383 #####################################################################
384 # HARDWARE DEVICE CONFIGURATION
385
386 # To include support for VGA VESA video modes
387 options         VESA
388
389 # Turn on extra debugging checks and output for VESA support.
390 options         VESA_DEBUG
391
392 device          dpms            # DPMS suspend & resume via VESA BIOS
393
394 # x86 real mode BIOS emulator, required by atkbdc/dpms/vesa
395 options         X86BIOS
396
397 #
398 # The Numeric Processing eXtension driver.  This is non-optional.
399 device          npx
400 hint.npx.0.flags="0x0"
401 hint.npx.0.irq="13"
402
403 #
404 # `flags' for npx0:
405 #       0x01    don't use the npx registers to optimize bcopy.
406 #       0x02    don't use the npx registers to optimize bzero.
407 #       0x04    don't use the npx registers to optimize copyin or copyout.
408 # The npx registers are normally used to optimize copying and zeroing when
409 # all of the following conditions are satisfied:
410 #       I586_CPU is an option
411 #       the cpu is an i586 (perhaps not a Pentium)
412 #       the probe for npx0 succeeds
413 #       INT 16 exception handling works.
414 # Then copying and zeroing using the npx registers is normally 30-100% faster.
415 # The flags can be used to control cases where it doesn't work or is slower.
416 # Setting them at boot time using hints works right (the optimizations
417 # are not used until later in the bootstrap when npx0 is attached).
418 # Flag 0x08 automatically disables the i586 optimized routines.
419 #
420
421 #
422 # Optional devices:
423 #
424
425 # PS/2 mouse
426 device          psm
427 hint.psm.0.at="atkbdc"
428 hint.psm.0.irq="12"
429
430 # Options for psm:
431 options         PSM_HOOKRESUME          #hook the system resume event, useful
432                                         #for some laptops
433 options         PSM_RESETAFTERSUSPEND   #reset the device at the resume event
434
435 # The keyboard controller; it controls the keyboard and the PS/2 mouse.
436 device          atkbdc
437 hint.atkbdc.0.at="isa"
438 hint.atkbdc.0.port="0x060"
439
440 # The AT keyboard
441 device          atkbd
442 hint.atkbd.0.at="atkbdc"
443 hint.atkbd.0.irq="1"
444
445 # Options for atkbd:
446 options         ATKBD_DFLT_KEYMAP       # specify the built-in keymap
447 makeoptions     ATKBD_DFLT_KEYMAP=fr.dvorak
448
449 # `flags' for atkbd:
450 #       0x01    Force detection of keyboard, else we always assume a keyboard
451 #       0x02    Don't reset keyboard, useful for some newer ThinkPads
452 #       0x03    Force detection and avoid reset, might help with certain
453 #               dockingstations
454 #       0x04    Old-style (XT) keyboard support, useful for older ThinkPads
455
456 # Video card driver for VGA adapters.
457 device          vga
458 hint.vga.0.at="isa"
459
460 # Options for vga:
461 # Try the following option if the mouse pointer is not drawn correctly
462 # or font does not seem to be loaded properly.  May cause flicker on
463 # some systems.
464 options         VGA_ALT_SEQACCESS
465
466 # If you can dispense with some vga driver features, you may want to
467 # use the following options to save some memory.
468 #options        VGA_NO_FONT_LOADING     # don't save/load font
469 #options        VGA_NO_MODE_CHANGE      # don't change video modes
470
471 # Older video cards may require this option for proper operation.
472 options         VGA_SLOW_IOACCESS       # do byte-wide i/o's to TS and GDC regs
473
474 # The following option probably won't work with the LCD displays.
475 options         VGA_WIDTH90             # support 90 column modes
476
477 # Debugging.
478 options         VGA_DEBUG
479
480 # vt(4) drivers.
481 device          vt_vga
482
483 # Linear framebuffer driver for S3 VESA 1.2 cards. Works on top of VESA.
484 device          s3pci
485
486 # 3Dfx Voodoo Graphics, Voodoo II /dev/3dfx CDEV support.  This will create
487 # the /dev/3dfx0 device to work with glide implementations.  This should get
488 # linked to /dev/3dfx and /dev/voodoo.  Note that this is not the same as
489 # the tdfx DRI module from XFree86 and is completely unrelated.
490 #
491 # To enable Linuxulator support, one must also include COMPAT_LINUX in the
492 # config as well.  The other option is to load both as modules.
493
494 device          tdfx                    # Enable 3Dfx Voodoo support
495 device          tdfx_linux              # Enable Linuxulator support
496
497 #
498 # ACPI support using the Intel ACPI Component Architecture reference
499 # implementation.
500 #
501 # ACPI_DEBUG enables the use of the debug.acpi.level and debug.acpi.layer
502 # kernel environment variables to select initial debugging levels for the
503 # Intel ACPICA code.  (Note that the Intel code must also have USE_DEBUGGER
504 # defined when it is built).
505
506 device          acpi
507 options         ACPI_DEBUG
508 options         ACPI_DMAR
509
510 # ACPI WMI Mapping driver
511 device          acpi_wmi
512
513 # ACPI Asus Extras (LCD backlight/brightness, video output, etc.)
514 device          acpi_asus
515
516 # ACPI Fujitsu Extras (Buttons)
517 device          acpi_fujitsu
518
519 # ACPI extras driver for HP laptops
520 device          acpi_hp
521
522 # ACPI extras driver for IBM laptops
523 device          acpi_ibm
524
525 # ACPI Panasonic Extras (LCD backlight/brightness, video output, etc.)
526 device          acpi_panasonic
527
528 # ACPI Sony extra (LCD brightness)
529 device          acpi_sony
530
531 # ACPI Toshiba Extras (LCD backlight/brightness, video output, etc.)
532 device          acpi_toshiba
533
534 # ACPI Video Extensions (LCD backlight/brightness, video output, etc.)
535 device          acpi_video
536
537 # ACPI Docking Station
538 device          acpi_dock
539
540 # ACPI ASOC ATK0110 ASUSTeK AI Booster (voltage, temperature and fan sensors)
541 device          aibs
542
543 # The cpufreq(4) driver provides support for non-ACPI CPU frequency control
544 device          cpufreq
545
546 # Direct Rendering modules for 3D acceleration.
547 device          drm             # DRM core module required by DRM drivers
548 device          i915drm         # Intel i830 through i915
549 device          mach64drm       # ATI Rage Pro, Rage Mobility P/M, Rage XL
550 device          mgadrm          # AGP Matrox G200, G400, G450, G550
551 device          r128drm         # ATI Rage 128
552 device          radeondrm       # ATI Radeon
553 device          savagedrm       # S3 Savage3D, Savage4
554 device          sisdrm          # SiS 300/305, 540, 630
555 device          tdfxdrm         # 3dfx Voodoo 3/4/5 and Banshee
556 device          viadrm          # VIA
557 options         DRM_DEBUG       # Include debug printfs (slow)
558
559 #
560 # mse: Logitech and ATI InPort bus mouse ports
561
562 device          mse
563 hint.mse.0.at="isa"
564 hint.mse.0.port="0x23c"
565 hint.mse.0.irq="5"
566
567 #
568 # Network interfaces:
569 #
570
571 # bxe:  Broadcom NetXtreme II (BCM5771X/BCM578XX) PCIe 10Gb Ethernet
572 #       adapters.
573 # ce:   Cronyx Tau-PCI/32 sync single/dual port G.703/E1 serial adaptor
574 #       with 32 HDLC subchannels (requires sppp (default), or NETGRAPH if
575 #       NETGRAPH_CRONYX is configured)
576 # cp:   Cronyx Tau-PCI sync single/dual/four port
577 #       V.35/RS-232/RS-530/RS-449/X.21/G.703/E1/E3/T3/STS-1
578 #       serial adaptor (requires sppp (default), or NETGRAPH if
579 #       NETGRAPH_CRONYX is configured)
580 # cs:   IBM Etherjet and other Crystal Semi CS89x0-based adapters
581 # ctau: Cronyx Tau sync dual port V.35/RS-232/RS-530/RS-449/X.21/G.703/E1
582 #       serial adaptor (requires sppp (default), or NETGRAPH if
583 #       NETGRAPH_CRONYX is configured)
584 # ed:   Western Digital and SMC 80xx; Novell NE1000 and NE2000; 3Com 3C503
585 #       HP PC Lan+, various PC Card devices
586 #       (requires miibus)
587 # ie:   AT&T StarLAN 10 and EN100; 3Com 3C507; unknown NI5210;
588 #       Intel EtherExpress
589 # ipw:  Intel PRO/Wireless 2100 IEEE 802.11 adapter
590 # iwi:  Intel PRO/Wireless 2200BG/2225BG/2915ABG IEEE 802.11 adapters
591 #       Requires the iwi firmware module
592 # iwn:  Intel Wireless WiFi Link 1000/105/135/2000/4965/5000/6000/6050 abgn
593 #       802.11 network adapters
594 #       Requires the iwn firmware module
595 # mlx4ib: Mellanox ConnectX HCA InfiniBand
596 # mlxen: Mellanox ConnectX HCA Ethernet
597 # mthca: Mellanox HCA InfiniBand
598 # nfe:  nVidia nForce MCP on-board Ethernet Networking (BSD open source)
599 # sbni: Granch SBNI12-xx ISA and PCI adapters
600 # vmx:  VMware VMXNET3 Ethernet (BSD open source)
601 # wl:   Lucent Wavelan (ISA card only).
602 # wpi:  Intel 3945ABG Wireless LAN controller
603 #       Requires the wpi firmware module
604
605 # Order for ISA/EISA devices is important here
606
607 device          bxe             # Broadcom NetXtreme II BCM5771X/BCM578XX 10GbE
608 device          ce
609 device          cp
610 device          cs              # Crystal Semiconductor CS89x0 NIC
611 hint.cs.0.at="isa"
612 hint.cs.0.port="0x300"
613 device          ctau
614 hint.ctau.0.at="isa"
615 hint.ctau.0.port="0x240"
616 hint.ctau.0.irq="15"
617 hint.ctau.0.drq="7"
618 #options        NETGRAPH_CRONYX         # Enable NETGRAPH support for Cronyx adapter(s)
619 device          ed              # NE[12]000, SMC Ultra, 3c503, DS8390 cards
620 options         ED_3C503
621 options         ED_HPP
622 options         ED_SIC
623 hint.ed.0.at="isa"
624 hint.ed.0.port="0x280"
625 hint.ed.0.irq="5"
626 hint.ed.0.maddr="0xd8000"
627 device          ie              # EtherExpress 8/16, 3C507, StarLAN 10 etc.
628 # Hints only required for Starlan
629 hint.ie.2.at="isa"
630 hint.ie.2.port="0x300"
631 hint.ie.2.irq="5"
632 hint.ie.2.maddr="0xd0000"
633 device          ipw             # Intel 2100 wireless NICs.
634 device          iwi             # Intel 2200BG/2225BG/2915ABG wireless NICs.
635 device          iwn             # Intel 4965/1000/5000/6000 wireless NICs.
636 # Hint for the i386-only ISA front-end of le(4).
637 hint.le.0.at="isa"
638 hint.le.0.port="0x280"
639 hint.le.0.irq="10"
640 hint.le.0.drq="0"
641 device          mlx4ib          # Mellanox ConnectX HCA InfiniBand
642 device          mlxen           # Mellanox ConnectX HCA Ethernet
643 device          mthca           # Mellanox HCA InfiniBand
644 device          nfe             # nVidia nForce MCP on-board Ethernet
645 device          sbni
646 hint.sbni.0.at="isa"
647 hint.sbni.0.port="0x210"
648 hint.sbni.0.irq="0xefdead"
649 hint.sbni.0.flags="0"
650 device          vmx             # VMware VMXNET3 Ethernet
651 device          wl
652 hint.wl.0.at="isa"
653 hint.wl.0.port="0x300"
654 options         WLCACHE         # enables the signal-strength cache
655 options         WLDEBUG         # enables verbose debugging output
656 device          wpi             # Intel 3945ABG wireless NICs.
657
658 # IEEE 802.11 adapter firmware modules
659
660 # Intel PRO/Wireless 2100 firmware:
661 #   ipwfw:              BSS/IBSS/monitor mode firmware
662 #   ipwbssfw:           BSS mode firmware
663 #   ipwibssfw:          IBSS mode firmware
664 #   ipwmonitorfw:       Monitor mode firmware
665 # Intel PRO/Wireless 2200BG/2225BG/2915ABG firmware:
666 #   iwifw:              BSS/IBSS/monitor mode firmware
667 #   iwibssfw:           BSS mode firmware
668 #   iwiibssfw:          IBSS mode firmware
669 #   iwimonitorfw:       Monitor mode firmware
670 # Intel Wireless WiFi Link 4965/1000/5000/6000 series firmware:
671 #   iwnfw:              Single module to support all devices
672 #   iwn1000fw:          Specific module for the 1000 only
673 #   iwn105fw:           Specific module for the 105 only
674 #   iwn135fw:           Specific module for the 135 only
675 #   iwn2000fw:          Specific module for the 2000 only
676 #   iwn2030fw:          Specific module for the 2030 only
677 #   iwn4965fw:          Specific module for the 4965 only
678 #   iwn5000fw:          Specific module for the 5000 only
679 #   iwn5150fw:          Specific module for the 5150 only
680 #   iwn6000fw:          Specific module for the 6000 only
681 #   iwn6000g2afw:       Specific module for the 6000g2a only
682 #   iwn6000g2bfw:       Specific module for the 6000g2b only
683 #   iwn6050fw:          Specific module for the 6050 only
684 # wpifw:        Intel 3945ABG Wireless LAN Controller firmware
685
686 device          iwifw
687 device          iwibssfw
688 device          iwiibssfw
689 device          iwimonitorfw
690 device          ipwfw
691 device          ipwbssfw
692 device          ipwibssfw
693 device          ipwmonitorfw
694 device          iwnfw
695 device          iwn1000fw
696 device          iwn105fw
697 device          iwn135fw
698 device          iwn2000fw
699 device          iwn2030fw
700 device          iwn4965fw
701 device          iwn5000fw
702 device          iwn5150fw
703 device          iwn6000fw
704 device          iwn6000g2afw
705 device          iwn6000g2bfw
706 device          iwn6050fw
707 device          wpifw
708
709 #
710 # ATA raid adapters
711 #
712 device          pst
713
714 #
715 # Areca 11xx and 12xx series of SATA II RAID controllers.
716 # CAM is required.
717 #
718 device          arcmsr          # Areca SATA II RAID
719
720 #
721 # 3ware 9000 series PATA/SATA RAID controller driver and options.
722 # The driver is implemented as a SIM, and so, needs the CAM infrastructure.
723 #
724 options         TWA_DEBUG               # 0-10; 10 prints the most messages.
725 options         TWA_FLASH_FIRMWARE      # firmware image bundled when defined.
726 device          twa                     # 3ware 9000 series PATA/SATA RAID
727
728 #
729 # SCSI host adapters:
730 #
731 # ncv: NCR 53C500 based SCSI host adapters.
732 # nsp: Workbit Ninja SCSI-3 based PC Card SCSI host adapters.
733 # stg: TMC 18C30, 18C50 based SCSI host adapters.
734
735 device          ncv
736 device          nsp
737 device          stg
738 hint.stg.0.at="isa"
739 hint.stg.0.port="0x140"
740 hint.stg.0.port="11"
741
742 #
743 # Adaptec FSA RAID controllers, including integrated DELL controllers,
744 # the Dell PERC 2/QC and the HP NetRAID-4M
745 device          aac
746 device          aacp    # SCSI Passthrough interface (optional, CAM required)
747
748 #
749 # Adaptec by PMC RAID controllers, Series 6/7/8 and upcoming families
750 device          aacraid         # Container interface, CAM required
751
752 #
753 # Highpoint RocketRAID 27xx.
754 device          hpt27xx
755
756 #
757 # Highpoint RocketRAID 182x.
758 device          hptmv
759
760 #
761 # Highpoint DC7280 and R750.
762 device          hptnr
763
764 #
765 # Highpoint RocketRAID.  Supports RR172x, RR222x, RR2240, RR232x, RR2340,
766 # RR2210, RR174x, RR2522, RR231x, RR230x.
767 device          hptrr
768
769 #
770 # Highpoint RocketRaid 3xxx series SATA RAID
771 device          hptiop
772
773 #
774 # IBM (now Adaptec) ServeRAID controllers
775 device          ips
776
777 #
778 # Intel C600 (Patsburg) integrated SAS controller
779 device          isci
780 options         ISCI_LOGGING    # enable debugging in isci HAL
781
782 #
783 # NVM Express (NVMe) support
784 device         nvme    # base NVMe driver
785 device         nvd     # expose NVMe namespaces as disks, depends on nvme
786
787 #
788 # PMC-Sierra SAS/SATA controller
789 device          pmspcv
790 #
791 # SafeNet crypto driver: can be moved to the MI NOTES as soon as
792 # it's tested on a big-endian machine
793 #
794 device          safe            # SafeNet 1141
795 options         SAFE_DEBUG      # enable debugging support: hw.safe.debug
796 options         SAFE_RNDTEST    # enable rndtest support
797
798 #
799 # glxiic is an I2C driver for the AMD Geode LX CS5536 System Management Bus
800 # controller.  Requires 'device iicbus'.
801 #
802 device          glxiic          # AMD Geode LX CS5536 System Management Bus
803
804 #
805 # glxsb is a driver for the Security Block in AMD Geode LX processors.
806 # Requires 'device crypto'.
807 #
808 device          glxsb           # AMD Geode LX Security Block
809
810 #
811 # VirtIO support
812 #
813 # The virtio entry provides a generic bus for use by the device drivers.
814 # It must be combined with an interface that communicates with the host.
815 # Multiple such interfaces defined by the VirtIO specification. FreeBSD
816 # only has support for PCI. Therefore, virtio_pci must be statically
817 # compiled in or loaded as a module for the device drivers to function.
818 #
819 device          virtio          # Generic VirtIO bus (required)
820 device          virtio_pci      # VirtIO PCI Interface
821 device          vtnet           # VirtIO Ethernet device
822 device          virtio_blk      # VirtIO Block device
823 device          virtio_scsi     # VirtIO SCSI device
824 device          virtio_balloon  # VirtIO Memory Balloon device
825 device          virtio_random   # VirtIO Entropy device
826 device          virtio_console  # VirtIO Console device
827
828 device          hyperv          # HyperV drivers
829
830 #####################################################################
831
832 #
833 # Miscellaneous hardware:
834 #
835 # apm: Laptop Advanced Power Management (experimental)
836 # ipmi: Intelligent Platform Management Interface
837 # smapi: System Management Application Program Interface driver
838 # smbios: DMI/SMBIOS entry point
839 # vpd: Vital Product Data kernel interface
840 # pmtimer: Adjust system timer at wakeup time
841 # pbio: Parallel (8255 PPI) basic I/O (mode 0) port (e.g. Advantech PCL-724)
842 # spic: Sony Programmable I/O controller (VAIO notebooks)
843 # asmc: Apple System Management Controller
844 # si: Specialix International SI/XIO or SX intelligent serial card driver
845 # tpm: Trusted Platform Module
846
847 # Notes on APM
848 #  The flags takes the following meaning for apm0:
849 #    0x0020  Statclock is broken.
850
851 # Notes on the Specialix SI/XIO driver:
852 #  The host card is memory, not IO mapped.
853 #  The Rev 1 host cards use a 64K chunk, on a 32K boundary.
854 #  The Rev 2 host cards use a 32K chunk, on a 32K boundary.
855 #  The cards can use an IRQ of 11, 12 or 15.
856
857 # Notes on the Sony Programmable I/O controller
858 #  This is a temporary driver that should someday be replaced by something
859 #  that hooks into the ACPI layer.  The device is hooked to the PIIX4's
860 #  General Device 10 decoder, which means you have to fiddle with PCI
861 #  registers to map it in, even though it is otherwise treated here as
862 #  an ISA device.  At the moment, the driver polls, although the device
863 #  is capable of generating interrupts.  It largely undocumented.
864 #  The port location in the hint is where you WANT the device to be
865 #  mapped.  0x10a0 seems to be traditional.  At the moment the jogdial
866 #  is the only thing truly supported, but apparently a fair percentage
867 #  of the Vaio extra features are controlled by this device.
868
869 device          apm
870 hint.apm.0.flags="0x20"
871 device          ipmi
872 device          smapi
873 device          smbios
874 device          vpd
875 device          pmtimer
876 device          pbio
877 hint.pbio.0.at="isa"
878 hint.pbio.0.port="0x360"
879 device          spic
880 hint.spic.0.at="isa"
881 hint.spic.0.port="0x10a0"
882 device          asmc
883 device          si
884 device          tpm
885 device          padlock_rng     # VIA Padlock RNG
886 device          rdrand_rng      # Intel Bull Mountain RNG
887 device          aesni           # AES-NI OpenCrypto module
888
889 #
890 # Laptop/Notebook options:
891 #
892 # See also:
893 #  apm under `Miscellaneous hardware'
894 # above.
895
896 # For older notebooks that signal a powerfail condition (external
897 # power supply dropped, or battery state low) by issuing an NMI:
898
899 options         POWERFAIL_NMI   # make it beep instead of panicing
900
901 #
902 # I2C Bus
903 #
904 # Philips i2c bus support is provided by the `iicbus' device.
905 #
906 # Supported interfaces:
907 # pcf   Philips PCF8584 ISA-bus controller
908 #
909 device          pcf
910 hint.pcf.0.at="isa"
911 hint.pcf.0.port="0x320"
912 hint.pcf.0.irq="5"
913
914 #
915 # Hardware watchdog timers:
916 #
917 # ichwd: Intel ICH watchdog timer
918 # amdsbwd: AMD SB7xx watchdog timer
919 # viawd: VIA south bridge watchdog timer
920 # wbwd: Winbond watchdog timer
921 #
922 device          ichwd
923 device          amdsbwd
924 device          viawd
925 device          wbwd
926
927 #
928 # Temperature sensors:
929 #
930 # coretemp: on-die sensor on Intel Core and newer CPUs
931 # amdtemp: on-die sensor on AMD K8/K10/K11 CPUs
932 #
933 device          coretemp
934 device          amdtemp
935
936 #
937 # CPU control pseudo-device. Provides access to MSRs, CPUID info and
938 # microcode update feature.
939 #
940 device          cpuctl
941
942 #
943 # System Management Bus (SMB)
944 #
945 options         ENABLE_ALART            # Control alarm on Intel intpm driver
946
947 #
948 # Set the number of PV entries per process.  Increasing this can
949 # stop panics related to heavy use of shared memory.  However, that can
950 # (combined with large amounts of physical memory) cause panics at
951 # boot time due the kernel running out of VM space.
952 #
953 # If you're tweaking this, you might also want to increase the sysctls
954 # "vm.v_free_min", "vm.v_free_reserved", and "vm.v_free_target".
955 #
956 # The value below is the one more than the default.
957 #
958 options         PMAP_SHPGPERPROC=201
959
960 #
961 # Change the size of the kernel virtual address space.  Due to
962 # constraints in loader(8) on i386, this must be a multiple of 4.
963 # 256 = 1 GB of kernel address space.  Increasing this also causes
964 # a reduction of the address space in user processes.  512 splits
965 # the 4GB cpu address space in half (2GB user, 2GB kernel).  For PAE
966 # kernels, the value will need to be double non-PAE.  A value of 1024
967 # for PAE kernels is necessary to split the address space in half.
968 # This will likely need to be increased to handle memory sizes >4GB.
969 # PAE kernels default to a value of 512.
970 #
971 options         KVA_PAGES=260
972
973 #
974 # Number of initial kernel page table pages used for early bootstrap.
975 # This number should include enough pages to map the kernel, any
976 # modules or other data loaded with the kernel by the loader, and data
977 # structures allocated before the VM system is initialized such as the
978 # vm_page_t array.  Each page table page maps 4MB (2MB with PAE).
979 #
980 options         NKPT=31
981
982 \f
983 #####################################################################
984 # ABI Emulation
985
986 # Enable iBCS2 runtime support for SCO and ISC binaries
987 #options        IBCS2
988
989 # Emulate spx device for client side of SVR3 local X interface
990 options         SPX_HACK
991
992 # Enable Linux ABI emulation
993 options         COMPAT_LINUX
994
995 # Enable i386 a.out binary support
996 options         COMPAT_AOUT
997
998 # Enable the linux-like proc filesystem support (requires COMPAT_LINUX
999 # and PSEUDOFS)
1000 options         LINPROCFS
1001
1002 #Enable the linux-like sys filesystem support (requires COMPAT_LINUX
1003 # and PSEUDOFS)
1004 options         LINSYSFS
1005
1006 #
1007 # SysVR4 ABI emulation
1008 #
1009 # The svr4 ABI emulator can be statically compiled into the kernel or loaded as
1010 # a KLD module.
1011 # The STREAMS network emulation code can also be compiled statically or as a
1012 # module.  If loaded as a module, it must be loaded before the svr4 module
1013 # (the /usr/sbin/svr4 script does this for you).  If compiling statically,
1014 # the `streams' device must be configured into any kernel which also
1015 # specifies COMPAT_SVR4.  It is possible to have a statically-configured
1016 # STREAMS device and a dynamically loadable svr4 emulator;  the /usr/sbin/svr4
1017 # script understands that it doesn't need to load the `streams' module under
1018 # those circumstances.
1019 # Caveat:  At this time, `options KTRACE' is required for the svr4 emulator
1020 # (whether static or dynamic).
1021 #
1022 options         COMPAT_SVR4     # build emulator statically
1023 options         DEBUG_SVR4      # enable verbose debugging
1024 device          streams         # STREAMS network driver (required for svr4).
1025
1026 # Enable NDIS binary driver support
1027 options         NDISAPI
1028 device          ndis
1029
1030 \f
1031 #####################################################################
1032 # VM OPTIONS
1033
1034 # Disable the 4 MByte page PSE CPU feature.  The PSE feature allows the
1035 # kernel to use 4 MByte pages to map the kernel instead of 4k pages.
1036 # This saves on the amount of memory needed for page tables needed to
1037 # map the kernel.  You should only disable this feature as a temporary
1038 # workaround if you are having problems with it enabled.
1039 #
1040 #options        DISABLE_PSE
1041
1042 # Disable the global pages PGE CPU feature.  The PGE feature allows pages
1043 # to be marked with the PG_G bit.  TLB entries for these pages are not
1044 # flushed from the cache when %cr3 is reloaded.  This can make context
1045 # switches less expensive.  You should only disable this feature as a
1046 # temporary workaround if you are having problems with it enabled.
1047 #
1048 #options        DISABLE_PG_G
1049
1050 # KSTACK_PAGES is the number of memory pages to assign to the kernel
1051 # stack of each thread.
1052
1053 options         KSTACK_PAGES=3
1054
1055 # Enable detailed accounting by the PV entry allocator.
1056
1057 options         PV_STATS
1058
1059 #####################################################################
1060
1061 # More undocumented options for linting.
1062 # Note that documenting these are not considered an affront.
1063
1064 options         FB_INSTALL_CDEV         # install a CDEV entry in /dev
1065
1066 options         I586_PMC_GUPROF=0x70000
1067 options         KBDIO_DEBUG=2
1068 options         KBD_MAXRETRY=4
1069 options         KBD_MAXWAIT=6
1070 options         KBD_RESETDELAY=201
1071
1072 options         PSM_DEBUG=1
1073
1074 options         TIMER_FREQ=((14318182+6)/12)
1075
1076 options         VM_KMEM_SIZE
1077 options         VM_KMEM_SIZE_MAX
1078 options         VM_KMEM_SIZE_SCALE
1079
1080 \f