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