options revision 56424
1254219Scy# $FreeBSD: head/sys/conf/options 56424 2000-01-23 03:35:11Z bp $
2254219Scy#
3254219Scy#        On the handling of kernel options
4254219Scy#
5254219Scy# All kernel options should be listed in LINT, with suitable
6254219Scy# descriptions.  Negative options (options that make some code not
7254219Scy# compile) should be commented out; LINT should compile as much code
8254219Scy# as possible.  Try to structure option-using code so that a single
9254219Scy# option only switch code on, or only switch code off, to make it
10254219Scy# possible to have a full compile-test.  If necessary, you can include
11254219Scy# "opt_lint.h" and check for COMPILING_LINT to get maximum code
12254219Scy# coverage.
13254219Scy#
14254219Scy# All new options shall also be listed in either "conf/options" or
15254219Scy# "<machine>/conf/options.<machine>".  Options that affect a single
16254219Scy# source-file <xxx>.[c|s] should be directed into "opt_<xxx>.h", while
17254219Scy# options that affect multiple files should either go in
18254219Scy# "opt_global.h" if this is a kernel-wide option (used just about
19254219Scy# everywhere), or in "opt_<option-name-in-lower-case>.h" if it affect
20254219Scy# only some files.  Note that the effect of listing only an option
21254219Scy# without a header-file-name in conf/options (and cousins) is that the
22254219Scy# last convention is followed.
23254219Scy#
24254219Scy# This handling scheme is not yet fully implemented.
25254219Scy#
26254219Scy#
27254219Scy# Format of this file:
28254219Scy# Option name	filename
29254219Scy#
30254219Scy# If filename is missing, the default is
31254219Scy# opt_<name-of-option-in-lower-case>.h
32254219Scy
33254219Scy# Adaptec aic7xxx SCSI controller options
34254219ScyAHC_ALLOW_MEMIO		opt_aic7xxx.h	# Allow PCI devices to use memory
35254219Scy					# mapped I/O
36254219Scy
37254219ScyAHC_TMODE_ENABLE	opt_aic7xxx.h	# Bitmap of units to enable
38254219Scy					# targetmode operations.
39254219Scy
40254219ScyAHC_DUMP_EEPROM		opt_aic7xxx.h	# Dump the contents of our
41254219Scy					# configuration prom.
42254219Scy
43254219ScyADW_ALLOW_MEMIO		opt_adw.h	# Allow PCI devices to use memory
44254219Scy					# mapped I/O
45254219Scy
46254219Scy# Miscellaneous options.
47254219ScyCOMPAT_43	opt_compat.h
48254219ScyCOMPAT_SUNOS	opt_compat.h
49254219ScyCOMPILING_LINT	opt_lint.h
50254219ScyCY_PCI_FASTINTR
51254219ScyDDB
52254219ScyDDB_UNATTENDED	opt_ddb.h
53254219ScyGDB_REMOTE_CHAT	opt_ddb.h
54254219ScyDEVFS
55254219ScyHW_WDOG
56254219ScyKTRACE
57254219ScyMD5
58254219ScyMD_ROOT		opt_md.h
59254219ScyMD_ROOT_SIZE	opt_md.h
60254219ScyMFS_ROOT	opt_mfs.h
61254219ScyMFS_ROOT_SIZE	opt_mfs.h
62254219ScyNTIMECOUNTER	opt_ntp.h
63254219ScyNSWAPDEV	opt_swap.h
64254219ScyPPS_SYNC	opt_ntp.h
65254219ScyQUOTA
66254219ScySPX_HACK
67254219ScySUIDDIR		opt_suiddir.h
68254219ScySYSVMSG		opt_sysvipc.h
69SYSVSEM		opt_sysvipc.h
70SYSVSHM		opt_sysvipc.h
71UCONSOLE
72ICMP_BANDLIM
73
74# POSIX kernel options
75P1003_1B			opt_posix.h
76_KPOSIX_PRIORITY_SCHEDULING	opt_posix.h
77_KPOSIX_VERSION			opt_posix.h
78
79# Do we want the config file compiled into the kernel?
80INCLUDE_CONFIG_FILE	opt_config.h
81
82# Options for static file systems.  These should only be used at config
83# time, since the corresponding lkms cannot work if there are any static
84# dependencies.  Unusability is enforced by hiding the defines for the
85# options in a never-included header.
86EXT2FS		opt_dontuse.h
87FDESC		opt_dontuse.h
88KERNFS		opt_dontuse.h
89MFS		opt_dontuse.h
90MSDOSFS		opt_dontuse.h
91NULLFS		opt_dontuse.h
92PORTAL		opt_dontuse.h
93PROCFS		opt_dontuse.h
94UMAPFS		opt_dontuse.h
95NTFS		opt_dontuse.h
96
97# These static filesystems has one slightly bogus static dependency in
98# sys/i386/i386/autoconf.c.  If any of these filesystems are
99# statically compiled into the kernel, code for mounting them as root
100# filesystems will be enabled - but look below.  Boot-code is purposely
101# unavailable for the LKM-based versions.
102CODA
103CD9660
104FFS
105NFS
106NWFS
107
108# If you are following the conditions in the copyright,
109# you can enable soft-updates which will speed up a lot of thigs
110# and make the system safer from crashes at the same time.
111# otherwise a STUB module will be compiled in.
112SOFTUPDATES	opt_ffs.h
113
114# The above static dependencies are planned removed, with a
115# <filesystem>_ROOT option to control if it usable as root.  This list
116# allows these options to be present in config files already (though
117# they won't make any difference yet).
118CD9660_ROOT	opt_cd9660.h
119FFS_ROOT	opt_ffs.h
120NFS_ROOT	opt_nfsroot.h
121
122# The union static file system has bogus static dependencies, so it isn't
123# hidden yet.
124UNION
125
126# Options used only in param.c.
127HZ		opt_param.h
128MAXFILES	opt_param.h
129MAXUSERS	opt_param.h
130MSGMNB		opt_param.h
131MSGMNI		opt_param.h
132MSGSEG		opt_param.h
133MSGSSZ		opt_param.h
134MSGTQL		opt_param.h
135NBUF		opt_param.h
136NMBCLUSTERS	opt_param.h
137NSFBUFS		opt_param.h
138SEMMAP		opt_param.h
139SEMMNI		opt_param.h
140SEMMNS		opt_param.h
141SEMMNU		opt_param.h
142SEMMSL		opt_param.h
143SEMOPM		opt_param.h
144SEMUME		opt_param.h
145SHMALL		opt_param.h
146SHMMAX		opt_param.h
147SHMMAXPGS	opt_param.h
148SHMMIN		opt_param.h
149SHMMNI		opt_param.h
150SHMSEG		opt_param.h
151
152# Generic SCSI options.
153CAM_MAX_HIGHPOWER	opt_cam.h
154CAMDEBUG		opt_cam.h
155CAM_DEBUG_DELAY		opt_cam.h
156CAM_DEBUG_BUS		opt_cam.h
157CAM_DEBUG_TARGET	opt_cam.h
158CAM_DEBUG_LUN		opt_cam.h
159CAM_DEBUG_FLAGS		opt_cam.h
160SCSI_DELAY		opt_scsi.h
161SCSI_NO_SENSE_STRINGS	opt_scsi.h
162SCSI_NO_OP_STRINGS	opt_scsi.h
163
164# Options used only in cam/scsi/scsi_cd.c
165CHANGER_MIN_BUSY_SECONDS	opt_cd.h
166CHANGER_MAX_BUSY_SECONDS	opt_cd.h
167
168# Options used only in cam/scsi/scsi_sa.c.
169SA_SPACE_TIMEOUT	opt_sa.h
170SA_REWIND_TIMEOUT	opt_sa.h
171SA_ERASE_TIMEOUT	opt_sa.h
172SA_1FM_AT_EOD		opt_sa.h
173
174# Options used only in cam/scsi/scsi_pt.c
175SCSI_PT_DEFAULT_TIMEOUT	opt_pt.h
176
177# Options used only in cam/scsi/scsi_ses.c
178SES_ENABLE_PASSTHROUGH	opt_ses.h
179
180# Options used in dev/sym/ (Symbios SCSI driver).
181SYM_SETUP_LP_PROBE_MAP	opt_sym.h	#-Low Priority Probe Map (bits)
182					# Allows the ncr to take precedence
183					# 1 (1<<0) -> 810a, 860
184					# 2 (1<<1) -> 825a, 875, 885, 895
185					# 4 (1<<2) -> 895a, 896, 1510d 
186SYM_SETUP_SCSI_DIFF	opt_sym.h	#-HVD support for 825a, 875, 885
187					# disabled:0 (default), enabled:1
188SYM_SETUP_PCI_PARITY	opt_sym.h	#-PCI parity checking
189					# disabled:0, enabled:1 (default)
190SYM_SETUP_MAX_LUN	opt_sym.h	#-Number of LUNs supported
191					# default:8, range:[1..64]
192
193# Options used only in pci/ncr.c
194SCSI_NCR_DEBUG		opt_ncr.h
195SCSI_NCR_MAX_SYNC	opt_ncr.h
196SCSI_NCR_MAX_WIDE	opt_ncr.h
197SCSI_NCR_MYADDR		opt_ncr.h
198
199# Options used only in pci/isp_pci.c
200SCSI_ISP_NO_FWLOAD_MASK	opt_isp.h
201SCSI_ISP_NO_NVRAM_MASK	opt_isp.h
202SCSI_ISP_PREFER_MEM_MAP	opt_isp.h
203SCSI_ISP_FABRIC		opt_isp.h
204SCSI_ISP_SCCLUN		opt_isp.h
205SCSI_ISP_FCDUPLEX	opt_isp.h
206SCSI_ISP_WWN		opt_isp.h
207ISP_DISABLE_1020_SUPPORT	opt_isp.h
208ISP_DISABLE_1080_SUPPORT	opt_isp.h
209ISP_DISABLE_2100_SUPPORT	opt_isp.h
210ISP_DISABLE_2200_SUPPORT	opt_isp.h
211ISP_COMPILE_FW			opt_isp.h
212ISP_COMPILE_1020_FW		opt_isp.h
213ISP_COMPILE_1080_FW		opt_isp.h
214ISP_COMPILE_2100_FW		opt_isp.h
215ISP_COMPILE_2200_FW		opt_isp.h
216ISP_TARGET_MODE		opt_isp.h
217
218# Options used in the 'ata' ATA/ATAPI driver
219ATA_STATIC_ID		opt_ata.h
220ATA_16BIT_ONLY		opt_ata.h
221ATA_ENABLE_ATAPI_DMA	opt_ata.h
222
223# Resource limits.
224DFLDSIZ			opt_rlimit.h
225MAXDSIZ			opt_rlimit.h
226
227# Net stuff.
228BOOTP			opt_bootp.h
229BOOTP_COMPAT		opt_bootp.h
230BOOTP_NFSROOT		opt_bootp.h
231BOOTP_NFSV3		opt_bootp.h
232BOOTP_WIRED_TO		opt_bootp.h
233BRIDGE			opt_bdg.h
234ETHER_II		opt_ef.h
235ETHER_8023		opt_ef.h
236ETHER_8022		opt_ef.h
237ETHER_SNAP		opt_ef.h
238MROUTING		opt_mrouting.h
239INET			opt_inet.h
240INET6			opt_inet6.h
241IPSEC			opt_ipsec.h
242IPSEC_ESP		opt_ipsec.h
243IPSEC_DEBUG		opt_ipsec.h
244IPSEC_IPV6FWD		opt_ipsec.h
245IPDIVERT
246DUMMYNET		opt_ipdn.h
247IPFILTER		opt_ipfilter.h
248IPFILTER_LOG		opt_ipfilter.h
249IPFILTER_LKM		opt_ipfilter.h
250IPFIREWALL		opt_ipfw.h
251IPFIREWALL_VERBOSE	opt_ipfw.h
252IPFIREWALL_VERBOSE_LIMIT	opt_ipfw.h
253IPFIREWALL_DEFAULT_TO_ACCEPT	opt_ipfw.h
254IPFIREWALL_FORWARD		opt_ipfw.h
255IPSTEALTH
256IPX			opt_ipx.h
257IPXIP			opt_ipx.h
258IPTUNNEL		opt_ipx.h
259NCP			opt_ncp.h
260NETATALK		opt_atalk.h
261PPP_BSDCOMP		opt_ppp.h
262PPP_DEFLATE		opt_ppp.h
263PPP_FILTER		opt_ppp.h
264SLIP_IFF_OPTS		opt_slip.h
265TCP_COMPAT_42		opt_compat.h
266TCPDEBUG
267TCP_DROP_SYNFIN		opt_tcp_input.h
268TCP_RESTRICT_RST	opt_tcp_input.h
269
270# Netgraph(4). Use option NETGRAPH to enable the base netgraph code.
271# Each netgraph node type can be either be compiled into the kernel
272# or loaded dynamically. To get the former, include the corresponding
273# option below. Each type has its own man page, e.g. ng_async(8).
274NETGRAPH
275NETGRAPH_ASYNC		opt_netgraph.h
276NETGRAPH_BPF		opt_netgraph.h
277NETGRAPH_CISCO		opt_netgraph.h
278NETGRAPH_ECHO		opt_netgraph.h
279NETGRAPH_FRAME_RELAY	opt_netgraph.h
280NETGRAPH_HOLE		opt_netgraph.h
281NETGRAPH_IFACE		opt_netgraph.h
282NETGRAPH_KSOCKET	opt_netgraph.h
283NETGRAPH_LMI		opt_netgraph.h
284NETGRAPH_PPP		opt_netgraph.h
285NETGRAPH_PPPOE		opt_netgraph.h
286NETGRAPH_PPTPGRE	opt_netgraph.h
287NETGRAPH_RFC1490	opt_netgraph.h
288NETGRAPH_SOCKET		opt_netgraph.h
289NETGRAPH_TEE		opt_netgraph.h
290NETGRAPH_TTY		opt_netgraph.h
291NETGRAPH_UI		opt_netgraph.h
292NETGRAPH_VJC		opt_netgraph.h
293
294# ATM (HARP version)
295ATM_CORE		opt_atm.h
296ATM_IP			opt_atm.h
297ATM_SIGPVC		opt_atm.h
298ATM_SPANS		opt_atm.h
299ATM_UNI			opt_atm.h
300
301# XXX Conflict: # of devices vs network protocol (Native ATM).
302# This makes "atm.h" unusable.
303NATM			opt_natm.h
304
305DPT_ALLOW_MEMIO		opt_dpt.h	# Allow PCI devices to use memory
306					# mapped I/O
307# DPT driver debug flags
308DPT_MEASURE_PERFORMANCE	opt_dpt.h
309DPT_HANDLE_TIMEOUTS	opt_dpt.h
310DPT_TIMEOUT_FACTOR	opt_dpt.h
311DPT_LOST_IRQ		opt_dpt.h
312DPT_RESET_HBA		opt_dpt.h
313
314# Misc debug flags.  Most of these should probably be replaced with
315# 'DEBUG', and then let people recompile just the interesting modules
316# with 'make CC="cc -DDEBUG"'.
317CLUSTERDEBUG		opt_debug_cluster.h
318DEBUG_1284		opt_ppb_1284.h
319VP0_DEBUG		opt_vpo.h
320LPT_DEBUG		opt_lpt.h
321PLIP_DEBUG		opt_plip.h
322LOCKF_DEBUG		opt_debug_lockf.h
323LOUTB			opt_debug_outb.h
324NPX_DEBUG		opt_debug_npx.h
325NETATALKDEBUG		opt_atalk.h
326SI_DEBUG		opt_debug_si.h
327
328# Fb options
329FB_DEBUG		opt_fb.h
330FB_INSTALL_CDEV		opt_fb.h
331
332# ppbus related options
333PERIPH_1284		opt_ppb_1284.h
334DONTPROBE_1284		opt_ppb_1284.h
335
336# smbus related options
337ENABLE_ALART		opt_intpm.h
338
339# These cause changes all over the kernel
340BLKDEV_IOSIZE		opt_global.h
341DEBUG			opt_global.h
342DEBUG_LOCKS		opt_global.h
343DEBUG_VFS_LOCKS		opt_global.h
344DIAGNOSTIC		opt_global.h
345ENABLE_VFS_IOOPT	opt_global.h
346INVARIANT_SUPPORT	opt_global.h
347INVARIANTS		opt_global.h
348SIMPLELOCK_DEBUG	opt_global.h
349VFS_BIO_DEBUG		opt_global.h
350
351# These are VM related options
352VM_KMEM_SIZE		opt_vm.h
353VM_KMEM_SIZE_SCALE	opt_vm.h
354VM_KMEM_SIZE_MAX	opt_vm.h
355NO_SWAPPING		opt_vm.h
356PQ_NOOPT		opt_vmpage.h
357PQ_NORMALCACHE		opt_vmpage.h
358PQ_MEDIUMCACHE		opt_vmpage.h
359PQ_LARGECACHE		opt_vmpage.h
360PQ_HUGECACHE		opt_vmpage.h
361
362# Standard SMP options
363SMP			opt_global.h
364NCPU			opt_smp.h
365NBUS			opt_smp.h
366
367# sys/netkey
368KEY
369
370# Size of the kernel message buffer
371MSGBUF_SIZE		opt_msgbuf.h
372
373# PCI related options
374PCI_QUIET		opt_pci.h
375
376# NFS options
377NFS_MINATTRTIMO		opt_nfs.h
378NFS_MAXATTRTIMO		opt_nfs.h
379NFS_MINDIRATTRTIMO	opt_nfs.h
380NFS_MAXDIRATTRTIMO	opt_nfs.h
381NFS_GATHERDELAY		opt_nfs.h
382NFS_UIDHASHSIZ		opt_nfs.h
383NFS_WDELAYHASHSIZ	opt_nfs.h
384NFS_MUIDHASHSIZ		opt_nfs.h
385NFS_NOSERVER		opt_nfs.h
386NFS_DEBUG		opt_nfs.h
387
388# For the Bt848/Bt848A/Bt849/Bt878/Bt879 driver
389OVERRIDE_CARD			opt_bktr.h
390OVERRIDE_TUNER			opt_bktr.h
391OVERRIDE_DBX			opt_bktr.h
392OVERRIDE_MSP			opt_bktr.h
393BROOKTREE_SYSTEM_DEFAULT	opt_bktr.h
394BKTR_USE_PLL			opt_bktr.h	
395BKTR_GPIO_ACCESS		opt_bktr.h
396BKTR_NO_MSP_RESET		opt_bktr.h
397BKTR_430_FX_MODE		opt_bktr.h
398BKTR_SIS_VIA_MODE		opt_bktr.h
399
400
401# meteor opt_meteor.h
402METEOR_ALLOC_PAGES	opt_meteor.h
403METEOR_TEST_VIDEO	opt_meteor.h
404METEOR_SYSTEM_DEFAULT	opt_meteor.h
405METEOR_DEALLOC_PAGES	opt_meteor.h
406METEOR_DEALLOC_ABOVE	opt_meteor.h
407
408# Various mi ISA bus flags
409COM_ESP			opt_sio.h
410COM_MULTIPORT		opt_sio.h
411BREAK_TO_DEBUGGER	opt_comconsole.h
412
413# Include tweaks for running under the SimOS machine simulator.
414SIMOS			opt_simos.h
415
416# options for bus/device framework
417BUS_DEBUG		opt_bus.h
418DEVICE_SYSCTLS		opt_bus.h
419
420# options for USB support
421UHCI_DEBUG		opt_usb.h
422OHCI_DEBUG		opt_usb.h
423USB_DEBUG		opt_usb.h
424UGEN_DEBUG		opt_usb.h
425UHID_DEBUG		opt_usb.h
426UHUB_DEBUG		opt_usb.h
427UKBD_DEBUG		opt_usb.h
428ULPT_DEBUG		opt_usb.h
429UMASS_DEBUG		opt_usb.h
430UMS_DEBUG		opt_usb.h
431
432# Vinum options
433VINUMDEBUG		opt_vinum.h
434
435# Embedded system options
436INIT_PATH		opt_init_path.h
437
438ROOTDEVNAME		opt_rootdevname.h
439
440FDC_DEBUG		opt_fdc.h
441PCFCLOCK_VERBOSE	opt_pcfclock.h
442PCFCLOCK_MAX_RETRIES	opt_pcfclock.h
443