2 # NOTES -- Lines that can be cut/pasted into kernel and hints configs.
4 # This file contains machine dependent kernel configuration notes. For
5 # machine independent notes, look in /sys/conf/NOTES.
11 # We want LINT to cover profiling as well.
15 #####################################################################
20 # IPI_PREEMPTION instructs the kernel to preempt threads running on other
21 # CPUS if needed. Relies on the PREEMPTION option
24 options IPI_PREEMPTION
25 device atpic # Optional legacy pic support
26 device mptable # Optional MPSPEC mptable support
36 options STOP_NMI # Stop CPUS using NMI instead of IPI
40 #####################################################################
44 # You must specify at least one CPU (the one you intend to run on);
45 # deleting the specification for CPUs you don't need to use may make
46 # parts of the system run faster.
48 cpu HAMMER # aka K8, aka Opteron & Athlon64
51 # Options for CPU features.
55 # PERFMON causes the driver for Pentium/Pentium Pro performance counters
56 # to be compiled. See perfmon(4) for more information.
61 #####################################################################
65 # DEVICE_POLLING adds support for mixed interrupt-polling handling
66 # of network device drivers, which has significant benefits in terms
67 # of robustness to overloads and responsivity, as well as permitting
68 # accurate scheduling of the CPU time between kernel network processing
69 # and other activities. The drawback is a moderate (up to 1/HZ seconds)
70 # potential increase in response times.
71 # It is strongly recommended to use HZ=1000 or 2000 with DEVICE_POLLING
72 # to achieve smoother behaviour.
73 # Additionally, you can enable/disable polling at runtime with help of
74 # the ifconfig(8) utility, and select the CPU fraction reserved to
75 # userland with the sysctl variable kern.polling.user_frac
76 # (default 50, range 0..100).
78 # Not all device drivers support this mode of operation at the time of
79 # this writing. See polling(4) for more details.
81 options DEVICE_POLLING
84 #####################################################################
87 # The following options are used for debugging clock behavior only, and
88 # should not be used for production systems.
90 # CLK_CALIBRATION_LOOP causes clock calibration to be run in a loop at
91 # startup until the user presses a key. (The i8254 clock is always
92 # calibrated relative to the RTC (mc146818a) and this option causes the
93 # calibration to be repeated.)
94 options CLK_CALIBRATION_LOOP
96 # CLK_USE_I8254_CALIBRATION causes the calibrated frequency of the i8254
97 # clock to actually be used.
98 options CLK_USE_I8254_CALIBRATION
101 #####################################################################
102 # MISCELLANEOUS DEVICES AND OPTIONS
105 # sio: serial ports (see sio(4)), including support for various
106 # PC Card devices, such as Modem and NICs
110 hint.sio.0.port="0x3F8"
111 hint.sio.0.flags="0x10"
114 # `flags' specific to sio(4).
115 # 0x10 enable console support for this unit. Other console flags
116 # (if applicable) are ignored unless this is set. Enabling
117 # console support does not make the unit the preferred console.
118 # Boot with -h or set boot_serial=YES in the loader. For sio(4)
119 # specifically, the 0x20 flag can also be set (see above).
120 # Currently, at most one unit can have console support; the
121 # first one (in config file order) with this flag set is
122 # preferred. Setting this flag for sio0 gives the old behaviour.
123 # 0x20 force this unit to be the console (unless there is another
124 # higher priority console). This replaces the COMCONSOLE option.
125 # 0x40 reserve this unit for low level console operations. Do not
126 # access the device in any normal way.
127 # 0x80 use this port for serial line gdb support in ddb. Also known
130 # 0x1 disable probing of this device. Used to prevent your modem
131 # from being attached as a PnP modem.
132 # Other flags for sio that aren't documented in the man page.
133 # 0x20000 enable hardware RTS/CTS and larger FIFOs. Only works for
134 # ST16650A-compatible UARTs.
137 options COM_ESP # Code for Hayes ESP.
138 options COM_MULTIPORT # Code for some cards with shared IRQs.
139 options CONSPEED=115200 # Speed for serial console
142 device speaker #Play IBM BASIC-style noises out your speaker
143 hint.speaker.0.at="isa"
144 hint.speaker.0.port="0x61"
145 device gzip #Exec gzipped a.out's. REQUIRES COMPAT_AOUT!
148 #####################################################################
149 # HARDWARE BUS CONFIGURATION
159 # AUTO_EOI_1 enables the `automatic EOI' feature for the master 8259A
160 # interrupt controller. This saves about 0.7-1.25 usec for each interrupt.
161 # This option breaks suspend/resume on some portables.
163 # AUTO_EOI_2 enables the `automatic EOI' feature for the slave 8259A
164 # interrupt controller. This saves about 0.7-1.25 usec for each interrupt.
165 # Automatic EOI is documented not to work for for the slave with the
166 # original i8259A, but it works for some clones and some integrated
169 # MAXMEM specifies the amount of RAM on the machine; if this is not
170 # specified, FreeBSD will first read the amount of memory from the CMOS
171 # RAM, so the amount of memory will initially be limited to 64MB or 16MB
172 # depending on the BIOS. If the BIOS reports 64MB, a memory probe will
173 # then attempt to detect the installed amount of RAM. If this probe
174 # fails to detect >64MB RAM you will have to use the MAXMEM option.
175 # The amount is in kilobytes, so for a machine with 128MB of RAM, it would
176 # be 131072 (128 * 1024).
178 # BROKEN_KEYBOARD_RESET disables the use of the keyboard controller to
179 # reset the CPU for reboot. This is needed on some systems with broken
180 # keyboard controllers.
185 options MAXMEM=(128*1024)
186 #options BROKEN_KEYBOARD_RESET
189 # PCI bus & PCI options:
198 #####################################################################
199 # HARDWARE DEVICE CONFIGURATION
207 hint.psm.0.at="atkbdc"
211 options PSM_HOOKRESUME #hook the system resume event, useful
213 options PSM_RESETAFTERSUSPEND #reset the device at the resume event
215 # The keyboard controller; it controls the keyboard and the PS/2 mouse.
217 hint.atkbdc.0.at="isa"
218 hint.atkbdc.0.port="0x060"
222 hint.atkbd.0.at="atkbdc"
226 options ATKBD_DFLT_KEYMAP # specify the built-in keymap
227 makeoptions ATKBD_DFLT_KEYMAP=jp.106
230 # 0x01 Force detection of keyboard, else we always assume a keyboard
231 # 0x02 Don't reset keyboard, useful for some newer ThinkPads
232 # 0x03 Force detection and avoid reset, might help with certain
234 # 0x04 Old-style (XT) keyboard support, useful for older ThinkPads
236 # Video card driver for VGA adapters.
241 # Try the following option if the mouse pointer is not drawn correctly
242 # or font does not seem to be loaded properly. May cause flicker on
244 options VGA_ALT_SEQACCESS
246 # If you can dispense with some vga driver features, you may want to
247 # use the following options to save some memory.
248 #options VGA_NO_FONT_LOADING # don't save/load font
249 #options VGA_NO_MODE_CHANGE # don't change video modes
251 # Older video cards may require this option for proper operation.
252 options VGA_SLOW_IOACCESS # do byte-wide i/o's to TS and GDC regs
254 # The following option probably won't work with the LCD displays.
255 options VGA_WIDTH90 # support 90 column modes
260 # 3Dfx Voodoo Graphics, Voodoo II /dev/3dfx CDEV support. This will create
261 # the /dev/3dfx0 device to work with glide implementations. This should get
262 # linked to /dev/3dfx and /dev/voodoo. Note that this is not the same as
263 # the tdfx DRI module from XFree86 and is completely unrelated.
265 # To enable Linuxulator support, one must also include COMPAT_LINUX in the
266 # config as well. The other option is to load both as modules.
268 device tdfx # Enable 3Dfx Voodoo support
269 #XXX#device tdfx_linux # Enable Linuxulator support
272 # ACPI support using the Intel ACPI Component Architecture reference
275 # ACPI_DEBUG enables the use of the debug.acpi.level and debug.acpi.layer
276 # kernel environment variables to select initial debugging levels for the
277 # Intel ACPICA code. (Note that the Intel code must also have USE_DEBUGGER
278 # defined when it is built).
280 # ACPI_NO_SEMAPHORES makes the AcpiOs*Semaphore routines a no-op.
284 #!options ACPI_NO_SEMAPHORES
286 # The cpufreq(4) driver provides support for non-ACPI CPU frequency control
289 # Direct Rendering modules for 3D acceleration.
290 device drm # DRM core module required by DRM drivers
291 device i915drm # Intel i830 through i915
292 device mach64drm # ATI Rage Pro, Rage Mobility P/M, Rage XL
293 device mgadrm # AGP Matrox G200, G400, G450, G550
294 device r128drm # ATI Rage 128
295 device radeondrm # ATI Radeon
296 device savagedrm # S3 Savage3D, Savage4
297 device sisdrm # SiS 300/305, 540, 630
298 device tdfxdrm # 3dfx Voodoo 3/4/5 and Banshee
299 options DRM_DEBUG # Include debug printfs (slow)
302 # Network interfaces:
305 # ath: Atheros a/b/g WiFi adapters (requires ath_hal and wlan)
306 # ed: Western Digital and SMC 80xx; Novell NE1000 and NE2000; 3Com 3C503
307 # HP PC Lan+, various PC Card devices
309 # ipw: Intel PRO/Wireless 2100 IEEE 802.11 adapter
310 # iwi: Intel PRO/Wireless 2200BG/2225BG/2915ABG IEEE 802.11 adapters
311 # nfe: nVidia nForce MCP on-board Ethernet Networking (BSD open source)
312 # nve: nVidia nForce MCP on-board Ethernet Networking
313 # ral: Ralink Technology IEEE 802.11 wireless adapter
314 # ural: Ralink Technology RT2500USB IEEE 802.11 wireless adapter
322 device nfe # nVidia nForce MCP on-board Ethernet Networking
323 device nve # nVidia nForce MCP on-board Ethernet Networking
328 device ath_hal # Atheros HAL (includes binary component)
329 #device ath_rate_amrr # AMRR rate control for ath driver
330 #device ath_rate_onoe # Onoe rate control for ath driver
331 device ath_rate_sample # SampleRate rate control for the ath driver
332 #device wlan # 802.11 layer
335 #XXX this stores pointers in a 32bit field that is defined by the hardware
339 # Areca 11xx and 12xx series of SATA II RAID controllers.
342 device arcmsr # Areca SATA II RAID
345 # 3ware 9000 series PATA/SATA RAID controller driver and options.
346 # The driver is implemented as a SIM, and so, needs the CAM infrastructure.
348 options TWA_DEBUG # 0-10; 10 prints the most messages.
349 options TWA_FLASH_FIRMWARE # firmware image bundled when defined.
350 device twa # 3ware 9000 series PATA/SATA RAID
353 # SCSI host adapters:
355 # ncv: NCR 53C500 based SCSI host adapters.
356 # nsp: Workbit Ninja SCSI-3 based PC Card SCSI host adapters.
357 # stg: TMC 18C30, 18C50 based SCSI host adapters.
364 # Adaptec FSA RAID controllers, including integrated DELL controllers,
365 # the Dell PERC 2/QC and the HP NetRAID-4M
367 device aacp # SCSI Passthrough interface (optional, CAM required)
370 # Highpoint RocketRAID 182x. This is really just software RAID on a
375 # Highpoint RocketRAID 232x. This is software RAID but with hardware
376 # acceleration assistance for RAID_5.
380 # Highpoint RocketRaid 3xxx series SATA RAID
384 # IBM (now Adaptec) ServeRAID controllers
388 # SafeNet crypto driver: can be moved to the MI NOTES as soon as
389 # it's tested on a big-endian machine
391 device safe # SafeNet 1141
392 options SAFE_DEBUG # enable debugging support: hw.safe.debug
393 options SAFE_RNDTEST # enable rndtest support
395 #####################################################################
398 # Miscellaneous hardware:
400 # ipmi: Intelligent Platform Management Interface
401 # smbios: DMI/SMBIOS entry point
402 # vpd: Vital Product Data kernel interface
403 # cy: Cyclades serial driver
404 # digi: Digiboard driver
406 # Notes on the Specialix SI/XIO driver:
407 # The host card is memory, not IO mapped.
408 # The Rev 1 host cards use a 64K chunk, on a 32K boundary.
409 # The Rev 2 host cards use a 32K chunk, on a 32K boundary.
410 # The cards can use an IRQ of 11, 12 or 15.
413 options CY_PCI_FASTINTR # Use with cy_pci unless irq is shared
415 # BIOS & FEP/OS components of device digi.
424 # Parallel (8255 PPI) basic I/O (mode 0) port (e.g. Advantech PCL-724)
427 hint.pbio.0.port="0x360"
430 # HOT1 Xilinx 6200 card (http://www.vcc.com/)
434 # Laptop/Notebook options:
443 # Hardware watchdog timers:
445 # ichwd: Intel ICH watchdog timer
449 #---------------------------------------------------------------------------
452 # See /usr/share/examples/isdn/ROADMAP for an introduction to isdn4bsd.
454 # i4b passive ISDN cards support contains the following hardware drivers:
456 # isic - Siemens/Infineon ISDN ISAC/HSCX/IPAC chipset driver
457 # iwic - Winbond W6692 PCI bus ISDN S/T interface controller
458 # ifpi - AVM Fritz!Card PCI driver
459 # ifpi2 - AVM Fritz!Card PCI version 2 driver
460 # itjc - Siemens ISAC / TJNet Tiger300/320 chipset
462 # i4b active ISDN cards support contains the following hardware drivers:
464 # iavc - AVM B1 PCI, AVM B1 ISA, AVM T1
466 # Note that the ``options'' (if given) and ``device'' lines must BOTH
467 # be uncommented to enable support for a given card !
469 # In addition to a hardware driver (and probably an option) the mandatory
470 # ISDN protocol stack devices and the mandatory support device must be
471 # enabled as well as one or more devices from the optional devices section.
473 #---------------------------------------------------------------------------
474 # isic driver (Siemens/Infineon chipsets)
481 # ELSA MicroLink ISDN/PCI (same as ELSA QuickStep 1000pro PCI)
484 #---------------------------------------------------------------------------
485 # ifpi2 driver for AVM Fritz!Card PCI version 2
487 # AVM Fritz!Card PCI version 2
490 #---------------------------------------------------------------------------
491 # iwic driver for Winbond W6692 chipset
493 # ASUSCOM P-IN100-ST-D (and other Winbond W6692 based cards)
496 #---------------------------------------------------------------------------
497 # itjc driver for Siemens ISAC / TJNet Tiger300/320 chipset
499 # Traverse Technologies NETjet-S
503 #---------------------------------------------------------------------------
504 # iavc driver (AVM active cards, needs i4bcapi driver!)
508 #---------------------------------------------------------------------------
509 # ISDN Protocol Stack - mandatory for all hardware drivers
511 # Q.921 / layer 2 - i4b passive cards D channel handling
514 # Q.931 / layer 3 - i4b passive cards D channel handling
517 # layer 4 - i4b common passive and active card handling
520 #---------------------------------------------------------------------------
521 # ISDN devices - mandatory for all hardware drivers
523 # userland driver to do ISDN tracing (for passive cards only)
525 #XXX#options NI4BTRC=4
527 # userland driver to control the whole thing
530 #---------------------------------------------------------------------------
531 # ISDN devices - optional
533 # userland driver for access to raw B channel
535 #XXX#options NI4BRBCH=4
537 # userland driver for telephony
539 #XXX#options NI4BTEL=2
541 # network driver for IP over raw HDLC ISDN
543 #XXX#options NI4BIPR=4
544 # enable VJ header compression detection for ipr i/f
546 # enable logging of the first n IP packets to isdnd (n=32 here)
547 #XXX#options IPR_LOG=32
549 # network driver for sync PPP over ISDN; requires an equivalent
550 # number of sppp device to be configured
552 #XXX#options NI4BISPPP=4
554 # B-channel interface to the netgraph subsystem
556 #XXX#options NI4BING=2
558 # CAPI driver needed for active ISDN cards (see iavc driver above)
561 #---------------------------------------------------------------------------
564 # System Management Bus (SMB)
566 options ENABLE_ALART # Control alarm on Intel intpm driver
569 # Set the number of PV entries per process. Increasing this can
570 # stop panics related to heavy use of shared memory. However, that can
571 # (combined with large amounts of physical memory) cause panics at
572 # boot time due the kernel running out of VM space.
574 # If you're tweaking this, you might also want to increase the sysctls
575 # "vm.v_free_min", "vm.v_free_reserved", and "vm.v_free_target".
577 # The value below is the one more than the default.
579 options PMAP_SHPGPERPROC=201
582 #####################################################################
585 #XXX keep these here for now and reactivate when support for emulating
586 #XXX these 32 bit binaries is added.
588 # Enable 32-bit runtime support for FreeBSD/i386 binaries.
591 # Enable iBCS2 runtime support for SCO and ISC binaries
594 # Emulate spx device for client side of SVR3 local X interface
595 #XXX#options SPX_HACK
597 # Enable Linux ABI emulation
598 #XXX#options COMPAT_LINUX
600 # Enable 32-bit Linux ABI emulation (requires COMPAT_43 and COMPAT_IA32)
601 options COMPAT_LINUX32
603 # Enable the linux-like proc filesystem support (requires COMPAT_LINUX32
607 #Enable the linux-like sys filesystem support (requires COMPAT_LINUX32
612 # SysVR4 ABI emulation
614 # The svr4 ABI emulator can be statically compiled into the kernel or loaded as
616 # The STREAMS network emulation code can also be compiled statically or as a
617 # module. If loaded as a module, it must be loaded before the svr4 module
618 # (the /usr/sbin/svr4 script does this for you). If compiling statically,
619 # the `streams' device must be configured into any kernel which also
620 # specifies COMPAT_SVR4. It is possible to have a statically-configured
621 # STREAMS device and a dynamically loadable svr4 emulator; the /usr/sbin/svr4
622 # script understands that it doesn't need to load the `streams' module under
623 # those circumstances.
624 # Caveat: At this time, `options KTRACE' is required for the svr4 emulator
625 # (whether static or dynamic).
627 #XXX#options COMPAT_SVR4 # build emulator statically
628 #XXX#options DEBUG_SVR4 # enable verbose debugging
629 #XXX#device streams # STREAMS network driver (required for svr4).
632 #####################################################################
635 # KSTACK_PAGES is the number of memory pages to assign to the kernel
636 # stack of each thread.
638 options KSTACK_PAGES=3
640 #####################################################################
642 # More undocumented options for linting.
643 # Note that documenting these are not considered an affront.
645 options FB_INSTALL_CDEV # install a CDEV entry in /dev
647 options KBDIO_DEBUG=2
648 options KBD_MAXRETRY=4
649 options KBD_MAXWAIT=6
650 options KBD_RESETDELAY=201
654 options TIMER_FREQ=((14318182+6)/12)
657 options VM_KMEM_SIZE_MAX
658 options VM_KMEM_SIZE_SCALE
660 # Enable NDIS binary driver support