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 # This directive is mandatory; it defines the architecture to be
12 # configured for; in this case, the 386 family based PC-98 and
19 # We want LINT to cover profiling as well.
23 #####################################################################
26 # The apic device enables the use of the I/O APIC for interrupt delivery.
27 # The apic device can be used in both UP and SMP kernels, but is required
28 # for SMP kernels. Thus, the apic device is not strictly an SMP option,
29 # but it is a prerequisite for SMP.
33 device apic # I/O apic
42 options KDB_STOP_NMI # Stop CPUS using NMI instead of IPI
46 #####################################################################
50 # You must specify at least one CPU (the one you intend to run on);
51 # deleting the specification for CPUs you don't need to use may make
52 # parts of the system run faster.
55 cpu I586_CPU # aka Pentium(tm)
56 cpu I686_CPU # aka Pentium Pro(tm)
59 # Options for CPU features.
61 # CPU_BLUELIGHTNING_3X enables triple-clock mode on IBM Blue Lightning
62 # CPU if CPU supports it. The default is double-clock mode on
63 # BlueLightning CPU box.
65 # CPU_BLUELIGHTNING_FPU_OP_CACHE enables FPU operand cache on IBM
66 # BlueLightning CPU. It works only with Cyrix FPU, and this option
67 # should not be used with Intel FPU.
69 # CPU_BTB_EN enables branch target buffer on Cyrix 5x86 (NOTE 1).
71 # CPU_CYRIX_NO_LOCK enables weak locking for the entire address space
72 # of Cyrix 6x86 and 6x86MX CPUs by setting the NO_LOCK bit of CCR1.
73 # Otherwise, the NO_LOCK bit of CCR1 is cleared. (NOTE 3)
75 # CPU_DIRECT_MAPPED_CACHE sets L1 cache of Cyrix 486DLC CPU in direct
76 # mapped mode. Default is 2-way set associative mode.
78 # CPU_DISABLE_5X86_LSSER disables load store serialize (i.e., enables
79 # reorder). This option should not be used if you use memory mapped
82 # CPU_DISABLE_CMPXCHG disables the CMPXCHG instruction on > i386 IA32
83 # machines. VmWare 3.x seems to emulate this instruction poorly, causing
84 # the guest OS to run very slowly. This problem appears to be fixed in
85 # VmWare 4.x, at least in version 4.5.2, so that enabling this option with
86 # VmWare 4.x will result in locking operations to be 20-30 times slower.
87 # Enabling this with an SMP kernel will cause the kernel to be unusable.
89 # CPU_DISABLE_SSE explicitly prevents I686_CPU from turning on SSE.
91 # CPU_FASTER_5X86_FPU enables faster FPU exception handler.
93 # CPU_I486_ON_386 enables CPU cache on i486 based CPU upgrade products
96 # CPU_IORT defines I/O clock delay time (NOTE 1). Default values of
97 # I/O clock delay time on Cyrix 5x86 and 6x86 are 0 and 7,respectively
100 # CPU_L2_LATENCY specifies the L2 cache latency value. This option is used
101 # only when CPU_PPRO2CELERON is defined and Mendocino Celeron is detected.
102 # The default value is 5.
104 # CPU_LOOP_EN prevents flushing the prefetch buffer if the destination
105 # of a jump is already present in the prefetch buffer on Cyrix 5x86(NOTE
108 # CPU_PPRO2CELERON enables L2 cache of Mendocino Celeron CPUs. This option
109 # is useful when you use Socket 8 to Socket 370 converter, because most Pentium
110 # Pro BIOSs do not enable L2 cache of Mendocino Celeron CPUs.
112 # CPU_RSTK_EN enables return stack on Cyrix 5x86 (NOTE 1).
114 # CPU_SUSP_HLT enables suspend on HALT. If this option is set, CPU
115 # enters suspend mode following execution of HALT instruction.
117 # CPU_UPGRADE_HW_CACHE eliminates unneeded cache flush instruction(s).
119 # CPU_WT_ALLOC enables write allocation on Cyrix 6x86/6x86MX and AMD
122 # CYRIX_CACHE_WORKS enables CPU cache on Cyrix 486 CPUs with cache
123 # flush at hold state.
125 # CYRIX_CACHE_REALLY_WORKS enables (1) CPU cache on Cyrix 486 CPUs
126 # without cache flush at hold state, and (2) write-back CPU cache on
127 # Cyrix 6x86 whose revision < 2.7 (NOTE 2).
129 # NO_F00F_HACK disables the hack that prevents Pentiums (and ONLY
130 # Pentiums) from locking up when a LOCK CMPXCHG8B instruction is
131 # executed. This option is only needed if I586_CPU is also defined,
132 # and should be included for any non-Pentium CPU that defines it.
134 # NO_MEMORY_HOLE is an optimisation for systems with AMD K6 processors
135 # which indicates that the 15-16MB range is *definitely* not being
136 # occupied by an ISA memory hole.
138 # NOTE 1: The options, CPU_BTB_EN, CPU_LOOP_EN, CPU_IORT,
139 # CPU_LOOP_EN and CPU_RSTK_EN should not be used because of CPU bugs.
140 # These options may crash your system.
142 # NOTE 2: If CYRIX_CACHE_REALLY_WORKS is not set, CPU cache is enabled
143 # in write-through mode when revision < 2.7. If revision of Cyrix
144 # 6x86 >= 2.7, CPU cache is always enabled in write-back mode.
146 # NOTE 3: This option may cause failures for software that requires
147 # locked cycles in order to operate correctly.
149 options CPU_BLUELIGHTNING_3X
150 options CPU_BLUELIGHTNING_FPU_OP_CACHE
152 options CPU_DIRECT_MAPPED_CACHE
153 options CPU_DISABLE_5X86_LSSER
154 options CPU_DISABLE_CMPXCHG
155 #options CPU_DISABLE_SSE
156 options CPU_FASTER_5X86_FPU
157 options CPU_I486_ON_386
159 options CPU_L2_LATENCY=5
161 options CPU_PPRO2CELERON
164 options CPU_UPGRADE_HW_CACHE
166 options CYRIX_CACHE_WORKS
167 options CYRIX_CACHE_REALLY_WORKS
168 #options NO_F00F_HACK
171 options NPX_DEBUG # enable npx debugging
174 # PERFMON causes the driver for Pentium/Pentium Pro performance counters
175 # to be compiled. See perfmon(4) for more information.
180 #####################################################################
184 # DEVICE_POLLING adds support for mixed interrupt-polling handling
185 # of network device drivers, which has significant benefits in terms
186 # of robustness to overloads and responsivity, as well as permitting
187 # accurate scheduling of the CPU time between kernel network processing
188 # and other activities. The drawback is a moderate (up to 1/HZ seconds)
189 # potential increase in response times.
190 # It is strongly recommended to use HZ=1000 or 2000 with DEVICE_POLLING
191 # to achieve smoother behaviour.
192 # Additionally, you can enable/disable polling at runtime with help of
193 # the ifconfig(8) utility, and select the CPU fraction reserved to
194 # userland with the sysctl variable kern.polling.user_frac
195 # (default 50, range 0..100).
197 # Not all device drivers support this mode of operation at the time of
198 # this writing. See polling(4) for more details.
200 options DEVICE_POLLING
203 #####################################################################
206 # The following options are used for debugging clock behavior only, and
207 # should not be used for production systems.
209 # CLK_CALIBRATION_LOOP causes clock calibration to be run in a loop at
210 # startup until the user presses a key. (The i8254 clock is always
211 # calibrated relative to the RTC (mc146818a) and this option causes the
212 # calibration to be repeated.)
213 options CLK_CALIBRATION_LOOP
215 # CLK_USE_I8254_CALIBRATION causes the calibrated frequency of the i8254
216 # clock to actually be used.
217 options CLK_USE_I8254_CALIBRATION
220 #####################################################################
221 # MISCELLANEOUS DEVICES AND OPTIONS
223 device speaker #Play IBM BASIC-style noises out your speaker
224 hint.speaker.0.at="isa"
225 hint.speaker.0.port="0x35"
226 device gzip #Exec gzipped a.out's. REQUIRES COMPAT_AOUT!
227 device apm_saver # Requires APM
230 #####################################################################
231 # HARDWARE BUS CONFIGURATION
241 # AUTO_EOI_1 enables the `automatic EOI' feature for the master 8259A
242 # interrupt controller. This saves about 0.7-1.25 usec for each interrupt.
243 # This option breaks suspend/resume on some portables.
245 # MAXMEM specifies the amount of RAM on the machine; if this is not
246 # specified, FreeBSD will first read the amount of memory from the CMOS
247 # RAM, so the amount of memory will initially be limited to 64MB or 16MB
248 # depending on the BIOS. If the BIOS reports 64MB, a memory probe will
249 # then attempt to detect the installed amount of RAM. If this probe
250 # fails to detect >64MB RAM you will have to use the MAXMEM option.
251 # The amount is in kilobytes, so for a machine with 128MB of RAM, it would
252 # be 131072 (128 * 1024).
254 # BROKEN_KEYBOARD_RESET disables the use of the keyboard controller to
255 # reset the CPU for reboot. This is needed on some systems with broken
256 # keyboard controllers.
260 options MAXMEM=(128*1024)
261 #options BROKEN_KEYBOARD_RESET
262 options EPSON_BOUNCEDMA
266 # PCI bus & PCI options:
275 #####################################################################
276 # HARDWARE DEVICE CONFIGURATION
280 hint.pckbd.0.at="isa"
281 hint.pckbd.0.port="0x041"
284 # These options are valid for other keyboard drivers as well.
285 options KBD_DISABLE_KEYMAP_LOAD # refuse to load a keymap
286 options KBD_INSTALL_CDEV # install a CDEV entry in /dev
294 # The Numeric Processing eXtension driver. This is non-optional.
299 # 0x01 don't use the npx registers to optimize bcopy.
300 # 0x02 don't use the npx registers to optimize bzero.
301 # 0x04 don't use the npx registers to optimize copyin or copyout.
302 # The npx registers are normally used to optimize copying and zeroing when
303 # all of the following conditions are satisfied:
304 # I586_CPU is an option
305 # the cpu is an i586 (perhaps not a Pentium)
306 # the probe for npx0 succeeds
307 # INT 16 exception handling works.
308 # Then copying and zeroing using the npx registers is normally 30-100% faster.
309 # The flags can be used to control cases where it doesn't work or is slower.
310 # Setting them at boot time using hints works right (the optimizations
311 # are not used until later in the bootstrap when npx0 is attached).
312 # Flag 0x08 automatically disables the i586 optimized routines.
319 # 3Dfx Voodoo Graphics, Voodoo II /dev/3dfx CDEV support. This will create
320 # the /dev/3dfx0 device to work with glide implementations. This should get
321 # linked to /dev/3dfx and /dev/voodoo. Note that this is not the same as
322 # the tdfx DRI module from XFree86 and is completely unrelated.
324 # To enable Linuxulator support, one must also include COMPAT_LINUX in the
325 # config as well, or you will not have the dependencies. The other option
326 # is to load both as modules.
328 device tdfx # Enable 3Dfx Voodoo support
329 options TDFX_LINUX # Enable Linuxulator support
331 # Direct Rendering modules for 3D acceleration.
332 device drm # DRM core module required by DRM drivers
333 device mach64drm # ATI Rage Pro, Rage Mobility P/M, Rage XL
334 device mgadrm # AGP Matrox G200, G400, G450, G550
335 device r128drm # ATI Rage 128
336 device radeondrm # ATI Radeon
337 device sisdrm # SiS 300/305, 540, 630
338 device tdfxdrm # 3dfx Voodoo 3/4/5 and Banshee
339 options DRM_DEBUG # Include debug printfs (slow)
346 hint.mse.0.port="0x7fd9"
350 # Network interfaces:
353 # ar: Arnet SYNC/570i hdlc sync 2/4 port V.35/X.21 serial driver
355 # cp: Cronyx Tau-PCI sync single/dual/four port
356 # V.35/RS-232/RS-530/RS-449/X.21/G.703/E1/E3/T3/STS-1
357 # serial adaptor (requires sppp (default), or NETGRAPH if
358 # NETGRAPH_CRONYX is configured)
359 # ed: Western Digital and SMC 80xx; Novell NE1000 and NE2000; 3Com 3C503
360 # HP PC Lan+, various PC Card devices (refer to etc/defaults/pccard.conf)
362 # ie: AT&T StarLAN 10 and EN100; 3Com 3C507; unknown NI5210;
364 # lnc: Lance/PCnet cards (Isolan, Novell NE2100, NE32-VL, AMD Am7990 and
366 # oltr: Olicom ISA token-ring adapters OC-3115, OC-3117, OC-3118 and OC-3133.
367 # Olicom PCI token-ring adapters OC-3136, OC-3137, OC-3139, OC-3140,
368 # OC-3141, OC-3540 and OC-3250.
369 # sbni: Granch SBNI12-xx ISA and PCI adapters
370 # sr: RISCom/N2 hdlc sync 1/2 port V.35/X.21 serial driver (requires sppp)
372 # Order for ISA/EISA devices is important here
377 #options ED_NO_MIIBUS # Disable ed miibus support
379 hint.ed.0.port="0x280"
381 hint.ed.0.maddr="0xd8000"
382 device ie # Hints only required for Starlan
384 hint.ie.2.port="0x300"
386 hint.ie.2.maddr="0xd0000"
389 hint.lnc.0.port="0x280"
394 hint.sbni.0.port="0x210"
395 hint.sbni.0.irq="0xefdead"
396 hint.sbni.0.flags="0"
399 hint.snc.0.port="0x888"
401 hint.snc.0.maddr="0xc0000"
406 # SCSI host adapters:
408 # ct: WD33C93[ABC] based SCSI host adapters.
409 # ncv: NCR 53C500 based SCSI host adapters.
410 # nsp: Workbit Ninja SCSI-3 based PC Card SCSI host adapters.
411 # stg: TMC 18C30, 18C50 based SCSI host adapters.
420 # SafeNet crypto driver: can be moved to the MI NOTES as soon as
421 # it's tested on a big-endian machine
423 device safe # SafeNet 1141
424 options SAFE_DEBUG # enable debugging support: hw.safe.debug
425 options SAFE_RNDTEST # enable rndtest support
427 #####################################################################
430 # Miscellaneous hardware:
432 # apm: Laptop Advanced Power Management (experimental)
433 # pmtimer: Timer device driver for power management events (APM or ACPI)
434 # cy: Cyclades serial driver
435 # digi: Digiboard driver
438 # The flags takes the following meaning for apm0:
439 # 0x0020 Statclock is broken.
442 hint.apm.0.flags="0x20"
446 options CY_PCI_FASTINTR # Use with cy_pci unless irq is shared
448 # BIOS & FEP/OS components of device digi.
458 hint.olpt.0.port="0x040"
461 hint.pmc.0.port="0x8f0"
462 device pmtimer # Adjust system timer at wakeup time
463 # sx device is i386 and pc98 only at the moment.
468 # Laptop/Notebook options:
471 # apm under `Miscellaneous hardware'
474 # For older notebooks that signal a powerfail condition (external
475 # power supply dropped, or battery state low) by issuing an NMI:
477 options POWERFAIL_NMI # make it beep instead of panicing
479 #---------------------------------------------------------------------------
482 # See /usr/share/examples/isdn/ROADMAP for an introduction to isdn4bsd.
484 # i4b passive ISDN cards support contains the following hardware drivers:
486 # isic - Siemens/Infineon ISDN ISAC/HSCX/IPAC chipset driver
487 # iwic - Winbond W6692 PCI bus ISDN S/T interface controller
488 # ifpi - AVM Fritz!Card PCI driver
489 # ifpi2 - AVM Fritz!Card PCI version 2 driver
490 # ihfc - Cologne Chip HFC ISA/ISA-PnP chipset driver
491 # ifpnp - AVM Fritz!Card PnP driver
492 # itjc - Siemens ISAC / TJNet Tiger300/320 chipset
494 # i4b active ISDN cards support contains the following hardware drivers:
496 # iavc - AVM B1 PCI, AVM B1 ISA, AVM T1
498 # Note that the ``options'' (if given) and ``device'' lines must BOTH
499 # be uncommented to enable support for a given card !
501 # In addition to a hardware driver (and probably an option) the mandatory
502 # ISDN protocol stack devices and the mandatory support device must be
503 # enabled as well as one or more devices from the optional devices section.
505 #---------------------------------------------------------------------------
506 # isic driver (Siemens/Infineon chipsets)
513 # ELSA MicroLink ISDN/PCI (same as ELSA QuickStep 1000pro PCI)
516 #---------------------------------------------------------------------------
517 # ifpnp driver for AVM Fritz!Card PnP
522 #---------------------------------------------------------------------------
523 # ihfc driver for Cologne Chip ISA chipsets (experimental!)
525 # Teles 16.3c ISA PnP
526 # AcerISDN P10 ISA PnP
527 # TELEINT ISDN SPEED No.1
530 #---------------------------------------------------------------------------
531 # ifpi driver for AVM Fritz!Card PCI
536 #---------------------------------------------------------------------------
537 # ifpi2 driver for AVM Fritz!Card PCI version 2
539 # AVM Fritz!Card PCI version 2
542 #---------------------------------------------------------------------------
543 # iwic driver for Winbond W6692 chipset
545 # ASUSCOM P-IN100-ST-D (and other Winbond W6692 based cards)
548 #---------------------------------------------------------------------------
549 # itjc driver for Siemens ISAC / TJNet Tiger300/320 chipset
551 # Traverse Technologies NETjet-S
555 #---------------------------------------------------------------------------
556 # iavc driver (AVM active cards, needs i4bcapi driver!)
560 #---------------------------------------------------------------------------
561 # ISDN Protocol Stack - mandatory for all hardware drivers
563 # Q.921 / layer 2 - i4b passive cards D channel handling
566 # Q.931 / layer 3 - i4b passive cards D channel handling
569 # layer 4 - i4b common passive and active card handling
572 #---------------------------------------------------------------------------
573 # ISDN devices - mandatory for all hardware drivers
575 # userland driver to do ISDN tracing (for passive cards only)
579 # userland driver to control the whole thing
582 #---------------------------------------------------------------------------
583 # ISDN devices - optional
585 # userland driver for access to raw B channel
589 # userland driver for telephony
593 # network driver for IP over raw HDLC ISDN
596 # enable VJ header compression detection for ipr i/f
598 # enable logging of the first n IP packets to isdnd (n=32 here)
601 # network driver for sync PPP over ISDN; requires an equivalent
602 # number of sppp device to be configured
606 # B-channel interface to the netgraph subsystem
610 # CAPI driver needed for active ISDN cards (see iavc driver above)
613 #---------------------------------------------------------------------------
616 # Set the number of PV entries per process. Increasing this can
617 # stop panics related to heavy use of shared memory. However, that can
618 # (combined with large amounts of physical memory) cause panics at
619 # boot time due the kernel running out of VM space.
621 # If you're tweaking this, you might also want to increase the sysctls
622 # "vm.v_free_min", "vm.v_free_reserved", and "vm.v_free_target".
624 # The value below is the one more than the default.
626 options PMAP_SHPGPERPROC=201
629 # Change the size of the kernel virtual address space. Due to
630 # constraints in loader(8) on i386, this must be a multiple of 4.
631 # 256 = 1 GB of kernel address space. Increasing this also causes
632 # a reduction of the address space in user processes. 512 splits
633 # the 4GB cpu address space in half (2GB user, 2GB kernel).
635 options KVA_PAGES=260
638 #####################################################################
641 # Enable iBCS2 runtime support for SCO and ISC binaries
644 # Emulate spx device for client side of SVR3 local X interface
647 # Enable Linux ABI emulation
650 # Enable i386 a.out binary support
653 # Enable the linux-like proc filesystem support (requires COMPAT_LINUX
657 #Enable the linux-like sys filesystem support (requires COMPAT_LINUX)
661 # SysVR4 ABI emulation
663 # The svr4 ABI emulator can be statically compiled into the kernel or loaded as
665 # The STREAMS network emulation code can also be compiled statically or as a
666 # module. If loaded as a module, it must be loaded before the svr4 module
667 # (the /usr/sbin/svr4 script does this for you). If compiling statically,
668 # the `streams' device must be configured into any kernel which also
669 # specifies COMPAT_SVR4. It is possible to have a statically-configured
670 # STREAMS device and a dynamically loadable svr4 emulator; the /usr/sbin/svr4
671 # script understands that it doesn't need to load the `streams' module under
672 # those circumstances.
673 # Caveat: At this time, `options KTRACE' is required for the svr4 emulator
674 # (whether static or dynamic).
676 options COMPAT_SVR4 # build emulator statically
677 options DEBUG_SVR4 # enable verbose debugging
678 device streams # STREAMS network driver (required for svr4).
681 #####################################################################
684 # Disable the 4 MByte page PSE CPU feature. The PSE feature allows the
685 # kernel to use 4 MByte pages to map the kernel instead of 4k pages.
686 # This saves on the amount of memory needed for page tables needed to
687 # map the kernel. You should only disable this feature as a temporary
688 # workaround if you are having problems with it enabled.
692 # Disable the global pages PGE CPU feature. The PGE feature allows pages
693 # to be marked with the PG_G bit. TLB entries for these pages are not
694 # flushed from the cache when %cr3 is reloaded. This can make context
695 # switches less expensive. You should only disable this feature as a
696 # temporary workaround if you are having problems with it enabled.
698 #options DISABLE_PG_G
700 # KSTACK_PAGES is the number of memory pages to assign to the kernel
701 # stack of each thread.
703 options KSTACK_PAGES=3
705 #####################################################################
707 # More undocumented options for linting.
708 # Note that documenting these are not considered an affront.
710 options FB_INSTALL_CDEV # install a CDEV entry in /dev
712 # PECOFF module (Win32 Execution Format)
713 options PECOFF_SUPPORT
716 options I4B_SMP_WORKAROUND
717 options I586_PMC_GUPROF=0x70000
718 options KBDIO_DEBUG=2
719 options KBD_MAXRETRY=4
720 options KBD_MAXWAIT=6
721 options KBD_RESETDELAY=201
723 options TIMER_FREQ=((14318182+6)/12)
726 options VM_KMEM_SIZE_MAX
727 options VM_KMEM_SIZE_SCALE
734 #####################################################################
735 # Devices we don't want to deal with
754 nodevice ida # Compaq Smart RAID
755 nodevice mlx # Mylex DAC960
756 nodevice amr # AMI MegaRAID
757 nodevice twe # 3ware ATA RAID
773 #####################################################################
774 # Options we don't want to deal with
778 nooption VGA_SLOW_IOACCESS
779 nooption VGA_ALT_SEQACCESS
780 nooption PSM_RESETAFTERSUSPEND
781 nooption PSM_HOOKRESUME
782 nooption ATKBD_DFLT_KEYMAP
784 nooption AHD_DEBUG_OPTS
785 nooption AHD_REG_PRETTY_PRINT
786 nooption ADW_ALLOW_MEMIO
787 nooption DPT_LOST_IRQ
788 nooption DPT_RESET_HBA
789 nooption DPT_TIMEOUT_FACTOR
791 nooption ACPI_MAX_THREADS
794 #####################################################################
795 # Make options we don't want to deal with
797 nomakeoption ATKBD_DFLT_KEYMAP