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 # sbni: Granch SBNI12-xx ISA and PCI adapters
386 # snc: National Semiconductor DP8393X SONIC Ethernet adapter driver
388 # Order for ISA/EISA devices is important here
395 hint.ed.0.port="0x280"
397 hint.ed.0.maddr="0xd8000"
398 device ie # Hints only required for Starlan
400 hint.ie.2.port="0x300"
402 hint.ie.2.maddr="0xd0000"
404 # Hint for the PC98-only C-NET(98)S C-bus front-end of le(4).
406 hint.le.0.port="0x03d0"
410 hint.sbni.0.port="0x210"
411 hint.sbni.0.irq="0xefdead"
412 hint.sbni.0.flags="0"
415 hint.snc.0.port="0x888"
417 hint.snc.0.maddr="0xc0000"
420 # SCSI host adapters:
422 # ct: WD33C93[ABC] based SCSI host adapters.
423 # ncv: NCR 53C500 based SCSI host adapters.
424 # nsp: Workbit Ninja SCSI-3 based PC Card SCSI host adapters.
425 # stg: TMC 18C30, 18C50 based SCSI host adapters.
434 # SafeNet crypto driver: can be moved to the MI NOTES as soon as
435 # it's tested on a big-endian machine
437 device safe # SafeNet 1141
438 options SAFE_DEBUG # enable debugging support: hw.safe.debug
439 options SAFE_RNDTEST # enable rndtest support
441 #####################################################################
444 # Miscellaneous hardware:
446 # apm: Laptop Advanced Power Management (experimental)
447 # canbus: CanBe I/O Bus
448 # canbepm: CanBe Power Management Controller
450 # pmc: Power Management Controller of NEC PC-98Note
451 # pmtimer: Timer device driver for power management events (APM or ACPI)
452 # Adjusts system timer at wakeup time
455 # The flags takes the following meaning for apm0:
456 # 0x0020 Statclock is broken.
459 hint.apm.0.flags="0x20"
464 hint.olpt.0.port="0x040"
467 hint.pmc.0.port="0x8f0"
471 # Laptop/Notebook options:
474 # apm under `Miscellaneous hardware'
477 # For older notebooks that signal a powerfail condition (external
478 # power supply dropped, or battery state low) by issuing an NMI:
480 options POWERFAIL_NMI # make it beep instead of panicing
483 # Set the number of PV entries per process. Increasing this can
484 # stop panics related to heavy use of shared memory. However, that can
485 # (combined with large amounts of physical memory) cause panics at
486 # boot time due the kernel running out of VM space.
488 # If you're tweaking this, you might also want to increase the sysctls
489 # "vm.v_free_min", "vm.v_free_reserved", and "vm.v_free_target".
491 # The value below is the one more than the default.
493 options PMAP_SHPGPERPROC=201
496 # Change the size of the kernel virtual address space. Due to
497 # constraints in loader(8) on i386, this must be a multiple of 4.
498 # 256 = 1 GB of kernel address space. Increasing this also causes
499 # a reduction of the address space in user processes. 512 splits
500 # the 4GB cpu address space in half (2GB user, 2GB kernel).
502 options KVA_PAGES=260
505 #####################################################################
508 # Enable iBCS2 runtime support for SCO and ISC binaries
511 # Emulate spx device for client side of SVR3 local X interface
514 # Enable Linux ABI emulation
517 # Enable i386 a.out binary support
520 # Enable the linux-like proc filesystem support (requires COMPAT_LINUX
524 # Enable the linux-like sys filesystem support (requires COMPAT_LINUX
529 # SysVR4 ABI emulation
531 # The svr4 ABI emulator can be statically compiled into the kernel or loaded as
533 # The STREAMS network emulation code can also be compiled statically or as a
534 # module. If loaded as a module, it must be loaded before the svr4 module
535 # (the /usr/sbin/svr4 script does this for you). If compiling statically,
536 # the `streams' device must be configured into any kernel which also
537 # specifies COMPAT_SVR4. It is possible to have a statically-configured
538 # STREAMS device and a dynamically loadable svr4 emulator; the /usr/sbin/svr4
539 # script understands that it doesn't need to load the `streams' module under
540 # those circumstances.
541 # Caveat: At this time, `options KTRACE' is required for the svr4 emulator
542 # (whether static or dynamic).
544 options COMPAT_SVR4 # build emulator statically
545 options DEBUG_SVR4 # enable verbose debugging
546 device streams # STREAMS network driver (required for svr4).
548 # Linux-specific pseudo devices support
552 #####################################################################
555 # Disable the 4 MByte page PSE CPU feature. The PSE feature allows the
556 # kernel to use 4 MByte pages to map the kernel instead of 4k pages.
557 # This saves on the amount of memory needed for page tables needed to
558 # map the kernel. You should only disable this feature as a temporary
559 # workaround if you are having problems with it enabled.
563 # Disable the global pages PGE CPU feature. The PGE feature allows pages
564 # to be marked with the PG_G bit. TLB entries for these pages are not
565 # flushed from the cache when %cr3 is reloaded. This can make context
566 # switches less expensive. You should only disable this feature as a
567 # temporary workaround if you are having problems with it enabled.
569 #options DISABLE_PG_G
571 # KSTACK_PAGES is the number of memory pages to assign to the kernel
572 # stack of each thread.
574 options KSTACK_PAGES=3
576 #####################################################################
578 # More undocumented options for linting.
579 # Note that documenting these are not considered an affront.
581 options FB_INSTALL_CDEV # install a CDEV entry in /dev
583 options I586_PMC_GUPROF=0x70000
584 options KBDIO_DEBUG=2
585 options KBD_MAXRETRY=4
586 options KBD_MAXWAIT=6
587 options KBD_RESETDELAY=201
589 options TIMER_FREQ=((14318182+6)/12)
592 options VM_KMEM_SIZE_MAX
593 options VM_KMEM_SIZE_SCALE
596 #####################################################################
597 # Devices we don't want to deal with
611 nodevice ida # Compaq Smart RAID
612 nodevice mlx # Mylex DAC960
613 nodevice amr # AMI MegaRAID
614 nodevice twe # 3ware ATA RAID
628 #####################################################################
629 # Options we don't want to deal with
632 nooption AHD_DEBUG_OPTS
633 nooption AHD_REG_PRETTY_PRINT
634 nooption ADW_ALLOW_MEMIO
635 nooption DPT_LOST_IRQ
636 nooption DPT_RESET_HBA
637 nooption DPT_TIMEOUT_FACTOR
641 #####################################################################
642 # Make options we don't want to deal with