chiark / gitweb /
32bb0f423e2e01b92f8383635bbc85110181e6b2
[elogind.git] / extras / scsi_id / scsi_serial.c
1 /*
2  * scsi_serial.c
3  *
4  * Code related to requesting and getting an id from a scsi device
5  *
6  * Copyright (C) IBM Corp. 2003
7  *
8  * Author:
9  *      Patrick Mansfield<patmans@us.ibm.com>
10  *
11  *      This program is free software; you can redistribute it and/or modify it
12  *      under the terms of the GNU General Public License as published by the
13  *      Free Software Foundation version 2 of the License.
14  */
15
16 #include <sys/types.h>
17 #include <sys/ioctl.h>
18 #include <stdio.h>
19 #include <errno.h>
20 #include <string.h>
21 #include <fcntl.h>
22 #include <stdlib.h>
23 #include <unistd.h>
24 #include <syslog.h>
25 #include <scsi/sg.h>
26
27 #include "../../udev.h"
28 #include "scsi.h"
29 #include "scsi_id.h"
30 #include "scsi_id_version.h"
31
32 /*
33  * A priority based list of id, naa, and binary/ascii for the identifier
34  * descriptor in VPD page 0x83.
35  *
36  * Brute force search for a match starting with the first value in the
37  * following id_search_list. This is not a performance issue, since there
38  * is normally one or some small number of descriptors.
39  */
40 static const struct scsi_id_search_values id_search_list[] = {
41         { SCSI_ID_NAA,  SCSI_ID_NAA_IEEE_REG_EXTENDED,  SCSI_ID_BINARY },
42         { SCSI_ID_NAA,  SCSI_ID_NAA_IEEE_REG_EXTENDED,  SCSI_ID_ASCII },
43         { SCSI_ID_NAA,  SCSI_ID_NAA_IEEE_REG,   SCSI_ID_BINARY },
44         { SCSI_ID_NAA,  SCSI_ID_NAA_IEEE_REG,   SCSI_ID_ASCII },
45         /*
46          * Devices already exist using NAA values that are now marked
47          * reserved. These should not conflict with other values, or it is
48          * a bug in the device. As long as we find the IEEE extended one
49          * first, we really don't care what other ones are used. Using
50          * don't care here means that a device that returns multiple
51          * non-IEEE descriptors in a random order will get different
52          * names.
53          */
54         { SCSI_ID_NAA,  SCSI_ID_NAA_DONT_CARE,  SCSI_ID_BINARY },
55         { SCSI_ID_NAA,  SCSI_ID_NAA_DONT_CARE,  SCSI_ID_ASCII },
56         { SCSI_ID_EUI_64,       SCSI_ID_NAA_DONT_CARE,  SCSI_ID_BINARY },
57         { SCSI_ID_EUI_64,       SCSI_ID_NAA_DONT_CARE,  SCSI_ID_ASCII },
58         { SCSI_ID_T10_VENDOR,   SCSI_ID_NAA_DONT_CARE,  SCSI_ID_BINARY },
59         { SCSI_ID_T10_VENDOR,   SCSI_ID_NAA_DONT_CARE,  SCSI_ID_ASCII },
60         { SCSI_ID_VENDOR_SPECIFIC,      SCSI_ID_NAA_DONT_CARE,  SCSI_ID_BINARY },
61         { SCSI_ID_VENDOR_SPECIFIC,      SCSI_ID_NAA_DONT_CARE,  SCSI_ID_ASCII },
62 };
63
64 static const char hex_str[]="0123456789abcdef";
65
66 /*
67  * Values returned in the result/status, only the ones used by the code
68  * are used here.
69  */
70
71 #define DID_NO_CONNECT                  0x01    /* Unable to connect before timeout */
72 #define DID_BUS_BUSY                    0x02    /* Bus remain busy until timeout */
73 #define DID_TIME_OUT                    0x03    /* Timed out for some other reason */
74 #define DRIVER_TIMEOUT                  0x06
75 #define DRIVER_SENSE                    0x08    /* Sense_buffer has been set */
76
77 /* The following "category" function returns one of the following */
78 #define SG_ERR_CAT_CLEAN                0       /* No errors or other information */
79 #define SG_ERR_CAT_MEDIA_CHANGED        1       /* interpreted from sense buffer */
80 #define SG_ERR_CAT_RESET                2       /* interpreted from sense buffer */
81 #define SG_ERR_CAT_TIMEOUT              3
82 #define SG_ERR_CAT_RECOVERED            4       /* Successful command after recovered err */
83 #define SG_ERR_CAT_NOTSUPPORTED         5       /* Illegal / unsupported command */
84 #define SG_ERR_CAT_SENSE                98      /* Something else in the sense buffer */
85 #define SG_ERR_CAT_OTHER                99      /* Some other error/warning */
86
87 static int sg_err_category_new(int scsi_status, int msg_status, int
88                                host_status, int driver_status, const
89                                unsigned char *sense_buffer, int sb_len)
90 {
91         scsi_status &= 0x7e;
92
93         /*
94          * XXX change to return only two values - failed or OK.
95          */
96
97         /*
98          * checks msg_status
99          */
100         if (!scsi_status && !msg_status && !host_status && !driver_status)
101                 return SG_ERR_CAT_CLEAN;
102
103         if ((scsi_status == SCSI_CHECK_CONDITION) ||
104             (scsi_status == SCSI_COMMAND_TERMINATED) ||
105             ((driver_status & 0xf) == DRIVER_SENSE)) {
106                 if (sense_buffer && (sb_len > 2)) {
107                         int sense_key;
108                         unsigned char asc;
109
110                         if (sense_buffer[0] & 0x2) {
111                                 sense_key = sense_buffer[1] & 0xf;
112                                 asc = sense_buffer[2];
113                         } else {
114                                 sense_key = sense_buffer[2] & 0xf;
115                                 asc = (sb_len > 12) ? sense_buffer[12] : 0;
116                         }
117
118                         if (sense_key == RECOVERED_ERROR)
119                                 return SG_ERR_CAT_RECOVERED;
120                         else if (sense_key == UNIT_ATTENTION) {
121                                 if (0x28 == asc)
122                                         return SG_ERR_CAT_MEDIA_CHANGED;
123                                 if (0x29 == asc)
124                                         return SG_ERR_CAT_RESET;
125                         } else if (sense_key == ILLEGAL_REQUEST) {
126                                 return SG_ERR_CAT_NOTSUPPORTED;
127                         }
128                 }
129                 return SG_ERR_CAT_SENSE;
130         }
131         if (!host_status) {
132                 if ((host_status == DID_NO_CONNECT) ||
133                     (host_status == DID_BUS_BUSY) ||
134                     (host_status == DID_TIME_OUT))
135                         return SG_ERR_CAT_TIMEOUT;
136         }
137         if (!driver_status) {
138                 if (driver_status == DRIVER_TIMEOUT)
139                         return SG_ERR_CAT_TIMEOUT;
140         }
141         return SG_ERR_CAT_OTHER;
142 }
143
144 static int sg_err_category3(struct sg_io_hdr *hp)
145 {
146         return sg_err_category_new(hp->status, hp->msg_status,
147                                    hp->host_status, hp->driver_status,
148                                    hp->sbp, hp->sb_len_wr);
149 }
150
151 static int scsi_dump_sense(struct scsi_id_device *dev_scsi, struct sg_io_hdr *io)
152 {
153         unsigned char *sense_buffer;
154         int s;
155         int sb_len;
156         int code;
157         int sense_class;
158         int sense_key;
159         int descriptor_format;
160         int asc, ascq;
161 #ifdef DUMP_SENSE
162         char out_buffer[256];
163         int i, j;
164 #endif
165
166         /*
167          * Figure out and print the sense key, asc and ascq.
168          *
169          * If you want to suppress these for a particular drive model, add
170          * a black list entry in the scsi_id config file.
171          *
172          * XXX We probably need to: lookup the sense/asc/ascq in a retry
173          * table, and if found return 1 (after dumping the sense, asc, and
174          * ascq). So, if/when we get something like a power on/reset,
175          * we'll retry the command.
176          */
177
178         dbg("got check condition\n");
179
180         sb_len = io->sb_len_wr;
181         if (sb_len < 1) {
182                 info("%s: sense buffer empty\n", dev_scsi->kernel);
183                 return -1;
184         }
185
186         sense_buffer = io->sbp;
187         sense_class = (sense_buffer[0] >> 4) & 0x07;
188         code = sense_buffer[0] & 0xf;
189
190         if (sense_class == 7) {
191                 /*
192                  * extended sense data.
193                  */
194                 s = sense_buffer[7] + 8;
195                 if (sb_len < s) {
196                         info("%s: sense buffer too small %d bytes, %d bytes too short\n",
197                             dev_scsi->kernel, sb_len, s - sb_len);
198                         return -1;
199                 }
200                 if ((code == 0x0) || (code == 0x1)) {
201                         descriptor_format = 0;
202                         sense_key = sense_buffer[2] & 0xf;
203                         if (s < 14) {
204                                 /*
205                                  * Possible?
206                                  */
207                                 info("%s: sense result too" " small %d bytes\n",
208                                     dev_scsi->kernel, s);
209                                 return -1;
210                         }
211                         asc = sense_buffer[12];
212                         ascq = sense_buffer[13];
213                 } else if ((code == 0x2) || (code == 0x3)) {
214                         descriptor_format = 1;
215                         sense_key = sense_buffer[1] & 0xf;
216                         asc = sense_buffer[2];
217                         ascq = sense_buffer[3];
218                 } else {
219                         info("%s: invalid sense code 0x%x\n",
220                             dev_scsi->kernel, code);
221                         return -1;
222                 }
223                 info("%s: sense key 0x%x ASC 0x%x ASCQ 0x%x\n",
224                     dev_scsi->kernel, sense_key, asc, ascq);
225         } else {
226                 if (sb_len < 4) {
227                         info("%s: sense buffer too small %d bytes, %d bytes too short\n",
228                             dev_scsi->kernel, sb_len, 4 - sb_len);
229                         return -1;
230                 }
231
232                 if (sense_buffer[0] < 15)
233                         info("%s: old sense key: 0x%x\n", dev_scsi->kernel, sense_buffer[0] & 0x0f);
234                 else
235                         info("%s: sense = %2x %2x\n",
236                             dev_scsi->kernel, sense_buffer[0], sense_buffer[2]);
237                 info("%s: non-extended sense class %d code 0x%0x\n",
238                     dev_scsi->kernel, sense_class, code);
239
240         }
241
242 #ifdef DUMP_SENSE
243         for (i = 0, j = 0; (i < s) && (j < 254); i++) {
244                 dbg("i %d, j %d\n", i, j);
245                 out_buffer[j++] = hex_str[(sense_buffer[i] & 0xf0) >> 4];
246                 out_buffer[j++] = hex_str[sense_buffer[i] & 0x0f];
247                 out_buffer[j++] = ' ';
248         }
249         out_buffer[j] = '\0';
250         info("%s: sense dump:\n", dev_scsi->kernel);
251         info("%s: %s\n", dev_scsi->kernel, out_buffer);
252
253 #endif
254         return -1;
255 }
256
257 static int scsi_dump(struct scsi_id_device *dev_scsi, struct sg_io_hdr *io)
258 {
259         if (!io->status && !io->host_status && !io->msg_status &&
260             !io->driver_status) {
261                 /*
262                  * Impossible, should not be called.
263                  */
264                 info("%s: called with no error\n", __FUNCTION__);
265                 return -1;
266         }
267
268         info("%s: sg_io failed status 0x%x 0x%x 0x%x 0x%x\n",
269             dev_scsi->kernel, io->driver_status, io->host_status, io->msg_status, io->status);
270         if (io->status == SCSI_CHECK_CONDITION)
271                 return scsi_dump_sense(dev_scsi, io);
272         else
273                 return -1;
274 }
275
276 static int scsi_inquiry(struct scsi_id_device *dev_scsi, int fd,
277                         unsigned char evpd, unsigned char page,
278                         unsigned char *buf, unsigned int buflen)
279 {
280         unsigned char inq_cmd[INQUIRY_CMDLEN] =
281                 { INQUIRY_CMD, evpd, page, 0, buflen, 0 };
282         unsigned char sense[SENSE_BUFF_LEN];
283         struct sg_io_hdr io_hdr;
284         int retval;
285         int retry = 3; /* rather random */
286
287         if (buflen > SCSI_INQ_BUFF_LEN) {
288                 info("buflen %d too long\n", buflen);
289                 return -1;
290         }
291
292 resend:
293         dbg("%s evpd %d, page 0x%x\n", dev_scsi->kernel, evpd, page);
294
295         memset(&io_hdr, 0, sizeof(struct sg_io_hdr));
296         io_hdr.interface_id = 'S';
297         io_hdr.cmd_len = sizeof(inq_cmd);
298         io_hdr.mx_sb_len = sizeof(sense);
299         io_hdr.dxfer_direction = SG_DXFER_FROM_DEV;
300         io_hdr.dxfer_len = buflen;
301         io_hdr.dxferp = buf;
302         io_hdr.cmdp = inq_cmd;
303         io_hdr.sbp = sense;
304         io_hdr.timeout = DEF_TIMEOUT;
305
306         if (ioctl(fd, SG_IO, &io_hdr) < 0) {
307                 info("%s: ioctl failed: %s\n", dev_scsi->kernel, strerror(errno));
308                 retval = -1;
309                 goto error;
310         }
311
312         retval = sg_err_category3(&io_hdr);
313
314         switch (retval) {
315                 case SG_ERR_CAT_NOTSUPPORTED:
316                         buf[1] = 0;
317                         /* Fallthrough */
318                 case SG_ERR_CAT_CLEAN:
319                 case SG_ERR_CAT_RECOVERED:
320                         retval = 0;
321                         break;
322
323                 default:
324                         retval = scsi_dump(dev_scsi, &io_hdr);
325         }
326
327         if (!retval) {
328                 retval = buflen;
329         } else if (retval > 0) {
330                 if (--retry > 0) {
331                         dbg("%s: Retrying ...\n", dev_scsi->kernel);
332                         goto resend;
333                 }
334                 retval = -1;
335         }
336
337 error:
338         if (retval < 0)
339                 info("%s: Unable to get INQUIRY vpd %d page 0x%x.\n",
340                     dev_scsi->kernel, evpd, page);
341
342         return retval;
343 }
344
345 /* Get list of supported EVPD pages */
346 static int do_scsi_page0_inquiry(struct scsi_id_device *dev_scsi, int fd,
347                                  unsigned char *buffer, unsigned int len)
348 {
349         int retval;
350
351         memset(buffer, 0, len);
352         retval = scsi_inquiry(dev_scsi, fd, 1, 0x0, buffer, len);
353         if (retval < 0)
354                 return 1;
355
356         if (buffer[1] != 0) {
357                 info("%s: page 0 not available.\n", dev_scsi->kernel);
358                 return 1;
359         }
360         if (buffer[3] > len) {
361                 info("%s: page 0 buffer too long %d\n", dev_scsi->kernel,  buffer[3]);
362                 return 1;
363         }
364
365         /*
366          * Following check is based on code once included in the 2.5.x
367          * kernel.
368          *
369          * Some ill behaved devices return the standard inquiry here
370          * rather than the evpd data, snoop the data to verify.
371          */
372         if (buffer[3] > MODEL_LENGTH) {
373                 /*
374                  * If the vendor id appears in the page assume the page is
375                  * invalid.
376                  */
377                 if (!strncmp((char *)&buffer[VENDOR_LENGTH], dev_scsi->vendor, VENDOR_LENGTH)) {
378                         info("%s: invalid page0 data\n", dev_scsi->kernel);
379                         return 1;
380                 }
381         }
382         return 0;
383 }
384
385 /*
386  * The caller checks that serial is long enough to include the vendor +
387  * model.
388  */
389 static int prepend_vendor_model(struct scsi_id_device *dev_scsi, char *serial)
390 {
391         int ind;
392
393         strncpy(serial, dev_scsi->vendor, VENDOR_LENGTH);
394         ind = strlen(serial) - 1;
395
396         strncat(serial, dev_scsi->model, MODEL_LENGTH);
397         ind = strlen(serial) - 1;
398         ind++;
399
400         /*
401          * This is not a complete check, since we are using strncat/cpy
402          * above, ind will never be too large.
403          */
404         if (ind != (VENDOR_LENGTH + MODEL_LENGTH)) {
405                 info("%s: expected length %d, got length %d\n",
406                      dev_scsi->kernel, (VENDOR_LENGTH + MODEL_LENGTH), ind);
407                 return 1;
408         }
409         return ind;
410 }
411
412 /**
413  * check_fill_0x83_id - check the page 0x83 id, if OK allocate and fill
414  * serial number.
415  **/
416 static int check_fill_0x83_id(struct scsi_id_device *dev_scsi,
417                               unsigned char *page_83,
418                               const struct scsi_id_search_values
419                               *id_search, char *serial, char *serial_short, int max_len)
420 {
421         int i, j, s, len;
422
423         /*
424          * ASSOCIATION must be with the device (value 0)
425          */
426         if ((page_83[1] & 0x30) != 0)
427                 return 1;
428
429         if ((page_83[1] & 0x0f) != id_search->id_type)
430                 return 1;
431
432         /*
433          * Possibly check NAA sub-type.
434          */
435         if ((id_search->naa_type != SCSI_ID_NAA_DONT_CARE) &&
436             (id_search->naa_type != (page_83[4] & 0xf0) >> 4))
437                 return 1;
438
439         /*
440          * Check for matching code set - ASCII or BINARY.
441          */
442         if ((page_83[0] & 0x0f) != id_search->code_set)
443                 return 1;
444
445         /*
446          * page_83[3]: identifier length
447          */
448         len = page_83[3];
449         if ((page_83[0] & 0x0f) != SCSI_ID_ASCII)
450                 /*
451                  * If not ASCII, use two bytes for each binary value.
452                  */
453                 len *= 2;
454
455         /*
456          * Add one byte for the NUL termination, and one for the id_type.
457          */
458         len += 2;
459         if (id_search->id_type == SCSI_ID_VENDOR_SPECIFIC)
460                 len += VENDOR_LENGTH + MODEL_LENGTH;
461
462         if (max_len < len) {
463                 info("%s: length %d too short - need %d\n",
464                     dev_scsi->kernel, max_len, len);
465                 return 1;
466         }
467
468         serial[0] = hex_str[id_search->id_type];
469
470         /*
471          * For SCSI_ID_VENDOR_SPECIFIC prepend the vendor and model before
472          * the id since it is not unique across all vendors and models,
473          * this differs from SCSI_ID_T10_VENDOR, where the vendor is
474          * included in the identifier.
475          */
476         if (id_search->id_type == SCSI_ID_VENDOR_SPECIFIC)
477                 if (prepend_vendor_model(dev_scsi, &serial[1]) < 0) {
478                         dbg("prepend failed\n");
479                         return 1;
480                 }
481
482         i = 4; /* offset to the start of the identifier */
483         s = j = strlen(serial);
484         if ((page_83[0] & 0x0f) == SCSI_ID_ASCII) {
485                 /*
486                  * ASCII descriptor.
487                  */
488                 while (i < (4 + page_83[3]))
489                         serial[j++] = page_83[i++];
490         } else {
491                 /*
492                  * Binary descriptor, convert to ASCII, using two bytes of
493                  * ASCII for each byte in the page_83.
494                  */
495                 while (i < (4 + page_83[3])) {
496                         serial[j++] = hex_str[(page_83[i] & 0xf0) >> 4];
497                         serial[j++] = hex_str[page_83[i] & 0x0f];
498                         i++;
499                 }
500         }
501
502         strcpy(serial_short, &serial[s]);
503         return 0;
504 }
505
506 /* Extract the raw binary from VPD 0x83 pre-SPC devices */
507 static int check_fill_0x83_prespc3(struct scsi_id_device *dev_scsi,
508                                    unsigned char *page_83,
509                                    const struct scsi_id_search_values
510                                    *id_search, char *serial, char *serial_short, int max_len)
511 {
512         int i, j;
513
514         dbg("using pre-spc3-83 for %s\n", dev_scsi->kernel);
515         serial[0] = hex_str[id_search->id_type];
516         /* serial has been memset to zero before */
517         j = strlen(serial);     /* j = 1; */
518
519         for (i = 0; i < page_83[3]; ++i) {
520                 serial[j++] = hex_str[(page_83[4+i] & 0xf0) >> 4];
521                 serial[j++] = hex_str[ page_83[4+i] & 0x0f];
522         }
523         strcpy(serial_short, serial);
524         return 0;
525 }
526
527
528 /* Get device identification VPD page */
529 static int do_scsi_page83_inquiry(struct scsi_id_device *dev_scsi, int fd,
530                                   char *serial, char *serial_short, int len)
531 {
532         int retval;
533         unsigned int id_ind, j;
534         unsigned char page_83[SCSI_INQ_BUFF_LEN];
535
536         memset(page_83, 0, SCSI_INQ_BUFF_LEN);
537         retval = scsi_inquiry(dev_scsi, fd, 1, PAGE_83, page_83,
538                               SCSI_INQ_BUFF_LEN);
539         if (retval < 0)
540                 return 1;
541
542         if (page_83[1] != PAGE_83) {
543                 info("%s: Invalid page 0x83\n", dev_scsi->kernel);
544                 return 1;
545         }
546         
547         /*
548          * XXX Some devices (IBM 3542) return all spaces for an identifier if
549          * the LUN is not actually configured. This leads to identifers of
550          * the form: "1            ".
551          */
552
553         /*
554          * Model 4, 5, and (some) model 6 EMC Symmetrix devices return
555          * a page 83 reply according to SCSI-2 format instead of SPC-2/3.
556          *
557          * The SCSI-2 page 83 format returns an IEEE WWN in binary
558          * encoded hexi-decimal in the 16 bytes following the initial
559          * 4-byte page 83 reply header.
560          *
561          * Both the SPC-2 and SPC-3 formats return an IEEE WWN as part
562          * of an Identification descriptor.  The 3rd byte of the first
563          * Identification descriptor is a reserved (BSZ) byte field.
564          *
565          * Reference the 7th byte of the page 83 reply to determine
566          * whether the reply is compliant with SCSI-2 or SPC-2/3
567          * specifications.  A zero value in the 7th byte indicates
568          * an SPC-2/3 conformant reply, (i.e., the reserved field of the
569          * first Identification descriptor).  This byte will be non-zero
570          * for a SCSI-2 conformant page 83 reply from these EMC
571          * Symmetrix models since the 7th byte of the reply corresponds
572          * to the 4th and 5th nibbles of the 6-byte OUI for EMC, that is,
573          * 0x006048.
574          */
575         
576         if (page_83[6] != 0) 
577                 return check_fill_0x83_prespc3(dev_scsi, page_83, id_search_list,
578                                                serial, serial_short, len);
579
580         /*
581          * Search for a match in the prioritized id_search_list.
582          */
583         for (id_ind = 0;
584              id_ind < sizeof(id_search_list)/sizeof(id_search_list[0]);
585              id_ind++) {
586                 /*
587                  * Examine each descriptor returned. There is normally only
588                  * one or a small number of descriptors.
589                  */
590                 for (j = 4; j <= (unsigned int)page_83[3] + 3; j += page_83[j + 3] + 4) {
591                         retval = check_fill_0x83_id(dev_scsi, &page_83[j],
592                                                     &id_search_list[id_ind],
593                                                     serial, serial_short, len);
594                         dbg("%s id desc %d/%d/%d\n", dev_scsi->kernel,
595                                 id_search_list[id_ind].id_type,
596                                 id_search_list[id_ind].naa_type,
597                                 id_search_list[id_ind].code_set);
598                         if (!retval) {
599                                 dbg("  used\n");
600                                 return retval;
601                         } else if (retval < 0) {
602                                 dbg("  failed\n");
603                                 return retval;
604                         } else {
605                                 dbg("  not used\n");
606                         }
607                 }
608         }
609         return 1;
610 }
611
612 /*
613  * Get device identification VPD page for older SCSI-2 device which is not
614  * compliant with either SPC-2 or SPC-3 format.
615  *
616  * Return the hard coded error code value 2 if the page 83 reply is not
617  * conformant to the SCSI-2 format.
618  */
619 static int do_scsi_page83_prespc3_inquiry(struct scsi_id_device *dev_scsi, int fd,
620                                           char *serial, char *serial_short, int len)
621 {
622         int retval;
623         int i, j;
624         unsigned char page_83[SCSI_INQ_BUFF_LEN];
625
626         memset(page_83, 0, SCSI_INQ_BUFF_LEN);
627         retval = scsi_inquiry(dev_scsi, fd, 1, PAGE_83, page_83, SCSI_INQ_BUFF_LEN);
628         if (retval < 0)
629                 return 1;
630
631         if (page_83[1] != PAGE_83) {
632                 info("%s: Invalid page 0x83\n", dev_scsi->kernel);
633                 return 1;
634         }
635         /*
636          * Model 4, 5, and (some) model 6 EMC Symmetrix devices return
637          * a page 83 reply according to SCSI-2 format instead of SPC-2/3.
638          *
639          * The SCSI-2 page 83 format returns an IEEE WWN in binary
640          * encoded hexi-decimal in the 16 bytes following the initial
641          * 4-byte page 83 reply header.
642          *
643          * Both the SPC-2 and SPC-3 formats return an IEEE WWN as part
644          * of an Identification descriptor.  The 3rd byte of the first
645          * Identification descriptor is a reserved (BSZ) byte field.
646          *
647          * Reference the 7th byte of the page 83 reply to determine
648          * whether the reply is compliant with SCSI-2 or SPC-2/3
649          * specifications.  A zero value in the 7th byte indicates
650          * an SPC-2/3 conformant reply, (i.e., the reserved field of the
651          * first Identification descriptor).  This byte will be non-zero
652          * for a SCSI-2 conformant page 83 reply from these EMC
653          * Symmetrix models since the 7th byte of the reply corresponds
654          * to the 4th and 5th nibbles of the 6-byte OUI for EMC, that is,
655          * 0x006048.
656          */
657         if (page_83[6] == 0)
658                 return 2;
659
660         serial[0] = hex_str[id_search_list[0].id_type];
661         /*
662          * The first four bytes contain data, not a descriptor.
663          */
664         i = 4;
665         j = strlen(serial);
666         /*
667          * Binary descriptor, convert to ASCII,
668          * using two bytes of ASCII for each byte
669          * in the page_83.
670          */
671         while (i < (page_83[3]+4)) {
672                 serial[j++] = hex_str[(page_83[i] & 0xf0) >> 4];
673                 serial[j++] = hex_str[page_83[i] & 0x0f];
674                 i++;
675         }
676         dbg("using pre-spc3-83 for %s\n", dev_scsi->kernel);
677         return 0;
678 }
679
680 /* Get unit serial number VPD page */
681 static int do_scsi_page80_inquiry(struct scsi_id_device *dev_scsi, int fd,
682                                   char *serial, char *serial_short, int max_len)
683 {
684         int retval;
685         int ser_ind;
686         int i;
687         int len;
688         unsigned char buf[SCSI_INQ_BUFF_LEN];
689
690         memset(buf, 0, SCSI_INQ_BUFF_LEN);
691         retval = scsi_inquiry(dev_scsi, fd, 1, PAGE_80, buf, SCSI_INQ_BUFF_LEN);
692         if (retval < 0)
693                 return retval;
694
695         if (buf[1] != PAGE_80) {
696                 info("%s: Invalid page 0x80\n", dev_scsi->kernel);
697                 return 1;
698         }
699
700         len = 1 + VENDOR_LENGTH + MODEL_LENGTH + buf[3];
701         if (max_len < len) {
702                 info("%s: length %d too short - need %d\n",
703                     dev_scsi->kernel, max_len, len);
704                 return 1;
705         }
706         /*
707          * Prepend 'S' to avoid unlikely collision with page 0x83 vendor
708          * specific type where we prepend '0' + vendor + model.
709          */
710         serial[0] = 'S';
711         ser_ind = prepend_vendor_model(dev_scsi, &serial[1]);
712         if (ser_ind < 0)
713                 return 1;
714         len = buf[3];
715         for (i = 4; i < len + 4; i++, ser_ind++)
716                 serial[ser_ind] = buf[i];
717         memcpy(serial_short, &buf[4], len);
718         serial_short[len] = '\0';
719         return 0;
720 }
721
722 int scsi_std_inquiry(struct scsi_id_device *dev_scsi, const char *devname)
723 {
724         int retval;
725         int fd;
726         unsigned char buf[SCSI_INQ_BUFF_LEN];
727         struct stat statbuf;
728
729         dbg("opening %s\n", devname);
730         fd = open(devname, O_RDONLY | O_NONBLOCK);
731         if (fd < 0) {
732                 info("scsi_id: cannot open %s: %s\n",
733                      devname, strerror(errno));
734                 return 1;
735         }
736
737         if (fstat(fd, &statbuf) < 0) {
738                 info("scsi_id: cannot stat %s: %s\n",
739                      devname, strerror(errno));
740                 return 2;
741         }
742         sprintf(dev_scsi->kernel,"%d:%d", major(statbuf.st_rdev),
743                 minor(statbuf.st_rdev));
744
745         memset(buf, 0, SCSI_INQ_BUFF_LEN);
746         retval = scsi_inquiry(dev_scsi, fd, 0, 0, buf, SCSI_INQ_BUFF_LEN);
747         if (retval < 0)
748                 return retval;
749
750         memcpy(dev_scsi->vendor, buf + 8, 8);
751         memcpy(dev_scsi->model, buf + 16, 16);
752         memcpy(dev_scsi->revision, buf + 32, 4);
753         sprintf(dev_scsi->type,"%x", buf[0] & 0x1f);
754
755         if (close(fd) < 0)
756                 info("%s: close failed: %s\n", dev_scsi->kernel, strerror(errno));
757
758         return 0;
759 }
760
761 int scsi_get_serial (struct scsi_id_device *dev_scsi, const char *devname,
762                      int page_code, char *serial_short, int len)
763 {
764         unsigned char page0[SCSI_INQ_BUFF_LEN];
765         int fd;
766         int ind;
767         int retval;
768
769         memset(dev_scsi->serial, 0, len);
770         dbg("opening %s\n", devname);
771         fd = open(devname, O_RDONLY | O_NONBLOCK);
772         if (fd < 0) {
773                 info("%s: cannot open %s: %s\n",
774                     dev_scsi->kernel, devname, strerror(errno));
775                 return 1;
776         }
777
778         if (page_code == PAGE_80) {
779                 if (do_scsi_page80_inquiry(dev_scsi, fd, dev_scsi->serial, serial_short, len)) {
780                         retval = 1;
781                         goto completed;
782                 } else  {
783                         retval = 0;
784                         goto completed;
785                 }
786         } else if (page_code == PAGE_83) {
787                 if (do_scsi_page83_inquiry(dev_scsi, fd, dev_scsi->serial, serial_short, len)) {
788                         retval = 1;
789                         goto completed;
790                 } else  {
791                         retval = 0;
792                         goto completed;
793                 }
794         } else if (page_code == PAGE_83_PRE_SPC3) {
795                 retval = do_scsi_page83_prespc3_inquiry(dev_scsi, fd, dev_scsi->serial, serial_short, len);
796                 if (retval) {
797                         /*
798                          * Fallback to servicing a SPC-2/3 compliant page 83
799                          * inquiry if the page 83 reply format does not
800                          * conform to pre-SPC3 expectations.
801                          */
802                         if (retval == 2) {
803                                 if (do_scsi_page83_inquiry(dev_scsi, fd, dev_scsi->serial, serial_short, len)) {
804                                         retval = 1;
805                                         goto completed;
806                                 } else  {
807                                         retval = 0;
808                                         goto completed;
809                                 }
810                         }
811                         else {
812                                 retval = 1;
813                                 goto completed;
814                         }
815                 } else  {
816                         retval = 0;
817                         goto completed;
818                 }
819         } else if (page_code != 0x00) {
820                 info("%s: unsupported page code 0x%d\n", dev_scsi->kernel, page_code);
821                 return 1;
822         }
823
824         /*
825          * Get page 0, the page of the pages. By default, try from best to
826          * worst of supported pages: 0x83 then 0x80.
827          */
828         if (do_scsi_page0_inquiry(dev_scsi, fd, page0, SCSI_INQ_BUFF_LEN)) {
829                 /*
830                  * Don't try anything else. Black list if a specific page
831                  * should be used for this vendor+model, or maybe have an
832                  * optional fall-back to page 0x80 or page 0x83.
833                  */
834                 retval = 1;
835                 goto completed;
836         }
837
838         dbg("%s: Checking page0\n", dev_scsi->kernel);
839
840         for (ind = 4; ind <= page0[3] + 3; ind++)
841                 if (page0[ind] == PAGE_83)
842                         if (!do_scsi_page83_inquiry(dev_scsi, fd,
843                                                     dev_scsi->serial, serial_short, len)) {
844                                 /*
845                                  * Success
846                                  */
847                                 retval = 0;
848                                 goto completed;
849                         }
850
851         for (ind = 4; ind <= page0[3] + 3; ind++)
852                 if (page0[ind] == PAGE_80)
853                         if (!do_scsi_page80_inquiry(dev_scsi, fd,
854                                                     dev_scsi->serial, serial_short, len)) {
855                                 /*
856                                  * Success
857                                  */
858                                 retval = 0;
859                                 goto completed;
860                         }
861         retval = 1;
862 completed:
863         if (close(fd) < 0)
864                 info("%s: close failed: %s\n", dev_scsi->kernel, strerror(errno));
865         return retval;
866 }