NOTES revision 188257
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: head/sys/pc98/conf/NOTES 188257 2009-02-07 00:15:30Z wkoszek $ 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# Debugging options. 33# 34options STOP_NMI # Stop CPUS using NMI instead of IPI 35 36 37 38##################################################################### 39# CPU OPTIONS 40 41# 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. 45# 46cpu I486_CPU 47cpu I586_CPU # aka Pentium(tm) 48cpu I686_CPU # aka Pentium Pro(tm) 49 50# 51# Options for CPU features. 52# 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. 56# 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. 60# 61# CPU_BTB_EN enables branch target buffer on Cyrix 5x86 (NOTE 1). 62# 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) 66# 67# CPU_DIRECT_MAPPED_CACHE sets L1 cache of Cyrix 486DLC CPU in direct 68# mapped mode. Default is 2-way set associative mode. 69# 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 72# I/O device(s). 73# 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. 80# 81# CPU_DISABLE_SSE explicitly prevents I686_CPU from turning on SSE. 82# 83# CPU_FASTER_5X86_FPU enables faster FPU exception handler. 84# 85# CPU_I486_ON_386 enables CPU cache on i486 based CPU upgrade products 86# for i386 machines. 87# 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 90# (no clock delay). 91# 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. 95# 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 98# 1). 99# 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. 103# 104# CPU_RSTK_EN enables return stack on Cyrix 5x86 (NOTE 1). 105# 106# CPU_SUSP_HLT enables suspend on HALT. If this option is set, CPU 107# enters suspend mode following execution of HALT instruction. 108# 109# CPU_UPGRADE_HW_CACHE eliminates unneeded cache flush instruction(s). 110# 111# CPU_WT_ALLOC enables write allocation on Cyrix 6x86/6x86MX and AMD 112# K5/K6/K6-2 CPUs. 113# 114# CYRIX_CACHE_WORKS enables CPU cache on Cyrix 486 CPUs with cache 115# flush at hold state. 116# 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). 120# 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. 125# 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. 129# 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. 133# 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. 137# 138# NOTE 3: This option may cause failures for software that requires 139# locked cycles in order to operate correctly. 140# 141options CPU_BLUELIGHTNING_3X 142options CPU_BLUELIGHTNING_FPU_OP_CACHE 143options CPU_BTB_EN 144options CPU_DIRECT_MAPPED_CACHE 145options CPU_DISABLE_5X86_LSSER 146options CPU_DISABLE_CMPXCHG 147#options CPU_DISABLE_SSE 148options CPU_FASTER_5X86_FPU 149options CPU_I486_ON_386 150options CPU_IORT 151options CPU_L2_LATENCY=5 152options CPU_LOOP_EN 153options CPU_PPRO2CELERON 154options CPU_RSTK_EN 155options CPU_SUSP_HLT 156options CPU_UPGRADE_HW_CACHE 157options CPU_WT_ALLOC 158options CYRIX_CACHE_WORKS 159options CYRIX_CACHE_REALLY_WORKS 160#options NO_F00F_HACK 161 162# Debug options 163options NPX_DEBUG # enable npx debugging 164 165# 166# PERFMON causes the driver for Pentium/Pentium Pro performance counters 167# to be compiled. See perfmon(4) for more information. 168# 169options PERFMON 170 171 172##################################################################### 173# NETWORKING OPTIONS 174 175# 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). 188# 189# Not all device drivers support this mode of operation at the time of 190# this writing. See polling(4) for more details. 191 192options DEVICE_POLLING 193 194# BPF_JITTER adds support for BPF just-in-time compiler. 195 196options BPF_JITTER 197 198 199##################################################################### 200# MISCELLANEOUS DEVICES AND OPTIONS 201 202# 203# sio: serial ports (see sio(4)), including support for various 204# PC Card devices, such as Modem and NICs 205# 206#device sio 207hint.sio.0.at="isa" 208hint.sio.0.port="0x3F8" 209hint.sio.0.flags="0x10" 210hint.sio.0.irq="4" 211 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 226# as debug port. 227# PnP `flags' 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. 233 234# Options for sio: 235options COM_ESP # Code for Hayes ESP. 236options COM_MULTIPORT # Code for some cards with shared IRQs. 237options CONSPEED=115200 # Speed for serial console 238 # (default 9600). 239 240device speaker #Play IBM BASIC-style noises out your speaker 241hint.speaker.0.at="isa" 242hint.speaker.0.port="0x35" 243device gzip #Exec gzipped a.out's. REQUIRES COMPAT_AOUT! 244device apm_saver # Requires APM 245 246 247##################################################################### 248# HARDWARE BUS CONFIGURATION 249 250# 251# ISA bus 252# 253device isa 254 255# 256# Options for `isa': 257# 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. 261# 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). 270# 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. 274# 275# EPSON_BOUNCEDMA: XXX 276# EPSON_MEMWIN: XXX 277 278options AUTO_EOI_1 279 280options MAXMEM=(128*1024) 281#options BROKEN_KEYBOARD_RESET 282options EPSON_BOUNCEDMA 283options EPSON_MEMWIN 284 285# 286# PCI bus & PCI options: 287# 288device pci 289 290# 291# AGP GART support 292device agp 293 294# AGP debugging. 295options AGP_DEBUG 296 297 298##################################################################### 299# HARDWARE DEVICE CONFIGURATION 300 301# PC98 keyboard 302device pckbd 303hint.pckbd.0.at="isa" 304hint.pckbd.0.port="0x041" 305hint.pckbd.0.irq="1" 306 307# GDC screen 308device gdc 309hint.gdc.0.at="isa" 310options LINE30 311 312# 313# The Numeric Processing eXtension driver. This is non-optional. 314device npx 315 316# 317# `flags' for npx0: 318# 0x01 don't use the npx registers to optimize bcopy. 319# 0x02 don't use the npx registers to optimize bzero. 320# 0x04 don't use the npx registers to optimize copyin or copyout. 321# The npx registers are normally used to optimize copying and zeroing when 322# all of the following conditions are satisfied: 323# I586_CPU is an option 324# the cpu is an i586 (perhaps not a Pentium) 325# the probe for npx0 succeeds 326# INT 16 exception handling works. 327# Then copying and zeroing using the npx registers is normally 30-100% faster. 328# The flags can be used to control cases where it doesn't work or is slower. 329# Setting them at boot time using hints works right (the optimizations 330# are not used until later in the bootstrap when npx0 is attached). 331# Flag 0x08 automatically disables the i586 optimized routines. 332# 333 334# 335# Optional devices: 336# 337 338# 3Dfx Voodoo Graphics, Voodoo II /dev/3dfx CDEV support. This will create 339# the /dev/3dfx0 device to work with glide implementations. This should get 340# linked to /dev/3dfx and /dev/voodoo. Note that this is not the same as 341# the tdfx DRI module from XFree86 and is completely unrelated. 342# 343# To enable Linuxulator support, one must also include COMPAT_LINUX in the 344# config as well. The other option is to load both as modules. 345 346device tdfx # Enable 3Dfx Voodoo support 347device tdfx_linux # Enable Linuxulator support 348 349# Direct Rendering modules for 3D acceleration. 350device drm # DRM core module required by DRM drivers 351device mach64drm # ATI Rage Pro, Rage Mobility P/M, Rage XL 352device mgadrm # AGP Matrox G200, G400, G450, G550 353device r128drm # ATI Rage 128 354device radeondrm # ATI Radeon 355device savagedrm # S3 Savage3D, Savage4 356device sisdrm # SiS 300/305, 540, 630 357device tdfxdrm # 3dfx Voodoo 3/4/5 and Banshee 358options DRM_DEBUG # Include debug printfs (slow) 359 360# 361# Bus mouse 362# 363device mse 364hint.mse.0.at="isa" 365hint.mse.0.port="0x7fd9" 366hint.mse.0.irq="13" 367 368# 369# Network interfaces: 370# 371 372# ar: Arnet SYNC/570i hdlc sync 2/4 port V.35/X.21 serial driver 373# (requires sppp) 374# ce: Cronyx Tau-PCI/32 sync single/dual port G.703/E1 serial adaptor 375# with 32 HDLC subchannels (requires sppp (default), or NETGRAPH if 376# NETGRAPH_CRONYX is configured) 377# cp: Cronyx Tau-PCI sync single/dual/four port 378# V.35/RS-232/RS-530/RS-449/X.21/G.703/E1/E3/T3/STS-1 379# serial adaptor (requires sppp (default), or NETGRAPH if 380# NETGRAPH_CRONYX is configured) 381# cs: IBM Etherjet and other Crystal Semi CS89x0-based adapters and pccard 382# ed: Western Digital and SMC 80xx; Novell NE1000 and NE2000; 3Com 3C503 383# HP PC Lan+, various PC Card devices 384# (requires miibus) 385# ie: AT&T StarLAN 10 and EN100; 3Com 3C507; unknown NI5210; 386# Intel EtherExpress 387# le: AMD Am7900 LANCE and Am79C9xx ILACC/PCnet Ethernet interface driver 388# ral: Ralink Technology IEEE 802.11 wireless adapter 389# sbni: Granch SBNI12-xx ISA and PCI adapters 390# snc: National Semiconductor DP8393X SONIC Ethernet adapter driver 391# sr: RISCom/N2 hdlc sync 1/2 port V.35/X.21 serial driver (requires sppp) 392# ural: Ralink Technology RT2500USB IEEE 802.11 wireless adapter 393# ath: Atheros a/b/g WiFi adapters (requires ath_hal and wlan) 394 395# Order for ISA/EISA devices is important here 396 397device ar 398device ce 399device cp 400device cs 401device ed 402hint.ed.0.at="isa" 403hint.ed.0.port="0x280" 404hint.ed.0.irq="5" 405hint.ed.0.maddr="0xd8000" 406device ie # Hints only required for Starlan 407hint.ie.2.at="isa" 408hint.ie.2.port="0x300" 409hint.ie.2.irq="5" 410hint.ie.2.maddr="0xd0000" 411#device le 412# Hint for the PC98-only C-NET(98)S C-bus front-end of le(4). 413hint.le.0.at="isa" 414hint.le.0.port="0x03d0" 415hint.le.0.irq="6" 416device ral 417device sbni 418hint.sbni.0.at="isa" 419hint.sbni.0.port="0x210" 420hint.sbni.0.irq="0xefdead" 421hint.sbni.0.flags="0" 422device snc 423hint.snc.0.at="isa" 424hint.snc.0.port="0x888" 425hint.snc.0.irq="6" 426hint.snc.0.maddr="0xc0000" 427device sr 428device ural 429 430device ath # Atheros pci/cardbus NIC's 431device ath_hal # pci/cardbus chip support 432#device ath_ar5210 # AR5210 chips 433#device ath_ar5211 # AR5211 chips 434#device ath_ar5212 # AR5212 chips 435#device ath_rf2413 436#device ath_rf2417 437#device ath_rf2425 438#device ath_rf5111 439#device ath_rf5112 440#device ath_rf5413 441#device ath_ar5416 # AR5416 chips 442options AH_SUPPORT_AR5416 # enable AR5416 tx/rx descriptors 443device ath_rate_sample # SampleRate tx rate control for ath 444 445# 446# SCSI host adapters: 447# 448# ct: WD33C93[ABC] based SCSI host adapters. 449# ncv: NCR 53C500 based SCSI host adapters. 450# nsp: Workbit Ninja SCSI-3 based PC Card SCSI host adapters. 451# stg: TMC 18C30, 18C50 based SCSI host adapters. 452 453device ct 454hint.ct.0.at="isa" 455device ncv 456device nsp 457device stg 458 459# 460# SafeNet crypto driver: can be moved to the MI NOTES as soon as 461# it's tested on a big-endian machine 462# 463device safe # SafeNet 1141 464options SAFE_DEBUG # enable debugging support: hw.safe.debug 465options SAFE_RNDTEST # enable rndtest support 466 467##################################################################### 468 469# 470# Miscellaneous hardware: 471# 472# apm: Laptop Advanced Power Management (experimental) 473# canbus: CanBe I/O Bus 474# canbepm: CanBe Power Management Controller 475# olpt: XXX 476# pmc: Power Management Controller of NEC PC-98Note 477# pmtimer: Timer device driver for power management events (APM or ACPI) 478# Adjusts system timer at wakeup time 479# 480# Notes on APM 481# The flags takes the following meaning for apm0: 482# 0x0020 Statclock is broken. 483 484device apm 485hint.apm.0.flags="0x20" 486device canbus 487device canbepm 488device olpt 489hint.olpt.0.at="isa" 490hint.olpt.0.port="0x040" 491device pmc 492hint.pmc.0.at="isa" 493hint.pmc.0.port="0x8f0" 494device pmtimer 495 496# 497# Laptop/Notebook options: 498# 499# See also: 500# apm under `Miscellaneous hardware' 501# above. 502 503# For older notebooks that signal a powerfail condition (external 504# power supply dropped, or battery state low) by issuing an NMI: 505 506options POWERFAIL_NMI # make it beep instead of panicing 507 508# 509# Set the number of PV entries per process. Increasing this can 510# stop panics related to heavy use of shared memory. However, that can 511# (combined with large amounts of physical memory) cause panics at 512# boot time due the kernel running out of VM space. 513# 514# If you're tweaking this, you might also want to increase the sysctls 515# "vm.v_free_min", "vm.v_free_reserved", and "vm.v_free_target". 516# 517# The value below is the one more than the default. 518# 519options PMAP_SHPGPERPROC=201 520 521# 522# Change the size of the kernel virtual address space. Due to 523# constraints in loader(8) on i386, this must be a multiple of 4. 524# 256 = 1 GB of kernel address space. Increasing this also causes 525# a reduction of the address space in user processes. 512 splits 526# the 4GB cpu address space in half (2GB user, 2GB kernel). 527# 528options KVA_PAGES=260 529 530 531##################################################################### 532# ABI Emulation 533 534# Enable iBCS2 runtime support for SCO and ISC binaries 535options IBCS2 536 537# Emulate spx device for client side of SVR3 local X interface 538options SPX_HACK 539 540# Enable Linux ABI emulation 541options COMPAT_LINUX 542 543# Enable i386 a.out binary support 544options COMPAT_AOUT 545 546# Enable the linux-like proc filesystem support (requires COMPAT_LINUX 547# and PSEUDOFS) 548options LINPROCFS 549 550# Enable the linux-like sys filesystem support (requires COMPAT_LINUX 551# and PSEUDOFS) 552options LINSYSFS 553 554# 555# SysVR4 ABI emulation 556# 557# The svr4 ABI emulator can be statically compiled into the kernel or loaded as 558# a KLD module. 559# The STREAMS network emulation code can also be compiled statically or as a 560# module. If loaded as a module, it must be loaded before the svr4 module 561# (the /usr/sbin/svr4 script does this for you). If compiling statically, 562# the `streams' device must be configured into any kernel which also 563# specifies COMPAT_SVR4. It is possible to have a statically-configured 564# STREAMS device and a dynamically loadable svr4 emulator; the /usr/sbin/svr4 565# script understands that it doesn't need to load the `streams' module under 566# those circumstances. 567# Caveat: At this time, `options KTRACE' is required for the svr4 emulator 568# (whether static or dynamic). 569# 570options COMPAT_SVR4 # build emulator statically 571options DEBUG_SVR4 # enable verbose debugging 572device streams # STREAMS network driver (required for svr4). 573 574 575##################################################################### 576# VM OPTIONS 577 578# Disable the 4 MByte page PSE CPU feature. The PSE feature allows the 579# kernel to use 4 MByte pages to map the kernel instead of 4k pages. 580# This saves on the amount of memory needed for page tables needed to 581# map the kernel. You should only disable this feature as a temporary 582# workaround if you are having problems with it enabled. 583# 584#options DISABLE_PSE 585 586# Disable the global pages PGE CPU feature. The PGE feature allows pages 587# to be marked with the PG_G bit. TLB entries for these pages are not 588# flushed from the cache when %cr3 is reloaded. This can make context 589# switches less expensive. You should only disable this feature as a 590# temporary workaround if you are having problems with it enabled. 591# 592#options DISABLE_PG_G 593 594# KSTACK_PAGES is the number of memory pages to assign to the kernel 595# stack of each thread. 596 597options KSTACK_PAGES=3 598 599##################################################################### 600 601# More undocumented options for linting. 602# Note that documenting these are not considered an affront. 603 604options FB_INSTALL_CDEV # install a CDEV entry in /dev 605 606options I586_PMC_GUPROF=0x70000 607options KBDIO_DEBUG=2 608options KBD_MAXRETRY=4 609options KBD_MAXWAIT=6 610options KBD_RESETDELAY=201 611 612options TIMER_FREQ=((14318182+6)/12) 613 614options VM_KMEM_SIZE 615options VM_KMEM_SIZE_MAX 616options VM_KMEM_SIZE_SCALE 617 618 619##################################################################### 620# Devices we don't want to deal with 621 622nodevice bt 623nodevice adw 624nodevice aha 625nodevice ahb 626nodevice ahd 627nodevice mpt 628nodevice trm 629nodevice wds 630nodevice dpt 631nodevice ciss 632nodevice iir 633nodevice mly 634nodevice ida # Compaq Smart RAID 635nodevice mlx # Mylex DAC960 636nodevice amr # AMI MegaRAID 637nodevice twe # 3ware ATA RAID 638nodevice ataraid 639nodevice cm 640nodevice ex 641nodevice fea 642nodevice intpm 643nodevice alpm 644nodevice ichsmb 645nodevice viapm 646nodevice amdpm 647nodevice amdsmb 648nodevice nfpm 649nodevice nfsmb 650 651 652##################################################################### 653# Options we don't want to deal with 654 655nooption AHD_DEBUG 656nooption AHD_DEBUG_OPTS 657nooption AHD_REG_PRETTY_PRINT 658nooption ADW_ALLOW_MEMIO 659nooption DPT_LOST_IRQ 660nooption DPT_RESET_HBA 661nooption DPT_TIMEOUT_FACTOR 662nooption AAC_DEBUG 663 664 665##################################################################### 666# Make options we don't want to deal with 667