2 .\" Copyright (c) 2003 Tom Rhodes
3 .\" All rights reserved.
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that the following conditions
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.
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
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 $
34 .Nd IBM/Adaptec ServeRAID controller driver
41 driver claims to support the
43 (now Adaptec) ServeRAID series
46 Some supported devices include:
61 Newer ServeRAID controllers are supported by the
65 These cards come with a built in configuration utility stored in
66 the firmware known as the
68 This utility is accessed with the
70 key combination during the initial card
73 It is highly recommended that this utility be used to configure the card
74 before attempting to diagnose the below error messages.
78 driver can have difficulties attaching during
79 the system initialization period.
80 To avoid these difficulties, set the
86 prevents the driver from attaching.
88 If you see occasional iobuf errors on the console after
92 are issued, you can try setting
93 .Dl debug.ips.ignore_flush_cmd
96 and see if that stops it.
99 command to change this setting after boot.
101 Several error codes may be shown when the card initializes the
104 utility and are independent of
107 .It ips%d: failed to get adapter configuration data from device
108 .It ips%d: failed to get drive configuration data from device
110 Unable to obtain adapter or drive configuration.
111 .It ips%d iobuf error
113 A buffer input/output error has occurred.
116 .Ss General adapter errors:
118 .It Attaching bus failed
120 This message is undocumented.
121 .It WARNING: command timeout. Adapter is in toaster mode, resetting
123 A command timeout has caused the adapter to be reset.
124 .It AIEE! adapter reset failed, giving up and going home! Have a nice day
126 An error occurred while attempting to reset the adapter.
127 .It unable to get adapter configuration
128 .It unable to get drive configuration
130 There was an error when attempting to get configuration information.
131 .It Adapter error during initialization.
132 .It adapter initialization failed
134 There was an error while attempting to initialize the adapter.
135 .It adapter failed config check
136 .It adapter clear failed
138 There was an error while checking the adapter.
139 .It device is disabled
141 The adapter is disabled.
142 .It resource allocation failed
143 .It irq allocation failed
146 The driver was unable to allocate resources for the device.
148 .Ss Error messages due to DMA:
150 .It can't alloc command dma tag
151 .It can't alloc SG dma tag
152 .It can't alloc dma tag for statue queue
155 Failure to map or allocate DMA resources.
157 .Ss Cache, buffer, and command errors:
159 .It failed to initialize command buffers
160 .It no mem for command slots!
167 .It ERROR: unable to get a command! can't flush cache!
168 .It ERROR: cache flush command failed!
169 .It ERROR: unable to get a command! can't update nvram
170 .It ERROR: nvram update command failed!
171 .It ERROR: unable to get a command! can't sync cache!
172 .It ERROR: cache sync command failed!
173 .It ERROR: unable to get a command! can't sync cache!
174 .It ERROR: etable command failed!
177 Unlike many of the other
183 driver does not use the
195 driver was written by
199 .An Scott Long Aq scottl@FreeBSD.org .
201 This manual page was written by
202 .An Tom Rhodes Aq trhodes@FreeBSD.org .