3 # On the handling of kernel options
5 # All kernel options should be listed in NOTES, with suitable
6 # descriptions. Negative options (options that make some code not
7 # compile) should be commented out; LINT (generated from NOTES) should
8 # compile as much code as possible. Try to structure option-using
9 # code so that a single option only switch code on, or only switch
10 # code off, to make it possible to have a full compile-test. If
11 # necessary, you can check for COMPILING_LINT to get maximum code
14 # All new options shall also be listed in either "conf/options" or
15 # "conf/options.<machine>". Options that affect a single source-file
16 # <xxx>.[c|s] should be directed into "opt_<xxx>.h", while options
17 # that affect multiple files should either go in "opt_global.h" if
18 # this is a kernel-wide option (used just about everywhere), or in
19 # "opt_<option-name-in-lower-case>.h" if it affect only some files.
20 # Note that the effect of listing only an option without a
21 # header-file-name in conf/options (and cousins) is that the last
22 # convention is followed.
24 # This handling scheme is not yet fully implemented.
27 # Format of this file:
28 # Option name filename
30 # If filename is missing, the default is
31 # opt_<name-of-option-in-lower-case>.h
33 # Adaptec Array Controller driver options
34 AAC_DEBUG opt_aac.h # Debugging levels:
35 # 0 - quiet, only emit warnings
36 # 1 - noisy, emit major function
37 # points and things done
38 # 2 - extremely noisy, emit trace
39 # items in loops, etc.
41 # Adaptec aic7xxx SCSI controller options
42 AHC_ALLOW_MEMIO opt_aic7xxx.h # Allow PCI devices to use memory
45 AHC_TMODE_ENABLE opt_aic7xxx.h # Bitmap of units to enable
46 # targetmode operations.
48 AHC_DUMP_EEPROM opt_aic7xxx.h # Dump the contents of our
51 AHC_DEBUG opt_aic7xxx.h # Compile in Aic7xxx Debugging code.
53 AHC_DEBUG_OPTS opt_aic7xxx.h # Aic7xxx driver debugging options.
54 # See sys/dev/aic7xxx/aic7xxx.h
56 AHC_REG_PRETTY_PRINT opt_aic7xxx.h # Print register bitfields in debug
57 # output. Adds ~128k to driver.
59 # Adaptec aic79xx SCSI controller options
60 AHD_DEBUG opt_aic79xx.h # Compile in Aic79xx Debugging code.
62 AHD_DEBUG_OPTS opt_aic79xx.h # Aic79xx driver debugging options.
63 # See sys/dev/aic7xxx/aic79xx.h
65 AHD_TMODE_ENABLE opt_aic79xx.h # Bitmap of units to enable
66 # targetmode operations.
68 AHD_REG_PRETTY_PRINT opt_aic79xx.h # Print register bitfields in debug
69 # output. Adds ~215k to driver.
71 ADW_ALLOW_MEMIO opt_adw.h # Allow PCI devices to use memory
74 # Miscellaneous options.
77 COMPAT_43 opt_compat.h
78 COMPAT_FREEBSD4 opt_compat.h
79 COMPAT_SUNOS opt_compat.h
80 NO_COMPAT_FREEBSD4 opt_compat.h
81 COMPILING_LINT opt_global.h
83 CONSPEED opt_comconsole.h
85 DDB_NOKLDSYM opt_ddb.h
88 GDB_REMOTE_CHAT opt_ddb.h
97 GEOM_SUNLABEL opt_geom.h
102 KTRACE_REQUEST_POOL opt_ktrace.h
105 MD_ROOT_SIZE opt_md.h
108 NTIMECOUNTER opt_ntp.h
110 PANIC_REBOOT_WAIT_TIME opt_panic.h
112 PUC_FASTINTR opt_puc.h
116 SUIDDIR opt_suiddir.h
131 SHMMAXPGS opt_sysvipc.h
135 SYSVMSG opt_sysvipc.h
136 SYSVSEM opt_sysvipc.h
137 SYSVSHM opt_sysvipc.h
139 WLCACHE opt_wavelan.h
140 WLDEBUG opt_wavelan.h
142 # POSIX kernel options
143 _KPOSIX_PRIORITY_SCHEDULING opt_posix.h
144 P1003_1B_SEMAPHORES opt_posix.h
146 #####################################################################
147 # SECURITY POLICY PARAMETERS
149 # Support for Mandatory Access Control (MAC)
151 MAC_BIBA opt_dontuse.h
152 MAC_BSDEXTENDED opt_dontuse.h
154 MAC_IFOFF opt_dontuse.h
155 MAC_LOMAC opt_dontuse.h
156 MAC_MLS opt_dontuse.h
157 MAC_NONE opt_dontuse.h
158 MAC_PARTITION opt_dontuse.h
159 MAC_SEEOTHERUIDS opt_dontuse.h
160 MAC_TEST opt_dontuse.h
162 # Do we want the config file compiled into the kernel?
163 INCLUDE_CONFIG_FILE opt_config.h
165 # Options for static filesystems. These should only be used at config
166 # time, since the corresponding lkms cannot work if there are any static
167 # dependencies. Unusability is enforced by hiding the defines for the
168 # options in a never-included header.
172 FDESCFS opt_dontuse.h
173 LINPROCFS opt_dontuse.h
174 MSDOSFS opt_dontuse.h
177 PORTALFS opt_dontuse.h
179 PSEUDOFS opt_dontuse.h
184 UNIONFS opt_dontuse.h
187 # Broken - ffs_snapshot() dependency from ufs_lookup() :-(
188 FFS opt_ffs_broken_fixme.h
190 # These static filesystems has one slightly bogus static dependency in
191 # sys/i386/i386/autoconf.c. If any of these filesystems are
192 # statically compiled into the kernel, code for mounting them as root
193 # filesystems will be enabled - but look below.
197 # If you are following the conditions in the copyright,
198 # you can enable soft-updates which will speed up a lot of thigs
199 # and make the system safer from crashes at the same time.
200 # otherwise a STUB module will be compiled in.
201 SOFTUPDATES opt_ffs.h
203 # Enabling this option turns on support for Access Control Lists in UFS,
204 # which can be used to support high security configurations. Depends on
208 # Enabling this option turns on support for extended attributes in UFS-based
209 # filesystems, which can be used to support high security configurations
210 # as well as new filesystem features.
211 UFS_EXTATTR opt_ufs.h
212 UFS_EXTATTR_AUTOSTART opt_ufs.h
214 # Enable fast hash lookups for large directories on UFS-based filesystems.
215 UFS_DIRHASH opt_ufs.h
217 # The above static dependencies are planned removed, with a
218 # <filesystem>_ROOT option to control if it usable as root. This list
219 # allows these options to be present in config files already (though
220 # they won't make any difference yet).
221 NFS_ROOT opt_nfsroot.h
225 NETSMBCRYPTO opt_netsmb.h
227 # Options used only in subr_param.c.
231 NMBCLUSTERS opt_param.h
233 VM_BCACHE_SIZE_MAX opt_param.h
234 VM_SWZONE_SIZE_MAX opt_param.h
240 # Generic SCSI options.
241 CAM_MAX_HIGHPOWER opt_cam.h
243 CAM_DEBUG_DELAY opt_cam.h
244 CAM_DEBUG_BUS opt_cam.h
245 CAM_DEBUG_TARGET opt_cam.h
246 CAM_DEBUG_LUN opt_cam.h
247 CAM_DEBUG_FLAGS opt_cam.h
248 CAM_NEW_TRAN_CODE opt_cam.h
249 SCSI_DELAY opt_scsi.h
250 SCSI_NO_SENSE_STRINGS opt_scsi.h
251 SCSI_NO_OP_STRINGS opt_scsi.h
255 # Options used only in cam/scsi/scsi_cd.c
256 CHANGER_MIN_BUSY_SECONDS opt_cd.h
257 CHANGER_MAX_BUSY_SECONDS opt_cd.h
259 # Options used only in cam/scsi/scsi_sa.c.
260 SA_IO_TIMEOUT opt_sa.h
261 SA_SPACE_TIMEOUT opt_sa.h
262 SA_REWIND_TIMEOUT opt_sa.h
263 SA_ERASE_TIMEOUT opt_sa.h
264 SA_1FM_AT_EOD opt_sa.h
266 # Options used only in cam/scsi/scsi_pt.c
267 SCSI_PT_DEFAULT_TIMEOUT opt_pt.h
269 # Options used only in cam/scsi/scsi_ses.c
270 SES_ENABLE_PASSTHROUGH opt_ses.h
272 # Options used in dev/sym/ (Symbios SCSI driver).
273 SYM_SETUP_LP_PROBE_MAP opt_sym.h #-Low Priority Probe Map (bits)
274 # Allows the ncr to take precedence
275 # 1 (1<<0) -> 810a, 860
276 # 2 (1<<1) -> 825a, 875, 885, 895
277 # 4 (1<<2) -> 895a, 896, 1510d
278 SYM_SETUP_SCSI_DIFF opt_sym.h #-HVD support for 825a, 875, 885
279 # disabled:0 (default), enabled:1
280 SYM_SETUP_PCI_PARITY opt_sym.h #-PCI parity checking
281 # disabled:0, enabled:1 (default)
282 SYM_SETUP_MAX_LUN opt_sym.h #-Number of LUNs supported
283 # default:8, range:[1..64]
285 # Options used only in pci/ncr.c
286 SCSI_NCR_DEBUG opt_ncr.h
287 SCSI_NCR_MAX_SYNC opt_ncr.h
288 SCSI_NCR_MAX_WIDE opt_ncr.h
289 SCSI_NCR_MYADDR opt_ncr.h
291 # Options used only in dev/isp/*
292 ISP_TARGET_MODE opt_isp.h
293 ISP_FW_CRASH_DUMP opt_isp.h
295 # Options used in the 'ata' ATA/ATAPI driver
296 ATA_STATIC_ID opt_ata.h
298 DEV_ATADISK opt_ata.h
299 DEV_ATAPICD opt_ata.h
300 DEV_ATAPIST opt_ata.h
301 DEV_ATAPIFD opt_ata.h
302 DEV_ATAPICAM opt_ata.h
304 ATAPI_DEBUG opt_ata.h
312 BOOTP_COMPAT opt_bootp.h
313 BOOTP_NFSROOT opt_bootp.h
314 BOOTP_NFSV3 opt_bootp.h
315 BOOTP_WIRED_TO opt_bootp.h
321 MROUTING opt_mrouting.h
325 IPSEC_ESP opt_ipsec.h
326 IPSEC_DEBUG opt_ipsec.h
327 FAST_IPSEC opt_ipsec.h
330 IPFILTER opt_ipfilter.h
331 IPFILTER_LOG opt_ipfilter.h
332 IPFILTER_DEFAULT_BLOCK opt_ipfilter.h
333 PFIL_HOOKS opt_pfil_hooks.h
334 IPFIREWALL opt_ipfw.h
335 IPFIREWALL_VERBOSE opt_ipfw.h
336 IPFIREWALL_VERBOSE_LIMIT opt_ipfw.h
337 IPFIREWALL_DEFAULT_TO_ACCEPT opt_ipfw.h
338 IPFIREWALL_FORWARD opt_ipfw.h
339 IPV6FIREWALL opt_ip6fw.h
340 IPV6FIREWALL_VERBOSE opt_ip6fw.h
341 IPV6FIREWALL_VERBOSE_LIMIT opt_ip6fw.h
342 IPV6FIREWALL_DEFAULT_TO_ACCEPT opt_ip6fw.h
351 PPP_BSDCOMP opt_ppp.h
352 PPP_DEFLATE opt_ppp.h
355 SLIP_IFF_OPTS opt_slip.h
357 TCP_DROP_SYNFIN opt_tcp_input.h
360 # Netgraph(4). Use option NETGRAPH to enable the base netgraph code.
361 # Each netgraph node type can be either be compiled into the kernel
362 # or loaded dynamically. To get the former, include the corresponding
363 # option below. Each type has its own man page, e.g. ng_async(4).
365 NETGRAPH_ASYNC opt_netgraph.h
366 NETGRAPH_BPF opt_netgraph.h
367 NETGRAPH_BRIDGE opt_netgraph.h
368 NETGRAPH_CISCO opt_netgraph.h
369 NETGRAPH_ECHO opt_netgraph.h
370 NETGRAPH_ETHER opt_netgraph.h
371 NETGRAPH_FRAME_RELAY opt_netgraph.h
372 NETGRAPH_GIF opt_netgraph.h
373 NETGRAPH_GIF_DEMUX opt_netgraph.h
374 NETGRAPH_HOLE opt_netgraph.h
375 NETGRAPH_IFACE opt_netgraph.h
376 NETGRAPH_IP_INPUT opt_netgraph.h
377 NETGRAPH_KSOCKET opt_netgraph.h
378 NETGRAPH_LMI opt_netgraph.h
379 NETGRAPH_L2TP opt_netgraph.h
380 # MPPC compression requires proprietary files (not included)
381 NETGRAPH_MPPC_COMPRESSION opt_netgraph.h
382 NETGRAPH_MPPC_ENCRYPTION opt_netgraph.h
383 NETGRAPH_ONE2MANY opt_netgraph.h
384 NETGRAPH_PPP opt_netgraph.h
385 NETGRAPH_PPPOE opt_netgraph.h
386 NETGRAPH_PPTPGRE opt_netgraph.h
387 NETGRAPH_RFC1490 opt_netgraph.h
388 NETGRAPH_SOCKET opt_netgraph.h
389 NETGRAPH_SPLIT opt_netgraph.h
390 NETGRAPH_TEE opt_netgraph.h
391 NETGRAPH_TTY opt_netgraph.h
392 NETGRAPH_UI opt_netgraph.h
393 NETGRAPH_VJC opt_netgraph.h
400 ZERO_COPY_SOCKETS opt_zero.h
401 TI_PRIVATE_JUMBOS opt_ti.h
402 TI_JUMBO_HDRSPLIT opt_ti.h
411 # XXX Conflict: # of devices vs network protocol (Native ATM).
412 # This makes "atm.h" unusable.
415 DPT_ALLOW_MEMIO opt_dpt.h # Allow PCI devices to use memory
417 # DPT driver debug flags
418 DPT_MEASURE_PERFORMANCE opt_dpt.h
419 DPT_HANDLE_TIMEOUTS opt_dpt.h
420 DPT_TIMEOUT_FACTOR opt_dpt.h
421 DPT_LOST_IRQ opt_dpt.h
422 DPT_RESET_HBA opt_dpt.h
424 # Adaptec ASR and DPT V/VI controller options
425 ASR_MEASURE_PERFORMANCE opt_asr.h
427 # Misc debug flags. Most of these should probably be replaced with
428 # 'DEBUG', and then let people recompile just the interesting modules
429 # with 'make CC="cc -DDEBUG"'.
430 CLUSTERDEBUG opt_debug_cluster.h
431 DEBUG_1284 opt_ppb_1284.h
434 PLIP_DEBUG opt_plip.h
435 LOCKF_DEBUG opt_debug_lockf.h
436 NPX_DEBUG opt_debug_npx.h
437 NETATALKDEBUG opt_atalk.h
438 SI_DEBUG opt_debug_si.h
442 FB_INSTALL_CDEV opt_fb.h
444 # ppbus related options
445 PERIPH_1284 opt_ppb_1284.h
446 DONTPROBE_1284 opt_ppb_1284.h
448 # smbus related options
449 ENABLE_ALART opt_intpm.h
451 # These cause changes all over the kernel
452 BLKDEV_IOSIZE opt_global.h
454 DEBUG_LOCKS opt_global.h
455 DEBUG_VFS_LOCKS opt_global.h
456 LOOKUP_SHARED opt_global.h
457 DIAGNOSTIC opt_global.h
458 ENABLE_VFS_IOOPT opt_global.h
459 INVARIANT_SUPPORT opt_global.h
460 INVARIANTS opt_global.h
461 MCLSHIFT opt_global.h
463 REGRESSION opt_global.h
464 RESTARTABLE_PANICS opt_global.h
465 VFS_BIO_DEBUG opt_global.h
467 # These are VM related options
468 VM_KMEM_SIZE opt_vm.h
469 VM_KMEM_SIZE_SCALE opt_vm.h
470 VM_KMEM_SIZE_MAX opt_vm.h
472 MALLOC_PROFILE opt_vm.h
473 PQ_NOOPT opt_vmpage.h
474 PQ_NORMALCACHE opt_vmpage.h
475 PQ_MEDIUMCACHE opt_vmpage.h
476 PQ_LARGECACHE opt_vmpage.h
477 PQ_HUGECACHE opt_vmpage.h
478 PQ_CACHESIZE opt_vmpage.h
480 # Standard SMP options
483 # Size of the kernel message buffer
484 MSGBUF_SIZE opt_msgbuf.h
487 NFS_MINATTRTIMO opt_nfs.h
488 NFS_MAXATTRTIMO opt_nfs.h
489 NFS_MINDIRATTRTIMO opt_nfs.h
490 NFS_MAXDIRATTRTIMO opt_nfs.h
491 NFS_GATHERDELAY opt_nfs.h
492 NFS_WDELAYHASHSIZ opt_nfs.h
495 # For the Bt848/Bt848A/Bt849/Bt878/Bt879 driver
496 OVERRIDE_CARD opt_bktr.h
497 OVERRIDE_TUNER opt_bktr.h
498 OVERRIDE_DBX opt_bktr.h
499 OVERRIDE_MSP opt_bktr.h
500 BROOKTREE_SYSTEM_DEFAULT opt_bktr.h
501 BROOKTREE_ALLOC_PAGES opt_bktr.h
502 BKTR_OVERRIDE_CARD opt_bktr.h
503 BKTR_OVERRIDE_TUNER opt_bktr.h
504 BKTR_OVERRIDE_DBX opt_bktr.h
505 BKTR_OVERRIDE_MSP opt_bktr.h
506 BKTR_SYSTEM_DEFAULT opt_bktr.h
507 BKTR_ALLOC_PAGES opt_bktr.h
508 BKTR_USE_PLL opt_bktr.h
509 BKTR_GPIO_ACCESS opt_bktr.h
510 BKTR_NO_MSP_RESET opt_bktr.h
511 BKTR_430_FX_MODE opt_bktr.h
512 BKTR_SIS_VIA_MODE opt_bktr.h
513 BKTR_USE_FREEBSD_SMBUS opt_bktr.h
515 # meteor opt_meteor.h
516 METEOR_ALLOC_PAGES opt_meteor.h
517 METEOR_TEST_VIDEO opt_meteor.h
518 METEOR_SYSTEM_DEFAULT opt_meteor.h
519 METEOR_DEALLOC_PAGES opt_meteor.h
520 METEOR_DEALLOC_ABOVE opt_meteor.h
522 # Various mi ISA bus flags
524 COM_MULTIPORT opt_sio.h
525 BREAK_TO_DEBUGGER opt_comconsole.h
526 ALT_BREAK_TO_DEBUGGER opt_comconsole.h
529 # Include tweaks for running under the SimOS machine simulator.
532 # options for bus/device framework
535 # options for USB support
544 UMASS_DEBUG opt_usb.h
547 UKBD_DFLT_KEYMAP opt_ukbd.h
550 VINUMDEBUG opt_vinum.h
552 # Embedded system options
553 INIT_PATH opt_init_path.h
555 ROOTDEVNAME opt_rootdevname.h
558 PCFCLOCK_VERBOSE opt_pcfclock.h
559 PCFCLOCK_MAX_RETRIES opt_pcfclock.h
562 RAID_AUTOCONFIG opt_raid.h
563 RAID_DEBUG opt_raid.h
564 TDFX_LINUX opt_tdfx.h
569 KTR_CPUMASK opt_ktr.h
570 KTR_COMPILE opt_global.h
571 KTR_ENTRIES opt_global.h
572 KTR_VERBOSE opt_ktr.h
573 MUTEX_DEBUG opt_global.h
575 WITNESS_DDB opt_witness.h
576 WITNESS_SKIPSPIN opt_witness.h
578 # options for ACPI support
579 ACPI_DEBUG opt_acpi.h
580 ACPI_NO_SEMAPHORES opt_acpi.h
581 ACPI_MAX_THREADS opt_acpi.h
583 # options for DEVFS, see sys/fs/devfs/devfs.h
584 NDEVFSINO opt_devfs.h
585 NDEVFSOVERFLOW opt_devfs.h
587 # various 'device presence' options.
592 ED_NO_MIIBUS opt_ed.h
595 WI_SYMBOL_FIRMWARE opt_wi.h
597 # Polling device handling
598 DEVICE_POLLING opt_global.h
601 MUTEX_PROFILING opt_global.h