xref: /freebsd/sys/conf/NOTES (revision 81d1ffee089aab2652954909acbe6aadd8a1a72c)
1# $FreeBSD$
2#
3# NOTES -- Lines that can be cut/pasted into kernel and hints configs.
4#
5# Lines that begin with 'device', 'options', 'machine', 'ident', 'maxusers',
6# 'makeoptions', 'hints', etc. go into the kernel configuration that you
7# run config(8) with.
8#
9# Lines that begin with 'hint.' are NOT for config(8), they go into your
10# hints file.  See /boot/device.hints and/or the 'hints' config(8) directive.
11#
12# Please use ``make LINT'' to create an old-style LINT file if you want to
13# do kernel test-builds.
14#
15# This file contains machine independent kernel configuration notes.  For
16# machine dependent notes, look in /sys/<arch>/conf/NOTES.
17#
18
19#
20# NOTES conventions and style guide:
21#
22# Large block comments should begin and end with a line containing only a
23# comment character.
24#
25# To describe a particular object, a block comment (if it exists) should
26# come first.  Next should come device, options, and hints lines in that
27# order.  All device and option lines must be described by a comment that
28# doesn't just expand the device or option name.  Use only a concise
29# comment on the same line if possible.  Very detailed descriptions of
30# devices and subsystems belong in manpages.
31#
32# A space followed by a tab separates 'option' from an option name.  Two
33# spaces followed by a tab separate 'device' from a device name.  Comments
34# after an option or device should use one space after the comment character.
35# To comment out a negative option that disables code and thus should not be
36# enabled for LINT builds, precede 'option' with "#!".
37#
38
39#
40# This is the ``identification'' of the kernel.  Usually this should
41# be the same as the name of your kernel.
42#
43ident		LINT
44
45#
46# The `maxusers' parameter controls the static sizing of a number of
47# internal system tables by a formula defined in subr_param.c.  Setting
48# maxusers to 0 will cause the system to auto-size based on physical
49# memory.
50#
51maxusers	10
52
53#
54# The `makeoptions' parameter allows variables to be passed to the
55# generated Makefile in the build area.
56#
57# CONF_CFLAGS gives some extra compiler flags that are added to ${CFLAGS}
58# after most other flags.  Here we use it to inhibit use of non-optimal
59# gcc builtin functions (e.g., memcmp).
60#
61# DEBUG happens to be magic.
62# The following is equivalent to 'config -g KERNELNAME' and creates
63# 'kernel.debug' compiled with -g debugging as well as a normal
64# 'kernel'.  Use 'make install.debug' to install the debug kernel
65# but that isn't normally necessary as the debug symbols are not loaded
66# by the kernel and are not useful there anyway.
67#
68# KERNEL can be overridden so that you can change the default name of your
69# kernel.
70#
71# MODULES_OVERRIDE can be used to limit modules built to a specific list.
72#
73makeoptions	CONF_CFLAGS=-fno-builtin  #Don't allow use of memcmp, etc.
74#makeoptions	DEBUG=-g		#Build kernel with gdb(1) debug symbols
75#makeoptions	KERNEL=foo		#Build kernel "foo" and install "/foo"
76# Only build Linux API modules and plus those parts of the sound system I need.
77#makeoptions	MODULES_OVERRIDE="linux sound/snd sound/pcm sound/driver/maestro3"
78makeoptions	DESTDIR=/tmp
79
80
81#
82# Certain applications can grow to be larger than the 512M limit
83# that FreeBSD initially imposes.  Below are some options to
84# allow that limit to grow to 1GB, and can be increased further
85# with changing the parameters.  MAXDSIZ is the maximum that the
86# limit can be set to, and the DFLDSIZ is the default value for
87# the limit.  MAXSSIZ is the maximum that the stack limit can be
88# set to.  You might want to set the default lower than the max,
89# and explicitly set the maximum with a shell command for processes
90# that regularly exceed the limit like INND.
91#
92options 	MAXDSIZ=(1024UL*1024*1024)
93options 	MAXSSIZ=(128UL*1024*1024)
94options 	DFLDSIZ=(1024UL*1024*1024)
95
96#
97# BLKDEV_IOSIZE sets the default block size used in user block
98# device I/O.  Note that this value will be overriden by the label
99# when specifying a block device from a label with a non-0
100# partition blocksize.  The default is PAGE_SIZE.
101#
102options 	BLKDEV_IOSIZE=8192
103
104# Options for the VM subsystem
105options 	PQ_CACHESIZE=512	# color for 512k/16k cache
106# Deprecated options supported for backwards compatibility
107#options 	PQ_NOOPT		# No coloring
108#options 	PQ_LARGECACHE		# color for 512k/16k cache
109#options 	PQ_HUGECACHE		# color for 1024k/16k cache
110#options 	PQ_MEDIUMCACHE		# color for 256k/16k cache
111#options 	PQ_NORMALCACHE		# color for 64k/16k cache
112
113# This allows you to actually store this configuration file into
114# the kernel binary itself, where it may be later read by saying:
115#    strings -n 3 /boot/kernel/kernel | sed -n 's/^___//p' > MYKERNEL
116#
117options 	INCLUDE_CONFIG_FILE     # Include this file in kernel
118
119options 	GEOM_AES
120options 	GEOM_APPLE
121options 	GEOM_BDE
122options 	GEOM_BSD
123options 	GEOM_GPT
124options 	GEOM_MBR
125options 	GEOM_PC98
126options 	GEOM_SUNLABEL
127options 	GEOM_VOL
128
129#
130# The root device and filesystem type can be compiled in;
131# this provides a fallback option if the root device cannot
132# be correctly guessed by the bootstrap code, or an override if
133# the RB_DFLTROOT flag (-r) is specified when booting the kernel.
134#
135options 	ROOTDEVNAME=\"ufs:da0s2e\"
136
137
138#####################################################################
139# Scheduler options:
140#
141# Specifying one of SCHED_4BSD or SCHED_ULE is mandatory.  These options
142# select which scheduler is compiled in.
143#
144# SCHED_4BSD is the historical, proven, BSD scheduler.  It has a global run
145# queue and no cpu affinity which makes it suboptimal for SMP.  It has very
146# good interactivity and priority selection.
147#
148# SCHED_ULE is a new experimental scheduler that has been designed for SMP,
149# but will work just fine on UP too.  Users of this scheduler should expect
150# some hicups and be prepaired to provide feedback.
151#
152options		SCHED_4BSD
153#options	SCHED_ULE
154
155#####################################################################
156# SMP OPTIONS:
157#
158# SMP enables building of a Symmetric MultiProcessor Kernel.
159
160# Mandatory:
161options 	SMP			# Symmetric MultiProcessor Kernel
162
163# ADAPTIVE_MUTEXES changes the behavior of blocking mutexes to spin
164# if the thread that currently owns the mutex is executing on another
165# CPU.
166options 	ADAPTIVE_MUTEXES
167
168# SMP Debugging Options:
169#
170# MUTEX_DEBUG enables various extra assertions in the mutex code.
171# WITNESS enables the witness code which detects deadlocks and cycles
172#         during locking operations.
173# WITNESS_DDB causes the witness code to drop into the kernel debugger if
174#	  a lock heirarchy violation occurs or if locks are held when going to
175#	  sleep.
176# WITNESS_SKIPSPIN disables the witness checks on spin mutexes.
177options 	MUTEX_DEBUG
178options 	WITNESS
179options 	WITNESS_DDB
180options 	WITNESS_SKIPSPIN
181
182#
183# MUTEX_PROFILING - Profiling mutual exclusion locks (mutexes).  This
184# records four numbers for each acquisition point (identified by
185# source file name and line number): longest time held, total time held,
186# number of non-recursive acquisitions, and average time held. Measurements
187# are made and stored in nanoseconds (using nanotime(9)), but are presented
188# in microseconds, which should be sufficient for the locks which actually
189# want this (those that are held long and / or often).  The MUTEX_PROFILING
190# option has the following sysctl namespace for controlling and viewing its
191# operation:
192#
193#  debug.mutex.prof.enable - enable / disable profiling
194#  debug.mutex.prof.acquisitions - number of mutex acquisitions held
195#  debug.mutex.prof.records - number of acquisition points recorded
196#  debug.mutex.prof.maxrecords - max number of acquisition points
197#  debug.mutex.prof.rejected - number of rejections (due to full table)
198#  debug.mutex.prof.hashsize - hash size
199#  debug.mutex.prof.collisions - number of hash collisions
200#  debug.mutex.prof.stats - profiling statistics
201#
202options 	MUTEX_PROFILING
203
204
205#####################################################################
206# COMPATIBILITY OPTIONS
207
208#
209# Implement system calls compatible with 4.3BSD and older versions of
210# FreeBSD.  You probably do NOT want to remove this as much current code
211# still relies on the 4.3 emulation.
212#
213options 	COMPAT_43
214
215# Enable FreeBSD4 compatibility syscalls
216options 	COMPAT_FREEBSD4
217
218#
219# These three options provide support for System V Interface
220# Definition-style interprocess communication, in the form of shared
221# memory, semaphores, and message queues, respectively.
222#
223options 	SYSVSHM
224options 	SYSVSEM
225options 	SYSVMSG
226
227
228#####################################################################
229# DEBUGGING OPTIONS
230
231#
232# Enable the kernel debugger.
233#
234options 	DDB
235
236#
237# Use direct symbol lookup routines for ddb instead of the kernel linker
238# ones, so that symbols (mostly) work before the kernel linker has been
239# initialized.  This is not the default because it breaks ddb's lookup of
240# symbols in loaded modules.
241#
242#!options 	DDB_NOKLDSYM
243
244#
245# Print a stack trace of the current thread out on the console for a panic.
246#
247options 	DDB_TRACE
248
249#
250# Don't drop into DDB for a panic. Intended for unattended operation
251# where you may want to drop to DDB from the console, but still want
252# the machine to recover from a panic
253#
254options 	DDB_UNATTENDED
255
256#
257# If using GDB remote mode to debug the kernel, there's a non-standard
258# extension to the remote protocol that can be used to use the serial
259# port as both the debugging port and the system console.  It's non-
260# standard and you're on your own if you enable it.  See also the
261# "remotechat" variables in the FreeBSD specific version of gdb.
262#
263options 	GDB_REMOTE_CHAT
264
265#
266# KTRACE enables the system-call tracing facility ktrace(2).  To be more
267# SMP-friendly, KTRACE uses a worker thread to process most trace events
268# asynchronously to the thread generating the event.  This requires a
269# pre-allocated store of objects representing trace events.  The
270# KTRACE_REQUEST_POOL option specifies the initial size of this store.
271# The size of the pool can be adjusted both at boottime and runtime via
272# the kern.ktrace_request_pool tunable and sysctl.
273#
274options 	KTRACE			#kernel tracing
275options 	KTRACE_REQUEST_POOL=101
276
277#
278# KTR is a kernel tracing mechanism imported from BSD/OS.  Currently it
279# has no userland interface aside from a few sysctl's.  It is enabled with
280# the KTR option.  KTR_ENTRIES defines the number of entries in the circular
281# trace buffer.  KTR_COMPILE defines the mask of events to compile into the
282# kernel as defined by the KTR_* constants in <sys/ktr.h>.  KTR_MASK defines the
283# initial value of the ktr_mask variable which determines at runtime what
284# events to trace.  KTR_CPUMASK determines which CPU's log events, with
285# bit X corresponding to cpu X.  KTR_VERBOSE enables dumping of KTR events
286# to the console by default.  This functionality can be toggled via the
287# debug.ktr_verbose sysctl and defaults to off if KTR_VERBOSE is not defined.
288#
289options 	KTR
290options 	KTR_ENTRIES=1024
291options 	KTR_COMPILE=(KTR_INTR|KTR_PROC)
292options 	KTR_MASK=KTR_INTR
293options 	KTR_CPUMASK=0x3
294options 	KTR_VERBOSE
295
296#
297# The INVARIANTS option is used in a number of source files to enable
298# extra sanity checking of internal structures.  This support is not
299# enabled by default because of the extra time it would take to check
300# for these conditions, which can only occur as a result of
301# programming errors.
302#
303options 	INVARIANTS
304
305#
306# The INVARIANT_SUPPORT option makes us compile in support for
307# verifying some of the internal structures.  It is a prerequisite for
308# 'INVARIANTS', as enabling 'INVARIANTS' will make these functions be
309# called.  The intent is that you can set 'INVARIANTS' for single
310# source files (by changing the source file or specifying it on the
311# command line) if you have 'INVARIANT_SUPPORT' enabled.  Also, if you
312# wish to build a kernel module with 'INVARIANTS', then adding
313# 'INVARIANT_SUPPORT' to your kernel will provide all the necessary
314# infrastructure without the added overhead.
315#
316options 	INVARIANT_SUPPORT
317
318#
319# The DIAGNOSTIC option is used to enable extra debugging information
320# from some parts of the kernel.  As this makes everything more noisy,
321# it is disabled by default.
322#
323options 	DIAGNOSTIC
324
325#
326# REGRESSION causes optional kernel interfaces necessary only for regression
327# testing to be enabled.  These interfaces may consitute security risks
328# when enabled, as they permit processes to easily modify aspects of the
329# run-time environment to reproduce unlikely or unusual (possibly normally
330# impossible) scenarios.
331#
332options 	REGRESSION
333
334#
335# RESTARTABLE_PANICS allows one to continue from a panic as if it were
336# a call to the debugger via the Debugger() function instead.  It is only
337# useful if a kernel debugger is present.  To restart from a panic, reset
338# the panicstr variable to NULL and continue execution.  This option is
339# for development use only and should NOT be used in production systems
340# to "workaround" a panic.
341#
342#options 	RESTARTABLE_PANICS
343
344#
345# This option let some drivers co-exist that can't co-exist in a running
346# system.  This is used to be able to compile all kernel code in one go for
347# quality assurance purposes (like this file, which the option takes it name
348# from.)
349#
350options 	COMPILING_LINT
351
352
353#####################################################################
354# NETWORKING OPTIONS
355
356#
357# Protocol families:
358#  Only the INET (Internet) family is officially supported in FreeBSD.
359#
360options 	INET			#Internet communications protocols
361options 	INET6			#IPv6 communications protocols
362options 	IPSEC			#IP security
363options 	IPSEC_ESP		#IP security (crypto; define w/ IPSEC)
364options 	IPSEC_DEBUG		#debug for IP security
365#
366# Set IPSEC_FILTERGIF to force packets coming through a gif tunnel
367# to be processed by any configured packet filtering (ipfw, ipf).
368# The default is that packets coming from a tunnel are _not_ processed;
369# they are assumed trusted.
370#
371# Note that enabling this can be problematic as there are no mechanisms
372# in place for distinguishing packets coming out of a tunnel (e.g. no
373# encX devices as found on openbsd).
374#
375#options 	IPSEC_FILTERGIF		#filter ipsec packets from a tunnel
376
377#options 	FAST_IPSEC		#new IPsec (cannot define w/ IPSEC)
378
379options 	IPX			#IPX/SPX communications protocols
380options 	IPXIP			#IPX in IP encapsulation (not available)
381options 	IPTUNNEL		#IP in IPX encapsulation (not available)
382
383#options 	NCP			#NetWare Core protocol
384
385options 	NETATALK		#Appletalk communications protocols
386options 	NETATALKDEBUG		#Appletalk debugging
387
388#
389# SMB/CIFS requester
390# NETSMB enables support for SMB protocol, it requires LIBMCHAIN and LIBICONV
391# options.
392# NETSMBCRYPTO enables support for encrypted passwords.
393options 	NETSMB			#SMB/CIFS requester
394options 	NETSMBCRYPTO		#encrypted password support for SMB
395
396# mchain library. It can be either loaded as KLD or compiled into kernel
397options 	LIBMCHAIN
398
399# netgraph(4). Enable the base netgraph code with the NETGRAPH option.
400# Individual node types can be enabled with the corresponding option
401# listed below; however, this is not strictly necessary as netgraph
402# will automatically load the corresponding KLD module if the node type
403# is not already compiled into the kernel. Each type below has a
404# corresponding man page, e.g., ng_async(8).
405options 	NETGRAPH		#netgraph(4) system
406options 	NETGRAPH_ASYNC
407options 	NETGRAPH_BPF
408options 	NETGRAPH_BRIDGE
409options 	NETGRAPH_CISCO
410options 	NETGRAPH_ECHO
411options 	NETGRAPH_ETHER
412options 	NETGRAPH_FRAME_RELAY
413options 	NETGRAPH_GIF
414options 	NETGRAPH_GIF_DEMUX
415options 	NETGRAPH_HOLE
416options 	NETGRAPH_IFACE
417options 	NETGRAPH_IP_INPUT
418options 	NETGRAPH_KSOCKET
419options 	NETGRAPH_L2TP
420options 	NETGRAPH_LMI
421# MPPC compression requires proprietary files (not included)
422#options 	NETGRAPH_MPPC_COMPRESSION
423options 	NETGRAPH_MPPC_ENCRYPTION
424options 	NETGRAPH_ONE2MANY
425options 	NETGRAPH_PPP
426options 	NETGRAPH_PPPOE
427options 	NETGRAPH_PPTPGRE
428options 	NETGRAPH_RFC1490
429options 	NETGRAPH_SOCKET
430options 	NETGRAPH_SPLIT
431options 	NETGRAPH_TEE
432options 	NETGRAPH_TTY
433options 	NETGRAPH_UI
434options 	NETGRAPH_VJC
435
436device		mn	# Munich32x/Falc54 Nx64kbit/sec cards.
437device		lmc	# tulip based LanMedia WAN cards
438device		musycc	# LMC/SBE LMC1504 quad T1/E1
439
440#
441# Network interfaces:
442#  The `loop' device is MANDATORY when networking is enabled.
443#  The `ether' device provides generic code to handle
444#  Ethernets; it is MANDATORY when an Ethernet device driver is
445#  configured or token-ring is enabled.
446#  The 'wlan' device provides generic code to support 802.11
447#  drivers, including host AP mode; it is MANDATORY for the wi
448#  driver and will eventually be required by all 802.11 drivers.
449#  The `fddi' device provides generic code to support FDDI.
450#  The `arcnet' device provides generic code to support Arcnet.
451#  The `sppp' device serves a similar role for certain types
452#  of synchronous PPP links (like `cx', `ar').
453#  The `sl' device implements the Serial Line IP (SLIP) service.
454#  The `ppp' device implements the Point-to-Point Protocol.
455#  The `bpf' device enables the Berkeley Packet Filter.  Be
456#  aware of the legal and administrative consequences of enabling this
457#  option.  The number of devices determines the maximum number of
458#  simultaneous BPF clients programs runnable.
459#  The `disc' device implements a minimal network interface,
460#  which throws away all packets sent and never receives any.  It is
461#  included for testing purposes.  This shows up as the `ds' interface.
462#  The `tap' device is a pty-like virtual Ethernet interface
463#  The `tun' device implements (user-)ppp and nos-tun
464#  The `gif' device implements IPv6 over IP4 tunneling,
465#  IPv4 over IPv6 tunneling, IPv4 over IPv4 tunneling and
466#  IPv6 over IPv6 tunneling.
467#  The `gre' device implements two types of IP4 over IP4 tunneling:
468#  GRE and MOBILE, as specified in the RFC1701 and RFC2004.
469#  The XBONEHACK option allows the same pair of addresses to be configured on
470#  multiple gif interfaces.
471#  The `faith' device captures packets sent to it and diverts them
472#  to the IPv4/IPv6 translation daemon.
473#  The `stf' device implements 6to4 encapsulation.
474#  The `ef' device provides support for multiple ethernet frame types
475#  specified via ETHER_* options. See ef(4) for details.
476#
477# The PPP_BSDCOMP option enables support for compress(1) style entire
478# packet compression, the PPP_DEFLATE is for zlib/gzip style compression.
479# PPP_FILTER enables code for filtering the ppp data stream and selecting
480# events for resetting the demand dial activity timer - requires bpf.
481# See pppd(8) for more details.
482#
483device		ether			#Generic Ethernet
484device		vlan			#VLAN support
485device		wlan			#802.11 support
486device		token			#Generic TokenRing
487device		fddi			#Generic FDDI
488device		arcnet			#Generic Arcnet
489device		sppp			#Generic Synchronous PPP
490device		loop			#Network loopback device
491device		bpf			#Berkeley packet filter
492device		disc			#Discard device (ds0, ds1, etc)
493device		tap			#Virtual Ethernet driver
494device		tun			#Tunnel driver (ppp(8), nos-tun(8))
495device		sl			#Serial Line IP
496device		gre			#IP over IP tunneling
497device		ppp			#Point-to-point protocol
498options 	PPP_BSDCOMP		#PPP BSD-compress support
499options 	PPP_DEFLATE		#PPP zlib/deflate/gzip support
500options 	PPP_FILTER		#enable bpf filtering (needs bpf)
501
502device		ef			# Multiple ethernet frames support
503options 	ETHER_II		# enable Ethernet_II frame
504options 	ETHER_8023		# enable Ethernet_802.3 (Novell) frame
505options 	ETHER_8022		# enable Ethernet_802.2 frame
506options 	ETHER_SNAP		# enable Ethernet_802.2/SNAP frame
507
508# for IPv6
509device		gif			#IPv6 and IPv4 tunneling
510options 	XBONEHACK
511device		faith			#for IPv6 and IPv4 translation
512device		stf			#6to4 IPv6 over IPv4 encapsulation
513
514#
515# Internet family options:
516#
517# MROUTING enables the kernel multicast packet forwarder, which works
518# with mrouted(8).
519#
520# IPFIREWALL enables support for IP firewall construction, in
521# conjunction with the `ipfw' program.  IPFIREWALL_VERBOSE sends
522# logged packets to the system logger.  IPFIREWALL_VERBOSE_LIMIT
523# limits the number of times a matching entry can be logged.
524#
525# WARNING:  IPFIREWALL defaults to a policy of "deny ip from any to any"
526# and if you do not add other rules during startup to allow access,
527# YOU WILL LOCK YOURSELF OUT.  It is suggested that you set firewall_type=open
528# in /etc/rc.conf when first enabling this feature, then refining the
529# firewall rules in /etc/rc.firewall after you've tested that the new kernel
530# feature works properly.
531#
532# IPFIREWALL_DEFAULT_TO_ACCEPT causes the default rule (at boot) to
533# allow everything.  Use with care, if a cracker can crash your
534# firewall machine, they can get to your protected machines.  However,
535# if you are using it as an as-needed filter for specific problems as
536# they arise, then this may be for you.  Changing the default to 'allow'
537# means that you won't get stuck if the kernel and /sbin/ipfw binary get
538# out of sync.
539#
540# IPDIVERT enables the divert IP sockets, used by ``ipfw divert''
541#
542# IPSTEALTH enables code to support stealth forwarding (i.e., forwarding
543# packets without touching the ttl).  This can be useful to hide firewalls
544# from traceroute and similar tools.
545#
546# PFIL_HOOKS enables an abtraction layer which is meant to be used in
547# network code where filtering is required.  See the pfil(9) man page.
548# This option is a subset of the IPFILTER option.
549#
550# TCPDEBUG enables code which keeps traces of the TCP state machine
551# for sockets with the SO_DEBUG option set, which can then be examined
552# using the trpt(8) utility.
553#
554options 	MROUTING		# Multicast routing
555options 	IPFIREWALL		#firewall
556options 	IPFIREWALL_VERBOSE	#enable logging to syslogd(8)
557options 	IPFIREWALL_FORWARD	#enable transparent proxy support
558options 	IPFIREWALL_VERBOSE_LIMIT=100	#limit verbosity
559options 	IPFIREWALL_DEFAULT_TO_ACCEPT	#allow everything by default
560options 	IPV6FIREWALL		#firewall for IPv6
561options 	IPV6FIREWALL_VERBOSE
562options 	IPV6FIREWALL_VERBOSE_LIMIT=100
563options 	IPV6FIREWALL_DEFAULT_TO_ACCEPT
564options 	IPDIVERT		#divert sockets
565options 	IPFILTER		#ipfilter support
566options 	IPFILTER_LOG		#ipfilter logging
567options 	IPFILTER_DEFAULT_BLOCK	#block all packets by default
568options 	IPSTEALTH		#support for stealth forwarding
569options 	PFIL_HOOKS
570options 	TCPDEBUG
571
572# RANDOM_IP_ID causes the ID field in IP packets to be randomized
573# instead of incremented by 1 with each packet generated.  This
574# option closes a minor information leak which allows remote
575# observers to determine the rate of packet generation on the
576# machine by watching the counter.
577options 	RANDOM_IP_ID
578
579# Statically Link in accept filters
580options 	ACCEPT_FILTER_DATA
581options 	ACCEPT_FILTER_HTTP
582
583# TCP_DROP_SYNFIN adds support for ignoring TCP packets with SYN+FIN. This
584# prevents nmap et al. from identifying the TCP/IP stack, but breaks support
585# for RFC1644 extensions and is not recommended for web servers.
586#
587options 	TCP_DROP_SYNFIN		#drop TCP packets with SYN+FIN
588
589# DUMMYNET enables the "dummynet" bandwidth limiter. You need
590# IPFIREWALL as well. See the dummynet(4) and ipfw(8) manpages for more info.
591# When you run DUMMYNET it is advisable to also have "options HZ=1000"
592# to achieve a smoother scheduling of the traffic.
593#
594# BRIDGE enables bridging between ethernet cards -- see bridge(4).
595# You can use IPFIREWALL and DUMMYNET together with bridging.
596#
597options 	DUMMYNET
598options 	BRIDGE
599
600# Zero copy sockets support.  This enables "zero copy" for sending and
601# receving data via a socket.  The send side works for any type of NIC,
602# the receive side only works for NICs that support MTUs greater than the
603# page size of your architecture and that support header splitting.  See
604# zero_copy(9) for more details.
605options 	ZERO_COPY_SOCKETS
606
607#
608# ATM (HARP version) options
609#
610# ATM_CORE includes the base ATM functionality code.  This must be included
611#	for ATM support.
612#
613# ATM_IP includes support for running IP over ATM.
614#
615# At least one (and usually only one) of the following signalling managers
616# must be included (note that all signalling managers include PVC support):
617# ATM_SIGPVC includes support for the PVC-only signalling manager `sigpvc'.
618# ATM_SPANS includes support for the `spans' signalling manager, which runs
619#	the FORE Systems's proprietary SPANS signalling protocol.
620# ATM_UNI includes support for the `uni30' and `uni31' signalling managers,
621#	which run the ATM Forum UNI 3.x signalling protocols.
622#
623# The `hea' driver provides support for the Efficient Networks, Inc.
624# ENI-155p ATM PCI Adapter.
625#
626# The `hfa' driver provides support for the FORE Systems, Inc.
627# PCA-200E ATM PCI Adapter.
628#
629options 	ATM_CORE		#core ATM protocol family
630options 	ATM_IP			#IP over ATM support
631options 	ATM_SIGPVC		#SIGPVC signalling manager
632options 	ATM_SPANS		#SPANS signalling manager
633options 	ATM_UNI			#UNI signalling manager
634
635device		hea			#Efficient ENI-155p ATM PCI
636device		hfa			#FORE PCA-200E ATM PCI
637
638
639#####################################################################
640# FILESYSTEM OPTIONS
641
642#
643# Only the root, /usr, and /tmp filesystems need be statically
644# compiled; everything else will be automatically loaded at mount
645# time.  (Exception: the UFS family--- FFS --- cannot
646# currently be demand-loaded.)  Some people still prefer to statically
647# compile other filesystems as well.
648#
649# NB: The NULL, PORTAL, UMAP and UNION filesystems are known to be
650# buggy, and WILL panic your system if you attempt to do anything with
651# them.  They are included here as an incentive for some enterprising
652# soul to sit down and fix them.
653#
654
655# One of these is mandatory:
656options 	FFS			#Fast filesystem
657options 	NFSCLIENT		#Network File System
658options 	NFSSERVER		#Network File System
659
660# The rest are optional:
661options 	CD9660			#ISO 9660 filesystem
662options 	FDESCFS			#File descriptor filesystem
663options 	HPFS			#OS/2 File system
664options 	MSDOSFS			#MS DOS File System (FAT, FAT32)
665options 	NTFS			#NT File System
666options 	NULLFS			#NULL filesystem
667#options 	NWFS			#NetWare filesystem
668options 	PORTALFS		#Portal filesystem
669options 	PROCFS			#Process filesystem (requires PSEUDOFS)
670options 	PSEUDOFS		#Pseudo-filesystem framework
671options 	SMBFS			#SMB/CIFS filesystem
672options 	UDF			#Universal Disk Format
673options 	UMAPFS			#UID map filesystem
674options 	UNIONFS			#Union filesystem
675# The xFS_ROOT options REQUIRE the associated ``options xFS''
676options 	NFS_ROOT		#NFS usable as root device
677
678# Soft updates is a technique for improving filesystem speed and
679# making abrupt shutdown less risky.
680#
681options 	SOFTUPDATES
682
683# Extended attributes allow additional data to be associated with files,
684# and is used for ACLs, Capabilities, and MAC labels.
685# See src/sys/ufs/ufs/README.extattr for more information.
686options 	UFS_EXTATTR
687options 	UFS_EXTATTR_AUTOSTART
688
689# Access Control List support for UFS filesystems.  The current ACL
690# implementation requires extended attribute support, UFS_EXTATTR,
691# for the underlying filesystem.
692# See src/sys/ufs/ufs/README.acls for more information.
693options 	UFS_ACL
694
695# Directory hashing improves the speed of operations on very large
696# directories at the expense of some memory.
697options 	UFS_DIRHASH
698
699# Make space in the kernel for a root filesystem on a md device.
700# Define to the number of kilobytes to reserve for the filesystem.
701options 	MD_ROOT_SIZE=10
702
703# Make the md device a potential root device, either with preloaded
704# images of type mfs_root or md_root.
705options 	MD_ROOT
706
707# Allow this many swap-devices.
708#
709# In order to manage swap, the system must reserve bitmap space that
710# scales with the largest mounted swap device multiplied by NSWAPDEV,
711# irregardless of whether other swap devices exist or not.  So it
712# is not a good idea to make this value too large.
713options 	NSWAPDEV=5
714
715# Disk quotas are supported when this option is enabled.
716options 	QUOTA			#enable disk quotas
717
718# If you are running a machine just as a fileserver for PC and MAC
719# users, using SAMBA or Netatalk, you may consider setting this option
720# and keeping all those users' directories on a filesystem that is
721# mounted with the suiddir option. This gives new files the same
722# ownership as the directory (similar to group). It's a security hole
723# if you let these users run programs, so confine it to file-servers
724# (but it'll save you lots of headaches in those cases). Root owned
725# directories are exempt and X bits are cleared. The suid bit must be
726# set on the directory as well; see chmod(1) PC owners can't see/set
727# ownerships so they keep getting their toes trodden on. This saves
728# you all the support calls as the filesystem it's used on will act as
729# they expect: "It's my dir so it must be my file".
730#
731options 	SUIDDIR
732
733# NFS options:
734options 	NFS_MINATTRTIMO=3	# VREG attrib cache timeout in sec
735options 	NFS_MAXATTRTIMO=60
736options 	NFS_MINDIRATTRTIMO=30	# VDIR attrib cache timeout in sec
737options 	NFS_MAXDIRATTRTIMO=60
738options 	NFS_GATHERDELAY=10	# Default write gather delay (msec)
739options 	NFS_WDELAYHASHSIZ=16	# and with this
740options 	NFS_DEBUG		# Enable NFS Debugging
741
742# Coda stuff:
743options 	CODA			#CODA filesystem.
744device		vcoda	4		#coda minicache <-> venus comm.
745
746#
747# Add support for the EXT2FS filesystem of Linux fame.  Be a bit
748# careful with this - the ext2fs code has a tendency to lag behind
749# changes and not be exercised very much, so mounting read/write could
750# be dangerous (and even mounting read only could result in panics.)
751#
752options 	EXT2FS
753
754# Use real implementations of the aio_* system calls.  There are numerous
755# stability and security issues in the current aio code that make it
756# unsuitable for inclusion on machines with untrusted local users.
757options 	VFS_AIO
758
759# Cryptographically secure random number generator; /dev/[u]random
760device		random
761
762
763#####################################################################
764# POSIX P1003.1B
765
766# Real time extensions added in the 1993 Posix
767# _KPOSIX_PRIORITY_SCHEDULING: Build in _POSIX_PRIORITY_SCHEDULING
768
769options 	_KPOSIX_PRIORITY_SCHEDULING
770# p1003_1b_semaphores are very experimental,
771# user should be ready to assist in debugging if problems arise.
772options		P1003_1B_SEMAPHORES
773
774
775#####################################################################
776# SECURITY POLICY PARAMETERS
777
778# Support for Mandatory Access Control (MAC):
779options 	MAC
780options 	MAC_BIBA
781options 	MAC_BSDEXTENDED
782options 	MAC_DEBUG
783options 	MAC_IFOFF
784options 	MAC_LOMAC
785options 	MAC_MLS
786options 	MAC_NONE
787options 	MAC_PARTITION
788options 	MAC_PORTACL
789options 	MAC_SEEOTHERUIDS
790options 	MAC_TEST
791
792
793#####################################################################
794# CLOCK OPTIONS
795
796# The granularity of operation is controlled by the kernel option HZ whose
797# default value (100) means a granularity of 10ms (1s/HZ).
798# Some subsystems, such as DUMMYNET, might benefit from a smaller
799# granularity such as 1ms or less, for a smoother scheduling of packets.
800# Consider, however, that reducing the granularity too much might
801# cause excessive overhead in clock interrupt processing,
802# potentially causing ticks to be missed and thus actually reducing
803# the accuracy of operation.
804
805options 	HZ=100
806
807# If you see the "calcru: negative time of %ld usec for pid %d (%s)\n"
808# message you probably have some broken sw/hw which disables interrupts
809# for too long.  You can make the system more resistant to this by
810# choosing a high value for NTIMECOUNTER.  The default is 5, there
811# is no upper limit but more than a couple of hundred are not productive.
812
813options 	NTIMECOUNTER=20
814
815# Enable support for the kernel PLL to use an external PPS signal,
816# under supervision of [x]ntpd(8)
817# More info in ntpd documentation: http://www.eecis.udel.edu/~ntp
818
819options 	PPS_SYNC
820
821
822#####################################################################
823# SCSI DEVICES
824
825# SCSI DEVICE CONFIGURATION
826
827# The SCSI subsystem consists of the `base' SCSI code, a number of
828# high-level SCSI device `type' drivers, and the low-level host-adapter
829# device drivers.  The host adapters are listed in the ISA and PCI
830# device configuration sections below.
831#
832# Beginning with FreeBSD 2.0.5 you can wire down your SCSI devices so
833# that a given bus, target, and LUN always come on line as the same
834# device unit.  In earlier versions the unit numbers were assigned
835# in the order that the devices were probed on the SCSI bus.  This
836# means that if you removed a disk drive, you may have had to rewrite
837# your /etc/fstab file, and also that you had to be careful when adding
838# a new disk as it may have been probed earlier and moved your device
839# configuration around.
840
841# This old behavior is maintained as the default behavior.  The unit
842# assignment begins with the first non-wired down unit for a device
843# type.  For example, if you wire a disk as "da3" then the first
844# non-wired disk will be assigned da4.
845
846# The syntax for wiring down devices is:
847
848hint.scbus.0.at="ahc0"
849hint.scbus.1.at="ahc1"
850hint.scbus.1.bus="0"
851hint.scbus.3.at="ahc2"
852hint.scbus.3.bus="0"
853hint.scbus.2.at="ahc2"
854hint.scbus.2.bus="1"
855hint.da.0.at="scbus0"
856hint.da.0.target="0"
857hint.da.0.unit="0"
858hint.da.1.at="scbus3"
859hint.da.1.target="1"
860hint.da.2.at="scbus2"
861hint.da.2.target="3"
862hint.sa.1.at="scbus1"
863hint.sa.1.target="6"
864
865# "units" (SCSI logical unit number) that are not specified are
866# treated as if specified as LUN 0.
867
868# All SCSI devices allocate as many units as are required.
869
870# The ch driver drives SCSI Media Changer ("jukebox") devices.
871#
872# The da driver drives SCSI Direct Access ("disk") and Optical Media
873# ("WORM") devices.
874#
875# The sa driver drives SCSI Sequential Access ("tape") devices.
876#
877# The cd driver drives SCSI Read Only Direct Access ("cd") devices.
878#
879# The ses driver drives SCSI Envinronment Services ("ses") and
880# SAF-TE ("SCSI Accessable Fault-Tolerant Enclosure") devices.
881#
882# The pt driver drives SCSI Processor devices.
883#
884#
885# Target Mode support is provided here but also requires that a SIM
886# (SCSI Host Adapter Driver) provide support as well.
887#
888# The targ driver provides target mode support as a Processor type device.
889# It exists to give the minimal context necessary to respond to Inquiry
890# commands. There is a sample user application that shows how the rest
891# of the command support might be done in /usr/share/examples/scsi_target.
892#
893# The targbh driver provides target mode support and exists to respond
894# to incoming commands that do not otherwise have a logical unit assigned
895# to them.
896#
897# The "unknown" device (uk? in pre-2.0.5) is now part of the base SCSI
898# configuration as the "pass" driver.
899
900device		scbus		#base SCSI code
901device		ch		#SCSI media changers
902device		da		#SCSI direct access devices (aka disks)
903device		sa		#SCSI tapes
904device		cd		#SCSI CD-ROMs
905device		ses		#SCSI Environmental Services (and SAF-TE)
906device		pt		#SCSI processor
907device		targ		#SCSI Target Mode Code
908device		targbh		#SCSI Target Mode Blackhole Device
909device		pass		#CAM passthrough driver
910
911# CAM OPTIONS:
912# debugging options:
913# -- NOTE --  If you specify one of the bus/target/lun options, you must
914#             specify them all!
915# CAMDEBUG: When defined enables debugging macros
916# CAM_DEBUG_BUS:  Debug the given bus.  Use -1 to debug all busses.
917# CAM_DEBUG_TARGET:  Debug the given target.  Use -1 to debug all targets.
918# CAM_DEBUG_LUN:  Debug the given lun.  Use -1 to debug all luns.
919# CAM_DEBUG_FLAGS:  OR together CAM_DEBUG_INFO, CAM_DEBUG_TRACE,
920#                   CAM_DEBUG_SUBTRACE, and CAM_DEBUG_CDB
921#
922# CAM_MAX_HIGHPOWER: Maximum number of concurrent high power (start unit) cmds
923# CAM_NEW_TRAN_CODE: this is the new transport layer code that will be switched
924#			to soon
925# SCSI_NO_SENSE_STRINGS: When defined disables sense descriptions
926# SCSI_NO_OP_STRINGS: When defined disables opcode descriptions
927# SCSI_DELAY: The number of MILLISECONDS to freeze the SIM (scsi adapter)
928#             queue after a bus reset, and the number of milliseconds to
929#             freeze the device queue after a bus device reset.  This
930#             can be changed at boot and runtime with the
931#             kern.cam.scsi_delay tunable/sysctl.
932options 	CAMDEBUG
933options 	CAM_DEBUG_BUS=-1
934options 	CAM_DEBUG_TARGET=-1
935options 	CAM_DEBUG_LUN=-1
936options 	CAM_DEBUG_FLAGS=(CAM_DEBUG_INFO|CAM_DEBUG_TRACE|CAM_DEBUG_CDB)
937options 	CAM_MAX_HIGHPOWER=4
938options 	SCSI_NO_SENSE_STRINGS
939options 	SCSI_NO_OP_STRINGS
940options 	SCSI_DELAY=8000	# Be pessimistic about Joe SCSI device
941
942# Options for the CAM CDROM driver:
943# CHANGER_MIN_BUSY_SECONDS: Guaranteed minimum time quantum for a changer LUN
944# CHANGER_MAX_BUSY_SECONDS: Maximum time quantum per changer LUN, only
945#                           enforced if there is I/O waiting for another LUN
946# The compiled in defaults for these variables are 2 and 10 seconds,
947# respectively.
948#
949# These can also be changed on the fly with the following sysctl variables:
950# kern.cam.cd.changer.min_busy_seconds
951# kern.cam.cd.changer.max_busy_seconds
952#
953options 	CHANGER_MIN_BUSY_SECONDS=2
954options 	CHANGER_MAX_BUSY_SECONDS=10
955
956# Options for the CAM sequential access driver:
957# SA_IO_TIMEOUT: Timeout for read/write/wfm  operations, in minutes
958# SA_SPACE_TIMEOUT: Timeout for space operations, in minutes
959# SA_REWIND_TIMEOUT: Timeout for rewind operations, in minutes
960# SA_ERASE_TIMEOUT: Timeout for erase operations, in minutes
961# SA_1FM_AT_EOD: Default to model which only has a default one filemark at EOT.
962options 	SA_IO_TIMEOUT=4
963options 	SA_SPACE_TIMEOUT=60
964options 	SA_REWIND_TIMEOUT=(2*60)
965options 	SA_ERASE_TIMEOUT=(4*60)
966options 	SA_1FM_AT_EOD
967
968# Optional timeout for the CAM processor target (pt) device
969# This is specified in seconds.  The default is 60 seconds.
970options 	SCSI_PT_DEFAULT_TIMEOUT=60
971
972# Optional enable of doing SES passthrough on other devices (e.g., disks)
973#
974# Normally disabled because a lot of newer SCSI disks report themselves
975# as having SES capabilities, but this can then clot up attempts to build
976# build a topology with the SES device that's on the box these drives
977# are in....
978options 	SES_ENABLE_PASSTHROUGH
979
980
981#####################################################################
982# MISCELLANEOUS DEVICES AND OPTIONS
983
984# The `pty' device usually turns out to be ``effectively mandatory'',
985# as it is required for `telnetd', `rlogind', `screen', `emacs', and
986# `xterm', among others.
987
988device		pty		#Pseudo ttys
989device		nmdm		#back-to-back tty devices
990device		md		#Memory/malloc disk
991device		snp		#Snoop device - to look at pty/vty/etc..
992device		ccd		#Concatenated disk driver
993
994# Configuring Vinum into the kernel is not necessary, since the kld
995# module gets started automatically when vinum(8) starts.  This
996# device is also untested.  Use at your own risk.
997#
998# The option VINUMDEBUG must match the value set in CFLAGS
999# in src/sbin/vinum/Makefile.  Failure to do so will result in
1000# the following message from vinum(8):
1001#
1002# Can't get vinum config: Invalid argument
1003#
1004# see vinum(4) for more reasons not to use these options.
1005device		vinum		#Vinum concat/mirror/raid driver
1006options 	VINUMDEBUG	#enable Vinum debugging hooks
1007
1008# RAIDframe device.  RAID_AUTOCONFIG allows RAIDframe to search all of the
1009# disk devices in the system looking for components that it recognizes (already
1010# configured once before) and auto-configured them into arrays.
1011device		raidframe
1012options		RAID_AUTOCONFIG
1013
1014# Kernel side iconv library
1015options 	LIBICONV
1016
1017# Size of the kernel message buffer.  Should be N * pagesize.
1018options 	MSGBUF_SIZE=40960
1019
1020# Maximum size of a tty or pty input buffer.
1021options 	TTYHOG=8193
1022
1023
1024#####################################################################
1025# HARDWARE DEVICE CONFIGURATION
1026
1027# For ISA the required hints are listed.
1028# EISA, MCA, PCI and pccard are self identifying buses, so no hints
1029# are needed.
1030
1031#
1032# Mandatory devices:
1033#
1034
1035# The keyboard controller; it controls the keyboard and the PS/2 mouse.
1036device		atkbdc
1037hint.atkbdc.0.at="isa"
1038hint.atkbdc.0.port="0x060"
1039
1040# The AT keyboard
1041device		atkbd
1042hint.atkbd.0.at="atkbdc"
1043hint.atkbd.0.irq="1"
1044
1045# Options for atkbd:
1046options 	ATKBD_DFLT_KEYMAP	# specify the built-in keymap
1047makeoptions	ATKBD_DFLT_KEYMAP=jp.106
1048
1049# These options are valid for other keyboard drivers as well.
1050options 	KBD_DISABLE_KEYMAP_LOAD	# refuse to load a keymap
1051options 	KBD_INSTALL_CDEV	# install a CDEV entry in /dev
1052
1053# `flags' for atkbd:
1054#       0x01    Force detection of keyboard, else we always assume a keyboard
1055#       0x02    Don't reset keyboard, useful for some newer ThinkPads
1056#	0x03	Force detection and avoid reset, might help with certain
1057#		dockingstations
1058#       0x04    Old-style (XT) keyboard support, useful for older ThinkPads
1059
1060# PS/2 mouse
1061device		psm
1062hint.psm.0.at="atkbdc"
1063hint.psm.0.irq="12"
1064
1065# Options for psm:
1066options 	PSM_HOOKRESUME		#hook the system resume event, useful
1067					#for some laptops
1068options 	PSM_RESETAFTERSUSPEND	#reset the device at the resume event
1069
1070# Video card driver for VGA adapters.
1071device		vga
1072hint.vga.0.at="isa"
1073
1074# Options for vga:
1075# Try the following option if the mouse pointer is not drawn correctly
1076# or font does not seem to be loaded properly.  May cause flicker on
1077# some systems.
1078options 	VGA_ALT_SEQACCESS
1079
1080# If you can dispense with some vga driver features, you may want to
1081# use the following options to save some memory.
1082#options 	VGA_NO_FONT_LOADING	# don't save/load font
1083#options 	VGA_NO_MODE_CHANGE	# don't change video modes
1084
1085# Older video cards may require this option for proper operation.
1086options 	VGA_SLOW_IOACCESS	# do byte-wide i/o's to TS and GDC regs
1087
1088# The following option probably won't work with the LCD displays.
1089options 	VGA_WIDTH90		# support 90 column modes
1090
1091options 	FB_DEBUG		# Frame buffer debugging
1092
1093device		splash			# Splash screen and screen saver support
1094
1095# Various screen savers.
1096device		blank_saver
1097device		daemon_saver
1098device		fade_saver
1099device		fire_saver
1100device		green_saver
1101device		logo_saver
1102device		rain_saver
1103device		star_saver
1104device		warp_saver
1105
1106# The syscons console driver (sco color console compatible).
1107device		sc
1108hint.sc.0.at="isa"
1109options 	MAXCONS=16		# number of virtual consoles
1110options 	SC_ALT_MOUSE_IMAGE	# simplified mouse cursor in text mode
1111options 	SC_DFLT_FONT		# compile font in
1112makeoptions	SC_DFLT_FONT=cp850
1113options 	SC_DISABLE_DDBKEY	# disable `debug' key
1114options 	SC_DISABLE_REBOOT	# disable reboot key sequence
1115options 	SC_HISTORY_SIZE=200	# number of history buffer lines
1116options 	SC_MOUSE_CHAR=0x3	# char code for text mode mouse cursor
1117options 	SC_PIXEL_MODE		# add support for the raster text mode
1118
1119# The following options will let you change the default colors of syscons.
1120options 	SC_NORM_ATTR=(FG_GREEN|BG_BLACK)
1121options 	SC_NORM_REV_ATTR=(FG_YELLOW|BG_GREEN)
1122options 	SC_KERNEL_CONS_ATTR=(FG_RED|BG_BLACK)
1123options 	SC_KERNEL_CONS_REV_ATTR=(FG_BLACK|BG_RED)
1124
1125# The following options will let you change the default behaviour of
1126# cut-n-paste feature
1127options 	SC_CUT_SPACES2TABS	# convert leading spaces into tabs
1128options 	SC_CUT_SEPCHARS=\"x09\"	# set of characters that delimit words
1129					# (default is single space - \"x20\")
1130
1131# If you have a two button mouse, you may want to add the following option
1132# to use the right button of the mouse to paste text.
1133options 	SC_TWOBUTTON_MOUSE
1134
1135# You can selectively disable features in syscons.
1136options 	SC_NO_CUTPASTE
1137options 	SC_NO_FONT_LOADING
1138options 	SC_NO_HISTORY
1139options 	SC_NO_SYSMOUSE
1140options 	SC_NO_SUSPEND_VTYSWITCH
1141
1142# `flags' for sc
1143#	0x80	Put the video card in the VESA 800x600 dots, 16 color mode
1144#	0x100	Probe for a keyboard device periodically if one is not present
1145
1146#
1147# Optional devices:
1148#
1149
1150#
1151# SCSI host adapters:
1152#
1153# adv: All Narrow SCSI bus AdvanSys controllers.
1154# adw: Second Generation AdvanSys controllers including the ADV940UW.
1155# aha: Adaptec 154x/1535/1640
1156# ahb: Adaptec 174x EISA controllers
1157# ahc: Adaptec 274x/284x/2910/293x/294x/394x/3950x/3960x/398X/4944/
1158#      19160x/29160x, aic7770/aic78xx
1159# ahd: Adaptec 29320/39320 Controllers.
1160# aic: Adaptec 6260/6360, APA-1460 (PC Card), NEC PC9801-100 (C-BUS)
1161# amd: Support for the AMD 53C974 SCSI host adapter chip as found on devices
1162#      such as the Tekram DC-390(T).
1163# bt:  Most Buslogic controllers: including BT-445, BT-54x, BT-64x, BT-74x,
1164#      BT-75x, BT-946, BT-948, BT-956, BT-958, SDC3211B, SDC3211F, SDC3222F
1165# isp: Qlogic ISP 1020, 1040 and 1040B PCI SCSI host adapters,
1166#      ISP 1240 Dual Ultra SCSI, ISP 1080 and 1280 (Dual) Ultra2,
1167#      ISP 12160 Ultra3 SCSI,
1168#      Qlogic ISP 2100 and ISP 2200 1Gb Fibre Channel host adapters.
1169#      Qlogic ISP 2300 and ISP 2312 2Gb Fibre Channel host adapters.
1170# ispfw: Firmware module for Qlogic host adapters
1171# mpt: LSI-Logic MPT/Fusion 53c1020 or 53c1030 Ultra4
1172#      or FC9x9 Fibre Channel host adapters.
1173# ncr: NCR 53C810, 53C825 self-contained SCSI host adapters.
1174# sym: Symbios/Logic 53C8XX family of PCI-SCSI I/O processors:
1175#      53C810, 53C810A, 53C815, 53C825,  53C825A, 53C860, 53C875,
1176#      53C876, 53C885,  53C895, 53C895A, 53C896,  53C897, 53C1510D,
1177#      53C1010-33, 53C1010-66.
1178# trm: Tekram DC395U/UW/F DC315U adapters.
1179# wds: WD7000
1180
1181#
1182# Note that the order is important in order for Buslogic ISA/EISA cards to be
1183# probed correctly.
1184#
1185device		bt
1186hint.bt.0.at="isa"
1187hint.bt.0.port="0x330"
1188device		adv
1189hint.adv.0.at="isa"
1190device		adw
1191device		aha
1192hint.aha.0.at="isa"
1193device		aic
1194hint.aic.0.at="isa"
1195device		ahb
1196device		ahc
1197device		ahd
1198device		amd
1199device		isp
1200hint.isp.0.disable="1"
1201hint.isp.0.role="3"
1202hint.isp.0.prefer_iomap="1"
1203hint.isp.0.prefer_memmap="1"
1204hint.isp.0.fwload_disable="1"
1205hint.isp.0.ignore_nvram="1"
1206hint.isp.0.fullduplex="1"
1207hint.isp.0.topology="lport"
1208hint.isp.0.topology="nport"
1209hint.isp.0.topology="lport-only"
1210hint.isp.0.topology="nport-only"
1211# we can't get u_int64_t types, nor can we get strings if it's got
1212# a leading 0x, hence this silly dodge.
1213hint.isp.0.portwnn="w50000000aaaa0000"
1214hint.isp.0.nodewnn="w50000000aaaa0001"
1215device		ispfw
1216device		mpt
1217device		ncr
1218device		sym
1219device		trm
1220device		wds
1221hint.wds.0.at="isa"
1222hint.wds.0.port="0x350"
1223hint.wds.0.irq="11"
1224hint.wds.0.drq="6"
1225
1226# The aic7xxx driver will attempt to use memory mapped I/O for all PCI
1227# controllers that have it configured only if this option is set. Unfortunately,
1228# this doesn't work on some motherboards, which prevents it from being the
1229# default.
1230options 	AHC_ALLOW_MEMIO
1231
1232# Dump the contents of the ahc controller configuration PROM.
1233options 	AHC_DUMP_EEPROM
1234
1235# Bitmap of units to enable targetmode operations.
1236options 	AHC_TMODE_ENABLE
1237
1238# Compile in aic79xx debugging code.
1239options 	AHD_DEBUG
1240
1241# Aic79xx driver debugging options.
1242# See the ahd(4) manpage
1243options 	AHD_DEBUG_OPTS=0xFFFFFFFF
1244
1245# Print human-readable register definitions when debugging
1246options 	AHD_REG_PRETTY_PRINT
1247
1248# The adw driver will attempt to use memory mapped I/O for all PCI
1249# controllers that have it configured only if this option is set.
1250options 	ADW_ALLOW_MEMIO
1251
1252# Options used in dev/isp/ (Qlogic SCSI/FC driver).
1253#
1254#	ISP_TARGET_MODE		-	enable target mode operation
1255#
1256options 	ISP_TARGET_MODE=1
1257
1258# Options used in dev/sym/ (Symbios SCSI driver).
1259#options 	SYM_SETUP_LP_PROBE_MAP	#-Low Priority Probe Map (bits)
1260					# Allows the ncr to take precedence
1261					# 1 (1<<0) -> 810a, 860
1262					# 2 (1<<1) -> 825a, 875, 885, 895
1263					# 4 (1<<2) -> 895a, 896, 1510d
1264#options 	SYM_SETUP_SCSI_DIFF	#-HVD support for 825a, 875, 885
1265					# disabled:0 (default), enabled:1
1266#options 	SYM_SETUP_PCI_PARITY	#-PCI parity checking
1267					# disabled:0, enabled:1 (default)
1268#options 	SYM_SETUP_MAX_LUN	#-Number of LUNs supported
1269					# default:8, range:[1..64]
1270
1271# The 'asr' driver provides support for current DPT/Adaptec SCSI RAID
1272# controllers (SmartRAID V and VI and later).
1273# These controllers require the CAM infrastructure.
1274#
1275device		asr
1276
1277# The 'dpt' driver provides support for old DPT controllers (http://www.dpt.com/).
1278# These have hardware RAID-{0,1,5} support, and do multi-initiator I/O.
1279# The DPT controllers are commonly re-licensed under other brand-names -
1280# some controllers by Olivetti, Dec, HP, AT&T, SNI, AST, Alphatronic, NEC and
1281# Compaq are actually DPT controllers.
1282#
1283# See src/sys/dev/dpt for debugging and other subtle options.
1284#   DPT_MEASURE_PERFORMANCE Enables a set of (semi)invasive metrics. Various
1285#                           instruments are enabled.  The tools in
1286#                           /usr/sbin/dpt_* assume these to be enabled.
1287#   DPT_HANDLE_TIMEOUTS     Normally device timeouts are handled by the DPT.
1288#                           If you ant the driver to handle timeouts, enable
1289#                           this option.  If your system is very busy, this
1290#                           option will create more trouble than solve.
1291#   DPT_TIMEOUT_FACTOR      Used to compute the excessive amount of time to
1292#                           wait when timing out with the above option.
1293#  DPT_DEBUG_xxxx           These are controllable from sys/dev/dpt/dpt.h
1294#  DPT_LOST_IRQ             When enabled, will try, once per second, to catch
1295#                           any interrupt that got lost.  Seems to help in some
1296#                           DPT-firmware/Motherboard combinations.  Minimal
1297#                           cost, great benefit.
1298#  DPT_RESET_HBA            Make "reset" actually reset the controller
1299#                           instead of fudging it.  Only enable this if you
1300#			    are 100% certain you need it.
1301
1302device		dpt
1303
1304# DPT options
1305#!CAM# options 	DPT_MEASURE_PERFORMANCE
1306#!CAM# options 	DPT_HANDLE_TIMEOUTS
1307options 	DPT_TIMEOUT_FACTOR=4
1308options 	DPT_LOST_IRQ
1309options 	DPT_RESET_HBA
1310options 	DPT_ALLOW_MEMIO
1311
1312#
1313# Compaq "CISS" RAID controllers (SmartRAID 5* series)
1314# These controllers have a SCSI-like interface, and require the
1315# CAM infrastructure.
1316#
1317device		ciss
1318
1319#
1320# Intel Integrated RAID controllers.
1321# This driver was developed and is maintained by Intel.  Contacts
1322# at Intel for this driver are
1323# "Kannanthanam, Boji T" <boji.t.kannanthanam@intel.com> and
1324# "Leubner, Achim" <achim.leubner@intel.com>.
1325#
1326device		iir
1327
1328#
1329# Mylex AcceleRAID and eXtremeRAID controllers with v6 and later
1330# firmware.  These controllers have a SCSI-like interface, and require
1331# the CAM infrastructure.
1332#
1333device		mly
1334
1335#
1336# Compaq Smart RAID, Mylex DAC960 and AMI MegaRAID controllers.  Only
1337# one entry is needed; the code will find and configure all supported
1338# controllers.
1339#
1340device		ida		# Compaq Smart RAID
1341device		mlx		# Mylex DAC960
1342device		amr		# AMI MegaRAID
1343
1344#
1345# 3ware ATA RAID
1346#
1347device		twe		# 3ware ATA RAID
1348
1349#
1350# The 'ATA' driver supports all ATA and ATAPI devices, including PC Card
1351# devices. You only need one "device ata" for it to find all
1352# PCI and PC Card ATA/ATAPI devices on modern machines.
1353device		ata
1354device		atadisk		# ATA disk drives
1355device		atapicd		# ATAPI CDROM drives
1356device		atapifd		# ATAPI floppy drives
1357device		atapist		# ATAPI tape drives
1358device		atapicam	# emulate ATAPI devices as SCSI ditto via CAM
1359				# needs CAM to be present (scbus & pass)
1360#
1361# For older non-PCI, non-PnPBIOS systems, these are the hints lines to add:
1362hint.ata.0.at="isa"
1363hint.ata.0.port="0x1f0"
1364hint.ata.0.irq="14"
1365hint.ata.1.at="isa"
1366hint.ata.1.port="0x170"
1367hint.ata.1.irq="15"
1368
1369#
1370# The following options are valid on the ATA driver:
1371#
1372# ATA_STATIC_ID:	controller numbering is static ie depends on location
1373#			else the device numbers are dynamically allocated.
1374
1375options 	ATA_STATIC_ID
1376
1377#
1378# Standard floppy disk controllers and floppy tapes, supports
1379# the Y-E DATA External FDD (PC Card)
1380#
1381device		fdc
1382hint.fdc.0.at="isa"
1383hint.fdc.0.port="0x3F0"
1384hint.fdc.0.irq="6"
1385hint.fdc.0.drq="2"
1386#
1387# FDC_DEBUG enables floppy debugging.  Since the debug output is huge, you
1388# gotta turn it actually on by setting the variable fd_debug with DDB,
1389# however.
1390options 	FDC_DEBUG
1391#
1392# Activate this line if you happen to have an Insight floppy tape.
1393# Probing them proved to be dangerous for people with floppy disks only,
1394# so it's "hidden" behind a flag:
1395#hint.fdc.0.flags="1"
1396
1397# Specify floppy devices
1398hint.fd.0.at="fdc0"
1399hint.fd.0.drive="0"
1400hint.fd.1.at="fdc0"
1401hint.fd.1.drive="1"
1402
1403#
1404# sio: serial ports (see sio(4)), including support for various
1405#      PC Card devices, such as Modem and NICs (see etc/defaults/pccard.conf)
1406
1407device		sio
1408hint.sio.0.at="isa"
1409hint.sio.0.port="0x3F8"
1410hint.sio.0.flags="0x10"
1411hint.sio.0.irq="4"
1412
1413#
1414# `flags' for serial drivers that support consoles (only for sio now):
1415#	0x10	enable console support for this unit.  The other console flags
1416#		are ignored unless this is set.  Enabling console support does
1417#		not make the unit the preferred console - boot with -h or set
1418#		the 0x20 flag for that.  Currently, at most one unit can have
1419#		console support; the first one (in config file order) with
1420#		this flag set is preferred.  Setting this flag for sio0 gives
1421#		the old behaviour.
1422#	0x20	force this unit to be the console (unless there is another
1423#		higher priority console).  This replaces the COMCONSOLE option.
1424#	0x40	reserve this unit for low level console operations.  Do not
1425#		access the device in any normal way.
1426#	0x80	use this port for serial line gdb support in ddb.
1427#
1428# PnP `flags'
1429#	0x1	disable probing of this device.  Used to prevent your modem
1430#		from being attached as a PnP modem.
1431#
1432
1433# Options for serial drivers that support consoles (only for sio now):
1434options 	BREAK_TO_DEBUGGER	#a BREAK on a comconsole goes to
1435					#DDB, if available.
1436options 	CONSPEED=115200		# speed for serial console
1437					# (default 9600)
1438
1439# Solaris implements a new BREAK which is initiated by a character
1440# sequence CR ~ ^b which is similar to a familiar pattern used on
1441# Sun servers by the Remote Console.
1442options 	ALT_BREAK_TO_DEBUGGER
1443
1444# Options for sio:
1445options 	COM_ESP			#code for Hayes ESP
1446options 	COM_MULTIPORT		#code for some cards with shared IRQs
1447
1448# Other flags for sio that aren't documented in the man page.
1449#	0x20000	enable hardware RTS/CTS and larger FIFOs.  Only works for
1450#		ST16650A-compatible UARTs.
1451
1452# PCI Universal Communications driver
1453# Supports various single and multi port PCI serial cards. Maybe later
1454# also the parallel ports on combination serial/parallel cards. New cards
1455# can be added in src/sys/dev/puc/pucdata.c.
1456#
1457# If the PUC_FASTINTR option is used the driver will try to use fast
1458# interrupts. The card must then be the only user of that interrupt.
1459# Interrupts cannot be shared when using PUC_FASTINTR.
1460device		puc
1461options 	PUC_FASTINTR
1462
1463#
1464# Network interfaces:
1465#
1466# MII bus support is required for some PCI 10/100 ethernet NICs,
1467# namely those which use MII-compliant transceivers or implement
1468# tranceiver control interfaces that operate like an MII. Adding
1469# "device miibus0" to the kernel config pulls in support for
1470# the generic miibus API and all of the PHY drivers, including a
1471# generic one for PHYs that aren't specifically handled by an
1472# individual driver.
1473device		miibus
1474
1475# an:   Aironet 4500/4800 802.11 wireless adapters. Supports the PCMCIA,
1476#       PCI and ISA varieties.
1477# awi:  Support for IEEE 802.11 PC Card devices using the AMD Am79C930 and
1478#       Harris (Intersil) Chipset with PCnetMobile firmware by AMD.
1479# bge:	Support for gigabit ethernet adapters based on the Broadcom
1480#	BCM570x family of controllers, including the 3Com 3c996-T,
1481#	the Netgear GA302T, the SysKonnect SK-9D21 and SK-9D41, and
1482#	the embedded gigE NICs on Dell PowerEdge 2550 servers.
1483# cm:	Arcnet SMC COM90c26 / SMC COM90c56
1484#	(and SMC COM90c66 in '56 compatibility mode) adapters.
1485# cnw:  Xircom CNW/Netware Airsurfer PC Card adapter
1486# cs:   IBM Etherjet and other Crystal Semi CS89x0-based adapters
1487# dc:   Support for PCI fast ethernet adapters based on the DEC/Intel 21143
1488#       and various workalikes including:
1489#       the ADMtek AL981 Comet and AN985 Centaur, the ASIX Electronics
1490#       AX88140A and AX88141, the Davicom DM9100 and DM9102, the Lite-On
1491#       82c168 and 82c169 PNIC, the Lite-On/Macronix LC82C115 PNIC II
1492#       and the Macronix 98713/98713A/98715/98715A/98725 PMAC. This driver
1493#       replaces the old al, ax, dm, pn and mx drivers.  List of brands:
1494#       Digital DE500-BA, Kingston KNE100TX, D-Link DFE-570TX, SOHOware SFA110,
1495#       SVEC PN102-TX, CNet Pro110B, 120A, and 120B, Compex RL100-TX,
1496#       LinkSys LNE100TX, LNE100TX V2.0, Jaton XpressNet, Alfa Inc GFC2204,
1497#       KNE110TX.
1498# de:   Digital Equipment DC21040
1499# em:   Intel Pro/1000 Gigabit Ethernet 82542, 82543, 82544 based adapters.
1500# ep:   3Com 3C509, 3C529, 3C556, 3C562D, 3C563D, 3C572, 3C574X, 3C579, 3C589
1501#       and PC Card devices using these chipsets.
1502# ex:   Intel EtherExpress Pro/10 and other i82595-based adapters,
1503#       Olicom Ethernet PC Card devices.
1504# fe:   Fujitsu MB86960A/MB86965A Ethernet
1505# fea:  DEC DEFEA EISA FDDI adapter
1506# fpa:  Support for the Digital DEFPA PCI FDDI. `device fddi' is also needed.
1507# fxp:  Intel EtherExpress Pro/100B
1508#	(hint of prefer_iomap can be done to prefer I/O instead of Mem mapping)
1509# gx:   Intel Pro/1000 Gigabit Ethernet (82542, 82543-F, 82543-T)
1510# lge:	Support for PCI gigabit ethernet adapters based on the Level 1
1511#	LXT1001 NetCellerator chipset. This includes the D-Link DGE-500SX,
1512#	SMC TigerCard 1000 (SMC9462SX), and some Addtron cards.
1513# my:	Myson Fast Ethernet (MTD80X, MTD89X)
1514# nge:	Support for PCI gigabit ethernet adapters based on the National
1515#	Semiconductor DP83820 and DP83821 chipset. This includes the
1516#	SMC EZ Card 1000 (SMC9462TX), D-Link DGE-500T, Asante FriendlyNet
1517#	GigaNIX 1000TA and 1000TPC, the Addtron AEG320T, the LinkSys
1518#	EG1032 and EG1064, the Surecom EP-320G-TX and the Netgear GA622T.
1519# pcn:	Support for PCI fast ethernet adapters based on the AMD Am79c97x
1520#	chipsets, including the PCnet/FAST, PCnet/FAST+, PCnet/PRO and
1521#	PCnet/Home. These were previously handled by the lnc driver (and
1522#	still will be if you leave this driver out of the kernel).
1523# rl:   Support for PCI fast ethernet adapters based on the RealTek 8129/8139
1524#       chipset.  Note that the RealTek driver defaults to using programmed
1525#       I/O to do register accesses because memory mapped mode seems to cause
1526#       severe lockups on SMP hardware.  This driver also supports the
1527#       Accton EN1207D `Cheetah' adapter, which uses a chip called
1528#       the MPX 5030/5038, which is either a RealTek in disguise or a
1529#       RealTek workalike.  Note that the D-Link DFE-530TX+ uses the RealTek
1530#       chipset and is supported by this driver, not the 'vr' driver.
1531# sf:   Support for Adaptec Duralink PCI fast ethernet adapters based on the
1532#       Adaptec AIC-6915 "starfire" controller.
1533#       This includes dual and quad port cards, as well as one 100baseFX card.
1534#       Most of these are 64-bit PCI devices, except for one single port
1535#       card which is 32-bit.
1536# sis:  Support for NICs based on the Silicon Integrated Systems SiS 900,
1537#       SiS 7016 and NS DP83815 PCI fast ethernet controller chips.
1538# sk:   Support for the SysKonnect SK-984x series PCI gigabit ethernet NICs.
1539#       This includes the SK-9841 and SK-9842 single port cards (single mode
1540#       and multimode fiber) and the SK-9843 and SK-9844 dual port cards
1541#       (also single mode and multimode).
1542#       The driver will autodetect the number of ports on the card and
1543#       attach each one as a separate network interface.
1544# sn:   Support for ISA and PC Card Ethernet devices using the
1545#       SMC91C90/92/94/95 chips.
1546# ste:  Sundance Technologies ST201 PCI fast ethernet controller, includes
1547#       the D-Link DFE-550TX.
1548# ti:   Support for PCI gigabit ethernet NICs based on the Alteon Networks
1549#       Tigon 1 and Tigon 2 chipsets.  This includes the Alteon AceNIC, the
1550#       3Com 3c985, the Netgear GA620 and various others.  Note that you will
1551#       probably want to bump up NMBCLUSTERS a lot to use this driver.
1552# tl:   Support for the Texas Instruments TNETE100 series 'ThunderLAN'
1553#       cards and integrated ethernet controllers.  This includes several
1554#       Compaq Netelligent 10/100 cards and the built-in ethernet controllers
1555#       in several Compaq Prosignia, Proliant and Deskpro systems.  It also
1556#       supports several Olicom 10Mbps and 10/100 boards.
1557# tx:   SMC 9432 TX, BTX and FTX cards. (SMC EtherPower II serie)
1558# txp:	Support for 3Com 3cR990 cards with the "Typhoon" chipset
1559# vr:   Support for various fast ethernet adapters based on the VIA
1560#       Technologies VT3043 `Rhine I' and VT86C100A `Rhine II' chips,
1561#       including the D-Link DFE530TX (see 'rl' for DFE530TX+), the Hawking
1562#       Technologies PN102TX, and the AOpen/Acer ALN-320.
1563# vx:   3Com 3C590 and 3C595
1564# wb:   Support for fast ethernet adapters based on the Winbond W89C840F chip.
1565#       Note: this is not the same as the Winbond W89C940F, which is a
1566#       NE2000 clone.
1567# wi:   Lucent WaveLAN/IEEE 802.11 PCMCIA adapters. Note: this supports both
1568#       the PCMCIA and ISA cards: the ISA card is really a PCMCIA to ISA
1569#       bridge with a PCMCIA adapter plugged into it.
1570# xe:   Xircom/Intel EtherExpress Pro100/16 PC Card ethernet controller,
1571#       Accton Fast EtherCard-16, Compaq Netelligent 10/100 PC Card,
1572#       Toshiba 10/100 Ethernet PC Card, Xircom 16-bit Ethernet + Modem 56
1573# xl:   Support for the 3Com 3c900, 3c905, 3c905B and 3c905C (Fast)
1574#       Etherlink XL cards and integrated controllers.  This includes the
1575#       integrated 3c905B-TX chips in certain Dell Optiplex and Dell
1576#       Precision desktop machines and the integrated 3c905-TX chips
1577#       in Dell Latitude laptop docking stations.
1578#       Also supported: 3Com 3c980(C)-TX, 3Com 3cSOHO100-TX, 3Com 3c450-TX
1579
1580# Order for ISA/EISA devices is important here
1581
1582device		cm
1583hint.cm.0.at="isa"
1584hint.cm.0.port="0x2e0"
1585hint.cm.0.irq="9"
1586hint.cm.0.maddr="0xdc000"
1587device		cs
1588hint.cs.0.at="isa"
1589hint.cs.0.port="0x300"
1590device		ep
1591device		ex
1592device		fe
1593hint.fe.0.at="isa"
1594hint.fe.0.port="0x300"
1595device		fea
1596device		sn
1597hint.sn.0.at="isa"
1598hint.sn.0.port="0x300"
1599hint.sn.0.irq="10"
1600device		an
1601device		awi
1602device		cnw
1603device		wi
1604device		xe
1605
1606# PCI Ethernet NICs that use the common MII bus controller code.
1607device		dc		# DEC/Intel 21143 and various workalikes
1608device		fxp		# Intel EtherExpress PRO/100B (82557, 82558)
1609hint.fxp.0.prefer_iomap="0"
1610device		my		# Myson Fast Ethernet (MTD80X, MTD89X)
1611device		rl		# RealTek 8129/8139
1612device		pcn		# AMD Am79C97x PCI 10/100 NICs
1613device		sf		# Adaptec AIC-6915 (``Starfire'')
1614device		sis		# Silicon Integrated Systems SiS 900/SiS 7016
1615device		ste		# Sundance ST201 (D-Link DFE-550TX)
1616device		tl		# Texas Instruments ThunderLAN
1617device		tx		# SMC EtherPower II (83c170 ``EPIC'')
1618device		vr		# VIA Rhine, Rhine II
1619device		wb		# Winbond W89C840F
1620device		xl		# 3Com 3c90x (``Boomerang'', ``Cyclone'')
1621
1622# PCI Ethernet NICs.
1623device		de		# DEC/Intel DC21x4x (``Tulip'')
1624device		txp		# 3Com 3cR990 (``Typhoon'')
1625device		vx		# 3Com 3c590, 3c595 (``Vortex'')
1626
1627# PCI Gigabit & FDDI NICs.
1628device		bge
1629device		gx
1630device		lge
1631device		nge
1632device		sk
1633device		ti
1634device		fpa
1635
1636# Use "private" jumbo buffers allocated exclusively for the ti(4) driver.
1637# This option is incompatible with the TI_JUMBO_HDRSPLIT option below.
1638#options 	TI_PRIVATE_JUMBOS
1639# Turn on the header splitting option for the ti(4) driver firmware.  This
1640# only works for Tigon II chips, and has no effect for Tigon I chips.
1641options 	TI_JUMBO_HDRSPLIT
1642
1643# These two options allow manipulating the mbuf cluster size and mbuf size,
1644# respectively.  Be very careful with NIC driver modules when changing
1645# these from their default values, because that can potentially cause a
1646# mismatch between the mbuf size assumed by the kernel and the mbuf size
1647# assumed by a module.  The only driver that currently has the ability to
1648# detect a mismatch is ti(4).
1649options 	MCLSHIFT=12	# mbuf cluster shift in bits, 12 == 4KB
1650options 	MSIZE=512	# mbuf size in bytes
1651
1652#
1653# ATM related options (Cranor version)
1654# (note: this driver cannot be used with the HARP ATM stack)
1655#
1656# The `en' device provides support for Efficient Networks (ENI)
1657# ENI-155 PCI midway cards, and the Adaptec 155Mbps PCI ATM cards (ANA-59x0).
1658#
1659# atm device provides generic atm functions and is required for
1660# atm devices.
1661# NATM enables the netnatm protocol family that can be used to
1662# bypass TCP/IP.
1663#
1664# the current driver supports only PVC operations (no atm-arp, no multicast).
1665# for more details, please read the original documents at
1666# http://www.ccrc.wustl.edu/pub/chuck/tech/bsdatm/bsdatm.html
1667#
1668device		atm
1669device		en
1670options 	NATM			#native ATM
1671
1672#
1673# Audio drivers: `pcm', `sbc', `gusc'
1674#
1675# pcm: PCM audio through various sound cards.
1676#
1677# This has support for a large number of new audio cards, based on
1678# CS423x, OPTi931, Yamaha OPL-SAx, and also for SB16, GusPnP.
1679# For more information about this driver and supported cards,
1680# see the pcm.4 man page.
1681#
1682# The flags of the device tells the device a bit more info about the
1683# device that normally is obtained through the PnP interface.
1684#	bit  2..0   secondary DMA channel;
1685#	bit  4      set if the board uses two dma channels;
1686#	bit 15..8   board type, overrides autodetection; leave it
1687#		    zero if don't know what to put in (and you don't,
1688#		    since this is unsupported at the moment...).
1689#
1690# Supported cards include:
1691# Creative SoundBlaster ISA PnP/non-PnP
1692# Supports ESS and Avance ISA chips as well.
1693# Gravis UltraSound ISA PnP/non-PnP
1694# Crystal Semiconductor CS461x/428x PCI
1695# Neomagic 256AV (ac97)
1696# Most of the more common ISA/PnP sb/mss/ess compatable cards.
1697
1698device		pcm
1699
1700# For non-pnp sound cards with no bridge drivers only:
1701hint.pcm.0.at="isa"
1702hint.pcm.0.irq="10"
1703hint.pcm.0.drq="1"
1704hint.pcm.0.flags="0x0"
1705
1706#
1707# midi: MIDI interfaces and synthesizers
1708#
1709
1710device		midi
1711
1712# For non-pnp sound cards with no bridge drivers:
1713hint.midi.0.at="isa"
1714hint.midi.0.irq="5"
1715hint.midi.0.flags="0x0"
1716
1717# For serial ports (this example configures port 2):
1718# TODO: implement generic tty-midi interface so that we can use
1719#	other uarts.
1720hint.midi.0.at="isa"
1721hint.midi.0.port="0x2F8"
1722hint.midi.0.irq="3"
1723
1724#
1725# seq: MIDI sequencer
1726#
1727
1728device		seq
1729
1730# The bridge drivers for sound cards.  These can be separately configured
1731# for providing services to the likes of new-midi.
1732# When used with 'device pcm' they also provide pcm sound services.
1733#
1734# sbc:  Creative SoundBlaster ISA PnP/non-PnP
1735#	Supports ESS and Avance ISA chips as well.
1736# gusc: Gravis UltraSound ISA PnP/non-PnP
1737# csa:  Crystal Semiconductor CS461x/428x PCI
1738
1739# For non-PnP cards:
1740device		sbc
1741hint.sbc.0.at="isa"
1742hint.sbc.0.port="0x220"
1743hint.sbc.0.irq="5"
1744hint.sbc.0.drq="1"
1745hint.sbc.0.flags="0x15"
1746device		gusc
1747hint.gusc.0.at="isa"
1748hint.gusc.0.port="0x220"
1749hint.gusc.0.irq="5"
1750hint.gusc.0.drq="1"
1751hint.gusc.0.flags="0x13"
1752
1753#
1754# Miscellaneous hardware:
1755#
1756# scd: Sony CD-ROM using proprietary (non-ATAPI) interface
1757# mcd: Mitsumi CD-ROM using proprietary (non-ATAPI) interface
1758# meteor: Matrox Meteor video capture board
1759# bktr: Brooktree bt848/848a/849a/878/879 video capture and TV Tuner board
1760# cy: Cyclades serial driver
1761# joy: joystick (including IO DATA PCJOY PC Card joystick)
1762# rc: RISCom/8 multiport card
1763# rp: Comtrol Rocketport(ISA/PCI) - single card
1764# si: Specialix SI/XIO 4-32 port terminal multiplexor
1765# nmdm: nullmodem terminal driver (see nmdm(4))
1766
1767# Notes on the Comtrol Rocketport driver:
1768#
1769# The exact values used for rp0 depend on how many boards you have
1770# in the system.  The manufacturer's sample configs are listed as:
1771#
1772#               device  rp	# core driver support
1773#
1774#   Comtrol Rocketport ISA single card
1775#		hint.rp.0.at="isa"
1776#		hint.rp.0.port="0x280"
1777#
1778#   If instead you have two ISA cards, one installed at 0x100 and the
1779#   second installed at 0x180, then you should add the following to
1780#   your kernel probe hints:
1781#		hint.rp.0.at="isa"
1782#		hint.rp.0.port="0x100"
1783#		hint.rp.1.at="isa"
1784#		hint.rp.1.port="0x180"
1785#
1786#   For 4 ISA cards, it might be something like this:
1787#		hint.rp.0.at="isa"
1788#		hint.rp.0.port="0x180"
1789#		hint.rp.1.at="isa"
1790#		hint.rp.1.port="0x100"
1791#		hint.rp.2.at="isa"
1792#		hint.rp.2.port="0x340"
1793#		hint.rp.3.at="isa"
1794#		hint.rp.3.port="0x240"
1795#
1796#   For PCI cards, you need no hints.
1797
1798# Mitsumi CD-ROM
1799device		mcd
1800hint.mcd.0.at="isa"
1801hint.mcd.0.port="0x300"
1802# for the Sony CDU31/33A CDROM
1803device		scd
1804hint.scd.0.at="isa"
1805hint.scd.0.port="0x230"
1806device		joy			# PnP aware, hints for nonpnp only
1807hint.joy.0.at="isa"
1808hint.joy.0.port="0x201"
1809device		rc
1810hint.rc.0.at="isa"
1811hint.rc.0.port="0x220"
1812hint.rc.0.irq="12"
1813device		rp
1814hint.rp.0.at="isa"
1815hint.rp.0.port="0x280"
1816device		si
1817options 	SI_DEBUG
1818hint.si.0.at="isa"
1819hint.si.0.maddr="0xd0000"
1820hint.si.0.irq="12"
1821device		nmdm
1822
1823#
1824# The `meteor' device is a PCI video capture board. It can also have the
1825# following options:
1826#   options METEOR_ALLOC_PAGES=xxx	preallocate kernel pages for data entry
1827#	figure (ROWS*COLUMN*BYTES_PER_PIXEL*FRAME+PAGE_SIZE-1)/PAGE_SIZE
1828#   options METEOR_DEALLOC_PAGES	remove all allocated pages on close(2)
1829#   options METEOR_DEALLOC_ABOVE=xxx	remove all allocated pages above the
1830#	specified amount. If this value is below the allocated amount no action
1831#	taken
1832#   options METEOR_SYSTEM_DEFAULT={METEOR_PAL|METEOR_NTSC|METEOR_SECAM}, used
1833#	for initialization of fps routine when a signal is not present.
1834#
1835# The 'bktr' device is a PCI video capture device using the Brooktree
1836# bt848/bt848a/bt849a/bt878/bt879 chipset. When used with a TV Tuner it forms a
1837# TV card, eg Miro PC/TV, Hauppauge WinCast/TV WinTV, VideoLogic Captivator,
1838# Intel Smart Video III, AverMedia, IMS Turbo, FlyVideo.
1839#
1840# options 	OVERRIDE_CARD=xxx
1841# options 	OVERRIDE_TUNER=xxx
1842# options 	OVERRIDE_MSP=1
1843# options 	OVERRIDE_DBX=1
1844# These options can be used to override the auto detection
1845# The current values for xxx are found in src/sys/dev/bktr/bktr_card.h
1846# Using sysctl(8) run-time overrides on a per-card basis can be made
1847#
1848# options 	BROOKTREE_SYSTEM_DEFAULT=BROOKTREE_PAL
1849# or
1850# options 	BROOKTREE_SYSTEM_DEFAULT=BROOKTREE_NTSC
1851# Specifes the default video capture mode.
1852# This is required for Dual Crystal (28&35Mhz) boards where PAL is used
1853# to prevent hangs during initialisation.  eg VideoLogic Captivator PCI.
1854#
1855# options 	BKTR_USE_PLL
1856# PAL or SECAM users who have a 28Mhz crystal (and no 35Mhz crystal)
1857# must enable PLL mode with this option. eg some new Bt878 cards.
1858#
1859# options 	BKTR_GPIO_ACCESS
1860# This enable IOCTLs which give user level access to the GPIO port.
1861#
1862# options 	BKTR_NO_MSP_RESET
1863# Prevents the MSP34xx reset. Good if you initialise the MSP in another OS first
1864#
1865# options 	BKTR_430_FX_MODE
1866# Switch Bt878/879 cards into Intel 430FX chipset compatibility mode.
1867#
1868# options 	BKTR_SIS_VIA_MODE
1869# Switch Bt878/879 cards into SIS/VIA chipset compatibility mode which is
1870# needed for some old SiS and VIA chipset motherboards.
1871# This also allows Bt878/879 chips to work on old OPTi (<1997) chipset
1872# motherboards and motherboards with bad or incomplete PCI 2.1 support.
1873# As a rough guess, old = before 1998
1874#
1875
1876device		meteor	1
1877
1878#
1879# options	BKTR_USE_FREEBSD_SMBUS
1880# Compile with FreeBSD SMBus implementation
1881#
1882# Brooktree driver has been ported to the new I2C framework. Thus,
1883# you'll need to have the following 3 lines in the kernel config.
1884#     device smbus
1885#     device iicbus
1886#     device iicbb
1887#     device iicsmb
1888# The iic and smb devices are only needed if you want to control other
1889# I2C slaves connected to the external connector of some cards.
1890#
1891device		bktr
1892
1893#
1894# PC Card/PCMCIA
1895# (OLDCARD)
1896#
1897# card: pccard slots
1898# pcic: isa/pccard bridge
1899#device		pcic
1900#hint.pcic.0.at="isa"
1901#hint.pcic.1.at="isa"
1902#device		card	1
1903
1904#
1905# PC Card/PCMCIA and Cardbus
1906# (NEWCARD)
1907#
1908# Note that NEWCARD and OLDCARD are incompatible.  Do not use both at the same
1909# time.
1910#
1911# pccbb: pci/cardbus bridge implementing YENTA interface
1912# pccard: pccard slots
1913# cardbus: cardbus slots
1914device		cbb
1915device		pccard
1916device		cardbus
1917#device		pcic		ISA attachment currently busted
1918#hint.pcic.0.at="isa"
1919#hint.pcic.1.at="isa"
1920
1921#
1922# SMB bus
1923#
1924# System Management Bus support is provided by the 'smbus' device.
1925# Access to the SMBus device is via the 'smb' device (/dev/smb*),
1926# which is a child of the 'smbus' device.
1927#
1928# Supported devices:
1929# smb		standard io through /dev/smb*
1930#
1931# Supported SMB interfaces:
1932# iicsmb	I2C to SMB bridge with any iicbus interface
1933# bktr		brooktree848 I2C hardware interface
1934# intpm		Intel PIIX4 (82371AB, 82443MX) Power Management Unit
1935# alpm		Acer Aladdin-IV/V/Pro2 Power Management Unit
1936# ichsmb	Intel ICH SMBus controller chips (82801AA, 82801AB, 82801BA)
1937# viapm		VIA VT82C586B/596B/686A and VT8233 Power Management Unit
1938# amdpm		AMD 756 Power Management Unit
1939# nfpm		NVIDIA nForce Power Management Unit
1940#
1941device		smbus		# Bus support, required for smb below.
1942
1943device		intpm
1944device		alpm
1945device		ichsmb
1946device		viapm
1947device		amdpm
1948device		nfpm
1949
1950device		smb
1951
1952#
1953# I2C Bus
1954#
1955# Philips i2c bus support is provided by the `iicbus' device.
1956#
1957# Supported devices:
1958# ic	i2c network interface
1959# iic	i2c standard io
1960# iicsmb i2c to smb bridge. Allow i2c i/o with smb commands.
1961#
1962# Supported interfaces:
1963# bktr	brooktree848 I2C software interface
1964#
1965# Other:
1966# iicbb	generic I2C bit-banging code (needed by lpbb, bktr)
1967#
1968device		iicbus		# Bus support, required for ic/iic/iicsmb below.
1969device		iicbb
1970
1971device		ic
1972device		iic
1973device		iicsmb		# smb over i2c bridge
1974
1975# Parallel-Port Bus
1976#
1977# Parallel port bus support is provided by the `ppbus' device.
1978# Multiple devices may be attached to the parallel port, devices
1979# are automatically probed and attached when found.
1980#
1981# Supported devices:
1982# vpo	Iomega Zip Drive
1983#	Requires SCSI disk support ('scbus' and 'da'), best
1984#	performance is achieved with ports in EPP 1.9 mode.
1985# lpt	Parallel Printer
1986# plip	Parallel network interface
1987# ppi	General-purpose I/O ("Geek Port") + IEEE1284 I/O
1988# pps	Pulse per second Timing Interface
1989# lpbb	Philips official parallel port I2C bit-banging interface
1990#
1991# Supported interfaces:
1992# ppc	ISA-bus parallel port interfaces.
1993#
1994
1995options 	PPC_PROBE_CHIPSET # Enable chipset specific detection
1996				  # (see flags in ppc(4))
1997options 	DEBUG_1284	# IEEE1284 signaling protocol debug
1998options 	PERIPH_1284	# Makes your computer act as an IEEE1284
1999				# compliant peripheral
2000options 	DONTPROBE_1284	# Avoid boot detection of PnP parallel devices
2001options 	VP0_DEBUG	# ZIP/ZIP+ debug
2002options 	LPT_DEBUG	# Printer driver debug
2003options 	PPC_DEBUG	# Parallel chipset level debug
2004options 	PLIP_DEBUG	# Parallel network IP interface debug
2005options 	PCFCLOCK_VERBOSE         # Verbose pcfclock driver
2006options 	PCFCLOCK_MAX_RETRIES=5   # Maximum read tries (default 10)
2007
2008device		ppc
2009hint.ppc.0.at="isa"
2010hint.ppc.0.irq="7"
2011device		ppbus
2012device		vpo
2013device		lpt
2014device		plip
2015device		ppi
2016device		pps
2017device		lpbb
2018device		pcfclock
2019
2020# Kernel BOOTP support
2021
2022options 	BOOTP		# Use BOOTP to obtain IP address/hostname
2023				# Requires NFSCLIENT and NFS_ROOT
2024options 	BOOTP_NFSROOT	# NFS mount root filesystem using BOOTP info
2025options 	BOOTP_NFSV3	# Use NFS v3 to NFS mount root
2026options 	BOOTP_COMPAT	# Workaround for broken bootp daemons.
2027options 	BOOTP_WIRED_TO=fxp0 # Use interface fxp0 for BOOTP
2028
2029#
2030# Add tie-ins for a hardware watchdog.  This only enable the hooks;
2031# the user must still supply the actual driver.
2032#
2033options 	HW_WDOG
2034
2035#
2036# Disable swapping. This option removes all code which actually performs
2037# swapping, so it's not possible to turn it back on at run-time.
2038#
2039# This is sometimes usable for systems which don't have any swap space
2040# (see also sysctls "vm.defer_swapspace_pageouts" and
2041# "vm.disable_swapspace_pageouts")
2042#
2043#options 	NO_SWAPPING
2044
2045# Set the number of sf_bufs to allocate. sf_bufs are virtual buffers
2046# for sendfile(2) that are used to map file VM pages, and normally
2047# default to a quantity that is roughly 16*MAXUSERS+512. You would
2048# typically want about 4 of these for each simultaneous file send.
2049#
2050options 	NSFBUFS=1024
2051
2052#
2053# Enable extra debugging code for locks.  This stores the filename and
2054# line of whatever acquired the lock in the lock itself, and change a
2055# number of function calls to pass around the relevant data.  This is
2056# not at all useful unless you are debugging lock code.  Also note
2057# that it is likely to break e.g. fstat(1) unless you recompile your
2058# userland with -DDEBUG_LOCKS as well.
2059#
2060options 	DEBUG_LOCKS
2061
2062
2063#####################################################################
2064# USB support
2065# UHCI controller
2066device		uhci
2067# OHCI controller
2068device		ohci
2069# General USB code (mandatory for USB)
2070device		usb
2071#
2072# USB Double Bulk Pipe devices
2073device		udbp
2074# Generic USB device driver
2075device		ugen
2076# Human Interface Device (anything with buttons and dials)
2077device		uhid
2078# USB keyboard
2079device		ukbd
2080# USB printer
2081device		ulpt
2082# USB Iomega Zip 100 Drive (Requires scbus and da)
2083device		umass
2084# USB modem support
2085device		umodem
2086# USB mouse
2087device		ums
2088# Diamond Rio 500 Mp3 player
2089device		urio
2090# USB scanners
2091device		uscanner
2092# USB serial support
2093device		ucom
2094# USB support for serial adapters based on the FT8U100AX and FT8U232AM
2095device		uftdi
2096# USB support for Prolific PL-2303 serial adapters
2097device		uplcom
2098# USB support for Belkin F5U103 and compatible serial adapters
2099device		ubsa
2100# USB serial support for DDI pocket's PHS
2101device		uvscom
2102# USB Visor and Palm devices
2103device		uvisor
2104
2105# USB Fm Radio
2106device		ufm
2107#
2108# ADMtek USB ethernet. Supports the LinkSys USB100TX,
2109# the Billionton USB100, the Melco LU-ATX, the D-Link DSB-650TX
2110# and the SMC 2202USB. Also works with the ADMtek AN986 Pegasus
2111# eval board.
2112device		aue
2113#
2114# CATC USB-EL1201A USB ethernet. Supports the CATC Netmate
2115# and Netmate II, and the Belkin F5U111.
2116device		cue
2117#
2118# Kawasaki LSI ethernet. Supports the LinkSys USB10T,
2119# Entrega USB-NET-E45, Peracom Ethernet Adapter, the
2120# 3Com 3c19250, the ADS Technologies USB-10BT, the ATen UC10T,
2121# the Netgear EA101, the D-Link DSB-650, the SMC 2102USB
2122# and 2104USB, and the Corega USB-T.
2123device		kue
2124
2125# debugging options for the USB subsystem
2126#
2127options 	USB_DEBUG
2128
2129# options for ukbd:
2130options 	UKBD_DFLT_KEYMAP	# specify the built-in keymap
2131makeoptions	UKBD_DFLT_KEYMAP=it.iso
2132
2133#####################################################################
2134# Firewire support
2135
2136device		firewire	# Firewire bus code
2137device		sbp		# SCSI over Firewire (Requires scbus and da)
2138device		fwe		# Ethernet over Firewire (non-standard!)
2139
2140#####################################################################
2141# crypto subsystem
2142#
2143# This is a port of the openbsd crypto framework.  Include this when
2144# configuring FAST_IPSEC and when you have a h/w crypto device to accelerate
2145# user applications that link to openssl.
2146#
2147# Drivers are ports from openbsd with some simple enhancements that have
2148# been fed back to openbsd.
2149
2150device		crypto		# core crypto support
2151device		cryptodev	# /dev/crypto for access to h/w
2152
2153device		hifn		# Hifn 7951, 7781, etc.
2154device		ubsec		# Broadcom 5501, 5601, 58xx
2155
2156#####################################################################
2157
2158
2159#
2160# Embedded system options:
2161#
2162# An embedded system might want to run something other than init.
2163options 	INIT_PATH=/sbin/init:/stand/sysinstall
2164
2165# Debug options
2166options 	BUS_DEBUG	# enable newbus debugging
2167options 	DEBUG_VFS_LOCKS	# enable vfs lock debugging
2168
2169#####################################################################
2170# SYSV IPC KERNEL PARAMETERS
2171#
2172# Maximum number of entries in a semaphore map.
2173options 	SEMMAP=31
2174
2175# Maximum number of System V semaphores that can be used on the system at
2176# one time.
2177options 	SEMMNI=11
2178
2179# Total number of semaphores system wide
2180options 	SEMMNS=61
2181
2182# Total number of undo structures in system
2183options 	SEMMNU=31
2184
2185# Maximum number of System V semaphores that can be used by a single process
2186# at one time.
2187options 	SEMMSL=61
2188
2189# Maximum number of operations that can be outstanding on a single System V
2190# semaphore at one time.
2191options 	SEMOPM=101
2192
2193# Maximum number of undo operations that can be outstanding on a single
2194# System V semaphore at one time.
2195options 	SEMUME=11
2196
2197# Maximum number of shared memory pages system wide.
2198options 	SHMALL=1025
2199
2200# Maximum size, in bytes, of a single System V shared memory region.
2201options 	SHMMAX=(SHMMAXPGS*PAGE_SIZE+1)
2202options 	SHMMAXPGS=1025
2203
2204# Minimum size, in bytes, of a single System V shared memory region.
2205options 	SHMMIN=2
2206
2207# Maximum number of shared memory regions that can be used on the system
2208# at one time.
2209options 	SHMMNI=33
2210
2211# Maximum number of System V shared memory regions that can be attached to
2212# a single process at one time.
2213options 	SHMSEG=9
2214
2215# Set the amount of time (in seconds) the system will wait before
2216# rebooting automatically when a kernel panic occurs.  If set to (-1),
2217# the system will wait indefinitely until a key is pressed on the
2218# console.
2219options 	PANIC_REBOOT_WAIT_TIME=16
2220
2221#####################################################################
2222
2223# More undocumented options for linting.
2224# Note that documenting these are not considered an affront.
2225
2226options 	CAM_DEBUG_DELAY
2227
2228# VFS cluster debugging.
2229options 	CLUSTERDEBUG
2230
2231options 	DEBUG
2232
2233# Kernel filelock debugging.
2234options 	LOCKF_DEBUG
2235
2236# System V compatible message queues
2237# Please note that the values provided here are used to test kernel
2238# building.  The defaults in the sources provide almost the same numbers.
2239# MSGSSZ must be a power of 2 between 8 and 1024.
2240options 	MSGMNB=2049	# Max number of chars in queue
2241options 	MSGMNI=41	# Max number of message queue identifiers
2242options 	MSGSEG=2049	# Max number of message segments
2243options 	MSGSSZ=16	# Size of a message segment
2244options 	MSGTQL=41	# Max number of messages in system
2245
2246options 	NBUF=512	# Number of buffer headers
2247
2248options 	NMBCLUSTERS=1024	# Number of mbuf clusters
2249
2250options 	SCSI_NCR_DEBUG
2251options 	SCSI_NCR_MAX_SYNC=10000
2252options 	SCSI_NCR_MAX_WIDE=1
2253options 	SCSI_NCR_MYADDR=7
2254
2255options 	SC_DEBUG_LEVEL=5	# Syscons debug level
2256options 	SC_RENDER_DEBUG	# syscons rendering debugging
2257
2258options 	SHOW_BUSYBUFS	# List buffers that prevent root unmount
2259options 	SLIP_IFF_OPTS
2260options 	VFS_BIO_DEBUG	# VFS buffer I/O debugging
2261
2262options		KSTACK_MAX_PAGES=32 # Maximum pages to give the kernel stack
2263
2264# Yet more undocumented options for linting.
2265options 	AAC_DEBUG
2266options 	ACD_DEBUG
2267options 	ACPI_MAX_THREADS=1
2268#!options 	ACPI_NO_SEMAPHORES
2269# Broken:
2270##options 	ASR_MEASURE_PERFORMANCE
2271options 	AST_DEBUG
2272options 	ATAPI_DEBUG
2273options 	ATA_DEBUG
2274# BKTR_ALLOC_PAGES has no effect except to cause warnings, and
2275# BROOKTREE_ALLOC_PAGES hasn't actually been superseded by it, since the
2276# driver still mostly spells this option BROOKTREE_ALLOC_PAGES.
2277##options 	BKTR_ALLOC_PAGES=(217*4+1)
2278options 	BROOKTREE_ALLOC_PAGES=(217*4+1)
2279options 	MAXFILES=999
2280# METEOR_TEST_VIDEO has no effect since meteor is broken.
2281options 	METEOR_TEST_VIDEO
2282options 	NDEVFSINO=1025
2283options 	NDEVFSOVERFLOW=32769
2284
2285# Yet more undocumented options for linting.
2286options 	VGA_DEBUG
2287