]> CyberLeo.Net >> Repos - FreeBSD/FreeBSD.git/blob - sys/i386/conf/NOTES
This commit was generated by cvs2svn to compensate for changes in r171945,
[FreeBSD/FreeBSD.git] / sys / i386 / conf / NOTES
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.
12 profile         2
13
14 \f
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 # Notes:
24 #
25 # HTT CPUs should only be used if they are enabled in the BIOS.  For
26 # the ACPI case, ACPI only correctly tells us about any HTT CPUs if
27 # they are enabled.  However, most HTT systems do not list HTT CPUs
28 # in the MP Table if they are enabled, thus we guess at the HTT CPUs
29 # for the MP Table case.  However, we shouldn't try to guess and use
30 # these CPUs if HTT is disabled.  Thus, HTT guessing is only enabled
31 # for the MP Table if the user explicitly asks for it via the
32 # MPTABLE_FORCE_HTT option.  Do NOT use this option if you have HTT
33 # disabled in your BIOS.
34 #
35 # IPI_PREEMPTION instructs the kernel to preempt threads running on other
36 # CPUS if needed.  Relies on the PREEMPTION option
37
38 # Mandatory:
39 device          apic                    # I/O apic
40
41 # Optional:
42 options         MPTABLE_FORCE_HTT       # Enable HTT CPUs with the MP Table
43 options         IPI_PREEMPTION
44
45 #
46 # Watchdog routines.
47 #
48 options         MP_WATCHDOG
49
50 # Debugging options.
51 #
52 options         STOP_NMI                # Stop CPUS using NMI instead of IPI
53 options         COUNT_XINVLTLB_HITS     # Counters for TLB events
54 options         COUNT_IPIS              # Per-CPU IPI interrupt counters
55
56
57 \f
58 #####################################################################
59 # CPU OPTIONS
60
61 #
62 # You must specify at least one CPU (the one you intend to run on);
63 # deleting the specification for CPUs you don't need to use may make
64 # parts of the system run faster.
65 #
66 cpu             I486_CPU
67 cpu             I586_CPU                # aka Pentium(tm)
68 cpu             I686_CPU                # aka Pentium Pro(tm)
69
70 #
71 # Options for CPU features.
72 #
73 # CPU_ATHLON_SSE_HACK tries to enable SSE instructions when the BIOS has
74 # forgotten to enable them.
75 #
76 # CPU_BLUELIGHTNING_3X enables triple-clock mode on IBM Blue Lightning
77 # CPU if CPU supports it.  The default is double-clock mode on
78 # BlueLightning CPU box.
79 #
80 # CPU_BLUELIGHTNING_FPU_OP_CACHE enables FPU operand cache on IBM
81 # BlueLightning CPU.  It works only with Cyrix FPU, and this option
82 # should not be used with Intel FPU.
83 #
84 # CPU_BTB_EN enables branch target buffer on Cyrix 5x86 (NOTE 1).
85 #
86 # CPU_CYRIX_NO_LOCK enables weak locking for the entire address space
87 # of Cyrix 6x86 and 6x86MX CPUs by setting the NO_LOCK bit of CCR1.
88 # Otherwise, the NO_LOCK bit of CCR1 is cleared.  (NOTE 3)
89 #
90 # CPU_DIRECT_MAPPED_CACHE sets L1 cache of Cyrix 486DLC CPU in direct
91 # mapped mode.  Default is 2-way set associative mode.
92 #
93 # CPU_DISABLE_5X86_LSSER disables load store serialize (i.e., enables
94 # reorder).  This option should not be used if you use memory mapped
95 # I/O device(s).
96 #
97 # CPU_DISABLE_CMPXCHG disables the CMPXCHG instruction on > i386 IA32
98 # machines.  VmWare 3.x seems to emulate this instruction poorly, causing
99 # the guest OS to run very slowly.  This problem appears to be fixed in
100 # VmWare 4.x, at least in version 4.5.2, so that enabling this option with
101 # VmWare 4.x will result in locking operations to be 20-30 times slower.
102 # Enabling this with an SMP kernel will cause the kernel to be unusable.
103 #
104 # CPU_DISABLE_SSE explicitly prevents I686_CPU from turning on SSE.
105 #
106 # CPU_ELAN enables support for AMDs ElanSC520 CPU.
107 #    CPU_ELAN_PPS enables precision timestamp code.
108 #    CPU_ELAN_XTAL sets the clock crystal frequency in Hz.
109 #
110 # CPU_ENABLE_LONGRUN enables support for Transmeta Crusoe LongRun
111 # technology which allows to restrict power consumption of the CPU by
112 # using group of hw.crusoe.* sysctls.
113 #
114 # CPU_FASTER_5X86_FPU enables faster FPU exception handler.
115 #
116 # CPU_GEODE is for the SC1100 Geode embedded processor.  This option
117 # is necessary because the i8254 timecounter is toast.
118 #
119 # CPU_I486_ON_386 enables CPU cache on i486 based CPU upgrade products
120 # for i386 machines.
121 #
122 # CPU_IORT defines I/O clock delay time (NOTE 1).  Default values of
123 # I/O clock delay time on Cyrix 5x86 and 6x86 are 0 and 7,respectively
124 # (no clock delay).
125 #
126 # CPU_L2_LATENCY specifies the L2 cache latency value.  This option is used
127 # only when CPU_PPRO2CELERON is defined and Mendocino Celeron is detected.
128 # The default value is 5.
129 #
130 # CPU_LOOP_EN prevents flushing the prefetch buffer if the destination
131 # of a jump is already present in the prefetch buffer on Cyrix 5x86(NOTE
132 # 1).
133 #
134 # CPU_PPRO2CELERON enables L2 cache of Mendocino Celeron CPUs.  This option
135 # is useful when you use Socket 8 to Socket 370 converter, because most Pentium
136 # Pro BIOSs do not enable L2 cache of Mendocino Celeron CPUs.
137 #
138 # CPU_RSTK_EN enables return stack on Cyrix 5x86 (NOTE 1).
139 #
140 # CPU_SOEKRIS enables support www.soekris.com hardware.
141 #
142 # CPU_SUSP_HLT enables suspend on HALT.  If this option is set, CPU
143 # enters suspend mode following execution of HALT instruction.
144 #
145 # CPU_UPGRADE_HW_CACHE eliminates unneeded cache flush instruction(s).
146 #
147 # CPU_WT_ALLOC enables write allocation on Cyrix 6x86/6x86MX and AMD
148 # K5/K6/K6-2 CPUs.
149 #
150 # CYRIX_CACHE_WORKS enables CPU cache on Cyrix 486 CPUs with cache
151 # flush at hold state.
152 #
153 # CYRIX_CACHE_REALLY_WORKS enables (1) CPU cache on Cyrix 486 CPUs
154 # without cache flush at hold state, and (2) write-back CPU cache on
155 # Cyrix 6x86 whose revision < 2.7 (NOTE 2).
156 #
157 # NO_F00F_HACK disables the hack that prevents Pentiums (and ONLY
158 # Pentiums) from locking up when a LOCK CMPXCHG8B instruction is
159 # executed.  This option is only needed if I586_CPU is also defined,
160 # and should be included for any non-Pentium CPU that defines it.
161 #
162 # NO_MEMORY_HOLE is an optimisation for systems with AMD K6 processors
163 # which indicates that the 15-16MB range is *definitely* not being
164 # occupied by an ISA memory hole.
165 #
166 # NOTE 1: The options, CPU_BTB_EN, CPU_LOOP_EN, CPU_IORT,
167 # CPU_LOOP_EN and CPU_RSTK_EN should not be used because of CPU bugs.
168 # These options may crash your system.
169 #
170 # NOTE 2: If CYRIX_CACHE_REALLY_WORKS is not set, CPU cache is enabled
171 # in write-through mode when revision < 2.7.  If revision of Cyrix
172 # 6x86 >= 2.7, CPU cache is always enabled in write-back mode.
173 #
174 # NOTE 3: This option may cause failures for software that requires
175 # locked cycles in order to operate correctly.
176 #
177 options         CPU_ATHLON_SSE_HACK
178 options         CPU_BLUELIGHTNING_3X
179 options         CPU_BLUELIGHTNING_FPU_OP_CACHE
180 options         CPU_BTB_EN
181 options         CPU_DIRECT_MAPPED_CACHE
182 options         CPU_DISABLE_5X86_LSSER
183 options         CPU_DISABLE_CMPXCHG
184 #options        CPU_DISABLE_SSE
185 options         CPU_ELAN
186 options         CPU_ELAN_PPS
187 options         CPU_ELAN_XTAL=32768000
188 options         CPU_ENABLE_LONGRUN
189 options         CPU_FASTER_5X86_FPU
190 options         CPU_GEODE
191 options         CPU_I486_ON_386
192 options         CPU_IORT
193 options         CPU_L2_LATENCY=5
194 options         CPU_LOOP_EN
195 options         CPU_PPRO2CELERON
196 options         CPU_RSTK_EN
197 options         CPU_SOEKRIS
198 options         CPU_SUSP_HLT
199 options         CPU_UPGRADE_HW_CACHE
200 options         CPU_WT_ALLOC
201 options         CYRIX_CACHE_WORKS
202 options         CYRIX_CACHE_REALLY_WORKS
203 #options        NO_F00F_HACK
204
205 # Debug options
206 options         NPX_DEBUG       # enable npx debugging
207
208 #
209 # PERFMON causes the driver for Pentium/Pentium Pro performance counters
210 # to be compiled.  See perfmon(4) for more information.
211 #
212 options         PERFMON
213
214 #
215 # XBOX causes the kernel to be bootable on the Microsoft XBox console system.
216 # The resulting kernel will auto-detect whether it is being booted on a XBox,
217 # so kernels compiled with this option will also work on an ordinary PC.
218 # This option require I686_CPU.
219 #
220 # xboxfb includes support for the XBox frame buffer device. It is fully USB-
221 # keyboard aware, and will only be used if an xbox is detected. This option
222 # (obviously) requires XBOX support in your kernel.
223 #
224 # NOTE: xboxfb currently conflicts with syscons(4); if you have an XBOX and
225 # include both in your kernel; you will not get any video output. Ordinary
226 # PC's do not suffer from this.
227 #
228 options         XBOX
229 device          xboxfb
230
231 \f
232 #####################################################################
233 # NETWORKING OPTIONS
234
235 #
236 # DEVICE_POLLING adds support for mixed interrupt-polling handling
237 # of network device drivers, which has significant benefits in terms
238 # of robustness to overloads and responsivity, as well as permitting
239 # accurate scheduling of the CPU time between kernel network processing
240 # and other activities.  The drawback is a moderate (up to 1/HZ seconds)
241 # potential increase in response times.
242 # It is strongly recommended to use HZ=1000 or 2000 with DEVICE_POLLING
243 # to achieve smoother behaviour.
244 # Additionally, you can enable/disable polling at runtime with help of
245 # the ifconfig(8) utility, and select the CPU fraction reserved to
246 # userland with the sysctl variable kern.polling.user_frac
247 # (default 50, range 0..100).
248 #
249 # Not all device drivers support this mode of operation at the time of
250 # this writing.  See polling(4) for more details.
251
252 options         DEVICE_POLLING
253
254 \f
255 #####################################################################
256 # CLOCK OPTIONS
257
258 # The following options are used for debugging clock behavior only, and
259 # should not be used for production systems.
260
261 # CLK_CALIBRATION_LOOP causes clock calibration to be run in a loop at
262 # startup until the user presses a key.  (The i8254 clock is always
263 # calibrated relative to the RTC (mc146818a) and this option causes the
264 # calibration to be repeated.)
265 options         CLK_CALIBRATION_LOOP
266
267 # CLK_USE_I8254_CALIBRATION causes the calibrated frequency of the i8254
268 # clock to actually be used.
269 options         CLK_USE_I8254_CALIBRATION
270
271 \f
272 #####################################################################
273 # MISCELLANEOUS DEVICES AND OPTIONS
274
275
276 # sio: serial ports (see sio(4)), including support for various
277 #      PC Card devices, such as Modem and NICs
278 #
279 device          sio
280 hint.sio.0.at="isa"
281 hint.sio.0.port="0x3F8"
282 hint.sio.0.flags="0x10"
283 hint.sio.0.irq="4"
284
285 # `flags' specific to sio(4).
286 #       0x10    enable console support for this unit.  Other console flags
287 #               (if applicable) are ignored unless this is set.  Enabling
288 #               console support does not make the unit the preferred console.
289 #               Boot with -h or set boot_serial=YES in the loader.  For sio(4)
290 #               specifically, the 0x20 flag can also be set (see above).
291 #               Currently, at most one unit can have console support; the
292 #               first one (in config file order) with this flag set is
293 #               preferred.  Setting this flag for sio0 gives the old behaviour.
294 #       0x20    force this unit to be the console (unless there is another
295 #               higher priority console).  This replaces the COMCONSOLE option.
296 #       0x40    reserve this unit for low level console operations.  Do not
297 #               access the device in any normal way.
298 #       0x80    use this port for serial line gdb support in ddb.  Also known
299 #               as debug port.
300 # PnP `flags'
301 #       0x1     disable probing of this device.  Used to prevent your modem
302 #               from being attached as a PnP modem.
303 # Other flags for sio that aren't documented in the man page.
304 #       0x20000 enable hardware RTS/CTS and larger FIFOs.  Only works for
305 #               ST16650A-compatible UARTs.
306
307 # Options for sio:
308 options         COM_ESP                 # Code for Hayes ESP.
309 options         COM_MULTIPORT           # Code for some cards with shared IRQs.
310 options         CONSPEED=115200         # Speed for serial console
311                                         # (default 9600).
312
313 device          speaker         #Play IBM BASIC-style noises out your speaker
314 hint.speaker.0.at="isa"
315 hint.speaker.0.port="0x61"
316 device          gzip            #Exec gzipped a.out's.  REQUIRES COMPAT_AOUT!
317 device          apm_saver       # Requires APM
318
319 \f
320 #####################################################################
321 # HARDWARE BUS CONFIGURATION
322
323 #
324 # ISA bus
325 #
326 device          isa             # Required by npx(4)
327
328 #
329 # Options for `isa':
330 #
331 # AUTO_EOI_1 enables the `automatic EOI' feature for the master 8259A
332 # interrupt controller.  This saves about 0.7-1.25 usec for each interrupt.
333 # This option breaks suspend/resume on some portables.
334 #
335 # AUTO_EOI_2 enables the `automatic EOI' feature for the slave 8259A
336 # interrupt controller.  This saves about 0.7-1.25 usec for each interrupt.
337 # Automatic EOI is documented not to work for for the slave with the
338 # original i8259A, but it works for some clones and some integrated
339 # versions.
340 #
341 # MAXMEM specifies the amount of RAM on the machine; if this is not
342 # specified, FreeBSD will first read the amount of memory from the CMOS
343 # RAM, so the amount of memory will initially be limited to 64MB or 16MB
344 # depending on the BIOS.  If the BIOS reports 64MB, a memory probe will
345 # then attempt to detect the installed amount of RAM.  If this probe
346 # fails to detect >64MB RAM you will have to use the MAXMEM option.
347 # The amount is in kilobytes, so for a machine with 128MB of RAM, it would
348 # be 131072 (128 * 1024).
349 #
350 # BROKEN_KEYBOARD_RESET disables the use of the keyboard controller to
351 # reset the CPU for reboot.  This is needed on some systems with broken
352 # keyboard controllers.
353
354 options         AUTO_EOI_1
355 #options        AUTO_EOI_2
356
357 options         MAXMEM=(128*1024)
358 #options        BROKEN_KEYBOARD_RESET
359
360 #
361 # EISA bus
362 #
363 # The EISA bus device is `eisa'.  It provides auto-detection and
364 # configuration support for all devices on the EISA bus.
365
366 device          eisa
367
368 # By default, only 10 EISA slots are probed, since the slot numbers
369 # above clash with the configuration address space of the PCI subsystem,
370 # and the EISA probe is not very smart about this.  This is sufficient
371 # for most machines, but in particular the HP NetServer LC series comes
372 # with an onboard AIC7770 dual-channel SCSI controller on EISA slot #11,
373 # thus you need to bump this figure to 12 for them.
374 options         EISA_SLOTS=12
375
376 #
377 # MCA bus:
378 #
379 # The MCA bus device is `mca'.  It provides auto-detection and
380 # configuration support for all devices on the MCA bus.
381 # No hints are required for MCA.
382
383 device          mca
384
385 #
386 # PCI bus & PCI options:
387 #
388 device          pci
389
390 #
391 # AGP GART support
392 device          agp
393
394 \f
395 #####################################################################
396 # HARDWARE DEVICE CONFIGURATION
397
398 # To include support for VGA VESA video modes
399 options         VESA
400
401 # Turn on extra debugging checks and output for VESA support.
402 options         VESA_DEBUG
403
404 #
405 # The Numeric Processing eXtension driver.  This is non-optional.
406 device          npx
407 hint.npx.0.flags="0x0"
408 hint.npx.0.irq="13"
409
410 #
411 # `flags' for npx0:
412 #       0x01    don't use the npx registers to optimize bcopy.
413 #       0x02    don't use the npx registers to optimize bzero.
414 #       0x04    don't use the npx registers to optimize copyin or copyout.
415 # The npx registers are normally used to optimize copying and zeroing when
416 # all of the following conditions are satisfied:
417 #       I586_CPU is an option
418 #       the cpu is an i586 (perhaps not a Pentium)
419 #       the probe for npx0 succeeds
420 #       INT 16 exception handling works.
421 # Then copying and zeroing using the npx registers is normally 30-100% faster.
422 # The flags can be used to control cases where it doesn't work or is slower.
423 # Setting them at boot time using hints works right (the optimizations
424 # are not used until later in the bootstrap when npx0 is attached).
425 # Flag 0x08 automatically disables the i586 optimized routines.
426 #
427
428 #
429 # Optional devices:
430 #
431
432 # PS/2 mouse
433 device          psm
434 hint.psm.0.at="atkbdc"
435 hint.psm.0.irq="12"
436
437 # Options for psm:
438 options         PSM_HOOKRESUME          #hook the system resume event, useful
439                                         #for some laptops
440 options         PSM_RESETAFTERSUSPEND   #reset the device at the resume event
441
442 # The keyboard controller; it controls the keyboard and the PS/2 mouse.
443 device          atkbdc
444 hint.atkbdc.0.at="isa"
445 hint.atkbdc.0.port="0x060"
446
447 # The AT keyboard
448 device          atkbd
449 hint.atkbd.0.at="atkbdc"
450 hint.atkbd.0.irq="1"
451
452 # Options for atkbd:
453 options         ATKBD_DFLT_KEYMAP       # specify the built-in keymap
454 makeoptions     ATKBD_DFLT_KEYMAP=jp.106
455
456 # `flags' for atkbd:
457 #       0x01    Force detection of keyboard, else we always assume a keyboard
458 #       0x02    Don't reset keyboard, useful for some newer ThinkPads
459 #       0x03    Force detection and avoid reset, might help with certain
460 #               dockingstations
461 #       0x04    Old-style (XT) keyboard support, useful for older ThinkPads
462
463 # Video card driver for VGA adapters.
464 device          vga
465 hint.vga.0.at="isa"
466
467 # Options for vga:
468 # Try the following option if the mouse pointer is not drawn correctly
469 # or font does not seem to be loaded properly.  May cause flicker on
470 # some systems.
471 options         VGA_ALT_SEQACCESS
472
473 # If you can dispense with some vga driver features, you may want to
474 # use the following options to save some memory.
475 #options        VGA_NO_FONT_LOADING     # don't save/load font
476 #options        VGA_NO_MODE_CHANGE      # don't change video modes
477
478 # Older video cards may require this option for proper operation.
479 options         VGA_SLOW_IOACCESS       # do byte-wide i/o's to TS and GDC regs
480
481 # The following option probably won't work with the LCD displays.
482 options         VGA_WIDTH90             # support 90 column modes
483
484 # Debugging.
485 options         VGA_DEBUG
486
487 # 3Dfx Voodoo Graphics, Voodoo II /dev/3dfx CDEV support.  This will create
488 # the /dev/3dfx0 device to work with glide implementations.  This should get
489 # linked to /dev/3dfx and /dev/voodoo.  Note that this is not the same as
490 # the tdfx DRI module from XFree86 and is completely unrelated.
491 #
492 # To enable Linuxulator support, one must also include COMPAT_LINUX in the
493 # config as well.  The other option is to load both as modules.
494
495 device          tdfx                    # Enable 3Dfx Voodoo support
496 device          tdfx_linux              # Enable Linuxulator support
497
498 #
499 # ACPI support using the Intel ACPI Component Architecture reference
500 # implementation.
501 #
502 # ACPI_DEBUG enables the use of the debug.acpi.level and debug.acpi.layer
503 # kernel environment variables to select initial debugging levels for the
504 # Intel ACPICA code.  (Note that the Intel code must also have USE_DEBUGGER
505 # defined when it is built).
506 #
507 # ACPI_NO_SEMAPHORES makes the AcpiOs*Semaphore routines a no-op.
508 #
509 # Note that building ACPI into the kernel is deprecated; the module is
510 # normally loaded automatically by the loader.
511
512 device          acpi
513 options         ACPI_DEBUG
514 #!options       ACPI_NO_SEMAPHORES
515
516 # ACPI Asus Desktop Extras. (voltage, temp, fan)
517 device          acpi_aiboost
518
519 # ACPI Asus Extras (LCD backlight/brightness, video output, etc.)
520 device          acpi_asus
521
522 # ACPI Fujitsu Extras (Buttons)
523 device          acpi_fujitsu
524
525 # ACPI extras driver for IBM laptops
526 device         acpi_ibm
527
528 # ACPI Panasonic Extras (LCD backlight/brightness, video output, etc.)
529 device          acpi_panasonic
530
531 # ACPI Sony extra (LCD brightness)
532 device          acpi_sony
533
534 # ACPI Toshiba Extras (LCD backlight/brightness, video output, etc.)
535 device          acpi_toshiba
536
537 # ACPI Video Extensions (LCD backlight/brightness, video output, etc.)
538 device          acpi_video
539
540 # ACPI Docking Station
541 device          acpi_dock
542
543 # The cpufreq(4) driver provides support for non-ACPI CPU frequency control
544 device          cpufreq
545
546 # Direct Rendering modules for 3D acceleration.
547 device          drm             # DRM core module required by DRM drivers
548 device          i915drm         # Intel i830 through i915
549 device          mach64drm       # ATI Rage Pro, Rage Mobility P/M, Rage XL
550 device          mgadrm          # AGP Matrox G200, G400, G450, G550
551 device          r128drm         # ATI Rage 128
552 device          radeondrm       # ATI Radeon
553 device          savagedrm       # S3 Savage3D, Savage4
554 device          sisdrm          # SiS 300/305, 540, 630
555 device          tdfxdrm         # 3dfx Voodoo 3/4/5 and Banshee
556 options         DRM_DEBUG       # Include debug printfs (slow)
557
558 #
559 # mse: Logitech and ATI InPort bus mouse ports
560
561 device          mse
562 hint.mse.0.at="isa"
563 hint.mse.0.port="0x23c"
564 hint.mse.0.irq="5"
565
566 #
567 # Network interfaces:
568 #
569
570 # ar:   Arnet SYNC/570i hdlc sync 2/4 port V.35/X.21 serial driver
571 #       (requires sppp)
572 # arl:  Aironet Arlan 655 wireless adapters.
573 # ath:  Atheros a/b/g WiFi adapters (requires ath_hal and wlan)
574 # ce:   Cronyx Tau-PCI/32 sync single/dual port G.703/E1 serial adaptor
575 #       with 32 HDLC subchannels (requires sppp (default), or NETGRAPH if
576 #       NETGRAPH_CRONYX is configured)
577 # cp:   Cronyx Tau-PCI sync single/dual/four port
578 #       V.35/RS-232/RS-530/RS-449/X.21/G.703/E1/E3/T3/STS-1
579 #       serial adaptor (requires sppp (default), or NETGRAPH if
580 #       NETGRAPH_CRONYX is configured)
581 # cs:   IBM Etherjet and other Crystal Semi CS89x0-based adapters
582 # ctau: Cronyx Tau sync dual port V.35/RS-232/RS-530/RS-449/X.21/G.703/E1
583 #       serial adaptor (requires sppp (default), or NETGRAPH if
584 #       NETGRAPH_CRONYX is configured)
585 # cx:   Cronyx Sigma multiport sync/async adapter (requires sppp (default),
586 #       or NETGRAPH if NETGRAPH_CRONYX is configured)
587 # ed:   Western Digital and SMC 80xx; Novell NE1000 and NE2000; 3Com 3C503
588 #       HP PC Lan+, various PC Card devices
589 #       (requires miibus)
590 # ie:   AT&T StarLAN 10 and EN100; 3Com 3C507; unknown NI5210;
591 #       Intel EtherExpress
592 # ipw:  Intel PRO/Wireless 2100 IEEE 802.11 adapter
593 # iwi:  Intel PRO/Wireless 2200BG/2225BG/2915ABG IEEE 802.11 adapters
594 # nfe:  nVidia nForce MCP on-board Ethernet Networking (BSD open source)
595 # nve:  nVidia nForce MCP on-board Ethernet Networking
596 # oltr: Olicom ISA token-ring adapters OC-3115, OC-3117, OC-3118 and OC-3133.
597 #       Olicom PCI token-ring adapters OC-3136, OC-3137, OC-3139, OC-3140,
598 #       OC-3141, OC-3540 and OC-3250.
599 # ral:  Ralink Technology IEEE 802.11 wireless adapter
600 # sbni: Granch SBNI12-xx ISA and PCI adapters
601 # sr:   RISCom/N2 hdlc sync 1/2 port V.35/X.21 serial driver (requires sppp)
602 # ural: Ralink Technology RT2500USB IEEE 802.11 wireless adapter
603 # wl:   Lucent Wavelan (ISA card only).
604
605 # Order for ISA/EISA devices is important here
606
607 device          ar
608 hint.ar.0.at="isa"
609 hint.ar.0.port="0x300"
610 hint.ar.0.irq="10"
611 hint.ar.0.maddr="0xd0000"
612 device          arl
613 hint.arl.0.at="isa"
614 hint.arl.0.irq="9"
615 hint.arl.0.maddr="0xd0000"
616 device          ce
617 device          cp
618 device          cs
619 hint.cs.0.at="isa"
620 hint.cs.0.port="0x300"
621 device          ctau
622 hint.ctau.0.at="isa"
623 hint.ctau.0.port="0x240"
624 hint.ctau.0.irq="15"
625 hint.ctau.0.drq="7"
626 device          cx
627 hint.cx.0.at="isa"
628 hint.cx.0.port="0x240"
629 hint.cx.0.irq="15"
630 hint.cx.0.drq="7"
631 #options        NETGRAPH_CRONYX         # Enable NETGRAPH support for Cronyx adapter(s)
632 device          ed
633 options         ED_3C503
634 options         ED_HPP
635 options         ED_SIC
636 hint.ed.0.at="isa"
637 hint.ed.0.port="0x280"
638 hint.ed.0.irq="5"
639 hint.ed.0.maddr="0xd8000"
640 device          ie                      # Hints only required for Starlan
641 hint.ie.2.at="isa"
642 hint.ie.2.port="0x300"
643 hint.ie.2.irq="5"
644 hint.ie.2.maddr="0xd0000"
645 device          iwi
646 device          ipw
647 # Hint for the i386-only ISA front-end of le(4).
648 hint.le.0.at="isa"
649 hint.le.0.port="0x280"
650 hint.le.0.irq="10"
651 hint.le.0.drq="0"
652 device          nfe             # nVidia nForce MCP on-board Ethernet Networking
653 device          nve             # nVidia nForce MCP on-board Ethernet Networking
654 device          oltr
655 hint.oltr.0.at="isa"
656 device          ral
657 device          sbni
658 hint.sbni.0.at="isa"
659 hint.sbni.0.port="0x210"
660 hint.sbni.0.irq="0xefdead"
661 hint.sbni.0.flags="0"
662 device          sr
663 hint.sr.0.at="isa"
664 hint.sr.0.port="0x300"
665 hint.sr.0.irq="5"
666 hint.sr.0.maddr="0xd0000"
667 device          ural
668 device          wl
669 hint.wl.0.at="isa"
670 hint.wl.0.port="0x300"
671 options         WLCACHE         # enables the signal-strength cache
672 options         WLDEBUG         # enables verbose debugging output
673
674 device          ath
675 device          ath_hal         # Atheros HAL (includes binary component)
676 #device         ath_rate_amrr   # AMRR rate control for ath driver
677 #device         ath_rate_onoe   # Onoe rate control for ath driver
678 device          ath_rate_sample # SampleRate rate control for the ath driver
679 #device         wlan            # 802.11 layer
680
681 #
682 # ATA raid adapters
683 #
684 device          pst
685
686 #
687 # Areca 11xx and 12xx series of SATA II RAID controllers.
688 # CAM is required.
689 #
690 device          arcmsr          # Areca SATA II RAID
691
692 #
693 # 3ware 9000 series PATA/SATA RAID controller driver and options.
694 # The driver is implemented as a SIM, and so, needs the CAM infrastructure.
695 #
696 options         TWA_DEBUG               # 0-10; 10 prints the most messages.
697 options         TWA_FLASH_FIRMWARE      # firmware image bundled when defined.
698 device          twa                     # 3ware 9000 series PATA/SATA RAID
699
700 #
701 # SCSI host adapters:
702 #
703 # ncv: NCR 53C500 based SCSI host adapters.
704 # nsp: Workbit Ninja SCSI-3 based PC Card SCSI host adapters.
705 # stg: TMC 18C30, 18C50 based SCSI host adapters.
706
707 device          ncv
708 device          nsp
709 device          stg
710 hint.stg.0.at="isa"
711 hint.stg.0.port="0x140"
712 hint.stg.0.port="11"
713
714 #
715 # Adaptec FSA RAID controllers, including integrated DELL controllers,
716 # the Dell PERC 2/QC and the HP NetRAID-4M
717 device          aac
718 device          aacp    # SCSI Passthrough interface (optional, CAM required)
719
720 # The 'asr' driver provides support for current DPT/Adaptec SCSI RAID
721 # controllers (SmartRAID V and VI and later).
722 # These controllers require the CAM infrastructure.
723 #
724 device          asr
725
726 #
727 # Highpoint RocketRAID 182x.  This is really just software RAID on a
728 # Marvell SATA chip.
729 device          hptmv
730
731 #
732 # Highpoint RocketRAID 232x.  This is software RAID but with hardware
733 # acceleration assistance for RAID_5.
734 device          rr232x
735
736 #
737 # Highpoint RocketRaid 3xxx series SATA RAID
738 device          hptiop
739
740 #
741 # IBM (now Adaptec) ServeRAID controllers
742 device          ips
743
744 #
745 # SafeNet crypto driver: can be moved to the MI NOTES as soon as
746 # it's tested on a big-endian machine
747 #
748 device          safe            # SafeNet 1141
749 options         SAFE_DEBUG      # enable debugging support: hw.safe.debug
750 options         SAFE_RNDTEST    # enable rndtest support
751
752 #####################################################################
753
754 #
755 # Miscellaneous hardware:
756 #
757 # apm: Laptop Advanced Power Management (experimental)
758 # ipmi: Intelligent Platform Management Interface
759 # pmtimer: Timer device driver for power management events (APM or ACPI)
760 # smapi: System Management Application Program Interface driver
761 # smbios: DMI/SMBIOS entry point
762 # vpd: Vital Product Data kernel interface
763 # cy: Cyclades serial driver
764 # digi: Digiboard driver
765 # spic: Sony Programmable I/O controller (VAIO notebooks)
766
767 # Notes on APM
768 #  The flags takes the following meaning for apm0:
769 #    0x0020  Statclock is broken.
770
771 # Notes on the Specialix SI/XIO driver:
772 #  The host card is memory, not IO mapped.
773 #  The Rev 1 host cards use a 64K chunk, on a 32K boundary.
774 #  The Rev 2 host cards use a 32K chunk, on a 32K boundary.
775 #  The cards can use an IRQ of 11, 12 or 15.
776
777 # Notes on the Sony Programmable I/O controller
778 #  This is a temporary driver that should someday be replaced by something
779 #  that hooks into the ACPI layer.  The device is hooked to the PIIX4's
780 #  General Device 10 decoder, which means you have to fiddle with PCI
781 #  registers to map it in, even though it is otherwise treated here as
782 #  an ISA device.  At the moment, the driver polls, although the device
783 #  is capable of generating interrupts.  It largely undocumented.
784 #  The port location in the hint is where you WANT the device to be
785 #  mapped.  0x10a0 seems to be traditional.  At the moment the jogdial
786 #  is the only thing truly supported, but apparently a fair percentage
787 #  of the Vaio extra features are controlled by this device.
788
789 device          apm
790 hint.apm.0.flags="0x20"
791 device          ipmi
792 device          smapi
793 device          smbios
794 device          vpd
795 device          pmtimer                 # Adjust system timer at wakeup time
796 device          cy
797 options         CY_PCI_FASTINTR         # Use with cy_pci unless irq is shared
798 hint.cy.0.at="isa"
799 hint.cy.0.irq="10"
800 hint.cy.0.maddr="0xd4000"
801 hint.cy.0.msize="0x2000"
802 device          digi
803 hint.digi.0.at="isa"
804 hint.digi.0.port="0x104"
805 hint.digi.0.maddr="0xd0000"
806 # BIOS & FEP/OS components of device digi.
807 device          digi_CX
808 device          digi_CX_PCI
809 device          digi_EPCX
810 device          digi_EPCX_PCI
811 device          digi_Xe
812 device          digi_Xem
813 device          digi_Xr
814 # Parallel (8255 PPI) basic I/O (mode 0) port (e.g. Advantech PCL-724)
815 device          pbio
816 hint.pbio.0.at="isa"
817 hint.pbio.0.port="0x360"
818 device          spic
819 hint.spic.0.at="isa"
820 hint.spic.0.port="0x10a0"
821 # HOT1 Xilinx 6200 card (http://www.vcc.com/)
822 device          xrpu
823
824 #
825 # Laptop/Notebook options:
826 #
827 # See also:
828 #  apm under `Miscellaneous hardware'
829 # above.
830
831 # For older notebooks that signal a powerfail condition (external
832 # power supply dropped, or battery state low) by issuing an NMI:
833
834 options         POWERFAIL_NMI   # make it beep instead of panicing
835
836 #
837 # I2C Bus
838 #
839 # Philips i2c bus support is provided by the `iicbus' device.
840 #
841 # Supported interfaces:
842 # pcf   Philips PCF8584 ISA-bus controller
843 #
844 device          pcf
845 hint.pcf.0.at="isa"
846 hint.pcf.0.port="0x320"
847 hint.pcf.0.irq="5"
848
849 #
850 # Hardware watchdog timers:
851 #
852 # ichwd: Intel ICH watchdog timer
853 #
854 device          ichwd
855
856 #
857 # Temperature sensors:
858 #
859 # coretemp: on-die sensor on Intel Core and newer CPUs
860 #
861 device          coretemp
862
863 #---------------------------------------------------------------------------
864 # ISDN4BSD
865 #
866 # See /usr/share/examples/isdn/ROADMAP for an introduction to isdn4bsd.
867 #
868 # i4b passive ISDN cards support contains the following hardware drivers:
869 #
870 #       isic  - Siemens/Infineon ISDN ISAC/HSCX/IPAC chipset driver
871 #       iwic  - Winbond W6692 PCI bus ISDN S/T interface controller
872 #       ifpi  - AVM Fritz!Card PCI driver
873 #       ifpi2  - AVM Fritz!Card PCI version 2 driver
874 #       ihfc  - Cologne Chip HFC ISA/ISA-PnP chipset driver
875 #       ifpnp - AVM Fritz!Card PnP driver
876 #       itjc  - Siemens ISAC / TJNet Tiger300/320 chipset
877 #
878 # i4b active ISDN cards support contains the following hardware drivers:
879 #
880 #       iavc  - AVM B1 PCI, AVM B1 ISA, AVM T1
881 #
882 # Note that the ``options'' (if given) and ``device'' lines must BOTH
883 # be uncommented to enable support for a given card !
884 #
885 # In addition to a hardware driver (and probably an option) the mandatory
886 # ISDN protocol stack devices and the mandatory support device must be
887 # enabled as well as one or more devices from the optional devices section.
888 #
889 #---------------------------------------------------------------------------
890 #       isic driver (Siemens/Infineon chipsets)
891 #
892 device  isic
893 #
894 # ISA bus non-PnP Cards:
895 # ----------------------
896 #
897 # Teles S0/8 or Niccy 1008
898 options         TEL_S0_8
899 hint.isic.0.at="isa"
900 hint.isic.0.maddr="0xd0000"
901 hint.isic.0.irq="5"
902 hint.isic.0.flags="1"
903 #
904 # Teles S0/16 or Creatix ISDN-S0 or Niccy 1016
905 options         TEL_S0_16
906 hint.isic.0.at="isa"
907 hint.isic.0.port="0xd80"
908 hint.isic.0.maddr="0xd0000"
909 hint.isic.0.irq="5"
910 hint.isic.0.flags="2"
911 #
912 # Teles S0/16.3
913 options         TEL_S0_16_3
914 hint.isic.0.at="isa"
915 hint.isic.0.port="0xd80"
916 hint.isic.0.irq="5"
917 hint.isic.0.flags="3"
918 #
919 # AVM A1 or AVM Fritz!Card
920 options         AVM_A1
921 hint.isic.0.at="isa"
922 hint.isic.0.port="0x340"
923 hint.isic.0.irq="5"
924 hint.isic.0.flags="4"
925 #
926 # USRobotics Sportster ISDN TA intern
927 options         USR_STI
928 hint.isic.0.at="isa"
929 hint.isic.0.port="0x268"
930 hint.isic.0.irq="5"
931 hint.isic.0.flags="7"
932 #
933 # ITK ix1 Micro ( < V.3, non-PnP version )
934 options         ITKIX1
935 hint.isic.0.at="isa"
936 hint.isic.0.port="0x398"
937 hint.isic.0.irq="10"
938 hint.isic.0.flags="18"
939 #
940 # ELSA PCC-16
941 options         ELSA_PCC16
942 hint.isic.0.at="isa"
943 hint.isic.0.port="0x360"
944 hint.isic.0.irq="10"
945 hint.isic.0.flags="20"
946 #
947 # ISA bus PnP Cards:
948 # ------------------
949 #
950 # Teles S0/16.3 PnP
951 options         TEL_S0_16_3_P
952 #
953 # Creatix ISDN-S0 P&P
954 options         CRTX_S0_P
955 #
956 # Dr. Neuhaus Niccy Go@
957 options         DRN_NGO
958 #
959 # Sedlbauer Win Speed
960 options         SEDLBAUER
961 #
962 # Dynalink IS64PH
963 options         DYNALINK
964 #
965 # ELSA QuickStep 1000pro ISA
966 options         ELSA_QS1ISA
967 #
968 # Siemens I-Surf 2.0
969 options         SIEMENS_ISURF2
970 #
971 # Asuscom ISDNlink 128K ISA
972 options         ASUSCOM_IPAC
973 #
974 # Eicon Diehl DIVA 2.0 and 2.02
975 options         EICON_DIVA
976 #
977 # Compaq Microcom 610 ISDN card (Compaq series PSB2222I)
978 options         COMPAQ_M610
979 #
980 # PCI bus Cards:
981 # --------------
982 #
983 # ELSA MicroLink ISDN/PCI (same as ELSA QuickStep 1000pro PCI)
984 options         ELSA_QS1PCI
985 #
986 #---------------------------------------------------------------------------
987 #       ifpnp driver for AVM Fritz!Card PnP
988 #
989 # AVM Fritz!Card PnP
990 device          ifpnp
991 #
992 #---------------------------------------------------------------------------
993 #       ihfc driver for Cologne Chip ISA chipsets (experimental!)
994 #
995 # Teles 16.3c ISA PnP
996 # AcerISDN P10 ISA PnP
997 # TELEINT ISDN SPEED No.1
998 device          ihfc
999 #
1000 #---------------------------------------------------------------------------
1001 #       ifpi driver for AVM Fritz!Card PCI
1002 #
1003 # AVM Fritz!Card PCI
1004 device          ifpi
1005 #
1006 #---------------------------------------------------------------------------
1007 #       ifpi2 driver for AVM Fritz!Card PCI version 2
1008 #
1009 # AVM Fritz!Card PCI version 2
1010 device          ifpi2
1011 #
1012 #---------------------------------------------------------------------------
1013 #       iwic driver for Winbond W6692 chipset
1014 #
1015 # ASUSCOM P-IN100-ST-D (and other Winbond W6692 based cards)
1016 device          iwic
1017 #
1018 #---------------------------------------------------------------------------
1019 #       itjc driver for Siemens ISAC / TJNet Tiger300/320 chipset
1020 #
1021 # Traverse Technologies NETjet-S
1022 # Teles PCI-TJ
1023 device          itjc
1024 #
1025 #---------------------------------------------------------------------------
1026 #       iavc driver (AVM active cards, needs i4bcapi driver!)
1027 #
1028 device          iavc
1029 #
1030 # AVM B1 ISA bus (PnP mode not supported!)
1031 # ----------------------------------------
1032 hint.iavc.0.at="isa"
1033 hint.iavc.0.port="0x150"
1034 hint.iavc.0.irq="5"
1035 #
1036 #---------------------------------------------------------------------------
1037 #       ISDN Protocol Stack - mandatory for all hardware drivers
1038 #
1039 # Q.921 / layer 2 - i4b passive cards D channel handling
1040 device          i4bq921
1041 #
1042 # Q.931 / layer 3 - i4b passive cards D channel handling
1043 device          i4bq931
1044 #
1045 # layer 4 - i4b common passive and active card handling
1046 device          i4b
1047 #
1048 #---------------------------------------------------------------------------
1049 #       ISDN devices - mandatory for all hardware drivers
1050 #
1051 # userland driver to do ISDN tracing (for passive cards only)
1052 device          i4btrc
1053 options         NI4BTRC=4
1054 #
1055 # userland driver to control the whole thing
1056 device          i4bctl
1057 #
1058 #---------------------------------------------------------------------------
1059 #       ISDN devices - optional
1060 #
1061 # userland driver for access to raw B channel
1062 device          i4brbch
1063 options         NI4BRBCH=4
1064 #
1065 # userland driver for telephony
1066 device          i4btel
1067 options         NI4BTEL=2
1068 #
1069 #XXXBZ# IPR and ISPPP are not usable until I4B is locked.
1070 # network driver for IP over raw HDLC ISDN
1071 #XXXBZ#device           i4bipr
1072 #XXXBZ#options  NI4BIPR=4
1073 # enable VJ header compression detection for ipr i/f
1074 #XXXBZ#options  IPR_VJ
1075 # enable logging of the first n IP packets to isdnd (n=32 here)
1076 #XXXBZ#options  IPR_LOG=32
1077 #
1078 # network driver for sync PPP over ISDN; requires an equivalent
1079 # number of sppp device to be configured
1080 #XXXBZ#device           i4bisppp
1081 #XXXBZ#options  NI4BISPPP=4
1082 #
1083 # B-channel interface to the netgraph subsystem
1084 #XXXBZ#device           i4bing
1085 #XXXBZ#options  NI4BING=2
1086 #
1087 # CAPI driver needed for active ISDN cards (see iavc driver above)
1088 device          i4bcapi
1089 #
1090 #---------------------------------------------------------------------------
1091
1092 #
1093 # System Management Bus (SMB)
1094 #
1095 options         ENABLE_ALART            # Control alarm on Intel intpm driver
1096
1097 #
1098 # Set the number of PV entries per process.  Increasing this can
1099 # stop panics related to heavy use of shared memory.  However, that can
1100 # (combined with large amounts of physical memory) cause panics at
1101 # boot time due the kernel running out of VM space.
1102 #
1103 # If you're tweaking this, you might also want to increase the sysctls
1104 # "vm.v_free_min", "vm.v_free_reserved", and "vm.v_free_target".
1105 #
1106 # The value below is the one more than the default.
1107 #
1108 options         PMAP_SHPGPERPROC=201
1109
1110 #
1111 # Change the size of the kernel virtual address space.  Due to
1112 # constraints in loader(8) on i386, this must be a multiple of 4.
1113 # 256 = 1 GB of kernel address space.  Increasing this also causes
1114 # a reduction of the address space in user processes.  512 splits
1115 # the 4GB cpu address space in half (2GB user, 2GB kernel).  For PAE
1116 # kernels, the value will need to be double non-PAE.  A value of 1024
1117 # for PAE kernels is necessary to split the address space in half.
1118 # This will likely need to be increased to handle memory sizes >4GB.
1119 # PAE kernels default to a value of 512.
1120 #
1121 options         KVA_PAGES=260
1122
1123 \f
1124 #####################################################################
1125 # ABI Emulation
1126
1127 # Enable iBCS2 runtime support for SCO and ISC binaries
1128 options         IBCS2
1129
1130 # Emulate spx device for client side of SVR3 local X interface
1131 options         SPX_HACK
1132
1133 # Enable Linux ABI emulation
1134 options         COMPAT_LINUX
1135
1136 # Enable i386 a.out binary support
1137 options         COMPAT_AOUT
1138
1139 # Enable the linux-like proc filesystem support (requires COMPAT_LINUX
1140 # and PSEUDOFS)
1141 options         LINPROCFS
1142
1143 #Enable the linux-like sys filesystem support (requires COMPAT_LINUX
1144 # and PSEUDOFS)
1145 options         LINSYSFS
1146
1147 #
1148 # SysVR4 ABI emulation
1149 #
1150 # The svr4 ABI emulator can be statically compiled into the kernel or loaded as
1151 # a KLD module.
1152 # The STREAMS network emulation code can also be compiled statically or as a
1153 # module.  If loaded as a module, it must be loaded before the svr4 module
1154 # (the /usr/sbin/svr4 script does this for you).  If compiling statically,
1155 # the `streams' device must be configured into any kernel which also
1156 # specifies COMPAT_SVR4.  It is possible to have a statically-configured
1157 # STREAMS device and a dynamically loadable svr4 emulator;  the /usr/sbin/svr4
1158 # script understands that it doesn't need to load the `streams' module under
1159 # those circumstances.
1160 # Caveat:  At this time, `options KTRACE' is required for the svr4 emulator
1161 # (whether static or dynamic).
1162 #
1163 options         COMPAT_SVR4     # build emulator statically
1164 options         DEBUG_SVR4      # enable verbose debugging
1165 device          streams         # STREAMS network driver (required for svr4).
1166
1167 # Enable NDIS binary driver support
1168 options         NDISAPI
1169 device          ndis
1170
1171 \f
1172 #####################################################################
1173 # VM OPTIONS
1174
1175 # Disable the 4 MByte page PSE CPU feature.  The PSE feature allows the
1176 # kernel to use 4 MByte pages to map the kernel instead of 4k pages.
1177 # This saves on the amount of memory needed for page tables needed to
1178 # map the kernel.  You should only disable this feature as a temporary
1179 # workaround if you are having problems with it enabled.
1180 #
1181 #options        DISABLE_PSE
1182
1183 # Disable the global pages PGE CPU feature.  The PGE feature allows pages
1184 # to be marked with the PG_G bit.  TLB entries for these pages are not
1185 # flushed from the cache when %cr3 is reloaded.  This can make context
1186 # switches less expensive.  You should only disable this feature as a
1187 # temporary workaround if you are having problems with it enabled.
1188 #
1189 #options        DISABLE_PG_G
1190
1191 # KSTACK_PAGES is the number of memory pages to assign to the kernel
1192 # stack of each thread.
1193
1194 options         KSTACK_PAGES=3
1195
1196 #####################################################################
1197
1198 # More undocumented options for linting.
1199 # Note that documenting these are not considered an affront.
1200
1201 options         FB_INSTALL_CDEV         # install a CDEV entry in /dev
1202
1203 # PECOFF module (Win32 Execution Format)
1204 options         PECOFF_SUPPORT
1205 options         PECOFF_DEBUG
1206
1207 options         I4B_SMP_WORKAROUND
1208 options         I586_PMC_GUPROF=0x70000
1209 options         KBDIO_DEBUG=2
1210 options         KBD_MAXRETRY=4
1211 options         KBD_MAXWAIT=6
1212 options         KBD_RESETDELAY=201
1213
1214 options         PSM_DEBUG=1
1215
1216 options         TIMER_FREQ=((14318182+6)/12)
1217
1218 options         VM_KMEM_SIZE
1219 options         VM_KMEM_SIZE_MAX
1220 options         VM_KMEM_SIZE_SCALE
1221
1222 \f
1223 # asr old ioctls support, needed by raidutils
1224
1225 options         ASR_COMPAT