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