xref: /freebsd/sys/conf/options (revision a14a0223ae1b172e96dd2a1d849e22026a98b692)
1# $FreeBSD$
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
57MD5
58MFS_ROOT	opt_mfs.h
59MFS_ROOT_SIZE	opt_mfs.h
60NTIMECOUNTER	opt_ntp.h
61NSWAPDEV	opt_swap.h
62PPS_SYNC	opt_ntp.h
63QUOTA
64SPX_HACK
65SUIDDIR		opt_suiddir.h
66SYSVMSG		opt_sysvipc.h
67SYSVSEM		opt_sysvipc.h
68SYSVSHM		opt_sysvipc.h
69UCONSOLE
70ICMP_BANDLIM
71
72# POSIX kernel options
73P1003_1B			opt_posix.h
74_KPOSIX_PRIORITY_SCHEDULING	opt_posix.h
75_KPOSIX_VERSION			opt_posix.h
76
77# Do we want the config file compiled into the kernel?
78INCLUDE_CONFIG_FILE	opt_config.h
79
80# Options for static file systems.  These should only be used at config
81# time, since the corresponding lkms cannot work if there are any static
82# dependencies.  Unusability is enforced by hiding the defines for the
83# options in a never-included header.
84EXT2FS		opt_dontuse.h
85FDESC		opt_dontuse.h
86KERNFS		opt_dontuse.h
87MFS		opt_dontuse.h
88MSDOSFS		opt_dontuse.h
89NULLFS		opt_dontuse.h
90PORTAL		opt_dontuse.h
91PROCFS		opt_dontuse.h
92UMAPFS		opt_dontuse.h
93NTFS		opt_dontuse.h
94
95# These static filesystems has one slightly bogus static dependency in
96# sys/i386/i386/autoconf.c.  If any of these filesystems are
97# statically compiled into the kernel, code for mounting them as root
98# filesystems will be enabled - but look below.  Boot-code is purposely
99# unavailable for the LKM-based versions.
100CODA
101CD9660
102FFS
103NFS
104NWFS
105
106# If you are following the conditions in the copyright,
107# you can enable soft-updates which will speed up a lot of thigs
108# and make the system safer from crashes at the same time.
109# otherwise a STUB module will be compiled in.
110SOFTUPDATES	opt_ffs.h
111
112# The above static dependencies are planned removed, with a
113# <filesystem>_ROOT option to control if it usable as root.  This list
114# allows these options to be present in config files already (though
115# they won't make any difference yet).
116CD9660_ROOT	opt_cd9660.h
117FFS_ROOT	opt_ffs.h
118NFS_ROOT	opt_nfsroot.h
119
120# The union static file system has bogus static dependencies, so it isn't
121# hidden yet.
122UNION
123
124# Options used only in param.c.
125HZ		opt_param.h
126MAXFILES	opt_param.h
127MAXUSERS	opt_param.h
128MSGMNB		opt_param.h
129MSGMNI		opt_param.h
130MSGSEG		opt_param.h
131MSGSSZ		opt_param.h
132MSGTQL		opt_param.h
133NBUF		opt_param.h
134NMBCLUSTERS	opt_param.h
135NSFBUFS		opt_param.h
136SEMMAP		opt_param.h
137SEMMNI		opt_param.h
138SEMMNS		opt_param.h
139SEMMNU		opt_param.h
140SEMMSL		opt_param.h
141SEMOPM		opt_param.h
142SEMUME		opt_param.h
143SHMALL		opt_param.h
144SHMMAX		opt_param.h
145SHMMAXPGS	opt_param.h
146SHMMIN		opt_param.h
147SHMMNI		opt_param.h
148SHMSEG		opt_param.h
149
150# Generic SCSI options.
151CAM_MAX_HIGHPOWER	opt_cam.h
152CAMDEBUG		opt_cam.h
153CAM_DEBUG_DELAY		opt_cam.h
154CAM_DEBUG_BUS		opt_cam.h
155CAM_DEBUG_TARGET	opt_cam.h
156CAM_DEBUG_LUN		opt_cam.h
157CAM_DEBUG_FLAGS		opt_cam.h
158SCSI_DELAY		opt_scsi.h
159SCSI_NO_SENSE_STRINGS	opt_scsi.h
160SCSI_NO_OP_STRINGS	opt_scsi.h
161
162# Options used only in cam/scsi/scsi_cd.c
163CHANGER_MIN_BUSY_SECONDS	opt_cd.h
164CHANGER_MAX_BUSY_SECONDS	opt_cd.h
165
166# Options used only in cam/scsi/scsi_sa.c.
167SA_SPACE_TIMEOUT	opt_sa.h
168SA_REWIND_TIMEOUT	opt_sa.h
169SA_ERASE_TIMEOUT	opt_sa.h
170SA_1FM_AT_EOD		opt_sa.h
171
172# Options used only in cam/scsi/scsi_pt.c
173SCSI_PT_DEFAULT_TIMEOUT	opt_pt.h
174
175# Options used only in pci/ncr.c
176SCSI_NCR_DEBUG		opt_ncr.h
177SCSI_NCR_MAX_SYNC	opt_ncr.h
178SCSI_NCR_MAX_WIDE	opt_ncr.h
179SCSI_NCR_MYADDR		opt_ncr.h
180
181# Options used only in pci/isp_pci.c
182SCSI_ISP_NO_FWLOAD_MASK	opt_isp.h
183SCSI_ISP_NO_NVRAM_MASK	opt_isp.h
184SCSI_ISP_PREFER_MEM_MAP	opt_isp.h
185SCSI_ISP_FABRIC		opt_isp.h
186SCSI_ISP_SCCLUN		opt_isp.h
187SCSI_ISP_FCDUPLEX	opt_isp.h
188ISP_DISABLE_1020_SUPPORT	opt_isp.h
189ISP_DISABLE_1080_SUPPORT	opt_isp.h
190ISP_DISABLE_2100_SUPPORT	opt_isp.h
191ISP_DISABLE_2200_SUPPORT	opt_isp.h
192
193# Options used in the 'ata' ATA/ATAPI driver
194ATA_STATIC_ID		opt_ata.h
195ATA_16BIT_ONLY		opt_ata.h
196ATA_ENABLE_ATAPI_DMA	opt_ata.h
197
198# Resource limits.
199DFLDSIZ			opt_rlimit.h
200MAXDSIZ			opt_rlimit.h
201
202# Net stuff.
203BOOTP			opt_bootp.h
204BOOTP_COMPAT		opt_bootp.h
205BOOTP_NFSROOT		opt_bootp.h
206BOOTP_NFSV3		opt_bootp.h
207BOOTP_WIRED_TO		opt_bootp.h
208BRIDGE			opt_bdg.h
209MROUTING		opt_mrouting.h
210INET			opt_inet.h
211INET6			opt_inet.h
212IPDIVERT
213DUMMYNET		opt_ipdn.h
214IPFILTER_LKM		opt_ipfilter.h
215IPFIREWALL		opt_ipfw.h
216IPFIREWALL_VERBOSE	opt_ipfw.h
217IPFIREWALL_VERBOSE_LIMIT	opt_ipfw.h
218IPFIREWALL_DEFAULT_TO_ACCEPT	opt_ipfw.h
219IPFIREWALL_FORWARD		opt_ipfw.h
220IPSTEALTH
221IPX			opt_ipx.h
222IPXIP			opt_ipx.h
223IPTUNNEL		opt_ipx.h
224NCP			opt_ncp.h
225NETATALK		opt_atalk.h
226PPP_BSDCOMP		opt_ppp.h
227PPP_DEFLATE		opt_ppp.h
228PPP_FILTER		opt_ppp.h
229SLIP_IFF_OPTS		opt_slip.h
230TCP_COMPAT_42		opt_compat.h
231TCPDEBUG
232TCP_DROP_SYNFIN		opt_tcp_input.h
233TCP_RESTRICT_RST	opt_tcp_input.h
234
235# Netgraph(4). Use option NETGRAPH to enable the base netgraph code.
236# Each netgraph node type can be either be compiled into the kernel
237# or loaded dynamically. To get the former, include the corresponding
238# option below.
239NETGRAPH
240NETGRAPH_ASYNC		opt_netgraph.h
241NETGRAPH_CISCO		opt_netgraph.h
242NETGRAPH_ECHO		opt_netgraph.h
243NETGRAPH_FRAME_RELAY	opt_netgraph.h
244NETGRAPH_HOLE		opt_netgraph.h
245NETGRAPH_IFACE		opt_netgraph.h
246NETGRAPH_LMI		opt_netgraph.h
247NETGRAPH_PPP		opt_netgraph.h
248NETGRAPH_PPPOE		opt_netgraph.h
249NETGRAPH_RFC1490	opt_netgraph.h
250NETGRAPH_SOCKET		opt_netgraph.h
251NETGRAPH_TEE		opt_netgraph.h
252NETGRAPH_TTY		opt_netgraph.h
253NETGRAPH_UI		opt_netgraph.h
254NETGRAPH_VJC		opt_netgraph.h
255
256# ATM (HARP version)
257ATM_CORE		opt_atm.h
258ATM_IP			opt_atm.h
259ATM_SIGPVC		opt_atm.h
260ATM_SPANS		opt_atm.h
261ATM_UNI			opt_atm.h
262
263# XXX Conflict: # of devices vs network protocol (Native ATM).
264# This makes "atm.h" unusable.
265NATM			opt_natm.h
266
267DPT_ALLOW_MEMIO		opt_dpt.h	# Allow PCI devices to use memory
268					# mapped I/O
269# DPT driver debug flags
270DPT_MEASURE_PERFORMANCE	opt_dpt.h
271DPT_HANDLE_TIMEOUTS	opt_dpt.h
272DPT_TIMEOUT_FACTOR	opt_dpt.h
273DPT_LOST_IRQ		opt_dpt.h
274DPT_RESET_HBA		opt_dpt.h
275
276# Misc debug flags.  Most of these should probably be replaced with
277# 'DEBUG', and then let people recompile just the interesting modules
278# with 'make CC="cc -DDEBUG"'.
279CLUSTERDEBUG		opt_debug_cluster.h
280DEBUG_1284		opt_ppb_1284.h
281VP0_DEBUG		opt_vpo.h
282LPT_DEBUG		opt_lpt.h
283PLIP_DEBUG		opt_plip.h
284LOCKF_DEBUG		opt_debug_lockf.h
285LOUTB			opt_debug_outb.h
286NPX_DEBUG		opt_debug_npx.h
287NETATALKDEBUG		opt_atalk.h
288SI_DEBUG		opt_debug_si.h
289
290# Fb options
291FB_DEBUG		opt_fb.h
292FB_INSTALL_CDEV		opt_fb.h
293
294# ppbus related options
295PERIPH_1284		opt_ppb_1284.h
296DONTPROBE_1284		opt_ppb_1284.h
297
298# smbus related options
299ENABLE_ALART		opt_intpm.h
300
301# These cause changes all over the kernel
302BLKDEV_IOSIZE		opt_global.h
303DEBUG			opt_global.h
304DEBUG_LOCKS		opt_global.h
305DEBUG_VFS_LOCKS		opt_global.h
306DIAGNOSTIC		opt_global.h
307ENABLE_VFS_IOOPT	opt_global.h
308INVARIANT_SUPPORT	opt_global.h
309INVARIANTS		opt_global.h
310SIMPLELOCK_DEBUG	opt_global.h
311VFS_BIO_DEBUG		opt_global.h
312
313# These are VM related options
314VM_KMEM_SIZE		opt_vm.h
315VM_KMEM_SIZE_SCALE	opt_vm.h
316VM_KMEM_SIZE_MAX	opt_vm.h
317NO_SWAPPING		opt_vm.h
318PQ_NOOPT		opt_vmpage.h
319PQ_NORMALCACHE		opt_vmpage.h
320PQ_MEDIUMCACHE		opt_vmpage.h
321PQ_LARGECACHE		opt_vmpage.h
322PQ_HUGECACHE		opt_vmpage.h
323
324# Standard SMP options
325SMP			opt_global.h
326NCPU			opt_smp.h
327NBUS			opt_smp.h
328
329# sys/netkey
330KEY
331KEY_DEBUG		opt_key.h
332
333# Size of the kernel message buffer
334MSGBUF_SIZE		opt_msgbuf.h
335
336# PCI related options
337PCI_QUIET		opt_pci.h
338
339# NFS options
340NFS_MINATTRTIMO		opt_nfs.h
341NFS_MAXATTRTIMO		opt_nfs.h
342NFS_MINDIRATTRTIMO	opt_nfs.h
343NFS_MAXDIRATTRTIMO	opt_nfs.h
344NFS_GATHERDELAY		opt_nfs.h
345NFS_UIDHASHSIZ		opt_nfs.h
346NFS_WDELAYHASHSIZ	opt_nfs.h
347NFS_MUIDHASHSIZ		opt_nfs.h
348NFS_NOSERVER		opt_nfs.h
349NFS_DEBUG		opt_nfs.h
350
351# For the Bt848/Bt848A/Bt849/Bt878/Bt879 driver
352OVERRIDE_CARD			opt_bktr.h
353OVERRIDE_TUNER			opt_bktr.h
354OVERRIDE_DBX			opt_bktr.h
355OVERRIDE_MSP			opt_bktr.h
356BROOKTREE_SYSTEM_DEFAULT	opt_bktr.h
357BKTR_USE_PLL			opt_bktr.h
358BKTR_GPIO_ACCESS		opt_bktr.h
359BKTR_NO_MSP_RESET		opt_bktr.h
360BKTR_430_FX_MODE		opt_bktr.h
361BKTR_SIS_VIA_MODE		opt_bktr.h
362
363
364# meteor opt_meteor.h
365METEOR_ALLOC_PAGES	opt_meteor.h
366METEOR_TEST_VIDEO	opt_meteor.h
367METEOR_SYSTEM_DEFAULT	opt_meteor.h
368METEOR_DEALLOC_PAGES	opt_meteor.h
369METEOR_DEALLOC_ABOVE	opt_meteor.h
370
371# Various mi ISA bus flags
372COM_ESP			opt_sio.h
373COM_MULTIPORT		opt_sio.h
374EXTRA_SIO		opt_sio.h
375BREAK_TO_DEBUGGER	opt_comconsole.h
376
377# Include tweaks for running under the SimOS machine simulator.
378SIMOS			opt_simos.h
379
380# options for bus/device framework
381BUS_DEBUG		opt_bus.h
382
383# options for USB support
384UHCI_DEBUG		opt_usb.h
385OHCI_DEBUG		opt_usb.h
386USB_DEBUG		opt_usb.h
387UGEN_DEBUG		opt_usb.h
388UHID_DEBUG		opt_usb.h
389UHUB_DEBUG		opt_usb.h
390UKBD_DEBUG		opt_usb.h
391ULPT_DEBUG		opt_usb.h
392UMASS_DEBUG		opt_usb.h
393UMS_DEBUG		opt_usb.h
394
395# Vinum options
396VINUMDEBUG		opt_vinum.h
397
398# Embedded system options
399INIT_PATH		opt_init_path.h
400
401ROOTDEVNAME		opt_rootdevname.h
402
403FDC_DEBUG		opt_fdc.h
404FDC_YE			opt_fdc.h
405