Add a manual page for the ahd driver.
This commit is contained in:
scottl
parent
3c7d05d837
commit
cbcc6c0caa
@ -9,6 +9,7 @@ MAN= aac.4 \
|
||||
aha.4 \
|
||||
ahb.4 \
|
||||
ahc.4 \
|
||||
ahd.4 \
|
||||
amd.4 \
|
||||
amr.4 \
|
||||
an.4 \
|
||||
|
||||
142
share/man/man4/ahd.4
Normal file
142
share/man/man4/ahd.4
Normal file
@ -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 <bitmask of options>
|
||||
.Cd options AHD_REG_PRETTY_PRINT
|
||||
.Pp
|
||||
To configure one or more controllers to assume the target role:
|
||||
.Cd options AHC_TMODE_ENABLE <bitmask of units>
|
||||
.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 .
|
||||
Loading…
Reference in New Issue
Block a user