xref: /netbsd/share/man/man4/dpt.4 (revision c4a72b64)
1.\"	$NetBSD: dpt.4,v 1.19 2002/12/07 20:01:03 ad 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 DIAGNOSTICS
67None of these messages should be encountered under normal circumstances.  It
68should be noted that the list below is not complete.
69.Pp
70.Bl -tag -width indent
71.It dpt%d: readcfg failed - see dpt(4)
72.br
73The EATA configuration data did not appear upon request.  This may be caused
74by older firmware.  Generally the solution is to power-cycle the affected
75machine.
76.br
77.It dpt%d: spurious intr
78.br
79A spurious interrupt was received from the HBA.
80.br
81.It dpt%d: bogus status (returned CCB id NNNN)
82.br
83A corrupt or incomplete status packet was received from the HBA.
84.El
85.Sh FILES
86.Bl -tag -width /dev/dptn -compact
87.It Pa /dev/dpt Ns Ar u
88control device for unit
89.Ar u
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/raidutil
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 Aq ad@netbsd.org ,
117based upon the
118.Nm uha
119and
120.Nm bha
121drivers, which are the work of others.
122.Sh BUGS
123EATA adapters other than listed may function correctly with the
124.Nm
125driver, however a definitive list is not available.
126.Pp
127Older boards that do not support scatter-gather I/O or DMA are not supported.
128.Pp
129ECC formatted disk and arrays (i.e. with a sector size of 528 bytes) do not
130work correctly with the PM2041 and certain firmware revisions of the PM3334.
131