xref: /dragonfly/share/man/man4/ips.4 (revision e293de53) 
1.\"
2.\" Copyright (c) 2003 Tom Rhodes
3.\" All rights reserved.
4.\"
5.\" Redistribution and use in source and binary forms, with or without
6.\" modification, are permitted provided that the following conditions
7.\" are met:
8.\" 1. Redistributions of source code must retain the above copyright
9.\"    notice, this list of conditions and the following disclaimer.
10.\" 2. Redistributions in binary form must reproduce the above copyright
11.\"    notice, this list of conditions and the following disclaimer in the
12.\"    documentation and/or other materials provided with the distribution.
13.\"
14.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24.\" SUCH DAMAGE.
25.\"
26.\" $FreeBSD: src/share/man/man4/ips.4,v 1.2 2003/11/12 02:26:47 hmp Exp $
27.\" $DragonFly: src/share/man/man4/ips.4,v 1.3 2008/05/02 02:05:05 swildner Exp $
28.\"
29.Dd November 11, 2003
30.Dt IPS 4
31.Os
32.Sh NAME
33.Nm ips
34.Nd IBM/Adaptec ServeRAID controller driver
35.Sh SYNOPSIS
36.Cd device scbus
37.Cd device ips
38.Sh DESCRIPTION
39The
40.Nm
41driver claims to support the
42.Tn IBM
43(now Adaptec) ServeRAID series
44.Tn SCSI
45controller cards.
46Some supported devices include:
47.Pp
48.Bl -item -compact
49.It
50IBM ServeRAID 3H
51.It
52ServeRAID 4L/4M/4H
53.It
54ServeRAID Series 5
55.It
56ServeRAID 6i/6M
57.El
58.Pp
59These cards come with a built in configuration utility stored in
60the firmware known as the
61.Tn ISPR .
62This utility is accessed with the
63.Em CTRL + I
64key combination during the initial card
65.Tn POST .
66.Pp
67It is highly recommended that this utility be used to configure the card
68before attempting to diagnose the below error messages.
69.Pp
70In some cases, the
71.Nm
72driver can have difficulties attaching during
73the system initialization period.
74To avoid these difficulties, set the
75.Dl hw.ips.0.disable
76tunable to
77.Dq 1 .
78This
79.Tn MIB
80prevents the driver from attaching.
81.Sh DIAGNOSTICS
82Several error codes may be shown when the card initializes the
83.Tn IBM
84.Tn ISPR
85utility and are independent of
86.Dx .
87.Bl -diag
88.It ips%d: failed to get adapter configuration data from device
89.It ips%d: failed to get drive configuration data from device
90.Pp
91Unable to obtain adapter or drive configuration.
92.It ips%d iobuf error
93.Pp
94A buffer input/output error has occurred.
95.Bq Er ENXIO
96.El
97.Ss General adapter errors:
98.Bl -diag
99.It Attaching bus failed
100.Pp
101This message is undocumented.
102.It WARNING: command timeout. Adapter is in toaster mode, resetting
103.Pp
104A command timeout has caused the adapter to be reset.
105.It AIEE! adapter reset failed, giving up and going home! Have a nice day
106.Pp
107An error occurred while attempting to reset the adapter.
108.It unable to get adapter configuration
109.It unable to get drive configuration
110.Pp
111There was an error when attempting to get configuration information.
112.It Adapter error during initialization.
113.It adapter initialization failed
114.Pp
115There was an error while attempting to initialize the adapter.
116.It adapter failed config check
117.It adapter clear failed
118.Pp
119There was an error while checking the adapter.
120.It device is disabled
121.Pp
122The adapter is disabled.
123.It resource allocation failed
124.It irq allocation failed
125.It irq setup failed
126.Pp
127The driver was unable to allocate resources for the device.
128.El
129.Ss Error messages due to DMA:
130.Bl -diag
131.It can't alloc command dma tag
132.It can't alloc SG dma tag
133.It can't alloc dma tag for statue queue
134.It dmamap failed
135.Pp
136Failure to map or allocate DMA resources.
137.El
138.Ss Cache, buffer, and command errors:
139.Bl -diag
140.It failed to initialize command buffers
141.It no mem for command slots!
142.Pp
143The
144.Nm
145driver will return
146.Bq Er ENOMEM
147in such cases.
148.It ERROR: unable to get a command! can't flush cache!
149.It ERROR: cache flush command failed!
150.It ERROR: unable to get a command! can't update nvram
151.It ERROR: nvram update command failed!
152.It ERROR: unable to get a command! can't sync cache!
153.It ERROR: cache sync command failed!
154.It ERROR: unable to get a command! can't sync cache!
155.It ERROR: etable command failed!
156.El
157.Sh COMPATIBILITY
158Unlike many of the other
159.Tn SCSI
160devices in
161.Dx ,
162the
163.Nm
164driver does not use the
165.Xr cam 4
166.Tn SCSI
167subsystem.
168.Sh SEE ALSO
169.Xr ch 4 ,
170.Xr da 4 ,
171.Xr sysctl 8
172.Sh AUTHORS
173The
174.Nm
175driver was written by
176.An -nosplit
177.An David Jefferys
178and
179.An Scott Long Aq scottl@FreeBSD.org .
180.Pp
181This manual page was written by
182.An Tom Rhodes Aq trhodes@FreeBSD.org .
183