130f4520cb
CTL is a disk and processor device emulation subsystem originally written
for Copan Systems under Linux starting in 2003. It has been shipping in
Copan (now SGI) products since 2005.
It was ported to FreeBSD in 2008, and thanks to an agreement between SGI
(who acquired Copan's assets in 2010) and Spectra Logic in 2010, CTL is
available under a BSD-style license. The intent behind the agreement was
that Spectra would work to get CTL into the FreeBSD tree.
Some CTL features:
- Disk and processor device emulation.
- Tagged queueing
- SCSI task attribute support (ordered, head of queue, simple tags)
- SCSI implicit command ordering support. (e.g. if a read follows a mode
select, the read will be blocked until the mode select completes.)
- Full task management support (abort, LUN reset, target reset, etc.)
- Support for multiple ports
- Support for multiple simultaneous initiators
- Support for multiple simultaneous backing stores
- Persistent reservation support
- Mode sense/select support
- Error injection support
- High Availability support (1)
- All I/O handled in-kernel, no userland context switch overhead.
(1) HA Support is just an API stub, and needs much more to be fully
functional.
ctl.c: The core of CTL. Command handlers and processing,
character driver, and HA support are here.
ctl.h: Basic function declarations and data structures.
ctl_backend.c,
ctl_backend.h: The basic CTL backend API.
ctl_backend_block.c,
ctl_backend_block.h: The block and file backend. This allows for using
a disk or a file as the backing store for a LUN.
Multiple threads are started to do I/O to the
backing device, primarily because the VFS API
requires that to get any concurrency.
ctl_backend_ramdisk.c: A "fake" ramdisk backend. It only allocates a
small amount of memory to act as a source and sink
for reads and writes from an initiator. Therefore
it cannot be used for any real data, but it can be
used to test for throughput. It can also be used
to test initiators' support for extremely large LUNs.
ctl_cmd_table.c: This is a table with all 256 possible SCSI opcodes,
and command handler functions defined for supported
opcodes.
ctl_debug.h: Debugging support.
ctl_error.c,
ctl_error.h: CTL-specific wrappers around the CAM sense building
functions.
ctl_frontend.c,
ctl_frontend.h: These files define the basic CTL frontend port API.
ctl_frontend_cam_sim.c: This is a CTL frontend port that is also a CAM SIM.
This frontend allows for using CTL without any
target-capable hardware. So any LUNs you create in
CTL are visible in CAM via this port.
ctl_frontend_internal.c,
ctl_frontend_internal.h:
This is a frontend port written for Copan to do
some system-specific tasks that required sending
commands into CTL from inside the kernel. This
isn't entirely relevant to FreeBSD in general,
but can perhaps be repurposed.
ctl_ha.h: This is a stubbed-out High Availability API. Much
more is needed for full HA support. See the
comments in the header and the description of what
is needed in the README.ctl.txt file for more
details.
ctl_io.h: This defines most of the core CTL I/O structures.
union ctl_io is conceptually very similar to CAM's
union ccb.
ctl_ioctl.h: This defines all ioctls available through the CTL
character device, and the data structures needed
for those ioctls.
ctl_mem_pool.c,
ctl_mem_pool.h: Generic memory pool implementation used by the
internal frontend.
ctl_private.h: Private data structres (e.g. CTL softc) and
function prototypes. This also includes the SCSI
vendor and product names used by CTL.
ctl_scsi_all.c,
ctl_scsi_all.h: CTL wrappers around CAM sense printing functions.
ctl_ser_table.c: Command serialization table. This defines what
happens when one type of command is followed by
another type of command.
ctl_util.c,
ctl_util.h: CTL utility functions, primarily designed to be
used from userland. See ctladm for the primary
consumer of these functions. These include CDB
building functions.
scsi_ctl.c: CAM target peripheral driver and CTL frontend port.
This is the path into CTL for commands from
target-capable hardware/SIMs.
README.ctl.txt: CTL code features, roadmap, to-do list.
usr.sbin/Makefile: Add ctladm.
ctladm/Makefile,
ctladm/ctladm.8,
ctladm/ctladm.c,
ctladm/ctladm.h,
ctladm/util.c: ctladm(8) is the CTL management utility.
It fills a role similar to camcontrol(8).
It allow configuring LUNs, issuing commands,
injecting errors and various other control
functions.
usr.bin/Makefile: Add ctlstat.
ctlstat/Makefile
ctlstat/ctlstat.8,
ctlstat/ctlstat.c: ctlstat(8) fills a role similar to iostat(8).
It reports I/O statistics for CTL.
sys/conf/files: Add CTL files.
sys/conf/NOTES: Add device ctl.
sys/cam/scsi_all.h: To conform to more recent specs, the inquiry CDB
length field is now 2 bytes long.
Add several mode page definitions for CTL.
sys/cam/scsi_all.c: Handle the new 2 byte inquiry length.
sys/dev/ciss/ciss.c,
sys/dev/ata/atapi-cam.c,
sys/cam/scsi/scsi_targ_bh.c,
scsi_target/scsi_cmds.c,
mlxcontrol/interface.c: Update for 2 byte inquiry length field.
scsi_da.h: Add versions of the format and rigid disk pages
that are in a more reasonable format for CTL.
amd64/conf/GENERIC,
i386/conf/GENERIC,
ia64/conf/GENERIC,
sparc64/conf/GENERIC: Add device ctl.
i386/conf/PAE: The CTL frontend SIM at least does not compile
cleanly on PAE.
Sponsored by: Copan Systems, SGI and Spectra Logic
MFC after: 1 month
216 lines
8.3 KiB
Plaintext
216 lines
8.3 KiB
Plaintext
#
|
|
# GENERIC -- Generic kernel configuration file for FreeBSD/ia64
|
|
#
|
|
# For more information on this file, please read the handbook section on
|
|
# Kernel Configuration Files:
|
|
#
|
|
# http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig-config.html
|
|
#
|
|
# The handbook is also available locally in /usr/share/doc/handbook
|
|
# if you've installed the doc distribution, otherwise always see the
|
|
# FreeBSD World Wide Web server (http://www.FreeBSD.org/) for the
|
|
# latest information.
|
|
#
|
|
# An exhaustive list of options and more detailed explanations of the
|
|
# device lines is also present in the ../../conf/NOTES and NOTES files.
|
|
# If you are in doubt as to the purpose or necessity of a line, check
|
|
# first in NOTES.
|
|
#
|
|
# For hardware specific information check HARDWARE.TXT
|
|
#
|
|
# $FreeBSD$
|
|
|
|
cpu ITANIUM2
|
|
ident GENERIC
|
|
|
|
makeoptions DEBUG=-g # Build kernel with debug information.
|
|
|
|
options AUDIT # Security event auditing
|
|
options CAPABILITY_MODE # Capsicum capability mode
|
|
options CAPABILITIES # Capsicum capabilities
|
|
options CD9660 # ISO 9660 Filesystem
|
|
options COMPAT_FREEBSD7 # Compatible with FreeBSD7
|
|
options FFS # Berkeley Fast Filesystem
|
|
options GEOM_LABEL # Provides labelization
|
|
options INCLUDE_CONFIG_FILE # Include this file in kernel
|
|
options INET # InterNETworking
|
|
options INET6 # IPv6 communications protocols
|
|
options KTRACE # ktrace(1) syscall trace support
|
|
options MAC # TrustedBSD MAC Framework
|
|
options MD_ROOT # MD usable as root device
|
|
options MSDOSFS # MSDOS Filesystem
|
|
options NFSCL # New Network Filesystem Client
|
|
options NFSLOCKD # Network Lock Manager
|
|
options NFSD # New Network Filesystem Server
|
|
options NFS_ROOT # NFS usable as root device
|
|
options P1003_1B_SEMAPHORES # POSIX-style semaphores
|
|
#options PREEMPTION # Enable kernel thread preemption
|
|
options PRINTF_BUFR_SIZE=128 # Printf buffering to limit interspersion
|
|
options PROCFS # Process filesystem (/proc)
|
|
options PSEUDOFS # Pseudo-filesystem framework
|
|
options SCHED_ULE # ULE scheduler
|
|
options SCSI_DELAY=5000 # Delay (in ms) before probing SCSI
|
|
options SCTP # Stream Control Transmission Protocol
|
|
options SMP # Symmetric Multi-Processor support
|
|
options SOFTUPDATES # Enable FFS soft updates support
|
|
options STACK # stack(9) support
|
|
options SYSVMSG # SYSV-style message queues
|
|
options SYSVSEM # SYSV-style semaphores
|
|
options SYSVSHM # SYSV-style shared memory
|
|
options UFS_ACL # Support for access control lists
|
|
options UFS_DIRHASH # Hash-based directory lookup scheme
|
|
options UFS_GJOURNAL # Enable gjournal-based UFS journaling
|
|
options _KPOSIX_PRIORITY_SCHEDULING # Posix P1003_1B RT extensions
|
|
|
|
# Debugging support. Always need this:
|
|
options KDB # Enable kernel debugger support.
|
|
# For minimum debugger support (stable branch) use:
|
|
#options KDB_TRACE # Print a stack trace for a panic.
|
|
# For full debugger support use this instead:
|
|
options DDB # Support DDB
|
|
options GDB # Support remote GDB
|
|
options DEADLKRES # Enable the deadlock resolver
|
|
options INVARIANTS # Enable calls of extra sanity checking
|
|
options INVARIANT_SUPPORT # required by INVARIANTS
|
|
options WITNESS # Enable checks to detect deadlocks and cycles
|
|
options WITNESS_SKIPSPIN # Don't run witness on spinlocks for speed
|
|
options MALLOC_DEBUG_MAXZONES=8 # Separate malloc(9) zones
|
|
|
|
# Various "busses"
|
|
device firewire # FireWire bus code
|
|
device miibus # MII bus support (Ethernet)
|
|
device pci # PCI bus support
|
|
device scbus # SCSI bus (required for ATA/SCSI)
|
|
device usb # USB Bus (required for USB)
|
|
|
|
# ATA controllers
|
|
device ahci # AHCI-compatible SATA controllers
|
|
device ata # Legacy ATA/SATA controllers
|
|
options ATA_CAM # Handle legacy controllers with CAM
|
|
device mvs # Marvell 88SX50XX/88SX60XX/88SX70XX/SoC SATA
|
|
device siis # SiliconImage SiI3124/SiI3132/SiI3531 SATA
|
|
|
|
# SCSI Controllers
|
|
device ahc # AHA2940 and AIC7xxx devices
|
|
device ahd # AHA39320/29320 and AIC79xx devices
|
|
device hptiop # Highpoint RocketRaid 3xxx series
|
|
device isp # Qlogic family
|
|
device mpt # LSI-Logic MPT-Fusion
|
|
device sym # NCR/Symbios Logic
|
|
|
|
# RAID controllers interfaced to the SCSI subsystem
|
|
device amr # AMI MegaRAID
|
|
device ciss # Compaq Smart RAID 5*
|
|
device dpt # DPT Smartcache III, IV
|
|
device iir # Intel Integrated RAID
|
|
device ips # IBM (Adaptec) ServeRAID
|
|
device mly # Mylex AcceleRAID/eXtremeRAID
|
|
device twa # 3ware 9000 series PATA/SATA RAID
|
|
|
|
# ATA/SCSI peripherals
|
|
device cd # CD-ROM, DVD-ROM etc.
|
|
device ch # Media changer
|
|
device da # Direct Access (ie disk)
|
|
device pass # Passthrough (direct ATA/SCSI access)
|
|
device sa # Sequential Access (ie tape)
|
|
device ses # Enclosure Services (SES and SAF-TE)
|
|
device ctl # CAM Target Layer
|
|
|
|
# RAID controllers
|
|
device aac # Adaptec FSA RAID
|
|
device aacp # SCSI passthrough for aac (requires CAM)
|
|
device ida # Compaq Smart RAID
|
|
device mlx # Mylex DAC960 family
|
|
|
|
# USB host controllers and peripherals
|
|
options USB_DEBUG # enable debug msgs
|
|
device ehci # EHCI host controller
|
|
device ohci # OHCI PCI->USB interface
|
|
device uhci # UHCI PCI->USB interface
|
|
device uhid # Human Interface Devices
|
|
device ukbd # Keyboard
|
|
device ulpt # Printer
|
|
device umass # Disks/Mass storage (need scbus & da)
|
|
device ums # Mouse
|
|
|
|
# PCI Ethernet NICs.
|
|
device de # DEC/Intel DC21x4x (``Tulip'')
|
|
device em # Intel PRO/1000 Gigabit Ethernet Family
|
|
device igb # Intel PRO/1000 PCIE Server Gigabit Family
|
|
device ixgbe # Intel PRO/10GbE PCIE Ethernet Family
|
|
device txp # 3Com 3cR990 (``Typhoon'')
|
|
|
|
# PCI Ethernet NICs that use the common MII bus controller code.
|
|
device ae # Attansic/Atheros L2 FastEthernet
|
|
device age # Attansic/Atheros L1 Gigabit Ethernet
|
|
device alc # Atheros AR8131/AR8132 Ethernet
|
|
device ale # Atheros AR8121/AR8113/AR8114 Ethernet
|
|
device bce # Broadcom BCM5706/BCM5708 Gigabit Ethernet
|
|
device bfe # Broadcom BCM440x 10/100 Ethernet
|
|
device bge # Broadcom BCM570xx Gigabit Ethernet
|
|
device et # Agere ET1310 10/100/Gigabit Ethernet
|
|
device jme # JMicron JMC250 Gigabit/JMC260 Fast Ethernet
|
|
device msk # Marvell/SysKonnect Yukon II Gigabit Ethernet
|
|
device nge # NatSemi DP83820 gigabit Ethernet
|
|
device fxp # Intel EtherExpress PRO/100B (82557, 82558)
|
|
device re # RealTek 8139C+/8169/8169S/8110S
|
|
device sf # Adaptec AIC-6915 (``Starfire'')
|
|
device sk # SysKonnect SK-984x & SK-982x gigabit Ethernet
|
|
device ste # Sundance ST201 (D-Link DFE-550TX)
|
|
device stge # Sundance/Tamarack TC9021 gigabit Ethernet
|
|
device tx # SMC EtherPower II (83c170 ``EPIC'')
|
|
device vge # VIA VT612x gigabit Ethernet
|
|
device xl # 3Com 3c90x ("Boomerang", "Cyclone")
|
|
|
|
# USB Ethernet
|
|
device aue # ADMtek USB Ethernet
|
|
device axe # ASIX Electronics USB Ethernet
|
|
device cdce # Generic USB over Ethernet
|
|
device cue # CATC USB Ethernet
|
|
device kue # Kawasaki LSI USB Ethernet
|
|
device rue # RealTek RTL8150 USB Ethernet
|
|
device udav # Davicom DM9601E USB
|
|
|
|
# USB Serial
|
|
device uark # Technologies ARK3116 based serial adapters
|
|
device ubsa # Belkin F5U103 and compatible serial adapters
|
|
device uftdi # For FTDI usb serial adapters
|
|
device uipaq # Some WinCE based devices
|
|
device uplcom # Prolific PL-2303 serial adapters
|
|
device uslcom # SI Labs CP2101/CP2102 serial adapters
|
|
device uvisor # Visor and Palm devices
|
|
device uvscom # USB serial support for DDI pocket's PHS
|
|
|
|
# Wireless NIC cards.
|
|
# The wlan(4) module assumes this, so just define it so it
|
|
# at least correctly loads.
|
|
options IEEE80211_SUPPORT_MESH
|
|
|
|
# The ath(4) and ath_hal(4) code requires this. The module currently
|
|
# builds everything including AR5416 (and later 11n NIC) support.
|
|
options AH_SUPPORT_AR5416
|
|
|
|
# FireWire support
|
|
device fwip # IP over FireWire (RFC 2734,3146)
|
|
# sbp(4) works for some systems but causes boot failure on others
|
|
#device sbp # SCSI over FireWire (need scbus & da)
|
|
|
|
# Various (pseudo) devices
|
|
device ether # Ethernet support
|
|
device faith # IPv6-to-IPv4 relaying (translation)
|
|
device gif # IPv6 and IPv4 tunneling
|
|
device loop # Network loopback
|
|
device md # Memory "disks"
|
|
device pty # BSD-style compatibility pseudo ttys
|
|
device puc # Multi I/O cards and multi-channel UARTs
|
|
device random # Entropy device
|
|
device tun # Packet tunnel.
|
|
device uart # Serial port (UART)
|
|
device vlan # 802.1Q VLAN support
|
|
device firmware # firmware assist module
|
|
|
|
# The `bpf' device enables the Berkeley Packet Filter.
|
|
# Be aware of the administrative consequences of enabling this!
|
|
# Note that 'bpf' is required for DHCP.
|
|
device bpf # Berkeley packet filter
|