diff --git a/share/man/man4/aac.4 b/share/man/man4/aac.4 index 25b429ff6fe8..aa0e8be8a706 100644 --- a/share/man/man4/aac.4 +++ b/share/man/man4/aac.4 @@ -1,172 +1,176 @@ .\" Copyright (c) 2000 Scott Long .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" $FreeBSD$ -.Dd February 22, 2001 +.Dd July 4, 2004 .Dt AAC 4 .Os .Sh NAME .Nm aac .Nd Adaptec AdvancedRAID Controller driver .Sh SYNOPSIS .Cd options AAC_DEBUG=N .Cd device pci .Cd device aac .Cd device aacp .Sh DESCRIPTION The .Nm driver provides support for the Adaptec AAC family of SCSI Ultra2, Ultra160, and Ultra320 RAID controllers. -Supported controllers include: -.Bl -bullet -.It -AAC-364 -.It -Adaptec SCSI RAID 2120S -.It -Adaptec SCSI RAID 2200S -.It -Adaptec SCSI RAID 2410SA -.It -Adaptec SCSI RAID 2810SA -.It -Adaptec SCSI RAID 5400S -.It -Dell CERC SATA RAID 2 -.It -Dell PERC 2/Si -.It -Dell PERC 2/QC -.It -Dell PERC 3/Si -.It -Dell PERC 3/Di -.It -Dell PERC 320/DC -.It -HP NetRAID 4M .Pp -.El Access to RAID containers is available via the .Pa /dev/aacd? device nodes. Individual drives cannot be accessed unless they are part of a container or volume set, and non-fixed disks cannot be accessed. Containers can be configured by using either the on-board BIOS utility of the card, or a command-line interface management application. .Pp The .Pa /dev/aac? device nodes provide access to the management interface of the controller. One node exists per installed card. The aliases .Pa /dev/afa? and .Pa /dev/hpn? exist for the Dell and HP flavors, respectively, and are required for the CLI management utility available from these vendors to work. If the kernel is compiled with the .Dv COMPAT_LINUX option, or the .Pa aac_linux.ko and .Pa linux.ko modules are loaded, the Linux-compatible .Xr ioctl 2 interface for the management device will be enabled and will allow Linux-based management applications to control the card. .Pp The .Nm aacp device enables the SCSI pass-thru interface and allows devices connected to the card such as cdroms to be available via the CAM .Xr scsi 4 subsystem. Note that not all cards allow this interface to be enabled. .Ss Tuning The read-only sysctl .Va hw.aac.iosize_max defaults to 65536 and may be set at boot time to another value via .Xr loader 8 . This value determines the maximum data transfer size allowed to/from an array. Setting it higher will result in better performance, especially for large sequential access patterns. .Em Beware : internal limitations of the card limit this value to 64K for arrays with many members. While it may be safe to raise this value, this is done .Em at the operator's own risk . Note also that performance peaks at a value of 96K, and drops off dramatically at 128K, due to other limitations of the card. +.Sh HARDWARE +Controllers supported by the +.Nm +driver include: +.Pp +.Bl -bullet -compact +.It +Adaptec AAC-364 +.It +Adaptec SCSI RAID 2120S +.It +Adaptec SCSI RAID 2200S +.It +Adaptec SCSI RAID 2410SA +.It +Adaptec SCSI RAID 2810SA +.It +Adaptec SCSI RAID 5400S +.It +Dell CERC SATA RAID 2 +.It +Dell PERC 2/Si +.It +Dell PERC 2/QC +.It +Dell PERC 3/Si +.It +Dell PERC 3/Di +.It +Dell PERC 320/DC +.It +HP NetRAID 4M +.El .Sh FILES .Bl -tag -width /boot/kernel/aac.ko -compact .It Pa /dev/aac? aac management interface .It Pa /dev/aacd? disk/container interface .It Pa /boot/kernel/aac.ko aac loadable module .El .Sh DIAGNOSTICS Compiling with .Dv AAC_DEBUG set to a number between 0 and 3 will enable increasingly verbose debug messages. .Pp The adapter can send status and alert messages asynchronously to the driver. These messages are printed on the system console, and are also queued for retrieval by a management application. .Sh SEE ALSO .Xr kld 4 , .Xr linux 4 , .Xr scsi 4 , .Xr kldload 8 , .Xr loader 8 , .Xr sysctl 8 .Sh HISTORY The .Nm driver first appeared in .Fx 4.3 . .Sh AUTHORS .An Mike Smith .Aq msmith@FreeBSD.org .An Scott Long .Aq scottl@FreeBSD.org .Sh BUGS This driver is not compatible with Dell controllers that have version 1.x firmware. The firmware version is the same as the kernel version printed in the BIOS POST and driver attach messages. .Pp The controller is not actually paused on suspend/resume. .Pp diff --git a/share/man/man4/aha.4 b/share/man/man4/aha.4 index d44c75d0d48b..f06e8db8e6a6 100644 --- a/share/man/man4/aha.4 +++ b/share/man/man4/aha.4 @@ -1,105 +1,122 @@ .\" .\" Copyright (c) 1994 Wilko Bulte .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. The name of the author may not be used to endorse or promote products .\" derived from this software without specific prior written permission .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" .\" $FreeBSD$ .\" -.Dd October 15, 1998 +.Dd July 4, 2004 .Dt AHA 4 .Os .Sh NAME .Nm aha .Nd Adaptec SCSI host adapter driver .Sh SYNOPSIS .Cd device aha .Cd device scbus .Pp In .Pa /boot/device.hints : .Cd hint.aha.0.at="isa" .Sh DESCRIPTION This driver provides access to the .Tn SCSI -bus connected to an Adaptec AHA-154xB, AHA-154xC, -AHA-154xCF, AHA-154xCP, or AHA-1640 host adapter. +bus connected to the Adaptec AHA-154x and AHA-1640 SCSI host adapters. x is 0 for controllers without a floppy drive and 2 for controllers that have them. -Host adapters supporting a 154x compatible interface, -such as some Tekram controllers and the Adaptec AHA-174x in 154x -emulation mode can also be attached with this driver. For optimum performance, Adaptec AHA-174x controllers should be configured in enhanced mode and attached via the .Xr ahb 4 driver. .Pp One device hint entry for every card to be attached by the system is required. Specific values for the port address, IRQ, and DRQ may be specified. If wildcard values are used, the driver will query the device for its current settings and use those. If the port address is a wildcard, the driver consults an internal table of possible port address locations and attaches to the first unattached card it finds. The possible port addresses for this card are 0x330, 0x334, 0x230, 0x234, 0x130, and 0x134. .Pp The AHA-1640 is an MCA bus card. Since the MCA bus is a self-identifying bus, no setting of hints is required. +.Sh HARDWARE +The +.Nm +driver supports the following SCSI host adapters: +.Pp +.Bl -bullet -compact +.It +Adaptec AHA-154xB +.It +Adaptec AHA-154xC +.It +Adaptec AHA-154xCF +.It +Adaptec AHA-154xCP +.It +Adaptec AHA-1640 +.It +Adaptec AHA-174x in 154x emulation mode +.It +Tekram SCSI controllers in 154x emulation mode +.El .Sh BUGS The AHA-154xA card does not support residuals on data transfers. As a result, this card is no longer supported. .Pp There have been some reports that the AHA-154xB does not work well under heavy load. .Pp The AHA-154xCP is a plug and play controller. However, its resources are set using the on-board BIOS and cannot be moved. Failures to attached for this card are often caused when the resources set in the BIOS conflict. .Sh SEE ALSO .Xr ahb 4 , .Xr ahc 4 , .Xr aic 4 , .Xr cd 4 , .Xr da 4 , .Xr sa 4 , .Xr scsi 4 .\" .\" .Sh DIAGNOSTICS .\" .Sh AUTHORS .An -nosplit The .Nm driver was ported by .An M. Warner Losh from the .Nm bt driver written by .An Justin T. Gibbs . diff --git a/share/man/man4/ahb.4 b/share/man/man4/ahb.4 index 0c1f0db1ea73..b08e318d0d0e 100644 --- a/share/man/man4/ahb.4 +++ b/share/man/man4/ahb.4 @@ -1,65 +1,80 @@ .\" .\" Copyright (c) 1994 Wilko Bulte .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. The name of the author may not be used to endorse or promote products .\" derived from this software without specific prior written permission .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" .\" $FreeBSD$ .\" -.Dd October 15, 1998 +.Dd July 4, 2004 .Dt AHB 4 .Os .Sh NAME .Nm ahb .Nd Adaptec EISA SCSI host adapter driver .Sh SYNOPSIS .Cd device ahb .Cd device scbus .Sh DESCRIPTION This driver provides access to the .Tn SCSI bus connected to an Adaptec -AHA-1740, AHA-1742, AHA-1740A, AHA-1742A host adapters in +AHA-174X host adapters in .Dq Em enhanced mode. Tagged queueing and synchronous SCSI transfers are supported. +.Sh HARDWARE +The +.Nm +driver supports the following SCSI host adapters: +.Pp +.Bl -bullet -compact +.It +Adaptec AHA-1740 +.It +Adaptec AHA-1742 +.It +Adaptec AHA-1740A +.It +Adaptec AHA-1742A +.El .Sh CAVEATS The Adaptec 174X is very sensitive to SCSI bus termination and cable length. It may also have difficulties operating with some modern devices that, due to their speed, expose timing problems in the controller. There are no known mechanisms for working around device incompatibilities of this nature. .Sh SEE ALSO .Xr aha 4 , .Xr ahc 4 , .Xr aic 4 , .Xr cd 4 , .Xr da 4 , .Xr sa 4 , .Xr scsi 4 .Sh AUTHORS The .Nm driver was written by .An Justin T. Gibbs . diff --git a/share/man/man4/ahc.4 b/share/man/man4/ahc.4 index ee29da15b2d0..9213dc0fabe9 100644 --- a/share/man/man4/ahc.4 +++ b/share/man/man4/ahc.4 @@ -1,314 +1,434 @@ .\" .\" Copyright (c) 1995, 1996, 1997, 1998, 2000 .\" Justin T. Gibbs. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. The name of the author may not be used to endorse or promote products .\" derived from this software without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" .\" $FreeBSD$ .\" -.Dd February 13, 2000 +.Dd July 4, 2004 .Dt AHC 4 .Os .Sh NAME .Nm ahc .Nd Adaptec VL/EISA/PCI SCSI host adapter driver .Sh SYNOPSIS For one or more VL/EISA cards: .Cd device eisa .Cd device ahc .Pp For one or more PCI cards: .Cd device pci .Cd device ahc .Pp To allow PCI adapters to use memory mapped I/O if enabled: .Cd options AHC_ALLOW_MEMIO .Pp To configure one or more controllers to assume the target role: .Cd options AHC_TMODE_ENABLE .Pp For one or more SCSI busses: .Cd device scbus .Sh DESCRIPTION This driver provides access to the .Tn SCSI -bus(es) connected to Adaptec -.Tn AIC7770 , -.Tn AIC7850 , -.Tn AIC7860 , -.Tn AIC7870 , -.Tn AIC7880 , -.Tn AIC7890 , -.Tn AIC7891 , -.Tn AIC7892 , -.Tn AIC7895 , -.Tn AIC7896 , -.Tn AIC7897 -and -.Tn AIC7899 +bus(es) connected to the Adaptec AIC77xx and AIC78xx host adapter chips. -These chips are found on many motherboards as well as the following -Adaptec SCSI controller cards: -.Tn 274X(W) , -.Tn 274X(T) , -.Tn 284X , -.Tn 2910 , -.Tn 2915 , -.Tn 2920 , -.Tn 2930C , -.Tn 2930U2 , -.Tn 2940 , -.Tn 2940J , -.Tn 2940N , -.Tn 2940U , -.Tn 2940AU , -.Tn 2940UW , -.Tn 2940UW Dual , -.Tn 2940UW Pro , -.Tn 2940U2W , -.Tn 2940U2B , -.Tn 2950U2W , -.Tn 2950U2B , -.Tn 19160B , -.Tn 29160B , -.Tn 29160N , -.Tn 3940 , -.Tn 3940U , -.Tn 3940AU , -.Tn 3940UW , -.Tn 3940AUW , -.Tn 3940U2W , -.Tn 3950U2 , -.Tn 3960 , -.Tn 39160 , -.Tn 3985 , -and -.Tn 4944UW . -.Pp -On the pc98 platform, support is also provided for the NEC PC-9821Xt13 -and RvII26, PC-9821X-B02L/B09, and SV-98/2-B03. .Pp Driver features include support for twin and wide busses, fast, ultra or ultra2 synchronous transfers depending on controller type, tagged queueing, SCB paging, and target mode. .Pp Memory mapped I/O can be enabled for PCI devices with the .Dq Dv AHC_ALLOW_MEMIO configuration option. Memory mapped I/O is more efficient than the alternative, programmed I/O. Most PCI BIOSes will map devices so that either technique for communicating with the card is available. In some cases, usually when the PCI device is sitting behind a PCI->PCI bridge, the BIOS may fail to properly initialize the chip for memory mapped I/O. The typical symptom of this problem is a system hang if memory mapped I/O is attempted. Most modern motherboards perform the initialization correctly and work fine with this option enabled. .Pp Individual controllers may be configured to operate in the target role through the .Dq Dv AHC_TMODE_ENABLE configuration option. The value assigned to this option should be a bitmap of all units where target mode is desired. For example, a value of 0x25, would enable target mode on units 0, 2, and 5. A value of 0x8a enables it for units 1, 3, and 7. .Pp Per target configuration performed in the .Tn SCSI-Select menu, accessible at boot in .No non- Ns Tn EISA models, or through an .Tn EISA configuration utility for .Tn EISA models, is honored by this driver. This includes synchronous/asynchronous transfers, maximum synchronous negotiation rate, wide transfers, disconnection, the host adapter's SCSI ID, and, in the case of .Tn EISA Twin Channel controllers, the primary channel selection. For systems that store non-volatile settings in a system specific manner rather than a serial eeprom directly connected to the aic7xxx controller, the .Tn BIOS must be enabled for the driver to access this information. This restriction applies to all .Tn EISA and many motherboard configurations. .Pp Note that I/O addresses are determined automatically by the probe routines, but care should be taken when using a 284x .Pq Tn VESA No local bus controller in an .Tn EISA system. The jumpers setting the I/O area for the 284x should match the .Tn EISA slot into which the card is inserted to prevent conflicts with other .Tn EISA cards. .Pp Performance and feature sets vary throughout the aic7xxx product line. The following table provides a comparison of the different chips supported by the .Nm driver. Note that wide and twin channel features, although always supported by a particular chip, may be disabled in a particular motherboard or card design. .Pp .Bd -ragged -offset indent .Bl -column "aic7770 " "10 " "EISA/VL " "10MHz " "16bit " "SCBs " Features .Em "Chip MIPS Bus MaxSync MaxWidth SCBs Features" aic7770 10 EISA/VL 10MHz 16Bit 4 1 aic7850 10 PCI/32 10MHz 8Bit 3 aic7860 10 PCI/32 20MHz 8Bit 3 aic7870 10 PCI/32 10MHz 16Bit 16 aic7880 10 PCI/32 20MHz 16Bit 16 aic7890 20 PCI/32 40MHz 16Bit 16 3 4 5 6 7 8 aic7891 20 PCI/64 40MHz 16Bit 16 3 4 5 6 7 8 aic7892 20 PCI/64 80MHz 16Bit 16 3 4 5 6 7 8 aic7895 15 PCI/32 20MHz 16Bit 16 2 3 4 5 aic7895C 15 PCI/32 20MHz 16Bit 16 2 3 4 5 8 aic7896 20 PCI/32 40MHz 16Bit 16 2 3 4 5 6 7 8 aic7897 20 PCI/64 40MHz 16Bit 16 2 3 4 5 6 7 8 aic7899 20 PCI/64 80MHz 16Bit 16 2 3 4 5 6 7 8 .El .Pp .Bl -enum -compact .It Multiplexed Twin Channel Device - One controller servicing two busses. .It Multi-function Twin Channel Device - Two controllers on one chip. .It Command Channel Secondary DMA Engine - Allows scatter gather list and SCB prefetch. .It 64 Byte SCB Support - SCSI CDB is embedded in the SCB to eliminate an extra DMA. .It Block Move Instruction Support - Doubles the speed of certain sequencer operations. .It .Sq Bayonet style Scatter Gather Engine - Improves S/G prefetch performance. .It Queuing Registers - Allows queueing of new transactions without pausing the sequencer. .It Multiple Target IDs - Allows the controller to respond to selection as a target on multiple SCSI IDs. .El .Ed +.Sh HARDWARE +The +.Nm +driver supports the following +.Tn SCSI +host adapter chips and +.Tn SCSI +controller cards: +.Pp +.Bl -bullet -compact +.It +Adaptec +.Tn AIC7770 +host adapter chip +.It +Adaptec +.Tn AIC7850 +host adapter chip +.It +Adaptec +.Tn AIC7860 +host adapter chip +.It +Adaptec +.Tn AIC7870 +host adapter chip +.It +Adaptec +.Tn AIC7880 +host adapter chip +.It +Adaptec +.Tn AIC7890 +host adapter chip +.It +Adaptec +.Tn AIC7891 +host adapter chip +.It +Adaptec +.Tn AIC7892 +host adapter chip +.It +Adaptec +.Tn AIC7895 +host adapter chip +.It +Adaptec +.Tn AIC7896 +host adapter chip +.It +Adaptec +.Tn AIC7897 +host adapter chip +.It +Adaptec +.Tn AIC7899 +host adapter chip +.It +Adaptec +.Tn 274X(W) +.It +Adaptec +.Tn 274X(T) +.It +Adaptec +.Tn 284X +.It +Adaptec +.Tn 2910 +.It +Adaptec +.Tn 2915 +.It +Adaptec +.Tn 2920 +.It +Adaptec +.Tn 2930C +.It +Adaptec +.Tn 2930U2 +.It +Adaptec +.Tn 2940 +.It +Adaptec +.Tn 2940J +.It +Adaptec +.Tn 2940N +.It +Adaptec +.Tn 2940U +.It +Adaptec +.Tn 2940AU +.It +Adaptec +.Tn 2940UW +.It +Adaptec +.Tn 2940UW Dual +.It +Adaptec +.Tn 2940UW Pro +.It +Adaptec +.Tn 2940U2W +.It +Adaptec +.Tn 2940U2B +.It +Adaptec +.Tn 2950U2W +.It +Adaptec +.Tn 2950U2B +.It +Adaptec +.Tn 19160B +.It +Adaptec +.Tn 29160B +.It +Adaptec +.Tn 29160N +.It +Adaptec +.Tn 3940 +.It +Adaptec +.Tn 3940U +.It +Adaptec +.Tn 3940AU +.It +Adaptec +.Tn 3940UW +.It +Adaptec +.Tn 3940AUW +.It +Adaptec +.Tn 3940U2W +.It +Adaptec +.Tn 3950U2 +.It +Adaptec +.Tn 3960 +.It +Adaptec +.Tn 39160 +.It +Adaptec +.Tn 3985 +.It +Adaptec +.Tn 4944UW +.It +NEC PC-9821Xt13 (PC-98) +.It +NEC RvII26 (PC-98) +.It +NEC PC-9821X-B02L/B09 (PC-98) +.It +NEC SV-98/2-B03 (PC-98) +.It +Many motherboards with on-board +.Tn SCSI +support +.El .Sh SCSI CONTROL BLOCKS (SCBs) Every transaction sent to a device on the SCSI bus is assigned a .Sq SCSI Control Block (SCB). The SCB contains all of the information required by the controller to process a transaction. The chip feature table lists the number of SCBs that can be stored in on-chip memory. All chips with model numbers greater than or equal to 7870 allow for the on chip SCB space to be augmented with external SRAM up to a maximum of 255 SCBs. Very few Adaptec controller configurations have external SRAM. .Pp If external SRAM is not available, SCBs are a limited resource. Using the SCBs in a straight forward manner would only allow the driver to handle as many concurrent transactions as there are physical SCBs. To fully utilize the SCSI bus and the devices on it, requires much more concurrency. The solution to this problem is .Em SCB Paging , a concept similar to memory paging. SCB paging takes advantage of the fact that devices usually disconnect from the SCSI bus for long periods of time without talking to the controller. The SCBs for disconnected transactions are only of use to the controller when the transfer is resumed. When the host queues another transaction for the controller to execute, the controller firmware will use a free SCB if one is available. Otherwise, the state of the most recently disconnected (and therefore most likely to stay disconnected) SCB is saved, via dma, to host memory, and the local SCB reused to start the new transaction. This allows the controller to queue up to 255 transactions regardless of the amount of SCB space. Since the local SCB space serves as a cache for disconnected transactions, the more SCB space available, the less host bus traffic consumed saving and restoring SCB data. .Sh BUGS Some Quantum drives (at least the Empire 2100 and 1080s) will not run on an .Tn AIC7870 Rev B in synchronous mode at 10MHz. Controllers with this problem have a 42 MHz clock crystal on them and run slightly above 10MHz. This confuses the drive and hangs the bus. Setting a maximum synchronous negotiation rate of 8MHz in the .Tn SCSI-Select utility will allow normal operation. .Pp Although the Ultra2 and Ultra160 products have sufficient instruction ram space to support both the initiator and target roles concurrently, this configuration is disabled in favor of allowing the target role to respond on multiple target ids. A method for configuring dual role mode should be provided. .Pp Tagged Queuing is not supported in target mode. .Pp Reselection in target mode fails to function correctly on all high voltage differential boards as shipped by Adaptec. Information on how to modify HVD board to work correctly in target mode is available from Adaptec. .Sh SEE ALSO .Xr aha 4 , .Xr ahb 4 , .Xr cd 4 , .Xr da 4 , .Xr sa 4 , .Xr scsi 4 .Sh AUTHORS The .Nm driver, the .Tn AIC7xxx sequencer-code assembler, and the firmware running on the aic7xxx chips was written by .An Justin T. Gibbs . .Sh HISTORY The .Nm driver appeared in .Fx 2.0 . diff --git a/share/man/man4/ahd.4 b/share/man/man4/ahd.4 index 95c61aa8a8f1..03c9452dd12e 100644 --- a/share/man/man4/ahd.4 +++ b/share/man/man4/ahd.4 @@ -1,159 +1,181 @@ .\" .\" Copyright (c) 1995, 1996, 1997, 1998, 2000 .\" Justin T. Gibbs. All rights reserved. .\" Copyright (c) 2002 .\" Scott Long. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. The name of the author may not be used to endorse or promote products .\" derived from this software without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" .\" $FreeBSD$ .\" -.Dd September 1, 2002 +.Dd July 4, 2004 .Dt AHD 4 .Os .Sh NAME .Nm ahd .Nd Adaptec PCI/PCI-X Ultra320 SCSI host adapter driver .Sh SYNOPSIS For one or more PCI/PCI-X cards: .Bd -ragged -offset indent -compact .Cd device pci .Cd device ahd .Ed .Pp To compile in debugging code: .Bd -ragged -offset indent -compact .Cd options AHD_DEBUG .Cd options AHD_DEBUG_OPTS= .Cd options AHD_REG_PRETTY_PRINT .Ed .Pp To configure one or more controllers to assume the target role: .Bd -ragged -offset indent -compact .Cd options AHD_TMODE_ENABLE= .Ed .Pp For one or more .Tn SCSI busses: .Bd -ragged -offset indent -compact .Cd device scbus .Ed .Sh DESCRIPTION This driver provides access to the .Tn SCSI bus(es) connected to Adaptec -.Tn AIC7901 -and -.Tn AIC7902 +.Tn AIC79xx host adapter chips. -These chips are found on many motherboards as well as the -.Tn 29320 -and -.Tn 39320 -Adaptec -.Tn SCSI -controller cards. .Pp Driver features include support for narrow and wide busses, fast, ultra, ultra2, ultra160, and ultra320 synchronous transfers, packetized transfers, tagged queueing, 512 SCB's, and target mode. .Pp The .Dv AHD_DEBUG_OPTS option is used to control which diagnostic messages are printed to the console when .Dv AHD_DEBUG is enabled. Logically OR the following bits together: .Bl -column -offset indent Value Function .Em "Value Function" 0x0001 Show miscellaneous information 0x0002 Show sense data 0x0004 Show Serial EEPROM contents 0x0008 Show bus termination settings 0x0010 Show host memory usage 0x0020 Show SCSI protocol messages 0x0040 Show mode pointer of the chip register window 0x0080 Show selection timeouts 0x0100 Show FIFO usage messages 0x0200 Show Queue Full status 0x0400 Show SCB queue status 0x0800 Show inbound packet information 0x1000 Show S/G list information 0x2000 Enable extra diagnostic code in the firmware .El .Pp The .Dv AHD_REG_PRETTY_PRINT option compiles in support for human-readable bit definitions for each register that is printed by the debugging code. However, it also bloats the compiled size of the driver by approximately 215KB. .Pp Individual controllers may be configured to operate in the target role through the .Dv AHD_TMODE_ENABLE configuration option. The value assigned to this option should be a bitmap of all units where target mode is desired. For example, a value of 0x25 would enable target mode on units 0, 2, and 5. Note that target mode is only supported for ultra160 speeds and below. .Pp Per target configuration performed in the .Tn SCSI-Select menu, accessible at boot, is honored by this driver. This includes synchronous/asynchronous transfers, maximum synchronous negotiation rate, wide transfers, disconnection, and the host adapter's .Tn SCSI ID. +.Sh HARDWARE +The +.Nm +driver supports the following: +.Pp +.Bl -bullet -compact +.It +Adaptec +.Tn AIC7901 +host adapter chip +.It +Adaptec +.Tn AIC7901A +host adapter chip +.It +Adaptec +.Tn AIC7902 +host adapter chip +.It +Adaptec +.Tn 29320 +host adapter +.It +Adaptec +.Tn 39320 +host adapter +.It +Many motherboards with on-board +.Tn SCSI +support +.El .Sh BUGS The current generation of 79xx chips do not support target mode in Ultra320 mode. Target mode in general has not been well tested in this driver. .Sh SEE ALSO .Xr ahc 4 , .Xr cd 4 , .Xr da 4 , .Xr sa 4 , .Xr scsi 4 .Sh AUTHORS The .Nm driver, the .Tn AIC7xxx sequencer-code assembler, and the firmware running on the aic79xx chips was written by .An Justin T. Gibbs . This manual page is based on the .Xr ahc 4 manual page. .Sh HISTORY The .Nm driver first appeared in .Fx 4.7 . diff --git a/share/man/man4/bge.4 b/share/man/man4/bge.4 index 20a51c7ff04d..3d2a95775c93 100644 --- a/share/man/man4/bge.4 +++ b/share/man/man4/bge.4 @@ -1,220 +1,225 @@ .\" Copyright (c) 2001 Wind River Systems .\" Copyright (c) 1997, 1998, 1999, 2000, 2001 .\" Bill Paul . All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by Bill Paul. .\" 4. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF .\" THE POSSIBILITY OF SUCH DAMAGE. .\" .\" $FreeBSD$ .\" -.Dd September 27, 2001 +.Dd July 4, 2004 .Dt BGE 4 .Os .Sh NAME .Nm bge .Nd "Broadcom BCM570x PCI gigabit ethernet adapter driver" .Sh SYNOPSIS .Cd "device miibus" .Cd "device bge" .Sh DESCRIPTION The .Nm driver provides support for various NICs based on the Broadcom BCM570x -family of gigabit ethernet controller chips, including the -following: -.Pp -.Bl -bullet -compact -.It -3Com 3c996-T (10/100/1000baseTX) -.It -Dell PowerEdge 1750 integrated BCM5704C NIC (10/100/1000baseTX) -.It -Dell PowerEdge 2550 integrated BCM5700 NIC (10/100/1000baseTX) -.It -Dell PowerEdge 2650 integrated BCM5703 NIC (10/100/1000baseTX) -.It -IBM x235 server integrated BCM5703x NIC (10/100/1000baseTX) -.It -HP ProLiant NC7760 embedded Gigabit NIC (10/100/1000baseTX) -.It -HP ProLiant NC7770 PCI-X Gigabit NIC (10/100/1000baseTX) -.It -HP ProLiant NC7781 embedded PCI-X Gigabit NIC (10/100/1000baseTX) -.It -Netgear GA302T (10/100/1000baseTX) -.It -SysKonnect SK-9D21 (10/100/1000baseTX) -.It -SysKonnect SK-9D41 (1000baseSX) -.El +family of gigabit ethernet controller chips. .Pp All of these NICs are capable of 10, 100 and 1000Mbps speeds over CAT5 copper cable, except for the SysKonnect SK-9D41 which supports only 1000Mbps over multimode fiber. The BCM570x builds upon the technology of the Alteon Tigon II. It has two R4000 CPU cores and is PCI v2.2 and PCI-X v1.0 compliant. It supports IP, TCP and UDP checksum offload for both receive and transmit, multiple RX and TX DMA rings for QoS applications, rules-based receive filtering, and VLAN tag stripping/insertion as well as a 256-bit multicast hash filter. Additional features may be provided via value-add firmware updates. The BCM570x supports TBI (ten bit interface) and GMII transceivers, which means it can be used with either copper or 1000baseX fiber applications. Note however the device only supports a single speed in TBI mode. .Pp Most BCM5700-based cards also use the Broadcom BCM5401 or BCM5411 10/100/1000 copper gigabit transceivers, which support autonegotiation of 10, 100 and 1000Mbps modes in full or half duplex. .Pp The BCM570x also supports jumbo frames, which can be configured via the interface MTU setting. Selecting an MTU larger than 1500 bytes with the .Xr ifconfig 8 utility configures the adapter to receive and transmit jumbo frames. Using jumbo frames can greatly improve performance for certain tasks, such as file transfers and data streaming. .Pp The .Nm driver supports the following media types: .Bl -tag -width ".Cm 10baseT/UTP" .It Cm autoselect Enable autoselection of the media type and options. The user can manually override the autoselected mode by adding media options to .Xr rc.conf 5 . .It Cm 10baseT/UTP Set 10Mbps operation. The .Xr ifconfig 8 .Ic mediaopt option can also be used to select either .Cm full-duplex or .Cm half-duplex modes. .It Cm 100baseTX Set 100Mbps (fast ethernet) operation. The .Xr ifconfig 8 .Ic mediaopt option can also be used to select either .Cm full-duplex or .Cm half-duplex modes. .It Cm 1000baseTX Set 1000baseTX operation over twisted pair. Only .Cm full-duplex mode is supported. .It Cm 1000baseSX Set 1000Mbps (gigabit ethernet) operation. Both .Cm full-duplex and .Cm half-duplex modes are supported. .El .Pp The .Nm driver supports the following media options: .Bl -tag -width ".Cm full-duplex" .It Cm full-duplex Force full duplex operation. .It Cm half-duplex Force half duplex operation. .El .Pp The .Nm driver also supports one special link option for 1000baseTX cards: .Bl -tag -width ".Cm link0" .It Cm link0 With 1000baseTX cards, establishing a link between two ports requires that one port be configured as a master and the other a slave. With autonegotiation, the master/slave settings will be chosen automatically. However when manually selecting the link state, it is necessary to force one side of the link to be a master and the other a slave. The .Nm driver configures the ports as slaves by default. Setting the .Cm link0 flag with .Xr ifconfig 8 will set a port as a master instead. .El .Pp For more information on configuring this device, see .Xr ifconfig 8 . +.Sh HARDWARE +The +.Nm +driver provides support for various NICs based on the Broadcom BCM570x +family of gigabit ethernet controller chips, including the +following: +.Pp +.Bl -bullet -compact +.It +3Com 3c996-T (10/100/1000baseTX) +.It +Dell PowerEdge 1750 integrated BCM5704C NIC (10/100/1000baseTX) +.It +Dell PowerEdge 2550 integrated BCM5700 NIC (10/100/1000baseTX) +.It +Dell PowerEdge 2650 integrated BCM5703 NIC (10/100/1000baseTX) +.It +IBM x235 server integrated BCM5703x NIC (10/100/1000baseTX) +.It +HP ProLiant NC7760 embedded Gigabit NIC (10/100/1000baseTX) +.It +HP ProLiant NC7770 PCI-X Gigabit NIC (10/100/1000baseTX) +.It +HP ProLiant NC7781 embedded PCI-X Gigabit NIC (10/100/1000baseTX) +.It +Netgear GA302T (10/100/1000baseTX) +.It +SysKonnect SK-9D21 (10/100/1000baseTX) +.It +SysKonnect SK-9D41 (1000baseSX) +.El .Sh DIAGNOSTICS .Bl -diag .It "bge%d: couldn't map memory" A fatal initialization error has occurred. .It "bge%d: couldn't map ports" A fatal initialization error has occurred. .It "bge%d: couldn't map interrupt" A fatal initialization error has occurred. .It "bge%d: no memory for softc struct!" The driver failed to allocate memory for per-device instance information during initialization. .It "bge%d: failed to enable memory mapping!" The driver failed to initialize PCI shared memory mapping. This might happen if the card is not in a bus-master slot. .It "bge%d: no memory for jumbo buffers!" The driver failed to allocate memory for jumbo frames during initialization. .It "bge%d: watchdog timeout" The device has stopped responding to the network, or there is a problem with the network connection (cable). .El .Sh SEE ALSO .Xr arp 4 , .Xr miibus 4 , .Xr netintro 4 , .Xr ng_ether 4 , .Xr vlan 4 , .Xr ifconfig 8 .Sh HISTORY The .Nm device driver first appeared in .Fx 4.5 . .Sh AUTHORS The .Nm driver was written by .An Bill Paul Aq wpaul@windriver.com . diff --git a/share/man/man4/dpt.4 b/share/man/man4/dpt.4 index f08806500920..01b3f229d07a 100644 --- a/share/man/man4/dpt.4 +++ b/share/man/man4/dpt.4 @@ -1,105 +1,109 @@ .\" .\" Copyright (c) 1998 Justin T. Gibbs .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. The name of the author may not be used to endorse or promote products .\" derived from this software without specific prior written permission .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" .\" $FreeBSD$ .\" -.Dd October 16, 1998 +.Dd July 4, 2004 .Dt DPT 4 .Os .Sh NAME .Nm dpt .Nd DPT RAID Controller SCSI driver .Sh SYNOPSIS For one or more EISA Controllers .Cd "device eisa" .Cd "device dpt" .Pp For one or more PCI Controllers .Cd "device pci" .Cd "device dpt" .Pp To allow PCI adapters to use memory mapped I/O if enabled: .Cd options DPT_ALLOW_MEMIO .Sh DESCRIPTION The .Nm +driver supports DPT RAID SCSI controllers. +.Pp +SmartRAID (PM3???) are "Enterprise" class cards, +and SmartCache (PM2???) cards are in the "Workstation" class. +The Gen 4 Smart Cache IV products were a re-issue of the Gen 3 utilizing +upgraded (and cheaper to produce) silicon. +The PM3334 (Smart RAID III) was not revamped as there was no upgraded silicon +(68040 processor) and it was using the best DPT made. +Note there has been customer confusion over the faster enterprise class card +supported by this driver being an older generation. +The Gen5 cards are supported by the +.Xr asr 4 +driver. +.Sh HARDWARE +The +.Nm driver provides support for the following RAID adapters: .Pp .Bl -bullet -compact .It DPT Smart Cache Plus .It Smart Cache II (PM2?2?, PM2022 [EISA], PM2024/PM2124 [PCI]) (Gen2) .It Smart RAID II (PM3?2?, PM3021, PM3222) .It Smart Cache III (PM2?3?) .It Smart RAID III (PM3?3?, PM3332 [EISA], PM3334UW [PCI]) (Gen3) .It Smart Cache IV (PM2?4?, PM2042 [EISA], PM2044/PM2144 [PCI]) (Gen4) .It Smart RAID IV .El -.Pp -SmartRAID (PM3???) are "Enterprise" class cards, -and SmartCache (PM2???) cards are in the "Workstation" class. -The Gen 4 Smart Cache IV products were a re-issue of the Gen 3 utilizing -upgraded (and cheaper to produce) silicon. -The PM3334 (Smart RAID III) was not revamped as there was no upgraded silicon -(68040 processor) and it was using the best DPT made. -Note there has been customer confusion over the faster enterprise class card -supported by this driver being an older generation. -The Gen5 cards are supported by the -.Xr asr 4 -driver. .Sh FILES .Bl -tag -width /usr/share/man0/template.doc -compact .It Pa sys/dev/dpt/dpt_scsi.c Core Driver Implementation .It Pa sys/dev/dpt/dpt.h Register Set and Core Driver Data Structures .It Pa sys/dev/dpt/dpt_pci.c PCI Bus Driver Attachment .It Pa sys/dev/dpt/dpt_eisa.c EISA Bus Driver Attachment .El .Sh SEE ALSO .Xr cd 4 , .Xr ch 4 , .Xr da 4 , .Xr sa 4 , .Xr scsi 4 .Sh AUTHORS .An -nosplit The .Nm driver was written by .An Simon Shapiro and ported to the CAM SCSI system by .An Justin T. Gibbs . .Sh HISTORY The .Nm driver first appeared in .Fx 2.2.6 . diff --git a/share/man/man4/fxp.4 b/share/man/man4/fxp.4 index 0dbdb7003a97..15046107c957 100644 --- a/share/man/man4/fxp.4 +++ b/share/man/man4/fxp.4 @@ -1,151 +1,154 @@ .\" .\" Copyright (c) 1997 David E. O'Brien .\" .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. .\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT, .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" .\" $FreeBSD$ .\" -.Dd May 9, 2004 +.Dd July 4, 2004 .Dt FXP 4 .Os .Sh NAME .Nm fxp .Nd Intel EtherExpress PRO/100 Ethernet device driver .Sh SYNOPSIS .Cd "device miibus" .Cd "device fxp" .Sh DESCRIPTION The .Nm driver provides support for Ethernet adapters based on the Intel i82557, i82558, i82559, i82550, and i82562 chips. -This includes the following adapters: -.Pp -.Bl -bullet -compact -.It -Intel EtherExpress PRO/10 -.It -Intel InBusiness 10/100 -.It -Intel PRO/100B / EtherExpressPRO/100 B PCI Adapter -.It -Intel PRO/100+ Management Adapter -.It -Intel PRO/100 VE Desktop Adapter -.It -Intel PRO/100 M Desktop Adapter -.It -Intel PRO/100 S Desktop, Server and Dual-Port Server Adapters -.It -Contec C-NET(PI)-100TX (PC98) -.It -NEC PC-9821Ra20, Rv20, Xv13, Xv20 internal 100Base-TX (PC98) -.It -NEC PC-9821X-B06 (PC98) -.It -Many on-board network interfaces on Intel motherboards. -.El .Pp The .Nm driver supports the following media types: .Pp .Bl -tag -width xxxxxxxxxxxxxxxxxxxx .It autoselect Enable autoselection of the media type and options .It 10baseT/UTP Set 10Mbps operation .It 100baseTX Set 100Mbps (Fast Ethernet) operation .El .Pp The .Nm driver supports the following media options: .Pp .Bl -tag -width xxxxxxxxxxxxxxxxxxxx .It full-duplex Set full duplex operation .El .Pp Note that 100baseTX media type is not available on the Pro/10. For further information on configuring this device, see .Xr ifconfig 8 . .Pp The .Nm driver also supports a special link option: .Bl -tag -width link0 .It Cm link0 Some chip revisions have loadable microcode which can be used to reduce the interrupt load on the host cpu. Not all boards have microcode support. Setting the .Cm link0 flag with .Xr ifconfig 8 will download the microcode to the chip if it is available. .El +.Sh HARDWARE +Adapters supported by the +.Nm +driver include: +.Pp +.Bl -bullet -compact +.It +Intel EtherExpress PRO/10 +.It +Intel InBusiness 10/100 +.It +Intel PRO/100B / EtherExpressPRO/100 B PCI Adapter +.It +Intel PRO/100+ Management Adapter +.It +Intel PRO/100 VE Desktop Adapter +.It +Intel PRO/100 M Desktop Adapter +.It +Intel PRO/100 S Desktop, Server and Dual-Port Server Adapters +.It +Contec C-NET(PI)-100TX (PC-98) +.It +NEC PC-9821Ra20, Rv20, Xv13, Xv20 internal 100Base-TX (PC-98) +.It +NEC PC-9821X-B06 (PC-98) +.It +Many on-board network interfaces on Intel motherboards +.El .Sh DIAGNOSTICS .Bl -diag .It "fxp%d: couldn't map memory" A fatal initialization error has occurred. .It "fxp%d: couldn't map interrupt" A fatal initialization error has occurred. .It "fxp%d: Failed to malloc memory" There are not enough mbuf's available for allocation. .It "fxp%d: device timeout" The device has stopped responding to the network, or there is a problem with the network connection (cable). .It "fxp%d: Ethernet address ff:ff:ff:ff:ff:ff" In some Alpha's (AXPpci and Multia) you must tell the driver to use (slower) I/O rather than memory to access the card. Create, if it does not yet exist, and add to the file .Pa /boot/device.hints the line .Dq Li hint.fxp.0.prefer_iomap="0" . .It "fxp%d: Microcode loaded, int_delay: %d usec bundle_max: %d" The chip has successfully downloaded the microcode, and changed the parameterized values to the given settings. .El .Sh SEE ALSO .Xr arp 4 , .Xr miibus 4 , .Xr netintro 4 , .Xr ng_ether 4 , .Xr ifconfig 8 .Sh HISTORY The .Nm device driver first appeared in .Fx 2.1 . .Sh AUTHORS .An -nosplit The .Nm device driver was written by .An David Greenman . It has then been updated to use the busdma API and made endian-clean by .An Maxime Henrion . This manual page was written by .An David E. O'Brien . diff --git a/share/man/man4/twe.4 b/share/man/man4/twe.4 index 935ee4267afb..8f3a22239a9e 100644 --- a/share/man/man4/twe.4 +++ b/share/man/man4/twe.4 @@ -1,221 +1,225 @@ .\" .\" Copyright (c) 2000 Michael Smith .\" Copyright (c) 2000 BSDi .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. The name of the author may not be used to endorse or promote products .\" derived from this software without specific prior written permission .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" .\" $FreeBSD$ .\" -.Dd April 10, 2000 +.Dd July 4, 2004 .Dt TWE 4 .Os .Sh NAME .Nm twe .Nd 3ware Escalade ATA RAID adapter driver .Sh SYNOPSIS .Cd device pci .Cd device twe .Sh DESCRIPTION The .Nm -driver provides support for the following series of ATA RAID +driver provides support for 3ware Escalade ATA RAID adapters. +.Pp +These devices support 2, 4 or 8 ATA disk drives +and provide RAID0 (striping) and RAID1 (mirroring) functionality. +.Sh HARDWARE +The +.Nm +driver supports the following series of 3ware ATA RAID controllers: .Pp .Bl -bullet -compact .It Escalade 3W-5x00 .It Escalade 3W-6x00 .It Escalade 3W-7x00 .It Escalade 3W-8x00 .El -.Pp -These devices support 2, 4 or 8 ATA disk drives -and provide RAID0 (striping) and RAID1 (mirroring) functionality. .Sh DIAGNOSTICS .Ss Controller initialisation phase .Bl -diag .It twe%d: microcontroller not ready .Pp The controller's onboard CPU is not reporting that it is ready; this may be due to either a board or system failure. Initialisation has failed. .It twe%d: no attention interrupt .It twe%d: can't drain AEN queue .It twe%d: reset not reported .It twe%d: controller errors detected .It twe%d: can't drain response queue .It twe%d: reset %d failed, trying again .Pp The controller is not responding correctly to the driver's attempts to reset and initialise it. This process is retried several times. .It twe%d: can't initialise controller, giving up .Pp Several attempts to reset and initialise the controller have failed; initialisation has failed and the driver will not attach to this controller. .El .Ss Driver initialisation/shutdown phase .Bl -diag .It twe%d: register window not available .It twe%d: can't allocate register window .It twe%d: can't allocate parent DMA tag .It twe%d: can't allocate interrupt .It twe%d: can't set up interrupt .It twe%d: can't establish configuration hook .Pp A resource allocation error occurred while initialising the driver; initialisation has failed and the driver will not attach to this controller. .It twe%d: can't detect attached units .Pp Fetching the list of attached units failed; initialisation has failed. .It twe%d: error fetching capacity for unit %d .It twe%d: error fetching state for unit %d .It twe%d: error fetching descriptor size for unit %d .It twe%d: error fetching descriptor for unit %d .It twe%d: device_add_child failed .It twe%d: bus_generic_attach returned %d .Pp Creation of the disk devices failed, either due to communications problems with the adapter or due to resource shortage; attachment of one or more units may have been aborted. .El .Ss Operational phase .Bl -diag .It twe%d: command completed - %s .El .Pp A command was reported completed with a warning by the controller. The warning may be one of: .Bl -diag .It redundant/inconsequential request ignored .It failed to write zeroes to LBA 0 .It failed to profile TwinStor zones .El .Bl -diag .It twe%d: command failed - %s .El .Pp A command was reported as failed by the controller. The failure message may be one of: .Bl -diag .It aborted due to system command or reconfiguration .It aborted .It access error .It access violation .It device failure .It controller error .It timed out .It invalid unit number .It unit not available .It undefined opcode .It request incompatible with unit .It invalid request .It firmware error, reset requested .Pp The command will be returned to the operating system after a fatal error. .El .Bl -diag .It twe%d: command failed submission - controller wedged .Pp A command could not be delivered to the controller because the controller is unresponsive. .It twe%d: AEN: <%s> .El .Pp The controller has reported a change in status using an AEN (Asynchronous Event Notification). The following AENs may be reported: .Bl -diag .It queue empty .It soft reset .It degraded mirror .It controller error .It rebuild fail .It rebuild done .It incomplete unit .It initialisation done .It unclean shutdown detected .It drive timeout .It drive error .It rebuild started .It aen queue full .Pp AENs are also queued internally for use by management tools. .El .Bl -diag .It twe%d: error polling for signalled AENs .Pp The controller has reported that one or more status messages are ready for the driver, but attempting to fetch one of these has returned an error. .It twe%d: AEN queue overflow, lost AEN <%s> .Pp A status message was retrieved from the controller, but there is no more room to queue it in the driver. The message is lost (but will be printed to the console). .It twe%d: missing expected status bits %s .It twe%d: unexpected status bits %s .Pp A check of the controller's status bits indicates an unexpected condition. .It twe%d: host interrupt .Pp The controller has signalled a host interrupt. This serves an unknown purpose and is ignored. .It twe%d: command interrupt .Pp The controller has signalled a command interrupt. This is not used, and will be disabled. .It twe%d: controller reset in progress... .Pp The controller is being reset by the driver. Typically this is done when the driver has determined that the controller is in an unrecoverable state. .It twe%d: can't reset controller, giving up .Pp The driver has given up on resetting the controller. No further I/O will be handled. .It controller reset done, %d commands restarted .Pp The controller was successfully reset, and outstanding commands were restarted. .El .Sh BUGS The controller cannot handle I/O transfers that are not aligned to a 512-byte boundary. In order to support raw device access from user-space, the driver will perform alignment fixup on non-aligned data. This process is inefficient, and thus in order to obtain best performance user-space applications accessing the device should do so with aligned buffers. .Sh AUTHORS The .Nm driver and manpage were written by .An Michael Smith .Aq msmith@FreeBSD.org . diff --git a/share/man/man4/txp.4 b/share/man/man4/txp.4 index b459a508f410..ef845dad0331 100644 --- a/share/man/man4/txp.4 +++ b/share/man/man4/txp.4 @@ -1,144 +1,147 @@ .\" $OpenBSD: txp.4,v 1.8 2001/06/26 02:09:11 pjanzen Exp $ .\" $FreeBSD$ .\" .\" Copyright (c) 2001 Jason L. Wright (jason@thought.net) .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by Jason L. Wright .\" 4. The name of the author may not be used to endorse or promote products .\" derived from this software without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE .\" DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, .\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES .\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR .\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, .\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN .\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" -.Dd April 15, 2001 +.Dd July 4, 2004 .Dt TXP 4 .Os .Sh NAME .Nm txp .Nd 3Com 3XP Typhoon/Sidewinder (3CR990) Ethernet interface .Sh SYNOPSIS .Cd "device txp" .Sh DESCRIPTION The .Nm interface provides access to the 10Mb/s and 100Mb/s Ethernet networks via the .Tn 3Com .Tn Typhoon/Sidewinder chipset. -This driver supports the following cards: -.Pp -.Bl -bullet -offset indent -compact -.It -3Com 3CR990-TX-95 -.It -3Com 3CR990-TX-97 -.It -3Com 3cR990B-TXM -.It -3Com 3CR990SVR95 -.It -3Com 3CR990SVR97 -.It -3Com 3cR990B-SRV -.El .Pp Basic Ethernet functions are provided as well as support for .Xr vlan 4 tag removal and insertion assistance, receive .Xr ip 4 , .Xr tcp 4 , and .Xr udp 4 checksum offloading, and transmit .Xr ip 4 checksum offloading. There is currently no support for transmit .Xr tcp 4 or .Xr udp 4 checksum offloading, .Xr tcp 4 segmentation, nor .Xr ipsec 4 acceleration. Note that hardware checksumming is only used when the interface is not in .Xr bridge 4 mode. .Pp Each of the host's network addresses is specified at boot time with an .Dv SIOCSIFADDR .Xr ioctl 2 . The .Nm interface employs the address resolution protocol described in .Xr arp 4 to dynamically map between Internet and Ethernet addresses on the local network. .Pp When a .Nm interface is brought up, by default, it will attempt to auto-negotiate the link speed and duplex mode. The speeds, in order of attempt, are: 100Mb/s Full Duplex, 100Mb/s Half Duplex, 10 Mb/s Full Duplex, and 10 Mb/s Half Duplex. .Pp The .Nm supports several media types, which are selected via the .Xr ifconfig 8 command. The supported media types are: .Bl -tag -width indent .It Cm media autoselect Attempt to autoselect the media type (default) .It Cm media 100baseTX mediaopt full-duplex Use 100baseTX, full duplex .It Cm media 100baseTX Op Cm mediaopt half-duplex Use 100baseTX, half duplex .It Cm media 10baseT mediaopt full-duplex Use 10baseT, full duplex .It Cm media 10baseT Op Cm mediaopt half-duplex Use 10baseT, half duplex .El +.Sh HARDWARE +The +.Nm +driver supports the following cards: +.Pp +.Bl -bullet -offset indent -compact +.It +3Com 3CR990-TX-95 +.It +3Com 3CR990-TX-97 +.It +3Com 3cR990B-TXM +.It +3Com 3CR990SVR95 +.It +3Com 3CR990SVR97 +.It +3Com 3cR990B-SRV +.El .Sh SEE ALSO .Xr arp 4 , .Xr ifmedia 4 , .Xr inet 4 , .Xr intro 4 , .Xr ip 4 , .Xr miibus 4 , .Xr tcp 4 , .Xr udp 4 , .Xr vlan 4 , .Xr ifconfig 8 .Sh HISTORY The .Nm driver first appeared in .Ox 2.9 . diff --git a/share/man/man4/xe.4 b/share/man/man4/xe.4 index cfb678eb910c..bc0a206cc7de 100644 --- a/share/man/man4/xe.4 +++ b/share/man/man4/xe.4 @@ -1,148 +1,152 @@ .\" .\" Copyright (c) 2003 Tom Rhodes .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" $FreeBSD$ .\" -.Dd November 4, 2003 +.Dd July 4, 2004 .Dt XE 4 .Os .Sh NAME .Nm xe .Nd Xircom PCMCIA Ethernet device driver .Sh SYNOPSIS .Cd "device xe" .Sh DESCRIPTION The .Nm driver supports .Tn PCMCIA Ethernet adapters based on Xircom CE2- and CE3-class hardware. This includes devices made by Xircom along with various .Tn OEM manufacturers. -The following cards are supported: -.Pp -.Bl -bullet -compact -offset -indent -.It -Xircom CreditCard Ethernet (PS-CE2-10) -.It -Xircom CreditCard Ethernet + Modem 28 (PS-CEM-28) -.It -Xircom CreditCard Ethernet + Modem 33 (CEM33) -.It -Xircom CreditCard 10/100 (CE3, CE3B) -.It -Xircom CreditCard Ethernet 10/100 + Modem 56 (CEM56) -.It -Xircom RealPort Ethernet 10 (RE10) -.It -Xircom RealPort Ethernet 10/100 (RE100) -.It -Xircom RealPort Ethernet 10/100 + Modem 56 (REM56, REM56G) -.It -Accton Fast EtherCard-16 (EN2226) -.It -Compaq Netelligent 10/100 PC Card (CPQ-10/100) -.It -Intel EtherExpress Pro/100 PC Card Mobile Adapter 16 (Pro/100 M16A) -.El -Other similar devices using the same hardware may also be supported. .Pp Please note that the .Nm driver only supports .Tn PCMCIA cards and their Ethernet functions. .Nm does not support the on-board modem device located on some version of the Ethernet/modem combo cards. In particular, Xircom RealPort2 cards are not supported by this driver. .Pp The .Nm driver supports the following media types: .Bl -tag -width xxxxxxxxxxxxxxxxxxxx .It autoselect Enable autoselection of media type and options. .It 10Base2/BNC Select 10Mbps operation on a BNC coaxial connector. .It 10BaseT/UTP Select 10Mbps operation on a RJ-45 connector. .It 100BaseTX Select 100Mbps operation. .El .Pp Note that 100BaseTX operation is not available on CE2-class cards, while the 10Base2/BNC mode is only available on CE2-class cards. .Ar Full-duplex operation is currently not supported. For more information on configuring network interface devices, see .Xr ifconfig 8 . +.Sh HARDWARE +The +.Nm +driver supports the following cards: +.Pp +.Bl -bullet -compact -offset -indent +.It +Xircom CreditCard Ethernet (PS-CE2-10) +.It +Xircom CreditCard Ethernet + Modem 28 (PS-CEM-28) +.It +Xircom CreditCard Ethernet + Modem 33 (CEM33) +.It +Xircom CreditCard 10/100 (CE3, CE3B) +.It +Xircom CreditCard Ethernet 10/100 + Modem 56 (CEM56) +.It +Xircom RealPort Ethernet 10 (RE10) +.It +Xircom RealPort Ethernet 10/100 (RE100) +.It +Xircom RealPort Ethernet 10/100 + Modem 56 (REM56, REM56G) +.It +Accton Fast EtherCard-16 (EN2226) +.It +Compaq Netelligent 10/100 PC Card (CPQ-10/100) +.It +Intel EtherExpress Pro/100 PC Card Mobile Adapter 16 (Pro/100 M16A) +.El +.Pp +Other similar devices using the same hardware may also be supported. .Sh DIAGNOSTICS .Bl -diag .It "xe%d: Cannot allocate ioport" .It "xe%d: Cannot allocate irq" A fatal initialization error occurred while attempting to allocate system resources for the card. .It "xe%d: Unable to fix your %s combo card" A fatal initialization error occurred while attempting to attach an Ethernet/modem combo card. .It "xe%d: watchdog timeout: resetting card" The card failed to generate an interrupt acknowledging a transmitted packet. May indicate a .Tn PCMCIA configuration problem. .It "xe%d: no carrier" The card has lost all contact with the network; this usually indicates a cable problem. .El .Sh SEE ALSO .Xr pccard 4 , .Xr ifconfig 8 .Sh HISTORY The .Nm driver first appeared in .Fx 3.3 . .Sh AUTHORS The .Nm device driver was written by .An Scott Mitchell Aq rsm@FreeBSD.org . This manual page was written by .An -nosplit .An Scott Mitchell Aq rsm@FreeBSD.org , and .An Tom Rhodes Aq trhodes@FreeBSD.org . .Sh BUGS Supported devices will fail to attach on some machines using the .Tn NEWCARD .Tn PC Card framework. .Pp Automatic media selection is usually unreliable.