xref: /netbsd-src/share/man/man4/dpt.4 (revision 23c8222edbfb0f0932d88a8351d3a0cf817dfb9e)
1.\"	$NetBSD: dpt.4,v 1.22 2003/02/14 15:20:18 grant Exp $
2.\"
3.\" Copyright (c) 1999, 2000, 2002 Andrew Doran <ad@NetBSD.org>
4.\" All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. The name of the author may not be used to endorse or promote products
12.\"    derived from this software without specific prior written permission
13.\"
14.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
15.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
16.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
17.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
18.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
19.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
20.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
21.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
23.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
24.\"
25.Dd December 7, 2002
26.Dt DPT 4
27.Os
28.Sh NAME
29.Nm dpt
30.Nd
31DPT EATA
32.Tn SCSI
33adapter driver
34.Sh SYNOPSIS
35.Cd "dpt* at isa? port ? irq ? dma ?"
36.Cd "dpt* at eisa? slot ?"
37.Cd "dpt* at pci? dev ? function ?"
38.Cd "scsibus* at dpt?"
39.Sh DESCRIPTION
40The
41.Nm
42driver provides support for third and fourth generation DPT
43.Tn SCSI
44controllers.  All communication with the controllers is conducted via the
45EATA (Enhanced AT Bus Attachment) protocol.
46.Pp
47DPT adapters examine and interpret all
48.Tn SCSI
49commands received before passing them to any underlying physical device(s).
50In this way, caching, RAID and other transformations are achieved while
51remaining transparent to the host operating system.
52.Sh HARDWARE
53The
54.Nm
55driver provides support for the adapters listed below.  Later models are
56supported by the
57.Nm iop
58driver.
59.Pp
60.Bl -tag -width Dv -offset indent -compact
61.It Tn DPT SmartCache III
62.It Tn DPT SmartCache IV
63.It Tn DPT SmartRAID III
64.It Tn DPT SmartRAID IV
65.El
66.Sh FILES
67.Bl -tag -width /dev/dptn -compact
68.It Pa /dev/dpt Ns Ar u
69control device for unit
70.Ar u
71.El
72.Sh DIAGNOSTICS
73None of these messages should be encountered under normal circumstances.  It
74should be noted that the list below is not complete.
75.Pp
76.Bl -tag -width indent
77.It dpt%d: readcfg failed - see dpt(4)
78.br
79The EATA configuration data did not appear upon request.  This may be caused
80by older firmware.  Generally the solution is to power-cycle the affected
81machine.
82.br
83.It dpt%d: spurious intr
84.br
85A spurious interrupt was received from the HBA.
86.br
87.It dpt%d: bogus status (returned CCB id NNNN)
88.br
89A corrupt or incomplete status packet was received from the HBA.
90.El
91.Sh SEE ALSO
92.Xr cd 4 ,
93.Xr ch 4 ,
94.Xr dpti 4 ,
95.Xr intro 4 ,
96.Xr iop 4 ,
97.Xr scsi 4 ,
98.Xr sd 4 ,
99.Xr st 4
100.Pp
101The
102.Pa sysutils/dptutil
103package.
104.Pp
105CAM committee standard CAM/89-004 - the EATA (Enhanced AT Bus Attachment)
106protocol.
107.Sh HISTORY
108The
109.Nm dpt
110driver first appeared in
111.Nx 1.4.2 .
112.Sh AUTHORS
113The
114.Nm
115driver was written by
116.An Andrew Doran
117.Aq ad@NetBSD.org ,
118based upon the
119.Nm uha
120and
121.Nm bha
122drivers, which are the work of others.
123.Sh BUGS
124EATA adapters other than listed may function correctly with the
125.Nm
126driver, however a definitive list is not available.
127.Pp
128Older boards that do not support scatter-gather I/O or DMA are not supported.
129.Pp
130ECC formatted disk and arrays (i.e. with a sector size of 528 bytes) do not
131work correctly with the PM2041 and certain firmware revisions of the PM3334.
132