freebsd-skq/share/man/man4/ahb.4

.\"
.\" 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 July 4, 2004
.Dt AHB 4
.Os
.Sh NAME
.Nm ahb
.Nd Adaptec EISA SCSI host adapter driver
.Sh SYNOPSIS
To compile this driver into the kernel,
place the following lines in your
kernel configuration file:
.Bd -ragged -offset indent
.Cd "device scbus"
.Cd "device ahb"
.Ed
.Pp
Alternatively, to load the driver as a
module at boot time, place the following line in
.Xr loader.conf 5 :
.Bd -literal -offset indent
ahb_load="YES"
.Ed
.Sh DESCRIPTION
This driver provides access to the
.Tn SCSI
bus connected to an Adaptec
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 .
Add new files from Wilko (and in their proper place). Submitted by: Wilko Bulte 1994-09-29 13:54:36 +00:00			`.\"`
			`.\" 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`
Spelling police: withough -> without Submitted by: Joseph Mallett <jmallett@xMach.org> 2001-08-23 21:36:18 +00:00			`.\" derived from this software without specific prior written permission`
Add new files from Wilko (and in their proper place). Submitted by: Wilko Bulte 1994-09-29 13:54:36 +00:00			`.\"`
			.\" 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.`
			`.\"`
$Id$ -> $FreeBSD$ 1999-08-28 00:22:10 +00:00			`.\" $FreeBSD$`
Add new files from Wilko (and in their proper place). Submitted by: Wilko Bulte 1994-09-29 13:54:36 +00:00			`.\"`
Add a HARDWARE section which lists supported devices. The actual device listings has been moved (and in some cases more or less rewritten) from the DESCRIPTION section. This will be used later for automatically generating device listings in the Hardware Notes, by parsing the manual pages. Reviewed in principle by: ru, hrs, trhodes No objections: -doc, re Section name inspired by: NetBSD 2004-07-04 14:17:41 +00:00			`.Dd July 4, 2004`
Remove the MD part from the document title. Forgotten by: obrien 2001-02-20 11:07:27 +00:00			`.Dt AHB 4`
mdoc(7) police: removed HISTORY info from the .Os call. 2001-07-10 15:31:11 +00:00			`.Os`
Add new files from Wilko (and in their proper place). Submitted by: Wilko Bulte 1994-09-29 13:54:36 +00:00			`.Sh NAME`
			`.Nm ahb`
More man page cleanups. 1996-01-19 22:17:57 +00:00			`.Nd Adaptec EISA SCSI host adapter driver`
Add new files from Wilko (and in their proper place). Submitted by: Wilko Bulte 1994-09-29 13:54:36 +00:00			`.Sh SYNOPSIS`
Convert to use a SYNPOSIS section that mentions kernel modules. Also add "device scbus" where needed. MFC after: 3 days 2006-05-20 09:39:28 +00:00			`To compile this driver into the kernel,`
			`place the following lines in your`
			`kernel configuration file:`
			`.Bd -ragged -offset indent`
			`.Cd "device scbus"`
			`.Cd "device ahb"`
			`.Ed`
			`.Pp`
			`Alternatively, to load the driver as a`
			`module at boot time, place the following line in`
			`.Xr loader.conf 5 :`
			`.Bd -literal -offset indent`
			`ahb_load="YES"`
			`.Ed`
Add new files from Wilko (and in their proper place). Submitted by: Wilko Bulte 1994-09-29 13:54:36 +00:00			`.Sh DESCRIPTION`
More man page cleanups. 1996-01-19 22:17:57 +00:00			`This driver provides access to the`
			`.Tn SCSI`
Removed whitespace at end-of-line; no content changes. I simply did cd src/share; find man[1-9] -type f\|xargs perl -pi -e 's/[ \t]+$//' BTW, what editors are the culprits? I'm using vim and it shows me whitespace at EOL in troff files with a thick blue block... Reviewed by: Silence from cvs diff -b MFC after: 7 days 2001-07-14 19:41:16 +00:00			`bus connected to an Adaptec`
Add a HARDWARE section which lists supported devices. The actual device listings has been moved (and in some cases more or less rewritten) from the DESCRIPTION section. This will be used later for automatically generating device listings in the Hardware Notes, by parsing the manual pages. Reviewed in principle by: ru, hrs, trhodes No objections: -doc, re Section name inspired by: NetBSD 2004-07-04 14:17:41 +00:00			`AHA-174X host adapters in`
More man page cleanups. 1996-01-19 22:17:57 +00:00			`.Dq Em enhanced`
Update the aha(4) and ahb(4) man pages for CAM. Reviewed by: ken Submitted by: gibbs 1998-10-16 04:41:38 +00:00			`mode.`
Revert my queueing -> queuing commit. Both spellings are correct, and some people prefer the former. Submitted by: ken, nectar 2001-08-25 21:57:02 +00:00			`Tagged queueing and synchronous SCSI transfers are supported.`
Add a HARDWARE section which lists supported devices. The actual device listings has been moved (and in some cases more or less rewritten) from the DESCRIPTION section. This will be used later for automatically generating device listings in the Hardware Notes, by parsing the manual pages. Reviewed in principle by: ru, hrs, trhodes No objections: -doc, re Section name inspired by: NetBSD 2004-07-04 14:17:41 +00:00			`.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`
Update the aha(4) and ahb(4) man pages for CAM. Reviewed by: ken Submitted by: gibbs 1998-10-16 04:41:38 +00:00			`.Sh CAVEATS`
			`The Adaptec 174X is very sensitive to SCSI bus termination and cable`
Hiten's patchset for section four manpages, slightly edited by me. 2003-06-28 23:53:39 +00:00			`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`
Update the aha(4) and ahb(4) man pages for CAM. Reviewed by: ken Submitted by: gibbs 1998-10-16 04:41:38 +00:00			`this nature.`
Add new files from Wilko (and in their proper place). Submitted by: Wilko Bulte 1994-09-29 13:54:36 +00:00			`.Sh SEE ALSO`
More man page cleanups. 1996-01-19 22:17:57 +00:00			`.Xr aha 4 ,`
			`.Xr ahc 4 ,`
Update list of supported devices for ahb 2003-11-09 01:52:13 +00:00			`.Xr aic 4 ,`
More man page cleanups. 1996-01-19 22:17:57 +00:00			`.Xr cd 4 ,`
Update the aha(4) and ahb(4) man pages for CAM. Reviewed by: ken Submitted by: gibbs 1998-10-16 04:41:38 +00:00			`.Xr da 4 ,`
Various man page cleanup: - Sort xrefs - FreeBSD.ORG -> FreeBSD.org - Be consistent with section names as outlined in mdoc(7). - Other misc mdoc cleanup. PR: doc/13144 Submitted by: Alexey M. Zelkin <phantom@cris.net> 1999-08-15 10:48:36 +00:00			`.Xr sa 4 ,`
			`.Xr scsi 4`
.Sh AUTHOR -> .Sh AUTHORS according to mdoc specs. Use .An/.Aq. 1998-03-12 07:31:21 +00:00			`.Sh AUTHORS`
More man page cleanups. 1996-01-19 22:17:57 +00:00			`The`
			`.Nm`
.Sh AUTHOR -> .Sh AUTHORS according to mdoc specs. Use .An/.Aq. 1998-03-12 07:31:21 +00:00			`driver was written by`
Update the aha(4) and ahb(4) man pages for CAM. Reviewed by: ken Submitted by: gibbs 1998-10-16 04:41:38 +00:00			`.An Justin T. Gibbs .`