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 # Enable the kernel DTrace hooks which are required to load the DTrace
21 #####################################################################
26 # IPI_PREEMPTION instructs the kernel to preempt threads running on other
27 # CPUS if needed. Relies on the PREEMPTION option
30 options IPI_PREEMPTION
31 device atpic # Optional legacy pic support
32 device mptable # Optional MPSPEC mptable support
41 #####################################################################
45 # You must specify at least one CPU (the one you intend to run on);
46 # deleting the specification for CPUs you don't need to use may make
47 # parts of the system run faster.
49 cpu HAMMER # aka K8, aka Opteron & Athlon64
52 # Options for CPU features.
56 # PERFMON causes the driver for Pentium/Pentium Pro performance counters
57 # to be compiled. See perfmon(4) for more information.
62 #####################################################################
66 # DEVICE_POLLING adds support for mixed interrupt-polling handling
67 # of network device drivers, which has significant benefits in terms
68 # of robustness to overloads and responsivity, as well as permitting
69 # accurate scheduling of the CPU time between kernel network processing
70 # and other activities. The drawback is a moderate (up to 1/HZ seconds)
71 # potential increase in response times.
72 # It is strongly recommended to use HZ=1000 or 2000 with DEVICE_POLLING
73 # to achieve smoother behaviour.
74 # Additionally, you can enable/disable polling at runtime with help of
75 # the ifconfig(8) utility, and select the CPU fraction reserved to
76 # userland with the sysctl variable kern.polling.user_frac
77 # (default 50, range 0..100).
79 # Not all device drivers support this mode of operation at the time of
80 # this writing. See polling(4) for more details.
82 options DEVICE_POLLING
84 # BPF_JITTER adds support for BPF just-in-time compiler.
89 #####################################################################
92 # Provide read/write access to the memory in the clock chip.
93 device nvram # Access to rtc cmos via /dev/nvram
96 #####################################################################
97 # MISCELLANEOUS DEVICES AND OPTIONS
99 device speaker #Play IBM BASIC-style noises out your speaker
100 hint.speaker.0.at="isa"
101 hint.speaker.0.port="0x61"
102 device gzip #Exec gzipped a.out's. REQUIRES COMPAT_AOUT!
105 #####################################################################
106 # HARDWARE BUS CONFIGURATION
116 # AUTO_EOI_1 enables the `automatic EOI' feature for the master 8259A
117 # interrupt controller. This saves about 0.7-1.25 usec for each interrupt.
118 # This option breaks suspend/resume on some portables.
120 # AUTO_EOI_2 enables the `automatic EOI' feature for the slave 8259A
121 # interrupt controller. This saves about 0.7-1.25 usec for each interrupt.
122 # Automatic EOI is documented not to work for for the slave with the
123 # original i8259A, but it works for some clones and some integrated
126 # MAXMEM specifies the amount of RAM on the machine; if this is not
127 # specified, FreeBSD will first read the amount of memory from the CMOS
128 # RAM, so the amount of memory will initially be limited to 64MB or 16MB
129 # depending on the BIOS. If the BIOS reports 64MB, a memory probe will
130 # then attempt to detect the installed amount of RAM. If this probe
131 # fails to detect >64MB RAM you will have to use the MAXMEM option.
132 # The amount is in kilobytes, so for a machine with 128MB of RAM, it would
133 # be 131072 (128 * 1024).
135 # BROKEN_KEYBOARD_RESET disables the use of the keyboard controller to
136 # reset the CPU for reboot. This is needed on some systems with broken
137 # keyboard controllers.
142 options MAXMEM=(128*1024)
143 #options BROKEN_KEYBOARD_RESET
146 # PCI bus & PCI options:
160 #####################################################################
161 # HARDWARE DEVICE CONFIGURATION
163 # To include support for VGA VESA video modes
166 # Turn on extra debugging checks and output for VESA support.
169 device dpms # DPMS suspend & resume via VESA BIOS
171 # x86 real mode BIOS emulator, required by atkbdc/dpms/vesa
180 hint.psm.0.at="atkbdc"
184 options PSM_HOOKRESUME #hook the system resume event, useful
186 options PSM_RESETAFTERSUSPEND #reset the device at the resume event
188 # The keyboard controller; it controls the keyboard and the PS/2 mouse.
190 hint.atkbdc.0.at="isa"
191 hint.atkbdc.0.port="0x060"
195 hint.atkbd.0.at="atkbdc"
199 options ATKBD_DFLT_KEYMAP # specify the built-in keymap
200 makeoptions ATKBD_DFLT_KEYMAP=jp.106
203 # 0x01 Force detection of keyboard, else we always assume a keyboard
204 # 0x02 Don't reset keyboard, useful for some newer ThinkPads
205 # 0x03 Force detection and avoid reset, might help with certain
207 # 0x04 Old-style (XT) keyboard support, useful for older ThinkPads
209 # Video card driver for VGA adapters.
214 # Try the following option if the mouse pointer is not drawn correctly
215 # or font does not seem to be loaded properly. May cause flicker on
217 options VGA_ALT_SEQACCESS
219 # If you can dispense with some vga driver features, you may want to
220 # use the following options to save some memory.
221 #options VGA_NO_FONT_LOADING # don't save/load font
222 #options VGA_NO_MODE_CHANGE # don't change video modes
224 # Older video cards may require this option for proper operation.
225 options VGA_SLOW_IOACCESS # do byte-wide i/o's to TS and GDC regs
227 # The following option probably won't work with the LCD displays.
228 options VGA_WIDTH90 # support 90 column modes
233 # Linear framebuffer driver for S3 VESA 1.2 cards. Works on top of VESA.
236 # 3Dfx Voodoo Graphics, Voodoo II /dev/3dfx CDEV support. This will create
237 # the /dev/3dfx0 device to work with glide implementations. This should get
238 # linked to /dev/3dfx and /dev/voodoo. Note that this is not the same as
239 # the tdfx DRI module from XFree86 and is completely unrelated.
241 # To enable Linuxulator support, one must also include COMPAT_LINUX in the
242 # config as well. The other option is to load both as modules.
244 device tdfx # Enable 3Dfx Voodoo support
245 #XXX#device tdfx_linux # Enable Linuxulator support
248 # ACPI support using the Intel ACPI Component Architecture reference
251 # ACPI_DEBUG enables the use of the debug.acpi.level and debug.acpi.layer
252 # kernel environment variables to select initial debugging levels for the
253 # Intel ACPICA code. (Note that the Intel code must also have USE_DEBUGGER
254 # defined when it is built).
259 # The cpufreq(4) driver provides support for non-ACPI CPU frequency control
262 # Direct Rendering modules for 3D acceleration.
263 device drm # DRM core module required by DRM drivers
264 device i915drm # Intel i830 through i915
265 device mach64drm # ATI Rage Pro, Rage Mobility P/M, Rage XL
266 device mgadrm # AGP Matrox G200, G400, G450, G550
267 device r128drm # ATI Rage 128
268 device radeondrm # ATI Radeon
269 device savagedrm # S3 Savage3D, Savage4
270 device sisdrm # SiS 300/305, 540, 630
271 device tdfxdrm # 3dfx Voodoo 3/4/5 and Banshee
272 options DRM_DEBUG # Include debug printfs (slow)
275 # Network interfaces:
278 # ed: Western Digital and SMC 80xx; Novell NE1000 and NE2000; 3Com 3C503
279 # HP PC Lan+, various PC Card devices
281 # ipw: Intel PRO/Wireless 2100 IEEE 802.11 adapter
282 # Requires the ipw firmware module
283 # iwi: Intel PRO/Wireless 2200BG/2225BG/2915ABG IEEE 802.11 adapters
284 # Requires the iwi firmware module
285 # iwn: Intel Wireless WiFi Link 4965/1000/5000/6000 802.11 network adapters
286 # Requires the iwn firmware module
287 # mwl: Marvell 88W8363 IEEE 802.11 adapter
288 # Requires the mwl firmware module
289 # nfe: nVidia nForce MCP on-board Ethernet Networking (BSD open source)
290 # nve: nVidia nForce MCP on-board Ethernet Networking
291 # ral: Ralink Technology IEEE 802.11 wireless adapter
292 # wpi: Intel 3945ABG Wireless LAN controller
293 # Requires the wpi firmware module
308 device ath # Atheros pci/cardbus NIC's
309 device ath_hal # pci/cardbus chip support
310 options AH_SUPPORT_AR5416 # enable AR5416 tx/rx descriptors
311 device ath_rate_sample # SampleRate tx rate control for ath
312 #device ath_rate_amrr # AMRR rate control for ath driver
313 #device ath_rate_onoe # Onoe rate control for ath driver
315 # IEEE 802.11 adapter firmware modules
317 # Intel PRO/Wireless 2100 firmware:
318 # ipwfw: BSS/IBSS/monitor mode firmware
319 # ipwbssfw: BSS mode firmware
320 # ipwibssfw: IBSS mode firmware
321 # ipwmonitorfw: Monitor mode firmware
322 # Intel PRO/Wireless 2200BG/2225BG/2915ABG firmware:
323 # iwifw: BSS/IBSS/monitor mode firmware
324 # iwibssfw: BSS mode firmware
325 # iwiibssfw: IBSS mode firmware
326 # iwimonitorfw: Monitor mode firmware
327 # Intel Wireless WiFi Link 4965/1000/5000/6000 series firmware:
328 # iwnfw: Single module to support the 4965/1000/5000/5150/6000
329 # iwn4965fw: Specific module for the 4965 only
330 # iwn1000fw: Specific module for the 1000 only
331 # iwn5000fw: Specific module for the 5000 only
332 # iwn5150fw: Specific module for the 5150 only
333 # iwn6000fw: Specific module for the 6000 only
334 # iwn6050fw: Specific module for the 6050 only
335 # mwlfw: Marvell 88W8363 firmware
336 # wpifw: Intel 3945ABG Wireless LAN Controller firmware
357 #XXX this stores pointers in a 32bit field that is defined by the hardware
361 # Areca 11xx and 12xx series of SATA II RAID controllers.
364 device arcmsr # Areca SATA II RAID
367 # 3ware 9000 series PATA/SATA RAID controller driver and options.
368 # The driver is implemented as a SIM, and so, needs the CAM infrastructure.
370 options TWA_DEBUG # 0-10; 10 prints the most messages.
371 options TWA_FLASH_FIRMWARE # firmware image bundled when defined.
372 device twa # 3ware 9000 series PATA/SATA RAID
375 # SCSI host adapters:
377 # ncv: NCR 53C500 based SCSI host adapters.
378 # nsp: Workbit Ninja SCSI-3 based PC Card SCSI host adapters.
379 # stg: TMC 18C30, 18C50 based SCSI host adapters.
386 # Adaptec FSA RAID controllers, including integrated DELL controllers,
387 # the Dell PERC 2/QC and the HP NetRAID-4M
389 device aacp # SCSI Passthrough interface (optional, CAM required)
392 # Highpoint RocketRAID 182x.
396 # Highpoint RocketRAID. Supports RR172x, RR222x, RR2240, RR232x, RR2340,
397 # RR2210, RR174x, RR2522, RR231x, RR230x.
401 # Highpoint RocketRaid 3xxx series SATA RAID
405 # IBM (now Adaptec) ServeRAID controllers
409 # SafeNet crypto driver: can be moved to the MI NOTES as soon as
410 # it's tested on a big-endian machine
412 device safe # SafeNet 1141
413 options SAFE_DEBUG # enable debugging support: hw.safe.debug
414 options SAFE_RNDTEST # enable rndtest support
416 #####################################################################
419 # Miscellaneous hardware:
421 # ipmi: Intelligent Platform Management Interface
422 # pbio: Parallel (8255 PPI) basic I/O (mode 0) port (e.g. Advantech PCL-724)
423 # smbios: DMI/SMBIOS entry point
424 # vpd: Vital Product Data kernel interface
425 # asmc: Apple System Management Controller
426 # si: Specialix International SI/XIO or SX intelligent serial card
427 # tpm: Trusted Platform Module
429 # Notes on the Specialix SI/XIO driver:
430 # The host card is memory, not IO mapped.
431 # The Rev 1 host cards use a 64K chunk, on a 32K boundary.
432 # The Rev 2 host cards use a 32K chunk, on a 32K boundary.
433 # The cards can use an IRQ of 11, 12 or 15.
438 hint.pbio.0.port="0x360"
446 # Laptop/Notebook options:
455 # Hardware watchdog timers:
457 # ichwd: Intel ICH watchdog timer
458 # amdsbwd: AMD SB7xx watchdog timer
464 # Temperature sensors:
466 # coretemp: on-die sensor on Intel Core and newer CPUs
467 # amdtemp: on-die sensor on AMD K8/K10/K11 CPUs
473 # CPU control pseudo-device. Provides access to MSRs, CPUID info and
474 # microcode update feature.
479 # System Management Bus (SMB)
481 options ENABLE_ALART # Control alarm on Intel intpm driver
484 # Set the number of PV entries per process. Increasing this can
485 # stop panics related to heavy use of shared memory. However, that can
486 # (combined with large amounts of physical memory) cause panics at
487 # boot time due the kernel running out of VM space.
489 # If you're tweaking this, you might also want to increase the sysctls
490 # "vm.v_free_min", "vm.v_free_reserved", and "vm.v_free_target".
492 # The value below is the one more than the default.
494 options PMAP_SHPGPERPROC=201
497 #####################################################################
500 #XXX keep these here for now and reactivate when support for emulating
501 #XXX these 32 bit binaries is added.
503 # Enable 32-bit runtime support for FreeBSD/i386 binaries.
504 options COMPAT_FREEBSD32
506 # Enable iBCS2 runtime support for SCO and ISC binaries
509 # Emulate spx device for client side of SVR3 local X interface
510 #XXX#options SPX_HACK
512 # Enable Linux ABI emulation
513 #XXX#options COMPAT_LINUX
515 # Enable 32-bit Linux ABI emulation (requires COMPAT_43 and COMPAT_FREEBSD32)
516 options COMPAT_LINUX32
518 # Enable the linux-like proc filesystem support (requires COMPAT_LINUX32
522 #Enable the linux-like sys filesystem support (requires COMPAT_LINUX32
527 # SysVR4 ABI emulation
529 # The svr4 ABI emulator can be statically compiled into the kernel or loaded as
531 # The STREAMS network emulation code can also be compiled statically or as a
532 # module. If loaded as a module, it must be loaded before the svr4 module
533 # (the /usr/sbin/svr4 script does this for you). If compiling statically,
534 # the `streams' device must be configured into any kernel which also
535 # specifies COMPAT_SVR4. It is possible to have a statically-configured
536 # STREAMS device and a dynamically loadable svr4 emulator; the /usr/sbin/svr4
537 # script understands that it doesn't need to load the `streams' module under
538 # those circumstances.
539 # Caveat: At this time, `options KTRACE' is required for the svr4 emulator
540 # (whether static or dynamic).
542 #XXX#options COMPAT_SVR4 # build emulator statically
543 #XXX#options DEBUG_SVR4 # enable verbose debugging
544 #XXX#device streams # STREAMS network driver (required for svr4).
547 #####################################################################
550 # KSTACK_PAGES is the number of memory pages to assign to the kernel
551 # stack of each thread.
553 options KSTACK_PAGES=3
555 #####################################################################
557 # More undocumented options for linting.
558 # Note that documenting these are not considered an affront.
560 options FB_INSTALL_CDEV # install a CDEV entry in /dev
562 options KBDIO_DEBUG=2
563 options KBD_MAXRETRY=4
564 options KBD_MAXWAIT=6
565 options KBD_RESETDELAY=201
569 options TIMER_FREQ=((14318182+6)/12)
572 options VM_KMEM_SIZE_MAX
573 options VM_KMEM_SIZE_SCALE
575 # Enable NDIS binary driver support
579 # Linux-specific pseudo devices support