options revision 71861
1# $FreeBSD: head/sys/conf/options 71861 2001-01-31 05:33:23Z peter $
2#
3#        On the handling of kernel options
4#
5# All kernel options should be listed in LINT, with suitable
6# descriptions.  Negative options (options that make some code not
7# compile) should be commented out; LINT should compile as much code
8# as possible.  Try to structure option-using code so that a single
9# option only switch code on, or only switch code off, to make it
10# possible to have a full compile-test.  If necessary, you can check
11# for COMPILING_LINT to get maximum code coverage.
12#
13# All new options shall also be listed in either "conf/options" or
14# "<machine>/conf/options.<machine>".  Options that affect a single
15# source-file <xxx>.[c|s] should be directed into "opt_<xxx>.h", while
16# options that affect multiple files should either go in
17# "opt_global.h" if this is a kernel-wide option (used just about
18# everywhere), or in "opt_<option-name-in-lower-case>.h" if it affect
19# only some files.  Note that the effect of listing only an option
20# without a header-file-name in conf/options (and cousins) is that the
21# last convention is followed.
22#
23# This handling scheme is not yet fully implemented.
24#
25#
26# Format of this file:
27# Option name	filename
28#
29# If filename is missing, the default is
30# opt_<name-of-option-in-lower-case>.h
31
32# Adaptec aic7xxx SCSI controller options
33AHC_ALLOW_MEMIO		opt_aic7xxx.h	# Allow PCI devices to use memory
34					# mapped I/O
35
36AHC_TMODE_ENABLE	opt_aic7xxx.h	# Bitmap of units to enable
37					# targetmode operations.
38
39AHC_DUMP_EEPROM		opt_aic7xxx.h	# Dump the contents of our
40					# configuration prom.
41
42AHC_DEBUG_SEQUENCER	opt_aic7xxx.h	# Enable diagnostic sequencer code
43
44ADW_ALLOW_MEMIO		opt_adw.h	# Allow PCI devices to use memory
45					# mapped I/O
46
47# Miscellaneous options.
48COMPAT_43	opt_compat.h
49COMPAT_SUNOS	opt_compat.h
50COMPILING_LINT	opt_global.h
51CY_PCI_FASTINTR
52DDB
53DDB_UNATTENDED	opt_ddb.h
54GDB_REMOTE_CHAT	opt_ddb.h
55DEVFS
56HW_WDOG
57KTRACE
58MD_NSECT	opt_md.h
59MD_ROOT		opt_md.h
60MD_ROOT_SIZE	opt_md.h
61MFS_ROOT	opt_mfs.h
62MFS_ROOT_SIZE	opt_mfs.h
63NTIMECOUNTER	opt_ntp.h
64NSWAPDEV	opt_swap.h
65PPS_SYNC	opt_ntp.h
66QUOTA
67SPX_HACK
68SUIDDIR		opt_suiddir.h
69SYSVMSG		opt_sysvipc.h
70SYSVSEM		opt_sysvipc.h
71SYSVSHM		opt_sysvipc.h
72SHMALL		opt_sysvipc.h
73SHMMAX		opt_sysvipc.h
74SHMMAXPGS	opt_sysvipc.h
75SHMMIN		opt_sysvipc.h
76SHMMNI		opt_sysvipc.h
77SHMSEG		opt_sysvipc.h
78SEMMAP		opt_sysvipc.h
79SEMMNI		opt_sysvipc.h
80SEMMNS		opt_sysvipc.h
81SEMMNU		opt_sysvipc.h
82SEMMSL		opt_sysvipc.h
83SEMOPM		opt_sysvipc.h
84SEMUME		opt_sysvipc.h
85MSGMNB		opt_sysvipc.h
86MSGMNI		opt_sysvipc.h
87MSGSEG		opt_sysvipc.h
88MSGSSZ		opt_sysvipc.h
89MSGTQL		opt_sysvipc.h
90UCONSOLE
91VFS_AIO
92
93# POSIX kernel options
94P1003_1B			opt_posix.h
95_KPOSIX_PRIORITY_SCHEDULING	opt_posix.h
96_KPOSIX_VERSION			opt_posix.h
97
98# TrustedBSD and POSIX.1e Kernel Options
99CAPABILITIES	opt_cap.h
100
101# Do we want the config file compiled into the kernel?
102INCLUDE_CONFIG_FILE	opt_config.h
103
104# Options for static file systems.  These should only be used at config
105# time, since the corresponding lkms cannot work if there are any static
106# dependencies.  Unusability is enforced by hiding the defines for the
107# options in a never-included header.
108EXT2FS		opt_dontuse.h
109FDESC		opt_dontuse.h
110MFS		opt_dontuse.h
111MSDOSFS		opt_dontuse.h
112NULLFS		opt_dontuse.h
113PORTAL		opt_dontuse.h
114PROCFS		opt_dontuse.h
115UMAPFS		opt_dontuse.h
116NTFS		opt_dontuse.h
117HPFS		opt_dontuse.h
118
119# These static filesystems has one slightly bogus static dependency in
120# sys/i386/i386/autoconf.c.  If any of these filesystems are
121# statically compiled into the kernel, code for mounting them as root
122# filesystems will be enabled - but look below.  Boot-code is purposely
123# unavailable for the LKM-based versions.
124CODA
125CD9660
126FFS
127IFS
128NFS
129NWFS
130
131# If you are following the conditions in the copyright,
132# you can enable soft-updates which will speed up a lot of thigs
133# and make the system safer from crashes at the same time.
134# otherwise a STUB module will be compiled in.
135SOFTUPDATES	opt_ffs.h
136
137# Enabling this option turns on support for extended attributes
138# in FFS, which can be used to support high security configurations
139# as well as new file system features.
140FFS_EXTATTR	opt_ffs.h
141
142# The above static dependencies are planned removed, with a
143# <filesystem>_ROOT option to control if it usable as root.  This list
144# allows these options to be present in config files already (though
145# they won't make any difference yet).
146CD9660_ROOT	opt_cd9660.h
147FFS_ROOT	opt_ffs.h
148NFS_ROOT	opt_nfsroot.h
149
150# The union static file system has bogus static dependencies, so it isn't
151# hidden yet.
152UNION
153
154# Options used only in param.c.
155HZ		opt_param.h
156MAXFILES	opt_param.h
157MAXUSERS	opt_param.h
158NBUF		opt_param.h
159NMBCLUSTERS	opt_param.h
160NSFBUFS		opt_param.h
161
162# Generic SCSI options.
163CAM_MAX_HIGHPOWER	opt_cam.h
164CAMDEBUG		opt_cam.h
165CAM_DEBUG_DELAY		opt_cam.h
166CAM_DEBUG_BUS		opt_cam.h
167CAM_DEBUG_TARGET	opt_cam.h
168CAM_DEBUG_LUN		opt_cam.h
169CAM_DEBUG_FLAGS		opt_cam.h
170SCSI_DELAY		opt_scsi.h
171SCSI_NO_SENSE_STRINGS	opt_scsi.h
172SCSI_NO_OP_STRINGS	opt_scsi.h
173
174# Options used only in cam/scsi/scsi_cd.c
175CHANGER_MIN_BUSY_SECONDS	opt_cd.h
176CHANGER_MAX_BUSY_SECONDS	opt_cd.h
177
178# Options used only in cam/scsi/scsi_sa.c.
179SA_SPACE_TIMEOUT	opt_sa.h
180SA_REWIND_TIMEOUT	opt_sa.h
181SA_ERASE_TIMEOUT	opt_sa.h
182SA_1FM_AT_EOD		opt_sa.h
183
184# Options used only in cam/scsi/scsi_pt.c
185SCSI_PT_DEFAULT_TIMEOUT	opt_pt.h
186
187# Options used only in cam/scsi/scsi_ses.c
188SES_ENABLE_PASSTHROUGH	opt_ses.h
189
190# Options used in dev/sym/ (Symbios SCSI driver).
191SYM_SETUP_LP_PROBE_MAP	opt_sym.h	#-Low Priority Probe Map (bits)
192					# Allows the ncr to take precedence
193					# 1 (1<<0) -> 810a, 860
194					# 2 (1<<1) -> 825a, 875, 885, 895
195					# 4 (1<<2) -> 895a, 896, 1510d 
196SYM_SETUP_SCSI_DIFF	opt_sym.h	#-HVD support for 825a, 875, 885
197					# disabled:0 (default), enabled:1
198SYM_SETUP_PCI_PARITY	opt_sym.h	#-PCI parity checking
199					# disabled:0, enabled:1 (default)
200SYM_SETUP_MAX_LUN	opt_sym.h	#-Number of LUNs supported
201					# default:8, range:[1..64]
202
203# Options used only in pci/ncr.c
204SCSI_NCR_DEBUG		opt_ncr.h
205SCSI_NCR_MAX_SYNC	opt_ncr.h
206SCSI_NCR_MAX_WIDE	opt_ncr.h
207SCSI_NCR_MYADDR		opt_ncr.h
208
209# Options used only in pci/isp_pci.c
210ISP_TARGET_MODE		opt_isp.h
211
212# Options used in the 'ata' ATA/ATAPI driver
213ACD_DEBUG		opt_ata.h
214AST_DEBUG		opt_ata.h
215ATAPI_DEBUG		opt_ata.h
216ATA_DEBUG		opt_ata.h
217ATA_STATIC_ID		opt_ata.h
218ATA_ENABLE_ATAPI_DMA	opt_ata.h
219ATA_ENABLE_WC		opt_ata.h 
220ATA_ENABLE_TAGS		opt_ata.h	# also sets ATA_ENABLE_WC
221DEV_ATADISK		opt_ata.h
222DEV_ATAPICD		opt_ata.h
223DEV_ATAPIST		opt_ata.h
224DEV_ATAPIFD		opt_ata.h
225
226# Resource limits.
227DFLDSIZ			opt_rlimit.h
228MAXDSIZ			opt_rlimit.h
229
230# Net stuff.
231ACCEPT_FILTER_DATA
232ACCEPT_FILTER_HTTP
233BOOTP			opt_bootp.h
234BOOTP_COMPAT		opt_bootp.h
235BOOTP_NFSROOT		opt_bootp.h
236BOOTP_NFSV3		opt_bootp.h
237BOOTP_WIRED_TO		opt_bootp.h
238BRIDGE			opt_bdg.h
239ETHER_II		opt_ef.h
240ETHER_8023		opt_ef.h
241ETHER_8022		opt_ef.h
242ETHER_SNAP		opt_ef.h
243MROUTING		opt_mrouting.h
244INET			opt_inet.h
245INET6			opt_inet6.h
246IPSEC			opt_ipsec.h
247IPSEC_ESP		opt_ipsec.h
248IPSEC_DEBUG		opt_ipsec.h
249IPDIVERT
250DUMMYNET		opt_ipdn.h
251IPFILTER		opt_ipfilter.h
252IPFILTER_LOG		opt_ipfilter.h
253IPFILTER_DEFAULT_BLOCK	opt_ipfilter.h
254PFIL_HOOKS		opt_pfil_hooks.h
255IPFIREWALL		opt_ipfw.h
256IPFIREWALL_VERBOSE	opt_ipfw.h
257IPFIREWALL_VERBOSE_LIMIT	opt_ipfw.h
258IPFIREWALL_DEFAULT_TO_ACCEPT	opt_ipfw.h
259IPFIREWALL_FORWARD		opt_ipfw.h
260IPV6FIREWALL		opt_ip6fw.h
261IPV6FIREWALL_VERBOSE	opt_ip6fw.h
262IPV6FIREWALL_VERBOSE_LIMIT	opt_ip6fw.h
263IPV6FIREWALL_DEFAULT_TO_ACCEPT	opt_ip6fw.h
264IPSTEALTH
265IPX			opt_ipx.h
266IPXIP			opt_ipx.h
267IPTUNNEL		opt_ipx.h
268NCP			opt_ncp.h
269NETATALK		opt_atalk.h
270PPP_BSDCOMP		opt_ppp.h
271PPP_DEFLATE		opt_ppp.h
272PPP_FILTER		opt_ppp.h
273SLIP_IFF_OPTS		opt_slip.h
274TCP_COMPAT_42		opt_compat.h
275TCPDEBUG
276TCP_DROP_SYNFIN		opt_tcp_input.h
277TCP_RESTRICT_RST	opt_tcp_input.h
278XBONEHACK
279
280# Netgraph(4). Use option NETGRAPH to enable the base netgraph code.
281# Each netgraph node type can be either be compiled into the kernel
282# or loaded dynamically. To get the former, include the corresponding
283# option below. Each type has its own man page, e.g. ng_async(4).
284NETGRAPH
285NETGRAPH_ASYNC		opt_netgraph.h
286NETGRAPH_BPF		opt_netgraph.h
287NETGRAPH_BRIDGE		opt_netgraph.h
288NETGRAPH_CISCO		opt_netgraph.h
289NETGRAPH_ECHO		opt_netgraph.h
290NETGRAPH_ETHER		opt_netgraph.h
291NETGRAPH_FRAME_RELAY	opt_netgraph.h
292NETGRAPH_HOLE		opt_netgraph.h
293NETGRAPH_IFACE		opt_netgraph.h
294NETGRAPH_KSOCKET	opt_netgraph.h
295NETGRAPH_LMI		opt_netgraph.h
296# MPPC compression requires proprietary files (not included)
297NETGRAPH_MPPC_COMPRESSION	opt_netgraph.h
298NETGRAPH_MPPC_ENCRYPTION	opt_netgraph.h
299NETGRAPH_ONE2MANY	opt_netgraph.h
300NETGRAPH_PPP		opt_netgraph.h
301NETGRAPH_PPPOE		opt_netgraph.h
302NETGRAPH_PPTPGRE	opt_netgraph.h
303NETGRAPH_RFC1490	opt_netgraph.h
304NETGRAPH_SOCKET		opt_netgraph.h
305NETGRAPH_TEE		opt_netgraph.h
306NETGRAPH_TTY		opt_netgraph.h
307NETGRAPH_UI		opt_netgraph.h
308NETGRAPH_VJC		opt_netgraph.h
309
310# ATM (HARP version)
311ATM_CORE		opt_atm.h
312ATM_IP			opt_atm.h
313ATM_SIGPVC		opt_atm.h
314ATM_SPANS		opt_atm.h
315ATM_UNI			opt_atm.h
316
317# XXX Conflict: # of devices vs network protocol (Native ATM).
318# This makes "atm.h" unusable.
319NATM			opt_natm.h
320
321DPT_ALLOW_MEMIO		opt_dpt.h	# Allow PCI devices to use memory
322					# mapped I/O
323# DPT driver debug flags
324DPT_MEASURE_PERFORMANCE	opt_dpt.h
325DPT_HANDLE_TIMEOUTS	opt_dpt.h
326DPT_TIMEOUT_FACTOR	opt_dpt.h
327DPT_LOST_IRQ		opt_dpt.h
328DPT_RESET_HBA		opt_dpt.h
329
330# Adaptec ASR and DPT V/VI controller options
331ASR_MEASURE_PERFORMANCE	opt_asr.h
332
333# Misc debug flags.  Most of these should probably be replaced with
334# 'DEBUG', and then let people recompile just the interesting modules
335# with 'make CC="cc -DDEBUG"'.
336CLUSTERDEBUG		opt_debug_cluster.h
337DEBUG_1284		opt_ppb_1284.h
338VP0_DEBUG		opt_vpo.h
339LPT_DEBUG		opt_lpt.h
340PLIP_DEBUG		opt_plip.h
341LOCKF_DEBUG		opt_debug_lockf.h
342LOUTB			opt_debug_outb.h
343NPX_DEBUG		opt_debug_npx.h
344NETATALKDEBUG		opt_atalk.h
345SI_DEBUG		opt_debug_si.h
346
347# Fb options
348FB_DEBUG		opt_fb.h
349FB_INSTALL_CDEV		opt_fb.h
350
351# ppbus related options
352PERIPH_1284		opt_ppb_1284.h
353DONTPROBE_1284		opt_ppb_1284.h
354
355# smbus related options
356ENABLE_ALART		opt_intpm.h
357
358# These cause changes all over the kernel
359BLKDEV_IOSIZE		opt_global.h
360DEBUG			opt_global.h
361DEBUG_LOCKS		opt_global.h
362DEBUG_VFS_LOCKS		opt_global.h
363DIAGNOSTIC		opt_global.h
364ENABLE_VFS_IOOPT	opt_global.h
365INVARIANT_SUPPORT	opt_global.h
366INVARIANTS		opt_global.h
367SIMPLELOCK_DEBUG	opt_global.h
368VFS_BIO_DEBUG		opt_global.h
369
370# These are VM related options
371VM_KMEM_SIZE		opt_vm.h
372VM_KMEM_SIZE_SCALE	opt_vm.h
373VM_KMEM_SIZE_MAX	opt_vm.h
374NO_SWAPPING		opt_vm.h
375PQ_NOOPT		opt_vmpage.h
376PQ_NORMALCACHE		opt_vmpage.h
377PQ_MEDIUMCACHE		opt_vmpage.h
378PQ_LARGECACHE		opt_vmpage.h
379PQ_HUGECACHE		opt_vmpage.h
380PQ_CACHESIZE		opt_vmpage.h
381
382# Standard SMP options
383SMP			opt_global.h
384
385# sys/netkey
386KEY
387
388# Size of the kernel message buffer
389MSGBUF_SIZE		opt_msgbuf.h
390
391# PCI related options
392PCI_QUIET		opt_pci.h
393
394# NFS options
395NFS_MINATTRTIMO		opt_nfs.h
396NFS_MAXATTRTIMO		opt_nfs.h
397NFS_MINDIRATTRTIMO	opt_nfs.h
398NFS_MAXDIRATTRTIMO	opt_nfs.h
399NFS_GATHERDELAY		opt_nfs.h
400NFS_UIDHASHSIZ		opt_nfs.h
401NFS_WDELAYHASHSIZ	opt_nfs.h
402NFS_MUIDHASHSIZ		opt_nfs.h
403NFS_NOSERVER		opt_nfs.h
404NFS_DEBUG		opt_nfs.h
405
406# For the Bt848/Bt848A/Bt849/Bt878/Bt879 driver
407OVERRIDE_CARD			opt_bktr.h
408OVERRIDE_TUNER			opt_bktr.h
409OVERRIDE_DBX			opt_bktr.h
410OVERRIDE_MSP			opt_bktr.h
411BROOKTREE_SYSTEM_DEFAULT	opt_bktr.h
412BROOKTREE_ALLOC_PAGES		opt_bktr.h
413BKTR_OVERRIDE_CARD		opt_bktr.h
414BKTR_OVERRIDE_TUNER		opt_bktr.h
415BKTR_OVERRIDE_DBX		opt_bktr.h
416BKTR_OVERRIDE_MSP		opt_bktr.h
417BKTR_SYSTEM_DEFAULT		opt_bktr.h
418BKTR_ALLOC_PAGES		opt_bktr.h
419BKTR_USE_PLL			opt_bktr.h	
420BKTR_GPIO_ACCESS		opt_bktr.h
421BKTR_NO_MSP_RESET		opt_bktr.h
422BKTR_430_FX_MODE		opt_bktr.h
423BKTR_SIS_VIA_MODE		opt_bktr.h
424
425# meteor opt_meteor.h
426METEOR_ALLOC_PAGES	opt_meteor.h
427METEOR_TEST_VIDEO	opt_meteor.h
428METEOR_SYSTEM_DEFAULT	opt_meteor.h
429METEOR_DEALLOC_PAGES	opt_meteor.h
430METEOR_DEALLOC_ABOVE	opt_meteor.h
431
432# Various mi ISA bus flags
433COM_ESP			opt_sio.h
434COM_MULTIPORT		opt_sio.h
435BREAK_TO_DEBUGGER	opt_comconsole.h
436ALT_BREAK_TO_DEBUGGER	opt_comconsole.h
437DEV_ISA			opt_isa.h
438
439# Include tweaks for running under the SimOS machine simulator.
440SIMOS			opt_simos.h
441
442# options for bus/device framework
443BUS_DEBUG		opt_bus.h
444DEVICE_SYSCTLS		opt_bus.h
445
446# options for USB support
447UHCI_DEBUG		opt_usb.h
448OHCI_DEBUG		opt_usb.h
449USB_DEBUG		opt_usb.h
450UGEN_DEBUG		opt_usb.h
451UHID_DEBUG		opt_usb.h
452UHUB_DEBUG		opt_usb.h
453UKBD_DEBUG		opt_usb.h
454ULPT_DEBUG		opt_usb.h
455UMASS_DEBUG		opt_usb.h
456UMS_DEBUG		opt_usb.h
457URIO_DEBUG		opt_usb.h
458UKBD_DFLT_KEYMAP	opt_ukbd.h
459
460# Vinum options
461VINUMDEBUG		opt_vinum.h
462
463# Embedded system options
464INIT_PATH		opt_init_path.h
465
466ROOTDEVNAME		opt_rootdevname.h
467
468FDC_DEBUG		opt_fdc.h
469PCFCLOCK_VERBOSE	opt_pcfclock.h
470PCFCLOCK_MAX_RETRIES	opt_pcfclock.h
471TDFX_LINUX opt_tdfx.h
472
473KTR			opt_global.h
474KTR_MASK		opt_ktr.h
475KTR_CPUMASK		opt_ktr.h
476KTR_COMPILE		opt_global.h
477KTR_ENTRIES		opt_global.h
478KTR_EXTEND		opt_global.h
479KTR_VERBOSE		opt_ktr.h
480MUTEX_DEBUG		opt_global.h
481CV_DEBUG		opt_global.h
482WITNESS			opt_global.h
483WITNESS_DDB		opt_witness.h
484WITNESS_SKIPSPIN	opt_witness.h
485
486# options for ACPI support
487ACPI_DEBUG		opt_acpi.h
488AML_DEBUG		opt_acpi.h
489ACPI_NO_ENABLE_ON_BOOT	opt_acpi.h
490
491# options for DEVFS, see sys/fs/devfs/devfs.h
492NDEVFSINO		opt_devfs.h
493NDEVFSOVERFLOW		opt_devfs.h
494
495# various 'device presence' options.
496DEV_SNP			opt_snp.h
497DEV_MCA			opt_mca.h
498DEV_BPF			opt_bpf.h
499