NOTES revision 172249
195158Sjmallett# $FreeBSD: head/sys/conf/NOTES 172249 2007-09-19 18:12:44Z imp $
295158Sjmallett#
398442Sjmallett# NOTES -- Lines that can be cut/pasted into kernel and hints configs.
4107374Sru#
598442Sjmallett# Lines that begin with 'device', 'options', 'machine', 'ident', 'maxusers',
698442Sjmallett# 'makeoptions', 'hints', etc. go into the kernel configuration that you
798442Sjmallett# run config(8) with.
898442Sjmallett#
998442Sjmallett# Lines that begin with 'hint.' are NOT for config(8), they go into your
1098442Sjmallett# hints file.  See /boot/device.hints and/or the 'hints' config(8) directive.
1195158Sjmallett#
1295158Sjmallett# Please use ``make LINT'' to create an old-style LINT file if you want to
1395158Sjmallett# do kernel test-builds.
1495158Sjmallett#
1595158Sjmallett# This file contains machine independent kernel configuration notes.  For
1695158Sjmallett# machine dependent notes, look in /sys/<arch>/conf/NOTES.
1795158Sjmallett#
1895158Sjmallett
1996070Sjmallett#
2095158Sjmallett# NOTES conventions and style guide:
2195158Sjmallett#
2295158Sjmallett# Large block comments should begin and end with a line containing only a
2395158Sjmallett# comment character.
2495158Sjmallett#
2595538Sjmallett# To describe a particular object, a block comment (if it exists) should
2695167Sjmallett# come first.  Next should come device, options, and hints lines in that
27110654Sgad# order.  All device and option lines must be described by a comment that
2895538Sjmallett# doesn't just expand the device or option name.  Use only a concise
2996070Sjmallett# comment on the same line if possible.  Very detailed descriptions of
3096070Sjmallett# devices and subsystems belong in man pages.
3196070Sjmallett#
3298442Sjmallett# A space followed by a tab separates 'options' from an option name.  Two
3398461Sjmallett# spaces followed by a tab separate 'device' from a device name.  Comments
3498442Sjmallett# after an option or device should use one space after the comment character.
35107374Sru# To comment out a negative option that disables code and thus should not be
36107374Sru# enabled for LINT builds, precede 'options' with "#!".
37107374Sru#
38107374Sru
39107374Sru#
40107374Sru# This is the ``identification'' of the kernel.  Usually this should
41107375Sru# be the same as the name of your kernel.
42107375Sru#
43107375Sruident		LINT
44117226Sru
45117226Sru#
46117226Sru# The `maxusers' parameter controls the static sizing of a number of
47120676Sru# internal system tables by a formula defined in subr_param.c.
48120676Sru# Omitting this parameter or setting it to 0 will cause the system to
49120676Sru# auto-size based on physical memory.
5095158Sjmallett#
51105907Sjmallettmaxusers	10
52100794Sjmallett
53100794Sjmallett#
54100794Sjmallett# The `makeoptions' parameter allows variables to be passed to the
5595167Sjmallett# generated Makefile in the build area.
5695167Sjmallett#
5795167Sjmallett# CONF_CFLAGS gives some extra compiler flags that are added to ${CFLAGS}
5895167Sjmallett# after most other flags.  Here we use it to inhibit use of non-optimal
5995167Sjmallett# gcc built-in functions (e.g., memcmp).
60105907Sjmallett#
6195167Sjmallett# DEBUG happens to be magic.
62105907Sjmallett# The following is equivalent to 'config -g KERNELNAME' and creates
6396070Sjmallett# 'kernel.debug' compiled with -g debugging as well as a normal
6496070Sjmallett# 'kernel'.  Use 'make install.debug' to install the debug kernel
6596070Sjmallett# but that isn't normally necessary as the debug symbols are not loaded
6696070Sjmallett# by the kernel and are not useful there anyway.
67105907Sjmallett#
6896070Sjmallett# KERNEL can be overridden so that you can change the default name of your
6998442Sjmallett# kernel.
7098442Sjmallett#
7198442Sjmallett# MODULES_OVERRIDE can be used to limit modules built to a specific list.
7298442Sjmallett#
7398461Sjmallettmakeoptions	CONF_CFLAGS=-fno-builtin  #Don't allow use of memcmp, etc.
7498442Sjmallett#makeoptions	DEBUG=-g		#Build kernel with gdb(1) debug symbols
75107374Sru#makeoptions	KERNEL=foo		#Build kernel "foo" and install "/foo"
76107374Sru# Only build ext2fs module plus those parts of the sound system I need.
77107374Sru#makeoptions	MODULES_OVERRIDE="ext2fs sound/sound sound/driver/maestro3"
78107374Srumakeoptions	DESTDIR=/tmp
79107374Sru
80107374Sru#
81107374Sru# FreeBSD processes are subject to certain limits to their consumption
82107374Sru# of system resources.  See getrlimit(2) for more details.  Each
83107374Sru# resource limit has two values, a "soft" limit and a "hard" limit.
84107374Sru# The soft limits can be modified during normal system operation, but
85107374Sru# the hard limits are set at boot time.  Their default values are
86107374Sru# in sys/<arch>/include/vmparam.h.  There are two ways to change them:
87107374Sru# 
88107374Sru# 1.  Set the values at kernel build time.  The options below are one
89107374Sru#     way to allow that limit to grow to 1GB.  They can be increased
90107374Sru#     further by changing the parameters:
91107374Sru#	
92107374Sru# 2.  In /boot/loader.conf, set the tunables kern.maxswzone,
93107375Sru#     kern.maxbcache, kern.maxtsiz, kern.dfldsiz, kern.maxdsiz,
94107375Sru#     kern.dflssiz, kern.maxssiz and kern.sgrowsiz.
95107375Sru#
96107375Sru# The options in /boot/loader.conf override anything in the kernel
97107375Sru# configuration file.  See the function init_param1 in
98107375Sru# sys/kern/subr_param.c for more details.
99117226Sru#
100117226Sru
101117226Sruoptions 	MAXDSIZ=(1024UL*1024*1024)
102117226Sruoptions 	MAXSSIZ=(128UL*1024*1024)
103117226Sruoptions 	DFLDSIZ=(1024UL*1024*1024)
104117226Sru
105117226Sru#
106117226Sru# BLKDEV_IOSIZE sets the default block size used in user block
107117226Sru# device I/O.  Note that this value will be overridden by the label
108120676Sru# when specifying a block device from a label with a non-0
109120676Sru# partition blocksize.  The default is PAGE_SIZE.
110120676Sru#
111120676Sruoptions 	BLKDEV_IOSIZE=8192
112120676Sru
113120676Sru#
114120676Sru# MAXPHYS and DFLTPHYS
115120676Sru#
11695158Sjmallett# These are the max and default 'raw' I/O block device access sizes.
11795538Sjmallett# Reads and writes will be split into DFLTPHYS chunks. Some applications
11895158Sjmallett# have better performance with larger raw I/O access sizes. Typically
119# MAXPHYS should be twice the size of DFLTPHYS. Note that certain VM
120# parameters are derived from these values and making them too large
121# can make an an unbootable kernel.
122#
123# The defaults are 64K and 128K respectively.
124options 	DFLTPHYS=(64*1024)
125options 	MAXPHYS=(128*1024)
126
127
128# This allows you to actually store this configuration file into
129# the kernel binary itself, where it may be later read by saying:
130#    strings -n 3 /boot/kernel/kernel | sed -n 's/^___//p' > MYKERNEL
131#
132options 	INCLUDE_CONFIG_FILE     # Include this file in kernel
133
134options 	GEOM_AES		# Don't use, use GEOM_BDE
135options 	GEOM_BDE		# Disk encryption.
136options 	GEOM_BSD		# BSD disklabels
137options 	GEOM_CACHE		# Disk cache.
138options 	GEOM_CONCAT		# Disk concatenation.
139options 	GEOM_ELI		# Disk encryption.
140options 	GEOM_FOX		# Redundant path mitigation
141options 	GEOM_GATE		# Userland services.
142options 	GEOM_JOURNAL		# Journaling.
143options 	GEOM_LABEL		# Providers labelization.
144options 	GEOM_MBR		# DOS/MBR partitioning
145options 	GEOM_MIRROR		# Disk mirroring.
146options 	GEOM_MULTIPATH		# Disk multipath
147options 	GEOM_NOP		# Test class.
148options 	GEOM_PART_APM		# Apple partitioning
149options 	GEOM_PART_GPT		# GPT partitioning
150options 	GEOM_PART_MBR		# MBR partitioning
151options 	GEOM_PC98		# NEC PC9800 partitioning
152options 	GEOM_RAID3		# RAID3 functionality.
153options 	GEOM_SHSEC		# Shared secret.
154options 	GEOM_STRIPE		# Disk striping.
155options 	GEOM_SUNLABEL		# Sun/Solaris partitioning
156options 	GEOM_UZIP		# Read-only compressed disks
157options 	GEOM_VOL		# Volume names from UFS superblock
158options 	GEOM_ZERO		# Performance testing helper.
159
160#
161# The root device and filesystem type can be compiled in;
162# this provides a fallback option if the root device cannot
163# be correctly guessed by the bootstrap code, or an override if
164# the RB_DFLTROOT flag (-r) is specified when booting the kernel.
165#
166options 	ROOTDEVNAME=\"ufs:da0s2e\"
167
168
169#####################################################################
170# Scheduler options:
171#
172# Specifying one of SCHED_4BSD or SCHED_ULE is mandatory.  These options
173# select which scheduler is compiled in.
174#
175# SCHED_4BSD is the historical, proven, BSD scheduler.  It has a global run
176# queue and no CPU affinity which makes it suboptimal for SMP.  It has very
177# good interactivity and priority selection.
178#
179# SCHED_ULE provides significant performance advantages over 4BSD on many
180# workloads on SMP machines.  It supports cpu-affinity, per-cpu runqueues
181# and scheduler locks.  It also has a stronger notion of interactivity 
182# which leads to better responsiveness even on uniprocessor machines.  This
183# will eventually become the default scheduler.
184#
185options 	SCHED_4BSD
186#options 	SCHED_ULE
187
188#####################################################################
189# SMP OPTIONS:
190#
191# SMP enables building of a Symmetric MultiProcessor Kernel.
192
193# Mandatory:
194options 	SMP			# Symmetric MultiProcessor Kernel
195
196# ADAPTIVE_MUTEXES changes the behavior of blocking mutexes to spin
197# if the thread that currently owns the mutex is executing on another
198# CPU.  This behaviour is enabled by default, so this option can be used
199# to disable it.
200options 	NO_ADAPTIVE_MUTEXES
201
202# ADAPTIVE_RWLOCKS changes the behavior of reader/writer locks to spin
203# if the thread that currently owns the rwlock is executing on another
204# CPU.  This behaviour is enabled by default, so this option can be used
205# to disable it.
206options 	NO_ADAPTIVE_RWLOCKS
207
208# ADAPTIVE_GIANT causes the Giant lock to also be made adaptive when
209# running without NO_ADAPTIVE_MUTEXES.  Normally, because Giant is assumed
210# to be held for extended periods, contention on Giant will cause a thread
211# to sleep rather than spinning.
212options 	ADAPTIVE_GIANT
213
214# ADAPTIVE_SX changes the behavior of sx locks to spin if the thread
215# that currently owns the lock is executing on another CPU.  Note that
216# in addition to enabling this option, individual sx locks must be
217# initialized with the SX_ADAPTIVESPIN flag.
218options 	ADAPTIVE_SX
219
220# MUTEX_NOINLINE forces mutex operations to call functions to perform each
221# operation rather than inlining the simple cases.  This can be used to
222# shrink the size of the kernel text segment.  Note that this behavior is
223# already implied by the INVARIANT_SUPPORT, INVARIANTS, KTR, LOCK_PROFILING,
224# and WITNESS options.
225options 	MUTEX_NOINLINE
226
227# RWLOCK_NOINLINE forces rwlock operations to call functions to perform each
228# operation rather than inlining the simple cases.  This can be used to
229# shrink the size of the kernel text segment.  Note that this behavior is
230# already implied by the INVARIANT_SUPPORT, INVARIANTS, KTR, LOCK_PROFILING,
231# and WITNESS options.
232options 	RWLOCK_NOINLINE
233
234# SX_NOINLINE forces sx lock operations to call functions to perform each
235# operation rather than inlining the simple cases.  This can be used to
236# shrink the size of the kernel text segment.  Note that this behavior is
237# already implied by the INVARIANT_SUPPORT, INVARIANTS, KTR, LOCK_PROFILING,
238# and WITNESS options.
239options 	SX_NOINLINE
240
241# SMP Debugging Options:
242#
243# PREEMPTION allows the threads that are in the kernel to be preempted
244#	  by higher priority threads.  It helps with interactivity and
245#	  allows interrupt threads to run sooner rather than waiting.
246#	  WARNING! Only tested on amd64 and i386.
247# FULL_PREEMPTION instructs the kernel to preempt non-realtime kernel
248#	  threads.  Its sole use is to expose race conditions and other
249#	  bugs during development.  Enabling this option will reduce
250#	  performance and increase the frequency of kernel panics by
251#	  design.  If you aren't sure that you need it then you don't.
252#	  Relies on the PREEMPTION option.  DON'T TURN THIS ON.
253# MUTEX_DEBUG enables various extra assertions in the mutex code.
254# SLEEPQUEUE_PROFILING enables rudimentary profiling of the hash table
255#	  used to hold active sleep queues.
256# TURNSTILE_PROFILING enables rudimentary profiling of the hash table
257#	  used to hold active lock queues.
258# WITNESS enables the witness code which detects deadlocks and cycles
259#         during locking operations.
260# WITNESS_KDB causes the witness code to drop into the kernel debugger if
261#	  a lock hierarchy violation occurs or if locks are held when going to
262#	  sleep.
263# WITNESS_SKIPSPIN disables the witness checks on spin mutexes.
264options 	PREEMPTION
265options 	FULL_PREEMPTION
266options 	MUTEX_DEBUG
267options 	WITNESS
268options 	WITNESS_KDB
269options 	WITNESS_SKIPSPIN
270
271# LOCK_PROFILING - Profiling locks.  See LOCK_PROFILING(9) for details.
272options 	LOCK_PROFILING
273# Set the number of buffers and the hash size.  The hash size MUST be larger
274# than the number of buffers.  Hash size should be prime.
275options 	MPROF_BUFFERS="1536"
276options 	MPROF_HASH_SIZE="1543"
277
278# Profiling for internal hash tables.
279options 	SLEEPQUEUE_PROFILING
280options 	TURNSTILE_PROFILING
281
282
283#####################################################################
284# COMPATIBILITY OPTIONS
285
286#
287# Implement system calls compatible with 4.3BSD and older versions of
288# FreeBSD.  You probably do NOT want to remove this as much current code
289# still relies on the 4.3 emulation.  Note that some architectures that
290# are supported by FreeBSD do not include support for certain important
291# aspects of this compatibility option, namely those related to the
292# signal delivery mechanism.
293#
294options 	COMPAT_43
295
296# Old tty interface.
297options 	COMPAT_43TTY
298
299# Enable FreeBSD4 compatibility syscalls
300options 	COMPAT_FREEBSD4
301
302# Enable FreeBSD5 compatibility syscalls
303options 	COMPAT_FREEBSD5
304
305# Enable FreeBSD6 compatibility syscalls
306options 	COMPAT_FREEBSD6
307
308#
309# These three options provide support for System V Interface
310# Definition-style interprocess communication, in the form of shared
311# memory, semaphores, and message queues, respectively.
312#
313options 	SYSVSHM
314options 	SYSVSEM
315options 	SYSVMSG
316
317
318#####################################################################
319# DEBUGGING OPTIONS
320
321#
322# Compile with kernel debugger related code.
323#
324options 	KDB
325
326#
327# Print a stack trace of the current thread on the console for a panic.
328#
329options 	KDB_TRACE
330
331#
332# Don't enter the debugger for a panic. Intended for unattended operation
333# where you may want to enter the debugger from the console, but still want
334# the machine to recover from a panic.
335#
336options 	KDB_UNATTENDED
337
338#
339# Enable the ddb debugger backend.
340#
341options 	DDB
342
343#
344# Print the numerical value of symbols in addition to the symbolic
345# representation.
346#
347options 	DDB_NUMSYM
348
349#
350# Enable the remote gdb debugger backend.
351#
352options 	GDB
353
354#
355# SYSCTL_DEBUG enables a 'sysctl' debug tree that can be used to dump the
356# contents of the registered sysctl nodes on the console.  It is disabled by
357# default because it generates excessively verbose console output that can
358# interfere with serial console operation.
359#
360options 	SYSCTL_DEBUG
361
362#
363# DEBUG_MEMGUARD builds and enables memguard(9), a replacement allocator
364# for the kernel used to detect modify-after-free scenarios.  See the
365# memguard(9) man page for more information on usage.
366#
367options 	DEBUG_MEMGUARD
368
369#
370# DEBUG_REDZONE enables buffer underflows and buffer overflows detection for
371# malloc(9).
372#
373options 	DEBUG_REDZONE
374
375#
376# KTRACE enables the system-call tracing facility ktrace(2).  To be more
377# SMP-friendly, KTRACE uses a worker thread to process most trace events
378# asynchronously to the thread generating the event.  This requires a
379# pre-allocated store of objects representing trace events.  The
380# KTRACE_REQUEST_POOL option specifies the initial size of this store.
381# The size of the pool can be adjusted both at boottime and runtime via
382# the kern.ktrace_request_pool tunable and sysctl.
383#
384options 	KTRACE			#kernel tracing
385options 	KTRACE_REQUEST_POOL=101
386
387#
388# KTR is a kernel tracing mechanism imported from BSD/OS.  Currently
389# it has no userland interface aside from a few sysctl's.  It is
390# enabled with the KTR option.  KTR_ENTRIES defines the number of
391# entries in the circular trace buffer; it must be a power of two.
392# KTR_COMPILE defines the mask of events to compile into the kernel as
393# defined by the KTR_* constants in <sys/ktr.h>.  KTR_MASK defines the
394# initial value of the ktr_mask variable which determines at runtime
395# what events to trace.  KTR_CPUMASK determines which CPU's log
396# events, with bit X corresponding to CPU X.  KTR_VERBOSE enables
397# dumping of KTR events to the console by default.  This functionality
398# can be toggled via the debug.ktr_verbose sysctl and defaults to off
399# if KTR_VERBOSE is not defined.
400#
401options 	KTR
402options 	KTR_ENTRIES=1024
403options 	KTR_COMPILE=(KTR_INTR|KTR_PROC)
404options 	KTR_MASK=KTR_INTR
405options 	KTR_CPUMASK=0x3
406options 	KTR_VERBOSE
407
408#
409# ALQ(9) is a facility for the asynchronous queuing of records from the kernel
410# to a vnode, and is employed by services such as KTR(4) to produce trace
411# files based on a kernel event stream.  Records are written asynchronously
412# in a worker thread.
413#
414options 	ALQ
415options 	KTR_ALQ
416
417#
418# The INVARIANTS option is used in a number of source files to enable
419# extra sanity checking of internal structures.  This support is not
420# enabled by default because of the extra time it would take to check
421# for these conditions, which can only occur as a result of
422# programming errors.
423#
424options 	INVARIANTS
425
426#
427# The INVARIANT_SUPPORT option makes us compile in support for
428# verifying some of the internal structures.  It is a prerequisite for
429# 'INVARIANTS', as enabling 'INVARIANTS' will make these functions be
430# called.  The intent is that you can set 'INVARIANTS' for single
431# source files (by changing the source file or specifying it on the
432# command line) if you have 'INVARIANT_SUPPORT' enabled.  Also, if you
433# wish to build a kernel module with 'INVARIANTS', then adding
434# 'INVARIANT_SUPPORT' to your kernel will provide all the necessary
435# infrastructure without the added overhead.
436#
437options 	INVARIANT_SUPPORT
438
439#
440# The DIAGNOSTIC option is used to enable extra debugging information
441# from some parts of the kernel.  As this makes everything more noisy,
442# it is disabled by default.
443#
444options 	DIAGNOSTIC
445
446#
447# REGRESSION causes optional kernel interfaces necessary only for regression
448# testing to be enabled.  These interfaces may constitute security risks
449# when enabled, as they permit processes to easily modify aspects of the
450# run-time environment to reproduce unlikely or unusual (possibly normally
451# impossible) scenarios.
452#
453options 	REGRESSION
454
455#
456# RESTARTABLE_PANICS allows one to continue from a panic as if it were
457# a call to the debugger to continue from a panic as instead.  It is only
458# useful if a kernel debugger is present.  To restart from a panic, reset
459# the panicstr variable to NULL and continue execution.  This option is
460# for development use only and should NOT be used in production systems
461# to "workaround" a panic.
462#
463#options 	RESTARTABLE_PANICS
464
465#
466# This option let some drivers co-exist that can't co-exist in a running
467# system.  This is used to be able to compile all kernel code in one go for
468# quality assurance purposes (like this file, which the option takes it name
469# from.)
470#
471options 	COMPILING_LINT
472
473
474#####################################################################
475# PERFORMANCE MONITORING OPTIONS
476
477#
478# The hwpmc driver that allows the use of in-CPU performance monitoring
479# counters for performance monitoring.  The base kernel needs to configured
480# with the 'options' line, while the hwpmc device can be either compiled
481# in or loaded as a loadable kernel module.
482#
483# Additional configuration options may be required on specific architectures,
484# please see hwpmc(4).
485
486device  	hwpmc			# Driver (also a loadable module)
487options 	HWPMC_HOOKS		# Other necessary kernel hooks
488
489
490#####################################################################
491# NETWORKING OPTIONS
492
493#
494# Protocol families
495#
496options 	INET			#Internet communications protocols
497options 	INET6			#IPv6 communications protocols
498
499# In order to enable IPSEC you MUST also add device crypto to 
500# your kernel configuration
501options 	IPSEC			#IP security (requires device crypto)
502#options 	IPSEC_DEBUG		#debug for IP security
503#
504# Set IPSEC_FILTERTUNNEL to force packets coming through a tunnel
505# to be processed by any configured packet filtering twice.
506# The default is that packets coming out of a tunnel are _not_ processed;
507# they are assumed trusted.
508#
509# IPSEC history is preserved for such packets, and can be filtered
510# using ipfw(8)'s 'ipsec' keyword, when this option is enabled.
511#
512#options 	IPSEC_FILTERTUNNEL	#filter ipsec packets from a tunnel
513
514options 	IPX			#IPX/SPX communications protocols
515
516options 	NCP			#NetWare Core protocol
517
518options 	NETATALK		#Appletalk communications protocols
519options 	NETATALKDEBUG		#Appletalk debugging
520
521#
522# SMB/CIFS requester
523# NETSMB enables support for SMB protocol, it requires LIBMCHAIN and LIBICONV
524# options.
525options 	NETSMB			#SMB/CIFS requester
526
527# mchain library. It can be either loaded as KLD or compiled into kernel
528options 	LIBMCHAIN
529
530# libalias library, performing NAT
531options		LIBALIAS
532
533#
534# SCTP is a NEW transport protocol defined by
535# RFC2960 updated by RFC3309 and RFC3758.. and
536# soon to have a new base RFC and many many more
537# extensions. This release supports all the extensions
538# including many drafts (most about to become RFC's).
539# It is the premeier SCTP implementation in the NET
540# and is quite well tested.
541#
542# Note YOU MUST have both INET and INET6 defined.
543# you don't have to enable V6, but SCTP is 
544# dual stacked and so far we have not teased apart
545# the V6 and V4.. since an association can span
546# both a V6 and V4 address at the SAME time :-)
547#
548options         SCTP
549# There are bunches of options:
550# this one turns on all sorts of
551# nastly printing that you can
552# do. Its all controled by a
553# bit mask (settable by socket opt and
554# by sysctl). Including will not cause
555# logging until you set the bits.. but it
556# can be quite verbose.. so without this
557# option we don't do any of the tests for
558# bits and prints.. which makes the code run
559# faster.. if you are not debugging don't use.
560options SCTP_DEBUG
561#
562# This option turns off the CRC32c checksum. Basically
563# You will not be able to talk to anyone else that
564# has not done this. Its more for expermentation to
565# see how much CPU the CRC32c really takes. Most new
566# cards for TCP support checksum offload.. so this 
567# option gives you a "view" into what SCTP would be
568# like with such an offload (which only exists in
569# high in iSCSI boards so far). With the new
570# splitting 8's algorithm its not as bad as it used
571# to be.. but it does speed things up try only
572# for in a captured lab environment :-)
573options SCTP_WITH_NO_CSUM
574#
575
576#
577# All that options after that turn on specific types of
578# logging. You can monitor CWND growth, flight size
579# and all sorts of things. Go look at the code and
580# see. I have used this to produce interesting 
581# charts and graphs as well :->
582# 
583# I have not yet commited the tools to get and print
584# the logs, I will do that eventually .. before then
585# if you want them send me an email rrs@freebsd.org
586# You basically must have KTR enabled for these
587# and you then set the sysctl to turn on/off various
588# logging bits. Use ktrdump to pull the log and run
589# it through a dispaly program.. and graphs and other
590# things too.
591#
592options 	SCTP_LOCK_LOGGING
593options 	SCTP_MBUF_LOGGING
594options 	SCTP_MBCNT_LOGGING
595options 	SCTP_PACKET_LOGGING
596options		SCTP_LTRACE_CHUNKS
597options 	SCTP_LTRACE_ERRORS
598
599
600# altq(9). Enable the base part of the hooks with the ALTQ option.
601# Individual disciplines must be built into the base system and can not be
602# loaded as modules at this point. ALTQ requires a stable TSC so if yours is
603# broken or changes with CPU throttling then you must also have the ALTQ_NOPCC
604# option.
605options 	ALTQ
606options 	ALTQ_CBQ	# Class Bases Queueing
607options 	ALTQ_RED	# Random Early Detection
608options 	ALTQ_RIO	# RED In/Out
609options 	ALTQ_HFSC	# Hierarchical Packet Scheduler
610options 	ALTQ_CDNR	# Traffic conditioner
611options 	ALTQ_PRIQ	# Priority Queueing
612options 	ALTQ_NOPCC	# Required if the TSC is unusable
613options 	ALTQ_DEBUG
614
615# netgraph(4). Enable the base netgraph code with the NETGRAPH option.
616# Individual node types can be enabled with the corresponding option
617# listed below; however, this is not strictly necessary as netgraph
618# will automatically load the corresponding KLD module if the node type
619# is not already compiled into the kernel. Each type below has a
620# corresponding man page, e.g., ng_async(8).
621options 	NETGRAPH		# netgraph(4) system
622options 	NETGRAPH_DEBUG		# enable extra debugging, this
623					# affects netgraph(4) and nodes
624# Node types
625options 	NETGRAPH_ASYNC
626options 	NETGRAPH_ATMLLC
627options 	NETGRAPH_ATM_ATMPIF
628options 	NETGRAPH_BLUETOOTH		# ng_bluetooth(4)
629options 	NETGRAPH_BLUETOOTH_BT3C		# ng_bt3c(4)
630options 	NETGRAPH_BLUETOOTH_H4		# ng_h4(4)
631options 	NETGRAPH_BLUETOOTH_HCI		# ng_hci(4)
632options 	NETGRAPH_BLUETOOTH_L2CAP	# ng_l2cap(4)
633options 	NETGRAPH_BLUETOOTH_SOCKET	# ng_btsocket(4)
634options 	NETGRAPH_BLUETOOTH_UBT		# ng_ubt(4)
635options 	NETGRAPH_BLUETOOTH_UBTBCMFW	# ubtbcmfw(4)
636options 	NETGRAPH_BPF
637options 	NETGRAPH_BRIDGE
638options 	NETGRAPH_CAR
639options 	NETGRAPH_CISCO
640options 	NETGRAPH_DEFLATE
641options 	NETGRAPH_DEVICE
642options 	NETGRAPH_ECHO
643options 	NETGRAPH_EIFACE
644options 	NETGRAPH_ETHER
645options 	NETGRAPH_FEC
646options 	NETGRAPH_FRAME_RELAY
647options 	NETGRAPH_GIF
648options 	NETGRAPH_GIF_DEMUX
649options 	NETGRAPH_HOLE
650options 	NETGRAPH_IFACE
651options 	NETGRAPH_IP_INPUT
652options 	NETGRAPH_IPFW
653options 	NETGRAPH_KSOCKET
654options 	NETGRAPH_L2TP
655options 	NETGRAPH_LMI
656# MPPC compression requires proprietary files (not included)
657#options 	NETGRAPH_MPPC_COMPRESSION
658options 	NETGRAPH_MPPC_ENCRYPTION
659options 	NETGRAPH_NETFLOW
660options 	NETGRAPH_NAT
661options 	NETGRAPH_ONE2MANY
662options 	NETGRAPH_PPP
663options 	NETGRAPH_PPPOE
664options 	NETGRAPH_PPTPGRE
665options 	NETGRAPH_PRED1
666options 	NETGRAPH_RFC1490
667options 	NETGRAPH_SOCKET
668options 	NETGRAPH_SPLIT
669options 	NETGRAPH_SPPP
670options 	NETGRAPH_TAG
671options 	NETGRAPH_TCPMSS
672options 	NETGRAPH_TEE
673options 	NETGRAPH_TTY
674options 	NETGRAPH_UI
675options 	NETGRAPH_VJC
676
677# NgATM - Netgraph ATM
678options 	NGATM_ATM
679options 	NGATM_ATMBASE
680options 	NGATM_SSCOP
681options 	NGATM_SSCFU
682options 	NGATM_UNI
683options 	NGATM_CCATM
684
685device		mn	# Munich32x/Falc54 Nx64kbit/sec cards.
686
687#
688# Network interfaces:
689#  The `loop' device is MANDATORY when networking is enabled.
690#  The `ether' device provides generic code to handle
691#  Ethernets; it is MANDATORY when an Ethernet device driver is
692#  configured or token-ring is enabled.
693#  The `vlan' device implements the VLAN tagging of Ethernet frames
694#  according to IEEE 802.1Q.  It requires `device miibus'.
695#  The `wlan' device provides generic code to support 802.11
696#  drivers, including host AP mode; it is MANDATORY for the wi,
697#  ath, and awi drivers and will eventually be required by all 802.11 drivers.
698#  The `wlan_wep', `wlan_tkip', and `wlan_ccmp' devices provide
699#  support for WEP, TKIP, and AES-CCMP crypto protocols optionally
700#  used with 802.11 devices that depend on the `wlan' module.
701#  The `wlan_xauth' device provides support for external (i.e. user-mode)
702#  authenticators for use with 802.11 drivers that use the `wlan'
703#  module and support 802.1x and/or WPA security protocols.
704#  The `wlan_acl' device provides a MAC-based access control mechanism
705#  for use with 802.11 drivers operating in ap mode and using the
706#  `wlan' module.
707#  The `fddi' device provides generic code to support FDDI.
708#  The `arcnet' device provides generic code to support Arcnet.
709#  The `sppp' device serves a similar role for certain types
710#  of synchronous PPP links (like `cx', `ar').
711#  The `sl' device implements the Serial Line IP (SLIP) service.
712#  The `ppp' device implements the Point-to-Point Protocol.
713#  The `bpf' device enables the Berkeley Packet Filter.  Be
714#  aware of the legal and administrative consequences of enabling this
715#  option.  The number of devices determines the maximum number of
716#  simultaneous BPF clients programs runnable.  DHCP requires bpf.
717#  The `disc' device implements a minimal network interface,
718#  which throws away all packets sent and never receives any.  It is
719#  included for testing and benchmarking purposes.
720#  The `edsc' device implements a minimal Ethernet interface,
721#  which discards all packets sent and receives none.
722#  The `tap' device is a pty-like virtual Ethernet interface
723#  The `tun' device implements (user-)ppp and nos-tun
724#  The `gif' device implements IPv6 over IP4 tunneling,
725#  IPv4 over IPv6 tunneling, IPv4 over IPv4 tunneling and
726#  IPv6 over IPv6 tunneling.
727#  The `gre' device implements two types of IP4 over IP4 tunneling:
728#  GRE and MOBILE, as specified in the RFC1701 and RFC2004.
729#  The XBONEHACK option allows the same pair of addresses to be configured on
730#  multiple gif interfaces.
731#  The `faith' device captures packets sent to it and diverts them
732#  to the IPv4/IPv6 translation daemon.
733#  The `stf' device implements 6to4 encapsulation.
734#  The `ef' device provides support for multiple ethernet frame types
735#  specified via ETHER_* options. See ef(4) for details.
736#
737# The pf packet filter consists of three devices:
738#  The `pf' device provides /dev/pf and the firewall code itself.
739#  The `pflog' device provides the pflog0 interface which logs packets.
740#  The `pfsync' device provides the pfsync0 interface used for
741#   synchronization of firewall state tables (over the net).
742#  The PF_MPSAFE_UGID option enables a special workaround for a LOR with
743#   user/group rules that would otherwise lead to a deadlock.  This has
744#   performance implications and should be used with care.
745#
746# The PPP_BSDCOMP option enables support for compress(1) style entire
747# packet compression, the PPP_DEFLATE is for zlib/gzip style compression.
748# PPP_FILTER enables code for filtering the ppp data stream and selecting
749# events for resetting the demand dial activity timer - requires bpf.
750# See pppd(8) for more details.
751#
752device		ether			#Generic Ethernet
753device		vlan			#VLAN support (needs miibus)
754device		wlan			#802.11 support
755device		wlan_wep		#802.11 WEP support
756device		wlan_ccmp		#802.11 CCMP support
757device		wlan_tkip		#802.11 TKIP support
758device		wlan_xauth		#802.11 external authenticator support
759device		wlan_acl		#802.11 MAC ACL support
760device		wlan_amrr		#AMRR transmit rate control algorithm
761device		wlan_scan_ap		#802.11 AP mode scanning
762device		wlan_scan_sta		#802.11 STA mode scanning
763device		token			#Generic TokenRing
764device		fddi			#Generic FDDI
765device		arcnet			#Generic Arcnet
766device		sppp			#Generic Synchronous PPP
767device		loop			#Network loopback device
768device		bpf			#Berkeley packet filter
769device		disc			#Discard device based on loopback
770device		edsc			#Ethernet discard device
771device		tap			#Virtual Ethernet driver
772device		tun			#Tunnel driver (ppp(8), nos-tun(8))
773device		sl			#Serial Line IP
774device		gre			#IP over IP tunneling
775device		if_bridge		#Bridge interface
776device		pf			#PF OpenBSD packet-filter firewall
777device		pflog			#logging support interface for PF
778device		pfsync			#synchronization interface for PF
779options 	PF_MPSAFE_UGID		#Workaround LOR with user/group rules
780device		carp			#Common Address Redundancy Protocol
781device		enc			#IPsec interface
782device		ppp			#Point-to-point protocol
783options 	PPP_BSDCOMP		#PPP BSD-compress support
784options 	PPP_DEFLATE		#PPP zlib/deflate/gzip support
785options 	PPP_FILTER		#enable bpf filtering (needs bpf)
786device		lagg			#Link aggregation interface
787
788device		ef			# Multiple ethernet frames support
789options 	ETHER_II		# enable Ethernet_II frame
790options 	ETHER_8023		# enable Ethernet_802.3 (Novell) frame
791options 	ETHER_8022		# enable Ethernet_802.2 frame
792options 	ETHER_SNAP		# enable Ethernet_802.2/SNAP frame
793
794# for IPv6
795device		gif			#IPv6 and IPv4 tunneling
796options 	XBONEHACK
797device		faith			#for IPv6 and IPv4 translation
798device		stf			#6to4 IPv6 over IPv4 encapsulation
799
800#
801# Internet family options:
802#
803# MROUTING enables the kernel multicast packet forwarder, which works
804# with mrouted and XORP.
805#
806# IPFIREWALL enables support for IP firewall construction, in
807# conjunction with the `ipfw' program.  IPFIREWALL_VERBOSE sends
808# logged packets to the system logger.  IPFIREWALL_VERBOSE_LIMIT
809# limits the number of times a matching entry can be logged.
810#
811# WARNING:  IPFIREWALL defaults to a policy of "deny ip from any to any"
812# and if you do not add other rules during startup to allow access,
813# YOU WILL LOCK YOURSELF OUT.  It is suggested that you set firewall_type=open
814# in /etc/rc.conf when first enabling this feature, then refining the
815# firewall rules in /etc/rc.firewall after you've tested that the new kernel
816# feature works properly.
817#
818# IPFIREWALL_DEFAULT_TO_ACCEPT causes the default rule (at boot) to
819# allow everything.  Use with care, if a cracker can crash your
820# firewall machine, they can get to your protected machines.  However,
821# if you are using it as an as-needed filter for specific problems as
822# they arise, then this may be for you.  Changing the default to 'allow'
823# means that you won't get stuck if the kernel and /sbin/ipfw binary get
824# out of sync.
825#
826# IPDIVERT enables the divert IP sockets, used by ``ipfw divert''.  It
827# depends on IPFIREWALL if compiled into the kernel.
828#
829# IPFIREWALL_FORWARD enables changing of the packet destination either
830# to do some sort of policy routing or transparent proxying.  Used by
831# ``ipfw forward''. All  redirections apply to locally generated
832# packets too.  Because of this great care is required when
833# crafting the ruleset.
834#
835# IPFIREWALL_NAT adds support for in kernel nat in ipfw, and it requires
836# LIBALIAS. To build an ipfw kld with nat support enabled, add 
837# "CFLAGS+= -DIPFIREWALL_NAT" to your make.conf.
838#
839# IPSTEALTH enables code to support stealth forwarding (i.e., forwarding
840# packets without touching the TTL).  This can be useful to hide firewalls
841# from traceroute and similar tools.
842#
843# TCPDEBUG enables code which keeps traces of the TCP state machine
844# for sockets with the SO_DEBUG option set, which can then be examined
845# using the trpt(8) utility.
846#
847options 	MROUTING		# Multicast routing
848options 	IPFIREWALL		#firewall
849options 	IPFIREWALL_VERBOSE	#enable logging to syslogd(8)
850options 	IPFIREWALL_VERBOSE_LIMIT=100	#limit verbosity
851options 	IPFIREWALL_DEFAULT_TO_ACCEPT	#allow everything by default
852options 	IPFIREWALL_FORWARD	#packet destination changes
853options 	IPFIREWALL_NAT		#ipfw kernel nat support
854options 	IPDIVERT		#divert sockets
855options 	IPFILTER		#ipfilter support
856options 	IPFILTER_LOG		#ipfilter logging
857options 	IPFILTER_LOOKUP		#ipfilter pools
858options 	IPFILTER_DEFAULT_BLOCK	#block all packets by default
859options 	IPSTEALTH		#support for stealth forwarding
860options 	TCPDEBUG
861
862# The MBUF_STRESS_TEST option enables options which create
863# various random failures / extreme cases related to mbuf
864# functions.  See mbuf(9) for a list of available test cases.
865options 	MBUF_STRESS_TEST
866
867# Statically Link in accept filters
868options 	ACCEPT_FILTER_DATA
869options 	ACCEPT_FILTER_HTTP
870
871# TCP_SIGNATURE adds support for RFC 2385 (TCP-MD5) digests. These are
872# carried in TCP option 19. This option is commonly used to protect
873# TCP sessions (e.g. BGP) where IPSEC is not available nor desirable.
874# This is enabled on a per-socket basis using the TCP_MD5SIG socket option.
875# This requires the use of 'device crypto', 'options IPSEC'
876# or 'device cryptodev'.
877#options 	TCP_SIGNATURE		#include support for RFC 2385
878
879# DUMMYNET enables the "dummynet" bandwidth limiter.  You need IPFIREWALL
880# as well.  See dummynet(4) and ipfw(8) for more info.  When you run
881# DUMMYNET it is advisable to also have "options HZ=1000" to achieve a
882# smoother scheduling of the traffic.
883options 	DUMMYNET
884
885# Zero copy sockets support.  This enables "zero copy" for sending and
886# receiving data via a socket.  The send side works for any type of NIC,
887# the receive side only works for NICs that support MTUs greater than the
888# page size of your architecture and that support header splitting.  See
889# zero_copy(9) for more details.
890options 	ZERO_COPY_SOCKETS
891
892#
893# ATM (HARP version) options
894#
895# XXX: These have been disabled in FreeBSD 7.0 as they are not MPSAFE.
896#
897# ATM_CORE includes the base ATM functionality code.  This must be included
898#	for ATM support.
899#
900# ATM_IP includes support for running IP over ATM.
901#
902# At least one (and usually only one) of the following signalling managers
903# must be included (note that all signalling managers include PVC support):
904# ATM_SIGPVC includes support for the PVC-only signalling manager `sigpvc'.
905# ATM_SPANS includes support for the `spans' signalling manager, which runs
906#	the FORE Systems's proprietary SPANS signalling protocol.
907# ATM_UNI includes support for the `uni30' and `uni31' signalling managers,
908#	which run the ATM Forum UNI 3.x signalling protocols.
909#
910# The `hfa' driver provides support for the FORE Systems, Inc.
911# PCA-200E ATM PCI Adapter.
912#
913# The `harp' pseudo-driver makes all NATM interface drivers available to HARP.
914#
915#options 	ATM_CORE		#core ATM protocol family
916#options 	ATM_IP			#IP over ATM support
917#options 	ATM_SIGPVC		#SIGPVC signalling manager
918#options 	ATM_SPANS		#SPANS signalling manager
919#options 	ATM_UNI			#UNI signalling manager
920
921#device		hfa			#FORE PCA-200E ATM PCI
922#device		harp			#Pseudo-interface for NATM
923
924
925#####################################################################
926# FILESYSTEM OPTIONS
927
928#
929# Only the root, /usr, and /tmp filesystems need be statically
930# compiled; everything else will be automatically loaded at mount
931# time.  (Exception: the UFS family--- FFS --- cannot
932# currently be demand-loaded.)  Some people still prefer to statically
933# compile other filesystems as well.
934#
935# NB: The PORTAL filesystem is known to be buggy, and WILL panic your
936# system if you attempt to do anything with it.  It is included here
937# as an incentive for some enterprising soul to sit down and fix it.
938# The UNION filesystem was known to be buggy in the past.  It is now
939# being actively maintained, although there are still some issues being
940# resolved.
941#
942
943# One of these is mandatory:
944options 	FFS			#Fast filesystem
945options 	NFSCLIENT		#Network File System client
946
947# The rest are optional:
948options 	CD9660			#ISO 9660 filesystem
949options 	FDESCFS			#File descriptor filesystem
950options 	HPFS			#OS/2 File system
951options 	MSDOSFS			#MS DOS File System (FAT, FAT32)
952options 	NFSSERVER		#Network File System server
953options 	NTFS			#NT File System
954options 	NULLFS			#NULL filesystem
955# Broken (depends on NCP):
956#options 	NWFS			#NetWare filesystem
957options 	PORTALFS		#Portal filesystem
958options 	PROCFS			#Process filesystem (requires PSEUDOFS)
959options 	PSEUDOFS		#Pseudo-filesystem framework
960options 	PSEUDOFS_TRACE		#Debugging support for PSEUDOFS
961options 	SMBFS			#SMB/CIFS filesystem
962options 	UDF			#Universal Disk Format
963options 	UNIONFS			#Union filesystem
964# The xFS_ROOT options REQUIRE the associated ``options xFS''
965options 	NFS_ROOT		#NFS usable as root device
966
967# Soft updates is a technique for improving filesystem speed and
968# making abrupt shutdown less risky.
969#
970options 	SOFTUPDATES
971
972# Extended attributes allow additional data to be associated with files,
973# and is used for ACLs, Capabilities, and MAC labels.
974# See src/sys/ufs/ufs/README.extattr for more information.
975options 	UFS_EXTATTR
976options 	UFS_EXTATTR_AUTOSTART
977
978# Access Control List support for UFS filesystems.  The current ACL
979# implementation requires extended attribute support, UFS_EXTATTR,
980# for the underlying filesystem.
981# See src/sys/ufs/ufs/README.acls for more information.
982options 	UFS_ACL
983
984# Directory hashing improves the speed of operations on very large
985# directories at the expense of some memory.
986options 	UFS_DIRHASH
987
988# Gjournal-based UFS journaling support.
989options 	UFS_GJOURNAL
990
991# Make space in the kernel for a root filesystem on a md device.
992# Define to the number of kilobytes to reserve for the filesystem.
993options 	MD_ROOT_SIZE=10
994
995# Make the md device a potential root device, either with preloaded
996# images of type mfs_root or md_root.
997options 	MD_ROOT
998
999# Disk quotas are supported when this option is enabled.
1000options 	QUOTA			#enable disk quotas
1001
1002# If you are running a machine just as a fileserver for PC and MAC
1003# users, using SAMBA or Netatalk, you may consider setting this option
1004# and keeping all those users' directories on a filesystem that is
1005# mounted with the suiddir option. This gives new files the same
1006# ownership as the directory (similar to group). It's a security hole
1007# if you let these users run programs, so confine it to file-servers
1008# (but it'll save you lots of headaches in those cases). Root owned
1009# directories are exempt and X bits are cleared. The suid bit must be
1010# set on the directory as well; see chmod(1) PC owners can't see/set
1011# ownerships so they keep getting their toes trodden on. This saves
1012# you all the support calls as the filesystem it's used on will act as
1013# they expect: "It's my dir so it must be my file".
1014#
1015options 	SUIDDIR
1016
1017# NFS options:
1018options 	NFS_MINATTRTIMO=3	# VREG attrib cache timeout in sec
1019options 	NFS_MAXATTRTIMO=60
1020options 	NFS_MINDIRATTRTIMO=30	# VDIR attrib cache timeout in sec
1021options 	NFS_MAXDIRATTRTIMO=60
1022options 	NFS_GATHERDELAY=10	# Default write gather delay (msec)
1023options 	NFS_WDELAYHASHSIZ=16	# and with this
1024options 	NFS_DEBUG		# Enable NFS Debugging
1025
1026# Coda stuff:
1027options 	CODA			#CODA filesystem.
1028device		vcoda			#coda minicache <-> venus comm.
1029# Use the old Coda 5.x venus<->kernel interface instead of the new
1030# realms-aware 6.x protocol.
1031#options 	CODA_COMPAT_5
1032
1033#
1034# Add support for the EXT2FS filesystem of Linux fame.  Be a bit
1035# careful with this - the ext2fs code has a tendency to lag behind
1036# changes and not be exercised very much, so mounting read/write could
1037# be dangerous (and even mounting read only could result in panics.)
1038#
1039options 	EXT2FS
1040
1041#
1042# Add support for the ReiserFS filesystem (used in Linux). Currently,
1043# this is limited to read-only access.
1044#
1045options 	REISERFS
1046
1047#
1048# Add support for the SGI XFS filesystem. Currently,
1049# this is limited to read-only access.
1050#
1051options 	XFS
1052
1053# Use real implementations of the aio_* system calls.  There are numerous
1054# stability and security issues in the current aio code that make it
1055# unsuitable for inclusion on machines with untrusted local users.
1056options 	VFS_AIO
1057
1058# Cryptographically secure random number generator; /dev/random
1059device		random
1060
1061# The system memory devices; /dev/mem, /dev/kmem
1062device		mem
1063
1064# Optional character code conversion support with LIBICONV.
1065# Each option requires their base file system and LIBICONV.
1066options 	CD9660_ICONV
1067options 	MSDOSFS_ICONV
1068options 	NTFS_ICONV
1069options 	UDF_ICONV
1070
1071
1072#####################################################################
1073# POSIX P1003.1B
1074
1075# Real time extensions added in the 1993 POSIX
1076# _KPOSIX_PRIORITY_SCHEDULING: Build in _POSIX_PRIORITY_SCHEDULING
1077
1078options 	_KPOSIX_PRIORITY_SCHEDULING
1079# p1003_1b_semaphores are very experimental,
1080# user should be ready to assist in debugging if problems arise.
1081options 	P1003_1B_SEMAPHORES
1082
1083# POSIX message queue
1084options 	P1003_1B_MQUEUE
1085
1086#####################################################################
1087# SECURITY POLICY PARAMETERS
1088
1089# Support for BSM audit
1090options 	AUDIT
1091
1092# Support for Mandatory Access Control (MAC):
1093options 	MAC
1094options 	MAC_BIBA
1095options 	MAC_BSDEXTENDED
1096options 	MAC_IFOFF
1097options 	MAC_LOMAC
1098options 	MAC_MLS
1099options 	MAC_NONE
1100options 	MAC_PARTITION
1101options 	MAC_PORTACL
1102options 	MAC_SEEOTHERUIDS
1103options 	MAC_STUB
1104options 	MAC_TEST
1105
1106
1107#####################################################################
1108# CLOCK OPTIONS
1109
1110# The granularity of operation is controlled by the kernel option HZ whose
1111# default value (100) means a granularity of 10ms (1s/HZ).
1112# Some subsystems, such as DUMMYNET, might benefit from a smaller
1113# granularity such as 1ms or less, for a smoother scheduling of packets.
1114# Consider, however, that reducing the granularity too much might
1115# cause excessive overhead in clock interrupt processing,
1116# potentially causing ticks to be missed and thus actually reducing
1117# the accuracy of operation.
1118
1119options 	HZ=100
1120
1121# Enable support for the kernel PLL to use an external PPS signal,
1122# under supervision of [x]ntpd(8)
1123# More info in ntpd documentation: http://www.eecis.udel.edu/~ntp
1124
1125options 	PPS_SYNC
1126
1127
1128#####################################################################
1129# SCSI DEVICES
1130
1131# SCSI DEVICE CONFIGURATION
1132
1133# The SCSI subsystem consists of the `base' SCSI code, a number of
1134# high-level SCSI device `type' drivers, and the low-level host-adapter
1135# device drivers.  The host adapters are listed in the ISA and PCI
1136# device configuration sections below.
1137#
1138# It is possible to wire down your SCSI devices so that a given bus,
1139# target, and LUN always come on line as the same device unit.  In
1140# earlier versions the unit numbers were assigned in the order that
1141# the devices were probed on the SCSI bus.  This means that if you
1142# removed a disk drive, you may have had to rewrite your /etc/fstab
1143# file, and also that you had to be careful when adding a new disk
1144# as it may have been probed earlier and moved your device configuration
1145# around.  (See also option GEOM_VOL for a different solution to this
1146# problem.)
1147
1148# This old behavior is maintained as the default behavior.  The unit
1149# assignment begins with the first non-wired down unit for a device
1150# type.  For example, if you wire a disk as "da3" then the first
1151# non-wired disk will be assigned da4.
1152
1153# The syntax for wiring down devices is:
1154
1155hint.scbus.0.at="ahc0"
1156hint.scbus.1.at="ahc1"
1157hint.scbus.1.bus="0"
1158hint.scbus.3.at="ahc2"
1159hint.scbus.3.bus="0"
1160hint.scbus.2.at="ahc2"
1161hint.scbus.2.bus="1"
1162hint.da.0.at="scbus0"
1163hint.da.0.target="0"
1164hint.da.0.unit="0"
1165hint.da.1.at="scbus3"
1166hint.da.1.target="1"
1167hint.da.2.at="scbus2"
1168hint.da.2.target="3"
1169hint.sa.1.at="scbus1"
1170hint.sa.1.target="6"
1171
1172# "units" (SCSI logical unit number) that are not specified are
1173# treated as if specified as LUN 0.
1174
1175# All SCSI devices allocate as many units as are required.
1176
1177# The ch driver drives SCSI Media Changer ("jukebox") devices.
1178#
1179# The da driver drives SCSI Direct Access ("disk") and Optical Media
1180# ("WORM") devices.
1181#
1182# The sa driver drives SCSI Sequential Access ("tape") devices.
1183#
1184# The cd driver drives SCSI Read Only Direct Access ("cd") devices.
1185#
1186# The ses driver drives SCSI Environment Services ("ses") and
1187# SAF-TE ("SCSI Accessible Fault-Tolerant Enclosure") devices.
1188#
1189# The pt driver drives SCSI Processor devices.
1190#
1191# The sg driver provides a passthrough API that is compatible with the
1192# Linux SG driver.  It will work in conjunction with the COMPAT_LINUX
1193# option to run linux SG apps.  It can also stand on its own and provide
1194# source level API compatiblity for porting apps to FreeBSD.
1195#
1196# Target Mode support is provided here but also requires that a SIM
1197# (SCSI Host Adapter Driver) provide support as well.
1198#
1199# The targ driver provides target mode support as a Processor type device.
1200# It exists to give the minimal context necessary to respond to Inquiry
1201# commands. There is a sample user application that shows how the rest
1202# of the command support might be done in /usr/share/examples/scsi_target.
1203#
1204# The targbh driver provides target mode support and exists to respond
1205# to incoming commands that do not otherwise have a logical unit assigned
1206# to them.
1207#
1208# The "unknown" device (uk? in pre-2.0.5) is now part of the base SCSI
1209# configuration as the "pass" driver.
1210
1211device		scbus		#base SCSI code
1212device		ch		#SCSI media changers
1213device		da		#SCSI direct access devices (aka disks)
1214device		sa		#SCSI tapes
1215device		cd		#SCSI CD-ROMs
1216device		ses		#SCSI Environmental Services (and SAF-TE)
1217device		pt		#SCSI processor
1218device		targ		#SCSI Target Mode Code
1219device		targbh		#SCSI Target Mode Blackhole Device
1220device		pass		#CAM passthrough driver
1221device		sg		#Linux SCSI passthrough
1222
1223# CAM OPTIONS:
1224# debugging options:
1225# -- NOTE --  If you specify one of the bus/target/lun options, you must
1226#             specify them all!
1227# CAMDEBUG: When defined enables debugging macros
1228# CAM_DEBUG_BUS:  Debug the given bus.  Use -1 to debug all busses.
1229# CAM_DEBUG_TARGET:  Debug the given target.  Use -1 to debug all targets.
1230# CAM_DEBUG_LUN:  Debug the given lun.  Use -1 to debug all luns.
1231# CAM_DEBUG_FLAGS:  OR together CAM_DEBUG_INFO, CAM_DEBUG_TRACE,
1232#                   CAM_DEBUG_SUBTRACE, and CAM_DEBUG_CDB
1233#
1234# CAM_MAX_HIGHPOWER: Maximum number of concurrent high power (start unit) cmds
1235# SCSI_NO_SENSE_STRINGS: When defined disables sense descriptions
1236# SCSI_NO_OP_STRINGS: When defined disables opcode descriptions
1237# SCSI_DELAY: The number of MILLISECONDS to freeze the SIM (scsi adapter)
1238#             queue after a bus reset, and the number of milliseconds to
1239#             freeze the device queue after a bus device reset.  This
1240#             can be changed at boot and runtime with the
1241#             kern.cam.scsi_delay tunable/sysctl.
1242options 	CAMDEBUG
1243options 	CAM_DEBUG_BUS=-1
1244options 	CAM_DEBUG_TARGET=-1
1245options 	CAM_DEBUG_LUN=-1
1246options 	CAM_DEBUG_FLAGS=(CAM_DEBUG_INFO|CAM_DEBUG_TRACE|CAM_DEBUG_CDB)
1247options 	CAM_MAX_HIGHPOWER=4
1248options 	SCSI_NO_SENSE_STRINGS
1249options 	SCSI_NO_OP_STRINGS
1250options 	SCSI_DELAY=5000	# Be pessimistic about Joe SCSI device
1251
1252# Options for the CAM CDROM driver:
1253# CHANGER_MIN_BUSY_SECONDS: Guaranteed minimum time quantum for a changer LUN
1254# CHANGER_MAX_BUSY_SECONDS: Maximum time quantum per changer LUN, only
1255#                           enforced if there is I/O waiting for another LUN
1256# The compiled in defaults for these variables are 2 and 10 seconds,
1257# respectively.
1258#
1259# These can also be changed on the fly with the following sysctl variables:
1260# kern.cam.cd.changer.min_busy_seconds
1261# kern.cam.cd.changer.max_busy_seconds
1262#
1263options 	CHANGER_MIN_BUSY_SECONDS=2
1264options 	CHANGER_MAX_BUSY_SECONDS=10
1265
1266# Options for the CAM sequential access driver:
1267# SA_IO_TIMEOUT: Timeout for read/write/wfm  operations, in minutes
1268# SA_SPACE_TIMEOUT: Timeout for space operations, in minutes
1269# SA_REWIND_TIMEOUT: Timeout for rewind operations, in minutes
1270# SA_ERASE_TIMEOUT: Timeout for erase operations, in minutes
1271# SA_1FM_AT_EOD: Default to model which only has a default one filemark at EOT.
1272options 	SA_IO_TIMEOUT=4
1273options 	SA_SPACE_TIMEOUT=60
1274options 	SA_REWIND_TIMEOUT=(2*60)
1275options 	SA_ERASE_TIMEOUT=(4*60)
1276options 	SA_1FM_AT_EOD
1277
1278# Optional timeout for the CAM processor target (pt) device
1279# This is specified in seconds.  The default is 60 seconds.
1280options 	SCSI_PT_DEFAULT_TIMEOUT=60
1281
1282# Optional enable of doing SES passthrough on other devices (e.g., disks)
1283#
1284# Normally disabled because a lot of newer SCSI disks report themselves
1285# as having SES capabilities, but this can then clot up attempts to build
1286# build a topology with the SES device that's on the box these drives
1287# are in....
1288options 	SES_ENABLE_PASSTHROUGH
1289
1290
1291#####################################################################
1292# MISCELLANEOUS DEVICES AND OPTIONS
1293
1294# The `pty' device usually turns out to be ``effectively mandatory'',
1295# as it is required for `telnetd', `rlogind', `screen', `emacs', and
1296# `xterm', among others.
1297
1298device		pty		#Pseudo ttys
1299device		nmdm		#back-to-back tty devices
1300device		md		#Memory/malloc disk
1301device		snp		#Snoop device - to look at pty/vty/etc..
1302device		ccd		#Concatenated disk driver
1303device		firmware	#firmware(9) support
1304
1305# Kernel side iconv library
1306options 	LIBICONV
1307
1308# Size of the kernel message buffer.  Should be N * pagesize.
1309options 	MSGBUF_SIZE=40960
1310
1311# Maximum size of a tty or pty input buffer.
1312options 	TTYHOG=8193
1313
1314
1315#####################################################################
1316# HARDWARE DEVICE CONFIGURATION
1317
1318# For ISA the required hints are listed.
1319# EISA, MCA, PCI, CardBus, SD/MMC and pccard are self identifying buses, so
1320# no hints are needed.
1321
1322#
1323# Mandatory devices:
1324#
1325
1326# These options are valid for other keyboard drivers as well.
1327options 	KBD_DISABLE_KEYMAP_LOAD	# refuse to load a keymap
1328options 	KBD_INSTALL_CDEV	# install a CDEV entry in /dev
1329
1330options 	FB_DEBUG		# Frame buffer debugging
1331
1332device		splash			# Splash screen and screen saver support
1333
1334# Various screen savers.
1335device		blank_saver
1336device		daemon_saver
1337device		dragon_saver
1338device		fade_saver
1339device		fire_saver
1340device		green_saver
1341device		logo_saver
1342device		rain_saver
1343device		snake_saver
1344device		star_saver
1345device		warp_saver
1346
1347# The syscons console driver (SCO color console compatible).
1348device		sc
1349hint.sc.0.at="isa"
1350options 	MAXCONS=16		# number of virtual consoles
1351options 	SC_ALT_MOUSE_IMAGE	# simplified mouse cursor in text mode
1352options 	SC_DFLT_FONT		# compile font in
1353makeoptions	SC_DFLT_FONT=cp850
1354options 	SC_DISABLE_KDBKEY	# disable `debug' key
1355options 	SC_DISABLE_REBOOT	# disable reboot key sequence
1356options 	SC_HISTORY_SIZE=200	# number of history buffer lines
1357options 	SC_MOUSE_CHAR=0x3	# char code for text mode mouse cursor
1358options 	SC_PIXEL_MODE		# add support for the raster text mode
1359
1360# The following options will let you change the default colors of syscons.
1361options 	SC_NORM_ATTR=(FG_GREEN|BG_BLACK)
1362options 	SC_NORM_REV_ATTR=(FG_YELLOW|BG_GREEN)
1363options 	SC_KERNEL_CONS_ATTR=(FG_RED|BG_BLACK)
1364options 	SC_KERNEL_CONS_REV_ATTR=(FG_BLACK|BG_RED)
1365
1366# The following options will let you change the default behaviour of
1367# cut-n-paste feature
1368options 	SC_CUT_SPACES2TABS	# convert leading spaces into tabs
1369options 	SC_CUT_SEPCHARS=\"x09\"	# set of characters that delimit words
1370					# (default is single space - \"x20\")
1371
1372# If you have a two button mouse, you may want to add the following option
1373# to use the right button of the mouse to paste text.
1374options 	SC_TWOBUTTON_MOUSE
1375
1376# You can selectively disable features in syscons.
1377options 	SC_NO_CUTPASTE
1378options 	SC_NO_FONT_LOADING
1379options 	SC_NO_HISTORY
1380options 	SC_NO_MODE_CHANGE
1381options 	SC_NO_SYSMOUSE
1382options 	SC_NO_SUSPEND_VTYSWITCH
1383
1384# `flags' for sc
1385#	0x80	Put the video card in the VESA 800x600 dots, 16 color mode
1386#	0x100	Probe for a keyboard device periodically if one is not present
1387
1388#
1389# Optional devices:
1390#
1391
1392#
1393# SCSI host adapters:
1394#
1395# adv: All Narrow SCSI bus AdvanSys controllers.
1396# adw: Second Generation AdvanSys controllers including the ADV940UW.
1397# aha: Adaptec 154x/1535/1640
1398# ahb: Adaptec 174x EISA controllers
1399# ahc: Adaptec 274x/284x/2910/293x/294x/394x/3950x/3960x/398X/4944/
1400#      19160x/29160x, aic7770/aic78xx
1401# ahd: Adaptec 29320/39320 Controllers.
1402# aic: Adaptec 6260/6360, APA-1460 (PC Card), NEC PC9801-100 (C-BUS)
1403# amd: Support for the AMD 53C974 SCSI host adapter chip as found on devices
1404#      such as the Tekram DC-390(T).
1405# bt:  Most Buslogic controllers: including BT-445, BT-54x, BT-64x, BT-74x,
1406#      BT-75x, BT-946, BT-948, BT-956, BT-958, SDC3211B, SDC3211F, SDC3222F
1407# esp: NCR53c9x.  Only for SBUS hardware right now.
1408# isp: Qlogic ISP 1020, 1040 and 1040B PCI SCSI host adapters,
1409#      ISP 1240 Dual Ultra SCSI, ISP 1080 and 1280 (Dual) Ultra2,
1410#      ISP 12160 Ultra3 SCSI,
1411#      Qlogic ISP 2100 and ISP 2200 1Gb Fibre Channel host adapters.
1412#      Qlogic ISP 2300 and ISP 2312 2Gb Fibre Channel host adapters.
1413#      Qlogic ISP 2322 and ISP 6322 2Gb Fibre Channel host adapters.
1414# ispfw: Firmware module for Qlogic host adapters
1415# mpt: LSI-Logic MPT/Fusion 53c1020 or 53c1030 Ultra4
1416#      or FC9x9 Fibre Channel host adapters.
1417# ncr: NCR 53C810, 53C825 self-contained SCSI host adapters.
1418# sym: Symbios/Logic 53C8XX family of PCI-SCSI I/O processors:
1419#      53C810, 53C810A, 53C815, 53C825,  53C825A, 53C860, 53C875,
1420#      53C876, 53C885,  53C895, 53C895A, 53C896,  53C897, 53C1510D,
1421#      53C1010-33, 53C1010-66.
1422# trm: Tekram DC395U/UW/F DC315U adapters.
1423# wds: WD7000
1424
1425#
1426# Note that the order is important in order for Buslogic ISA/EISA cards to be
1427# probed correctly.
1428#
1429device		bt
1430hint.bt.0.at="isa"
1431hint.bt.0.port="0x330"
1432device		adv
1433hint.adv.0.at="isa"
1434device		adw
1435device		aha
1436hint.aha.0.at="isa"
1437device		aic
1438hint.aic.0.at="isa"
1439device		ahb
1440device		ahc
1441device		ahd
1442device		amd
1443device		esp
1444device		iscsi_initiator
1445device		isp
1446hint.isp.0.disable="1"
1447hint.isp.0.role="3"
1448hint.isp.0.prefer_iomap="1"
1449hint.isp.0.prefer_memmap="1"
1450hint.isp.0.fwload_disable="1"
1451hint.isp.0.ignore_nvram="1"
1452hint.isp.0.fullduplex="1"
1453hint.isp.0.topology="lport"
1454hint.isp.0.topology="nport"
1455hint.isp.0.topology="lport-only"
1456hint.isp.0.topology="nport-only"
1457# we can't get u_int64_t types, nor can we get strings if it's got
1458# a leading 0x, hence this silly dodge.
1459hint.isp.0.portwnn="w50000000aaaa0000"
1460hint.isp.0.nodewnn="w50000000aaaa0001"
1461device		ispfw
1462device		mpt
1463device		ncr
1464device		sym
1465device		trm
1466device		wds
1467hint.wds.0.at="isa"
1468hint.wds.0.port="0x350"
1469hint.wds.0.irq="11"
1470hint.wds.0.drq="6"
1471
1472# The aic7xxx driver will attempt to use memory mapped I/O for all PCI
1473# controllers that have it configured only if this option is set. Unfortunately,
1474# this doesn't work on some motherboards, which prevents it from being the
1475# default.
1476options 	AHC_ALLOW_MEMIO
1477
1478# Dump the contents of the ahc controller configuration PROM.
1479options 	AHC_DUMP_EEPROM
1480
1481# Bitmap of units to enable targetmode operations.
1482options 	AHC_TMODE_ENABLE
1483
1484# Compile in Aic7xxx Debugging code.
1485options 	AHC_DEBUG
1486
1487# Aic7xxx driver debugging options. See sys/dev/aic7xxx/aic7xxx.h
1488options 	AHC_DEBUG_OPTS
1489
1490# Print register bitfields in debug output.  Adds ~128k to driver
1491# See ahc(4).
1492options 	AHC_REG_PRETTY_PRINT
1493
1494# Compile in aic79xx debugging code.
1495options 	AHD_DEBUG
1496
1497# Aic79xx driver debugging options.  Adds ~215k to driver.  See ahd(4).
1498options 	AHD_DEBUG_OPTS=0xFFFFFFFF
1499
1500# Print human-readable register definitions when debugging
1501options 	AHD_REG_PRETTY_PRINT
1502
1503# Bitmap of units to enable targetmode operations.
1504options 	AHD_TMODE_ENABLE
1505
1506# The adw driver will attempt to use memory mapped I/O for all PCI
1507# controllers that have it configured only if this option is set.
1508options 	ADW_ALLOW_MEMIO
1509
1510# Options used in dev/iscsi (Software iSCSI stack)
1511#
1512options		ISCSI_INITIATOR_DEBUG=9
1513
1514# Options used in dev/isp/ (Qlogic SCSI/FC driver).
1515#
1516#	ISP_TARGET_MODE		-	enable target mode operation
1517#
1518options 	ISP_TARGET_MODE=1
1519#
1520#	ISP_DEFAULT_ROLES	-	default role
1521#		none=0
1522#		target=1
1523#		initiator=2
1524#		both=3			(not supported currently)
1525#
1526options 	ISP_DEFAULT_ROLES=2
1527
1528# Options used in dev/sym/ (Symbios SCSI driver).
1529#options 	SYM_SETUP_LP_PROBE_MAP	#-Low Priority Probe Map (bits)
1530					# Allows the ncr to take precedence
1531					# 1 (1<<0) -> 810a, 860
1532					# 2 (1<<1) -> 825a, 875, 885, 895
1533					# 4 (1<<2) -> 895a, 896, 1510d
1534#options 	SYM_SETUP_SCSI_DIFF	#-HVD support for 825a, 875, 885
1535					# disabled:0 (default), enabled:1
1536#options 	SYM_SETUP_PCI_PARITY	#-PCI parity checking
1537					# disabled:0, enabled:1 (default)
1538#options 	SYM_SETUP_MAX_LUN	#-Number of LUNs supported
1539					# default:8, range:[1..64]
1540
1541# The 'dpt' driver provides support for old DPT controllers (http://www.dpt.com/).
1542# These have hardware RAID-{0,1,5} support, and do multi-initiator I/O.
1543# The DPT controllers are commonly re-licensed under other brand-names -
1544# some controllers by Olivetti, Dec, HP, AT&T, SNI, AST, Alphatronic, NEC and
1545# Compaq are actually DPT controllers.
1546#
1547# See src/sys/dev/dpt for debugging and other subtle options.
1548#   DPT_MEASURE_PERFORMANCE Enables a set of (semi)invasive metrics. Various
1549#                           instruments are enabled.  The tools in
1550#                           /usr/sbin/dpt_* assume these to be enabled.
1551#   DPT_HANDLE_TIMEOUTS     Normally device timeouts are handled by the DPT.
1552#                           If you ant the driver to handle timeouts, enable
1553#                           this option.  If your system is very busy, this
1554#                           option will create more trouble than solve.
1555#   DPT_TIMEOUT_FACTOR      Used to compute the excessive amount of time to
1556#                           wait when timing out with the above option.
1557#  DPT_DEBUG_xxxx           These are controllable from sys/dev/dpt/dpt.h
1558#  DPT_LOST_IRQ             When enabled, will try, once per second, to catch
1559#                           any interrupt that got lost.  Seems to help in some
1560#                           DPT-firmware/Motherboard combinations.  Minimal
1561#                           cost, great benefit.
1562#  DPT_RESET_HBA            Make "reset" actually reset the controller
1563#                           instead of fudging it.  Only enable this if you
1564#			    are 100% certain you need it.
1565
1566device		dpt
1567
1568# DPT options
1569#!CAM# options 	DPT_MEASURE_PERFORMANCE
1570#!CAM# options 	DPT_HANDLE_TIMEOUTS
1571options 	DPT_TIMEOUT_FACTOR=4
1572options 	DPT_LOST_IRQ
1573options 	DPT_RESET_HBA
1574
1575#
1576# Compaq "CISS" RAID controllers (SmartRAID 5* series)
1577# These controllers have a SCSI-like interface, and require the
1578# CAM infrastructure.
1579#
1580device		ciss
1581
1582#
1583# Intel Integrated RAID controllers.
1584# This driver was developed and is maintained by Intel.  Contacts
1585# at Intel for this driver are
1586# "Kannanthanam, Boji T" <boji.t.kannanthanam@intel.com> and
1587# "Leubner, Achim" <achim.leubner@intel.com>.
1588#
1589device		iir
1590
1591#
1592# Mylex AcceleRAID and eXtremeRAID controllers with v6 and later
1593# firmware.  These controllers have a SCSI-like interface, and require
1594# the CAM infrastructure.
1595#
1596device		mly
1597
1598#
1599# Compaq Smart RAID, Mylex DAC960 and AMI MegaRAID controllers.  Only
1600# one entry is needed; the code will find and configure all supported
1601# controllers.
1602#
1603device		ida		# Compaq Smart RAID
1604device		mlx		# Mylex DAC960
1605device		amr		# AMI MegaRAID
1606device		mfi		# LSI MegaRAID SAS
1607device		mfip		# LSI MegaRAID SAS passthrough, requires CAM
1608options 	MFI_DEBUG
1609
1610#
1611# 3ware ATA RAID
1612#
1613device		twe		# 3ware ATA RAID
1614
1615#
1616# The 'ATA' driver supports all ATA and ATAPI devices, including PC Card
1617# devices. You only need one "device ata" for it to find all
1618# PCI and PC Card ATA/ATAPI devices on modern machines.
1619device		ata
1620device		atadisk		# ATA disk drives
1621device		ataraid		# ATA RAID drives
1622device		atapicd		# ATAPI CDROM drives
1623device		atapifd		# ATAPI floppy drives
1624device		atapist		# ATAPI tape drives
1625device		atapicam	# emulate ATAPI devices as SCSI ditto via CAM
1626				# needs CAM to be present (scbus & pass)
1627#
1628# For older non-PCI, non-PnPBIOS systems, these are the hints lines to add:
1629hint.ata.0.at="isa"
1630hint.ata.0.port="0x1f0"
1631hint.ata.0.irq="14"
1632hint.ata.1.at="isa"
1633hint.ata.1.port="0x170"
1634hint.ata.1.irq="15"
1635
1636#
1637# The following options are valid on the ATA driver:
1638#
1639# ATA_STATIC_ID:	controller numbering is static ie depends on location
1640#			else the device numbers are dynamically allocated.
1641
1642options 	ATA_STATIC_ID
1643
1644#
1645# Standard floppy disk controllers and floppy tapes, supports
1646# the Y-E DATA External FDD (PC Card)
1647#
1648device		fdc
1649hint.fdc.0.at="isa"
1650hint.fdc.0.port="0x3F0"
1651hint.fdc.0.irq="6"
1652hint.fdc.0.drq="2"
1653#
1654# FDC_DEBUG enables floppy debugging.  Since the debug output is huge, you
1655# gotta turn it actually on by setting the variable fd_debug with DDB,
1656# however.
1657options 	FDC_DEBUG
1658#
1659# Activate this line if you happen to have an Insight floppy tape.
1660# Probing them proved to be dangerous for people with floppy disks only,
1661# so it's "hidden" behind a flag:
1662#hint.fdc.0.flags="1"
1663
1664# Specify floppy devices
1665hint.fd.0.at="fdc0"
1666hint.fd.0.drive="0"
1667hint.fd.1.at="fdc0"
1668hint.fd.1.drive="1"
1669
1670#
1671# uart: newbusified driver for serial interfaces.  It consolidates the sio(4),
1672#	sab(4) and zs(4) drivers.
1673#
1674device		uart
1675
1676# Options for uart(4)
1677options 	UART_PPS_ON_CTS		# Do time pulse capturing using CTS
1678					# instead of DCD.
1679
1680# The following hint should only be used for pure ISA devices.  It is not
1681# needed otherwise.  Use of hints is strongly discouraged.
1682hint.uart.0.at="isa"
1683
1684# The following 3 hints are used when the UART is a system device (i.e., a
1685# console or debug port), but only on platforms that don't have any other
1686# means to pass the information to the kernel.  The unit number of the hint
1687# is only used to bundle the hints together.  There is no relation to the
1688# unit number of the probed UART.
1689hint.uart.0.port="0x3f8"
1690hint.uart.0.flags="0x10"
1691hint.uart.0.baud="115200"
1692
1693# `flags' for serial drivers that support consoles like sio(4) and uart(4):
1694#	0x10	enable console support for this unit.  Other console flags
1695#		(if applicable) are ignored unless this is set.  Enabling
1696#		console support does not make the unit the preferred console.
1697#		Boot with -h or set boot_serial=YES in the loader.  For sio(4)
1698#		specifically, the 0x20 flag can also be set (see above).
1699#		Currently, at most one unit can have console support; the
1700#		first one (in config file order) with this flag set is
1701#		preferred.  Setting this flag for sio0 gives the old behaviour.
1702#	0x80	use this port for serial line gdb support in ddb.  Also known
1703#		as debug port.
1704#
1705
1706# Options for serial drivers that support consoles:
1707options 	BREAK_TO_DEBUGGER	# A BREAK on a serial console goes to
1708					# ddb, if available.
1709
1710# Solaris implements a new BREAK which is initiated by a character
1711# sequence CR ~ ^b which is similar to a familiar pattern used on
1712# Sun servers by the Remote Console.
1713options 	ALT_BREAK_TO_DEBUGGER
1714
1715# Serial Communications Controller
1716# Supports the Siemens SAB 82532 and Zilog Z8530 multi-channel
1717# communications controllers.
1718device		scc
1719
1720# PCI Universal Communications driver
1721# Supports various multi port PCI I/O cards.
1722device		puc
1723
1724#
1725# Network interfaces:
1726#
1727# MII bus support is required for some PCI 10/100 ethernet NICs,
1728# namely those which use MII-compliant transceivers or implement
1729# transceiver control interfaces that operate like an MII. Adding
1730# "device miibus0" to the kernel config pulls in support for
1731# the generic miibus API and all of the PHY drivers, including a
1732# generic one for PHYs that aren't specifically handled by an
1733# individual driver.
1734device		miibus
1735
1736# an:   Aironet 4500/4800 802.11 wireless adapters. Supports the PCMCIA,
1737#       PCI and ISA varieties.
1738# awi:  Support for IEEE 802.11 PC Card devices using the AMD Am79C930 and
1739#       Harris (Intersil) Chipset with PCnetMobile firmware by AMD.
1740# bce:	Broadcom NetXtreme II (BCM5706/BCM5708) PCI/PCIe Gigabit Ethernet
1741#       adapters.
1742# bfe:	Broadcom BCM4401 Ethernet adapter.
1743# bge:	Support for gigabit ethernet adapters based on the Broadcom
1744#	BCM570x family of controllers, including the 3Com 3c996-T,
1745#	the Netgear GA302T, the SysKonnect SK-9D21 and SK-9D41, and
1746#	the embedded gigE NICs on Dell PowerEdge 2550 servers.
1747# cm:	Arcnet SMC COM90c26 / SMC COM90c56
1748#	(and SMC COM90c66 in '56 compatibility mode) adapters.
1749# cnw:  Xircom CNW/Netware Airsurfer PC Card adapter
1750# dc:   Support for PCI fast ethernet adapters based on the DEC/Intel 21143
1751#       and various workalikes including:
1752#       the ADMtek AL981 Comet and AN985 Centaur, the ASIX Electronics
1753#       AX88140A and AX88141, the Davicom DM9100 and DM9102, the Lite-On
1754#       82c168 and 82c169 PNIC, the Lite-On/Macronix LC82C115 PNIC II
1755#       and the Macronix 98713/98713A/98715/98715A/98725 PMAC. This driver
1756#       replaces the old al, ax, dm, pn and mx drivers.  List of brands:
1757#       Digital DE500-BA, Kingston KNE100TX, D-Link DFE-570TX, SOHOware SFA110,
1758#       SVEC PN102-TX, CNet Pro110B, 120A, and 120B, Compex RL100-TX,
1759#       LinkSys LNE100TX, LNE100TX V2.0, Jaton XpressNet, Alfa Inc GFC2204,
1760#       KNE110TX.
1761# de:   Digital Equipment DC21040
1762# em:   Intel Pro/1000 Gigabit Ethernet 82542, 82543, 82544 based adapters.
1763# ep:   3Com 3C509, 3C529, 3C556, 3C562D, 3C563D, 3C572, 3C574X, 3C579, 3C589
1764#       and PC Card devices using these chipsets.
1765# ex:   Intel EtherExpress Pro/10 and other i82595-based adapters,
1766#       Olicom Ethernet PC Card devices.
1767# fe:   Fujitsu MB86960A/MB86965A Ethernet
1768# fea:  DEC DEFEA EISA FDDI adapter
1769# fpa:  Support for the Digital DEFPA PCI FDDI. `device fddi' is also needed.
1770# fxp:  Intel EtherExpress Pro/100B
1771#	(hint of prefer_iomap can be done to prefer I/O instead of Mem mapping)
1772# hme:  Sun HME (Happy Meal Ethernet)
1773# le:   AMD Am7900 LANCE and Am79C9xx PCnet
1774# lge:	Support for PCI gigabit ethernet adapters based on the Level 1
1775#	LXT1001 NetCellerator chipset. This includes the D-Link DGE-500SX,
1776#	SMC TigerCard 1000 (SMC9462SX), and some Addtron cards.
1777# msk:	Support for gigabit ethernet adapters based on the Marvell/SysKonnect
1778#	Yukon II Gigabit controllers, including 88E8021, 88E8022, 88E8061,
1779#	88E8062, 88E8035, 88E8036, 88E8038, 88E8050, 88E8052, 88E8053,
1780#	88E8055, 88E8056 and D-Link 560T/550SX.
1781# lmc:	Support for the LMC/SBE wide-area network interface cards.
1782# my:	Myson Fast Ethernet (MTD80X, MTD89X)
1783# nge:	Support for PCI gigabit ethernet adapters based on the National
1784#	Semiconductor DP83820 and DP83821 chipset. This includes the
1785#	SMC EZ Card 1000 (SMC9462TX), D-Link DGE-500T, Asante FriendlyNet
1786#	GigaNIX 1000TA and 1000TPC, the Addtron AEG320T, the Surecom
1787#	EP-320G-TX and the Netgear GA622T.
1788# pcn:	Support for PCI fast ethernet adapters based on the AMD Am79c97x
1789#	PCnet-FAST, PCnet-FAST+, PCnet-FAST III, PCnet-PRO and PCnet-Home
1790#	chipsets. These can also be handled by the le(4) driver if the
1791#	pcn(4) driver is left out of the kernel. The le(4) driver does not
1792#	support the additional features like the MII bus and burst mode of
1793#	the PCnet-FAST and greater chipsets though.
1794# rl:   Support for PCI fast ethernet adapters based on the RealTek 8129/8139
1795#       chipset.  Note that the RealTek driver defaults to using programmed
1796#       I/O to do register accesses because memory mapped mode seems to cause
1797#       severe lockups on SMP hardware.  This driver also supports the
1798#       Accton EN1207D `Cheetah' adapter, which uses a chip called
1799#       the MPX 5030/5038, which is either a RealTek in disguise or a
1800#       RealTek workalike.  Note that the D-Link DFE-530TX+ uses the RealTek
1801#       chipset and is supported by this driver, not the 'vr' driver.
1802# sf:   Support for Adaptec Duralink PCI fast ethernet adapters based on the
1803#       Adaptec AIC-6915 "starfire" controller.
1804#       This includes dual and quad port cards, as well as one 100baseFX card.
1805#       Most of these are 64-bit PCI devices, except for one single port
1806#       card which is 32-bit.
1807# sis:  Support for NICs based on the Silicon Integrated Systems SiS 900,
1808#       SiS 7016 and NS DP83815 PCI fast ethernet controller chips.
1809# sbsh:	Support for Granch SBNI16 SHDSL modem PCI adapters
1810# sk:   Support for the SysKonnect SK-984x series PCI gigabit ethernet NICs.
1811#       This includes the SK-9841 and SK-9842 single port cards (single mode
1812#       and multimode fiber) and the SK-9843 and SK-9844 dual port cards
1813#       (also single mode and multimode).
1814#       The driver will autodetect the number of ports on the card and
1815#       attach each one as a separate network interface.
1816# sn:   Support for ISA and PC Card Ethernet devices using the
1817#       SMC91C90/92/94/95 chips.
1818# ste:  Sundance Technologies ST201 PCI fast ethernet controller, includes
1819#       the D-Link DFE-550TX.
1820# stge: Support for gigabit ethernet adapters based on the Sundance/Tamarack
1821#       TC9021 family of controllers, including the Sundance ST2021/ST2023,
1822#       the Sundance/Tamarack TC9021, the D-Link DL-4000 and ASUS NX1101.
1823# ti:   Support for PCI gigabit ethernet NICs based on the Alteon Networks
1824#       Tigon 1 and Tigon 2 chipsets.  This includes the Alteon AceNIC, the
1825#       3Com 3c985, the Netgear GA620 and various others.  Note that you will
1826#       probably want to bump up kern.ipc.nmbclusters a lot to use this driver.
1827# tl:   Support for the Texas Instruments TNETE100 series 'ThunderLAN'
1828#       cards and integrated ethernet controllers.  This includes several
1829#       Compaq Netelligent 10/100 cards and the built-in ethernet controllers
1830#       in several Compaq Prosignia, Proliant and Deskpro systems.  It also
1831#       supports several Olicom 10Mbps and 10/100 boards.
1832# tx:   SMC 9432 TX, BTX and FTX cards. (SMC EtherPower II series)
1833# txp:	Support for 3Com 3cR990 cards with the "Typhoon" chipset
1834# vr:   Support for various fast ethernet adapters based on the VIA
1835#       Technologies VT3043 `Rhine I' and VT86C100A `Rhine II' chips,
1836#       including the D-Link DFE530TX (see 'rl' for DFE530TX+), the Hawking
1837#       Technologies PN102TX, and the AOpen/Acer ALN-320.
1838# vx:   3Com 3C590 and 3C595
1839# wb:   Support for fast ethernet adapters based on the Winbond W89C840F chip.
1840#       Note: this is not the same as the Winbond W89C940F, which is a
1841#       NE2000 clone.
1842# wi:   Lucent WaveLAN/IEEE 802.11 PCMCIA adapters. Note: this supports both
1843#       the PCMCIA and ISA cards: the ISA card is really a PCMCIA to ISA
1844#       bridge with a PCMCIA adapter plugged into it.
1845# xe:   Xircom/Intel EtherExpress Pro100/16 PC Card ethernet controller,
1846#       Accton Fast EtherCard-16, Compaq Netelligent 10/100 PC Card,
1847#       Toshiba 10/100 Ethernet PC Card, Xircom 16-bit Ethernet + Modem 56
1848# xl:   Support for the 3Com 3c900, 3c905, 3c905B and 3c905C (Fast)
1849#       Etherlink XL cards and integrated controllers.  This includes the
1850#       integrated 3c905B-TX chips in certain Dell Optiplex and Dell
1851#       Precision desktop machines and the integrated 3c905-TX chips
1852#       in Dell Latitude laptop docking stations.
1853#       Also supported: 3Com 3c980(C)-TX, 3Com 3cSOHO100-TX, 3Com 3c450-TX
1854
1855# Order for ISA/EISA devices is important here
1856
1857device		cm
1858hint.cm.0.at="isa"
1859hint.cm.0.port="0x2e0"
1860hint.cm.0.irq="9"
1861hint.cm.0.maddr="0xdc000"
1862device		ep
1863device		ex
1864device		fe
1865hint.fe.0.at="isa"
1866hint.fe.0.port="0x300"
1867device		fea
1868device		sn
1869hint.sn.0.at="isa"
1870hint.sn.0.port="0x300"
1871hint.sn.0.irq="10"
1872device		an
1873device		awi
1874device		cnw
1875device		wi
1876device		xe
1877
1878# PCI Ethernet NICs that use the common MII bus controller code.
1879device		bce		# Broadcom BCM5706/BCM5708 Gigabit Ethernet
1880device		bfe		# Broadcom BCM440x 10/100 Ethernet
1881device		bge		# Broadcom BCM570xx Gigabit Ethernet
1882device		cxgb		# Chelsio T3 10 Gigabit Ethernet
1883device		dc		# DEC/Intel 21143 and various workalikes
1884device		fxp		# Intel EtherExpress PRO/100B (82557, 82558)
1885hint.fxp.0.prefer_iomap="0"
1886device		hme		# Sun HME (Happy Meal Ethernet)
1887device		lge		# Level 1 LXT1001 gigabit Ethernet
1888device		my		# Myson Fast Ethernet (MTD80X, MTD89X)
1889device		nge		# NatSemi DP83820 gigabit Ethernet
1890device		rl		# RealTek 8129/8139
1891device		pcn		# AMD Am79C97x PCI 10/100 NICs
1892device		sf		# Adaptec AIC-6915 (``Starfire'')
1893device		sbsh		# Granch SBNI16 SHDSL modem
1894device		sis		# Silicon Integrated Systems SiS 900/SiS 7016
1895device		sk		# SysKonnect SK-984x & SK-982x gigabit Ethernet
1896device		ste		# Sundance ST201 (D-Link DFE-550TX)
1897device		ti		# Alteon Networks Tigon I/II gigabit Ethernet
1898device		tl		# Texas Instruments ThunderLAN
1899device		tx		# SMC EtherPower II (83c170 ``EPIC'')
1900device		vr		# VIA Rhine, Rhine II
1901device		wb		# Winbond W89C840F
1902device		xl		# 3Com 3c90x (``Boomerang'', ``Cyclone'')
1903
1904# PCI Ethernet NICs.
1905device		de		# DEC/Intel DC21x4x (``Tulip'')
1906device		le		# AMD Am7900 LANCE and Am79C9xx PCnet
1907device		mxge		# Myricom Myri-10G 10GbE NIC
1908device		nxge		# Neterion Xframe 10GbE Server/Storage Adapter
1909device		txp		# 3Com 3cR990 (``Typhoon'')
1910device		vx		# 3Com 3c590, 3c595 (``Vortex'')
1911
1912# PCI FDDI NICs.
1913device		fpa
1914
1915# PCI WAN adapters.
1916device		lmc
1917
1918# Use "private" jumbo buffers allocated exclusively for the ti(4) driver.
1919# This option is incompatible with the TI_JUMBO_HDRSPLIT option below.
1920#options 	TI_PRIVATE_JUMBOS
1921# Turn on the header splitting option for the ti(4) driver firmware.  This
1922# only works for Tigon II chips, and has no effect for Tigon I chips.
1923options 	TI_JUMBO_HDRSPLIT
1924
1925# These two options allow manipulating the mbuf cluster size and mbuf size,
1926# respectively.  Be very careful with NIC driver modules when changing
1927# these from their default values, because that can potentially cause a
1928# mismatch between the mbuf size assumed by the kernel and the mbuf size
1929# assumed by a module.  The only driver that currently has the ability to
1930# detect a mismatch is ti(4).
1931options 	MCLSHIFT=12	# mbuf cluster shift in bits, 12 == 4KB
1932options 	MSIZE=512	# mbuf size in bytes
1933
1934#
1935# ATM related options (Cranor version)
1936# (note: this driver cannot be used with the HARP ATM stack)
1937#
1938# The `en' device provides support for Efficient Networks (ENI)
1939# ENI-155 PCI midway cards, and the Adaptec 155Mbps PCI ATM cards (ANA-59x0).
1940#
1941# The `hatm' device provides support for Fore/Marconi HE155 and HE622
1942# ATM PCI cards.
1943#
1944# The `fatm' device provides support for Fore PCA200E ATM PCI cards.
1945#
1946# The `patm' device provides support for IDT77252 based cards like
1947# ProSum's ProATM-155 and ProATM-25 and IDT's evaluation boards.
1948#
1949# atm device provides generic atm functions and is required for
1950# atm devices.
1951# NATM enables the netnatm protocol family that can be used to
1952# bypass TCP/IP.
1953#
1954# utopia provides the access to the ATM PHY chips and is required for en,
1955# hatm and fatm.
1956#
1957# the current driver supports only PVC operations (no atm-arp, no multicast).
1958# for more details, please read the original documents at
1959# http://www.ccrc.wustl.edu/pub/chuck/tech/bsdatm/bsdatm.html
1960#
1961device		atm
1962device		en
1963device		fatm			#Fore PCA200E
1964device		hatm			#Fore/Marconi HE155/622
1965device		patm			#IDT77252 cards (ProATM and IDT)
1966device		utopia			#ATM PHY driver
1967options 	NATM			#native ATM
1968
1969options 	LIBMBPOOL		#needed by patm, iatm
1970
1971#
1972# Sound drivers
1973#
1974# sound: The generic sound driver.
1975#
1976
1977device		sound
1978
1979#
1980# snd_*: Device-specific drivers.
1981#
1982# The flags of the device tells the device a bit more info about the
1983# device that normally is obtained through the PnP interface.
1984#	bit  2..0   secondary DMA channel;
1985#	bit  4      set if the board uses two dma channels;
1986#	bit 15..8   board type, overrides autodetection; leave it
1987#		    zero if don't know what to put in (and you don't,
1988#		    since this is unsupported at the moment...).
1989#
1990# snd_ad1816:		Analog Devices AD1816 ISA PnP/non-PnP.
1991# snd_als4000:		Avance Logic ALS4000 PCI.
1992# snd_atiixp:		ATI IXP 200/300/400 PCI.
1993# snd_au88x0		Aureal Vortex 1/2/Advantage PCI. This driver
1994#			lacks support for playback and recording.
1995# snd_audiocs:		Crystal Semiconductor CS4231 SBus/EBus. Only
1996#			for sparc64.
1997# snd_cmi:		CMedia CMI8338/CMI8738 PCI.
1998# snd_cs4281:		Crystal Semiconductor CS4281 PCI.
1999# snd_csa:		Crystal Semiconductor CS461x/428x PCI. (except
2000#			4281)
2001# snd_ds1:		Yamaha DS-1 PCI.
2002# snd_emu10k1:		Creative EMU10K1 PCI and EMU10K2 (Audigy) PCI.
2003# snd_emu10kx:		Creative SoundBlaster Live! and Audigy
2004# snd_envy24:		VIA Envy24 and compatible, needs snd_spicds.
2005# snd_envy24ht:		VIA Envy24HT and compatible, needs snd_spicds.
2006# snd_es137x:		Ensoniq AudioPCI ES137x PCI.
2007# snd_ess:		Ensoniq ESS ISA PnP/non-PnP, to be used in
2008#			conjunction with snd_sbc.
2009# snd_fm801:		Forte Media FM801 PCI.
2010# snd_gusc:		Gravis UltraSound ISA PnP/non-PnP.
2011# snd_hda:		Intel High Definition Audio (Controller) and
2012#			compatible.
2013# snd_ich:		Intel ICH PCI and some more audio controllers
2014#			embedded in a chipset, for example nVidia
2015#			nForce controllers.
2016# snd_maestro:		ESS Technology Maestro-1/2x PCI.
2017# snd_maestro3:		ESS Technology Maestro-3/Allegro PCI.
2018# snd_mss:		Microsoft Sound System ISA PnP/non-PnP.
2019# snd_neomagic:		Neomagic 256 AV/ZX PCI.
2020# snd_sb16:		Creative SoundBlaster16, to be used in
2021#			conjunction with snd_sbc.
2022# snd_sb8:		Creative SoundBlaster (pre-16), to be used in
2023#			conjunction with snd_sbc.
2024# snd_sbc:		Creative SoundBlaster ISA PnP/non-PnP.
2025#			Supports ESS and Avance ISA chips as well.
2026# snd_spicds:		SPI codec driver, needed by Envy24/Envy24HT drivers.
2027# snd_solo:		ESS Solo-1x PCI.
2028# snd_t4dwave:		Trident 4DWave DX/NX PCI, Sis 7018 PCI and Acer Labs
2029#			M5451 PCI.
2030# snd_via8233:		VIA VT8233x PCI.
2031# snd_via82c686:	VIA VT82C686A PCI.
2032# snd_vibes:		S3 Sonicvibes PCI.
2033# snd_uaudio:		USB audio.
2034
2035device		snd_ad1816
2036device		snd_als4000
2037device		snd_atiixp
2038#device		snd_au88x0
2039#device		snd_audiocs
2040device		snd_cmi
2041device		snd_cs4281
2042device		snd_csa
2043device		snd_ds1
2044device		snd_emu10k1
2045device		snd_emu10kx
2046device		snd_envy24
2047device		snd_envy24ht
2048device		snd_es137x
2049device		snd_ess
2050device		snd_fm801
2051device		snd_gusc
2052device		snd_hda
2053device		snd_ich
2054device		snd_maestro
2055device		snd_maestro3
2056device		snd_mss
2057device		snd_neomagic
2058device		snd_sb16
2059device		snd_sb8
2060device		snd_sbc
2061device		snd_solo
2062device		snd_spicds
2063device		snd_t4dwave
2064device		snd_via8233
2065device		snd_via82c686
2066device		snd_vibes
2067device		snd_uaudio
2068
2069# For non-PnP sound cards:
2070hint.pcm.0.at="isa"
2071hint.pcm.0.irq="10"
2072hint.pcm.0.drq="1"
2073hint.pcm.0.flags="0x0"
2074hint.sbc.0.at="isa"
2075hint.sbc.0.port="0x220"
2076hint.sbc.0.irq="5"
2077hint.sbc.0.drq="1"
2078hint.sbc.0.flags="0x15"
2079hint.gusc.0.at="isa"
2080hint.gusc.0.port="0x220"
2081hint.gusc.0.irq="5"
2082hint.gusc.0.drq="1"
2083hint.gusc.0.flags="0x13"
2084
2085#
2086# IEEE-488 hardware:
2087# pcii:		PCIIA cards (uPD7210 based isa cards)
2088# tnt4882:	National Instruments PCI-GPIB card.
2089
2090device	pcii
2091hint.pcii.0.at="isa"
2092hint.pcii.0.port="0x2e1"
2093hint.pcii.0.irq="5"
2094hint.pcii.0.drq="1"
2095
2096device	tnt4882
2097
2098#
2099# Miscellaneous hardware:
2100#
2101# scd: Sony CD-ROM using proprietary (non-ATAPI) interface
2102# mcd: Mitsumi CD-ROM using proprietary (non-ATAPI) interface
2103# bktr: Brooktree bt848/848a/849a/878/879 video capture and TV Tuner board
2104# cy: Cyclades serial driver
2105# joy: joystick (including IO DATA PCJOY PC Card joystick)
2106# rc: RISCom/8 multiport card
2107# rp: Comtrol Rocketport(ISA/PCI) - single card
2108# si: Specialix SI/XIO 4-32 port terminal multiplexor
2109
2110# Notes on the Comtrol Rocketport driver:
2111#
2112# The exact values used for rp0 depend on how many boards you have
2113# in the system.  The manufacturer's sample configs are listed as:
2114#
2115#               device  rp	# core driver support
2116#
2117#   Comtrol Rocketport ISA single card
2118#		hint.rp.0.at="isa"
2119#		hint.rp.0.port="0x280"
2120#
2121#   If instead you have two ISA cards, one installed at 0x100 and the
2122#   second installed at 0x180, then you should add the following to
2123#   your kernel probe hints:
2124#		hint.rp.0.at="isa"
2125#		hint.rp.0.port="0x100"
2126#		hint.rp.1.at="isa"
2127#		hint.rp.1.port="0x180"
2128#
2129#   For 4 ISA cards, it might be something like this:
2130#		hint.rp.0.at="isa"
2131#		hint.rp.0.port="0x180"
2132#		hint.rp.1.at="isa"
2133#		hint.rp.1.port="0x100"
2134#		hint.rp.2.at="isa"
2135#		hint.rp.2.port="0x340"
2136#		hint.rp.3.at="isa"
2137#		hint.rp.3.port="0x240"
2138#
2139#   For PCI cards, you need no hints.
2140
2141# Mitsumi CD-ROM
2142device		mcd
2143hint.mcd.0.at="isa"
2144hint.mcd.0.port="0x300"
2145# for the Sony CDU31/33A CDROM
2146device		scd
2147hint.scd.0.at="isa"
2148hint.scd.0.port="0x230"
2149device		joy			# PnP aware, hints for non-PnP only
2150hint.joy.0.at="isa"
2151hint.joy.0.port="0x201"
2152device		rc
2153hint.rc.0.at="isa"
2154hint.rc.0.port="0x220"
2155hint.rc.0.irq="12"
2156device		rp
2157hint.rp.0.at="isa"
2158hint.rp.0.port="0x280"
2159device		si
2160options 	SI_DEBUG
2161hint.si.0.at="isa"
2162hint.si.0.maddr="0xd0000"
2163hint.si.0.irq="12"
2164
2165#
2166# The 'bktr' device is a PCI video capture device using the Brooktree
2167# bt848/bt848a/bt849a/bt878/bt879 chipset. When used with a TV Tuner it forms a
2168# TV card, e.g. Miro PC/TV, Hauppauge WinCast/TV WinTV, VideoLogic Captivator,
2169# Intel Smart Video III, AverMedia, IMS Turbo, FlyVideo.
2170#
2171# options 	OVERRIDE_CARD=xxx
2172# options 	OVERRIDE_TUNER=xxx
2173# options 	OVERRIDE_MSP=1
2174# options 	OVERRIDE_DBX=1
2175# These options can be used to override the auto detection
2176# The current values for xxx are found in src/sys/dev/bktr/bktr_card.h
2177# Using sysctl(8) run-time overrides on a per-card basis can be made
2178#
2179# options 	BROOKTREE_SYSTEM_DEFAULT=BROOKTREE_PAL
2180# or
2181# options 	BROOKTREE_SYSTEM_DEFAULT=BROOKTREE_NTSC
2182# Specifies the default video capture mode.
2183# This is required for Dual Crystal (28&35Mhz) boards where PAL is used
2184# to prevent hangs during initialisation, e.g. VideoLogic Captivator PCI.
2185#
2186# options 	BKTR_USE_PLL
2187# This is required for PAL or SECAM boards with a 28Mhz crystal and no 35Mhz
2188# crystal, e.g. some new Bt878 cards.
2189#
2190# options 	BKTR_GPIO_ACCESS
2191# This enable IOCTLs which give user level access to the GPIO port.
2192#
2193# options 	BKTR_NO_MSP_RESET
2194# Prevents the MSP34xx reset. Good if you initialise the MSP in another OS first
2195#
2196# options 	BKTR_430_FX_MODE
2197# Switch Bt878/879 cards into Intel 430FX chipset compatibility mode.
2198#
2199# options 	BKTR_SIS_VIA_MODE
2200# Switch Bt878/879 cards into SIS/VIA chipset compatibility mode which is
2201# needed for some old SiS and VIA chipset motherboards.
2202# This also allows Bt878/879 chips to work on old OPTi (<1997) chipset
2203# motherboards and motherboards with bad or incomplete PCI 2.1 support.
2204# As a rough guess, old = before 1998
2205#
2206# options 	BKTR_NEW_MSP34XX_DRIVER
2207# Use new, more complete initialization scheme for the msp34* soundchip.
2208# Should fix stereo autodetection if the old driver does only output
2209# mono sound.
2210
2211#
2212# options 	BKTR_USE_FREEBSD_SMBUS
2213# Compile with FreeBSD SMBus implementation
2214#
2215# Brooktree driver has been ported to the new I2C framework. Thus,
2216# you'll need to have the following 3 lines in the kernel config.
2217#     device smbus
2218#     device iicbus
2219#     device iicbb
2220#     device iicsmb
2221# The iic and smb devices are only needed if you want to control other
2222# I2C slaves connected to the external connector of some cards.
2223#
2224device		bktr
2225
2226#
2227# PC Card/PCMCIA and Cardbus
2228#
2229# cbb: pci/cardbus bridge implementing YENTA interface
2230# pccard: pccard slots
2231# cardbus: cardbus slots
2232device		cbb
2233device		pccard
2234device		cardbus
2235
2236#
2237# MMC/SD
2238#
2239# mmc: mmc bus
2240# mmcsd: mmc memory and sd cards.
2241#device		mmc
2242#device		mmcsd
2243
2244#
2245# SMB bus
2246#
2247# System Management Bus support is provided by the 'smbus' device.
2248# Access to the SMBus device is via the 'smb' device (/dev/smb*),
2249# which is a child of the 'smbus' device.
2250#
2251# Supported devices:
2252# smb		standard I/O through /dev/smb*
2253#
2254# Supported SMB interfaces:
2255# iicsmb	I2C to SMB bridge with any iicbus interface
2256# bktr		brooktree848 I2C hardware interface
2257# intpm		Intel PIIX4 (82371AB, 82443MX) Power Management Unit
2258# alpm		Acer Aladdin-IV/V/Pro2 Power Management Unit
2259# ichsmb	Intel ICH SMBus controller chips (82801AA, 82801AB, 82801BA)
2260# viapm		VIA VT82C586B/596B/686A and VT8233 Power Management Unit
2261# amdpm		AMD 756 Power Management Unit
2262# amdsmb	AMD 8111 SMBus 2.0 Controller
2263# nfpm		NVIDIA nForce Power Management Unit
2264# nfsmb		NVIDIA nForce2/3/4 MCP SMBus 2.0 Controller
2265#
2266device		smbus		# Bus support, required for smb below.
2267
2268device		intpm
2269device		alpm
2270device		ichsmb
2271device		viapm
2272device		amdpm
2273device		amdsmb
2274device		nfpm
2275device		nfsmb
2276
2277device		smb
2278
2279#
2280# I2C Bus
2281#
2282# Philips i2c bus support is provided by the `iicbus' device.
2283#
2284# Supported devices:
2285# ic	i2c network interface
2286# iic	i2c standard io
2287# iicsmb i2c to smb bridge. Allow i2c i/o with smb commands.
2288#
2289# Supported interfaces:
2290# bktr	brooktree848 I2C software interface
2291#
2292# Other:
2293# iicbb	generic I2C bit-banging code (needed by lpbb, bktr)
2294#
2295device		iicbus		# Bus support, required for ic/iic/iicsmb below.
2296device		iicbb
2297
2298device		ic
2299device		iic
2300device		iicsmb		# smb over i2c bridge
2301
2302# Parallel-Port Bus
2303#
2304# Parallel port bus support is provided by the `ppbus' device.
2305# Multiple devices may be attached to the parallel port, devices
2306# are automatically probed and attached when found.
2307#
2308# Supported devices:
2309# vpo	Iomega Zip Drive
2310#	Requires SCSI disk support ('scbus' and 'da'), best
2311#	performance is achieved with ports in EPP 1.9 mode.
2312# lpt	Parallel Printer
2313# plip	Parallel network interface
2314# ppi	General-purpose I/O ("Geek Port") + IEEE1284 I/O
2315# pps	Pulse per second Timing Interface
2316# lpbb	Philips official parallel port I2C bit-banging interface
2317#
2318# Supported interfaces:
2319# ppc	ISA-bus parallel port interfaces.
2320#
2321
2322options 	PPC_PROBE_CHIPSET # Enable chipset specific detection
2323				  # (see flags in ppc(4))
2324options 	DEBUG_1284	# IEEE1284 signaling protocol debug
2325options 	PERIPH_1284	# Makes your computer act as an IEEE1284
2326				# compliant peripheral
2327options 	DONTPROBE_1284	# Avoid boot detection of PnP parallel devices
2328options 	VP0_DEBUG	# ZIP/ZIP+ debug
2329options 	LPT_DEBUG	# Printer driver debug
2330options 	PPC_DEBUG	# Parallel chipset level debug
2331options 	PLIP_DEBUG	# Parallel network IP interface debug
2332options 	PCFCLOCK_VERBOSE         # Verbose pcfclock driver
2333options 	PCFCLOCK_MAX_RETRIES=5   # Maximum read tries (default 10)
2334
2335device		ppc
2336hint.ppc.0.at="isa"
2337hint.ppc.0.irq="7"
2338device		ppbus
2339device		vpo
2340device		lpt
2341device		plip
2342device		ppi
2343device		pps
2344device		lpbb
2345device		pcfclock
2346
2347# Kernel BOOTP support
2348
2349options 	BOOTP		# Use BOOTP to obtain IP address/hostname
2350				# Requires NFSCLIENT and NFS_ROOT
2351options 	BOOTP_NFSROOT	# NFS mount root filesystem using BOOTP info
2352options 	BOOTP_NFSV3	# Use NFS v3 to NFS mount root
2353options 	BOOTP_COMPAT	# Workaround for broken bootp daemons.
2354options 	BOOTP_WIRED_TO=fxp0 # Use interface fxp0 for BOOTP
2355
2356#
2357# Add software watchdog routines.
2358#
2359options 	SW_WATCHDOG
2360
2361#
2362# Disable swapping of stack pages.  This option removes all
2363# code which actually performs swapping, so it's not possible to turn
2364# it back on at run-time.
2365#
2366# This is sometimes usable for systems which don't have any swap space
2367# (see also sysctls "vm.defer_swapspace_pageouts" and
2368# "vm.disable_swapspace_pageouts")
2369#
2370#options 	NO_SWAPPING
2371
2372# Set the number of sf_bufs to allocate. sf_bufs are virtual buffers
2373# for sendfile(2) that are used to map file VM pages, and normally
2374# default to a quantity that is roughly 16*MAXUSERS+512. You would
2375# typically want about 4 of these for each simultaneous file send.
2376#
2377options 	NSFBUFS=1024
2378
2379#
2380# Enable extra debugging code for locks.  This stores the filename and
2381# line of whatever acquired the lock in the lock itself, and change a
2382# number of function calls to pass around the relevant data.  This is
2383# not at all useful unless you are debugging lock code.  Also note
2384# that it is likely to break e.g. fstat(1) unless you recompile your
2385# userland with -DDEBUG_LOCKS as well.
2386#
2387options 	DEBUG_LOCKS
2388
2389
2390#####################################################################
2391# USB support
2392# UHCI controller
2393device		uhci
2394# OHCI controller
2395device		ohci
2396# EHCI controller
2397device		ehci
2398# SL811 Controller
2399device 		slhci
2400# General USB code (mandatory for USB)
2401device		usb
2402#
2403# USB Double Bulk Pipe devices
2404device		udbp
2405# USB Fm Radio
2406device		ufm
2407# Generic USB device driver
2408device		ugen
2409# Human Interface Device (anything with buttons and dials)
2410device		uhid
2411# USB keyboard
2412device		ukbd
2413# USB printer
2414device		ulpt
2415# USB Iomega Zip 100 Drive (Requires scbus and da)
2416device		umass
2417# USB support for Belkin F5U109 and Magic Control Technology serial adapters
2418device		umct
2419# USB modem support
2420device		umodem
2421# USB mouse
2422device		ums
2423# Diamond Rio 500 MP3 player
2424device		urio
2425# USB scanners
2426device		uscanner
2427#
2428# USB serial support
2429device		ucom
2430# USB support for Technologies ARK3116 based serial adapters
2431device		uark
2432# USB support for Belkin F5U103 and compatible serial adapters
2433device		ubsa
2434# USB support for BWCT console serial adapters
2435device		ubser
2436# USB support for serial adapters based on the FT8U100AX and FT8U232AM
2437device		uftdi
2438# USB support for some Windows CE based serial communication.
2439device		uipaq
2440# USB support for Prolific PL-2303 serial adapters
2441device		uplcom
2442# USB Visor and Palm devices
2443device		uvisor
2444# USB serial support for DDI pocket's PHS
2445device		uvscom
2446#
2447# ADMtek USB ethernet. Supports the LinkSys USB100TX,
2448# the Billionton USB100, the Melco LU-ATX, the D-Link DSB-650TX
2449# and the SMC 2202USB. Also works with the ADMtek AN986 Pegasus
2450# eval board.
2451device		aue
2452
2453# ASIX Electronics AX88172 USB 2.0 ethernet driver. Used in the
2454# LinkSys USB200M and various other adapters.
2455
2456device		axe
2457
2458#
2459# Devices which communicate using Ethernet over USB, particularly
2460# Communication Device Class (CDC) Ethernet specification. Supports
2461# Sharp Zaurus PDAs, some DOCSIS cable modems and so on.
2462device		cdce
2463#
2464# CATC USB-EL1201A USB ethernet. Supports the CATC Netmate
2465# and Netmate II, and the Belkin F5U111.
2466device		cue
2467#
2468# Kawasaki LSI ethernet. Supports the LinkSys USB10T,
2469# Entrega USB-NET-E45, Peracom Ethernet Adapter, the
2470# 3Com 3c19250, the ADS Technologies USB-10BT, the ATen UC10T,
2471# the Netgear EA101, the D-Link DSB-650, the SMC 2102USB
2472# and 2104USB, and the Corega USB-T.
2473device		kue
2474#
2475# RealTek RTL8150 USB to fast ethernet. Supports the Melco LUA-KTX
2476# and the GREEN HOUSE GH-USB100B.
2477device		rue
2478#
2479# Davicom DM9601E USB to fast ethernet. Supports the Corega FEther USB-TXC.
2480device		udav
2481
2482
2483# debugging options for the USB subsystem
2484#
2485options 	USB_DEBUG
2486
2487# options for ukbd:
2488options 	UKBD_DFLT_KEYMAP	# specify the built-in keymap
2489makeoptions	UKBD_DFLT_KEYMAP=it.iso
2490
2491# options for uplcom:
2492options 	UPLCOM_INTR_INTERVAL=100	# interrupt pipe interval
2493						# in milliseconds
2494
2495# options for uvscom:
2496options 	UVSCOM_DEFAULT_OPKTSIZE=8	# default output packet size
2497options 	UVSCOM_INTR_INTERVAL=100	# interrupt pipe interval
2498						# in milliseconds
2499
2500#####################################################################
2501# FireWire support
2502
2503device		firewire	# FireWire bus code
2504device		sbp		# SCSI over Firewire (Requires scbus and da)
2505device		sbp_targ	# SBP-2 Target mode  (Requires scbus and targ)
2506device		fwe		# Ethernet over FireWire (non-standard!)
2507device		fwip		# IP over FireWire (RFC2734 and RFC3146)
2508
2509#####################################################################
2510# dcons support (Dumb Console Device)
2511
2512device		dcons			# dumb console driver
2513device		dcons_crom		# FireWire attachment
2514options 	DCONS_BUF_SIZE=16384	# buffer size
2515options 	DCONS_POLL_HZ=100	# polling rate
2516options 	DCONS_FORCE_CONSOLE=0	# force to be the primary console
2517options 	DCONS_FORCE_GDB=1	# force to be the gdb device
2518
2519#####################################################################
2520# crypto subsystem
2521#
2522# This is a port of the OpenBSD crypto framework.  Include this when
2523# configuring IPSEC and when you have a h/w crypto device to accelerate
2524# user applications that link to OpenSSL.
2525#
2526# Drivers are ports from OpenBSD with some simple enhancements that have
2527# been fed back to OpenBSD.
2528
2529device		crypto		# core crypto support
2530device		cryptodev	# /dev/crypto for access to h/w
2531
2532device		rndtest		# FIPS 140-2 entropy tester
2533
2534device		hifn		# Hifn 7951, 7781, etc.
2535options 	HIFN_DEBUG	# enable debugging support: hw.hifn.debug
2536options 	HIFN_RNDTEST	# enable rndtest support
2537
2538device		ubsec		# Broadcom 5501, 5601, 58xx
2539options 	UBSEC_DEBUG	# enable debugging support: hw.ubsec.debug
2540options 	UBSEC_RNDTEST	# enable rndtest support
2541
2542#####################################################################
2543
2544
2545#
2546# Embedded system options:
2547#
2548# An embedded system might want to run something other than init.
2549options 	INIT_PATH=/sbin/init:/stand/sysinstall
2550
2551# Debug options
2552options 	BUS_DEBUG	# enable newbus debugging
2553options 	DEBUG_VFS_LOCKS	# enable VFS lock debugging
2554options 	SOCKBUF_DEBUG	# enable sockbuf last record/mb tail checking
2555
2556#
2557# Verbose SYSINIT
2558#
2559# Make the SYSINIT process performed by mi_startup() verbose.  This is very
2560# useful when porting to a new architecture.  If DDB is also enabled, this
2561# will print function names instead of addresses.
2562options 	VERBOSE_SYSINIT
2563
2564#####################################################################
2565# SYSV IPC KERNEL PARAMETERS
2566#
2567# Maximum number of entries in a semaphore map.
2568options 	SEMMAP=31
2569
2570# Maximum number of System V semaphores that can be used on the system at
2571# one time.
2572options 	SEMMNI=11
2573
2574# Total number of semaphores system wide
2575options 	SEMMNS=61
2576
2577# Total number of undo structures in system
2578options 	SEMMNU=31
2579
2580# Maximum number of System V semaphores that can be used by a single process
2581# at one time.
2582options 	SEMMSL=61
2583
2584# Maximum number of operations that can be outstanding on a single System V
2585# semaphore at one time.
2586options 	SEMOPM=101
2587
2588# Maximum number of undo operations that can be outstanding on a single
2589# System V semaphore at one time.
2590options 	SEMUME=11
2591
2592# Maximum number of shared memory pages system wide.
2593options 	SHMALL=1025
2594
2595# Maximum size, in bytes, of a single System V shared memory region.
2596options 	SHMMAX=(SHMMAXPGS*PAGE_SIZE+1)
2597options 	SHMMAXPGS=1025
2598
2599# Minimum size, in bytes, of a single System V shared memory region.
2600options 	SHMMIN=2
2601
2602# Maximum number of shared memory regions that can be used on the system
2603# at one time.
2604options 	SHMMNI=33
2605
2606# Maximum number of System V shared memory regions that can be attached to
2607# a single process at one time.
2608options 	SHMSEG=9
2609
2610# Set the amount of time (in seconds) the system will wait before
2611# rebooting automatically when a kernel panic occurs.  If set to (-1),
2612# the system will wait indefinitely until a key is pressed on the
2613# console.
2614options 	PANIC_REBOOT_WAIT_TIME=16
2615
2616# Attempt to bypass the buffer cache and put data directly into the
2617# userland buffer for read operation when O_DIRECT flag is set on the
2618# file.  Both offset and length of the read operation must be
2619# multiples of the physical media sector size.
2620#
2621options 	DIRECTIO
2622
2623# Specify a lower limit for the number of swap I/O buffers.  They are
2624# (among other things) used when bypassing the buffer cache due to
2625# DIRECTIO kernel option enabled and O_DIRECT flag set on file.
2626#
2627options 	NSWBUF_MIN=120
2628
2629#####################################################################
2630
2631# More undocumented options for linting.
2632# Note that documenting these are not considered an affront.
2633
2634options 	CAM_DEBUG_DELAY
2635
2636# VFS cluster debugging.
2637options 	CLUSTERDEBUG
2638
2639options 	DEBUG
2640
2641# Kernel filelock debugging.
2642options 	LOCKF_DEBUG
2643
2644# System V compatible message queues
2645# Please note that the values provided here are used to test kernel
2646# building.  The defaults in the sources provide almost the same numbers.
2647# MSGSSZ must be a power of 2 between 8 and 1024.
2648options 	MSGMNB=2049	# Max number of chars in queue
2649options 	MSGMNI=41	# Max number of message queue identifiers
2650options 	MSGSEG=2049	# Max number of message segments
2651options 	MSGSSZ=16	# Size of a message segment
2652options 	MSGTQL=41	# Max number of messages in system
2653
2654options 	NBUF=512	# Number of buffer headers
2655
2656options 	SCSI_NCR_DEBUG
2657options 	SCSI_NCR_MAX_SYNC=10000
2658options 	SCSI_NCR_MAX_WIDE=1
2659options 	SCSI_NCR_MYADDR=7
2660
2661options 	SC_DEBUG_LEVEL=5	# Syscons debug level
2662options 	SC_RENDER_DEBUG	# syscons rendering debugging
2663
2664options 	SHOW_BUSYBUFS	# List buffers that prevent root unmount
2665options 	SLIP_IFF_OPTS
2666options 	VFS_BIO_DEBUG	# VFS buffer I/O debugging
2667
2668options 	KSTACK_MAX_PAGES=32 # Maximum pages to give the kernel stack
2669
2670# Adaptec Array Controller driver options
2671options 	AAC_DEBUG	# Debugging levels:
2672				# 0 - quiet, only emit warnings
2673				# 1 - noisy, emit major function
2674				#     points and things done
2675				# 2 - extremely noisy, emit trace
2676				#     items in loops, etc.
2677
2678# Yet more undocumented options for linting.
2679# BKTR_ALLOC_PAGES has no effect except to cause warnings, and
2680# BROOKTREE_ALLOC_PAGES hasn't actually been superseded by it, since the
2681# driver still mostly spells this option BROOKTREE_ALLOC_PAGES.
2682##options 	BKTR_ALLOC_PAGES=(217*4+1)
2683options 	BROOKTREE_ALLOC_PAGES=(217*4+1)
2684options 	MAXFILES=999
2685