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. 12profile 2 13 14 15##################################################################### 16# SMP OPTIONS: 17# 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. 22# 23 24# Mandatory: 25device apic # I/O apic 26 27# 28# Watchdog routines. 29# 30options MP_WATCHDOG 31 32 33 34##################################################################### 35# CPU OPTIONS 36 37# 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. 41# 42cpu I486_CPU 43cpu I586_CPU # aka Pentium(tm) 44cpu I686_CPU # aka Pentium Pro(tm) 45 46# 47# Options for CPU features. 48# 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. 52# 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. 56# 57# CPU_BTB_EN enables branch target buffer on Cyrix 5x86 (NOTE 1). 58# 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) 62# 63# CPU_DIRECT_MAPPED_CACHE sets L1 cache of Cyrix 486DLC CPU in direct 64# mapped mode. Default is 2-way set associative mode. 65# 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 68# I/O device(s). 69# 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. 76# 77# CPU_DISABLE_SSE explicitly prevents I686_CPU from turning on SSE. 78# 79# CPU_FASTER_5X86_FPU enables faster FPU exception handler. 80# 81# CPU_I486_ON_386 enables CPU cache on i486 based CPU upgrade products 82# for i386 machines. 83# 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 86# (no clock delay). 87# 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. 91# 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 94# 1). 95# 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. 99# 100# CPU_RSTK_EN enables return stack on Cyrix 5x86 (NOTE 1). 101# 102# CPU_SUSP_HLT enables suspend on HALT. If this option is set, CPU 103# enters suspend mode following execution of HALT instruction. 104# 105# CPU_UPGRADE_HW_CACHE eliminates unneeded cache flush instruction(s). 106# 107# CPU_WT_ALLOC enables write allocation on Cyrix 6x86/6x86MX and AMD 108# K5/K6/K6-2 CPUs. 109# 110# CYRIX_CACHE_WORKS enables CPU cache on Cyrix 486 CPUs with cache 111# flush at hold state. 112# 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). 116# 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. 121# 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. 125# 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. 129# 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. 133# 134# NOTE 3: This option may cause failures for software that requires 135# locked cycles in order to operate correctly. 136# 137options CPU_BLUELIGHTNING_3X 138options CPU_BLUELIGHTNING_FPU_OP_CACHE 139options CPU_BTB_EN 140options CPU_DIRECT_MAPPED_CACHE 141options CPU_DISABLE_5X86_LSSER 142options CPU_DISABLE_CMPXCHG 143#options CPU_DISABLE_SSE 144options CPU_FASTER_5X86_FPU 145options CPU_I486_ON_386 146options CPU_IORT 147options CPU_L2_LATENCY=5 148options CPU_LOOP_EN 149options CPU_PPRO2CELERON 150options CPU_RSTK_EN 151options CPU_SUSP_HLT 152options CPU_UPGRADE_HW_CACHE 153options CPU_WT_ALLOC 154options CYRIX_CACHE_WORKS 155options CYRIX_CACHE_REALLY_WORKS 156#options NO_F00F_HACK 157 158# Debug options 159options NPX_DEBUG # enable npx debugging 160 161# 162# PERFMON causes the driver for Pentium/Pentium Pro performance counters 163# to be compiled. See perfmon(4) for more information. 164# 165options PERFMON 166 167 168##################################################################### 169# NETWORKING OPTIONS 170 171# 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). 184# 185# Not all device drivers support this mode of operation at the time of 186# this writing. See polling(4) for more details. 187 188options DEVICE_POLLING 189 190# BPF_JITTER adds support for BPF just-in-time compiler. 191 192options BPF_JITTER 193 194 195##################################################################### 196# MISCELLANEOUS DEVICES AND OPTIONS 197 198# 199# sio: serial ports (see sio(4)), including support for various 200# PC Card devices, such as Modem and NICs 201# 202#device sio 203hint.sio.0.at="isa" 204hint.sio.0.port="0x3F8" 205hint.sio.0.flags="0x10" 206hint.sio.0.irq="4" 207 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 222# as debug port. 223# PnP `flags' 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. 229 230# Options for sio: 231options COM_ESP # Code for Hayes ESP. 232options COM_MULTIPORT # Code for some cards with shared IRQs. 233options CONSPEED=115200 # Speed for serial console 234 # (default 9600). 235 236device speaker #Play IBM BASIC-style noises out your speaker 237hint.speaker.0.at="isa" 238hint.speaker.0.port="0x35" 239device gzip #Exec gzipped a.out's. REQUIRES COMPAT_AOUT! 240device apm_saver # Requires APM 241 242 243##################################################################### 244# HARDWARE BUS CONFIGURATION 245 246# 247# ISA bus 248# 249device isa 250 251# 252# Options for `isa': 253# 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. 257# 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). 266# 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. 270# 271# EPSON_BOUNCEDMA was to use a bounce buffer to upper 15MB, but it's 272# broken now. 273# 274# EPSON_MEMWIN disables 15-16MB chunk, and enables EPSON memory window. 275# 276 277options AUTO_EOI_1 278 279options MAXMEM=(128*1024) 280#options BROKEN_KEYBOARD_RESET 281options EPSON_BOUNCEDMA 282options EPSON_MEMWIN 283 284# 285# PCI bus & PCI options: 286# 287device pci 288 289# 290# AGP GART support 291device agp 292 293# AGP debugging. 294options AGP_DEBUG 295 296 297##################################################################### 298# HARDWARE DEVICE CONFIGURATION 299 300# PC98 keyboard 301device pckbd 302hint.pckbd.0.at="isa" 303hint.pckbd.0.port="0x041" 304hint.pckbd.0.irq="1" 305 306# GDC screen 307device gdc 308hint.gdc.0.at="isa" 309options LINE30 310 311# 312# The Numeric Processing eXtension driver. This is non-optional. 313device npx 314 315# 316# `flags' for npx0: 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. 331# 332 333# 334# Optional devices: 335# 336 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. 341# 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. 344 345device tdfx # Enable 3Dfx Voodoo support 346device tdfx_linux # Enable Linuxulator support 347 348# Direct Rendering modules for 3D acceleration. 349device drm # DRM core module required by DRM drivers 350device mach64drm # ATI Rage Pro, Rage Mobility P/M, Rage XL 351device mgadrm # AGP Matrox G200, G400, G450, G550 352device r128drm # ATI Rage 128 353device radeondrm # ATI Radeon 354device savagedrm # S3 Savage3D, Savage4 355device sisdrm # SiS 300/305, 540, 630 356device tdfxdrm # 3dfx Voodoo 3/4/5 and Banshee 357options DRM_DEBUG # Include debug printfs (slow) 358 359# 360# Bus mouse 361# 362device mse 363hint.mse.0.at="isa" 364hint.mse.0.port="0x7fd9" 365hint.mse.0.irq="13" 366 367# 368# Network interfaces: 369# 370 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 381# (requires miibus) 382# ie: AT&T StarLAN 10 and EN100; 3Com 3C507; unknown NI5210; 383# Intel EtherExpress 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 387 388# Order for ISA/EISA devices is important here 389 390device ce 391device cp 392device cs 393device ed 394hint.ed.0.at="isa" 395hint.ed.0.port="0x280" 396hint.ed.0.irq="5" 397hint.ed.0.maddr="0xd8000" 398device ie # Hints only required for Starlan 399hint.ie.2.at="isa" 400hint.ie.2.port="0x300" 401hint.ie.2.irq="5" 402hint.ie.2.maddr="0xd0000" 403#device le 404# Hint for the PC98-only C-NET(98)S C-bus front-end of le(4). 405hint.le.0.at="isa" 406hint.le.0.port="0x03d0" 407hint.le.0.irq="6" 408device sbni 409hint.sbni.0.at="isa" 410hint.sbni.0.port="0x210" 411hint.sbni.0.irq="0xefdead" 412hint.sbni.0.flags="0" 413device snc 414hint.snc.0.at="isa" 415hint.snc.0.port="0x888" 416hint.snc.0.irq="6" 417hint.snc.0.maddr="0xc0000" 418 419# 420# SCSI host adapters: 421# 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. 426 427device ct 428hint.ct.0.at="isa" 429device ncv 430device nsp 431device stg 432 433# 434# SafeNet crypto driver: can be moved to the MI NOTES as soon as 435# it's tested on a big-endian machine 436# 437device safe # SafeNet 1141 438options SAFE_DEBUG # enable debugging support: hw.safe.debug 439options SAFE_RNDTEST # enable rndtest support 440 441##################################################################### 442 443# 444# Miscellaneous hardware: 445# 446# apm: Laptop Advanced Power Management (experimental) 447# canbus: CanBe I/O Bus 448# canbepm: CanBe Power Management Controller 449# olpt: XXX 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 453# 454# Notes on APM 455# The flags takes the following meaning for apm0: 456# 0x0020 Statclock is broken. 457 458device apm 459hint.apm.0.flags="0x20" 460device canbus 461device canbepm 462device olpt 463hint.olpt.0.at="isa" 464hint.olpt.0.port="0x040" 465device pmc 466hint.pmc.0.at="isa" 467hint.pmc.0.port="0x8f0" 468device pmtimer 469 470# 471# Laptop/Notebook options: 472# 473# See also: 474# apm under `Miscellaneous hardware' 475# above. 476 477# For older notebooks that signal a powerfail condition (external 478# power supply dropped, or battery state low) by issuing an NMI: 479 480options POWERFAIL_NMI # make it beep instead of panicing 481 482# 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. 487# 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". 490# 491# The value below is the one more than the default. 492# 493options PMAP_SHPGPERPROC=201 494 495# 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). 501# 502options KVA_PAGES=260 503 504 505##################################################################### 506# ABI Emulation 507 508# Enable iBCS2 runtime support for SCO and ISC binaries 509options IBCS2 510 511# Emulate spx device for client side of SVR3 local X interface 512options SPX_HACK 513 514# Enable Linux ABI emulation 515options COMPAT_LINUX 516 517# Enable i386 a.out binary support 518options COMPAT_AOUT 519 520# Enable the linux-like proc filesystem support (requires COMPAT_LINUX 521# and PSEUDOFS) 522options LINPROCFS 523 524# Enable the linux-like sys filesystem support (requires COMPAT_LINUX 525# and PSEUDOFS) 526options LINSYSFS 527 528# 529# SysVR4 ABI emulation 530# 531# The svr4 ABI emulator can be statically compiled into the kernel or loaded as 532# a KLD module. 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). 543# 544options COMPAT_SVR4 # build emulator statically 545options DEBUG_SVR4 # enable verbose debugging 546device streams # STREAMS network driver (required for svr4). 547 548# Linux-specific pseudo devices support 549device lindev 550 551 552##################################################################### 553# VM OPTIONS 554 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. 560# 561#options DISABLE_PSE 562 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. 568# 569#options DISABLE_PG_G 570 571# KSTACK_PAGES is the number of memory pages to assign to the kernel 572# stack of each thread. 573 574options KSTACK_PAGES=3 575 576##################################################################### 577 578# More undocumented options for linting. 579# Note that documenting these are not considered an affront. 580 581options FB_INSTALL_CDEV # install a CDEV entry in /dev 582 583options I586_PMC_GUPROF=0x70000 584options KBDIO_DEBUG=2 585options KBD_MAXRETRY=4 586options KBD_MAXWAIT=6 587options KBD_RESETDELAY=201 588 589options TIMER_FREQ=((14318182+6)/12) 590 591options VM_KMEM_SIZE 592options VM_KMEM_SIZE_MAX 593options VM_KMEM_SIZE_SCALE 594 595 596##################################################################### 597# Devices we don't want to deal with 598 599nodevice bt 600nodevice adw 601nodevice aha 602nodevice ahb 603nodevice ahd 604nodevice mpt 605nodevice trm 606nodevice wds 607nodevice dpt 608nodevice ciss 609nodevice iir 610nodevice mly 611nodevice ida # Compaq Smart RAID 612nodevice mlx # Mylex DAC960 613nodevice amr # AMI MegaRAID 614nodevice twe # 3ware ATA RAID 615nodevice ataraid 616nodevice cm 617nodevice ex 618nodevice fea 619nodevice intpm 620nodevice alpm 621nodevice ichsmb 622nodevice viapm 623nodevice amdpm 624nodevice amdsmb 625nodevice nfpm 626nodevice nfsmb 627 628 629##################################################################### 630# Options we don't want to deal with 631 632nooption AHD_DEBUG 633nooption AHD_DEBUG_OPTS 634nooption AHD_REG_PRETTY_PRINT 635nooption ADW_ALLOW_MEMIO 636nooption DPT_LOST_IRQ 637nooption DPT_RESET_HBA 638nooption DPT_TIMEOUT_FACTOR 639nooption AAC_DEBUG 640 641 642##################################################################### 643# Make options we don't want to deal with 644