Deleted Added
full compact
NOTES (161380) NOTES (161567)
1# $FreeBSD: head/sys/conf/NOTES 161380 2006-08-17 00:37:03Z julian $
1# $FreeBSD: head/sys/conf/NOTES 161567 2006-08-24 08:00:02Z ru $
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

--- 41 unchanged lines hidden (view full) ---

51maxusers 10
52
53#
54# The `makeoptions' parameter allows variables to be passed to the
55# generated Makefile in the build area.
56#
57# CONF_CFLAGS gives some extra compiler flags that are added to ${CFLAGS}
58# after most other flags. Here we use it to inhibit use of non-optimal
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

--- 41 unchanged lines hidden (view full) ---

51maxusers 10
52
53#
54# The `makeoptions' parameter allows variables to be passed to the
55# generated Makefile in the build area.
56#
57# CONF_CFLAGS gives some extra compiler flags that are added to ${CFLAGS}
58# after most other flags. Here we use it to inhibit use of non-optimal
59# gcc builtin functions (e.g., memcmp).
59# gcc built-in 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#

--- 67 unchanged lines hidden (view full) ---

135options GEOM_NOP # Test class.
136options GEOM_PC98 # NEC PC9800 partitioning
137options GEOM_RAID3 # RAID3 functionality.
138options GEOM_SHSEC # Shared secret.
139options GEOM_STRIPE # Disk striping.
140options GEOM_SUNLABEL # Sun/Solaris partitioning
141options GEOM_UZIP # Read-only compressed disks
142options GEOM_VOL # Volume names from UFS superblock
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#

--- 67 unchanged lines hidden (view full) ---

135options GEOM_NOP # Test class.
136options GEOM_PC98 # NEC PC9800 partitioning
137options GEOM_RAID3 # RAID3 functionality.
138options GEOM_SHSEC # Shared secret.
139options GEOM_STRIPE # Disk striping.
140options GEOM_SUNLABEL # Sun/Solaris partitioning
141options GEOM_UZIP # Read-only compressed disks
142options GEOM_VOL # Volume names from UFS superblock
143options GEOM_ZERO # Peformance testing helper.
143options GEOM_ZERO # Performance testing helper.
144
145#
146# The root device and filesystem type can be compiled in;
147# this provides a fallback option if the root device cannot
148# be correctly guessed by the bootstrap code, or an override if
149# the RB_DFLTROOT flag (-r) is specified when booting the kernel.
150#
151options ROOTDEVNAME=\"ufs:da0s2e\"
152
153
154#####################################################################
155# Scheduler options:
156#
157# Specifying one of SCHED_4BSD or SCHED_ULE is mandatory. These options
158# select which scheduler is compiled in.
159#
160# SCHED_4BSD is the historical, proven, BSD scheduler. It has a global run
144
145#
146# The root device and filesystem type can be compiled in;
147# this provides a fallback option if the root device cannot
148# be correctly guessed by the bootstrap code, or an override if
149# the RB_DFLTROOT flag (-r) is specified when booting the kernel.
150#
151options ROOTDEVNAME=\"ufs:da0s2e\"
152
153
154#####################################################################
155# Scheduler options:
156#
157# Specifying one of SCHED_4BSD or SCHED_ULE is mandatory. These options
158# select which scheduler is compiled in.
159#
160# SCHED_4BSD is the historical, proven, BSD scheduler. It has a global run
161# queue and no cpu affinity which makes it suboptimal for SMP. It has very
161# queue and no CPU affinity which makes it suboptimal for SMP. It has very
162# good interactivity and priority selection.
163#
164# SCHED_ULE is a new scheduler that has been designed for SMP and has some
165# advantages for UP as well. It is intended to replace the 4BSD scheduler
166# over time.
167#
168options SCHED_4BSD
169#options SCHED_CORE

--- 147 unchanged lines hidden (view full) ---

317#
318# Enable the remote gdb debugger backend.
319#
320options GDB
321
322#
323# SYSCTL_DEBUG enables a 'sysctl' debug tree that can be used to dump the
324# contents of the registered sysctl nodes on the console. It is disabled by
162# good interactivity and priority selection.
163#
164# SCHED_ULE is a new scheduler that has been designed for SMP and has some
165# advantages for UP as well. It is intended to replace the 4BSD scheduler
166# over time.
167#
168options SCHED_4BSD
169#options SCHED_CORE

--- 147 unchanged lines hidden (view full) ---

317#
318# Enable the remote gdb debugger backend.
319#
320options GDB
321
322#
323# SYSCTL_DEBUG enables a 'sysctl' debug tree that can be used to dump the
324# contents of the registered sysctl nodes on the console. It is disabled by
325# default because it generates excessively verbose consol output that can
325# default because it generates excessively verbose console output that can
326# interfere with serial console operation.
327#
328options SYSCTL_DEBUG
329
330#
331# DEBUG_MEMGUARD builds and enables memguard(9), a replacement allocator
332# for the kernel used to detect modify-after-free scenarios. See the
333# memguard(9) man page for more information on usage.

--- 22 unchanged lines hidden (view full) ---

356# KTR is a kernel tracing mechanism imported from BSD/OS. Currently
357# it has no userland interface aside from a few sysctl's. It is
358# enabled with the KTR option. KTR_ENTRIES defines the number of
359# entries in the circular trace buffer; it must be a power of two.
360# KTR_COMPILE defines the mask of events to compile into the kernel as
361# defined by the KTR_* constants in <sys/ktr.h>. KTR_MASK defines the
362# initial value of the ktr_mask variable which determines at runtime
363# what events to trace. KTR_CPUMASK determines which CPU's log
326# interfere with serial console operation.
327#
328options SYSCTL_DEBUG
329
330#
331# DEBUG_MEMGUARD builds and enables memguard(9), a replacement allocator
332# for the kernel used to detect modify-after-free scenarios. See the
333# memguard(9) man page for more information on usage.

--- 22 unchanged lines hidden (view full) ---

356# KTR is a kernel tracing mechanism imported from BSD/OS. Currently
357# it has no userland interface aside from a few sysctl's. It is
358# enabled with the KTR option. KTR_ENTRIES defines the number of
359# entries in the circular trace buffer; it must be a power of two.
360# KTR_COMPILE defines the mask of events to compile into the kernel as
361# defined by the KTR_* constants in <sys/ktr.h>. KTR_MASK defines the
362# initial value of the ktr_mask variable which determines at runtime
363# what events to trace. KTR_CPUMASK determines which CPU's log
364# events, with bit X corresponding to cpu X. KTR_VERBOSE enables
364# events, with bit X corresponding to CPU X. KTR_VERBOSE enables
365# dumping of KTR events to the console by default. This functionality
366# can be toggled via the debug.ktr_verbose sysctl and defaults to off
367# if KTR_VERBOSE is not defined.
368#
369options KTR
370options KTR_ENTRIES=1024
371options KTR_COMPILE=(KTR_INTR|KTR_PROC)
372options KTR_MASK=KTR_INTR
373options KTR_CPUMASK=0x3
374options KTR_VERBOSE
375
376#
365# dumping of KTR events to the console by default. This functionality
366# can be toggled via the debug.ktr_verbose sysctl and defaults to off
367# if KTR_VERBOSE is not defined.
368#
369options KTR
370options KTR_ENTRIES=1024
371options KTR_COMPILE=(KTR_INTR|KTR_PROC)
372options KTR_MASK=KTR_INTR
373options KTR_CPUMASK=0x3
374options KTR_VERBOSE
375
376#
377# ALQ(9) is a facilty for the asynchronous queuing of records from the kernel
377# ALQ(9) is a facility for the asynchronous queuing of records from the kernel
378# to a vnode, and is employed by services such as KTR(4) to produce trace
379# files based on a kernel event stream. Records are written asynchronously
380# in a worker thread.
381#
382options ALQ
383options KTR_ALQ
384
385#

--- 334 unchanged lines hidden (view full) ---

720#
721# IPFIREWALL_FORWARD enables changing of the packet destination either
722# to do some sort of policy routing or transparent proxying. Used by
723# ``ipfw forward''. All redirections apply to locally generated
724# packets too. Because of this great care is required when
725# crafting the ruleset.
726#
727# IPSTEALTH enables code to support stealth forwarding (i.e., forwarding
378# to a vnode, and is employed by services such as KTR(4) to produce trace
379# files based on a kernel event stream. Records are written asynchronously
380# in a worker thread.
381#
382options ALQ
383options KTR_ALQ
384
385#

--- 334 unchanged lines hidden (view full) ---

720#
721# IPFIREWALL_FORWARD enables changing of the packet destination either
722# to do some sort of policy routing or transparent proxying. Used by
723# ``ipfw forward''. All redirections apply to locally generated
724# packets too. Because of this great care is required when
725# crafting the ruleset.
726#
727# IPSTEALTH enables code to support stealth forwarding (i.e., forwarding
728# packets without touching the ttl). This can be useful to hide firewalls
728# packets without touching the TTL). This can be useful to hide firewalls
729# from traceroute and similar tools.
730#
731# TCPDEBUG enables code which keeps traces of the TCP state machine
732# for sockets with the SO_DEBUG option set, which can then be examined
733# using the trpt(8) utility.
734#
735options MROUTING # Multicast routing
736options PIM # Protocol Independent Multicast

--- 231 unchanged lines hidden (view full) ---

968# filesystems are not suitable for exporting through NFS, or any other
969# application that requires fixed inode numbers.
970options MSDOSFS_LARGE
971
972
973#####################################################################
974# POSIX P1003.1B
975
729# from traceroute and similar tools.
730#
731# TCPDEBUG enables code which keeps traces of the TCP state machine
732# for sockets with the SO_DEBUG option set, which can then be examined
733# using the trpt(8) utility.
734#
735options MROUTING # Multicast routing
736options PIM # Protocol Independent Multicast

--- 231 unchanged lines hidden (view full) ---

968# filesystems are not suitable for exporting through NFS, or any other
969# application that requires fixed inode numbers.
970options MSDOSFS_LARGE
971
972
973#####################################################################
974# POSIX P1003.1B
975
976# Real time extensions added in the 1993 Posix
976# Real time extensions added in the 1993 POSIX
977# _KPOSIX_PRIORITY_SCHEDULING: Build in _POSIX_PRIORITY_SCHEDULING
978
979options _KPOSIX_PRIORITY_SCHEDULING
980# p1003_1b_semaphores are very experimental,
981# user should be ready to assist in debugging if problems arise.
982options P1003_1B_SEMAPHORES
983
984# POSIX message queue

--- 305 unchanged lines hidden (view full) ---

1290device fire_saver
1291device green_saver
1292device logo_saver
1293device rain_saver
1294device snake_saver
1295device star_saver
1296device warp_saver
1297
977# _KPOSIX_PRIORITY_SCHEDULING: Build in _POSIX_PRIORITY_SCHEDULING
978
979options _KPOSIX_PRIORITY_SCHEDULING
980# p1003_1b_semaphores are very experimental,
981# user should be ready to assist in debugging if problems arise.
982options P1003_1B_SEMAPHORES
983
984# POSIX message queue

--- 305 unchanged lines hidden (view full) ---

1290device fire_saver
1291device green_saver
1292device logo_saver
1293device rain_saver
1294device snake_saver
1295device star_saver
1296device warp_saver
1297
1298# The syscons console driver (sco color console compatible).
1298# The syscons console driver (SCO color console compatible).
1299device sc
1300hint.sc.0.at="isa"
1301options MAXCONS=16 # number of virtual consoles
1302options SC_ALT_MOUSE_IMAGE # simplified mouse cursor in text mode
1303options SC_DFLT_FONT # compile font in
1304makeoptions SC_DFLT_FONT=cp850
1305options SC_DISABLE_KDBKEY # disable `debug' key
1306options SC_DISABLE_REBOOT # disable reboot key sequence

--- 635 unchanged lines hidden (view full) ---

1942# snd_ich: Intel ICH PCI and some more audio controllers
1943# embedded in a chipset, for example nVidia
1944# nForce controllers.
1945# snd_maestro: ESS Technology Maestro-1/2x PCI.
1946# snd_maestro3: ESS Technology Maestro-3/Allegro PCI.
1947# snd_mss: Microsoft Sound System ISA PnP/non-PnP.
1948# snd_neomagic: Neomagic 256 AV/ZX PCI.
1949# snd_sb16: Creative SoundBlaster16, to be used in
1299device sc
1300hint.sc.0.at="isa"
1301options MAXCONS=16 # number of virtual consoles
1302options SC_ALT_MOUSE_IMAGE # simplified mouse cursor in text mode
1303options SC_DFLT_FONT # compile font in
1304makeoptions SC_DFLT_FONT=cp850
1305options SC_DISABLE_KDBKEY # disable `debug' key
1306options SC_DISABLE_REBOOT # disable reboot key sequence

--- 635 unchanged lines hidden (view full) ---

1942# snd_ich: Intel ICH PCI and some more audio controllers
1943# embedded in a chipset, for example nVidia
1944# nForce controllers.
1945# snd_maestro: ESS Technology Maestro-1/2x PCI.
1946# snd_maestro3: ESS Technology Maestro-3/Allegro PCI.
1947# snd_mss: Microsoft Sound System ISA PnP/non-PnP.
1948# snd_neomagic: Neomagic 256 AV/ZX PCI.
1949# snd_sb16: Creative SoundBlaster16, to be used in
1950# conjuction with snd_sbc.
1950# conjunction with snd_sbc.
1951# snd_sb8: Creative SoundBlaster (pre-16), to be used in
1951# snd_sb8: Creative SoundBlaster (pre-16), to be used in
1952# conjuction with snd_sbc.
1952# conjunction with snd_sbc.
1953# snd_sbc: Creative SoundBlaster ISA PnP/non-PnP.
1954# Supports ESS and Avance ISA chips as well.
1955# snd_solo: ESS Solo-1x PCI.
1956# snd_t4dwave: Trident 4DWave DX/NX PCI, Sis 7018 PCI and Acer Labs
1957# M5451 PCI.
1958# snd_via8233: VIA VT8233x PCI.
1959# snd_via82c686: VIA VT82C686A PCI.
1960# snd_vibes: S3 Sonicvibes PCI.

--- 27 unchanged lines hidden (view full) ---

1988device snd_sbc
1989device snd_solo
1990device snd_t4dwave
1991device snd_via8233
1992device snd_via82c686
1993device snd_vibes
1994device snd_uaudio
1995
1953# snd_sbc: Creative SoundBlaster ISA PnP/non-PnP.
1954# Supports ESS and Avance ISA chips as well.
1955# snd_solo: ESS Solo-1x PCI.
1956# snd_t4dwave: Trident 4DWave DX/NX PCI, Sis 7018 PCI and Acer Labs
1957# M5451 PCI.
1958# snd_via8233: VIA VT8233x PCI.
1959# snd_via82c686: VIA VT82C686A PCI.
1960# snd_vibes: S3 Sonicvibes PCI.

--- 27 unchanged lines hidden (view full) ---

1988device snd_sbc
1989device snd_solo
1990device snd_t4dwave
1991device snd_via8233
1992device snd_via82c686
1993device snd_vibes
1994device snd_uaudio
1995
1996# For non-pnp sound cards:
1996# For non-PnP sound cards:
1997hint.pcm.0.at="isa"
1998hint.pcm.0.irq="10"
1999hint.pcm.0.drq="1"
2000hint.pcm.0.flags="0x0"
2001hint.sbc.0.at="isa"
2002hint.sbc.0.port="0x220"
2003hint.sbc.0.irq="5"
2004hint.sbc.0.drq="1"

--- 64 unchanged lines hidden (view full) ---

2069# Mitsumi CD-ROM
2070device mcd
2071hint.mcd.0.at="isa"
2072hint.mcd.0.port="0x300"
2073# for the Sony CDU31/33A CDROM
2074device scd
2075hint.scd.0.at="isa"
2076hint.scd.0.port="0x230"
1997hint.pcm.0.at="isa"
1998hint.pcm.0.irq="10"
1999hint.pcm.0.drq="1"
2000hint.pcm.0.flags="0x0"
2001hint.sbc.0.at="isa"
2002hint.sbc.0.port="0x220"
2003hint.sbc.0.irq="5"
2004hint.sbc.0.drq="1"

--- 64 unchanged lines hidden (view full) ---

2069# Mitsumi CD-ROM
2070device mcd
2071hint.mcd.0.at="isa"
2072hint.mcd.0.port="0x300"
2073# for the Sony CDU31/33A CDROM
2074device scd
2075hint.scd.0.at="isa"
2076hint.scd.0.port="0x230"
2077device joy # PnP aware, hints for nonpnp only
2077device joy # PnP aware, hints for non-PnP only
2078hint.joy.0.at="isa"
2079hint.joy.0.port="0x201"
2080device rc
2081hint.rc.0.at="isa"
2082hint.rc.0.port="0x220"
2083hint.rc.0.irq="12"
2084device rp
2085hint.rp.0.at="isa"

--- 250 unchanged lines hidden (view full) ---

2336# USB Iomega Zip 100 Drive (Requires scbus and da)
2337device umass
2338# USB support for Belkin F5U109 and Magic Control Technology serial adapters
2339device umct
2340# USB modem support
2341device umodem
2342# USB mouse
2343device ums
2078hint.joy.0.at="isa"
2079hint.joy.0.port="0x201"
2080device rc
2081hint.rc.0.at="isa"
2082hint.rc.0.port="0x220"
2083hint.rc.0.irq="12"
2084device rp
2085hint.rp.0.at="isa"

--- 250 unchanged lines hidden (view full) ---

2336# USB Iomega Zip 100 Drive (Requires scbus and da)
2337device umass
2338# USB support for Belkin F5U109 and Magic Control Technology serial adapters
2339device umct
2340# USB modem support
2341device umodem
2342# USB mouse
2343device ums
2344# Diamond Rio 500 Mp3 player
2344# Diamond Rio 500 MP3 player
2345device urio
2346# USB scanners
2347device uscanner
2348#
2349# USB serial support
2350device ucom
2351# USB support for Belkin F5U103 and compatible serial adapters
2352device ubsa

--- 63 unchanged lines hidden (view full) ---

2416
2417#####################################################################
2418# FireWire support
2419
2420device firewire # FireWire bus code
2421device sbp # SCSI over Firewire (Requires scbus and da)
2422device sbp_targ # SBP-2 Target mode (Requires scbus and targ)
2423device fwe # Ethernet over FireWire (non-standard!)
2345device urio
2346# USB scanners
2347device uscanner
2348#
2349# USB serial support
2350device ucom
2351# USB support for Belkin F5U103 and compatible serial adapters
2352device ubsa

--- 63 unchanged lines hidden (view full) ---

2416
2417#####################################################################
2418# FireWire support
2419
2420device firewire # FireWire bus code
2421device sbp # SCSI over Firewire (Requires scbus and da)
2422device sbp_targ # SBP-2 Target mode (Requires scbus and targ)
2423device fwe # Ethernet over FireWire (non-standard!)
2424device fwip # IP over FireWire (rfc2734 and rfc3146)
2424device fwip # IP over FireWire (RFC2734 and RFC3146)
2425
2426#####################################################################
2427# dcons support (Dumb Console Device)
2428
2429device dcons # dumb console driver
2430device dcons_crom # FireWire attachment
2431options DCONS_BUF_SIZE=16384 # buffer size
2432options DCONS_POLL_HZ=100 # polling rate
2433options DCONS_FORCE_CONSOLE=0 # force to be the primary console
2434options DCONS_FORCE_GDB=1 # force to be the gdb device
2435
2436#####################################################################
2437# crypto subsystem
2438#
2425
2426#####################################################################
2427# dcons support (Dumb Console Device)
2428
2429device dcons # dumb console driver
2430device dcons_crom # FireWire attachment
2431options DCONS_BUF_SIZE=16384 # buffer size
2432options DCONS_POLL_HZ=100 # polling rate
2433options DCONS_FORCE_CONSOLE=0 # force to be the primary console
2434options DCONS_FORCE_GDB=1 # force to be the gdb device
2435
2436#####################################################################
2437# crypto subsystem
2438#
2439# This is a port of the openbsd crypto framework. Include this when
2439# This is a port of the OpenBSD crypto framework. Include this when
2440# configuring FAST_IPSEC and when you have a h/w crypto device to accelerate
2440# configuring FAST_IPSEC and when you have a h/w crypto device to accelerate
2441# user applications that link to openssl.
2441# user applications that link to OpenSSL.
2442#
2442#
2443# Drivers are ports from openbsd with some simple enhancements that have
2444# been fed back to openbsd.
2443# Drivers are ports from OpenBSD with some simple enhancements that have
2444# been fed back to OpenBSD.
2445
2446device crypto # core crypto support
2447device cryptodev # /dev/crypto for access to h/w
2448
2449device rndtest # FIPS 140-2 entropy tester
2450
2451device hifn # Hifn 7951, 7781, etc.
2452options HIFN_DEBUG # enable debugging support: hw.hifn.debug

--- 9 unchanged lines hidden (view full) ---

2462#
2463# Embedded system options:
2464#
2465# An embedded system might want to run something other than init.
2466options INIT_PATH=/sbin/init:/stand/sysinstall
2467
2468# Debug options
2469options BUS_DEBUG # enable newbus debugging
2445
2446device crypto # core crypto support
2447device cryptodev # /dev/crypto for access to h/w
2448
2449device rndtest # FIPS 140-2 entropy tester
2450
2451device hifn # Hifn 7951, 7781, etc.
2452options HIFN_DEBUG # enable debugging support: hw.hifn.debug

--- 9 unchanged lines hidden (view full) ---

2462#
2463# Embedded system options:
2464#
2465# An embedded system might want to run something other than init.
2466options INIT_PATH=/sbin/init:/stand/sysinstall
2467
2468# Debug options
2469options BUS_DEBUG # enable newbus debugging
2470options DEBUG_VFS_LOCKS # enable vfs lock debugging
2470options DEBUG_VFS_LOCKS # enable VFS lock debugging
2471options SOCKBUF_DEBUG # enable sockbuf last record/mb tail checking
2472
2473#
2474# Verbose SYSINIT
2475#
2476# Make the SYSINIT process performed by mi_startup() verbose. This is very
2477# useful when porting to a new architecture. If DDB is also enabled, this
2478# will print function names instead of addresses.

--- 126 unchanged lines hidden ---
2471options SOCKBUF_DEBUG # enable sockbuf last record/mb tail checking
2472
2473#
2474# Verbose SYSINIT
2475#
2476# Make the SYSINIT process performed by mi_startup() verbose. This is very
2477# useful when porting to a new architecture. If DDB is also enabled, this
2478# will print function names instead of addresses.

--- 126 unchanged lines hidden ---