xref: /linux/drivers/scsi/scsi_transport_sas.c (revision 54a8a2220c936a47840c9a3d74910c5a56fae2ed)
1 /*
2  * Copyright (C) 2005 Dell Inc.
3  *	Released under GPL v2.
4  *
5  * Serial Attached SCSI (SAS) transport class.
6  *
7  * The SAS transport class contains common code to deal with SAS HBAs,
8  * an aproximated representation of SAS topologies in the driver model,
9  * and various sysfs attributes to expose these topologies and managment
10  * interfaces to userspace.
11  *
12  * In addition to the basic SCSI core objects this transport class
13  * introduces two additional intermediate objects:  The SAS PHY
14  * as represented by struct sas_phy defines an "outgoing" PHY on
15  * a SAS HBA or Expander, and the SAS remote PHY represented by
16  * struct sas_rphy defines an "incoming" PHY on a SAS Expander or
17  * end device.  Note that this is purely a software concept, the
18  * underlying hardware for a PHY and a remote PHY is the exactly
19  * the same.
20  *
21  * There is no concept of a SAS port in this code, users can see
22  * what PHYs form a wide port based on the port_identifier attribute,
23  * which is the same for all PHYs in a port.
24  */
25 
26 #include <linux/init.h>
27 #include <linux/module.h>
28 #include <linux/err.h>
29 
30 #include <scsi/scsi_device.h>
31 #include <scsi/scsi_host.h>
32 #include <scsi/scsi_transport.h>
33 #include <scsi/scsi_transport_sas.h>
34 
35 
36 #define SAS_HOST_ATTRS		0
37 #define SAS_PORT_ATTRS		11
38 #define SAS_RPORT_ATTRS		5
39 
40 struct sas_internal {
41 	struct scsi_transport_template t;
42 	struct sas_function_template *f;
43 
44 	struct class_device_attribute private_host_attrs[SAS_HOST_ATTRS];
45 	struct class_device_attribute private_phy_attrs[SAS_PORT_ATTRS];
46 	struct class_device_attribute private_rphy_attrs[SAS_RPORT_ATTRS];
47 
48 	struct transport_container phy_attr_cont;
49 	struct transport_container rphy_attr_cont;
50 
51 	/*
52 	 * The array of null terminated pointers to attributes
53 	 * needed by scsi_sysfs.c
54 	 */
55 	struct class_device_attribute *host_attrs[SAS_HOST_ATTRS + 1];
56 	struct class_device_attribute *phy_attrs[SAS_PORT_ATTRS + 1];
57 	struct class_device_attribute *rphy_attrs[SAS_RPORT_ATTRS + 1];
58 };
59 #define to_sas_internal(tmpl)	container_of(tmpl, struct sas_internal, t)
60 
61 struct sas_host_attrs {
62 	struct list_head rphy_list;
63 	spinlock_t lock;
64 	u32 next_target_id;
65 };
66 #define to_sas_host_attrs(host)	((struct sas_host_attrs *)(host)->shost_data)
67 
68 
69 /*
70  * Hack to allow attributes of the same name in different objects.
71  */
72 #define SAS_CLASS_DEVICE_ATTR(_prefix,_name,_mode,_show,_store) \
73 	struct class_device_attribute class_device_attr_##_prefix##_##_name = \
74 	__ATTR(_name,_mode,_show,_store)
75 
76 
77 /*
78  * Pretty printing helpers
79  */
80 
81 #define sas_bitfield_name_match(title, table)			\
82 static ssize_t							\
83 get_sas_##title##_names(u32 table_key, char *buf)		\
84 {								\
85 	char *prefix = "";					\
86 	ssize_t len = 0;					\
87 	int i;							\
88 								\
89 	for (i = 0; i < sizeof(table)/sizeof(table[0]); i++) {	\
90 		if (table[i].value & table_key) {		\
91 			len += sprintf(buf + len, "%s%s",	\
92 				prefix, table[i].name);		\
93 			prefix = ", ";				\
94 		}						\
95 	}							\
96 	len += sprintf(buf + len, "\n");			\
97 	return len;						\
98 }
99 
100 #define sas_bitfield_name_search(title, table)			\
101 static ssize_t							\
102 get_sas_##title##_names(u32 table_key, char *buf)		\
103 {								\
104 	ssize_t len = 0;					\
105 	int i;							\
106 								\
107 	for (i = 0; i < sizeof(table)/sizeof(table[0]); i++) {	\
108 		if (table[i].value == table_key) {		\
109 			len += sprintf(buf + len, "%s",		\
110 				table[i].name);			\
111 			break;					\
112 		}						\
113 	}							\
114 	len += sprintf(buf + len, "\n");			\
115 	return len;						\
116 }
117 
118 static struct {
119 	u32		value;
120 	char		*name;
121 } sas_device_type_names[] = {
122 	{ SAS_PHY_UNUSED,		"unused" },
123 	{ SAS_END_DEVICE,		"end device" },
124 	{ SAS_EDGE_EXPANDER_DEVICE,	"edge expander" },
125 	{ SAS_FANOUT_EXPANDER_DEVICE,	"fanout expander" },
126 };
127 sas_bitfield_name_search(device_type, sas_device_type_names)
128 
129 
130 static struct {
131 	u32		value;
132 	char		*name;
133 } sas_protocol_names[] = {
134 	{ SAS_PROTOCOL_SATA,		"sata" },
135 	{ SAS_PROTOCOL_SMP,		"smp" },
136 	{ SAS_PROTOCOL_STP,		"stp" },
137 	{ SAS_PROTOCOL_SSP,		"ssp" },
138 };
139 sas_bitfield_name_match(protocol, sas_protocol_names)
140 
141 static struct {
142 	u32		value;
143 	char		*name;
144 } sas_linkspeed_names[] = {
145 	{ SAS_LINK_RATE_UNKNOWN,	"Unknown" },
146 	{ SAS_PHY_DISABLED,		"Phy disabled" },
147 	{ SAS_LINK_RATE_FAILED,		"Link Rate failed" },
148 	{ SAS_SATA_SPINUP_HOLD,		"Spin-up hold" },
149 	{ SAS_LINK_RATE_1_5_GBPS,	"1.5 Gbit" },
150 	{ SAS_LINK_RATE_3_0_GBPS,	"3.0 Gbit" },
151 };
152 sas_bitfield_name_search(linkspeed, sas_linkspeed_names)
153 
154 
155 /*
156  * SAS host attributes
157  */
158 
159 static int sas_host_setup(struct transport_container *tc, struct device *dev,
160 			  struct class_device *cdev)
161 {
162 	struct Scsi_Host *shost = dev_to_shost(dev);
163 	struct sas_host_attrs *sas_host = to_sas_host_attrs(shost);
164 
165 	INIT_LIST_HEAD(&sas_host->rphy_list);
166 	spin_lock_init(&sas_host->lock);
167 	sas_host->next_target_id = 0;
168 	return 0;
169 }
170 
171 static DECLARE_TRANSPORT_CLASS(sas_host_class,
172 		"sas_host", sas_host_setup, NULL, NULL);
173 
174 static int sas_host_match(struct attribute_container *cont,
175 			    struct device *dev)
176 {
177 	struct Scsi_Host *shost;
178 	struct sas_internal *i;
179 
180 	if (!scsi_is_host_device(dev))
181 		return 0;
182 	shost = dev_to_shost(dev);
183 
184 	if (!shost->transportt)
185 		return 0;
186 	if (shost->transportt->host_attrs.ac.class !=
187 			&sas_host_class.class)
188 		return 0;
189 
190 	i = to_sas_internal(shost->transportt);
191 	return &i->t.host_attrs.ac == cont;
192 }
193 
194 static int do_sas_phy_delete(struct device *dev, void *data)
195 {
196 	if (scsi_is_sas_phy(dev))
197 		sas_phy_delete(dev_to_phy(dev));
198 	return 0;
199 }
200 
201 /**
202  * sas_remove_host  --  tear down a Scsi_Host's SAS data structures
203  * @shost:	Scsi Host that is torn down
204  *
205  * Removes all SAS PHYs and remote PHYs for a given Scsi_Host.
206  * Must be called just before scsi_remove_host for SAS HBAs.
207  */
208 void sas_remove_host(struct Scsi_Host *shost)
209 {
210 	device_for_each_child(&shost->shost_gendev, NULL, do_sas_phy_delete);
211 }
212 EXPORT_SYMBOL(sas_remove_host);
213 
214 
215 /*
216  * SAS Port attributes
217  */
218 
219 #define sas_phy_show_simple(field, name, format_string, cast)		\
220 static ssize_t								\
221 show_sas_phy_##name(struct class_device *cdev, char *buf)		\
222 {									\
223 	struct sas_phy *phy = transport_class_to_phy(cdev);		\
224 									\
225 	return snprintf(buf, 20, format_string, cast phy->field);	\
226 }
227 
228 #define sas_phy_simple_attr(field, name, format_string, type)		\
229 	sas_phy_show_simple(field, name, format_string, (type))	\
230 static CLASS_DEVICE_ATTR(name, S_IRUGO, show_sas_phy_##name, NULL)
231 
232 #define sas_phy_show_protocol(field, name)				\
233 static ssize_t								\
234 show_sas_phy_##name(struct class_device *cdev, char *buf)		\
235 {									\
236 	struct sas_phy *phy = transport_class_to_phy(cdev);		\
237 									\
238 	if (!phy->field)						\
239 		return snprintf(buf, 20, "none\n");			\
240 	return get_sas_protocol_names(phy->field, buf);		\
241 }
242 
243 #define sas_phy_protocol_attr(field, name)				\
244 	sas_phy_show_protocol(field, name)				\
245 static CLASS_DEVICE_ATTR(name, S_IRUGO, show_sas_phy_##name, NULL)
246 
247 #define sas_phy_show_linkspeed(field)					\
248 static ssize_t								\
249 show_sas_phy_##field(struct class_device *cdev, char *buf)		\
250 {									\
251 	struct sas_phy *phy = transport_class_to_phy(cdev);		\
252 									\
253 	return get_sas_linkspeed_names(phy->field, buf);		\
254 }
255 
256 #define sas_phy_linkspeed_attr(field)					\
257 	sas_phy_show_linkspeed(field)					\
258 static CLASS_DEVICE_ATTR(field, S_IRUGO, show_sas_phy_##field, NULL)
259 
260 static ssize_t
261 show_sas_device_type(struct class_device *cdev, char *buf)
262 {
263 	struct sas_phy *phy = transport_class_to_phy(cdev);
264 
265 	if (!phy->identify.device_type)
266 		return snprintf(buf, 20, "none\n");
267 	return get_sas_device_type_names(phy->identify.device_type, buf);
268 }
269 
270 static CLASS_DEVICE_ATTR(device_type, S_IRUGO, show_sas_device_type, NULL);
271 
272 sas_phy_protocol_attr(identify.initiator_port_protocols,
273 		initiator_port_protocols);
274 sas_phy_protocol_attr(identify.target_port_protocols,
275 		target_port_protocols);
276 sas_phy_simple_attr(identify.sas_address, sas_address, "0x%016llx\n",
277 		unsigned long long);
278 sas_phy_simple_attr(identify.phy_identifier, phy_identifier, "%d\n", u8);
279 sas_phy_simple_attr(port_identifier, port_identifier, "%d\n", u8);
280 sas_phy_linkspeed_attr(negotiated_linkrate);
281 sas_phy_linkspeed_attr(minimum_linkrate_hw);
282 sas_phy_linkspeed_attr(minimum_linkrate);
283 sas_phy_linkspeed_attr(maximum_linkrate_hw);
284 sas_phy_linkspeed_attr(maximum_linkrate);
285 
286 
287 static DECLARE_TRANSPORT_CLASS(sas_phy_class,
288 		"sas_phy", NULL, NULL, NULL);
289 
290 static int sas_phy_match(struct attribute_container *cont, struct device *dev)
291 {
292 	struct Scsi_Host *shost;
293 	struct sas_internal *i;
294 
295 	if (!scsi_is_sas_phy(dev))
296 		return 0;
297 	shost = dev_to_shost(dev->parent);
298 
299 	if (!shost->transportt)
300 		return 0;
301 	if (shost->transportt->host_attrs.ac.class !=
302 			&sas_host_class.class)
303 		return 0;
304 
305 	i = to_sas_internal(shost->transportt);
306 	return &i->phy_attr_cont.ac == cont;
307 }
308 
309 static void sas_phy_release(struct device *dev)
310 {
311 	struct sas_phy *phy = dev_to_phy(dev);
312 
313 	put_device(dev->parent);
314 	kfree(phy);
315 }
316 
317 /**
318  * sas_phy_alloc  --  allocates and initialize a SAS PHY structure
319  * @parent:	Parent device
320  * @number:	Port number
321  *
322  * Allocates an SAS PHY structure.  It will be added in the device tree
323  * below the device specified by @parent, which has to be either a Scsi_Host
324  * or sas_rphy.
325  *
326  * Returns:
327  *	SAS PHY allocated or %NULL if the allocation failed.
328  */
329 struct sas_phy *sas_phy_alloc(struct device *parent, int number)
330 {
331 	struct Scsi_Host *shost = dev_to_shost(parent);
332 	struct sas_phy *phy;
333 
334 	phy = kmalloc(sizeof(*phy), GFP_KERNEL);
335 	if (!phy)
336 		return NULL;
337 	memset(phy, 0, sizeof(*phy));
338 
339 	get_device(parent);
340 
341 	phy->number = number;
342 
343 	device_initialize(&phy->dev);
344 	phy->dev.parent = get_device(parent);
345 	phy->dev.release = sas_phy_release;
346 	sprintf(phy->dev.bus_id, "phy-%d:%d", shost->host_no, number);
347 
348 	transport_setup_device(&phy->dev);
349 
350 	return phy;
351 }
352 EXPORT_SYMBOL(sas_phy_alloc);
353 
354 /**
355  * sas_phy_add  --  add a SAS PHY to the device hierachy
356  * @phy:	The PHY to be added
357  *
358  * Publishes a SAS PHY to the rest of the system.
359  */
360 int sas_phy_add(struct sas_phy *phy)
361 {
362 	int error;
363 
364 	error = device_add(&phy->dev);
365 	if (!error) {
366 		transport_add_device(&phy->dev);
367 		transport_configure_device(&phy->dev);
368 	}
369 
370 	return error;
371 }
372 EXPORT_SYMBOL(sas_phy_add);
373 
374 /**
375  * sas_phy_free  --  free a SAS PHY
376  * @phy:	SAS PHY to free
377  *
378  * Frees the specified SAS PHY.
379  *
380  * Note:
381  *   This function must only be called on a PHY that has not
382  *   sucessfully been added using sas_phy_add().
383  */
384 void sas_phy_free(struct sas_phy *phy)
385 {
386 	transport_destroy_device(&phy->dev);
387 	put_device(phy->dev.parent);
388 	put_device(phy->dev.parent);
389 	put_device(phy->dev.parent);
390 	kfree(phy);
391 }
392 EXPORT_SYMBOL(sas_phy_free);
393 
394 /**
395  * sas_phy_delete  --  remove SAS PHY
396  * @phy:	SAS PHY to remove
397  *
398  * Removes the specified SAS PHY.  If the SAS PHY has an
399  * associated remote PHY it is removed before.
400  */
401 void
402 sas_phy_delete(struct sas_phy *phy)
403 {
404 	struct device *dev = &phy->dev;
405 
406 	if (phy->rphy)
407 		sas_rphy_delete(phy->rphy);
408 
409 	transport_remove_device(dev);
410 	device_del(dev);
411 	transport_destroy_device(dev);
412 	put_device(dev->parent);
413 }
414 EXPORT_SYMBOL(sas_phy_delete);
415 
416 /**
417  * scsi_is_sas_phy  --  check if a struct device represents a SAS PHY
418  * @dev:	device to check
419  *
420  * Returns:
421  *	%1 if the device represents a SAS PHY, %0 else
422  */
423 int scsi_is_sas_phy(const struct device *dev)
424 {
425 	return dev->release == sas_phy_release;
426 }
427 EXPORT_SYMBOL(scsi_is_sas_phy);
428 
429 /*
430  * SAS remote PHY attributes.
431  */
432 
433 #define sas_rphy_show_simple(field, name, format_string, cast)		\
434 static ssize_t								\
435 show_sas_rphy_##name(struct class_device *cdev, char *buf)		\
436 {									\
437 	struct sas_rphy *rphy = transport_class_to_rphy(cdev);	\
438 									\
439 	return snprintf(buf, 20, format_string, cast rphy->field);	\
440 }
441 
442 #define sas_rphy_simple_attr(field, name, format_string, type)		\
443 	sas_rphy_show_simple(field, name, format_string, (type))	\
444 static SAS_CLASS_DEVICE_ATTR(rphy, name, S_IRUGO, 			\
445 		show_sas_rphy_##name, NULL)
446 
447 #define sas_rphy_show_protocol(field, name)				\
448 static ssize_t								\
449 show_sas_rphy_##name(struct class_device *cdev, char *buf)		\
450 {									\
451 	struct sas_rphy *rphy = transport_class_to_rphy(cdev);	\
452 									\
453 	if (!rphy->field)					\
454 		return snprintf(buf, 20, "none\n");			\
455 	return get_sas_protocol_names(rphy->field, buf);	\
456 }
457 
458 #define sas_rphy_protocol_attr(field, name)				\
459 	sas_rphy_show_protocol(field, name)				\
460 static SAS_CLASS_DEVICE_ATTR(rphy, name, S_IRUGO,			\
461 		show_sas_rphy_##name, NULL)
462 
463 static ssize_t
464 show_sas_rphy_device_type(struct class_device *cdev, char *buf)
465 {
466 	struct sas_rphy *rphy = transport_class_to_rphy(cdev);
467 
468 	if (!rphy->identify.device_type)
469 		return snprintf(buf, 20, "none\n");
470 	return get_sas_device_type_names(
471 			rphy->identify.device_type, buf);
472 }
473 
474 static SAS_CLASS_DEVICE_ATTR(rphy, device_type, S_IRUGO,
475 		show_sas_rphy_device_type, NULL);
476 
477 sas_rphy_protocol_attr(identify.initiator_port_protocols,
478 		initiator_port_protocols);
479 sas_rphy_protocol_attr(identify.target_port_protocols, target_port_protocols);
480 sas_rphy_simple_attr(identify.sas_address, sas_address, "0x%016llx\n",
481 		unsigned long long);
482 sas_rphy_simple_attr(identify.phy_identifier, phy_identifier, "%d\n", u8);
483 
484 static DECLARE_TRANSPORT_CLASS(sas_rphy_class,
485 		"sas_rphy", NULL, NULL, NULL);
486 
487 static int sas_rphy_match(struct attribute_container *cont, struct device *dev)
488 {
489 	struct Scsi_Host *shost;
490 	struct sas_internal *i;
491 
492 	if (!scsi_is_sas_rphy(dev))
493 		return 0;
494 	shost = dev_to_shost(dev->parent->parent);
495 
496 	if (!shost->transportt)
497 		return 0;
498 	if (shost->transportt->host_attrs.ac.class !=
499 			&sas_host_class.class)
500 		return 0;
501 
502 	i = to_sas_internal(shost->transportt);
503 	return &i->rphy_attr_cont.ac == cont;
504 }
505 
506 static void sas_rphy_release(struct device *dev)
507 {
508 	struct sas_rphy *rphy = dev_to_rphy(dev);
509 
510 	put_device(dev->parent);
511 	kfree(rphy);
512 }
513 
514 /**
515  * sas_rphy_alloc  --  allocates and initialize a SAS remote PHY structure
516  * @parent:		SAS PHY this remote PHY is conneted to
517  *
518  * Allocates an SAS remote PHY structure, connected to @parent.
519  *
520  * Returns:
521  *	SAS PHY allocated or %NULL if the allocation failed.
522  */
523 struct sas_rphy *sas_rphy_alloc(struct sas_phy *parent)
524 {
525 	struct Scsi_Host *shost = dev_to_shost(&parent->dev);
526 	struct sas_rphy *rphy;
527 
528 	rphy = kmalloc(sizeof(*rphy), GFP_KERNEL);
529 	if (!rphy) {
530 		put_device(&parent->dev);
531 		return NULL;
532 	}
533 	memset(rphy, 0, sizeof(*rphy));
534 
535 	device_initialize(&rphy->dev);
536 	rphy->dev.parent = get_device(&parent->dev);
537 	rphy->dev.release = sas_rphy_release;
538 	sprintf(rphy->dev.bus_id, "rphy-%d:%d",
539 		shost->host_no, parent->number);
540 	transport_setup_device(&rphy->dev);
541 
542 	return rphy;
543 }
544 EXPORT_SYMBOL(sas_rphy_alloc);
545 
546 /**
547  * sas_rphy_add  --  add a SAS remote PHY to the device hierachy
548  * @rphy:	The remote PHY to be added
549  *
550  * Publishes a SAS remote PHY to the rest of the system.
551  */
552 int sas_rphy_add(struct sas_rphy *rphy)
553 {
554 	struct sas_phy *parent = dev_to_phy(rphy->dev.parent);
555 	struct Scsi_Host *shost = dev_to_shost(parent->dev.parent);
556 	struct sas_host_attrs *sas_host = to_sas_host_attrs(shost);
557 	struct sas_identify *identify = &rphy->identify;
558 	int error;
559 
560 	if (parent->rphy)
561 		return -ENXIO;
562 	parent->rphy = rphy;
563 
564 	error = device_add(&rphy->dev);
565 	if (error)
566 		return error;
567 	transport_add_device(&rphy->dev);
568 	transport_configure_device(&rphy->dev);
569 
570 	spin_lock(&sas_host->lock);
571 	list_add_tail(&rphy->list, &sas_host->rphy_list);
572 	if (identify->device_type == SAS_END_DEVICE &&
573 	    (identify->target_port_protocols &
574 	     (SAS_PROTOCOL_SSP|SAS_PROTOCOL_STP|SAS_PROTOCOL_SATA)))
575 		rphy->scsi_target_id = sas_host->next_target_id++;
576 	else
577 		rphy->scsi_target_id = -1;
578 	spin_unlock(&sas_host->lock);
579 
580 	if (rphy->scsi_target_id != -1) {
581 		scsi_scan_target(&rphy->dev, parent->number,
582 				rphy->scsi_target_id, ~0, 0);
583 	}
584 
585 	return 0;
586 }
587 EXPORT_SYMBOL(sas_rphy_add);
588 
589 /**
590  * sas_rphy_free  --  free a SAS remote PHY
591  * @rphy	SAS remote PHY to free
592  *
593  * Frees the specified SAS remote PHY.
594  *
595  * Note:
596  *   This function must only be called on a remote
597  *   PHY that has not sucessfully been added using
598  *   sas_rphy_add().
599  */
600 void sas_rphy_free(struct sas_rphy *rphy)
601 {
602 	struct Scsi_Host *shost = dev_to_shost(rphy->dev.parent->parent);
603 	struct sas_host_attrs *sas_host = to_sas_host_attrs(shost);
604 
605 	spin_lock(&sas_host->lock);
606 	list_del(&rphy->list);
607 	spin_unlock(&sas_host->lock);
608 
609 	transport_destroy_device(&rphy->dev);
610 	put_device(rphy->dev.parent);
611 	put_device(rphy->dev.parent);
612 	put_device(rphy->dev.parent);
613 	kfree(rphy);
614 }
615 EXPORT_SYMBOL(sas_rphy_free);
616 
617 /**
618  * sas_rphy_delete  --  remove SAS remote PHY
619  * @rphy:	SAS remote PHY to remove
620  *
621  * Removes the specified SAS remote PHY.
622  */
623 void
624 sas_rphy_delete(struct sas_rphy *rphy)
625 {
626 	struct device *dev = &rphy->dev;
627 	struct sas_phy *parent = dev_to_phy(dev->parent);
628 	struct Scsi_Host *shost = dev_to_shost(parent->dev.parent);
629 	struct sas_host_attrs *sas_host = to_sas_host_attrs(shost);
630 
631 	scsi_remove_target(dev);
632 
633 	transport_remove_device(dev);
634 	device_del(dev);
635 	transport_destroy_device(dev);
636 
637 	spin_lock(&sas_host->lock);
638 	list_del(&rphy->list);
639 	spin_unlock(&sas_host->lock);
640 
641 	put_device(&parent->dev);
642 }
643 EXPORT_SYMBOL(sas_rphy_delete);
644 
645 /**
646  * scsi_is_sas_rphy  --  check if a struct device represents a SAS remote PHY
647  * @dev:	device to check
648  *
649  * Returns:
650  *	%1 if the device represents a SAS remote PHY, %0 else
651  */
652 int scsi_is_sas_rphy(const struct device *dev)
653 {
654 	return dev->release == sas_rphy_release;
655 }
656 EXPORT_SYMBOL(scsi_is_sas_rphy);
657 
658 
659 /*
660  * SCSI scan helper
661  */
662 
663 static struct device *sas_target_parent(struct Scsi_Host *shost,
664 					int channel, uint id)
665 {
666 	struct sas_host_attrs *sas_host = to_sas_host_attrs(shost);
667 	struct sas_rphy *rphy;
668 	struct device *dev = NULL;
669 
670 	spin_lock(&sas_host->lock);
671 	list_for_each_entry(rphy, &sas_host->rphy_list, list) {
672 		struct sas_phy *parent = dev_to_phy(rphy->dev.parent);
673 		if (parent->number == channel &&
674 		    rphy->scsi_target_id == id)
675 			dev = &rphy->dev;
676 	}
677 	spin_unlock(&sas_host->lock);
678 
679 	return dev;
680 }
681 
682 
683 /*
684  * Setup / Teardown code
685  */
686 
687 #define SETUP_RPORT_ATTRIBUTE(field)					\
688 	i->private_rphy_attrs[count] = class_device_attr_##field;	\
689 	i->private_rphy_attrs[count].attr.mode = S_IRUGO;		\
690 	i->private_rphy_attrs[count].store = NULL;			\
691 	i->rphy_attrs[count] = &i->private_rphy_attrs[count];	\
692 	count++
693 
694 #define SETUP_PORT_ATTRIBUTE(field)					\
695 	i->private_phy_attrs[count] = class_device_attr_##field;	\
696         i->private_phy_attrs[count].attr.mode = S_IRUGO;		\
697         i->private_phy_attrs[count].store = NULL;			\
698         i->phy_attrs[count] = &i->private_phy_attrs[count];		\
699 	count++
700 
701 
702 /**
703  * sas_attach_transport  --  instantiate SAS transport template
704  * @ft:		SAS transport class function template
705  */
706 struct scsi_transport_template *
707 sas_attach_transport(struct sas_function_template *ft)
708 {
709 	struct sas_internal *i;
710 	int count;
711 
712 	i = kmalloc(sizeof(struct sas_internal), GFP_KERNEL);
713 	if (!i)
714 		return NULL;
715 	memset(i, 0, sizeof(struct sas_internal));
716 
717 	i->t.target_parent = sas_target_parent;
718 
719 	i->t.host_attrs.ac.attrs = &i->host_attrs[0];
720 	i->t.host_attrs.ac.class = &sas_host_class.class;
721 	i->t.host_attrs.ac.match = sas_host_match;
722 	transport_container_register(&i->t.host_attrs);
723 	i->t.host_size = sizeof(struct sas_host_attrs);
724 
725 	i->phy_attr_cont.ac.class = &sas_phy_class.class;
726 	i->phy_attr_cont.ac.attrs = &i->phy_attrs[0];
727 	i->phy_attr_cont.ac.match = sas_phy_match;
728 	transport_container_register(&i->phy_attr_cont);
729 
730 	i->rphy_attr_cont.ac.class = &sas_rphy_class.class;
731 	i->rphy_attr_cont.ac.attrs = &i->rphy_attrs[0];
732 	i->rphy_attr_cont.ac.match = sas_rphy_match;
733 	transport_container_register(&i->rphy_attr_cont);
734 
735 	i->f = ft;
736 
737 	count = 0;
738 	i->host_attrs[count] = NULL;
739 
740 	count = 0;
741 	SETUP_PORT_ATTRIBUTE(initiator_port_protocols);
742 	SETUP_PORT_ATTRIBUTE(target_port_protocols);
743 	SETUP_PORT_ATTRIBUTE(device_type);
744 	SETUP_PORT_ATTRIBUTE(sas_address);
745 	SETUP_PORT_ATTRIBUTE(phy_identifier);
746 	SETUP_PORT_ATTRIBUTE(port_identifier);
747 	SETUP_PORT_ATTRIBUTE(negotiated_linkrate);
748 	SETUP_PORT_ATTRIBUTE(minimum_linkrate_hw);
749 	SETUP_PORT_ATTRIBUTE(minimum_linkrate);
750 	SETUP_PORT_ATTRIBUTE(maximum_linkrate_hw);
751 	SETUP_PORT_ATTRIBUTE(maximum_linkrate);
752 	i->phy_attrs[count] = NULL;
753 
754 	count = 0;
755 	SETUP_RPORT_ATTRIBUTE(rphy_initiator_port_protocols);
756 	SETUP_RPORT_ATTRIBUTE(rphy_target_port_protocols);
757 	SETUP_RPORT_ATTRIBUTE(rphy_device_type);
758 	SETUP_RPORT_ATTRIBUTE(rphy_sas_address);
759 	SETUP_RPORT_ATTRIBUTE(rphy_phy_identifier);
760 	i->rphy_attrs[count] = NULL;
761 
762 	return &i->t;
763 }
764 EXPORT_SYMBOL(sas_attach_transport);
765 
766 /**
767  * sas_release_transport  --  release SAS transport template instance
768  * @t:		transport template instance
769  */
770 void sas_release_transport(struct scsi_transport_template *t)
771 {
772 	struct sas_internal *i = to_sas_internal(t);
773 
774 	transport_container_unregister(&i->t.host_attrs);
775 	transport_container_unregister(&i->phy_attr_cont);
776 	transport_container_unregister(&i->rphy_attr_cont);
777 
778 	kfree(i);
779 }
780 EXPORT_SYMBOL(sas_release_transport);
781 
782 static __init int sas_transport_init(void)
783 {
784 	int error;
785 
786 	error = transport_class_register(&sas_host_class);
787 	if (error)
788 		goto out;
789 	error = transport_class_register(&sas_phy_class);
790 	if (error)
791 		goto out_unregister_transport;
792 	error = transport_class_register(&sas_rphy_class);
793 	if (error)
794 		goto out_unregister_phy;
795 
796 	return 0;
797 
798  out_unregister_phy:
799 	transport_class_unregister(&sas_phy_class);
800  out_unregister_transport:
801 	transport_class_unregister(&sas_host_class);
802  out:
803 	return error;
804 
805 }
806 
807 static void __exit sas_transport_exit(void)
808 {
809 	transport_class_unregister(&sas_host_class);
810 	transport_class_unregister(&sas_phy_class);
811 	transport_class_unregister(&sas_rphy_class);
812 }
813 
814 MODULE_AUTHOR("Christoph Hellwig");
815 MODULE_DESCRIPTION("SAS Transphy Attributes");
816 MODULE_LICENSE("GPL");
817 
818 module_init(sas_transport_init);
819 module_exit(sas_transport_exit);
820