options revision 65557
1# $FreeBSD: head/sys/conf/options 65557 2000-09-07 01:33:02Z jasone $
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 include
11# "opt_lint.h" and 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# "<machine>/conf/options.<machine>".  Options that affect a single
16# source-file <xxx>.[c|s] should be directed into "opt_<xxx>.h", while
17# options that affect multiple files should either go in
18# "opt_global.h" if this is a kernel-wide option (used just about
19# everywhere), or in "opt_<option-name-in-lower-case>.h" if it affect
20# only some files.  Note that the effect of listing only an option
21# without a header-file-name in conf/options (and cousins) is that the
22# last 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 aic7xxx SCSI controller options
34AHC_ALLOW_MEMIO		opt_aic7xxx.h	# Allow PCI devices to use memory
35					# mapped I/O
36
37AHC_TMODE_ENABLE	opt_aic7xxx.h	# Bitmap of units to enable
38					# targetmode operations.
39
40AHC_DUMP_EEPROM		opt_aic7xxx.h	# Dump the contents of our
41					# configuration prom.
42
43ADW_ALLOW_MEMIO		opt_adw.h	# Allow PCI devices to use memory
44					# mapped I/O
45
46# Miscellaneous options.
47COMPAT_43	opt_compat.h
48COMPAT_SUNOS	opt_compat.h
49COMPILING_LINT	opt_lint.h
50CY_PCI_FASTINTR
51DDB
52DDB_UNATTENDED	opt_ddb.h
53GDB_REMOTE_CHAT	opt_ddb.h
54DEVFS
55HW_WDOG
56KTRACE
57MD_NSECT	opt_md.h
58MD_ROOT		opt_md.h
59MD_ROOT_SIZE	opt_md.h
60MFS_ROOT	opt_mfs.h
61MFS_ROOT_SIZE	opt_mfs.h
62NTIMECOUNTER	opt_ntp.h
63NSWAPDEV	opt_swap.h
64PPS_SYNC	opt_ntp.h
65QUOTA
66RANDOMDEV
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
110KERNFS		opt_dontuse.h
111MFS		opt_dontuse.h
112MSDOSFS		opt_dontuse.h
113NULLFS		opt_dontuse.h
114PORTAL		opt_dontuse.h
115PROCFS		opt_dontuse.h
116UMAPFS		opt_dontuse.h
117NTFS		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
127NFS
128NWFS
129
130# If you are following the conditions in the copyright,
131# you can enable soft-updates which will speed up a lot of thigs
132# and make the system safer from crashes at the same time.
133# otherwise a STUB module will be compiled in.
134SOFTUPDATES	opt_ffs.h
135
136# Enabling this option turns on support for extended attributes
137# in FFS, which can be used to support high security configurations
138# as well as new file system features.
139FFS_EXTATTR	opt_ffs.h
140
141# The above static dependencies are planned removed, with a
142# <filesystem>_ROOT option to control if it usable as root.  This list
143# allows these options to be present in config files already (though
144# they won't make any difference yet).
145CD9660_ROOT	opt_cd9660.h
146FFS_ROOT	opt_ffs.h
147NFS_ROOT	opt_nfsroot.h
148
149# The union static file system has bogus static dependencies, so it isn't
150# hidden yet.
151UNION
152
153# Options used only in param.c.
154HZ		opt_param.h
155MAXFILES	opt_param.h
156MAXUSERS	opt_param.h
157NBUF		opt_param.h
158NMBCLUSTERS	opt_param.h
159NSFBUFS		opt_param.h
160
161# Generic SCSI options.
162CAM_MAX_HIGHPOWER	opt_cam.h
163CAMDEBUG		opt_cam.h
164CAM_DEBUG_DELAY		opt_cam.h
165CAM_DEBUG_BUS		opt_cam.h
166CAM_DEBUG_TARGET	opt_cam.h
167CAM_DEBUG_LUN		opt_cam.h
168CAM_DEBUG_FLAGS		opt_cam.h
169SCSI_DELAY		opt_scsi.h
170SCSI_NO_SENSE_STRINGS	opt_scsi.h
171SCSI_NO_OP_STRINGS	opt_scsi.h
172
173# Options used only in cam/scsi/scsi_cd.c
174CHANGER_MIN_BUSY_SECONDS	opt_cd.h
175CHANGER_MAX_BUSY_SECONDS	opt_cd.h
176
177# Options used only in cam/scsi/scsi_sa.c.
178SA_SPACE_TIMEOUT	opt_sa.h
179SA_REWIND_TIMEOUT	opt_sa.h
180SA_ERASE_TIMEOUT	opt_sa.h
181SA_1FM_AT_EOD		opt_sa.h
182
183# Options used only in cam/scsi/scsi_pt.c
184SCSI_PT_DEFAULT_TIMEOUT	opt_pt.h
185
186# Options used only in cam/scsi/scsi_ses.c
187SES_ENABLE_PASSTHROUGH	opt_ses.h
188
189# Options used in dev/sym/ (Symbios SCSI driver).
190SYM_SETUP_LP_PROBE_MAP	opt_sym.h	#-Low Priority Probe Map (bits)
191					# Allows the ncr to take precedence
192					# 1 (1<<0) -> 810a, 860
193					# 2 (1<<1) -> 825a, 875, 885, 895
194					# 4 (1<<2) -> 895a, 896, 1510d 
195SYM_SETUP_SCSI_DIFF	opt_sym.h	#-HVD support for 825a, 875, 885
196					# disabled:0 (default), enabled:1
197SYM_SETUP_PCI_PARITY	opt_sym.h	#-PCI parity checking
198					# disabled:0, enabled:1 (default)
199SYM_SETUP_MAX_LUN	opt_sym.h	#-Number of LUNs supported
200					# default:8, range:[1..64]
201
202# Options used only in pci/ncr.c
203SCSI_NCR_DEBUG		opt_ncr.h
204SCSI_NCR_MAX_SYNC	opt_ncr.h
205SCSI_NCR_MAX_WIDE	opt_ncr.h
206SCSI_NCR_MYADDR		opt_ncr.h
207
208# Options used only in pci/isp_pci.c
209ISP_TARGET_MODE		opt_isp.h
210
211# Options used in the 'ata' ATA/ATAPI driver
212ATA_STATIC_ID		opt_ata.h
213ATA_ENABLE_ATAPI_DMA	opt_ata.h
214
215# Resource limits.
216DFLDSIZ			opt_rlimit.h
217MAXDSIZ			opt_rlimit.h
218
219# Net stuff.
220ACCEPT_FILTER_DATA
221ACCEPT_FILTER_HTTP
222BOOTP			opt_bootp.h
223BOOTP_COMPAT		opt_bootp.h
224BOOTP_NFSROOT		opt_bootp.h
225BOOTP_NFSV3		opt_bootp.h
226BOOTP_WIRED_TO		opt_bootp.h
227BRIDGE			opt_bdg.h
228ETHER_II		opt_ef.h
229ETHER_8023		opt_ef.h
230ETHER_8022		opt_ef.h
231ETHER_SNAP		opt_ef.h
232MROUTING		opt_mrouting.h
233INET			opt_inet.h
234INET6			opt_inet6.h
235IPSEC			opt_ipsec.h
236IPSEC_ESP		opt_ipsec.h
237IPSEC_DEBUG		opt_ipsec.h
238IPDIVERT
239DUMMYNET		opt_ipdn.h
240IPFILTER		opt_ipfilter.h
241IPFILTER_LOG		opt_ipfilter.h
242IPFILTER_DEFAULT_BLOCK	opt_ipfilter.h
243PFIL_HOOKS		opt_pfil_hooks.h
244IPFIREWALL		opt_ipfw.h
245IPFIREWALL_VERBOSE	opt_ipfw.h
246IPFIREWALL_VERBOSE_LIMIT	opt_ipfw.h
247IPFIREWALL_DEFAULT_TO_ACCEPT	opt_ipfw.h
248IPFIREWALL_FORWARD		opt_ipfw.h
249IPV6FIREWALL		opt_ip6fw.h
250IPV6FIREWALL_VERBOSE	opt_ip6fw.h
251IPV6FIREWALL_VERBOSE_LIMIT	opt_ip6fw.h
252IPV6FIREWALL_DEFAULT_TO_ACCEPT	opt_ip6fw.h
253IPSTEALTH
254IPX			opt_ipx.h
255IPXIP			opt_ipx.h
256IPTUNNEL		opt_ipx.h
257NCP			opt_ncp.h
258NETATALK		opt_atalk.h
259PPP_BSDCOMP		opt_ppp.h
260PPP_DEFLATE		opt_ppp.h
261PPP_FILTER		opt_ppp.h
262SLIP_IFF_OPTS		opt_slip.h
263TCP_COMPAT_42		opt_compat.h
264TCPDEBUG
265TCP_DROP_SYNFIN		opt_tcp_input.h
266TCP_RESTRICT_RST	opt_tcp_input.h
267XBONEHACK
268
269# Netgraph(4). Use option NETGRAPH to enable the base netgraph code.
270# Each netgraph node type can be either be compiled into the kernel
271# or loaded dynamically. To get the former, include the corresponding
272# option below. Each type has its own man page, e.g. ng_async(4).
273NETGRAPH
274NETGRAPH_ASYNC		opt_netgraph.h
275NETGRAPH_BPF		opt_netgraph.h
276NETGRAPH_BRIDGE		opt_netgraph.h
277NETGRAPH_CISCO		opt_netgraph.h
278NETGRAPH_ECHO		opt_netgraph.h
279NETGRAPH_ETHER		opt_netgraph.h
280NETGRAPH_FRAME_RELAY	opt_netgraph.h
281NETGRAPH_HOLE		opt_netgraph.h
282NETGRAPH_IFACE		opt_netgraph.h
283NETGRAPH_KSOCKET	opt_netgraph.h
284NETGRAPH_LMI		opt_netgraph.h
285# MPPC compression requires proprietary files (not included)
286NETGRAPH_MPPC_COMPRESSION	opt_netgraph.h
287NETGRAPH_MPPC_ENCRYPTION	opt_netgraph.h
288NETGRAPH_PPP		opt_netgraph.h
289NETGRAPH_PPPOE		opt_netgraph.h
290NETGRAPH_PPTPGRE	opt_netgraph.h
291NETGRAPH_RFC1490	opt_netgraph.h
292NETGRAPH_SOCKET		opt_netgraph.h
293NETGRAPH_TEE		opt_netgraph.h
294NETGRAPH_TTY		opt_netgraph.h
295NETGRAPH_UI		opt_netgraph.h
296NETGRAPH_VJC		opt_netgraph.h
297
298# ATM (HARP version)
299ATM_CORE		opt_atm.h
300ATM_IP			opt_atm.h
301ATM_SIGPVC		opt_atm.h
302ATM_SPANS		opt_atm.h
303ATM_UNI			opt_atm.h
304
305# XXX Conflict: # of devices vs network protocol (Native ATM).
306# This makes "atm.h" unusable.
307NATM			opt_natm.h
308
309DPT_ALLOW_MEMIO		opt_dpt.h	# Allow PCI devices to use memory
310					# mapped I/O
311# DPT driver debug flags
312DPT_MEASURE_PERFORMANCE	opt_dpt.h
313DPT_HANDLE_TIMEOUTS	opt_dpt.h
314DPT_TIMEOUT_FACTOR	opt_dpt.h
315DPT_LOST_IRQ		opt_dpt.h
316DPT_RESET_HBA		opt_dpt.h
317
318# Adaptec ASR and DPT V/VI controller options
319ASR_MEASURE_PERFORMANCE	opt_asr.h
320
321# Misc debug flags.  Most of these should probably be replaced with
322# 'DEBUG', and then let people recompile just the interesting modules
323# with 'make CC="cc -DDEBUG"'.
324CLUSTERDEBUG		opt_debug_cluster.h
325DEBUG_1284		opt_ppb_1284.h
326VP0_DEBUG		opt_vpo.h
327LPT_DEBUG		opt_lpt.h
328PLIP_DEBUG		opt_plip.h
329LOCKF_DEBUG		opt_debug_lockf.h
330LOUTB			opt_debug_outb.h
331NPX_DEBUG		opt_debug_npx.h
332NETATALKDEBUG		opt_atalk.h
333SI_DEBUG		opt_debug_si.h
334
335# Fb options
336FB_DEBUG		opt_fb.h
337FB_INSTALL_CDEV		opt_fb.h
338
339# ppbus related options
340PERIPH_1284		opt_ppb_1284.h
341DONTPROBE_1284		opt_ppb_1284.h
342
343# smbus related options
344ENABLE_ALART		opt_intpm.h
345
346# These cause changes all over the kernel
347BLKDEV_IOSIZE		opt_global.h
348DEBUG			opt_global.h
349DEBUG_LOCKS		opt_global.h
350DEBUG_VFS_LOCKS		opt_global.h
351DIAGNOSTIC		opt_global.h
352ENABLE_VFS_IOOPT	opt_global.h
353INVARIANT_SUPPORT	opt_global.h
354INVARIANTS		opt_global.h
355SIMPLELOCK_DEBUG	opt_global.h
356VFS_BIO_DEBUG		opt_global.h
357
358# These are VM related options
359VM_KMEM_SIZE		opt_vm.h
360VM_KMEM_SIZE_SCALE	opt_vm.h
361VM_KMEM_SIZE_MAX	opt_vm.h
362NO_SWAPPING		opt_vm.h
363PQ_NOOPT		opt_vmpage.h
364PQ_NORMALCACHE		opt_vmpage.h
365PQ_MEDIUMCACHE		opt_vmpage.h
366PQ_LARGECACHE		opt_vmpage.h
367PQ_HUGECACHE		opt_vmpage.h
368PQ_CACHESIZE		opt_vmpage.h
369
370# Standard SMP options
371SMP			opt_global.h
372NCPU			opt_smp.h
373NBUS			opt_smp.h
374
375# sys/netkey
376KEY
377
378# Size of the kernel message buffer
379MSGBUF_SIZE		opt_msgbuf.h
380
381# PCI related options
382PCI_QUIET		opt_pci.h
383COMPAT_OLDPCI
384
385# NFS options
386NFS_MINATTRTIMO		opt_nfs.h
387NFS_MAXATTRTIMO		opt_nfs.h
388NFS_MINDIRATTRTIMO	opt_nfs.h
389NFS_MAXDIRATTRTIMO	opt_nfs.h
390NFS_GATHERDELAY		opt_nfs.h
391NFS_UIDHASHSIZ		opt_nfs.h
392NFS_WDELAYHASHSIZ	opt_nfs.h
393NFS_MUIDHASHSIZ		opt_nfs.h
394NFS_NOSERVER		opt_nfs.h
395NFS_DEBUG		opt_nfs.h
396
397# For the Bt848/Bt848A/Bt849/Bt878/Bt879 driver
398OVERRIDE_CARD			opt_bktr.h
399OVERRIDE_TUNER			opt_bktr.h
400OVERRIDE_DBX			opt_bktr.h
401OVERRIDE_MSP			opt_bktr.h
402BROOKTREE_SYSTEM_DEFAULT	opt_bktr.h
403BKTR_USE_PLL			opt_bktr.h	
404BKTR_GPIO_ACCESS		opt_bktr.h
405BKTR_NO_MSP_RESET		opt_bktr.h
406BKTR_430_FX_MODE		opt_bktr.h
407BKTR_SIS_VIA_MODE		opt_bktr.h
408
409
410# meteor opt_meteor.h
411METEOR_ALLOC_PAGES	opt_meteor.h
412METEOR_TEST_VIDEO	opt_meteor.h
413METEOR_SYSTEM_DEFAULT	opt_meteor.h
414METEOR_DEALLOC_PAGES	opt_meteor.h
415METEOR_DEALLOC_ABOVE	opt_meteor.h
416
417# Various mi ISA bus flags
418COM_ESP			opt_sio.h
419COM_MULTIPORT		opt_sio.h
420BREAK_TO_DEBUGGER	opt_comconsole.h
421ALT_BREAK_TO_DEBUGGER	opt_comconsole.h
422
423# Include tweaks for running under the SimOS machine simulator.
424SIMOS			opt_simos.h
425
426# options for bus/device framework
427BUS_DEBUG		opt_bus.h
428DEVICE_SYSCTLS		opt_bus.h
429
430# options for USB support
431UHCI_DEBUG		opt_usb.h
432OHCI_DEBUG		opt_usb.h
433USB_DEBUG		opt_usb.h
434UGEN_DEBUG		opt_usb.h
435UHID_DEBUG		opt_usb.h
436UHUB_DEBUG		opt_usb.h
437UKBD_DEBUG		opt_usb.h
438ULPT_DEBUG		opt_usb.h
439UMASS_DEBUG		opt_usb.h
440UMS_DEBUG		opt_usb.h
441URIO_DEBUG		opt_usb.h
442UKBD_DFLT_KEYMAP	opt_ukbd.h
443
444# Vinum options
445VINUMDEBUG		opt_vinum.h
446
447# Embedded system options
448INIT_PATH		opt_init_path.h
449
450ROOTDEVNAME		opt_rootdevname.h
451
452FDC_DEBUG		opt_fdc.h
453PCFCLOCK_VERBOSE	opt_pcfclock.h
454PCFCLOCK_MAX_RETRIES	opt_pcfclock.h
455TDFX_LINUX opt_tdfx.h
456
457KTR			opt_global.h
458KTR_MASK		opt_global.h
459KTR_CPUMASK		opt_global.h
460KTR_COMPILE		opt_global.h
461KTR_ENTRIES		opt_global.h
462KTR_EXTEND		opt_global.h
463SMP_DEBUG		opt_global.h
464WITNESS			opt_global.h
465
466# options for ACPI support
467ACPI_DEBUG		opt_acpi.h
468AML_DEBUG		opt_acpi.h
469ACPI_NO_ENABLE_ON_BOOT	opt_acpi.h
470ACPI_NO_OSDFUNC_INLINE	opt_acpi.h
471
472# options for DEVFS, see sys/fs/devfs/devfs.h
473NDEVFSINO		opt_devfs.h
474NDEVFSOVERFLOW		opt_devfs.h
475