1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
|
<table class="head">
<tr>
<td class="head-ltitle">IPS(4)</td>
<td class="head-vol">Device Drivers Manual</td>
<td class="head-rtitle">IPS(4)</td>
</tr>
</table>
<div class="manual-text">
<section class="Sh">
<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
<p class="Pp"><code class="Nm">ips</code> — <span class="Nd">IBM/Adaptec
ServeRAID controller driver</span></p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<p class="Pp">To compile this driver into the kernel, place the following lines
in your kernel configuration file:</p>
<div class="Bd Pp Bd-indent"><code class="Cd">device pci</code>
<br/>
<code class="Cd">device scbus</code>
<br/>
<code class="Cd">device ips</code></div>
<p class="Pp">Alternatively, to load the driver as a module at boot time, place
the following line in <a class="Xr">loader.conf(5)</a>:</p>
<div class="Bd Pp Bd-indent Li">
<pre>ips_load="YES"</pre>
</div>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp">The <code class="Nm">ips</code> driver claims to support the IBM
(now Adaptec) ServeRAID series SCSI controller cards.</p>
<p class="Pp" id="Ctrl+I">These cards come with a built in configuration utility
stored in the firmware known as the ISPR. This utility is accessed with the
⟨<a class="permalink" href="#Ctrl+I"><i class="Em">Ctrl+I</i></a>⟩
key combination during the initial card POST.</p>
<p class="Pp">It is highly recommended that this utility be used to configure
the card before attempting to diagnose the below error messages.</p>
<p class="Pp">In some cases, the <code class="Nm">ips</code> driver can have
difficulties attaching during the system initialization period. To avoid
these difficulties, set the <var class="Va">hw.ips.0.disable</var> tunable
to 1. It will prevent the driver from attaching.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="HARDWARE"><a class="permalink" href="#HARDWARE">HARDWARE</a></h1>
<p class="Pp">Controllers supported by the <code class="Nm">ips</code> driver
include:</p>
<p class="Pp"></p>
<ul class="Bl-bullet Bl-compact">
<li>IBM ServeRAID 3H</li>
<li>ServeRAID 4L/4M/4H</li>
<li>ServeRAID Series 5</li>
<li>ServeRAID 6i/6M</li>
<li>ServeRAID 7t/7k/7M</li>
</ul>
<p class="Pp">Newer ServeRAID controllers are supported by the
<a class="Xr">aac(4)</a> or <a class="Xr">mfi(4)</a> driver.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="DIAGNOSTICS"><a class="permalink" href="#DIAGNOSTICS">DIAGNOSTICS</a></h1>
<p class="Pp">Several error codes may be shown when the card initializes the IBM
ISPR utility and are independent of <span class="Ux">FreeBSD</span>.</p>
<dl class="Bl-diag">
<dt>ips%d: failed to get adapter configuration data from device</dt>
<dd></dd>
<dt>ips%d: failed to get drive configuration data from device</dt>
<dd>
<p class="Pp">Unable to obtain adapter or drive configuration.</p>
</dd>
<dt>ips%d iobuf error</dt>
<dd>
<p class="Pp">A buffer input/output error has occurred.
[<code class="Er">ENXIO</code>]</p>
</dd>
</dl>
<section class="Ss">
<h2 class="Ss" id="General_adapter_errors_:"><a class="permalink" href="#General_adapter_errors_:">General
adapter errors:</a></h2>
<dl class="Bl-diag">
<dt>Attaching bus failed</dt>
<dd>
<p class="Pp">This message is undocumented.</p>
</dd>
<dt>WARNING: command timeout. Adapter is in toaster mode, resetting</dt>
<dd>
<p class="Pp">A command timeout has caused the adapter to be reset.</p>
</dd>
<dt>AIEE! adapter reset failed, giving up and going home! Have a nice day</dt>
<dd>
<p class="Pp">An error occurred while attempting to reset the adapter.</p>
</dd>
<dt>unable to get adapter configuration</dt>
<dd></dd>
<dt>unable to get drive configuration</dt>
<dd>
<p class="Pp">There was an error when attempting to get configuration
information.</p>
</dd>
<dt>Adapter error during initialization.</dt>
<dd></dd>
<dt>adapter initialization failed</dt>
<dd>
<p class="Pp">There was an error while attempting to initialize the
adapter.</p>
</dd>
<dt>adapter failed config check</dt>
<dd></dd>
<dt>adapter clear failed</dt>
<dd>
<p class="Pp">There was an error while checking the adapter.</p>
</dd>
<dt>device is disabled</dt>
<dd>
<p class="Pp">The adapter is disabled.</p>
</dd>
<dt>resource allocation failed</dt>
<dd></dd>
<dt>irq allocation failed</dt>
<dd></dd>
<dt>irq setup failed</dt>
<dd>
<p class="Pp">The driver was unable to allocate resources for the
device.</p>
</dd>
</dl>
</section>
<section class="Ss">
<h2 class="Ss" id="Error_messages_due_to_DMA_:"><a class="permalink" href="#Error_messages_due_to_DMA_:">Error
messages due to DMA:</a></h2>
<dl class="Bl-diag">
<dt>can't alloc command dma tag</dt>
<dd></dd>
<dt>can't alloc SG dma tag</dt>
<dd></dd>
<dt>can't alloc dma tag for statue queue</dt>
<dd></dd>
<dt>dmamap failed</dt>
<dd>
<p class="Pp">Failure to map or allocate DMA resources.</p>
</dd>
</dl>
</section>
<section class="Ss">
<h2 class="Ss" id="Cache,_buffer,_and_command_errors_:"><a class="permalink" href="#Cache,_buffer,_and_command_errors_:">Cache,
buffer, and command errors:</a></h2>
<dl class="Bl-diag">
<dt>failed to initialize command buffers</dt>
<dd></dd>
<dt>no mem for command slots!</dt>
<dd>
<p class="Pp">The <code class="Nm">ips</code> driver will return
[<code class="Er">ENOMEM</code>] in such cases.</p>
</dd>
<dt>ERROR: unable to get a command! can't flush cache!</dt>
<dd></dd>
<dt>ERROR: cache flush command failed!</dt>
<dd></dd>
<dt>ERROR: unable to get a command! can't update nvram</dt>
<dd></dd>
<dt>ERROR: nvram update command failed!</dt>
<dd></dd>
<dt>ERROR: unable to get a command! can't sync cache!</dt>
<dd></dd>
<dt>ERROR: cache sync command failed!</dt>
<dd></dd>
<dt>ERROR: unable to get a command! can't sync cache!</dt>
<dd></dd>
<dt>ERROR: etable command failed!</dt>
<dd></dd>
</dl>
</section>
</section>
<section class="Sh">
<h1 class="Sh" id="COMPATIBILITY"><a class="permalink" href="#COMPATIBILITY">COMPATIBILITY</a></h1>
<p class="Pp">Unlike many of the other SCSI devices in
<span class="Ux">FreeBSD</span>, the <code class="Nm">ips</code> driver does
not use the <a class="Xr">cam(4)</a> SCSI subsystem.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
ALSO</a></h1>
<p class="Pp"><a class="Xr">aac(4)</a>, <a class="Xr">ch(4)</a>,
<a class="Xr">da(4)</a>, <a class="Xr">mfi(4)</a>,
<a class="Xr">sysctl(8)</a></p>
</section>
<section class="Sh">
<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<p class="Pp">The <code class="Nm">ips</code> driver was written by
<span class="An">David Jefferys</span> and <span class="An">Scott
Long</span>
<<a class="Mt" href="mailto:scottl@FreeBSD.org">scottl@FreeBSD.org</a>>.</p>
<p class="Pp">This manual page was written by <span class="An">Tom Rhodes</span>
<<a class="Mt" href="mailto:trhodes@FreeBSD.org">trhodes@FreeBSD.org</a>>.</p>
</section>
</div>
<table class="foot">
<tr>
<td class="foot-date">August 7, 2009</td>
<td class="foot-os">FreeBSD 15.0</td>
</tr>
</table>
|
