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.
11 # We want LINT to cover profiling as well.
15 #####################################################################
18 # The apic device enables the use of the I/O APIC for interrupt delivery.
19 # The apic device can be used in both UP and SMP kernels, but is required
20 # for SMP kernels. Thus, the apic device is not strictly an SMP option,
21 # but it is a prerequisite for SMP.
25 device apic # I/O apic
34 #####################################################################
38 # You must specify at least one CPU (the one you intend to run on);
39 # deleting the specification for CPUs you don't need to use may make
40 # parts of the system run faster.
43 cpu I586_CPU # aka Pentium(tm)
44 cpu I686_CPU # aka Pentium Pro(tm)
47 # Options for CPU features.
49 # CPU_BLUELIGHTNING_3X enables triple-clock mode on IBM Blue Lightning
50 # CPU if CPU supports it. The default is double-clock mode on
51 # BlueLightning CPU box.
53 # CPU_BLUELIGHTNING_FPU_OP_CACHE enables FPU operand cache on IBM
54 # BlueLightning CPU. It works only with Cyrix FPU, and this option
55 # should not be used with Intel FPU.
57 # CPU_BTB_EN enables branch target buffer on Cyrix 5x86 (NOTE 1).
59 # CPU_CYRIX_NO_LOCK enables weak locking for the entire address space
60 # of Cyrix 6x86 and 6x86MX CPUs by setting the NO_LOCK bit of CCR1.
61 # Otherwise, the NO_LOCK bit of CCR1 is cleared. (NOTE 3)
63 # CPU_DIRECT_MAPPED_CACHE sets L1 cache of Cyrix 486DLC CPU in direct
64 # mapped mode. Default is 2-way set associative mode.
66 # CPU_DISABLE_5X86_LSSER disables load store serialize (i.e., enables
67 # reorder). This option should not be used if you use memory mapped
70 # CPU_DISABLE_CMPXCHG disables the CMPXCHG instruction on > i386 IA32
71 # machines. VmWare 3.x seems to emulate this instruction poorly, causing
72 # the guest OS to run very slowly. This problem appears to be fixed in
73 # VmWare 4.x, at least in version 4.5.2, so that enabling this option with
74 # VmWare 4.x will result in locking operations to be 20-30 times slower.
75 # Enabling this with an SMP kernel will cause the kernel to be unusable.
77 # CPU_DISABLE_SSE explicitly prevents I686_CPU from turning on SSE.
79 # CPU_FASTER_5X86_FPU enables faster FPU exception handler.
81 # CPU_I486_ON_386 enables CPU cache on i486 based CPU upgrade products
84 # CPU_IORT defines I/O clock delay time (NOTE 1). Default values of
85 # I/O clock delay time on Cyrix 5x86 and 6x86 are 0 and 7,respectively
88 # CPU_L2_LATENCY specifies the L2 cache latency value. This option is used
89 # only when CPU_PPRO2CELERON is defined and Mendocino Celeron is detected.
90 # The default value is 5.
92 # CPU_LOOP_EN prevents flushing the prefetch buffer if the destination
93 # of a jump is already present in the prefetch buffer on Cyrix 5x86(NOTE
96 # CPU_PPRO2CELERON enables L2 cache of Mendocino Celeron CPUs. This option
97 # is useful when you use Socket 8 to Socket 370 converter, because most Pentium
98 # Pro BIOSs do not enable L2 cache of Mendocino Celeron CPUs.
100 # CPU_RSTK_EN enables return stack on Cyrix 5x86 (NOTE 1).
102 # CPU_SUSP_HLT enables suspend on HALT. If this option is set, CPU
103 # enters suspend mode following execution of HALT instruction.
105 # CPU_UPGRADE_HW_CACHE eliminates unneeded cache flush instruction(s).
107 # CPU_WT_ALLOC enables write allocation on Cyrix 6x86/6x86MX and AMD
110 # CYRIX_CACHE_WORKS enables CPU cache on Cyrix 486 CPUs with cache
111 # flush at hold state.
113 # CYRIX_CACHE_REALLY_WORKS enables (1) CPU cache on Cyrix 486 CPUs
114 # without cache flush at hold state, and (2) write-back CPU cache on
115 # Cyrix 6x86 whose revision < 2.7 (NOTE 2).
117 # NO_F00F_HACK disables the hack that prevents Pentiums (and ONLY
118 # Pentiums) from locking up when a LOCK CMPXCHG8B instruction is
119 # executed. This option is only needed if I586_CPU is also defined,
120 # and should be included for any non-Pentium CPU that defines it.
122 # NO_MEMORY_HOLE is an optimisation for systems with AMD K6 processors
123 # which indicates that the 15-16MB range is *definitely* not being
124 # occupied by an ISA memory hole.
126 # NOTE 1: The options, CPU_BTB_EN, CPU_LOOP_EN, CPU_IORT,
127 # CPU_LOOP_EN and CPU_RSTK_EN should not be used because of CPU bugs.
128 # These options may crash your system.
130 # NOTE 2: If CYRIX_CACHE_REALLY_WORKS is not set, CPU cache is enabled
131 # in write-through mode when revision < 2.7. If revision of Cyrix
132 # 6x86 >= 2.7, CPU cache is always enabled in write-back mode.
134 # NOTE 3: This option may cause failures for software that requires
135 # locked cycles in order to operate correctly.
137 options CPU_BLUELIGHTNING_3X
138 options CPU_BLUELIGHTNING_FPU_OP_CACHE
140 options CPU_DIRECT_MAPPED_CACHE
141 options CPU_DISABLE_5X86_LSSER
142 options CPU_DISABLE_CMPXCHG
143 #options CPU_DISABLE_SSE
144 options CPU_FASTER_5X86_FPU
145 options CPU_I486_ON_386
147 options CPU_L2_LATENCY=5
149 options CPU_PPRO2CELERON
152 options CPU_UPGRADE_HW_CACHE
154 options CYRIX_CACHE_WORKS
155 options CYRIX_CACHE_REALLY_WORKS
156 #options NO_F00F_HACK
159 options NPX_DEBUG # enable npx debugging
162 # PERFMON causes the driver for Pentium/Pentium Pro performance counters
163 # to be compiled. See perfmon(4) for more information.
168 #####################################################################
172 # DEVICE_POLLING adds support for mixed interrupt-polling handling
173 # of network device drivers, which has significant benefits in terms
174 # of robustness to overloads and responsivity, as well as permitting
175 # accurate scheduling of the CPU time between kernel network processing
176 # and other activities. The drawback is a moderate (up to 1/HZ seconds)
177 # potential increase in response times.
178 # It is strongly recommended to use HZ=1000 or 2000 with DEVICE_POLLING
179 # to achieve smoother behaviour.
180 # Additionally, you can enable/disable polling at runtime with help of
181 # the ifconfig(8) utility, and select the CPU fraction reserved to
182 # userland with the sysctl variable kern.polling.user_frac
183 # (default 50, range 0..100).
185 # Not all device drivers support this mode of operation at the time of
186 # this writing. See polling(4) for more details.
188 options DEVICE_POLLING
190 # BPF_JITTER adds support for BPF just-in-time compiler.
195 #####################################################################
196 # MISCELLANEOUS DEVICES AND OPTIONS
199 # sio: serial ports (see sio(4)), including support for various
200 # PC Card devices, such as Modem and NICs
204 hint.sio.0.port="0x3F8"
205 hint.sio.0.flags="0x10"
208 # `flags' specific to sio(4).
209 # 0x10 enable console support for this unit. Other console flags
210 # (if applicable) are ignored unless this is set. Enabling
211 # console support does not make the unit the preferred console.
212 # Boot with -h or set boot_serial=YES in the loader. For sio(4)
213 # specifically, the 0x20 flag can also be set (see above).
214 # Currently, at most one unit can have console support; the
215 # first one (in config file order) with this flag set is
216 # preferred. Setting this flag for sio0 gives the old behaviour.
217 # 0x20 force this unit to be the console (unless there is another
218 # higher priority console). This replaces the COMCONSOLE option.
219 # 0x40 reserve this unit for low level console operations. Do not
220 # access the device in any normal way.
221 # 0x80 use this port for serial line gdb support in ddb. Also known
224 # 0x1 disable probing of this device. Used to prevent your modem
225 # from being attached as a PnP modem.
226 # Other flags for sio that aren't documented in the man page.
227 # 0x20000 enable hardware RTS/CTS and larger FIFOs. Only works for
228 # ST16650A-compatible UARTs.
231 options COM_ESP # Code for Hayes ESP.
232 options COM_MULTIPORT # Code for some cards with shared IRQs.
233 options CONSPEED=115200 # Speed for serial console
236 device speaker #Play IBM BASIC-style noises out your speaker
237 hint.speaker.0.at="isa"
238 hint.speaker.0.port="0x35"
239 device gzip #Exec gzipped a.out's. REQUIRES COMPAT_AOUT!
240 device apm_saver # Requires APM
243 #####################################################################
244 # HARDWARE BUS CONFIGURATION
254 # AUTO_EOI_1 enables the `automatic EOI' feature for the master 8259A
255 # interrupt controller. This saves about 0.7-1.25 usec for each interrupt.
256 # This option breaks suspend/resume on some portables.
258 # MAXMEM specifies the amount of RAM on the machine; if this is not
259 # specified, FreeBSD will first read the amount of memory from the CMOS
260 # RAM, so the amount of memory will initially be limited to 64MB or 16MB
261 # depending on the BIOS. If the BIOS reports 64MB, a memory probe will
262 # then attempt to detect the installed amount of RAM. If this probe
263 # fails to detect >64MB RAM you will have to use the MAXMEM option.
264 # The amount is in kilobytes, so for a machine with 128MB of RAM, it would
265 # be 131072 (128 * 1024).
267 # BROKEN_KEYBOARD_RESET disables the use of the keyboard controller to
268 # reset the CPU for reboot. This is needed on some systems with broken
269 # keyboard controllers.
271 # EPSON_BOUNCEDMA was to use a bounce buffer to upper 15MB, but it's
274 # EPSON_MEMWIN disables 15-16MB chunk, and enables EPSON memory window.
279 options MAXMEM=(128*1024)
280 #options BROKEN_KEYBOARD_RESET
281 options EPSON_BOUNCEDMA
285 # PCI bus & PCI options:
297 #####################################################################
298 # HARDWARE DEVICE CONFIGURATION
302 hint.pckbd.0.at="isa"
303 hint.pckbd.0.port="0x041"
312 # The Numeric Processing eXtension driver. This is non-optional.
317 # 0x01 don't use the npx registers to optimize bcopy.
318 # 0x02 don't use the npx registers to optimize bzero.
319 # 0x04 don't use the npx registers to optimize copyin or copyout.
320 # The npx registers are normally used to optimize copying and zeroing when
321 # all of the following conditions are satisfied:
322 # I586_CPU is an option
323 # the cpu is an i586 (perhaps not a Pentium)
324 # the probe for npx0 succeeds
325 # INT 16 exception handling works.
326 # Then copying and zeroing using the npx registers is normally 30-100% faster.
327 # The flags can be used to control cases where it doesn't work or is slower.
328 # Setting them at boot time using hints works right (the optimizations
329 # are not used until later in the bootstrap when npx0 is attached).
330 # Flag 0x08 automatically disables the i586 optimized routines.
337 # 3Dfx Voodoo Graphics, Voodoo II /dev/3dfx CDEV support. This will create
338 # the /dev/3dfx0 device to work with glide implementations. This should get
339 # linked to /dev/3dfx and /dev/voodoo. Note that this is not the same as
340 # the tdfx DRI module from XFree86 and is completely unrelated.
342 # To enable Linuxulator support, one must also include COMPAT_LINUX in the
343 # config as well. The other option is to load both as modules.
345 device tdfx # Enable 3Dfx Voodoo support
346 device tdfx_linux # Enable Linuxulator support
348 # Direct Rendering modules for 3D acceleration.
349 device drm # DRM core module required by DRM drivers
350 device mach64drm # ATI Rage Pro, Rage Mobility P/M, Rage XL
351 device mgadrm # AGP Matrox G200, G400, G450, G550
352 device r128drm # ATI Rage 128
353 device radeondrm # ATI Radeon
354 device savagedrm # S3 Savage3D, Savage4
355 device sisdrm # SiS 300/305, 540, 630
356 device tdfxdrm # 3dfx Voodoo 3/4/5 and Banshee
357 options DRM_DEBUG # Include debug printfs (slow)
364 hint.mse.0.port="0x7fd9"
368 # Network interfaces:
371 # ce: Cronyx Tau-PCI/32 sync single/dual port G.703/E1 serial adaptor
372 # with 32 HDLC subchannels (requires sppp (default), or NETGRAPH if
373 # NETGRAPH_CRONYX is configured)
374 # cp: Cronyx Tau-PCI sync single/dual/four port
375 # V.35/RS-232/RS-530/RS-449/X.21/G.703/E1/E3/T3/STS-1
376 # serial adaptor (requires sppp (default), or NETGRAPH if
377 # NETGRAPH_CRONYX is configured)
378 # cs: IBM Etherjet and other Crystal Semi CS89x0-based adapters and pccard
379 # ed: Western Digital and SMC 80xx; Novell NE1000 and NE2000; 3Com 3C503
380 # HP PC Lan+, various PC Card devices
382 # ie: AT&T StarLAN 10 and EN100; 3Com 3C507; unknown NI5210;
384 # le: AMD Am7900 LANCE and Am79C9xx ILACC/PCnet Ethernet interface driver
385 # ral: Ralink Technology IEEE 802.11 wireless adapter
386 # sbni: Granch SBNI12-xx ISA and PCI adapters
387 # snc: National Semiconductor DP8393X SONIC Ethernet adapter driver
388 # ural: Ralink Technology RT2500USB IEEE 802.11 wireless adapter
389 # ath: Atheros a/b/g WiFi adapters (requires ath_hal and wlan)
391 # Order for ISA/EISA devices is important here
398 hint.ed.0.port="0x280"
400 hint.ed.0.maddr="0xd8000"
401 device ie # Hints only required for Starlan
403 hint.ie.2.port="0x300"
405 hint.ie.2.maddr="0xd0000"
407 # Hint for the PC98-only C-NET(98)S C-bus front-end of le(4).
409 hint.le.0.port="0x03d0"
414 hint.sbni.0.port="0x210"
415 hint.sbni.0.irq="0xefdead"
416 hint.sbni.0.flags="0"
419 hint.snc.0.port="0x888"
421 hint.snc.0.maddr="0xc0000"
424 device ath # Atheros pci/cardbus NIC's
425 device ath_hal # pci/cardbus chip support
426 #device ath_ar5210 # AR5210 chips
427 #device ath_ar5211 # AR5211 chips
428 #device ath_ar5212 # AR5212 chips
435 #device ath_ar5416 # AR5416 chips
436 options AH_SUPPORT_AR5416 # enable AR5416 tx/rx descriptors
437 device ath_rate_sample # SampleRate tx rate control for ath
440 # SCSI host adapters:
442 # ct: WD33C93[ABC] based SCSI host adapters.
443 # ncv: NCR 53C500 based SCSI host adapters.
444 # nsp: Workbit Ninja SCSI-3 based PC Card SCSI host adapters.
445 # stg: TMC 18C30, 18C50 based SCSI host adapters.
454 # SafeNet crypto driver: can be moved to the MI NOTES as soon as
455 # it's tested on a big-endian machine
457 device safe # SafeNet 1141
458 options SAFE_DEBUG # enable debugging support: hw.safe.debug
459 options SAFE_RNDTEST # enable rndtest support
461 #####################################################################
464 # Miscellaneous hardware:
466 # apm: Laptop Advanced Power Management (experimental)
467 # canbus: CanBe I/O Bus
468 # canbepm: CanBe Power Management Controller
470 # pmc: Power Management Controller of NEC PC-98Note
471 # pmtimer: Timer device driver for power management events (APM or ACPI)
472 # Adjusts system timer at wakeup time
475 # The flags takes the following meaning for apm0:
476 # 0x0020 Statclock is broken.
479 hint.apm.0.flags="0x20"
484 hint.olpt.0.port="0x040"
487 hint.pmc.0.port="0x8f0"
491 # Laptop/Notebook options:
494 # apm under `Miscellaneous hardware'
497 # For older notebooks that signal a powerfail condition (external
498 # power supply dropped, or battery state low) by issuing an NMI:
500 options POWERFAIL_NMI # make it beep instead of panicing
503 # Set the number of PV entries per process. Increasing this can
504 # stop panics related to heavy use of shared memory. However, that can
505 # (combined with large amounts of physical memory) cause panics at
506 # boot time due the kernel running out of VM space.
508 # If you're tweaking this, you might also want to increase the sysctls
509 # "vm.v_free_min", "vm.v_free_reserved", and "vm.v_free_target".
511 # The value below is the one more than the default.
513 options PMAP_SHPGPERPROC=201
516 # Change the size of the kernel virtual address space. Due to
517 # constraints in loader(8) on i386, this must be a multiple of 4.
518 # 256 = 1 GB of kernel address space. Increasing this also causes
519 # a reduction of the address space in user processes. 512 splits
520 # the 4GB cpu address space in half (2GB user, 2GB kernel).
522 options KVA_PAGES=260
525 #####################################################################
528 # Enable iBCS2 runtime support for SCO and ISC binaries
531 # Emulate spx device for client side of SVR3 local X interface
534 # Enable Linux ABI emulation
537 # Enable i386 a.out binary support
540 # Enable the linux-like proc filesystem support (requires COMPAT_LINUX
544 # Enable the linux-like sys filesystem support (requires COMPAT_LINUX
549 # SysVR4 ABI emulation
551 # The svr4 ABI emulator can be statically compiled into the kernel or loaded as
553 # The STREAMS network emulation code can also be compiled statically or as a
554 # module. If loaded as a module, it must be loaded before the svr4 module
555 # (the /usr/sbin/svr4 script does this for you). If compiling statically,
556 # the `streams' device must be configured into any kernel which also
557 # specifies COMPAT_SVR4. It is possible to have a statically-configured
558 # STREAMS device and a dynamically loadable svr4 emulator; the /usr/sbin/svr4
559 # script understands that it doesn't need to load the `streams' module under
560 # those circumstances.
561 # Caveat: At this time, `options KTRACE' is required for the svr4 emulator
562 # (whether static or dynamic).
564 options COMPAT_SVR4 # build emulator statically
565 options DEBUG_SVR4 # enable verbose debugging
566 device streams # STREAMS network driver (required for svr4).
569 #####################################################################
572 # Disable the 4 MByte page PSE CPU feature. The PSE feature allows the
573 # kernel to use 4 MByte pages to map the kernel instead of 4k pages.
574 # This saves on the amount of memory needed for page tables needed to
575 # map the kernel. You should only disable this feature as a temporary
576 # workaround if you are having problems with it enabled.
580 # Disable the global pages PGE CPU feature. The PGE feature allows pages
581 # to be marked with the PG_G bit. TLB entries for these pages are not
582 # flushed from the cache when %cr3 is reloaded. This can make context
583 # switches less expensive. You should only disable this feature as a
584 # temporary workaround if you are having problems with it enabled.
586 #options DISABLE_PG_G
588 # KSTACK_PAGES is the number of memory pages to assign to the kernel
589 # stack of each thread.
591 options KSTACK_PAGES=3
593 #####################################################################
595 # More undocumented options for linting.
596 # Note that documenting these are not considered an affront.
598 options FB_INSTALL_CDEV # install a CDEV entry in /dev
600 options I586_PMC_GUPROF=0x70000
601 options KBDIO_DEBUG=2
602 options KBD_MAXRETRY=4
603 options KBD_MAXWAIT=6
604 options KBD_RESETDELAY=201
606 options TIMER_FREQ=((14318182+6)/12)
609 options VM_KMEM_SIZE_MAX
610 options VM_KMEM_SIZE_SCALE
613 #####################################################################
614 # Devices we don't want to deal with
628 nodevice ida # Compaq Smart RAID
629 nodevice mlx # Mylex DAC960
630 nodevice amr # AMI MegaRAID
631 nodevice twe # 3ware ATA RAID
646 #####################################################################
647 # Options we don't want to deal with
650 nooption AHD_DEBUG_OPTS
651 nooption AHD_REG_PRETTY_PRINT
652 nooption ADW_ALLOW_MEMIO
653 nooption DPT_LOST_IRQ
654 nooption DPT_RESET_HBA
655 nooption DPT_TIMEOUT_FACTOR
659 #####################################################################
660 # Make options we don't want to deal with