xref: /freebsd/sys/conf/NOTES (revision dd267672cd131891951fb10bae04f6b0c8019179)
12365e64fSRodney W. Grimes#
219dde963SPeter Wemm# NOTES -- Lines that can be cut/pasted into kernel and hints configs.
3f71c01ccSPeter Wemm#
4f71c01ccSPeter Wemm# Lines that begin with 'device', 'options', 'machine', 'ident', 'maxusers',
5f71c01ccSPeter Wemm# 'makeoptions', 'hints' etc go into the kernel configuration that you
6f71c01ccSPeter Wemm# run config(8) with.
7f71c01ccSPeter Wemm#
8f71c01ccSPeter Wemm# Lines that begin with 'hints.' are NOT for config(8), they go into your
9f71c01ccSPeter Wemm# hints file.  See /boot/device.hints and/or the 'hints' config(8) directive.
102365e64fSRodney W. Grimes#
115d4850e7SAlexander Langer# Please use ``make LINT'' to create an old-style LINT file if you want to
125d4850e7SAlexander Langer# do kernel test-builds.
135d4850e7SAlexander Langer#
14dd267672SJohn Baldwin# This file contains machine independent kernel configuration notes.  For
15dd267672SJohn Baldwin# machine dependent notes, look in /sys/<arch>/conf/NOTES.
16dd267672SJohn Baldwin#
17c3aac50fSPeter Wemm# $FreeBSD$
182365e64fSRodney W. Grimes#
192365e64fSRodney W. Grimes
206a8d6623SGarrett Wollman#
216a8d6623SGarrett Wollman# This is the ``identification'' of the kernel.  Usually this should
226a8d6623SGarrett Wollman# be the same as the name of your kernel.
236a8d6623SGarrett Wollman#
246a8d6623SGarrett Wollmanident		LINT
256a8d6623SGarrett Wollman
266a8d6623SGarrett Wollman#
276a8d6623SGarrett Wollman# The `maxusers' parameter controls the static sizing of a number of
28c8b4c292SMatthew Dillon# internal system tables by a formula defined in subr_param.c.  Setting
29c8b4c292SMatthew Dillon# maxusers to 0 will cause the system to auto-size based on physical
30c8b4c292SMatthew Dillon# memory.
316a8d6623SGarrett Wollman#
326a8d6623SGarrett Wollmanmaxusers	10
336a8d6623SGarrett Wollman
346a8d6623SGarrett Wollman#
351b3c07c8SPoul-Henning Kamp# We want LINT to cover profiling as well
368a10dafbSPeter Wemmprofile 	2
371b3c07c8SPoul-Henning Kamp
381b3c07c8SPoul-Henning Kamp#
397bf01a14SPeter Wemm# The `makeoptions' parameter allows variables to be passed to the
40503e6666SBruce Evans# generated Makefile in the build area.
41503e6666SBruce Evans#
42503e6666SBruce Evans# CONF_CFLAGS gives some extra compiler flags that are added to ${CFLAGS}
43503e6666SBruce Evans# after most other flags.  Here we use it to inhibit use of non-optimal
44503e6666SBruce Evans# gcc builtin functions (e.g., memcmp).
45503e6666SBruce Evans#
46503e6666SBruce Evans# DEBUG happens to be magic.
477bf01a14SPeter Wemm# The following is equivalent to 'config -g KERNELNAME' and creates
487bf01a14SPeter Wemm# 'kernel.debug' compiled with -g debugging as well as a normal
497bf01a14SPeter Wemm# 'kernel'.  Use 'make install.debug' to install the debug kernel
507bf01a14SPeter Wemm# but that isn't normally necessary as the debug symbols are not loaded
517bf01a14SPeter Wemm# by the kernel and are not useful there anyway.
527bf01a14SPeter Wemm#
532c8635c6SPeter Wemm# KERNEL can be overridden so that you can change the default name of your
542c8635c6SPeter Wemm# kernel.
552c8635c6SPeter Wemm#
560e3d06b1SWarner Losh# MODULES_OVERRIDE can be used to limit modules built to a specific list.
570e3d06b1SWarner Losh#
58503e6666SBruce Evansmakeoptions	CONF_CFLAGS=-fno-builtin  #Don't allow use of memcmp, etc.
595895e3c8SPeter Wemm#makeoptions	DEBUG=-g		#Build kernel with gdb(1) debug symbols
602c8635c6SPeter Wemm#makeoptions	KERNEL=foo		#Build kernel "foo" and install "/foo"
610e3d06b1SWarner Losh# Only build Linux API modules and plus those parts of the sound system I need.
6206a9ff8eSWarner Losh#makeoptions	MODULES_OVERRIDE="linux sound/snd sound/pcm sound/driver/maestro3"
637bf01a14SPeter Wemm
647bf01a14SPeter Wemm#
6598eb9009SSeigo Tanimura# Certain applications can grow to be larger than the 512M limit
66d43f0f0aSJohn Dyson# that FreeBSD initially imposes.  Below are some options to
6798eb9009SSeigo Tanimura# allow that limit to grow to 1GB, and can be increased further
68d43f0f0aSJohn Dyson# with changing the parameters.  MAXDSIZ is the maximum that the
69d43f0f0aSJohn Dyson# limit can be set to, and the DFLDSIZ is the default value for
705ecfb8f9SJim Pirzyk# the limit.  MAXSSIZ is the maximum that the stack limit can be
715ecfb8f9SJim Pirzyk# set to.  You might want to set the default lower than the max,
725ecfb8f9SJim Pirzyk# and explicitly set the maximum with a shell command for processes
73d43f0f0aSJohn Dyson# that regularly exceed the limit like INND.
74d43f0f0aSJohn Dyson#
7598eb9009SSeigo Tanimuraoptions 	MAXDSIZ="(1024UL*1024*1024)"
765ecfb8f9SJim Pirzykoptions 	MAXSSIZ="(128UL*1024*1024)"
7798eb9009SSeigo Tanimuraoptions 	DFLDSIZ="(1024UL*1024*1024)"
78d43f0f0aSJohn Dyson
79a59d364aSMatthew Dillon#
80a59d364aSMatthew Dillon# BLKDEV_IOSIZE sets the default block size used in user block
81a59d364aSMatthew Dillon# device I/O.  Note that this value will be overriden by the label
82a59d364aSMatthew Dillon# when specifying a block device from a label with a non-0
838b22cebbSMatthew Dillon# partition blocksize.  The default is PAGE_SIZE.
84a59d364aSMatthew Dillon#
85a59d364aSMatthew Dillonoptions 	BLKDEV_IOSIZE=8192
86a59d364aSMatthew Dillon
8720f71813SJohn-Mark Gurney# Options for the VM subsystem
889a20f99aSJohn Baldwinoptions 	PQ_CACHESIZE=512	# color for 512k/16k cache
89dd267672SJohn Baldwinoptions 	KSTACK_PAGES=3		# number of stack pages per process
909a20f99aSJohn Baldwin# Deprecated options supported for backwards compatibility
9120f71813SJohn-Mark Gurney#options 	PQ_NOOPT		# No coloring
929a20f99aSJohn Baldwin#options 	PQ_LARGECACHE		# color for 512k/16k cache
9320f71813SJohn-Mark Gurney#options 	PQ_HUGECACHE		# color for 1024k/16k cache
947c43028bSKelly Yancey#options 	PQ_MEDIUMCACHE		# color for 256k/16k cache
957c43028bSKelly Yancey#options 	PQ_NORMALCACHE		# color for 64k/16k cache
9620f71813SJohn-Mark Gurney
97827d623eSJordan K. Hubbard# This allows you to actually store this configuration file into
98827d623eSJordan K. Hubbard# the kernel binary itself, where it may be later read by saying:
99ffd41c98SDoug Barton#    strings -n 3 /boot/kernel/kernel | sed -n 's/^___//p' > MYKERNEL
100827d623eSJordan K. Hubbard#
101827d623eSJordan K. Hubbardoptions 	INCLUDE_CONFIG_FILE     # Include this file in kernel
102827d623eSJordan K. Hubbard
103106d5017SPoul-Henning Kampoptions	GEOM				# Use the GEOMetry system for
1047b03a440SPoul-Henning Kamp					# disk-I/O transformations.
1057b03a440SPoul-Henning Kamp
1068b140d57SMike Smith#
1078b140d57SMike Smith# The root device and filesystem type can be compiled in;
1088b140d57SMike Smith# this provides a fallback option if the root device cannot
1093b6c640cSCrist J. Clark# be correctly guessed by the bootstrap code, or an override if
1108b140d57SMike Smith# the RB_DFLTROOT flag (-r) is specified when booting the kernel.
1118b140d57SMike Smith#
1128b140d57SMike Smithoptions 	ROOTDEVNAME=\"ufs:da0s2e\"
1138b140d57SMike Smith
1146a8d6623SGarrett Wollman
1156a8d6623SGarrett Wollman#####################################################################
116477a642cSPeter Wemm# SMP OPTIONS:
117477a642cSPeter Wemm#
118477a642cSPeter Wemm# SMP enables building of a Symmetric MultiProcessor Kernel.
119477a642cSPeter Wemm
120477a642cSPeter Wemm# Mandatory:
121477a642cSPeter Wemmoptions 	SMP			# Symmetric MultiProcessor Kernel
122477a642cSPeter Wemm
1231fe4c660SJohn Baldwin# SMP Debugging Options:
1241fe4c660SJohn Baldwin#
125ab4f2c18SJohn Baldwin# MUTEX_DEBUG enables various extra assertions in the mutex code.
1261fe4c660SJohn Baldwin# WITNESS enables the mutex witness code which detects deadlocks and cycles
1271fe4c660SJohn Baldwin#         during locking operations.
128660d1e3aSJohn Baldwin# WITNESS_DDB causes the witness code to drop into the kernel debugger if
129660d1e3aSJohn Baldwin#	  a lock heirarchy violation occurs or if locks are held when going to
130660d1e3aSJohn Baldwin#	  sleep.
131660d1e3aSJohn Baldwin# WITNESS_SKIPSPIN disables the witness checks on spin mutexes.
132ab4f2c18SJohn Baldwinoptions 	MUTEX_DEBUG
1331fe4c660SJohn Baldwinoptions 	WITNESS
134660d1e3aSJohn Baldwinoptions 	WITNESS_DDB
135660d1e3aSJohn Baldwinoptions 	WITNESS_SKIPSPIN
1361fe4c660SJohn Baldwin
137477a642cSPeter Wemm
138477a642cSPeter Wemm#####################################################################
1396a8d6623SGarrett Wollman# COMPATIBILITY OPTIONS
140690f540cSAndrey A. Chernov
1416a8d6623SGarrett Wollman#
1426a8d6623SGarrett Wollman# Implement system calls compatible with 4.3BSD and older versions of
14356c7a48cSJordan K. Hubbard# FreeBSD.  You probably do NOT want to remove this as much current code
14456c7a48cSJordan K. Hubbard# still relies on the 4.3 emulation.
1456a8d6623SGarrett Wollman#
1465895e3c8SPeter Wemmoptions 	COMPAT_43
1476a8d6623SGarrett Wollman
1486a8d6623SGarrett Wollman#
1496a8d6623SGarrett Wollman# These three options provide support for System V Interface
1506a8d6623SGarrett Wollman# Definition-style interprocess communication, in the form of shared
1516a8d6623SGarrett Wollman# memory, semaphores, and message queues, respectively.
1526a8d6623SGarrett Wollman#
1536a8d6623SGarrett Wollmanoptions 	SYSVSHM
1546a8d6623SGarrett Wollmanoptions 	SYSVSEM
1556a8d6623SGarrett Wollmanoptions 	SYSVMSG
1566a8d6623SGarrett Wollman
1576a8d6623SGarrett Wollman
1586a8d6623SGarrett Wollman#####################################################################
1596a8d6623SGarrett Wollman# DEBUGGING OPTIONS
1606a8d6623SGarrett Wollman
1616a8d6623SGarrett Wollman#
162b5d89ca8SBruce Evans# Enable the kernel debugger.
1636a8d6623SGarrett Wollman#
164b5d89ca8SBruce Evansoptions 	DDB
165b5d89ca8SBruce Evans
166b5d89ca8SBruce Evans#
1675ccab2afSGary Palmer# Don't drop into DDB for a panic. Intended for unattended operation
1685ccab2afSGary Palmer# where you may want to drop to DDB from the console, but still want
1695ccab2afSGary Palmer# the machine to recover from a panic
1705ccab2afSGary Palmer#
1715ccab2afSGary Palmeroptions 	DDB_UNATTENDED
1725ccab2afSGary Palmer
1735ccab2afSGary Palmer#
174562d05dfSPaul Traina# If using GDB remote mode to debug the kernel, there's a non-standard
175562d05dfSPaul Traina# extension to the remote protocol that can be used to use the serial
176562d05dfSPaul Traina# port as both the debugging port and the system console.  It's non-
177562d05dfSPaul Traina# standard and you're on your own if you enable it.  See also the
178562d05dfSPaul Traina# "remotechat" variables in the FreeBSD specific version of gdb.
179562d05dfSPaul Traina#
180562d05dfSPaul Trainaoptions 	GDB_REMOTE_CHAT
181562d05dfSPaul Traina
182562d05dfSPaul Traina#
1836a8d6623SGarrett Wollman# KTRACE enables the system-call tracing facility ktrace(2).
1846a8d6623SGarrett Wollman#
1852365e64fSRodney W. Grimesoptions 	KTRACE			#kernel tracing
18621c64a07SAndrey A. Chernov
1876a8d6623SGarrett Wollman#
188c508c1b6SJohn Baldwin# KTR is a kernel tracing mechanism imported from BSD/OS.  Currently it
189c508c1b6SJohn Baldwin# has no userland interface aside from a few sysctl's.  It is enabled with
1900f8870a2SJohn Baldwin# the KTR option.  KTR_ENTRIES defines the number of entries in the circular
1910f8870a2SJohn Baldwin# trace buffer.  KTR_COMPILE defines the mask of events to compile into the
1920f8870a2SJohn Baldwin# kernel as defined by the KTR_* constants in <sys/ktr.h>.  KTR_MASK defines the
193c508c1b6SJohn Baldwin# initial value of the ktr_mask variable which determines at runtime what
194c508c1b6SJohn Baldwin# events to trace.  KTR_CPUMASK determines which CPU's log events, with
195d902baa4SJohn Baldwin# bit X corresponding to cpu X.  KTR_VERBOSE enables dumping of KTR events
196d902baa4SJohn Baldwin# to the console by default.  This functionality can be toggled via the
197d902baa4SJohn Baldwin# debug.ktr_verbose sysctl and defaults to off if KTR_VERBOSE is not defined.
198c508c1b6SJohn Baldwin#
199c508c1b6SJohn Baldwinoptions 	KTR
200c508c1b6SJohn Baldwinoptions 	KTR_ENTRIES=1024
201c7ff3825SBruce Evansoptions 	KTR_COMPILE="(KTR_INTR|KTR_PROC)"
202a9672a81SJohn Baldwinoptions 	KTR_MASK=KTR_INTR
203c508c1b6SJohn Baldwinoptions 	KTR_CPUMASK=0x3
204d902baa4SJohn Baldwinoptions 	KTR_VERBOSE
205c508c1b6SJohn Baldwin
206c508c1b6SJohn Baldwin#
2075526d2d9SEivind Eklund# The INVARIANTS option is used in a number of source files to enable
2086a8d6623SGarrett Wollman# extra sanity checking of internal structures.  This support is not
2096a8d6623SGarrett Wollman# enabled by default because of the extra time it would take to check
2106a8d6623SGarrett Wollman# for these conditions, which can only occur as a result of
2116a8d6623SGarrett Wollman# programming errors.
2126a8d6623SGarrett Wollman#
2135526d2d9SEivind Eklundoptions 	INVARIANTS
2145526d2d9SEivind Eklund
2155526d2d9SEivind Eklund#
21634b15f2aSJohn Baldwin# The INVARIANT_SUPPORT option makes us compile in support for
21734b15f2aSJohn Baldwin# verifying some of the internal structures.  It is a prerequisite for
21834b15f2aSJohn Baldwin# 'INVARIANTS', as enabling 'INVARIANTS' will make these functions be
21934b15f2aSJohn Baldwin# called.  The intent is that you can set 'INVARIANTS' for single
22034b15f2aSJohn Baldwin# source files (by changing the source file or specifying it on the
22134b15f2aSJohn Baldwin# command line) if you have 'INVARIANT_SUPPORT' enabled.  Also, if you
22234b15f2aSJohn Baldwin# wish to build a kernel module with 'INVARIANTS', then adding
22334b15f2aSJohn Baldwin# 'INVARIANT_SUPPORT' to your kernel will provide all the necessary
22434b15f2aSJohn Baldwin# infrastructure without the added overhead.
22534b15f2aSJohn Baldwin#
22634b15f2aSJohn Baldwinoptions 	INVARIANT_SUPPORT
22734b15f2aSJohn Baldwin
22834b15f2aSJohn Baldwin#
2295526d2d9SEivind Eklund# The DIAGNOSTIC option is used to enable extra debugging information
2305526d2d9SEivind Eklund# from some parts of the kernel.  As this makes everything more noisy,
2315526d2d9SEivind Eklund# it is disabled by default.
2325526d2d9SEivind Eklund#
2330dc7d907SPoul-Henning Kampoptions 	DIAGNOSTIC
234da59a31cSDavid Greenman
2350dd1eea1SJordan K. Hubbard#
2360b5438c6SRobert Watson# REGRESSION causes optional kernel interfaces necessary only for regression
2370b5438c6SRobert Watson# testing to be enabled.  These interfaces may consitute security risks
2380b5438c6SRobert Watson# when enabled, as they permit processes to easily modify aspects of the
2390b5438c6SRobert Watson# run-time environment to reproduce unlikely or unusual (possibly normally
2400b5438c6SRobert Watson# impossible) scenarios.
2410b5438c6SRobert Watson#
2420b5438c6SRobert Watsonoptions 	REGRESSION
2430b5438c6SRobert Watson
2440b5438c6SRobert Watson#
2451432aa0cSJohn Baldwin# RESTARTABLE_PANICS allows one to continue from a panic as if it were
2461432aa0cSJohn Baldwin# a call to the debugger via the Debugger() function instead.  It is only
2471432aa0cSJohn Baldwin# useful if a kernel debugger is present.  To restart from a panic, reset
2481432aa0cSJohn Baldwin# the panicstr variable to NULL and continue execution.  This option is
2491432aa0cSJohn Baldwin# for development use only and should NOT be used in production systems
2501432aa0cSJohn Baldwin# to "workaround" a panic.
2511432aa0cSJohn Baldwin#
2529d60f0cbSJohn Baldwin#options 	RESTARTABLE_PANICS
2531432aa0cSJohn Baldwin
2541432aa0cSJohn Baldwin#
255346ebe51SEivind Eklund# This option let some drivers co-exist that can't co-exist in a running
256346ebe51SEivind Eklund# system.  This is used to be able to compile all kernel code in one go for
257346ebe51SEivind Eklund# quality assurance purposes (like this file, which the option takes it name
258346ebe51SEivind Eklund# from.)
259346ebe51SEivind Eklund#
260346ebe51SEivind Eklundoptions 	COMPILING_LINT
261346ebe51SEivind Eklund
262346ebe51SEivind Eklund
26396fc6efbSPoul-Henning Kamp# XXX - this doesn't belong here either
2642398f0cdSPeter Wemm#options 	USERCONFIG		#boot -c editor
2652398f0cdSPeter Wemm#options 	INTRO_USERCONFIG	#imply -c and show intro screen
2662398f0cdSPeter Wemm#options 	VISUAL_USERCONFIG	#visual boot -c editor
2676a8d6623SGarrett Wollman
2686a8d6623SGarrett Wollman#####################################################################
2696a8d6623SGarrett Wollman# NETWORKING OPTIONS
27070c0b54cSAndrey A. Chernov
2716a8d6623SGarrett Wollman#
2726a8d6623SGarrett Wollman# Protocol families:
2736a8d6623SGarrett Wollman#  Only the INET (Internet) family is officially supported in FreeBSD.
27411bfa65aSBruce Evans#  Source code for the NS (Xerox Network Service) is provided for amusement
27511bfa65aSBruce Evans#  value.
2766a8d6623SGarrett Wollman#
2776a8d6623SGarrett Wollmanoptions 	INET			#Internet communications protocols
27851f4c152SYoshinobu Inoueoptions 	INET6			#IPv6 communications protocols
2796a800098SYoshinobu Inoueoptions 	IPSEC			#IP security
2806a800098SYoshinobu Inoueoptions 	IPSEC_ESP		#IP security (crypto; define w/ IPSEC)
2816a800098SYoshinobu Inoueoptions 	IPSEC_DEBUG		#debug for IP security
282f73bbaf2SDavid Greenman
283cc6a66f2SJulian Elischeroptions 	IPX			#IPX/SPX communications protocols
284cc6a66f2SJulian Elischeroptions 	IPXIP			#IPX in IP encapsulation (not available)
285cc6a66f2SJulian Elischeroptions 	IPTUNNEL		#IP in IPX encapsulation (not available)
286cc6a66f2SJulian Elischer
287b40ce416SJulian Elischer#options 	NCP			#NetWare Core protocol
288e83e2322SBoris Popov
28934b5fca7SJulian Elischeroptions 	NETATALK		#Appletalk communications protocols
2908b6f5e65SJeroen Ruigrok van der Wervenoptions 	NETATALKDEBUG		#Appletalk debugging
29134b5fca7SJulian Elischer
29211bfa65aSBruce Evans# These are currently broken but are shipped due to interest.
29311bfa65aSBruce Evans#options 	NS			#Xerox NS protocols
294dc915e7cSGarrett Wollman#options 	NSIP			#XNS over IP
29563a74862SSteven Wallace
296daaa73b5SRobert Watson#
297daaa73b5SRobert Watson# SMB/CIFS requester
298daaa73b5SRobert Watson# NETSMB enables support for SMB protocol, it requires LIBMCHAIN and LIBICONV
299daaa73b5SRobert Watson# options.
300daaa73b5SRobert Watson# NETSMBCRYPTO enables support for encrypted passwords.
301daaa73b5SRobert Watsonoptions 	NETSMB			#SMB/CIFS requester
302daaa73b5SRobert Watsonoptions 	NETSMBCRYPTO		#encrypted password support for SMB
303daaa73b5SRobert Watson
304d8589bd5SBoris Popov# mchain library. It can be either loaded as KLD or compiled into kernel
305d8589bd5SBoris Popovoptions 	LIBMCHAIN
306d8589bd5SBoris Popov
3074cf49a43SJulian Elischer# netgraph(4). Enable the base netgraph code with the NETGRAPH option.
3084cf49a43SJulian Elischer# Individual node types can be enabled with the corresponding option
3094cf49a43SJulian Elischer# listed below; however, this is not strictly necessary as netgraph
3104cf49a43SJulian Elischer# will automatically load the corresponding KLD module if the node type
31192a3e552SArchie Cobbs# is not already compiled into the kernel. Each type below has a
31292a3e552SArchie Cobbs# corresponding man page, e.g., ng_async(8).
3134cf49a43SJulian Elischeroptions 	NETGRAPH		#netgraph(4) system
3144cf49a43SJulian Elischeroptions 	NETGRAPH_ASYNC
31592a3e552SArchie Cobbsoptions 	NETGRAPH_BPF
3164cf49a43SJulian Elischeroptions 	NETGRAPH_CISCO
3174cf49a43SJulian Elischeroptions 	NETGRAPH_ECHO
31846aa8b9bSArchie Cobbsoptions 	NETGRAPH_ETHER
3194cf49a43SJulian Elischeroptions 	NETGRAPH_FRAME_RELAY
32037379158SBrooks Davisoptions 	NETGRAPH_GIF
32137379158SBrooks Davisoptions 	NETGRAPH_GIF_DEMUX
3224cf49a43SJulian Elischeroptions 	NETGRAPH_HOLE
3234cf49a43SJulian Elischeroptions 	NETGRAPH_IFACE
32437379158SBrooks Davisoptions 	NETGRAPH_IP_INPUT
32548e94174SArchie Cobbsoptions 	NETGRAPH_KSOCKET
3264cf49a43SJulian Elischeroptions 	NETGRAPH_LMI
327a2b408adSArchie Cobbs# MPPC compression requires proprietary files (not included)
328a2b408adSArchie Cobbs#options 	NETGRAPH_MPPC_COMPRESSION
329a2b408adSArchie Cobbsoptions 	NETGRAPH_MPPC_ENCRYPTION
3307d7a5b89SArchie Cobbsoptions 	NETGRAPH_ONE2MANY
331b0801bacSArchie Cobbsoptions 	NETGRAPH_PPP
332b0801bacSArchie Cobbsoptions 	NETGRAPH_PPPOE
333add85a1dSArchie Cobbsoptions 	NETGRAPH_PPTPGRE
3344cf49a43SJulian Elischeroptions 	NETGRAPH_RFC1490
335b0801bacSArchie Cobbsoptions 	NETGRAPH_SOCKET
3364d60fee2SBrooks Davisoptions 	NETGRAPH_SPLIT
3374cf49a43SJulian Elischeroptions 	NETGRAPH_TEE
3384cf49a43SJulian Elischeroptions 	NETGRAPH_TTY
3394cf49a43SJulian Elischeroptions 	NETGRAPH_UI
340b58a8a3bSJulian Elischeroptions 	NETGRAPH_VJC
3414cf49a43SJulian Elischer
342c9953c3bSPeter Wemmdevice		mn	# Munich32x/Falc54 Nx64kbit/sec cards.
343599fcb02SPoul-Henning Kampdevice		lmc	# tulip based LanMedia WAN cards
34448ecc012SPoul-Henning Kampdevice		musycc	# LMC/SBE LMC1504 quad T1/E1
3453cf4d0bfSPoul-Henning Kamp
3466a8d6623SGarrett Wollman#
3476a8d6623SGarrett Wollman# Network interfaces:
348f71c01ccSPeter Wemm#  The `loop' device is MANDATORY when networking is enabled.
349f71c01ccSPeter Wemm#  The `ether' device provides generic code to handle
35056c7a48cSJordan K. Hubbard#  Ethernets; it is MANDATORY when a Ethernet device driver is
351722012ccSJulian Elischer#  configured or token-ring is enabled.
3521a02faf6SGarrett Wollman#  The `fddi' device provides generic code to support FDDI.
353eda6ecb2SMax Khon#  The `arcnet' device provides generic code to support Arcnet.
354f71c01ccSPeter Wemm#  The `sppp' device serves a similar role for certain types
355e7c234a1SPeter Wemm#  of synchronous PPP links (like `cx', `ar').
356f71c01ccSPeter Wemm#  The `sl' device implements the Serial Line IP (SLIP) service.
357f71c01ccSPeter Wemm#  The `ppp' device implements the Point-to-Point Protocol.
358f71c01ccSPeter Wemm#  The `bpf' device enables the Berkeley Packet Filter.  Be
359d29895dcSGarrett Wollman#  aware of the legal and administrative consequences of enabling this
360d29895dcSGarrett Wollman#  option.  The number of devices determines the maximum number of
361d29895dcSGarrett Wollman#  simultaneous BPF clients programs runnable.
362f71c01ccSPeter Wemm#  The `disc' device implements a minimal network interface,
36359d8d13fSGarrett Wollman#  which throws away all packets sent and never receives any.  It is
3641a02faf6SGarrett Wollman#  included for testing purposes.  This shows up as the `ds' interface.
3654c12b435SNick Sayer#  The `tap' device is a pty-like virtual Ethernet interface
366f71c01ccSPeter Wemm#  The `tun' device implements (user-)ppp and nos-tun
367f71c01ccSPeter Wemm#  The `gif' device implements IPv6 over IP4 tunneling,
368cfa1ca9dSYoshinobu Inoue#  IPv4 over IPv6 tunneling, IPv4 over IPv4 tunneling and
369cfa1ca9dSYoshinobu Inoue#  IPv6 over IPv6 tunneling.
370f57fc21cSJeroen Ruigrok van der Werven#  The XBONEHACK option allows the same pair of addresses to be configured on
371f57fc21cSJeroen Ruigrok van der Werven#  multiple gif interfaces.
372f71c01ccSPeter Wemm#  The `faith' device captures packets sent to it and diverts them
373cfa1ca9dSYoshinobu Inoue#  to the IPv4/IPv6 translation daemon.
374d5015639SMunechika SUMIKAWA#  The `stf' device implements 6to4 encapsulation.
375f71c01ccSPeter Wemm#  The `ef' device provides support for multiple ethernet frame types
3765d94d71cSBoris Popov#  specified via ETHER_* options. See ef(4) for details.
3776a8d6623SGarrett Wollman#
378829b5d55SPeter Wemm# The PPP_BSDCOMP option enables support for compress(1) style entire
379829b5d55SPeter Wemm# packet compression, the PPP_DEFLATE is for zlib/gzip style compression.
380829b5d55SPeter Wemm# PPP_FILTER enables code for filtering the ppp data stream and selecting
3816b5ca0d8SDag-Erling Smørgrav# events for resetting the demand dial activity timer - requires bpf.
382829b5d55SPeter Wemm# See pppd(8) for more details.
38389327d27SPeter Wemm#
384f71c01ccSPeter Wemmdevice		ether			#Generic Ethernet
3850fa2bf54SBrooks Davisdevice		vlan			#VLAN support
386f71c01ccSPeter Wemmdevice		token			#Generic TokenRing
387f71c01ccSPeter Wemmdevice		fddi			#Generic FDDI
388eda6ecb2SMax Khondevice		arcnet			#Generic Arcnet
389f71c01ccSPeter Wemmdevice		sppp			#Generic Synchronous PPP
390f71c01ccSPeter Wemmdevice		loop	1		#Network loopback device
391f71c01ccSPeter Wemmdevice		bpf			#Berkeley packet filter
392f71c01ccSPeter Wemmdevice		disc			#Discard device (ds0, ds1, etc)
3934c12b435SNick Sayerdevice		tap			#Virtual Ethernet driver
394f71c01ccSPeter Wemmdevice		tun			#Tunnel driver (ppp(8), nos-tun(8))
395f71c01ccSPeter Wemmdevice		sl			#Serial Line IP
396f71c01ccSPeter Wemmdevice		ppp	2		#Point-to-point protocol
39789327d27SPeter Wemmoptions 	PPP_BSDCOMP		#PPP BSD-compress support
39889327d27SPeter Wemmoptions 	PPP_DEFLATE		#PPP zlib/deflate/gzip support
3996b5ca0d8SDag-Erling Smørgravoptions 	PPP_FILTER		#enable bpf filtering (needs bpf)
400d29895dcSGarrett Wollman
401f71c01ccSPeter Wemmdevice		ef			# Multiple ethernet frames support
4025d94d71cSBoris Popovoptions 	ETHER_II		# enable Ethernet_II frame
4035d94d71cSBoris Popovoptions 	ETHER_8023		# enable Ethernet_802.3 (Novell) frame
4045d94d71cSBoris Popovoptions 	ETHER_8022		# enable Ethernet_802.2 frame
4055d94d71cSBoris Popovoptions 	ETHER_SNAP		# enable Ethernet_802.2/SNAP frame
4065d94d71cSBoris Popov
407cfa1ca9dSYoshinobu Inoue# for IPv6
4089753d2f8SBrooks Davisdevice		gif			#IPv6 and IPv4 tunneling
409f57fc21cSJeroen Ruigrok van der Wervenoptions 	XBONEHACK
4102f653328SBrooks Davisdevice		faith			#for IPv6 and IPv4 translation
411d5015639SMunechika SUMIKAWAdevice		stf			#6to4 IPv6 over IPv4 encapsulation
412cfa1ca9dSYoshinobu Inoue
4136a8d6623SGarrett Wollman#
4146a8d6623SGarrett Wollman# Internet family options:
4156a8d6623SGarrett Wollman#
4166a8d6623SGarrett Wollman# MROUTING enables the kernel multicast packet forwarder, which works
4176a8d6623SGarrett Wollman# with mrouted(8).
4186a8d6623SGarrett Wollman#
419d29895dcSGarrett Wollman# IPFIREWALL enables support for IP firewall construction, in
420ff6f025aSAlexander Langer# conjunction with the `ipfw' program.  IPFIREWALL_VERBOSE sends
421ff6f025aSAlexander Langer# logged packets to the system logger.  IPFIREWALL_VERBOSE_LIMIT
422ff6f025aSAlexander Langer# limits the number of times a matching entry can be logged.
423ab6e02daSJordan K. Hubbard#
424ab6e02daSJordan K. Hubbard# WARNING:  IPFIREWALL defaults to a policy of "deny ip from any to any"
425ab6e02daSJordan K. Hubbard# and if you do not add other rules during startup to allow access,
426a236d14cSJordan K. Hubbard# YOU WILL LOCK YOURSELF OUT.  It is suggested that you set firewall_type=open
427ab6e02daSJordan K. Hubbard# in /etc/rc.conf when first enabling this feature, then refining the
428ab6e02daSJordan K. Hubbard# firewall rules in /etc/rc.firewall after you've tested that the new kernel
429ab6e02daSJordan K. Hubbard# feature works properly.
4308dd4744eSJordan K. Hubbard#
431ffdd472dSPeter Wemm# IPFIREWALL_DEFAULT_TO_ACCEPT causes the default rule (at boot) to
432ffdd472dSPeter Wemm# allow everything.  Use with care, if a cracker can crash your
433ffdd472dSPeter Wemm# firewall machine, they can get to your protected machines.  However,
434ffdd472dSPeter Wemm# if you are using it as an as-needed filter for specific problems as
435ffdd472dSPeter Wemm# they arise, then this may be for you.  Changing the default to 'allow'
436ffdd472dSPeter Wemm# means that you won't get stuck if the kernel and /sbin/ipfw binary get
437ffdd472dSPeter Wemm# out of sync.
438d29895dcSGarrett Wollman#
43993e0e116SJulian Elischer# IPDIVERT enables the divert IP sockets, used by ``ipfw divert''
44093e0e116SJulian Elischer#
4411b968362SDag-Erling Smørgrav# IPSTEALTH enables code to support stealth forwarding (i.e., forwarding
4421b968362SDag-Erling Smørgrav# packets without touching the ttl).  This can be useful to hide firewalls
4431b968362SDag-Erling Smørgrav# from traceroute and similar tools.
4441b968362SDag-Erling Smørgrav#
44508d38d45SRobert Watson# PFIL_HOOKS enables an abtraction layer which is meant to be used in
44608d38d45SRobert Watson# network code where filtering is required.  See the pfil(9) man page.
44708d38d45SRobert Watson# This option is a subset of the IPFILTER option.
44808d38d45SRobert Watson#
4495e331acdSGarrett Wollman# TCPDEBUG enables code which keeps traces of the TCP state machine
4505e331acdSGarrett Wollman# for sockets with the SO_DEBUG option set, which can then be examined
4515e331acdSGarrett Wollman# using the trpt(8) utility.
45265e8111fSBruce Evans#
453e3178a06SJordan K. Hubbardoptions 	MROUTING		# Multicast routing
454d29895dcSGarrett Wollmanoptions 	IPFIREWALL		#firewall
4554479e72cSCrist J. Clarkoptions 	IPFIREWALL_VERBOSE	#enable logging to syslogd(8)
4561857b6feSDag-Erling Smørgravoptions 	IPFIREWALL_FORWARD	#enable transparent proxy support
4575895e3c8SPeter Wemmoptions 	IPFIREWALL_VERBOSE_LIMIT=100	#limit verbosity
458e43a9900SAlexander Langeroptions 	IPFIREWALL_DEFAULT_TO_ACCEPT	#allow everything by default
459210d0432SYoshinobu Inoueoptions 	IPV6FIREWALL		#firewall for IPv6
460210d0432SYoshinobu Inoueoptions 	IPV6FIREWALL_VERBOSE
461210d0432SYoshinobu Inoueoptions 	IPV6FIREWALL_VERBOSE_LIMIT=100
462210d0432SYoshinobu Inoueoptions 	IPV6FIREWALL_DEFAULT_TO_ACCEPT
46393e0e116SJulian Elischeroptions 	IPDIVERT		#divert sockets
4649cc86ee9SGuido van Rooijoptions 	IPFILTER		#ipfilter support
4659cc86ee9SGuido van Rooijoptions 	IPFILTER_LOG		#ipfilter logging
4668259bcdfSJeroen Ruigrok van der Wervenoptions 	IPFILTER_DEFAULT_BLOCK	#block all packets by default
4671b968362SDag-Erling Smørgravoptions 	IPSTEALTH		#support for stealth forwarding
46808d38d45SRobert Watsonoptions 	PFIL_HOOKS
46965e8111fSBruce Evansoptions 	TCPDEBUG
4706a8d6623SGarrett Wollman
47164dddc18SKris Kennaway# RANDOM_IP_ID causes the ID field in IP packets to be randomized
47264dddc18SKris Kennaway# instead of incremented by 1 with each packet generated.  This
47364dddc18SKris Kennaway# option closes a minor information leak which allows remote
47464dddc18SKris Kennaway# observers to determine the rate of packet generation on the
47564dddc18SKris Kennaway# machine by watching the counter.
47664dddc18SKris Kennawayoptions 	RANDOM_IP_ID
47764dddc18SKris Kennaway
478a79b7128SAlfred Perlstein# Statically Link in accept filters
479a79b7128SAlfred Perlsteinoptions 	ACCEPT_FILTER_DATA
480a79b7128SAlfred Perlsteinoptions 	ACCEPT_FILTER_HTTP
481a79b7128SAlfred Perlstein
482e46cd3d4SDag-Erling Smørgrav# TCP_DROP_SYNFIN adds support for ignoring TCP packets with SYN+FIN. This
483e46cd3d4SDag-Erling Smørgrav# prevents nmap et al. from identifying the TCP/IP stack, but breaks support
484e46cd3d4SDag-Erling Smørgrav# for RFC1644 extensions and is not recommended for web servers.
485e46cd3d4SDag-Erling Smørgrav#
486e46cd3d4SDag-Erling Smørgravoptions 	TCP_DROP_SYNFIN		#drop TCP packets with SYN+FIN
487e46cd3d4SDag-Erling Smørgrav
48868e9d934SLuigi Rizzo# DUMMYNET enables the "dummynet" bandwidth limiter. You need
489c578eeb3SLuigi Rizzo# IPFIREWALL as well. See the dummynet(4) and ipfw(8) manpages for more info.
490c578eeb3SLuigi Rizzo# When you run DUMMYNET it is advisable to also have "options HZ=1000"
491c578eeb3SLuigi Rizzo# to achieve a smoother scheduling of the traffic.
492c578eeb3SLuigi Rizzo#
49368e9d934SLuigi Rizzo# BRIDGE enables bridging between ethernet cards -- see bridge(4).
494c578eeb3SLuigi Rizzo# You can use IPFIREWALL and DUMMYNET together with bridging.
495c578eeb3SLuigi Rizzo#
49668ec4eb6SLuigi Rizzooptions 	DUMMYNET
49768ec4eb6SLuigi Rizzooptions 	BRIDGE
49868e9d934SLuigi Rizzo
4993f8c4506SPoul-Henning Kamp#
5003f8c4506SPoul-Henning Kamp# ATM (HARP version) options
5013f8c4506SPoul-Henning Kamp#
5023f8c4506SPoul-Henning Kamp# ATM_CORE includes the base ATM functionality code.  This must be included
5033f8c4506SPoul-Henning Kamp#	for ATM support.
5043f8c4506SPoul-Henning Kamp#
5053f8c4506SPoul-Henning Kamp# ATM_IP includes support for running IP over ATM.
5063f8c4506SPoul-Henning Kamp#
5073f8c4506SPoul-Henning Kamp# At least one (and usually only one) of the following signalling managers
5083f8c4506SPoul-Henning Kamp# must be included (note that all signalling managers include PVC support):
5093f8c4506SPoul-Henning Kamp# ATM_SIGPVC includes support for the PVC-only signalling manager `sigpvc'.
5103f8c4506SPoul-Henning Kamp# ATM_SPANS includes support for the `spans' signalling manager, which runs
5113f8c4506SPoul-Henning Kamp#	the FORE Systems's proprietary SPANS signalling protocol.
5123f8c4506SPoul-Henning Kamp# ATM_UNI includes support for the `uni30' and `uni31' signalling managers,
5133f8c4506SPoul-Henning Kamp#	which run the ATM Forum UNI 3.x signalling protocols.
5143f8c4506SPoul-Henning Kamp#
5153f8c4506SPoul-Henning Kamp# The `hea' driver provides support for the Efficient Networks, Inc.
5163f8c4506SPoul-Henning Kamp# ENI-155p ATM PCI Adapter.
5173f8c4506SPoul-Henning Kamp#
5183f8c4506SPoul-Henning Kamp# The `hfa' driver provides support for the FORE Systems, Inc.
5193f8c4506SPoul-Henning Kamp# PCA-200E ATM PCI Adapter.
5203f8c4506SPoul-Henning Kamp#
5213f8c4506SPoul-Henning Kampoptions 	ATM_CORE		#core ATM protocol family
5223f8c4506SPoul-Henning Kampoptions 	ATM_IP			#IP over ATM support
5233f8c4506SPoul-Henning Kampoptions 	ATM_SIGPVC		#SIGPVC signalling manager
5243f8c4506SPoul-Henning Kampoptions 	ATM_SPANS		#SPANS signalling manager
5253f8c4506SPoul-Henning Kampoptions 	ATM_UNI			#UNI signalling manager
526c9953c3bSPeter Wemmdevice		hea			#Efficient ENI-155p ATM PCI
527c9953c3bSPeter Wemmdevice		hfa			#FORE PCA-200E ATM PCI
5283f8c4506SPoul-Henning Kamp
5296a8d6623SGarrett Wollman
5306a8d6623SGarrett Wollman#####################################################################
5316a8d6623SGarrett Wollman# FILESYSTEM OPTIONS
532e3178a06SJordan K. Hubbard
5332365e64fSRodney W. Grimes#
5346a8d6623SGarrett Wollman# Only the root, /usr, and /tmp filesystems need be statically
5356a8d6623SGarrett Wollman# compiled; everything else will be automatically loaded at mount
536888a8e35SPoul-Henning Kamp# time.  (Exception: the UFS family--- FFS --- cannot
5376a8d6623SGarrett Wollman# currently be demand-loaded.)  Some people still prefer to statically
5386a8d6623SGarrett Wollman# compile other filesystems as well.
5396a8d6623SGarrett Wollman#
540a5b88b01SKATO Takenori# NB: The NULL, PORTAL, UMAP and UNION filesystems are known to be
541a5b88b01SKATO Takenori# buggy, and WILL panic your system if you attempt to do anything with
542a5b88b01SKATO Takenori# them.  They are included here as an incentive for some enterprising
543a5b88b01SKATO Takenori# soul to sit down and fix them.
5442365e64fSRodney W. Grimes#
545f1a9c715SDavid Greenman
5466a8d6623SGarrett Wollman# One of these is mandatory:
5476a8d6623SGarrett Wollmanoptions 	FFS			#Fast filesystem
548eb25edbdSPeter Wemmoptions 	NFSCLIENT		#Network File System
549eb25edbdSPeter Wemmoptions 	NFSSERVER		#Network File System
5506a8d6623SGarrett Wollman
5516a8d6623SGarrett Wollman# The rest are optional:
5525895e3c8SPeter Wemmoptions 	CD9660			#ISO 9660 filesystem
55399d300a1SRuslan Ermilovoptions 	FDESCFS			#File descriptor filesystem
5540adb9b96SPeter Wemmoptions 	HPFS			#OS/2 File system
555dba11ce5SAlexander Langeroptions 	MSDOSFS			#MS DOS File System (FAT, FAT32)
5563ee9bf69SEivind Eklundoptions 	NTFS			#NT File System
557f1a9c715SDavid Greenmanoptions 	NULLFS			#NULL filesystem
558b40ce416SJulian Elischer#options 	NWFS			#NetWare filesystem
55999d300a1SRuslan Ermilovoptions 	PORTALFS		#Portal filesystem
5604d2647f9SDag-Erling Smørgravoptions 	PROCFS			#Process filesystem (requires PSEUDOFS)
56152ebde4fSDag-Erling Smørgravoptions 	PSEUDOFS		#Pseudo-filesystem framework
562daaa73b5SRobert Watsonoptions 	SMBFS			#SMB/CIFS filesystem
563f1a9c715SDavid Greenmanoptions 	UMAPFS			#UID map filesystem
56499d300a1SRuslan Ermilovoptions 	UNIONFS			#Union filesystem
565ab9f3b29SPoul-Henning Kamp# options 	NODEVFS			#disable devices filesystem
566bcf77694SPeter Wemm# The xFS_ROOT options REQUIRE the associated ``options xFS''
567bcf77694SPeter Wemmoptions 	NFS_ROOT		#NFS usable as root device
5680b0c10b4SAdrian Chadd# This code enables IFS, an FFS which exports inodes as the namespace.
5690b0c10b4SAdrian Chadd# You can find details in src/sys/ufs/ifs/README .
5700b0c10b4SAdrian Chaddoptions 	IFS
571f1a9c715SDavid Greenman
572d0a28bafSAlexander Langer# Soft updates is a technique for improving file system speed and
573d61e6649SAlexander Langer# making abrupt shutdown less risky.
574f8f8d7afSEivind Eklund#
5753d5c4fdcSPoul-Henning Kampoptions 	SOFTUPDATES
576b1897c19SJulian Elischer
577a64ed089SRobert Watson# Extended attributes allow additional data to be associated with files,
57851be6918SChris D. Faulhaber# and is used for ACLs, Capabilities, and MAC labels.
57951be6918SChris D. Faulhaber# See src/sys/ufs/ufs/README.extattr for more information.
58049993db0SRobert Watsonoptions 	UFS_EXTATTR
58149993db0SRobert Watsonoptions 	UFS_EXTATTR_AUTOSTART
582a64ed089SRobert Watson
58351be6918SChris D. Faulhaber# Access Control List support for UFS filesystems.  The current ACL
58451be6918SChris D. Faulhaber# implementation requires extended attribute support, UFS_EXTATTR,
58551be6918SChris D. Faulhaber# for the underlying filesystem.
58651be6918SChris D. Faulhaber# See src/sys/ufs/ufs/README.acls for more information.
58751be6918SChris D. Faulhaberoptions 	UFS_ACL
58851be6918SChris D. Faulhaber
5899b5ad47fSIan Dowse# Directory hashing improves the speed of operations on very large
5909b5ad47fSIan Dowse# directories at the expense of some memory.
5919b5ad47fSIan Dowseoptions 	UFS_DIRHASH
5929b5ad47fSIan Dowse
59371e4fff8SPoul-Henning Kamp# Make space in the kernel for a root filesystem on a md device.
59471e4fff8SPoul-Henning Kamp# Define to the number of kilobytes to reserve for the filesystem.
59571e4fff8SPoul-Henning Kampoptions 	MD_ROOT_SIZE=10
59671e4fff8SPoul-Henning Kamp
59771e4fff8SPoul-Henning Kamp# Make the md device a potential root device, either with preloaded
59871e4fff8SPoul-Henning Kamp# images of type mfs_root or md_root.
59971e4fff8SPoul-Henning Kampoptions 	MD_ROOT
600d52d7365SPoul-Henning Kamp
601a401ebbeSDavid Greenman# Allow this many swap-devices.
6028f7939aeSMatthew Dillon#
6038f7939aeSMatthew Dillon# In order to manage swap, the system must reserve bitmap space that
6048f7939aeSMatthew Dillon# scales with the largest mounted swap device multiplied by NSWAPDEV,
6058f7939aeSMatthew Dillon# irregardless of whether other swap devices exist or not.  So it
6068f7939aeSMatthew Dillon# is not a good idea to make this value too large.
6072727da4cSDag-Erling Smørgravoptions 	NSWAPDEV=5
608a401ebbeSDavid Greenman
609495967e4SEivind Eklund# Disk quotas are supported when this option is enabled.
6102365e64fSRodney W. Grimesoptions 	QUOTA			#enable disk quotas
6116a8d6623SGarrett Wollman
612276756a4SDag-Erling Smørgrav# If you are running a machine just as a fileserver for PC and MAC
613276756a4SDag-Erling Smørgrav# users, using SAMBA or Netatalk, you may consider setting this option
614276756a4SDag-Erling Smørgrav# and keeping all those users' directories on a filesystem that is
615276756a4SDag-Erling Smørgrav# mounted with the suiddir option. This gives new files the same
616ec4e5afbSRobert Nordier# ownership as the directory (similar to group). It's a security hole
6176110161fSDag-Erling Smørgrav# if you let these users run programs, so confine it to file-servers
618276756a4SDag-Erling Smørgrav# (but it'll save you lots of headaches in those cases). Root owned
619276756a4SDag-Erling Smørgrav# directories are exempt and X bits are cleared. The suid bit must be
620276756a4SDag-Erling Smørgrav# set on the directory as well; see chmod(1) PC owners can't see/set
621276756a4SDag-Erling Smørgrav# ownerships so they keep getting their toes trodden on. This saves
622276756a4SDag-Erling Smørgrav# you all the support calls as the filesystem it's used on will act as
623276756a4SDag-Erling Smørgrav# they expect: "It's my dir so it must be my file".
624cb800e34SJulian Elischer#
625cb800e34SJulian Elischeroptions 	SUIDDIR
626cb800e34SJulian Elischer
627df394affSJohn-Mark Gurney# NFS options:
6285895e3c8SPeter Wemmoptions 	NFS_MINATTRTIMO=3	# VREG attrib cache timeout in sec
6295895e3c8SPeter Wemmoptions 	NFS_MAXATTRTIMO=60
6305895e3c8SPeter Wemmoptions 	NFS_MINDIRATTRTIMO=30	# VDIR attrib cache timeout in sec
6315895e3c8SPeter Wemmoptions 	NFS_MAXDIRATTRTIMO=60
6325895e3c8SPeter Wemmoptions 	NFS_GATHERDELAY=10	# Default write gather delay (msec)
6335895e3c8SPeter Wemmoptions 	NFS_WDELAYHASHSIZ=16	# and with this
634df394affSJohn-Mark Gurneyoptions 	NFS_DEBUG		# Enable NFS Debugging
635df394affSJohn-Mark Gurney
6369afcea2fSRobert V. Baron# Coda stuff:
6379afcea2fSRobert V. Baronoptions 	CODA			#CODA filesystem.
638f71c01ccSPeter Wemmdevice		vcoda	4		#coda minicache <-> venus comm.
639a1d55890SJordan K. Hubbard
640053a2b61SEivind Eklund#
641053a2b61SEivind Eklund# Add support for the EXT2FS filesystem of Linux fame.  Be a bit
642053a2b61SEivind Eklund# careful with this - the ext2fs code has a tendency to lag behind
643053a2b61SEivind Eklund# changes and not be exercised very much, so mounting read/write could
644053a2b61SEivind Eklund# be dangerous (and even mounting read only could result in panics.)
645053a2b61SEivind Eklund#
6465895e3c8SPeter Wemmoptions 	EXT2FS
647053a2b61SEivind Eklund
648dd85920aSJason Evans# Use real implementations of the aio_* system calls.  There are numerous
6490cbe2ad6SRobert Watson# stability and security issues in the current aio code that make it
6500cbe2ad6SRobert Watson# unsuitable for inclusion on machines with untrusted local users.
651dd85920aSJason Evansoptions 	VFS_AIO
652053a2b61SEivind Eklund
653c16dc61bSEivind Eklund# Enable the code UFS IO optimization through the VM system.  This allows
654c16dc61bSEivind Eklund# use VM operations instead of copying operations when possible.
655c16dc61bSEivind Eklund#
656c16dc61bSEivind Eklund# Even with this enabled, actual use of the code is still controlled by the
657c16dc61bSEivind Eklund# sysctl vfs.ioopt.  0 gives no optimization, 1 gives normal (use VM
658c16dc61bSEivind Eklund# operations if a request happens to fit), 2 gives agressive optimization
659c16dc61bSEivind Eklund# (the operations are split to do as much as possible through the VM system.)
660c16dc61bSEivind Eklund#
661c16dc61bSEivind Eklund# Enabling this will probably not give an overall speedup except for
662c16dc61bSEivind Eklund# special workloads.
663c16dc61bSEivind Eklundoptions 	ENABLE_VFS_IOOPT
664c16dc61bSEivind Eklund
66515bbdecfSMark Murray# Cryptographically secure random number generator; /dev/[u]random
666ac519db0SMark Murraydevice		random
66715bbdecfSMark Murray
6686a8d6623SGarrett Wollman
6696a8d6623SGarrett Wollman#####################################################################
670abc97a06SBruce Evans# POSIX P1003.1B
671abc97a06SBruce Evans
672ec4e5afbSRobert Nordier# Real time extensions added in the 1993 Posix
673abc97a06SBruce Evans# P1003_1B: Infrastructure
674abc97a06SBruce Evans# _KPOSIX_PRIORITY_SCHEDULING: Build in _POSIX_PRIORITY_SCHEDULING
675abc97a06SBruce Evans# _KPOSIX_VERSION:             Version kernel is built for
676abc97a06SBruce Evans
6775895e3c8SPeter Wemmoptions 	P1003_1B
6785895e3c8SPeter Wemmoptions 	_KPOSIX_PRIORITY_SCHEDULING
6795895e3c8SPeter Wemmoptions 	_KPOSIX_VERSION=199309L
680abc97a06SBruce Evans
681abc97a06SBruce Evans
682abc97a06SBruce Evans#####################################################################
683000033d0SJeroen Ruigrok van der Werven# CLOCK OPTIONS
684000033d0SJeroen Ruigrok van der Werven
685000033d0SJeroen Ruigrok van der Werven# The granularity of operation is controlled by the kernel option HZ whose
686c578eeb3SLuigi Rizzo# default value (100) means a granularity of 10ms (1s/HZ).
687c578eeb3SLuigi Rizzo# Some subsystems, such as DUMMYNET, might benefit from a smaller
688c578eeb3SLuigi Rizzo# granularity such as 1ms or less, for a smoother scheduling of packets.
689c578eeb3SLuigi Rizzo# Consider, however, that reducing the granularity too much might
690c578eeb3SLuigi Rizzo# cause excessive overhead in clock interrupt processing,
691c578eeb3SLuigi Rizzo# potentially causing ticks to be missed and thus actually reducing
692000033d0SJeroen Ruigrok van der Werven# the accuracy of operation.
693000033d0SJeroen Ruigrok van der Werven
694000033d0SJeroen Ruigrok van der Wervenoptions 	HZ=100
695000033d0SJeroen Ruigrok van der Werven
696000033d0SJeroen Ruigrok van der Werven
697000033d0SJeroen Ruigrok van der Werven#####################################################################
698de6a307eSPeter Dufault# SCSI DEVICES
699de6a307eSPeter Dufault
7006a8d6623SGarrett Wollman# SCSI DEVICE CONFIGURATION
7016a8d6623SGarrett Wollman
7026a8d6623SGarrett Wollman# The SCSI subsystem consists of the `base' SCSI code, a number of
703ebc1a0e2SPeter Dufault# high-level SCSI device `type' drivers, and the low-level host-adapter
7046a8d6623SGarrett Wollman# device drivers.  The host adapters are listed in the ISA and PCI
7056a8d6623SGarrett Wollman# device configuration sections below.
7066a8d6623SGarrett Wollman#
707265368d4SRodney W. Grimes# Beginning with FreeBSD 2.0.5 you can wire down your SCSI devices so
708ebc1a0e2SPeter Dufault# that a given bus, target, and LUN always come on line as the same
709ebc1a0e2SPeter Dufault# device unit.  In earlier versions the unit numbers were assigned
710ebc1a0e2SPeter Dufault# in the order that the devices were probed on the SCSI bus.  This
711ebc1a0e2SPeter Dufault# means that if you removed a disk drive, you may have had to rewrite
712ebc1a0e2SPeter Dufault# your /etc/fstab file, and also that you had to be careful when adding
713ebc1a0e2SPeter Dufault# a new disk as it may have been probed earlier and moved your device
714ebc1a0e2SPeter Dufault# configuration around.
715ebc1a0e2SPeter Dufault
716ebc1a0e2SPeter Dufault# This old behavior is maintained as the default behavior.  The unit
717ebc1a0e2SPeter Dufault# assignment begins with the first non-wired down unit for a device
718700daf5eSJustin T. Gibbs# type.  For example, if you wire a disk as "da3" then the first
719700daf5eSJustin T. Gibbs# non-wired disk will be assigned da4.
720ebc1a0e2SPeter Dufault
721ebc1a0e2SPeter Dufault# The syntax for wiring down devices is:
722ebc1a0e2SPeter Dufault
723f71c01ccSPeter Wemmhint.scbus.0.at="ahc0"
724f71c01ccSPeter Wemmhint.scbus.1.at="ahc1"
725f71c01ccSPeter Wemmhint.scbus.1.bus="0"
726f71c01ccSPeter Wemmhint.scbus.3.at="ahc2"
727f71c01ccSPeter Wemmhint.scbus.3.bus="0"
728f71c01ccSPeter Wemmhint.scbus.2.at="ahc2"
729f71c01ccSPeter Wemmhint.scbus.2.bus="1"
730f71c01ccSPeter Wemmhint.da.0.at="scbus0"
731f71c01ccSPeter Wemmhint.da.0.target="0"
732f71c01ccSPeter Wemmhint.da.0.unit="0"
733f71c01ccSPeter Wemmhint.da.1.at="scbus3"
734f71c01ccSPeter Wemmhint.da.1.target="1"
735f71c01ccSPeter Wemmhint.da.2.at="scbus2"
736f71c01ccSPeter Wemmhint.da.2.target="3"
737f71c01ccSPeter Wemmhint.sa.1.at="scbus1"
738f71c01ccSPeter Wemmhint.sa.1.target="6"
739ebc1a0e2SPeter Dufault
740ebc1a0e2SPeter Dufault# "units" (SCSI logical unit number) that are not specified are
741ebc1a0e2SPeter Dufault# treated as if specified as LUN 0.
742ebc1a0e2SPeter Dufault
743ebc1a0e2SPeter Dufault# All SCSI devices allocate as many units as are required.
744ebc1a0e2SPeter Dufault
745cf2458c9SMatt Jacob# The ch driver drives SCSI Media Changer ("jukebox") devices.
746cf2458c9SMatt Jacob#
747cf2458c9SMatt Jacob# The da driver drives SCSI Direct Access ("disk") and Optical Media
748cf2458c9SMatt Jacob# ("WORM") devices.
749cf2458c9SMatt Jacob#
750cf2458c9SMatt Jacob# The sa driver drives SCSI Sequential Access ("tape") devices.
751cf2458c9SMatt Jacob#
752cf2458c9SMatt Jacob# The cd driver drives SCSI Read Only Direct Access ("cd") devices.
753cf2458c9SMatt Jacob#
754cf2458c9SMatt Jacob# The ses driver drives SCSI Envinronment Services ("ses") and
755cf2458c9SMatt Jacob# SAF-TE ("SCSI Accessable Fault-Tolerant Enclosure") devices.
756cf2458c9SMatt Jacob#
757cf2458c9SMatt Jacob# The pt driver drives SCSI Processor devices.
758cf2458c9SMatt Jacob#
759cf2458c9SMatt Jacob#
760cf2458c9SMatt Jacob# Target Mode support is provided here but also requires that a SIM
761cf2458c9SMatt Jacob# (SCSI Host Adapter Driver) provide support as well.
762cf2458c9SMatt Jacob#
763cf2458c9SMatt Jacob# The targ driver provides target mode support as a Processor type device.
764cf2458c9SMatt Jacob# It exists to give the minimal context necessary to respond to Inquiry
765cf2458c9SMatt Jacob# commands. There is a sample user application that shows how the rest
766cf2458c9SMatt Jacob# of the command support might be done in /usr/share/examples/scsi_target.
767cf2458c9SMatt Jacob#
768cf2458c9SMatt Jacob# The targbh driver provides target mode support and exists to respond
769cf2458c9SMatt Jacob# to incoming commands that do not otherwise have a logical unit assigned
770cf2458c9SMatt Jacob# to them.
771cf2458c9SMatt Jacob#
772265368d4SRodney W. Grimes# The "unknown" device (uk? in pre-2.0.5) is now part of the base SCSI
773cf2458c9SMatt Jacob# configuration as the "pass" driver.
774ebc1a0e2SPeter Dufault
775c9953c3bSPeter Wemmdevice		scbus		#base SCSI code
776c9953c3bSPeter Wemmdevice		ch		#SCSI media changers
777c9953c3bSPeter Wemmdevice		da		#SCSI direct access devices (aka disks)
778c9953c3bSPeter Wemmdevice		sa		#SCSI tapes
779c9953c3bSPeter Wemmdevice		cd		#SCSI CD-ROMs
78064ed91d5SMatt Jacobdevice		ses		#SCSI Environmental Services (and SAF-TE)
781cf2458c9SMatt Jacobdevice		pt		#SCSI processor
78264ed91d5SMatt Jacobdevice		targ		#SCSI Target Mode Code
78364ed91d5SMatt Jacobdevice		targbh		#SCSI Target Mode Blackhole Device
784cf2458c9SMatt Jacobdevice		pass		#CAM passthrough driver
7858909a72bSPeter Dufault
786700daf5eSJustin T. Gibbs# CAM OPTIONS:
787700daf5eSJustin T. Gibbs# debugging options:
788700daf5eSJustin T. Gibbs# -- NOTE --  If you specify one of the bus/target/lun options, you must
789700daf5eSJustin T. Gibbs#             specify them all!
790700daf5eSJustin T. Gibbs# CAMDEBUG: When defined enables debugging macros
791700daf5eSJustin T. Gibbs# CAM_DEBUG_BUS:  Debug the given bus.  Use -1 to debug all busses.
792700daf5eSJustin T. Gibbs# CAM_DEBUG_TARGET:  Debug the given target.  Use -1 to debug all targets.
793700daf5eSJustin T. Gibbs# CAM_DEBUG_LUN:  Debug the given lun.  Use -1 to debug all luns.
794d05caa00SKenneth D. Merry# CAM_DEBUG_FLAGS:  OR together CAM_DEBUG_INFO, CAM_DEBUG_TRACE,
795d05caa00SKenneth D. Merry#                   CAM_DEBUG_SUBTRACE, and CAM_DEBUG_CDB
796700daf5eSJustin T. Gibbs#
797700daf5eSJustin T. Gibbs# CAM_MAX_HIGHPOWER: Maximum number of concurrent high power (start unit) cmds
798b29f9e40SMatt Jacob# CAM_NEW_TRAN_CODE: this is the new transport layer code that will be switched
799b29f9e40SMatt Jacob#			to soon
800700daf5eSJustin T. Gibbs# SCSI_NO_SENSE_STRINGS: When defined disables sense descriptions
801700daf5eSJustin T. Gibbs# SCSI_NO_OP_STRINGS: When defined disables opcode descriptions
80256234437SKenneth D. Merry# SCSI_DELAY: The number of MILLISECONDS to freeze the SIM (scsi adapter)
80356234437SKenneth D. Merry#             queue after a bus reset, and the number of milliseconds to
80456234437SKenneth D. Merry#             freeze the device queue after a bus device reset.
805700daf5eSJustin T. Gibbsoptions 	CAMDEBUG
8065895e3c8SPeter Wemmoptions 	CAM_DEBUG_BUS=-1
8075895e3c8SPeter Wemmoptions 	CAM_DEBUG_TARGET=-1
8085895e3c8SPeter Wemmoptions 	CAM_DEBUG_LUN=-1
8095895e3c8SPeter Wemmoptions 	CAM_DEBUG_FLAGS="CAM_DEBUG_INFO|CAM_DEBUG_TRACE|CAM_DEBUG_CDB"
8105895e3c8SPeter Wemmoptions 	CAM_MAX_HIGHPOWER=4
811700daf5eSJustin T. Gibbsoptions 	SCSI_NO_SENSE_STRINGS
812700daf5eSJustin T. Gibbsoptions 	SCSI_NO_OP_STRINGS
81356234437SKenneth D. Merryoptions 	SCSI_DELAY=8000	# Be pessimistic about Joe SCSI device
8141a7c583cSGarrett Wollman
815700daf5eSJustin T. Gibbs# Options for the CAM CDROM driver:
816700daf5eSJustin T. Gibbs# CHANGER_MIN_BUSY_SECONDS: Guaranteed minimum time quantum for a changer LUN
817700daf5eSJustin T. Gibbs# CHANGER_MAX_BUSY_SECONDS: Maximum time quantum per changer LUN, only
818700daf5eSJustin T. Gibbs#                           enforced if there is I/O waiting for another LUN
819700daf5eSJustin T. Gibbs# The compiled in defaults for these variables are 2 and 10 seconds,
820700daf5eSJustin T. Gibbs# respectively.
82193063432SJoerg Wunsch#
822700daf5eSJustin T. Gibbs# These can also be changed on the fly with the following sysctl variables:
823700daf5eSJustin T. Gibbs# kern.cam.cd.changer.min_busy_seconds
824700daf5eSJustin T. Gibbs# kern.cam.cd.changer.max_busy_seconds
82593063432SJoerg Wunsch#
8265895e3c8SPeter Wemmoptions 	CHANGER_MIN_BUSY_SECONDS=2
8275895e3c8SPeter Wemmoptions 	CHANGER_MAX_BUSY_SECONDS=10
82893063432SJoerg Wunsch
8299dfb4471SKenneth D. Merry# Options for the CAM sequential access driver:
830b29f9e40SMatt Jacob# SA_IO_TIMEOUT: Timeout for read/write/wfm  operations, in minutes
8319dfb4471SKenneth D. Merry# SA_SPACE_TIMEOUT: Timeout for space operations, in minutes
8329dfb4471SKenneth D. Merry# SA_REWIND_TIMEOUT: Timeout for rewind operations, in minutes
8339dfb4471SKenneth D. Merry# SA_ERASE_TIMEOUT: Timeout for erase operations, in minutes
8349f050ed5SMatt Jacob# SA_1FM_AT_EOD: Default to model which only has a default one filemark at EOT.
835b29f9e40SMatt Jacoboptions 	SA_IO_TIMEOUT="(4)"
8365895e3c8SPeter Wemmoptions 	SA_SPACE_TIMEOUT="(60)"
8375895e3c8SPeter Wemmoptions 	SA_REWIND_TIMEOUT="(2*60)"
8385895e3c8SPeter Wemmoptions 	SA_ERASE_TIMEOUT="(4*60)"
8399f050ed5SMatt Jacoboptions 	SA_1FM_AT_EOD
8409dfb4471SKenneth D. Merry
8413ece1bd2SKenneth D. Merry# Optional timeout for the CAM processor target (pt) device
8423ece1bd2SKenneth D. Merry# This is specified in seconds.  The default is 60 seconds.
8433ece1bd2SKenneth D. Merryoptions 	SCSI_PT_DEFAULT_TIMEOUT="60"
8443ece1bd2SKenneth D. Merry
8458904e70bSMatt Jacob# Optional enable of doing SES passthrough on other devices (e.g., disks)
8468904e70bSMatt Jacob#
8478904e70bSMatt Jacob# Normally disabled because a lot of newer SCSI disks report themselves
8488904e70bSMatt Jacob# as having SES capabilities, but this can then clot up attempts to build
8498904e70bSMatt Jacob# build a topology with the SES device that's on the box these drives
8508904e70bSMatt Jacob# are in....
8518904e70bSMatt Jacoboptions 	SES_ENABLE_PASSTHROUGH
8528904e70bSMatt Jacob
8536a8d6623SGarrett Wollman
8546a8d6623SGarrett Wollman#####################################################################
8556a8d6623SGarrett Wollman# MISCELLANEOUS DEVICES AND OPTIONS
8566a8d6623SGarrett Wollman
8571160da92SJoerg Wunsch# The `pty' device usually turns out to be ``effectively mandatory'',
8581160da92SJoerg Wunsch# as it is required for `telnetd', `rlogind', `screen', `emacs', and
8591160da92SJoerg Wunsch# `xterm', among others.
8601160da92SJoerg Wunsch
861f71c01ccSPeter Wemmdevice		pty		#Pseudo ttys
8626d823e81SJulian Elischerdevice		nmdm		#back-to-back tty devices
863f71c01ccSPeter Wemmdevice		md		#Memory/malloc disk
864f71c01ccSPeter Wemmdevice		snp		#Snoop device - to look at pty/vty/etc..
865efacde1bSBrooks Davisdevice		ccd		#Concatenated disk driver
866be174c7eSGreg Lehey
867be174c7eSGreg Lehey# Configuring Vinum into the kernel is not necessary, since the kld
868be174c7eSGreg Lehey# module gets started automatically when vinum(8) starts.  This
869be174c7eSGreg Lehey# device is also untested.  Use at your own risk.
8704cc4752cSGreg Lehey#
8714cc4752cSGreg Lehey# The option VINUMDEBUG must match the value set in CFLAGS
87298a44096SSheldon Hearn# in src/sbin/vinum/Makefile.  Failure to do so will result in
8734cc4752cSGreg Lehey# the following message from vinum(8):
8744cc4752cSGreg Lehey#
8754cc4752cSGreg Lehey# Can't get vinum config: Invalid argument
8764cc4752cSGreg Lehey#
8774cc4752cSGreg Lehey# see vinum(4) for more reasons not to use these options.
878f71c01ccSPeter Wemmdevice		vinum		#Vinum concat/mirror/raid driver
8793ea799d5SPeter Wemmoptions 	VINUMDEBUG	#enable Vinum debugging hooks
8809ba0e7c3SBruce Evans
8816f2d8adbSBoris Popov# Kernel side iconv library
8826f2d8adbSBoris Popovoptions 	LIBICONV
8836f2d8adbSBoris Popov
88458067a99SPoul-Henning Kamp# Size of the kernel message buffer.  Should be N * pagesize.
8855895e3c8SPeter Wemmoptions 	MSGBUF_SIZE=40960
88658067a99SPoul-Henning Kamp
8876a8d6623SGarrett Wollman
8886a8d6623SGarrett Wollman#####################################################################
889d61e6649SAlexander Langer# HARDWARE BUS CONFIGURATION
8906a8d6623SGarrett Wollman
8916a8d6623SGarrett Wollman#
892dd267672SJohn Baldwin# ISA bus
8936a8d6623SGarrett Wollman#
894c9953c3bSPeter Wemmdevice		isa
8952365e64fSRodney W. Grimes
896595f6341SPoul-Henning Kamp# Enable support for the kernel PLL to use an external PPS signal,
897595f6341SPoul-Henning Kamp# under supervision of [x]ntpd(8)
898a2210fe1SPoul-Henning Kamp# More info in ntpd documentation: http://www.eecis.udel.edu/~ntp
899595f6341SPoul-Henning Kamp
900595f6341SPoul-Henning Kampoptions 	PPS_SYNC
901595f6341SPoul-Henning Kamp
902c2906d55SPoul-Henning Kamp# If you see the "calcru: negative time of %ld usec for pid %d (%s)\n"
903c2906d55SPoul-Henning Kamp# message you probably have some broken sw/hw which disables interrupts
904c2906d55SPoul-Henning Kamp# for too long.  You can make the system more resistant to this by
905c2906d55SPoul-Henning Kamp# choosing a high value for NTIMECOUNTER.  The default is 5, there
906c2906d55SPoul-Henning Kamp# is no upper limit but more than a couple of hundred are not productive.
907c2906d55SPoul-Henning Kamp
9085895e3c8SPeter Wemmoptions 	NTIMECOUNTER=20
909c2906d55SPoul-Henning Kamp
910d61e6649SAlexander Langer#
911d61e6649SAlexander Langer# PCI bus & PCI options:
912d61e6649SAlexander Langer#
913d61e6649SAlexander Langer# The main PCI bus device is `pci'.  It provides auto-detection and
914d61e6649SAlexander Langer# configuration support for all devices on the PCI bus, using either
915d61e6649SAlexander Langer# configuration mode defined in the PCI specification.
916d61e6649SAlexander Langer
917d61e6649SAlexander Langerdevice		pci
918d61e6649SAlexander Langer
919d61e6649SAlexander Langer
920d61e6649SAlexander Langer#####################################################################
921d61e6649SAlexander Langer# HARDWARE DEVICE CONFIGURATION
922d61e6649SAlexander Langer
923d61e6649SAlexander Langer# For ISA the required hints are listed.
924d61e6649SAlexander Langer# EISA, MCA, PCI and pccard are self identifying buses, so no hints
925d61e6649SAlexander Langer# are needed.
926d61e6649SAlexander Langer
927d61e6649SAlexander Langer#
928d61e6649SAlexander Langer# Mandatory devices:
929d61e6649SAlexander Langer#
930d61e6649SAlexander Langer
931ee16b430SBruce Evans# The syscons console driver (sco color console compatible).
932f71c01ccSPeter Wemmdevice		sc	1
933f71c01ccSPeter Wemmhint.sc.0.at="isa"
934683cbdf4SBruce Evansoptions 	MAXCONS=16		# number of virtual consoles
9356e8394b8SKazutaka YOKOTAoptions 	SC_ALT_MOUSE_IMAGE	# simplified mouse cursor in text mode
9366e8394b8SKazutaka YOKOTAoptions 	SC_DFLT_FONT		# compile font in
937cc6c2ad0SPeter Wemmmakeoptions	SC_DFLT_FONT=cp850
9386e8394b8SKazutaka YOKOTAoptions 	SC_DISABLE_DDBKEY	# disable `debug' key
939c4118fc0SKazutaka YOKOTAoptions 	SC_DISABLE_REBOOT	# disable reboot key sequence
9406e8394b8SKazutaka YOKOTAoptions 	SC_HISTORY_SIZE=200	# number of history buffer lines
9416e8394b8SKazutaka YOKOTAoptions 	SC_MOUSE_CHAR=0x3	# char code for text mode mouse cursor
9426e8394b8SKazutaka YOKOTAoptions 	SC_PIXEL_MODE		# add support for the raster text mode
94385e36760SJordan K. Hubbard
9447a88382dSKazutaka YOKOTA# The following options will let you change the default colors of syscons.
9457a88382dSKazutaka YOKOTAoptions 	SC_NORM_ATTR="(FG_GREEN|BG_BLACK)"
9467a88382dSKazutaka YOKOTAoptions 	SC_NORM_REV_ATTR="(FG_YELLOW|BG_GREEN)"
9477a88382dSKazutaka YOKOTAoptions 	SC_KERNEL_CONS_ATTR="(FG_RED|BG_BLACK)"
9487a88382dSKazutaka YOKOTAoptions 	SC_KERNEL_CONS_REV_ATTR="(FG_BLACK|BG_RED)"
9497a88382dSKazutaka YOKOTA
95078f45204SMaxim Sobolev# The following options will let you change the default behaviour of
95178f45204SMaxim Sobolev# cut-n-paste feature
95278f45204SMaxim Sobolevoptions 	SC_CUT_SPACES2TABS	# convert leading spaces into tabs
95378f45204SMaxim Sobolevoptions 	SC_CUT_SEPCHARS="\x20"	# set of characters that delimit words
95478f45204SMaxim Sobolev					# (default is single space - "\x20")
95578f45204SMaxim Sobolev
9567a88382dSKazutaka YOKOTA# If you have a two button mouse, you may want to add the following option
9577a88382dSKazutaka YOKOTA# to use the right button of the mouse to paste text.
9587a88382dSKazutaka YOKOTAoptions 	SC_TWOBUTTON_MOUSE
9597a88382dSKazutaka YOKOTA
9606e8394b8SKazutaka YOKOTA# You can selectively disable features in syscons.
9616e8394b8SKazutaka YOKOTAoptions 	SC_NO_CUTPASTE
9626e8394b8SKazutaka YOKOTAoptions 	SC_NO_FONT_LOADING
9636e8394b8SKazutaka YOKOTAoptions 	SC_NO_HISTORY
9646e8394b8SKazutaka YOKOTAoptions 	SC_NO_SYSMOUSE
9652ac8be82SAndreas Schulz
9668a28ce0eSJohn Baldwin# `flags' for sc
9678a28ce0eSJohn Baldwin#	0x80	Put the video card in the VESA 800x600 dots, 16 color mode
9688a28ce0eSJohn Baldwin#	0x100	Probe for a keyboard device periodically if one is not present
9698a28ce0eSJohn Baldwin
9701fe04850SBruce Evans#
971d61e6649SAlexander Langer# Optional devices:
9726a8d6623SGarrett Wollman#
9736a8d6623SGarrett Wollman
9746a8d6623SGarrett Wollman#
975d61e6649SAlexander Langer# SCSI host adapters:
9766a8d6623SGarrett Wollman#
977859244a6SJustin T. Gibbs# adw: Second Generation AdvanSys controllers including the ADV940UW.
978d61e6649SAlexander Langer# ahc: Adaptec 274x/284x/2910/293x/294x/394x/3950x/3960x/398X/4944/
979d61e6649SAlexander Langer#      19160x/29160x, aic7770/aic78xx
980d61e6649SAlexander Langer# amd: Support for the AMD 53C974 SCSI host adapter chip as found on devices
981d61e6649SAlexander Langer#      such as the Tekram DC-390(T).
982d61e6649SAlexander Langer# isp: Qlogic ISP 1020, 1040 and 1040B PCI SCSI host adapters,
983d61e6649SAlexander Langer#      ISP 1240 Dual Ultra SCSI, ISP 1080 and 1280 (Dual) Ultra2,
984d61e6649SAlexander Langer#      ISP 12160 Ultra3 SCSI,
985e8a0f829SMatt Jacob#      Qlogic ISP 2100 and ISP 2200 1Gb Fibre Channel host adapters.
986e8a0f829SMatt Jacob#      Qlogic ISP 2300 and ISP 2312 2Gb Fibre Channel host adapters.
987ac918c84SMatt Jacob# ispfw: Firmware module for Qlogic host adapters
988d61e6649SAlexander Langer# ncr: NCR 53C810, 53C825 self-contained SCSI host adapters.
989ae94720dSNoriaki Mitsunaga# ncv: NCR 53C500 based SCSI host adapters.
990ae94720dSNoriaki Mitsunaga# nsp: Workbit Ninja SCSI-3 based PC Card SCSI host adapters.
991fb91fd69SGerard Roudier# sym: Symbios/Logic 53C8XX family of PCI-SCSI I/O processors:
992fb91fd69SGerard Roudier#      53C810, 53C810A, 53C815, 53C825,  53C825A, 53C860, 53C875,
993fb91fd69SGerard Roudier#      53C876, 53C885,  53C895, 53C895A, 53C896,  53C897, 53C1510D,
994fb91fd69SGerard Roudier#      53C1010-33, 53C1010-66.
995d61e6649SAlexander Langer
996c9953c3bSPeter Wemmdevice		adw
997d61e6649SAlexander Langerdevice		ahc
998d61e6649SAlexander Langerdevice		amd
999d61e6649SAlexander Langerdevice		isp
10000787f2b8SMatt Jacobhint.isp.0.disable="1"
10010787f2b8SMatt Jacobhint.isp.0.role="3"
10020787f2b8SMatt Jacobhint.isp.0.prefer_iomap="1"
10030787f2b8SMatt Jacobhint.isp.0.prefer_memmap="1"
10040787f2b8SMatt Jacobhint.isp.0.fwload_disable="1"
10050787f2b8SMatt Jacobhint.isp.0.ignore_nvram="1"
10060787f2b8SMatt Jacobhint.isp.0.fullduplex="1"
10070787f2b8SMatt Jacobhint.isp.0.topology="lport"
10080787f2b8SMatt Jacobhint.isp.0.topology="nport"
10090787f2b8SMatt Jacobhint.isp.0.topology="lport-only"
10100787f2b8SMatt Jacobhint.isp.0.topology="nport-only"
10110787f2b8SMatt Jacob# we can't get u_int64_t types, nor can we get strings if it's got
10120787f2b8SMatt Jacob# a leading 0x, hence this silly dodge.
10130787f2b8SMatt Jacobhint.isp.0.portwnn="w50000000aaaa0000"
10140787f2b8SMatt Jacobhint.isp.0.nodewnn="w50000000aaaa0001"
1015d61e6649SAlexander Langerdevice		ispfw
1016d61e6649SAlexander Langerdevice		ncr
1017ae94720dSNoriaki Mitsunagadevice		ncv
1018ae94720dSNoriaki Mitsunagadevice		nsp
1019d61e6649SAlexander Langerdevice		sym
1020d61e6649SAlexander Langer
1021d61e6649SAlexander Langer# The aic7xxx driver will attempt to use memory mapped I/O for all PCI
1022d61e6649SAlexander Langer# controllers that have it configured only if this option is set. Unfortunately,
1023d61e6649SAlexander Langer# this doesn't work on some motherboards, which prevents it from being the
1024d61e6649SAlexander Langer# default.
1025d61e6649SAlexander Langeroptions 	AHC_ALLOW_MEMIO
1026d61e6649SAlexander Langer
1027fac70739SJeroen Ruigrok van der Werven# Enable diagnostic sequencer code.
1028fac70739SJeroen Ruigrok van der Wervenoptions 	AHC_DEBUG_SEQUENCER
1029fac70739SJeroen Ruigrok van der Werven
1030fac70739SJeroen Ruigrok van der Werven# Dump the contents of the ahc controller configuration PROM.
1031fac70739SJeroen Ruigrok van der Wervenoptions 	AHC_DUMP_EEPROM
1032fac70739SJeroen Ruigrok van der Werven
1033fac70739SJeroen Ruigrok van der Werven# Bitmap of units to enable targetmode operations.
1034fac70739SJeroen Ruigrok van der Wervenoptions 	AHC_TMODE_ENABLE
1035fac70739SJeroen Ruigrok van der Werven
1036d61e6649SAlexander Langer# The adw driver will attempt to use memory mapped I/O for all PCI
1037d61e6649SAlexander Langer# controllers that have it configured only if this option is set.
1038d61e6649SAlexander Langeroptions 	ADW_ALLOW_MEMIO
1039d61e6649SAlexander Langer
1040d61e6649SAlexander Langer# Options used in dev/isp/ (Qlogic SCSI/FC driver).
1041d61e6649SAlexander Langer#
1042d61e6649SAlexander Langer#	ISP_TARGET_MODE		-	enable target mode operation
1043d61e6649SAlexander Langer#
1044d61e6649SAlexander Langer#options 	ISP_TARGET_MODE=1
1045d61e6649SAlexander Langer
1046d61e6649SAlexander Langer# Options used in dev/sym/ (Symbios SCSI driver).
1047d61e6649SAlexander Langer#options 	SYM_SETUP_LP_PROBE_MAP	#-Low Priority Probe Map (bits)
1048d61e6649SAlexander Langer					# Allows the ncr to take precedence
1049d61e6649SAlexander Langer					# 1 (1<<0) -> 810a, 860
1050d61e6649SAlexander Langer					# 2 (1<<1) -> 825a, 875, 885, 895
1051d61e6649SAlexander Langer					# 4 (1<<2) -> 895a, 896, 1510d
1052d61e6649SAlexander Langer#options 	SYM_SETUP_SCSI_DIFF	#-HVD support for 825a, 875, 885
1053d61e6649SAlexander Langer					# disabled:0 (default), enabled:1
1054d61e6649SAlexander Langer#options 	SYM_SETUP_PCI_PARITY	#-PCI parity checking
1055d61e6649SAlexander Langer					# disabled:0, enabled:1 (default)
1056d61e6649SAlexander Langer#options 	SYM_SETUP_MAX_LUN	#-Number of LUNs supported
1057d61e6649SAlexander Langer					# default:8, range:[1..64]
10586a8d6623SGarrett Wollman
1059ef137fd3SMike Smith# The 'asr' driver provides support for current DPT/Adaptec SCSI RAID
1060ef137fd3SMike Smith# controllers (SmartRAID V and VI and later).
1061ef137fd3SMike Smith# These controllers require the CAM infrastructure.
1062ef137fd3SMike Smith#
1063ef137fd3SMike Smithdevice		asr
1064ef137fd3SMike Smith
1065153cbcc3SMike Smith# The 'dpt' driver provides support for old DPT controllers (http://www.dpt.com/).
1066153cbcc3SMike Smith# These have hardware RAID-{0,1,5} support, and do multi-initiator I/O.
1067153cbcc3SMike Smith# The DPT controllers are commonly re-licensed under other brand-names -
1068153cbcc3SMike Smith# some controllers by Olivetti, Dec, HP, AT&T, SNI, AST, Alphatronic, NEC and
1069153cbcc3SMike Smith# Compaq are actually DPT controllers.
1070153cbcc3SMike Smith#
1071153cbcc3SMike Smith# See src/sys/dev/dpt for debugging and other subtle options.
1072153cbcc3SMike Smith#   DPT_MEASURE_PERFORMANCE Enables a set of (semi)invasive metrics. Various
1073153cbcc3SMike Smith#                           instruments are enabled.  The tools in
1074153cbcc3SMike Smith#                           /usr/sbin/dpt_* assume these to be enabled.
1075153cbcc3SMike Smith#   DPT_HANDLE_TIMEOUTS     Normally device timeouts are handled by the DPT.
1076153cbcc3SMike Smith#                           If you ant the driver to handle timeouts, enable
1077153cbcc3SMike Smith#                           this option.  If your system is very busy, this
1078153cbcc3SMike Smith#                           option will create more trouble than solve.
1079153cbcc3SMike Smith#   DPT_TIMEOUT_FACTOR      Used to compute the excessive amount of time to
1080153cbcc3SMike Smith#                           wait when timing out with the above option.
1081153cbcc3SMike Smith#  DPT_DEBUG_xxxx           These are controllable from sys/dev/dpt/dpt.h
1082153cbcc3SMike Smith#  DPT_LOST_IRQ             When enabled, will try, once per second, to catch
1083153cbcc3SMike Smith#                           any interrupt that got lost.  Seems to help in some
1084153cbcc3SMike Smith#                           DPT-firmware/Motherboard combinations.  Minimal
1085153cbcc3SMike Smith#                           cost, great benefit.
1086153cbcc3SMike Smith#  DPT_RESET_HBA            Make "reset" actually reset the controller
1087153cbcc3SMike Smith#                           instead of fudging it.  Only enable this if you
1088153cbcc3SMike Smith#			    are 100% certain you need it.
1089153cbcc3SMike Smith
1090153cbcc3SMike Smithdevice		dpt
1091153cbcc3SMike Smith
1092153cbcc3SMike Smith# DPT options
1093153cbcc3SMike Smith#!CAM# options 	DPT_MEASURE_PERFORMANCE
1094153cbcc3SMike Smith#!CAM# options 	DPT_HANDLE_TIMEOUTS
1095153cbcc3SMike Smithoptions 	DPT_TIMEOUT_FACTOR=4
1096153cbcc3SMike Smithoptions 	DPT_LOST_IRQ
1097153cbcc3SMike Smithoptions 	DPT_RESET_HBA
1098153cbcc3SMike Smithoptions 	DPT_ALLOW_MEMIO
1099153cbcc3SMike Smith
1100153cbcc3SMike Smith#
11013a31b7ebSMike Smith# Compaq "CISS" RAID controllers (SmartRAID 5* series)
11023a31b7ebSMike Smith# These controllers have a SCSI-like interface, and require the
11033a31b7ebSMike Smith# CAM infrastructure.
11043a31b7ebSMike Smith#
11053a31b7ebSMike Smithdevice		ciss
11063a31b7ebSMike Smith
11073a31b7ebSMike Smith#
1108a245737cSMike Smith# Intel Integrated RAID controllers.
1109a245737cSMike Smith# This driver was developed and is maintained by Intel.  Contacts
1110a245737cSMike Smith# at Intel for this driver are
1111a245737cSMike Smith# "Kannanthanam, Boji T" <boji.t.kannanthanam@intel.com> and
1112a245737cSMike Smith# "Leubner, Achim" <achim.leubner@intel.com>.
1113a245737cSMike Smith#
1114a245737cSMike Smithdevice		iir
1115a245737cSMike Smith
1116a245737cSMike Smith#
1117153cbcc3SMike Smith# Mylex AcceleRAID and eXtremeRAID controllers with v6 and later
1118153cbcc3SMike Smith# firmware.  These controllers have a SCSI-like interface, and require
1119153cbcc3SMike Smith# the CAM infrastructure.
1120153cbcc3SMike Smith#
1121153cbcc3SMike Smithdevice		mly
1122153cbcc3SMike Smith
11238b89ef0aSSøren Schmidt#
112435863739SMike Smith# Adaptec FSA RAID controllers, including integrated DELL controllers,
112535863739SMike Smith# the Dell PERC 2/QC and the HP NetRAID-4M
1126ead270f1SMike Smith#
1127ead270f1SMike Smith# AAC_COMPAT_LINUX	Include code to support Linux-binary management
1128ead270f1SMike Smith#			utilities (requires Linux compatibility
1129ead270f1SMike Smith#			support).
1130ead270f1SMike Smith#
113135863739SMike Smithdevice		aac
113235863739SMike Smith
113335863739SMike Smith#
11345e3488e3SJonathan Lemon# Compaq Smart RAID, Mylex DAC960 and AMI MegaRAID controllers.  Only
11355e3488e3SJonathan Lemon# one entry is needed; the code will find and configure all supported
11365e3488e3SJonathan Lemon# controllers.
113713066c5fSJonathan Lemon#
11385e3488e3SJonathan Lemondevice		ida		# Compaq Smart RAID
1139c9953c3bSPeter Wemmdevice		mlx		# Mylex DAC960
1140c9953c3bSPeter Wemmdevice		amr		# AMI MegaRAID
11416ac4727aSMike Smith
11426ac4727aSMike Smith#
114390d3341eSPeter Wemm# 3ware ATA RAID
114490d3341eSPeter Wemm#
114590d3341eSPeter Wemmdevice		twe		# 3ware ATA RAID
114690d3341eSPeter Wemm
114790d3341eSPeter Wemm#
11486d04301dSAlexander Langer# The 'ATA' driver supports all ATA and ATAPI devices, including PC Card
11496d04301dSAlexander Langer# devices. You only need one "device ata" for it to find all
11506d04301dSAlexander Langer# PCI and PC Card ATA/ATAPI devices on modern machines.
1151c9953c3bSPeter Wemmdevice		ata
1152c9953c3bSPeter Wemmdevice		atadisk		# ATA disk drives
1153c9953c3bSPeter Wemmdevice		atapicd		# ATAPI CDROM drives
1154c9953c3bSPeter Wemmdevice		atapifd		# ATAPI floppy drives
1155c9953c3bSPeter Wemmdevice		atapist		# ATAPI tape drives
115674d8e840SSøren Schmidt
11578b89ef0aSSøren Schmidt#
11586d04301dSAlexander Langer# For older non-PCI, non-PnPBIOS systems, these are the hints lines to add:
11596d04301dSAlexander Langerhint.ata.0.at="isa"
11606d04301dSAlexander Langerhint.ata.0.port="0x1f0"
11616d04301dSAlexander Langerhint.ata.0.irq="14"
11626d04301dSAlexander Langerhint.ata.1.at="isa"
11636d04301dSAlexander Langerhint.ata.1.port="0x170"
11646d04301dSAlexander Langerhint.ata.1.irq="15"
11656d04301dSAlexander Langer
11666d04301dSAlexander Langer#
1167000da71aSSøren Schmidt# The following options are valid on the ATA driver:
1168000da71aSSøren Schmidt#
1169000da71aSSøren Schmidt# ATA_STATIC_ID:	controller numbering is static ie depends on location
117074d8e840SSøren Schmidt#			else the device numbers are dynamically allocated.
117174d8e840SSøren Schmidt
117274d8e840SSøren Schmidtoptions 	ATA_STATIC_ID
117374d8e840SSøren Schmidt
11748b89ef0aSSøren Schmidt#
11756d04301dSAlexander Langer# Standard floppy disk controllers and floppy tapes, supports
11766d04301dSAlexander Langer# the Y-E DATA External FDD (PC Card)
11776a8d6623SGarrett Wollman#
1178f71c01ccSPeter Wemmdevice		fdc
1179f71c01ccSPeter Wemmhint.fdc.0.at="isa"
1180f71c01ccSPeter Wemmhint.fdc.0.port="0x3F0"
1181f71c01ccSPeter Wemmhint.fdc.0.irq="6"
1182f71c01ccSPeter Wemmhint.fdc.0.drq="2"
118385827d9cSJoerg Wunsch#
1184d2fb4892SJoerg Wunsch# FDC_DEBUG enables floppy debugging.  Since the debug output is huge, you
1185d2fb4892SJoerg Wunsch# gotta turn it actually on by setting the variable fd_debug with DDB,
1186d2fb4892SJoerg Wunsch# however.
1187d2fb4892SJoerg Wunschoptions 	FDC_DEBUG
1188d2fb4892SJoerg Wunsch#
1189f71c01ccSPeter Wemm# Activate this line if you happen to have an Insight floppy tape.
1190f71c01ccSPeter Wemm# Probing them proved to be dangerous for people with floppy disks only,
1191f71c01ccSPeter Wemm# so it's "hidden" behind a flag:
1192f71c01ccSPeter Wemm#hint.fdc.0.flags="1"
119385827d9cSJoerg Wunsch
1194f71c01ccSPeter Wemm# Specify floppy devices
1195f71c01ccSPeter Wemmhint.fd.0.at="fdc0"
1196f71c01ccSPeter Wemmhint.fd.0.drive="0"
1197f71c01ccSPeter Wemmhint.fd.1.at="fdc0"
1198f71c01ccSPeter Wemmhint.fd.1.drive="1"
119985827d9cSJoerg Wunsch
12006a8d6623SGarrett Wollman#
12016d04301dSAlexander Langer# sio: serial ports (see sio(4)), including support for various
12026d04301dSAlexander Langer#      PC Card devices, such as Modem and NICs (see etc/defaults/pccard.conf)
12036a8d6623SGarrett Wollman
1204f71c01ccSPeter Wemmdevice		sio
1205f71c01ccSPeter Wemmhint.sio.0.at="isa"
1206f71c01ccSPeter Wemmhint.sio.0.port="0x3F8"
1207f71c01ccSPeter Wemmhint.sio.0.flags="0x10"
1208f71c01ccSPeter Wemmhint.sio.0.irq="4"
12099546766aSBruce Evans
12109546766aSBruce Evans#
12119546766aSBruce Evans# `flags' for serial drivers that support consoles (only for sio now):
12129546766aSBruce Evans#	0x10	enable console support for this unit.  The other console flags
12139546766aSBruce Evans#		are ignored unless this is set.  Enabling console support does
12149546766aSBruce Evans#		not make the unit the preferred console - boot with -h or set
12159546766aSBruce Evans#		the 0x20 flag for that.  Currently, at most one unit can have
12169546766aSBruce Evans#		console support; the first one (in config file order) with
12179546766aSBruce Evans#		this flag set is preferred.  Setting this flag for sio0 gives
12189546766aSBruce Evans#		the old behaviour.
12199546766aSBruce Evans#	0x20	force this unit to be the console (unless there is another
12209546766aSBruce Evans#		higher priority console).  This replaces the COMCONSOLE option.
12219546766aSBruce Evans#	0x40	reserve this unit for low level console operations.  Do not
122204fb8e53SAlexander Langer#		access the device in any normal way.
1223a7674320SMartin Cracauer#	0x80	use this port for serial line gdb support in ddb.
12249546766aSBruce Evans#
12256a796ce0SJohn-Mark Gurney# PnP `flags' (set via userconfig using pnp x flags y)
12266a796ce0SJohn-Mark Gurney#	0x1	disable probing of this device.  Used to prevent your modem
12276a796ce0SJohn-Mark Gurney#		from being attached as a PnP modem.
12286a796ce0SJohn-Mark Gurney#
12299546766aSBruce Evans
12309546766aSBruce Evans# Options for serial drivers that support consoles (only for sio now):
12319546766aSBruce Evansoptions 	BREAK_TO_DEBUGGER	#a BREAK on a comconsole goes to
12329546766aSBruce Evans					#DDB, if available.
1233ba23229eSDima Dorfmanoptions 	CONSPEED=115200		# speed for serial console
1234ba23229eSDima Dorfman					# (default 9600)
12356a8d6623SGarrett Wollman
123626b6ea69SPaul Saab# Solaris implements a new BREAK which is initiated by a character
123726b6ea69SPaul Saab# sequence CR ~ ^b which is similar to a familiar pattern used on
123826b6ea69SPaul Saab# Sun servers by the Remote Console.
123926b6ea69SPaul Saaboptions 	ALT_BREAK_TO_DEBUGGER
124026b6ea69SPaul Saab
12416a8d6623SGarrett Wollman# Options for sio:
1242768fd661SBruce Evansoptions 	COM_ESP			#code for Hayes ESP
12439ba0e7c3SBruce Evansoptions 	COM_MULTIPORT		#code for some cards with shared IRQs
12446a8d6623SGarrett Wollman
124596b89afcSBruce Evans# Other flags for sio that aren't documented in the man page.
124696b89afcSBruce Evans#	0x20000	enable hardware RTS/CTS and larger FIFOs.  Only works for
124796b89afcSBruce Evans#		ST16650A-compatible UARTs.
124896b89afcSBruce Evans
12499c564b6cSJohn Hay# PCI Universal Communications driver
12509c564b6cSJohn Hay# Supports various single and multi port PCI serial cards. Maybe later
12519c564b6cSJohn Hay# also the parallel ports on combination serial/parallel cards. New cards
1252093d7296SChris D. Faulhaber# can be added in src/sys/dev/puc/pucdata.c.
12539c564b6cSJohn Hay#
12549c564b6cSJohn Hay# If the PUC_FASTINTR option is used the driver will try to use fast
12559c564b6cSJohn Hay# interrupts. The card must then be the only user of that interrupt.
12569c564b6cSJohn Hay# Interrupts cannot be shared when using PUC_FASTINTR.
12579c564b6cSJohn Haydevice		puc
12589c564b6cSJohn Hayoptions 	PUC_FASTINTR
12599c564b6cSJohn Hay
12606a8d6623SGarrett Wollman#
1261d61e6649SAlexander Langer# Network interfaces:
12626a8d6623SGarrett Wollman#
1263d61e6649SAlexander Langer# MII bus support is required for some PCI 10/100 ethernet NICs,
1264d61e6649SAlexander Langer# namely those which use MII-compliant transceivers or implement
1265d61e6649SAlexander Langer# tranceiver control interfaces that operate like an MII. Adding
1266d61e6649SAlexander Langer# "device miibus0" to the kernel config pulls in support for
1267d61e6649SAlexander Langer# the generic miibus API and all of the PHY drivers, including a
1268d61e6649SAlexander Langer# generic one for PHYs that aren't specifically handled by an
1269d61e6649SAlexander Langer# individual driver.
1270d61e6649SAlexander Langerdevice		miibus
1271d61e6649SAlexander Langer
127295d67482SBill Paul# bge:	Support for gigabit ethernet adapters based on the Broadcom
1273586d7c2eSJohn Polstra#	BCM570x family of controllers, including the 3Com 3c996-T,
1274586d7c2eSJohn Polstra#	the Netgear GA302T, the SysKonnect SK-9D21 and SK-9D41, and
1275586d7c2eSJohn Polstra#	the embedded gigE NICs on Dell PowerEdge 2550 servers.
1276d61e6649SAlexander Langer# dc:   Support for PCI fast ethernet adapters based on the DEC/Intel 21143
1277d61e6649SAlexander Langer#       and various workalikes including:
1278d61e6649SAlexander Langer#       the ADMtek AL981 Comet and AN985 Centaur, the ASIX Electronics
1279d61e6649SAlexander Langer#       AX88140A and AX88141, the Davicom DM9100 and DM9102, the Lite-On
1280d61e6649SAlexander Langer#       82c168 and 82c169 PNIC, the Lite-On/Macronix LC82C115 PNIC II
1281d61e6649SAlexander Langer#       and the Macronix 98713/98713A/98715/98715A/98725 PMAC. This driver
1282d61e6649SAlexander Langer#       replaces the old al, ax, dm, pn and mx drivers.  List of brands:
1283d61e6649SAlexander Langer#       Digital DE500-BA, Kingston KNE100TX, D-Link DFE-570TX, SOHOware SFA110,
1284d61e6649SAlexander Langer#       SVEC PN102-TX, CNet Pro110B, 120A, and 120B, Compex RL100-TX,
1285d61e6649SAlexander Langer#       LinkSys LNE100TX, LNE100TX V2.0, Jaton XpressNet, Alfa Inc GFC2204,
1286d61e6649SAlexander Langer#       KNE110TX.
1287d61e6649SAlexander Langer# de:   Digital Equipment DC21040
1288a59716d2SPrafulla Deuskar# em:   Intel Pro/1000 Gigabit Ethernet 82542, 82543, 82544 based adapters.
1289d61e6649SAlexander Langer# fpa:  Support for the Digital DEFPA PCI FDDI. `device fddi' is also needed.
1290d61e6649SAlexander Langer# fxp:  Intel EtherExpress Pro/100B
1291cf87044eSMatt Jacob#	(hint of prefer_iomap can be done to prefer I/O instead of Mem mapping)
1292e903bd58SJonathan Lemon# gx:   Intel Pro/1000 Gigabit Ethernet (82542, 82543-F, 82543-T)
1293c678bc4fSBill Paul# lge:	Support for PCI gigabit ethernet adapters based on the Level 1
1294c678bc4fSBill Paul#	LXT1001 NetCellerator chipset. This includes the D-Link DGE-500SX,
1295c678bc4fSBill Paul#	SMC TigerCard 1000 (SMC9462SX), and some Addtron cards.
1296ce4946daSBill Paul# nge:	Support for PCI gigabit ethernet adapters based on the National
1297ce4946daSBill Paul#	Semiconductor DP83820 and DP83821 chipset. This includes the
1298ce4946daSBill Paul#	SMC EZ Card 1000 (SMC9462TX), D-Link DGE-500T, Asante FriendlyNet
129901019292SBill Paul#	GigaNIX 1000TA and 1000TPC, the Addtron AEG320T, the LinkSys
1300660e0297SBill Paul#	EG1032 and EG1064, the Surecom EP-320G-TX and the Netgear GA622T.
130141f7d2d5SBill Paul# pcn:	Support for PCI fast ethernet adapters based on the AMD Am79c97x
130241f7d2d5SBill Paul#	chipsets, including the PCnet/FAST, PCnet/FAST+, PCnet/PRO and
130341f7d2d5SBill Paul#	PCnet/Home. These were previously handled by the lnc driver (and
130441f7d2d5SBill Paul#	still will be if you leave this driver out of the kernel).
1305d61e6649SAlexander Langer# rl:   Support for PCI fast ethernet adapters based on the RealTek 8129/8139
1306d61e6649SAlexander Langer#       chipset.  Note that the RealTek driver defaults to using programmed
1307d61e6649SAlexander Langer#       I/O to do register accesses because memory mapped mode seems to cause
1308d61e6649SAlexander Langer#       severe lockups on SMP hardware.  This driver also supports the
1309d61e6649SAlexander Langer#       Accton EN1207D `Cheetah' adapter, which uses a chip called
1310d61e6649SAlexander Langer#       the MPX 5030/5038, which is either a RealTek in disguise or a
1311d61e6649SAlexander Langer#       RealTek workalike.  Note that the D-Link DFE-530TX+ uses the RealTek
1312d61e6649SAlexander Langer#       chipset and is supported by this driver, not the 'vr' driver.
1313d61e6649SAlexander Langer# sf:   Support for Adaptec Duralink PCI fast ethernet adapters based on the
1314d61e6649SAlexander Langer#       Adaptec AIC-6915 "starfire" controller.
1315d61e6649SAlexander Langer#       This includes dual and quad port cards, as well as one 100baseFX card.
1316d61e6649SAlexander Langer#       Most of these are 64-bit PCI devices, except for one single port
1317d61e6649SAlexander Langer#       card which is 32-bit.
1318b2ca5572SAlexander Langer# sis:  Support for NICs based on the Silicon Integrated Systems SiS 900,
1319b2ca5572SAlexander Langer#       SiS 7016 and NS DP83815 PCI fast ethernet controller chips.
1320d61e6649SAlexander Langer# sk:   Support for the SysKonnect SK-984x series PCI gigabit ethernet NICs.
1321d61e6649SAlexander Langer#       This includes the SK-9841 and SK-9842 single port cards (single mode
1322d61e6649SAlexander Langer#       and multimode fiber) and the SK-9843 and SK-9844 dual port cards
1323d61e6649SAlexander Langer#       (also single mode and multimode).
1324d61e6649SAlexander Langer#       The driver will autodetect the number of ports on the card and
1325d61e6649SAlexander Langer#       attach each one as a separate network interface.
1326d61e6649SAlexander Langer# ste:  Sundance Technologies ST201 PCI fast ethernet controller, includes
1327d61e6649SAlexander Langer#       the D-Link DFE-550TX.
1328d61e6649SAlexander Langer# ti:   Support for PCI gigabit ethernet NICs based on the Alteon Networks
1329d61e6649SAlexander Langer#       Tigon 1 and Tigon 2 chipsets.  This includes the Alteon AceNIC, the
1330d61e6649SAlexander Langer#       3Com 3c985, the Netgear GA620 and various others.  Note that you will
1331d61e6649SAlexander Langer#       probably want to bump up NMBCLUSTERS a lot to use this driver.
1332d61e6649SAlexander Langer# tl:   Support for the Texas Instruments TNETE100 series 'ThunderLAN'
1333d61e6649SAlexander Langer#       cards and integrated ethernet controllers.  This includes several
1334d61e6649SAlexander Langer#       Compaq Netelligent 10/100 cards and the built-in ethernet controllers
1335d61e6649SAlexander Langer#       in several Compaq Prosignia, Proliant and Deskpro systems.  It also
1336d61e6649SAlexander Langer#       supports several Olicom 10Mbps and 10/100 boards.
13370cc2be21SSemen Ustimenko# tx:   SMC 9432 TX, BTX and FTX cards. (SMC EtherPower II serie)
1338362c5c1eSBill Paul# txp:	Support for 3Com 3cR990 cards with the "Typhoon" chipset
1339d61e6649SAlexander Langer# vr:   Support for various fast ethernet adapters based on the VIA
1340d61e6649SAlexander Langer#       Technologies VT3043 `Rhine I' and VT86C100A `Rhine II' chips,
1341d61e6649SAlexander Langer#       including the D-Link DFE530TX (see 'rl' for DFE530TX+), the Hawking
1342d61e6649SAlexander Langer#       Technologies PN102TX, and the AOpen/Acer ALN-320.
1343d61e6649SAlexander Langer# vx:   3Com 3C590 and 3C595
1344d61e6649SAlexander Langer# wb:   Support for fast ethernet adapters based on the Winbond W89C840F chip.
1345d61e6649SAlexander Langer#       Note: this is not the same as the Winbond W89C940F, which is a
1346d61e6649SAlexander Langer#       NE2000 clone.
1347d61e6649SAlexander Langer# xl:   Support for the 3Com 3c900, 3c905, 3c905B and 3c905C (Fast)
1348d61e6649SAlexander Langer#       Etherlink XL cards and integrated controllers.  This includes the
1349d61e6649SAlexander Langer#       integrated 3c905B-TX chips in certain Dell Optiplex and Dell
1350d61e6649SAlexander Langer#       Precision desktop machines and the integrated 3c905-TX chips
1351d61e6649SAlexander Langer#       in Dell Latitude laptop docking stations.
1352d61e6649SAlexander Langer#       Also supported: 3Com 3c980(C)-TX, 3Com 3cSOHO100-TX, 3Com 3c450-TX
1353d61e6649SAlexander Langer
1354d61e6649SAlexander Langer# PCI Ethernet NICs that use the common MII bus controller code.
1355d61e6649SAlexander Langerdevice		dc		# DEC/Intel 21143 and various workalikes
13564664a8d5SJonathan Lemondevice		fxp		# Intel EtherExpress PRO/100B (82557, 82558)
13574664a8d5SJonathan Lemonhint.fxp.0.prefer_iomap="0"
1358d61e6649SAlexander Langerdevice		rl		# RealTek 8129/8139
13592e1b1231SDima Dorfmandevice		pcn		# AMD Am79C97x PCI 10/100 NICs
1360d61e6649SAlexander Langerdevice		sf		# Adaptec AIC-6915 (``Starfire'')
1361d61e6649SAlexander Langerdevice		sis		# Silicon Integrated Systems SiS 900/SiS 7016
1362d61e6649SAlexander Langerdevice		ste		# Sundance ST201 (D-Link DFE-550TX)
1363d61e6649SAlexander Langerdevice		tl		# Texas Instruments ThunderLAN
1364eed59f52SSemen Ustimenkodevice		tx		# SMC EtherPower II (83c170 ``EPIC'')
1365d61e6649SAlexander Langerdevice		vr		# VIA Rhine, Rhine II
1366d61e6649SAlexander Langerdevice		wb		# Winbond W89C840F
1367d61e6649SAlexander Langerdevice		xl		# 3Com 3c90x (``Boomerang'', ``Cyclone'')
1368d61e6649SAlexander Langer
1369d61e6649SAlexander Langer# PCI Ethernet NICs.
1370d61e6649SAlexander Langerdevice		de		# DEC/Intel DC21x4x (``Tulip'')
137195d67482SBill Pauldevice		txp		# 3Com 3cR990 (``Typhoon'')
1372c7ba4194SWarner Loshdevice		vx		# 3Com 3c590, 3c595 (``Vortex'')
1373d61e6649SAlexander Langer
1374d61e6649SAlexander Langer# PCI Gigabit & FDDI NICs.
137595d67482SBill Pauldevice		bge
1376e903bd58SJonathan Lemondevice		gx
1377c678bc4fSBill Pauldevice		lge
1378ce4946daSBill Pauldevice		nge
1379d61e6649SAlexander Langerdevice		sk
1380d61e6649SAlexander Langerdevice		ti
1381d61e6649SAlexander Langerdevice		fpa	1
1382d61e6649SAlexander Langer
138368713f97SKenjiro Cho#
138444b5247dSKenjiro Cho# ATM related options (Cranor version)
138544b5247dSKenjiro Cho# (note: this driver cannot be used with the HARP ATM stack)
138668713f97SKenjiro Cho#
138768713f97SKenjiro Cho# The `en' device provides support for Efficient Networks (ENI)
138868713f97SKenjiro Cho# ENI-155 PCI midway cards, and the Adaptec 155Mbps PCI ATM cards (ANA-59x0).
138968713f97SKenjiro Cho#
1390f71c01ccSPeter Wemm# atm device provides generic atm functions and is required for
139168713f97SKenjiro Cho# atm devices.
13923cbceb82SKenjiro Cho# NATM enables the netnatm protocol family that can be used to
139368713f97SKenjiro Cho# bypass TCP/IP.
139468713f97SKenjiro Cho#
139568713f97SKenjiro Cho# the current driver supports only PVC operations (no atm-arp, no multicast).
139668713f97SKenjiro Cho# for more details, please read the original documents at
139798a44096SSheldon Hearn# http://www.ccrc.wustl.edu/pub/chuck/tech/bsdatm/bsdatm.html
139868713f97SKenjiro Cho#
1399f71c01ccSPeter Wemmdevice		atm
140044b5247dSKenjiro Chodevice		en
14013cbceb82SKenjiro Chooptions 	NATM			#native ATM
1402f4567b9cSJulian Elischer
1403c19da41eSPeter Wemm#
1404dd267672SJohn Baldwin# Audio drivers: `pcm'
1405c19da41eSPeter Wemm#
1406c7406082SJohn-Mark Gurney# pcm: PCM audio through various sound cards.
1407c7406082SJohn-Mark Gurney#
140868ec4eb6SLuigi Rizzo# This has support for a large number of new audio cards, based on
140968ec4eb6SLuigi Rizzo# CS423x, OPTi931, Yamaha OPL-SAx, and also for SB16, GusPnP.
141068ec4eb6SLuigi Rizzo# For more information about this driver and supported cards,
141198a44096SSheldon Hearn# see the pcm.4 man page.
1412c7406082SJohn-Mark Gurney#
141381bb901eSPeter Wemm# Supported cards include:
141481bb901eSPeter Wemm# Crystal Semiconductor CS461x/428x PCI
141581bb901eSPeter Wemm# Neomagic 256AV (ac97)
141681bb901eSPeter Wemm
141767245194SPeter Wemmdevice		pcm
1418c19da41eSPeter Wemm
1419fb0ef528SSeigo Tanimura#
1420fb0ef528SSeigo Tanimura# midi: MIDI interfaces and synthesizers
1421fb0ef528SSeigo Tanimura#
1422fb0ef528SSeigo Tanimura
1423fb0ef528SSeigo Tanimuradevice		midi
1424fb0ef528SSeigo Tanimura
1425fb0ef528SSeigo Tanimura#
1426fb0ef528SSeigo Tanimura# seq: MIDI sequencer
1427fb0ef528SSeigo Tanimura#
1428fb0ef528SSeigo Tanimura
1429fb0ef528SSeigo Tanimuradevice		seq
1430fb0ef528SSeigo Tanimura
14316a8d6623SGarrett Wollman#
1432567e21c2SBruce Evans# Miscellaneous hardware:
14336a8d6623SGarrett Wollman#
14341d86961eSJordan K. Hubbard# meteor: Matrox Meteor video capture board
14351c2b5939SRoger Hardiman# bktr: Brooktree bt848/848a/849a/878/879 video capture and TV Tuner board
14362849b131SBruce Evans# cy: Cyclades serial driver
1437dd267672SJohn Baldwin# rp: Comtrol Rocketport(ISA/PCI) - single card
1438ec84f103SMark Peek# nmdm: nullmodem terminal driver (see nmdm(4))
1439657e73c4SPeter Dufault
14403b577e1fSJordan K. Hubbard# Notes on the Comtrol Rocketport driver:
14413b577e1fSJordan K. Hubbard#
14423b577e1fSJordan K. Hubbard# The exact values used for rp0 depend on how many boards you have
14433b577e1fSJordan K. Hubbard# in the system.  The manufacturer's sample configs are listed as:
14443b577e1fSJordan K. Hubbard#
1445f71c01ccSPeter Wemm#               device  rp	# core driver support
1446f71c01ccSPeter Wemm#
14473b577e1fSJordan K. Hubbard#   Comtrol Rocketport ISA single card
1448f71c01ccSPeter Wemm#		hints.rp.0.at="isa"
1449f71c01ccSPeter Wemm#		hints.rp.0.port="0x280"
14503b577e1fSJordan K. Hubbard#
14513b577e1fSJordan K. Hubbard#   If instead you have two ISA cards, one installed at 0x100 and the
14523b577e1fSJordan K. Hubbard#   second installed at 0x180, then you should add the following to
1453f71c01ccSPeter Wemm#   your kernel probe hints:
1454f71c01ccSPeter Wemm#		hints.rp.0.at="isa"
1455f71c01ccSPeter Wemm#		hints.rp.0.port="0x100"
1456f71c01ccSPeter Wemm#		hints.rp.1.at="isa"
1457f71c01ccSPeter Wemm#		hints.rp.1.port="0x180"
14583b577e1fSJordan K. Hubbard#
14593b577e1fSJordan K. Hubbard#   For 4 ISA cards, it might be something like this:
1460f71c01ccSPeter Wemm#		hints.rp.0.at="isa"
1461f71c01ccSPeter Wemm#		hints.rp.0.port="0x180"
1462f71c01ccSPeter Wemm#		hints.rp.1.at="isa"
1463f71c01ccSPeter Wemm#		hints.rp.1.port="0x100"
1464f71c01ccSPeter Wemm#		hints.rp.2.at="isa"
1465f71c01ccSPeter Wemm#		hints.rp.2.port="0x340"
1466f71c01ccSPeter Wemm#		hints.rp.3.at="isa"
1467f71c01ccSPeter Wemm#		hints.rp.3.port="0x240"
14683b577e1fSJordan K. Hubbard#
1469dd267672SJohn Baldwin#   For PCI cards, you need no hints.
14703b577e1fSJordan K. Hubbard
14712849b131SBruce Evansdevice		cy	1
14722849b131SBruce Evansoptions 	CY_PCI_FASTINTR		# Use with cy_pci unless irq is shared
14732849b131SBruce Evanshint.cy.0.at="isa"
14742849b131SBruce Evanshint.cy.0.irq="10"
14752849b131SBruce Evanshint.cy.0.maddr="0xd4000"
14762849b131SBruce Evanshint.cy.0.msize="0x2000"
1477f71c01ccSPeter Wemmdevice		rp
1478ec84f103SMark Peek# nullmodem terminal driver
1479ec84f103SMark Peekdevice		nmdm
1480a800f455SJulian Elischer
1481eeb706c0SJustin T. Gibbs#
1482bba9a7a0SGarrett Wollman# The `meteor' device is a PCI video capture board. It can also have the
14831d86961eSJordan K. Hubbard# following options:
1484b1529bdaSPeter Wemm#   options METEOR_ALLOC_PAGES=xxx	preallocate kernel pages for data entry
14851d86961eSJordan K. Hubbard#	figure (ROWS*COLUMN*BYTES_PER_PIXEL*FRAME+PAGE_SIZE-1)/PAGE_SIZE
14861d86961eSJordan K. Hubbard#   options METEOR_DEALLOC_PAGES	remove all allocated pages on close(2)
1487b1529bdaSPeter Wemm#   options METEOR_DEALLOC_ABOVE=xxx	remove all allocated pages above the
14881d86961eSJordan K. Hubbard#	specified amount. If this value is below the allocated amount no action
14891d86961eSJordan K. Hubbard#	taken
14904f5f3f07SBrian Somers#   options METEOR_SYSTEM_DEFAULT={METEOR_PAL|METEOR_NTSC|METEOR_SECAM}, used
1491734d08a2SJordan K. Hubbard#	for initialization of fps routine when a signal is not present.
14921d86961eSJordan K. Hubbard#
1493a9c5b8d0SSøren Schmidt# The 'bktr' device is a PCI video capture device using the Brooktree
14941c2b5939SRoger Hardiman# bt848/bt848a/bt849a/bt878/bt879 chipset. When used with a TV Tuner it forms a
1495a9c5b8d0SSøren Schmidt# TV card, eg Miro PC/TV, Hauppauge WinCast/TV WinTV, VideoLogic Captivator,
14961c2b5939SRoger Hardiman# Intel Smart Video III, AverMedia, IMS Turbo, FlyVideo.
14971c2b5939SRoger Hardiman#
1498a9c5b8d0SSøren Schmidt# options 	OVERRIDE_CARD=xxx
1499a9c5b8d0SSøren Schmidt# options 	OVERRIDE_TUNER=xxx
1500a9c5b8d0SSøren Schmidt# options 	OVERRIDE_MSP=1
1501a9c5b8d0SSøren Schmidt# options 	OVERRIDE_DBX=1
15021c2b5939SRoger Hardiman# These options can be used to override the auto detection
150398a44096SSheldon Hearn# The current values for xxx are found in src/sys/dev/bktr/bktr_card.h
15041c2b5939SRoger Hardiman# Using sysctl(8) run-time overrides on a per-card basis can be made
15059ff07e32SAmancio Hasty#
15064f5f3f07SBrian Somers# options 	BROOKTREE_SYSTEM_DEFAULT=BROOKTREE_PAL
15071c2b5939SRoger Hardiman# or
15081c2b5939SRoger Hardiman# options 	BROOKTREE_SYSTEM_DEFAULT=BROOKTREE_NTSC
15091c2b5939SRoger Hardiman# Specifes the default video capture mode.
1510a9c5b8d0SSøren Schmidt# This is required for Dual Crystal (28&35Mhz) boards where PAL is used
1511a9c5b8d0SSøren Schmidt# to prevent hangs during initialisation.  eg VideoLogic Captivator PCI.
1512a9c5b8d0SSøren Schmidt#
15134f5f3f07SBrian Somers# options 	BKTR_USE_PLL
15141c2b5939SRoger Hardiman# PAL or SECAM users who have a 28Mhz crystal (and no 35Mhz crystal)
15151c2b5939SRoger Hardiman# must enable PLL mode with this option. eg some new Bt878 cards.
1516a9c5b8d0SSøren Schmidt#
15171c2b5939SRoger Hardiman# options 	BKTR_GPIO_ACCESS
15181c2b5939SRoger Hardiman# This enable IOCTLs which give user level access to the GPIO port.
15191c2b5939SRoger Hardiman#
15201c2b5939SRoger Hardiman# options 	BKTR_NO_MSP_RESET
15211c2b5939SRoger Hardiman# Prevents the MSP34xx reset. Good if you initialise the MSP in another OS first
15221c2b5939SRoger Hardiman#
15231c2b5939SRoger Hardiman# options 	BKTR_430_FX_MODE
15241c2b5939SRoger Hardiman# Switch Bt878/879 cards into Intel 430FX chipset compatibility mode.
15251c2b5939SRoger Hardiman#
15261c2b5939SRoger Hardiman# options 	BKTR_SIS_VIA_MODE
15271c2b5939SRoger Hardiman# Switch Bt878/879 cards into SIS/VIA chipset compatibility mode which is
15281c2b5939SRoger Hardiman# needed for some old SiS and VIA chipset motherboards.
15291c2b5939SRoger Hardiman# This also allows Bt878/879 chips to work on old OPTi (<1997) chipset
15301c2b5939SRoger Hardiman# motherboards and motherboards with bad or incomplete PCI 2.1 support.
15311c2b5939SRoger Hardiman# As a rough guess, old = before 1998
15321c2b5939SRoger Hardiman#
1533017b0edcSMatt Jacob
1534f71c01ccSPeter Wemmdevice		meteor	1
15350f3563b6SRoger Hardiman
1536c17d4340SNicolas Souchu#
1537c17d4340SNicolas Souchu# options	BKTR_USE_FREEBSD_SMBUS
1538c17d4340SNicolas Souchu# Compile with FreeBSD SMBus implementation
1539c17d4340SNicolas Souchu#
154028ebb692SNicolas Souchu# Brooktree driver has been ported to the new I2C framework. Thus,
15410f3563b6SRoger Hardiman# you'll need to have the following 3 lines in the kernel config.
154237973e86SPeter Wemm#     device smbus
154337973e86SPeter Wemm#     device iicbus
154437973e86SPeter Wemm#     device iicbb
1545c17d4340SNicolas Souchu#     device iicsmb
15460f3563b6SRoger Hardiman# The iic and smb devices are only needed if you want to control other
15470f3563b6SRoger Hardiman# I2C slaves connected to the external connector of some cards.
154828ebb692SNicolas Souchu#
1549f71c01ccSPeter Wemmdevice		bktr	1
1550446cee6eSJoerg Wunsch
1551dc9deb29SPoul-Henning Kamp#
15528afa373cSNicolas Souchu# SMB bus
15538afa373cSNicolas Souchu#
15543c5656bfSArchie Cobbs# System Management Bus support is provided by the 'smbus' device.
15553c5656bfSArchie Cobbs# Access to the SMBus device is via the 'smb' device (/dev/smb*),
15563c5656bfSArchie Cobbs# which is a child of the 'smbus' device.
15578afa373cSNicolas Souchu#
15588afa373cSNicolas Souchu# Supported devices:
15593c5656bfSArchie Cobbs# smb		standard io through /dev/smb*
15608afa373cSNicolas Souchu#
15613c5656bfSArchie Cobbs# Supported SMB interfaces:
156228ebb692SNicolas Souchu# iicsmb	I2C to SMB bridge with any iicbus interface
156328ebb692SNicolas Souchu# bktr		brooktree848 I2C hardware interface
15648afa373cSNicolas Souchu#
1565c9953c3bSPeter Wemmdevice		smbus		# Bus support, required for smb below.
15663c5656bfSArchie Cobbs
1567c9953c3bSPeter Wemmdevice		smb
15688afa373cSNicolas Souchu
15698afa373cSNicolas Souchu#
15708afa373cSNicolas Souchu# I2C Bus
15718afa373cSNicolas Souchu#
15728afa373cSNicolas Souchu# Philips i2c bus support is provided by the `iicbus' device.
15738afa373cSNicolas Souchu#
15748afa373cSNicolas Souchu# Supported devices:
15758afa373cSNicolas Souchu# ic	i2c network interface
15768afa373cSNicolas Souchu# iic	i2c standard io
1577f7d09fbaSNicolas Souchu# iicsmb i2c to smb bridge. Allow i2c i/o with smb commands.
15788afa373cSNicolas Souchu#
15798afa373cSNicolas Souchu# Supported interfaces:
158028ebb692SNicolas Souchu# bktr	brooktree848 I2C software interface
158128ebb692SNicolas Souchu#
158228ebb692SNicolas Souchu# Other:
158328ebb692SNicolas Souchu# iicbb	generic I2C bit-banging code (needed by lpbb, bktr)
15848afa373cSNicolas Souchu#
1585c9953c3bSPeter Wemmdevice		iicbus		# Bus support, required for ic/iic/iicsmb below.
1586c9953c3bSPeter Wemmdevice		iicbb
15878afa373cSNicolas Souchu
1588c9953c3bSPeter Wemmdevice		ic
1589c9953c3bSPeter Wemmdevice		iic
1590c9953c3bSPeter Wemmdevice		iicsmb		# smb over i2c bridge
15918afa373cSNicolas Souchu
1592ab4c624bSMike Smith# Parallel-Port Bus
1593ab4c624bSMike Smith#
1594ab4c624bSMike Smith# Parallel port bus support is provided by the `ppbus' device.
1595ab4c624bSMike Smith# Multiple devices may be attached to the parallel port, devices
1596ab4c624bSMike Smith# are automatically probed and attached when found.
1597ab4c624bSMike Smith#
1598ab4c624bSMike Smith# Supported devices:
1599ab4c624bSMike Smith# vpo	Iomega Zip Drive
1600f7d09fbaSNicolas Souchu#	Requires SCSI disk support ('scbus' and 'da'), best
1601f88c1346SMike Smith#	performance is achieved with ports in EPP 1.9 mode.
1602fdf94d1aSNicolas Souchu# lpt	Parallel Printer
160346f3ff79SMike Smith# plip	Parallel network interface
1604fdf94d1aSNicolas Souchu# ppi	General-purpose I/O ("Geek Port") + IEEE1284 I/O
1605f7d09fbaSNicolas Souchu# pps	Pulse per second Timing Interface
160628ebb692SNicolas Souchu# lpbb	Philips official parallel port I2C bit-banging interface
1607ab4c624bSMike Smith#
1608ab4c624bSMike Smith# Supported interfaces:
1609ab4c624bSMike Smith# ppc	ISA-bus parallel port interfaces.
1610ab4c624bSMike Smith#
1611ef8f7626SNicolas Souchu
16120f210c92SNicolas Souchuoptions 	PPC_PROBE_CHIPSET # Enable chipset specific detection
16130f210c92SNicolas Souchu				  # (see flags in ppc(4))
16145895e3c8SPeter Wemmoptions 	DEBUG_1284	# IEEE1284 signaling protocol debug
16155895e3c8SPeter Wemmoptions 	PERIPH_1284	# Makes your computer act as a IEEE1284
1616ef8f7626SNicolas Souchu				# compliant peripheral
16175895e3c8SPeter Wemmoptions 	DONTPROBE_1284	# Avoid boot detection of PnP parallel devices
16185895e3c8SPeter Wemmoptions 	VP0_DEBUG	# ZIP/ZIP+ debug
16195895e3c8SPeter Wemmoptions 	LPT_DEBUG	# Printer driver debug
16205895e3c8SPeter Wemmoptions 	PPC_DEBUG	# Parallel chipset level debug
16215895e3c8SPeter Wemmoptions 	PLIP_DEBUG	# Parallel network IP interface debug
16223b2d592cSJordan K. Hubbardoptions 	PCFCLOCK_VERBOSE         # Verbose pcfclock driver
16233b2d592cSJordan K. Hubbardoptions 	PCFCLOCK_MAX_RETRIES=5   # Maximum read tries (default 10)
1624ef8f7626SNicolas Souchu
1625f71c01ccSPeter Wemmdevice		ppc
1626f71c01ccSPeter Wemmhint.ppc.0.at="isa"
1627f71c01ccSPeter Wemmhint.ppc.0.irq="7"
16280d31b179SPeter Wemmdevice		ppbus
16290d31b179SPeter Wemmdevice		vpo
16300d31b179SPeter Wemmdevice		lpt
16310d31b179SPeter Wemmdevice		plip
16320d31b179SPeter Wemmdevice		ppi
16330d31b179SPeter Wemmdevice		pps
16340d31b179SPeter Wemmdevice		lpbb
16350d31b179SPeter Wemmdevice		pcfclock
1636ab4c624bSMike Smith
1637432aad0eSTor Egge# Kernel BOOTP support
1638432aad0eSTor Egge
1639432aad0eSTor Eggeoptions 	BOOTP		# Use BOOTP to obtain IP address/hostname
1640432aad0eSTor Eggeoptions 	BOOTP_NFSROOT	# NFS mount root filesystem using BOOTP info
16415895e3c8SPeter Wemmoptions 	BOOTP_NFSV3	# Use NFS v3 to NFS mount root
1642432aad0eSTor Eggeoptions 	BOOTP_COMPAT	# Workaround for broken bootp daemons.
16435895e3c8SPeter Wemmoptions 	BOOTP_WIRED_TO=fxp0 # Use interface fxp0 for BOOTP
1644432aad0eSTor Egge
1645d94f38acSEivind Eklund#
1646d94f38acSEivind Eklund# Add tie-ins for a hardware watchdog.  This only enable the hooks;
1647d94f38acSEivind Eklund# the user must still supply the actual driver.
1648d94f38acSEivind Eklund#
1649d94f38acSEivind Eklundoptions 	HW_WDOG
1650d94f38acSEivind Eklund
1651005092bbSEivind Eklund#
1652c796cfa1SAndrzej Bialecki# Disable swapping. This option removes all code which actually performs
1653c796cfa1SAndrzej Bialecki# swapping, so it's not possible to turn it back on at run-time.
1654c796cfa1SAndrzej Bialecki#
1655c796cfa1SAndrzej Bialecki# This is sometimes usable for systems which don't have any swap space
1656c796cfa1SAndrzej Bialecki# (see also sysctls "vm.defer_swapspace_pageouts" and
1657c796cfa1SAndrzej Bialecki# "vm.disable_swapspace_pageouts")
1658c796cfa1SAndrzej Bialecki#
165919dde963SPeter Wemm#options 	NO_SWAPPING
1660c796cfa1SAndrzej Bialecki
16619dab0776SDavid Greenman# Set the number of sf_bufs to allocate. sf_bufs are virtual buffers
16629dab0776SDavid Greenman# for sendfile(2) that are used to map file VM pages, and normally
16639dab0776SDavid Greenman# default to a quantity that is roughly 16*MAXUSERS+512. You would
16649dab0776SDavid Greenman# typically want about 4 of these for each simultaneous file send.
16659dab0776SDavid Greenman#
16665895e3c8SPeter Wemmoptions 	NSFBUFS=1024
16679dab0776SDavid Greenman
166815a1057cSEivind Eklund#
1669053a2b61SEivind Eklund# Enable extra debugging code for locks.  This stores the filename and
1670ec4e5afbSRobert Nordier# line of whatever acquired the lock in the lock itself, and change a
1671053a2b61SEivind Eklund# number of function calls to pass around the relevant data.  This is
1672053a2b61SEivind Eklund# not at all useful unless you are debugging lock code.  Also note
1673053a2b61SEivind Eklund# that it is likely to break e.g. fstat(1) unless you recompile your
1674053a2b61SEivind Eklund# userland with -DDEBUG_LOCKS as well.
167515a1057cSEivind Eklund#
167615a1057cSEivind Eklundoptions 	DEBUG_LOCKS
167715a1057cSEivind Eklund
167826086a03SPeter Wemm
167926086a03SPeter Wemm#####################################################################
16801d33cf3dSNick Hibma# USB support
16811d33cf3dSNick Hibma# UHCI controller
1682c9953c3bSPeter Wemmdevice		uhci
16831d33cf3dSNick Hibma# OHCI controller
1684c9953c3bSPeter Wemmdevice		ohci
16851d33cf3dSNick Hibma# General USB code (mandatory for USB)
1686c9953c3bSPeter Wemmdevice		usb
16871d33cf3dSNick Hibma#
1688b5ea1f0cSNick Hibma# USB Double Bulk Pipe devices
1689b5ea1f0cSNick Hibmadevice		udbp
1690f26c33d2SNick Hibma# Generic USB device driver
1691c9953c3bSPeter Wemmdevice		ugen
1692f26c33d2SNick Hibma# Human Interface Device (anything with buttons and dials)
1693c9953c3bSPeter Wemmdevice		uhid
16941d33cf3dSNick Hibma# USB keyboard
1695c9953c3bSPeter Wemmdevice		ukbd
16961d33cf3dSNick Hibma# USB printer
1697c9953c3bSPeter Wemmdevice		ulpt
16986521db35SKris Kennaway# USB Iomega Zip 100 Drive (Requires scbus and da)
1699c9953c3bSPeter Wemmdevice		umass
1700e9fb12d3SNick Hibma# USB modem support
1701e9fb12d3SNick Hibmadevice		umodem
1702f26c33d2SNick Hibma# USB mouse
1703c9953c3bSPeter Wemmdevice		ums
1704e2dbd15fSNick Hibma# Diamond Rio 500 Mp3 player
1705e2dbd15fSNick Hibmadevice		urio
17062fd84f56SNick Hibma# USB scanners
17072fd84f56SNick Hibmadevice		uscanner
1708916e6e02SJosef Karthauser# USB serial support
1709916e6e02SJosef Karthauserdevice		ucom
1710916e6e02SJosef Karthauserdevice		uplcom
1711916e6e02SJosef Karthauser# USB serial support for DDI pocket's PHS
1712916e6e02SJosef Karthauserdevice		uvscom
171363c6b757SAlfred Perlstein# USB Fm Radio
171463c6b757SAlfred Perlsteindevice		ufm
1715f26c33d2SNick Hibma#
1716ed63a7aaSBill Paul# ADMtek USB ethernet. Supports the LinkSys USB100TX,
1717d04bb221SBill Paul# the Billionton USB100, the Melco LU-ATX, the D-Link DSB-650TX
1718d04bb221SBill Paul# and the SMC 2202USB. Also works with the ADMtek AN986 Pegasus
1719d04bb221SBill Paul# eval board.
1720c9953c3bSPeter Wemmdevice		aue
1721dfd1e98eSBill Paul#
172201779872SBill Paul# CATC USB-EL1201A USB ethernet. Supports the CATC Netmate
172301779872SBill Paul# and Netmate II, and the Belkin F5U111.
1724c9953c3bSPeter Wemmdevice		cue
172501779872SBill Paul#
1726dfd1e98eSBill Paul# Kawasaki LSI ethernet. Supports the LinkSys USB10T,
1727d04bb221SBill Paul# Entrega USB-NET-E45, Peracom Ethernet Adapter, the
1728d04bb221SBill Paul# 3Com 3c19250, the ADS Technologies USB-10BT, the ATen UC10T,
172901779872SBill Paul# the Netgear EA101, the D-Link DSB-650, the SMC 2102USB
173001779872SBill Paul# and 2104USB, and the Corega USB-T.
1731c9953c3bSPeter Wemmdevice		kue
1732f26c33d2SNick Hibma
1733f26c33d2SNick Hibma# debugging options for the USB subsystem
17341d33cf3dSNick Hibma#
17357dc1a5bdSNick Hibmaoptions 	UHCI_DEBUG
17367dc1a5bdSNick Hibmaoptions 	OHCI_DEBUG
17371d33cf3dSNick Hibmaoptions 	USB_DEBUG
1738f26c33d2SNick Hibma
17397dc1a5bdSNick Hibmaoptions 	UGEN_DEBUG
1740f26c33d2SNick Hibmaoptions 	UHID_DEBUG
1741f26c33d2SNick Hibmaoptions 	UHUB_DEBUG
1742f26c33d2SNick Hibmaoptions 	UKBD_DEBUG
17437dc1a5bdSNick Hibmaoptions 	ULPT_DEBUG
1744f26c33d2SNick Hibmaoptions 	UMASS_DEBUG
1745f26c33d2SNick Hibmaoptions 	UMS_DEBUG
1746e2dbd15fSNick Hibmaoptions 	URIO_DEBUG
1747f26c33d2SNick Hibma
17486e8394b8SKazutaka YOKOTA# options for ukbd:
17496e8394b8SKazutaka YOKOTAoptions 	UKBD_DFLT_KEYMAP	# specify the built-in keymap
1750cc6c2ad0SPeter Wemmmakeoptions	UKBD_DFLT_KEYMAP=it.iso
17516e8394b8SKazutaka YOKOTA
1752785d2100SJohn Birrell#
1753785d2100SJohn Birrell# Embedded system options:
1754785d2100SJohn Birrell#
1755785d2100SJohn Birrell# An embedded system might want to run something other than init.
17568a13a924SJohn Birrelloptions 	INIT_PATH="/sbin/init:/stand/sysinstall"
1757bc0e3a03SJeroen Ruigrok van der Werven
1758bc0e3a03SJeroen Ruigrok van der Werven# Debug options
1759bc0e3a03SJeroen Ruigrok van der Wervenoptions 	BUS_DEBUG	# enable newbus debugging
1760bc0e3a03SJeroen Ruigrok van der Wervenoptions 	DEBUG_VFS_LOCKS	# enable vfs lock debugging
1761bc0e3a03SJeroen Ruigrok van der Wervenoptions 	NPX_DEBUG	# enable npx debugging (FPU/math emu)
1762bc0e3a03SJeroen Ruigrok van der Werven
1763446af86dSJohn Baldwin#####################################################################
1764446af86dSJohn Baldwin# SYSV IPC KERNEL PARAMETERS
1765446af86dSJohn Baldwin#
1766446af86dSJohn Baldwin# Maximum number of entries in a semaphore map.
1767446af86dSJohn Baldwinoptions 	SEMMAP=31
1768446af86dSJohn Baldwin
1769446af86dSJohn Baldwin# Maximum number of System V semaphores that can be used on the system at
1770446af86dSJohn Baldwin# one time.
1771446af86dSJohn Baldwinoptions 	SEMMNI=11
1772446af86dSJohn Baldwin
1773446af86dSJohn Baldwin# Total number of semaphores system wide
1774446af86dSJohn Baldwinoptions 	SEMMNS=61
1775446af86dSJohn Baldwin
1776446af86dSJohn Baldwin# Total number of undo structures in system
1777446af86dSJohn Baldwinoptions 	SEMMNU=31
1778446af86dSJohn Baldwin
1779446af86dSJohn Baldwin# Maximum number of System V semaphores that can be used by a single process
1780446af86dSJohn Baldwin# at one time.
1781446af86dSJohn Baldwinoptions 	SEMMSL=61
1782446af86dSJohn Baldwin
1783446af86dSJohn Baldwin# Maximum number of operations that can be outstanding on a single System V
1784446af86dSJohn Baldwin# semaphore at one time.
1785446af86dSJohn Baldwinoptions 	SEMOPM=101
1786446af86dSJohn Baldwin
1787446af86dSJohn Baldwin# Maximum number of undo operations that can be outstanding on a single
1788446af86dSJohn Baldwin# System V semaphore at one time.
1789446af86dSJohn Baldwinoptions 	SEMUME=11
1790446af86dSJohn Baldwin
1791446af86dSJohn Baldwin# Maximum number of shared memory pages system wide.
1792446af86dSJohn Baldwinoptions 	SHMALL=1025
1793446af86dSJohn Baldwin
1794446af86dSJohn Baldwin# Maximum size, in bytes, of a single System V shared memory region.
1795446af86dSJohn Baldwinoptions 	SHMMAX="(SHMMAXPGS*PAGE_SIZE+1)"
1796446af86dSJohn Baldwinoptions 	SHMMAXPGS=1025
1797446af86dSJohn Baldwin
1798446af86dSJohn Baldwin# Minimum size, in bytes, of a single System V shared memory region.
1799446af86dSJohn Baldwinoptions 	SHMMIN=2
1800446af86dSJohn Baldwin
1801446af86dSJohn Baldwin# Maximum number of shared memory regions that can be used on the system
1802446af86dSJohn Baldwin# at one time.
1803446af86dSJohn Baldwinoptions 	SHMMNI=33
1804446af86dSJohn Baldwin
1805446af86dSJohn Baldwin# Maximum number of System V shared memory regions that can be attached to
1806446af86dSJohn Baldwin# a single process at one time.
1807446af86dSJohn Baldwinoptions 	SHMSEG=9
1808446af86dSJohn Baldwin
1809d9282887SDima Dorfman# Set the amount of time (in seconds) the system will wait before
1810d9282887SDima Dorfman# rebooting automatically when a kernel panic occurs.  If set to (-1),
1811d9282887SDima Dorfman# the system will wait indefinitely until a key is pressed on the
1812d9282887SDima Dorfman# console.
1813d9282887SDima Dorfmanoptions 	PANIC_REBOOT_WAIT_TIME=16
1814d9282887SDima Dorfman
1815446af86dSJohn Baldwin#####################################################################
1816446af86dSJohn Baldwin
1817bc0e3a03SJeroen Ruigrok van der Werven# More undocumented options for linting.
1818bc0e3a03SJeroen Ruigrok van der Werven# Note that documenting these are not considered an affront.
1819bc0e3a03SJeroen Ruigrok van der Werven
1820bc0e3a03SJeroen Ruigrok van der Wervenoptions 	CAM_DEBUG_DELAY
182128d7984fSJeroen Ruigrok van der Werven
182228d7984fSJeroen Ruigrok van der Werven# VFS cluster debugging.
1823bc0e3a03SJeroen Ruigrok van der Wervenoptions 	CLUSTERDEBUG
182428d7984fSJeroen Ruigrok van der Werven
1825bc0e3a03SJeroen Ruigrok van der Wervenoptions 	DEBUG
18268b6f5e65SJeroen Ruigrok van der Werven
182728d7984fSJeroen Ruigrok van der Werven# Kernel filelock debugging.
1828bc0e3a03SJeroen Ruigrok van der Wervenoptions 	LOCKF_DEBUG
182928d7984fSJeroen Ruigrok van der Werven
18308b6f5e65SJeroen Ruigrok van der Werven# System V compatible message queues
18318b6f5e65SJeroen Ruigrok van der Werven# Please note that the values provided here are used to test kernel
18328b6f5e65SJeroen Ruigrok van der Werven# building.  The defaults in the sources provide almost the same numbers.
18338b6f5e65SJeroen Ruigrok van der Werven# MSGSSZ must be a power of 2 between 8 and 1024.
18348b6f5e65SJeroen Ruigrok van der Wervenoptions 	MSGMNB=2049	# Max number of chars in queue
18358b6f5e65SJeroen Ruigrok van der Wervenoptions 	MSGMNI=41	# Max number of message queue identifiers
18368b6f5e65SJeroen Ruigrok van der Wervenoptions 	MSGSEG=2049	# Max number of message segments
18378b6f5e65SJeroen Ruigrok van der Wervenoptions 	MSGSSZ=16	# Size of a message segment
18388b6f5e65SJeroen Ruigrok van der Wervenoptions 	MSGTQL=41	# Max number of messages in system
18398b6f5e65SJeroen Ruigrok van der Werven
18408b6f5e65SJeroen Ruigrok van der Wervenoptions 	NBUF=512	# Number of buffer headers
18418b6f5e65SJeroen Ruigrok van der Werven
18428b6f5e65SJeroen Ruigrok van der Wervenoptions 	NMBCLUSTERS=1024	# Number of mbuf clusters
18438b6f5e65SJeroen Ruigrok van der Werven
1844bc0e3a03SJeroen Ruigrok van der Wervenoptions 	SCSI_NCR_DEBUG
1845bc0e3a03SJeroen Ruigrok van der Wervenoptions 	SCSI_NCR_MAX_SYNC=10000
1846bc0e3a03SJeroen Ruigrok van der Wervenoptions 	SCSI_NCR_MAX_WIDE=1
1847bc0e3a03SJeroen Ruigrok van der Wervenoptions 	SCSI_NCR_MYADDR=7
18488b6f5e65SJeroen Ruigrok van der Werven
18498b6f5e65SJeroen Ruigrok van der Wervenoptions 	SC_DEBUG_LEVEL=5	# Syscons debug level
18508b6f5e65SJeroen Ruigrok van der Wervenoptions 	SC_RENDER_DEBUG	# syscons rendering debugging
18518b6f5e65SJeroen Ruigrok van der Werven
1852bc0e3a03SJeroen Ruigrok van der Wervenoptions 	SHOW_BUSYBUFS	# List buffers that prevent root unmount
1853bc0e3a03SJeroen Ruigrok van der Wervenoptions 	SLIP_IFF_OPTS
18548b6f5e65SJeroen Ruigrok van der Wervenoptions 	VFS_BIO_DEBUG	# VFS buffer I/O debugging
18558b6f5e65SJeroen Ruigrok van der Werven
18561e9ea774SBruce Evans# Yet more undocumented options for linting.
18571e9ea774SBruce Evansoptions 	AAC_DEBUG
18581e9ea774SBruce Evansoptions 	ACD_DEBUG
18591e9ea774SBruce Evansoptions 	ACPI_MAX_THREADS=1
18601e9ea774SBruce Evans#!options 	ACPI_NO_SEMAPHORES
18611e9ea774SBruce Evans# Broken:
18621e9ea774SBruce Evans##options 	ASR_MEASURE_PERFORMANCE
18631e9ea774SBruce Evansoptions 	AST_DEBUG
18641e9ea774SBruce Evansoptions 	ATAPI_DEBUG
18651e9ea774SBruce Evansoptions 	ATA_DEBUG
18661e9ea774SBruce Evans# BKTR_ALLOC_PAGES has no effect except to cause warnings, and
18671e9ea774SBruce Evans# BROOKTREE_ALLOC_PAGES hasn't actually been superseded by it, since the
18681e9ea774SBruce Evans# driver still mostly spells this option BROOKTREE_ALLOC_PAGES.
18691e9ea774SBruce Evans##options 	BKTR_ALLOC_PAGES="(217*4+1)"
18701e9ea774SBruce Evansoptions 	BROOKTREE_ALLOC_PAGES="(217*4+1)"
18711e9ea774SBruce Evans# Broken:
18721e9ea774SBruce Evans##options 	CAPABILITIES
18731e9ea774SBruce Evansoptions 	MAXFILES=999
18741e9ea774SBruce Evans# METEOR_TEST_VIDEO has no effect since meteor is broken.
18751e9ea774SBruce Evansoptions 	METEOR_TEST_VIDEO
18761e9ea774SBruce Evansoptions 	NDEVFSINO=1025
18771e9ea774SBruce Evansoptions 	NDEVFSOVERFLOW=32769
18781e9ea774SBruce Evansoptions 	NETGRAPH_BRIDGE
18791e9ea774SBruce Evans# SIMOS is broken since it is alpha-only but not ifdefed.
18801e9ea774SBruce Evans##options 	SIMOS
1881