xref: /netbsd-src/share/man/man4/dpt.4 (revision 497a9e953ff79d29ae0bba8ea08421adbe9a3535)
1.\"	$NetBSD: dpt.4,v 1.24 2009/04/10 15:21:09 joerg 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)
78The EATA configuration data did not appear upon request.  This may be caused
79by older firmware.  Generally the solution is to power-cycle the affected
80machine.
81.It dpt%d: spurious intr
82A spurious interrupt was received from the HBA.
83.It dpt%d: bogus status (returned CCB id NNNN)
84A corrupt or incomplete status packet was received from the HBA.
85.El
86.Sh SEE ALSO
87.Xr cd 4 ,
88.Xr ch 4 ,
89.Xr dpti 4 ,
90.Xr intro 4 ,
91.Xr iop 4 ,
92.Xr scsi 4 ,
93.Xr sd 4 ,
94.Xr st 4
95.Pp
96The
97.Pa sysutils/dptutil
98package.
99.Pp
100CAM committee standard CAM/89-004 - the EATA (Enhanced AT Bus Attachment)
101protocol.
102.Sh HISTORY
103The
104.Nm dpt
105driver first appeared in
106.Nx 1.4.2 .
107.Sh BUGS
108EATA adapters other than listed may function correctly with the
109.Nm
110driver, however a definitive list is not available.
111.Pp
112Older boards that do not support scatter-gather I/O or DMA are not supported.
113.Pp
114ECC formatted disk and arrays (i.e. with a sector size of 528 bytes) do not
115work correctly with the PM2041 and certain firmware revisions of the PM3334.
116