The Design and Implementation of the FreeBSD Operating System, Second Edition
Now available: The Design and Implementation of the FreeBSD Operating System (Second Edition)


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]

FreeBSD/Linux Kernel Cross Reference
sys/conf/NOTES

Version: -  FREEBSD  -  FREEBSD-13-STABLE  -  FREEBSD-13-0  -  FREEBSD-12-STABLE  -  FREEBSD-12-0  -  FREEBSD-11-STABLE  -  FREEBSD-11-0  -  FREEBSD-10-STABLE  -  FREEBSD-10-0  -  FREEBSD-9-STABLE  -  FREEBSD-9-0  -  FREEBSD-8-STABLE  -  FREEBSD-8-0  -  FREEBSD-7-STABLE  -  FREEBSD-7-0  -  FREEBSD-6-STABLE  -  FREEBSD-6-0  -  FREEBSD-5-STABLE  -  FREEBSD-5-0  -  FREEBSD-4-STABLE  -  FREEBSD-3-STABLE  -  FREEBSD22  -  l41  -  OPENBSD  -  linux-2.6  -  MK84  -  PLAN9  -  xnu-8792 
SearchContext: -  none  -  3  -  10 

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

Cache object: 7221c4c99242db5afad3b2c9f443c14d


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]


This page is part of the FreeBSD/Linux Linux Kernel Cross-Reference, and was automatically generated using a modified version of the LXR engine.