2 * Copyright (C) IBM Corp. 2003
4 * Author: Patrick Mansfield<patmans@us.ibm.com>
6 * This program is free software: you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation, either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program. If not, see <http://www.gnu.org/licenses/>.
23 #include <linux/bsg.h>
24 #include <linux/types.h>
25 #include <scsi/scsi.h>
30 #include <sys/ioctl.h>
32 #include <sys/types.h>
36 #include "libudev-private.h"
38 #include "random-util.h"
41 #include "string-util.h"
44 * A priority based list of id, naa, and binary/ascii for the identifier
45 * descriptor in VPD page 0x83.
47 * Brute force search for a match starting with the first value in the
48 * following id_search_list. This is not a performance issue, since there
49 * is normally one or some small number of descriptors.
51 static const struct scsi_id_search_values id_search_list
[] = {
52 { SCSI_ID_TGTGROUP
, SCSI_ID_NAA_DONT_CARE
, SCSI_ID_BINARY
},
53 { SCSI_ID_NAA
, SCSI_ID_NAA_IEEE_REG_EXTENDED
, SCSI_ID_BINARY
},
54 { SCSI_ID_NAA
, SCSI_ID_NAA_IEEE_REG_EXTENDED
, SCSI_ID_ASCII
},
55 { SCSI_ID_NAA
, SCSI_ID_NAA_IEEE_REG
, SCSI_ID_BINARY
},
56 { SCSI_ID_NAA
, SCSI_ID_NAA_IEEE_REG
, SCSI_ID_ASCII
},
58 * Devices already exist using NAA values that are now marked
59 * reserved. These should not conflict with other values, or it is
60 * a bug in the device. As long as we find the IEEE extended one
61 * first, we really don't care what other ones are used. Using
62 * don't care here means that a device that returns multiple
63 * non-IEEE descriptors in a random order will get different
66 { SCSI_ID_NAA
, SCSI_ID_NAA_DONT_CARE
, SCSI_ID_BINARY
},
67 { SCSI_ID_NAA
, SCSI_ID_NAA_DONT_CARE
, SCSI_ID_ASCII
},
68 { SCSI_ID_EUI_64
, SCSI_ID_NAA_DONT_CARE
, SCSI_ID_BINARY
},
69 { SCSI_ID_EUI_64
, SCSI_ID_NAA_DONT_CARE
, SCSI_ID_ASCII
},
70 { SCSI_ID_T10_VENDOR
, SCSI_ID_NAA_DONT_CARE
, SCSI_ID_BINARY
},
71 { SCSI_ID_T10_VENDOR
, SCSI_ID_NAA_DONT_CARE
, SCSI_ID_ASCII
},
72 { SCSI_ID_VENDOR_SPECIFIC
, SCSI_ID_NAA_DONT_CARE
, SCSI_ID_BINARY
},
73 { SCSI_ID_VENDOR_SPECIFIC
, SCSI_ID_NAA_DONT_CARE
, SCSI_ID_ASCII
},
76 static const char hex_str
[]="0123456789abcdef";
79 * Values returned in the result/status, only the ones used by the code
83 #define DID_NO_CONNECT 0x01 /* Unable to connect before timeout */
84 #define DID_BUS_BUSY 0x02 /* Bus remain busy until timeout */
85 #define DID_TIME_OUT 0x03 /* Timed out for some other reason */
86 #define DRIVER_TIMEOUT 0x06
87 #define DRIVER_SENSE 0x08 /* Sense_buffer has been set */
89 /* The following "category" function returns one of the following */
90 #define SG_ERR_CAT_CLEAN 0 /* No errors or other information */
91 #define SG_ERR_CAT_MEDIA_CHANGED 1 /* interpreted from sense buffer */
92 #define SG_ERR_CAT_RESET 2 /* interpreted from sense buffer */
93 #define SG_ERR_CAT_TIMEOUT 3
94 #define SG_ERR_CAT_RECOVERED 4 /* Successful command after recovered err */
95 #define SG_ERR_CAT_NOTSUPPORTED 5 /* Illegal / unsupported command */
96 #define SG_ERR_CAT_SENSE 98 /* Something else in the sense buffer */
97 #define SG_ERR_CAT_OTHER 99 /* Some other error/warning */
99 static int do_scsi_page80_inquiry(struct udev
*udev
,
100 struct scsi_id_device
*dev_scsi
, int fd
,
101 char *serial
, char *serial_short
, int max_len
);
103 static int sg_err_category_new(struct udev
*udev
,
104 int scsi_status
, int msg_status
, int
105 host_status
, int driver_status
, const
106 unsigned char *sense_buffer
, int sb_len
)
111 * XXX change to return only two values - failed or OK.
114 if (!scsi_status
&& !host_status
&& !driver_status
)
115 return SG_ERR_CAT_CLEAN
;
117 if ((scsi_status
== SCSI_CHECK_CONDITION
) ||
118 (scsi_status
== SCSI_COMMAND_TERMINATED
) ||
119 ((driver_status
& 0xf) == DRIVER_SENSE
)) {
120 if (sense_buffer
&& (sb_len
> 2)) {
124 if (sense_buffer
[0] & 0x2) {
125 sense_key
= sense_buffer
[1] & 0xf;
126 asc
= sense_buffer
[2];
128 sense_key
= sense_buffer
[2] & 0xf;
129 asc
= (sb_len
> 12) ? sense_buffer
[12] : 0;
132 if (sense_key
== RECOVERED_ERROR
)
133 return SG_ERR_CAT_RECOVERED
;
134 else if (sense_key
== UNIT_ATTENTION
) {
136 return SG_ERR_CAT_MEDIA_CHANGED
;
138 return SG_ERR_CAT_RESET
;
139 } else if (sense_key
== ILLEGAL_REQUEST
)
140 return SG_ERR_CAT_NOTSUPPORTED
;
142 return SG_ERR_CAT_SENSE
;
145 if ((host_status
== DID_NO_CONNECT
) ||
146 (host_status
== DID_BUS_BUSY
) ||
147 (host_status
== DID_TIME_OUT
))
148 return SG_ERR_CAT_TIMEOUT
;
151 if (driver_status
== DRIVER_TIMEOUT
)
152 return SG_ERR_CAT_TIMEOUT
;
154 return SG_ERR_CAT_OTHER
;
157 static int sg_err_category3(struct udev
*udev
, struct sg_io_hdr
*hp
)
159 return sg_err_category_new(udev
,
160 hp
->status
, hp
->msg_status
,
161 hp
->host_status
, hp
->driver_status
,
162 hp
->sbp
, hp
->sb_len_wr
);
165 static int sg_err_category4(struct udev
*udev
, struct sg_io_v4
*hp
)
167 return sg_err_category_new(udev
, hp
->device_status
, 0,
168 hp
->transport_status
, hp
->driver_status
,
169 (unsigned char *)(uintptr_t)hp
->response
,
173 static int scsi_dump_sense(struct udev
*udev
,
174 struct scsi_id_device
*dev_scsi
,
175 unsigned char *sense_buffer
, int sb_len
)
183 char out_buffer
[256];
188 * Figure out and print the sense key, asc and ascq.
190 * If you want to suppress these for a particular drive model, add
191 * a black list entry in the scsi_id config file.
193 * XXX We probably need to: lookup the sense/asc/ascq in a retry
194 * table, and if found return 1 (after dumping the sense, asc, and
195 * ascq). So, if/when we get something like a power on/reset,
196 * we'll retry the command.
200 log_debug("%s: sense buffer empty", dev_scsi
->kernel
);
204 sense_class
= (sense_buffer
[0] >> 4) & 0x07;
205 code
= sense_buffer
[0] & 0xf;
207 if (sense_class
== 7) {
209 * extended sense data.
211 s
= sense_buffer
[7] + 8;
213 log_debug("%s: sense buffer too small %d bytes, %d bytes too short",
214 dev_scsi
->kernel
, sb_len
, s
- sb_len
);
217 if ((code
== 0x0) || (code
== 0x1)) {
218 sense_key
= sense_buffer
[2] & 0xf;
223 log_debug("%s: sense result too" " small %d bytes",
224 dev_scsi
->kernel
, s
);
227 asc
= sense_buffer
[12];
228 ascq
= sense_buffer
[13];
229 } else if ((code
== 0x2) || (code
== 0x3)) {
230 sense_key
= sense_buffer
[1] & 0xf;
231 asc
= sense_buffer
[2];
232 ascq
= sense_buffer
[3];
234 log_debug("%s: invalid sense code 0x%x",
235 dev_scsi
->kernel
, code
);
238 log_debug("%s: sense key 0x%x ASC 0x%x ASCQ 0x%x",
239 dev_scsi
->kernel
, sense_key
, asc
, ascq
);
242 log_debug("%s: sense buffer too small %d bytes, %d bytes too short",
243 dev_scsi
->kernel
, sb_len
, 4 - sb_len
);
247 if (sense_buffer
[0] < 15)
248 log_debug("%s: old sense key: 0x%x", dev_scsi
->kernel
, sense_buffer
[0] & 0x0f);
250 log_debug("%s: sense = %2x %2x",
251 dev_scsi
->kernel
, sense_buffer
[0], sense_buffer
[2]);
252 log_debug("%s: non-extended sense class %d code 0x%0x",
253 dev_scsi
->kernel
, sense_class
, code
);
258 for (i
= 0, j
= 0; (i
< s
) && (j
< 254); i
++) {
259 out_buffer
[j
++] = hex_str
[(sense_buffer
[i
] & 0xf0) >> 4];
260 out_buffer
[j
++] = hex_str
[sense_buffer
[i
] & 0x0f];
261 out_buffer
[j
++] = ' ';
263 out_buffer
[j
] = '\0';
264 log_debug("%s: sense dump:", dev_scsi
->kernel
);
265 log_debug("%s: %s", dev_scsi
->kernel
, out_buffer
);
271 static int scsi_dump(struct udev
*udev
,
272 struct scsi_id_device
*dev_scsi
, struct sg_io_hdr
*io
)
274 if (!io
->status
&& !io
->host_status
&& !io
->msg_status
&&
275 !io
->driver_status
) {
277 * Impossible, should not be called.
279 log_debug("%s: called with no error", __FUNCTION__
);
283 log_debug("%s: sg_io failed status 0x%x 0x%x 0x%x 0x%x",
284 dev_scsi
->kernel
, io
->driver_status
, io
->host_status
, io
->msg_status
, io
->status
);
285 if (io
->status
== SCSI_CHECK_CONDITION
)
286 return scsi_dump_sense(udev
, dev_scsi
, io
->sbp
, io
->sb_len_wr
);
291 static int scsi_dump_v4(struct udev
*udev
,
292 struct scsi_id_device
*dev_scsi
, struct sg_io_v4
*io
)
294 if (!io
->device_status
&& !io
->transport_status
&&
295 !io
->driver_status
) {
297 * Impossible, should not be called.
299 log_debug("%s: called with no error", __FUNCTION__
);
303 log_debug("%s: sg_io failed status 0x%x 0x%x 0x%x",
304 dev_scsi
->kernel
, io
->driver_status
, io
->transport_status
,
306 if (io
->device_status
== SCSI_CHECK_CONDITION
)
307 return scsi_dump_sense(udev
, dev_scsi
, (unsigned char *)(uintptr_t)io
->response
,
313 static int scsi_inquiry(struct udev
*udev
,
314 struct scsi_id_device
*dev_scsi
, int fd
,
315 unsigned char evpd
, unsigned char page
,
316 unsigned char *buf
, unsigned int buflen
)
318 unsigned char inq_cmd
[INQUIRY_CMDLEN
] =
319 { INQUIRY_CMD
, evpd
, page
, 0, buflen
, 0 };
320 unsigned char sense
[SENSE_BUFF_LEN
];
322 struct sg_io_v4 io_v4
;
323 struct sg_io_hdr io_hdr
;
324 int retry
= 3; /* rather random */
327 if (buflen
> SCSI_INQ_BUFF_LEN
) {
328 log_debug("buflen %d too long", buflen
);
333 if (dev_scsi
->use_sg
== 4) {
334 memzero(&io_v4
, sizeof(struct sg_io_v4
));
336 io_v4
.protocol
= BSG_PROTOCOL_SCSI
;
337 io_v4
.subprotocol
= BSG_SUB_PROTOCOL_SCSI_CMD
;
338 io_v4
.request_len
= sizeof(inq_cmd
);
339 io_v4
.request
= (uintptr_t)inq_cmd
;
340 io_v4
.max_response_len
= sizeof(sense
);
341 io_v4
.response
= (uintptr_t)sense
;
342 io_v4
.din_xfer_len
= buflen
;
343 io_v4
.din_xferp
= (uintptr_t)buf
;
344 io_buf
= (void *)&io_v4
;
346 memzero(&io_hdr
, sizeof(struct sg_io_hdr
));
347 io_hdr
.interface_id
= 'S';
348 io_hdr
.cmd_len
= sizeof(inq_cmd
);
349 io_hdr
.mx_sb_len
= sizeof(sense
);
350 io_hdr
.dxfer_direction
= SG_DXFER_FROM_DEV
;
351 io_hdr
.dxfer_len
= buflen
;
353 io_hdr
.cmdp
= inq_cmd
;
355 io_hdr
.timeout
= DEF_TIMEOUT
;
356 io_buf
= (void *)&io_hdr
;
359 retval
= ioctl(fd
, SG_IO
, io_buf
);
361 if ((errno
== EINVAL
|| errno
== ENOSYS
) && dev_scsi
->use_sg
== 4) {
362 dev_scsi
->use_sg
= 3;
365 log_debug_errno(errno
, "%s: ioctl failed: %m", dev_scsi
->kernel
);
369 if (dev_scsi
->use_sg
== 4)
370 retval
= sg_err_category4(udev
, io_buf
);
372 retval
= sg_err_category3(udev
, io_buf
);
375 case SG_ERR_CAT_NOTSUPPORTED
:
378 case SG_ERR_CAT_CLEAN
:
379 case SG_ERR_CAT_RECOVERED
:
384 if (dev_scsi
->use_sg
== 4)
385 retval
= scsi_dump_v4(udev
, dev_scsi
, io_buf
);
387 retval
= scsi_dump(udev
, dev_scsi
, io_buf
);
392 } else if (retval
> 0) {
400 log_debug("%s: Unable to get INQUIRY vpd %d page 0x%x.",
401 dev_scsi
->kernel
, evpd
, page
);
406 /* Get list of supported EVPD pages */
407 static int do_scsi_page0_inquiry(struct udev
*udev
,
408 struct scsi_id_device
*dev_scsi
, int fd
,
409 unsigned char *buffer
, unsigned int len
)
413 memzero(buffer
, len
);
414 retval
= scsi_inquiry(udev
, dev_scsi
, fd
, 1, 0x0, buffer
, len
);
418 if (buffer
[1] != 0) {
419 log_debug("%s: page 0 not available.", dev_scsi
->kernel
);
422 if (buffer
[3] > len
) {
423 log_debug("%s: page 0 buffer too long %d", dev_scsi
->kernel
, buffer
[3]);
428 * Following check is based on code once included in the 2.5.x
431 * Some ill behaved devices return the standard inquiry here
432 * rather than the evpd data, snoop the data to verify.
434 if (buffer
[3] > MODEL_LENGTH
) {
436 * If the vendor id appears in the page assume the page is
439 if (strneq((char *)&buffer
[VENDOR_LENGTH
], dev_scsi
->vendor
, VENDOR_LENGTH
)) {
440 log_debug("%s: invalid page0 data", dev_scsi
->kernel
);
448 * The caller checks that serial is long enough to include the vendor +
451 static int prepend_vendor_model(struct udev
*udev
,
452 struct scsi_id_device
*dev_scsi
, char *serial
)
456 strncpy(serial
, dev_scsi
->vendor
, VENDOR_LENGTH
);
457 strncat(serial
, dev_scsi
->model
, MODEL_LENGTH
);
458 ind
= strlen(serial
);
461 * This is not a complete check, since we are using strncat/cpy
462 * above, ind will never be too large.
464 if (ind
!= (VENDOR_LENGTH
+ MODEL_LENGTH
)) {
465 log_debug("%s: expected length %d, got length %d",
466 dev_scsi
->kernel
, (VENDOR_LENGTH
+ MODEL_LENGTH
), ind
);
473 * check_fill_0x83_id - check the page 0x83 id, if OK allocate and fill
476 static int check_fill_0x83_id(struct udev
*udev
,
477 struct scsi_id_device
*dev_scsi
,
478 unsigned char *page_83
,
479 const struct scsi_id_search_values
480 *id_search
, char *serial
, char *serial_short
,
481 int max_len
, char *wwn
,
482 char *wwn_vendor_extension
, char *tgpt_group
)
487 * ASSOCIATION must be with the device (value 0)
488 * or with the target port for SCSI_ID_TGTPORT
490 if ((page_83
[1] & 0x30) == 0x10) {
491 if (id_search
->id_type
!= SCSI_ID_TGTGROUP
)
493 } else if ((page_83
[1] & 0x30) != 0)
496 if ((page_83
[1] & 0x0f) != id_search
->id_type
)
500 * Possibly check NAA sub-type.
502 if ((id_search
->naa_type
!= SCSI_ID_NAA_DONT_CARE
) &&
503 (id_search
->naa_type
!= (page_83
[4] & 0xf0) >> 4))
507 * Check for matching code set - ASCII or BINARY.
509 if ((page_83
[0] & 0x0f) != id_search
->code_set
)
513 * page_83[3]: identifier length
516 if ((page_83
[0] & 0x0f) != SCSI_ID_ASCII
)
518 * If not ASCII, use two bytes for each binary value.
523 * Add one byte for the NUL termination, and one for the id_type.
526 if (id_search
->id_type
== SCSI_ID_VENDOR_SPECIFIC
)
527 len
+= VENDOR_LENGTH
+ MODEL_LENGTH
;
530 log_debug("%s: length %d too short - need %d",
531 dev_scsi
->kernel
, max_len
, len
);
535 if (id_search
->id_type
== SCSI_ID_TGTGROUP
&& tgpt_group
!= NULL
) {
538 group
= ((unsigned int)page_83
[6] << 8) | page_83
[7];
539 sprintf(tgpt_group
,"%x", group
);
543 serial
[0] = hex_str
[id_search
->id_type
];
546 * For SCSI_ID_VENDOR_SPECIFIC prepend the vendor and model before
547 * the id since it is not unique across all vendors and models,
548 * this differs from SCSI_ID_T10_VENDOR, where the vendor is
549 * included in the identifier.
551 if (id_search
->id_type
== SCSI_ID_VENDOR_SPECIFIC
)
552 if (prepend_vendor_model(udev
, dev_scsi
, &serial
[1]) < 0)
555 i
= 4; /* offset to the start of the identifier */
556 s
= j
= strlen(serial
);
557 if ((page_83
[0] & 0x0f) == SCSI_ID_ASCII
) {
561 while (i
< (4 + page_83
[3]))
562 serial
[j
++] = page_83
[i
++];
565 * Binary descriptor, convert to ASCII, using two bytes of
566 * ASCII for each byte in the page_83.
568 while (i
< (4 + page_83
[3])) {
569 serial
[j
++] = hex_str
[(page_83
[i
] & 0xf0) >> 4];
570 serial
[j
++] = hex_str
[page_83
[i
] & 0x0f];
575 strcpy(serial_short
, &serial
[s
]);
577 if (id_search
->id_type
== SCSI_ID_NAA
&& wwn
!= NULL
) {
578 strncpy(wwn
, &serial
[s
], 16);
579 if (wwn_vendor_extension
!= NULL
)
580 strncpy(wwn_vendor_extension
, &serial
[s
+ 16], 16);
586 /* Extract the raw binary from VPD 0x83 pre-SPC devices */
587 static int check_fill_0x83_prespc3(struct udev
*udev
,
588 struct scsi_id_device
*dev_scsi
,
589 unsigned char *page_83
,
590 const struct scsi_id_search_values
591 *id_search
, char *serial
, char *serial_short
, int max_len
)
595 serial
[0] = hex_str
[id_search
->id_type
];
596 /* serial has been memset to zero before */
597 j
= strlen(serial
); /* j = 1; */
599 for (i
= 0; (i
< page_83
[3]) && (j
< max_len
-3); ++i
) {
600 serial
[j
++] = hex_str
[(page_83
[4+i
] & 0xf0) >> 4];
601 serial
[j
++] = hex_str
[ page_83
[4+i
] & 0x0f];
603 serial
[max_len
-1] = 0;
604 strncpy(serial_short
, serial
, max_len
-1);
609 /* Get device identification VPD page */
610 static int do_scsi_page83_inquiry(struct udev
*udev
,
611 struct scsi_id_device
*dev_scsi
, int fd
,
612 char *serial
, char *serial_short
, int len
,
613 char *unit_serial_number
, char *wwn
,
614 char *wwn_vendor_extension
, char *tgpt_group
)
617 unsigned int id_ind
, j
;
618 unsigned char page_83
[SCSI_INQ_BUFF_LEN
];
620 /* also pick up the page 80 serial number */
621 do_scsi_page80_inquiry(udev
, dev_scsi
, fd
, NULL
, unit_serial_number
, MAX_SERIAL_LEN
);
623 memzero(page_83
, SCSI_INQ_BUFF_LEN
);
624 retval
= scsi_inquiry(udev
, dev_scsi
, fd
, 1, PAGE_83
, page_83
,
629 if (page_83
[1] != PAGE_83
) {
630 log_debug("%s: Invalid page 0x83", dev_scsi
->kernel
);
635 * XXX Some devices (IBM 3542) return all spaces for an identifier if
636 * the LUN is not actually configured. This leads to identifiers of
641 * Model 4, 5, and (some) model 6 EMC Symmetrix devices return
642 * a page 83 reply according to SCSI-2 format instead of SPC-2/3.
644 * The SCSI-2 page 83 format returns an IEEE WWN in binary
645 * encoded hexi-decimal in the 16 bytes following the initial
646 * 4-byte page 83 reply header.
648 * Both the SPC-2 and SPC-3 formats return an IEEE WWN as part
649 * of an Identification descriptor. The 3rd byte of the first
650 * Identification descriptor is a reserved (BSZ) byte field.
652 * Reference the 7th byte of the page 83 reply to determine
653 * whether the reply is compliant with SCSI-2 or SPC-2/3
654 * specifications. A zero value in the 7th byte indicates
655 * an SPC-2/3 conformant reply, (i.e., the reserved field of the
656 * first Identification descriptor). This byte will be non-zero
657 * for a SCSI-2 conformant page 83 reply from these EMC
658 * Symmetrix models since the 7th byte of the reply corresponds
659 * to the 4th and 5th nibbles of the 6-byte OUI for EMC, that is,
664 return check_fill_0x83_prespc3(udev
,
665 dev_scsi
, page_83
, id_search_list
,
666 serial
, serial_short
, len
);
669 * Search for a match in the prioritized id_search_list - since WWN ids
670 * come first we can pick up the WWN in check_fill_0x83_id().
673 id_ind
< sizeof(id_search_list
)/sizeof(id_search_list
[0]);
676 * Examine each descriptor returned. There is normally only
677 * one or a small number of descriptors.
679 for (j
= 4; j
<= (unsigned int)page_83
[3] + 3; j
+= page_83
[j
+ 3] + 4) {
680 retval
= check_fill_0x83_id(udev
,
681 dev_scsi
, &page_83
[j
],
682 &id_search_list
[id_ind
],
683 serial
, serial_short
, len
,
684 wwn
, wwn_vendor_extension
,
696 * Get device identification VPD page for older SCSI-2 device which is not
697 * compliant with either SPC-2 or SPC-3 format.
699 * Return the hard coded error code value 2 if the page 83 reply is not
700 * conformant to the SCSI-2 format.
702 static int do_scsi_page83_prespc3_inquiry(struct udev
*udev
,
703 struct scsi_id_device
*dev_scsi
, int fd
,
704 char *serial
, char *serial_short
, int len
)
708 unsigned char page_83
[SCSI_INQ_BUFF_LEN
];
710 memzero(page_83
, SCSI_INQ_BUFF_LEN
);
711 retval
= scsi_inquiry(udev
, dev_scsi
, fd
, 1, PAGE_83
, page_83
, SCSI_INQ_BUFF_LEN
);
715 if (page_83
[1] != PAGE_83
) {
716 log_debug("%s: Invalid page 0x83", dev_scsi
->kernel
);
720 * Model 4, 5, and (some) model 6 EMC Symmetrix devices return
721 * a page 83 reply according to SCSI-2 format instead of SPC-2/3.
723 * The SCSI-2 page 83 format returns an IEEE WWN in binary
724 * encoded hexi-decimal in the 16 bytes following the initial
725 * 4-byte page 83 reply header.
727 * Both the SPC-2 and SPC-3 formats return an IEEE WWN as part
728 * of an Identification descriptor. The 3rd byte of the first
729 * Identification descriptor is a reserved (BSZ) byte field.
731 * Reference the 7th byte of the page 83 reply to determine
732 * whether the reply is compliant with SCSI-2 or SPC-2/3
733 * specifications. A zero value in the 7th byte indicates
734 * an SPC-2/3 conformant reply, (i.e., the reserved field of the
735 * first Identification descriptor). This byte will be non-zero
736 * for a SCSI-2 conformant page 83 reply from these EMC
737 * Symmetrix models since the 7th byte of the reply corresponds
738 * to the 4th and 5th nibbles of the 6-byte OUI for EMC, that is,
744 serial
[0] = hex_str
[id_search_list
[0].id_type
];
746 * The first four bytes contain data, not a descriptor.
751 * Binary descriptor, convert to ASCII,
752 * using two bytes of ASCII for each byte
755 while (i
< (page_83
[3]+4)) {
756 serial
[j
++] = hex_str
[(page_83
[i
] & 0xf0) >> 4];
757 serial
[j
++] = hex_str
[page_83
[i
] & 0x0f];
763 /* Get unit serial number VPD page */
764 static int do_scsi_page80_inquiry(struct udev
*udev
,
765 struct scsi_id_device
*dev_scsi
, int fd
,
766 char *serial
, char *serial_short
, int max_len
)
772 unsigned char buf
[SCSI_INQ_BUFF_LEN
];
774 memzero(buf
, SCSI_INQ_BUFF_LEN
);
775 retval
= scsi_inquiry(udev
, dev_scsi
, fd
, 1, PAGE_80
, buf
, SCSI_INQ_BUFF_LEN
);
779 if (buf
[1] != PAGE_80
) {
780 log_debug("%s: Invalid page 0x80", dev_scsi
->kernel
);
784 len
= 1 + VENDOR_LENGTH
+ MODEL_LENGTH
+ buf
[3];
786 log_debug("%s: length %d too short - need %d",
787 dev_scsi
->kernel
, max_len
, len
);
791 * Prepend 'S' to avoid unlikely collision with page 0x83 vendor
792 * specific type where we prepend '0' + vendor + model.
795 if (serial
!= NULL
) {
797 ser_ind
= prepend_vendor_model(udev
, dev_scsi
, &serial
[1]);
800 ser_ind
++; /* for the leading 'S' */
801 for (i
= 4; i
< len
+ 4; i
++, ser_ind
++)
802 serial
[ser_ind
] = buf
[i
];
804 if (serial_short
!= NULL
) {
805 memcpy(serial_short
, &buf
[4], len
);
806 serial_short
[len
] = '\0';
811 int scsi_std_inquiry(struct udev
*udev
,
812 struct scsi_id_device
*dev_scsi
, const char *devname
)
815 unsigned char buf
[SCSI_INQ_BUFF_LEN
];
819 fd
= open(devname
, O_RDONLY
| O_NONBLOCK
| O_CLOEXEC
);
821 log_debug_errno(errno
, "scsi_id: cannot open %s: %m", devname
);
825 if (fstat(fd
, &statbuf
) < 0) {
826 log_debug_errno(errno
, "scsi_id: cannot stat %s: %m", devname
);
830 sprintf(dev_scsi
->kernel
,"%d:%d", major(statbuf
.st_rdev
),
831 minor(statbuf
.st_rdev
));
833 memzero(buf
, SCSI_INQ_BUFF_LEN
);
834 err
= scsi_inquiry(udev
, dev_scsi
, fd
, 0, 0, buf
, SCSI_INQ_BUFF_LEN
);
839 memcpy(dev_scsi
->vendor
, buf
+ 8, 8);
840 dev_scsi
->vendor
[8] = '\0';
841 memcpy(dev_scsi
->model
, buf
+ 16, 16);
842 dev_scsi
->model
[16] = '\0';
843 memcpy(dev_scsi
->revision
, buf
+ 32, 4);
844 dev_scsi
->revision
[4] = '\0';
845 sprintf(dev_scsi
->type
,"%x", buf
[0] & 0x1f);
852 int scsi_get_serial(struct udev
*udev
,
853 struct scsi_id_device
*dev_scsi
, const char *devname
,
854 int page_code
, int len
)
856 unsigned char page0
[SCSI_INQ_BUFF_LEN
];
862 memzero(dev_scsi
->serial
, len
);
864 for (cnt
= 20; cnt
> 0; cnt
--) {
865 struct timespec duration
;
867 fd
= open(devname
, O_RDONLY
| O_NONBLOCK
| O_CLOEXEC
);
868 if (fd
>= 0 || errno
!= EBUSY
)
871 duration
.tv_nsec
= (200 * 1000 * 1000) + (rand() % 100 * 1000 * 1000);
872 nanosleep(&duration
, NULL
);
877 if (page_code
== PAGE_80
) {
878 if (do_scsi_page80_inquiry(udev
, dev_scsi
, fd
, dev_scsi
->serial
, dev_scsi
->serial_short
, len
)) {
885 } else if (page_code
== PAGE_83
) {
886 if (do_scsi_page83_inquiry(udev
, dev_scsi
, fd
, dev_scsi
->serial
, dev_scsi
->serial_short
, len
, dev_scsi
->unit_serial_number
, dev_scsi
->wwn
, dev_scsi
->wwn_vendor_extension
, dev_scsi
->tgpt_group
)) {
893 } else if (page_code
== PAGE_83_PRE_SPC3
) {
894 retval
= do_scsi_page83_prespc3_inquiry(udev
, dev_scsi
, fd
, dev_scsi
->serial
, dev_scsi
->serial_short
, len
);
897 * Fallback to servicing a SPC-2/3 compliant page 83
898 * inquiry if the page 83 reply format does not
899 * conform to pre-SPC3 expectations.
902 if (do_scsi_page83_inquiry(udev
, dev_scsi
, fd
, dev_scsi
->serial
, dev_scsi
->serial_short
, len
, dev_scsi
->unit_serial_number
, dev_scsi
->wwn
, dev_scsi
->wwn_vendor_extension
, dev_scsi
->tgpt_group
)) {
918 } else if (page_code
!= 0x00) {
919 log_debug("%s: unsupported page code 0x%d", dev_scsi
->kernel
, page_code
);
925 * Get page 0, the page of the pages. By default, try from best to
926 * worst of supported pages: 0x83 then 0x80.
928 if (do_scsi_page0_inquiry(udev
, dev_scsi
, fd
, page0
, SCSI_INQ_BUFF_LEN
)) {
930 * Don't try anything else. Black list if a specific page
931 * should be used for this vendor+model, or maybe have an
932 * optional fall-back to page 0x80 or page 0x83.
938 for (ind
= 4; ind
<= page0
[3] + 3; ind
++)
939 if (page0
[ind
] == PAGE_83
)
940 if (!do_scsi_page83_inquiry(udev
, dev_scsi
, fd
,
941 dev_scsi
->serial
, dev_scsi
->serial_short
, len
, dev_scsi
->unit_serial_number
, dev_scsi
->wwn
, dev_scsi
->wwn_vendor_extension
, dev_scsi
->tgpt_group
)) {
949 for (ind
= 4; ind
<= page0
[3] + 3; ind
++)
950 if (page0
[ind
] == PAGE_80
)
951 if (!do_scsi_page80_inquiry(udev
, dev_scsi
, fd
,
952 dev_scsi
->serial
, dev_scsi
->serial_short
, len
)) {