1 /* 2 * CDDL HEADER START 3 * 4 * The contents of this file are subject to the terms of the 5 * Common Development and Distribution License (the "License"). 6 * You may not use this file except in compliance with the License. 7 * 8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 9 * or http://www.opensolaris.org/os/licensing. 10 * See the License for the specific language governing permissions 11 * and limitations under the License. 12 * 13 * When distributing Covered Code, include this CDDL HEADER in each 14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 15 * If applicable, add the following below this CDDL HEADER, with the 16 * fields enclosed by brackets "[]" replaced with your own identifying 17 * information: Portions Copyright [yyyy] [name of copyright owner] 18 * 19 * CDDL HEADER END 20 */ 21 22 /* 23 * Copyright (c) 1994, 2010, Oracle and/or its affiliates. All rights reserved. 24 * Copyright 2014 Garrett D'Amore <garrett@damore.org> 25 * Copyright (c) 2016 by Delphix. All rights reserved. 26 * Copyright 2022 RackTop Systems, Inc. 27 * Copyright 2023 Oxide Computer Company 28 */ 29 30 #include <sys/note.h> 31 32 /* 33 * Generic SCSI Host Bus Adapter interface implementation 34 */ 35 #include <sys/scsi/scsi.h> 36 #include <sys/scsi/generic/sas.h> 37 #include <sys/file.h> 38 #include <sys/disp.h> /* for minclsyspri */ 39 #include <sys/ddi_impldefs.h> 40 #include <sys/ndi_impldefs.h> 41 #include <sys/sunndi.h> 42 #include <sys/ddi.h> 43 #include <sys/sunmdi.h> 44 #include <sys/mdi_impldefs.h> 45 #include <sys/callb.h> 46 #include <sys/epm.h> 47 #include <sys/damap.h> 48 #include <sys/time.h> 49 #include <sys/sunldi.h> 50 #include <sys/fm/protocol.h> 51 52 extern struct scsi_pkt *scsi_init_cache_pkt(struct scsi_address *, 53 struct scsi_pkt *, struct buf *, int, int, int, int, 54 int (*)(caddr_t), caddr_t); 55 extern void scsi_free_cache_pkt(struct scsi_address *, struct scsi_pkt *); 56 extern void scsi_cache_dmafree(struct scsi_address *, struct scsi_pkt *); 57 extern void scsi_sync_cache_pkt(struct scsi_address *, struct scsi_pkt *); 58 extern int modrootloaded; 59 60 /* 61 * Round up all allocations so that we can guarantee 62 * long-long alignment. This is the same alignment 63 * provided by kmem_alloc(). 64 */ 65 #define ROUNDUP(x) (((x) + 0x07) & ~0x07) 66 67 /* Magic number to track correct allocations in wrappers */ 68 #define PKT_WRAPPER_MAGIC 0xa110ced /* alloced correctly */ 69 70 kmutex_t scsi_flag_nointr_mutex; 71 kcondvar_t scsi_flag_nointr_cv; 72 kmutex_t scsi_log_mutex; 73 74 /* asynchronous probe barrier deletion data structures */ 75 static kmutex_t scsi_hba_barrier_mutex; 76 static kcondvar_t scsi_hba_barrier_cv; 77 static struct scsi_hba_barrier { 78 struct scsi_hba_barrier *barrier_next; 79 clock_t barrier_endtime; 80 dev_info_t *barrier_probe; 81 } *scsi_hba_barrier_list; 82 static int scsi_hba_devi_is_barrier(dev_info_t *probe); 83 static void scsi_hba_barrier_tran_tgt_free(dev_info_t *probe); 84 static void scsi_hba_barrier_add(dev_info_t *probe, int seconds); 85 static int scsi_hba_remove_node(dev_info_t *child); 86 static void scsi_hba_barrier_daemon(void *arg); 87 88 /* LUN-change ASC/ASCQ processing data structures (stage1 and stage2) */ 89 static kmutex_t scsi_lunchg1_mutex; 90 static kcondvar_t scsi_lunchg1_cv; 91 static struct scsi_pkt *scsi_lunchg1_list; 92 static void scsi_lunchg1_daemon(void *arg); 93 static kmutex_t scsi_lunchg2_mutex; 94 static kcondvar_t scsi_lunchg2_cv; 95 static struct scsi_lunchg2 { 96 struct scsi_lunchg2 *lunchg2_next; 97 char *lunchg2_path; 98 } *scsi_lunchg2_list; 99 static void scsi_lunchg2_daemon(void *arg); 100 101 static int scsi_findchild(dev_info_t *self, char *name, char *addr, 102 int init, dev_info_t **dchildp, mdi_pathinfo_t **pchildp, int *ppi); 103 104 /* return value defines for scsi_findchild */ 105 #define CHILD_TYPE_NONE 0 106 #define CHILD_TYPE_DEVINFO 1 107 #define CHILD_TYPE_PATHINFO 2 108 109 /* 110 * Enumeration code path currently being followed. SE_BUSCONFIG results in 111 * DEVI_SID_NODEID, and SE_HP (hotplug) results in DEVI_SID_HP_NODEID. 112 * 113 * Since hotplug enumeration is based on information obtained from hardware 114 * (tgtmap/report_lun) the type/severity of enumeration error messages is 115 * sometimes based SE_HP (indirectly via ndi_dev_is_hotplug_node()). By 116 * convention, these messages are all produced by scsi_enumeration_failed(). 117 */ 118 typedef enum { SE_BUSCONFIG = 0, SE_HP = 1 } scsi_enum_t; 119 120 /* compatible properties of driver to use during probe/enumeration operations */ 121 static char *compatible_probe = "scsa,probe"; 122 static char *compatible_nodev = "scsa,nodev"; 123 static char *scsi_probe_ascii[] = SCSIPROBE_ASCII; 124 125 /* number of LUNs we attempt to get on the first SCMD_REPORT_LUNS command */ 126 int scsi_lunrpt_default_max = 256; 127 int scsi_lunrpt_timeout = 3; /* seconds */ 128 129 /* 130 * Only enumerate one lun if reportluns fails on a SCSI_VERSION_3 device 131 * (tunable based on calling context). 132 */ 133 int scsi_lunrpt_failed_do1lun = (1 << SE_HP); 134 135 /* 'scsi-binding-set' value for legacy enumerated 'spi' transports */ 136 char *scsi_binding_set_spi = "spi"; 137 138 /* enable NDI_DEVI_DEBUG for bus_[un]config operations */ 139 int scsi_hba_bus_config_debug = 0; 140 141 /* DEBUG: enable NDI_DEVI_REMOVE for bus_unconfig of dynamic node */ 142 int scsi_hba_bus_unconfig_remove = 0; 143 144 /* number of probe serilization messages */ 145 int scsi_hba_wait_msg = 5; 146 147 /* 148 * Establish the timeout used to cache (in the probe node) the fact that the 149 * device does not exist. This replaces the target specific probe cache. 150 */ 151 int scsi_hba_barrier_timeout = (60); /* seconds */ 152 153 #ifdef DEBUG 154 int scsi_hba_bus_config_failure_msg = 0; 155 int scsi_hba_bus_config_failure_dbg = 0; 156 int scsi_hba_bus_config_success_msg = 0; 157 int scsi_hba_bus_config_success_dbg = 0; 158 #endif /* DEBUG */ 159 160 /* 161 * Structure for scsi_hba_iportmap_* implementation/wrap. 162 */ 163 typedef struct impl_scsi_iportmap { 164 dev_info_t *iportmap_hba_dip; 165 damap_t *iportmap_dam; 166 int iportmap_create_window; 167 uint64_t iportmap_create_time; /* clock64_t */ 168 int iportmap_create_csync_usec; 169 int iportmap_settle_usec; 170 int iportmap_sync_cnt; 171 } impl_scsi_iportmap_t; 172 173 /* 174 * Structure for scsi_hba_tgtmap_* implementation/wrap. 175 * 176 * Every call to scsi_hba_tgtmap_set_begin will increment tgtmap_reports, 177 * and a call to scsi_hba_tgtmap_set_end will reset tgtmap_reports to zero. 178 * If, in scsi_hba_tgtmap_set_begin, we detect a tgtmap_reports value of 179 * scsi_hba_tgtmap_reports_max we produce a message to indicate that 180 * the caller is never completing an observation (i.e. we are not making 181 * any forward progress). If this message occurs, it indicates that the 182 * solaris hotplug ramifications at the target and lun level are no longer 183 * tracking. 184 * 185 * NOTE: LUNMAPSIZE OK for now, but should be dynamic in reportlun code. 186 */ 187 typedef struct impl_scsi_tgtmap { 188 scsi_hba_tran_t *tgtmap_tran; 189 int tgtmap_reports; /* _begin, no _end */ 190 int tgtmap_noisy; 191 scsi_tgt_activate_cb_t tgtmap_activate_cb; 192 scsi_tgt_deactivate_cb_t tgtmap_deactivate_cb; 193 void *tgtmap_mappriv; 194 damap_t *tgtmap_dam[SCSI_TGT_NTYPES]; 195 int tgtmap_create_window; 196 uint64_t tgtmap_create_time; /* clock64_t */ 197 int tgtmap_create_csync_usec; 198 int tgtmap_settle_usec; 199 int tgtmap_sync_cnt; 200 } impl_scsi_tgtmap_t; 201 #define LUNMAPSIZE 256 /* 256 LUNs/target */ 202 203 /* Produce warning if number of begins without an end exceed this value */ 204 int scsi_hba_tgtmap_reports_max = 256; 205 206 static int scsi_tgtmap_sync(scsi_hba_tgtmap_t *, int); 207 208 /* Default settle_usec damap_sync factor */ 209 int scsi_hba_map_settle_f = 10; 210 211 212 /* Prototype for static dev_ops devo_*() functions */ 213 static int scsi_hba_info( 214 dev_info_t *self, 215 ddi_info_cmd_t infocmd, 216 void *arg, 217 void **result); 218 219 /* Prototypes for static bus_ops bus_*() functions */ 220 static int scsi_hba_bus_ctl( 221 dev_info_t *self, 222 dev_info_t *child, 223 ddi_ctl_enum_t op, 224 void *arg, 225 void *result); 226 227 static int scsi_hba_map_fault( 228 dev_info_t *self, 229 dev_info_t *child, 230 struct hat *hat, 231 struct seg *seg, 232 caddr_t addr, 233 struct devpage *dp, 234 pfn_t pfn, 235 uint_t prot, 236 uint_t lock); 237 238 static int scsi_hba_get_eventcookie( 239 dev_info_t *self, 240 dev_info_t *child, 241 char *name, 242 ddi_eventcookie_t *eventp); 243 244 static int scsi_hba_add_eventcall( 245 dev_info_t *self, 246 dev_info_t *child, 247 ddi_eventcookie_t event, 248 void (*callback)( 249 dev_info_t *dip, 250 ddi_eventcookie_t event, 251 void *arg, 252 void *bus_impldata), 253 void *arg, 254 ddi_callback_id_t *cb_id); 255 256 static int scsi_hba_remove_eventcall( 257 dev_info_t *self, 258 ddi_callback_id_t id); 259 260 static int scsi_hba_post_event( 261 dev_info_t *self, 262 dev_info_t *child, 263 ddi_eventcookie_t event, 264 void *bus_impldata); 265 266 static int scsi_hba_bus_config( 267 dev_info_t *self, 268 uint_t flags, 269 ddi_bus_config_op_t op, 270 void *arg, 271 dev_info_t **childp); 272 273 static int scsi_hba_bus_unconfig( 274 dev_info_t *self, 275 uint_t flags, 276 ddi_bus_config_op_t op, 277 void *arg); 278 279 static int scsi_hba_fm_init_child( 280 dev_info_t *self, 281 dev_info_t *child, 282 int cap, 283 ddi_iblock_cookie_t *ibc); 284 285 static int scsi_hba_bus_power( 286 dev_info_t *self, 287 void *impl_arg, 288 pm_bus_power_op_t op, 289 void *arg, 290 void *result); 291 292 /* bus_ops vector for SCSI HBA's. */ 293 static struct bus_ops scsi_hba_busops = { 294 BUSO_REV, 295 nullbusmap, /* bus_map */ 296 NULL, /* bus_get_intrspec */ 297 NULL, /* bus_add_intrspec */ 298 NULL, /* bus_remove_intrspec */ 299 scsi_hba_map_fault, /* bus_map_fault */ 300 NULL, /* bus_dma_map */ 301 ddi_dma_allochdl, /* bus_dma_allochdl */ 302 ddi_dma_freehdl, /* bus_dma_freehdl */ 303 ddi_dma_bindhdl, /* bus_dma_bindhdl */ 304 ddi_dma_unbindhdl, /* bus_unbindhdl */ 305 ddi_dma_flush, /* bus_dma_flush */ 306 ddi_dma_win, /* bus_dma_win */ 307 ddi_dma_mctl, /* bus_dma_ctl */ 308 scsi_hba_bus_ctl, /* bus_ctl */ 309 ddi_bus_prop_op, /* bus_prop_op */ 310 scsi_hba_get_eventcookie, /* bus_get_eventcookie */ 311 scsi_hba_add_eventcall, /* bus_add_eventcall */ 312 scsi_hba_remove_eventcall, /* bus_remove_eventcall */ 313 scsi_hba_post_event, /* bus_post_event */ 314 NULL, /* bus_intr_ctl */ 315 scsi_hba_bus_config, /* bus_config */ 316 scsi_hba_bus_unconfig, /* bus_unconfig */ 317 scsi_hba_fm_init_child, /* bus_fm_init */ 318 NULL, /* bus_fm_fini */ 319 NULL, /* bus_fm_access_enter */ 320 NULL, /* bus_fm_access_exit */ 321 scsi_hba_bus_power /* bus_power */ 322 }; 323 324 /* cb_ops for hotplug :devctl and :scsi support */ 325 static struct cb_ops scsi_hba_cbops = { 326 scsi_hba_open, 327 scsi_hba_close, 328 nodev, /* strategy */ 329 nodev, /* print */ 330 nodev, /* dump */ 331 nodev, /* read */ 332 nodev, /* write */ 333 scsi_hba_ioctl, /* ioctl */ 334 nodev, /* devmap */ 335 nodev, /* mmap */ 336 nodev, /* segmap */ 337 nochpoll, /* poll */ 338 ddi_prop_op, /* prop_op */ 339 NULL, /* stream */ 340 D_NEW|D_MP|D_HOTPLUG, /* cb_flag */ 341 CB_REV, /* rev */ 342 nodev, /* int (*cb_aread)() */ 343 nodev /* int (*cb_awrite)() */ 344 }; 345 346 /* Prototypes for static scsi_hba.c/SCSA private lunmap interfaces */ 347 static int scsi_lunmap_create( 348 dev_info_t *self, 349 impl_scsi_tgtmap_t *tgtmap, 350 char *tgt_addr); 351 static void scsi_lunmap_destroy( 352 dev_info_t *self, 353 impl_scsi_tgtmap_t *tgtmap, 354 char *tgt_addr); 355 static void scsi_lunmap_set_begin( 356 dev_info_t *self, 357 damap_t *lundam); 358 static int scsi_lunmap_set_add( 359 dev_info_t *self, 360 damap_t *lundam, 361 char *taddr, 362 scsi_lun64_t lun_num, 363 int lun_sfunc); 364 static void scsi_lunmap_set_end( 365 dev_info_t *self, 366 damap_t *lundam); 367 368 /* Prototypes for static misc. scsi_hba.c private bus_config interfaces */ 369 static int scsi_hba_bus_config_iports(dev_info_t *self, uint_t flags, 370 ddi_bus_config_op_t op, void *arg, dev_info_t **childp); 371 static int scsi_hba_bus_config_spi(dev_info_t *self, uint_t flags, 372 ddi_bus_config_op_t op, void *arg, dev_info_t **childp); 373 static dev_info_t *scsi_hba_bus_config_port(dev_info_t *self, 374 char *nameaddr, scsi_enum_t se); 375 376 #ifdef sparc 377 static int scsi_hba_bus_config_prom_node(dev_info_t *self, uint_t flags, 378 void *arg, dev_info_t **childp); 379 #endif /* sparc */ 380 381 382 /* 383 * SCSI_HBA_LOG is used for all messages. A logging level is specified when 384 * generating a message. Some levels correspond directly to cmn_err levels, 385 * some are associated with increasing levels diagnostic/debug output (LOG1-4), 386 * and others are associated with specific levels of interface (LOGMAP). 387 * For _LOG() messages, a __func__ prefix will identify the function origin 388 * of the message. For _LOG_NF messages, there is no function prefix or 389 * self/child context. Filtering of messages is provided based on logging 390 * level, but messages with cmn_err logging level and messages generated 391 * generated with _LOG_NF() are never filtered. 392 * 393 * For debugging, more complete information can be displayed with each message 394 * (full device path and pointer values) by adjusting scsi_hba_log_info. 395 */ 396 /* logging levels */ 397 #define SCSI_HBA_LOGCONT CE_CONT 398 #define SCSI_HBA_LOGNOTE CE_NOTE 399 #define SCSI_HBA_LOGWARN CE_WARN 400 #define SCSI_HBA_LOGPANIC CE_PANIC 401 #define SCSI_HBA_LOGIGNORE CE_IGNORE 402 #define SCSI_HBA_LOG_CE_MASK 0x0000000F /* no filter for these levels */ 403 #define SCSI_HBA_LOG1 0x00000010 /* DIAG1 level enable */ 404 #define SCSI_HBA_LOG2 0x00000020 /* DIAG2 level enable */ 405 #define SCSI_HBA_LOG3 0x00000040 /* DIAG3 level enable */ 406 #define SCSI_HBA_LOG4 0x00000080 /* DIAG4 level enable */ 407 #define SCSI_HBA_LOGMAPPHY 0x00000100 /* MAPPHY level enable */ 408 #define SCSI_HBA_LOGMAPIPT 0x00000200 /* MAPIPT level enable */ 409 #define SCSI_HBA_LOGMAPTGT 0x00000400 /* MAPTGT level enable */ 410 #define SCSI_HBA_LOGMAPLUN 0x00000800 /* MAPLUN level enable */ 411 #define SCSI_HBA_LOGMAPCFG 0x00001000 /* MAPCFG level enable */ 412 #define SCSI_HBA_LOGMAPUNCFG 0x00002000 /* MAPUNCFG level enable */ 413 #define SCSI_HBA_LOGTRACE 0x00010000 /* TRACE enable */ 414 #if (CE_CONT | CE_NOTE | CE_WARN | CE_PANIC | CE_IGNORE) > SCSI_HBA_LOG_CE_MASK 415 Error, problem with CE_ definitions 416 #endif 417 418 /* 419 * Tunable log message augmentation and filters: filters do not apply to 420 * SCSI_HBA_LOG_CE_MASK level messages or LOG_NF() messages. 421 * 422 * An example set of /etc/system tunings to simplify debug a SCSA pHCI HBA 423 * driver called "pmcs", including "scsi_vhci" operation, by capturing 424 * log information in the system log might be: 425 * 426 * echo "set scsi:scsi_hba_log_filter_level=0x3ff0" >> /etc/system 427 * echo "set scsi:scsi_hba_log_filter_phci=\"pmcs\"" >> /etc/system 428 * echo "set scsi:scsi_hba_log_filter_vhci=\"scsi_vhci\"" >> /etc/system 429 * 430 * To capture information on just HBA-SCSAv3 *map operation, use 431 * echo "set scsi:scsi_hba_log_filter_level=0x3f10" >> /etc/system 432 * 433 * For debugging an HBA driver, you may also want to set: 434 * 435 * echo "set scsi:scsi_hba_log_align=1" >> /etc/system 436 * echo "set scsi:scsi_hba_log_mt_disable=0x6" >> /etc/system 437 * echo "set mtc_off=1" >> /etc/system 438 * echo "set mdi_mtc_off=1" >> /etc/system 439 * echo "set scsi:scsi_hba_log_fcif=0" >> /etc/system 440 */ 441 int scsi_hba_log_filter_level = 442 SCSI_HBA_LOG1 | 443 0; 444 char *scsi_hba_log_filter_phci = "\0\0\0\0\0\0\0\0\0\0\0\0"; 445 char *scsi_hba_log_filter_vhci = "\0\0\0\0\0\0\0\0\0\0\0\0"; 446 int scsi_hba_log_align = 0; /* NOTE: will not cause truncation */ 447 int scsi_hba_log_fcif = '!'; /* "^!?" first char in format */ 448 /* NOTE: iff level > SCSI_HBA_LOG1 */ 449 /* '\0'0x00 -> console and system log */ 450 /* '^' 0x5e -> console_only */ 451 /* '!' 0x21 -> system log only */ 452 /* '?' 0x2F -> See cmn_err(9F) */ 453 int scsi_hba_log_info = /* augmentation: extra info output */ 454 (0 << 0) | /* 0x0001: process information */ 455 (0 << 1) | /* 0x0002: full /devices path */ 456 (0 << 2); /* 0x0004: devinfo pointer */ 457 458 int scsi_hba_log_mt_disable = 459 /* SCSI_ENUMERATION_MT_LUN_DISABLE | (ie 0x02) */ 460 /* SCSI_ENUMERATION_MT_TARGET_DISABLE | (ie 0x04) */ 461 0; 462 463 /* static data for HBA logging subsystem */ 464 static kmutex_t scsi_hba_log_mutex; 465 static char scsi_hba_log_i[512]; 466 static char scsi_hba_log_buf[512]; 467 static char scsi_hba_fmt[512]; 468 469 /* Macros to use in scsi_hba.c source code below */ 470 #define SCSI_HBA_LOG(x) scsi_hba_log x 471 #define _LOG(level) SCSI_HBA_LOG##level, __func__ 472 #define _MAP(map) SCSI_HBA_LOGMAP##map, __func__ 473 #define _LOG_NF(level) SCSI_HBA_LOG##level, NULL, NULL, NULL 474 #define _LOG_TRACE _LOG(TRACE) 475 #define _LOGLUN _MAP(LUN) 476 #define _LOGTGT _MAP(TGT) 477 #define _LOGIPT _MAP(IPT) 478 #define _LOGPHY _MAP(PHY) 479 #define _LOGCFG _MAP(CFG) 480 #define _LOGUNCFG _MAP(UNCFG) 481 482 /*PRINTFLIKE5*/ 483 static void 484 scsi_hba_log(int level, const char *func, dev_info_t *self, dev_info_t *child, 485 const char *fmt, ...) 486 { 487 va_list ap; 488 int clevel; 489 int align; 490 char *info; 491 char *f; 492 char *ua; 493 494 /* derive self from child's parent */ 495 if ((self == NULL) && child) 496 self = ddi_get_parent(child); 497 498 /* no filtering of SCSI_HBA_LOG_CE_MASK or LOG_NF messages */ 499 if (((level & SCSI_HBA_LOG_CE_MASK) != level) && (func != NULL)) { 500 /* scsi_hba_log_filter_level: filter on level as bitmask */ 501 if ((level & scsi_hba_log_filter_level) == 0) 502 return; 503 504 /* scsi_hba_log_filter_phci/vhci: on name of driver */ 505 if (*scsi_hba_log_filter_phci && 506 ((self == NULL) || 507 (ddi_driver_name(self) == NULL) || 508 strcmp(ddi_driver_name(self), scsi_hba_log_filter_phci))) { 509 /* does not match pHCI, check vHCI */ 510 if (*scsi_hba_log_filter_vhci && 511 ((self == NULL) || 512 (ddi_driver_name(self) == NULL) || 513 strcmp(ddi_driver_name(self), 514 scsi_hba_log_filter_vhci))) { 515 /* does not match vHCI */ 516 return; 517 } 518 } 519 520 521 /* passed filters, determine align */ 522 align = scsi_hba_log_align; 523 524 /* shorten func for filtered output */ 525 if (strncmp(func, "scsi_hba_", 9) == 0) 526 func += 9; 527 if (strncmp(func, "scsi_", 5) == 0) 528 func += 5; 529 } else { 530 /* don't align output that is never filtered */ 531 align = 0; 532 } 533 534 /* determine the cmn_err form from the level */ 535 clevel = ((level & SCSI_HBA_LOG_CE_MASK) == level) ? level : CE_CONT; 536 537 /* protect common buffers used to format output */ 538 mutex_enter(&scsi_hba_log_mutex); 539 540 /* skip special first characters, we add them back below */ 541 f = (char *)fmt; 542 if (*f && strchr("^!?", *f)) 543 f++; 544 va_start(ap, fmt); 545 (void) vsprintf(scsi_hba_log_buf, f, ap); 546 va_end(ap); 547 548 /* augment message with 'information' */ 549 info = scsi_hba_log_i; 550 *info = '\0'; 551 if ((scsi_hba_log_info & 0x0001) && curproc != NULL && 552 PTOU(curproc)->u_comm[0] != '\0') { 553 (void) sprintf(info, "%s[%d]%p ", 554 PTOU(curproc)->u_comm, curproc->p_pid, (void *)curthread); 555 info += strlen(info); 556 } 557 if (self) { 558 if ((scsi_hba_log_info & 0x0004) && (child || self)) { 559 (void) sprintf(info, "%p ", 560 (void *)(child ? child : self)); 561 info += strlen(info); 562 } 563 if (scsi_hba_log_info & 0x0002) { 564 (void) ddi_pathname(child ? child : self, info); 565 (void) strcat(info, " "); 566 info += strlen(info); 567 } 568 569 /* always provide 'default' information about self &child */ 570 (void) sprintf(info, "%s%d ", ddi_driver_name(self), 571 ddi_get_instance(self)); 572 info += strlen(info); 573 if (child) { 574 ua = ddi_get_name_addr(child); 575 (void) sprintf(info, "%s@%s ", 576 ddi_node_name(child), (ua && *ua) ? ua : ""); 577 info += strlen(info); 578 } 579 } 580 581 /* turn off alignment if truncation would occur */ 582 if (align && ((strlen(func) > 18) || (strlen(scsi_hba_log_i) > 36))) 583 align = 0; 584 585 /* adjust for aligned output */ 586 if (align) { 587 if (func == NULL) 588 func = ""; 589 /* remove trailing blank with align output */ 590 if ((info != scsi_hba_log_i) && (*(info -1) == '\b')) 591 *(info - 1) = '\0'; 592 } 593 594 /* special "first character in format" must be in format itself */ 595 f = scsi_hba_fmt; 596 if (fmt[0] && strchr("^!?", fmt[0])) 597 *f++ = fmt[0]; 598 else if (scsi_hba_log_fcif && (level > SCSI_HBA_LOG1)) 599 *f++ = (char)scsi_hba_log_fcif; /* add global fcif */ 600 if (align) 601 (void) sprintf(f, "%s", "%-18.18s: %36.36s: %s%s"); 602 else 603 (void) sprintf(f, "%s", func ? "%s: %s%s%s" : "%s%s%s"); 604 605 if (func) 606 cmn_err(clevel, scsi_hba_fmt, func, scsi_hba_log_i, 607 scsi_hba_log_buf, clevel == CE_CONT ? "\n" : ""); 608 else 609 cmn_err(clevel, scsi_hba_fmt, scsi_hba_log_i, 610 scsi_hba_log_buf, clevel == CE_CONT ? "\n" : ""); 611 mutex_exit(&scsi_hba_log_mutex); 612 } 613 614 int scsi_enumeration_failed_panic = 0; 615 int scsi_enumeration_failed_hotplug = 1; 616 617 static void 618 scsi_enumeration_failed(dev_info_t *child, scsi_enum_t se, 619 char *arg, char *when) 620 { 621 /* If 'se' is -1 the 'se' value comes from child. */ 622 if (se == -1) { 623 ASSERT(child); 624 se = ndi_dev_is_hotplug_node(child) ? SE_HP : SE_BUSCONFIG; 625 } 626 627 if (scsi_enumeration_failed_panic) { 628 /* set scsi_enumeration_failed_panic to debug */ 629 SCSI_HBA_LOG((_LOG(PANIC), NULL, child, 630 "%s%senumeration failed during %s", 631 arg ? arg : "", arg ? " " : "", when)); 632 } else if (scsi_enumeration_failed_hotplug && (se == SE_HP)) { 633 /* set scsi_enumeration_failed_hotplug for console messages */ 634 SCSI_HBA_LOG((_LOG(WARN), NULL, child, 635 "%s%senumeration failed during %s", 636 arg ? arg : "", arg ? " " : "", when)); 637 } else { 638 /* default */ 639 SCSI_HBA_LOG((_LOG(2), NULL, child, 640 "%s%senumeration failed during %s", 641 arg ? arg : "", arg ? " " : "", when)); 642 } 643 } 644 645 /* 646 * scsi_hba version of [nm]di_devi_enter/[nm]di_devi_exit that detects if HBA 647 * is a PHCI, and chooses mdi/ndi locking implementation. 648 */ 649 static void 650 scsi_hba_devi_enter(dev_info_t *self, boolean_t *enteredvp) 651 { 652 if (MDI_PHCI(self)) 653 mdi_devi_enter(self, enteredvp); 654 else 655 ndi_devi_enter(self); 656 } 657 658 static int 659 scsi_hba_devi_tryenter(dev_info_t *self, boolean_t *enteredvp) 660 { 661 if (MDI_PHCI(self)) 662 return (mdi_devi_tryenter(self, enteredvp)); 663 else 664 return (ndi_devi_tryenter(self)); 665 } 666 667 static void 668 scsi_hba_devi_exit(dev_info_t *self, boolean_t enteredv) 669 { 670 if (MDI_PHCI(self)) 671 mdi_devi_exit(self, enteredv); 672 else 673 ndi_devi_exit(self); 674 } 675 676 static void 677 scsi_hba_devi_enter_phci(dev_info_t *self) 678 { 679 if (MDI_PHCI(self)) 680 mdi_devi_enter_phci(self); 681 } 682 683 static void 684 scsi_hba_devi_exit_phci(dev_info_t *self) 685 { 686 if (MDI_PHCI(self)) 687 mdi_devi_exit_phci(self); 688 } 689 690 static int 691 scsi_hba_dev_is_sid(dev_info_t *child) 692 { 693 /* 694 * Use ndi_dev_is_persistent_node instead of ddi_dev_is_sid to avoid 695 * any possible locking issues in mixed nexus devctl code (like usb). 696 */ 697 return (ndi_dev_is_persistent_node(child)); 698 } 699 700 /* 701 * Called from _init() when loading "scsi" module 702 */ 703 void 704 scsi_initialize_hba_interface() 705 { 706 SCSI_HBA_LOG((_LOG_TRACE, NULL, NULL, __func__)); 707 708 /* We need "scsiprobe" and "scsinodev" as an alias or a driver. */ 709 if (ddi_name_to_major(compatible_probe) == DDI_MAJOR_T_NONE) { 710 SCSI_HBA_LOG((_LOG_NF(WARN), "failed to resolve '%s' " 711 "driver alias, defaulting to 'nulldriver'", 712 compatible_probe)); 713 714 /* If no "nulldriver" driver nothing will work... */ 715 compatible_probe = "nulldriver"; 716 if (ddi_name_to_major(compatible_probe) == DDI_MAJOR_T_NONE) 717 SCSI_HBA_LOG((_LOG_NF(WARN), "no probe '%s' driver, " 718 "system misconfigured", compatible_probe)); 719 } 720 if (ddi_name_to_major(compatible_nodev) == DDI_MAJOR_T_NONE) { 721 SCSI_HBA_LOG((_LOG_NF(WARN), "failed to resolve '%s' " 722 "driver alias, defaulting to 'nulldriver'", 723 compatible_nodev)); 724 725 /* If no "nulldriver" driver nothing will work... */ 726 compatible_nodev = "nulldriver"; 727 if (ddi_name_to_major(compatible_nodev) == DDI_MAJOR_T_NONE) 728 SCSI_HBA_LOG((_LOG_NF(WARN), "no nodev '%s' driver, " 729 "system misconfigured", compatible_nodev)); 730 } 731 732 /* 733 * Verify our special node name "probe" will not be used in other ways. 734 * Don't expect things to work if they are. 735 */ 736 if (ddi_major_to_name(ddi_name_to_major("probe"))) 737 SCSI_HBA_LOG((_LOG_NF(WARN), 738 "driver already using special node name 'probe'")); 739 740 mutex_init(&scsi_log_mutex, NULL, MUTEX_DRIVER, NULL); 741 mutex_init(&scsi_flag_nointr_mutex, NULL, MUTEX_DRIVER, NULL); 742 cv_init(&scsi_flag_nointr_cv, NULL, CV_DRIVER, NULL); 743 mutex_init(&scsi_hba_log_mutex, NULL, MUTEX_DRIVER, NULL); 744 745 /* initialize the asynchronous barrier deletion daemon */ 746 mutex_init(&scsi_hba_barrier_mutex, NULL, MUTEX_DRIVER, NULL); 747 cv_init(&scsi_hba_barrier_cv, NULL, CV_DRIVER, NULL); 748 (void) thread_create(NULL, 0, 749 (void (*)())scsi_hba_barrier_daemon, NULL, 750 0, &p0, TS_RUN, minclsyspri); 751 752 /* initialize lun change ASC/ASCQ processing daemon (stage1 & stage2) */ 753 mutex_init(&scsi_lunchg1_mutex, NULL, MUTEX_DRIVER, NULL); 754 cv_init(&scsi_lunchg1_cv, NULL, CV_DRIVER, NULL); 755 (void) thread_create(NULL, 0, 756 (void (*)())scsi_lunchg1_daemon, NULL, 757 0, &p0, TS_RUN, minclsyspri); 758 mutex_init(&scsi_lunchg2_mutex, NULL, MUTEX_DRIVER, NULL); 759 cv_init(&scsi_lunchg2_cv, NULL, CV_DRIVER, NULL); 760 (void) thread_create(NULL, 0, 761 (void (*)())scsi_lunchg2_daemon, NULL, 762 0, &p0, TS_RUN, minclsyspri); 763 } 764 765 int 766 scsi_hba_pkt_constructor(void *buf, void *arg, int kmflag) 767 { 768 struct scsi_pkt_cache_wrapper *pktw; 769 struct scsi_pkt *pkt; 770 scsi_hba_tran_t *tran = (scsi_hba_tran_t *)arg; 771 int pkt_len; 772 char *ptr; 773 774 /* 775 * allocate a chunk of memory for the following: 776 * scsi_pkt 777 * pcw_* fields 778 * pkt_ha_private 779 * pkt_cdbp, if needed 780 * (pkt_private always null) 781 * pkt_scbp, if needed 782 */ 783 pkt_len = tran->tran_hba_len + sizeof (struct scsi_pkt_cache_wrapper); 784 if (tran->tran_hba_flags & SCSI_HBA_TRAN_CDB) 785 pkt_len += DEFAULT_CDBLEN; 786 if (tran->tran_hba_flags & SCSI_HBA_TRAN_SCB) 787 pkt_len += DEFAULT_SCBLEN; 788 bzero(buf, pkt_len); 789 790 ptr = buf; 791 pktw = buf; 792 ptr += sizeof (struct scsi_pkt_cache_wrapper); 793 pkt = &(pktw->pcw_pkt); 794 pkt->pkt_ha_private = (opaque_t)ptr; 795 796 pktw->pcw_magic = PKT_WRAPPER_MAGIC; /* alloced correctly */ 797 /* 798 * keep track of the granularity at the time this handle was 799 * allocated 800 */ 801 pktw->pcw_granular = tran->tran_dma_attr.dma_attr_granular; 802 803 if (ddi_dma_alloc_handle(tran->tran_hba_dip, &tran->tran_dma_attr, 804 kmflag == KM_SLEEP ? SLEEP_FUNC: NULL_FUNC, NULL, 805 &pkt->pkt_handle) != DDI_SUCCESS) { 806 807 return (-1); 808 } 809 ptr += tran->tran_hba_len; 810 if (tran->tran_hba_flags & SCSI_HBA_TRAN_CDB) { 811 pkt->pkt_cdbp = (opaque_t)ptr; 812 ptr += DEFAULT_CDBLEN; 813 } 814 pkt->pkt_private = NULL; 815 if (tran->tran_hba_flags & SCSI_HBA_TRAN_SCB) 816 pkt->pkt_scbp = (opaque_t)ptr; 817 if (tran->tran_pkt_constructor) 818 return ((*tran->tran_pkt_constructor)(pkt, arg, kmflag)); 819 else 820 return (0); 821 } 822 823 #define P_TO_TRAN(pkt) ((pkt)->pkt_address.a_hba_tran) 824 825 void 826 scsi_hba_pkt_destructor(void *buf, void *arg) 827 { 828 struct scsi_pkt_cache_wrapper *pktw = buf; 829 struct scsi_pkt *pkt = &(pktw->pcw_pkt); 830 scsi_hba_tran_t *tran = (scsi_hba_tran_t *)arg; 831 832 ASSERT(pktw->pcw_magic == PKT_WRAPPER_MAGIC); 833 ASSERT((pktw->pcw_flags & PCW_BOUND) == 0); 834 if (tran->tran_pkt_destructor) 835 (*tran->tran_pkt_destructor)(pkt, arg); 836 837 /* make sure nobody messed with our pointers */ 838 ASSERT(pkt->pkt_ha_private == (opaque_t)((char *)pkt + 839 sizeof (struct scsi_pkt_cache_wrapper))); 840 ASSERT(((tran->tran_hba_flags & SCSI_HBA_TRAN_SCB) == 0) || 841 (pkt->pkt_scbp == (opaque_t)((char *)pkt + 842 tran->tran_hba_len + 843 (((tran->tran_hba_flags & SCSI_HBA_TRAN_CDB) == 0) ? 844 0 : DEFAULT_CDBLEN) + 845 DEFAULT_PRIVLEN + sizeof (struct scsi_pkt_cache_wrapper)))); 846 ASSERT(((tran->tran_hba_flags & SCSI_HBA_TRAN_CDB) == 0) || 847 (pkt->pkt_cdbp == (opaque_t)((char *)pkt + 848 tran->tran_hba_len + 849 sizeof (struct scsi_pkt_cache_wrapper)))); 850 ASSERT(pkt->pkt_handle); 851 ddi_dma_free_handle(&pkt->pkt_handle); 852 pkt->pkt_handle = NULL; 853 pkt->pkt_numcookies = 0; 854 pktw->pcw_total_xfer = 0; 855 pktw->pcw_totalwin = 0; 856 pktw->pcw_curwin = 0; 857 } 858 859 /* 860 * Called by an HBA from _init() to plumb in common SCSA bus_ops and 861 * cb_ops for the HBA's :devctl and :scsi minor nodes. 862 */ 863 int 864 scsi_hba_init(struct modlinkage *modlp) 865 { 866 struct dev_ops *hba_dev_ops; 867 868 SCSI_HBA_LOG((_LOG_TRACE, NULL, NULL, __func__)); 869 870 /* 871 * Get a pointer to the dev_ops structure of the HBA and plumb our 872 * bus_ops vector into the HBA's dev_ops structure. 873 */ 874 hba_dev_ops = ((struct modldrv *)(modlp->ml_linkage[0]))->drv_dev_ops; 875 ASSERT(hba_dev_ops->devo_bus_ops == NULL); 876 hba_dev_ops->devo_bus_ops = &scsi_hba_busops; 877 878 /* 879 * Plumb our cb_ops vector into the HBA's dev_ops structure to 880 * provide getinfo and hotplugging ioctl support if the HBA driver 881 * does not already provide this support. 882 */ 883 if (hba_dev_ops->devo_cb_ops == NULL) { 884 hba_dev_ops->devo_cb_ops = &scsi_hba_cbops; 885 } 886 if (hba_dev_ops->devo_cb_ops->cb_open == scsi_hba_open) { 887 ASSERT(hba_dev_ops->devo_cb_ops->cb_close == scsi_hba_close); 888 hba_dev_ops->devo_getinfo = scsi_hba_info; 889 } 890 return (0); 891 } 892 893 /* 894 * Called by an HBA attach(9E) to allocate a scsi_hba_tran(9S) structure. An 895 * HBA driver will then initialize the structure and then call 896 * scsi_hba_attach_setup(9F). 897 */ 898 /*ARGSUSED*/ 899 scsi_hba_tran_t * 900 scsi_hba_tran_alloc( 901 dev_info_t *self, 902 int flags) 903 { 904 scsi_hba_tran_t *tran; 905 906 SCSI_HBA_LOG((_LOG_TRACE, self, NULL, __func__)); 907 908 /* allocate SCSA flavors for self */ 909 ndi_flavorv_alloc(self, SCSA_NFLAVORS); 910 911 tran = kmem_zalloc(sizeof (scsi_hba_tran_t), 912 (flags & SCSI_HBA_CANSLEEP) ? KM_SLEEP : KM_NOSLEEP); 913 914 if (tran) { 915 tran->tran_interconnect_type = INTERCONNECT_PARALLEL; 916 917 /* 918 * HBA driver called scsi_hba_tran_alloc(), so tran structure 919 * is proper size and unused/newer fields are zero. 920 * 921 * NOTE: We use SCSA_HBA_SCSA_TA as an obtuse form of 922 * versioning to detect old HBA drivers that do not use 923 * scsi_hba_tran_alloc, and would present garbage data 924 * (instead of valid/zero data) for newer tran fields. 925 */ 926 tran->tran_hba_flags |= SCSI_HBA_SCSA_TA; 927 } 928 929 return (tran); 930 } 931 932 /* 933 * Called by an HBA to free a scsi_hba_tran structure 934 */ 935 void 936 scsi_hba_tran_free( 937 scsi_hba_tran_t *tran) 938 { 939 SCSI_HBA_LOG((_LOG_TRACE, tran->tran_hba_dip, NULL, __func__)); 940 941 kmem_free(tran, sizeof (scsi_hba_tran_t)); 942 } 943 944 int 945 scsi_tran_ext_alloc( 946 scsi_hba_tran_t *tran, 947 size_t length, 948 int flags) 949 { 950 void *tran_ext; 951 int ret = DDI_FAILURE; 952 953 tran_ext = kmem_zalloc(length, 954 (flags & SCSI_HBA_CANSLEEP) ? KM_SLEEP : KM_NOSLEEP); 955 if (tran_ext != NULL) { 956 tran->tran_extension = tran_ext; 957 ret = DDI_SUCCESS; 958 } 959 return (ret); 960 } 961 962 void 963 scsi_tran_ext_free( 964 scsi_hba_tran_t *tran, 965 size_t length) 966 { 967 if (tran->tran_extension != NULL) { 968 kmem_free(tran->tran_extension, length); 969 tran->tran_extension = NULL; 970 } 971 } 972 973 /* 974 * Common nexus teardown code: used by both scsi_hba_detach() on SCSA HBA node 975 * and iport_postdetach_tran_scsi_device() on a SCSA HBA iport node (and for 976 * failure cleanup). Undo scsa_nexus_setup in reverse order. 977 * 978 * NOTE: Since we are in the Solaris IO framework, we can depend on 979 * undocumented cleanup operations performed by other parts of the framework: 980 * like detach_node() calling ddi_prop_remove_all() and 981 * ddi_remove_minor_node(,NULL). 982 */ 983 static void 984 scsa_nexus_teardown(dev_info_t *self, scsi_hba_tran_t *tran) 985 { 986 /* Teardown FMA. */ 987 if (tran->tran_hba_flags & SCSI_HBA_SCSA_FM) { 988 ddi_fm_fini(self); 989 tran->tran_hba_flags &= ~SCSI_HBA_SCSA_FM; 990 } 991 } 992 993 /* 994 * Common nexus setup code: used by both scsi_hba_attach_setup() on SCSA HBA 995 * node and iport_preattach_tran_scsi_device() on a SCSA HBA iport node. 996 * 997 * This code makes no assumptions about tran use by scsi_device children. 998 */ 999 static int 1000 scsa_nexus_setup(dev_info_t *self, scsi_hba_tran_t *tran) 1001 { 1002 int capable; 1003 int scsa_minor; 1004 1005 /* 1006 * NOTE: SCSA maintains an 'fm-capable' domain, in tran_fm_capable, 1007 * that is not dependent (limited by) the capabilities of its parents. 1008 * For example a devinfo node in a branch that is not 1009 * DDI_FM_EREPORT_CAPABLE may report as capable, via tran_fm_capable, 1010 * to its scsi_device children. 1011 * 1012 * Get 'fm-capable' property from driver.conf, if present. If not 1013 * present, default to the scsi_fm_capable global (which has 1014 * DDI_FM_EREPORT_CAPABLE set by default). 1015 */ 1016 if (tran->tran_fm_capable == DDI_FM_NOT_CAPABLE) 1017 tran->tran_fm_capable = ddi_prop_get_int(DDI_DEV_T_ANY, self, 1018 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, 1019 "fm-capable", scsi_fm_capable); 1020 1021 /* 1022 * If an HBA is *not* doing its own fma support by calling 1023 * ddi_fm_init() prior to scsi_hba_attach_setup(), we provide a minimal 1024 * common SCSA implementation so that scsi_device children can generate 1025 * ereports via scsi_fm_ereport_post(). We use ddi_fm_capable() to 1026 * detect an HBA calling ddi_fm_init() prior to scsi_hba_attach_setup(). 1027 */ 1028 if (tran->tran_fm_capable && 1029 (ddi_fm_capable(self) == DDI_FM_NOT_CAPABLE)) { 1030 /* 1031 * We are capable of something, pass our capabilities up the 1032 * tree, but use a local variable so our parent can't limit 1033 * our capabilities (we don't want our parent to clear 1034 * DDI_FM_EREPORT_CAPABLE). 1035 * 1036 * NOTE: iblock cookies are not important because scsi HBAs 1037 * always interrupt below LOCK_LEVEL. 1038 */ 1039 capable = tran->tran_fm_capable; 1040 ddi_fm_init(self, &capable, NULL); 1041 1042 /* 1043 * Set SCSI_HBA_SCSA_FM bit to mark us as using the common 1044 * minimal SCSA fm implementation - we called ddi_fm_init(), 1045 * so we are responsible for calling ddi_fm_fini() in 1046 * scsi_hba_detach(). 1047 * 1048 * NOTE: if ddi_fm_init fails to establish handle, SKIP cleanup. 1049 */ 1050 if (DEVI(self)->devi_fmhdl) 1051 tran->tran_hba_flags |= SCSI_HBA_SCSA_FM; 1052 } 1053 1054 /* If SCSA responsible for for minor nodes, create :devctl minor. */ 1055 scsa_minor = (ddi_get_driver(self)->devo_cb_ops->cb_open == 1056 scsi_hba_open) ? 1 : 0; 1057 if (scsa_minor && ((ddi_create_minor_node(self, "devctl", S_IFCHR, 1058 INST2DEVCTL(ddi_get_instance(self)), DDI_NT_SCSI_NEXUS, 0) != 1059 DDI_SUCCESS))) { 1060 SCSI_HBA_LOG((_LOG(WARN), self, NULL, 1061 "can't create :devctl minor node")); 1062 goto fail; 1063 } 1064 1065 return (DDI_SUCCESS); 1066 1067 fail: scsa_nexus_teardown(self, tran); 1068 return (DDI_FAILURE); 1069 } 1070 1071 /* 1072 * Common tran teardown code: used by iport_postdetach_tran_scsi_device() on a 1073 * SCSA HBA iport node and (possibly) by scsi_hba_detach() on SCSA HBA node 1074 * (and for failure cleanup). Undo scsa_tran_setup in reverse order. 1075 * 1076 * NOTE: Since we are in the Solaris IO framework, we can depend on 1077 * undocumented cleanup operations performed by other parts of the framework: 1078 * like detach_node() calling ddi_prop_remove_all() and 1079 * ddi_remove_minor_node(,NULL). 1080 */ 1081 static void 1082 scsa_tran_teardown(dev_info_t *self, scsi_hba_tran_t *tran) 1083 { 1084 tran->tran_iport_dip = NULL; 1085 1086 /* Teardown pHCI registration */ 1087 if (tran->tran_hba_flags & SCSI_HBA_SCSA_PHCI) { 1088 (void) mdi_phci_unregister(self, 0); 1089 tran->tran_hba_flags &= ~SCSI_HBA_SCSA_PHCI; 1090 } 1091 } 1092 1093 /* 1094 * Common tran setup code: used by iport_preattach_tran_scsi_device() on a 1095 * SCSA HBA iport node and (possibly) by scsi_hba_attach_setup() on SCSA HBA 1096 * node. 1097 */ 1098 static int 1099 scsa_tran_setup(dev_info_t *self, scsi_hba_tran_t *tran) 1100 { 1101 int scsa_minor; 1102 int id; 1103 char *scsi_binding_set; 1104 static const char *interconnect[] = INTERCONNECT_TYPE_ASCII; 1105 1106 SCSI_HBA_LOG((_LOG_TRACE, self, NULL, __func__)); 1107 1108 /* If SCSA responsible for for minor nodes, create ":scsi" */ 1109 scsa_minor = (ddi_get_driver(self)->devo_cb_ops->cb_open == 1110 scsi_hba_open) ? 1 : 0; 1111 if (scsa_minor && (ddi_create_minor_node(self, "scsi", S_IFCHR, 1112 INST2SCSI(ddi_get_instance(self)), 1113 DDI_NT_SCSI_ATTACHMENT_POINT, 0) != DDI_SUCCESS)) { 1114 SCSI_HBA_LOG((_LOG(WARN), self, NULL, 1115 "can't create :scsi minor node")); 1116 goto fail; 1117 } 1118 1119 /* 1120 * If the property does not already exist on self then see if we can 1121 * pull it from further up the tree and define it on self. If the 1122 * property does not exist above (including options.conf) then use the 1123 * default value specified (global variable). We pull things down from 1124 * above for faster "DDI_PROP_NOTPROM | DDI_PROP_DONTPASS" runtime 1125 * access. 1126 * 1127 * Future: Should we avoid creating properties when value == global? 1128 */ 1129 #define CONFIG_INT_PROP(s, p, dv) { \ 1130 if ((ddi_prop_exists(DDI_DEV_T_ANY, s, \ 1131 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, p) == 0) && \ 1132 (ndi_prop_update_int(DDI_DEV_T_NONE, s, p, \ 1133 ddi_prop_get_int(DDI_DEV_T_ANY, ddi_get_parent(s), \ 1134 DDI_PROP_NOTPROM, p, dv)) != DDI_PROP_SUCCESS)) \ 1135 SCSI_HBA_LOG((_LOG(WARN), NULL, s, \ 1136 "can't create property '%s'", p)); \ 1137 } 1138 1139 /* Decorate with scsi configuration properties */ 1140 CONFIG_INT_PROP(self, "scsi-enumeration", scsi_enumeration); 1141 CONFIG_INT_PROP(self, "scsi-options", scsi_options); 1142 CONFIG_INT_PROP(self, "scsi-reset-delay", scsi_reset_delay); 1143 CONFIG_INT_PROP(self, "scsi-watchdog-tick", scsi_watchdog_tick); 1144 CONFIG_INT_PROP(self, "scsi-selection-timeout", scsi_selection_timeout); 1145 CONFIG_INT_PROP(self, "scsi-tag-age-limit", scsi_tag_age_limit); 1146 1147 /* 1148 * Pull down the scsi-initiator-id from further up the tree, or as 1149 * defined by OBP. Place on node for faster access. NOTE: there is 1150 * some confusion about what the name of the property should be. 1151 */ 1152 id = ddi_prop_get_int(DDI_DEV_T_ANY, self, 0, "initiator-id", -1); 1153 if (id == -1) 1154 id = ddi_prop_get_int(DDI_DEV_T_ANY, self, 0, 1155 "scsi-initiator-id", -1); 1156 if (id != -1) 1157 CONFIG_INT_PROP(self, "scsi-initiator-id", id); 1158 1159 /* 1160 * If we are responsible for tran allocation, establish 1161 * 'initiator-interconnect-type'. 1162 */ 1163 if ((tran->tran_hba_flags & SCSI_HBA_SCSA_TA) && 1164 (tran->tran_interconnect_type > 0) && 1165 (tran->tran_interconnect_type < INTERCONNECT_MAX)) { 1166 if (ndi_prop_update_string(DDI_DEV_T_NONE, self, 1167 "initiator-interconnect-type", 1168 (char *)interconnect[tran->tran_interconnect_type]) 1169 != DDI_PROP_SUCCESS) { 1170 SCSI_HBA_LOG((_LOG(WARN), self, NULL, 1171 "failed to establish " 1172 "'initiator-interconnect-type'")); 1173 goto fail; 1174 } 1175 } 1176 1177 /* 1178 * The 'scsi-binding-set' property can be defined in driver.conf 1179 * files of legacy drivers on an as-needed basis. If 'scsi-binding-set' 1180 * is not driver.conf defined, and the HBA is not implementing its own 1181 * private bus_config, we define scsi-binding-set to the default 1182 * 'spi' legacy value. 1183 * 1184 * NOTE: This default 'spi' value will be deleted if an HBA driver 1185 * ends up using the scsi_hba_tgtmap_create() enumeration services. 1186 * 1187 * NOTE: If we were ever to decide to derive 'scsi-binding-set' from 1188 * the IEEE-1275 'device_type' property then this is where that code 1189 * should go - there is not enough consistency in 'device_type' to do 1190 * this correctly at this point in time. 1191 */ 1192 if (ddi_prop_lookup_string(DDI_DEV_T_ANY, self, 1193 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, "scsi-binding-set", 1194 &scsi_binding_set) == DDI_PROP_SUCCESS) { 1195 SCSI_HBA_LOG((_LOG(2), NULL, self, 1196 "external 'scsi-binding-set' \"%s\"", scsi_binding_set)); 1197 ddi_prop_free(scsi_binding_set); 1198 } else if (scsi_binding_set_spi && 1199 ((tran->tran_bus_config == NULL) || 1200 (tran->tran_bus_config == scsi_hba_bus_config_spi))) { 1201 if (ndi_prop_update_string(DDI_DEV_T_NONE, self, 1202 "scsi-binding-set", scsi_binding_set_spi) != 1203 DDI_PROP_SUCCESS) { 1204 SCSI_HBA_LOG((_LOG(WARN), self, NULL, 1205 "failed to establish 'scsi_binding_set' default")); 1206 goto fail; 1207 } 1208 SCSI_HBA_LOG((_LOG(2), NULL, self, 1209 "default 'scsi-binding-set' \"%s\"", scsi_binding_set_spi)); 1210 } else 1211 SCSI_HBA_LOG((_LOG(2), NULL, self, 1212 "no 'scsi-binding-set'")); 1213 1214 /* 1215 * If SCSI_HBA_TRAN_PHCI is set, take care of pHCI registration of the 1216 * initiator. 1217 */ 1218 if ((tran->tran_hba_flags & SCSI_HBA_TRAN_PHCI) && 1219 (mdi_phci_register(MDI_HCI_CLASS_SCSI, self, 0) == MDI_SUCCESS)) 1220 tran->tran_hba_flags |= SCSI_HBA_SCSA_PHCI; 1221 1222 /* NOTE: tran_hba_dip is for DMA operation at the HBA node level */ 1223 tran->tran_iport_dip = self; /* for iport association */ 1224 return (DDI_SUCCESS); 1225 1226 fail: scsa_tran_teardown(self, tran); 1227 return (DDI_FAILURE); 1228 } 1229 1230 /* 1231 * Called by a SCSA HBA driver to attach an instance of the driver to 1232 * SCSA HBA node enumerated by PCI. 1233 */ 1234 int 1235 scsi_hba_attach_setup( 1236 dev_info_t *self, 1237 ddi_dma_attr_t *hba_dma_attr, 1238 scsi_hba_tran_t *tran, 1239 int flags) 1240 { 1241 int len; 1242 char cache_name[96]; 1243 1244 SCSI_HBA_LOG((_LOG_TRACE, self, NULL, __func__)); 1245 1246 /* 1247 * Verify that we are a driver so other code does not need to 1248 * check for NULL ddi_get_driver() result. 1249 */ 1250 if (ddi_get_driver(self) == NULL) 1251 return (DDI_FAILURE); 1252 1253 /* 1254 * Verify that we are called on a SCSA HBA node (function enumerated 1255 * by PCI), not on an iport node. 1256 */ 1257 ASSERT(scsi_hba_iport_unit_address(self) == NULL); 1258 if (scsi_hba_iport_unit_address(self)) 1259 return (DDI_FAILURE); /* self can't be an iport */ 1260 1261 /* Caller must provide the tran. */ 1262 ASSERT(tran); 1263 if (tran == NULL) 1264 return (DDI_FAILURE); 1265 1266 /* 1267 * Verify correct scsi_hba_tran_t form: 1268 * 1269 * o Both or none of tran_get_name/tran_get_addr. 1270 * NOTE: Older SCSA HBA drivers for SCSI transports with addressing 1271 * that did not fit the SPI "struct scsi_address" model were required 1272 * to implement tran_get_name and tran_get_addr. This is no longer 1273 * true - modern transport drivers should now use common SCSA 1274 * enumeration services. The SCSA enumeration code will represent 1275 * the unit-address using well-known address properties 1276 * (SCSI_ADDR_PROP_TARGET_PORT, SCSI_ADDR_PROP_LUN64) during 1277 * devinfo/pathinfo node creation. The HBA driver can obtain values 1278 * using scsi_device_prop_lookup_*() from its tran_tgt_init(9E). 1279 * 1280 */ 1281 if ((tran->tran_get_name == NULL) ^ (tran->tran_get_bus_addr == NULL)) { 1282 SCSI_HBA_LOG((_LOG(WARN), self, NULL, 1283 "should support both or neither: " 1284 "tran_get_name, tran_get_bus_addr")); 1285 return (DDI_FAILURE); 1286 } 1287 1288 /* 1289 * Establish the devinfo context of this tran structure, preserving 1290 * knowledge of how the tran was allocated. 1291 */ 1292 tran->tran_hba_dip = self; /* for DMA */ 1293 tran->tran_hba_flags = (flags & ~SCSI_HBA_SCSA_TA) | 1294 (tran->tran_hba_flags & SCSI_HBA_SCSA_TA); 1295 1296 /* Establish flavor of transport (and ddi_get_driver_private()) */ 1297 ndi_flavorv_set(self, SCSA_FLAVOR_SCSI_DEVICE, tran); 1298 1299 /* 1300 * Note: We only need dma_attr_minxfer and dma_attr_burstsizes 1301 * from the DMA attributes. scsi_hba_attach(9f) only guarantees 1302 * that these two fields are initialized properly. If this 1303 * changes, be sure to revisit the implementation of 1304 * scsi_hba_attach(9F). 1305 */ 1306 (void) memcpy(&tran->tran_dma_attr, hba_dma_attr, 1307 sizeof (ddi_dma_attr_t)); 1308 1309 /* Create tran_setup_pkt(9E) kmem_cache. */ 1310 if (tran->tran_setup_pkt) { 1311 ASSERT(tran->tran_init_pkt == NULL); 1312 ASSERT(tran->tran_destroy_pkt == NULL); 1313 if (tran->tran_init_pkt || tran->tran_destroy_pkt) 1314 goto fail; 1315 1316 tran->tran_init_pkt = scsi_init_cache_pkt; 1317 tran->tran_destroy_pkt = scsi_free_cache_pkt; 1318 tran->tran_sync_pkt = scsi_sync_cache_pkt; 1319 tran->tran_dmafree = scsi_cache_dmafree; 1320 1321 len = sizeof (struct scsi_pkt_cache_wrapper); 1322 len += ROUNDUP(tran->tran_hba_len); 1323 if (tran->tran_hba_flags & SCSI_HBA_TRAN_CDB) 1324 len += ROUNDUP(DEFAULT_CDBLEN); 1325 if (tran->tran_hba_flags & SCSI_HBA_TRAN_SCB) 1326 len += ROUNDUP(DEFAULT_SCBLEN); 1327 1328 (void) snprintf(cache_name, sizeof (cache_name), 1329 "pkt_cache_%s_%d", ddi_driver_name(self), 1330 ddi_get_instance(self)); 1331 1332 tran->tran_pkt_cache_ptr = kmem_cache_create( 1333 cache_name, len, 8, scsi_hba_pkt_constructor, 1334 scsi_hba_pkt_destructor, NULL, tran, NULL, 0); 1335 } 1336 1337 /* Perform node setup independent of initiator role */ 1338 if (scsa_nexus_setup(self, tran) != DDI_SUCCESS) 1339 goto fail; 1340 1341 /* 1342 * The SCSI_HBA_HBA flag is passed to scsi_hba_attach_setup when the 1343 * HBA driver knows that *all* children of the SCSA HBA node will be 1344 * 'iports'. If the SCSA HBA node can have iport children and also 1345 * function as an initiator for xxx_device children then it should 1346 * not specify SCSI_HBA_HBA in its scsi_hba_attach_setup call. An 1347 * HBA driver that does not manage iports should not set SCSA_HBA_HBA. 1348 */ 1349 if (tran->tran_hba_flags & SCSI_HBA_HBA) { 1350 /* 1351 * Set the 'ddi-config-driver-node' property on the nexus 1352 * node that notify attach_driver_nodes() to configure all 1353 * immediate children so that nodes which bind to the 1354 * same driver as parent are able to be added into per-driver 1355 * list. 1356 */ 1357 if (ndi_prop_create_boolean(DDI_DEV_T_NONE, 1358 self, "ddi-config-driver-node") != DDI_PROP_SUCCESS) 1359 goto fail; 1360 } else { 1361 if (scsa_tran_setup(self, tran) != DDI_SUCCESS) 1362 goto fail; 1363 } 1364 1365 return (DDI_SUCCESS); 1366 1367 fail: (void) scsi_hba_detach(self); 1368 return (DDI_FAILURE); 1369 } 1370 1371 /* 1372 * Called by an HBA to detach an instance of the driver. This may be called 1373 * for SCSA HBA nodes and for SCSA iport nodes. 1374 */ 1375 int 1376 scsi_hba_detach(dev_info_t *self) 1377 { 1378 scsi_hba_tran_t *tran; 1379 1380 ASSERT(scsi_hba_iport_unit_address(self) == NULL); 1381 if (scsi_hba_iport_unit_address(self)) 1382 return (DDI_FAILURE); /* self can't be an iport */ 1383 1384 /* Check all error return conditions upfront */ 1385 tran = ndi_flavorv_get(self, SCSA_FLAVOR_SCSI_DEVICE); 1386 ASSERT(tran); 1387 if (tran == NULL) 1388 return (DDI_FAILURE); 1389 1390 ASSERT(tran->tran_open_flag == 0); 1391 if (tran->tran_open_flag) 1392 return (DDI_FAILURE); 1393 1394 if (!(tran->tran_hba_flags & SCSI_HBA_HBA)) 1395 scsa_tran_teardown(self, tran); 1396 scsa_nexus_teardown(self, tran); 1397 1398 /* Teardown tran_setup_pkt(9E) kmem_cache. */ 1399 if (tran->tran_pkt_cache_ptr) { 1400 kmem_cache_destroy(tran->tran_pkt_cache_ptr); 1401 tran->tran_pkt_cache_ptr = NULL; 1402 } 1403 1404 (void) memset(&tran->tran_dma_attr, 0, sizeof (ddi_dma_attr_t)); 1405 1406 /* Teardown flavor of transport (and ddi_get_driver_private()) */ 1407 ndi_flavorv_set(self, SCSA_FLAVOR_SCSI_DEVICE, NULL); 1408 1409 tran->tran_hba_dip = NULL; 1410 1411 return (DDI_SUCCESS); 1412 } 1413 1414 1415 /* 1416 * Called by an HBA from _fini() 1417 */ 1418 void 1419 scsi_hba_fini(struct modlinkage *modlp) 1420 { 1421 struct dev_ops *hba_dev_ops; 1422 1423 SCSI_HBA_LOG((_LOG_TRACE, NULL, NULL, __func__)); 1424 1425 /* Get the devops structure of this module and clear bus_ops vector. */ 1426 hba_dev_ops = ((struct modldrv *)(modlp->ml_linkage[0]))->drv_dev_ops; 1427 1428 if (hba_dev_ops->devo_cb_ops == &scsi_hba_cbops) 1429 hba_dev_ops->devo_cb_ops = NULL; 1430 1431 if (hba_dev_ops->devo_getinfo == scsi_hba_info) 1432 hba_dev_ops->devo_getinfo = NULL; 1433 1434 hba_dev_ops->devo_bus_ops = (struct bus_ops *)NULL; 1435 } 1436 1437 /* 1438 * SAS specific functions 1439 */ 1440 smp_hba_tran_t * 1441 smp_hba_tran_alloc(dev_info_t *self) 1442 { 1443 /* allocate SCSA flavors for self */ 1444 ndi_flavorv_alloc(self, SCSA_NFLAVORS); 1445 return (kmem_zalloc(sizeof (smp_hba_tran_t), KM_SLEEP)); 1446 } 1447 1448 void 1449 smp_hba_tran_free(smp_hba_tran_t *tran) 1450 { 1451 kmem_free(tran, sizeof (smp_hba_tran_t)); 1452 } 1453 1454 int 1455 smp_hba_attach_setup( 1456 dev_info_t *self, 1457 smp_hba_tran_t *tran) 1458 { 1459 ASSERT(scsi_hba_iport_unit_address(self) == NULL); 1460 if (scsi_hba_iport_unit_address(self)) 1461 return (DDI_FAILURE); /* self can't be an iport */ 1462 1463 /* 1464 * The owner of the this devinfo_t was responsible 1465 * for informing the framework already about 1466 * additional flavors. 1467 */ 1468 ndi_flavorv_set(self, SCSA_FLAVOR_SMP, tran); 1469 return (DDI_SUCCESS); 1470 } 1471 1472 int 1473 smp_hba_detach(dev_info_t *self) 1474 { 1475 ASSERT(scsi_hba_iport_unit_address(self) == NULL); 1476 if (scsi_hba_iport_unit_address(self)) 1477 return (DDI_FAILURE); /* self can't be an iport */ 1478 1479 ndi_flavorv_set(self, SCSA_FLAVOR_SMP, NULL); 1480 return (DDI_SUCCESS); 1481 } 1482 1483 /* 1484 * SMP child flavored functions 1485 */ 1486 static int 1487 smp_busctl_ua(dev_info_t *child, char *addr, int maxlen) 1488 { 1489 char *tport; 1490 char *wwn; 1491 1492 /* limit ndi_devi_findchild_by_callback to expected flavor */ 1493 if (ndi_flavor_get(child) != SCSA_FLAVOR_SMP) 1494 return (DDI_FAILURE); 1495 1496 if (ddi_prop_lookup_string(DDI_DEV_T_ANY, child, 1497 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, 1498 SCSI_ADDR_PROP_TARGET_PORT, &tport) == DDI_SUCCESS) { 1499 (void) snprintf(addr, maxlen, "%s", tport); 1500 ddi_prop_free(tport); 1501 return (DDI_SUCCESS); 1502 } 1503 1504 /* 1505 * NOTE: the following code should be deleted when mpt is changed to 1506 * use SCSI_ADDR_PROP_TARGET_PORT instead of SMP_WWN. 1507 */ 1508 if (ddi_prop_lookup_string(DDI_DEV_T_ANY, child, 1509 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, 1510 SMP_WWN, &wwn) == DDI_SUCCESS) { 1511 (void) snprintf(addr, maxlen, "w%s", wwn); 1512 ddi_prop_free(wwn); 1513 return (DDI_SUCCESS); 1514 } 1515 return (DDI_FAILURE); 1516 } 1517 1518 static int 1519 smp_busctl_reportdev(dev_info_t *child) 1520 { 1521 dev_info_t *self = ddi_get_parent(child); 1522 char *tport; 1523 char *wwn; 1524 1525 if (ddi_prop_lookup_string(DDI_DEV_T_ANY, child, 1526 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, 1527 SCSI_ADDR_PROP_TARGET_PORT, &tport) == DDI_SUCCESS) { 1528 SCSI_HBA_LOG((_LOG_NF(CONT), "?%s%d at %s%d: target-port %s", 1529 ddi_driver_name(child), ddi_get_instance(child), 1530 ddi_driver_name(self), ddi_get_instance(self), tport)); 1531 ddi_prop_free(tport); 1532 return (DDI_SUCCESS); 1533 } 1534 1535 /* 1536 * NOTE: the following code should be deleted when mpt is changed to 1537 * use SCSI_ADDR_PROP_TARGET_PORT instead of SMP_WWN. 1538 */ 1539 if (ddi_prop_lookup_string(DDI_DEV_T_ANY, child, 1540 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, 1541 SMP_WWN, &wwn) == DDI_SUCCESS) { 1542 SCSI_HBA_LOG((_LOG_NF(CONT), "?%s%d at %s%d: wwn %s", 1543 ddi_driver_name(child), ddi_get_instance(child), 1544 ddi_driver_name(self), ddi_get_instance(self), wwn)); 1545 ddi_prop_free(wwn); 1546 return (DDI_SUCCESS); 1547 } 1548 return (DDI_FAILURE); 1549 } 1550 1551 static int 1552 smp_busctl_initchild(dev_info_t *child) 1553 { 1554 dev_info_t *self = ddi_get_parent(child); 1555 smp_hba_tran_t *tran; 1556 dev_info_t *dup; 1557 char addr[SCSI_MAXNAMELEN]; 1558 struct smp_device *smp_sd; 1559 uint64_t wwn; 1560 1561 tran = ndi_flavorv_get(self, SCSA_FLAVOR_SMP); 1562 ASSERT(tran); 1563 if (tran == NULL) 1564 return (DDI_FAILURE); 1565 1566 if (smp_busctl_ua(child, addr, sizeof (addr)) != DDI_SUCCESS) 1567 return (DDI_NOT_WELL_FORMED); 1568 if (scsi_wwnstr_to_wwn(addr, &wwn)) 1569 return (DDI_NOT_WELL_FORMED); 1570 1571 /* Prevent duplicate nodes. */ 1572 dup = ndi_devi_findchild_by_callback(self, ddi_node_name(child), addr, 1573 smp_busctl_ua); 1574 if (dup) { 1575 ASSERT(ndi_flavor_get(dup) == SCSA_FLAVOR_SMP); 1576 if (ndi_flavor_get(dup) != SCSA_FLAVOR_SMP) { 1577 SCSI_HBA_LOG((_LOG(1), NULL, child, 1578 "init failed: %s@%s: not SMP flavored", 1579 ddi_node_name(child), addr)); 1580 return (DDI_FAILURE); 1581 } 1582 if (dup != child) { 1583 SCSI_HBA_LOG((_LOG(4), NULL, child, 1584 "init failed: %s@%s: detected duplicate %p", 1585 ddi_node_name(child), addr, (void *)dup)); 1586 return (DDI_FAILURE); 1587 } 1588 } 1589 1590 1591 /* set the node @addr string */ 1592 ddi_set_name_addr(child, addr); 1593 1594 /* Allocate and initialize smp_device. */ 1595 smp_sd = kmem_zalloc(sizeof (struct smp_device), KM_SLEEP); 1596 smp_sd->smp_sd_dev = child; 1597 smp_sd->smp_sd_address.smp_a_hba_tran = tran; 1598 bcopy(&wwn, smp_sd->smp_sd_address.smp_a_wwn, SAS_WWN_BYTE_SIZE); 1599 1600 ddi_set_driver_private(child, smp_sd); 1601 1602 if (tran->smp_tran_init && ((*tran->smp_tran_init)(self, child, 1603 tran, smp_sd) != DDI_SUCCESS)) { 1604 kmem_free(smp_sd, sizeof (struct smp_device)); 1605 scsi_enumeration_failed(child, -1, NULL, "smp_tran_init"); 1606 ddi_set_driver_private(child, NULL); 1607 ddi_set_name_addr(child, NULL); 1608 return (DDI_FAILURE); 1609 } 1610 1611 return (DDI_SUCCESS); 1612 } 1613 1614 /*ARGSUSED*/ 1615 static int 1616 smp_busctl_uninitchild(dev_info_t *child) 1617 { 1618 dev_info_t *self = ddi_get_parent(child); 1619 struct smp_device *smp_sd = ddi_get_driver_private(child); 1620 smp_hba_tran_t *tran; 1621 1622 tran = ndi_flavorv_get(self, SCSA_FLAVOR_SMP); 1623 ASSERT(smp_sd && tran); 1624 if ((smp_sd == NULL) || (tran == NULL)) 1625 return (DDI_FAILURE); 1626 1627 if (tran->smp_tran_free) 1628 (*tran->smp_tran_free) (self, child, tran, smp_sd); 1629 1630 kmem_free(smp_sd, sizeof (*smp_sd)); 1631 ddi_set_driver_private(child, NULL); 1632 ddi_set_name_addr(child, NULL); 1633 return (DDI_SUCCESS); 1634 } 1635 1636 /* Find an "smp" child at the specified address. */ 1637 static dev_info_t * 1638 smp_findchild(dev_info_t *self, char *addr) 1639 { 1640 dev_info_t *child; 1641 1642 /* Search "smp" devinfo child at specified address. */ 1643 ASSERT(self && DEVI_BUSY_OWNED(self) && addr); 1644 for (child = ddi_get_child(self); child; 1645 child = ddi_get_next_sibling(child)) { 1646 /* skip non-"smp" nodes */ 1647 if (ndi_flavor_get(child) != SCSA_FLAVOR_SMP) 1648 continue; 1649 1650 /* Attempt initchild to establish unit-address */ 1651 if (i_ddi_node_state(child) < DS_INITIALIZED) 1652 (void) ddi_initchild(self, child); 1653 1654 /* Verify state and non-NULL unit-address. */ 1655 if ((i_ddi_node_state(child) < DS_INITIALIZED) || 1656 (ddi_get_name_addr(child) == NULL)) 1657 continue; 1658 1659 /* Return "smp" child if unit-address matches. */ 1660 if (strcmp(ddi_get_name_addr(child), addr) == 0) 1661 return (child); 1662 } 1663 return (NULL); 1664 } 1665 1666 /* 1667 * Search for "smp" child of self at the specified address. If found, online 1668 * and return with a hold. Unlike general SCSI configuration, we can assume 1669 * the the device is actually there when we are called (i.e., device is 1670 * created by hotplug, not by bus_config). 1671 */ 1672 int 1673 smp_hba_bus_config(dev_info_t *self, char *addr, dev_info_t **childp) 1674 { 1675 dev_info_t *child; 1676 boolean_t enteredv; 1677 1678 ASSERT(self && addr && childp); 1679 *childp = NULL; 1680 1681 /* Search for "smp" child. */ 1682 scsi_hba_devi_enter(self, &enteredv); 1683 if ((child = smp_findchild(self, addr)) == NULL) { 1684 scsi_hba_devi_exit(self, enteredv); 1685 return (NDI_FAILURE); 1686 } 1687 1688 /* Attempt online. */ 1689 if (ndi_devi_online(child, 0) != NDI_SUCCESS) { 1690 scsi_hba_devi_exit(self, enteredv); 1691 return (NDI_FAILURE); 1692 } 1693 1694 /* On success, return with active hold. */ 1695 ndi_hold_devi(child); 1696 scsi_hba_devi_exit(self, enteredv); 1697 *childp = child; 1698 return (NDI_SUCCESS); 1699 } 1700 1701 1702 1703 /* Create "smp" child devinfo node at specified unit-address. */ 1704 int 1705 smp_hba_bus_config_taddr(dev_info_t *self, char *addr) 1706 { 1707 dev_info_t *child; 1708 boolean_t enteredv; 1709 1710 /* 1711 * NOTE: If we ever uses a generic node name (.vs. a driver name) 1712 * or define a 'compatible' property, this code will need to use 1713 * a 'probe' node (ala scsi_device support) to obtain identity 1714 * information from the device. 1715 */ 1716 1717 /* Search for "smp" child. */ 1718 scsi_hba_devi_enter(self, &enteredv); 1719 child = smp_findchild(self, addr); 1720 if (child) { 1721 /* Child exists, note if this was a new reinsert. */ 1722 if (ndi_devi_device_insert(child)) 1723 SCSI_HBA_LOG((_LOGCFG, self, NULL, 1724 "devinfo smp@%s device_reinsert", addr)); 1725 1726 scsi_hba_devi_exit(self, enteredv); 1727 return (NDI_SUCCESS); 1728 } 1729 1730 /* Allocate "smp" child devinfo node and establish flavor of child. */ 1731 ndi_devi_alloc_sleep(self, "smp", DEVI_SID_HP_NODEID, &child); 1732 ASSERT(child); 1733 ndi_flavor_set(child, SCSA_FLAVOR_SMP); 1734 1735 /* Add unit-address property to child. */ 1736 if (ndi_prop_update_string(DDI_DEV_T_NONE, child, 1737 SCSI_ADDR_PROP_TARGET_PORT, addr) != DDI_PROP_SUCCESS) { 1738 (void) ndi_devi_free(child); 1739 scsi_hba_devi_exit(self, enteredv); 1740 return (NDI_FAILURE); 1741 } 1742 1743 /* Attempt to online the new "smp" node. */ 1744 (void) ndi_devi_online(child, 0); 1745 1746 scsi_hba_devi_exit(self, enteredv); 1747 return (NDI_SUCCESS); 1748 } 1749 1750 /* 1751 * Wrapper to scsi_ua_get which takes a devinfo argument instead of a 1752 * scsi_device structure. 1753 */ 1754 static int 1755 scsi_busctl_ua(dev_info_t *child, char *addr, int maxlen) 1756 { 1757 struct scsi_device *sd; 1758 1759 /* limit ndi_devi_findchild_by_callback to expected flavor */ 1760 if (ndi_flavor_get(child) != SCSA_FLAVOR_SCSI_DEVICE) 1761 return (DDI_FAILURE); 1762 1763 /* nodes are named by tran_get_name or default "tgt,lun" */ 1764 sd = ddi_get_driver_private(child); 1765 if (sd && (scsi_ua_get(sd, addr, maxlen) == 1)) 1766 return (DDI_SUCCESS); 1767 1768 return (DDI_FAILURE); 1769 } 1770 1771 static int 1772 scsi_busctl_reportdev(dev_info_t *child) 1773 { 1774 dev_info_t *self = ddi_get_parent(child); 1775 struct scsi_device *sd = ddi_get_driver_private(child); 1776 scsi_hba_tran_t *tran; 1777 char ua[SCSI_MAXNAMELEN]; 1778 char ra[SCSI_MAXNAMELEN]; 1779 1780 SCSI_HBA_LOG((_LOG_TRACE, NULL, child, __func__)); 1781 1782 tran = ndi_flavorv_get(self, SCSA_FLAVOR_SCSI_DEVICE); 1783 ASSERT(tran && sd); 1784 if ((tran == NULL) || (sd == NULL)) 1785 return (DDI_FAILURE); 1786 1787 /* get the unit_address and bus_addr information */ 1788 if ((scsi_ua_get(sd, ua, sizeof (ua)) == 0) || 1789 (scsi_ua_get_reportdev(sd, ra, sizeof (ra)) == 0)) { 1790 SCSI_HBA_LOG((_LOG(WARN), NULL, child, "REPORTDEV failure")); 1791 return (DDI_FAILURE); 1792 } 1793 1794 if (tran->tran_get_name == NULL) 1795 SCSI_HBA_LOG((_LOG_NF(CONT), "?%s%d at %s%d: %s", 1796 ddi_driver_name(child), ddi_get_instance(child), 1797 ddi_driver_name(self), ddi_get_instance(self), ra)); 1798 else if (*ra) 1799 SCSI_HBA_LOG((_LOG_NF(CONT), 1800 "?%s%d at %s%d: unit-address %s: %s", 1801 ddi_driver_name(child), ddi_get_instance(child), 1802 ddi_driver_name(self), ddi_get_instance(self), ua, ra)); 1803 else 1804 SCSI_HBA_LOG((_LOG_NF(CONT), 1805 "?%s%d at %s%d: unit-address %s", 1806 ddi_driver_name(child), ddi_get_instance(child), 1807 ddi_driver_name(self), ddi_get_instance(self), ua)); 1808 1809 return (DDI_SUCCESS); 1810 } 1811 1812 1813 /* 1814 * scsi_busctl_initchild is called to initialize the SCSA transport for 1815 * communication with a particular child scsi target device. Successful 1816 * initialization requires properties on the node which describe the address 1817 * of the target device. If the address of the target device can't be 1818 * determined from properties then DDI_NOT_WELL_FORMED is returned. Nodes that 1819 * are DDI_NOT_WELL_FORMED are considered an implementation artifact and 1820 * are hidden from devinfo snapshots by calling ndi_devi_set_hidden(). 1821 * The child may be one of the following types of devinfo nodes: 1822 * 1823 * OBP node: 1824 * OBP does not enumerate target devices attached a SCSI bus. These 1825 * template/stub/wild-card nodes are a legacy artifact for support of old 1826 * driver loading methods. Since they have no properties, 1827 * DDI_NOT_WELL_FORMED will be returned. 1828 * 1829 * SID node: 1830 * The node may be either a: 1831 * o probe/barrier SID node 1832 * o a dynamic SID target node 1833 * 1834 * driver.conf node: The situation for this nexus is different than most. 1835 * Typically a driver.conf node definition is used to either define a 1836 * new child devinfo node or to further decorate (via merge) a SID 1837 * child with properties. In our case we use the nodes for *both* 1838 * purposes. 1839 * 1840 * In both the SID node and driver.conf node cases we must form the nodes 1841 * "@addr" from the well-known scsi(9P) device unit-address properties on 1842 * the node. 1843 * 1844 * For HBA drivers that implement the deprecated tran_get_name interface, 1845 * "@addr" construction involves having that driver interpret properties via 1846 * scsi_busctl_ua -> scsi_ua_get -> tran_get_name: there is no 1847 * requirement for the property names to be well-known. 1848 * 1849 * NOTE: We don't currently support "merge". When this support is added a 1850 * specific property, like "unit-address", should *always* identify a 1851 * driver.conf node that needs to be merged into a specific SID node. When 1852 * enumeration is enabled, a .conf node without the "unit-address" property 1853 * should be ignored. The best way to establish the "unit-address" property 1854 * would be to have the system assign parent= and unit-address= from an 1855 * instance=# driver.conf entry (by using the instance tree). 1856 */ 1857 static int 1858 scsi_busctl_initchild(dev_info_t *child) 1859 { 1860 dev_info_t *self = ddi_get_parent(child); 1861 dev_info_t *dup; 1862 scsi_hba_tran_t *tran; 1863 struct scsi_device *sd; 1864 scsi_hba_tran_t *tran_clone; 1865 char *class; 1866 int tgt; 1867 int lun; 1868 int sfunc; 1869 int err = DDI_FAILURE; 1870 char addr[SCSI_MAXNAMELEN]; 1871 1872 ASSERT(DEVI_BUSY_OWNED(self)); 1873 SCSI_HBA_LOG((_LOG(4), NULL, child, "init begin")); 1874 1875 /* 1876 * For a driver like fp with multiple upper-layer-protocols 1877 * it is possible for scsi_hba_init in _init to plumb SCSA 1878 * and have the load of fcp (which does scsi_hba_attach_setup) 1879 * to fail. In this case we may get here with a NULL hba. 1880 */ 1881 tran = ndi_flavorv_get(self, SCSA_FLAVOR_SCSI_DEVICE); 1882 if (tran == NULL) 1883 return (DDI_NOT_WELL_FORMED); 1884 1885 /* 1886 * OBP may create template/stub/wild-card nodes for legacy driver 1887 * loading methods. These nodes have no properties, so we lack the 1888 * addressing properties to initchild them. Hide the node and return 1889 * DDI_NOT_WELL_FORMED. 1890 * 1891 * Future: define/use a ndi_devi_has_properties(dip) type interface. 1892 * 1893 * NOTE: It would be nice if we could delete these ill formed nodes by 1894 * implementing a DDI_NOT_WELL_FORMED_DELETE return code. This can't 1895 * be done until leadville debug code removes its dependencies 1896 * on the devinfo still being present after a failed ndi_devi_online. 1897 */ 1898 if ((DEVI(child)->devi_hw_prop_ptr == NULL) && 1899 (DEVI(child)->devi_drv_prop_ptr == NULL) && 1900 (DEVI(child)->devi_sys_prop_ptr == NULL)) { 1901 SCSI_HBA_LOG((_LOG(4), NULL, child, 1902 "init failed: no properties")); 1903 ndi_devi_set_hidden(child); 1904 return (DDI_NOT_WELL_FORMED); 1905 } 1906 1907 /* get legacy SPI addressing properties */ 1908 if ((tgt = ddi_prop_get_int(DDI_DEV_T_ANY, child, 1909 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, 1910 SCSI_ADDR_PROP_TARGET, -1)) == -1) { 1911 tgt = 0; 1912 /* 1913 * A driver.conf node for merging always has a target= property, 1914 * even if it is just a dummy that does not contain the real 1915 * target address. However drivers that register devids may 1916 * create stub driver.conf nodes without a target= property so 1917 * that pathological devid resolution works. Hide the stub 1918 * node and return DDI_NOT_WELL_FORMED. 1919 */ 1920 if (!scsi_hba_dev_is_sid(child)) { 1921 SCSI_HBA_LOG((_LOG(4), NULL, child, 1922 "init failed: stub .conf node")); 1923 ndi_devi_set_hidden(child); 1924 return (DDI_NOT_WELL_FORMED); 1925 } 1926 } 1927 lun = ddi_prop_get_int(DDI_DEV_T_ANY, child, 1928 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, SCSI_ADDR_PROP_LUN, 0); 1929 sfunc = ddi_prop_get_int(DDI_DEV_T_ANY, child, 1930 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, SCSI_ADDR_PROP_SFUNC, -1); 1931 1932 /* 1933 * The scsi_address structure may not specify all the addressing 1934 * information. For an old HBA that doesn't support tran_get_name 1935 * (most pre-SCSI-3 HBAs) the scsi_address structure is still used, 1936 * so the target property must exist and the LUN must be < 256. 1937 */ 1938 if ((tran->tran_get_name == NULL) && 1939 ((tgt >= USHRT_MAX) || (lun >= 256))) { 1940 SCSI_HBA_LOG((_LOG(1), NULL, child, 1941 "init failed: illegal/missing properties")); 1942 ndi_devi_set_hidden(child); 1943 return (DDI_NOT_WELL_FORMED); 1944 } 1945 1946 /* 1947 * We need to initialize a fair amount of our environment to invoke 1948 * tran_get_name (via scsi_busctl_ua and scsi_ua_get) to 1949 * produce the "@addr" name from addressing properties. Allocate and 1950 * initialize scsi device structure. 1951 */ 1952 sd = kmem_zalloc(sizeof (struct scsi_device), KM_SLEEP); 1953 mutex_init(&sd->sd_mutex, NULL, MUTEX_DRIVER, NULL); 1954 sd->sd_dev = child; 1955 sd->sd_pathinfo = NULL; 1956 sd->sd_uninit_prevent = 0; 1957 ddi_set_driver_private(child, sd); 1958 1959 if (tran->tran_hba_flags & SCSI_HBA_ADDR_COMPLEX) { 1960 /* 1961 * For a SCSI_HBA_ADDR_COMPLEX transport we store a pointer to 1962 * scsi_device in the scsi_address structure. This allows an 1963 * HBA driver to find its per-scsi_device private data 1964 * (accessible to the HBA given just the scsi_address by using 1965 * scsi_address_device(9F)/scsi_device_hba_private_get(9F)). 1966 */ 1967 sd->sd_address.a.a_sd = sd; 1968 tran_clone = NULL; 1969 } else { 1970 /* 1971 * Initialize the scsi_address so that a SCSI-2 target driver 1972 * talking to a SCSI-2 device on a SCSI-3 bus (spi) continues 1973 * to work. We skew the secondary function value so that we 1974 * can tell from the address structure if we are processing 1975 * a secondary function request. 1976 */ 1977 sd->sd_address.a_target = (ushort_t)tgt; 1978 sd->sd_address.a_lun = (uchar_t)lun; 1979 if (sfunc == -1) 1980 sd->sd_address.a_sublun = (uchar_t)0; 1981 else 1982 sd->sd_address.a_sublun = (uchar_t)sfunc + 1; 1983 1984 /* 1985 * NOTE: Don't limit LUNs to scsi_options value because a 1986 * scsi_device discovered via SPI dynamic enumeration might 1987 * still support SCMD_REPORT_LUNS. 1988 */ 1989 1990 /* 1991 * Deprecated: Use SCSI_HBA_ADDR_COMPLEX: 1992 * Clone transport structure if requested. Cloning allows 1993 * an HBA to maintain target-specific information if 1994 * necessary, such as target addressing information that 1995 * does not adhere to the scsi_address structure format. 1996 */ 1997 if (tran->tran_hba_flags & SCSI_HBA_TRAN_CLONE) { 1998 tran_clone = kmem_alloc( 1999 sizeof (scsi_hba_tran_t), KM_SLEEP); 2000 bcopy((caddr_t)tran, 2001 (caddr_t)tran_clone, sizeof (scsi_hba_tran_t)); 2002 tran = tran_clone; 2003 tran->tran_sd = sd; 2004 } else { 2005 tran_clone = NULL; 2006 ASSERT(tran->tran_sd == NULL); 2007 } 2008 } 2009 2010 /* establish scsi_address pointer to the HBA's tran structure */ 2011 sd->sd_address.a_hba_tran = tran; 2012 2013 /* 2014 * This is a grotty hack that allows direct-access (non-scsa) drivers 2015 * (like chs, ata, and mlx which all make cmdk children) to put its 2016 * own vector in the 'a_hba_tran' field. When all the drivers that do 2017 * this are fixed, please remove this hack. 2018 * 2019 * NOTE: This hack is also shows up in the DEVP_TO_TRAN implementation 2020 * in scsi_confsubr.c. 2021 */ 2022 sd->sd_tran_safe = tran; 2023 2024 /* 2025 * If the class property is not already established, set it to "scsi". 2026 * This is done so that parent= driver.conf nodes have class. 2027 */ 2028 if (ddi_prop_lookup_string(DDI_DEV_T_ANY, child, 2029 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, "class", 2030 &class) == DDI_PROP_SUCCESS) { 2031 ddi_prop_free(class); 2032 } else if (ndi_prop_update_string(DDI_DEV_T_NONE, child, 2033 "class", "scsi") != DDI_PROP_SUCCESS) { 2034 SCSI_HBA_LOG((_LOG(2), NULL, child, "init failed: class")); 2035 ndi_devi_set_hidden(child); 2036 err = DDI_NOT_WELL_FORMED; 2037 goto failure; 2038 } 2039 2040 /* Establish the @addr name of the child. */ 2041 *addr = '\0'; 2042 if (scsi_busctl_ua(child, addr, sizeof (addr)) != DDI_SUCCESS) { 2043 /* 2044 * Some driver.conf files add bogus target properties (relative 2045 * to their nexus representation of target) to their stub 2046 * nodes, causing the check above to not filter them. 2047 */ 2048 SCSI_HBA_LOG((_LOG(3), NULL, child, 2049 "init failed: scsi_busctl_ua call")); 2050 ndi_devi_set_hidden(child); 2051 err = DDI_NOT_WELL_FORMED; 2052 goto failure; 2053 } 2054 if (*addr == '\0') { 2055 SCSI_HBA_LOG((_LOG(2), NULL, child, "init failed: ua")); 2056 ndi_devi_set_hidden(child); 2057 err = DDI_NOT_WELL_FORMED; 2058 goto failure; 2059 } 2060 2061 /* Prevent duplicate nodes. */ 2062 dup = ndi_devi_findchild_by_callback(self, ddi_node_name(child), addr, 2063 scsi_busctl_ua); 2064 if (dup) { 2065 ASSERT(ndi_flavor_get(dup) == SCSA_FLAVOR_SCSI_DEVICE); 2066 if (ndi_flavor_get(dup) != SCSA_FLAVOR_SCSI_DEVICE) { 2067 SCSI_HBA_LOG((_LOG(1), NULL, child, 2068 "init failed: %s@%s: not SCSI_DEVICE flavored", 2069 ddi_node_name(child), addr)); 2070 goto failure; 2071 } 2072 if (dup != child) { 2073 SCSI_HBA_LOG((_LOG(4), NULL, child, 2074 "init failed: %s@%s: detected duplicate %p", 2075 ddi_node_name(child), addr, (void *)dup)); 2076 goto failure; 2077 } 2078 } 2079 2080 /* set the node @addr string */ 2081 ddi_set_name_addr(child, addr); 2082 2083 /* call HBA's target init entry point if it exists */ 2084 if (tran->tran_tgt_init != NULL) { 2085 SCSI_HBA_LOG((_LOG(4), NULL, child, "init tran_tgt_init")); 2086 sd->sd_tran_tgt_free_done = 0; 2087 if ((*tran->tran_tgt_init) 2088 (self, child, tran, sd) != DDI_SUCCESS) { 2089 scsi_enumeration_failed(child, -1, NULL, 2090 "tran_tgt_init"); 2091 goto failure; 2092 } 2093 } 2094 2095 SCSI_HBA_LOG((_LOG(3), NULL, child, "init successful")); 2096 return (DDI_SUCCESS); 2097 2098 failure: 2099 if (tran_clone) 2100 kmem_free(tran_clone, sizeof (scsi_hba_tran_t)); 2101 mutex_destroy(&sd->sd_mutex); 2102 kmem_free(sd, sizeof (*sd)); 2103 ddi_set_driver_private(child, NULL); 2104 ddi_set_name_addr(child, NULL); 2105 2106 return (err); /* remove the node */ 2107 } 2108 2109 static int 2110 scsi_busctl_uninitchild(dev_info_t *child) 2111 { 2112 dev_info_t *self = ddi_get_parent(child); 2113 struct scsi_device *sd = ddi_get_driver_private(child); 2114 scsi_hba_tran_t *tran; 2115 scsi_hba_tran_t *tran_clone; 2116 2117 ASSERT(DEVI_BUSY_OWNED(self)); 2118 2119 tran = ndi_flavorv_get(self, SCSA_FLAVOR_SCSI_DEVICE); 2120 ASSERT(tran && sd); 2121 if ((tran == NULL) || (sd == NULL)) 2122 return (DDI_FAILURE); 2123 2124 /* 2125 * We use sd_uninit_prevent to avoid uninitializing barrier/probe 2126 * nodes that are still in use. Since barrier/probe nodes are not 2127 * attached we can't prevent their state demotion via ndi_hold_devi. 2128 */ 2129 if (sd->sd_uninit_prevent) { 2130 SCSI_HBA_LOG((_LOG(2), NULL, child, "uninit prevented")); 2131 return (DDI_FAILURE); 2132 } 2133 2134 /* 2135 * Don't uninitialize a client node if it still has paths. 2136 */ 2137 if (MDI_CLIENT(child) && mdi_client_get_path_count(child)) { 2138 SCSI_HBA_LOG((_LOG(2), NULL, child, 2139 "uninit prevented, client has paths")); 2140 return (DDI_FAILURE); 2141 } 2142 2143 SCSI_HBA_LOG((_LOG(3), NULL, child, "uninit begin")); 2144 2145 if (tran->tran_hba_flags & SCSI_HBA_TRAN_CLONE) { 2146 tran_clone = sd->sd_address.a_hba_tran; 2147 2148 /* ... grotty hack, involving sd_tran_safe, continued. */ 2149 if (tran_clone != sd->sd_tran_safe) { 2150 tran_clone = sd->sd_tran_safe; 2151 #ifdef DEBUG 2152 /* 2153 * Complain so things get fixed and hack can, at 2154 * some point in time, be removed. 2155 */ 2156 SCSI_HBA_LOG((_LOG(WARN), self, NULL, 2157 "'%s' is corrupting a_hba_tran", sd->sd_dev ? 2158 ddi_driver_name(sd->sd_dev) : "unknown_driver")); 2159 #endif /* DEBUG */ 2160 } 2161 2162 ASSERT(tran_clone->tran_hba_flags & SCSI_HBA_TRAN_CLONE); 2163 ASSERT(tran_clone->tran_sd == sd); 2164 tran = tran_clone; 2165 } else { 2166 tran_clone = NULL; 2167 ASSERT(tran->tran_sd == NULL); 2168 } 2169 2170 /* 2171 * To simplify host adapter drivers we guarantee that multiple 2172 * tran_tgt_init(9E) calls of the same unit address are never 2173 * active at the same time. This requires that we always call 2174 * tran_tgt_free on probe/barrier nodes directly prior to 2175 * uninitchild. 2176 * 2177 * NOTE: To correctly support SCSI_HBA_TRAN_CLONE, we must use 2178 * the (possibly cloned) hba_tran pointer from the scsi_device 2179 * instead of hba_tran. 2180 */ 2181 if (tran->tran_tgt_free) { 2182 if (!sd->sd_tran_tgt_free_done) { 2183 SCSI_HBA_LOG((_LOG(4), NULL, child, 2184 "uninit tran_tgt_free")); 2185 (*tran->tran_tgt_free) (self, child, tran, sd); 2186 sd->sd_tran_tgt_free_done = 1; 2187 } else { 2188 SCSI_HBA_LOG((_LOG(4), NULL, child, 2189 "uninit tran_tgt_free already done")); 2190 } 2191 } 2192 2193 /* 2194 * If a inquiry data is still allocated (by scsi_probe()) we 2195 * free the allocation here. This keeps scsi_inq valid for the 2196 * same duration as the corresponding inquiry properties. It 2197 * also allows a tran_tgt_init() implementation that establishes 2198 * sd_inq to deal with deallocation in its tran_tgt_free 2199 * (setting sd_inq back to NULL) without upsetting the 2200 * framework. Moving the inquiry free here also allows setting 2201 * of sd_uninit_prevent to preserve the data for lun0 based 2202 * scsi_get_device_type_scsi_options() calls. 2203 */ 2204 if (sd->sd_inq) { 2205 kmem_free(sd->sd_inq, SUN_INQSIZE); 2206 sd->sd_inq = (struct scsi_inquiry *)NULL; 2207 } 2208 2209 mutex_destroy(&sd->sd_mutex); 2210 if (tran_clone) 2211 kmem_free(tran_clone, sizeof (scsi_hba_tran_t)); 2212 kmem_free(sd, sizeof (*sd)); 2213 2214 ddi_set_driver_private(child, NULL); 2215 SCSI_HBA_LOG((_LOG(3), NULL, child, "uninit complete")); 2216 ddi_set_name_addr(child, NULL); 2217 return (DDI_SUCCESS); 2218 } 2219 2220 static int 2221 iport_busctl_ua(dev_info_t *child, char *addr, int maxlen) 2222 { 2223 char *iport_ua; 2224 2225 /* limit ndi_devi_findchild_by_callback to expected flavor */ 2226 if (ndi_flavor_get(child) != SCSA_FLAVOR_IPORT) 2227 return (DDI_FAILURE); 2228 2229 if (ddi_prop_lookup_string(DDI_DEV_T_ANY, child, 2230 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, 2231 SCSI_ADDR_PROP_IPORTUA, &iport_ua) != DDI_SUCCESS) { 2232 return (DDI_FAILURE); 2233 } 2234 2235 (void) snprintf(addr, maxlen, "%s", iport_ua); 2236 ddi_prop_free(iport_ua); 2237 return (DDI_SUCCESS); 2238 } 2239 2240 static int 2241 iport_busctl_reportdev(dev_info_t *child) 2242 { 2243 dev_info_t *self = ddi_get_parent(child); 2244 char *iport_ua; 2245 char *initiator_port = NULL; 2246 2247 if (ddi_prop_lookup_string(DDI_DEV_T_ANY, child, 2248 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, 2249 SCSI_ADDR_PROP_IPORTUA, &iport_ua) != DDI_SUCCESS) 2250 return (DDI_FAILURE); 2251 2252 (void) ddi_prop_lookup_string(DDI_DEV_T_ANY, child, 2253 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, 2254 SCSI_ADDR_PROP_INITIATOR_PORT, &initiator_port); 2255 2256 if (initiator_port) { 2257 SCSI_HBA_LOG((_LOG_NF(CONT), 2258 "?%s%d at %s%d: %s %s %s %s", 2259 ddi_driver_name(child), ddi_get_instance(child), 2260 ddi_driver_name(self), ddi_get_instance(self), 2261 SCSI_ADDR_PROP_INITIATOR_PORT, initiator_port, 2262 SCSI_ADDR_PROP_IPORTUA, iport_ua)); 2263 ddi_prop_free(initiator_port); 2264 } else { 2265 SCSI_HBA_LOG((_LOG_NF(CONT), "?%s%d at %s%d: %s %s", 2266 ddi_driver_name(child), ddi_get_instance(child), 2267 ddi_driver_name(self), ddi_get_instance(self), 2268 SCSI_ADDR_PROP_IPORTUA, iport_ua)); 2269 } 2270 ddi_prop_free(iport_ua); 2271 return (DDI_SUCCESS); 2272 } 2273 2274 /* initchild SCSA iport 'child' node */ 2275 static int 2276 iport_busctl_initchild(dev_info_t *child) 2277 { 2278 dev_info_t *self = ddi_get_parent(child); 2279 dev_info_t *dup = NULL; 2280 char addr[SCSI_MAXNAMELEN]; 2281 2282 if (iport_busctl_ua(child, addr, sizeof (addr)) != DDI_SUCCESS) 2283 return (DDI_NOT_WELL_FORMED); 2284 2285 /* Prevent duplicate nodes. */ 2286 dup = ndi_devi_findchild_by_callback(self, ddi_node_name(child), addr, 2287 iport_busctl_ua); 2288 if (dup) { 2289 ASSERT(ndi_flavor_get(dup) == SCSA_FLAVOR_IPORT); 2290 if (ndi_flavor_get(dup) != SCSA_FLAVOR_IPORT) { 2291 SCSI_HBA_LOG((_LOG(1), NULL, child, 2292 "init failed: %s@%s: not IPORT flavored", 2293 ddi_node_name(child), addr)); 2294 return (DDI_FAILURE); 2295 } 2296 if (dup != child) { 2297 SCSI_HBA_LOG((_LOG(4), NULL, child, 2298 "init failed: %s@%s: detected duplicate %p", 2299 ddi_node_name(child), addr, (void *)dup)); 2300 return (DDI_FAILURE); 2301 } 2302 } 2303 2304 /* set the node @addr string */ 2305 ddi_set_name_addr(child, addr); 2306 2307 return (DDI_SUCCESS); 2308 } 2309 2310 /* uninitchild SCSA iport 'child' node */ 2311 static int 2312 iport_busctl_uninitchild(dev_info_t *child) 2313 { 2314 ddi_set_name_addr(child, NULL); 2315 return (DDI_SUCCESS); 2316 } 2317 2318 /* Uninitialize scsi_device flavor of transport on SCSA iport 'child' node. */ 2319 static void 2320 iport_postdetach_tran_scsi_device(dev_info_t *child) 2321 { 2322 scsi_hba_tran_t *tran; 2323 2324 tran = ndi_flavorv_get(child, SCSA_FLAVOR_SCSI_DEVICE); 2325 if (tran == NULL) 2326 return; 2327 2328 scsa_tran_teardown(child, tran); 2329 scsa_nexus_teardown(child, tran); 2330 2331 ndi_flavorv_set(child, SCSA_FLAVOR_SCSI_DEVICE, NULL); 2332 scsi_hba_tran_free(tran); 2333 } 2334 2335 /* Initialize scsi_device flavor of transport on SCSA iport 'child' node. */ 2336 static void 2337 iport_preattach_tran_scsi_device(dev_info_t *child) 2338 { 2339 dev_info_t *hba = ddi_get_parent(child); 2340 scsi_hba_tran_t *htran; 2341 scsi_hba_tran_t *tran; 2342 2343 /* parent HBA node scsi_device tran is required */ 2344 htran = ndi_flavorv_get(hba, SCSA_FLAVOR_SCSI_DEVICE); 2345 ASSERT(htran); 2346 2347 /* Allocate iport child's scsi_device transport vector */ 2348 tran = scsi_hba_tran_alloc(child, SCSI_HBA_CANSLEEP); 2349 ASSERT(tran); 2350 2351 /* Structure-copy scsi_device transport of HBA to iport. */ 2352 *tran = *htran; 2353 2354 /* 2355 * Reset scsi_device transport fields not shared with the 2356 * parent, and not established below. 2357 */ 2358 tran->tran_open_flag = 0; 2359 tran->tran_hba_private = NULL; 2360 2361 /* Establish the devinfo context of this tran structure. */ 2362 tran->tran_iport_dip = child; 2363 2364 /* Clear SCSI_HBA_SCSA flags (except TA) */ 2365 tran->tran_hba_flags &= 2366 ~(SCSI_HBA_SCSA_FM | SCSI_HBA_SCSA_PHCI); /* clear parent state */ 2367 tran->tran_hba_flags |= SCSI_HBA_SCSA_TA; /* always TA */ 2368 tran->tran_hba_flags &= ~SCSI_HBA_HBA; /* never HBA */ 2369 2370 /* Establish flavor of transport (and ddi_get_driver_private()) */ 2371 ndi_flavorv_set(child, SCSA_FLAVOR_SCSI_DEVICE, tran); 2372 2373 /* Setup iport node */ 2374 if ((scsa_nexus_setup(child, tran) != DDI_SUCCESS) || 2375 (scsa_tran_setup(child, tran) != DDI_SUCCESS)) 2376 iport_postdetach_tran_scsi_device(child); 2377 } 2378 2379 /* Uninitialize smp_device flavor of transport on SCSA iport 'child' node. */ 2380 static void 2381 iport_postdetach_tran_smp_device(dev_info_t *child) 2382 { 2383 smp_hba_tran_t *tran; 2384 2385 tran = ndi_flavorv_get(child, SCSA_FLAVOR_SMP); 2386 if (tran == NULL) 2387 return; 2388 2389 ndi_flavorv_set(child, SCSA_FLAVOR_SMP, NULL); 2390 smp_hba_tran_free(tran); 2391 } 2392 2393 /* Initialize smp_device flavor of transport on SCSA iport 'child' node. */ 2394 static void 2395 iport_preattach_tran_smp_device(dev_info_t *child) 2396 { 2397 dev_info_t *hba = ddi_get_parent(child); 2398 smp_hba_tran_t *htran; 2399 smp_hba_tran_t *tran; 2400 2401 /* parent HBA node smp_device tran is optional */ 2402 htran = ndi_flavorv_get(hba, SCSA_FLAVOR_SMP); 2403 if (htran == NULL) { 2404 ndi_flavorv_set(child, SCSA_FLAVOR_SMP, NULL); 2405 return; 2406 } 2407 2408 /* Allocate iport child's smp_device transport vector */ 2409 tran = smp_hba_tran_alloc(child); 2410 2411 /* Structure-copy smp_device transport of HBA to iport. */ 2412 *tran = *htran; 2413 2414 /* Establish flavor of transport */ 2415 ndi_flavorv_set(child, SCSA_FLAVOR_SMP, tran); 2416 } 2417 2418 /* 2419 * Generic bus_ctl operations for SCSI HBA's, 2420 * hiding the busctl interface from the HBA. 2421 */ 2422 /*ARGSUSED*/ 2423 static int 2424 scsi_hba_bus_ctl( 2425 dev_info_t *self, 2426 dev_info_t *child, 2427 ddi_ctl_enum_t op, 2428 void *arg, 2429 void *result) 2430 { 2431 int child_flavor = 0; 2432 int val; 2433 ddi_dma_attr_t *attr; 2434 scsi_hba_tran_t *tran; 2435 struct attachspec *as; 2436 struct detachspec *ds; 2437 2438 /* For some ops, child is 'arg'. */ 2439 if ((op == DDI_CTLOPS_INITCHILD) || (op == DDI_CTLOPS_UNINITCHILD)) 2440 child = (dev_info_t *)arg; 2441 2442 /* Determine the flavor of the child: scsi, smp, iport */ 2443 child_flavor = ndi_flavor_get(child); 2444 2445 switch (op) { 2446 case DDI_CTLOPS_INITCHILD: 2447 switch (child_flavor) { 2448 case SCSA_FLAVOR_SCSI_DEVICE: 2449 return (scsi_busctl_initchild(child)); 2450 case SCSA_FLAVOR_SMP: 2451 return (smp_busctl_initchild(child)); 2452 case SCSA_FLAVOR_IPORT: 2453 return (iport_busctl_initchild(child)); 2454 default: 2455 return (DDI_FAILURE); 2456 } 2457 /* NOTREACHED */ 2458 2459 case DDI_CTLOPS_UNINITCHILD: 2460 switch (child_flavor) { 2461 case SCSA_FLAVOR_SCSI_DEVICE: 2462 return (scsi_busctl_uninitchild(child)); 2463 case SCSA_FLAVOR_SMP: 2464 return (smp_busctl_uninitchild(child)); 2465 case SCSA_FLAVOR_IPORT: 2466 return (iport_busctl_uninitchild(child)); 2467 default: 2468 return (DDI_FAILURE); 2469 } 2470 /* NOTREACHED */ 2471 2472 case DDI_CTLOPS_REPORTDEV: 2473 switch (child_flavor) { 2474 case SCSA_FLAVOR_SCSI_DEVICE: 2475 return (scsi_busctl_reportdev(child)); 2476 case SCSA_FLAVOR_SMP: 2477 return (smp_busctl_reportdev(child)); 2478 case SCSA_FLAVOR_IPORT: 2479 return (iport_busctl_reportdev(child)); 2480 default: 2481 return (DDI_FAILURE); 2482 } 2483 /* NOTREACHED */ 2484 2485 case DDI_CTLOPS_ATTACH: 2486 as = (struct attachspec *)arg; 2487 2488 if (child_flavor != SCSA_FLAVOR_IPORT) 2489 return (DDI_SUCCESS); 2490 2491 /* iport processing */ 2492 if (as->when == DDI_PRE) { 2493 /* setup pre attach(9E) */ 2494 iport_preattach_tran_scsi_device(child); 2495 iport_preattach_tran_smp_device(child); 2496 } else if ((as->when == DDI_POST) && 2497 (as->result != DDI_SUCCESS)) { 2498 /* cleanup if attach(9E) failed */ 2499 iport_postdetach_tran_scsi_device(child); 2500 iport_postdetach_tran_smp_device(child); 2501 } 2502 return (DDI_SUCCESS); 2503 2504 case DDI_CTLOPS_DETACH: 2505 ds = (struct detachspec *)arg; 2506 2507 if (child_flavor != SCSA_FLAVOR_IPORT) 2508 return (DDI_SUCCESS); 2509 2510 /* iport processing */ 2511 if ((ds->when == DDI_POST) && 2512 (ds->result == DDI_SUCCESS)) { 2513 /* cleanup if detach(9E) was successful */ 2514 iport_postdetach_tran_scsi_device(child); 2515 iport_postdetach_tran_smp_device(child); 2516 } 2517 return (DDI_SUCCESS); 2518 2519 case DDI_CTLOPS_IOMIN: 2520 tran = ddi_get_driver_private(self); 2521 ASSERT(tran); 2522 if (tran == NULL) 2523 return (DDI_FAILURE); 2524 2525 /* 2526 * The 'arg' value of nonzero indicates 'streaming' 2527 * mode. If in streaming mode, pick the largest 2528 * of our burstsizes available and say that that 2529 * is our minimum value (modulo what minxfer is). 2530 */ 2531 attr = &tran->tran_dma_attr; 2532 val = *((int *)result); 2533 val = maxbit(val, attr->dma_attr_minxfer); 2534 *((int *)result) = maxbit(val, ((intptr_t)arg ? 2535 (1<<ddi_ffs(attr->dma_attr_burstsizes)-1) : 2536 (1<<(ddi_fls(attr->dma_attr_burstsizes)-1)))); 2537 2538 return (ddi_ctlops(self, child, op, arg, result)); 2539 2540 case DDI_CTLOPS_SIDDEV: 2541 return (ndi_dev_is_persistent_node(child) ? 2542 DDI_SUCCESS : DDI_FAILURE); 2543 2544 case DDI_CTLOPS_POWER: 2545 return (DDI_SUCCESS); 2546 2547 /* 2548 * These ops correspond to functions that "shouldn't" be called 2549 * by a SCSI target driver. So we whine when we're called. 2550 */ 2551 case DDI_CTLOPS_DMAPMAPC: 2552 case DDI_CTLOPS_REPORTINT: 2553 case DDI_CTLOPS_REGSIZE: 2554 case DDI_CTLOPS_NREGS: 2555 case DDI_CTLOPS_SLAVEONLY: 2556 case DDI_CTLOPS_AFFINITY: 2557 case DDI_CTLOPS_POKE: 2558 case DDI_CTLOPS_PEEK: 2559 SCSI_HBA_LOG((_LOG(WARN), self, NULL, "invalid op (%d)", op)); 2560 return (DDI_FAILURE); 2561 2562 /* Everything else we pass up */ 2563 case DDI_CTLOPS_PTOB: 2564 case DDI_CTLOPS_BTOP: 2565 case DDI_CTLOPS_BTOPR: 2566 case DDI_CTLOPS_DVMAPAGESIZE: 2567 default: 2568 return (ddi_ctlops(self, child, op, arg, result)); 2569 } 2570 /* NOTREACHED */ 2571 } 2572 2573 /* 2574 * Private wrapper for scsi_pkt's allocated via scsi_hba_pkt_alloc() 2575 */ 2576 struct scsi_pkt_wrapper { 2577 struct scsi_pkt scsi_pkt; 2578 int pkt_wrapper_magic; 2579 int pkt_wrapper_len; 2580 }; 2581 2582 #if !defined(lint) 2583 _NOTE(SCHEME_PROTECTS_DATA("unique per thread", scsi_pkt_wrapper)) 2584 _NOTE(SCHEME_PROTECTS_DATA("Unshared Data", dev_ops)) 2585 #endif 2586 2587 /* 2588 * Called by an HBA to allocate a scsi_pkt 2589 */ 2590 /*ARGSUSED*/ 2591 struct scsi_pkt * 2592 scsi_hba_pkt_alloc( 2593 dev_info_t *self, 2594 struct scsi_address *ap, 2595 int cmdlen, 2596 int statuslen, 2597 int tgtlen, 2598 int hbalen, 2599 int (*callback)(caddr_t arg), 2600 caddr_t arg) 2601 { 2602 struct scsi_pkt *pkt; 2603 struct scsi_pkt_wrapper *hba_pkt; 2604 caddr_t p; 2605 int acmdlen, astatuslen, atgtlen, ahbalen; 2606 int pktlen; 2607 2608 /* Sanity check */ 2609 if (callback != SLEEP_FUNC && callback != NULL_FUNC) 2610 SCSI_HBA_LOG((_LOG(WARN), self, NULL, 2611 "callback must be SLEEP_FUNC or NULL_FUNC")); 2612 2613 /* 2614 * Round up so everything gets allocated on long-word boundaries 2615 */ 2616 acmdlen = ROUNDUP(cmdlen); 2617 astatuslen = ROUNDUP(statuslen); 2618 atgtlen = ROUNDUP(tgtlen); 2619 ahbalen = ROUNDUP(hbalen); 2620 pktlen = sizeof (struct scsi_pkt_wrapper) + 2621 acmdlen + astatuslen + atgtlen + ahbalen; 2622 2623 hba_pkt = kmem_zalloc(pktlen, 2624 (callback == SLEEP_FUNC) ? KM_SLEEP : KM_NOSLEEP); 2625 if (hba_pkt == NULL) { 2626 ASSERT(callback == NULL_FUNC); 2627 return (NULL); 2628 } 2629 2630 /* 2631 * Set up our private info on this pkt 2632 */ 2633 hba_pkt->pkt_wrapper_len = pktlen; 2634 hba_pkt->pkt_wrapper_magic = PKT_WRAPPER_MAGIC; /* alloced correctly */ 2635 pkt = &hba_pkt->scsi_pkt; 2636 2637 /* 2638 * Set up pointers to private data areas, cdb, and status. 2639 */ 2640 p = (caddr_t)(hba_pkt + 1); 2641 if (hbalen > 0) { 2642 pkt->pkt_ha_private = (opaque_t)p; 2643 p += ahbalen; 2644 } 2645 if (tgtlen > 0) { 2646 pkt->pkt_private = (opaque_t)p; 2647 p += atgtlen; 2648 } 2649 if (statuslen > 0) { 2650 pkt->pkt_scbp = (uchar_t *)p; 2651 p += astatuslen; 2652 } 2653 if (cmdlen > 0) { 2654 pkt->pkt_cdbp = (uchar_t *)p; 2655 } 2656 2657 /* 2658 * Initialize the pkt's scsi_address 2659 */ 2660 pkt->pkt_address = *ap; 2661 2662 /* 2663 * NB: It may not be safe for drivers, esp target drivers, to depend 2664 * on the following fields being set until all the scsi_pkt 2665 * allocation violations discussed in scsi_pkt.h are all resolved. 2666 */ 2667 pkt->pkt_cdblen = cmdlen; 2668 pkt->pkt_tgtlen = tgtlen; 2669 pkt->pkt_scblen = statuslen; 2670 2671 return (pkt); 2672 } 2673 2674 /* 2675 * Called by an HBA to free a scsi_pkt 2676 */ 2677 /*ARGSUSED*/ 2678 void 2679 scsi_hba_pkt_free( 2680 struct scsi_address *ap, 2681 struct scsi_pkt *pkt) 2682 { 2683 kmem_free(pkt, ((struct scsi_pkt_wrapper *)pkt)->pkt_wrapper_len); 2684 } 2685 2686 /* 2687 * Return 1 if the scsi_pkt used a proper allocator. 2688 * 2689 * The DDI does not allow a driver to allocate it's own scsi_pkt(9S), a 2690 * driver should not have *any* compiled in dependencies on "sizeof (struct 2691 * scsi_pkt)". While this has been the case for many years, a number of 2692 * drivers have still not been fixed. This function can be used to detect 2693 * improperly allocated scsi_pkt structures, and produce messages identifying 2694 * drivers that need to be fixed. 2695 * 2696 * While drivers in violation are being fixed, this function can also 2697 * be used by the framework to detect packets that violated allocation 2698 * rules. 2699 * 2700 * NB: It is possible, but very unlikely, for this code to return a false 2701 * positive (finding correct magic, but for wrong reasons). Careful 2702 * consideration is needed for callers using this interface to condition 2703 * access to newer scsi_pkt fields (those after pkt_reason). 2704 * 2705 * NB: As an aid to minimizing the amount of work involved in 'fixing' legacy 2706 * drivers that violate scsi_*(9S) allocation rules, private 2707 * scsi_pkt_size()/scsi_size_clean() functions are available (see their 2708 * implementation for details). 2709 * 2710 * *** Non-legacy use of scsi_pkt_size() is discouraged. *** 2711 * 2712 * NB: When supporting broken HBA drivers is not longer a concern, this 2713 * code should be removed. 2714 */ 2715 int 2716 scsi_pkt_allocated_correctly(struct scsi_pkt *pkt) 2717 { 2718 struct scsi_pkt_wrapper *hba_pkt = (struct scsi_pkt_wrapper *)pkt; 2719 int magic; 2720 major_t major; 2721 #ifdef DEBUG 2722 int *pspwm, *pspcwm; 2723 2724 /* 2725 * We are getting scsi packets from two 'correct' wrapper schemes, 2726 * make sure we are looking at the same place in both to detect 2727 * proper allocation. 2728 */ 2729 pspwm = &((struct scsi_pkt_wrapper *)0)->pkt_wrapper_magic; 2730 pspcwm = &((struct scsi_pkt_cache_wrapper *)0)->pcw_magic; 2731 ASSERT(pspwm == pspcwm); 2732 #endif /* DEBUG */ 2733 2734 2735 /* 2736 * Check to see if driver is scsi_size_clean(), assume it 2737 * is using the scsi_pkt_size() interface everywhere it needs to 2738 * if the driver indicates it is scsi_size_clean(). 2739 */ 2740 major = ddi_driver_major(P_TO_TRAN(pkt)->tran_hba_dip); 2741 if (devnamesp[major].dn_flags & DN_SCSI_SIZE_CLEAN) 2742 return (1); /* ok */ 2743 2744 /* 2745 * Special case crossing a page boundary. If the scsi_pkt was not 2746 * allocated correctly, then across a page boundary we have a 2747 * fault hazard. 2748 */ 2749 if ((((uintptr_t)(&hba_pkt->scsi_pkt)) & MMU_PAGEMASK) == 2750 (((uintptr_t)(&hba_pkt->pkt_wrapper_magic)) & MMU_PAGEMASK)) { 2751 /* fastpath, no cross-page hazard */ 2752 magic = hba_pkt->pkt_wrapper_magic; 2753 } else { 2754 /* add protection for cross-page hazard */ 2755 if (ddi_peek32((dev_info_t *)NULL, 2756 &hba_pkt->pkt_wrapper_magic, &magic) == DDI_FAILURE) { 2757 return (0); /* violation */ 2758 } 2759 } 2760 2761 /* properly allocated packet always has correct magic */ 2762 return ((magic == PKT_WRAPPER_MAGIC) ? 1 : 0); 2763 } 2764 2765 /* 2766 * Private interfaces to simplify conversion of legacy drivers so they don't 2767 * depend on scsi_*(9S) size. Instead of using these private interface, HBA 2768 * drivers should use DDI sanctioned allocation methods: 2769 * 2770 * scsi_pkt Use scsi_hba_pkt_alloc(9F), or implement 2771 * tran_setup_pkt(9E). 2772 * 2773 * scsi_device You are doing something strange/special, a scsi_device 2774 * structure should only be allocated by scsi_hba.c 2775 * initchild code or scsi_vhci.c code. 2776 * 2777 * scsi_hba_tran Use scsi_hba_tran_alloc(9F). 2778 */ 2779 size_t 2780 scsi_pkt_size() 2781 { 2782 return (sizeof (struct scsi_pkt)); 2783 } 2784 2785 size_t 2786 scsi_hba_tran_size() 2787 { 2788 return (sizeof (scsi_hba_tran_t)); 2789 } 2790 2791 size_t 2792 scsi_device_size() 2793 { 2794 return (sizeof (struct scsi_device)); 2795 } 2796 2797 /* 2798 * Legacy compliance to scsi_pkt(9S) allocation rules through use of 2799 * scsi_pkt_size() is detected by the 'scsi-size-clean' driver.conf property 2800 * or an HBA driver calling to scsi_size_clean() from attach(9E). A driver 2801 * developer should only indicate that a legacy driver is clean after using 2802 * SCSI_SIZE_CLEAN_VERIFY to ensure compliance (see scsi_pkt.h). 2803 */ 2804 void 2805 scsi_size_clean(dev_info_t *self) 2806 { 2807 major_t major; 2808 struct devnames *dnp; 2809 2810 ASSERT(self); 2811 major = ddi_driver_major(self); 2812 ASSERT(major < devcnt); 2813 if (major >= devcnt) { 2814 SCSI_HBA_LOG((_LOG(WARN), self, NULL, 2815 "scsi_pkt_size: bogus major: %d", major)); 2816 return; 2817 } 2818 2819 /* Set DN_SCSI_SIZE_CLEAN flag in dn_flags. */ 2820 dnp = &devnamesp[major]; 2821 if ((dnp->dn_flags & DN_SCSI_SIZE_CLEAN) == 0) { 2822 LOCK_DEV_OPS(&dnp->dn_lock); 2823 dnp->dn_flags |= DN_SCSI_SIZE_CLEAN; 2824 UNLOCK_DEV_OPS(&dnp->dn_lock); 2825 } 2826 } 2827 2828 2829 /* 2830 * Called by an HBA to map strings to capability indices 2831 */ 2832 int 2833 scsi_hba_lookup_capstr( 2834 char *capstr) 2835 { 2836 /* 2837 * Capability strings: only add entries to mask the legacy 2838 * '_' vs. '-' misery. All new capabilities should use '-', 2839 * and be captured be added to SCSI_CAP_ASCII. 2840 */ 2841 static struct cap_strings { 2842 char *cap_string; 2843 int cap_index; 2844 } cap_strings[] = { 2845 { "dma_max", SCSI_CAP_DMA_MAX }, 2846 { "msg_out", SCSI_CAP_MSG_OUT }, 2847 { "wide_xfer", SCSI_CAP_WIDE_XFER }, 2848 { NULL, 0 } 2849 }; 2850 static char *cap_ascii[] = SCSI_CAP_ASCII; 2851 char **cap; 2852 int i; 2853 struct cap_strings *cp; 2854 2855 for (cap = cap_ascii, i = 0; *cap != NULL; cap++, i++) 2856 if (strcmp(*cap, capstr) == 0) 2857 return (i); 2858 2859 for (cp = cap_strings; cp->cap_string != NULL; cp++) 2860 if (strcmp(cp->cap_string, capstr) == 0) 2861 return (cp->cap_index); 2862 2863 return (-1); 2864 } 2865 2866 /* 2867 * Called by an HBA to determine if the system is in 'panic' state. 2868 */ 2869 int 2870 scsi_hba_in_panic() 2871 { 2872 return (panicstr != NULL); 2873 } 2874 2875 /* 2876 * If a SCSI target driver attempts to mmap memory, 2877 * the buck stops here. 2878 */ 2879 /*ARGSUSED*/ 2880 static int 2881 scsi_hba_map_fault( 2882 dev_info_t *self, 2883 dev_info_t *child, 2884 struct hat *hat, 2885 struct seg *seg, 2886 caddr_t addr, 2887 struct devpage *dp, 2888 pfn_t pfn, 2889 uint_t prot, 2890 uint_t lock) 2891 { 2892 return (DDI_FAILURE); 2893 } 2894 2895 static int 2896 scsi_hba_get_eventcookie( 2897 dev_info_t *self, 2898 dev_info_t *child, 2899 char *name, 2900 ddi_eventcookie_t *eventp) 2901 { 2902 scsi_hba_tran_t *tran; 2903 2904 tran = ddi_get_driver_private(self); 2905 if (tran->tran_get_eventcookie && 2906 ((*tran->tran_get_eventcookie)(self, 2907 child, name, eventp) == DDI_SUCCESS)) { 2908 return (DDI_SUCCESS); 2909 } 2910 2911 return (ndi_busop_get_eventcookie(self, child, name, eventp)); 2912 } 2913 2914 static int 2915 scsi_hba_add_eventcall( 2916 dev_info_t *self, 2917 dev_info_t *child, 2918 ddi_eventcookie_t event, 2919 void (*callback)( 2920 dev_info_t *self, 2921 ddi_eventcookie_t event, 2922 void *arg, 2923 void *bus_impldata), 2924 void *arg, 2925 ddi_callback_id_t *cb_id) 2926 { 2927 scsi_hba_tran_t *tran; 2928 2929 tran = ddi_get_driver_private(self); 2930 if (tran->tran_add_eventcall && 2931 ((*tran->tran_add_eventcall)(self, child, 2932 event, callback, arg, cb_id) == DDI_SUCCESS)) { 2933 return (DDI_SUCCESS); 2934 } 2935 2936 return (DDI_FAILURE); 2937 } 2938 2939 static int 2940 scsi_hba_remove_eventcall(dev_info_t *self, ddi_callback_id_t cb_id) 2941 { 2942 scsi_hba_tran_t *tran; 2943 ASSERT(cb_id); 2944 2945 tran = ddi_get_driver_private(self); 2946 if (tran->tran_remove_eventcall && 2947 ((*tran->tran_remove_eventcall)( 2948 self, cb_id) == DDI_SUCCESS)) { 2949 return (DDI_SUCCESS); 2950 } 2951 2952 return (DDI_FAILURE); 2953 } 2954 2955 static int 2956 scsi_hba_post_event( 2957 dev_info_t *self, 2958 dev_info_t *child, 2959 ddi_eventcookie_t event, 2960 void *bus_impldata) 2961 { 2962 scsi_hba_tran_t *tran; 2963 2964 tran = ddi_get_driver_private(self); 2965 if (tran->tran_post_event && 2966 ((*tran->tran_post_event)(self, 2967 child, event, bus_impldata) == DDI_SUCCESS)) { 2968 return (DDI_SUCCESS); 2969 } 2970 2971 return (DDI_FAILURE); 2972 } 2973 2974 /* 2975 * Default getinfo(9e) for scsi_hba 2976 */ 2977 /* ARGSUSED */ 2978 static int 2979 scsi_hba_info(dev_info_t *self, ddi_info_cmd_t infocmd, void *arg, 2980 void **result) 2981 { 2982 int error = DDI_SUCCESS; 2983 2984 switch (infocmd) { 2985 case DDI_INFO_DEVT2INSTANCE: 2986 *result = (void *)(intptr_t)(MINOR2INST(getminor((dev_t)arg))); 2987 break; 2988 default: 2989 error = DDI_FAILURE; 2990 } 2991 return (error); 2992 } 2993 2994 /* 2995 * Default open and close routine for scsi_hba 2996 */ 2997 /* ARGSUSED */ 2998 int 2999 scsi_hba_open(dev_t *devp, int flags, int otyp, cred_t *credp) 3000 { 3001 dev_info_t *self; 3002 scsi_hba_tran_t *tran; 3003 int rv = 0; 3004 3005 if (otyp != OTYP_CHR) 3006 return (EINVAL); 3007 3008 if ((self = e_ddi_hold_devi_by_dev(*devp, 0)) == NULL) 3009 return (ENXIO); 3010 3011 tran = ddi_get_driver_private(self); 3012 if (tran == NULL) { 3013 ddi_release_devi(self); 3014 return (ENXIO); 3015 } 3016 3017 /* 3018 * tran_open_flag bit field: 3019 * 0: closed 3020 * 1: shared open by minor at bit position 3021 * 1 at 31st bit: exclusive open 3022 */ 3023 mutex_enter(&(tran->tran_open_lock)); 3024 if (flags & FEXCL) { 3025 if (tran->tran_open_flag != 0) { 3026 rv = EBUSY; /* already open */ 3027 } else { 3028 tran->tran_open_flag = TRAN_OPEN_EXCL; 3029 } 3030 } else { 3031 if (tran->tran_open_flag == TRAN_OPEN_EXCL) { 3032 rv = EBUSY; /* already excl. open */ 3033 } else { 3034 int minor = getminor(*devp) & TRAN_MINOR_MASK; 3035 tran->tran_open_flag |= (1 << minor); 3036 /* 3037 * Ensure that the last framework reserved minor 3038 * is unused. Otherwise, the exclusive open 3039 * mechanism may break. 3040 */ 3041 ASSERT(minor != 31); 3042 } 3043 } 3044 mutex_exit(&(tran->tran_open_lock)); 3045 3046 ddi_release_devi(self); 3047 return (rv); 3048 } 3049 3050 /* ARGSUSED */ 3051 int 3052 scsi_hba_close(dev_t dev, int flag, int otyp, cred_t *credp) 3053 { 3054 dev_info_t *self; 3055 scsi_hba_tran_t *tran; 3056 3057 if (otyp != OTYP_CHR) 3058 return (EINVAL); 3059 3060 if ((self = e_ddi_hold_devi_by_dev(dev, 0)) == NULL) 3061 return (ENXIO); 3062 3063 tran = ddi_get_driver_private(self); 3064 if (tran == NULL) { 3065 ddi_release_devi(self); 3066 return (ENXIO); 3067 } 3068 3069 mutex_enter(&(tran->tran_open_lock)); 3070 if (tran->tran_open_flag == TRAN_OPEN_EXCL) { 3071 tran->tran_open_flag = 0; 3072 } else { 3073 int minor = getminor(dev) & TRAN_MINOR_MASK; 3074 tran->tran_open_flag &= ~(1 << minor); 3075 } 3076 mutex_exit(&(tran->tran_open_lock)); 3077 3078 ddi_release_devi(self); 3079 return (0); 3080 } 3081 3082 /* 3083 * standard ioctl commands for SCSI hotplugging 3084 */ 3085 /* ARGSUSED */ 3086 int 3087 scsi_hba_ioctl(dev_t dev, int cmd, intptr_t arg, int mode, cred_t *credp, 3088 int *rvalp) 3089 { 3090 dev_info_t *self; 3091 struct devctl_iocdata *dcp = NULL; 3092 dev_info_t *child = NULL; 3093 mdi_pathinfo_t *path = NULL; 3094 struct scsi_device *sd; 3095 scsi_hba_tran_t *tran; 3096 uint_t bus_state; 3097 int rv = 0; 3098 boolean_t enteredv; 3099 char *name; 3100 char *addr; 3101 3102 self = e_ddi_hold_devi_by_dev(dev, 0); 3103 if (self == NULL) { 3104 rv = ENXIO; 3105 goto out; 3106 } 3107 3108 tran = ddi_get_driver_private(self); 3109 if (tran == NULL) { 3110 rv = ENXIO; 3111 goto out; 3112 } 3113 3114 /* Ioctls for which the generic implementation suffices. */ 3115 switch (cmd) { 3116 case DEVCTL_BUS_GETSTATE: 3117 rv = ndi_devctl_ioctl(self, cmd, arg, mode, 0); 3118 goto out; 3119 } 3120 3121 /* read devctl ioctl data */ 3122 if (ndi_dc_allochdl((void *)arg, &dcp) != NDI_SUCCESS) { 3123 rv = EFAULT; 3124 goto out; 3125 } 3126 3127 /* Ioctls that require child identification */ 3128 switch (cmd) { 3129 case DEVCTL_DEVICE_GETSTATE: 3130 case DEVCTL_DEVICE_ONLINE: 3131 case DEVCTL_DEVICE_OFFLINE: 3132 case DEVCTL_DEVICE_REMOVE: 3133 case DEVCTL_DEVICE_RESET: 3134 name = ndi_dc_getname(dcp); 3135 addr = ndi_dc_getaddr(dcp); 3136 if ((name == NULL) || (addr == NULL)) { 3137 rv = EINVAL; 3138 goto out; 3139 } 3140 3141 /* 3142 * Find child with name@addr - might find a devinfo 3143 * child (child), a pathinfo child (path), or nothing. 3144 */ 3145 scsi_hba_devi_enter(self, &enteredv); 3146 3147 (void) scsi_findchild(self, name, addr, 1, &child, &path, NULL); 3148 if (path) { 3149 /* Found a pathinfo */ 3150 ASSERT(path && (child == NULL)); 3151 mdi_hold_path(path); 3152 scsi_hba_devi_exit_phci(self); 3153 sd = NULL; 3154 } else if (child) { 3155 /* Found a devinfo */ 3156 ASSERT(child && (path == NULL)); 3157 3158 /* verify scsi_device of child */ 3159 if (ndi_flavor_get(child) == SCSA_FLAVOR_SCSI_DEVICE) 3160 sd = ddi_get_driver_private(child); 3161 else 3162 sd = NULL; 3163 } else { 3164 ASSERT((path == NULL) && (child == NULL)); 3165 scsi_hba_devi_exit(self, enteredv); 3166 rv = ENXIO; /* found nothing */ 3167 goto out; 3168 } 3169 break; 3170 3171 case DEVCTL_BUS_RESETALL: /* ioctl that operate on any child */ 3172 /* 3173 * Find a child's scsi_address so we can invoke tran_reset. 3174 * 3175 * Future: If no child exists, we could fake a child. This will 3176 * be a enhancement for the future - for now, we fall back to 3177 * BUS_RESET. 3178 */ 3179 scsi_hba_devi_enter(self, &enteredv); 3180 child = ddi_get_child(self); 3181 sd = NULL; 3182 while (child) { 3183 /* verify scsi_device of child */ 3184 if (ndi_flavor_get(child) == SCSA_FLAVOR_SCSI_DEVICE) 3185 sd = ddi_get_driver_private(child); 3186 if (sd != NULL) { 3187 /* 3188 * NOTE: node has a scsi_device structure, so 3189 * it must be initialized. 3190 */ 3191 ndi_hold_devi(child); 3192 break; 3193 } 3194 child = ddi_get_next_sibling(child); 3195 } 3196 if (child == NULL) 3197 scsi_hba_devi_exit(self, enteredv); 3198 break; 3199 } 3200 3201 switch (cmd) { 3202 case DEVCTL_DEVICE_GETSTATE: 3203 if (path) { 3204 if (mdi_dc_return_dev_state(path, dcp) != MDI_SUCCESS) 3205 rv = EFAULT; 3206 } else if (child) { 3207 if (ndi_dc_return_dev_state(child, dcp) != NDI_SUCCESS) 3208 rv = EFAULT; 3209 } else { 3210 rv = ENXIO; 3211 } 3212 break; 3213 3214 case DEVCTL_DEVICE_RESET: 3215 if (sd == NULL) { 3216 rv = ENOTTY; 3217 break; 3218 } 3219 if (tran->tran_reset == NULL) { 3220 rv = ENOTSUP; 3221 break; 3222 } 3223 3224 /* Start with the small stick */ 3225 if (scsi_reset(&sd->sd_address, RESET_LUN) == 1) 3226 break; /* LUN reset worked */ 3227 if (scsi_reset(&sd->sd_address, RESET_TARGET) != 1) 3228 rv = EIO; /* Target reset failed */ 3229 break; 3230 3231 case DEVCTL_BUS_QUIESCE: 3232 if ((ndi_get_bus_state(self, &bus_state) == NDI_SUCCESS) && 3233 (bus_state == BUS_QUIESCED)) 3234 rv = EALREADY; 3235 else if (tran->tran_quiesce == NULL) 3236 rv = ENOTSUP; /* man ioctl(2) says ENOTTY */ 3237 else if (tran->tran_quiesce(self) != 0) 3238 rv = EIO; 3239 else if (ndi_set_bus_state(self, BUS_QUIESCED) != NDI_SUCCESS) 3240 rv = EIO; 3241 break; 3242 3243 case DEVCTL_BUS_UNQUIESCE: 3244 if ((ndi_get_bus_state(self, &bus_state) == NDI_SUCCESS) && 3245 (bus_state == BUS_ACTIVE)) 3246 rv = EALREADY; 3247 else if (tran->tran_unquiesce == NULL) 3248 rv = ENOTSUP; /* man ioctl(2) says ENOTTY */ 3249 else if (tran->tran_unquiesce(self) != 0) 3250 rv = EIO; 3251 else if (ndi_set_bus_state(self, BUS_ACTIVE) != NDI_SUCCESS) 3252 rv = EIO; 3253 break; 3254 3255 case DEVCTL_BUS_RESET: 3256 if (tran->tran_bus_reset == NULL) 3257 rv = ENOTSUP; /* man ioctl(2) says ENOTTY */ 3258 else if (tran->tran_bus_reset(self, RESET_BUS) != 1) 3259 rv = EIO; 3260 break; 3261 3262 case DEVCTL_BUS_RESETALL: 3263 if ((sd != NULL) && 3264 (scsi_reset(&sd->sd_address, RESET_ALL) == 1)) { 3265 break; /* reset all worked */ 3266 } 3267 if (tran->tran_bus_reset == NULL) { 3268 rv = ENOTSUP; /* man ioctl(2) says ENOTTY */ 3269 break; 3270 } 3271 if (tran->tran_bus_reset(self, RESET_BUS) != 1) 3272 rv = EIO; /* bus reset failed */ 3273 break; 3274 3275 case DEVCTL_BUS_CONFIGURE: 3276 if (ndi_devi_config(self, NDI_DEVFS_CLEAN | NDI_DEVI_PERSIST | 3277 NDI_CONFIG_REPROBE) != NDI_SUCCESS) { 3278 rv = EIO; 3279 } 3280 break; 3281 3282 case DEVCTL_BUS_UNCONFIGURE: 3283 if (ndi_devi_unconfig(self, 3284 NDI_DEVFS_CLEAN | NDI_DEVI_REMOVE) != NDI_SUCCESS) { 3285 rv = EBUSY; 3286 } 3287 break; 3288 3289 case DEVCTL_DEVICE_ONLINE: 3290 ASSERT(child || path); 3291 if (path) { 3292 if (mdi_pi_online(path, NDI_USER_REQ) != MDI_SUCCESS) 3293 rv = EIO; 3294 } else { 3295 if (ndi_devi_online(child, 0) != NDI_SUCCESS) 3296 rv = EIO; 3297 } 3298 break; 3299 3300 case DEVCTL_DEVICE_OFFLINE: 3301 ASSERT(child || path); 3302 if (sd != NULL) 3303 (void) scsi_clear_task_set(&sd->sd_address); 3304 if (path) { 3305 if (mdi_pi_offline(path, NDI_USER_REQ) != MDI_SUCCESS) 3306 rv = EIO; 3307 } else { 3308 if (ndi_devi_offline(child, 3309 NDI_DEVFS_CLEAN) != NDI_SUCCESS) 3310 rv = EIO; 3311 } 3312 break; 3313 3314 case DEVCTL_DEVICE_REMOVE: 3315 ASSERT(child || path); 3316 if (sd != NULL) 3317 (void) scsi_clear_task_set(&sd->sd_address); 3318 if (path) { 3319 /* NOTE: don't pass NDI_DEVI_REMOVE to mdi_pi_offline */ 3320 if (mdi_pi_offline(path, NDI_USER_REQ) == MDI_SUCCESS) { 3321 scsi_hba_devi_enter_phci(self); 3322 mdi_rele_path(path); 3323 3324 /* ... here is the DEVICE_REMOVE part. */ 3325 (void) mdi_pi_free(path, 0); 3326 path = NULL; 3327 } else { 3328 rv = EIO; 3329 } 3330 } else { 3331 if (ndi_devi_offline(child, 3332 NDI_DEVFS_CLEAN | NDI_DEVI_REMOVE) != NDI_SUCCESS) 3333 rv = EIO; 3334 } 3335 break; 3336 3337 default: 3338 ASSERT(dcp != NULL); 3339 rv = ENOTTY; 3340 break; 3341 } 3342 3343 /* all done -- clean up and return */ 3344 out: 3345 /* release hold on what we found */ 3346 if (path) { 3347 scsi_hba_devi_enter_phci(self); 3348 mdi_rele_path(path); 3349 } 3350 if (path || child) 3351 scsi_hba_devi_exit(self, enteredv); 3352 3353 if (dcp) 3354 ndi_dc_freehdl(dcp); 3355 3356 if (self) 3357 ddi_release_devi(self); 3358 3359 *rvalp = rv; 3360 3361 return (rv); 3362 } 3363 3364 /*ARGSUSED*/ 3365 static int 3366 scsi_hba_fm_init_child(dev_info_t *self, dev_info_t *child, int cap, 3367 ddi_iblock_cookie_t *ibc) 3368 { 3369 scsi_hba_tran_t *tran = ddi_get_driver_private(self); 3370 3371 return (tran ? tran->tran_fm_capable : scsi_fm_capable); 3372 } 3373 3374 static int 3375 scsi_hba_bus_power(dev_info_t *self, void *impl_arg, pm_bus_power_op_t op, 3376 void *arg, void *result) 3377 { 3378 scsi_hba_tran_t *tran; 3379 3380 tran = ddi_get_driver_private(self); 3381 if (tran && tran->tran_bus_power) { 3382 return (tran->tran_bus_power(self, impl_arg, 3383 op, arg, result)); 3384 } 3385 3386 return (pm_busop_bus_power(self, impl_arg, op, arg, result)); 3387 } 3388 3389 /* 3390 * Return the lun64 value from a address string: "addr,lun[,sfunc]". Either 3391 * the lun is after the first ',' or the entire address string is the lun. 3392 * Return SCSI_LUN64_ILLEGAL if the format is incorrect. A lun64 is at most 3393 * 16 hex digits long. 3394 * 3395 * If the address string specified has incorrect syntax (busconfig one of 3396 * bogus /devices path) then scsi_addr_to_lun64 can return SCSI_LUN64_ILLEGAL. 3397 */ 3398 static scsi_lun64_t 3399 scsi_addr_to_lun64(char *addr) 3400 { 3401 scsi_lun64_t lun64; 3402 char *s; 3403 int i; 3404 3405 if (addr) { 3406 s = strchr(addr, ','); /* "addr,lun" */ 3407 if (s) 3408 s++; /* skip ',', at lun */ 3409 else 3410 s = addr; /* "lun" */ 3411 3412 for (lun64 = 0, i = 0; *s && (i < 16); s++, i++) { 3413 if (*s >= '0' && *s <= '9') 3414 lun64 = (lun64 << 4) + (*s - '0'); 3415 else if (*s >= 'A' && *s <= 'F') 3416 lun64 = (lun64 << 4) + 10 + (*s - 'A'); 3417 else if (*s >= 'a' && *s <= 'f') 3418 lun64 = (lun64 << 4) + 10 + (*s - 'a'); 3419 else 3420 break; 3421 } 3422 if (*s && (*s != ',')) /* [,sfunc] is OK */ 3423 lun64 = SCSI_LUN64_ILLEGAL; 3424 } else 3425 lun64 = SCSI_LUN64_ILLEGAL; 3426 3427 if (lun64 == SCSI_LUN64_ILLEGAL) 3428 SCSI_HBA_LOG((_LOG(2), NULL, NULL, 3429 "addr_to_lun64 %s lun %" PRIlun64, 3430 addr ? addr : "NULL", lun64)); 3431 return (lun64); 3432 } 3433 3434 /* 3435 * Return the sfunc value from a address string: "addr,lun[,sfunc]". Either the 3436 * sfunc is after the second ',' or the entire address string is the sfunc. 3437 * Return -1 if there is only one ',' in the address string or the string is 3438 * invalid. An sfunc is at most two hex digits long. 3439 */ 3440 static int 3441 scsi_addr_to_sfunc(char *addr) 3442 { 3443 int sfunc; 3444 char *s; 3445 int i; 3446 3447 if (addr) { 3448 s = strchr(addr, ','); /* "addr,lun" */ 3449 if (s) { 3450 s++; /* skip ',', at lun */ 3451 s = strchr(s, ','); /* "lun,sfunc" */ 3452 if (s == NULL) 3453 return (-1); /* no ",sfunc" */ 3454 s++; /* skip ',', at sfunc */ 3455 } else 3456 s = addr; /* "sfunc" */ 3457 3458 for (sfunc = 0, i = 0; *s && (i < 2); s++, i++) { 3459 if (*s >= '0' && *s <= '9') 3460 sfunc = (sfunc << 4) + (*s - '0'); 3461 else if (*s >= 'A' && *s <= 'F') 3462 sfunc = (sfunc << 4) + 10 + (*s - 'A'); 3463 else if (*s >= 'a' && *s <= 'f') 3464 sfunc = (sfunc << 4) + 10 + (*s - 'a'); 3465 else 3466 break; 3467 } 3468 if (*s) 3469 sfunc = -1; /* illegal */ 3470 } else 3471 sfunc = -1; 3472 return (sfunc); 3473 } 3474 3475 /* 3476 * Convert scsi ascii string data to NULL terminated (semi) legal IEEE 1275 3477 * "compatible" (name) property form. 3478 * 3479 * For ASCII INQUIRY data, a one-way conversion algorithm is needed to take 3480 * SCSI_ASCII (20h - 7Eh) to a 1275-like compatible form. The 1275 spec allows 3481 * letters, digits, one ",", and ". _ + -", all limited by a maximum 31 3482 * character length. Since ", ." are used as separators in the compatible 3483 * string itself, they are converted to "_". All SCSI_ASCII characters that 3484 * are illegal in 1275, as well as any illegal SCSI_ASCII characters 3485 * encountered, are converted to "_". To reduce length, trailing blanks are 3486 * trimmed from SCSI_ASCII fields prior to conversion. 3487 * 3488 * Example: SCSI_ASCII "ST32550W SUN2.1G" -> "ST32550W_SUN2_1G" 3489 * 3490 * NOTE: the 1275 string form is always less than or equal to the scsi form. 3491 */ 3492 static char * 3493 string_scsi_to_1275(char *s_1275, char *s_scsi, int len) 3494 { 3495 (void) strncpy(s_1275, s_scsi, len); 3496 s_1275[len--] = '\0'; 3497 3498 while (len >= 0) { 3499 if (s_1275[len] == ' ') 3500 s_1275[len--] = '\0'; /* trim trailing " " */ 3501 else 3502 break; 3503 } 3504 3505 while (len >= 0) { 3506 if (((s_1275[len] >= 'a') && (s_1275[len] <= 'z')) || 3507 ((s_1275[len] >= 'A') && (s_1275[len] <= 'Z')) || 3508 ((s_1275[len] >= '0') && (s_1275[len] <= '9')) || 3509 (s_1275[len] == '_') || 3510 (s_1275[len] == '+') || 3511 (s_1275[len] == '-')) 3512 len--; /* legal 1275 */ 3513 else 3514 s_1275[len--] = '_'; /* illegal SCSI_ASCII | 1275 */ 3515 } 3516 3517 return (s_1275); 3518 } 3519 3520 /* 3521 * Given the inquiry data, binding_set, and dtype_node for a scsi device, 3522 * return the nodename and compatible property for the device. The "compatible" 3523 * concept comes from IEEE-1275. The compatible information is returned is in 3524 * the correct form for direct use defining the "compatible" string array 3525 * property. Internally, "compatible" is also used to determine the nodename 3526 * to return. 3527 * 3528 * This function is provided as a separate entry point for use by drivers that 3529 * currently issue their own non-SCSA inquiry command and perform their own 3530 * node creation based their own private compiled in tables. Converting these 3531 * drivers to use this interface provides a quick easy way of obtaining 3532 * consistency as well as the flexibility associated with the 1275 techniques. 3533 * 3534 * The dtype_node is passed as a separate argument (instead of having the 3535 * implementation use inq_dtype). It indicates that information about 3536 * a secondary function embedded service should be produced. 3537 * 3538 * Callers must always use scsi_hba_nodename_compatible_free, even if 3539 * *nodenamep is null, to free the nodename and compatible information 3540 * when done. 3541 * 3542 * If a nodename can't be determined then **compatiblep will point to a 3543 * diagnostic string containing all the compatible forms. 3544 * 3545 * NOTE: some compatible strings may violate the 31 character restriction 3546 * imposed by IEEE-1275. This is not a problem because Solaris does not care 3547 * about this 31 character limit. 3548 * 3549 * Each compatible form belongs to a form-group. The form-groups currently 3550 * defined are generic ("scsiclass"), binding-set ("scsa.b"), and failover 3551 * ("scsa.f"). 3552 * 3553 * The following compatible forms, in high to low precedence 3554 * order, are defined for SCSI target device nodes. 3555 * 3556 * scsiclass,DDEEFFF.vVVVVVVVV.pPPPPPPPPPPPPPPPP.rRRRR (1 *1&2) 3557 * scsiclass,DDEE.vVVVVVVVV.pPPPPPPPPPPPPPPPP.rRRRR (2 *1) 3558 * scsiclass,DDFFF.vVVVVVVVV.pPPPPPPPPPPPPPPPP.rRRRR (3 *2) 3559 * scsiclass,DD.vVVVVVVVV.pPPPPPPPPPPPPPPPP.rRRRR (4) 3560 * scsiclass,DDEEFFF.vVVVVVVVV.pPPPPPPPPPPPPPPPP (5 *1&2) 3561 * scsiclass,DDEE.vVVVVVVVV.pPPPPPPPPPPPPPPPP (6 *1) 3562 * scsiclass,DDFFF.vVVVVVVVV.pPPPPPPPPPPPPPPPP (7 *2) 3563 * scsiclass,DD.vVVVVVVVV.pPPPPPPPPPPPPPPPP (8) 3564 * scsa,DD.bBBBBBBBB (8.5 *3) 3565 * scsiclass,DDEEFFF (9 *1&2) 3566 * scsiclass,DDEE (10 *1) 3567 * scsiclass,DDFFF (11 *2) 3568 * scsiclass,DD (12) 3569 * scsa.fFFF (12.5 *4) 3570 * scsiclass (13) 3571 * 3572 * *1 only produced on a secondary function node 3573 * *2 only produced when generic form-group flags exist. 3574 * *3 only produced when binding-set form-group legacy support is needed 3575 * *4 only produced when failover form-group flags exist. 3576 * 3577 * where: 3578 * 3579 * v is the letter 'v'. Denotest the 3580 * beginning of VVVVVVVV. 3581 * 3582 * VVVVVVVV Translated scsi_vendor. 3583 * 3584 * p is the letter 'p'. Denotes the 3585 * beginning of PPPPPPPPPPPPPPPP. 3586 * 3587 * PPPPPPPPPPPPPPPP Translated scsi_product. 3588 * 3589 * r is the letter 'r'. Denotes the 3590 * beginning of RRRR. 3591 * 3592 * RRRR Translated scsi_revision. 3593 * 3594 * DD is a two digit ASCII hexadecimal 3595 * number. The value of the two digits is 3596 * based one the SCSI "Peripheral device 3597 * type" command set associated with the 3598 * node. On a primary node this is the 3599 * scsi_dtype of the primary command set, 3600 * on a secondary node this is the 3601 * scsi_dtype associated with the secondary 3602 * function embedded command set. 3603 * 3604 * EE Same encoding used for DD. This form is 3605 * only generated on secondary function 3606 * nodes. The DD secondary function is embedded 3607 * in an EE device. 3608 * 3609 * FFF Concatenation, in alphabetical order, 3610 * of the flag characters within a form-group. 3611 * For a given form-group, the following 3612 * flags are defined. 3613 * 3614 * scsiclass: (generic form-group): 3615 * R Removable_Media: Used when 3616 * inq_rmb is set. 3617 * S SAF-TE device: Used when 3618 * inquiry information indicates 3619 * SAF-TE devices. 3620 * 3621 * scsa.f: (failover form-group): 3622 * E Explicit Target_Port_Group: Used 3623 * when inq_tpgse is set and 'G' is 3624 * alse present. 3625 * G GUID: Used when a GUID can be 3626 * generated for the device. 3627 * I Implicit Target_Port_Group: Used 3628 * when inq_tpgs is set and 'G' is 3629 * also present. 3630 * 3631 * Forms using FFF are only be generated 3632 * if there are applicable flag 3633 * characters. 3634 * 3635 * b is the letter 'b'. Denotes the 3636 * beginning of BBBBBBBB. 3637 * 3638 * BBBBBBBB Binding-set. Operating System Specific: 3639 * scsi-binding-set property of HBA. 3640 */ 3641 #define NCOMPAT (1 + (13 + 2) + 1) 3642 #define COMPAT_LONGEST (strlen( \ 3643 "scsiclass,DDEEFFF.vVVVVVVVV.pPPPPPPPPPPPPPPPP.rRRRR" + 1)) 3644 3645 /* 3646 * Private version with extra device 'identity' arguments to allow code 3647 * to determine GUID FFF support. 3648 */ 3649 static void 3650 scsi_hba_ident_nodename_compatible_get(struct scsi_inquiry *inq, 3651 uchar_t *inq80, size_t inq80len, uchar_t *inq83, size_t inq83len, 3652 char *binding_set, int dtype_node, char *compat0, 3653 char **nodenamep, char **drivernamep, 3654 char ***compatiblep, int *ncompatiblep) 3655 { 3656 char vid[sizeof (inq->inq_vid) + 1 ]; 3657 char pid[sizeof (inq->inq_pid) + 1]; 3658 char rev[sizeof (inq->inq_revision) + 1]; 3659 char gf[sizeof ("RS\0")]; 3660 char ff[sizeof ("EGI\0")]; 3661 int dtype_device; 3662 int ncompat; /* number of compatible */ 3663 char **compatp; /* compatible ptrs */ 3664 int i; 3665 char *nname; /* nodename */ 3666 char *dname; /* driver name */ 3667 char **csp; 3668 char *p; 3669 int tlen; 3670 int len; 3671 major_t major; 3672 ddi_devid_t devid; 3673 char *guid; 3674 uchar_t *iqd = (uchar_t *)inq; 3675 3676 /* 3677 * Nodename_aliases: This table was originally designed to be 3678 * implemented via a new nodename_aliases file - a peer to the 3679 * driver_aliases that selects a nodename based on compatible 3680 * forms in much the same say driver_aliases is used to select 3681 * driver bindings from compatible forms. Each compatible form 3682 * is an 'alias'. Until a more general need for a 3683 * nodename_aliases file exists, which may never occur, the 3684 * scsi mappings are described here via a compiled in table. 3685 * 3686 * This table contains nodename mappings for self-identifying 3687 * scsi devices enumerated by the Solaris kernel. For a given 3688 * device, the highest precedence "compatible" form with a 3689 * mapping is used to select the nodename for the device. This 3690 * will typically be a generic nodename, however in some legacy 3691 * compatibility cases a driver nodename mapping may be selected. 3692 * 3693 * Because of possible breakage associated with switching SCSI 3694 * target devices from driver nodenames to generic nodenames, 3695 * we are currently unable to support generic nodenames for all 3696 * SCSI devices (binding-sets). Although /devices paths are 3697 * defined as unstable, avoiding possible breakage is 3698 * important. Some of the newer SCSI transports (USB) already 3699 * use generic nodenames. All new SCSI transports and target 3700 * devices should use generic nodenames. At times this decision 3701 * may be architecture dependent (sparc .vs. intel) based on when 3702 * a transport was supported on a particular architecture. 3703 * 3704 * We provide a base set of generic nodename mappings based on 3705 * scsiclass dtype and higher-precedence driver nodename 3706 * mappings based on scsa "binding-set" to cover legacy 3707 * issues. The binding-set is typically associated with 3708 * "scsi-binding-set" property value of the HBA. The legacy 3709 * mappings are provided independent of whether the driver they 3710 * refer to is installed. This allows a correctly named node 3711 * be created at discovery time, and binding to occur when/if 3712 * an add_drv of the legacy driver occurs. 3713 * 3714 * We also have mappings for legacy SUN hardware that 3715 * misidentifies itself (enclosure services which identify 3716 * themselves as processors). All future hardware should use 3717 * the correct dtype. 3718 * 3719 * As SCSI HBAs are modified to use the SCSA interfaces for 3720 * self-identifying SCSI target devices (PSARC/2004/116) the 3721 * nodename_aliases table (PSARC/2004/420) should be augmented 3722 * with legacy mappings in order to maintain compatibility with 3723 * existing /devices paths, especially for devices that house 3724 * an OS. Failure to do this may cause upgrade problems. 3725 * Additions for new target devices or transports should not 3726 * add scsa binding-set compatible mappings. 3727 */ 3728 static struct nodename_aliases { 3729 char *na_nodename; /* nodename */ 3730 char *na_alias; /* compatible form match */ 3731 } na[] = { 3732 /* # mapping to generic nodenames based on scsi dtype */ 3733 {"disk", "scsiclass,00"}, 3734 {"tape", "scsiclass,01"}, 3735 {"printer", "scsiclass,02"}, 3736 {"processor", "scsiclass,03"}, 3737 {"worm", "scsiclass,04"}, 3738 {"cdrom", "scsiclass,05"}, 3739 {"scanner", "scsiclass,06"}, 3740 {"optical-disk", "scsiclass,07"}, 3741 {"medium-changer", "scsiclass,08"}, 3742 {"obsolete", "scsiclass,09"}, 3743 {"prepress-a", "scsiclass,0a"}, 3744 {"prepress-b", "scsiclass,0b"}, 3745 {"array-controller", "scsiclass,0c"}, 3746 {"enclosure", "scsiclass,0d"}, 3747 {"disk", "scsiclass,0e"}, 3748 {"card-reader", "scsiclass,0f"}, 3749 {"bridge", "scsiclass,10"}, 3750 {"object-store", "scsiclass,11"}, 3751 {"reserved", "scsiclass,12"}, 3752 {"reserved", "scsiclass,13"}, 3753 {"reserved", "scsiclass,14"}, 3754 {"reserved", "scsiclass,15"}, 3755 {"reserved", "scsiclass,16"}, 3756 {"reserved", "scsiclass,17"}, 3757 {"reserved", "scsiclass,18"}, 3758 {"reserved", "scsiclass,19"}, 3759 {"reserved", "scsiclass,1a"}, 3760 {"reserved", "scsiclass,1b"}, 3761 {"reserved", "scsiclass,1c"}, 3762 {"reserved", "scsiclass,1d"}, 3763 {"well-known-lun", "scsiclass,1e"}, 3764 {"unknown", "scsiclass,1f"}, 3765 3766 #ifdef sparc 3767 /* # legacy mapping to driver nodenames for fcp binding-set */ 3768 {"ssd", "scsa,00.bfcp"}, 3769 {"st", "scsa,01.bfcp"}, 3770 {"sgen", "scsa,08.bfcp"}, 3771 {"ses", "scsa,0d.bfcp"}, 3772 3773 /* # legacy mapping to driver nodenames for vhci binding-set */ 3774 {"ssd", "scsa,00.bvhci"}, 3775 {"st", "scsa,01.bvhci"}, 3776 {"sgen", "scsa,08.bvhci"}, 3777 {"ses", "scsa,0d.bvhci"}, 3778 #else /* sparc */ 3779 /* # for x86 fcp and vhci use generic nodenames */ 3780 #endif /* sparc */ 3781 3782 /* # legacy mapping to driver nodenames for spi binding-set */ 3783 {"sd", "scsa,00.bspi"}, 3784 {"sd", "scsa,05.bspi"}, 3785 {"sd", "scsa,07.bspi"}, 3786 {"st", "scsa,01.bspi"}, 3787 {"ses", "scsa,0d.bspi"}, 3788 3789 /* # SUN misidentified spi hardware */ 3790 {"ses", "scsiclass,03.vSUN.pD2"}, 3791 {"ses", "scsiclass,03.vSYMBIOS.pD1000"}, 3792 3793 /* # legacy mapping to driver nodenames for atapi binding-set */ 3794 {"sd", "scsa,00.batapi"}, 3795 {"sd", "scsa,05.batapi"}, 3796 {"sd", "scsa,07.batapi"}, 3797 {"st", "scsa,01.batapi"}, 3798 {"unknown", "scsa,0d.batapi"}, 3799 3800 /* # legacy mapping to generic nodenames for usb binding-set */ 3801 {"disk", "scsa,05.busb"}, 3802 {"disk", "scsa,07.busb"}, 3803 {"changer", "scsa,08.busb"}, 3804 {"comm", "scsa,09.busb"}, 3805 {"array_ctlr", "scsa,0c.busb"}, 3806 {"esi", "scsa,0d.busb"}, 3807 3808 /* 3809 * mapping nodenames for mpt based on scsi dtype 3810 * for being compatible with the original node names 3811 * under mpt controller 3812 */ 3813 {"sd", "scsa,00.bmpt"}, 3814 {"sd", "scsa,05.bmpt"}, 3815 {"sd", "scsa,07.bmpt"}, 3816 {"st", "scsa,01.bmpt"}, 3817 {"ses", "scsa,0d.bmpt"}, 3818 {"sgen", "scsa,08.bmpt"}, 3819 {NULL, NULL} 3820 }; 3821 struct nodename_aliases *nap; 3822 3823 /* NOTE: drivernamep can be NULL */ 3824 ASSERT(nodenamep && compatiblep && ncompatiblep && 3825 (binding_set == NULL || (strlen(binding_set) <= 8))); 3826 if ((nodenamep == NULL) || (compatiblep == NULL) || 3827 (ncompatiblep == NULL)) 3828 return; 3829 3830 /* 3831 * In order to reduce runtime we allocate one block of memory that 3832 * contains both the NULL terminated array of pointers to compatible 3833 * forms and the individual compatible strings. This block is 3834 * somewhat larger than needed, but is short lived - it only exists 3835 * until the caller can transfer the information into the "compatible" 3836 * string array property and call scsi_hba_nodename_compatible_free. 3837 */ 3838 tlen = NCOMPAT * COMPAT_LONGEST; 3839 compatp = kmem_alloc((NCOMPAT * sizeof (char *)) + tlen, KM_SLEEP); 3840 3841 /* convert inquiry data from SCSI ASCII to 1275 string */ 3842 (void) string_scsi_to_1275(vid, inq->inq_vid, 3843 sizeof (inq->inq_vid)); 3844 (void) string_scsi_to_1275(pid, inq->inq_pid, 3845 sizeof (inq->inq_pid)); 3846 (void) string_scsi_to_1275(rev, inq->inq_revision, 3847 sizeof (inq->inq_revision)); 3848 ASSERT((strlen(vid) <= sizeof (inq->inq_vid)) && 3849 (strlen(pid) <= sizeof (inq->inq_pid)) && 3850 (strlen(rev) <= sizeof (inq->inq_revision))); 3851 3852 /* 3853 * Form flags in ***ALPHABETICAL*** order within form-group: 3854 * 3855 * NOTE: When adding a new flag to an existing form-group, careful 3856 * consideration must be given to not breaking existing bindings 3857 * based on that form-group. 3858 */ 3859 3860 /* 3861 * generic form-group flags 3862 * R removable: 3863 * Set when inq_rmb is set and for well known scsi dtypes. For a 3864 * bus where the entire device is removable (like USB), we expect 3865 * the HBA to intercept the inquiry data and set inq_rmb. 3866 * Since OBP does not distinguish removable media in its generic 3867 * name selection we avoid setting the 'R' flag if the root is not 3868 * yet mounted. 3869 * S SAF-TE device 3870 * Set when the device type is SAT-TE. 3871 */ 3872 i = 0; 3873 dtype_device = inq->inq_dtype & DTYPE_MASK; 3874 if (modrootloaded && (inq->inq_rmb || 3875 (dtype_device == DTYPE_WORM) || 3876 (dtype_device == DTYPE_RODIRECT) || 3877 (dtype_device == DTYPE_OPTICAL))) 3878 gf[i++] = 'R'; /* removable */ 3879 gf[i] = '\0'; 3880 3881 if (modrootloaded && 3882 (dtype_device == DTYPE_PROCESSOR) && 3883 (strncmp((char *)&iqd[44], "SAF-TE", 4) == 0)) 3884 gf[i++] = 'S'; 3885 gf[i] = '\0'; 3886 3887 /* 3888 * failover form-group flags 3889 * E Explicit Target_Port_Group_Supported: 3890 * Set for a device that has a GUID if inq_tpgse also set. 3891 * G GUID: 3892 * Set when we have identity information, can determine a devid 3893 * from the identity information, and can generate a guid from 3894 * that devid. 3895 * I Implicit Target_Port_Group_Supported: 3896 * Set for a device that has a GUID if inq_tpgs also set. 3897 */ 3898 i = 0; 3899 if ((inq80 || inq83) && 3900 (ddi_devid_scsi_encode(DEVID_SCSI_ENCODE_VERSION_LATEST, NULL, 3901 (uchar_t *)inq, sizeof (*inq), inq80, inq80len, inq83, inq83len, 3902 &devid) == DDI_SUCCESS)) { 3903 guid = ddi_devid_to_guid(devid); 3904 ddi_devid_free(devid); 3905 } else 3906 guid = NULL; 3907 if (guid && (inq->inq_tpgs & TPGS_FAILOVER_EXPLICIT)) 3908 ff[i++] = 'E'; /* EXPLICIT TPGS */ 3909 if (guid) 3910 ff[i++] = 'G'; /* GUID */ 3911 if (guid && (inq->inq_tpgs & TPGS_FAILOVER_IMPLICIT)) 3912 ff[i++] = 'I'; /* IMPLICIT TPGS */ 3913 ff[i] = '\0'; 3914 if (guid) 3915 ddi_devid_free_guid(guid); 3916 3917 /* 3918 * Construct all applicable compatible forms. See comment at the 3919 * head of the function for a description of the compatible forms. 3920 */ 3921 csp = compatp; 3922 p = (char *)(compatp + NCOMPAT); 3923 3924 /* ( 0) driver (optional, not documented in scsi(5)) */ 3925 if (compat0) { 3926 *csp++ = p; 3927 (void) snprintf(p, tlen, "%s", compat0); 3928 len = strlen(p) + 1; 3929 p += len; 3930 tlen -= len; 3931 } 3932 3933 /* ( 1) scsiclass,DDEEFFF.vV.pP.rR */ 3934 if ((dtype_device != dtype_node) && *gf && *vid && *pid && *rev) { 3935 *csp++ = p; 3936 (void) snprintf(p, tlen, "scsiclass,%02x%02x%s.v%s.p%s.r%s", 3937 dtype_node, dtype_device, gf, vid, pid, rev); 3938 len = strlen(p) + 1; 3939 p += len; 3940 tlen -= len; 3941 } 3942 3943 /* ( 2) scsiclass,DDEE.vV.pP.rR */ 3944 if ((dtype_device != dtype_node) && *vid && *pid && *rev) { 3945 *csp++ = p; 3946 (void) snprintf(p, tlen, "scsiclass,%02x%02x.v%s.p%s.r%s", 3947 dtype_node, dtype_device, vid, pid, rev); 3948 len = strlen(p) + 1; 3949 p += len; 3950 tlen -= len; 3951 } 3952 3953 /* ( 3) scsiclass,DDFFF.vV.pP.rR */ 3954 if (*gf && *vid && *pid && *rev) { 3955 *csp++ = p; 3956 (void) snprintf(p, tlen, "scsiclass,%02x%s.v%s.p%s.r%s", 3957 dtype_node, gf, vid, pid, rev); 3958 len = strlen(p) + 1; 3959 p += len; 3960 tlen -= len; 3961 } 3962 3963 /* ( 4) scsiclass,DD.vV.pP.rR */ 3964 if (*vid && *pid && *rev) { 3965 *csp++ = p; 3966 (void) snprintf(p, tlen, "scsiclass,%02x.v%s.p%s.r%s", 3967 dtype_node, vid, pid, rev); 3968 len = strlen(p) + 1; 3969 p += len; 3970 tlen -= len; 3971 } 3972 3973 /* ( 5) scsiclass,DDEEFFF.vV.pP */ 3974 if ((dtype_device != dtype_node) && *gf && *vid && *pid) { 3975 *csp++ = p; 3976 (void) snprintf(p, tlen, "scsiclass,%02x%02x%s.v%s.p%s", 3977 dtype_node, dtype_device, gf, vid, pid); 3978 len = strlen(p) + 1; 3979 p += len; 3980 tlen -= len; 3981 } 3982 3983 /* ( 6) scsiclass,DDEE.vV.pP */ 3984 if ((dtype_device != dtype_node) && *vid && *pid) { 3985 *csp++ = p; 3986 (void) snprintf(p, tlen, "scsiclass,%02x%02x.v%s.p%s", 3987 dtype_node, dtype_device, vid, pid); 3988 len = strlen(p) + 1; 3989 p += len; 3990 tlen -= len; 3991 } 3992 3993 /* ( 7) scsiclass,DDFFF.vV.pP */ 3994 if (*gf && *vid && *pid) { 3995 *csp++ = p; 3996 (void) snprintf(p, tlen, "scsiclass,%02x%s.v%s.p%s", 3997 dtype_node, gf, vid, pid); 3998 len = strlen(p) + 1; 3999 p += len; 4000 tlen -= len; 4001 } 4002 4003 /* ( 8) scsiclass,DD.vV.pP */ 4004 if (*vid && *pid) { 4005 *csp++ = p; 4006 (void) snprintf(p, tlen, "scsiclass,%02x.v%s.p%s", 4007 dtype_node, vid, pid); 4008 len = strlen(p) + 1; 4009 p += len; 4010 tlen -= len; 4011 } 4012 4013 /* (8.5) scsa,DD.bB (not documented in scsi(5)) */ 4014 if (binding_set) { 4015 *csp++ = p; 4016 (void) snprintf(p, tlen, "scsa,%02x.b%s", 4017 dtype_node, binding_set); 4018 len = strlen(p) + 1; 4019 p += len; 4020 tlen -= len; 4021 } 4022 4023 /* ( 9) scsiclass,DDEEFFF */ 4024 if ((dtype_device != dtype_node) && *gf) { 4025 *csp++ = p; 4026 (void) snprintf(p, tlen, "scsiclass,%02x%02x%s", 4027 dtype_node, dtype_device, gf); 4028 len = strlen(p) + 1; 4029 p += len; 4030 tlen -= len; 4031 } 4032 4033 /* (10) scsiclass,DDEE */ 4034 if (dtype_device != dtype_node) { 4035 *csp++ = p; 4036 (void) snprintf(p, tlen, "scsiclass,%02x%02x", 4037 dtype_node, dtype_device); 4038 len = strlen(p) + 1; 4039 p += len; 4040 tlen -= len; 4041 } 4042 4043 /* (11) scsiclass,DDFFF */ 4044 if (*gf) { 4045 *csp++ = p; 4046 (void) snprintf(p, tlen, "scsiclass,%02x%s", 4047 dtype_node, gf); 4048 len = strlen(p) + 1; 4049 p += len; 4050 tlen -= len; 4051 } 4052 4053 /* (12) scsiclass,DD */ 4054 *csp++ = p; 4055 (void) snprintf(p, tlen, "scsiclass,%02x", dtype_node); 4056 len = strlen(p) + 1; 4057 p += len; 4058 tlen -= len; 4059 4060 /* (12.5) scsa.fFFF */ 4061 if (*ff) { 4062 *csp++ = p; 4063 (void) snprintf(p, tlen, "scsa.f%s", ff); 4064 len = strlen(p) + 1; 4065 p += len; 4066 tlen -= len; 4067 } 4068 4069 /* (13) scsiclass */ 4070 *csp++ = p; 4071 (void) snprintf(p, tlen, "scsiclass"); 4072 len = strlen(p) + 1; 4073 p += len; 4074 tlen -= len; 4075 ASSERT(tlen >= 0); 4076 4077 *csp = NULL; /* NULL terminate array of pointers */ 4078 ncompat = csp - compatp; 4079 4080 /* 4081 * When determining a nodename, a nodename_aliases specified 4082 * mapping has precedence over using a driver_aliases specified 4083 * driver binding as a nodename. 4084 * 4085 * See if any of the compatible forms have a nodename_aliases 4086 * specified nodename. These mappings are described by 4087 * nodename_aliases entries like: 4088 * 4089 * disk "scsiclass,00" 4090 * enclosure "scsiclass,03.vSYMBIOS.pD1000" 4091 * ssd "scsa,00.bfcp" 4092 * 4093 * All nodename_aliases mappings should idealy be to generic 4094 * names, however a higher precedence legacy mapping to a 4095 * driver name may exist. The highest precedence mapping 4096 * provides the nodename, so legacy driver nodename mappings 4097 * (if they exist) take precedence over generic nodename 4098 * mappings. 4099 */ 4100 for (nname = NULL, csp = compatp; (nname == NULL) && *csp; csp++) { 4101 for (nap = na; nap->na_nodename; nap++) { 4102 if (strcmp(*csp, nap->na_alias) == 0) { 4103 nname = nap->na_nodename; 4104 break; 4105 } 4106 } 4107 } 4108 4109 /* 4110 * Determine the driver name based on compatible (which may 4111 * have the passed in compat0 as the first item). The driver_aliases 4112 * file has entries like 4113 * 4114 * sd "scsiclass,00" 4115 * 4116 * that map compatible forms to specific drivers. These entries are 4117 * established by add_drv/update_drv. We use the most specific 4118 * driver binding as the nodename. This matches the eventual 4119 * ddi_driver_compatible_major() binding that will be 4120 * established by bind_node() 4121 */ 4122 for (dname = NULL, csp = compatp; *csp; csp++) { 4123 major = ddi_name_to_major(*csp); 4124 if ((major == DDI_MAJOR_T_NONE) || 4125 (devnamesp[major].dn_flags & DN_DRIVER_REMOVED)) 4126 continue; 4127 if (dname = ddi_major_to_name(major)) 4128 break; 4129 } 4130 4131 /* 4132 * If no nodename_aliases mapping exists then use the 4133 * driver_aliases specified driver binding as a nodename. 4134 */ 4135 if (nname == NULL) 4136 nname = dname; 4137 4138 /* return results */ 4139 if (nname) { 4140 *nodenamep = kmem_alloc(strlen(nname) + 1, KM_SLEEP); 4141 (void) strcpy(*nodenamep, nname); 4142 } else { 4143 *nodenamep = NULL; 4144 4145 /* 4146 * If no nodename could be determined return a special 4147 * 'compatible' to be used for a diagnostic message. This 4148 * compatible contains all compatible forms concatenated 4149 * into a single string pointed to by the first element. 4150 */ 4151 for (csp = compatp; *(csp + 1); csp++) 4152 *((*csp) + strlen(*csp)) = ' '; 4153 *(compatp + 1) = NULL; 4154 ncompat = 1; 4155 4156 } 4157 if (drivernamep) { 4158 if (dname) { 4159 *drivernamep = kmem_alloc(strlen(dname) + 1, KM_SLEEP); 4160 (void) strcpy(*drivernamep, dname); 4161 } else 4162 *drivernamep = NULL; 4163 } 4164 *compatiblep = compatp; 4165 *ncompatiblep = ncompat; 4166 } 4167 4168 /* 4169 * Free allocations associated with scsi_hba_ident_nodename_compatible_get. 4170 */ 4171 static void 4172 scsi_hba_ident_nodename_compatible_free(char *nodename, char *drivername, 4173 char **compatible) 4174 { 4175 if (nodename) 4176 kmem_free(nodename, strlen(nodename) + 1); 4177 if (drivername) 4178 kmem_free(drivername, strlen(drivername) + 1); 4179 if (compatible) 4180 kmem_free(compatible, (NCOMPAT * sizeof (char *)) + 4181 (NCOMPAT * COMPAT_LONGEST)); 4182 } 4183 4184 void 4185 scsi_hba_nodename_compatible_get(struct scsi_inquiry *inq, 4186 char *binding_set, int dtype_node, char *compat0, 4187 char **nodenamep, char ***compatiblep, int *ncompatiblep) 4188 { 4189 scsi_hba_ident_nodename_compatible_get(inq, 4190 NULL, 0, NULL, 0, binding_set, dtype_node, compat0, nodenamep, 4191 NULL, compatiblep, ncompatiblep); 4192 } 4193 4194 void 4195 scsi_hba_nodename_compatible_free(char *nodename, char **compatible) 4196 { 4197 scsi_hba_ident_nodename_compatible_free(nodename, NULL, compatible); 4198 } 4199 4200 /* return the unit_address associated with a scsi_device */ 4201 char * 4202 scsi_device_unit_address(struct scsi_device *sd) 4203 { 4204 mdi_pathinfo_t *pip; 4205 4206 ASSERT(sd && sd->sd_dev); 4207 if ((sd == NULL) || (sd->sd_dev == NULL)) 4208 return (NULL); 4209 4210 pip = (mdi_pathinfo_t *)sd->sd_pathinfo; 4211 if (pip) 4212 return (mdi_pi_get_addr(pip)); 4213 else 4214 return (ddi_get_name_addr(sd->sd_dev)); 4215 } 4216 4217 /* scsi_device property interfaces */ 4218 #define _TYPE_DEFINED(flags) \ 4219 (((flags & SCSI_DEVICE_PROP_TYPE_MSK) == SCSI_DEVICE_PROP_PATH) || \ 4220 ((flags & SCSI_DEVICE_PROP_TYPE_MSK) == SCSI_DEVICE_PROP_DEVICE)) 4221 4222 #define _DEVICE_PIP(sd, flags) \ 4223 ((((flags & SCSI_DEVICE_PROP_TYPE_MSK) == SCSI_DEVICE_PROP_PATH) && \ 4224 sd->sd_pathinfo) ? (mdi_pathinfo_t *)sd->sd_pathinfo : NULL) 4225 4226 int 4227 scsi_device_prop_get_int(struct scsi_device *sd, uint_t flags, 4228 char *name, int defval) 4229 { 4230 mdi_pathinfo_t *pip; 4231 int v = defval; 4232 int data; 4233 int rv; 4234 4235 ASSERT(sd && name && sd->sd_dev && _TYPE_DEFINED(flags)); 4236 if ((sd == NULL) || (name == NULL) || (sd->sd_dev == NULL) || 4237 !_TYPE_DEFINED(flags)) 4238 return (v); 4239 4240 pip = _DEVICE_PIP(sd, flags); 4241 if (pip) { 4242 rv = mdi_prop_lookup_int(pip, name, &data); 4243 if (rv == DDI_PROP_SUCCESS) 4244 v = data; 4245 } else 4246 v = ddi_prop_get_int(DDI_DEV_T_ANY, sd->sd_dev, 4247 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, name, v); 4248 return (v); 4249 } 4250 4251 4252 int64_t 4253 scsi_device_prop_get_int64(struct scsi_device *sd, uint_t flags, 4254 char *name, int64_t defval) 4255 { 4256 mdi_pathinfo_t *pip; 4257 int64_t v = defval; 4258 int64_t data; 4259 int rv; 4260 4261 ASSERT(sd && name && sd->sd_dev && _TYPE_DEFINED(flags)); 4262 if ((sd == NULL) || (name == NULL) || (sd->sd_dev == NULL) || 4263 !_TYPE_DEFINED(flags)) 4264 return (v); 4265 4266 pip = _DEVICE_PIP(sd, flags); 4267 if (pip) { 4268 rv = mdi_prop_lookup_int64(pip, name, &data); 4269 if (rv == DDI_PROP_SUCCESS) 4270 v = data; 4271 } else 4272 v = ddi_prop_get_int64(DDI_DEV_T_ANY, sd->sd_dev, 4273 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, name, v); 4274 return (v); 4275 } 4276 4277 int 4278 scsi_device_prop_lookup_byte_array(struct scsi_device *sd, uint_t flags, 4279 char *name, uchar_t **data, uint_t *nelements) 4280 { 4281 mdi_pathinfo_t *pip; 4282 int rv; 4283 4284 ASSERT(sd && name && sd->sd_dev && _TYPE_DEFINED(flags)); 4285 if ((sd == NULL) || (name == NULL) || (sd->sd_dev == NULL) || 4286 !_TYPE_DEFINED(flags)) 4287 return (DDI_PROP_INVAL_ARG); 4288 4289 pip = _DEVICE_PIP(sd, flags); 4290 if (pip) 4291 rv = mdi_prop_lookup_byte_array(pip, name, data, nelements); 4292 else 4293 rv = ddi_prop_lookup_byte_array(DDI_DEV_T_ANY, sd->sd_dev, 4294 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, 4295 name, data, nelements); 4296 return (rv); 4297 } 4298 4299 int 4300 scsi_device_prop_lookup_int_array(struct scsi_device *sd, uint_t flags, 4301 char *name, int **data, uint_t *nelements) 4302 { 4303 mdi_pathinfo_t *pip; 4304 int rv; 4305 4306 ASSERT(sd && name && sd->sd_dev && _TYPE_DEFINED(flags)); 4307 if ((sd == NULL) || (name == NULL) || (sd->sd_dev == NULL) || 4308 !_TYPE_DEFINED(flags)) 4309 return (DDI_PROP_INVAL_ARG); 4310 4311 pip = _DEVICE_PIP(sd, flags); 4312 if (pip) 4313 rv = mdi_prop_lookup_int_array(pip, name, data, nelements); 4314 else 4315 rv = ddi_prop_lookup_int_array(DDI_DEV_T_ANY, sd->sd_dev, 4316 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, 4317 name, data, nelements); 4318 return (rv); 4319 } 4320 4321 4322 int 4323 scsi_device_prop_lookup_string(struct scsi_device *sd, uint_t flags, 4324 char *name, char **data) 4325 { 4326 mdi_pathinfo_t *pip; 4327 int rv; 4328 4329 ASSERT(sd && name && sd->sd_dev && _TYPE_DEFINED(flags)); 4330 if ((sd == NULL) || (name == NULL) || (sd->sd_dev == NULL) || 4331 !_TYPE_DEFINED(flags)) 4332 return (DDI_PROP_INVAL_ARG); 4333 4334 pip = _DEVICE_PIP(sd, flags); 4335 if (pip) 4336 rv = mdi_prop_lookup_string(pip, name, data); 4337 else 4338 rv = ddi_prop_lookup_string(DDI_DEV_T_ANY, sd->sd_dev, 4339 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, 4340 name, data); 4341 return (rv); 4342 } 4343 4344 int 4345 scsi_device_prop_lookup_string_array(struct scsi_device *sd, uint_t flags, 4346 char *name, char ***data, uint_t *nelements) 4347 { 4348 mdi_pathinfo_t *pip; 4349 int rv; 4350 4351 ASSERT(sd && name && sd->sd_dev && _TYPE_DEFINED(flags)); 4352 if ((sd == NULL) || (name == NULL) || (sd->sd_dev == NULL) || 4353 !_TYPE_DEFINED(flags)) 4354 return (DDI_PROP_INVAL_ARG); 4355 4356 pip = _DEVICE_PIP(sd, flags); 4357 if (pip) 4358 rv = mdi_prop_lookup_string_array(pip, name, data, nelements); 4359 else 4360 rv = ddi_prop_lookup_string_array(DDI_DEV_T_ANY, sd->sd_dev, 4361 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, 4362 name, data, nelements); 4363 return (rv); 4364 } 4365 4366 int 4367 scsi_device_prop_update_byte_array(struct scsi_device *sd, uint_t flags, 4368 char *name, uchar_t *data, uint_t nelements) 4369 { 4370 mdi_pathinfo_t *pip; 4371 int rv; 4372 4373 ASSERT(sd && name && sd->sd_dev && _TYPE_DEFINED(flags)); 4374 if ((sd == NULL) || (name == NULL) || (sd->sd_dev == NULL) || 4375 !_TYPE_DEFINED(flags)) 4376 return (DDI_PROP_INVAL_ARG); 4377 4378 pip = _DEVICE_PIP(sd, flags); 4379 if (pip) 4380 rv = mdi_prop_update_byte_array(pip, name, data, nelements); 4381 else 4382 rv = ndi_prop_update_byte_array(DDI_DEV_T_NONE, sd->sd_dev, 4383 name, data, nelements); 4384 return (rv); 4385 } 4386 4387 int 4388 scsi_device_prop_update_int(struct scsi_device *sd, uint_t flags, 4389 char *name, int data) 4390 { 4391 mdi_pathinfo_t *pip; 4392 int rv; 4393 4394 ASSERT(sd && name && sd->sd_dev && _TYPE_DEFINED(flags)); 4395 if ((sd == NULL) || (name == NULL) || (sd->sd_dev == NULL) || 4396 !_TYPE_DEFINED(flags)) 4397 return (DDI_PROP_INVAL_ARG); 4398 4399 pip = _DEVICE_PIP(sd, flags); 4400 if (pip) 4401 rv = mdi_prop_update_int(pip, name, data); 4402 else 4403 rv = ndi_prop_update_int(DDI_DEV_T_NONE, sd->sd_dev, 4404 name, data); 4405 return (rv); 4406 } 4407 4408 int 4409 scsi_device_prop_update_int64(struct scsi_device *sd, uint_t flags, 4410 char *name, int64_t data) 4411 { 4412 mdi_pathinfo_t *pip; 4413 int rv; 4414 4415 ASSERT(sd && name && sd->sd_dev && _TYPE_DEFINED(flags)); 4416 if ((sd == NULL) || (name == NULL) || (sd->sd_dev == NULL) || 4417 !_TYPE_DEFINED(flags)) 4418 return (DDI_PROP_INVAL_ARG); 4419 4420 pip = _DEVICE_PIP(sd, flags); 4421 if (pip) 4422 rv = mdi_prop_update_int64(pip, name, data); 4423 else 4424 rv = ndi_prop_update_int64(DDI_DEV_T_NONE, sd->sd_dev, 4425 name, data); 4426 return (rv); 4427 } 4428 4429 int 4430 scsi_device_prop_update_int_array(struct scsi_device *sd, uint_t flags, 4431 char *name, int *data, uint_t nelements) 4432 { 4433 mdi_pathinfo_t *pip; 4434 int rv; 4435 4436 ASSERT(sd && name && sd->sd_dev && _TYPE_DEFINED(flags)); 4437 if ((sd == NULL) || (name == NULL) || (sd->sd_dev == NULL) || 4438 !_TYPE_DEFINED(flags)) 4439 return (DDI_PROP_INVAL_ARG); 4440 4441 pip = _DEVICE_PIP(sd, flags); 4442 if (pip) 4443 rv = mdi_prop_update_int_array(pip, name, data, nelements); 4444 else 4445 rv = ndi_prop_update_int_array(DDI_DEV_T_NONE, sd->sd_dev, 4446 name, data, nelements); 4447 return (rv); 4448 } 4449 4450 int 4451 scsi_device_prop_update_string(struct scsi_device *sd, uint_t flags, 4452 char *name, char *data) 4453 { 4454 mdi_pathinfo_t *pip; 4455 int rv; 4456 4457 ASSERT(sd && name && sd->sd_dev && _TYPE_DEFINED(flags)); 4458 if ((sd == NULL) || (name == NULL) || (sd->sd_dev == NULL) || 4459 !_TYPE_DEFINED(flags)) 4460 return (DDI_PROP_INVAL_ARG); 4461 4462 pip = _DEVICE_PIP(sd, flags); 4463 if (pip) 4464 rv = mdi_prop_update_string(pip, name, data); 4465 else 4466 rv = ndi_prop_update_string(DDI_DEV_T_NONE, sd->sd_dev, 4467 name, data); 4468 return (rv); 4469 } 4470 4471 int 4472 scsi_device_prop_update_string_array(struct scsi_device *sd, uint_t flags, 4473 char *name, char **data, uint_t nelements) 4474 { 4475 mdi_pathinfo_t *pip; 4476 int rv; 4477 4478 ASSERT(sd && name && sd->sd_dev && _TYPE_DEFINED(flags)); 4479 if ((sd == NULL) || (name == NULL) || (sd->sd_dev == NULL) || 4480 !_TYPE_DEFINED(flags)) 4481 return (DDI_PROP_INVAL_ARG); 4482 4483 pip = _DEVICE_PIP(sd, flags); 4484 if (pip) 4485 rv = mdi_prop_update_string_array(pip, name, data, nelements); 4486 else 4487 rv = ndi_prop_update_string_array(DDI_DEV_T_NONE, sd->sd_dev, 4488 name, data, nelements); 4489 return (rv); 4490 } 4491 4492 int 4493 scsi_device_prop_remove(struct scsi_device *sd, uint_t flags, char *name) 4494 { 4495 mdi_pathinfo_t *pip; 4496 int rv; 4497 4498 ASSERT(sd && name && sd->sd_dev && _TYPE_DEFINED(flags)); 4499 if ((sd == NULL) || (name == NULL) || (sd->sd_dev == NULL) || 4500 !_TYPE_DEFINED(flags)) 4501 return (DDI_PROP_INVAL_ARG); 4502 4503 pip = _DEVICE_PIP(sd, flags); 4504 if (pip) 4505 rv = mdi_prop_remove(pip, name); 4506 else 4507 rv = ndi_prop_remove(DDI_DEV_T_NONE, sd->sd_dev, name); 4508 return (rv); 4509 } 4510 4511 void 4512 scsi_device_prop_free(struct scsi_device *sd, uint_t flags, void *data) 4513 { 4514 mdi_pathinfo_t *pip; 4515 4516 ASSERT(sd && data && sd->sd_dev && _TYPE_DEFINED(flags)); 4517 if ((sd == NULL) || (data == NULL) || (sd->sd_dev == NULL) || 4518 !_TYPE_DEFINED(flags)) 4519 return; 4520 4521 pip = _DEVICE_PIP(sd, flags); 4522 if (pip) 4523 (void) mdi_prop_free(data); 4524 else 4525 ddi_prop_free(data); 4526 } 4527 4528 /* SMP device property interfaces */ 4529 int 4530 smp_device_prop_get_int(struct smp_device *smp_sd, char *name, int defval) 4531 { 4532 int v = defval; 4533 4534 ASSERT(smp_sd && name && smp_sd->smp_sd_dev); 4535 if ((smp_sd == NULL) || (name == NULL) || (smp_sd->smp_sd_dev == NULL)) 4536 return (v); 4537 4538 v = ddi_prop_get_int(DDI_DEV_T_ANY, smp_sd->smp_sd_dev, 4539 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, name, v); 4540 return (v); 4541 } 4542 4543 4544 int64_t 4545 smp_device_prop_get_int64(struct smp_device *smp_sd, char *name, int64_t defval) 4546 { 4547 int64_t v = defval; 4548 4549 ASSERT(smp_sd && name && smp_sd->smp_sd_dev); 4550 if ((smp_sd == NULL) || (name == NULL) || (smp_sd->smp_sd_dev == NULL)) 4551 return (v); 4552 4553 v = ddi_prop_get_int64(DDI_DEV_T_ANY, smp_sd->smp_sd_dev, 4554 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, name, v); 4555 return (v); 4556 } 4557 4558 int 4559 smp_device_prop_lookup_byte_array(struct smp_device *smp_sd, char *name, 4560 uchar_t **data, uint_t *nelements) 4561 { 4562 int rv; 4563 4564 ASSERT(smp_sd && name && smp_sd->smp_sd_dev); 4565 if ((smp_sd == NULL) || (name == NULL) || (smp_sd->smp_sd_dev == NULL)) 4566 return (DDI_PROP_INVAL_ARG); 4567 4568 rv = ddi_prop_lookup_byte_array(DDI_DEV_T_ANY, smp_sd->smp_sd_dev, 4569 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, 4570 name, data, nelements); 4571 return (rv); 4572 } 4573 4574 int 4575 smp_device_prop_lookup_int_array(struct smp_device *smp_sd, char *name, 4576 int **data, uint_t *nelements) 4577 { 4578 int rv; 4579 4580 ASSERT(smp_sd && name && smp_sd->smp_sd_dev); 4581 if ((smp_sd == NULL) || (name == NULL) || (smp_sd->smp_sd_dev == NULL)) 4582 return (DDI_PROP_INVAL_ARG); 4583 4584 rv = ddi_prop_lookup_int_array(DDI_DEV_T_ANY, smp_sd->smp_sd_dev, 4585 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, 4586 name, data, nelements); 4587 return (rv); 4588 } 4589 4590 4591 int 4592 smp_device_prop_lookup_string(struct smp_device *smp_sd, char *name, 4593 char **data) 4594 { 4595 int rv; 4596 4597 ASSERT(smp_sd && name && smp_sd->smp_sd_dev); 4598 if ((smp_sd == NULL) || (name == NULL) || (smp_sd->smp_sd_dev == NULL)) 4599 return (DDI_PROP_INVAL_ARG); 4600 4601 rv = ddi_prop_lookup_string(DDI_DEV_T_ANY, smp_sd->smp_sd_dev, 4602 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, 4603 name, data); 4604 return (rv); 4605 } 4606 4607 int 4608 smp_device_prop_lookup_string_array(struct smp_device *smp_sd, char *name, 4609 char ***data, uint_t *nelements) 4610 { 4611 int rv; 4612 4613 ASSERT(smp_sd && name && smp_sd->smp_sd_dev); 4614 if ((smp_sd == NULL) || (name == NULL) || (smp_sd->smp_sd_dev == NULL)) 4615 return (DDI_PROP_INVAL_ARG); 4616 4617 rv = ddi_prop_lookup_string_array(DDI_DEV_T_ANY, smp_sd->smp_sd_dev, 4618 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, 4619 name, data, nelements); 4620 return (rv); 4621 } 4622 4623 int 4624 smp_device_prop_update_byte_array(struct smp_device *smp_sd, char *name, 4625 uchar_t *data, uint_t nelements) 4626 { 4627 int rv; 4628 4629 ASSERT(smp_sd && name && smp_sd->smp_sd_dev); 4630 if ((smp_sd == NULL) || (name == NULL) || (smp_sd->smp_sd_dev == NULL)) 4631 return (DDI_PROP_INVAL_ARG); 4632 4633 rv = ndi_prop_update_byte_array(DDI_DEV_T_NONE, smp_sd->smp_sd_dev, 4634 name, data, nelements); 4635 return (rv); 4636 } 4637 4638 int 4639 smp_device_prop_update_int(struct smp_device *smp_sd, char *name, int data) 4640 { 4641 int rv; 4642 4643 ASSERT(smp_sd && name && smp_sd->smp_sd_dev); 4644 if ((smp_sd == NULL) || (name == NULL) || (smp_sd->smp_sd_dev == NULL)) 4645 return (DDI_PROP_INVAL_ARG); 4646 4647 rv = ndi_prop_update_int(DDI_DEV_T_NONE, smp_sd->smp_sd_dev, 4648 name, data); 4649 return (rv); 4650 } 4651 4652 int 4653 smp_device_prop_update_int64(struct smp_device *smp_sd, char *name, 4654 int64_t data) 4655 { 4656 int rv; 4657 4658 ASSERT(smp_sd && name && smp_sd->smp_sd_dev); 4659 if ((smp_sd == NULL) || (name == NULL) || (smp_sd->smp_sd_dev == NULL)) 4660 return (DDI_PROP_INVAL_ARG); 4661 4662 rv = ndi_prop_update_int64(DDI_DEV_T_NONE, smp_sd->smp_sd_dev, 4663 name, data); 4664 return (rv); 4665 } 4666 4667 int 4668 smp_device_prop_update_int_array(struct smp_device *smp_sd, char *name, 4669 int *data, uint_t nelements) 4670 { 4671 int rv; 4672 4673 ASSERT(smp_sd && name && smp_sd->smp_sd_dev); 4674 if ((smp_sd == NULL) || (name == NULL) || (smp_sd->smp_sd_dev == NULL)) 4675 return (DDI_PROP_INVAL_ARG); 4676 4677 rv = ndi_prop_update_int_array(DDI_DEV_T_NONE, smp_sd->smp_sd_dev, 4678 name, data, nelements); 4679 return (rv); 4680 } 4681 4682 int 4683 smp_device_prop_update_string(struct smp_device *smp_sd, char *name, char *data) 4684 { 4685 int rv; 4686 4687 ASSERT(smp_sd && name && smp_sd->smp_sd_dev); 4688 if ((smp_sd == NULL) || (name == NULL) || (smp_sd->smp_sd_dev == NULL)) 4689 return (DDI_PROP_INVAL_ARG); 4690 4691 rv = ndi_prop_update_string(DDI_DEV_T_NONE, smp_sd->smp_sd_dev, 4692 name, data); 4693 return (rv); 4694 } 4695 4696 int 4697 smp_device_prop_update_string_array(struct smp_device *smp_sd, char *name, 4698 char **data, uint_t nelements) 4699 { 4700 int rv; 4701 4702 ASSERT(smp_sd && name && smp_sd->smp_sd_dev); 4703 if ((smp_sd == NULL) || (name == NULL) || (smp_sd->smp_sd_dev == NULL)) 4704 return (DDI_PROP_INVAL_ARG); 4705 4706 rv = ndi_prop_update_string_array(DDI_DEV_T_NONE, smp_sd->smp_sd_dev, 4707 name, data, nelements); 4708 return (rv); 4709 } 4710 4711 int 4712 smp_device_prop_remove(struct smp_device *smp_sd, char *name) 4713 { 4714 int rv; 4715 4716 ASSERT(smp_sd && name && smp_sd->smp_sd_dev); 4717 if ((smp_sd == NULL) || (name == NULL) || (smp_sd->smp_sd_dev == NULL)) 4718 return (DDI_PROP_INVAL_ARG); 4719 4720 rv = ndi_prop_remove(DDI_DEV_T_NONE, smp_sd->smp_sd_dev, name); 4721 return (rv); 4722 } 4723 4724 void 4725 smp_device_prop_free(struct smp_device *smp_sd, void *data) 4726 { 4727 ASSERT(smp_sd && data && smp_sd->smp_sd_dev); 4728 if ((smp_sd == NULL) || (data == NULL) || (smp_sd->smp_sd_dev == NULL)) 4729 return; 4730 4731 ddi_prop_free(data); 4732 } 4733 4734 /* 4735 * scsi_hba_ua_set: given "unit-address" string, set properties. 4736 * 4737 * Function to set the properties on a devinfo or pathinfo node from 4738 * the "unit-address" part of a "name@unit-address" /devices path 'name' 4739 * string. 4740 * 4741 * This function works in conjunction with scsi_ua_get()/scsi_hba_ua_get() 4742 * (and possibly with an HBA driver's tran_tgt_init() implementation). 4743 */ 4744 static int 4745 scsi_hba_ua_set(char *ua, dev_info_t *dchild, mdi_pathinfo_t *pchild) 4746 { 4747 char *p; 4748 int tgt; 4749 char *tgt_port_end; 4750 char *tgt_port; 4751 int tgt_port_len; 4752 int sfunc; 4753 scsi_lun64_t lun64; 4754 4755 /* Caller must choose to decorate devinfo *or* pathinfo */ 4756 ASSERT((dchild != NULL) ^ (pchild != NULL)); 4757 if (dchild && pchild) 4758 return (0); 4759 4760 /* 4761 * generic implementation based on "tgt,lun[,sfunc]" address form. 4762 * parse hex "tgt" part of "tgt,lun[,sfunc]" 4763 */ 4764 p = ua; 4765 tgt_port_end = NULL; 4766 for (tgt = 0; *p && *p != ','; p++) { 4767 if (*p >= '0' && *p <= '9') 4768 tgt = (tgt << 4) + (*p - '0'); 4769 else if (*p >= 'a' && *p <= 'f') 4770 tgt = (tgt << 4) + 10 + (*p - 'a'); 4771 else 4772 tgt = -1; /* non-numeric */ 4773 4774 /* 4775 * if non-numeric or our of range set tgt to -1 and 4776 * skip forward 4777 */ 4778 if (tgt < 0) { 4779 tgt = -1; 4780 for (; *p && *p != ','; p++) 4781 ; 4782 break; 4783 } 4784 } 4785 tgt_port_end = p; 4786 4787 /* parse hex ",lun" part of "tgt,lun[,sfunc]" */ 4788 if (*p) 4789 p++; 4790 for (lun64 = 0; *p && *p != ','; p++) { 4791 if (*p >= '0' && *p <= '9') 4792 lun64 = (lun64 << 4) + (*p - '0'); 4793 else if (*p >= 'a' && *p <= 'f') 4794 lun64 = (lun64 << 4) + 10 + (*p - 'a'); 4795 else 4796 return (0); 4797 } 4798 4799 /* parse hex ",sfunc" part of "tgt,lun[,sfunc]" */ 4800 if (*p) { 4801 p++; 4802 for (sfunc = 0; *p; p++) { 4803 if (*p >= '0' && *p <= '9') 4804 sfunc = (sfunc << 4) + (*p - '0'); 4805 else if (*p >= 'a' && *p <= 'f') 4806 sfunc = (sfunc << 4) + 10 + (*p - 'a'); 4807 else 4808 return (0); 4809 } 4810 } else 4811 sfunc = -1; 4812 4813 if (dchild) { 4814 /* 4815 * Decorate a devinfo node with unit address properties. 4816 * This adds the the addressing properties needed to 4817 * DDI_CTLOPS_UNINITCHILD the devinfo node (i.e. perform 4818 * the reverse operation - form unit address from properties). 4819 */ 4820 if ((tgt != -1) && (ndi_prop_update_int(DDI_DEV_T_NONE, dchild, 4821 SCSI_ADDR_PROP_TARGET, tgt) != DDI_PROP_SUCCESS)) 4822 return (0); 4823 4824 if (tgt_port_end) { 4825 tgt_port_len = tgt_port_end - ua + 1; 4826 tgt_port = kmem_alloc(tgt_port_len, KM_SLEEP); 4827 (void) strlcpy(tgt_port, ua, tgt_port_len); 4828 if (ndi_prop_update_string(DDI_DEV_T_NONE, dchild, 4829 SCSI_ADDR_PROP_TARGET_PORT, tgt_port) != 4830 DDI_PROP_SUCCESS) { 4831 kmem_free(tgt_port, tgt_port_len); 4832 return (0); 4833 } 4834 kmem_free(tgt_port, tgt_port_len); 4835 } 4836 4837 /* Set the appropriate lun properties. */ 4838 if (lun64 < SCSI_32LUNS_PER_TARGET) { 4839 if (ndi_prop_update_int(DDI_DEV_T_NONE, dchild, 4840 SCSI_ADDR_PROP_LUN, (int)lun64) != DDI_PROP_SUCCESS) 4841 return (0); 4842 } 4843 if (ndi_prop_update_int64(DDI_DEV_T_NONE, dchild, 4844 SCSI_ADDR_PROP_LUN64, lun64) != DDI_PROP_SUCCESS) 4845 return (0); 4846 4847 /* Set the sfunc property */ 4848 if ((sfunc != -1) && 4849 (ndi_prop_update_int(DDI_DEV_T_NONE, dchild, 4850 SCSI_ADDR_PROP_SFUNC, (int)sfunc) != DDI_PROP_SUCCESS)) 4851 return (0); 4852 } else if (pchild) { 4853 /* 4854 * Decorate a pathinfo node with unit address properties. 4855 */ 4856 if ((tgt != -1) && (mdi_prop_update_int(pchild, 4857 SCSI_ADDR_PROP_TARGET, tgt) != DDI_PROP_SUCCESS)) 4858 return (0); 4859 4860 if (tgt_port_end) { 4861 tgt_port_len = tgt_port_end - ua + 1; 4862 tgt_port = kmem_alloc(tgt_port_len, KM_SLEEP); 4863 (void) strlcpy(tgt_port, ua, tgt_port_len); 4864 if (mdi_prop_update_string(pchild, 4865 SCSI_ADDR_PROP_TARGET_PORT, tgt_port) != 4866 DDI_PROP_SUCCESS) { 4867 kmem_free(tgt_port, tgt_port_len); 4868 return (0); 4869 } 4870 kmem_free(tgt_port, tgt_port_len); 4871 } 4872 4873 /* Set the appropriate lun properties */ 4874 if (lun64 < SCSI_32LUNS_PER_TARGET) { 4875 if (mdi_prop_update_int(pchild, SCSI_ADDR_PROP_LUN, 4876 (int)lun64) != DDI_PROP_SUCCESS) 4877 return (0); 4878 } 4879 4880 if (mdi_prop_update_int64(pchild, SCSI_ADDR_PROP_LUN64, 4881 lun64) != DDI_PROP_SUCCESS) 4882 return (0); 4883 4884 /* Set the sfunc property */ 4885 if ((sfunc != -1) && 4886 (mdi_prop_update_int(pchild, 4887 SCSI_ADDR_PROP_SFUNC, (int)sfunc) != DDI_PROP_SUCCESS)) 4888 return (0); 4889 } 4890 return (1); 4891 } 4892 4893 /* 4894 * Private ndi_devi_find/mdi_pi_find implementation - find the child 4895 * dev_info/path_info of self whose phci name matches "name@caddr". 4896 * We have our own implementation because we need to search with both 4897 * forms of sibling lists (dev_info and path_info) and we need to be able 4898 * to search with a NULL name in order to find siblings already associated 4899 * with a given unit-address (same @addr). NOTE: NULL name search will never 4900 * return probe node. 4901 * 4902 * If pchildp is NULL and we find a pathinfo child, we return the client 4903 * devinfo node in *dchildp. 4904 * 4905 * The init flag argument should be clear when called from places where 4906 * recursion could occur (like scsi_busctl_initchild) and when the caller 4907 * has already performed a search for name@addr with init set (performance). 4908 * 4909 * Future: Integrate ndi_devi_findchild_by_callback into scsi_findchild. 4910 */ 4911 static int 4912 scsi_findchild(dev_info_t *self, char *name, char *addr, int init, 4913 dev_info_t **dchildp, mdi_pathinfo_t **pchildp, int *ppi) 4914 { 4915 dev_info_t *dchild; /* devinfo child */ 4916 mdi_pathinfo_t *pchild; /* pathinfo child */ 4917 int found = CHILD_TYPE_NONE; 4918 char *daddr; 4919 4920 ASSERT(self && DEVI_BUSY_OWNED(self)); 4921 ASSERT(addr && dchildp); 4922 if ((self == NULL) || (addr == NULL) || (dchildp == NULL)) 4923 return (CHILD_TYPE_NONE); 4924 4925 *dchildp = NULL; 4926 if (pchildp) 4927 *pchildp = NULL; 4928 if (ppi) 4929 *ppi = 0; 4930 4931 /* Walk devinfo child list to find a match */ 4932 for (dchild = ddi_get_child(self); dchild; 4933 dchild = ddi_get_next_sibling(dchild)) { 4934 if (i_ddi_node_state(dchild) < DS_INITIALIZED) 4935 continue; 4936 4937 daddr = ddi_get_name_addr(dchild); 4938 if (daddr && (strcmp(addr, daddr) == 0) && 4939 ((name == NULL) || 4940 (strcmp(name, DEVI(dchild)->devi_node_name) == 0))) { 4941 /* 4942 * If we are asked to find "anything" at a given 4943 * unit-address (name == NULL), we don't realy want 4944 * to find the 'probe' node. The existance of 4945 * a probe node on a 'name == NULL' search should 4946 * fail. This will trigger slow-path code where 4947 * we explicity look for, and synchronize against, 4948 * a node named "probe" at the unit-address. 4949 */ 4950 if ((name == NULL) && 4951 scsi_hba_devi_is_barrier(dchild)) { 4952 SCSI_HBA_LOG((_LOG(4), NULL, dchild, 4953 "%s@%s 'probe' devinfo found, skip", 4954 name ? name : "", addr)); 4955 continue; 4956 } 4957 4958 /* We have found a match. */ 4959 found |= CHILD_TYPE_DEVINFO; 4960 SCSI_HBA_LOG((_LOG(4), NULL, dchild, 4961 "%s@%s devinfo found", name ? name : "", addr)); 4962 *dchildp = dchild; /* devinfo found */ 4963 break; 4964 } 4965 } 4966 4967 /* 4968 * Walk pathinfo child list to find a match. 4969 * 4970 * NOTE: Unlike devinfo nodes, pathinfo nodes have a string searchable 4971 * unit-address from creation - so there is no need for an 'init' 4972 * search block of code for pathinfo nodes below. 4973 */ 4974 pchild = mdi_pi_find(self, NULL, addr); 4975 if (pchild) { 4976 /* 4977 * NOTE: If name specified and we match a pathinfo unit 4978 * address, we don't check the client node name. 4979 */ 4980 if (ppi) 4981 *ppi = mdi_pi_get_path_instance(pchild); 4982 found |= CHILD_TYPE_PATHINFO; 4983 4984 if (pchildp) { 4985 SCSI_HBA_LOG((_LOG(4), self, NULL, 4986 "%s pathinfo found", mdi_pi_spathname(pchild))); 4987 *pchildp = pchild; /* pathinfo found */ 4988 } else if (*dchildp == NULL) { 4989 /* 4990 * Did not find a devinfo node, found a pathinfo node, 4991 * but caller did not ask us to return a pathinfo node: 4992 * we return the 'client' devinfo node instead (but 4993 * with CHILD_TYPE_PATHINFO 'found' return value). 4994 */ 4995 dchild = mdi_pi_get_client(pchild); 4996 SCSI_HBA_LOG((_LOG(4), NULL, dchild, 4997 "%s pathinfo found, client switch", 4998 mdi_pi_spathname(pchild))); 4999 5000 /* 5001 * A pathinfo node always has a 'client' devinfo node, 5002 * but we need to ensure that the 'client' is 5003 * initialized and has a scsi_device structure too. 5004 */ 5005 ASSERT(dchild); 5006 if (i_ddi_node_state(dchild) < DS_INITIALIZED) { 5007 SCSI_HBA_LOG((_LOG(4), NULL, dchild, 5008 "%s found client, initchild", 5009 mdi_pi_spathname(pchild))); 5010 (void) ddi_initchild(ddi_get_parent(dchild), 5011 dchild); 5012 } 5013 if (i_ddi_node_state(dchild) >= DS_INITIALIZED) { 5014 /* client found and initialized */ 5015 *dchildp = dchild; 5016 } else { 5017 SCSI_HBA_LOG((_LOG(4), NULL, dchild, 5018 "%s found client, but failed initchild", 5019 mdi_pi_spathname(pchild))); 5020 } 5021 } 5022 } 5023 5024 /* Try devinfo again with initchild of uninitialized nodes */ 5025 if ((found == CHILD_TYPE_NONE) && init) { 5026 for (dchild = ddi_get_child(self); dchild; 5027 dchild = ddi_get_next_sibling(dchild)) { 5028 /* skip if checked above */ 5029 if (i_ddi_node_state(dchild) >= DS_INITIALIZED) 5030 continue; 5031 /* attempt initchild to establish unit-address */ 5032 (void) ddi_initchild(self, dchild); 5033 if (i_ddi_node_state(dchild) < DS_INITIALIZED) 5034 continue; 5035 daddr = ddi_get_name_addr(dchild); 5036 if (daddr && 5037 ((name == NULL) || (strcmp(name, 5038 DEVI(dchild)->devi_node_name) == 0)) && 5039 (strcmp(addr, daddr) == 0)) { 5040 found |= CHILD_TYPE_DEVINFO; 5041 SCSI_HBA_LOG((_LOG(4), NULL, dchild, 5042 "%s@%s devinfo found post initchild", 5043 name ? name : "", addr)); 5044 *dchildp = dchild; /* devinfo found */ 5045 break; /* node found */ 5046 } 5047 } 5048 } 5049 5050 /* 5051 * We should never find devinfo and pathinfo at the same 5052 * unit-address. 5053 */ 5054 ASSERT(found != (CHILD_TYPE_DEVINFO | CHILD_TYPE_PATHINFO)); 5055 if (found == (CHILD_TYPE_DEVINFO | CHILD_TYPE_PATHINFO)) { 5056 found = CHILD_TYPE_NONE; 5057 *dchildp = NULL; 5058 *pchildp = NULL; 5059 } 5060 return (found); 5061 } 5062 5063 /* 5064 * Given information about a child device (contained on probe node) construct 5065 * and return a pointer to the dynamic SID devinfo node associated with the 5066 * device. In the creation of this SID node a compatible property for the 5067 * device is formed and used to establish a nodename (via 5068 * /etc/nodename_aliases) and to bind a driver (via /etc/driver_aliases). 5069 * 5070 * If this routine is called then we got a response from a device and 5071 * obtained the inquiry data from the device. Some inquiry results indicate 5072 * that the specific LUN we addressed does not exist, and we don't want to 5073 * bind a standard target driver to the node we create. Even though the 5074 * specific LUN is not usable, the framework may still want to bind a 5075 * target driver to the device for internal communication with the device - 5076 * an example would be issuing a report_lun to enumerate other LUNs under a 5077 * DPQ_NEVER LUN0. Another example would be wanting to known that the 5078 * DPQ_NEVER LUN0 device exists in BUS_CONFIG_ONE for non-existent LUN 5079 * caching optimizations. To support this we let the caller specify a 5080 * compatible property (or driver). If LUN0 inquiry data indicates that the 5081 * LUN does not exist then we establish compat0 as the highest precedence(0) 5082 * compatible form. If used, this compat0 driver will never be called on to 5083 * issue external commands to the device. 5084 * 5085 * If no driver binds to the device using driver_alias we establish the driver 5086 * passed in as the node name. 5087 */ 5088 5089 extern int e_devid_cache_pathinfo(mdi_pathinfo_t *, ddi_devid_t); 5090 5091 static int 5092 scsi_device_createchild(dev_info_t *self, char *addr, scsi_enum_t se, 5093 struct scsi_device *sdprobe, dev_info_t **dchildp, mdi_pathinfo_t **pchildp) 5094 { 5095 scsi_lun64_t lun64; 5096 int dtype; 5097 int dpq; 5098 int dpq_vu; 5099 int dtype_node; 5100 int lunexists; 5101 char *compat0; 5102 char *nname; 5103 char **compat = NULL; 5104 int ncompat; 5105 dev_info_t *dchild = NULL; 5106 mdi_pathinfo_t *pchild = NULL; 5107 dev_info_t *probe = sdprobe->sd_dev; 5108 struct scsi_inquiry *inq = sdprobe->sd_inq; 5109 uchar_t *inq80 = NULL; 5110 uchar_t *inq83 = NULL; 5111 uint_t inq80len, inq83len; 5112 char *binding_set = NULL; 5113 char *dname = NULL; 5114 ddi_devid_t devid; 5115 int have_devid = 0; 5116 ddi_devid_t cdevid; 5117 int have_cdevid = 0; 5118 char *devid_str; 5119 char *guid = NULL; 5120 5121 ASSERT(self && addr && *addr && DEVI_BUSY_OWNED(self)); 5122 ASSERT(dchildp && pchildp); 5123 5124 /* 5125 * Determine the lun and whether the lun exists. We may need to create 5126 * a node for LUN0 (with compat0 driver binding) even if the lun does 5127 * not exist - so we can run report_lun to find additional LUNs. 5128 */ 5129 lun64 = scsi_addr_to_lun64(addr); 5130 dtype = inq->inq_dtype & DTYPE_MASK; /* device */ 5131 dpq = inq->inq_dtype & DPQ_MASK; 5132 dpq_vu = inq->inq_dtype & DPQ_VUNIQ ? 1 : 0; 5133 5134 dtype_node = scsi_addr_to_sfunc(addr); /* secondary function */ 5135 if (dtype_node == -1) 5136 dtype_node = dtype; /* node for device */ 5137 5138 lunexists = (dtype != dtype_node) || /* override */ 5139 ((dpq_vu == 0) && (dpq == DPQ_POSSIBLE)) || /* ANSII */ 5140 (dpq_vu && (lun64 == 0)); /* VU LUN0 */ 5141 if (dtype == DTYPE_UNKNOWN) 5142 lunexists = 0; 5143 5144 SCSI_HBA_LOG((_LOG(4), self, NULL, 5145 "@%s dtype %x %x dpq_vu %d dpq %x: %d", 5146 addr, dtype, dtype_node, dpq_vu, dpq, lunexists)); 5147 5148 /* A non-existent LUN0 uses compatible_nodev. */ 5149 if (lunexists) { 5150 compat0 = NULL; /* compat0 not needed */ 5151 } else if (lun64 == 0) { 5152 compat0 = compatible_nodev; 5153 SCSI_HBA_LOG((_LOG(2), self, NULL, 5154 "@%s lun 0 with compat0 %s", addr, compat0)); 5155 } else 5156 goto out; /* no node created */ 5157 5158 /* Obtain identity information from probe node. */ 5159 if (ddi_prop_lookup_byte_array(DDI_DEV_T_ANY, probe, 5160 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, "inquiry-page-80", 5161 &inq80, &inq80len) != DDI_PROP_SUCCESS) 5162 inq80 = NULL; 5163 if (ddi_prop_lookup_byte_array(DDI_DEV_T_ANY, probe, 5164 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, "inquiry-page-83", 5165 &inq83, &inq83len) != DDI_PROP_SUCCESS) 5166 inq83 = NULL; 5167 5168 /* Get "scsi-binding-set" property (if there is one). */ 5169 if (ddi_prop_lookup_string(DDI_DEV_T_ANY, self, 5170 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, 5171 "scsi-binding-set", &binding_set) == DDI_PROP_SUCCESS) 5172 SCSI_HBA_LOG((_LOG(2), NULL, probe, 5173 "binding_set '%s'", binding_set)); 5174 5175 /* determine the node name and compatible information */ 5176 scsi_hba_ident_nodename_compatible_get(inq, 5177 inq80, inq80len, inq83, inq83len, binding_set, dtype_node, 5178 compat0, &nname, &dname, &compat, &ncompat); 5179 5180 if (nname == NULL) { 5181 /* 5182 * We will not be able to create a node because we could not 5183 * determine a node name. Print out a NODRIVER level warning 5184 * message with the compatible forms for the device. Note that 5185 * there may be a driver.conf node that attaches to the device, 5186 * which is why we only produce this warning message for debug 5187 * kernels. 5188 */ 5189 SCSI_HBA_LOG((_LOG(1), NULL, self, 5190 "no node_name for device @%s:\n compatible: %s", 5191 addr, *compat)); 5192 goto out; 5193 } 5194 5195 /* 5196 * FUTURE: some day we may want an accurate "compatible" on the probe 5197 * node so that vhci_is_dev_supported() in scsi_vhci could, at 5198 * least in part, determine/configure based on "compatible". 5199 * 5200 * if (ndi_prop_update_string_array(DDI_DEV_T_NONE, probe, 5201 * "compatible", compat, ncompat) != DDI_PROP_SUCCESS) { 5202 * SCSI_HBA_LOG((_LOG(3), self, NULL, 5203 * "%s@%s failed probe compatible decoration", 5204 * nname, addr)); 5205 * goto out; 5206 * } 5207 */ 5208 5209 /* Encode devid from identity information. */ 5210 if (ddi_devid_scsi_encode(DEVID_SCSI_ENCODE_VERSION_LATEST, dname, 5211 (uchar_t *)inq, sizeof (*inq), inq80, inq80len, inq83, inq83len, 5212 &devid) == DDI_SUCCESS) { 5213 have_devid = 1; 5214 5215 /* Attempt to form guid from devid. */ 5216 guid = ddi_devid_to_guid(devid); 5217 5218 /* Produce string devid for debug. */ 5219 devid_str = ddi_devid_str_encode(devid, NULL); 5220 SCSI_HBA_LOG((_LOG(3), self, probe, "devid '%s' guid '%s'", 5221 devid_str ? devid_str : "NULL", guid ? guid : "NULL")); 5222 ddi_devid_str_free(devid_str); 5223 } 5224 5225 5226 /* 5227 * Determine if the device should be enumerated as under the vHCI 5228 * (client node) or under the pHCI. By convention scsi_vhci expects 5229 * the "cinfo" argument identity information to be represented as a 5230 * devinfo node with the needed information (i.e. the pHCI probe node). 5231 */ 5232 if ((guid == NULL) || 5233 (mdi_is_dev_supported(MDI_HCI_CLASS_SCSI, self, sdprobe) != 5234 MDI_SUCCESS)) { 5235 SCSI_HBA_LOG((_LOG(3), self, probe, "==> devinfo")); 5236 5237 /* 5238 * Enumerate under pHCI: 5239 * 5240 * Create dynamic SID dchild node. No attempt is made to 5241 * transfer information (except the addressing and identity 5242 * information) from the probe node to the dynamic node since 5243 * there may be HBA specific side effects that the framework 5244 * does not known how to transfer. 5245 */ 5246 ndi_devi_alloc_sleep(self, nname, 5247 (se == SE_HP) ? DEVI_SID_HP_NODEID : DEVI_SID_NODEID, 5248 &dchild); 5249 ASSERT(dchild); 5250 ndi_flavor_set(dchild, SCSA_FLAVOR_SCSI_DEVICE); 5251 5252 /* 5253 * Decorate new node with addressing properties (via 5254 * scsi_hba_ua_set()), compatible, identity information, and 5255 * class. 5256 */ 5257 if ((scsi_hba_ua_set(addr, dchild, NULL) == 0) || 5258 (ndi_prop_update_string_array(DDI_DEV_T_NONE, dchild, 5259 "compatible", compat, ncompat) != DDI_PROP_SUCCESS) || 5260 (inq80 && (ndi_prop_update_byte_array(DDI_DEV_T_NONE, 5261 dchild, "inquiry-page-80", inq80, inq80len) != 5262 DDI_PROP_SUCCESS)) || 5263 (inq83 && (ndi_prop_update_byte_array(DDI_DEV_T_NONE, 5264 dchild, "inquiry-page-83", inq83, inq83len) != 5265 DDI_PROP_SUCCESS)) || 5266 (ndi_prop_update_string(DDI_DEV_T_NONE, dchild, 5267 "class", "scsi") != DDI_PROP_SUCCESS)) { 5268 SCSI_HBA_LOG((_LOG(2), self, NULL, 5269 "devinfo @%s failed decoration", addr)); 5270 (void) scsi_hba_remove_node(dchild); 5271 dchild = NULL; 5272 goto out; 5273 } 5274 5275 /* Bind the driver */ 5276 if (ndi_devi_bind_driver(dchild, 0) != NDI_SUCCESS) { 5277 /* need to bind in order to register a devid */ 5278 SCSI_HBA_LOG((_LOGCFG, NULL, dchild, 5279 "devinfo @%s created, no driver-> " 5280 "no devid_register", addr)); 5281 goto out; 5282 } 5283 5284 /* Register devid */ 5285 if (have_devid) { 5286 if (ddi_devid_register(dchild, devid) == DDI_FAILURE) 5287 SCSI_HBA_LOG((_LOG(1), NULL, dchild, 5288 "devinfo @%s created, " 5289 "devid register failed", addr)); 5290 else 5291 SCSI_HBA_LOG((_LOG(2), NULL, dchild, 5292 "devinfo @%s created with devid", addr)); 5293 } else 5294 SCSI_HBA_LOG((_LOG(2), NULL, dchild, 5295 "devinfo @%s created, no devid", addr)); 5296 } else { 5297 /* 5298 * Enumerate under vHCI: 5299 * 5300 * Create a pathinfo pchild node. 5301 */ 5302 SCSI_HBA_LOG((_LOG(3), self, probe, "==>pathinfo")); 5303 5304 if (mdi_pi_alloc_compatible(self, nname, guid, addr, compat, 5305 ncompat, 0, &pchild) != MDI_SUCCESS) { 5306 SCSI_HBA_LOG((_LOG(2), self, probe, 5307 "pathinfo alloc failed")); 5308 goto out; 5309 } 5310 5311 ASSERT(pchild); 5312 dchild = mdi_pi_get_client(pchild); 5313 ASSERT(dchild); 5314 ndi_flavor_set(dchild, SCSA_FLAVOR_SCSI_DEVICE); 5315 5316 /* 5317 * Decorate new node with addressing properties via 5318 * scsi_hba_ua_set(). 5319 */ 5320 if (scsi_hba_ua_set(addr, NULL, pchild) == 0) { 5321 SCSI_HBA_LOG((_LOG(1), self, NULL, 5322 "pathinfo %s decoration failed", 5323 mdi_pi_spathname(pchild))); 5324 (void) mdi_pi_free(pchild, 0); 5325 pchild = NULL; 5326 goto out; 5327 } 5328 5329 /* Bind the driver */ 5330 if (ndi_devi_bind_driver(dchild, 0) != NDI_SUCCESS) { 5331 /* need to bind in order to register a devid */ 5332 SCSI_HBA_LOG((_LOGCFG, self, NULL, 5333 "pathinfo %s created, no client driver-> " 5334 "no devid_register", mdi_pi_spathname(pchild))); 5335 goto out; 5336 } 5337 5338 /* Watch out for inconsistancies in devids. */ 5339 if (ddi_devid_get(dchild, &cdevid) == DDI_SUCCESS) 5340 have_cdevid = 1; 5341 5342 if (have_devid && !have_cdevid) { 5343 /* Client does not yet have devid, register ours. */ 5344 if (ddi_devid_register(dchild, devid) == DDI_FAILURE) 5345 SCSI_HBA_LOG((_LOG(1), self, NULL, 5346 "pathinfo %s created, " 5347 "devid register failed", 5348 mdi_pi_spathname(pchild))); 5349 else 5350 SCSI_HBA_LOG((_LOG(2), self, NULL, 5351 "pathinfo %s created with devid", 5352 mdi_pi_spathname(pchild))); 5353 } else if (have_devid && have_cdevid) { 5354 /* 5355 * We have devid and client already has devid: 5356 * they must be the same. 5357 */ 5358 if (ddi_devid_compare(cdevid, devid) != 0) { 5359 SCSI_HBA_LOG((_LOG(WARN), NULL, dchild, 5360 "mismatched devid on path %s", 5361 mdi_pi_spathname(pchild))); 5362 } 5363 } else if (!have_devid && have_cdevid) { 5364 /* 5365 * Client already has a devid, but we don't: 5366 * we should not have missing devids. 5367 */ 5368 SCSI_HBA_LOG((_LOG(WARN), NULL, dchild, 5369 "missing devid on path %s", 5370 mdi_pi_spathname(pchild))); 5371 } else if (!have_cdevid && !have_devid) { 5372 /* devid not supported */ 5373 SCSI_HBA_LOG((_LOG(2), self, NULL, 5374 "pathinfo %s created, no devid", 5375 mdi_pi_spathname(pchild))); 5376 } 5377 5378 /* 5379 * The above has registered devid for the device under 5380 * the client node. Now register it under the full pHCI 5381 * path to the device. We'll get an entry equivalent to 5382 * booting with mpxio disabled. This is needed for 5383 * telemetry during enumeration. 5384 */ 5385 if (e_devid_cache_pathinfo(pchild, devid) == DDI_SUCCESS) { 5386 SCSI_HBA_LOG((_LOG(2), NULL, dchild, 5387 "pathinfo @%s created with devid", addr)); 5388 } else { 5389 SCSI_HBA_LOG((_LOG(1), NULL, dchild, 5390 "pathinfo @%s devid cache failed", addr)); 5391 } 5392 } 5393 5394 /* free the node name and compatible information */ 5395 out: if (have_devid) 5396 ddi_devid_free(devid); 5397 if (have_cdevid) 5398 ddi_devid_free(cdevid); 5399 if (guid) 5400 ddi_devid_free_guid(guid); 5401 if (compat) 5402 scsi_hba_ident_nodename_compatible_free(nname, dname, compat); 5403 if (inq80) 5404 ddi_prop_free(inq80); 5405 if (inq83) 5406 ddi_prop_free(inq83); 5407 if (binding_set) 5408 ddi_prop_free(binding_set); 5409 5410 /* return child_type results */ 5411 if (pchild) { 5412 *dchildp = NULL; 5413 *pchildp = pchild; 5414 return (CHILD_TYPE_PATHINFO); 5415 } else if (dchild) { 5416 *dchildp = dchild; 5417 *pchildp = NULL; 5418 return (CHILD_TYPE_DEVINFO); 5419 } 5420 5421 return (CHILD_TYPE_NONE); 5422 } 5423 5424 /* 5425 * Call scsi_device_createchild and then initchild the new node. 5426 */ 5427 static dev_info_t * 5428 scsi_device_configchild(dev_info_t *self, char *addr, scsi_enum_t se, 5429 struct scsi_device *sdprobe, int *ppi) 5430 { 5431 int child_type; 5432 dev_info_t *dchild; 5433 mdi_pathinfo_t *pchild; 5434 dev_info_t *child; 5435 int rval; 5436 5437 ASSERT(self && addr && *addr && DEVI_BUSY_OWNED(self)); 5438 if (ppi) 5439 *ppi = 0; 5440 5441 child_type = scsi_device_createchild(self, addr, se, sdprobe, 5442 &dchild, &pchild); 5443 5444 /* 5445 * Prevent multiple initialized (tran_tgt_init) nodes associated with 5446 * the same @addr at the same time by calling tran_tgt_free() on the 5447 * probe node prior to promotion of the 'real' node. After the call 5448 * to scsi_hba_barrier_tran_tgt_free(), the HBA no longer has any 5449 * probe node context. 5450 */ 5451 scsi_hba_barrier_tran_tgt_free(sdprobe->sd_dev); 5452 5453 switch (child_type) { 5454 case CHILD_TYPE_NONE: 5455 child = NULL; 5456 break; 5457 5458 case CHILD_TYPE_PATHINFO: 5459 /* 5460 * Online pathinfo: Hold the path and exit the pHCI while 5461 * calling mdi_pi_online() to avoid deadlock with power 5462 * management of pHCI. 5463 */ 5464 ASSERT(MDI_PHCI(self)); 5465 mdi_hold_path(pchild); 5466 scsi_hba_devi_exit_phci(self); 5467 5468 rval = mdi_pi_online(pchild, 0); 5469 5470 scsi_hba_devi_enter_phci(self); 5471 mdi_rele_path(pchild); 5472 5473 if (rval != MDI_SUCCESS) { 5474 /* pathinfo form of "failed during tran_tgt_init" */ 5475 scsi_enumeration_failed(NULL, se, 5476 mdi_pi_spathname(pchild), "path online"); 5477 (void) mdi_pi_free(pchild, 0); 5478 return (NULL); 5479 } 5480 5481 /* 5482 * Return the path_instance of the pathinfo node. 5483 * 5484 * NOTE: We assume that sd_inq is not path-specific. 5485 */ 5486 if (ppi) 5487 *ppi = mdi_pi_get_path_instance(pchild); 5488 5489 5490 /* 5491 * Fallthrough into CHILD_TYPE_DEVINFO code to promote 5492 * the 'client' devinfo node as a dchild. 5493 */ 5494 dchild = mdi_pi_get_client(pchild); 5495 SCSI_HBA_LOG((_LOG(4), NULL, dchild, 5496 "pathinfo online successful")); 5497 /* FALLTHROUGH */ 5498 5499 case CHILD_TYPE_DEVINFO: 5500 /* 5501 * For now, we ndi_devi_online() the child because some other 5502 * parts of the IO framework, like degenerate devid code, 5503 * depend on bus_config driving nodes to DS_ATTACHED. At some 5504 * point in the future, to keep things light-weight, we would 5505 * like to change the ndi_devi_online call below to be 5506 * 5507 * if (ddi_initchild(self, dchild) != DDI_SUCCESS) 5508 * 5509 * This would promote the node so that framework code could 5510 * find the child with an @addr search, but does not incur 5511 * attach(9E) overhead for BUS_CONFIG_ALL cases where the 5512 * framework is not interested in attach of the node. 5513 * 5514 * NOTE: If the addr specified has incorrect syntax (busconfig 5515 * one of bogus /devices path) then call below can fail. 5516 */ 5517 if (ndi_devi_online(dchild, 0) != NDI_SUCCESS) { 5518 SCSI_HBA_LOG((_LOG(2), NULL, dchild, 5519 "devinfo online failed")); 5520 5521 /* failed online does not remove the node */ 5522 (void) scsi_hba_remove_node(dchild); 5523 return (NULL); 5524 } 5525 SCSI_HBA_LOG((_LOG(4), NULL, dchild, 5526 "devinfo initchild successful")); 5527 child = dchild; 5528 break; 5529 } 5530 return (child); 5531 } 5532 5533 void 5534 scsi_hba_pkt_comp(struct scsi_pkt *pkt) 5535 { 5536 scsi_hba_tran_t *tran; 5537 uint8_t *sensep; 5538 5539 ASSERT(pkt); 5540 5541 /* 5542 * Catch second call on the same packet before doing anything else. 5543 */ 5544 if (pkt->pkt_flags & FLAG_PKT_COMP_CALLED) { 5545 cmn_err( 5546 #ifdef DEBUG 5547 CE_PANIC, 5548 #else 5549 CE_WARN, 5550 #endif 5551 "%s duplicate scsi_hba_pkt_comp(9F) on same scsi_pkt(9S)", 5552 mod_containing_pc(caller())); 5553 } 5554 5555 pkt->pkt_flags |= FLAG_PKT_COMP_CALLED; 5556 5557 if (pkt->pkt_comp == NULL) 5558 return; 5559 5560 /* 5561 * For HBA drivers that implement tran_setup_pkt(9E), if we are 5562 * completing a 'consistent' mode DMA operation then we must 5563 * perform dma_sync prior to calling pkt_comp to ensure that 5564 * the target driver sees the correct data in memory. 5565 */ 5566 ASSERT((pkt->pkt_flags & FLAG_NOINTR) == 0); 5567 if (((pkt->pkt_dma_flags & DDI_DMA_CONSISTENT) && 5568 (pkt->pkt_dma_flags & DDI_DMA_READ)) && 5569 ((P_TO_TRAN(pkt)->tran_setup_pkt) != NULL)) { 5570 scsi_sync_pkt(pkt); 5571 } 5572 5573 /* 5574 * If the HBA driver is using SCSAv3 scsi_hba_tgtmap_create enumeration 5575 * then we detect the special ASC/ASCQ completion codes that indicate 5576 * that the lun configuration of a target has changed. Since we need to 5577 * be determine scsi_device given scsi_address enbedded in 5578 * scsi_pkt (via scsi_address_device(9F)), we also require use of 5579 * SCSI_HBA_ADDR_COMPLEX. 5580 */ 5581 tran = pkt->pkt_address.a_hba_tran; 5582 ASSERT(tran); 5583 if ((tran->tran_tgtmap == NULL) || 5584 !(tran->tran_hba_flags & SCSI_HBA_ADDR_COMPLEX)) 5585 goto comp; /* not using tgtmap */ 5586 5587 /* 5588 * Check for lun-change notification and queue the scsi_pkt for 5589 * lunchg1 processing. The 'pkt_comp' call to the target driver 5590 * is part of lunchg1 processing. 5591 */ 5592 if ((pkt->pkt_reason == CMD_CMPLT) && 5593 (((*pkt->pkt_scbp) & STATUS_MASK) == STATUS_CHECK) && 5594 (pkt->pkt_state & STATE_ARQ_DONE)) { 5595 sensep = (uint8_t *)&(((struct scsi_arq_status *)(uintptr_t) 5596 (pkt->pkt_scbp))->sts_sensedata); 5597 if (((scsi_sense_key(sensep) == KEY_UNIT_ATTENTION) && 5598 (scsi_sense_asc(sensep) == 0x3f) && 5599 (scsi_sense_ascq(sensep) == 0x0e)) || 5600 5601 ((scsi_sense_key(sensep) == KEY_UNIT_ATTENTION) && 5602 (scsi_sense_asc(sensep) == 0x25) && 5603 (scsi_sense_ascq(sensep) == 0x00))) { 5604 /* 5605 * The host adaptor is done with the packet, we use 5606 * pkt_stmp stage-temporary to link the packet for 5607 * lunchg1 processing. 5608 * 5609 * NOTE: pkt_ha_private is not available since its use 5610 * extends to tran_teardown_pkt. 5611 */ 5612 mutex_enter(&scsi_lunchg1_mutex); 5613 pkt->pkt_stmp = scsi_lunchg1_list; 5614 scsi_lunchg1_list = pkt; 5615 if (pkt->pkt_stmp == NULL) 5616 cv_signal(&scsi_lunchg1_cv); 5617 mutex_exit(&scsi_lunchg1_mutex); 5618 return; 5619 } 5620 } 5621 5622 comp: (*pkt->pkt_comp)(pkt); 5623 } 5624 5625 /* 5626 * return 1 if the specified node is a barrier/probe node 5627 */ 5628 static int 5629 scsi_hba_devi_is_barrier(dev_info_t *probe) 5630 { 5631 if (probe && (strcmp(ddi_node_name(probe), "probe") == 0)) 5632 return (1); 5633 return (0); 5634 } 5635 5636 /* 5637 * A host adapter driver is easier to write if we prevent multiple initialized 5638 * (tran_tgt_init) scsi_device structures to the same unit-address at the same 5639 * time. We prevent this from occurring all the time during the barrier/probe 5640 * node to real child hand-off by calling scsi_hba_barrier_tran_tgt_free 5641 * on the probe node prior to ddi_inichild of the 'real' node. As part of 5642 * this early tran_tgt_free implementation, we must also call this function 5643 * as we put a probe node on the scsi_hba_barrier_list. 5644 */ 5645 static void 5646 scsi_hba_barrier_tran_tgt_free(dev_info_t *probe) 5647 { 5648 struct scsi_device *sdprobe; 5649 dev_info_t *self; 5650 scsi_hba_tran_t *tran; 5651 5652 ASSERT(probe && scsi_hba_devi_is_barrier(probe)); 5653 5654 /* Return if we never called tran_tgt_init(9E). */ 5655 if (i_ddi_node_state(probe) < DS_INITIALIZED) 5656 return; 5657 5658 sdprobe = ddi_get_driver_private(probe); 5659 self = ddi_get_parent(probe); 5660 ASSERT(sdprobe && self); 5661 tran = ddi_get_driver_private(self); 5662 ASSERT(tran); 5663 5664 if (tran->tran_tgt_free) { 5665 /* 5666 * To correctly support TRAN_CLONE, we need to use the same 5667 * cloned scsi_hba_tran(9S) structure for both tran_tgt_init(9E) 5668 * and tran_tgt_free(9E). 5669 */ 5670 if (tran->tran_hba_flags & SCSI_HBA_TRAN_CLONE) 5671 tran = sdprobe->sd_address.a_hba_tran; 5672 5673 if (!sdprobe->sd_tran_tgt_free_done) { 5674 SCSI_HBA_LOG((_LOG(4), NULL, probe, 5675 "tran_tgt_free EARLY")); 5676 (*tran->tran_tgt_free) (self, probe, tran, sdprobe); 5677 sdprobe->sd_tran_tgt_free_done = 1; 5678 } else { 5679 SCSI_HBA_LOG((_LOG(4), NULL, probe, 5680 "tran_tgt_free EARLY already done")); 5681 } 5682 } 5683 } 5684 5685 /* 5686 * Add an entry to the list of barrier nodes to be asynchronously deleted by 5687 * the scsi_hba_barrier_daemon after the specified timeout. Nodes on 5688 * the barrier list are used to implement the bus_config probe cache 5689 * of non-existent devices. The nodes are at DS_INITIALIZED, so their 5690 * @addr is established for searching. Since devi_ref of a DS_INITIALIZED 5691 * node will *not* prevent demotion, demotion is prevented by setting 5692 * sd_uninit_prevent. Devinfo snapshots attempt to attach probe cache 5693 * nodes, and on failure attempt to demote the node (without the participation 5694 * of bus_unconfig) to DS_BOUND - this demotion is prevented via 5695 * sd_uninit_prevent causing any attempted DDI_CTLOPS_UNINITCHILD to fail. 5696 * Probe nodes are bound to nulldriver. The list is sorted by 5697 * expiration time. 5698 * 5699 * NOTE: If we drove a probe node to DS_ATTACHED, we could use ndi_hold_devi() 5700 * to prevent demotion (instead of sd_uninit_prevent). 5701 */ 5702 static void 5703 scsi_hba_barrier_add(dev_info_t *probe, int seconds) 5704 { 5705 struct scsi_hba_barrier *nb; 5706 struct scsi_hba_barrier *b; 5707 struct scsi_hba_barrier **bp; 5708 clock_t endtime; 5709 5710 ASSERT(scsi_hba_devi_is_barrier(probe)); 5711 5712 /* HBA is no longer responsible for nodes on the barrier list. */ 5713 scsi_hba_barrier_tran_tgt_free(probe); 5714 nb = kmem_alloc(sizeof (struct scsi_hba_barrier), KM_SLEEP); 5715 mutex_enter(&scsi_hba_barrier_mutex); 5716 endtime = ddi_get_lbolt() + drv_usectohz(seconds * MICROSEC); 5717 for (bp = &scsi_hba_barrier_list; (b = *bp) != NULL; 5718 bp = &b->barrier_next) 5719 if (b->barrier_endtime > endtime) 5720 break; 5721 nb->barrier_next = *bp; 5722 nb->barrier_endtime = endtime; 5723 nb->barrier_probe = probe; 5724 *bp = nb; 5725 if (bp == &scsi_hba_barrier_list) 5726 cv_signal(&scsi_hba_barrier_cv); 5727 mutex_exit(&scsi_hba_barrier_mutex); 5728 } 5729 5730 /* 5731 * Attempt to remove devinfo node node, return 1 if removed. We 5732 * don't try to remove barrier nodes that have sd_uninit_prevent set 5733 * (even though they should fail device_uninitchild). 5734 */ 5735 static int 5736 scsi_hba_remove_node(dev_info_t *child) 5737 { 5738 dev_info_t *self = ddi_get_parent(child); 5739 struct scsi_device *sd; 5740 boolean_t enteredv; 5741 int remove = 1; 5742 int ret = 0; 5743 char na[SCSI_MAXNAMELEN]; 5744 5745 scsi_hba_devi_enter(self, &enteredv); 5746 5747 /* Honor sd_uninit_prevent on barrier nodes */ 5748 if (scsi_hba_devi_is_barrier(child)) { 5749 sd = ddi_get_driver_private(child); 5750 if (sd && sd->sd_uninit_prevent) 5751 remove = 0; 5752 } 5753 5754 if (remove) { 5755 (void) ddi_deviname(child, na); 5756 if (ddi_remove_child(child, 0) != DDI_SUCCESS) { 5757 SCSI_HBA_LOG((_LOG(2), NULL, child, 5758 "remove_node failed")); 5759 } else { 5760 child = NULL; /* child is gone */ 5761 SCSI_HBA_LOG((_LOG(4), self, NULL, 5762 "remove_node removed %s", *na ? &na[1] : na)); 5763 ret = 1; 5764 } 5765 } else { 5766 SCSI_HBA_LOG((_LOG(4), NULL, child, "remove_node prevented")); 5767 } 5768 scsi_hba_devi_exit(self, enteredv); 5769 return (ret); 5770 } 5771 5772 /* 5773 * The asynchronous barrier deletion daemon. Waits for a barrier timeout 5774 * to expire, then deletes the barrier (removes it as a child). 5775 */ 5776 /*ARGSUSED*/ 5777 static void 5778 scsi_hba_barrier_daemon(void *arg) 5779 { 5780 struct scsi_hba_barrier *b; 5781 dev_info_t *probe; 5782 callb_cpr_t cprinfo; 5783 boolean_t enteredv; 5784 dev_info_t *self; 5785 5786 CALLB_CPR_INIT(&cprinfo, &scsi_hba_barrier_mutex, 5787 callb_generic_cpr, "scsi_hba_barrier_daemon"); 5788 again: mutex_enter(&scsi_hba_barrier_mutex); 5789 for (;;) { 5790 b = scsi_hba_barrier_list; 5791 if (b == NULL) { 5792 /* all barriers expired, wait for barrier_add */ 5793 CALLB_CPR_SAFE_BEGIN(&cprinfo); 5794 (void) cv_wait(&scsi_hba_barrier_cv, 5795 &scsi_hba_barrier_mutex); 5796 CALLB_CPR_SAFE_END(&cprinfo, &scsi_hba_barrier_mutex); 5797 } else { 5798 if (ddi_get_lbolt() >= b->barrier_endtime) { 5799 /* 5800 * Drop and retry if ordering issue. Do this 5801 * before calling scsi_hba_remove_node() and 5802 * deadlocking. 5803 */ 5804 probe = b->barrier_probe; 5805 self = ddi_get_parent(probe); 5806 if (scsi_hba_devi_tryenter(self, 5807 &enteredv) == 0) { 5808 delay: mutex_exit(&scsi_hba_barrier_mutex); 5809 delay_random(5); 5810 goto again; 5811 } 5812 5813 /* process expired barrier */ 5814 if (!scsi_hba_remove_node(probe)) { 5815 /* remove failed, delay and retry */ 5816 SCSI_HBA_LOG((_LOG(4), NULL, probe, 5817 "delay expire")); 5818 scsi_hba_devi_exit(self, enteredv); 5819 goto delay; 5820 } 5821 scsi_hba_barrier_list = b->barrier_next; 5822 kmem_free(b, sizeof (struct scsi_hba_barrier)); 5823 scsi_hba_devi_exit(self, enteredv); 5824 } else { 5825 /* establish timeout for next barrier expire */ 5826 (void) cv_timedwait(&scsi_hba_barrier_cv, 5827 &scsi_hba_barrier_mutex, 5828 b->barrier_endtime); 5829 } 5830 } 5831 } 5832 } 5833 5834 /* 5835 * Remove all barriers associated with the specified HBA. This is called 5836 * from from the bus_unconfig implementation to remove probe nodes associated 5837 * with the specified HBA (self) so that probe nodes that have not expired 5838 * will not prevent DR of the HBA. 5839 */ 5840 static void 5841 scsi_hba_barrier_purge(dev_info_t *self) 5842 { 5843 struct scsi_hba_barrier **bp; 5844 struct scsi_hba_barrier *b; 5845 5846 mutex_enter(&scsi_hba_barrier_mutex); 5847 for (bp = &scsi_hba_barrier_list; (b = *bp) != NULL; ) { 5848 if (ddi_get_parent(b->barrier_probe) == self) { 5849 if (scsi_hba_remove_node(b->barrier_probe)) { 5850 *bp = b->barrier_next; 5851 kmem_free(b, sizeof (struct scsi_hba_barrier)); 5852 } else { 5853 SCSI_HBA_LOG((_LOG(4), NULL, b->barrier_probe, 5854 "skip purge")); 5855 } 5856 } else 5857 bp = &b->barrier_next; 5858 } 5859 5860 mutex_exit(&scsi_hba_barrier_mutex); 5861 } 5862 5863 /* 5864 * LUN-change processing daemons: processing occurs in two stages: 5865 * 5866 * Stage 1: Daemon waits for a lunchg1 queued scsi_pkt, dequeues the pkt, 5867 * forms the path, completes the scsi_pkt (pkt_comp), and 5868 * queues the path for stage 2 processing. The use of stage 1 5869 * avoids issues related to memory allocation in interrupt context 5870 * (scsi_hba_pkt_comp()). We delay the pkt_comp completion until 5871 * after lunchg1 processing forms the path for stage 2 - this is 5872 * done to prevent the target driver from detaching until the 5873 * path formation is complete (driver with outstanding commands 5874 * should not detach). 5875 * 5876 * Stage 2: Daemon waits for a lunchg2 queued request, dequeues the 5877 * request, and opens the path using ldi_open_by_name(). The 5878 * path opened uses a special "@taddr,*" unit address that will 5879 * trigger lun enumeration in scsi_hba_bus_configone(). We 5880 * trigger lun enumeration in stage 2 to avoid problems when 5881 * initial ASC/ASCQ trigger occurs during discovery. 5882 */ 5883 /*ARGSUSED*/ 5884 static void 5885 scsi_lunchg1_daemon(void *arg) 5886 { 5887 callb_cpr_t cprinfo; 5888 struct scsi_pkt *pkt; 5889 scsi_hba_tran_t *tran; 5890 dev_info_t *self; 5891 struct scsi_device *sd; 5892 char *ua, *p; 5893 char taddr[SCSI_MAXNAMELEN]; 5894 char path[MAXPATHLEN]; 5895 struct scsi_lunchg2 *lunchg2; 5896 5897 CALLB_CPR_INIT(&cprinfo, &scsi_lunchg1_mutex, 5898 callb_generic_cpr, "scsi_lunchg1_daemon"); 5899 mutex_enter(&scsi_lunchg1_mutex); 5900 for (;;) { 5901 pkt = scsi_lunchg1_list; 5902 if (pkt == NULL) { 5903 /* All lunchg1 processing requests serviced, wait. */ 5904 CALLB_CPR_SAFE_BEGIN(&cprinfo); 5905 (void) cv_wait(&scsi_lunchg1_cv, 5906 &scsi_lunchg1_mutex); 5907 CALLB_CPR_SAFE_END(&cprinfo, &scsi_lunchg1_mutex); 5908 continue; 5909 } 5910 5911 /* Unlink and perform lunchg1 processing on pkt. */ 5912 scsi_lunchg1_list = pkt->pkt_stmp; 5913 5914 /* Determine initiator port (self) from the pkt_address. */ 5915 tran = pkt->pkt_address.a_hba_tran; 5916 ASSERT(tran && tran->tran_tgtmap && tran->tran_iport_dip); 5917 self = tran->tran_iport_dip; 5918 5919 /* 5920 * Determine scsi_devie from pkt_address (depends on 5921 * SCSI_HBA_ADDR_COMPLEX). 5922 */ 5923 sd = scsi_address_device(&(pkt->pkt_address)); 5924 ASSERT(sd); 5925 if (sd == NULL) { 5926 (*pkt->pkt_comp)(pkt); 5927 continue; 5928 } 5929 5930 /* Determine unit-address from scsi_device. */ 5931 ua = scsi_device_unit_address(sd); 5932 5933 /* Extract taddr from the unit-address. */ 5934 for (p = taddr; (*ua != ',') && (*ua != '\0'); ) 5935 *p++ = *ua++; 5936 *p = '\0'; /* NULL terminate taddr */ 5937 5938 /* 5939 * Form path using special "@taddr,*" notation to trigger 5940 * lun enumeration. 5941 */ 5942 (void) ddi_pathname(self, path); 5943 (void) strlcat(path, "/luns@", sizeof (path)); 5944 (void) strlcat(path, taddr, sizeof (path)); 5945 (void) strlcat(path, ",*", sizeof (path)); 5946 5947 /* 5948 * Now that we have the path, complete the pkt that 5949 * triggered lunchg1 processing. 5950 */ 5951 (*pkt->pkt_comp)(pkt); 5952 5953 /* Allocate element for stage2 processing queue. */ 5954 lunchg2 = kmem_alloc(sizeof (*lunchg2), KM_SLEEP); 5955 lunchg2->lunchg2_path = strdup(path); 5956 5957 /* Queue and dispatch to stage 2. */ 5958 SCSI_HBA_LOG((_LOG(2), self, NULL, 5959 "lunchg stage1: queue %s", lunchg2->lunchg2_path)); 5960 mutex_enter(&scsi_lunchg2_mutex); 5961 lunchg2->lunchg2_next = scsi_lunchg2_list; 5962 scsi_lunchg2_list = lunchg2; 5963 if (lunchg2->lunchg2_next == NULL) 5964 cv_signal(&scsi_lunchg2_cv); 5965 mutex_exit(&scsi_lunchg2_mutex); 5966 } 5967 } 5968 5969 /*ARGSUSED*/ 5970 static void 5971 scsi_lunchg2_daemon(void *arg) 5972 { 5973 callb_cpr_t cprinfo; 5974 struct scsi_lunchg2 *lunchg2; 5975 ldi_ident_t li; 5976 ldi_handle_t lh; 5977 5978 CALLB_CPR_INIT(&cprinfo, &scsi_lunchg2_mutex, 5979 callb_generic_cpr, "scsi_lunchg2_daemon"); 5980 5981 li = ldi_ident_from_anon(); 5982 mutex_enter(&scsi_lunchg2_mutex); 5983 for (;;) { 5984 lunchg2 = scsi_lunchg2_list; 5985 if (lunchg2 == NULL) { 5986 /* All lunchg2 processing requests serviced, wait. */ 5987 CALLB_CPR_SAFE_BEGIN(&cprinfo); 5988 (void) cv_wait(&scsi_lunchg2_cv, 5989 &scsi_lunchg2_mutex); 5990 CALLB_CPR_SAFE_END(&cprinfo, &scsi_lunchg2_mutex); 5991 continue; 5992 } 5993 5994 /* Unlink and perform lunchg2 processing on pkt. */ 5995 scsi_lunchg2_list = lunchg2->lunchg2_next; 5996 5997 /* 5998 * Open and close the path to trigger lun enumeration. We 5999 * don't expect the open to succeed, but we do expect code in 6000 * scsi_hba_bus_configone() to trigger lun enumeration. 6001 */ 6002 SCSI_HBA_LOG((_LOG(2), NULL, NULL, 6003 "lunchg stage2: open %s", lunchg2->lunchg2_path)); 6004 if (ldi_open_by_name(lunchg2->lunchg2_path, 6005 FREAD, kcred, &lh, li) == 0) 6006 (void) ldi_close(lh, FREAD, kcred); 6007 6008 /* Free path and linked element. */ 6009 strfree(lunchg2->lunchg2_path); 6010 kmem_free(lunchg2, sizeof (*lunchg2)); 6011 } 6012 } 6013 6014 /* 6015 * Enumerate a child at the specified @addr. If a device exists @addr then 6016 * ensure that we have the appropriately named devinfo node for it. Name is 6017 * NULL in the bus_config_all case. This routine has no knowledge of the 6018 * format of an @addr string or associated addressing properties. 6019 * 6020 * The caller must guarantee that there is an open scsi_hba_devi_enter on the 6021 * parent. We return the scsi_device structure for the child device. This 6022 * scsi_device structure is valid until the caller scsi_hba_devi_exit the 6023 * parent. The caller can add do ndi_hold_devi of the child prior to the 6024 * scsi_hba_devi_exit to extend the validity of the child. 6025 * 6026 * In some cases the returned scsi_device structure may be used to drive 6027 * additional SCMD_REPORT_LUNS operations by bus_config_all callers. 6028 * 6029 * The first operation performed is to see if there is a dynamic SID nodes 6030 * already attached at the specified "name@addr". This is the fastpath 6031 * case for resolving a reference to a node that has already been created. 6032 * All other references are serialized for a given @addr prior to probing 6033 * to determine the type of device, if any, at the specified @addr. 6034 * If no device is present then NDI_FAILURE is returned. The fact that a 6035 * device does not exist may be determined via the barrier/probe cache, 6036 * minimizing the probes of non-existent devices. 6037 * 6038 * When there is a device present the dynamic SID node is created based on 6039 * the device found. If a driver.conf node exists for the same @addr it 6040 * will either merge into the dynamic SID node (if the SID node bound to 6041 * that driver), or exist independently. To prevent the actions of one driver 6042 * causing side effects in another, code prevents multiple SID nodes from 6043 * binding to the same "@addr" at the same time. There is autodetach code 6044 * to allow one device to be replaced with another at the same @addr for 6045 * slot addressed SCSI bus implementations (SPI). For compatibility with 6046 * legacy driver.conf behavior, the code does not prevent multiple driver.conf 6047 * nodes from attaching to the same @addr at the same time. 6048 * 6049 * This routine may have the side effect of creating nodes for devices other 6050 * than the one being sought. It is possible that there is a different type of 6051 * target device at that target/lun address than we were asking for. In that 6052 * It is the caller's responsibility to determine whether the device we found, 6053 * if any, at the specified address, is the one it really wanted. 6054 */ 6055 static struct scsi_device * 6056 scsi_device_config(dev_info_t *self, char *name, char *addr, scsi_enum_t se, 6057 boolean_t *enteredvp, int *ppi) 6058 { 6059 dev_info_t *child = NULL; 6060 dev_info_t *probe = NULL; 6061 struct scsi_device *sdchild; 6062 struct scsi_device *sdprobe; 6063 dev_info_t *dsearch; 6064 mdi_pathinfo_t *psearch; 6065 major_t major; 6066 int sp; 6067 int pi = 0; 6068 int wait_msg = scsi_hba_wait_msg; 6069 int chg; 6070 6071 ASSERT(self && addr && DEVI_BUSY_OWNED(self)); 6072 6073 SCSI_HBA_LOG((_LOG(4), self, NULL, "%s@%s wanted", 6074 name ? name : "", addr)); 6075 6076 /* playing with "probe" node name is dangerous */ 6077 if (name && (strcmp(name, "probe") == 0)) 6078 return (NULL); 6079 6080 /* 6081 * NOTE: use 'goto done;' or 'goto fail;'. There should only be one 6082 * 'return' statement from here to the end of the function - the one 6083 * on the last line of the function. 6084 */ 6085 6086 /* 6087 * Fastpath: search to see if we are requesting a named SID node that 6088 * already exists (we already created) - probe node does not count. 6089 * scsi_findchild() does not hold the returned devinfo node, but 6090 * this is OK since the caller has a scsi_hba_devi_enter on the 6091 * attached parent HBA (self). The caller is responsible for attaching 6092 * and placing a hold on the child (directly via ndi_hold_devi or 6093 * indirectly via ndi_busop_bus_config) before doing an 6094 * scsi_hba_devi_exit on the parent. 6095 * 6096 * NOTE: This fastpath prevents detecting a driver binding change 6097 * (autodetach) if the same nodename is used for old and new binding. 6098 */ 6099 /* first call is with init set */ 6100 (void) scsi_findchild(self, name, addr, 1, &dsearch, NULL, &pi); 6101 if (dsearch && scsi_hba_dev_is_sid(dsearch) && 6102 !scsi_hba_devi_is_barrier(dsearch)) { 6103 SCSI_HBA_LOG((_LOG(4), NULL, dsearch, 6104 "%s@%s devinfo fastpath", name ? name : "", addr)); 6105 child = dsearch; 6106 goto done; 6107 } 6108 6109 /* 6110 * Create a barrier devinfo node used to "probe" the device with. We 6111 * need to drive this node to DS_INITIALIZED so that the 6112 * DDI_CTLOPS_INITCHILD has occurred, bringing the SCSA transport to 6113 * a state useable state for issuing our "probe" commands. We establish 6114 * this barrier node with a node name of "probe" and compatible 6115 * property of "scsiprobe". The compatible property must be associated 6116 * in /etc/driver_aliases with a scsi target driver available in the 6117 * root file system (sd). 6118 * 6119 * The "probe" that we perform on the barrier node, after it is 6120 * DS_INITIALIZED, is used to find the information needed to create a 6121 * dynamic devinfo (SID) node. This "probe" is separate from the 6122 * probe(9E) call associated with the transition of a node from 6123 * DS_INITIALIZED to DS_PROBED. The probe(9E) call that eventually 6124 * occurs against the created SID node should find ddi_dev_is_sid and 6125 * just return DDI_PROBE_DONTCARE. 6126 * 6127 * Trying to avoid the use of a barrier node is not a good idea 6128 * because we may have an HBA driver that uses generic bus_config 6129 * (this code) but implements its own DDI_CTLOPS_INITCHILD with side 6130 * effects that we can't duplicate (such as the ATA nexus driver). 6131 * 6132 * The probe/barrier node plays an integral part of the locking scheme. 6133 * The objective is to single thread probes of the same device (same 6134 * @addr) while allowing parallelism for probes of different devices 6135 * with the same parent. At this point we are serialized on our self. 6136 * For parallelism we will need to release our self. Prior to release 6137 * we construct a barrier for probes of the same device to serialize 6138 * against. The "probe@addr" node acts as this barrier. An entering 6139 * thread must wait until the probe node does not exist - it can then 6140 * create and link the probe node - dropping the HBA (self) lock after 6141 * the node is linked and visible (after ddi_initchild). A side effect 6142 * of this is that transports should not "go over the wire" (i.e. do 6143 * things that incur significant delays) until after tran_target_init. 6144 * This means that the first "over the wire" operation should occur 6145 * at tran_target_probe time - when things are running in parallel 6146 * again. 6147 * 6148 * If the probe node exists then another probe with the same @addr is 6149 * in progress, we must wait until there is no probe in progress 6150 * before proceeding, and when we proceed we must continue to hold the 6151 * HBA (self) until we have linked a new probe node as a barrier. 6152 * 6153 * When a device is found to *not* exist, its probe/barrier node may be 6154 * marked with DEVICE_REMOVED with node deletion scheduled for some 6155 * future time (seconds). This asynchronous deletion allows the 6156 * framework to detect repeated requests to the same non-existent 6157 * device and avoid overhead associated with contacting a non-existent 6158 * device again and again. 6159 */ 6160 for (;;) { 6161 /* 6162 * Search for probe node - they should only exist as devinfo 6163 * nodes. 6164 */ 6165 (void) scsi_findchild(self, "probe", addr, 6166 0, &probe, &psearch, NULL); 6167 if (probe == NULL) { 6168 if (psearch) 6169 SCSI_HBA_LOG((_LOG(2), self, 6170 mdi_pi_get_client(psearch), 6171 "???? @%s 'probe' search found " 6172 "pathinfo: %p", addr, (void *)psearch)); 6173 break; 6174 } 6175 6176 /* 6177 * The barrier node may cache the non-existence of a device 6178 * by leaving the barrier node in place (with 6179 * DEVI_DEVICE_REMOVED flag set ) for some amount of time after 6180 * the failure of a probe. This flag is used to fail 6181 * additional probes until the barrier probe node is deleted, 6182 * which will occur from a timeout some time after a failed 6183 * probe. The failed probe will use DEVI_SET_DEVICE_REMOVED 6184 * and schedule probe node deletion from a timeout. The callers 6185 * scsi_hba_devi_exit on the way out of the first failure will 6186 * do the cv_broadcast associated with the cv_wait below - this 6187 * handles threads that wait prior to DEVI_DEVICE_REMOVED being 6188 * set. 6189 */ 6190 if (DEVI_IS_DEVICE_REMOVED(probe)) { 6191 SCSI_HBA_LOG((_LOG(3), NULL, probe, 6192 "detected probe DEVICE_REMOVED")); 6193 probe = NULL; /* deletion already scheduled */ 6194 goto fail; 6195 } 6196 6197 /* 6198 * Drop the lock on the HBA (self) and wait until the probe in 6199 * progress has completed. A changes in the sibling list from 6200 * removing the probe node will cause cv_wait to return 6201 * (scsi_hba_devi_exit does the cv_broadcast). 6202 */ 6203 if (wait_msg) { 6204 wait_msg--; 6205 SCSI_HBA_LOG((_LOG(2), NULL, probe, 6206 "exists, probe already in progress: %s", wait_msg ? 6207 "waiting..." : "last msg, but still waiting...")); 6208 } 6209 6210 /* 6211 * NOTE: we could avoid rare case of one second delay by 6212 * implementing scsi_hba_devi_exit_and_wait based on 6213 * ndi/mdi_devi_exit_and_wait (and consider switching devcfg.c 6214 * code to use these ndi/mdi interfaces too). 6215 */ 6216 scsi_hba_devi_exit(self, *enteredvp); 6217 mutex_enter(&DEVI(self)->devi_lock); 6218 (void) cv_timedwait(&DEVI(self)->devi_cv, 6219 &DEVI(self)->devi_lock, 6220 ddi_get_lbolt() + drv_usectohz(MICROSEC)); 6221 mutex_exit(&DEVI(self)->devi_lock); 6222 scsi_hba_devi_enter(self, enteredvp); 6223 } 6224 ASSERT(probe == NULL); 6225 6226 /* 6227 * Search to see if we are requesting a SID node that already exists. 6228 * We hold the HBA (self) and there is not another probe in progress at 6229 * the same @addr. scsi_findchild() does not hold the returned 6230 * devinfo node but this is OK since we hold the HBA (self). 6231 */ 6232 if (name) { 6233 (void) scsi_findchild(self, name, addr, 1, &dsearch, NULL, &pi); 6234 if (dsearch && scsi_hba_dev_is_sid(dsearch)) { 6235 SCSI_HBA_LOG((_LOG(4), NULL, dsearch, 6236 "%s@%s probe devinfo fastpath", 6237 name ? name : "", addr)); 6238 child = dsearch; 6239 goto done; 6240 } 6241 } 6242 6243 /* 6244 * We are looking for a SID node that does not exist or a driver.conf 6245 * node. 6246 * 6247 * To avoid probe side effects, before we probe the device at the 6248 * specified address we need to check to see if there is already an 6249 * initialized child "@addr". 6250 * 6251 * o If we find an initialized SID child and name is NULL or matches 6252 * the name or the name of the attached driver then we return the 6253 * existing node. 6254 * 6255 * o If we find a non-matching SID node, we will attempt to autodetach 6256 * and remove the node in preference to our new node. 6257 * 6258 * o If SID node found does not match and can't be autodetached, we 6259 * fail: we only allow one SID node at an address. 6260 * 6261 * NOTE: This code depends on SID nodes showing up prior to 6262 * driver.conf nodes in the sibling list. 6263 */ 6264 for (;;) { 6265 /* first NULL name call is with init set */ 6266 (void) scsi_findchild(self, NULL, addr, 1, &dsearch, NULL, &pi); 6267 if (dsearch == NULL) 6268 break; 6269 ASSERT(!scsi_hba_devi_is_barrier(dsearch)); 6270 6271 /* 6272 * To detect changes in driver binding that should attempt 6273 * autodetach we determine the major number of the driver 6274 * that should currently be associated with the device based 6275 * on the compatible property. 6276 */ 6277 major = DDI_MAJOR_T_NONE; 6278 if (scsi_hba_dev_is_sid(dsearch)) 6279 major = ddi_compatible_driver_major(dsearch, NULL); 6280 if ((major == DDI_MAJOR_T_NONE) && (name == NULL)) 6281 major = ddi_driver_major(dsearch); 6282 6283 if ((scsi_hba_dev_is_sid(dsearch) || 6284 (i_ddi_node_state(dsearch) >= DS_INITIALIZED)) && 6285 ((name == NULL) || 6286 (strcmp(ddi_node_name(dsearch), name) == 0) || 6287 (strcmp(ddi_driver_name(dsearch), name) == 0)) && 6288 (major == ddi_driver_major(dsearch))) { 6289 SCSI_HBA_LOG((_LOG(3), NULL, dsearch, 6290 "already attached @addr")); 6291 child = dsearch; 6292 goto done; 6293 } 6294 6295 if (!scsi_hba_dev_is_sid(dsearch)) 6296 break; /* driver.conf node */ 6297 6298 /* 6299 * Implement autodetach of SID node for situations like a 6300 * previously "scsinodev" LUN0 coming into existence (or a 6301 * disk/tape on an SPI transport at same addr but never both 6302 * powered on at the same time). Try to autodetach the existing 6303 * SID node @addr. If that works, search again - otherwise fail. 6304 */ 6305 SCSI_HBA_LOG((_LOG(2), NULL, dsearch, 6306 "looking for %s@%s: SID @addr exists, autodetach", 6307 name ? name : "", addr)); 6308 if (!scsi_hba_remove_node(dsearch)) { 6309 SCSI_HBA_LOG((_LOG(2), NULL, dsearch, 6310 "autodetach @%s failed: fail %s@%s", 6311 addr, name ? name : "", addr)); 6312 goto fail; 6313 } 6314 SCSI_HBA_LOG((_LOG(2), self, NULL, "autodetach @%s OK", addr)); 6315 } 6316 6317 /* 6318 * We will be creating a new SID node, allocate probe node 6319 * used to find out information about the device located @addr. 6320 * The probe node also acts as a barrier against additional 6321 * configuration at the same address, and in the case of non-existent 6322 * devices it will (for some amount of time) avoid re-learning that 6323 * the device does not exist on every reference. Once the probe 6324 * node is DS_LINKED we can drop the HBA (self). 6325 * 6326 * The probe node is allocated as a hidden node so that it does not 6327 * show up in devinfo snapshots. 6328 */ 6329 ndi_devi_alloc_sleep(self, "probe", 6330 (se == SE_HP) ? DEVI_SID_HP_HIDDEN_NODEID : DEVI_SID_HIDDEN_NODEID, 6331 &probe); 6332 ASSERT(probe); 6333 ndi_flavor_set(probe, SCSA_FLAVOR_SCSI_DEVICE); 6334 6335 /* 6336 * Decorate the probe node with the property representation of @addr 6337 * unit-address string prior to initchild so that initchild can 6338 * construct the name of the node from properties and tran_tgt_init 6339 * implementation can determine what LUN is being referenced. 6340 * 6341 * If the addr specified has incorrect syntax (busconfig one of bogus 6342 * /devices path) then scsi_hba_ua_set can fail. If the address 6343 * is not understood by the SCSA HBA driver then this operation will 6344 * work, but tran_tgt_init may still fail (for example the HBA 6345 * driver may not support secondary functions). 6346 */ 6347 if (scsi_hba_ua_set(addr, probe, NULL) == 0) { 6348 SCSI_HBA_LOG((_LOG(2), NULL, probe, 6349 "@%s failed scsi_hba_ua_set", addr)); 6350 goto fail; 6351 } 6352 6353 /* 6354 * Set the class property to "scsi". This is sufficient to distinguish 6355 * the node for HBAs that have multiple classes of children (like uata 6356 * - which has "dada" class for ATA children and "scsi" class for 6357 * ATAPI children) and may not use our scsi_busctl_initchild() 6358 * implementation. We also add a "compatible" property of "scsiprobe" 6359 * to select the probe driver. 6360 */ 6361 if ((ndi_prop_update_string(DDI_DEV_T_NONE, probe, 6362 "class", "scsi") != DDI_PROP_SUCCESS) || 6363 (ndi_prop_update_string_array(DDI_DEV_T_NONE, probe, 6364 "compatible", &compatible_probe, 1) != DDI_PROP_SUCCESS)) { 6365 SCSI_HBA_LOG((_LOG(1), NULL, probe, 6366 "@%s failed node decoration", addr)); 6367 goto fail; 6368 } 6369 6370 /* 6371 * Promote probe node to DS_INITIALIZED so that transport can be used 6372 * for scsi_probe. After this the node is linked and visible as a 6373 * barrier for serialization of other @addr operations. 6374 * 6375 * NOTE: If we attached the probe node, we could get rid of 6376 * uninit_prevent. 6377 */ 6378 if (ddi_initchild(self, probe) != DDI_SUCCESS) { 6379 SCSI_HBA_LOG((_LOG(2), NULL, probe, 6380 "@%s failed initchild", addr)); 6381 6382 /* probe node will be removed in fail exit path */ 6383 goto fail; 6384 } 6385 6386 /* get the scsi_device structure of the probe node */ 6387 sdprobe = ddi_get_driver_private(probe); 6388 ASSERT(sdprobe); 6389 6390 /* 6391 * Do scsi_probe. The probe node is linked and visible as a barrier. 6392 * We prevent uninitialization of the probe node and drop our HBA (self) 6393 * while we run scsi_probe() of this "@addr". This allows the framework 6394 * to support multiple scsi_probes for different devices attached to 6395 * the same HBA (self) in parallel. We prevent node demotion of the 6396 * probe node from DS_INITIALIZED by setting sd_uninit_prevent. The 6397 * probe node can not be successfully demoted below DS_INITIALIZED 6398 * (scsi_busctl_uninitchild will fail) until we zero sd_uninit_prevent 6399 * as we are freeing the node via scsi_hba_remove_node(probe). 6400 */ 6401 sdprobe->sd_uninit_prevent++; 6402 scsi_hba_devi_exit(self, *enteredvp); 6403 sp = scsi_probe(sdprobe, SLEEP_FUNC); 6404 6405 /* Introduce a small delay here to increase parallelism. */ 6406 delay_random(5); 6407 6408 if (sp == SCSIPROBE_EXISTS) { 6409 /* 6410 * For a device that exists, while still running in parallel, 6411 * also get identity information from device. This is done 6412 * separate from scsi_probe/tran_tgt_probe/scsi_hba_probe 6413 * since the probe code path may still be used for HBAs 6414 * that don't use common bus_config services (we don't want 6415 * to expose that code path to a behavior change). This 6416 * operation is called 'identity' to avoid confusion with 6417 * deprecated identify(9E). 6418 * 6419 * Future: We may eventually want to allow HBA customization via 6420 * scsi_identity/tran_tgt_identity/scsi_device_identity, but for 6421 * now we just scsi_device_identity. 6422 * 6423 * The identity operation will establish additional properties 6424 * on the probe node related to device identity: 6425 * 6426 * "inquiry-page-80" byte array of SCSI page 80 6427 * "inquiry-page-83" byte array of SCSI page 83 6428 * 6429 * These properties will be used to generate a devid 6430 * (ddi_devid_scsi_encode) and guid - and to register 6431 * (ddi_devid_register) a devid for the device. 6432 * 6433 * If identify fails (non-zero return), the we had allocation 6434 * problems or the device returned inconsistent results then 6435 * we pretend that device does not exist. 6436 */ 6437 if (scsi_device_identity(sdprobe, SLEEP_FUNC)) { 6438 scsi_enumeration_failed(probe, -1, NULL, "identify"); 6439 sp = SCSIPROBE_FAILURE; 6440 } 6441 6442 /* 6443 * Future: Is there anything more we can do here to help avoid 6444 * serialization on iport parent during scsi_device attach(9E)? 6445 */ 6446 } 6447 scsi_hba_devi_enter(self, enteredvp); 6448 sdprobe->sd_uninit_prevent--; 6449 6450 if (sp != SCSIPROBE_EXISTS) { 6451 scsi_enumeration_failed(probe, -1, NULL, "probe"); 6452 6453 if ((se != SE_HP) && scsi_hba_barrier_timeout) { 6454 /* 6455 * Target does not exist. Mark the barrier probe node 6456 * as DEVICE_REMOVED and schedule an asynchronous 6457 * deletion of the node in scsi_hba_barrier_timeout 6458 * seconds. We keep our hold on the probe node 6459 * until we are ready perform the asynchronous node 6460 * deletion. 6461 */ 6462 SCSI_HBA_LOG((_LOG(3), NULL, probe, 6463 "set probe DEVICE_REMOVED")); 6464 mutex_enter(&DEVI(probe)->devi_lock); 6465 DEVI_SET_DEVICE_REMOVED(probe); 6466 mutex_exit(&DEVI(probe)->devi_lock); 6467 6468 scsi_hba_barrier_add(probe, scsi_hba_barrier_timeout); 6469 probe = NULL; 6470 } 6471 goto fail; 6472 } 6473 6474 /* Create the child node from the inquiry data in the probe node. */ 6475 if ((child = scsi_device_configchild(self, addr, se, sdprobe, 6476 &pi)) == NULL) { 6477 /* 6478 * This may fail because there was no driver binding identified 6479 * via driver_alias. We may still have a conf node. 6480 */ 6481 if (name) { 6482 (void) scsi_findchild(self, name, addr, 6483 0, &child, NULL, &pi); 6484 if (child) 6485 SCSI_HBA_LOG((_LOG(2), NULL, child, 6486 "using driver.conf driver binding")); 6487 } 6488 if (child == NULL) { 6489 SCSI_HBA_LOG((_LOG(2), NULL, probe, 6490 "device not configured")); 6491 goto fail; 6492 } 6493 } 6494 6495 /* 6496 * Transfer the inquiry data from the probe node to the child 6497 * SID node to avoid an extra scsi_probe. Callers depend on 6498 * established inquiry data for the returned scsi_device. 6499 */ 6500 sdchild = ddi_get_driver_private(child); 6501 if (sdchild && (sdchild->sd_inq == NULL)) { 6502 sdchild->sd_inq = sdprobe->sd_inq; 6503 sdprobe->sd_inq = NULL; 6504 } 6505 6506 /* 6507 * If we are doing a bus_configone and the node we created has the 6508 * wrong node and driver name then switch the return result to a 6509 * driver.conf node with the correct name - if such a node exists. 6510 */ 6511 if (name && (strcmp(ddi_node_name(child), name) != 0) && 6512 (strcmp(ddi_driver_name(child), name) != 0)) { 6513 (void) scsi_findchild(self, name, addr, 6514 0, &dsearch, NULL, &pi); 6515 if (dsearch == NULL) { 6516 SCSI_HBA_LOG((_LOG(2), NULL, child, 6517 "wrong device configured %s@%s", name, addr)); 6518 /* 6519 * We can't remove when modrootloaded == 0 in case 6520 * boot-device a uses generic name and 6521 * scsi_hba_nodename_compatible_get() returned a 6522 * legacy binding-set driver oriented name. 6523 */ 6524 if (modrootloaded) { 6525 (void) scsi_hba_remove_node(child); 6526 child = NULL; 6527 goto fail; 6528 } 6529 } else { 6530 SCSI_HBA_LOG((_LOG(2), NULL, dsearch, 6531 "device configured, but switching to driver.conf")); 6532 child = dsearch; 6533 } 6534 } 6535 6536 /* get the scsi_device structure from the node */ 6537 SCSI_HBA_LOG((_LOG(3), NULL, child, "device configured")); 6538 6539 if (child) { 6540 done: ASSERT(child); 6541 sdchild = ddi_get_driver_private(child); 6542 ASSERT(sdchild); 6543 6544 /* 6545 * We may have ended up here after promotion of a previously 6546 * demoted node, where demotion deleted sd_inq data in 6547 * scsi_busctl_uninitchild. We redo the scsi_probe() to 6548 * reestablish sd_inq. We also want to redo the scsi_probe 6549 * for devices are currently device_isremove in order to 6550 * detect new device_insert. 6551 */ 6552 if ((sdchild->sd_inq == NULL) || 6553 ((pi == 0) && ndi_devi_device_isremoved(child))) { 6554 6555 /* hotplug_node can only be revived via hotplug. */ 6556 if ((se == SE_HP) || !ndi_dev_is_hotplug_node(child)) { 6557 SCSI_HBA_LOG((_LOG(3), NULL, child, 6558 "scsi_probe() demoted devinfo")); 6559 6560 sp = scsi_probe(sdchild, SLEEP_FUNC); 6561 6562 if (sp == SCSIPROBE_EXISTS) { 6563 ASSERT(sdchild->sd_inq); 6564 6565 /* 6566 * Devinfo child exists and we are 6567 * talking to the device, report 6568 * reinsert and note if this was a 6569 * new reinsert. 6570 */ 6571 chg = ndi_devi_device_insert(child); 6572 SCSI_HBA_LOG((_LOGCFG, NULL, child, 6573 "devinfo %s@%s device_reinsert%s", 6574 name ? name : "", addr, 6575 chg ? "" : "ed already")); 6576 } else { 6577 scsi_enumeration_failed(child, se, 6578 NULL, "reprobe"); 6579 6580 chg = ndi_devi_device_remove(child); 6581 SCSI_HBA_LOG((_LOG(2), NULL, child, 6582 "%s device_remove%s", 6583 (sp > (sizeof (scsi_probe_ascii) / 6584 sizeof (scsi_probe_ascii[0]))) ? 6585 "UNKNOWN" : scsi_probe_ascii[sp], 6586 chg ? "" : "ed already")); 6587 6588 child = NULL; 6589 sdchild = NULL; 6590 } 6591 } else { 6592 SCSI_HBA_LOG((_LOG(2), NULL, child, 6593 "no reprobe")); 6594 6595 child = NULL; 6596 sdchild = NULL; 6597 } 6598 } 6599 } else { 6600 fail: ASSERT(child == NULL); 6601 sdchild = NULL; 6602 } 6603 if (probe) { 6604 /* 6605 * Clean up probe node, destroying node if uninit_prevent 6606 * it is going to zero. Destroying the probe node (deleting 6607 * from the sibling list) will wake up any people waiting on 6608 * the probe node barrier. 6609 */ 6610 SCSI_HBA_LOG((_LOG(4), NULL, probe, "remove probe")); 6611 if (!scsi_hba_remove_node(probe)) { 6612 /* 6613 * Probe node removal should not fail, but if it 6614 * does we hand that responsibility over to the 6615 * async barrier deletion thread - other references 6616 * to the same unit-address can hang until the 6617 * probe node delete completes. 6618 */ 6619 SCSI_HBA_LOG((_LOG(4), NULL, probe, 6620 "remove probe failed, go async")); 6621 scsi_hba_barrier_add(probe, 1); 6622 } 6623 probe = NULL; 6624 } 6625 6626 /* 6627 * If we successfully resolved via a pathinfo node, we need to find 6628 * the pathinfo node and ensure that it is online (if possible). This 6629 * is done for the case where the device was open when 6630 * scsi_device_unconfig occurred, so mdi_pi_free did not occur. If the 6631 * device has now been reinserted, we want the path back online. 6632 * NOTE: This needs to occur after destruction of the probe node to 6633 * avoid ASSERT related to two nodes at the same unit-address. 6634 */ 6635 if (sdchild && pi && (probe == NULL)) { 6636 ASSERT(MDI_PHCI(self)); 6637 6638 (void) scsi_findchild(self, NULL, addr, 6639 0, &dsearch, &psearch, NULL); 6640 ASSERT((psearch == NULL) || 6641 (mdi_pi_get_client(psearch) == child)); 6642 6643 if (psearch && mdi_pi_device_isremoved(psearch)) { 6644 /* 6645 * Verify that we can talk to the device, and if 6646 * so note if this is a new device_insert. 6647 * 6648 * NOTE: We depend on mdi_path_select(), when given 6649 * a specific path_instance, to select that path 6650 * even if the path is offline. 6651 * 6652 * NOTE: A Client node is not ndi_dev_is_hotplug_node(). 6653 */ 6654 if (se == SE_HP) { 6655 SCSI_HBA_LOG((_LOG(3), NULL, child, 6656 "%s scsi_probe() demoted pathinfo", 6657 mdi_pi_spathname(psearch))); 6658 6659 sp = scsi_hba_probe_pi(sdchild, SLEEP_FUNC, pi); 6660 6661 if (sp == SCSIPROBE_EXISTS) { 6662 /* 6663 * Pathinfo child exists and we are 6664 * talking to the device, report 6665 * reinsert and note if this 6666 * was a new reinsert. 6667 */ 6668 chg = mdi_pi_device_insert(psearch); 6669 SCSI_HBA_LOG((_LOGCFG, self, NULL, 6670 "pathinfo %s device_reinsert%s", 6671 mdi_pi_spathname(psearch), 6672 chg ? "" : "ed already")); 6673 6674 if (chg) 6675 (void) mdi_pi_online(psearch, 6676 0); 6677 6678 /* 6679 * Report client reinsert and note if 6680 * this was a new reinsert. 6681 */ 6682 chg = ndi_devi_device_insert(child); 6683 SCSI_HBA_LOG((_LOGCFG, NULL, child, 6684 "client devinfo %s@%s " 6685 "device_reinsert%s", 6686 name ? name : "", addr, 6687 chg ? "" : "ed already")); 6688 } else { 6689 scsi_enumeration_failed(child, se, 6690 mdi_pi_spathname(psearch), 6691 "reprobe"); 6692 child = NULL; 6693 sdchild = NULL; 6694 } 6695 6696 } else { 6697 SCSI_HBA_LOG((_LOG(2), NULL, child, 6698 "%s no reprobe", 6699 mdi_pi_spathname(psearch))); 6700 6701 child = NULL; 6702 sdchild = NULL; 6703 } 6704 } 6705 } 6706 6707 /* If asked for path_instance, return it. */ 6708 if (ppi) 6709 *ppi = pi; 6710 6711 return (sdchild); 6712 } 6713 6714 static void 6715 scsi_device_unconfig(dev_info_t *self, char *addr) 6716 { 6717 dev_info_t *child = NULL; 6718 mdi_pathinfo_t *path = NULL; 6719 char *spathname; 6720 int rval; 6721 6722 ASSERT(self && addr && DEVI_BUSY_OWNED(self)); 6723 6724 /* 6725 * We have a catch-22. We may have a demoted node that we need to find 6726 * and offline/remove. To find the node if it isn't demoted, we 6727 * use scsi_findchild. If it's demoted, we then use 6728 * ndi_devi_findchild_by_callback. 6729 */ 6730 (void) scsi_findchild(self, NULL, addr, 0, &child, &path, NULL); 6731 6732 if ((child == NULL) && (path == NULL)) { 6733 child = ndi_devi_findchild_by_callback(self, NULL, addr, 6734 scsi_busctl_ua); 6735 if (child) { 6736 SCSI_HBA_LOG((_LOGUNCFG, self, NULL, 6737 "devinfo @%s found by callback", 6738 addr)); 6739 ASSERT(ndi_flavor_get(child) == 6740 SCSA_FLAVOR_SCSI_DEVICE); 6741 if (ndi_flavor_get(child) != SCSA_FLAVOR_SCSI_DEVICE) { 6742 SCSI_HBA_LOG((_LOGUNCFG, self, NULL, 6743 "devinfo @%s not SCSI_DEVICE flavored", 6744 addr)); 6745 child = NULL; 6746 } 6747 } 6748 } 6749 6750 if (child) { 6751 ASSERT(child && (path == NULL)); 6752 6753 /* Don't unconfig probe nodes. */ 6754 if (scsi_hba_devi_is_barrier(child)) { 6755 SCSI_HBA_LOG((_LOGUNCFG, self, NULL, 6756 "devinfo @%s is_barrier, skip", 6757 addr)); 6758 return; 6759 } 6760 6761 /* Attempt to offline/remove the devinfo node */ 6762 if (ndi_devi_offline(child, 6763 NDI_DEVFS_CLEAN | NDI_DEVI_REMOVE) == DDI_SUCCESS) { 6764 SCSI_HBA_LOG((_LOGUNCFG, self, NULL, 6765 "devinfo @%s offlined and removed", 6766 addr)); 6767 } else if (ndi_devi_device_remove(child)) { 6768 /* Offline/remove failed, note new device_remove */ 6769 SCSI_HBA_LOG((_LOGUNCFG, self, NULL, 6770 "devinfo @%s offline failed, device_remove", 6771 addr)); 6772 } 6773 } else if (path) { 6774 ASSERT(path && (child == NULL)); 6775 6776 /* 6777 * Attempt to offline/remove the pathinfo node. 6778 * 6779 * NOTE: mdi_pi_offline of last path will fail if the 6780 * device is open (i.e. the client can't be offlined). 6781 * 6782 * NOTE: For mdi there is no REMOVE flag for mdi_pi_offline(). 6783 * When mdi_pi_offline returns MDI_SUCCESS, we are responsible 6784 * for remove via mdi_pi_free(). 6785 */ 6786 mdi_hold_path(path); 6787 spathname = mdi_pi_spathname(path); /* valid after free */ 6788 scsi_hba_devi_exit_phci(self); 6789 rval = mdi_pi_offline(path, 0); 6790 scsi_hba_devi_enter_phci(self); 6791 6792 /* Note new device_remove */ 6793 if (mdi_pi_device_remove(path)) 6794 SCSI_HBA_LOG((_LOGUNCFG, self, NULL, 6795 "pathinfo %s note device_remove", spathname)); 6796 6797 mdi_rele_path(path); 6798 if (rval == MDI_SUCCESS) { 6799 (void) mdi_pi_free(path, 0); 6800 SCSI_HBA_LOG((_LOGUNCFG, self, NULL, 6801 "pathinfo %s offlined, then freed", spathname)); 6802 } 6803 } else { 6804 ASSERT((path == NULL) && (child == NULL)); 6805 6806 SCSI_HBA_LOG((_LOGUNCFG, self, NULL, "@%s not found", addr)); 6807 } 6808 } 6809 6810 /* 6811 * configure the device at the specified "@addr" address. 6812 */ 6813 static struct scsi_device * 6814 scsi_hba_bus_configone_addr(dev_info_t *self, char *addr, scsi_enum_t se) 6815 { 6816 boolean_t enteredv; 6817 struct scsi_device *sd; 6818 6819 scsi_hba_devi_enter(self, &enteredv); 6820 sd = scsi_device_config(self, NULL, addr, se, &enteredv, NULL); 6821 scsi_hba_devi_exit(self, enteredv); 6822 return (sd); 6823 } 6824 6825 /* 6826 * unconfigure the device at the specified "@addr" address. 6827 */ 6828 static void 6829 scsi_hba_bus_unconfigone_addr(dev_info_t *self, char *addr) 6830 { 6831 boolean_t enteredv; 6832 6833 scsi_hba_devi_enter(self, &enteredv); 6834 (void) scsi_device_unconfig(self, addr); 6835 scsi_hba_devi_exit(self, enteredv); 6836 } 6837 6838 /* 6839 * The bus_config_all operations are multi-threaded for performance. A 6840 * separate thread per target and per LUN is used. The config handle is used 6841 * to coordinate all the threads at a given level and the config thread data 6842 * contains the required information for a specific thread to identify what it 6843 * is processing and the handle under which this is being processed. 6844 */ 6845 6846 /* multi-threaded config handle */ 6847 struct scsi_hba_mte_h { 6848 dev_info_t *h_self; /* initiator port */ 6849 int h_thr_count; 6850 kmutex_t h_lock; 6851 kcondvar_t h_cv; 6852 }; 6853 6854 /* target of 'self' config thread data */ 6855 struct scsi_hba_mte_td { 6856 struct scsi_hba_mte_h *td_h; 6857 char *td_taddr; /* target port */ 6858 int td_mt; 6859 scsi_enum_t td_se; 6860 }; 6861 6862 /* Invoke callback on a vector of taddrs from multiple threads */ 6863 static void 6864 scsi_hba_thread_taddrs(dev_info_t *self, char **taddrs, int mt, 6865 scsi_enum_t se, void (*callback)(void *arg)) 6866 { 6867 struct scsi_hba_mte_h *h; /* HBA header */ 6868 struct scsi_hba_mte_td *td; /* target data */ 6869 char **taddr; 6870 6871 /* allocate and initialize the handle */ 6872 h = kmem_zalloc(sizeof (*h), KM_SLEEP); 6873 mutex_init(&h->h_lock, NULL, MUTEX_DEFAULT, NULL); 6874 cv_init(&h->h_cv, NULL, CV_DEFAULT, NULL); 6875 h->h_self = self; 6876 6877 /* loop over all the targets */ 6878 for (taddr = taddrs; *taddr; taddr++) { 6879 /* allocate a thread data structure for target */ 6880 td = kmem_alloc(sizeof (*td), KM_SLEEP); 6881 td->td_h = h; 6882 td->td_taddr = *taddr; 6883 td->td_mt = mt; 6884 td->td_se = se; 6885 6886 /* process the target */ 6887 mutex_enter(&h->h_lock); 6888 h->h_thr_count++; 6889 mutex_exit(&h->h_lock); 6890 6891 if (mt & SCSI_ENUMERATION_MT_TARGET_DISABLE) 6892 callback((void *)td); 6893 else 6894 (void) thread_create(NULL, 0, callback, (void *)td, 6895 0, &p0, TS_RUN, minclsyspri); 6896 } 6897 6898 /* wait for all the target threads to complete */ 6899 mutex_enter(&h->h_lock); 6900 while (h->h_thr_count > 0) 6901 cv_wait(&h->h_cv, &h->h_lock); 6902 mutex_exit(&h->h_lock); 6903 6904 /* free the handle */ 6905 cv_destroy(&h->h_cv); 6906 mutex_destroy(&h->h_lock); 6907 kmem_free(h, sizeof (*h)); 6908 } 6909 6910 6911 /* lun/secondary function of lun0 config thread data */ 6912 struct scsi_hba_mte_ld { 6913 struct scsi_hba_mte_h *ld_h; 6914 char *ld_taddr; /* target port */ 6915 scsi_lun64_t ld_lun64; /* lun */ 6916 int ld_sfunc; /* secondary function */ 6917 scsi_enum_t ld_se; 6918 }; 6919 6920 /* 6921 * Enumerate the LUNs and secondary functions of the specified target. The 6922 * target portion of the "@addr" is already represented as a string in the 6923 * thread data, we add a ",lun" representation to this and perform a 6924 * bus_configone byte of enumeration on that "@addr". 6925 */ 6926 static void 6927 scsi_hba_enum_lsf_of_tgt_thr(void *arg) 6928 { 6929 struct scsi_hba_mte_ld *ld = (struct scsi_hba_mte_ld *)arg; 6930 struct scsi_hba_mte_h *h = ld->ld_h; 6931 dev_info_t *self = h->h_self; 6932 char addr[SCSI_MAXNAMELEN]; 6933 6934 /* make string form of "@taddr,lun[,sfunc]" and see if it exists */ 6935 if (ld->ld_sfunc == -1) 6936 (void) snprintf(addr, sizeof (addr), 6937 "%s,%" PRIx64, ld->ld_taddr, ld->ld_lun64); 6938 else 6939 (void) snprintf(addr, sizeof (addr), 6940 "%s,%" PRIx64 ",%x", 6941 ld->ld_taddr, ld->ld_lun64, ld->ld_sfunc); 6942 6943 /* configure device at that unit-address address */ 6944 (void) scsi_hba_bus_configone_addr(self, addr, ld->ld_se); 6945 6946 /* signal completion of this LUN thread to the target */ 6947 mutex_enter(&h->h_lock); 6948 if (--h->h_thr_count == 0) 6949 cv_broadcast(&h->h_cv); 6950 mutex_exit(&h->h_lock); 6951 6952 /* free config thread data */ 6953 kmem_free(ld, sizeof (*ld)); 6954 } 6955 6956 /* Format of SCSI REPORT_LUNS report */ 6957 typedef struct scsi_lunrpt { 6958 uchar_t lunrpt_len_msb; /* # LUNs being reported */ 6959 uchar_t lunrpt_len_mmsb; 6960 uchar_t lunrpt_len_mlsb; 6961 uchar_t lunrpt_len_lsb; 6962 uchar_t lunrpt_reserved[4]; 6963 scsi_lun_t lunrpt_luns[1]; /* LUNs, variable size */ 6964 } scsi_lunrpt_t; 6965 6966 /* 6967 * scsi_device_reportluns() 6968 * 6969 * Callers of this routine should ensure that the 'sd0' scsi_device structure 6970 * and 'pi' path_instance specified are associated with a responding LUN0. 6971 * This should not be called for SCSI-1 devices. 6972 * 6973 * To get a LUN report, we must allocate a buffer. To know how big to make the 6974 * buffer, we must know the number of LUNs. To know the number of LUNs, we must 6975 * get a LUN report. We first issue a SCMD_REPORT_LUNS command using a 6976 * reasonably sized buffer that's big enough to report all LUNs for most 6977 * typical devices. If it turns out that we needed a bigger buffer, we attempt 6978 * to allocate a buffer of sufficient size, and reissue the command. If the 6979 * first command succeeds, but the second fails, we return whatever we were 6980 * able to get the first time. We return enough information for the caller to 6981 * tell whether they got all the LUNs or only a subset. 6982 * 6983 * If successful, we allocate an array of scsi_lun_t to hold the results. The 6984 * caller must kmem_free(*lunarrayp, *sizep) when finished with it. Upon 6985 * successful return return value is NDI_SUCCESS and: 6986 * 6987 * *lunarrayp points to the allocated array, 6988 * *nlunsp is the number of valid LUN entries in the array, 6989 * *tlunsp is the total number of LUNs in the target, 6990 * *sizep is the size of the lunarrayp array, which must be freed. 6991 * 6992 * If the *nlunsp is less than *tlunsp, then we were only able to retrieve a 6993 * subset of the total set of LUNs in the target. 6994 */ 6995 static int 6996 scsi_device_reportluns(struct scsi_device *sd0, char *taddr, int pi, 6997 scsi_lun_t **lunarrayp, uint32_t *nlunsp, uint32_t *tlunsp, size_t *sizep) 6998 { 6999 struct buf *lunrpt_bp; 7000 struct scsi_pkt *lunrpt_pkt; 7001 scsi_lunrpt_t *lunrpt; 7002 uint32_t bsize; 7003 uint32_t tluns, nluns; 7004 int default_maxluns = scsi_lunrpt_default_max; 7005 dev_info_t *child; 7006 7007 ASSERT(sd0 && lunarrayp && nlunsp && tlunsp && sizep); 7008 7009 /* 7010 * NOTE: child should only be used in SCSI_HBA_LOG context since with 7011 * vHCI enumeration it may be the vHCI 'client' devinfo child instead 7012 * of a child of the 'self' pHCI we are enumerating. 7013 */ 7014 child = sd0->sd_dev; 7015 7016 /* first try, look for up to scsi_lunrpt_default_max LUNs */ 7017 nluns = default_maxluns; 7018 7019 again: bsize = sizeof (struct scsi_lunrpt) + 7020 ((nluns - 1) * sizeof (struct scsi_lun)); 7021 7022 lunrpt_bp = scsi_alloc_consistent_buf(&sd0->sd_address, 7023 (struct buf *)NULL, bsize, B_READ, SLEEP_FUNC, NULL); 7024 if (lunrpt_bp == NULL) { 7025 SCSI_HBA_LOG((_LOG(1), NULL, child, "failed alloc")); 7026 return (NDI_NOMEM); 7027 } 7028 7029 lunrpt_pkt = scsi_init_pkt(&sd0->sd_address, 7030 (struct scsi_pkt *)NULL, lunrpt_bp, CDB_GROUP5, 7031 sizeof (struct scsi_arq_status), 0, PKT_CONSISTENT, 7032 SLEEP_FUNC, NULL); 7033 if (lunrpt_pkt == NULL) { 7034 SCSI_HBA_LOG((_LOG(1), NULL, child, "failed init")); 7035 scsi_free_consistent_buf(lunrpt_bp); 7036 return (NDI_NOMEM); 7037 } 7038 7039 (void) scsi_setup_cdb((union scsi_cdb *)lunrpt_pkt->pkt_cdbp, 7040 SCMD_REPORT_LUNS, 0, bsize, 0); 7041 7042 lunrpt_pkt->pkt_time = scsi_lunrpt_timeout; 7043 7044 /* 7045 * When sd0 is a vHCI scsi device, we need reportlun to be issued 7046 * against a specific LUN0 path_instance that we are enumerating. 7047 */ 7048 lunrpt_pkt->pkt_path_instance = pi; 7049 lunrpt_pkt->pkt_flags |= FLAG_PKT_PATH_INSTANCE; 7050 7051 /* 7052 * NOTE: scsi_poll may not allow HBA specific recovery from TRAN_BUSY. 7053 */ 7054 if (scsi_poll(lunrpt_pkt) < 0) { 7055 SCSI_HBA_LOG((_LOG(2), NULL, child, "reportlun not supported")); 7056 scsi_destroy_pkt(lunrpt_pkt); 7057 scsi_free_consistent_buf(lunrpt_bp); 7058 return (NDI_FAILURE); 7059 } 7060 7061 scsi_destroy_pkt(lunrpt_pkt); 7062 7063 lunrpt = (scsi_lunrpt_t *)lunrpt_bp->b_un.b_addr; 7064 7065 /* Compute the total number of LUNs in the target */ 7066 tluns = (((uint_t)lunrpt->lunrpt_len_msb << 24) | 7067 ((uint_t)lunrpt->lunrpt_len_mmsb << 16) | 7068 ((uint_t)lunrpt->lunrpt_len_mlsb << 8) | 7069 ((uint_t)lunrpt->lunrpt_len_lsb)) >> 3; 7070 7071 if (tluns == 0) { 7072 /* Illegal response -- this target is broken */ 7073 SCSI_HBA_LOG((_LOG(1), NULL, child, "illegal tluns of zero")); 7074 scsi_free_consistent_buf(lunrpt_bp); 7075 return (DDI_NOT_WELL_FORMED); 7076 } 7077 7078 if (tluns > nluns) { 7079 /* have more than we allocated space for */ 7080 if (nluns == default_maxluns) { 7081 /* first time around, reallocate larger */ 7082 scsi_free_consistent_buf(lunrpt_bp); 7083 nluns = tluns; 7084 goto again; 7085 } 7086 7087 /* uh oh, we got a different tluns the second time! */ 7088 SCSI_HBA_LOG((_LOG(1), NULL, child, 7089 "tluns changed from %d to %d", nluns, tluns)); 7090 } else 7091 nluns = tluns; 7092 7093 /* 7094 * Now we have: 7095 * lunrpt_bp is the buffer we're using; 7096 * tluns is the total number of LUNs the target says it has; 7097 * nluns is the number of LUNs we were able to get into the buffer. 7098 * 7099 * Copy the data out of scarce iopb memory into regular kmem. 7100 * The caller must kmem_free(*lunarrayp, *sizep) when finished with it. 7101 */ 7102 *lunarrayp = (scsi_lun_t *)kmem_alloc( 7103 nluns * sizeof (scsi_lun_t), KM_SLEEP); 7104 if (*lunarrayp == NULL) { 7105 SCSI_HBA_LOG((_LOG(1), NULL, child, "NULL lunarray")); 7106 scsi_free_consistent_buf(lunrpt_bp); 7107 return (NDI_NOMEM); 7108 } 7109 7110 *sizep = nluns * sizeof (scsi_lun_t); 7111 *nlunsp = nluns; 7112 *tlunsp = tluns; 7113 bcopy((void *)&lunrpt->lunrpt_luns, (void *)*lunarrayp, *sizep); 7114 scsi_free_consistent_buf(lunrpt_bp); 7115 SCSI_HBA_LOG((_LOG(3), NULL, child, 7116 "@%s,0 path %d: %d/%d luns", taddr, pi, nluns, tluns)); 7117 return (NDI_SUCCESS); 7118 } 7119 7120 /* 7121 * Enumerate all the LUNs and secondary functions of the specified 'taddr' 7122 * target port as accessed via 'self' pHCI. Note that sd0 may be associated 7123 * with a child of the vHCI instead of 'self' - in this case the 'pi' 7124 * path_instance is used to ensure that the SCMD_REPORT_LUNS command is issued 7125 * through the 'self' pHCI path. 7126 * 7127 * We multi-thread across all the LUNs and secondary functions and enumerate 7128 * them. Which LUNs exist is based on SCMD_REPORT_LUNS data. 7129 * 7130 * The scsi_device we are called with should be for LUN0 and has been probed. 7131 * 7132 * This function is structured so that an HBA that has a different target 7133 * addressing structure can still use this function to enumerate the its 7134 * LUNs if it uses "taddr,lun" for its LUN space. 7135 * 7136 * We make assumptions about other LUNs associated with the target: 7137 * 7138 * For SCSI-2 and SCSI-3 target we will issue the SCSI report_luns 7139 * command. If this fails or we have a SCSI-1 then the number of 7140 * LUNs is determined based on SCSI_OPTIONS_NLUNS. For a SCSI-1 7141 * target we never probe above LUN 8, even if SCSI_OPTIONS_NLUNS 7142 * indicates we should. 7143 * 7144 * HBA drivers wanting a different set of assumptions should implement their 7145 * own LUN enumeration code. 7146 */ 7147 static int 7148 scsi_hba_enum_lsf_of_t(struct scsi_device *sd0, 7149 dev_info_t *self, char *taddr, int pi, int mt, scsi_enum_t se) 7150 { 7151 dev_info_t *child; 7152 scsi_hba_tran_t *tran; 7153 impl_scsi_tgtmap_t *tgtmap; 7154 damap_id_t tgtid; 7155 damap_t *tgtdam; 7156 damap_t *lundam = NULL; 7157 struct scsi_hba_mte_h *h; 7158 struct scsi_hba_mte_ld *ld; 7159 int aver; 7160 scsi_lun_t *lunp = NULL; 7161 int lun; 7162 uint32_t nluns; 7163 uint32_t tluns; 7164 size_t size; 7165 scsi_lun64_t lun64; 7166 int maxluns; 7167 7168 /* 7169 * If LUN0 failed then we have no other LUNs. 7170 * 7171 * NOTE: We need sd_inq to be valid to check ansi version. Since 7172 * scsi_unprobe is now a noop (sd_inq freeded in 7173 * scsi_busctl_uninitchild) sd_inq remains valid even if a target 7174 * driver detach(9E) occurs, resulting in a scsi_unprobe call 7175 * (sd_uninit_prevent keeps sd_inq valid by failing any 7176 * device_uninitchild attempts). 7177 */ 7178 ASSERT(sd0 && sd0->sd_uninit_prevent && sd0->sd_dev && sd0->sd_inq); 7179 if ((sd0 == NULL) || (sd0->sd_dev == NULL) || (sd0->sd_inq == NULL)) { 7180 SCSI_HBA_LOG((_LOG(1), NULL, sd0 ? sd0->sd_dev : NULL, 7181 "not setup correctly:%s%s%s", 7182 (sd0 == NULL) ? " device" : "", 7183 (sd0 && (sd0->sd_dev == NULL)) ? " dip" : "", 7184 (sd0 && (sd0->sd_inq == NULL)) ? " inq" : "")); 7185 return (DDI_FAILURE); 7186 } 7187 7188 /* 7189 * NOTE: child should only be used in SCSI_HBA_LOG context since with 7190 * vHCI enumeration it may be the vHCI 'client' devinfo child instead 7191 * of a child of the 'self' pHCI we are enumerating. 7192 */ 7193 child = sd0->sd_dev; 7194 7195 /* Determine if we are reporting lun observations into lunmap. */ 7196 tran = ndi_flavorv_get(self, SCSA_FLAVOR_SCSI_DEVICE); 7197 tgtmap = (impl_scsi_tgtmap_t *)tran->tran_tgtmap; 7198 if (tgtmap) { 7199 tgtdam = tgtmap->tgtmap_dam[SCSI_TGT_SCSI_DEVICE]; 7200 tgtid = damap_lookup(tgtdam, taddr); 7201 if (tgtid != NODAM) { 7202 lundam = damap_id_priv_get(tgtdam, tgtid); 7203 damap_id_rele(tgtdam, tgtid); 7204 ASSERT(lundam); 7205 } 7206 } 7207 7208 if (lundam) { 7209 /* If using lunmap, start the observation */ 7210 scsi_lunmap_set_begin(self, lundam); 7211 } else { 7212 /* allocate and initialize the LUN handle */ 7213 h = kmem_zalloc(sizeof (*h), KM_SLEEP); 7214 mutex_init(&h->h_lock, NULL, MUTEX_DEFAULT, NULL); 7215 cv_init(&h->h_cv, NULL, CV_DEFAULT, NULL); 7216 h->h_self = self; 7217 } 7218 7219 /* See if SCMD_REPORT_LUNS works for SCSI-2 and beyond */ 7220 aver = sd0->sd_inq->inq_ansi; 7221 if ((aver >= SCSI_VERSION_2) && (scsi_device_reportluns(sd0, 7222 taddr, pi, &lunp, &nluns, &tluns, &size) == NDI_SUCCESS)) { 7223 7224 ASSERT(lunp && (size > 0) && (nluns > 0) && (tluns > 0)); 7225 7226 /* loop over the reported LUNs */ 7227 SCSI_HBA_LOG((_LOG(2), NULL, child, 7228 "@%s,0 path %d: enumerating %d reported lun%s", taddr, pi, 7229 nluns, nluns > 1 ? "s" : "")); 7230 7231 for (lun = 0; lun < nluns; lun++) { 7232 lun64 = scsi_lun_to_lun64(lunp[lun]); 7233 7234 if (lundam) { 7235 if (scsi_lunmap_set_add(self, lundam, 7236 taddr, lun64, -1) != DDI_SUCCESS) { 7237 SCSI_HBA_LOG((_LOG_NF(WARN), 7238 "@%s,%" PRIx64 " failed to create", 7239 taddr, lun64)); 7240 } 7241 } else { 7242 if (lun64 == 0) 7243 continue; 7244 7245 /* allocate a thread data structure for LUN */ 7246 ld = kmem_alloc(sizeof (*ld), KM_SLEEP); 7247 ld->ld_h = h; 7248 ld->ld_taddr = taddr; 7249 ld->ld_lun64 = lun64; 7250 ld->ld_sfunc = -1; 7251 ld->ld_se = se; 7252 7253 /* process the LUN */ 7254 mutex_enter(&h->h_lock); 7255 h->h_thr_count++; 7256 mutex_exit(&h->h_lock); 7257 7258 if (mt & SCSI_ENUMERATION_MT_LUN_DISABLE) 7259 scsi_hba_enum_lsf_of_tgt_thr( 7260 (void *)ld); 7261 else 7262 (void) thread_create(NULL, 0, 7263 scsi_hba_enum_lsf_of_tgt_thr, 7264 (void *)ld, 0, &p0, TS_RUN, 7265 minclsyspri); 7266 } 7267 } 7268 7269 /* free the LUN array allocated by scsi_device_reportluns */ 7270 kmem_free(lunp, size); 7271 } else { 7272 /* Determine the number of LUNs to enumerate. */ 7273 maxluns = scsi_get_scsi_maxluns(sd0); 7274 7275 /* Couldn't get SCMD_REPORT_LUNS data */ 7276 if (aver >= SCSI_VERSION_3) { 7277 scsi_enumeration_failed(child, se, taddr, "report_lun"); 7278 7279 /* 7280 * Based on calling context tunable, only enumerate one 7281 * lun (lun0) if scsi_device_reportluns() fails on a 7282 * SCSI_VERSION_3 or greater device. 7283 */ 7284 if (scsi_lunrpt_failed_do1lun & (1 << se)) 7285 maxluns = 1; 7286 } 7287 7288 /* loop over possible LUNs, skipping LUN0 */ 7289 if (maxluns > 1) 7290 SCSI_HBA_LOG((_LOG(2), NULL, child, 7291 "@%s,0 path %d: enumerating luns 1-%d", taddr, pi, 7292 maxluns - 1)); 7293 else 7294 SCSI_HBA_LOG((_LOG(2), NULL, child, 7295 "@%s,0 path %d: enumerating just lun0", taddr, pi)); 7296 7297 for (lun64 = 0; lun64 < maxluns; lun64++) { 7298 if (lundam) { 7299 if (scsi_lunmap_set_add(self, lundam, 7300 taddr, lun64, -1) != DDI_SUCCESS) { 7301 SCSI_HBA_LOG((_LOG_NF(WARN), 7302 "@%s,%" PRIx64 " failed to create", 7303 taddr, lun64)); 7304 } 7305 } else { 7306 if (lun64 == 0) 7307 continue; 7308 7309 /* allocate a thread data structure for LUN */ 7310 ld = kmem_alloc(sizeof (*ld), KM_SLEEP); 7311 ld->ld_h = h; 7312 ld->ld_taddr = taddr; 7313 ld->ld_lun64 = lun64; 7314 ld->ld_sfunc = -1; 7315 ld->ld_se = se; 7316 7317 /* process the LUN */ 7318 mutex_enter(&h->h_lock); 7319 h->h_thr_count++; 7320 mutex_exit(&h->h_lock); 7321 if (mt & SCSI_ENUMERATION_MT_LUN_DISABLE) 7322 scsi_hba_enum_lsf_of_tgt_thr( 7323 (void *)ld); 7324 else 7325 (void) thread_create(NULL, 0, 7326 scsi_hba_enum_lsf_of_tgt_thr, 7327 (void *)ld, 0, &p0, TS_RUN, 7328 minclsyspri); 7329 } 7330 } 7331 } 7332 7333 /* 7334 * If we have an embedded service as a secondary function on LUN0 and 7335 * the primary LUN0 function is different than the secondary function 7336 * then enumerate the secondary function. The sfunc value is the dtype 7337 * associated with the embedded service. 7338 * 7339 * inq_encserv: enclosure service and our dtype is not DTYPE_ESI 7340 * or DTYPE_UNKNOWN then create a separate DTYPE_ESI node for 7341 * enclosure service access. 7342 */ 7343 ASSERT(sd0->sd_inq); 7344 if (sd0->sd_inq->inq_encserv && 7345 ((sd0->sd_inq->inq_dtype & DTYPE_MASK) != DTYPE_UNKNOWN) && 7346 ((sd0->sd_inq->inq_dtype & DTYPE_MASK) != DTYPE_ESI) && 7347 ((sd0->sd_inq->inq_ansi >= SCSI_VERSION_3))) { 7348 if (lundam) { 7349 if (scsi_lunmap_set_add(self, lundam, 7350 taddr, 0, DTYPE_ESI) != DDI_SUCCESS) { 7351 SCSI_HBA_LOG((_LOG_NF(WARN), 7352 "@%s,0,%x failed to create", 7353 taddr, DTYPE_ESI)); 7354 } 7355 } else { 7356 /* allocate a thread data structure for sfunc */ 7357 ld = kmem_alloc(sizeof (*ld), KM_SLEEP); 7358 ld->ld_h = h; 7359 ld->ld_taddr = taddr; 7360 ld->ld_lun64 = 0; 7361 ld->ld_sfunc = DTYPE_ESI; 7362 ld->ld_se = se; 7363 7364 /* process the LUN */ 7365 mutex_enter(&h->h_lock); 7366 h->h_thr_count++; 7367 mutex_exit(&h->h_lock); 7368 if (mt & SCSI_ENUMERATION_MT_LUN_DISABLE) 7369 scsi_hba_enum_lsf_of_tgt_thr((void *)ld); 7370 else 7371 (void) thread_create(NULL, 0, 7372 scsi_hba_enum_lsf_of_tgt_thr, (void *)ld, 7373 0, &p0, TS_RUN, minclsyspri); 7374 } 7375 } 7376 7377 /* 7378 * Future: Add secondary function support for: 7379 * inq_mchngr (DTYPE_CHANGER) 7380 * inq_sccs (DTYPE_ARRAY_CTRL) 7381 */ 7382 7383 if (lundam) { 7384 /* If using lunmap, end the observation */ 7385 scsi_lunmap_set_end(self, lundam); 7386 } else { 7387 /* wait for all the LUN threads of this target to complete */ 7388 mutex_enter(&h->h_lock); 7389 while (h->h_thr_count > 0) 7390 cv_wait(&h->h_cv, &h->h_lock); 7391 mutex_exit(&h->h_lock); 7392 7393 /* free the target handle */ 7394 cv_destroy(&h->h_cv); 7395 mutex_destroy(&h->h_lock); 7396 kmem_free(h, sizeof (*h)); 7397 } 7398 7399 return (DDI_SUCCESS); 7400 } 7401 7402 /* 7403 * Enumerate LUN0 and all other LUNs and secondary functions associated with 7404 * the specified target address. 7405 * 7406 * Return NDI_SUCCESS if we might have created a new node. 7407 * Return NDI_FAILURE if we definitely did not create a new node. 7408 */ 7409 static int 7410 scsi_hba_bus_config_taddr(dev_info_t *self, char *taddr, int mt, scsi_enum_t se) 7411 { 7412 char addr[SCSI_MAXNAMELEN]; 7413 struct scsi_device *sd; 7414 boolean_t enteredv; 7415 int ret; 7416 int pi; 7417 7418 /* See if LUN0 of the specified target exists. */ 7419 (void) snprintf(addr, sizeof (addr), "%s,0", taddr); 7420 7421 scsi_hba_devi_enter(self, &enteredv); 7422 sd = scsi_device_config(self, NULL, addr, se, &enteredv, &pi); 7423 7424 if (sd) { 7425 /* 7426 * LUN0 exists, enumerate all the other LUNs. 7427 * 7428 * With vHCI enumeration, when 'self' is a pHCI the sd 7429 * scsi_device may be associated with the vHCI 'client'. 7430 * In this case 'pi' is the path_instance needed to 7431 * continue enumeration communication LUN0 via 'self' 7432 * pHCI and specific 'taddr' target address. 7433 * 7434 * We prevent the removal of LUN0 until we are done with 7435 * prevent/allow because we must exit the parent for 7436 * multi-threaded scsi_hba_enum_lsf_of_t(). 7437 * 7438 * NOTE: scsi_unprobe is a noop, sd->sd_inq is valid until 7439 * device_uninitchild - so sd_uninit_prevent keeps sd_inq valid 7440 * by failing any device_uninitchild attempts. 7441 */ 7442 ret = NDI_SUCCESS; 7443 sd->sd_uninit_prevent++; 7444 scsi_hba_devi_exit(self, enteredv); 7445 7446 (void) scsi_hba_enum_lsf_of_t(sd, self, taddr, pi, mt, se); 7447 7448 scsi_hba_devi_enter(self, &enteredv); 7449 sd->sd_uninit_prevent--; 7450 } else 7451 ret = NDI_FAILURE; 7452 scsi_hba_devi_exit(self, enteredv); 7453 return (ret); 7454 } 7455 7456 /* Config callout from scsi_hba_thread_taddrs */ 7457 static void 7458 scsi_hba_taddr_config_thr(void *arg) 7459 { 7460 struct scsi_hba_mte_td *td = (struct scsi_hba_mte_td *)arg; 7461 struct scsi_hba_mte_h *h = td->td_h; 7462 7463 (void) scsi_hba_bus_config_taddr(h->h_self, td->td_taddr, 7464 td->td_mt, td->td_se); 7465 7466 /* signal completion of this target thread to the HBA */ 7467 mutex_enter(&h->h_lock); 7468 if (--h->h_thr_count == 0) 7469 cv_broadcast(&h->h_cv); 7470 mutex_exit(&h->h_lock); 7471 7472 /* free config thread data */ 7473 kmem_free(td, sizeof (*td)); 7474 } 7475 7476 /* 7477 * Enumerate all the children of the specified SCSI parallel interface (spi). 7478 * An HBA associated with a non-parallel scsi bus should be using another bus 7479 * level enumeration implementation (possibly their own) and calling 7480 * scsi_hba_bus_config_taddr to do enumeration of devices associated with a 7481 * particular target address. 7482 * 7483 * On an spi bus the targets are sequentially enumerated based on the 7484 * width of the bus. We also take care to try to skip the HBAs own initiator 7485 * id. See scsi_hba_enum_lsf_of_t() for LUN and secondary function enumeration. 7486 * 7487 * Return NDI_SUCCESS if we might have created a new node. 7488 * Return NDI_FAILURE if we definitely did not create a new node. 7489 * 7490 * Note: At some point we may want to expose this interface in transport.h 7491 * if we find an hba that implements bus_config but still uses spi-like target 7492 * addresses. 7493 */ 7494 static int 7495 scsi_hba_bus_configall_spi(dev_info_t *self, int mt) 7496 { 7497 int options; 7498 int ntargets; 7499 int id; 7500 int tgt; 7501 char **taddrs; 7502 char **taddr; 7503 char *tbuf; 7504 7505 /* 7506 * Find the number of targets supported on the bus. Look at the per 7507 * bus scsi-options property on the HBA node and check its 7508 * SCSI_OPTIONS_WIDE setting. 7509 */ 7510 options = ddi_prop_get_int(DDI_DEV_T_ANY, self, 7511 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, "scsi-options", -1); 7512 if ((options != -1) && ((options & SCSI_OPTIONS_WIDE) == 0)) 7513 ntargets = NTARGETS; /* 8 */ 7514 else 7515 ntargets = NTARGETS_WIDE; /* 16 */ 7516 7517 /* 7518 * Find the initiator-id for the HBA so we can skip that. We get the 7519 * cached value on the HBA node, established in scsi_hba_attach_setup. 7520 * If we were unable to determine the id then we rely on the HBA to 7521 * fail gracefully when asked to enumerate itself. 7522 */ 7523 id = ddi_prop_get_int(DDI_DEV_T_ANY, self, 7524 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, "scsi-initiator-id", -1); 7525 if (id > ntargets) { 7526 SCSI_HBA_LOG((_LOG(1), self, NULL, 7527 "'scsi-initiator-id' bogus for %d target bus: %d", 7528 ntargets, id)); 7529 id = -1; 7530 } 7531 SCSI_HBA_LOG((_LOG(2), self, NULL, 7532 "enumerating targets 0-%d skip %d", ntargets, id)); 7533 7534 /* form vector of target addresses */ 7535 taddrs = kmem_zalloc(sizeof (char *) * (ntargets + 1), KM_SLEEP); 7536 for (tgt = 0, taddr = taddrs; tgt < ntargets; tgt++) { 7537 /* skip initiator */ 7538 if (tgt == id) 7539 continue; 7540 7541 /* convert to string and enumerate the target address */ 7542 tbuf = kmem_alloc(((tgt/16) + 1) + 1, KM_SLEEP); 7543 (void) sprintf(tbuf, "%x", tgt); 7544 ASSERT(strlen(tbuf) == ((tgt/16) + 1)); 7545 *taddr++ = tbuf; 7546 } 7547 7548 /* null terminate vector of target addresses */ 7549 *taddr = NULL; 7550 7551 /* configure vector of target addresses */ 7552 scsi_hba_thread_taddrs(self, taddrs, mt, SE_BUSCONFIG, 7553 scsi_hba_taddr_config_thr); 7554 7555 /* free vector of target addresses */ 7556 for (taddr = taddrs; *taddr; taddr++) 7557 kmem_free(*taddr, strlen(*taddr) + 1); 7558 kmem_free(taddrs, sizeof (char *) * (ntargets + 1)); 7559 return (NDI_SUCCESS); 7560 } 7561 7562 /* 7563 * Transport independent bus_configone BUS_CONFIG_ONE implementation. Takes 7564 * same arguments, minus op, as scsi_hba_bus_config(), tran_bus_config(), 7565 * and scsi_hba_bus_config_spi(). 7566 */ 7567 int 7568 scsi_hba_bus_configone(dev_info_t *self, uint_t flags, char *arg, 7569 dev_info_t **childp) 7570 { 7571 int ret; 7572 boolean_t enteredv; 7573 char *name, *addr; 7574 char *lcp; 7575 char sc1, sc2; 7576 char nameaddr[SCSI_MAXNAMELEN]; 7577 extern int i_ndi_make_spec_children(dev_info_t *, uint_t); 7578 struct scsi_device *sd0, *sd; 7579 scsi_lun64_t lun64; 7580 int mt; 7581 7582 /* parse_name modifies arg1, we must duplicate "name@addr" */ 7583 (void) strcpy(nameaddr, arg); 7584 i_ddi_parse_name(nameaddr, &name, &addr, NULL); 7585 7586 /* verify the form of the node - we need an @addr */ 7587 if ((name == NULL) || (addr == NULL) || 7588 (*name == '\0') || (*addr == '\0')) { 7589 /* 7590 * OBP may create ill formed template/stub/wild-card 7591 * nodes (no @addr) for legacy driver loading methods - 7592 * ignore them. 7593 */ 7594 SCSI_HBA_LOG((_LOG(2), self, NULL, "%s ill formed", arg)); 7595 return (NDI_FAILURE); 7596 } 7597 7598 /* 7599 * Check to see if this is a non-scsi flavor configuration operation. 7600 */ 7601 if (strcmp(name, "smp") == 0) { 7602 /* 7603 * Configure the child, and if we're successful return with 7604 * active hold. 7605 */ 7606 return (smp_hba_bus_config(self, addr, childp)); 7607 } 7608 7609 /* 7610 * The framework does not ensure the creation of driver.conf 7611 * nodes prior to calling a nexus bus_config. For legacy 7612 * support of driver.conf file nodes we want to create our 7613 * driver.conf file children now so that we can detect if we 7614 * are being asked to bus_configone one of these nodes. 7615 * 7616 * Needing driver.conf file nodes prior to bus config is unique 7617 * to scsi_enumeration mixed mode (legacy driver.conf and 7618 * dynamic SID node) support. There is no general need for the 7619 * framework to make driver.conf children prior to bus_config. 7620 * 7621 * We enter our HBA (self) prior to scsi_device_config, and 7622 * pass it our enteredv. The scsi_device_config may exit the 7623 * HBA around scsi_probe() operations to allow for parallelism. 7624 * This is done after the probe node "@addr" is available as a 7625 * barrier to prevent parallel probes of the same device. The 7626 * probe node is also configured in a way that it can't be 7627 * removed by the framework until we are done with it. 7628 * 7629 * NOTE: The framework is currently preventing many parallel 7630 * sibling operations (such as attaches), so the parallelism 7631 * we are providing is of marginal use until that is improved. 7632 * The most logical way to solve this would be to have separate 7633 * target and lun nodes. This would be a large change in the 7634 * format of /devices paths and is not being pursued at this 7635 * time. The need for parallelism will become more of an issue 7636 * with top-down attach for mpxio/vhci and for iSCSI support. 7637 * We may want to eventually want a dual mode implementation, 7638 * where the HBA determines if we should construct separate 7639 * target and lun devinfo nodes. 7640 */ 7641 scsi_hba_devi_enter(self, &enteredv); 7642 SCSI_HBA_LOG((_LOG(4), self, NULL, "%s@%s config_one", name, addr)); 7643 (void) i_ndi_make_spec_children(self, flags); 7644 7645 /* 7646 * For bus_configone, we make sure that we can find LUN0 7647 * first. This allows the delayed probe/barrier deletion for a 7648 * non-existent LUN0 (if enabled in scsi_device_config) to 7649 * cover all LUNs on the target. This is done to minimize the 7650 * number of independent target selection timeouts that occur 7651 * when a target with many LUNs is no longer accessible 7652 * (powered off). This removes the need for target driver 7653 * probe cache implementations. 7654 * 7655 * This optimization may not be desirable in a pure bridge 7656 * environment where targets on the other side of the bridge 7657 * show up as LUNs to the host. If we ever need to support 7658 * such a configuration then we should consider implementing a 7659 * SCSI_OPTIONS_ILUN0 bit. 7660 * 7661 * NOTE: we are *not* applying any target limitation filtering 7662 * to bus_configone, which means that we are relying on the 7663 * HBA tran_tgt_init entry point invoked by scsi_busctl_initchild 7664 * to fail. 7665 */ 7666 sd0 = (struct scsi_device *)-1; 7667 lcp = strchr(addr, ','); /* "addr,lun[,sfunc]" */ 7668 if (lcp) { 7669 /* 7670 * With "tgt,lun[,sfunc]" addressing, multiple addressing levels 7671 * have been compressed into single devinfo node unit-address. 7672 * This presents a mismatch - there is no bus_config to discover 7673 * LUNs below a specific target, the only choice is to 7674 * BUS_CONFIG_ALL the HBA. To support BUS_CONFIG_ALL_LUNS below 7675 * a specific target, a bus_configone with lun address of "*" 7676 * triggers lun discovery below a target. 7677 */ 7678 if (*(lcp + 1) == '*') { 7679 mt = ddi_prop_get_int(DDI_DEV_T_ANY, self, 7680 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, 7681 "scsi-enumeration", scsi_enumeration); 7682 mt |= scsi_hba_log_mt_disable; 7683 7684 SCSI_HBA_LOG((_LOG(2), self, NULL, 7685 "%s@%s lun enumeration triggered", name, addr)); 7686 *lcp = '\0'; /* turn ',' into '\0' */ 7687 scsi_hba_devi_exit(self, enteredv); 7688 (void) scsi_hba_bus_config_taddr(self, addr, 7689 mt, SE_BUSCONFIG); 7690 return (NDI_FAILURE); 7691 } 7692 7693 /* convert hex lun number from ascii */ 7694 lun64 = scsi_addr_to_lun64(lcp + 1); 7695 7696 if ((lun64 != 0) && (lun64 != SCSI_LUN64_ILLEGAL)) { 7697 /* 7698 * configure ",0" lun first, saving off 7699 * original lun characters. 7700 */ 7701 sc1 = *(lcp + 1); 7702 sc2 = *(lcp + 2); 7703 *(lcp + 1) = '0'; 7704 *(lcp + 2) = '\0'; 7705 sd0 = scsi_device_config(self, 7706 NULL, addr, SE_BUSCONFIG, &enteredv, NULL); 7707 7708 /* restore original lun */ 7709 *(lcp + 1) = sc1; 7710 *(lcp + 2) = sc2; 7711 7712 /* 7713 * Apply maxlun filtering. 7714 * 7715 * Future: We still have the kludged 7716 * scsi_check_ss2_LUN_limit() filtering off 7717 * scsi_probe() to catch bogus driver.conf 7718 * entries. 7719 */ 7720 if (sd0 && (lun64 < SCSI_32LUNS_PER_TARGET) && 7721 (lun64 >= scsi_get_scsi_maxluns(sd0))) { 7722 sd0 = NULL; 7723 SCSI_HBA_LOG((_LOG(4), self, NULL, 7724 "%s@%s filtered", name, addr)); 7725 } else 7726 SCSI_HBA_LOG((_LOG(4), self, NULL, 7727 "%s@%s lun 0 %s", name, addr, 7728 sd0 ? "worked" : "failed")); 7729 } 7730 } 7731 7732 /* 7733 * configure the requested device if LUN0 exists or we were 7734 * unable to determine the lun format to determine if LUN0 7735 * exists. 7736 */ 7737 if (sd0) { 7738 sd = scsi_device_config(self, 7739 name, addr, SE_BUSCONFIG, &enteredv, NULL); 7740 } else { 7741 sd = NULL; 7742 SCSI_HBA_LOG((_LOG(2), self, NULL, 7743 "%s@%s no lun 0 or filtered lun", name, addr)); 7744 } 7745 7746 /* 7747 * We know what we found, to reduce overhead we finish BUS_CONFIG_ONE 7748 * processing without calling back to the frameworks 7749 * ndi_busop_bus_config (unless we goto framework below). 7750 * 7751 * If the reference is to a driver name and we created a generic name 7752 * (bound to that driver) we will still succeed. This is important 7753 * for correctly resolving old drivername references to device that now 7754 * uses a generic names across the transition to generic naming. This 7755 * is effectively an internal implementation of the NDI_DRIVERNAME flag. 7756 * 7757 * We also need to special case the resolve_pathname OBP boot-device 7758 * case (modrootloaded == 0) where reference is to a generic name but 7759 * we created a legacy driver name node by returning just returning 7760 * the node created. 7761 */ 7762 if (sd && sd->sd_dev && 7763 ((strcmp(ddi_node_name(sd->sd_dev), name) == 0) || 7764 (strcmp(ddi_driver_name(sd->sd_dev), name) == 0) || 7765 (modrootloaded == 0)) && 7766 (ndi_devi_online(sd->sd_dev, 7767 flags & NDI_NO_EVENT) == NDI_SUCCESS)) { 7768 7769 /* device attached, return devinfo node with hold */ 7770 ret = NDI_SUCCESS; 7771 *childp = sd->sd_dev; 7772 ndi_hold_devi(sd->sd_dev); 7773 } else { 7774 /* 7775 * In the process of failing we may have added nodes to the HBA 7776 * (self), clearing DEVI_MADE_CHILDREN. To reduce the overhead 7777 * associated with the frameworks reaction to this we clear the 7778 * flag here. 7779 */ 7780 mutex_enter(&DEVI(self)->devi_lock); 7781 DEVI(self)->devi_flags &= ~DEVI_MADE_CHILDREN; 7782 mutex_exit(&DEVI(self)->devi_lock); 7783 ret = NDI_FAILURE; 7784 7785 /* 7786 * The framework may still be able to succeed with 7787 * with its GENERIC_PROP code. 7788 */ 7789 scsi_hba_devi_exit(self, enteredv); 7790 if (flags & NDI_DRV_CONF_REPROBE) 7791 flags |= NDI_CONFIG_REPROBE; 7792 flags |= NDI_MDI_FALLBACK; /* devinfo&pathinfo children */ 7793 return (ndi_busop_bus_config(self, flags, BUS_CONFIG_ONE, 7794 (void *)arg, childp, 0)); 7795 } 7796 7797 scsi_hba_devi_exit(self, enteredv); 7798 return (ret); 7799 } 7800 7801 /* 7802 * Perform SCSI Parallel Interconnect bus_config 7803 */ 7804 static int 7805 scsi_hba_bus_config_spi(dev_info_t *self, uint_t flags, 7806 ddi_bus_config_op_t op, void *arg, dev_info_t **childp) 7807 { 7808 int ret; 7809 int mt; 7810 7811 /* 7812 * Enumerate scsi target devices: See if we are doing generic dynamic 7813 * enumeration: if driver.conf has not specified the 'scsi-enumeration' 7814 * knob then use the global scsi_enumeration knob. 7815 */ 7816 mt = ddi_prop_get_int(DDI_DEV_T_ANY, self, 7817 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, 7818 "scsi-enumeration", scsi_enumeration); 7819 mt |= scsi_hba_log_mt_disable; 7820 7821 if ((mt & SCSI_ENUMERATION_ENABLE) == 0) { 7822 /* 7823 * Static driver.conf file enumeration: 7824 * 7825 * Force reprobe for BUS_CONFIG_ONE or when manually 7826 * reconfiguring via devfsadm(8) to emulate deferred attach. 7827 * Reprobe only discovers driver.conf enumerated nodes, more 7828 * dynamic implementations probably require their own 7829 * bus_config. 7830 */ 7831 if ((op == BUS_CONFIG_ONE) || (flags & NDI_DRV_CONF_REPROBE)) 7832 flags |= NDI_CONFIG_REPROBE; 7833 flags |= NDI_MDI_FALLBACK; /* devinfo&pathinfo children */ 7834 return (ndi_busop_bus_config(self, flags, op, arg, childp, 0)); 7835 } 7836 7837 if (scsi_hba_bus_config_debug) 7838 flags |= NDI_DEVI_DEBUG; 7839 7840 /* 7841 * Generic spi dynamic bus config enumeration to discover and enumerate 7842 * the target device nodes we are looking for. 7843 */ 7844 switch (op) { 7845 case BUS_CONFIG_ONE: /* enumerate the named child */ 7846 ret = scsi_hba_bus_configone(self, flags, (char *)arg, childp); 7847 break; 7848 7849 case BUS_CONFIG_ALL: /* enumerate all children on the bus */ 7850 case BUS_CONFIG_DRIVER: /* enumerate all children that bind to driver */ 7851 SCSI_HBA_LOG((_LOG(3), self, NULL, 7852 "BUS_CONFIG_%s mt %x", 7853 (op == BUS_CONFIG_ALL) ? "ALL" : "DRIVER", mt)); 7854 7855 /* 7856 * Enumerate targets on SCSI parallel interconnect and let the 7857 * framework finish the operation (attach the nodes). 7858 */ 7859 if ((ret = scsi_hba_bus_configall_spi(self, mt)) == NDI_SUCCESS) 7860 ret = ndi_busop_bus_config(self, flags, op, 7861 arg, childp, 0); 7862 break; 7863 7864 default: 7865 ret = NDI_FAILURE; 7866 break; 7867 } 7868 return (ret); 7869 } 7870 7871 /* 7872 * Perform SCSI Parallel Interconnect bus_unconfig 7873 */ 7874 static int 7875 scsi_hba_bus_unconfig_spi(dev_info_t *self, uint_t flags, 7876 ddi_bus_config_op_t op, void *arg) 7877 { 7878 int mt; 7879 int ret; 7880 boolean_t enteredv; 7881 7882 /* 7883 * See if we are doing generic dynamic enumeration: if driver.conf has 7884 * not specified the 'scsi-enumeration' knob then use the global 7885 * scsi_enumeration knob. 7886 */ 7887 mt = ddi_prop_get_int(DDI_DEV_T_ANY, self, 7888 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, 7889 "scsi-enumeration", scsi_enumeration); 7890 mt |= scsi_hba_log_mt_disable; 7891 7892 if ((mt & SCSI_ENUMERATION_ENABLE) == 0) 7893 return (ndi_busop_bus_unconfig(self, flags, op, arg)); 7894 7895 if (scsi_hba_bus_config_debug) 7896 flags |= NDI_DEVI_DEBUG; 7897 7898 scsi_hba_devi_enter(self, &enteredv); 7899 switch (op) { 7900 case BUS_UNCONFIG_ONE: 7901 SCSI_HBA_LOG((_LOG(3), self, NULL, 7902 "unconfig one: %s", (char *)arg)); 7903 ret = NDI_SUCCESS; 7904 break; 7905 7906 case BUS_UNCONFIG_ALL: 7907 case BUS_UNCONFIG_DRIVER: 7908 ret = NDI_SUCCESS; 7909 break; 7910 7911 default: 7912 ret = NDI_FAILURE; 7913 break; 7914 } 7915 7916 /* Perform the generic default bus unconfig */ 7917 if (ret == NDI_SUCCESS) 7918 ret = ndi_busop_bus_unconfig(self, flags, op, arg); 7919 7920 scsi_hba_devi_exit(self, enteredv); 7921 7922 return (ret); 7923 } 7924 7925 static int 7926 scsi_hba_bus_config_tgtmap(dev_info_t *self, uint_t flags, 7927 ddi_bus_config_op_t op, void *arg, dev_info_t **childp) 7928 { 7929 scsi_hba_tran_t *tran; 7930 impl_scsi_tgtmap_t *tgtmap; 7931 uint64_t tsa = 0; /* clock64_t */ 7932 int maxdev; 7933 int sync_usec; 7934 int synced; 7935 int ret = NDI_FAILURE; 7936 7937 if ((op != BUS_CONFIG_ONE) && (op != BUS_CONFIG_ALL) && 7938 (op != BUS_CONFIG_DRIVER)) 7939 goto out; 7940 7941 tran = ndi_flavorv_get(self, SCSA_FLAVOR_SCSI_DEVICE); 7942 tgtmap = (impl_scsi_tgtmap_t *)tran->tran_tgtmap; 7943 ASSERT(tgtmap); 7944 7945 /* 7946 * MPXIO is never a sure thing (and we have mixed children), so 7947 * set NDI_NDI_FALLBACK so that ndi_busop_bus_config will 7948 * search for both devinfo and pathinfo children. 7949 * 7950 * Future: Remove NDI_MDI_FALLBACK since devcfg.c now looks for 7951 * devinfo/pathinfo children in parallel (instead of old way of 7952 * looking for one form of child and then doing "fallback" to 7953 * look for other form of child). 7954 */ 7955 flags |= NDI_MDI_FALLBACK; /* devinfo&pathinfo children */ 7956 7957 /* 7958 * If bus_config occurred within the map create-to-hotplug_sync window, 7959 * we need the framework to wait for children that are physicaly 7960 * present at map create time to show up (via tgtmap hotplug config). 7961 * 7962 * The duration of this window is specified by the HBA driver at 7963 * scsi_hba_tgtmap_create(9F) time (during attach(9E)). Its 7964 * 'csync_usec' value is selected based on how long it takes the HBA 7965 * driver to get from map creation to initial observation for something 7966 * already plugged in. Estimate high, a low estimate can result in 7967 * devices not showing up correctly on first reference. The call to 7968 * ndi_busop_bus_config needs a timeout value large enough so that 7969 * the map sync call further down is not a noop (i.e. done against 7970 * an empty map when something is infact plugged in). With 7971 * BUS_CONFIG_ONE, the call to ndi_busop_bus_config will return as 7972 * soon as the desired device is enumerated via hotplug - so we are 7973 * not committed to waiting the entire time. 7974 * 7975 * We are typically outside the window, so timeout is 0. 7976 */ 7977 sync_usec = tgtmap->tgtmap_create_csync_usec; 7978 if (tgtmap->tgtmap_create_window) { 7979 tsa = ddi_get_lbolt64() - tgtmap->tgtmap_create_time; 7980 if (tsa < drv_usectohz(sync_usec)) { 7981 tsa = drv_usectohz(sync_usec) - tsa; 7982 ret = ndi_busop_bus_config(self, 7983 flags, op, arg, childp, (clock_t)tsa); 7984 } else 7985 tsa = 0; /* passed window */ 7986 7987 /* First one out closes the window. */ 7988 tgtmap->tgtmap_create_window = 0; 7989 } else if (op == BUS_CONFIG_ONE) 7990 ret = ndi_busop_bus_config(self, flags, op, arg, childp, 0); 7991 7992 /* Return if doing a BUS_CONFIG_ONE and we found what we want. */ 7993 if ((op == BUS_CONFIG_ONE) && (ret == NDI_SUCCESS)) 7994 goto out; /* performance path */ 7995 7996 /* 7997 * We sync if we were in the window, on the first bus_config_one, and 7998 * every bus_config_all (or bus_config_driver). 7999 */ 8000 if (tsa || (tgtmap->tgtmap_sync_cnt == 0) || 8001 (op != BUS_CONFIG_ONE)) { 8002 /* 8003 * Sync current observations in the map and look again. We 8004 * place an upper bound on the amount of time we will wait for 8005 * sync to complete to avoid a bad device causing this 8006 * busconfig operation to hang. 8007 * 8008 * We are typically stable, so damap_sync returns immediately. 8009 * 8010 * Max time to wait for sync is settle_usec per possible device. 8011 */ 8012 tgtmap->tgtmap_sync_cnt++; 8013 maxdev = damap_size(tgtmap->tgtmap_dam[SCSI_TGT_SCSI_DEVICE]); 8014 maxdev = (maxdev > scsi_hba_map_settle_f) ? maxdev : 8015 scsi_hba_map_settle_f; 8016 sync_usec = maxdev * tgtmap->tgtmap_settle_usec; 8017 synced = scsi_tgtmap_sync((scsi_hba_tgtmap_t *)tgtmap, 8018 sync_usec); 8019 if (!synced) 8020 SCSI_HBA_LOG((_LOGCFG, self, NULL, 8021 "tgtmap_sync timeout")); 8022 } else 8023 synced = -1; 8024 8025 if (op == BUS_CONFIG_ONE) 8026 ret = scsi_hba_bus_configone(self, flags, arg, childp); 8027 else 8028 ret = ndi_busop_bus_config(self, flags, op, arg, childp, 0); 8029 8030 out: 8031 #ifdef DEBUG 8032 if (ret != NDI_SUCCESS) { 8033 if (scsi_hba_bus_config_failure_msg || 8034 scsi_hba_bus_config_failure_dbg) { 8035 scsi_hba_bus_config_failure_msg--; 8036 printf("%s%d: bus_config_tgtmap %p failure on %s: " 8037 "%d %d\n", 8038 ddi_driver_name(self), ddi_get_instance(self), 8039 (void *)tgtmap, 8040 (op == BUS_CONFIG_ONE) ? (char *)arg : "ALL", 8041 (int)tsa, synced); 8042 } 8043 if (scsi_hba_bus_config_failure_dbg) { 8044 scsi_hba_bus_config_failure_dbg--; 8045 debug_enter("config_tgtmap failure"); 8046 } 8047 } else if (scsi_hba_bus_config_success_msg || 8048 scsi_hba_bus_config_success_dbg) { 8049 scsi_hba_bus_config_success_msg--; 8050 printf("%s%d: bus_config_tgtmap %p success on %s: %d %d\n", 8051 ddi_driver_name(self), ddi_get_instance(self), 8052 (void *)tgtmap, 8053 (op == BUS_CONFIG_ONE) ? (char *)arg : "ALL", 8054 (int)tsa, synced); 8055 if (scsi_hba_bus_config_success_dbg) { 8056 scsi_hba_bus_config_success_dbg--; 8057 debug_enter("config_tgtmap success"); 8058 } 8059 } 8060 #endif /* DEBUG */ 8061 return (ret); 8062 } 8063 8064 static int 8065 scsi_hba_bus_unconfig_tgtmap(dev_info_t *self, uint_t flags, 8066 ddi_bus_config_op_t op, void *arg) 8067 { 8068 int ret = NDI_FAILURE; 8069 8070 switch (op) { 8071 case BUS_UNCONFIG_ONE: 8072 case BUS_UNCONFIG_DRIVER: 8073 case BUS_UNCONFIG_ALL: 8074 ret = NDI_SUCCESS; 8075 break; 8076 default: 8077 break; 8078 } 8079 8080 if (ret == NDI_SUCCESS) { 8081 flags &= ~NDI_DEVI_REMOVE; 8082 ret = ndi_busop_bus_unconfig(self, flags, op, arg); 8083 } 8084 return (ret); 8085 } 8086 8087 static int 8088 scsi_hba_bus_config_iportmap(dev_info_t *self, uint_t flags, 8089 ddi_bus_config_op_t op, void *arg, dev_info_t **childp) 8090 { 8091 scsi_hba_tran_t *tran; 8092 impl_scsi_iportmap_t *iportmap; 8093 dev_info_t *child; 8094 boolean_t enteredv; 8095 uint64_t tsa = 0; /* clock64_t */ 8096 int sync_usec; 8097 int synced; 8098 int ret = NDI_FAILURE; 8099 8100 if ((op != BUS_CONFIG_ONE) && (op != BUS_CONFIG_ALL) && 8101 (op != BUS_CONFIG_DRIVER)) 8102 goto out; 8103 8104 tran = ndi_flavorv_get(self, SCSA_FLAVOR_SCSI_DEVICE); 8105 iportmap = (impl_scsi_iportmap_t *)tran->tran_iportmap; 8106 ASSERT(iportmap); 8107 8108 /* 8109 * MPXIO is never a sure thing (and we have mixed children), so 8110 * set NDI_NDI_FALLBACK so that ndi_busop_bus_config will 8111 * search for both devinfo and pathinfo children. 8112 * 8113 * Future: Remove NDI_MDI_FALLBACK since devcfg.c now looks for 8114 * devinfo/pathinfo children in parallel (instead of old way of 8115 * looking for one form of child and then doing "fallback" to 8116 * look for other form of child). 8117 */ 8118 flags |= NDI_MDI_FALLBACK; /* devinfo&pathinfo children */ 8119 8120 /* 8121 * If bus_config occurred within the map create-to-hotplug_sync window, 8122 * we need the framework to wait for children that are physicaly 8123 * present at map create time to show up (via iportmap hotplug config). 8124 * 8125 * The duration of this window is specified by the HBA driver at 8126 * scsi_hba_iportmap_create(9F) time (during attach(9E)). Its 8127 * 'csync_usec' value is selected based on how long it takes the HBA 8128 * driver to get from map creation to initial observation for something 8129 * already plugged in. Estimate high, a low estimate can result in 8130 * devices not showing up correctly on first reference. The call to 8131 * ndi_busop_bus_config needs a timeout value large enough so that 8132 * the map sync call further down is not a noop (i.e. done against 8133 * an empty map when something is infact plugged in). With 8134 * BUS_CONFIG_ONE, the call to ndi_busop_bus_config will return as 8135 * soon as the desired device is enumerated via hotplug - so we are 8136 * not committed to waiting the entire time. 8137 * 8138 * We are typically outside the window, so timeout is 0. 8139 */ 8140 sync_usec = iportmap->iportmap_create_csync_usec; 8141 if (iportmap->iportmap_create_window) { 8142 tsa = ddi_get_lbolt64() - iportmap->iportmap_create_time; 8143 if (tsa < drv_usectohz(sync_usec)) { 8144 tsa = drv_usectohz(sync_usec) - tsa; 8145 ret = ndi_busop_bus_config(self, 8146 flags, op, arg, childp, (clock_t)tsa); 8147 } else 8148 tsa = 0; /* passed window */ 8149 8150 /* First one out closes the window. */ 8151 iportmap->iportmap_create_window = 0; 8152 } else if (op == BUS_CONFIG_ONE) 8153 ret = ndi_busop_bus_config(self, flags, op, arg, childp, 0); 8154 8155 /* Return if doing a BUS_CONFIG_ONE and we found what we want. */ 8156 if ((op == BUS_CONFIG_ONE) && (ret == NDI_SUCCESS)) 8157 goto out; /* performance path */ 8158 8159 /* 8160 * We sync if we were in the window, on the first bus_config_one, and 8161 * every bus_config_all (or bus_config_driver). 8162 */ 8163 if (tsa || (iportmap->iportmap_sync_cnt == 0) || 8164 (op != BUS_CONFIG_ONE)) { 8165 /* 8166 * Sync current observations in the map and look again. We 8167 * place an upper bound on the amount of time we will wait for 8168 * sync to complete to avoid a bad device causing this 8169 * busconfig operation to hang. 8170 * 8171 * We are typically stable, so damap_sync returns immediately. 8172 * 8173 * Max time to wait for sync is settle_usec times settle factor. 8174 */ 8175 iportmap->iportmap_sync_cnt++; 8176 synced = damap_sync(iportmap->iportmap_dam, sync_usec); 8177 if (!synced) 8178 SCSI_HBA_LOG((_LOGCFG, self, NULL, 8179 "iportmap_sync timeout")); 8180 } else 8181 synced = -1; 8182 8183 if (op == BUS_CONFIG_ONE) { 8184 /* create the iport node child */ 8185 scsi_hba_devi_enter(self, &enteredv); 8186 if ((child = scsi_hba_bus_config_port(self, (char *)arg, 8187 SE_BUSCONFIG)) != NULL) { 8188 if (childp) { 8189 ndi_hold_devi(child); 8190 *childp = child; 8191 } 8192 ret = NDI_SUCCESS; 8193 } 8194 scsi_hba_devi_exit(self, enteredv); 8195 } else 8196 ret = ndi_busop_bus_config(self, flags, op, arg, childp, 0); 8197 8198 out: 8199 #ifdef DEBUG 8200 if (ret != NDI_SUCCESS) { 8201 if (scsi_hba_bus_config_failure_msg || 8202 scsi_hba_bus_config_failure_dbg) { 8203 scsi_hba_bus_config_failure_msg--; 8204 printf("%s%d: bus_config_iportmap %p failure on %s: " 8205 "%d %d\n", 8206 ddi_driver_name(self), ddi_get_instance(self), 8207 (void *)iportmap, 8208 (op == BUS_CONFIG_ONE) ? (char *)arg : "ALL", 8209 (int)tsa, synced); 8210 } 8211 if (scsi_hba_bus_config_failure_dbg) { 8212 scsi_hba_bus_config_failure_dbg--; 8213 debug_enter("config_iportmap failure"); 8214 } 8215 } else if (scsi_hba_bus_config_success_msg || 8216 scsi_hba_bus_config_success_dbg) { 8217 scsi_hba_bus_config_success_msg--; 8218 printf("%s%d: bus_config_iportmap %p success on %s: %d %d\n", 8219 ddi_driver_name(self), ddi_get_instance(self), 8220 (void *)iportmap, 8221 (op == BUS_CONFIG_ONE) ? (char *)arg : "ALL", 8222 (int)tsa, synced); 8223 if (scsi_hba_bus_config_success_dbg) { 8224 scsi_hba_bus_config_success_dbg--; 8225 debug_enter("config_iportmap success"); 8226 } 8227 } 8228 #endif /* DEBUG */ 8229 return (ret); 8230 } 8231 8232 static int 8233 scsi_hba_bus_unconfig_iportmap(dev_info_t *self, uint_t flags, 8234 ddi_bus_config_op_t op, void *arg) 8235 { 8236 flags &= ~NDI_DEVI_REMOVE; 8237 return (ndi_busop_bus_unconfig(self, flags, op, arg)); 8238 } 8239 8240 /* 8241 * SCSI HBA bus config enumeration entry point. Called via the bus_ops 8242 * bus_config entry point for all SCSA HBA drivers. 8243 * 8244 * o If an HBA implements its own bus_config via tran_bus_config then we 8245 * invoke it. An HBA that implements its own tran_bus_config entry point 8246 * may still call back into common SCSA code bus_config code for: 8247 * 8248 * o SPI bus_config (scsi_hba_bus_spi) 8249 * o LUN and secondary function enumeration (scsi_hba_enum_lsf_of_t()). 8250 * o configuration of a specific device (scsi_device_config). 8251 * o determining 1275 SCSI nodename and compatible property 8252 * (scsi_hba_nodename_compatible_get/_free). 8253 * 8254 * o Otherwise we implement a SCSI parallel interface (spi) bus config. 8255 * 8256 * Return NDI_SUCCESS if we might have created a new node. 8257 * Return NDI_FAILURE if we definitely did not create a new node. 8258 */ 8259 static int 8260 scsi_hba_bus_config(dev_info_t *self, uint_t flags, 8261 ddi_bus_config_op_t op, void *arg, dev_info_t **childp) 8262 { 8263 scsi_hba_tran_t *tran; 8264 int ret; 8265 8266 /* make sure that we will not disappear */ 8267 ASSERT(DEVI(self)->devi_ref); 8268 8269 tran = ndi_flavorv_get(self, SCSA_FLAVOR_SCSI_DEVICE); 8270 if (tran == NULL) { 8271 /* NULL tran driver.conf config (used by cmdk). */ 8272 if ((op == BUS_CONFIG_ONE) || (flags & NDI_DRV_CONF_REPROBE)) 8273 flags |= NDI_CONFIG_REPROBE; 8274 return (ndi_busop_bus_config(self, flags, op, arg, childp, 0)); 8275 } 8276 8277 /* Check if self is HBA-only node. */ 8278 if (tran->tran_hba_flags & SCSI_HBA_HBA) { 8279 /* The bus_config request is to configure iports below HBA. */ 8280 8281 #ifdef sparc 8282 /* 8283 * Sparc's 'boot-device' OBP property value lacks an /iport@X/ 8284 * component. Prior to the mount of root, we drive a disk@ 8285 * BUS_CONFIG_ONE operatino down a level to resolve an 8286 * OBP 'boot-device' path. 8287 * 8288 * Future: Add (modrootloaded == 0) below, and insure that 8289 * all attempts bus_conf of 'bo_name' (in OBP form) occur 8290 * prior to 'modrootloaded = 1;' assignment in vfs_mountroot. 8291 */ 8292 if ((op == BUS_CONFIG_ONE) && 8293 (strncmp((char *)arg, "disk@", strlen("disk@")) == 0)) { 8294 return (scsi_hba_bus_config_prom_node(self, 8295 flags, arg, childp)); 8296 } 8297 #endif /* sparc */ 8298 8299 if (tran->tran_iportmap) { 8300 /* config based on scsi_hba_iportmap API */ 8301 ret = scsi_hba_bus_config_iportmap(self, 8302 flags, op, arg, childp); 8303 } else { 8304 /* config based on 'iport_register' API */ 8305 ret = scsi_hba_bus_config_iports(self, 8306 flags, op, arg, childp); 8307 } 8308 return (ret); 8309 } 8310 8311 /* Check to see how the iport/HBA does target/lun bus config. */ 8312 if (tran->tran_bus_config) { 8313 /* HBA config based on Sun-private/legacy tran_bus_config */ 8314 ret = tran->tran_bus_config(self, flags, op, arg, childp); 8315 } else if (tran->tran_tgtmap) { 8316 /* SCSAv3 config based on scsi_hba_tgtmap_*() API */ 8317 ret = scsi_hba_bus_config_tgtmap(self, flags, op, arg, childp); 8318 } else { 8319 /* SCSA config based on SCSI Parallel Interconnect */ 8320 ret = scsi_hba_bus_config_spi(self, flags, op, arg, childp); 8321 } 8322 return (ret); 8323 } 8324 8325 /* 8326 * Called via the bus_ops bus_unconfig entry point for SCSI HBA drivers. 8327 */ 8328 static int 8329 scsi_hba_bus_unconfig(dev_info_t *self, uint_t flags, 8330 ddi_bus_config_op_t op, void *arg) 8331 { 8332 boolean_t enteredv; 8333 scsi_hba_tran_t *tran; 8334 int ret; 8335 8336 tran = ddi_get_driver_private(self); 8337 if (tran == NULL) { 8338 /* NULL tran driver.conf unconfig (used by cmdk). */ 8339 return (ndi_busop_bus_unconfig(self, flags, op, arg)); 8340 } 8341 8342 /* 8343 * Purge barrier/probe node children. We do this prior to 8344 * tran_bus_unconfig in case the unconfig implementation calls back 8345 * into the common code at a different enumeration level, such a 8346 * scsi_device_config, which still creates barrier/probe nodes. 8347 */ 8348 scsi_hba_devi_enter(self, &enteredv); 8349 scsi_hba_barrier_purge(self); 8350 scsi_hba_devi_exit(self, enteredv); 8351 8352 /* DEBUG: for testing, allow bus_unconfig do drive removal. */ 8353 if (scsi_hba_bus_unconfig_remove) 8354 flags |= NDI_DEVI_REMOVE; 8355 8356 /* Check if self is HBA-only node. */ 8357 if (tran->tran_hba_flags & SCSI_HBA_HBA) { 8358 /* The bus_config request is to unconfigure iports below HBA. */ 8359 if (tran->tran_iportmap) { 8360 /* SCSAv3 unconfig based on scsi_hba_iportmap API */ 8361 ret = scsi_hba_bus_unconfig_iportmap(self, 8362 flags, op, arg); 8363 } else if (tran->tran_bus_unconfig) { 8364 /* HBA unconfig based on Sun-private/legacy API */ 8365 ret = tran->tran_bus_unconfig(self, flags, op, arg); 8366 } else { 8367 /* Standard framework unconfig. */ 8368 ret = ndi_busop_bus_unconfig(self, flags, op, arg); 8369 } 8370 return (ret); 8371 } 8372 8373 /* Check to see how the iport/HBA does target/lun bus unconfig. */ 8374 if (tran->tran_bus_unconfig) { 8375 /* HBA unconfig based on Sun-private/legacy tran_bus_unconfig */ 8376 ret = tran->tran_bus_unconfig(self, flags, op, arg); 8377 } else if (tran->tran_tgtmap) { 8378 /* SCSAv3 unconfig based on scsi_hba_tgtmap_*() API */ 8379 ret = scsi_hba_bus_unconfig_tgtmap(self, flags, op, arg); 8380 } else { 8381 /* SCSA unconfig based on SCSI Parallel Interconnect */ 8382 ret = scsi_hba_bus_unconfig_spi(self, flags, op, arg); 8383 } 8384 return (ret); 8385 } 8386 8387 static int 8388 scsi_tgtmap_scsi_config(void *arg, damap_t *mapp, damap_id_t tgtid) 8389 { 8390 scsi_hba_tran_t *tran = (scsi_hba_tran_t *)arg; 8391 dev_info_t *self = tran->tran_iport_dip; 8392 impl_scsi_tgtmap_t *tgtmap; 8393 char *tgtaddr; 8394 int cfg_status, mt; 8395 8396 tgtmap = (impl_scsi_tgtmap_t *)tran->tran_tgtmap; 8397 tgtaddr = damap_id2addr(mapp, tgtid); 8398 8399 if (scsi_lunmap_create(self, tgtmap, tgtaddr) != DDI_SUCCESS) { 8400 SCSI_HBA_LOG((_LOG_NF(WARN), 8401 "failed to create lunmap for %s", tgtaddr)); 8402 } 8403 8404 mt = ddi_prop_get_int(DDI_DEV_T_ANY, self, 8405 DDI_PROP_NOTPROM | DDI_PROP_DONTPASS, "scsi-enumeration", 8406 scsi_enumeration); 8407 mt |= scsi_hba_log_mt_disable; 8408 8409 cfg_status = scsi_hba_bus_config_taddr(self, tgtaddr, mt, SE_HP); 8410 if (cfg_status != NDI_SUCCESS) { 8411 SCSI_HBA_LOG((_LOGCFG, self, NULL, "%s @%s config status %d", 8412 damap_name(mapp), tgtaddr, cfg_status)); 8413 scsi_lunmap_destroy(self, tgtmap, tgtaddr); 8414 return (DAM_FAILURE); 8415 } 8416 8417 return (DAM_SUCCESS); 8418 } 8419 8420 8421 static int 8422 scsi_tgtmap_scsi_unconfig(void *arg, damap_t *mapp, damap_id_t tgtid) 8423 { 8424 scsi_hba_tran_t *tran = (scsi_hba_tran_t *)arg; 8425 dev_info_t *self = tran->tran_iport_dip; 8426 impl_scsi_tgtmap_t *tgtmap; 8427 char *tgt_addr; 8428 8429 tgtmap = (impl_scsi_tgtmap_t *)tran->tran_tgtmap; 8430 tgt_addr = damap_id2addr(mapp, tgtid); 8431 8432 SCSI_HBA_LOG((_LOGUNCFG, self, NULL, "%s @%s", damap_name(mapp), 8433 tgt_addr)); 8434 scsi_lunmap_destroy(self, tgtmap, tgt_addr); 8435 return (DAM_SUCCESS); 8436 } 8437 8438 static int 8439 scsi_tgtmap_smp_config(void *arg, damap_t *mapp, damap_id_t tgtid) 8440 { 8441 scsi_hba_tran_t *tran = (scsi_hba_tran_t *)arg; 8442 dev_info_t *self = tran->tran_iport_dip; 8443 char *addr; 8444 8445 addr = damap_id2addr(mapp, tgtid); 8446 SCSI_HBA_LOG((_LOGCFG, self, NULL, "%s @%s", damap_name(mapp), addr)); 8447 8448 return ((smp_hba_bus_config_taddr(self, addr) == NDI_SUCCESS) ? 8449 DAM_SUCCESS : DAM_FAILURE); 8450 } 8451 8452 static int 8453 scsi_tgtmap_smp_unconfig(void *arg, damap_t *mapp, damap_id_t tgtid) 8454 { 8455 scsi_hba_tran_t *tran = (scsi_hba_tran_t *)arg; 8456 dev_info_t *self = tran->tran_iport_dip; 8457 char *addr; 8458 dev_info_t *child; 8459 char nameaddr[SCSI_MAXNAMELEN]; 8460 boolean_t enteredv; 8461 8462 addr = damap_id2addr(mapp, tgtid); 8463 SCSI_HBA_LOG((_LOGUNCFG, self, NULL, "%s @%s", damap_name(mapp), addr)); 8464 8465 (void) snprintf(nameaddr, sizeof (nameaddr), "smp@%s", addr); 8466 scsi_hba_devi_enter(self, &enteredv); 8467 if ((child = ndi_devi_findchild(self, nameaddr)) == NULL) { 8468 scsi_hba_devi_exit(self, enteredv); 8469 return (DAM_SUCCESS); 8470 } 8471 8472 if (ndi_devi_offline(child, 8473 NDI_DEVFS_CLEAN | NDI_DEVI_REMOVE) == DDI_SUCCESS) { 8474 SCSI_HBA_LOG((_LOGUNCFG, self, NULL, 8475 "devinfo smp@%s offlined and removed", addr)); 8476 } else if (ndi_devi_device_remove(child)) { 8477 /* Offline/remove failed, note new device_remove */ 8478 SCSI_HBA_LOG((_LOGUNCFG, self, NULL, 8479 "devinfo smp@%s offline failed, device_remove", 8480 addr)); 8481 } 8482 scsi_hba_devi_exit(self, enteredv); 8483 return (DAM_SUCCESS); 8484 } 8485 8486 /* ARGSUSED1 */ 8487 static void 8488 scsi_tgtmap_smp_activate(void *map_priv, char *tgt_addr, int addrid, 8489 void **tgt_privp) 8490 { 8491 impl_scsi_tgtmap_t *tgtmap = (impl_scsi_tgtmap_t *)map_priv; 8492 dev_info_t *self = tgtmap->tgtmap_tran->tran_iport_dip; 8493 8494 if (tgtmap->tgtmap_activate_cb) { 8495 SCSI_HBA_LOG((_LOGTGT, self, NULL, "%s @%s activated", 8496 damap_name(tgtmap->tgtmap_dam[SCSI_TGT_SMP_DEVICE]), 8497 tgt_addr)); 8498 8499 (*tgtmap->tgtmap_activate_cb)(tgtmap->tgtmap_mappriv, 8500 tgt_addr, SCSI_TGT_SMP_DEVICE, tgt_privp); 8501 } 8502 } 8503 8504 /* ARGSUSED1 */ 8505 static void 8506 scsi_tgtmap_smp_deactivate(void *map_priv, char *tgt_addr, int addrid, 8507 void *tgt_privp, damap_deact_rsn_t damap_rsn) 8508 { 8509 impl_scsi_tgtmap_t *tgtmap = (impl_scsi_tgtmap_t *)map_priv; 8510 dev_info_t *self = tgtmap->tgtmap_tran->tran_iport_dip; 8511 boolean_t tgtmap_rereport; 8512 scsi_tgtmap_deact_rsn_t tgtmap_rsn; 8513 8514 if (tgtmap->tgtmap_deactivate_cb) { 8515 SCSI_HBA_LOG((_LOGTGT, self, NULL, "%s @%s deactivated %d", 8516 damap_name(tgtmap->tgtmap_dam[SCSI_TGT_SMP_DEVICE]), 8517 tgt_addr, damap_rsn)); 8518 8519 if (damap_rsn == DAMAP_DEACT_RSN_GONE) 8520 tgtmap_rsn = SCSI_TGT_DEACT_RSN_GONE; 8521 else if (damap_rsn == DAMAP_DEACT_RSN_CFG_FAIL) 8522 tgtmap_rsn = SCSI_TGT_DEACT_RSN_CFG_FAIL; 8523 else if (damap_rsn == DAMAP_DEACT_RSN_UNSTBL) 8524 tgtmap_rsn = SCSI_TGT_DEACT_RSN_UNSTBL; 8525 else { 8526 SCSI_HBA_LOG((_LOG(WARN), self, NULL, 8527 "%s @%s deactivated with unknown rsn", 8528 damap_name(tgtmap->tgtmap_dam[SCSI_TGT_SMP_DEVICE]), 8529 tgt_addr)); 8530 return; 8531 } 8532 8533 tgtmap_rereport = (*tgtmap->tgtmap_deactivate_cb) 8534 (tgtmap->tgtmap_mappriv, tgt_addr, 8535 SCSI_TGT_SMP_DEVICE, tgt_privp, tgtmap_rsn); 8536 8537 if ((tgtmap_rsn == SCSI_TGT_DEACT_RSN_CFG_FAIL) && 8538 (tgtmap_rereport == B_FALSE)) { 8539 SCSI_HBA_LOG((_LOG(WARN), NULL, self, 8540 "%s enumeration failed, no more retries until " 8541 "config change occurs", tgt_addr)); 8542 } 8543 } 8544 } 8545 8546 /* ARGSUSED1 */ 8547 static void 8548 scsi_tgtmap_scsi_activate(void *map_priv, char *tgt_addr, int addrid, 8549 void **tgt_privp) 8550 { 8551 impl_scsi_tgtmap_t *tgtmap = (impl_scsi_tgtmap_t *)map_priv; 8552 dev_info_t *self = tgtmap->tgtmap_tran->tran_iport_dip; 8553 8554 if (tgtmap->tgtmap_activate_cb) { 8555 SCSI_HBA_LOG((_LOGTGT, self, NULL, "%s @%s activated", 8556 damap_name(tgtmap->tgtmap_dam[SCSI_TGT_SCSI_DEVICE]), 8557 tgt_addr)); 8558 8559 (*tgtmap->tgtmap_activate_cb)(tgtmap->tgtmap_mappriv, 8560 tgt_addr, SCSI_TGT_SCSI_DEVICE, tgt_privp); 8561 } 8562 } 8563 8564 /* ARGSUSED1 */ 8565 static void 8566 scsi_tgtmap_scsi_deactivate(void *map_priv, char *tgt_addr, int addrid, 8567 void *tgt_privp, damap_deact_rsn_t damap_rsn) 8568 { 8569 impl_scsi_tgtmap_t *tgtmap = (impl_scsi_tgtmap_t *)map_priv; 8570 dev_info_t *self = tgtmap->tgtmap_tran->tran_iport_dip; 8571 boolean_t tgtmap_rereport; 8572 scsi_tgtmap_deact_rsn_t tgtmap_rsn; 8573 8574 if (tgtmap->tgtmap_deactivate_cb) { 8575 SCSI_HBA_LOG((_LOGTGT, self, NULL, "%s @%s deactivated %d", 8576 damap_name(tgtmap->tgtmap_dam[SCSI_TGT_SCSI_DEVICE]), 8577 tgt_addr, damap_rsn)); 8578 8579 if (damap_rsn == DAMAP_DEACT_RSN_GONE) 8580 tgtmap_rsn = SCSI_TGT_DEACT_RSN_GONE; 8581 else if (damap_rsn == DAMAP_DEACT_RSN_CFG_FAIL) 8582 tgtmap_rsn = SCSI_TGT_DEACT_RSN_CFG_FAIL; 8583 else if (damap_rsn == DAMAP_DEACT_RSN_UNSTBL) 8584 tgtmap_rsn = SCSI_TGT_DEACT_RSN_UNSTBL; 8585 else { 8586 SCSI_HBA_LOG((_LOG(WARN), self, NULL, 8587 "%s @%s deactivated with unknown rsn", damap_name( 8588 tgtmap->tgtmap_dam[SCSI_TGT_SCSI_DEVICE]), 8589 tgt_addr)); 8590 return; 8591 } 8592 8593 tgtmap_rereport = (*tgtmap->tgtmap_deactivate_cb) 8594 (tgtmap->tgtmap_mappriv, tgt_addr, 8595 SCSI_TGT_SCSI_DEVICE, tgt_privp, tgtmap_rsn); 8596 8597 if ((tgtmap_rsn == SCSI_TGT_DEACT_RSN_CFG_FAIL) && 8598 (tgtmap_rereport == B_FALSE)) { 8599 SCSI_HBA_LOG((_LOG(WARN), NULL, self, 8600 "%s enumeration failed, no more retries until " 8601 "config change occurs", tgt_addr)); 8602 } 8603 } 8604 } 8605 8606 8607 int 8608 scsi_hba_tgtmap_create(dev_info_t *self, scsi_tgtmap_mode_t mode, 8609 int csync_usec, int settle_usec, void *tgtmap_priv, 8610 scsi_tgt_activate_cb_t activate_cb, scsi_tgt_deactivate_cb_t deactivate_cb, 8611 scsi_hba_tgtmap_t **handle) 8612 { 8613 scsi_hba_tran_t *tran; 8614 damap_t *mapp; 8615 char context[64]; 8616 impl_scsi_tgtmap_t *tgtmap; 8617 damap_rptmode_t rpt_style; 8618 char *scsi_binding_set; 8619 int optflags; 8620 8621 if (self == NULL || csync_usec == 0 || 8622 settle_usec == 0 || handle == NULL) 8623 return (DDI_FAILURE); 8624 8625 *handle = NULL; 8626 8627 if (scsi_hba_iport_unit_address(self) == NULL) 8628 return (DDI_FAILURE); 8629 8630 switch (mode) { 8631 case SCSI_TM_FULLSET: 8632 rpt_style = DAMAP_REPORT_FULLSET; 8633 break; 8634 case SCSI_TM_PERADDR: 8635 rpt_style = DAMAP_REPORT_PERADDR; 8636 break; 8637 default: 8638 return (DDI_FAILURE); 8639 } 8640 8641 tran = (scsi_hba_tran_t *)ddi_get_driver_private(self); 8642 ASSERT(tran); 8643 if (tran == NULL) 8644 return (DDI_FAILURE); 8645 8646 tgtmap = kmem_zalloc(sizeof (*tgtmap), KM_SLEEP); 8647 tgtmap->tgtmap_tran = tran; 8648 tgtmap->tgtmap_activate_cb = activate_cb; 8649 tgtmap->tgtmap_deactivate_cb = deactivate_cb; 8650 tgtmap->tgtmap_mappriv = tgtmap_priv; 8651 8652 tgtmap->tgtmap_create_window = 1; /* start with window */ 8653 tgtmap->tgtmap_create_time = ddi_get_lbolt64(); 8654 tgtmap->tgtmap_create_csync_usec = csync_usec; 8655 tgtmap->tgtmap_settle_usec = settle_usec; 8656 tgtmap->tgtmap_sync_cnt = 0; 8657 8658 optflags = (ddi_prop_get_int(DDI_DEV_T_ANY, self, 8659 DDI_PROP_NOTPROM | DDI_PROP_DONTPASS, "scsi-enumeration", 8660 scsi_enumeration) & SCSI_ENUMERATION_MT_TARGET_DISABLE) ? 8661 DAMAP_SERIALCONFIG : DAMAP_MTCONFIG; 8662 8663 (void) snprintf(context, sizeof (context), "%s%d.tgtmap.scsi", 8664 ddi_driver_name(self), ddi_get_instance(self)); 8665 SCSI_HBA_LOG((_LOGTGT, self, NULL, "%s", context)); 8666 if (damap_create(context, rpt_style, optflags, settle_usec, 8667 tgtmap, scsi_tgtmap_scsi_activate, scsi_tgtmap_scsi_deactivate, 8668 tran, scsi_tgtmap_scsi_config, scsi_tgtmap_scsi_unconfig, 8669 &mapp) != DAM_SUCCESS) { 8670 kmem_free(tgtmap, sizeof (*tgtmap)); 8671 return (DDI_FAILURE); 8672 } 8673 tgtmap->tgtmap_dam[SCSI_TGT_SCSI_DEVICE] = mapp; 8674 8675 (void) snprintf(context, sizeof (context), "%s%d.tgtmap.smp", 8676 ddi_driver_name(self), ddi_get_instance(self)); 8677 SCSI_HBA_LOG((_LOGTGT, self, NULL, "%s", context)); 8678 if (damap_create(context, rpt_style, optflags, 8679 settle_usec, tgtmap, scsi_tgtmap_smp_activate, 8680 scsi_tgtmap_smp_deactivate, 8681 tran, scsi_tgtmap_smp_config, scsi_tgtmap_smp_unconfig, 8682 &mapp) != DAM_SUCCESS) { 8683 damap_destroy(tgtmap->tgtmap_dam[SCSI_TGT_SCSI_DEVICE]); 8684 kmem_free(tgtmap, sizeof (*tgtmap)); 8685 return (DDI_FAILURE); 8686 } 8687 tgtmap->tgtmap_dam[SCSI_TGT_SMP_DEVICE] = mapp; 8688 8689 tran->tran_tgtmap = (scsi_hba_tgtmap_t *)tgtmap; 8690 *handle = (scsi_hba_tgtmap_t *)tgtmap; 8691 8692 /* 8693 * We have now set tran_tgtmap, marking the tran as using tgtmap 8694 * enumeration services. To prevent the generation of legacy spi 8695 * 'binding-set' compatible forms, remove the 'scsi-binding-set' 8696 * property. 8697 */ 8698 if (ddi_prop_lookup_string(DDI_DEV_T_ANY, self, 8699 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, "scsi-binding-set", 8700 &scsi_binding_set) == DDI_PROP_SUCCESS) { 8701 if (strcmp(scsi_binding_set, scsi_binding_set_spi) == 0) 8702 (void) ndi_prop_remove(DDI_DEV_T_NONE, self, 8703 "scsi-binding-set"); 8704 ddi_prop_free(scsi_binding_set); 8705 } 8706 return (DDI_SUCCESS); 8707 } 8708 8709 void 8710 scsi_hba_tgtmap_destroy(scsi_hba_tgtmap_t *handle) 8711 { 8712 impl_scsi_tgtmap_t *tgtmap = (impl_scsi_tgtmap_t *)handle; 8713 dev_info_t *self = tgtmap->tgtmap_tran->tran_iport_dip; 8714 int i; 8715 8716 for (i = 0; i < SCSI_TGT_NTYPES; i++) { 8717 if (tgtmap->tgtmap_dam[i]) { 8718 SCSI_HBA_LOG((_LOGTGT, self, NULL, 8719 "%s", damap_name(tgtmap->tgtmap_dam[i]))); 8720 damap_destroy(tgtmap->tgtmap_dam[i]); 8721 } 8722 } 8723 kmem_free(tgtmap, sizeof (*tgtmap)); 8724 } 8725 8726 /* return 1 if all maps ended up syned */ 8727 static int 8728 scsi_tgtmap_sync(scsi_hba_tgtmap_t *handle, int sync_usec) 8729 { 8730 impl_scsi_tgtmap_t *tgtmap = (impl_scsi_tgtmap_t *)handle; 8731 dev_info_t *self = tgtmap->tgtmap_tran->tran_iport_dip; 8732 int all_synced = 1; 8733 int synced; 8734 int i; 8735 8736 for (i = 0; i < SCSI_TGT_NTYPES; i++) { 8737 if (tgtmap->tgtmap_dam[i]) { 8738 SCSI_HBA_LOG((_LOGTGT, self, NULL, "%s sync begin", 8739 damap_name(tgtmap->tgtmap_dam[i]))); 8740 synced = damap_sync(tgtmap->tgtmap_dam[i], sync_usec); 8741 all_synced &= synced; 8742 SCSI_HBA_LOG((_LOGTGT, self, NULL, "%s sync end %d", 8743 damap_name(tgtmap->tgtmap_dam[i]), synced)); 8744 8745 } 8746 } 8747 return (all_synced); 8748 } 8749 8750 /* return 1 if all maps ended up empty */ 8751 static int 8752 scsi_tgtmap_is_empty(scsi_hba_tgtmap_t *handle) 8753 { 8754 impl_scsi_tgtmap_t *tgtmap = (impl_scsi_tgtmap_t *)handle; 8755 dev_info_t *self = tgtmap->tgtmap_tran->tran_iport_dip; 8756 int all_empty = 1; 8757 int empty; 8758 int i; 8759 8760 for (i = 0; i < SCSI_TGT_NTYPES; i++) { 8761 if (tgtmap->tgtmap_dam[i]) { 8762 empty = damap_is_empty(tgtmap->tgtmap_dam[i]); 8763 all_empty &= empty; 8764 SCSI_HBA_LOG((_LOGTGT, self, NULL, "%s is_empty %d", 8765 damap_name(tgtmap->tgtmap_dam[i]), empty)); 8766 } 8767 } 8768 8769 return (all_empty); 8770 } 8771 8772 static int 8773 scsi_tgtmap_beginf(scsi_hba_tgtmap_t *handle, boolean_t do_begin) 8774 { 8775 impl_scsi_tgtmap_t *tgtmap = (impl_scsi_tgtmap_t *)handle; 8776 dev_info_t *self = tgtmap->tgtmap_tran->tran_iport_dip; 8777 char *context; 8778 int rv = DAM_SUCCESS; 8779 int i; 8780 8781 for (i = 0; i < SCSI_TGT_NTYPES; i++) { 8782 if (tgtmap->tgtmap_dam[i] == NULL) { 8783 continue; 8784 } 8785 8786 context = damap_name(tgtmap->tgtmap_dam[i]); 8787 if (do_begin == B_TRUE) { 8788 if (i == SCSI_TGT_SCSI_DEVICE) { 8789 /* 8790 * In scsi_device context, so we have the 8791 * 'context' string, diagnose the case where 8792 * the tgtmap caller is failing to make 8793 * forward progress, i.e. the caller is never 8794 * completing an observation by calling 8795 * scsi_hbg_tgtmap_set_end. If this occurs, 8796 * the solaris target/lun state may be out 8797 * of sync with hardware. 8798 */ 8799 if (tgtmap->tgtmap_reports++ >= 8800 scsi_hba_tgtmap_reports_max) { 8801 tgtmap->tgtmap_noisy++; 8802 if (tgtmap->tgtmap_noisy == 1) { 8803 SCSI_HBA_LOG((_LOG(WARN), 8804 self, NULL, 8805 "%s: failing tgtmap begin", 8806 context)); 8807 } 8808 } 8809 } 8810 8811 rv = damap_addrset_begin(tgtmap->tgtmap_dam[i]); 8812 } else { 8813 rv = damap_addrset_flush(tgtmap->tgtmap_dam[i]); 8814 } 8815 8816 if (rv != DAM_SUCCESS) { 8817 SCSI_HBA_LOG((_LOGTGT, self, NULL, "%s FAIL", context)); 8818 } else { 8819 SCSI_HBA_LOG((_LOGTGT, self, NULL, "%s", context)); 8820 } 8821 } 8822 8823 return ((rv == DAM_SUCCESS) ? DDI_SUCCESS : DDI_FAILURE); 8824 } 8825 8826 8827 int 8828 scsi_hba_tgtmap_set_begin(scsi_hba_tgtmap_t *handle) 8829 { 8830 return (scsi_tgtmap_beginf(handle, B_TRUE)); 8831 } 8832 8833 int 8834 scsi_hba_tgtmap_set_flush(scsi_hba_tgtmap_t *handle) 8835 { 8836 return (scsi_tgtmap_beginf(handle, B_FALSE)); 8837 } 8838 8839 int 8840 scsi_hba_tgtmap_set_add(scsi_hba_tgtmap_t *handle, 8841 scsi_tgtmap_tgt_type_t tgt_type, char *tgt_addr, void *tgt_priv) 8842 { 8843 impl_scsi_tgtmap_t *tgtmap = (impl_scsi_tgtmap_t *)handle; 8844 dev_info_t *self = tgtmap->tgtmap_tran->tran_iport_dip; 8845 8846 if (tgt_type >= SCSI_TGT_NTYPES || !tgtmap->tgtmap_dam[tgt_type]) 8847 return (DDI_FAILURE); 8848 8849 SCSI_HBA_LOG((_LOGTGT, self, NULL, 8850 "%s @%s", damap_name(tgtmap->tgtmap_dam[tgt_type]), tgt_addr)); 8851 8852 return ((damap_addrset_add(tgtmap->tgtmap_dam[tgt_type], tgt_addr, 8853 NULL, NULL, tgt_priv) == DAM_SUCCESS) ? DDI_SUCCESS : DDI_FAILURE); 8854 } 8855 8856 /*ARGSUSED*/ 8857 int 8858 scsi_hba_tgtmap_set_end(scsi_hba_tgtmap_t *handle, uint_t flags) 8859 { 8860 impl_scsi_tgtmap_t *tgtmap = (impl_scsi_tgtmap_t *)handle; 8861 dev_info_t *self = tgtmap->tgtmap_tran->tran_iport_dip; 8862 char *context; 8863 int rv = DDI_SUCCESS; 8864 int i; 8865 8866 tgtmap->tgtmap_reports = tgtmap->tgtmap_noisy = 0; 8867 8868 for (i = 0; i < SCSI_TGT_NTYPES; i++) { 8869 if (tgtmap->tgtmap_dam[i] == NULL) 8870 continue; 8871 context = damap_name(tgtmap->tgtmap_dam[i]); 8872 if (damap_addrset_end( 8873 tgtmap->tgtmap_dam[i], 0) != DAM_SUCCESS) { 8874 SCSI_HBA_LOG((_LOGTGT, self, NULL, "%s FAIL", context)); 8875 rv = DDI_FAILURE; 8876 continue; 8877 } 8878 8879 SCSI_HBA_LOG((_LOGTGT, self, NULL, "%s", context)); 8880 } 8881 return (rv); 8882 } 8883 8884 int 8885 scsi_hba_tgtmap_tgt_add(scsi_hba_tgtmap_t *handle, 8886 scsi_tgtmap_tgt_type_t tgt_type, char *tgt_addr, void *tgt_priv) 8887 { 8888 impl_scsi_tgtmap_t *tgtmap = (impl_scsi_tgtmap_t *)handle; 8889 dev_info_t *self = tgtmap->tgtmap_tran->tran_iport_dip; 8890 8891 if (tgt_type >= SCSI_TGT_NTYPES || !tgtmap->tgtmap_dam[tgt_type]) 8892 return (DDI_FAILURE); 8893 8894 SCSI_HBA_LOG((_LOGTGT, self, NULL, 8895 "%s @%s", damap_name(tgtmap->tgtmap_dam[tgt_type]), tgt_addr)); 8896 8897 return ((damap_addr_add(tgtmap->tgtmap_dam[tgt_type], tgt_addr, NULL, 8898 NULL, tgt_priv) == DAM_SUCCESS) ? DDI_SUCCESS : DDI_FAILURE); 8899 } 8900 8901 int 8902 scsi_hba_tgtmap_tgt_remove(scsi_hba_tgtmap_t *handle, 8903 scsi_tgtmap_tgt_type_t tgt_type, char *tgt_addr) 8904 { 8905 impl_scsi_tgtmap_t *tgtmap = (impl_scsi_tgtmap_t *)handle; 8906 dev_info_t *self = tgtmap->tgtmap_tran->tran_iport_dip; 8907 8908 if (tgt_type >= SCSI_TGT_NTYPES || !tgtmap->tgtmap_dam[tgt_type]) 8909 return (DDI_FAILURE); 8910 8911 SCSI_HBA_LOG((_LOGTGT, self, NULL, 8912 "%s @%s", damap_name(tgtmap->tgtmap_dam[tgt_type]), tgt_addr)); 8913 8914 return ((damap_addr_del(tgtmap->tgtmap_dam[tgt_type], 8915 tgt_addr) == DAM_SUCCESS) ? DDI_SUCCESS : DDI_FAILURE); 8916 } 8917 8918 void 8919 scsi_hba_tgtmap_scan_luns(scsi_hba_tgtmap_t *handle, char *tgt_addr) 8920 { 8921 impl_scsi_tgtmap_t *tgtmap = (impl_scsi_tgtmap_t *)handle; 8922 dev_info_t *self = tgtmap->tgtmap_tran->tran_iport_dip; 8923 struct scsi_lunchg2 *lunchg2; 8924 struct scsi_lunchg2 *p; 8925 char path[MAXPATHLEN]; 8926 8927 (void) ddi_pathname(self, path); 8928 (void) strlcat(path, "/luns@", sizeof (path)); 8929 (void) strlcat(path, tgt_addr, sizeof (path)); 8930 (void) strlcat(path, ",*", sizeof (path)); 8931 8932 mutex_enter(&scsi_lunchg2_mutex); 8933 8934 /* if we're already scheduled to do this, don't submit another one */ 8935 for (p = scsi_lunchg2_list; p != NULL; p = p->lunchg2_next) { 8936 if (strcmp(path, p->lunchg2_path) == 0) { 8937 mutex_exit(&scsi_lunchg2_mutex); 8938 return; 8939 } 8940 } 8941 8942 lunchg2 = kmem_alloc(sizeof (*lunchg2), KM_SLEEP); 8943 lunchg2->lunchg2_path = strdup(path); 8944 lunchg2->lunchg2_next = scsi_lunchg2_list; 8945 scsi_lunchg2_list = lunchg2; 8946 if (lunchg2->lunchg2_next == NULL) 8947 cv_signal(&scsi_lunchg2_cv); 8948 mutex_exit(&scsi_lunchg2_mutex); 8949 } 8950 8951 int 8952 scsi_hba_tgtmap_lookup(scsi_hba_tgtmap_t *handle, 8953 char *tgt_addr, scsi_tgtmap_tgt_type_t *r_type) 8954 { 8955 impl_scsi_tgtmap_t *tgtmap = (impl_scsi_tgtmap_t *)handle; 8956 dev_info_t *self = tgtmap->tgtmap_tran->tran_iport_dip; 8957 damap_id_t tgtid; 8958 int i; 8959 8960 for (i = 0; i < SCSI_TGT_NTYPES; i++) { 8961 tgtid = damap_lookup(tgtmap->tgtmap_dam[i], tgt_addr); 8962 if (tgtid != NODAM) { 8963 *r_type = i; 8964 SCSI_HBA_LOG((_LOG(3), self, NULL, 8965 "%s @%s found: type %d", 8966 damap_name(tgtmap->tgtmap_dam[i]), tgt_addr, i)); 8967 damap_id_rele(tgtmap->tgtmap_dam[i], tgtid); 8968 return (DDI_SUCCESS); 8969 } 8970 } 8971 8972 SCSI_HBA_LOG((_LOG(3), self, NULL, 8973 "%s%d.tgtmap @%s not found", 8974 ddi_driver_name(self), ddi_get_instance(self), tgt_addr)); 8975 return (DDI_FAILURE); 8976 } 8977 8978 /* 8979 * Return the unit-address of an 'iport' node, or NULL for non-iport node. 8980 */ 8981 char * 8982 scsi_hba_iport_unit_address(dev_info_t *self) 8983 { 8984 /* 8985 * NOTE: Since 'self' could be a SCSA iport node or a SCSA HBA node, 8986 * we can't use SCSA flavors: the flavor of a SCSA HBA node is not 8987 * established/owned by SCSA, it is established by the nexus that 8988 * created the SCSA HBA node (PCI) as a child. 8989 * 8990 * NOTE: If we want to support a node_name other than "iport" for 8991 * an iport node then we can add support for a "scsa-iport-node-name" 8992 * property on the SCSA HBA node. A SCSA HBA driver would set this 8993 * property on the SCSA HBA node prior to using the iport API. 8994 */ 8995 if (strcmp(ddi_node_name(self), "iport") == 0) 8996 return (ddi_get_name_addr(self)); 8997 else 8998 return (NULL); 8999 } 9000 9001 /* 9002 * Define a SCSI initiator port (bus/channel) for an HBA card that needs to 9003 * support multiple SCSI ports, but only has a single HBA devinfo node. This 9004 * function should be called from the HBA's attach(9E) implementation (when 9005 * processing the HBA devinfo node attach) after the number of SCSI ports on 9006 * the card is known or when the HBA driver DR handler detects a new port. 9007 * The function returns 0 on failure and 1 on success. 9008 * 9009 * The implementation will add the port value into the "scsi-iports" property 9010 * value maintained on the HBA node as. These properties are used by the generic 9011 * scsi bus_config implementation to dynamicaly enumerate the specified iport 9012 * children. The enumeration code will, on demand, create the appropriate 9013 * iport children with a SCSI_ADDR_PROP_IPORTUA unit address. This node will 9014 * bind to the same driver as the HBA node itself. This means that an HBA 9015 * driver that uses iports should expect probe(9E), attach(9E), and detach(9E) 9016 * calls on the iport children of the HBA. If configuration for all ports was 9017 * already done during HBA node attach, the driver should just return 9018 * DDI_SUCCESS when confronted with an iport node. 9019 * 9020 * A maximum of 32 iport ports are supported per HBA devinfo node. 9021 * 9022 * A NULL "port" can be used to indicate that the framework should enumerate 9023 * target children on the HBA node itself, in addition to enumerating target 9024 * children on any iport nodes declared. There are two reasons that an HBA may 9025 * wish to have target children enumerated on both the HBA node and iport 9026 * node(s): 9027 * 9028 * o If, in the past, HBA hardware had only a single physical port but now 9029 * supports multiple physical ports, the updated driver that supports 9030 * multiple physical ports may want to avoid /devices path upgrade issues 9031 * by enumerating the first physical port under the HBA instead of as a 9032 * iport. 9033 * 9034 * o Some hardware RAID HBA controllers (mlx, chs, etc) support multiple 9035 * SCSI physical ports configured so that various physical devices on 9036 * the physical ports are amalgamated into virtual devices on a virtual 9037 * port. Amalgamated physical devices no longer appear to the host OS 9038 * on the physical ports, but other non-amalgamated devices may still be 9039 * visible on the physical ports. These drivers use a model where the 9040 * physical ports are iport nodes and the HBA node is the virtual port to 9041 * the configured virtual devices. 9042 */ 9043 int 9044 scsi_hba_iport_register(dev_info_t *self, char *port) 9045 { 9046 unsigned int ports = 0; 9047 int rval, i; 9048 char **iports, **newiports; 9049 9050 ASSERT(self); 9051 if (self == NULL) 9052 return (DDI_FAILURE); 9053 9054 rval = ddi_prop_lookup_string_array(DDI_DEV_T_ANY, self, 9055 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, "scsi-iports", &iports, 9056 &ports); 9057 9058 if (ports >= SCSI_HBA_MAX_IPORTS) { 9059 ddi_prop_free(iports); 9060 return (DDI_FAILURE); 9061 } 9062 9063 if (rval == DDI_PROP_SUCCESS) { 9064 for (i = 0; i < ports; i++) { 9065 if (strcmp(port, iports[i]) == 0) { 9066 /* iport already registered */ 9067 ddi_prop_free(iports); 9068 return (DDI_SUCCESS); 9069 } 9070 } 9071 } 9072 9073 newiports = kmem_alloc((sizeof (char *) * (ports + 1)), KM_SLEEP); 9074 9075 for (i = 0; i < ports; i++) { 9076 newiports[i] = strdup(iports[i]); 9077 } 9078 newiports[ports] = strdup(port); 9079 ports++; 9080 9081 if (ddi_prop_update_string_array(DDI_DEV_T_NONE, self, 9082 "scsi-iports", newiports, ports) != DDI_PROP_SUCCESS) { 9083 SCSI_HBA_LOG((_LOG(WARN), self, NULL, 9084 "failed to establish %s %s", 9085 SCSI_ADDR_PROP_IPORTUA, port)); 9086 rval = DDI_FAILURE; 9087 } else { 9088 rval = DDI_SUCCESS; 9089 } 9090 9091 /* If there is iport exist, free property */ 9092 if (ports > 1) 9093 ddi_prop_free(iports); 9094 for (i = 0; i < ports; i++) { 9095 strfree(newiports[i]); 9096 } 9097 kmem_free(newiports, (sizeof (char *)) * ports); 9098 9099 return (rval); 9100 } 9101 9102 /* 9103 * Check if the HBA has any scsi_hba_iport_register()ed children. 9104 */ 9105 int 9106 scsi_hba_iport_exist(dev_info_t *self) 9107 { 9108 unsigned int ports = 0; 9109 char **iports; 9110 int rval; 9111 9112 rval = ddi_prop_lookup_string_array(DDI_DEV_T_ANY, self, 9113 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, "scsi-iports", &iports, 9114 &ports); 9115 9116 if (rval != DDI_PROP_SUCCESS) 9117 return (0); 9118 9119 /* If there is now at least 1 iport, then iports is valid */ 9120 if (ports > 0) { 9121 rval = 1; 9122 } else 9123 rval = 0; 9124 ddi_prop_free(iports); 9125 9126 return (rval); 9127 } 9128 9129 dev_info_t * 9130 scsi_hba_iport_find(dev_info_t *self, char *portnm) 9131 { 9132 char *addr = NULL; 9133 char **iports; 9134 unsigned int num_iports = 0; 9135 int rval = DDI_FAILURE; 9136 int i = 0; 9137 dev_info_t *child = NULL; 9138 9139 /* check to see if this is an HBA that defined scsi iports */ 9140 rval = ddi_prop_lookup_string_array(DDI_DEV_T_ANY, self, 9141 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, "scsi-iports", &iports, 9142 &num_iports); 9143 9144 if (rval != DDI_SUCCESS) { 9145 return (NULL); 9146 } 9147 ASSERT(num_iports > 0); 9148 9149 /* check to see if this port was registered */ 9150 for (i = 0; i < num_iports; i++) { 9151 if (strcmp(iports[i], portnm) == 0) 9152 break; 9153 } 9154 9155 if (i == num_iports) { 9156 child = NULL; 9157 goto out; 9158 } 9159 9160 addr = kmem_zalloc(SCSI_MAXNAMELEN, KM_SLEEP); 9161 (void) snprintf(addr, SCSI_MAXNAMELEN, "iport@%s", portnm); 9162 rval = ndi_devi_config_one(self, addr, &child, NDI_NO_EVENT); 9163 kmem_free(addr, SCSI_MAXNAMELEN); 9164 9165 if (rval != DDI_SUCCESS) { 9166 child = NULL; 9167 } 9168 out: 9169 ddi_prop_free(iports); 9170 return (child); 9171 } 9172 9173 /* 9174 * Search/create the specified iport node 9175 */ 9176 static dev_info_t * 9177 scsi_hba_bus_config_port(dev_info_t *self, char *nameaddr, scsi_enum_t se) 9178 { 9179 dev_info_t *child; /* iport child of HBA node */ 9180 scsi_hba_tran_t *tran; 9181 char *addr; 9182 char *compat; 9183 9184 /* 9185 * See if the iport node already exists. 9186 */ 9187 addr = nameaddr + strlen("iport@"); 9188 if (child = ndi_devi_findchild(self, nameaddr)) { 9189 if (ndi_devi_device_isremoved(child)) { 9190 if ((se == SE_HP) || !ndi_dev_is_hotplug_node(child)) { 9191 if (ndi_devi_device_insert(child)) 9192 SCSI_HBA_LOG((_LOGCFG, self, NULL, 9193 "devinfo iport@%s device_reinsert", 9194 addr)); 9195 } else 9196 return (NULL); 9197 } 9198 return (child); 9199 } 9200 9201 9202 /* 9203 * If config based on scsi_hba_iportmap API, only allow create 9204 * from hotplug. 9205 */ 9206 tran = ndi_flavorv_get(self, SCSA_FLAVOR_SCSI_DEVICE); 9207 ASSERT(tran); 9208 if (tran->tran_iportmap && (se != SE_HP)) 9209 return (NULL); 9210 9211 /* allocate and initialize a new "iport" node */ 9212 ndi_devi_alloc_sleep(self, "iport", 9213 (se == SE_HP) ? DEVI_SID_HP_NODEID : DEVI_SID_NODEID, 9214 &child); 9215 ASSERT(child); 9216 /* 9217 * Set the flavor of the child to be IPORT flavored 9218 */ 9219 ndi_flavor_set(child, SCSA_FLAVOR_IPORT); 9220 9221 /* 9222 * Add the SCSI_ADDR_PROP_IPORTUA addressing property for this child. 9223 * This property is used to identify a iport node, and to represent the 9224 * nodes @addr form via node properties. 9225 * 9226 * Add "compatible" property to the "scsi-iport" node to cause it bind 9227 * to the same driver as the HBA driver. Use the "driver" name 9228 * instead of the "binding name" to distinguish from hw node. 9229 * 9230 * Give the HBA a chance, via tran_set_name_prop, to set additional 9231 * iport node properties or to change the "compatible" binding 9232 * prior to init_child. 9233 * 9234 * NOTE: the order of these operations is important so that 9235 * scsi_hba_iport works when called. 9236 */ 9237 compat = (char *)ddi_driver_name(self); 9238 if ((ndi_prop_update_string(DDI_DEV_T_NONE, child, 9239 SCSI_ADDR_PROP_IPORTUA, addr) != DDI_PROP_SUCCESS) || 9240 (ndi_prop_update_string_array(DDI_DEV_T_NONE, child, 9241 "compatible", &compat, 1) != DDI_PROP_SUCCESS) || 9242 ddi_pathname_obp_set(child, NULL) != DDI_SUCCESS) { 9243 SCSI_HBA_LOG((_LOG_NF(WARN), "%s failed dynamic decoration", 9244 nameaddr)); 9245 (void) ddi_remove_child(child, 0); 9246 child = NULL; 9247 } else { 9248 /* 9249 * Online/attach in order to get events so devfsadm will 9250 * create public names. 9251 */ 9252 ndi_hold_devi(child); 9253 if (ndi_devi_online(child, 0) != NDI_SUCCESS) { 9254 ndi_rele_devi(child); 9255 ndi_prop_remove_all(child); 9256 (void) ndi_devi_free(child); 9257 child = NULL; 9258 } else 9259 ndi_rele_devi(child); 9260 } 9261 9262 return (child); 9263 } 9264 9265 #ifdef sparc 9266 /* 9267 * Future: When iportmap boot support is added, consider rewriting this to 9268 * perform a scsi_hba_bus_config(BUS_CONFIG_ALL) on self (HBA) followed by 9269 * a scsi_hba_bus_config(BUS_CONFIG_ONE) on each child of self (each iport). 9270 */ 9271 /* ARGSUSED */ 9272 static int 9273 scsi_hba_bus_config_prom_node(dev_info_t *self, uint_t flags, 9274 void *arg, dev_info_t **childp) 9275 { 9276 char **iports; 9277 boolean_t enteredv; 9278 int i; 9279 int ret = NDI_FAILURE; 9280 unsigned int num_iports = 0; 9281 dev_info_t *pdip = NULL; 9282 char *addr = NULL; 9283 9284 /* check to see if this is an HBA that defined scsi iports */ 9285 ret = ddi_prop_lookup_string_array(DDI_DEV_T_ANY, self, 9286 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, "scsi-iports", &iports, 9287 &num_iports); 9288 9289 if (ret != DDI_SUCCESS) { 9290 return (ret); 9291 } 9292 9293 ASSERT(num_iports > 0); 9294 9295 addr = kmem_zalloc(SCSI_MAXNAMELEN, KM_SLEEP); 9296 9297 ret = NDI_FAILURE; 9298 9299 scsi_hba_devi_enter(self, &enteredv); 9300 9301 /* create iport nodes for each scsi port/bus */ 9302 for (i = 0; i < num_iports; i++) { 9303 bzero(addr, SCSI_MAXNAMELEN); 9304 /* Prepend the iport name */ 9305 (void) snprintf(addr, SCSI_MAXNAMELEN, "iport@%s", 9306 iports[i]); 9307 if (pdip = scsi_hba_bus_config_port(self, addr, SE_BUSCONFIG)) { 9308 if (ndi_busop_bus_config(self, NDI_NO_EVENT, 9309 BUS_CONFIG_ONE, addr, &pdip, 0) != 9310 NDI_SUCCESS) { 9311 continue; 9312 } 9313 /* 9314 * Try to configure child under iport see wehter 9315 * request node is the child of the iport node 9316 */ 9317 if (ndi_devi_config_one(pdip, arg, childp, 9318 NDI_NO_EVENT) == NDI_SUCCESS) { 9319 ret = NDI_SUCCESS; 9320 break; 9321 } 9322 } 9323 } 9324 9325 scsi_hba_devi_exit(self, enteredv); 9326 9327 kmem_free(addr, SCSI_MAXNAMELEN); 9328 9329 ddi_prop_free(iports); 9330 9331 return (ret); 9332 } 9333 #endif 9334 9335 /* 9336 * Perform iport port/bus bus_config. 9337 */ 9338 static int 9339 scsi_hba_bus_config_iports(dev_info_t *self, uint_t flags, 9340 ddi_bus_config_op_t op, void *arg, dev_info_t **childp) 9341 { 9342 char *nameaddr, *addr; 9343 char **iports; 9344 boolean_t enteredv; 9345 int i; 9346 int ret = NDI_FAILURE; 9347 unsigned int num_iports = 0; 9348 9349 /* check to see if this is an HBA that defined scsi iports */ 9350 ret = ddi_prop_lookup_string_array(DDI_DEV_T_ANY, self, 9351 DDI_PROP_DONTPASS | DDI_PROP_NOTPROM, "scsi-iports", &iports, 9352 &num_iports); 9353 9354 if (ret != DDI_SUCCESS) { 9355 return (ret); 9356 } 9357 9358 ASSERT(num_iports > 0); 9359 9360 scsi_hba_devi_enter(self, &enteredv); 9361 9362 switch (op) { 9363 case BUS_CONFIG_ONE: 9364 /* return if this operation is not against an iport node */ 9365 nameaddr = (char *)arg; 9366 if ((nameaddr == NULL) || 9367 (strncmp(nameaddr, "iport@", strlen("iport@")) != 0)) { 9368 ret = NDI_FAILURE; 9369 scsi_hba_devi_exit(self, enteredv); 9370 ddi_prop_free(iports); 9371 return (ret); 9372 } 9373 9374 /* parse the port number from "iport@%s" */ 9375 addr = nameaddr + strlen("iport@"); 9376 9377 /* check to see if this port was registered */ 9378 for (i = 0; i < num_iports; i++) { 9379 if (strcmp((iports[i]), addr) == 0) 9380 break; 9381 } 9382 9383 if (i == num_iports) { 9384 ret = NDI_FAILURE; 9385 break; 9386 } 9387 9388 /* create the iport node child */ 9389 if (scsi_hba_bus_config_port(self, nameaddr, SE_BUSCONFIG)) { 9390 ret = NDI_SUCCESS; 9391 } 9392 break; 9393 9394 case BUS_CONFIG_ALL: 9395 case BUS_CONFIG_DRIVER: 9396 addr = kmem_zalloc(SCSI_MAXNAMELEN, KM_SLEEP); 9397 /* create iport nodes for each scsi port/bus */ 9398 for (i = 0; i < num_iports; i++) { 9399 bzero(addr, SCSI_MAXNAMELEN); 9400 /* Prepend the iport name */ 9401 (void) snprintf(addr, SCSI_MAXNAMELEN, "iport@%s", 9402 iports[i]); 9403 (void) scsi_hba_bus_config_port(self, addr, 9404 SE_BUSCONFIG); 9405 } 9406 9407 kmem_free(addr, SCSI_MAXNAMELEN); 9408 ret = NDI_SUCCESS; 9409 break; 9410 } 9411 if (ret == NDI_SUCCESS) { 9412 #ifdef sparc 9413 /* 9414 * Mask NDI_PROMNAME since PROM doesn't have iport 9415 * node at all. 9416 */ 9417 flags &= (~NDI_PROMNAME); 9418 #endif 9419 flags |= NDI_MDI_FALLBACK; /* devinfo&pathinfo children */ 9420 ret = ndi_busop_bus_config(self, flags, op, 9421 arg, childp, 0); 9422 } 9423 scsi_hba_devi_exit(self, enteredv); 9424 9425 ddi_prop_free(iports); 9426 9427 return (ret); 9428 } 9429 9430 static int 9431 scsi_iportmap_config(void *arg, damap_t *mapp, damap_id_t tgtid) 9432 { 9433 dev_info_t *self = (dev_info_t *)arg; 9434 boolean_t enteredv; 9435 char nameaddr[SCSI_MAXNAMELEN]; 9436 char *iport_addr; 9437 dev_info_t *childp; 9438 9439 scsi_hba_devi_enter(self, &enteredv); 9440 9441 iport_addr = damap_id2addr(mapp, tgtid); 9442 SCSI_HBA_LOG((_LOGIPT, self, NULL, 9443 "%s @%s", damap_name(mapp), iport_addr)); 9444 9445 (void) snprintf(nameaddr, sizeof (nameaddr), "iport@%s", iport_addr); 9446 childp = scsi_hba_bus_config_port(self, nameaddr, SE_HP); 9447 scsi_hba_devi_exit(self, enteredv); 9448 return (childp != NULL ? DAM_SUCCESS : DAM_FAILURE); 9449 } 9450 9451 static int 9452 scsi_iportmap_unconfig(void *arg, damap_t *mapp, damap_id_t tgtid) 9453 { 9454 dev_info_t *self = arg; 9455 dev_info_t *childp; /* iport child of HBA node */ 9456 boolean_t enteredv; 9457 int empty; 9458 char *addr; 9459 char nameaddr[SCSI_MAXNAMELEN]; 9460 scsi_hba_tran_t *tran; 9461 9462 addr = damap_id2addr(mapp, tgtid); 9463 SCSI_HBA_LOG((_LOGIPT, self, NULL, "%s @%s", damap_name(mapp), addr)); 9464 9465 (void) snprintf(nameaddr, sizeof (nameaddr), "iport@%s", addr); 9466 scsi_hba_devi_enter(self, &enteredv); 9467 if ((childp = ndi_devi_findchild(self, nameaddr)) == NULL) { 9468 scsi_hba_devi_exit(self, enteredv); 9469 return (DAM_FAILURE); 9470 } 9471 9472 tran = ddi_get_driver_private(childp); 9473 ASSERT(tran); 9474 9475 ndi_hold_devi(childp); 9476 scsi_hba_devi_exit(self, enteredv); 9477 9478 /* 9479 * A begin/end (clear) against the iport's 9480 * tgtmap will trigger unconfigure of all 9481 * targets on the iport. 9482 * 9483 * Future: This bit of code only works if the 9484 * target map reporting style is are full 9485 * reports and not per-address. Maybe we 9486 * should plan on handling this by 9487 * auto-unconfiguration when destroying the 9488 * target map(s). 9489 */ 9490 (void) scsi_hba_tgtmap_set_begin(tran->tran_tgtmap); 9491 (void) scsi_hba_tgtmap_set_end(tran->tran_tgtmap, 0); 9492 9493 /* wait for unconfigure */ 9494 (void) scsi_tgtmap_sync(tran->tran_tgtmap, 0); 9495 empty = scsi_tgtmap_is_empty(tran->tran_tgtmap); 9496 9497 scsi_hba_devi_enter(self, &enteredv); 9498 ndi_rele_devi(childp); 9499 9500 /* If begin/end/sync ends in empty map, offline/remove. */ 9501 if (empty) { 9502 if (ndi_devi_offline(childp, 9503 NDI_DEVFS_CLEAN | NDI_DEVI_REMOVE) == DDI_SUCCESS) { 9504 SCSI_HBA_LOG((_LOGUNCFG, self, NULL, 9505 "devinfo iport@%s offlined and removed", 9506 addr)); 9507 } else if (ndi_devi_device_remove(childp)) { 9508 /* Offline/rem failed, note new device_remove */ 9509 SCSI_HBA_LOG((_LOGUNCFG, self, NULL, 9510 "devinfo iport@%s offline failed, " 9511 "device_remove", addr)); 9512 } 9513 } 9514 scsi_hba_devi_exit(self, enteredv); 9515 return (empty ? DAM_SUCCESS : DAM_FAILURE); 9516 } 9517 9518 9519 int 9520 scsi_hba_iportmap_create(dev_info_t *self, int csync_usec, int settle_usec, 9521 scsi_hba_iportmap_t **handle) 9522 { 9523 scsi_hba_tran_t *tran; 9524 damap_t *mapp; 9525 char context[64]; 9526 impl_scsi_iportmap_t *iportmap; 9527 9528 if (self == NULL || csync_usec == 0 || 9529 settle_usec == 0 || handle == NULL) 9530 return (DDI_FAILURE); 9531 9532 *handle = NULL; 9533 9534 if (scsi_hba_iport_unit_address(self) != NULL) 9535 return (DDI_FAILURE); 9536 9537 tran = (scsi_hba_tran_t *)ddi_get_driver_private(self); 9538 ASSERT(tran); 9539 if (tran == NULL) 9540 return (DDI_FAILURE); 9541 9542 (void) snprintf(context, sizeof (context), "%s%d.iportmap", 9543 ddi_driver_name(self), ddi_get_instance(self)); 9544 9545 if (damap_create(context, DAMAP_REPORT_PERADDR, DAMAP_SERIALCONFIG, 9546 settle_usec, NULL, NULL, NULL, self, 9547 scsi_iportmap_config, scsi_iportmap_unconfig, &mapp) != 9548 DAM_SUCCESS) { 9549 return (DDI_FAILURE); 9550 } 9551 iportmap = kmem_zalloc(sizeof (*iportmap), KM_SLEEP); 9552 iportmap->iportmap_hba_dip = self; 9553 iportmap->iportmap_dam = mapp; 9554 9555 iportmap->iportmap_create_window = 1; /* start with window */ 9556 iportmap->iportmap_create_time = ddi_get_lbolt64(); 9557 iportmap->iportmap_create_csync_usec = csync_usec; 9558 iportmap->iportmap_settle_usec = settle_usec; 9559 iportmap->iportmap_sync_cnt = 0; 9560 9561 tran->tran_iportmap = (scsi_hba_iportmap_t *)iportmap; 9562 *handle = (scsi_hba_iportmap_t *)iportmap; 9563 9564 SCSI_HBA_LOG((_LOGIPT, self, NULL, "%s", damap_name(mapp))); 9565 return (DDI_SUCCESS); 9566 } 9567 9568 void 9569 scsi_hba_iportmap_destroy(scsi_hba_iportmap_t *handle) 9570 { 9571 impl_scsi_iportmap_t *iportmap = (impl_scsi_iportmap_t *)handle; 9572 dev_info_t *self = iportmap->iportmap_hba_dip; 9573 9574 SCSI_HBA_LOG((_LOGIPT, self, NULL, 9575 "%s", damap_name(iportmap->iportmap_dam))); 9576 9577 damap_destroy(iportmap->iportmap_dam); 9578 kmem_free(iportmap, sizeof (*iportmap)); 9579 } 9580 9581 int 9582 scsi_hba_iportmap_iport_add(scsi_hba_iportmap_t *handle, 9583 char *iport_addr, void *iport_priv) 9584 { 9585 impl_scsi_iportmap_t *iportmap = (impl_scsi_iportmap_t *)handle; 9586 dev_info_t *self = iportmap->iportmap_hba_dip; 9587 9588 SCSI_HBA_LOG((_LOGIPT, self, NULL, 9589 "%s @%s", damap_name(iportmap->iportmap_dam), iport_addr)); 9590 9591 return ((damap_addr_add(iportmap->iportmap_dam, iport_addr, NULL, 9592 NULL, iport_priv) == DAM_SUCCESS) ? DDI_SUCCESS : DDI_FAILURE); 9593 } 9594 9595 int 9596 scsi_hba_iportmap_iport_remove(scsi_hba_iportmap_t *handle, 9597 char *iport_addr) 9598 { 9599 impl_scsi_iportmap_t *iportmap = (impl_scsi_iportmap_t *)handle; 9600 dev_info_t *self = iportmap->iportmap_hba_dip; 9601 9602 SCSI_HBA_LOG((_LOGIPT, self, NULL, 9603 "%s @%s", damap_name(iportmap->iportmap_dam), iport_addr)); 9604 9605 return ((damap_addr_del(iportmap->iportmap_dam, 9606 iport_addr) == DAM_SUCCESS) ? DDI_SUCCESS : DDI_FAILURE); 9607 } 9608 9609 int 9610 scsi_hba_iportmap_lookup(scsi_hba_iportmap_t *handle, 9611 char *iport_addr) 9612 { 9613 impl_scsi_iportmap_t *iportmap = (impl_scsi_iportmap_t *)handle; 9614 dev_info_t *self = iportmap->iportmap_hba_dip; 9615 damap_id_t iportid; 9616 9617 iportid = damap_lookup(iportmap->iportmap_dam, iport_addr); 9618 if (iportid != NODAM) { 9619 SCSI_HBA_LOG((_LOG(3), self, NULL, 9620 "%s @%s found", 9621 damap_name(iportmap->iportmap_dam), iport_addr)); 9622 damap_id_rele(iportmap->iportmap_dam, iportid); 9623 return (DDI_SUCCESS); 9624 } 9625 9626 SCSI_HBA_LOG((_LOG(3), self, NULL, 9627 "%s @%s not found", 9628 damap_name(iportmap->iportmap_dam), iport_addr)); 9629 return (DDI_FAILURE); 9630 } 9631 9632 9633 static int 9634 scsi_lunmap_config(void *arg, damap_t *lundam, damap_id_t lunid) 9635 { 9636 impl_scsi_tgtmap_t *tgtmap = (impl_scsi_tgtmap_t *)arg; 9637 scsi_hba_tran_t *tran = tgtmap->tgtmap_tran; 9638 dev_info_t *self = tran->tran_iport_dip; 9639 char *addr; 9640 9641 addr = damap_id2addr(lundam, lunid); 9642 SCSI_HBA_LOG((_LOGLUN, self, NULL, 9643 "%s @%s", damap_name(lundam), addr)); 9644 if (scsi_hba_bus_configone_addr(self, addr, SE_HP) != NULL) 9645 return (DAM_SUCCESS); 9646 else 9647 return (DAM_FAILURE); 9648 } 9649 9650 static int 9651 scsi_lunmap_unconfig(void *arg, damap_t *lundam, damap_id_t lunid) 9652 { 9653 impl_scsi_tgtmap_t *tgtmap = (impl_scsi_tgtmap_t *)arg; 9654 scsi_hba_tran_t *tran = tgtmap->tgtmap_tran; 9655 dev_info_t *self = tran->tran_iport_dip; 9656 char *addr; 9657 9658 addr = damap_id2addr(lundam, lunid); 9659 SCSI_HBA_LOG((_LOGLUN, self, NULL, "%s @%s", damap_name(lundam), 9660 addr)); 9661 9662 scsi_hba_bus_unconfigone_addr(self, addr); 9663 return (DAM_SUCCESS); 9664 } 9665 9666 static int 9667 scsi_lunmap_create(dev_info_t *self, impl_scsi_tgtmap_t *tgtmap, char *taddr) 9668 { 9669 char context[64]; 9670 damap_t *tgtdam; 9671 damap_id_t tgtid; 9672 damap_t *lundam; 9673 int optflags; 9674 9675 (void) snprintf(context, sizeof (context), "%s%d.%s.lunmap", 9676 ddi_driver_name(self), ddi_get_instance(self), taddr); 9677 9678 tgtdam = tgtmap->tgtmap_dam[SCSI_TGT_SCSI_DEVICE]; 9679 tgtid = damap_lookup(tgtdam, taddr); 9680 if (tgtid == NODAM) { 9681 SCSI_HBA_LOG((_LOG(1), self, NULL, 9682 "target %s not found", context)); 9683 return (DDI_FAILURE); 9684 } 9685 9686 lundam = damap_id_priv_get(tgtdam, tgtid); 9687 if (lundam) { 9688 SCSI_HBA_LOG((_LOG(1), self, NULL, 9689 "lunmap %s already created", context)); 9690 damap_id_rele(tgtdam, tgtid); 9691 return (DDI_FAILURE); 9692 } 9693 9694 optflags = (ddi_prop_get_int(DDI_DEV_T_ANY, self, 9695 DDI_PROP_NOTPROM | DDI_PROP_DONTPASS, "scsi-enumeration", 9696 scsi_enumeration) & SCSI_ENUMERATION_MT_LUN_DISABLE) ? 9697 DAMAP_SERIALCONFIG : DAMAP_MTCONFIG; 9698 9699 /* NOTE: expected ref at tgtid/taddr: 2: caller + lookup. */ 9700 ASSERT(damap_id_ref(tgtdam, tgtid) == 2); 9701 SCSI_HBA_LOG((_LOGLUN, self, NULL, "%s creat, id %d ref %d", 9702 context, tgtid, damap_id_ref(tgtdam, tgtid))); 9703 9704 /* create lundam */ 9705 if (damap_create(context, DAMAP_REPORT_FULLSET, optflags, 1, 9706 NULL, NULL, NULL, tgtmap, scsi_lunmap_config, scsi_lunmap_unconfig, 9707 &lundam) != DAM_SUCCESS) { 9708 SCSI_HBA_LOG((_LOG(1), self, NULL, 9709 "%s create failed, id %d ref %d", 9710 context, tgtid, damap_id_ref(tgtdam, tgtid))); 9711 damap_id_rele(tgtdam, tgtid); 9712 return (DDI_FAILURE); 9713 } 9714 9715 /* 9716 * Return with damap_id_hold at tgtid/taddr from damap_lookup to 9717 * account for damap_id_prv_set below. 9718 */ 9719 damap_id_priv_set(tgtdam, tgtid, lundam); 9720 return (DDI_SUCCESS); 9721 } 9722 9723 static void 9724 scsi_lunmap_destroy(dev_info_t *self, impl_scsi_tgtmap_t *tgtmap, char *taddr) 9725 { 9726 char context[64]; 9727 damap_t *tgtdam; 9728 damap_id_t tgtid; 9729 damap_t *lundam; 9730 9731 (void) snprintf(context, sizeof (context), "%s%d.%s.lunmap", 9732 ddi_driver_name(self), ddi_get_instance(self), taddr); 9733 9734 tgtdam = tgtmap->tgtmap_dam[SCSI_TGT_SCSI_DEVICE]; 9735 tgtid = damap_lookup(tgtdam, taddr); 9736 if (tgtid == NODAM) { 9737 SCSI_HBA_LOG((_LOG(1), self, NULL, 9738 "target %s not found", context)); 9739 return; 9740 } 9741 9742 lundam = (damap_t *)damap_id_priv_get(tgtdam, tgtid); 9743 if (lundam == NULL) { 9744 damap_id_rele(tgtdam, tgtid); /* from damap_lookup */ 9745 SCSI_HBA_LOG((_LOG(1), self, NULL, 9746 "lunmap %s already destroyed", context)); 9747 return; 9748 } 9749 9750 /* NOTE: expected ref at tgtid/taddr: 3: priv_set + caller + lookup. */ 9751 ASSERT(damap_id_ref(tgtdam, tgtid) == 3); 9752 SCSI_HBA_LOG((_LOGLUN, self, NULL, "%s, id %d ref %d", 9753 damap_name(lundam), tgtid, damap_id_ref(tgtdam, tgtid))); 9754 9755 /* 9756 * A begin/end (clear) against a target's lunmap will trigger 9757 * unconfigure of all LUNs on the target. 9758 */ 9759 scsi_lunmap_set_begin(self, lundam); 9760 scsi_lunmap_set_end(self, lundam); 9761 9762 SCSI_HBA_LOG((_LOGLUN, self, NULL, 9763 "%s sync begin", damap_name(lundam))); 9764 9765 (void) damap_sync(lundam, 0); /* wait for unconfigure */ 9766 9767 SCSI_HBA_LOG((_LOGLUN, self, NULL, 9768 "%s sync end", damap_name(lundam))); 9769 9770 damap_id_priv_set(tgtdam, tgtid, NULL); 9771 9772 /* release hold established by damap_lookup above */ 9773 damap_id_rele(tgtdam, tgtid); 9774 9775 /* release hold established since scsi_lunmap_create() */ 9776 damap_id_rele(tgtdam, tgtid); 9777 9778 damap_destroy(lundam); 9779 } 9780 9781 static void 9782 scsi_lunmap_set_begin(dev_info_t *self, damap_t *lundam) 9783 { 9784 SCSI_HBA_LOG((_LOGLUN, self, NULL, "%s", damap_name(lundam))); 9785 9786 (void) damap_addrset_begin(lundam); 9787 } 9788 9789 static int 9790 scsi_lunmap_set_add(dev_info_t *self, damap_t *lundam, 9791 char *taddr, scsi_lun64_t lun64, int sfunc) 9792 { 9793 char ua[SCSI_MAXNAMELEN]; 9794 9795 /* make unit address string form of "@taddr,lun[,sfunc]" */ 9796 if (sfunc == -1) 9797 (void) snprintf(ua, sizeof (ua), "%s,%" PRIx64, taddr, lun64); 9798 else 9799 (void) snprintf(ua, sizeof (ua), "%s,%" PRIx64 ",%x", 9800 taddr, lun64, sfunc); 9801 9802 SCSI_HBA_LOG((_LOGLUN, self, NULL, "%s @%s", damap_name(lundam), ua)); 9803 9804 return ((damap_addrset_add(lundam, ua, NULL, NULL, 9805 NULL) == DAM_SUCCESS) ? DDI_SUCCESS : DDI_FAILURE); 9806 } 9807 9808 static void 9809 scsi_lunmap_set_end(dev_info_t *self, damap_t *lundam) 9810 { 9811 SCSI_HBA_LOG((_LOGLUN, self, NULL, "%s", damap_name(lundam))); 9812 9813 (void) damap_addrset_end(lundam, 0); 9814 } 9815 9816 int 9817 scsi_lunmap_lookup(dev_info_t *self, damap_t *lundam, char *addr) 9818 { 9819 damap_id_t lunid; 9820 9821 if ((lunid = damap_lookup(lundam, addr)) != NODAM) { 9822 SCSI_HBA_LOG((_LOG(3), self, NULL, 9823 "%s @%s found", damap_name(lundam), addr)); 9824 damap_id_rele(lundam, lunid); 9825 return (DDI_SUCCESS); 9826 } 9827 9828 SCSI_HBA_LOG((_LOG(3), self, NULL, 9829 "%s @%s not found", damap_name(lundam), addr)); 9830 return (DDI_FAILURE); 9831 } 9832 9833 /* 9834 * phymap implementation 9835 * 9836 * We manage the timed aggregation of phys into a phy map * by creating a 9837 * SAS port construct (based upon 'name' of "local,remote" SAS addresses) 9838 * upon the first link up. As time goes on additional phys may join that port. 9839 * After an appropriate amount of settle time, we trigger the activation 9840 * callback which will then take the resultant bit mask of phys (phymask) in 9841 * the SAS port and use that to call back to the callback function 9842 * provided by the additional caller. 9843 * 9844 * We cross check to make sure that phys only exist in one SAS port at a 9845 * time by having soft state for each phy point back to the created 9846 * SAS port. 9847 * 9848 * NOTE: Make SAS_PHY_UA_LEN max(SAS_PHY_PHYMASK_LEN, SAS_PHY_NAME_LEN) 9849 * so we have enough space if sas_phymap_bitset2phymaskua phymask address 9850 * is already in use, and we end up using port name as unit address. 9851 */ 9852 #define SAS_PHY_NAME_FMT "%" PRIx64 ",%" PRIx64 9853 #define SAS_PHY_NAME_LEN (16 + 1 + 16 + 1) 9854 #define SAS_PHY_NPHY (SAS2_PHYNUM_MAX + 1) 9855 #define SAS_PHY_PHYMASK_LEN ((roundup(SAS_PHY_NPHY, 4)) / 4) 9856 #if (SAS_PHY_PHYMASK_LEN > SAS_PHY_NAME_LEN) 9857 #define SAS_PHY_UA_LEN SAS_PHY_PHYMASK_LEN 9858 #else 9859 #define SAS_PHY_UA_LEN SAS_PHY_NAME_LEN 9860 #endif 9861 typedef struct impl_sas_physet { /* needed for name2phys destroy */ 9862 struct impl_sas_physet *physet_next; 9863 char *physet_name; 9864 bitset_t *physet_phys; 9865 } impl_sas_physet_t; 9866 typedef struct impl_sas_phymap { 9867 dev_info_t *phymap_self; 9868 9869 kmutex_t phymap_lock; 9870 damap_t *phymap_dam; 9871 void *phymap_phy2name; 9872 ddi_soft_state_bystr *phymap_name2phys; /* bitset */ 9873 ddi_soft_state_bystr *phymap_name2ua; 9874 ddi_soft_state_bystr *phymap_ua2name; 9875 9876 /* Noisy phy information - ensure forward progress for noisy phys */ 9877 int phymap_phy_max; /* max phy# */ 9878 int phymap_reports; /* per period */ 9879 int phymap_reports_max; /* scales */ 9880 int phymap_phys_noisy; /* detected */ 9881 9882 /* These are for callbacks to the consumer. */ 9883 sas_phymap_activate_cb_t phymap_acp; 9884 sas_phymap_deactivate_cb_t phymap_dcp; 9885 void *phymap_private; 9886 9887 struct impl_sas_physet *phymap_physets; 9888 } impl_sas_phymap_t; 9889 9890 /* Detect noisy phy: max changes per stabilization period per phy. */ 9891 static int sas_phymap_phy_max_factor = 16; 9892 9893 /* 9894 * Convert bitset into a unit-address string. The maximum string length would 9895 * be the maximum number of phys, rounded up by 4 and divided by 4. 9896 */ 9897 static void 9898 sas_phymap_bitset2phymaskua(bitset_t *phys, char *buf) 9899 { 9900 char *ptr; 9901 int grp; 9902 int cur; 9903 uint_t bit; 9904 9905 bit = roundup(SAS_PHY_NPHY, 4); 9906 grp = 4; 9907 ptr = buf; 9908 cur = 0; 9909 do { 9910 bit -= 1; 9911 grp -= 1; 9912 if (bitset_in_set(phys, bit)) { 9913 cur |= (1 << grp); 9914 } 9915 if (grp == 0) { 9916 grp = 4; 9917 if (cur || ptr != buf) { 9918 *ptr++ = "0123456789abcdef"[cur]; 9919 *ptr = 0; 9920 } 9921 cur = 0; 9922 } 9923 } while (bit != 0); 9924 if (ptr == buf) { 9925 *ptr++ = '0'; 9926 *ptr = 0; 9927 } 9928 } 9929 9930 static int 9931 sas_phymap_config(void *arg, damap_t *phydam, damap_id_t phyid) 9932 { 9933 impl_sas_phymap_t *phymap = (impl_sas_phymap_t *)arg; 9934 char *context = damap_name(phymap->phymap_dam); 9935 char *damn; 9936 char *name; 9937 bitset_t *phys; 9938 char *ua; 9939 void *ua_priv; 9940 9941 ASSERT(context); 9942 9943 mutex_enter(&phymap->phymap_lock); 9944 phymap->phymap_reports = phymap->phymap_phys_noisy = 0; 9945 9946 /* Get the name ("local,remote" address string) from damap. */ 9947 damn = damap_id2addr(phydam, phyid); 9948 9949 /* Get the bitset of phys currently forming the port. */ 9950 phys = ddi_soft_state_bystr_get(phymap->phymap_name2phys, damn); 9951 if (phys == NULL) { 9952 SCSI_HBA_LOG((_LOG_NF(WARN), "%s: %s: no phys", 9953 context, damn)); 9954 mutex_exit(&phymap->phymap_lock); 9955 return (DAM_FAILURE); 9956 } 9957 9958 /* allocate, get, and initialize name index of name2ua map */ 9959 if (ddi_soft_state_bystr_zalloc(phymap->phymap_name2ua, damn) != 9960 DDI_SUCCESS) { 9961 SCSI_HBA_LOG((_LOG_NF(WARN), 9962 "%s: %s: failed name2ua alloc", context, damn)); 9963 mutex_exit(&phymap->phymap_lock); 9964 return (DAM_FAILURE); 9965 } 9966 if (!(ua = ddi_soft_state_bystr_get(phymap->phymap_name2ua, damn))) { 9967 SCSI_HBA_LOG((_LOG_NF(WARN), 9968 "%s: %s: no name2ua", context, damn)); 9969 mutex_exit(&phymap->phymap_lock); 9970 return (DAM_FAILURE); 9971 } 9972 sas_phymap_bitset2phymaskua(phys, ua); /* set ua */ 9973 9974 /* see if phymask ua index already allocated in ua2name map */ 9975 if (name = ddi_soft_state_bystr_get(phymap->phymap_ua2name, ua)) { 9976 /* 9977 * The 'phymask' sas_phymap_bitset2phymaskua ua is 9978 * already in use. This means that original phys have 9979 * formed into a new port, and that the original port 9980 * still exists (it has migrated to some completely 9981 * different set of phys). In this corner-case we use 9982 * "local,remote" name as a 'temporary' unit address. 9983 * Reset ua in name2ua map. 9984 */ 9985 (void) strlcpy(ua, damn, SAS_PHY_NAME_LEN); 9986 name = ddi_soft_state_bystr_get(phymap->phymap_ua2name, ua); 9987 if (name) { 9988 /* The "local,remote" ua should be new... */ 9989 SCSI_HBA_LOG((_LOG_NF(WARN), 9990 "%s: %s ua already configured", 9991 context, ua)); 9992 mutex_exit(&phymap->phymap_lock); 9993 return (DAM_SUCCESS); 9994 } 9995 } 9996 9997 /* allocate, get, and init ua index of ua2name map */ 9998 if (ddi_soft_state_bystr_zalloc(phymap->phymap_ua2name, ua) != 9999 DDI_SUCCESS) { 10000 ddi_soft_state_bystr_free(phymap->phymap_name2ua, damn); 10001 SCSI_HBA_LOG((_LOG_NF(WARN), "%s: %s: failed ua2name alloc", 10002 context, damn)); 10003 mutex_exit(&phymap->phymap_lock); 10004 return (DAM_FAILURE); 10005 } 10006 name = ddi_soft_state_bystr_get(phymap->phymap_ua2name, ua); 10007 if (name == NULL) { 10008 ddi_soft_state_bystr_free(phymap->phymap_name2ua, damn); 10009 SCSI_HBA_LOG((_LOG_NF(WARN), 10010 "%s: %s: no ua2name", context, ua)); 10011 mutex_exit(&phymap->phymap_lock); 10012 return (DAM_FAILURE); 10013 } 10014 10015 /* set name in ua2name map */ 10016 (void) strlcpy(name, damn, SAS_PHY_NAME_LEN); 10017 10018 SCSI_HBA_LOG((_LOGPHY, phymap->phymap_self, NULL, 10019 "%s: %s: ua %s: activate", context, damn, ua)); 10020 10021 if (phymap->phymap_acp) { 10022 /* 10023 * drop our lock and invoke the activation callback 10024 */ 10025 mutex_exit(&phymap->phymap_lock); 10026 ua_priv = NULL; 10027 (phymap->phymap_acp)(phymap->phymap_private, ua, &ua_priv); 10028 mutex_enter(&phymap->phymap_lock); 10029 damap_id_priv_set(phydam, phyid, ua_priv); 10030 } 10031 SCSI_HBA_LOG((_LOGPHY, phymap->phymap_self, NULL, 10032 "%s: %s: ua %s: activate complete", context, damn, ua)); 10033 mutex_exit(&phymap->phymap_lock); 10034 return (DAM_SUCCESS); 10035 } 10036 10037 /*ARGSUSED*/ 10038 static int 10039 sas_phymap_unconfig(void *arg, damap_t *phydam, damap_id_t phyid) 10040 { 10041 impl_sas_phymap_t *phymap = (impl_sas_phymap_t *)arg; 10042 char *context = damap_name(phymap->phymap_dam); 10043 char *damn; 10044 char *ua; 10045 void *ua_priv; 10046 10047 ASSERT(context); 10048 10049 mutex_enter(&phymap->phymap_lock); 10050 phymap->phymap_reports = phymap->phymap_phys_noisy = 0; 10051 10052 /* Get the name ("local,remote" address string) from damap. */ 10053 damn = damap_id2addr(phydam, phyid); 10054 10055 if (!(ua = ddi_soft_state_bystr_get(phymap->phymap_name2ua, damn))) { 10056 SCSI_HBA_LOG((_LOG_NF(WARN), 10057 "%s: %s: no name2ua", context, damn)); 10058 mutex_exit(&phymap->phymap_lock); 10059 return (DAM_FAILURE); 10060 } 10061 10062 SCSI_HBA_LOG((_LOGPHY, phymap->phymap_self, NULL, 10063 "%s: %s: ua %s: deactivate", context, damn, ua)); 10064 if (phymap->phymap_dcp) { 10065 ua_priv = damap_id_priv_get(phydam, phyid); 10066 mutex_exit(&phymap->phymap_lock); 10067 (phymap->phymap_dcp)(phymap->phymap_private, ua, ua_priv); 10068 mutex_enter(&phymap->phymap_lock); 10069 } 10070 SCSI_HBA_LOG((_LOGPHY, phymap->phymap_self, NULL, 10071 "%s: %s: ua %s: deactivate complete", context, damn, ua)); 10072 10073 /* delete ua<->name mappings */ 10074 ddi_soft_state_bystr_free(phymap->phymap_ua2name, ua); 10075 ddi_soft_state_bystr_free(phymap->phymap_name2ua, damn); 10076 mutex_exit(&phymap->phymap_lock); 10077 return (DAM_SUCCESS); 10078 } 10079 10080 int 10081 sas_phymap_create(dev_info_t *self, int settle_usec, 10082 sas_phymap_mode_t mode, void *mode_argument, void *phymap_priv, 10083 sas_phymap_activate_cb_t activate_cb, 10084 sas_phymap_deactivate_cb_t deactivate_cb, 10085 sas_phymap_t **handlep) 10086 { 10087 _NOTE(ARGUNUSED(mode_argument)); 10088 char context[64]; 10089 impl_sas_phymap_t *phymap; 10090 10091 if (self == NULL || settle_usec == 0 || handlep == NULL) 10092 return (DDI_FAILURE); 10093 10094 if (mode != PHYMAP_MODE_SIMPLE) 10095 return (DDI_FAILURE); 10096 10097 phymap = kmem_zalloc(sizeof (*phymap), KM_SLEEP); 10098 phymap->phymap_self = self; 10099 phymap->phymap_reports_max = 1 * sas_phymap_phy_max_factor; 10100 phymap->phymap_acp = activate_cb; 10101 phymap->phymap_dcp = deactivate_cb; 10102 phymap->phymap_private = phymap_priv; 10103 mutex_init(&phymap->phymap_lock, NULL, MUTEX_DRIVER, NULL); 10104 10105 (void) snprintf(context, sizeof (context), "%s%d.phymap", 10106 ddi_driver_name(self), ddi_get_instance(self)); 10107 SCSI_HBA_LOG((_LOGPHY, self, NULL, "%s", context)); 10108 10109 if (ddi_soft_state_init(&phymap->phymap_phy2name, 10110 SAS_PHY_NAME_LEN, SAS_PHY_NPHY) != 0) 10111 goto fail; 10112 if (ddi_soft_state_bystr_init(&phymap->phymap_name2phys, 10113 sizeof (bitset_t), SAS_PHY_NPHY) != 0) 10114 goto fail; 10115 10116 if (ddi_soft_state_bystr_init(&phymap->phymap_name2ua, 10117 SAS_PHY_UA_LEN, SAS_PHY_NPHY) != 0) 10118 goto fail; 10119 if (ddi_soft_state_bystr_init(&phymap->phymap_ua2name, 10120 SAS_PHY_NAME_LEN, SAS_PHY_NPHY) != 0) 10121 goto fail; 10122 10123 if (damap_create(context, DAMAP_REPORT_PERADDR, DAMAP_SERIALCONFIG, 10124 settle_usec, NULL, NULL, NULL, 10125 phymap, sas_phymap_config, sas_phymap_unconfig, 10126 &phymap->phymap_dam) != DAM_SUCCESS) 10127 goto fail; 10128 10129 10130 *handlep = (sas_phymap_t *)phymap; 10131 return (DDI_SUCCESS); 10132 10133 fail: sas_phymap_destroy((sas_phymap_t *)phymap); 10134 *handlep = NULL; 10135 return (DDI_FAILURE); 10136 } 10137 10138 void 10139 sas_phymap_destroy(sas_phymap_t *handle) 10140 { 10141 impl_sas_phymap_t *phymap = (impl_sas_phymap_t *)handle; 10142 char *context; 10143 struct impl_sas_physet *physet, *nphyset; 10144 bitset_t *phys; 10145 char *name; 10146 10147 context = phymap->phymap_dam ? 10148 damap_name(phymap->phymap_dam) : "unknown"; 10149 SCSI_HBA_LOG((_LOGPHY, phymap->phymap_self, NULL, "%s", context)); 10150 10151 if (phymap->phymap_dam) 10152 damap_destroy(phymap->phymap_dam); 10153 10154 /* free the bitsets of allocated physets */ 10155 for (physet = phymap->phymap_physets; physet; physet = nphyset) { 10156 nphyset = physet->physet_next; 10157 phys = physet->physet_phys; 10158 name = physet->physet_name; 10159 10160 if (phys) 10161 bitset_fini(phys); 10162 if (name) { 10163 ddi_soft_state_bystr_free( 10164 phymap->phymap_name2phys, name); 10165 strfree(name); 10166 } 10167 kmem_free(physet, sizeof (*physet)); 10168 } 10169 10170 /* free the maps */ 10171 if (phymap->phymap_ua2name) 10172 ddi_soft_state_bystr_fini(&phymap->phymap_ua2name); 10173 if (phymap->phymap_name2ua) 10174 ddi_soft_state_bystr_fini(&phymap->phymap_name2ua); 10175 10176 if (phymap->phymap_name2phys) 10177 ddi_soft_state_bystr_fini(&phymap->phymap_name2phys); 10178 if (phymap->phymap_phy2name) 10179 ddi_soft_state_fini(&phymap->phymap_phy2name); 10180 10181 mutex_destroy(&phymap->phymap_lock); 10182 kmem_free(phymap, sizeof (*phymap)); 10183 } 10184 10185 10186 int 10187 sas_phymap_phy_add(sas_phymap_t *handle, 10188 int phy, uint64_t local, uint64_t remote) 10189 { 10190 impl_sas_phymap_t *phymap = (impl_sas_phymap_t *)handle; 10191 char *context = damap_name(phymap->phymap_dam); 10192 char port[SAS_PHY_NAME_LEN]; 10193 char *name; 10194 int phy2name_allocated = 0; 10195 bitset_t *phys; 10196 struct impl_sas_physet *physet; 10197 int rv; 10198 10199 /* Create the SAS port name from the local and remote addresses. */ 10200 (void) snprintf(port, SAS_PHY_NAME_LEN, SAS_PHY_NAME_FMT, 10201 local, remote); 10202 10203 mutex_enter(&phymap->phymap_lock); 10204 SCSI_HBA_LOG((_LOGPHY, phymap->phymap_self, NULL, "%s: %s: add phy %d", 10205 context, port, phy)); 10206 10207 /* Check for conflict in phy2name map */ 10208 name = ddi_get_soft_state(phymap->phymap_phy2name, phy); 10209 if (name) { 10210 if (strcmp(name, port) != 0) 10211 SCSI_HBA_LOG((_LOG_NF(WARN), "%s: %s: add phy %d: " 10212 "already in %s", context, port, phy, name)); 10213 else 10214 SCSI_HBA_LOG((_LOG_NF(WARN), "%s: %s: add phy %d: " 10215 "duplicate add", context, port, phy)); 10216 mutex_exit(&phymap->phymap_lock); 10217 return (DDI_FAILURE); 10218 } 10219 10220 /* allocate, get, and initialize phy index of phy2name map */ 10221 if (ddi_soft_state_zalloc( 10222 phymap->phymap_phy2name, phy) != DDI_SUCCESS) { 10223 SCSI_HBA_LOG((_LOG_NF(WARN), 10224 "%s: %s: failed phy2name alloc", context, port)); 10225 goto fail; 10226 } 10227 name = ddi_get_soft_state(phymap->phymap_phy2name, phy); 10228 if (name == NULL) { 10229 SCSI_HBA_LOG((_LOG_NF(WARN), 10230 "%s: %s: no phy2name", context, port)); 10231 goto fail; 10232 } 10233 phy2name_allocated = 1; 10234 (void) strlcpy(name, port, SAS_PHY_NAME_LEN); /* set name */ 10235 10236 /* Find/alloc, initialize name index of name2phys map */ 10237 phys = ddi_soft_state_bystr_get(phymap->phymap_name2phys, name); 10238 if (phys == NULL) { 10239 if (ddi_soft_state_bystr_zalloc(phymap->phymap_name2phys, 10240 name) != DDI_SUCCESS) { 10241 SCSI_HBA_LOG((_LOG_NF(WARN), 10242 "%s: %s: failed name2phys alloc", context, name)); 10243 goto fail; 10244 } 10245 phys = ddi_soft_state_bystr_get(phymap->phymap_name2phys, name); 10246 if (phys == NULL) { 10247 SCSI_HBA_LOG((_LOG_NF(WARN), 10248 "%s: %s: no name2phys", context, name)); 10249 goto fail; 10250 } 10251 10252 /* Initialize bitset of phys. */ 10253 bitset_init(phys); 10254 bitset_resize(phys, SAS_PHY_NPHY); 10255 10256 /* Keep a list of information for destroy. */ 10257 physet = kmem_zalloc(sizeof (*physet), KM_SLEEP); 10258 physet->physet_name = strdup(name); 10259 physet->physet_phys = phys; 10260 physet->physet_next = phymap->phymap_physets; 10261 phymap->phymap_physets = physet; 10262 } 10263 ASSERT(phys); 10264 10265 /* Reflect 'add' in phys bitset. */ 10266 if (bitset_atomic_test_and_add(phys, phy) < 0) { 10267 /* It is an error if the phy was already recorded. */ 10268 SCSI_HBA_LOG((_LOG_NF(WARN), 10269 "%s: %s: phy bit %d already in port", context, name, phy)); 10270 goto fail; 10271 } 10272 10273 /* 10274 * Check to see if we have a new phy_max for this map, and if so 10275 * scale phymap_reports_max to the new number of phys. 10276 */ 10277 if (phy > phymap->phymap_phy_max) { 10278 phymap->phymap_phy_max = phy + 1; 10279 phymap->phymap_reports_max = phymap->phymap_phy_max * 10280 sas_phymap_phy_max_factor; 10281 } 10282 10283 /* 10284 * If we have not reached phymap_reports_max, start/restart the 10285 * activate timer. Otherwise, if phymap->phymap_reports add/rem reports 10286 * ever exceeds phymap_reports_max due to noisy phys, then report the 10287 * noise and force stabilization by stopping reports into the damap. 10288 * 10289 * The first config/unconfig callout out of the damap will reset 10290 * phymap->phymap_reports. 10291 */ 10292 rv = DDI_SUCCESS; 10293 if (phymap->phymap_reports++ < phymap->phymap_reports_max) { 10294 if (damap_addr_add(phymap->phymap_dam, name, 10295 NULL, NULL, NULL) == DAM_SUCCESS) { 10296 SCSI_HBA_LOG((_LOGPHY, phymap->phymap_self, NULL, 10297 "%s: %s: damap_addr_add", context, name)); 10298 } else { 10299 SCSI_HBA_LOG((_LOG_NF(WARN), 10300 "%s: %s: damap_addr_add failed", context, name)); 10301 rv = DDI_FAILURE; 10302 } 10303 } else { 10304 phymap->phymap_phys_noisy++; 10305 if (phymap->phymap_phys_noisy == 1) 10306 SCSI_HBA_LOG((_LOG_NF(WARN), 10307 "%s: %s: noisy phys", context, name)); 10308 } 10309 mutex_exit(&phymap->phymap_lock); 10310 return (rv); 10311 10312 fail: if (phy2name_allocated) 10313 ddi_soft_state_free(phymap->phymap_phy2name, phy); 10314 mutex_exit(&phymap->phymap_lock); 10315 return (DDI_FAILURE); 10316 } 10317 10318 int 10319 sas_phymap_phy_rem(sas_phymap_t *handle, int phy) 10320 { 10321 impl_sas_phymap_t *phymap = (impl_sas_phymap_t *)handle; 10322 char *context = damap_name(phymap->phymap_dam); 10323 char *name; 10324 bitset_t *phys; 10325 int rv = DDI_FAILURE; 10326 10327 ASSERT(context); 10328 10329 mutex_enter(&phymap->phymap_lock); 10330 phymap->phymap_reports++; 10331 10332 /* Find and free phy index of phy2name map */ 10333 name = ddi_get_soft_state(phymap->phymap_phy2name, phy); 10334 if (name == NULL) { 10335 SCSI_HBA_LOG((_LOG_NF(WARN), "%s: rem phy %d: never added", 10336 context, phy)); 10337 goto fail; 10338 } 10339 /* NOTE: always free phy index of phy2name map before return... */ 10340 10341 SCSI_HBA_LOG((_LOGPHY, phymap->phymap_self, NULL, "%s: %s: rem phy %d", 10342 context, name, phy)); 10343 10344 /* Get bitset of phys currently associated with named port. */ 10345 phys = ddi_soft_state_bystr_get(phymap->phymap_name2phys, name); 10346 if (phys == NULL) { 10347 SCSI_HBA_LOG((_LOG_NF(WARN), "%s: %s: name2phys failed", 10348 context, name)); 10349 goto fail; 10350 } 10351 10352 /* Reflect 'rem' in phys bitset. */ 10353 if (bitset_atomic_test_and_del(phys, phy) < 0) { 10354 /* It is an error if the phy wasn't one of the port's phys. */ 10355 SCSI_HBA_LOG((_LOG_NF(WARN), 10356 "%s: %s: phy bit %d not in port", context, name, phy)); 10357 goto fail; 10358 } 10359 10360 /* If this was the last phy in the port, start the deactivate timer. */ 10361 if (bitset_is_null(phys) && 10362 (phymap->phymap_reports++ < phymap->phymap_reports_max)) { 10363 if (damap_addr_del(phymap->phymap_dam, name) == DAM_SUCCESS) { 10364 SCSI_HBA_LOG((_LOGPHY, phymap->phymap_self, NULL, 10365 "%s: %s: damap_addr_del", context, name)); 10366 } else { 10367 SCSI_HBA_LOG((_LOG_NF(WARN), 10368 "%s: %s: damap_addr_del failure", context, name)); 10369 goto fail; 10370 } 10371 } 10372 rv = DDI_SUCCESS; 10373 10374 /* free phy index of phy2name map */ 10375 fail: if (name) 10376 ddi_soft_state_free(phymap->phymap_phy2name, phy); /* free */ 10377 mutex_exit(&phymap->phymap_lock); 10378 return (rv); 10379 } 10380 10381 char * 10382 sas_phymap_lookup_ua(sas_phymap_t *handle, uint64_t local, uint64_t remote) 10383 { 10384 impl_sas_phymap_t *phymap = (impl_sas_phymap_t *)handle; 10385 char *context = damap_name(phymap->phymap_dam); 10386 char name[SAS_PHY_NAME_LEN]; 10387 char *ua; 10388 10389 ASSERT(context); 10390 10391 (void) snprintf(name, SAS_PHY_NAME_LEN, SAS_PHY_NAME_FMT, 10392 local, remote); 10393 10394 mutex_enter(&phymap->phymap_lock); 10395 ua = ddi_soft_state_bystr_get(phymap->phymap_name2ua, name); 10396 SCSI_HBA_LOG((_LOG(3), phymap->phymap_self, NULL, 10397 "%s: %s: ua %s", context, name, ua ? ua : "NULL")); 10398 mutex_exit(&phymap->phymap_lock); 10399 return (ua); 10400 } 10401 10402 void * 10403 sas_phymap_lookup_uapriv(sas_phymap_t *handle, char *ua) 10404 { 10405 impl_sas_phymap_t *phymap = (impl_sas_phymap_t *)handle; 10406 char *context = damap_name(phymap->phymap_dam); 10407 char *name; 10408 damap_id_t phyid; 10409 void *ua_priv = NULL; 10410 10411 ASSERT(context); 10412 10413 mutex_enter(&phymap->phymap_lock); 10414 name = ddi_soft_state_bystr_get(phymap->phymap_ua2name, ua); 10415 if (name) { 10416 phyid = damap_lookup(phymap->phymap_dam, name); 10417 if (phyid != NODAM) { 10418 ua_priv = damap_id_priv_get(phymap->phymap_dam, phyid); 10419 damap_id_rele(phymap->phymap_dam, phyid); 10420 } 10421 } 10422 10423 SCSI_HBA_LOG((_LOG(3), phymap->phymap_self, NULL, 10424 "%s: %s: ua %s ua_priv %p", context, name, 10425 ua ? ua : "NULL", ua_priv)); 10426 mutex_exit(&phymap->phymap_lock); 10427 return (ua_priv); 10428 } 10429 10430 int 10431 sas_phymap_uahasphys(sas_phymap_t *handle, char *ua) 10432 { 10433 impl_sas_phymap_t *phymap = (impl_sas_phymap_t *)handle; 10434 char *name; 10435 bitset_t *phys; 10436 int n = 0; 10437 10438 mutex_enter(&phymap->phymap_lock); 10439 name = ddi_soft_state_bystr_get(phymap->phymap_ua2name, ua); 10440 if (name) { 10441 phys = ddi_soft_state_bystr_get(phymap->phymap_name2phys, name); 10442 if (phys) 10443 n = bitset_is_null(phys) ? 0 : 1; 10444 } 10445 mutex_exit(&phymap->phymap_lock); 10446 return (n); 10447 } 10448 10449 sas_phymap_phys_t * 10450 sas_phymap_ua2phys(sas_phymap_t *handle, char *ua) 10451 { 10452 impl_sas_phymap_t *phymap = (impl_sas_phymap_t *)handle; 10453 char *name; 10454 bitset_t *phys; 10455 bitset_t *cphys = NULL; 10456 10457 mutex_enter(&phymap->phymap_lock); 10458 name = ddi_soft_state_bystr_get(phymap->phymap_ua2name, ua); 10459 if (name == NULL) 10460 goto fail; 10461 10462 phys = ddi_soft_state_bystr_get(phymap->phymap_name2phys, name); 10463 if (phys == NULL) 10464 goto fail; 10465 10466 /* dup the phys and return */ 10467 cphys = kmem_alloc(sizeof (*cphys), KM_SLEEP); 10468 bitset_init(cphys); 10469 bitset_resize(cphys, SAS_PHY_NPHY); 10470 bitset_copy(phys, cphys); 10471 10472 fail: mutex_exit(&phymap->phymap_lock); 10473 return ((sas_phymap_phys_t *)cphys); 10474 } 10475 10476 int 10477 sas_phymap_phys_next(sas_phymap_phys_t *phys) 10478 { 10479 bitset_t *cphys = (bitset_t *)phys; 10480 int phy; 10481 10482 phy = bitset_find(cphys); 10483 if (phy != -1) 10484 bitset_del(cphys, phy); 10485 return (phy); 10486 } 10487 10488 void 10489 sas_phymap_phys_free(sas_phymap_phys_t *phys) 10490 { 10491 bitset_t *cphys = (bitset_t *)phys; 10492 10493 if (cphys) { 10494 bitset_fini(cphys); 10495 kmem_free(cphys, sizeof (*cphys)); 10496 } 10497 } 10498 10499 char * 10500 sas_phymap_phy2ua(sas_phymap_t *handle, int phy) 10501 { 10502 impl_sas_phymap_t *phymap = (impl_sas_phymap_t *)handle; 10503 char *name; 10504 char *ua; 10505 char *rua = NULL; 10506 10507 mutex_enter(&phymap->phymap_lock); 10508 name = ddi_get_soft_state(phymap->phymap_phy2name, phy); 10509 if (name == NULL) 10510 goto fail; 10511 ua = ddi_soft_state_bystr_get(phymap->phymap_name2ua, name); 10512 if (ua == NULL) 10513 goto fail; 10514 10515 /* dup the ua and return */ 10516 rua = strdup(ua); 10517 10518 fail: mutex_exit(&phymap->phymap_lock); 10519 return (rua); 10520 } 10521 10522 void 10523 sas_phymap_ua_free(char *ua) 10524 { 10525 if (ua) 10526 strfree(ua); 10527 } 10528