xref: /linux/drivers/scsi/scsi_sysfs.c (revision ba6e8564f459211117ce300eae2c7fdd23befe34)
1 /*
2  * scsi_sysfs.c
3  *
4  * SCSI sysfs interface routines.
5  *
6  * Created to pull SCSI mid layer sysfs routines into one file.
7  */
8 
9 #include <linux/module.h>
10 #include <linux/init.h>
11 #include <linux/blkdev.h>
12 #include <linux/device.h>
13 
14 #include <scsi/scsi.h>
15 #include <scsi/scsi_device.h>
16 #include <scsi/scsi_host.h>
17 #include <scsi/scsi_tcq.h>
18 #include <scsi/scsi_transport.h>
19 
20 #include "scsi_priv.h"
21 #include "scsi_logging.h"
22 
23 static const struct {
24 	enum scsi_device_state	value;
25 	char			*name;
26 } sdev_states[] = {
27 	{ SDEV_CREATED, "created" },
28 	{ SDEV_RUNNING, "running" },
29 	{ SDEV_CANCEL, "cancel" },
30 	{ SDEV_DEL, "deleted" },
31 	{ SDEV_QUIESCE, "quiesce" },
32 	{ SDEV_OFFLINE,	"offline" },
33 	{ SDEV_BLOCK,	"blocked" },
34 };
35 
36 const char *scsi_device_state_name(enum scsi_device_state state)
37 {
38 	int i;
39 	char *name = NULL;
40 
41 	for (i = 0; i < ARRAY_SIZE(sdev_states); i++) {
42 		if (sdev_states[i].value == state) {
43 			name = sdev_states[i].name;
44 			break;
45 		}
46 	}
47 	return name;
48 }
49 
50 static const struct {
51 	enum scsi_host_state	value;
52 	char			*name;
53 } shost_states[] = {
54 	{ SHOST_CREATED, "created" },
55 	{ SHOST_RUNNING, "running" },
56 	{ SHOST_CANCEL, "cancel" },
57 	{ SHOST_DEL, "deleted" },
58 	{ SHOST_RECOVERY, "recovery" },
59 	{ SHOST_CANCEL_RECOVERY, "cancel/recovery" },
60 	{ SHOST_DEL_RECOVERY, "deleted/recovery", },
61 };
62 const char *scsi_host_state_name(enum scsi_host_state state)
63 {
64 	int i;
65 	char *name = NULL;
66 
67 	for (i = 0; i < ARRAY_SIZE(shost_states); i++) {
68 		if (shost_states[i].value == state) {
69 			name = shost_states[i].name;
70 			break;
71 		}
72 	}
73 	return name;
74 }
75 
76 static int check_set(unsigned int *val, char *src)
77 {
78 	char *last;
79 
80 	if (strncmp(src, "-", 20) == 0) {
81 		*val = SCAN_WILD_CARD;
82 	} else {
83 		/*
84 		 * Doesn't check for int overflow
85 		 */
86 		*val = simple_strtoul(src, &last, 0);
87 		if (*last != '\0')
88 			return 1;
89 	}
90 	return 0;
91 }
92 
93 static int scsi_scan(struct Scsi_Host *shost, const char *str)
94 {
95 	char s1[15], s2[15], s3[15], junk;
96 	unsigned int channel, id, lun;
97 	int res;
98 
99 	res = sscanf(str, "%10s %10s %10s %c", s1, s2, s3, &junk);
100 	if (res != 3)
101 		return -EINVAL;
102 	if (check_set(&channel, s1))
103 		return -EINVAL;
104 	if (check_set(&id, s2))
105 		return -EINVAL;
106 	if (check_set(&lun, s3))
107 		return -EINVAL;
108 	if (shost->transportt->user_scan)
109 		res = shost->transportt->user_scan(shost, channel, id, lun);
110 	else
111 		res = scsi_scan_host_selected(shost, channel, id, lun, 1);
112 	return res;
113 }
114 
115 /*
116  * shost_show_function: macro to create an attr function that can be used to
117  * show a non-bit field.
118  */
119 #define shost_show_function(name, field, format_string)			\
120 static ssize_t								\
121 show_##name (struct class_device *class_dev, char *buf)			\
122 {									\
123 	struct Scsi_Host *shost = class_to_shost(class_dev);		\
124 	return snprintf (buf, 20, format_string, shost->field);		\
125 }
126 
127 /*
128  * shost_rd_attr: macro to create a function and attribute variable for a
129  * read only field.
130  */
131 #define shost_rd_attr2(name, field, format_string)			\
132 	shost_show_function(name, field, format_string)			\
133 static CLASS_DEVICE_ATTR(name, S_IRUGO, show_##name, NULL);
134 
135 #define shost_rd_attr(field, format_string) \
136 shost_rd_attr2(field, field, format_string)
137 
138 /*
139  * Create the actual show/store functions and data structures.
140  */
141 
142 static ssize_t store_scan(struct class_device *class_dev, const char *buf,
143 			  size_t count)
144 {
145 	struct Scsi_Host *shost = class_to_shost(class_dev);
146 	int res;
147 
148 	res = scsi_scan(shost, buf);
149 	if (res == 0)
150 		res = count;
151 	return res;
152 };
153 static CLASS_DEVICE_ATTR(scan, S_IWUSR, NULL, store_scan);
154 
155 static ssize_t
156 store_shost_state(struct class_device *class_dev, const char *buf, size_t count)
157 {
158 	int i;
159 	struct Scsi_Host *shost = class_to_shost(class_dev);
160 	enum scsi_host_state state = 0;
161 
162 	for (i = 0; i < ARRAY_SIZE(shost_states); i++) {
163 		const int len = strlen(shost_states[i].name);
164 		if (strncmp(shost_states[i].name, buf, len) == 0 &&
165 		   buf[len] == '\n') {
166 			state = shost_states[i].value;
167 			break;
168 		}
169 	}
170 	if (!state)
171 		return -EINVAL;
172 
173 	if (scsi_host_set_state(shost, state))
174 		return -EINVAL;
175 	return count;
176 }
177 
178 static ssize_t
179 show_shost_state(struct class_device *class_dev, char *buf)
180 {
181 	struct Scsi_Host *shost = class_to_shost(class_dev);
182 	const char *name = scsi_host_state_name(shost->shost_state);
183 
184 	if (!name)
185 		return -EINVAL;
186 
187 	return snprintf(buf, 20, "%s\n", name);
188 }
189 
190 static CLASS_DEVICE_ATTR(state, S_IRUGO | S_IWUSR, show_shost_state, store_shost_state);
191 
192 shost_rd_attr(unique_id, "%u\n");
193 shost_rd_attr(host_busy, "%hu\n");
194 shost_rd_attr(cmd_per_lun, "%hd\n");
195 shost_rd_attr(can_queue, "%hd\n");
196 shost_rd_attr(sg_tablesize, "%hu\n");
197 shost_rd_attr(unchecked_isa_dma, "%d\n");
198 shost_rd_attr2(proc_name, hostt->proc_name, "%s\n");
199 
200 static struct class_device_attribute *scsi_sysfs_shost_attrs[] = {
201 	&class_device_attr_unique_id,
202 	&class_device_attr_host_busy,
203 	&class_device_attr_cmd_per_lun,
204 	&class_device_attr_can_queue,
205 	&class_device_attr_sg_tablesize,
206 	&class_device_attr_unchecked_isa_dma,
207 	&class_device_attr_proc_name,
208 	&class_device_attr_scan,
209 	&class_device_attr_state,
210 	NULL
211 };
212 
213 static void scsi_device_cls_release(struct class_device *class_dev)
214 {
215 	struct scsi_device *sdev;
216 
217 	sdev = class_to_sdev(class_dev);
218 	put_device(&sdev->sdev_gendev);
219 }
220 
221 static void scsi_device_dev_release_usercontext(struct work_struct *work)
222 {
223 	struct scsi_device *sdev;
224 	struct device *parent;
225 	struct scsi_target *starget;
226 	unsigned long flags;
227 
228 	sdev = container_of(work, struct scsi_device, ew.work);
229 
230 	parent = sdev->sdev_gendev.parent;
231 	starget = to_scsi_target(parent);
232 
233 	spin_lock_irqsave(sdev->host->host_lock, flags);
234 	starget->reap_ref++;
235 	list_del(&sdev->siblings);
236 	list_del(&sdev->same_target_siblings);
237 	list_del(&sdev->starved_entry);
238 	spin_unlock_irqrestore(sdev->host->host_lock, flags);
239 
240 	if (sdev->request_queue) {
241 		sdev->request_queue->queuedata = NULL;
242 		/* user context needed to free queue */
243 		scsi_free_queue(sdev->request_queue);
244 		/* temporary expedient, try to catch use of queue lock
245 		 * after free of sdev */
246 		sdev->request_queue = NULL;
247 	}
248 
249 	scsi_target_reap(scsi_target(sdev));
250 
251 	kfree(sdev->inquiry);
252 	kfree(sdev);
253 
254 	if (parent)
255 		put_device(parent);
256 }
257 
258 static void scsi_device_dev_release(struct device *dev)
259 {
260 	struct scsi_device *sdp = to_scsi_device(dev);
261 	execute_in_process_context(scsi_device_dev_release_usercontext,
262 				   &sdp->ew);
263 }
264 
265 static struct class sdev_class = {
266 	.name		= "scsi_device",
267 	.release	= scsi_device_cls_release,
268 };
269 
270 /* all probing is done in the individual ->probe routines */
271 static int scsi_bus_match(struct device *dev, struct device_driver *gendrv)
272 {
273 	struct scsi_device *sdp = to_scsi_device(dev);
274 	if (sdp->no_uld_attach)
275 		return 0;
276 	return (sdp->inq_periph_qual == SCSI_INQ_PQ_CON)? 1: 0;
277 }
278 
279 static int scsi_bus_suspend(struct device * dev, pm_message_t state)
280 {
281 	struct scsi_device *sdev = to_scsi_device(dev);
282 	struct scsi_host_template *sht = sdev->host->hostt;
283 	int err;
284 
285 	err = scsi_device_quiesce(sdev);
286 	if (err)
287 		return err;
288 
289 	if (sht->suspend)
290 		err = sht->suspend(sdev, state);
291 
292 	return err;
293 }
294 
295 static int scsi_bus_resume(struct device * dev)
296 {
297 	struct scsi_device *sdev = to_scsi_device(dev);
298 	struct scsi_host_template *sht = sdev->host->hostt;
299 	int err = 0;
300 
301 	if (sht->resume)
302 		err = sht->resume(sdev);
303 
304 	scsi_device_resume(sdev);
305 	return err;
306 }
307 
308 struct bus_type scsi_bus_type = {
309         .name		= "scsi",
310         .match		= scsi_bus_match,
311 	.suspend	= scsi_bus_suspend,
312 	.resume		= scsi_bus_resume,
313 };
314 
315 int scsi_sysfs_register(void)
316 {
317 	int error;
318 
319 	error = bus_register(&scsi_bus_type);
320 	if (!error) {
321 		error = class_register(&sdev_class);
322 		if (error)
323 			bus_unregister(&scsi_bus_type);
324 	}
325 
326 	return error;
327 }
328 
329 void scsi_sysfs_unregister(void)
330 {
331 	class_unregister(&sdev_class);
332 	bus_unregister(&scsi_bus_type);
333 }
334 
335 /*
336  * sdev_show_function: macro to create an attr function that can be used to
337  * show a non-bit field.
338  */
339 #define sdev_show_function(field, format_string)				\
340 static ssize_t								\
341 sdev_show_##field (struct device *dev, struct device_attribute *attr, char *buf)				\
342 {									\
343 	struct scsi_device *sdev;					\
344 	sdev = to_scsi_device(dev);					\
345 	return snprintf (buf, 20, format_string, sdev->field);		\
346 }									\
347 
348 /*
349  * sdev_rd_attr: macro to create a function and attribute variable for a
350  * read only field.
351  */
352 #define sdev_rd_attr(field, format_string)				\
353 	sdev_show_function(field, format_string)			\
354 static DEVICE_ATTR(field, S_IRUGO, sdev_show_##field, NULL);
355 
356 
357 /*
358  * sdev_rd_attr: create a function and attribute variable for a
359  * read/write field.
360  */
361 #define sdev_rw_attr(field, format_string)				\
362 	sdev_show_function(field, format_string)				\
363 									\
364 static ssize_t								\
365 sdev_store_##field (struct device *dev, struct device_attribute *attr, const char *buf, size_t count)	\
366 {									\
367 	struct scsi_device *sdev;					\
368 	sdev = to_scsi_device(dev);					\
369 	snscanf (buf, 20, format_string, &sdev->field);			\
370 	return count;							\
371 }									\
372 static DEVICE_ATTR(field, S_IRUGO | S_IWUSR, sdev_show_##field, sdev_store_##field);
373 
374 /* Currently we don't export bit fields, but we might in future,
375  * so leave this code in */
376 #if 0
377 /*
378  * sdev_rd_attr: create a function and attribute variable for a
379  * read/write bit field.
380  */
381 #define sdev_rw_attr_bit(field)						\
382 	sdev_show_function(field, "%d\n")					\
383 									\
384 static ssize_t								\
385 sdev_store_##field (struct device *dev, struct device_attribute *attr, const char *buf, size_t count)	\
386 {									\
387 	int ret;							\
388 	struct scsi_device *sdev;					\
389 	ret = scsi_sdev_check_buf_bit(buf);				\
390 	if (ret >= 0)	{						\
391 		sdev = to_scsi_device(dev);				\
392 		sdev->field = ret;					\
393 		ret = count;						\
394 	}								\
395 	return ret;							\
396 }									\
397 static DEVICE_ATTR(field, S_IRUGO | S_IWUSR, sdev_show_##field, sdev_store_##field);
398 
399 /*
400  * scsi_sdev_check_buf_bit: return 0 if buf is "0", return 1 if buf is "1",
401  * else return -EINVAL.
402  */
403 static int scsi_sdev_check_buf_bit(const char *buf)
404 {
405 	if ((buf[1] == '\0') || ((buf[1] == '\n') && (buf[2] == '\0'))) {
406 		if (buf[0] == '1')
407 			return 1;
408 		else if (buf[0] == '0')
409 			return 0;
410 		else
411 			return -EINVAL;
412 	} else
413 		return -EINVAL;
414 }
415 #endif
416 /*
417  * Create the actual show/store functions and data structures.
418  */
419 sdev_rd_attr (device_blocked, "%d\n");
420 sdev_rd_attr (queue_depth, "%d\n");
421 sdev_rd_attr (type, "%d\n");
422 sdev_rd_attr (scsi_level, "%d\n");
423 sdev_rd_attr (vendor, "%.8s\n");
424 sdev_rd_attr (model, "%.16s\n");
425 sdev_rd_attr (rev, "%.4s\n");
426 
427 static ssize_t
428 sdev_show_timeout (struct device *dev, struct device_attribute *attr, char *buf)
429 {
430 	struct scsi_device *sdev;
431 	sdev = to_scsi_device(dev);
432 	return snprintf (buf, 20, "%d\n", sdev->timeout / HZ);
433 }
434 
435 static ssize_t
436 sdev_store_timeout (struct device *dev, struct device_attribute *attr, const char *buf, size_t count)
437 {
438 	struct scsi_device *sdev;
439 	int timeout;
440 	sdev = to_scsi_device(dev);
441 	sscanf (buf, "%d\n", &timeout);
442 	sdev->timeout = timeout * HZ;
443 	return count;
444 }
445 static DEVICE_ATTR(timeout, S_IRUGO | S_IWUSR, sdev_show_timeout, sdev_store_timeout);
446 
447 static ssize_t
448 store_rescan_field (struct device *dev, struct device_attribute *attr, const char *buf, size_t count)
449 {
450 	scsi_rescan_device(dev);
451 	return count;
452 }
453 static DEVICE_ATTR(rescan, S_IWUSR, NULL, store_rescan_field);
454 
455 static void sdev_store_delete_callback(struct device *dev)
456 {
457 	scsi_remove_device(to_scsi_device(dev));
458 }
459 
460 static ssize_t sdev_store_delete(struct device *dev, struct device_attribute *attr, const char *buf,
461 				 size_t count)
462 {
463 	int rc;
464 
465 	/* An attribute cannot be unregistered by one of its own methods,
466 	 * so we have to use this roundabout approach.
467 	 */
468 	rc = device_schedule_callback(dev, sdev_store_delete_callback);
469 	if (rc)
470 		count = rc;
471 	return count;
472 };
473 static DEVICE_ATTR(delete, S_IWUSR, NULL, sdev_store_delete);
474 
475 static ssize_t
476 store_state_field(struct device *dev, struct device_attribute *attr, const char *buf, size_t count)
477 {
478 	int i;
479 	struct scsi_device *sdev = to_scsi_device(dev);
480 	enum scsi_device_state state = 0;
481 
482 	for (i = 0; i < ARRAY_SIZE(sdev_states); i++) {
483 		const int len = strlen(sdev_states[i].name);
484 		if (strncmp(sdev_states[i].name, buf, len) == 0 &&
485 		   buf[len] == '\n') {
486 			state = sdev_states[i].value;
487 			break;
488 		}
489 	}
490 	if (!state)
491 		return -EINVAL;
492 
493 	if (scsi_device_set_state(sdev, state))
494 		return -EINVAL;
495 	return count;
496 }
497 
498 static ssize_t
499 show_state_field(struct device *dev, struct device_attribute *attr, char *buf)
500 {
501 	struct scsi_device *sdev = to_scsi_device(dev);
502 	const char *name = scsi_device_state_name(sdev->sdev_state);
503 
504 	if (!name)
505 		return -EINVAL;
506 
507 	return snprintf(buf, 20, "%s\n", name);
508 }
509 
510 static DEVICE_ATTR(state, S_IRUGO | S_IWUSR, show_state_field, store_state_field);
511 
512 static ssize_t
513 show_queue_type_field(struct device *dev, struct device_attribute *attr, char *buf)
514 {
515 	struct scsi_device *sdev = to_scsi_device(dev);
516 	const char *name = "none";
517 
518 	if (sdev->ordered_tags)
519 		name = "ordered";
520 	else if (sdev->simple_tags)
521 		name = "simple";
522 
523 	return snprintf(buf, 20, "%s\n", name);
524 }
525 
526 static DEVICE_ATTR(queue_type, S_IRUGO, show_queue_type_field, NULL);
527 
528 static ssize_t
529 show_iostat_counterbits(struct device *dev, struct device_attribute *attr, char *buf)
530 {
531 	return snprintf(buf, 20, "%d\n", (int)sizeof(atomic_t) * 8);
532 }
533 
534 static DEVICE_ATTR(iocounterbits, S_IRUGO, show_iostat_counterbits, NULL);
535 
536 #define show_sdev_iostat(field)						\
537 static ssize_t								\
538 show_iostat_##field(struct device *dev, struct device_attribute *attr, char *buf)			\
539 {									\
540 	struct scsi_device *sdev = to_scsi_device(dev);			\
541 	unsigned long long count = atomic_read(&sdev->field);		\
542 	return snprintf(buf, 20, "0x%llx\n", count);			\
543 }									\
544 static DEVICE_ATTR(field, S_IRUGO, show_iostat_##field, NULL)
545 
546 show_sdev_iostat(iorequest_cnt);
547 show_sdev_iostat(iodone_cnt);
548 show_sdev_iostat(ioerr_cnt);
549 
550 
551 /* Default template for device attributes.  May NOT be modified */
552 static struct device_attribute *scsi_sysfs_sdev_attrs[] = {
553 	&dev_attr_device_blocked,
554 	&dev_attr_queue_depth,
555 	&dev_attr_queue_type,
556 	&dev_attr_type,
557 	&dev_attr_scsi_level,
558 	&dev_attr_vendor,
559 	&dev_attr_model,
560 	&dev_attr_rev,
561 	&dev_attr_rescan,
562 	&dev_attr_delete,
563 	&dev_attr_state,
564 	&dev_attr_timeout,
565 	&dev_attr_iocounterbits,
566 	&dev_attr_iorequest_cnt,
567 	&dev_attr_iodone_cnt,
568 	&dev_attr_ioerr_cnt,
569 	NULL
570 };
571 
572 static ssize_t sdev_store_queue_depth_rw(struct device *dev, struct device_attribute *attr, const char *buf,
573 					 size_t count)
574 {
575 	int depth, retval;
576 	struct scsi_device *sdev = to_scsi_device(dev);
577 	struct scsi_host_template *sht = sdev->host->hostt;
578 
579 	if (!sht->change_queue_depth)
580 		return -EINVAL;
581 
582 	depth = simple_strtoul(buf, NULL, 0);
583 
584 	if (depth < 1)
585 		return -EINVAL;
586 
587 	retval = sht->change_queue_depth(sdev, depth);
588 	if (retval < 0)
589 		return retval;
590 
591 	return count;
592 }
593 
594 static struct device_attribute sdev_attr_queue_depth_rw =
595 	__ATTR(queue_depth, S_IRUGO | S_IWUSR, sdev_show_queue_depth,
596 	       sdev_store_queue_depth_rw);
597 
598 static ssize_t sdev_store_queue_type_rw(struct device *dev, struct device_attribute *attr, const char *buf,
599 					size_t count)
600 {
601 	struct scsi_device *sdev = to_scsi_device(dev);
602 	struct scsi_host_template *sht = sdev->host->hostt;
603 	int tag_type = 0, retval;
604 	int prev_tag_type = scsi_get_tag_type(sdev);
605 
606 	if (!sdev->tagged_supported || !sht->change_queue_type)
607 		return -EINVAL;
608 
609 	if (strncmp(buf, "ordered", 7) == 0)
610 		tag_type = MSG_ORDERED_TAG;
611 	else if (strncmp(buf, "simple", 6) == 0)
612 		tag_type = MSG_SIMPLE_TAG;
613 	else if (strncmp(buf, "none", 4) != 0)
614 		return -EINVAL;
615 
616 	if (tag_type == prev_tag_type)
617 		return count;
618 
619 	retval = sht->change_queue_type(sdev, tag_type);
620 	if (retval < 0)
621 		return retval;
622 
623 	return count;
624 }
625 
626 static struct device_attribute sdev_attr_queue_type_rw =
627 	__ATTR(queue_type, S_IRUGO | S_IWUSR, show_queue_type_field,
628 	       sdev_store_queue_type_rw);
629 
630 static struct device_attribute *attr_changed_internally(
631 		struct Scsi_Host *shost,
632 		struct device_attribute * attr)
633 {
634 	if (!strcmp("queue_depth", attr->attr.name)
635 	    && shost->hostt->change_queue_depth)
636 		return &sdev_attr_queue_depth_rw;
637 	else if (!strcmp("queue_type", attr->attr.name)
638 	    && shost->hostt->change_queue_type)
639 		return &sdev_attr_queue_type_rw;
640 	return attr;
641 }
642 
643 
644 static struct device_attribute *attr_overridden(
645 		struct device_attribute **attrs,
646 		struct device_attribute *attr)
647 {
648 	int i;
649 
650 	if (!attrs)
651 		return NULL;
652 	for (i = 0; attrs[i]; i++)
653 		if (!strcmp(attrs[i]->attr.name, attr->attr.name))
654 			return attrs[i];
655 	return NULL;
656 }
657 
658 static int attr_add(struct device *dev, struct device_attribute *attr)
659 {
660 	struct device_attribute *base_attr;
661 
662 	/*
663 	 * Spare the caller from having to copy things it's not interested in.
664 	 */
665 	base_attr = attr_overridden(scsi_sysfs_sdev_attrs, attr);
666 	if (base_attr) {
667 		/* extend permissions */
668 		attr->attr.mode |= base_attr->attr.mode;
669 
670 		/* override null show/store with default */
671 		if (!attr->show)
672 			attr->show = base_attr->show;
673 		if (!attr->store)
674 			attr->store = base_attr->store;
675 	}
676 
677 	return device_create_file(dev, attr);
678 }
679 
680 /**
681  * scsi_sysfs_add_sdev - add scsi device to sysfs
682  * @sdev:	scsi_device to add
683  *
684  * Return value:
685  * 	0 on Success / non-zero on Failure
686  **/
687 int scsi_sysfs_add_sdev(struct scsi_device *sdev)
688 {
689 	int error, i;
690 
691 	if ((error = scsi_device_set_state(sdev, SDEV_RUNNING)) != 0)
692 		return error;
693 
694 	error = device_add(&sdev->sdev_gendev);
695 	if (error) {
696 		put_device(sdev->sdev_gendev.parent);
697 		printk(KERN_INFO "error 1\n");
698 		return error;
699 	}
700 	error = class_device_add(&sdev->sdev_classdev);
701 	if (error) {
702 		printk(KERN_INFO "error 2\n");
703 		goto clean_device;
704 	}
705 
706 	/* take a reference for the sdev_classdev; this is
707 	 * released by the sdev_class .release */
708 	get_device(&sdev->sdev_gendev);
709 	if (sdev->host->hostt->sdev_attrs) {
710 		for (i = 0; sdev->host->hostt->sdev_attrs[i]; i++) {
711 			error = attr_add(&sdev->sdev_gendev,
712 					sdev->host->hostt->sdev_attrs[i]);
713 			if (error) {
714 				__scsi_remove_device(sdev);
715 				goto out;
716 			}
717 		}
718 	}
719 
720 	for (i = 0; scsi_sysfs_sdev_attrs[i]; i++) {
721 		if (!attr_overridden(sdev->host->hostt->sdev_attrs,
722 					scsi_sysfs_sdev_attrs[i])) {
723 			struct device_attribute * attr =
724 				attr_changed_internally(sdev->host,
725 							scsi_sysfs_sdev_attrs[i]);
726 			error = device_create_file(&sdev->sdev_gendev, attr);
727 			if (error) {
728 				__scsi_remove_device(sdev);
729 				goto out;
730 			}
731 		}
732 	}
733 
734 	transport_add_device(&sdev->sdev_gendev);
735  out:
736 	return error;
737 
738  clean_device:
739 	scsi_device_set_state(sdev, SDEV_CANCEL);
740 
741 	device_del(&sdev->sdev_gendev);
742 	transport_destroy_device(&sdev->sdev_gendev);
743 	put_device(&sdev->sdev_gendev);
744 
745 	return error;
746 }
747 
748 void __scsi_remove_device(struct scsi_device *sdev)
749 {
750 	struct device *dev = &sdev->sdev_gendev;
751 
752 	if (scsi_device_set_state(sdev, SDEV_CANCEL) != 0)
753 		return;
754 
755 	class_device_unregister(&sdev->sdev_classdev);
756 	transport_remove_device(dev);
757 	device_del(dev);
758 	scsi_device_set_state(sdev, SDEV_DEL);
759 	if (sdev->host->hostt->slave_destroy)
760 		sdev->host->hostt->slave_destroy(sdev);
761 	transport_destroy_device(dev);
762 	put_device(dev);
763 }
764 
765 /**
766  * scsi_remove_device - unregister a device from the scsi bus
767  * @sdev:	scsi_device to unregister
768  **/
769 void scsi_remove_device(struct scsi_device *sdev)
770 {
771 	struct Scsi_Host *shost = sdev->host;
772 
773 	mutex_lock(&shost->scan_mutex);
774 	__scsi_remove_device(sdev);
775 	mutex_unlock(&shost->scan_mutex);
776 }
777 EXPORT_SYMBOL(scsi_remove_device);
778 
779 void __scsi_remove_target(struct scsi_target *starget)
780 {
781 	struct Scsi_Host *shost = dev_to_shost(starget->dev.parent);
782 	unsigned long flags;
783 	struct scsi_device *sdev;
784 
785 	spin_lock_irqsave(shost->host_lock, flags);
786 	starget->reap_ref++;
787  restart:
788 	list_for_each_entry(sdev, &shost->__devices, siblings) {
789 		if (sdev->channel != starget->channel ||
790 		    sdev->id != starget->id ||
791 		    sdev->sdev_state == SDEV_DEL)
792 			continue;
793 		spin_unlock_irqrestore(shost->host_lock, flags);
794 		scsi_remove_device(sdev);
795 		spin_lock_irqsave(shost->host_lock, flags);
796 		goto restart;
797 	}
798 	spin_unlock_irqrestore(shost->host_lock, flags);
799 	scsi_target_reap(starget);
800 }
801 
802 static int __remove_child (struct device * dev, void * data)
803 {
804 	if (scsi_is_target_device(dev))
805 		__scsi_remove_target(to_scsi_target(dev));
806 	return 0;
807 }
808 
809 /**
810  * scsi_remove_target - try to remove a target and all its devices
811  * @dev: generic starget or parent of generic stargets to be removed
812  *
813  * Note: This is slightly racy.  It is possible that if the user
814  * requests the addition of another device then the target won't be
815  * removed.
816  */
817 void scsi_remove_target(struct device *dev)
818 {
819 	struct device *rdev;
820 
821 	if (scsi_is_target_device(dev)) {
822 		__scsi_remove_target(to_scsi_target(dev));
823 		return;
824 	}
825 
826 	rdev = get_device(dev);
827 	device_for_each_child(dev, NULL, __remove_child);
828 	put_device(rdev);
829 }
830 EXPORT_SYMBOL(scsi_remove_target);
831 
832 int scsi_register_driver(struct device_driver *drv)
833 {
834 	drv->bus = &scsi_bus_type;
835 
836 	return driver_register(drv);
837 }
838 EXPORT_SYMBOL(scsi_register_driver);
839 
840 int scsi_register_interface(struct class_interface *intf)
841 {
842 	intf->class = &sdev_class;
843 
844 	return class_interface_register(intf);
845 }
846 EXPORT_SYMBOL(scsi_register_interface);
847 
848 
849 static struct class_device_attribute *class_attr_overridden(
850 		struct class_device_attribute **attrs,
851 		struct class_device_attribute *attr)
852 {
853 	int i;
854 
855 	if (!attrs)
856 		return NULL;
857 	for (i = 0; attrs[i]; i++)
858 		if (!strcmp(attrs[i]->attr.name, attr->attr.name))
859 			return attrs[i];
860 	return NULL;
861 }
862 
863 static int class_attr_add(struct class_device *classdev,
864 		struct class_device_attribute *attr)
865 {
866 	struct class_device_attribute *base_attr;
867 
868 	/*
869 	 * Spare the caller from having to copy things it's not interested in.
870 	 */
871 	base_attr = class_attr_overridden(scsi_sysfs_shost_attrs, attr);
872 	if (base_attr) {
873 		/* extend permissions */
874 		attr->attr.mode |= base_attr->attr.mode;
875 
876 		/* override null show/store with default */
877 		if (!attr->show)
878 			attr->show = base_attr->show;
879 		if (!attr->store)
880 			attr->store = base_attr->store;
881 	}
882 
883 	return class_device_create_file(classdev, attr);
884 }
885 
886 /**
887  * scsi_sysfs_add_host - add scsi host to subsystem
888  * @shost:     scsi host struct to add to subsystem
889  * @dev:       parent struct device pointer
890  **/
891 int scsi_sysfs_add_host(struct Scsi_Host *shost)
892 {
893 	int error, i;
894 
895 	if (shost->hostt->shost_attrs) {
896 		for (i = 0; shost->hostt->shost_attrs[i]; i++) {
897 			error = class_attr_add(&shost->shost_classdev,
898 					shost->hostt->shost_attrs[i]);
899 			if (error)
900 				return error;
901 		}
902 	}
903 
904 	for (i = 0; scsi_sysfs_shost_attrs[i]; i++) {
905 		if (!class_attr_overridden(shost->hostt->shost_attrs,
906 					scsi_sysfs_shost_attrs[i])) {
907 			error = class_device_create_file(&shost->shost_classdev,
908 					scsi_sysfs_shost_attrs[i]);
909 			if (error)
910 				return error;
911 		}
912 	}
913 
914 	transport_register_device(&shost->shost_gendev);
915 	return 0;
916 }
917 
918 void scsi_sysfs_device_initialize(struct scsi_device *sdev)
919 {
920 	unsigned long flags;
921 	struct Scsi_Host *shost = sdev->host;
922 	struct scsi_target  *starget = sdev->sdev_target;
923 
924 	device_initialize(&sdev->sdev_gendev);
925 	sdev->sdev_gendev.bus = &scsi_bus_type;
926 	sdev->sdev_gendev.release = scsi_device_dev_release;
927 	sprintf(sdev->sdev_gendev.bus_id,"%d:%d:%d:%d",
928 		sdev->host->host_no, sdev->channel, sdev->id,
929 		sdev->lun);
930 
931 	class_device_initialize(&sdev->sdev_classdev);
932 	sdev->sdev_classdev.dev = &sdev->sdev_gendev;
933 	sdev->sdev_classdev.class = &sdev_class;
934 	snprintf(sdev->sdev_classdev.class_id, BUS_ID_SIZE,
935 		 "%d:%d:%d:%d", sdev->host->host_no,
936 		 sdev->channel, sdev->id, sdev->lun);
937 	sdev->scsi_level = starget->scsi_level;
938 	transport_setup_device(&sdev->sdev_gendev);
939 	spin_lock_irqsave(shost->host_lock, flags);
940 	list_add_tail(&sdev->same_target_siblings, &starget->devices);
941 	list_add_tail(&sdev->siblings, &shost->__devices);
942 	spin_unlock_irqrestore(shost->host_lock, flags);
943 }
944 
945 int scsi_is_sdev_device(const struct device *dev)
946 {
947 	return dev->release == scsi_device_dev_release;
948 }
949 EXPORT_SYMBOL(scsi_is_sdev_device);
950 
951 /* A blank transport template that is used in drivers that don't
952  * yet implement Transport Attributes */
953 struct scsi_transport_template blank_transport_template = { { { {NULL, }, }, }, };
954