scsi_transport_sas.c revision eb44820c28bc9a042e1157b41c677018a8fdfc74
1/* 2 * Copyright (C) 2005-2006 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/jiffies.h> 29#include <linux/err.h> 30#include <linux/slab.h> 31#include <linux/string.h> 32#include <linux/blkdev.h> 33#include <linux/bsg.h> 34 35#include <scsi/scsi.h> 36#include <scsi/scsi_device.h> 37#include <scsi/scsi_host.h> 38#include <scsi/scsi_transport.h> 39#include <scsi/scsi_transport_sas.h> 40 41#include "scsi_sas_internal.h" 42struct sas_host_attrs { 43 struct list_head rphy_list; 44 struct mutex lock; 45 struct request_queue *q; 46 u32 next_target_id; 47 u32 next_expander_id; 48 int next_port_id; 49}; 50#define to_sas_host_attrs(host) ((struct sas_host_attrs *)(host)->shost_data) 51 52 53/* 54 * Hack to allow attributes of the same name in different objects. 55 */ 56#define SAS_CLASS_DEVICE_ATTR(_prefix,_name,_mode,_show,_store) \ 57 struct class_device_attribute class_device_attr_##_prefix##_##_name = \ 58 __ATTR(_name,_mode,_show,_store) 59 60 61/* 62 * Pretty printing helpers 63 */ 64 65#define sas_bitfield_name_match(title, table) \ 66static ssize_t \ 67get_sas_##title##_names(u32 table_key, char *buf) \ 68{ \ 69 char *prefix = ""; \ 70 ssize_t len = 0; \ 71 int i; \ 72 \ 73 for (i = 0; i < ARRAY_SIZE(table); i++) { \ 74 if (table[i].value & table_key) { \ 75 len += sprintf(buf + len, "%s%s", \ 76 prefix, table[i].name); \ 77 prefix = ", "; \ 78 } \ 79 } \ 80 len += sprintf(buf + len, "\n"); \ 81 return len; \ 82} 83 84#define sas_bitfield_name_set(title, table) \ 85static ssize_t \ 86set_sas_##title##_names(u32 *table_key, const char *buf) \ 87{ \ 88 ssize_t len = 0; \ 89 int i; \ 90 \ 91 for (i = 0; i < ARRAY_SIZE(table); i++) { \ 92 len = strlen(table[i].name); \ 93 if (strncmp(buf, table[i].name, len) == 0 && \ 94 (buf[len] == '\n' || buf[len] == '\0')) { \ 95 *table_key = table[i].value; \ 96 return 0; \ 97 } \ 98 } \ 99 return -EINVAL; \ 100} 101 102#define sas_bitfield_name_search(title, table) \ 103static ssize_t \ 104get_sas_##title##_names(u32 table_key, char *buf) \ 105{ \ 106 ssize_t len = 0; \ 107 int i; \ 108 \ 109 for (i = 0; i < ARRAY_SIZE(table); i++) { \ 110 if (table[i].value == table_key) { \ 111 len += sprintf(buf + len, "%s", \ 112 table[i].name); \ 113 break; \ 114 } \ 115 } \ 116 len += sprintf(buf + len, "\n"); \ 117 return len; \ 118} 119 120static struct { 121 u32 value; 122 char *name; 123} sas_device_type_names[] = { 124 { SAS_PHY_UNUSED, "unused" }, 125 { SAS_END_DEVICE, "end device" }, 126 { SAS_EDGE_EXPANDER_DEVICE, "edge expander" }, 127 { SAS_FANOUT_EXPANDER_DEVICE, "fanout expander" }, 128}; 129sas_bitfield_name_search(device_type, sas_device_type_names) 130 131 132static struct { 133 u32 value; 134 char *name; 135} sas_protocol_names[] = { 136 { SAS_PROTOCOL_SATA, "sata" }, 137 { SAS_PROTOCOL_SMP, "smp" }, 138 { SAS_PROTOCOL_STP, "stp" }, 139 { SAS_PROTOCOL_SSP, "ssp" }, 140}; 141sas_bitfield_name_match(protocol, sas_protocol_names) 142 143static struct { 144 u32 value; 145 char *name; 146} sas_linkspeed_names[] = { 147 { SAS_LINK_RATE_UNKNOWN, "Unknown" }, 148 { SAS_PHY_DISABLED, "Phy disabled" }, 149 { SAS_LINK_RATE_FAILED, "Link Rate failed" }, 150 { SAS_SATA_SPINUP_HOLD, "Spin-up hold" }, 151 { SAS_LINK_RATE_1_5_GBPS, "1.5 Gbit" }, 152 { SAS_LINK_RATE_3_0_GBPS, "3.0 Gbit" }, 153 { SAS_LINK_RATE_6_0_GBPS, "6.0 Gbit" }, 154}; 155sas_bitfield_name_search(linkspeed, sas_linkspeed_names) 156sas_bitfield_name_set(linkspeed, sas_linkspeed_names) 157 158static void sas_smp_request(struct request_queue *q, struct Scsi_Host *shost, 159 struct sas_rphy *rphy) 160{ 161 struct request *req; 162 int ret; 163 int (*handler)(struct Scsi_Host *, struct sas_rphy *, struct request *); 164 165 while (!blk_queue_plugged(q)) { 166 req = elv_next_request(q); 167 if (!req) 168 break; 169 170 blkdev_dequeue_request(req); 171 172 spin_unlock_irq(q->queue_lock); 173 174 handler = to_sas_internal(shost->transportt)->f->smp_handler; 175 ret = handler(shost, rphy, req); 176 177 spin_lock_irq(q->queue_lock); 178 179 req->end_io(req, ret); 180 } 181} 182 183static void sas_host_smp_request(struct request_queue *q) 184{ 185 sas_smp_request(q, (struct Scsi_Host *)q->queuedata, NULL); 186} 187 188static void sas_non_host_smp_request(struct request_queue *q) 189{ 190 struct sas_rphy *rphy = q->queuedata; 191 sas_smp_request(q, rphy_to_shost(rphy), rphy); 192} 193 194static int sas_bsg_initialize(struct Scsi_Host *shost, struct sas_rphy *rphy) 195{ 196 struct request_queue *q; 197 int error; 198 struct device *dev; 199 char namebuf[BUS_ID_SIZE]; 200 const char *name; 201 202 if (!to_sas_internal(shost->transportt)->f->smp_handler) { 203 printk("%s can't handle SMP requests\n", shost->hostt->name); 204 return 0; 205 } 206 207 if (rphy) { 208 q = blk_init_queue(sas_non_host_smp_request, NULL); 209 dev = &rphy->dev; 210 name = dev->bus_id; 211 } else { 212 q = blk_init_queue(sas_host_smp_request, NULL); 213 dev = &shost->shost_gendev; 214 snprintf(namebuf, sizeof(namebuf), 215 "sas_host%d", shost->host_no); 216 name = namebuf; 217 } 218 if (!q) 219 return -ENOMEM; 220 221 error = bsg_register_queue(q, dev, name); 222 if (error) { 223 blk_cleanup_queue(q); 224 return -ENOMEM; 225 } 226 227 if (rphy) 228 rphy->q = q; 229 else 230 to_sas_host_attrs(shost)->q = q; 231 232 if (rphy) 233 q->queuedata = rphy; 234 else 235 q->queuedata = shost; 236 237 set_bit(QUEUE_FLAG_BIDI, &q->queue_flags); 238 239 return 0; 240} 241 242static void sas_bsg_remove(struct Scsi_Host *shost, struct sas_rphy *rphy) 243{ 244 struct request_queue *q; 245 246 if (rphy) 247 q = rphy->q; 248 else 249 q = to_sas_host_attrs(shost)->q; 250 251 if (!q) 252 return; 253 254 bsg_unregister_queue(q); 255 blk_cleanup_queue(q); 256} 257 258/* 259 * SAS host attributes 260 */ 261 262static int sas_host_setup(struct transport_container *tc, struct device *dev, 263 struct class_device *cdev) 264{ 265 struct Scsi_Host *shost = dev_to_shost(dev); 266 struct sas_host_attrs *sas_host = to_sas_host_attrs(shost); 267 268 INIT_LIST_HEAD(&sas_host->rphy_list); 269 mutex_init(&sas_host->lock); 270 sas_host->next_target_id = 0; 271 sas_host->next_expander_id = 0; 272 sas_host->next_port_id = 0; 273 274 if (sas_bsg_initialize(shost, NULL)) 275 dev_printk(KERN_ERR, dev, "fail to a bsg device %d\n", 276 shost->host_no); 277 278 return 0; 279} 280 281static int sas_host_remove(struct transport_container *tc, struct device *dev, 282 struct class_device *cdev) 283{ 284 struct Scsi_Host *shost = dev_to_shost(dev); 285 286 sas_bsg_remove(shost, NULL); 287 288 return 0; 289} 290 291static DECLARE_TRANSPORT_CLASS(sas_host_class, 292 "sas_host", sas_host_setup, sas_host_remove, NULL); 293 294static int sas_host_match(struct attribute_container *cont, 295 struct device *dev) 296{ 297 struct Scsi_Host *shost; 298 struct sas_internal *i; 299 300 if (!scsi_is_host_device(dev)) 301 return 0; 302 shost = dev_to_shost(dev); 303 304 if (!shost->transportt) 305 return 0; 306 if (shost->transportt->host_attrs.ac.class != 307 &sas_host_class.class) 308 return 0; 309 310 i = to_sas_internal(shost->transportt); 311 return &i->t.host_attrs.ac == cont; 312} 313 314static int do_sas_phy_delete(struct device *dev, void *data) 315{ 316 int pass = (int)(unsigned long)data; 317 318 if (pass == 0 && scsi_is_sas_port(dev)) 319 sas_port_delete(dev_to_sas_port(dev)); 320 else if (pass == 1 && scsi_is_sas_phy(dev)) 321 sas_phy_delete(dev_to_phy(dev)); 322 return 0; 323} 324 325/** 326 * sas_remove_children - tear down a devices SAS data structures 327 * @dev: device belonging to the sas object 328 * 329 * Removes all SAS PHYs and remote PHYs for a given object 330 */ 331void sas_remove_children(struct device *dev) 332{ 333 device_for_each_child(dev, (void *)0, do_sas_phy_delete); 334 device_for_each_child(dev, (void *)1, do_sas_phy_delete); 335} 336EXPORT_SYMBOL(sas_remove_children); 337 338/** 339 * sas_remove_host - tear down a Scsi_Host's SAS data structures 340 * @shost: Scsi Host that is torn down 341 * 342 * Removes all SAS PHYs and remote PHYs for a given Scsi_Host. 343 * Must be called just before scsi_remove_host for SAS HBAs. 344 */ 345void sas_remove_host(struct Scsi_Host *shost) 346{ 347 sas_remove_children(&shost->shost_gendev); 348} 349EXPORT_SYMBOL(sas_remove_host); 350 351 352/* 353 * SAS Phy attributes 354 */ 355 356#define sas_phy_show_simple(field, name, format_string, cast) \ 357static ssize_t \ 358show_sas_phy_##name(struct class_device *cdev, char *buf) \ 359{ \ 360 struct sas_phy *phy = transport_class_to_phy(cdev); \ 361 \ 362 return snprintf(buf, 20, format_string, cast phy->field); \ 363} 364 365#define sas_phy_simple_attr(field, name, format_string, type) \ 366 sas_phy_show_simple(field, name, format_string, (type)) \ 367static CLASS_DEVICE_ATTR(name, S_IRUGO, show_sas_phy_##name, NULL) 368 369#define sas_phy_show_protocol(field, name) \ 370static ssize_t \ 371show_sas_phy_##name(struct class_device *cdev, char *buf) \ 372{ \ 373 struct sas_phy *phy = transport_class_to_phy(cdev); \ 374 \ 375 if (!phy->field) \ 376 return snprintf(buf, 20, "none\n"); \ 377 return get_sas_protocol_names(phy->field, buf); \ 378} 379 380#define sas_phy_protocol_attr(field, name) \ 381 sas_phy_show_protocol(field, name) \ 382static CLASS_DEVICE_ATTR(name, S_IRUGO, show_sas_phy_##name, NULL) 383 384#define sas_phy_show_linkspeed(field) \ 385static ssize_t \ 386show_sas_phy_##field(struct class_device *cdev, char *buf) \ 387{ \ 388 struct sas_phy *phy = transport_class_to_phy(cdev); \ 389 \ 390 return get_sas_linkspeed_names(phy->field, buf); \ 391} 392 393/* Fudge to tell if we're minimum or maximum */ 394#define sas_phy_store_linkspeed(field) \ 395static ssize_t \ 396store_sas_phy_##field(struct class_device *cdev, const char *buf, \ 397 size_t count) \ 398{ \ 399 struct sas_phy *phy = transport_class_to_phy(cdev); \ 400 struct Scsi_Host *shost = dev_to_shost(phy->dev.parent); \ 401 struct sas_internal *i = to_sas_internal(shost->transportt); \ 402 u32 value; \ 403 struct sas_phy_linkrates rates = {0}; \ 404 int error; \ 405 \ 406 error = set_sas_linkspeed_names(&value, buf); \ 407 if (error) \ 408 return error; \ 409 rates.field = value; \ 410 error = i->f->set_phy_speed(phy, &rates); \ 411 \ 412 return error ? error : count; \ 413} 414 415#define sas_phy_linkspeed_rw_attr(field) \ 416 sas_phy_show_linkspeed(field) \ 417 sas_phy_store_linkspeed(field) \ 418static CLASS_DEVICE_ATTR(field, S_IRUGO, show_sas_phy_##field, \ 419 store_sas_phy_##field) 420 421#define sas_phy_linkspeed_attr(field) \ 422 sas_phy_show_linkspeed(field) \ 423static CLASS_DEVICE_ATTR(field, S_IRUGO, show_sas_phy_##field, NULL) 424 425 426#define sas_phy_show_linkerror(field) \ 427static ssize_t \ 428show_sas_phy_##field(struct class_device *cdev, char *buf) \ 429{ \ 430 struct sas_phy *phy = transport_class_to_phy(cdev); \ 431 struct Scsi_Host *shost = dev_to_shost(phy->dev.parent); \ 432 struct sas_internal *i = to_sas_internal(shost->transportt); \ 433 int error; \ 434 \ 435 error = i->f->get_linkerrors ? i->f->get_linkerrors(phy) : 0; \ 436 if (error) \ 437 return error; \ 438 return snprintf(buf, 20, "%u\n", phy->field); \ 439} 440 441#define sas_phy_linkerror_attr(field) \ 442 sas_phy_show_linkerror(field) \ 443static CLASS_DEVICE_ATTR(field, S_IRUGO, show_sas_phy_##field, NULL) 444 445 446static ssize_t 447show_sas_device_type(struct class_device *cdev, char *buf) 448{ 449 struct sas_phy *phy = transport_class_to_phy(cdev); 450 451 if (!phy->identify.device_type) 452 return snprintf(buf, 20, "none\n"); 453 return get_sas_device_type_names(phy->identify.device_type, buf); 454} 455static CLASS_DEVICE_ATTR(device_type, S_IRUGO, show_sas_device_type, NULL); 456 457static ssize_t do_sas_phy_enable(struct class_device *cdev, 458 size_t count, int enable) 459{ 460 struct sas_phy *phy = transport_class_to_phy(cdev); 461 struct Scsi_Host *shost = dev_to_shost(phy->dev.parent); 462 struct sas_internal *i = to_sas_internal(shost->transportt); 463 int error; 464 465 error = i->f->phy_enable(phy, enable); 466 if (error) 467 return error; 468 phy->enabled = enable; 469 return count; 470}; 471 472static ssize_t store_sas_phy_enable(struct class_device *cdev, 473 const char *buf, size_t count) 474{ 475 if (count < 1) 476 return -EINVAL; 477 478 switch (buf[0]) { 479 case '0': 480 do_sas_phy_enable(cdev, count, 0); 481 break; 482 case '1': 483 do_sas_phy_enable(cdev, count, 1); 484 break; 485 default: 486 return -EINVAL; 487 } 488 489 return count; 490} 491 492static ssize_t show_sas_phy_enable(struct class_device *cdev, char *buf) 493{ 494 struct sas_phy *phy = transport_class_to_phy(cdev); 495 496 return snprintf(buf, 20, "%d", phy->enabled); 497} 498 499static CLASS_DEVICE_ATTR(enable, S_IRUGO | S_IWUSR, show_sas_phy_enable, 500 store_sas_phy_enable); 501 502static ssize_t do_sas_phy_reset(struct class_device *cdev, 503 size_t count, int hard_reset) 504{ 505 struct sas_phy *phy = transport_class_to_phy(cdev); 506 struct Scsi_Host *shost = dev_to_shost(phy->dev.parent); 507 struct sas_internal *i = to_sas_internal(shost->transportt); 508 int error; 509 510 error = i->f->phy_reset(phy, hard_reset); 511 if (error) 512 return error; 513 return count; 514}; 515 516static ssize_t store_sas_link_reset(struct class_device *cdev, 517 const char *buf, size_t count) 518{ 519 return do_sas_phy_reset(cdev, count, 0); 520} 521static CLASS_DEVICE_ATTR(link_reset, S_IWUSR, NULL, store_sas_link_reset); 522 523static ssize_t store_sas_hard_reset(struct class_device *cdev, 524 const char *buf, size_t count) 525{ 526 return do_sas_phy_reset(cdev, count, 1); 527} 528static CLASS_DEVICE_ATTR(hard_reset, S_IWUSR, NULL, store_sas_hard_reset); 529 530sas_phy_protocol_attr(identify.initiator_port_protocols, 531 initiator_port_protocols); 532sas_phy_protocol_attr(identify.target_port_protocols, 533 target_port_protocols); 534sas_phy_simple_attr(identify.sas_address, sas_address, "0x%016llx\n", 535 unsigned long long); 536sas_phy_simple_attr(identify.phy_identifier, phy_identifier, "%d\n", u8); 537//sas_phy_simple_attr(port_identifier, port_identifier, "%d\n", int); 538sas_phy_linkspeed_attr(negotiated_linkrate); 539sas_phy_linkspeed_attr(minimum_linkrate_hw); 540sas_phy_linkspeed_rw_attr(minimum_linkrate); 541sas_phy_linkspeed_attr(maximum_linkrate_hw); 542sas_phy_linkspeed_rw_attr(maximum_linkrate); 543sas_phy_linkerror_attr(invalid_dword_count); 544sas_phy_linkerror_attr(running_disparity_error_count); 545sas_phy_linkerror_attr(loss_of_dword_sync_count); 546sas_phy_linkerror_attr(phy_reset_problem_count); 547 548 549static DECLARE_TRANSPORT_CLASS(sas_phy_class, 550 "sas_phy", NULL, NULL, NULL); 551 552static int sas_phy_match(struct attribute_container *cont, struct device *dev) 553{ 554 struct Scsi_Host *shost; 555 struct sas_internal *i; 556 557 if (!scsi_is_sas_phy(dev)) 558 return 0; 559 shost = dev_to_shost(dev->parent); 560 561 if (!shost->transportt) 562 return 0; 563 if (shost->transportt->host_attrs.ac.class != 564 &sas_host_class.class) 565 return 0; 566 567 i = to_sas_internal(shost->transportt); 568 return &i->phy_attr_cont.ac == cont; 569} 570 571static void sas_phy_release(struct device *dev) 572{ 573 struct sas_phy *phy = dev_to_phy(dev); 574 575 put_device(dev->parent); 576 kfree(phy); 577} 578 579/** 580 * sas_phy_alloc - allocates and initialize a SAS PHY structure 581 * @parent: Parent device 582 * @number: Phy index 583 * 584 * Allocates an SAS PHY structure. It will be added in the device tree 585 * below the device specified by @parent, which has to be either a Scsi_Host 586 * or sas_rphy. 587 * 588 * Returns: 589 * SAS PHY allocated or %NULL if the allocation failed. 590 */ 591struct sas_phy *sas_phy_alloc(struct device *parent, int number) 592{ 593 struct Scsi_Host *shost = dev_to_shost(parent); 594 struct sas_phy *phy; 595 596 phy = kzalloc(sizeof(*phy), GFP_KERNEL); 597 if (!phy) 598 return NULL; 599 600 phy->number = number; 601 phy->enabled = 1; 602 603 device_initialize(&phy->dev); 604 phy->dev.parent = get_device(parent); 605 phy->dev.release = sas_phy_release; 606 INIT_LIST_HEAD(&phy->port_siblings); 607 if (scsi_is_sas_expander_device(parent)) { 608 struct sas_rphy *rphy = dev_to_rphy(parent); 609 sprintf(phy->dev.bus_id, "phy-%d:%d:%d", shost->host_no, 610 rphy->scsi_target_id, number); 611 } else 612 sprintf(phy->dev.bus_id, "phy-%d:%d", shost->host_no, number); 613 614 transport_setup_device(&phy->dev); 615 616 return phy; 617} 618EXPORT_SYMBOL(sas_phy_alloc); 619 620/** 621 * sas_phy_add - add a SAS PHY to the device hierarchy 622 * @phy: The PHY to be added 623 * 624 * Publishes a SAS PHY to the rest of the system. 625 */ 626int sas_phy_add(struct sas_phy *phy) 627{ 628 int error; 629 630 error = device_add(&phy->dev); 631 if (!error) { 632 transport_add_device(&phy->dev); 633 transport_configure_device(&phy->dev); 634 } 635 636 return error; 637} 638EXPORT_SYMBOL(sas_phy_add); 639 640/** 641 * sas_phy_free - free a SAS PHY 642 * @phy: SAS PHY to free 643 * 644 * Frees the specified SAS PHY. 645 * 646 * Note: 647 * This function must only be called on a PHY that has not 648 * sucessfully been added using sas_phy_add(). 649 */ 650void sas_phy_free(struct sas_phy *phy) 651{ 652 transport_destroy_device(&phy->dev); 653 put_device(&phy->dev); 654} 655EXPORT_SYMBOL(sas_phy_free); 656 657/** 658 * sas_phy_delete - remove SAS PHY 659 * @phy: SAS PHY to remove 660 * 661 * Removes the specified SAS PHY. If the SAS PHY has an 662 * associated remote PHY it is removed before. 663 */ 664void 665sas_phy_delete(struct sas_phy *phy) 666{ 667 struct device *dev = &phy->dev; 668 669 /* this happens if the phy is still part of a port when deleted */ 670 BUG_ON(!list_empty(&phy->port_siblings)); 671 672 transport_remove_device(dev); 673 device_del(dev); 674 transport_destroy_device(dev); 675 put_device(dev); 676} 677EXPORT_SYMBOL(sas_phy_delete); 678 679/** 680 * scsi_is_sas_phy - check if a struct device represents a SAS PHY 681 * @dev: device to check 682 * 683 * Returns: 684 * %1 if the device represents a SAS PHY, %0 else 685 */ 686int scsi_is_sas_phy(const struct device *dev) 687{ 688 return dev->release == sas_phy_release; 689} 690EXPORT_SYMBOL(scsi_is_sas_phy); 691 692/* 693 * SAS Port attributes 694 */ 695#define sas_port_show_simple(field, name, format_string, cast) \ 696static ssize_t \ 697show_sas_port_##name(struct class_device *cdev, char *buf) \ 698{ \ 699 struct sas_port *port = transport_class_to_sas_port(cdev); \ 700 \ 701 return snprintf(buf, 20, format_string, cast port->field); \ 702} 703 704#define sas_port_simple_attr(field, name, format_string, type) \ 705 sas_port_show_simple(field, name, format_string, (type)) \ 706static CLASS_DEVICE_ATTR(name, S_IRUGO, show_sas_port_##name, NULL) 707 708sas_port_simple_attr(num_phys, num_phys, "%d\n", int); 709 710static DECLARE_TRANSPORT_CLASS(sas_port_class, 711 "sas_port", NULL, NULL, NULL); 712 713static int sas_port_match(struct attribute_container *cont, struct device *dev) 714{ 715 struct Scsi_Host *shost; 716 struct sas_internal *i; 717 718 if (!scsi_is_sas_port(dev)) 719 return 0; 720 shost = dev_to_shost(dev->parent); 721 722 if (!shost->transportt) 723 return 0; 724 if (shost->transportt->host_attrs.ac.class != 725 &sas_host_class.class) 726 return 0; 727 728 i = to_sas_internal(shost->transportt); 729 return &i->port_attr_cont.ac == cont; 730} 731 732 733static void sas_port_release(struct device *dev) 734{ 735 struct sas_port *port = dev_to_sas_port(dev); 736 737 BUG_ON(!list_empty(&port->phy_list)); 738 739 put_device(dev->parent); 740 kfree(port); 741} 742 743static void sas_port_create_link(struct sas_port *port, 744 struct sas_phy *phy) 745{ 746 int res; 747 748 res = sysfs_create_link(&port->dev.kobj, &phy->dev.kobj, 749 phy->dev.bus_id); 750 if (res) 751 goto err; 752 res = sysfs_create_link(&phy->dev.kobj, &port->dev.kobj, "port"); 753 if (res) 754 goto err; 755 return; 756err: 757 printk(KERN_ERR "%s: Cannot create port links, err=%d\n", 758 __FUNCTION__, res); 759} 760 761static void sas_port_delete_link(struct sas_port *port, 762 struct sas_phy *phy) 763{ 764 sysfs_remove_link(&port->dev.kobj, phy->dev.bus_id); 765 sysfs_remove_link(&phy->dev.kobj, "port"); 766} 767 768/** sas_port_alloc - allocate and initialize a SAS port structure 769 * 770 * @parent: parent device 771 * @port_id: port number 772 * 773 * Allocates a SAS port structure. It will be added to the device tree 774 * below the device specified by @parent which must be either a Scsi_Host 775 * or a sas_expander_device. 776 * 777 * Returns %NULL on error 778 */ 779struct sas_port *sas_port_alloc(struct device *parent, int port_id) 780{ 781 struct Scsi_Host *shost = dev_to_shost(parent); 782 struct sas_port *port; 783 784 port = kzalloc(sizeof(*port), GFP_KERNEL); 785 if (!port) 786 return NULL; 787 788 port->port_identifier = port_id; 789 790 device_initialize(&port->dev); 791 792 port->dev.parent = get_device(parent); 793 port->dev.release = sas_port_release; 794 795 mutex_init(&port->phy_list_mutex); 796 INIT_LIST_HEAD(&port->phy_list); 797 798 if (scsi_is_sas_expander_device(parent)) { 799 struct sas_rphy *rphy = dev_to_rphy(parent); 800 sprintf(port->dev.bus_id, "port-%d:%d:%d", shost->host_no, 801 rphy->scsi_target_id, port->port_identifier); 802 } else 803 sprintf(port->dev.bus_id, "port-%d:%d", shost->host_no, 804 port->port_identifier); 805 806 transport_setup_device(&port->dev); 807 808 return port; 809} 810EXPORT_SYMBOL(sas_port_alloc); 811 812/** sas_port_alloc_num - allocate and initialize a SAS port structure 813 * 814 * @parent: parent device 815 * 816 * Allocates a SAS port structure and a number to go with it. This 817 * interface is really for adapters where the port number has no 818 * meansing, so the sas class should manage them. It will be added to 819 * the device tree below the device specified by @parent which must be 820 * either a Scsi_Host or a sas_expander_device. 821 * 822 * Returns %NULL on error 823 */ 824struct sas_port *sas_port_alloc_num(struct device *parent) 825{ 826 int index; 827 struct Scsi_Host *shost = dev_to_shost(parent); 828 struct sas_host_attrs *sas_host = to_sas_host_attrs(shost); 829 830 /* FIXME: use idr for this eventually */ 831 mutex_lock(&sas_host->lock); 832 if (scsi_is_sas_expander_device(parent)) { 833 struct sas_rphy *rphy = dev_to_rphy(parent); 834 struct sas_expander_device *exp = rphy_to_expander_device(rphy); 835 836 index = exp->next_port_id++; 837 } else 838 index = sas_host->next_port_id++; 839 mutex_unlock(&sas_host->lock); 840 return sas_port_alloc(parent, index); 841} 842EXPORT_SYMBOL(sas_port_alloc_num); 843 844/** 845 * sas_port_add - add a SAS port to the device hierarchy 846 * @port: port to be added 847 * 848 * publishes a port to the rest of the system 849 */ 850int sas_port_add(struct sas_port *port) 851{ 852 int error; 853 854 /* No phys should be added until this is made visible */ 855 BUG_ON(!list_empty(&port->phy_list)); 856 857 error = device_add(&port->dev); 858 859 if (error) 860 return error; 861 862 transport_add_device(&port->dev); 863 transport_configure_device(&port->dev); 864 865 return 0; 866} 867EXPORT_SYMBOL(sas_port_add); 868 869/** 870 * sas_port_free - free a SAS PORT 871 * @port: SAS PORT to free 872 * 873 * Frees the specified SAS PORT. 874 * 875 * Note: 876 * This function must only be called on a PORT that has not 877 * sucessfully been added using sas_port_add(). 878 */ 879void sas_port_free(struct sas_port *port) 880{ 881 transport_destroy_device(&port->dev); 882 put_device(&port->dev); 883} 884EXPORT_SYMBOL(sas_port_free); 885 886/** 887 * sas_port_delete - remove SAS PORT 888 * @port: SAS PORT to remove 889 * 890 * Removes the specified SAS PORT. If the SAS PORT has an 891 * associated phys, unlink them from the port as well. 892 */ 893void sas_port_delete(struct sas_port *port) 894{ 895 struct device *dev = &port->dev; 896 struct sas_phy *phy, *tmp_phy; 897 898 if (port->rphy) { 899 sas_rphy_delete(port->rphy); 900 port->rphy = NULL; 901 } 902 903 mutex_lock(&port->phy_list_mutex); 904 list_for_each_entry_safe(phy, tmp_phy, &port->phy_list, 905 port_siblings) { 906 sas_port_delete_link(port, phy); 907 list_del_init(&phy->port_siblings); 908 } 909 mutex_unlock(&port->phy_list_mutex); 910 911 if (port->is_backlink) { 912 struct device *parent = port->dev.parent; 913 914 sysfs_remove_link(&port->dev.kobj, parent->bus_id); 915 port->is_backlink = 0; 916 } 917 918 transport_remove_device(dev); 919 device_del(dev); 920 transport_destroy_device(dev); 921 put_device(dev); 922} 923EXPORT_SYMBOL(sas_port_delete); 924 925/** 926 * scsi_is_sas_port - check if a struct device represents a SAS port 927 * @dev: device to check 928 * 929 * Returns: 930 * %1 if the device represents a SAS Port, %0 else 931 */ 932int scsi_is_sas_port(const struct device *dev) 933{ 934 return dev->release == sas_port_release; 935} 936EXPORT_SYMBOL(scsi_is_sas_port); 937 938/** 939 * sas_port_add_phy - add another phy to a port to form a wide port 940 * @port: port to add the phy to 941 * @phy: phy to add 942 * 943 * When a port is initially created, it is empty (has no phys). All 944 * ports must have at least one phy to operated, and all wide ports 945 * must have at least two. The current code makes no difference 946 * between ports and wide ports, but the only object that can be 947 * connected to a remote device is a port, so ports must be formed on 948 * all devices with phys if they're connected to anything. 949 */ 950void sas_port_add_phy(struct sas_port *port, struct sas_phy *phy) 951{ 952 mutex_lock(&port->phy_list_mutex); 953 if (unlikely(!list_empty(&phy->port_siblings))) { 954 /* make sure we're already on this port */ 955 struct sas_phy *tmp; 956 957 list_for_each_entry(tmp, &port->phy_list, port_siblings) 958 if (tmp == phy) 959 break; 960 /* If this trips, you added a phy that was already 961 * part of a different port */ 962 if (unlikely(tmp != phy)) { 963 dev_printk(KERN_ERR, &port->dev, "trying to add phy %s fails: it's already part of another port\n", phy->dev.bus_id); 964 BUG(); 965 } 966 } else { 967 sas_port_create_link(port, phy); 968 list_add_tail(&phy->port_siblings, &port->phy_list); 969 port->num_phys++; 970 } 971 mutex_unlock(&port->phy_list_mutex); 972} 973EXPORT_SYMBOL(sas_port_add_phy); 974 975/** 976 * sas_port_delete_phy - remove a phy from a port or wide port 977 * @port: port to remove the phy from 978 * @phy: phy to remove 979 * 980 * This operation is used for tearing down ports again. It must be 981 * done to every port or wide port before calling sas_port_delete. 982 */ 983void sas_port_delete_phy(struct sas_port *port, struct sas_phy *phy) 984{ 985 mutex_lock(&port->phy_list_mutex); 986 sas_port_delete_link(port, phy); 987 list_del_init(&phy->port_siblings); 988 port->num_phys--; 989 mutex_unlock(&port->phy_list_mutex); 990} 991EXPORT_SYMBOL(sas_port_delete_phy); 992 993void sas_port_mark_backlink(struct sas_port *port) 994{ 995 int res; 996 struct device *parent = port->dev.parent->parent->parent; 997 998 if (port->is_backlink) 999 return; 1000 port->is_backlink = 1; 1001 res = sysfs_create_link(&port->dev.kobj, &parent->kobj, 1002 parent->bus_id); 1003 if (res) 1004 goto err; 1005 return; 1006err: 1007 printk(KERN_ERR "%s: Cannot create port backlink, err=%d\n", 1008 __FUNCTION__, res); 1009 1010} 1011EXPORT_SYMBOL(sas_port_mark_backlink); 1012 1013/* 1014 * SAS remote PHY attributes. 1015 */ 1016 1017#define sas_rphy_show_simple(field, name, format_string, cast) \ 1018static ssize_t \ 1019show_sas_rphy_##name(struct class_device *cdev, char *buf) \ 1020{ \ 1021 struct sas_rphy *rphy = transport_class_to_rphy(cdev); \ 1022 \ 1023 return snprintf(buf, 20, format_string, cast rphy->field); \ 1024} 1025 1026#define sas_rphy_simple_attr(field, name, format_string, type) \ 1027 sas_rphy_show_simple(field, name, format_string, (type)) \ 1028static SAS_CLASS_DEVICE_ATTR(rphy, name, S_IRUGO, \ 1029 show_sas_rphy_##name, NULL) 1030 1031#define sas_rphy_show_protocol(field, name) \ 1032static ssize_t \ 1033show_sas_rphy_##name(struct class_device *cdev, char *buf) \ 1034{ \ 1035 struct sas_rphy *rphy = transport_class_to_rphy(cdev); \ 1036 \ 1037 if (!rphy->field) \ 1038 return snprintf(buf, 20, "none\n"); \ 1039 return get_sas_protocol_names(rphy->field, buf); \ 1040} 1041 1042#define sas_rphy_protocol_attr(field, name) \ 1043 sas_rphy_show_protocol(field, name) \ 1044static SAS_CLASS_DEVICE_ATTR(rphy, name, S_IRUGO, \ 1045 show_sas_rphy_##name, NULL) 1046 1047static ssize_t 1048show_sas_rphy_device_type(struct class_device *cdev, char *buf) 1049{ 1050 struct sas_rphy *rphy = transport_class_to_rphy(cdev); 1051 1052 if (!rphy->identify.device_type) 1053 return snprintf(buf, 20, "none\n"); 1054 return get_sas_device_type_names( 1055 rphy->identify.device_type, buf); 1056} 1057 1058static SAS_CLASS_DEVICE_ATTR(rphy, device_type, S_IRUGO, 1059 show_sas_rphy_device_type, NULL); 1060 1061static ssize_t 1062show_sas_rphy_enclosure_identifier(struct class_device *cdev, char *buf) 1063{ 1064 struct sas_rphy *rphy = transport_class_to_rphy(cdev); 1065 struct sas_phy *phy = dev_to_phy(rphy->dev.parent); 1066 struct Scsi_Host *shost = dev_to_shost(phy->dev.parent); 1067 struct sas_internal *i = to_sas_internal(shost->transportt); 1068 u64 identifier; 1069 int error; 1070 1071 /* 1072 * Only devices behind an expander are supported, because the 1073 * enclosure identifier is a SMP feature. 1074 */ 1075 if (scsi_is_sas_phy_local(phy)) 1076 return -EINVAL; 1077 1078 error = i->f->get_enclosure_identifier(rphy, &identifier); 1079 if (error) 1080 return error; 1081 return sprintf(buf, "0x%llx\n", (unsigned long long)identifier); 1082} 1083 1084static SAS_CLASS_DEVICE_ATTR(rphy, enclosure_identifier, S_IRUGO, 1085 show_sas_rphy_enclosure_identifier, NULL); 1086 1087static ssize_t 1088show_sas_rphy_bay_identifier(struct class_device *cdev, char *buf) 1089{ 1090 struct sas_rphy *rphy = transport_class_to_rphy(cdev); 1091 struct sas_phy *phy = dev_to_phy(rphy->dev.parent); 1092 struct Scsi_Host *shost = dev_to_shost(phy->dev.parent); 1093 struct sas_internal *i = to_sas_internal(shost->transportt); 1094 int val; 1095 1096 if (scsi_is_sas_phy_local(phy)) 1097 return -EINVAL; 1098 1099 val = i->f->get_bay_identifier(rphy); 1100 if (val < 0) 1101 return val; 1102 return sprintf(buf, "%d\n", val); 1103} 1104 1105static SAS_CLASS_DEVICE_ATTR(rphy, bay_identifier, S_IRUGO, 1106 show_sas_rphy_bay_identifier, NULL); 1107 1108sas_rphy_protocol_attr(identify.initiator_port_protocols, 1109 initiator_port_protocols); 1110sas_rphy_protocol_attr(identify.target_port_protocols, target_port_protocols); 1111sas_rphy_simple_attr(identify.sas_address, sas_address, "0x%016llx\n", 1112 unsigned long long); 1113sas_rphy_simple_attr(identify.phy_identifier, phy_identifier, "%d\n", u8); 1114 1115/* only need 8 bytes of data plus header (4 or 8) */ 1116#define BUF_SIZE 64 1117 1118int sas_read_port_mode_page(struct scsi_device *sdev) 1119{ 1120 char *buffer = kzalloc(BUF_SIZE, GFP_KERNEL), *msdata; 1121 struct sas_rphy *rphy = target_to_rphy(sdev->sdev_target); 1122 struct sas_end_device *rdev; 1123 struct scsi_mode_data mode_data; 1124 int res, error; 1125 1126 BUG_ON(rphy->identify.device_type != SAS_END_DEVICE); 1127 1128 rdev = rphy_to_end_device(rphy); 1129 1130 if (!buffer) 1131 return -ENOMEM; 1132 1133 res = scsi_mode_sense(sdev, 1, 0x19, buffer, BUF_SIZE, 30*HZ, 3, 1134 &mode_data, NULL); 1135 1136 error = -EINVAL; 1137 if (!scsi_status_is_good(res)) 1138 goto out; 1139 1140 msdata = buffer + mode_data.header_length + 1141 mode_data.block_descriptor_length; 1142 1143 if (msdata - buffer > BUF_SIZE - 8) 1144 goto out; 1145 1146 error = 0; 1147 1148 rdev->ready_led_meaning = msdata[2] & 0x10 ? 1 : 0; 1149 rdev->I_T_nexus_loss_timeout = (msdata[4] << 8) + msdata[5]; 1150 rdev->initiator_response_timeout = (msdata[6] << 8) + msdata[7]; 1151 1152 out: 1153 kfree(buffer); 1154 return error; 1155} 1156EXPORT_SYMBOL(sas_read_port_mode_page); 1157 1158static DECLARE_TRANSPORT_CLASS(sas_end_dev_class, 1159 "sas_end_device", NULL, NULL, NULL); 1160 1161#define sas_end_dev_show_simple(field, name, format_string, cast) \ 1162static ssize_t \ 1163show_sas_end_dev_##name(struct class_device *cdev, char *buf) \ 1164{ \ 1165 struct sas_rphy *rphy = transport_class_to_rphy(cdev); \ 1166 struct sas_end_device *rdev = rphy_to_end_device(rphy); \ 1167 \ 1168 return snprintf(buf, 20, format_string, cast rdev->field); \ 1169} 1170 1171#define sas_end_dev_simple_attr(field, name, format_string, type) \ 1172 sas_end_dev_show_simple(field, name, format_string, (type)) \ 1173static SAS_CLASS_DEVICE_ATTR(end_dev, name, S_IRUGO, \ 1174 show_sas_end_dev_##name, NULL) 1175 1176sas_end_dev_simple_attr(ready_led_meaning, ready_led_meaning, "%d\n", int); 1177sas_end_dev_simple_attr(I_T_nexus_loss_timeout, I_T_nexus_loss_timeout, 1178 "%d\n", int); 1179sas_end_dev_simple_attr(initiator_response_timeout, initiator_response_timeout, 1180 "%d\n", int); 1181 1182static DECLARE_TRANSPORT_CLASS(sas_expander_class, 1183 "sas_expander", NULL, NULL, NULL); 1184 1185#define sas_expander_show_simple(field, name, format_string, cast) \ 1186static ssize_t \ 1187show_sas_expander_##name(struct class_device *cdev, char *buf) \ 1188{ \ 1189 struct sas_rphy *rphy = transport_class_to_rphy(cdev); \ 1190 struct sas_expander_device *edev = rphy_to_expander_device(rphy); \ 1191 \ 1192 return snprintf(buf, 20, format_string, cast edev->field); \ 1193} 1194 1195#define sas_expander_simple_attr(field, name, format_string, type) \ 1196 sas_expander_show_simple(field, name, format_string, (type)) \ 1197static SAS_CLASS_DEVICE_ATTR(expander, name, S_IRUGO, \ 1198 show_sas_expander_##name, NULL) 1199 1200sas_expander_simple_attr(vendor_id, vendor_id, "%s\n", char *); 1201sas_expander_simple_attr(product_id, product_id, "%s\n", char *); 1202sas_expander_simple_attr(product_rev, product_rev, "%s\n", char *); 1203sas_expander_simple_attr(component_vendor_id, component_vendor_id, 1204 "%s\n", char *); 1205sas_expander_simple_attr(component_id, component_id, "%u\n", unsigned int); 1206sas_expander_simple_attr(component_revision_id, component_revision_id, "%u\n", 1207 unsigned int); 1208sas_expander_simple_attr(level, level, "%d\n", int); 1209 1210static DECLARE_TRANSPORT_CLASS(sas_rphy_class, 1211 "sas_device", NULL, NULL, NULL); 1212 1213static int sas_rphy_match(struct attribute_container *cont, struct device *dev) 1214{ 1215 struct Scsi_Host *shost; 1216 struct sas_internal *i; 1217 1218 if (!scsi_is_sas_rphy(dev)) 1219 return 0; 1220 shost = dev_to_shost(dev->parent->parent); 1221 1222 if (!shost->transportt) 1223 return 0; 1224 if (shost->transportt->host_attrs.ac.class != 1225 &sas_host_class.class) 1226 return 0; 1227 1228 i = to_sas_internal(shost->transportt); 1229 return &i->rphy_attr_cont.ac == cont; 1230} 1231 1232static int sas_end_dev_match(struct attribute_container *cont, 1233 struct device *dev) 1234{ 1235 struct Scsi_Host *shost; 1236 struct sas_internal *i; 1237 struct sas_rphy *rphy; 1238 1239 if (!scsi_is_sas_rphy(dev)) 1240 return 0; 1241 shost = dev_to_shost(dev->parent->parent); 1242 rphy = dev_to_rphy(dev); 1243 1244 if (!shost->transportt) 1245 return 0; 1246 if (shost->transportt->host_attrs.ac.class != 1247 &sas_host_class.class) 1248 return 0; 1249 1250 i = to_sas_internal(shost->transportt); 1251 return &i->end_dev_attr_cont.ac == cont && 1252 rphy->identify.device_type == SAS_END_DEVICE; 1253} 1254 1255static int sas_expander_match(struct attribute_container *cont, 1256 struct device *dev) 1257{ 1258 struct Scsi_Host *shost; 1259 struct sas_internal *i; 1260 struct sas_rphy *rphy; 1261 1262 if (!scsi_is_sas_rphy(dev)) 1263 return 0; 1264 shost = dev_to_shost(dev->parent->parent); 1265 rphy = dev_to_rphy(dev); 1266 1267 if (!shost->transportt) 1268 return 0; 1269 if (shost->transportt->host_attrs.ac.class != 1270 &sas_host_class.class) 1271 return 0; 1272 1273 i = to_sas_internal(shost->transportt); 1274 return &i->expander_attr_cont.ac == cont && 1275 (rphy->identify.device_type == SAS_EDGE_EXPANDER_DEVICE || 1276 rphy->identify.device_type == SAS_FANOUT_EXPANDER_DEVICE); 1277} 1278 1279static void sas_expander_release(struct device *dev) 1280{ 1281 struct sas_rphy *rphy = dev_to_rphy(dev); 1282 struct sas_expander_device *edev = rphy_to_expander_device(rphy); 1283 1284 put_device(dev->parent); 1285 kfree(edev); 1286} 1287 1288static void sas_end_device_release(struct device *dev) 1289{ 1290 struct sas_rphy *rphy = dev_to_rphy(dev); 1291 struct sas_end_device *edev = rphy_to_end_device(rphy); 1292 1293 put_device(dev->parent); 1294 kfree(edev); 1295} 1296 1297/** 1298 * sas_rphy_initialize - common rphy intialization 1299 * @rphy: rphy to initialise 1300 * 1301 * Used by both sas_end_device_alloc() and sas_expander_alloc() to 1302 * initialise the common rphy component of each. 1303 */ 1304static void sas_rphy_initialize(struct sas_rphy *rphy) 1305{ 1306 INIT_LIST_HEAD(&rphy->list); 1307} 1308 1309/** 1310 * sas_end_device_alloc - allocate an rphy for an end device 1311 * @parent: which port 1312 * 1313 * Allocates an SAS remote PHY structure, connected to @parent. 1314 * 1315 * Returns: 1316 * SAS PHY allocated or %NULL if the allocation failed. 1317 */ 1318struct sas_rphy *sas_end_device_alloc(struct sas_port *parent) 1319{ 1320 struct Scsi_Host *shost = dev_to_shost(&parent->dev); 1321 struct sas_end_device *rdev; 1322 1323 rdev = kzalloc(sizeof(*rdev), GFP_KERNEL); 1324 if (!rdev) { 1325 return NULL; 1326 } 1327 1328 device_initialize(&rdev->rphy.dev); 1329 rdev->rphy.dev.parent = get_device(&parent->dev); 1330 rdev->rphy.dev.release = sas_end_device_release; 1331 if (scsi_is_sas_expander_device(parent->dev.parent)) { 1332 struct sas_rphy *rphy = dev_to_rphy(parent->dev.parent); 1333 sprintf(rdev->rphy.dev.bus_id, "end_device-%d:%d:%d", 1334 shost->host_no, rphy->scsi_target_id, parent->port_identifier); 1335 } else 1336 sprintf(rdev->rphy.dev.bus_id, "end_device-%d:%d", 1337 shost->host_no, parent->port_identifier); 1338 rdev->rphy.identify.device_type = SAS_END_DEVICE; 1339 sas_rphy_initialize(&rdev->rphy); 1340 transport_setup_device(&rdev->rphy.dev); 1341 1342 return &rdev->rphy; 1343} 1344EXPORT_SYMBOL(sas_end_device_alloc); 1345 1346/** 1347 * sas_expander_alloc - allocate an rphy for an end device 1348 * @parent: which port 1349 * @type: SAS_EDGE_EXPANDER_DEVICE or SAS_FANOUT_EXPANDER_DEVICE 1350 * 1351 * Allocates an SAS remote PHY structure, connected to @parent. 1352 * 1353 * Returns: 1354 * SAS PHY allocated or %NULL if the allocation failed. 1355 */ 1356struct sas_rphy *sas_expander_alloc(struct sas_port *parent, 1357 enum sas_device_type type) 1358{ 1359 struct Scsi_Host *shost = dev_to_shost(&parent->dev); 1360 struct sas_expander_device *rdev; 1361 struct sas_host_attrs *sas_host = to_sas_host_attrs(shost); 1362 1363 BUG_ON(type != SAS_EDGE_EXPANDER_DEVICE && 1364 type != SAS_FANOUT_EXPANDER_DEVICE); 1365 1366 rdev = kzalloc(sizeof(*rdev), GFP_KERNEL); 1367 if (!rdev) { 1368 return NULL; 1369 } 1370 1371 device_initialize(&rdev->rphy.dev); 1372 rdev->rphy.dev.parent = get_device(&parent->dev); 1373 rdev->rphy.dev.release = sas_expander_release; 1374 mutex_lock(&sas_host->lock); 1375 rdev->rphy.scsi_target_id = sas_host->next_expander_id++; 1376 mutex_unlock(&sas_host->lock); 1377 sprintf(rdev->rphy.dev.bus_id, "expander-%d:%d", 1378 shost->host_no, rdev->rphy.scsi_target_id); 1379 rdev->rphy.identify.device_type = type; 1380 sas_rphy_initialize(&rdev->rphy); 1381 transport_setup_device(&rdev->rphy.dev); 1382 1383 return &rdev->rphy; 1384} 1385EXPORT_SYMBOL(sas_expander_alloc); 1386 1387/** 1388 * sas_rphy_add - add a SAS remote PHY to the device hierarchy 1389 * @rphy: The remote PHY to be added 1390 * 1391 * Publishes a SAS remote PHY to the rest of the system. 1392 */ 1393int sas_rphy_add(struct sas_rphy *rphy) 1394{ 1395 struct sas_port *parent = dev_to_sas_port(rphy->dev.parent); 1396 struct Scsi_Host *shost = dev_to_shost(parent->dev.parent); 1397 struct sas_host_attrs *sas_host = to_sas_host_attrs(shost); 1398 struct sas_identify *identify = &rphy->identify; 1399 int error; 1400 1401 if (parent->rphy) 1402 return -ENXIO; 1403 parent->rphy = rphy; 1404 1405 error = device_add(&rphy->dev); 1406 if (error) 1407 return error; 1408 transport_add_device(&rphy->dev); 1409 transport_configure_device(&rphy->dev); 1410 if (sas_bsg_initialize(shost, rphy)) 1411 printk("fail to a bsg device %s\n", rphy->dev.bus_id); 1412 1413 1414 mutex_lock(&sas_host->lock); 1415 list_add_tail(&rphy->list, &sas_host->rphy_list); 1416 if (identify->device_type == SAS_END_DEVICE && 1417 (identify->target_port_protocols & 1418 (SAS_PROTOCOL_SSP|SAS_PROTOCOL_STP|SAS_PROTOCOL_SATA))) 1419 rphy->scsi_target_id = sas_host->next_target_id++; 1420 else if (identify->device_type == SAS_END_DEVICE) 1421 rphy->scsi_target_id = -1; 1422 mutex_unlock(&sas_host->lock); 1423 1424 if (identify->device_type == SAS_END_DEVICE && 1425 rphy->scsi_target_id != -1) { 1426 scsi_scan_target(&rphy->dev, 0, 1427 rphy->scsi_target_id, SCAN_WILD_CARD, 0); 1428 } 1429 1430 return 0; 1431} 1432EXPORT_SYMBOL(sas_rphy_add); 1433 1434/** 1435 * sas_rphy_free - free a SAS remote PHY 1436 * @rphy: SAS remote PHY to free 1437 * 1438 * Frees the specified SAS remote PHY. 1439 * 1440 * Note: 1441 * This function must only be called on a remote 1442 * PHY that has not sucessfully been added using 1443 * sas_rphy_add() (or has been sas_rphy_remove()'d) 1444 */ 1445void sas_rphy_free(struct sas_rphy *rphy) 1446{ 1447 struct device *dev = &rphy->dev; 1448 struct Scsi_Host *shost = dev_to_shost(rphy->dev.parent->parent); 1449 struct sas_host_attrs *sas_host = to_sas_host_attrs(shost); 1450 1451 mutex_lock(&sas_host->lock); 1452 list_del(&rphy->list); 1453 mutex_unlock(&sas_host->lock); 1454 1455 sas_bsg_remove(shost, rphy); 1456 1457 transport_destroy_device(dev); 1458 1459 put_device(dev); 1460} 1461EXPORT_SYMBOL(sas_rphy_free); 1462 1463/** 1464 * sas_rphy_delete - remove and free SAS remote PHY 1465 * @rphy: SAS remote PHY to remove and free 1466 * 1467 * Removes the specified SAS remote PHY and frees it. 1468 */ 1469void 1470sas_rphy_delete(struct sas_rphy *rphy) 1471{ 1472 sas_rphy_remove(rphy); 1473 sas_rphy_free(rphy); 1474} 1475EXPORT_SYMBOL(sas_rphy_delete); 1476 1477/** 1478 * sas_rphy_remove - remove SAS remote PHY 1479 * @rphy: SAS remote phy to remove 1480 * 1481 * Removes the specified SAS remote PHY. 1482 */ 1483void 1484sas_rphy_remove(struct sas_rphy *rphy) 1485{ 1486 struct device *dev = &rphy->dev; 1487 struct sas_port *parent = dev_to_sas_port(dev->parent); 1488 1489 switch (rphy->identify.device_type) { 1490 case SAS_END_DEVICE: 1491 scsi_remove_target(dev); 1492 break; 1493 case SAS_EDGE_EXPANDER_DEVICE: 1494 case SAS_FANOUT_EXPANDER_DEVICE: 1495 sas_remove_children(dev); 1496 break; 1497 default: 1498 break; 1499 } 1500 1501 transport_remove_device(dev); 1502 device_del(dev); 1503 1504 parent->rphy = NULL; 1505} 1506EXPORT_SYMBOL(sas_rphy_remove); 1507 1508/** 1509 * scsi_is_sas_rphy - check if a struct device represents a SAS remote PHY 1510 * @dev: device to check 1511 * 1512 * Returns: 1513 * %1 if the device represents a SAS remote PHY, %0 else 1514 */ 1515int scsi_is_sas_rphy(const struct device *dev) 1516{ 1517 return dev->release == sas_end_device_release || 1518 dev->release == sas_expander_release; 1519} 1520EXPORT_SYMBOL(scsi_is_sas_rphy); 1521 1522 1523/* 1524 * SCSI scan helper 1525 */ 1526 1527static int sas_user_scan(struct Scsi_Host *shost, uint channel, 1528 uint id, uint lun) 1529{ 1530 struct sas_host_attrs *sas_host = to_sas_host_attrs(shost); 1531 struct sas_rphy *rphy; 1532 1533 mutex_lock(&sas_host->lock); 1534 list_for_each_entry(rphy, &sas_host->rphy_list, list) { 1535 if (rphy->identify.device_type != SAS_END_DEVICE || 1536 rphy->scsi_target_id == -1) 1537 continue; 1538 1539 if ((channel == SCAN_WILD_CARD || channel == 0) && 1540 (id == SCAN_WILD_CARD || id == rphy->scsi_target_id)) { 1541 scsi_scan_target(&rphy->dev, 0, 1542 rphy->scsi_target_id, lun, 1); 1543 } 1544 } 1545 mutex_unlock(&sas_host->lock); 1546 1547 return 0; 1548} 1549 1550 1551/* 1552 * Setup / Teardown code 1553 */ 1554 1555#define SETUP_TEMPLATE(attrb, field, perm, test) \ 1556 i->private_##attrb[count] = class_device_attr_##field; \ 1557 i->private_##attrb[count].attr.mode = perm; \ 1558 i->attrb[count] = &i->private_##attrb[count]; \ 1559 if (test) \ 1560 count++ 1561 1562#define SETUP_TEMPLATE_RW(attrb, field, perm, test, ro_test, ro_perm) \ 1563 i->private_##attrb[count] = class_device_attr_##field; \ 1564 i->private_##attrb[count].attr.mode = perm; \ 1565 if (ro_test) { \ 1566 i->private_##attrb[count].attr.mode = ro_perm; \ 1567 i->private_##attrb[count].store = NULL; \ 1568 } \ 1569 i->attrb[count] = &i->private_##attrb[count]; \ 1570 if (test) \ 1571 count++ 1572 1573#define SETUP_RPORT_ATTRIBUTE(field) \ 1574 SETUP_TEMPLATE(rphy_attrs, field, S_IRUGO, 1) 1575 1576#define SETUP_OPTIONAL_RPORT_ATTRIBUTE(field, func) \ 1577 SETUP_TEMPLATE(rphy_attrs, field, S_IRUGO, i->f->func) 1578 1579#define SETUP_PHY_ATTRIBUTE(field) \ 1580 SETUP_TEMPLATE(phy_attrs, field, S_IRUGO, 1) 1581 1582#define SETUP_PHY_ATTRIBUTE_RW(field) \ 1583 SETUP_TEMPLATE_RW(phy_attrs, field, S_IRUGO | S_IWUSR, 1, \ 1584 !i->f->set_phy_speed, S_IRUGO) 1585 1586#define SETUP_OPTIONAL_PHY_ATTRIBUTE_RW(field, func) \ 1587 SETUP_TEMPLATE_RW(phy_attrs, field, S_IRUGO | S_IWUSR, 1, \ 1588 !i->f->func, S_IRUGO) 1589 1590#define SETUP_PORT_ATTRIBUTE(field) \ 1591 SETUP_TEMPLATE(port_attrs, field, S_IRUGO, 1) 1592 1593#define SETUP_OPTIONAL_PHY_ATTRIBUTE(field, func) \ 1594 SETUP_TEMPLATE(phy_attrs, field, S_IRUGO, i->f->func) 1595 1596#define SETUP_PHY_ATTRIBUTE_WRONLY(field) \ 1597 SETUP_TEMPLATE(phy_attrs, field, S_IWUSR, 1) 1598 1599#define SETUP_OPTIONAL_PHY_ATTRIBUTE_WRONLY(field, func) \ 1600 SETUP_TEMPLATE(phy_attrs, field, S_IWUSR, i->f->func) 1601 1602#define SETUP_END_DEV_ATTRIBUTE(field) \ 1603 SETUP_TEMPLATE(end_dev_attrs, field, S_IRUGO, 1) 1604 1605#define SETUP_EXPANDER_ATTRIBUTE(field) \ 1606 SETUP_TEMPLATE(expander_attrs, expander_##field, S_IRUGO, 1) 1607 1608/** 1609 * sas_attach_transport - instantiate SAS transport template 1610 * @ft: SAS transport class function template 1611 */ 1612struct scsi_transport_template * 1613sas_attach_transport(struct sas_function_template *ft) 1614{ 1615 struct sas_internal *i; 1616 int count; 1617 1618 i = kzalloc(sizeof(struct sas_internal), GFP_KERNEL); 1619 if (!i) 1620 return NULL; 1621 1622 i->t.user_scan = sas_user_scan; 1623 1624 i->t.host_attrs.ac.attrs = &i->host_attrs[0]; 1625 i->t.host_attrs.ac.class = &sas_host_class.class; 1626 i->t.host_attrs.ac.match = sas_host_match; 1627 transport_container_register(&i->t.host_attrs); 1628 i->t.host_size = sizeof(struct sas_host_attrs); 1629 1630 i->phy_attr_cont.ac.class = &sas_phy_class.class; 1631 i->phy_attr_cont.ac.attrs = &i->phy_attrs[0]; 1632 i->phy_attr_cont.ac.match = sas_phy_match; 1633 transport_container_register(&i->phy_attr_cont); 1634 1635 i->port_attr_cont.ac.class = &sas_port_class.class; 1636 i->port_attr_cont.ac.attrs = &i->port_attrs[0]; 1637 i->port_attr_cont.ac.match = sas_port_match; 1638 transport_container_register(&i->port_attr_cont); 1639 1640 i->rphy_attr_cont.ac.class = &sas_rphy_class.class; 1641 i->rphy_attr_cont.ac.attrs = &i->rphy_attrs[0]; 1642 i->rphy_attr_cont.ac.match = sas_rphy_match; 1643 transport_container_register(&i->rphy_attr_cont); 1644 1645 i->end_dev_attr_cont.ac.class = &sas_end_dev_class.class; 1646 i->end_dev_attr_cont.ac.attrs = &i->end_dev_attrs[0]; 1647 i->end_dev_attr_cont.ac.match = sas_end_dev_match; 1648 transport_container_register(&i->end_dev_attr_cont); 1649 1650 i->expander_attr_cont.ac.class = &sas_expander_class.class; 1651 i->expander_attr_cont.ac.attrs = &i->expander_attrs[0]; 1652 i->expander_attr_cont.ac.match = sas_expander_match; 1653 transport_container_register(&i->expander_attr_cont); 1654 1655 i->f = ft; 1656 1657 count = 0; 1658 SETUP_PORT_ATTRIBUTE(num_phys); 1659 i->host_attrs[count] = NULL; 1660 1661 count = 0; 1662 SETUP_PHY_ATTRIBUTE(initiator_port_protocols); 1663 SETUP_PHY_ATTRIBUTE(target_port_protocols); 1664 SETUP_PHY_ATTRIBUTE(device_type); 1665 SETUP_PHY_ATTRIBUTE(sas_address); 1666 SETUP_PHY_ATTRIBUTE(phy_identifier); 1667 //SETUP_PHY_ATTRIBUTE(port_identifier); 1668 SETUP_PHY_ATTRIBUTE(negotiated_linkrate); 1669 SETUP_PHY_ATTRIBUTE(minimum_linkrate_hw); 1670 SETUP_PHY_ATTRIBUTE_RW(minimum_linkrate); 1671 SETUP_PHY_ATTRIBUTE(maximum_linkrate_hw); 1672 SETUP_PHY_ATTRIBUTE_RW(maximum_linkrate); 1673 1674 SETUP_PHY_ATTRIBUTE(invalid_dword_count); 1675 SETUP_PHY_ATTRIBUTE(running_disparity_error_count); 1676 SETUP_PHY_ATTRIBUTE(loss_of_dword_sync_count); 1677 SETUP_PHY_ATTRIBUTE(phy_reset_problem_count); 1678 SETUP_OPTIONAL_PHY_ATTRIBUTE_WRONLY(link_reset, phy_reset); 1679 SETUP_OPTIONAL_PHY_ATTRIBUTE_WRONLY(hard_reset, phy_reset); 1680 SETUP_OPTIONAL_PHY_ATTRIBUTE_RW(enable, phy_enable); 1681 i->phy_attrs[count] = NULL; 1682 1683 count = 0; 1684 SETUP_PORT_ATTRIBUTE(num_phys); 1685 i->port_attrs[count] = NULL; 1686 1687 count = 0; 1688 SETUP_RPORT_ATTRIBUTE(rphy_initiator_port_protocols); 1689 SETUP_RPORT_ATTRIBUTE(rphy_target_port_protocols); 1690 SETUP_RPORT_ATTRIBUTE(rphy_device_type); 1691 SETUP_RPORT_ATTRIBUTE(rphy_sas_address); 1692 SETUP_RPORT_ATTRIBUTE(rphy_phy_identifier); 1693 SETUP_OPTIONAL_RPORT_ATTRIBUTE(rphy_enclosure_identifier, 1694 get_enclosure_identifier); 1695 SETUP_OPTIONAL_RPORT_ATTRIBUTE(rphy_bay_identifier, 1696 get_bay_identifier); 1697 i->rphy_attrs[count] = NULL; 1698 1699 count = 0; 1700 SETUP_END_DEV_ATTRIBUTE(end_dev_ready_led_meaning); 1701 SETUP_END_DEV_ATTRIBUTE(end_dev_I_T_nexus_loss_timeout); 1702 SETUP_END_DEV_ATTRIBUTE(end_dev_initiator_response_timeout); 1703 i->end_dev_attrs[count] = NULL; 1704 1705 count = 0; 1706 SETUP_EXPANDER_ATTRIBUTE(vendor_id); 1707 SETUP_EXPANDER_ATTRIBUTE(product_id); 1708 SETUP_EXPANDER_ATTRIBUTE(product_rev); 1709 SETUP_EXPANDER_ATTRIBUTE(component_vendor_id); 1710 SETUP_EXPANDER_ATTRIBUTE(component_id); 1711 SETUP_EXPANDER_ATTRIBUTE(component_revision_id); 1712 SETUP_EXPANDER_ATTRIBUTE(level); 1713 i->expander_attrs[count] = NULL; 1714 1715 return &i->t; 1716} 1717EXPORT_SYMBOL(sas_attach_transport); 1718 1719/** 1720 * sas_release_transport - release SAS transport template instance 1721 * @t: transport template instance 1722 */ 1723void sas_release_transport(struct scsi_transport_template *t) 1724{ 1725 struct sas_internal *i = to_sas_internal(t); 1726 1727 transport_container_unregister(&i->t.host_attrs); 1728 transport_container_unregister(&i->phy_attr_cont); 1729 transport_container_unregister(&i->port_attr_cont); 1730 transport_container_unregister(&i->rphy_attr_cont); 1731 transport_container_unregister(&i->end_dev_attr_cont); 1732 transport_container_unregister(&i->expander_attr_cont); 1733 1734 kfree(i); 1735} 1736EXPORT_SYMBOL(sas_release_transport); 1737 1738static __init int sas_transport_init(void) 1739{ 1740 int error; 1741 1742 error = transport_class_register(&sas_host_class); 1743 if (error) 1744 goto out; 1745 error = transport_class_register(&sas_phy_class); 1746 if (error) 1747 goto out_unregister_transport; 1748 error = transport_class_register(&sas_port_class); 1749 if (error) 1750 goto out_unregister_phy; 1751 error = transport_class_register(&sas_rphy_class); 1752 if (error) 1753 goto out_unregister_port; 1754 error = transport_class_register(&sas_end_dev_class); 1755 if (error) 1756 goto out_unregister_rphy; 1757 error = transport_class_register(&sas_expander_class); 1758 if (error) 1759 goto out_unregister_end_dev; 1760 1761 return 0; 1762 1763 out_unregister_end_dev: 1764 transport_class_unregister(&sas_end_dev_class); 1765 out_unregister_rphy: 1766 transport_class_unregister(&sas_rphy_class); 1767 out_unregister_port: 1768 transport_class_unregister(&sas_port_class); 1769 out_unregister_phy: 1770 transport_class_unregister(&sas_phy_class); 1771 out_unregister_transport: 1772 transport_class_unregister(&sas_host_class); 1773 out: 1774 return error; 1775 1776} 1777 1778static void __exit sas_transport_exit(void) 1779{ 1780 transport_class_unregister(&sas_host_class); 1781 transport_class_unregister(&sas_phy_class); 1782 transport_class_unregister(&sas_port_class); 1783 transport_class_unregister(&sas_rphy_class); 1784 transport_class_unregister(&sas_end_dev_class); 1785 transport_class_unregister(&sas_expander_class); 1786} 1787 1788MODULE_AUTHOR("Christoph Hellwig"); 1789MODULE_DESCRIPTION("SAS Transport Attributes"); 1790MODULE_LICENSE("GPL"); 1791 1792module_init(sas_transport_init); 1793module_exit(sas_transport_exit); 1794