| blob | aa71a922707147d17ebe16a10dc936580c6d5002 |
1 '\" te
2 .\" Copyright (c) 2008, Sun Microsystems, Inc. , All Rights Reserved
3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 .TH SCSI_INQUIRY 9S "Nov 5, 2008"
7 .SH NAME
8 scsi_inquiry \- SCSI inquiry structure
9 .SH SYNOPSIS
10 .LP
11 .nf
12 #include <sys/scsi/scsi.h>
13 .fi
15 .SH INTERFACE LEVEL
16 .sp
17 .LP
18 Solaris DDI specific (Solaris DDI).
19 .SH DESCRIPTION
20 .sp
21 .LP
22 The \fBscsi_inquiry\fR structure contains 36 required bytes, followed by a
23 variable number of vendor-specific parameters. Bytes 59 through 95, if
24 returned, are reserved for future standardization. This structure is part of
25 \fBscsi_device\fR(9S) structure and typically filled in by
26 \fBscsi_probe\fR(9F).
27 .SH STRUCTURE MEMBERS
28 .sp
29 .in +2
30 .nf
31 Lines that start with an 'X' will be deleted before submission;
32 they are being classified as unstable at this time.
34 uchar_t inq_dtype; /* Periph. qualifier, dev. type */
35 uchar_t inq_rmb :1; /* Removable media */
36 uchar_t inq_qual :7; /* Dev. type qualifier */
37 uchar_t inq_iso :2; /* ISO version */
38 uchar_t inq_ecma :3; /* EMCA version */
39 uchar_t inq_ansi :3; /* ANSII version */
40 uchar_t inq_aenc :1; /* Async event notif. cap. */
41 uchar_t inq_trmiop :1; /* Supports TERMINATE I/O PROC msg */
42 uchar_t inq_normaca :1; /* setting NACA bit supported */
43 uchar_t inq_hisup :1; /* hierarchical addressing model */
44 uchar_t inq_rdf :4; /* Response data format */
45 uchar_t inq_len /* Additional length */
46 uchar_t inq_sccs :1; /* embedded storage array */
47 Xuchar_t inq_acc :1; /* access controls coordinator */
48 uchar_t inq_tpgse :1; /* explicit asymmetric lun access */
49 uchar_t inq_tpgsi :1; /* implicit asymmetric lun access */
50 Xuchar_t inq_3pc :1; /* third-party copy */
51 Xuchar_t inq_protect :1; /* supports protection information */
52 uchar_t inq_bque :1; /* basic queueing */
53 uchar_t inq_encserv :1; /* embedded enclosure services */
54 uchar_t inq_dualp :1; /* dual port device */
55 uchar_t inq_mchngr :1; /* embedded/attached to medium chngr */
56 uchar_t inq_addr16 :1; /* SPI: supports 16 bit wide SCSI addr */
57 uchar_t inq_wbus16 :1; /* SPI: Supports 16 bit wide data xfers */
58 uchar_t inq_sync :1; /* SPI: Supports synchronous data xfers */
59 uchar_t inq_linked :1; /* Supports linked commands */
60 uchar_t inq_cmd_que :1; /* Supports command queueing */
61 uchar_t inq_sftre :1; /* Supports Soft Reset option */
62 char inq_vid[8]; /* Vendor ID */
63 char inq_pid[16]; /* Product ID */
64 char inq_revision[4]; /* Revision level */
65 uchar_t inq_clk :2; /* SPI3 clocking */
66 uchar_t inq_qas :1; /* SPI3: quick arb sel */
67 uchar_t inq_ius :1; /* SPI3: information units */
68 .fi
69 .in -2
71 .sp
72 .LP
73 \fBinq_dtype\fR identifies the type of device. Bits 0 - 4 represent the
74 Peripheral Device Type and bits 5 - 7 represent the Peripheral Qualifier. The
75 following values are appropriate for Peripheral Device Type field:
76 .sp
77 .ne 2
78 .na
79 \fB\fBDTYPE_DIRECT\fR\fR
80 .ad
81 .RS 20n
82 Direct-access device (for example, magnetic disk).
83 .RE
85 .sp
86 .ne 2
87 .na
88 \fB\fBDTYPE_SEQUENTIAL\fR\fR
89 .ad
90 .RS 20n
91 Sequential-access device (for example, magnetic tape).
92 .RE
94 .sp
95 .ne 2
96 .na
97 \fB\fBDTYPE_PRINTER\fR\fR
98 .ad
99 .RS 20n
100 Printer device.
101 .RE
103 .sp
104 .ne 2
105 .na
106 \fB\fBDTYPE_PROCESSOR\fR\fR
107 .ad
108 .RS 20n
109 Processor device.
110 .RE
112 .sp
113 .ne 2
114 .na
115 \fB\fBDTYPE_WORM\fR\fR
116 .ad
117 .RS 20n
118 Write-once device (for example, some optical disks).
119 .RE
121 .sp
122 .ne 2
123 .na
124 \fB\fBDTYPE_RODIRECT\fR\fR
125 .ad
126 .RS 20n
127 CD-ROM device.
128 .RE
130 .sp
131 .ne 2
132 .na
133 \fB\fBDTYPE_SCANNER\fR\fR
134 .ad
135 .RS 20n
136 Scanner device.
137 .RE
139 .sp
140 .ne 2
141 .na
142 \fB\fBDTYPE_OPTICAL\fR\fR
143 .ad
144 .RS 20n
145 Optical memory device (for example, some optical disks).
146 .RE
148 .sp
149 .ne 2
150 .na
151 \fB\fBDTYPE_CHANGER\fR\fR
152 .ad
153 .RS 20n
154 Medium Changer device (for example, jukeboxes).
155 .RE
157 .sp
158 .ne 2
159 .na
160 \fB\fBDTYPE_COMM\fR\fR
161 .ad
162 .RS 20n
163 Communications device.
164 .RE
166 .sp
167 .ne 2
168 .na
169 \fB\fBDTYPE_ARRAY_CTRL\fR\fR
170 .ad
171 .RS 20n
172 Array controller device (for example, \fBRAID\fR).
173 .RE
175 .sp
176 .ne 2
177 .na
178 \fB\fBDTYPE_ESI\fR\fR
179 .ad
180 .RS 20n
181 Enclosure services device.
182 .RE
184 .sp
185 .ne 2
186 .na
187 \fB\fBDTYPE_RBC\fR\fR
188 .ad
189 .RS 20n
190 Simplified direct-access device.
191 .RE
193 .sp
194 .ne 2
195 .na
196 \fB\fBDTYPE_OCRW\fR\fR
197 .ad
198 .RS 20n
199 Optical card reader/writer device.
200 .RE
202 .sp
203 .ne 2
204 .na
205 \fB\fBDTYPE_BRIDGE\fR\fR
206 .ad
207 .RS 20n
208 Bridge.
209 .RE
211 .sp
212 .ne 2
213 .na
214 \fB\fBDTYPE_OSD\fR\fR
215 .ad
216 .RS 20n
217 Object-based storage device.
218 .RE
220 .sp
221 .ne 2
222 .na
223 \fB\fBDTYPE_UNKNOWN\fR\fR
224 .ad
225 .RS 20n
226 Unknown or no device type.
227 .RE
229 .sp
230 .ne 2
231 .na
232 \fB\fBDTYPE_MASK\fR\fR
233 .ad
234 .RS 20n
235 Mask to isolate Peripheral Device Type field.
236 .RE
238 .sp
239 .LP
240 The following values are appropriate for the Peripheral Qualifier field:
241 .sp
242 .ne 2
243 .na
244 \fB\fBDPQ_POSSIBLE\fR\fR
245 .ad
246 .RS 17n
247 The specified peripheral device type is currently connected to this logical
248 unit. If the target cannot determine whether or not a physical device is
249 currently connected, it uses this peripheral qualifier when returning the
250 \fBINQUIRY\fR data. This peripheral qualifier does not imply that the device is
251 ready for access by the initiator.
252 .RE
254 .sp
255 .ne 2
256 .na
257 \fB\fBDPQ_SUPPORTED\fR\fR
258 .ad
259 .RS 17n
260 The target is capable of supporting the specified peripheral device type on
261 this logical unit. However, the physical device is not currently connected to
262 this logical unit.
263 .RE
265 .sp
266 .ne 2
267 .na
268 \fB\fBDPQ_NEVER\fR\fR
269 .ad
270 .RS 17n
271 The target is not capable of supporting a physical device on this logical unit.
272 For this peripheral qualifier, the peripheral device type shall be set to
273 \fBDTYPE_UNKNOWN\fR to provide compatibility with previous versions of
274 \fBSCSI\fR. For all other peripheral device type values, this peripheral
275 qualifier is reserved.
276 .RE
278 .sp
279 .ne 2
280 .na
281 \fB\fBDPQ_VUNIQ\fR\fR
282 .ad
283 .RS 17n
284 This is a vendor-unique qualifier.
285 .RE
287 .sp
288 .ne 2
289 .na
290 \fB\fBDPQ_MASK\fR\fR
291 .ad
292 .RS 17n
293 Mask to isolate Peripheral Qualifier field.
294 .RE
296 .sp
297 .LP
298 \fBDTYPE_NOTPRESENT\fR is the peripheral qualifier \fBDPQ_NEVER\fR and the
299 peripheral device type \fBDTYPE_UNKNOWN\fR combined.
300 .sp
301 .LP
302 \fBinq_rmb\fR, if set, indicates that the medium is removable.
303 .sp
304 .LP
305 \fBinq_qual\fR is a device type qualifier.
306 .sp
307 .LP
308 \fBinq_iso\fR indicates \fBISO \fRversion.
309 .sp
310 .LP
311 \fBinq_ecma\fR indicates \fBECMA \fRversion.
312 .sp
313 .LP
314 \fBinq_ansi\fR indicates \fBANSI \fRversion.
315 .sp
316 .LP
317 \fBinq_aenc\fR, if set, indicates that the device supports asynchronous event
318 notification capability as defined in \fBSCSI-2 \fRspecification.
319 .sp
320 .LP
321 \fBinq_trmiop\fR, if set, indicates that the device supports the \fBTERMINATE
322 I/O PROCESS\fRmessage.
323 .sp
324 .LP
325 \fBinq_normaca\fR, if set, indicates that the device supports setting the
326 \fBNACA\fR bit to 1 in \fBCDB\fR.
327 .sp
328 .LP
329 \fBinq_hisip\fR, if set, indicates the \fBSCSI\fR target device uses the
330 hierarchical addressing model to assign \fBLUN\fRs to logical units.
331 .sp
332 .LP
333 \fBinq_rdf\fR, if set, indicates the \fBINQUIRY\fR data response data format:
334 "\fBRDF_LEVEL0\fR" means that this structure complies with the \fBSCSI-1\fR
335 spec, "\fBRDF_CCS\fR" means that this structure complies with the \fBCCS\fR
336 pseudo-spec, and "\fBRDF_SCSI2\fR" means that the structure complies with the
337 \fBSCSI-2\fR/3 spec.
338 .sp
339 .LP
340 \fBinq_len\fR, if set, is the additional length field that specifies the length
341 in bytes of the parameters.
342 .sp
343 .LP
344 \fBinq_sccs\fR, if set, indicates the target device contains an embedded
345 storage array controller component.
346 .sp
347 .LP
348 \fBinq_acc\fR, if set, indicates that the logical unit contains an access
349 controls coordinator (this structure member will be deleted before submission.
350 It is being classified as unstable at this time).
351 .sp
352 .LP
353 \fBinq_tpgse\fR, if set, indicates that implicit asymmetric logical unit access
354 is supported.
355 .sp
356 .LP
357 \fBinq_tpgsi\fR, if set, indicates that explicit asymmetric logical unit access
358 is supported.
359 .sp
360 .LP
361 \fBinq_3pc\fR, if set, indicates that the \fBSCSI\fR target device supports
362 third-party copy commands (this structure member will be deleted before
363 submission. It is being classified as unstable at this time).
364 .sp
365 .LP
366 \fBinq_protect\fR, if set, indicates that the logical unit supports protection
367 information (this structure member will be deleted before submission. It is
368 being classified as unstable at this time).
369 .sp
370 .LP
371 \fBinq_bque\fR, if set, indicates that the logical unit supports basic task
372 management.
373 .sp
374 .LP
375 \fBinq_encserv\fR, if set, indicates that the device contains an embedded
376 enclosure services component (\fBses\fR(7D)).
377 .sp
378 .LP
379 \fBinq_dualp\fR, if set, indicates that the \fBSCSI\fR target device supports
380 two or more ports.
381 .sp
382 .LP
383 \fBinq_mchngr\fR, if set, indicates that the \fBSCSI\fR target device supports
384 commands to control an attached media changer.
385 .sp
386 .LP
387 \fBinq_addr16\fR, if set, indicates that the device supports 16-bit wide
388 \fBSCSI\fR addresses.
389 .sp
390 .LP
391 \fBinq_wbus16\fR, if set, indicates that the device supports 16-bit wide data
392 transfers.
393 .sp
394 .LP
395 \fBinq_sync\fR, if set, indicates that the device supports synchronous data
396 transfers.
397 .sp
398 .LP
399 \fBinq_linked\fR, if set, indicates that the device supports linked commands
400 for this logical unit.
401 .sp
402 .LP
403 \fBinq_cmdque\fR, if set, indicates that the device supports tagged command
404 queueing.
405 .sp
406 .LP
407 \fBinq_sftre\fR, if reset, indicates that the device responds to the
408 \fBRESET\fR condition with the hard \fBRESET\fR alternative. If this bit is
409 set, this indicates that the device responds with the soft \fBRESET\fR
410 alternative.
411 .sp
412 .LP
413 \fBinq_vid\fR contains eight bytes of \fBASCII \fRdata identifying the vendor
414 of the product.
415 .sp
416 .LP
417 \fBinq_pid\fR contains sixteen bytes of \fBASCII \fRdata as defined by the
418 vendor.
419 .sp
420 .LP
421 \fBinq_revision\fR contains four bytes of \fBASCII \fRdata as defined by the
422 vendor.
423 .sp
424 .LP
425 \fBinq_clk\fR clocking of the \fBSPI3\fR target port.
426 .sp
427 .LP
428 \fBinq_gas\fR the \fBSPI3\fR target port supports quick arbitration and
429 selection.
430 .sp
431 .LP
432 \fBinq_ius\fR the \fBSPI3\fR target device supports information unit transfers.
433 .SH SEE ALSO
434 .sp
435 .LP
436 \fBscsi_probe\fR(9F), \fBscsi_device\fR(9S)
437 .sp
438 .LP
439 \fIANSI Small Computer System Interface-2 (SCSI-2)\fR
440 .sp
441 .LP
442 \fIANSI SCSI Primary Commands-3 (SPC-3)\fR
443 .sp
444 .LP
445 http://t10.org/drafts.htm#spc3
446 .sp
447 .LP
448 \fIWriting Device Drivers\fR