diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile index 1e154b52c44b..e5516e03e0fd 100644 --- a/share/man/man4/Makefile +++ b/share/man/man4/Makefile @@ -9,6 +9,7 @@ MAN= aac.4 \ aha.4 \ ahb.4 \ ahc.4 \ + ahd.4 \ amd.4 \ amr.4 \ an.4 \ diff --git a/share/man/man4/ahd.4 b/share/man/man4/ahd.4 new file mode 100644 index 000000000000..5585b393d851 --- /dev/null +++ b/share/man/man4/ahd.4 @@ -0,0 +1,142 @@ +.\" +.\" 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 +.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: +.Cd device pci +.Cd device ahc +.Pp +To compile in debugging code. +.Cd options AHD_DEBUG +.Cd options AHD_DEBUG_OPTS +.Cd options AHD_REG_PRETTY_PRINT +.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 AIC7901 +and +.Tn AIC7902 +host adapter chips. +These chips are found on many motherboards as well as the +.Tn 29320 +and +.Tn 39320 +Adaptec 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 +.Dq Dv AHD_DEBUG_OPTS +option is used to control which diagnostic messages are printed to the +console when +.Dq Dv AHD_DEBUG +is enabled. Logically 'or' the following bits together: +.Pp +.Bd -ragged -offset indent +.Bl -column "Value " Function +.Em "Value Function" +0x0001 Show miscellanious 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 +.Ed +.Pp +The +.Dq 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 +.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. +Note that target mode is only supoprted 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 SCSI ID. +.Pp +.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 .