xref: /linux/drivers/scsi/scsi_devinfo.c (revision 4b132aacb0768ac1e652cf517097ea6f237214b9)
1 // SPDX-License-Identifier: GPL-2.0
2 
3 #include <linux/blkdev.h>
4 #include <linux/init.h>
5 #include <linux/kernel.h>
6 #include <linux/module.h>
7 #include <linux/moduleparam.h>
8 #include <linux/proc_fs.h>
9 #include <linux/seq_file.h>
10 #include <linux/slab.h>
11 
12 #include <scsi/scsi_device.h>
13 #include <scsi/scsi_devinfo.h>
14 
15 #include "scsi_priv.h"
16 
17 
18 /*
19  * scsi_dev_info_list: structure to hold black/white listed devices.
20  */
21 struct scsi_dev_info_list {
22 	struct list_head dev_info_list;
23 	char vendor[8];
24 	char model[16];
25 	blist_flags_t flags;
26 	unsigned compatible; /* for use with scsi_static_device_list entries */
27 };
28 
29 struct scsi_dev_info_list_table {
30 	struct list_head node;	/* our node for being on the master list */
31 	struct list_head scsi_dev_info_list; /* head of dev info list */
32 	const char *name;	/* name of list for /proc (NULL for global) */
33 	int key;		/* unique numeric identifier */
34 };
35 
36 
37 static blist_flags_t scsi_default_dev_flags;
38 static LIST_HEAD(scsi_dev_info_list);
39 static char scsi_dev_flags[256];
40 
41 /*
42  * scsi_static_device_list: list of devices that require settings that differ
43  * from the default, includes black-listed (broken) devices. The entries here
44  * are added to the tail of scsi_dev_info_list via scsi_dev_info_list_init.
45  *
46  * If possible, set the BLIST_* flags from inside a SCSI LLD rather than
47  * adding an entry to this list.
48  */
49 static struct {
50 	char *vendor;
51 	char *model;
52 	char *revision;	/* revision known to be bad, unused */
53 	blist_flags_t flags;
54 } scsi_static_device_list[] __initdata = {
55 	/*
56 	 * The following devices are known not to tolerate a lun != 0 scan
57 	 * for one reason or another. Some will respond to all luns,
58 	 * others will lock up.
59 	 */
60 	{"Aashima", "IMAGERY 2400SP", "1.03", BLIST_NOLUN},	/* locks up */
61 	{"CHINON", "CD-ROM CDS-431", "H42", BLIST_NOLUN},	/* locks up */
62 	{"CHINON", "CD-ROM CDS-535", "Q14", BLIST_NOLUN},	/* locks up */
63 	{"DENON", "DRD-25X", "V", BLIST_NOLUN},			/* locks up */
64 	{"HITACHI", "DK312C", "CM81", BLIST_NOLUN},	/* responds to all lun */
65 	{"HITACHI", "DK314C", "CR21", BLIST_NOLUN},	/* responds to all lun */
66 	{"IBM", "2104-DU3", NULL, BLIST_NOLUN},		/* locks up */
67 	{"IBM", "2104-TU3", NULL, BLIST_NOLUN},		/* locks up */
68 	{"IMS", "CDD521/10", "2.06", BLIST_NOLUN},	/* locks up */
69 	{"MAXTOR", "XT-3280", "PR02", BLIST_NOLUN},	/* locks up */
70 	{"MAXTOR", "XT-4380S", "B3C", BLIST_NOLUN},	/* locks up */
71 	{"MAXTOR", "MXT-1240S", "I1.2", BLIST_NOLUN},	/* locks up */
72 	{"MAXTOR", "XT-4170S", "B5A", BLIST_NOLUN},	/* locks up */
73 	{"MAXTOR", "XT-8760S", "B7B", BLIST_NOLUN},	/* locks up */
74 	{"MEDIAVIS", "RENO CD-ROMX2A", "2.03", BLIST_NOLUN},	/* responds to all lun */
75 	{"MICROTEK", "ScanMakerIII", "2.30", BLIST_NOLUN},	/* responds to all lun */
76 	{"NEC", "CD-ROM DRIVE:841", "1.0", BLIST_NOLUN},/* locks up */
77 	{"PHILIPS", "PCA80SC", "V4-2", BLIST_NOLUN},	/* responds to all lun */
78 	{"RODIME", "RO3000S", "2.33", BLIST_NOLUN},	/* locks up */
79 	{"SUN", "SENA", NULL, BLIST_NOLUN},		/* responds to all luns */
80 	/*
81 	 * The following causes a failed REQUEST SENSE on lun 1 for
82 	 * aha152x controller, which causes SCSI code to reset bus.
83 	 */
84 	{"SANYO", "CRD-250S", "1.20", BLIST_NOLUN},
85 	/*
86 	 * The following causes a failed REQUEST SENSE on lun 1 for
87 	 * aha152x controller, which causes SCSI code to reset bus.
88 	 */
89 	{"SEAGATE", "ST157N", "\004|j", BLIST_NOLUN},
90 	{"SEAGATE", "ST296", "921", BLIST_NOLUN},	/* responds to all lun */
91 	{"SEAGATE", "ST1581", "6538", BLIST_NOLUN},	/* responds to all lun */
92 	{"SONY", "CD-ROM CDU-541", "4.3d", BLIST_NOLUN},
93 	{"SONY", "CD-ROM CDU-55S", "1.0i", BLIST_NOLUN},
94 	{"SONY", "CD-ROM CDU-561", "1.7x", BLIST_NOLUN},
95 	{"SONY", "CD-ROM CDU-8012", NULL, BLIST_NOLUN},
96 	{"SONY", "SDT-5000", "3.17", BLIST_SELECT_NO_ATN},
97 	{"TANDBERG", "TDC 3600", "U07", BLIST_NOLUN},	/* locks up */
98 	{"TEAC", "CD-R55S", "1.0H", BLIST_NOLUN},	/* locks up */
99 	/*
100 	 * The following causes a failed REQUEST SENSE on lun 1 for
101 	 * seagate controller, which causes SCSI code to reset bus.
102 	 */
103 	{"TEAC", "CD-ROM", "1.06", BLIST_NOLUN},
104 	{"TEAC", "MT-2ST/45S2-27", "RV M", BLIST_NOLUN},	/* responds to all lun */
105 	/*
106 	 * The following causes a failed REQUEST SENSE on lun 1 for
107 	 * seagate controller, which causes SCSI code to reset bus.
108 	 */
109 	{"HP", "C1750A", "3226", BLIST_NOLUN},		/* scanjet iic */
110 	{"HP", "C1790A", NULL, BLIST_NOLUN},		/* scanjet iip */
111 	{"HP", "C2500A", NULL, BLIST_NOLUN},		/* scanjet iicx */
112 	{"MEDIAVIS", "CDR-H93MV", "1.31", BLIST_NOLUN},	/* locks up */
113 	{"MICROTEK", "ScanMaker II", "5.61", BLIST_NOLUN},	/* responds to all lun */
114 	{"MITSUMI", "CD-R CR-2201CS", "6119", BLIST_NOLUN},	/* locks up */
115 	{"NEC", "D3856", "0009", BLIST_NOLUN},
116 	{"QUANTUM", "LPS525S", "3110", BLIST_NOLUN},	/* locks up */
117 	{"QUANTUM", "PD1225S", "3110", BLIST_NOLUN},	/* locks up */
118 	{"QUANTUM", "FIREBALL ST4.3S", "0F0C", BLIST_NOLUN},	/* locks up */
119 	{"RELISYS", "Scorpio", NULL, BLIST_NOLUN},	/* responds to all lun */
120 	{"SANKYO", "CP525", "6.64", BLIST_NOLUN},	/* causes failed REQ SENSE, extra reset */
121 	{"TEXEL", "CD-ROM", "1.06", BLIST_NOLUN | BLIST_BORKEN},
122 	{"transtec", "T5008", "0001", BLIST_NOREPORTLUN },
123 	{"YAMAHA", "CDR100", "1.00", BLIST_NOLUN},	/* locks up */
124 	{"YAMAHA", "CDR102", "1.00", BLIST_NOLUN},	/* locks up */
125 	{"YAMAHA", "CRW8424S", "1.0", BLIST_NOLUN},	/* locks up */
126 	{"YAMAHA", "CRW6416S", "1.0c", BLIST_NOLUN},	/* locks up */
127 	{"", "Scanner", "1.80", BLIST_NOLUN},	/* responds to all lun */
128 
129 	/*
130 	 * Other types of devices that have special flags.
131 	 * Note that all USB devices should have the BLIST_INQUIRY_36 flag.
132 	 */
133 	{"3PARdata", "VV", NULL, BLIST_REPORTLUN2},
134 	{"ADAPTEC", "AACRAID", NULL, BLIST_FORCELUN},
135 	{"ADAPTEC", "Adaptec 5400S", NULL, BLIST_FORCELUN},
136 	{"AIX", "VDASD", NULL, BLIST_TRY_VPD_PAGES | BLIST_NO_VPD_SIZE},
137 	{"AFT PRO", "-IX CF", "0.0>", BLIST_FORCELUN},
138 	{"BELKIN", "USB 2 HS-CF", "1.95",  BLIST_FORCELUN | BLIST_INQUIRY_36},
139 	{"BROWNIE", "1200U3P", NULL, BLIST_NOREPORTLUN},
140 	{"BROWNIE", "1600U3P", NULL, BLIST_NOREPORTLUN},
141 	{"CANON", "IPUBJD", NULL, BLIST_SPARSELUN},
142 	{"CBOX3", "USB Storage-SMC", "300A", BLIST_FORCELUN | BLIST_INQUIRY_36},
143 	{"CMD", "CRA-7280", NULL, BLIST_SPARSELUN},	/* CMD RAID Controller */
144 	{"CNSI", "G7324", NULL, BLIST_SPARSELUN},	/* Chaparral G7324 RAID */
145 	{"CNSi", "G8324", NULL, BLIST_SPARSELUN},	/* Chaparral G8324 RAID */
146 	{"COMPAQ", "ARRAY CONTROLLER", NULL, BLIST_SPARSELUN | BLIST_LARGELUN |
147 		BLIST_MAX_512 | BLIST_REPORTLUN2},	/* Compaq RA4x00 */
148 	{"COMPAQ", "LOGICAL VOLUME", NULL, BLIST_FORCELUN | BLIST_MAX_512}, /* Compaq RA4x00 */
149 	{"COMPAQ", "CR3500", NULL, BLIST_FORCELUN},
150 	{"COMPAQ", "MSA1000", NULL, BLIST_SPARSELUN | BLIST_NOSTARTONADD},
151 	{"COMPAQ", "MSA1000 VOLUME", NULL, BLIST_SPARSELUN | BLIST_NOSTARTONADD},
152 	{"COMPAQ", "HSV110", NULL, BLIST_REPORTLUN2 | BLIST_NOSTARTONADD},
153 	{"DDN", "SAN DataDirector", "*", BLIST_SPARSELUN},
154 	{"DEC", "HSG80", NULL, BLIST_REPORTLUN2 | BLIST_NOSTARTONADD},
155 	{"DELL", "PV660F", NULL, BLIST_SPARSELUN},
156 	{"DELL", "PV660F   PSEUDO", NULL, BLIST_SPARSELUN},
157 	{"DELL", "PSEUDO DEVICE .", NULL, BLIST_SPARSELUN},	/* Dell PV 530F */
158 	{"DELL", "PV530F", NULL, BLIST_SPARSELUN},
159 	{"DELL", "PERCRAID", NULL, BLIST_FORCELUN},
160 	{"DGC", "RAID", NULL, BLIST_SPARSELUN},	/* EMC CLARiiON, storage on LUN 0 */
161 	{"DGC", "DISK", NULL, BLIST_SPARSELUN},	/* EMC CLARiiON, no storage on LUN 0 */
162 	{"EMC",  "Invista", "*", BLIST_SPARSELUN | BLIST_LARGELUN},
163 	{"EMC", "SYMMETRIX", NULL, BLIST_SPARSELUN | BLIST_LARGELUN |
164 	 BLIST_REPORTLUN2 | BLIST_RETRY_ITF},
165 	{"EMULEX", "MD21/S2     ESDI", NULL, BLIST_SINGLELUN},
166 	{"easyRAID", "16P", NULL, BLIST_NOREPORTLUN},
167 	{"easyRAID", "X6P", NULL, BLIST_NOREPORTLUN},
168 	{"easyRAID", "F8", NULL, BLIST_NOREPORTLUN},
169 	{"FSC", "CentricStor", "*", BLIST_SPARSELUN | BLIST_LARGELUN},
170 	{"FUJITSU", "ETERNUS_DXM", "*", BLIST_RETRY_ASC_C1},
171 	{"Generic", "USB SD Reader", "1.00", BLIST_FORCELUN | BLIST_INQUIRY_36},
172 	{"Generic", "USB Storage-SMC", NULL, BLIST_FORCELUN | BLIST_INQUIRY_36}, /* FW: 0180 and 0207 */
173 	{"Generic", "Ultra HS-SD/MMC", "2.09", BLIST_IGN_MEDIA_CHANGE | BLIST_INQUIRY_36},
174 	{"HITACHI", "DF400", "*", BLIST_REPORTLUN2},
175 	{"HITACHI", "DF500", "*", BLIST_REPORTLUN2},
176 	{"HITACHI", "DISK-SUBSYSTEM", "*", BLIST_REPORTLUN2},
177 	{"HITACHI", "HUS1530", "*", BLIST_NO_DIF},
178 	{"HITACHI", "OPEN-", "*", BLIST_REPORTLUN2 | BLIST_TRY_VPD_PAGES},
179 	{"HP", "A6189A", NULL, BLIST_SPARSELUN | BLIST_LARGELUN},	/* HP VA7400 */
180 	{"HP", "OPEN-", "*", BLIST_REPORTLUN2 | BLIST_TRY_VPD_PAGES}, /* HP XP Arrays */
181 	{"HP", "NetRAID-4M", NULL, BLIST_FORCELUN},
182 	{"HP", "HSV100", NULL, BLIST_REPORTLUN2 | BLIST_NOSTARTONADD},
183 	{"HP", "C1557A", NULL, BLIST_FORCELUN},
184 	{"HP", "C3323-300", "4269", BLIST_NOTQ},
185 	{"HP", "C5713A", NULL, BLIST_NOREPORTLUN},
186 	{"HP", "DISK-SUBSYSTEM", "*", BLIST_REPORTLUN2},
187 	{"HPE", "OPEN-", "*", BLIST_REPORTLUN2 | BLIST_TRY_VPD_PAGES},
188 	{"IBM", "AuSaV1S2", NULL, BLIST_FORCELUN},
189 	{"IBM", "ProFibre 4000R", "*", BLIST_SPARSELUN | BLIST_LARGELUN},
190 	{"IBM", "2076", NULL, BLIST_NO_VPD_SIZE},
191 	{"IBM", "2105", NULL, BLIST_RETRY_HWERROR},
192 	{"iomega", "jaz 1GB", "J.86", BLIST_NOTQ | BLIST_NOLUN},
193 	{"IOMEGA", "ZIP", NULL, BLIST_NOTQ | BLIST_NOLUN},
194 	{"IOMEGA", "Io20S         *F", NULL, BLIST_KEY},
195 	{"INSITE", "Floptical   F*8I", NULL, BLIST_KEY},
196 	{"INSITE", "I325VM", NULL, BLIST_KEY},
197 	{"Intel", "Multi-Flex", NULL, BLIST_NO_RSOC},
198 	{"iRiver", "iFP Mass Driver", NULL, BLIST_NOT_LOCKABLE | BLIST_INQUIRY_36},
199 	{"LASOUND", "CDX7405", "3.10", BLIST_MAX5LUN | BLIST_SINGLELUN},
200 	{"Marvell", "Console", NULL, BLIST_SKIP_VPD_PAGES},
201 	{"Marvell", "91xx Config", "1.01", BLIST_SKIP_VPD_PAGES},
202 	{"MATSHITA", "PD-1", NULL, BLIST_FORCELUN | BLIST_SINGLELUN},
203 	{"MATSHITA", "DMC-LC5", NULL, BLIST_NOT_LOCKABLE | BLIST_INQUIRY_36},
204 	{"MATSHITA", "DMC-LC40", NULL, BLIST_NOT_LOCKABLE | BLIST_INQUIRY_36},
205 	{"Medion", "Flash XL  MMC/SD", "2.6D", BLIST_FORCELUN},
206 	{"MegaRAID", "LD", NULL, BLIST_FORCELUN},
207 	{"MICROP", "4110", NULL, BLIST_NOTQ},
208 	{"MSFT", "Virtual HD", NULL, BLIST_MAX_1024 | BLIST_NO_RSOC},
209 	{"MYLEX", "DACARMRB", "*", BLIST_REPORTLUN2},
210 	{"nCipher", "Fastness Crypto", NULL, BLIST_FORCELUN},
211 	{"NAKAMICH", "MJ-4.8S", NULL, BLIST_FORCELUN | BLIST_SINGLELUN},
212 	{"NAKAMICH", "MJ-5.16S", NULL, BLIST_FORCELUN | BLIST_SINGLELUN},
213 	{"NEC", "PD-1 ODX654P", NULL, BLIST_FORCELUN | BLIST_SINGLELUN},
214 	{"NEC", "iStorage", NULL, BLIST_REPORTLUN2},
215 	{"NRC", "MBR-7", NULL, BLIST_FORCELUN | BLIST_SINGLELUN},
216 	{"NRC", "MBR-7.4", NULL, BLIST_FORCELUN | BLIST_SINGLELUN},
217 	{"PIONEER", "CD-ROM DRM-600", NULL, BLIST_FORCELUN | BLIST_SINGLELUN},
218 	{"PIONEER", "CD-ROM DRM-602X", NULL, BLIST_FORCELUN | BLIST_SINGLELUN},
219 	{"PIONEER", "CD-ROM DRM-604X", NULL, BLIST_FORCELUN | BLIST_SINGLELUN},
220 	{"PIONEER", "CD-ROM DRM-624X", NULL, BLIST_FORCELUN | BLIST_SINGLELUN},
221 	{"Promise", "VTrak E610f", NULL, BLIST_SPARSELUN | BLIST_NO_RSOC},
222 	{"Promise", "", NULL, BLIST_SPARSELUN},
223 	{"QEMU", "QEMU CD-ROM", NULL, BLIST_SKIP_VPD_PAGES},
224 	{"QNAP", "iSCSI Storage", NULL, BLIST_MAX_1024},
225 	{"SYNOLOGY", "iSCSI Storage", NULL, BLIST_MAX_1024},
226 	{"QUANTUM", "XP34301", "1071", BLIST_NOTQ},
227 	{"REGAL", "CDC-4X", NULL, BLIST_MAX5LUN | BLIST_SINGLELUN},
228 	{"SanDisk", "ImageMate CF-SD1", NULL, BLIST_FORCELUN},
229 	{"SEAGATE", "ST34555N", "0930", BLIST_NOTQ},	/* Chokes on tagged INQUIRY */
230 	{"SEAGATE", "ST3390N", "9546", BLIST_NOTQ},
231 	{"SEAGATE", "ST900MM0006", NULL, BLIST_SKIP_VPD_PAGES},
232 	{"SGI", "RAID3", "*", BLIST_SPARSELUN},
233 	{"SGI", "RAID5", "*", BLIST_SPARSELUN},
234 	{"SGI", "TP9100", "*", BLIST_REPORTLUN2},
235 	{"SGI", "Universal Xport", "*", BLIST_NO_ULD_ATTACH},
236 	{"SKhynix", "H28U74301AMR", NULL, BLIST_SKIP_VPD_PAGES},
237 	{"IBM", "Universal Xport", "*", BLIST_NO_ULD_ATTACH},
238 	{"SUN", "Universal Xport", "*", BLIST_NO_ULD_ATTACH},
239 	{"DELL", "Universal Xport", "*", BLIST_NO_ULD_ATTACH},
240 	{"STK", "Universal Xport", "*", BLIST_NO_ULD_ATTACH},
241 	{"NETAPP", "Universal Xport", "*", BLIST_NO_ULD_ATTACH},
242 	{"LSI", "Universal Xport", "*", BLIST_NO_ULD_ATTACH},
243 	{"ENGENIO", "Universal Xport", "*", BLIST_NO_ULD_ATTACH},
244 	{"LENOVO", "Universal Xport", "*", BLIST_NO_ULD_ATTACH},
245 	{"FUJITSU", "Universal Xport", "*", BLIST_NO_ULD_ATTACH},
246 	{"SanDisk", "Cruzer Blade", NULL, BLIST_TRY_VPD_PAGES |
247 		BLIST_INQUIRY_36},
248 	{"SMSC", "USB 2 HS-CF", NULL, BLIST_SPARSELUN | BLIST_INQUIRY_36},
249 	{"SONY", "CD-ROM CDU-8001", NULL, BLIST_BORKEN},
250 	{"SONY", "TSL", NULL, BLIST_FORCELUN},		/* DDS3 & DDS4 autoloaders */
251 	{"ST650211", "CF", NULL, BLIST_RETRY_HWERROR},
252 	{"SUN", "T300", "*", BLIST_SPARSELUN},
253 	{"SUN", "T4", "*", BLIST_SPARSELUN},
254 	{"Tornado-", "F4", "*", BLIST_NOREPORTLUN},
255 	{"TOSHIBA", "CDROM", NULL, BLIST_ISROM},
256 	{"TOSHIBA", "CD-ROM", NULL, BLIST_ISROM},
257 	{"Traxdata", "CDR4120", NULL, BLIST_NOLUN},	/* locks up */
258 	{"USB2.0", "SMARTMEDIA/XD", NULL, BLIST_FORCELUN | BLIST_INQUIRY_36},
259 	{"WangDAT", "Model 2600", "01.7", BLIST_SELECT_NO_ATN},
260 	{"WangDAT", "Model 3200", "02.2", BLIST_SELECT_NO_ATN},
261 	{"WangDAT", "Model 1300", "02.4", BLIST_SELECT_NO_ATN},
262 	{"WDC WD25", "00JB-00FUA0", NULL, BLIST_NOREPORTLUN},
263 	{"XYRATEX", "RS", "*", BLIST_SPARSELUN | BLIST_LARGELUN},
264 	{"Zzyzx", "RocketStor 500S", NULL, BLIST_SPARSELUN},
265 	{"Zzyzx", "RocketStor 2000", NULL, BLIST_SPARSELUN},
266 	{ NULL, NULL, NULL, 0 },
267 };
268 
269 static struct scsi_dev_info_list_table *scsi_devinfo_lookup_by_key(int key)
270 {
271 	struct scsi_dev_info_list_table *devinfo_table;
272 	int found = 0;
273 
274 	list_for_each_entry(devinfo_table, &scsi_dev_info_list, node)
275 		if (devinfo_table->key == key) {
276 			found = 1;
277 			break;
278 		}
279 	if (!found)
280 		return ERR_PTR(-EINVAL);
281 
282 	return devinfo_table;
283 }
284 
285 /*
286  * scsi_strcpy_devinfo: called from scsi_dev_info_list_add to copy into
287  * devinfo vendor and model strings.
288  */
289 static void scsi_strcpy_devinfo(char *name, char *to, size_t to_length,
290 				char *from, int compatible)
291 {
292 	size_t from_length;
293 
294 	from_length = strlen(from);
295 
296 	/*
297 	 * null pad and null terminate if compatible
298 	 * otherwise space pad
299 	 */
300 	if (compatible)
301 		strscpy_pad(to, from, to_length);
302 	else
303 		memcpy_and_pad(to, to_length, from, from_length, ' ');
304 
305 	if (from_length > to_length)
306 		 printk(KERN_WARNING "%s: %s string '%s' is too long\n",
307 			__func__, name, from);
308 }
309 
310 /**
311  * scsi_dev_info_list_add - add one dev_info list entry.
312  * @compatible: if true, null terminate short strings.  Otherwise space pad.
313  * @vendor:	vendor string
314  * @model:	model (product) string
315  * @strflags:	integer string
316  * @flags:	if strflags NULL, use this flag value
317  *
318  * Description:
319  *	Create and add one dev_info entry for @vendor, @model, @strflags or
320  *	@flag. If @compatible, add to the tail of the list, do not space
321  *	pad, and set devinfo->compatible. The scsi_static_device_list entries
322  *	are added with @compatible 1 and @clfags NULL.
323  *
324  * Returns: 0 OK, -error on failure.
325  **/
326 static int scsi_dev_info_list_add(int compatible, char *vendor, char *model,
327 			    char *strflags, blist_flags_t flags)
328 {
329 	return scsi_dev_info_list_add_keyed(compatible, vendor, model,
330 					    strflags, flags,
331 					    SCSI_DEVINFO_GLOBAL);
332 }
333 
334 /**
335  * scsi_dev_info_list_add_keyed - add one dev_info list entry.
336  * @compatible: if true, null terminate short strings.  Otherwise space pad.
337  * @vendor:	vendor string
338  * @model:	model (product) string
339  * @strflags:	integer string
340  * @flags:	if strflags NULL, use this flag value
341  * @key:	specify list to use
342  *
343  * Description:
344  *	Create and add one dev_info entry for @vendor, @model,
345  *	@strflags or @flag in list specified by @key. If @compatible,
346  *	add to the tail of the list, do not space pad, and set
347  *	devinfo->compatible. The scsi_static_device_list entries are
348  *	added with @compatible 1 and @clfags NULL.
349  *
350  * Returns: 0 OK, -error on failure.
351  **/
352 int scsi_dev_info_list_add_keyed(int compatible, char *vendor, char *model,
353 				 char *strflags, blist_flags_t flags,
354 				 enum scsi_devinfo_key key)
355 {
356 	struct scsi_dev_info_list *devinfo;
357 	struct scsi_dev_info_list_table *devinfo_table =
358 		scsi_devinfo_lookup_by_key(key);
359 
360 	if (IS_ERR(devinfo_table))
361 		return PTR_ERR(devinfo_table);
362 
363 	devinfo = kmalloc(sizeof(*devinfo), GFP_KERNEL);
364 	if (!devinfo) {
365 		printk(KERN_ERR "%s: no memory\n", __func__);
366 		return -ENOMEM;
367 	}
368 
369 	scsi_strcpy_devinfo("vendor", devinfo->vendor, sizeof(devinfo->vendor),
370 			    vendor, compatible);
371 	scsi_strcpy_devinfo("model", devinfo->model, sizeof(devinfo->model),
372 			    model, compatible);
373 
374 	if (strflags) {
375 		unsigned long long val;
376 		int ret = kstrtoull(strflags, 0, &val);
377 
378 		if (ret != 0) {
379 			kfree(devinfo);
380 			return ret;
381 		}
382 		flags = (__force blist_flags_t)val;
383 	}
384 	if (flags & __BLIST_UNUSED_MASK) {
385 		pr_err("scsi_devinfo (%s:%s): unsupported flags 0x%llx",
386 		       vendor, model, flags & __BLIST_UNUSED_MASK);
387 		kfree(devinfo);
388 		return -EINVAL;
389 	}
390 	devinfo->flags = flags;
391 	devinfo->compatible = compatible;
392 
393 	if (compatible)
394 		list_add_tail(&devinfo->dev_info_list,
395 			      &devinfo_table->scsi_dev_info_list);
396 	else
397 		list_add(&devinfo->dev_info_list,
398 			 &devinfo_table->scsi_dev_info_list);
399 
400 	return 0;
401 }
402 EXPORT_SYMBOL(scsi_dev_info_list_add_keyed);
403 
404 /**
405  * scsi_dev_info_list_find - find a matching dev_info list entry.
406  * @vendor:	full vendor string
407  * @model:	full model (product) string
408  * @key:	specify list to use
409  *
410  * Description:
411  *	Finds the first dev_info entry matching @vendor, @model
412  *	in list specified by @key.
413  *
414  * Returns: pointer to matching entry, or ERR_PTR on failure.
415  **/
416 static struct scsi_dev_info_list *scsi_dev_info_list_find(const char *vendor,
417 		const char *model, enum scsi_devinfo_key key)
418 {
419 	struct scsi_dev_info_list *devinfo;
420 	struct scsi_dev_info_list_table *devinfo_table =
421 		scsi_devinfo_lookup_by_key(key);
422 	size_t vmax, mmax, mlen;
423 	const char *vskip, *mskip;
424 
425 	if (IS_ERR(devinfo_table))
426 		return (struct scsi_dev_info_list *) devinfo_table;
427 
428 	/* Prepare for "compatible" matches */
429 
430 	/*
431 	 * XXX why skip leading spaces? If an odd INQUIRY
432 	 * value, that should have been part of the
433 	 * scsi_static_device_list[] entry, such as "  FOO"
434 	 * rather than "FOO". Since this code is already
435 	 * here, and we don't know what device it is
436 	 * trying to work with, leave it as-is.
437 	 */
438 	vmax = sizeof(devinfo->vendor);
439 	vskip = vendor;
440 	while (vmax > 0 && *vskip == ' ') {
441 		vmax--;
442 		vskip++;
443 	}
444 	/* Also skip trailing spaces */
445 	while (vmax > 0 && vskip[vmax - 1] == ' ')
446 		--vmax;
447 
448 	mmax = sizeof(devinfo->model);
449 	mskip = model;
450 	while (mmax > 0 && *mskip == ' ') {
451 		mmax--;
452 		mskip++;
453 	}
454 	while (mmax > 0 && mskip[mmax - 1] == ' ')
455 		--mmax;
456 
457 	list_for_each_entry(devinfo, &devinfo_table->scsi_dev_info_list,
458 			    dev_info_list) {
459 		if (devinfo->compatible) {
460 			/*
461 			 * vendor strings must be an exact match
462 			 */
463 			if (vmax != strnlen(devinfo->vendor,
464 					    sizeof(devinfo->vendor)) ||
465 			    memcmp(devinfo->vendor, vskip, vmax))
466 				continue;
467 
468 			/*
469 			 * @model specifies the full string, and
470 			 * must be larger or equal to devinfo->model
471 			 */
472 			mlen = strnlen(devinfo->model, sizeof(devinfo->model));
473 			if (mmax < mlen || memcmp(devinfo->model, mskip, mlen))
474 				continue;
475 			return devinfo;
476 		} else {
477 			if (!memcmp(devinfo->vendor, vendor,
478 				    sizeof(devinfo->vendor)) &&
479 			    !memcmp(devinfo->model, model,
480 				    sizeof(devinfo->model)))
481 				return devinfo;
482 		}
483 	}
484 
485 	return ERR_PTR(-ENOENT);
486 }
487 
488 /**
489  * scsi_dev_info_list_del_keyed - remove one dev_info list entry.
490  * @vendor:	vendor string
491  * @model:	model (product) string
492  * @key:	specify list to use
493  *
494  * Description:
495  *	Remove and destroy one dev_info entry for @vendor, @model
496  *	in list specified by @key.
497  *
498  * Returns: 0 OK, -error on failure.
499  **/
500 int scsi_dev_info_list_del_keyed(char *vendor, char *model,
501 				 enum scsi_devinfo_key key)
502 {
503 	struct scsi_dev_info_list *found;
504 
505 	found = scsi_dev_info_list_find(vendor, model, key);
506 	if (IS_ERR(found))
507 		return PTR_ERR(found);
508 
509 	list_del(&found->dev_info_list);
510 	kfree(found);
511 	return 0;
512 }
513 EXPORT_SYMBOL(scsi_dev_info_list_del_keyed);
514 
515 /**
516  * scsi_dev_info_list_add_str - parse dev_list and add to the scsi_dev_info_list.
517  * @dev_list:	string of device flags to add
518  *
519  * Description:
520  *	Parse dev_list, and add entries to the scsi_dev_info_list.
521  *	dev_list is of the form "vendor:product:flag,vendor:product:flag".
522  *	dev_list is modified via strsep. Can be called for command line
523  *	addition, for proc or mabye a sysfs interface.
524  *
525  * Returns: 0 if OK, -error on failure.
526  **/
527 static int scsi_dev_info_list_add_str(char *dev_list)
528 {
529 	char *vendor, *model, *strflags, *next;
530 	char *next_check;
531 	int res = 0;
532 
533 	next = dev_list;
534 	if (next && next[0] == '"') {
535 		/*
536 		 * Ignore both the leading and trailing quote.
537 		 */
538 		next++;
539 		next_check = ",\"";
540 	} else {
541 		next_check = ",";
542 	}
543 
544 	/*
545 	 * For the leading and trailing '"' case, the for loop comes
546 	 * through the last time with vendor[0] == '\0'.
547 	 */
548 	for (vendor = strsep(&next, ":"); vendor && (vendor[0] != '\0')
549 	     && (res == 0); vendor = strsep(&next, ":")) {
550 		strflags = NULL;
551 		model = strsep(&next, ":");
552 		if (model)
553 			strflags = strsep(&next, next_check);
554 		if (!model || !strflags) {
555 			pr_err("%s: bad dev info string '%s' '%s' '%s'\n",
556 			       __func__, vendor, model ? model : "",
557 			       strflags ? strflags : "");
558 			res = -EINVAL;
559 		} else
560 			res = scsi_dev_info_list_add(0 /* compatible */, vendor,
561 						     model, strflags, 0);
562 	}
563 	return res;
564 }
565 
566 /**
567  * scsi_get_device_flags - get device specific flags from the dynamic
568  *	device list.
569  * @sdev:       &scsi_device to get flags for
570  * @vendor:	vendor name
571  * @model:	model name
572  *
573  * Description:
574  *     Search the global scsi_dev_info_list (specified by list zero)
575  *     for an entry matching @vendor and @model, if found, return the
576  *     matching flags value, else return the host or global default
577  *     settings.  Called during scan time.
578  **/
579 blist_flags_t scsi_get_device_flags(struct scsi_device *sdev,
580 				    const unsigned char *vendor,
581 				    const unsigned char *model)
582 {
583 	return scsi_get_device_flags_keyed(sdev, vendor, model,
584 					   SCSI_DEVINFO_GLOBAL);
585 }
586 
587 
588 /**
589  * scsi_get_device_flags_keyed - get device specific flags from the dynamic device list
590  * @sdev:       &scsi_device to get flags for
591  * @vendor:	vendor name
592  * @model:	model name
593  * @key:	list to look up
594  *
595  * Description:
596  *     Search the scsi_dev_info_list specified by @key for an entry
597  *     matching @vendor and @model, if found, return the matching
598  *     flags value, else return the host or global default settings.
599  *     Called during scan time.
600  **/
601 blist_flags_t scsi_get_device_flags_keyed(struct scsi_device *sdev,
602 				const unsigned char *vendor,
603 				const unsigned char *model,
604 				enum scsi_devinfo_key key)
605 {
606 	struct scsi_dev_info_list *devinfo;
607 
608 	devinfo = scsi_dev_info_list_find(vendor, model, key);
609 	if (!IS_ERR(devinfo))
610 		return devinfo->flags;
611 
612 	/* key or device not found: return nothing */
613 	if (key != SCSI_DEVINFO_GLOBAL)
614 		return 0;
615 
616 	/* except for the global list, where we have an exception */
617 	if (sdev->sdev_bflags)
618 		return sdev->sdev_bflags;
619 
620 	return scsi_default_dev_flags;
621 }
622 EXPORT_SYMBOL(scsi_get_device_flags_keyed);
623 
624 #ifdef CONFIG_SCSI_PROC_FS
625 struct double_list {
626 	struct list_head *top;
627 	struct list_head *bottom;
628 };
629 
630 static int devinfo_seq_show(struct seq_file *m, void *v)
631 {
632 	struct double_list *dl = v;
633 	struct scsi_dev_info_list_table *devinfo_table =
634 		list_entry(dl->top, struct scsi_dev_info_list_table, node);
635 	struct scsi_dev_info_list *devinfo =
636 		list_entry(dl->bottom, struct scsi_dev_info_list,
637 			   dev_info_list);
638 
639 	if (devinfo_table->scsi_dev_info_list.next == dl->bottom &&
640 	    devinfo_table->name)
641 		seq_printf(m, "[%s]:\n", devinfo_table->name);
642 
643 	seq_printf(m, "'%.8s' '%.16s' 0x%llx\n",
644 		   devinfo->vendor, devinfo->model, devinfo->flags);
645 	return 0;
646 }
647 
648 static void *devinfo_seq_start(struct seq_file *m, loff_t *ppos)
649 {
650 	struct double_list *dl = kmalloc(sizeof(*dl), GFP_KERNEL);
651 	loff_t pos = *ppos;
652 
653 	if (!dl)
654 		return NULL;
655 
656 	list_for_each(dl->top, &scsi_dev_info_list) {
657 		struct scsi_dev_info_list_table *devinfo_table =
658 			list_entry(dl->top, struct scsi_dev_info_list_table,
659 				   node);
660 		list_for_each(dl->bottom, &devinfo_table->scsi_dev_info_list)
661 			if (pos-- == 0)
662 				return dl;
663 	}
664 
665 	kfree(dl);
666 	return NULL;
667 }
668 
669 static void *devinfo_seq_next(struct seq_file *m, void *v, loff_t *ppos)
670 {
671 	struct double_list *dl = v;
672 	struct scsi_dev_info_list_table *devinfo_table =
673 		list_entry(dl->top, struct scsi_dev_info_list_table, node);
674 
675 	++*ppos;
676 	dl->bottom = dl->bottom->next;
677 	while (&devinfo_table->scsi_dev_info_list == dl->bottom) {
678 		dl->top = dl->top->next;
679 		if (dl->top == &scsi_dev_info_list) {
680 			kfree(dl);
681 			return NULL;
682 		}
683 		devinfo_table = list_entry(dl->top,
684 					   struct scsi_dev_info_list_table,
685 					   node);
686 		dl->bottom = devinfo_table->scsi_dev_info_list.next;
687 	}
688 
689 	return dl;
690 }
691 
692 static void devinfo_seq_stop(struct seq_file *m, void *v)
693 {
694 	kfree(v);
695 }
696 
697 static const struct seq_operations scsi_devinfo_seq_ops = {
698 	.start	= devinfo_seq_start,
699 	.next	= devinfo_seq_next,
700 	.stop	= devinfo_seq_stop,
701 	.show	= devinfo_seq_show,
702 };
703 
704 static int proc_scsi_devinfo_open(struct inode *inode, struct file *file)
705 {
706 	return seq_open(file, &scsi_devinfo_seq_ops);
707 }
708 
709 /*
710  * proc_scsi_dev_info_write - allow additions to scsi_dev_info_list via /proc.
711  *
712  * Description: Adds a black/white list entry for vendor and model with an
713  * integer value of flag to the scsi device info list.
714  * To use, echo "vendor:model:flag" > /proc/scsi/device_info
715  */
716 static ssize_t proc_scsi_devinfo_write(struct file *file,
717 				       const char __user *buf,
718 				       size_t length, loff_t *ppos)
719 {
720 	char *buffer;
721 	ssize_t err = length;
722 
723 	if (!buf || length>PAGE_SIZE)
724 		return -EINVAL;
725 	if (!(buffer = (char *) __get_free_page(GFP_KERNEL)))
726 		return -ENOMEM;
727 	if (copy_from_user(buffer, buf, length)) {
728 		err =-EFAULT;
729 		goto out;
730 	}
731 
732 	if (length < PAGE_SIZE)
733 		buffer[length] = '\0';
734 	else if (buffer[PAGE_SIZE-1]) {
735 		err = -EINVAL;
736 		goto out;
737 	}
738 
739 	scsi_dev_info_list_add_str(buffer);
740 
741 out:
742 	free_page((unsigned long)buffer);
743 	return err;
744 }
745 
746 static const struct proc_ops scsi_devinfo_proc_ops = {
747 	.proc_open	= proc_scsi_devinfo_open,
748 	.proc_read	= seq_read,
749 	.proc_write	= proc_scsi_devinfo_write,
750 	.proc_lseek	= seq_lseek,
751 	.proc_release	= seq_release,
752 };
753 #endif /* CONFIG_SCSI_PROC_FS */
754 
755 module_param_string(dev_flags, scsi_dev_flags, sizeof(scsi_dev_flags), 0);
756 MODULE_PARM_DESC(dev_flags,
757 	 "Given scsi_dev_flags=vendor:model:flags[,v:m:f] add black/white"
758 	 " list entries for vendor and model with an integer value of flags"
759 	 " to the scsi device info list");
760 
761 module_param_named(default_dev_flags, scsi_default_dev_flags, ullong, 0644);
762 MODULE_PARM_DESC(default_dev_flags,
763 		 "scsi default device flag uint64_t value");
764 
765 /**
766  * scsi_exit_devinfo - remove /proc/scsi/device_info & the scsi_dev_info_list
767  **/
768 void scsi_exit_devinfo(void)
769 {
770 #ifdef CONFIG_SCSI_PROC_FS
771 	remove_proc_entry("scsi/device_info", NULL);
772 #endif
773 
774 	scsi_dev_info_remove_list(SCSI_DEVINFO_GLOBAL);
775 }
776 
777 /**
778  * scsi_dev_info_add_list - add a new devinfo list
779  * @key:	key of the list to add
780  * @name:	Name of the list to add (for /proc/scsi/device_info)
781  *
782  * Adds the requested list, returns zero on success, -EEXIST if the
783  * key is already registered to a list, or other error on failure.
784  */
785 int scsi_dev_info_add_list(enum scsi_devinfo_key key, const char *name)
786 {
787 	struct scsi_dev_info_list_table *devinfo_table =
788 		scsi_devinfo_lookup_by_key(key);
789 
790 	if (!IS_ERR(devinfo_table))
791 		/* list already exists */
792 		return -EEXIST;
793 
794 	devinfo_table = kmalloc(sizeof(*devinfo_table), GFP_KERNEL);
795 
796 	if (!devinfo_table)
797 		return -ENOMEM;
798 
799 	INIT_LIST_HEAD(&devinfo_table->node);
800 	INIT_LIST_HEAD(&devinfo_table->scsi_dev_info_list);
801 	devinfo_table->name = name;
802 	devinfo_table->key = key;
803 	list_add_tail(&devinfo_table->node, &scsi_dev_info_list);
804 
805 	return 0;
806 }
807 EXPORT_SYMBOL(scsi_dev_info_add_list);
808 
809 /**
810  * scsi_dev_info_remove_list - destroy an added devinfo list
811  * @key: key of the list to destroy
812  *
813  * Iterates over the entire list first, freeing all the values, then
814  * frees the list itself.  Returns 0 on success or -EINVAL if the key
815  * can't be found.
816  */
817 int scsi_dev_info_remove_list(enum scsi_devinfo_key key)
818 {
819 	struct list_head *lh, *lh_next;
820 	struct scsi_dev_info_list_table *devinfo_table =
821 		scsi_devinfo_lookup_by_key(key);
822 
823 	if (IS_ERR(devinfo_table))
824 		/* no such list */
825 		return -EINVAL;
826 
827 	/* remove from the master list */
828 	list_del(&devinfo_table->node);
829 
830 	list_for_each_safe(lh, lh_next, &devinfo_table->scsi_dev_info_list) {
831 		struct scsi_dev_info_list *devinfo;
832 
833 		devinfo = list_entry(lh, struct scsi_dev_info_list,
834 				     dev_info_list);
835 		kfree(devinfo);
836 	}
837 	kfree(devinfo_table);
838 
839 	return 0;
840 }
841 EXPORT_SYMBOL(scsi_dev_info_remove_list);
842 
843 /**
844  * scsi_init_devinfo - set up the dynamic device list.
845  *
846  * Description:
847  *	Add command line entries from scsi_dev_flags, then add
848  *	scsi_static_device_list entries to the scsi device info list.
849  */
850 int __init scsi_init_devinfo(void)
851 {
852 #ifdef CONFIG_SCSI_PROC_FS
853 	struct proc_dir_entry *p;
854 #endif
855 	int error, i;
856 
857 	error = scsi_dev_info_add_list(SCSI_DEVINFO_GLOBAL, NULL);
858 	if (error)
859 		return error;
860 
861 	error = scsi_dev_info_list_add_str(scsi_dev_flags);
862 	if (error)
863 		goto out;
864 
865 	for (i = 0; scsi_static_device_list[i].vendor; i++) {
866 		error = scsi_dev_info_list_add(1 /* compatibile */,
867 				scsi_static_device_list[i].vendor,
868 				scsi_static_device_list[i].model,
869 				NULL,
870 				scsi_static_device_list[i].flags);
871 		if (error)
872 			goto out;
873 	}
874 
875 #ifdef CONFIG_SCSI_PROC_FS
876 	p = proc_create("scsi/device_info", 0, NULL, &scsi_devinfo_proc_ops);
877 	if (!p) {
878 		error = -ENOMEM;
879 		goto out;
880 	}
881 #endif /* CONFIG_SCSI_PROC_FS */
882 
883  out:
884 	if (error)
885 		scsi_exit_devinfo();
886 	return error;
887 }
888