1# $FreeBSD$ 2# 3# On the handling of kernel options 4# 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 12# coverage. 13# 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. 23# 24# This handling scheme is not yet fully implemented. 25# 26# 27# Format of this file: 28# Option name filename 29# 30# If filename is missing, the default is 31# opt_<name-of-option-in-lower-case>.h 32 33# Adaptec Array Controller driver options 34AAC_COMPAT_LINUX opt_aac.h # Enable the linux ioctl interface 35 36AAC_DEBUG opt_aac.h # Debugging levels: 37 # 0 - quiet, only emit warnings 38 # 1 - noisy, emit major function 39 # points and things done 40 # 2 - extremely noisy, emit trace 41 # items in loops, etc. 42 43# Adaptec aic7xxx SCSI controller options 44AHC_ALLOW_MEMIO opt_aic7xxx.h # Allow PCI devices to use memory 45 # mapped I/O 46 47AHC_TMODE_ENABLE opt_aic7xxx.h # Bitmap of units to enable 48 # targetmode operations. 49 50AHC_DUMP_EEPROM opt_aic7xxx.h # Dump the contents of our 51 # configuration prom. 52 53AHC_DEBUG_SEQUENCER opt_aic7xxx.h # Enable diagnostic sequencer code 54 55# Adaptec aic79xx SCSI controller options 56AHD_DEBUG opt_aic79xx.h # Compile in aic79xx debugging code. 57 58AHD_DEBUG_OPTS opt_aic79xx.h # Aic79xx driver debugging options. 59 # See sys/dev/aic79xx/aic79xx.h 60 61ADW_ALLOW_MEMIO opt_adw.h # Allow PCI devices to use memory 62 # mapped I/O 63 64# Miscellaneous options. 65ADAPTIVE_MUTEXES 66COMPAT_43 opt_compat.h 67COMPAT_FREEBSD4 opt_compat.h 68COMPAT_SUNOS opt_compat.h 69COMPILING_LINT opt_global.h 70CY_PCI_FASTINTR 71CONSPEED opt_comconsole.h 72DDB 73DDB_NOKLDSYM opt_ddb.h 74DDB_UNATTENDED opt_ddb.h 75GDB_REMOTE_CHAT opt_ddb.h 76GDBSPEED opt_ddb.h 77GEOM 78HW_WDOG 79KTRACE 80KTRACE_REQUEST_POOL opt_ktrace.h 81LIBICONV 82MD_ROOT opt_md.h 83MD_ROOT_SIZE opt_md.h 84NDGBPORTS opt_dgb.h 85NODEVFS opt_devfs.h 86NTIMECOUNTER opt_ntp.h 87NSWAPDEV opt_swap.h 88PPS_SYNC opt_ntp.h 89PUC_FASTINTR opt_puc.h 90QUOTA 91SPX_HACK 92SUIDDIR opt_suiddir.h 93MSGMNB opt_sysvipc.h 94MSGMNI opt_sysvipc.h 95MSGSEG opt_sysvipc.h 96MSGSSZ opt_sysvipc.h 97MSGTQL opt_sysvipc.h 98SEMMAP opt_sysvipc.h 99SEMMNI opt_sysvipc.h 100SEMMNS opt_sysvipc.h 101SEMMNU opt_sysvipc.h 102SEMMSL opt_sysvipc.h 103SEMOPM opt_sysvipc.h 104SEMUME opt_sysvipc.h 105SHMALL opt_sysvipc.h 106SHMMAX opt_sysvipc.h 107SHMMAXPGS opt_sysvipc.h 108SHMMIN opt_sysvipc.h 109SHMMNI opt_sysvipc.h 110SHMSEG opt_sysvipc.h 111SYSVMSG opt_sysvipc.h 112SYSVSEM opt_sysvipc.h 113SYSVSHM opt_sysvipc.h 114VFS_AIO 115WLCACHE opt_wavelan.h 116WLDEBUG opt_wavelan.h 117 118# POSIX kernel options 119P1003_1B opt_posix.h 120_KPOSIX_PRIORITY_SCHEDULING opt_posix.h 121_KPOSIX_VERSION opt_posix.h 122 123##################################################################### 124# SECURITY POLICY PARAMETERS 125 126# Support for Mandatory Access Control (MAC) 127MAC opt_mac.h 128MAC_DEBUG opt_mac.h 129MAC_NONE opt_dontuse.h 130 131# Do we want the config file compiled into the kernel? 132INCLUDE_CONFIG_FILE opt_config.h 133 134# Options for static filesystems. These should only be used at config 135# time, since the corresponding lkms cannot work if there are any static 136# dependencies. Unusability is enforced by hiding the defines for the 137# options in a never-included header. 138CD9660 opt_dontuse.h 139CODA opt_dontuse.h 140EXT2FS opt_dontuse.h 141FDESCFS opt_dontuse.h 142LINPROCFS opt_dontuse.h 143MSDOSFS opt_dontuse.h 144NULLFS opt_dontuse.h 145NWFS opt_dontuse.h 146PORTALFS opt_dontuse.h 147PROCFS opt_dontuse.h 148PSEUDOFS opt_dontuse.h 149UMAPFS opt_dontuse.h 150NTFS opt_dontuse.h 151HPFS opt_dontuse.h 152SMBFS opt_dontuse.h 153UNIONFS opt_dontuse.h 154UDF opt_dontuse.h 155 156# Broken - ffs_snapshot() dependency from ufs_lookup() :-( 157FFS opt_ffs_broken_fixme.h 158 159# These static filesystems has one slightly bogus static dependency in 160# sys/i386/i386/autoconf.c. If any of these filesystems are 161# statically compiled into the kernel, code for mounting them as root 162# filesystems will be enabled - but look below. 163NFSCLIENT opt_nfs.h 164NFSSERVER opt_nfs.h 165 166# If you are following the conditions in the copyright, 167# you can enable soft-updates which will speed up a lot of thigs 168# and make the system safer from crashes at the same time. 169# otherwise a STUB module will be compiled in. 170SOFTUPDATES opt_ffs.h 171 172# Enabling this option turns on support for Access Control Lists in UFS, 173# which can be used to support high security configurations. Depends on 174# UFS_EXTATTR. 175UFS_ACL opt_ufs.h 176 177# Enabling this option turns on support for extended attributes in UFS-based 178# filesystems, which can be used to support high security configurations 179# as well as new filesystem features. 180UFS_EXTATTR opt_ufs.h 181UFS_EXTATTR_AUTOSTART opt_ufs.h 182 183# Enable fast hash lookups for large directories on UFS-based filesystems. 184UFS_DIRHASH opt_ufs.h 185 186# The above static dependencies are planned removed, with a 187# <filesystem>_ROOT option to control if it usable as root. This list 188# allows these options to be present in config files already (though 189# they won't make any difference yet). 190NFS_ROOT opt_nfsroot.h 191 192# SMB/CIFS requester 193NETSMB opt_netsmb.h 194NETSMBCRYPTO opt_netsmb.h 195 196# Options used only in subr_param.c. 197HZ opt_param.h 198MAXFILES opt_param.h 199NBUF opt_param.h 200NMBCLUSTERS opt_param.h 201NSFBUFS opt_param.h 202VM_BCACHE_SIZE_MAX opt_param.h 203VM_SWZONE_SIZE_MAX opt_param.h 204MAXUSERS 205DFLDSIZ opt_param.h 206MAXDSIZ opt_param.h 207MAXSSIZ opt_param.h 208 209# Generic SCSI options. 210CAM_MAX_HIGHPOWER opt_cam.h 211CAMDEBUG opt_cam.h 212CAM_DEBUG_DELAY opt_cam.h 213CAM_DEBUG_BUS opt_cam.h 214CAM_DEBUG_TARGET opt_cam.h 215CAM_DEBUG_LUN opt_cam.h 216CAM_DEBUG_FLAGS opt_cam.h 217CAM_NEW_TRAN_CODE opt_cam.h 218SCSI_DELAY opt_scsi.h 219SCSI_NO_SENSE_STRINGS opt_scsi.h 220SCSI_NO_OP_STRINGS opt_scsi.h 221 222 223 224# Options used only in cam/scsi/scsi_cd.c 225CHANGER_MIN_BUSY_SECONDS opt_cd.h 226CHANGER_MAX_BUSY_SECONDS opt_cd.h 227 228# Options used only in cam/scsi/scsi_sa.c. 229SA_IO_TIMEOUT opt_sa.h 230SA_SPACE_TIMEOUT opt_sa.h 231SA_REWIND_TIMEOUT opt_sa.h 232SA_ERASE_TIMEOUT opt_sa.h 233SA_1FM_AT_EOD opt_sa.h 234 235# Options used only in cam/scsi/scsi_pt.c 236SCSI_PT_DEFAULT_TIMEOUT opt_pt.h 237 238# Options used only in cam/scsi/scsi_ses.c 239SES_ENABLE_PASSTHROUGH opt_ses.h 240 241# Options used in dev/sym/ (Symbios SCSI driver). 242SYM_SETUP_LP_PROBE_MAP opt_sym.h #-Low Priority Probe Map (bits) 243 # Allows the ncr to take precedence 244 # 1 (1<<0) -> 810a, 860 245 # 2 (1<<1) -> 825a, 875, 885, 895 246 # 4 (1<<2) -> 895a, 896, 1510d 247SYM_SETUP_SCSI_DIFF opt_sym.h #-HVD support for 825a, 875, 885 248 # disabled:0 (default), enabled:1 249SYM_SETUP_PCI_PARITY opt_sym.h #-PCI parity checking 250 # disabled:0, enabled:1 (default) 251SYM_SETUP_MAX_LUN opt_sym.h #-Number of LUNs supported 252 # default:8, range:[1..64] 253 254# Options used only in pci/ncr.c 255SCSI_NCR_DEBUG opt_ncr.h 256SCSI_NCR_MAX_SYNC opt_ncr.h 257SCSI_NCR_MAX_WIDE opt_ncr.h 258SCSI_NCR_MYADDR opt_ncr.h 259 260# Options used only in dev/isp/* 261ISP_TARGET_MODE opt_isp.h 262ISP_FW_CRASH_DUMP opt_isp.h 263 264# Options used in the 'ata' ATA/ATAPI driver 265ATA_STATIC_ID opt_ata.h 266ATA_NOPCI opt_ata.h 267DEV_ATADISK opt_ata.h 268DEV_ATAPICD opt_ata.h 269DEV_ATAPIST opt_ata.h 270DEV_ATAPIFD opt_ata.h 271DEV_ATAPICAM opt_ata.h 272ATA_DEBUG opt_ata.h 273ATAPI_DEBUG opt_ata.h 274ACD_DEBUG opt_ata.h 275AST_DEBUG opt_ata.h 276 277# Net stuff. 278ACCEPT_FILTER_DATA 279ACCEPT_FILTER_HTTP 280BOOTP opt_bootp.h 281BOOTP_COMPAT opt_bootp.h 282BOOTP_NFSROOT opt_bootp.h 283BOOTP_NFSV3 opt_bootp.h 284BOOTP_WIRED_TO opt_bootp.h 285BRIDGE opt_bdg.h 286ETHER_II opt_ef.h 287ETHER_8023 opt_ef.h 288ETHER_8022 opt_ef.h 289ETHER_SNAP opt_ef.h 290MROUTING opt_mrouting.h 291INET opt_inet.h 292INET6 opt_inet6.h 293IPSEC opt_ipsec.h 294IPSEC_ESP opt_ipsec.h 295IPSEC_DEBUG opt_ipsec.h 296IPDIVERT 297DUMMYNET opt_ipdn.h 298IPFILTER opt_ipfilter.h 299IPFILTER_LOG opt_ipfilter.h 300IPFILTER_DEFAULT_BLOCK opt_ipfilter.h 301PFIL_HOOKS opt_pfil_hooks.h 302IPFIREWALL opt_ipfw.h 303IPFIREWALL_VERBOSE opt_ipfw.h 304IPFIREWALL_VERBOSE_LIMIT opt_ipfw.h 305IPFIREWALL_DEFAULT_TO_ACCEPT opt_ipfw.h 306IPFIREWALL_FORWARD opt_ipfw.h 307IPV6FIREWALL opt_ip6fw.h 308IPV6FIREWALL_VERBOSE opt_ip6fw.h 309IPV6FIREWALL_VERBOSE_LIMIT opt_ip6fw.h 310IPV6FIREWALL_DEFAULT_TO_ACCEPT opt_ip6fw.h 311IPSTEALTH 312IPX opt_ipx.h 313IPXIP opt_ipx.h 314IPTUNNEL opt_ipx.h 315LIBMCHAIN 316NCP opt_ncp.h 317NETATALK opt_atalk.h 318PPP_BSDCOMP opt_ppp.h 319PPP_DEFLATE opt_ppp.h 320PPP_FILTER opt_ppp.h 321RANDOM_IP_ID 322SLIP_IFF_OPTS opt_slip.h 323TCPDEBUG 324TCP_DROP_SYNFIN opt_tcp_input.h 325XBONEHACK 326 327# Netgraph(4). Use option NETGRAPH to enable the base netgraph code. 328# Each netgraph node type can be either be compiled into the kernel 329# or loaded dynamically. To get the former, include the corresponding 330# option below. Each type has its own man page, e.g. ng_async(4). 331NETGRAPH 332NETGRAPH_ASYNC opt_netgraph.h 333NETGRAPH_BPF opt_netgraph.h 334NETGRAPH_BRIDGE opt_netgraph.h 335NETGRAPH_CISCO opt_netgraph.h 336NETGRAPH_ECHO opt_netgraph.h 337NETGRAPH_ETHER opt_netgraph.h 338NETGRAPH_FRAME_RELAY opt_netgraph.h 339NETGRAPH_GIF opt_netgraph.h 340NETGRAPH_GIF_DEMUX opt_netgraph.h 341NETGRAPH_HOLE opt_netgraph.h 342NETGRAPH_IFACE opt_netgraph.h 343NETGRAPH_IP_INPUT opt_netgraph.h 344NETGRAPH_KSOCKET opt_netgraph.h 345NETGRAPH_LMI opt_netgraph.h 346NETGRAPH_L2TP opt_netgraph.h 347# MPPC compression requires proprietary files (not included) 348NETGRAPH_MPPC_COMPRESSION opt_netgraph.h 349NETGRAPH_MPPC_ENCRYPTION opt_netgraph.h 350NETGRAPH_ONE2MANY opt_netgraph.h 351NETGRAPH_PPP opt_netgraph.h 352NETGRAPH_PPPOE opt_netgraph.h 353NETGRAPH_PPTPGRE opt_netgraph.h 354NETGRAPH_RFC1490 opt_netgraph.h 355NETGRAPH_SOCKET opt_netgraph.h 356NETGRAPH_SPLIT opt_netgraph.h 357NETGRAPH_TEE opt_netgraph.h 358NETGRAPH_TTY opt_netgraph.h 359NETGRAPH_UI opt_netgraph.h 360NETGRAPH_VJC opt_netgraph.h 361 362# DRM options 363DRM_LINUX opt_drm.h 364DRM_DEBUG opt_drm.h 365 366 367ZERO_COPY_SOCKETS opt_zero.h 368TI_PRIVATE_JUMBOS opt_ti.h 369TI_JUMBO_HDRSPLIT opt_ti.h 370 371# ATM (HARP version) 372ATM_CORE opt_atm.h 373ATM_IP opt_atm.h 374ATM_SIGPVC opt_atm.h 375ATM_SPANS opt_atm.h 376ATM_UNI opt_atm.h 377 378# XXX Conflict: # of devices vs network protocol (Native ATM). 379# This makes "atm.h" unusable. 380NATM opt_natm.h 381 382DPT_ALLOW_MEMIO opt_dpt.h # Allow PCI devices to use memory 383 # mapped I/O 384# DPT driver debug flags 385DPT_MEASURE_PERFORMANCE opt_dpt.h 386DPT_HANDLE_TIMEOUTS opt_dpt.h 387DPT_TIMEOUT_FACTOR opt_dpt.h 388DPT_LOST_IRQ opt_dpt.h 389DPT_RESET_HBA opt_dpt.h 390 391# Adaptec ASR and DPT V/VI controller options 392ASR_MEASURE_PERFORMANCE opt_asr.h 393 394# Misc debug flags. Most of these should probably be replaced with 395# 'DEBUG', and then let people recompile just the interesting modules 396# with 'make CC="cc -DDEBUG"'. 397CLUSTERDEBUG opt_debug_cluster.h 398DEBUG_1284 opt_ppb_1284.h 399VP0_DEBUG opt_vpo.h 400LPT_DEBUG opt_lpt.h 401PLIP_DEBUG opt_plip.h 402LOCKF_DEBUG opt_debug_lockf.h 403NPX_DEBUG opt_debug_npx.h 404NETATALKDEBUG opt_atalk.h 405SI_DEBUG opt_debug_si.h 406 407# Fb options 408FB_DEBUG opt_fb.h 409FB_INSTALL_CDEV opt_fb.h 410 411# ppbus related options 412PERIPH_1284 opt_ppb_1284.h 413DONTPROBE_1284 opt_ppb_1284.h 414 415# smbus related options 416ENABLE_ALART opt_intpm.h 417 418# These cause changes all over the kernel 419BLKDEV_IOSIZE opt_global.h 420DEBUG opt_global.h 421DEBUG_LOCKS opt_global.h 422DEBUG_VFS_LOCKS opt_global.h 423LOOKUP_SHARED opt_global.h 424DIAGNOSTIC opt_global.h 425ENABLE_VFS_IOOPT opt_global.h 426INVARIANT_SUPPORT opt_global.h 427INVARIANTS opt_global.h 428MCLSHIFT opt_global.h 429MSIZE opt_global.h 430REGRESSION opt_global.h 431RESTARTABLE_PANICS opt_global.h 432VFS_BIO_DEBUG opt_global.h 433 434# These are VM related options 435VM_KMEM_SIZE opt_vm.h 436VM_KMEM_SIZE_SCALE opt_vm.h 437VM_KMEM_SIZE_MAX opt_vm.h 438NO_SWAPPING opt_vm.h 439MALLOC_PROFILE opt_vm.h 440PQ_NOOPT opt_vmpage.h 441PQ_NORMALCACHE opt_vmpage.h 442PQ_MEDIUMCACHE opt_vmpage.h 443PQ_LARGECACHE opt_vmpage.h 444PQ_HUGECACHE opt_vmpage.h 445PQ_CACHESIZE opt_vmpage.h 446 447# Standard SMP options 448SMP opt_global.h 449 450# Size of the kernel message buffer 451MSGBUF_SIZE opt_msgbuf.h 452 453# PCI related options 454PCI_ALLOW_UNSUPPORTED_IO_RANGE opt_pci.h 455 456# NFS options 457NFS_MINATTRTIMO opt_nfs.h 458NFS_MAXATTRTIMO opt_nfs.h 459NFS_MINDIRATTRTIMO opt_nfs.h 460NFS_MAXDIRATTRTIMO opt_nfs.h 461NFS_GATHERDELAY opt_nfs.h 462NFS_WDELAYHASHSIZ opt_nfs.h 463NFS_DEBUG opt_nfs.h 464 465# For the Bt848/Bt848A/Bt849/Bt878/Bt879 driver 466OVERRIDE_CARD opt_bktr.h 467OVERRIDE_TUNER opt_bktr.h 468OVERRIDE_DBX opt_bktr.h 469OVERRIDE_MSP opt_bktr.h 470BROOKTREE_SYSTEM_DEFAULT opt_bktr.h 471BROOKTREE_ALLOC_PAGES opt_bktr.h 472BKTR_OVERRIDE_CARD opt_bktr.h 473BKTR_OVERRIDE_TUNER opt_bktr.h 474BKTR_OVERRIDE_DBX opt_bktr.h 475BKTR_OVERRIDE_MSP opt_bktr.h 476BKTR_SYSTEM_DEFAULT opt_bktr.h 477BKTR_ALLOC_PAGES opt_bktr.h 478BKTR_USE_PLL opt_bktr.h 479BKTR_GPIO_ACCESS opt_bktr.h 480BKTR_NO_MSP_RESET opt_bktr.h 481BKTR_430_FX_MODE opt_bktr.h 482BKTR_SIS_VIA_MODE opt_bktr.h 483BKTR_USE_FREEBSD_SMBUS opt_bktr.h 484 485# meteor opt_meteor.h 486METEOR_ALLOC_PAGES opt_meteor.h 487METEOR_TEST_VIDEO opt_meteor.h 488METEOR_SYSTEM_DEFAULT opt_meteor.h 489METEOR_DEALLOC_PAGES opt_meteor.h 490METEOR_DEALLOC_ABOVE opt_meteor.h 491 492# Various mi ISA bus flags 493COM_ESP opt_sio.h 494COM_MULTIPORT opt_sio.h 495BREAK_TO_DEBUGGER opt_comconsole.h 496ALT_BREAK_TO_DEBUGGER opt_comconsole.h 497DEV_ISA opt_isa.h 498 499# Include tweaks for running under the SimOS machine simulator. 500SIMOS opt_simos.h 501 502# options for bus/device framework 503BUS_DEBUG opt_bus.h 504 505# options for USB support 506UHCI_DEBUG opt_usb.h 507OHCI_DEBUG opt_usb.h 508USB_DEBUG opt_usb.h 509UGEN_DEBUG opt_usb.h 510UHID_DEBUG opt_usb.h 511UHUB_DEBUG opt_usb.h 512UKBD_DEBUG opt_usb.h 513ULPT_DEBUG opt_usb.h 514UMASS_DEBUG opt_usb.h 515UMS_DEBUG opt_usb.h 516URIO_DEBUG opt_usb.h 517UKBD_DFLT_KEYMAP opt_ukbd.h 518 519# Vinum options 520VINUMDEBUG opt_vinum.h 521 522# Embedded system options 523INIT_PATH opt_init_path.h 524 525ROOTDEVNAME opt_rootdevname.h 526 527FDC_DEBUG opt_fdc.h 528PCFCLOCK_VERBOSE opt_pcfclock.h 529PCFCLOCK_MAX_RETRIES opt_pcfclock.h 530TDFX_LINUX opt_tdfx.h 531 532KTR opt_global.h 533KTR_MASK opt_ktr.h 534KTR_CPUMASK opt_ktr.h 535KTR_COMPILE opt_global.h 536KTR_ENTRIES opt_global.h 537KTR_VERBOSE opt_ktr.h 538MUTEX_DEBUG opt_global.h 539WITNESS opt_global.h 540WITNESS_DDB opt_witness.h 541WITNESS_SKIPSPIN opt_witness.h 542 543# options for ACPI support 544ACPI_DEBUG opt_acpi.h 545ACPI_NO_SEMAPHORES opt_acpi.h 546ACPI_MAX_THREADS opt_acpi.h 547 548# options for DEVFS, see sys/fs/devfs/devfs.h 549NDEVFSINO opt_devfs.h 550NDEVFSOVERFLOW opt_devfs.h 551 552# various 'device presence' options. 553DEV_MCA opt_mca.h 554DEV_BPF opt_bpf.h 555 556# ed driver 557ED_NO_MIIBUS opt_ed.h 558 559# wi driver 560WI_SYMBOL_FIRMWARE opt_wi.h 561 562# Polling device handling 563DEVICE_POLLING opt_global.h 564 565# Mutex profiling 566MUTEX_PROFILING opt_global.h 567 568