1 /*- 2 * Implementation of the Common Access Method Transport (XPT) layer. 3 * 4 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD 5 * 6 * Copyright (c) 1997, 1998, 1999 Justin T. Gibbs. 7 * Copyright (c) 1997, 1998, 1999 Kenneth D. Merry. 8 * All rights reserved. 9 * 10 * Redistribution and use in source and binary forms, with or without 11 * modification, are permitted provided that the following conditions 12 * are met: 13 * 1. Redistributions of source code must retain the above copyright 14 * notice, this list of conditions, and the following disclaimer, 15 * without modification, immediately at the beginning of the file. 16 * 2. The name of the author may not be used to endorse or promote products 17 * derived from this software without specific prior written permission. 18 * 19 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 20 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 21 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 22 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR 23 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 24 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 25 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 26 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 27 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 28 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 29 * SUCH DAMAGE. 30 */ 31 32 #include "opt_printf.h" 33 34 #include <sys/cdefs.h> 35 __FBSDID("$FreeBSD$"); 36 37 #include <sys/param.h> 38 #include <sys/bio.h> 39 #include <sys/bus.h> 40 #include <sys/systm.h> 41 #include <sys/types.h> 42 #include <sys/malloc.h> 43 #include <sys/kernel.h> 44 #include <sys/time.h> 45 #include <sys/conf.h> 46 #include <sys/fcntl.h> 47 #include <sys/proc.h> 48 #include <sys/sbuf.h> 49 #include <sys/smp.h> 50 #include <sys/taskqueue.h> 51 52 #include <sys/lock.h> 53 #include <sys/mutex.h> 54 #include <sys/sysctl.h> 55 #include <sys/kthread.h> 56 57 #include <cam/cam.h> 58 #include <cam/cam_ccb.h> 59 #include <cam/cam_iosched.h> 60 #include <cam/cam_periph.h> 61 #include <cam/cam_queue.h> 62 #include <cam/cam_sim.h> 63 #include <cam/cam_xpt.h> 64 #include <cam/cam_xpt_sim.h> 65 #include <cam/cam_xpt_periph.h> 66 #include <cam/cam_xpt_internal.h> 67 #include <cam/cam_debug.h> 68 #include <cam/cam_compat.h> 69 70 #include <cam/scsi/scsi_all.h> 71 #include <cam/scsi/scsi_message.h> 72 #include <cam/scsi/scsi_pass.h> 73 74 #include <machine/md_var.h> /* geometry translation */ 75 #include <machine/stdarg.h> /* for xpt_print below */ 76 77 #include "opt_cam.h" 78 79 /* Wild guess based on not wanting to grow the stack too much */ 80 #define XPT_PRINT_MAXLEN 512 81 #ifdef PRINTF_BUFR_SIZE 82 #define XPT_PRINT_LEN PRINTF_BUFR_SIZE 83 #else 84 #define XPT_PRINT_LEN 128 85 #endif 86 _Static_assert(XPT_PRINT_LEN <= XPT_PRINT_MAXLEN, "XPT_PRINT_LEN is too large"); 87 88 /* 89 * This is the maximum number of high powered commands (e.g. start unit) 90 * that can be outstanding at a particular time. 91 */ 92 #ifndef CAM_MAX_HIGHPOWER 93 #define CAM_MAX_HIGHPOWER 4 94 #endif 95 96 /* Datastructures internal to the xpt layer */ 97 MALLOC_DEFINE(M_CAMXPT, "CAM XPT", "CAM XPT buffers"); 98 MALLOC_DEFINE(M_CAMDEV, "CAM DEV", "CAM devices"); 99 MALLOC_DEFINE(M_CAMCCB, "CAM CCB", "CAM CCBs"); 100 MALLOC_DEFINE(M_CAMPATH, "CAM path", "CAM paths"); 101 102 struct xpt_softc { 103 uint32_t xpt_generation; 104 105 /* number of high powered commands that can go through right now */ 106 struct mtx xpt_highpower_lock; 107 STAILQ_HEAD(highpowerlist, cam_ed) highpowerq; 108 int num_highpower; 109 110 /* queue for handling async rescan requests. */ 111 TAILQ_HEAD(, ccb_hdr) ccb_scanq; 112 int buses_to_config; 113 int buses_config_done; 114 int announce_nosbuf; 115 116 /* 117 * Registered buses 118 * 119 * N.B., "busses" is an archaic spelling of "buses". In new code 120 * "buses" is preferred. 121 */ 122 TAILQ_HEAD(,cam_eb) xpt_busses; 123 u_int bus_generation; 124 125 int boot_delay; 126 struct callout boot_callout; 127 struct task boot_task; 128 struct root_hold_token xpt_rootmount; 129 130 struct mtx xpt_topo_lock; 131 struct taskqueue *xpt_taskq; 132 }; 133 134 typedef enum { 135 DM_RET_COPY = 0x01, 136 DM_RET_FLAG_MASK = 0x0f, 137 DM_RET_NONE = 0x00, 138 DM_RET_STOP = 0x10, 139 DM_RET_DESCEND = 0x20, 140 DM_RET_ERROR = 0x30, 141 DM_RET_ACTION_MASK = 0xf0 142 } dev_match_ret; 143 144 typedef enum { 145 XPT_DEPTH_BUS, 146 XPT_DEPTH_TARGET, 147 XPT_DEPTH_DEVICE, 148 XPT_DEPTH_PERIPH 149 } xpt_traverse_depth; 150 151 struct xpt_traverse_config { 152 xpt_traverse_depth depth; 153 void *tr_func; 154 void *tr_arg; 155 }; 156 157 typedef int xpt_busfunc_t (struct cam_eb *bus, void *arg); 158 typedef int xpt_targetfunc_t (struct cam_et *target, void *arg); 159 typedef int xpt_devicefunc_t (struct cam_ed *device, void *arg); 160 typedef int xpt_periphfunc_t (struct cam_periph *periph, void *arg); 161 typedef int xpt_pdrvfunc_t (struct periph_driver **pdrv, void *arg); 162 163 /* Transport layer configuration information */ 164 static struct xpt_softc xsoftc; 165 166 MTX_SYSINIT(xpt_topo_init, &xsoftc.xpt_topo_lock, "XPT topology lock", MTX_DEF); 167 168 SYSCTL_INT(_kern_cam, OID_AUTO, boot_delay, CTLFLAG_RDTUN, 169 &xsoftc.boot_delay, 0, "Bus registration wait time"); 170 SYSCTL_UINT(_kern_cam, OID_AUTO, xpt_generation, CTLFLAG_RD, 171 &xsoftc.xpt_generation, 0, "CAM peripheral generation count"); 172 SYSCTL_INT(_kern_cam, OID_AUTO, announce_nosbuf, CTLFLAG_RWTUN, 173 &xsoftc.announce_nosbuf, 0, "Don't use sbuf for announcements"); 174 175 struct cam_doneq { 176 struct mtx_padalign cam_doneq_mtx; 177 STAILQ_HEAD(, ccb_hdr) cam_doneq; 178 int cam_doneq_sleep; 179 }; 180 181 static struct cam_doneq cam_doneqs[MAXCPU]; 182 static int cam_num_doneqs; 183 static struct proc *cam_proc; 184 185 SYSCTL_INT(_kern_cam, OID_AUTO, num_doneqs, CTLFLAG_RDTUN, 186 &cam_num_doneqs, 0, "Number of completion queues/threads"); 187 188 struct cam_periph *xpt_periph; 189 190 static periph_init_t xpt_periph_init; 191 192 static struct periph_driver xpt_driver = 193 { 194 xpt_periph_init, "xpt", 195 TAILQ_HEAD_INITIALIZER(xpt_driver.units), /* generation */ 0, 196 CAM_PERIPH_DRV_EARLY 197 }; 198 199 PERIPHDRIVER_DECLARE(xpt, xpt_driver); 200 201 static d_open_t xptopen; 202 static d_close_t xptclose; 203 static d_ioctl_t xptioctl; 204 static d_ioctl_t xptdoioctl; 205 206 static struct cdevsw xpt_cdevsw = { 207 .d_version = D_VERSION, 208 .d_flags = 0, 209 .d_open = xptopen, 210 .d_close = xptclose, 211 .d_ioctl = xptioctl, 212 .d_name = "xpt", 213 }; 214 215 /* Storage for debugging datastructures */ 216 struct cam_path *cam_dpath; 217 u_int32_t __read_mostly cam_dflags = CAM_DEBUG_FLAGS; 218 SYSCTL_UINT(_kern_cam, OID_AUTO, dflags, CTLFLAG_RWTUN, 219 &cam_dflags, 0, "Enabled debug flags"); 220 u_int32_t cam_debug_delay = CAM_DEBUG_DELAY; 221 SYSCTL_UINT(_kern_cam, OID_AUTO, debug_delay, CTLFLAG_RWTUN, 222 &cam_debug_delay, 0, "Delay in us after each debug message"); 223 224 /* Our boot-time initialization hook */ 225 static int cam_module_event_handler(module_t, int /*modeventtype_t*/, void *); 226 227 static moduledata_t cam_moduledata = { 228 "cam", 229 cam_module_event_handler, 230 NULL 231 }; 232 233 static int xpt_init(void *); 234 235 DECLARE_MODULE(cam, cam_moduledata, SI_SUB_CONFIGURE, SI_ORDER_SECOND); 236 MODULE_VERSION(cam, 1); 237 238 239 static void xpt_async_bcast(struct async_list *async_head, 240 u_int32_t async_code, 241 struct cam_path *path, 242 void *async_arg); 243 static path_id_t xptnextfreepathid(void); 244 static path_id_t xptpathid(const char *sim_name, int sim_unit, int sim_bus); 245 static union ccb *xpt_get_ccb(struct cam_periph *periph); 246 static union ccb *xpt_get_ccb_nowait(struct cam_periph *periph); 247 static void xpt_run_allocq(struct cam_periph *periph, int sleep); 248 static void xpt_run_allocq_task(void *context, int pending); 249 static void xpt_run_devq(struct cam_devq *devq); 250 static callout_func_t xpt_release_devq_timeout; 251 static void xpt_acquire_bus(struct cam_eb *bus); 252 static void xpt_release_bus(struct cam_eb *bus); 253 static uint32_t xpt_freeze_devq_device(struct cam_ed *dev, u_int count); 254 static int xpt_release_devq_device(struct cam_ed *dev, u_int count, 255 int run_queue); 256 static struct cam_et* 257 xpt_alloc_target(struct cam_eb *bus, target_id_t target_id); 258 static void xpt_acquire_target(struct cam_et *target); 259 static void xpt_release_target(struct cam_et *target); 260 static struct cam_eb* 261 xpt_find_bus(path_id_t path_id); 262 static struct cam_et* 263 xpt_find_target(struct cam_eb *bus, target_id_t target_id); 264 static struct cam_ed* 265 xpt_find_device(struct cam_et *target, lun_id_t lun_id); 266 static void xpt_config(void *arg); 267 static void xpt_hold_boot_locked(void); 268 static int xpt_schedule_dev(struct camq *queue, cam_pinfo *dev_pinfo, 269 u_int32_t new_priority); 270 static xpt_devicefunc_t xptpassannouncefunc; 271 static void xptaction(struct cam_sim *sim, union ccb *work_ccb); 272 static void xptpoll(struct cam_sim *sim); 273 static void camisr_runqueue(void); 274 static void xpt_done_process(struct ccb_hdr *ccb_h); 275 static void xpt_done_td(void *); 276 static dev_match_ret xptbusmatch(struct dev_match_pattern *patterns, 277 u_int num_patterns, struct cam_eb *bus); 278 static dev_match_ret xptdevicematch(struct dev_match_pattern *patterns, 279 u_int num_patterns, 280 struct cam_ed *device); 281 static dev_match_ret xptperiphmatch(struct dev_match_pattern *patterns, 282 u_int num_patterns, 283 struct cam_periph *periph); 284 static xpt_busfunc_t xptedtbusfunc; 285 static xpt_targetfunc_t xptedttargetfunc; 286 static xpt_devicefunc_t xptedtdevicefunc; 287 static xpt_periphfunc_t xptedtperiphfunc; 288 static xpt_pdrvfunc_t xptplistpdrvfunc; 289 static xpt_periphfunc_t xptplistperiphfunc; 290 static int xptedtmatch(struct ccb_dev_match *cdm); 291 static int xptperiphlistmatch(struct ccb_dev_match *cdm); 292 static int xptbustraverse(struct cam_eb *start_bus, 293 xpt_busfunc_t *tr_func, void *arg); 294 static int xpttargettraverse(struct cam_eb *bus, 295 struct cam_et *start_target, 296 xpt_targetfunc_t *tr_func, void *arg); 297 static int xptdevicetraverse(struct cam_et *target, 298 struct cam_ed *start_device, 299 xpt_devicefunc_t *tr_func, void *arg); 300 static int xptperiphtraverse(struct cam_ed *device, 301 struct cam_periph *start_periph, 302 xpt_periphfunc_t *tr_func, void *arg); 303 static int xptpdrvtraverse(struct periph_driver **start_pdrv, 304 xpt_pdrvfunc_t *tr_func, void *arg); 305 static int xptpdperiphtraverse(struct periph_driver **pdrv, 306 struct cam_periph *start_periph, 307 xpt_periphfunc_t *tr_func, 308 void *arg); 309 static xpt_busfunc_t xptdefbusfunc; 310 static xpt_targetfunc_t xptdeftargetfunc; 311 static xpt_devicefunc_t xptdefdevicefunc; 312 static xpt_periphfunc_t xptdefperiphfunc; 313 static void xpt_finishconfig_task(void *context, int pending); 314 static void xpt_dev_async_default(u_int32_t async_code, 315 struct cam_eb *bus, 316 struct cam_et *target, 317 struct cam_ed *device, 318 void *async_arg); 319 static struct cam_ed * xpt_alloc_device_default(struct cam_eb *bus, 320 struct cam_et *target, 321 lun_id_t lun_id); 322 static xpt_devicefunc_t xptsetasyncfunc; 323 static xpt_busfunc_t xptsetasyncbusfunc; 324 static cam_status xptregister(struct cam_periph *periph, 325 void *arg); 326 static __inline int device_is_queued(struct cam_ed *device); 327 328 static __inline int 329 xpt_schedule_devq(struct cam_devq *devq, struct cam_ed *dev) 330 { 331 int retval; 332 333 mtx_assert(&devq->send_mtx, MA_OWNED); 334 if ((dev->ccbq.queue.entries > 0) && 335 (dev->ccbq.dev_openings > 0) && 336 (dev->ccbq.queue.qfrozen_cnt == 0)) { 337 /* 338 * The priority of a device waiting for controller 339 * resources is that of the highest priority CCB 340 * enqueued. 341 */ 342 retval = 343 xpt_schedule_dev(&devq->send_queue, 344 &dev->devq_entry, 345 CAMQ_GET_PRIO(&dev->ccbq.queue)); 346 } else { 347 retval = 0; 348 } 349 return (retval); 350 } 351 352 static __inline int 353 device_is_queued(struct cam_ed *device) 354 { 355 return (device->devq_entry.index != CAM_UNQUEUED_INDEX); 356 } 357 358 static void 359 xpt_periph_init() 360 { 361 make_dev(&xpt_cdevsw, 0, UID_ROOT, GID_OPERATOR, 0600, "xpt0"); 362 } 363 364 static int 365 xptopen(struct cdev *dev, int flags, int fmt, struct thread *td) 366 { 367 368 /* 369 * Only allow read-write access. 370 */ 371 if (((flags & FWRITE) == 0) || ((flags & FREAD) == 0)) 372 return(EPERM); 373 374 /* 375 * We don't allow nonblocking access. 376 */ 377 if ((flags & O_NONBLOCK) != 0) { 378 printf("%s: can't do nonblocking access\n", devtoname(dev)); 379 return(ENODEV); 380 } 381 382 return(0); 383 } 384 385 static int 386 xptclose(struct cdev *dev, int flag, int fmt, struct thread *td) 387 { 388 389 return(0); 390 } 391 392 /* 393 * Don't automatically grab the xpt softc lock here even though this is going 394 * through the xpt device. The xpt device is really just a back door for 395 * accessing other devices and SIMs, so the right thing to do is to grab 396 * the appropriate SIM lock once the bus/SIM is located. 397 */ 398 static int 399 xptioctl(struct cdev *dev, u_long cmd, caddr_t addr, int flag, struct thread *td) 400 { 401 int error; 402 403 if ((error = xptdoioctl(dev, cmd, addr, flag, td)) == ENOTTY) { 404 error = cam_compat_ioctl(dev, cmd, addr, flag, td, xptdoioctl); 405 } 406 return (error); 407 } 408 409 static int 410 xptdoioctl(struct cdev *dev, u_long cmd, caddr_t addr, int flag, struct thread *td) 411 { 412 int error; 413 414 error = 0; 415 416 switch(cmd) { 417 /* 418 * For the transport layer CAMIOCOMMAND ioctl, we really only want 419 * to accept CCB types that don't quite make sense to send through a 420 * passthrough driver. XPT_PATH_INQ is an exception to this, as stated 421 * in the CAM spec. 422 */ 423 case CAMIOCOMMAND: { 424 union ccb *ccb; 425 union ccb *inccb; 426 struct cam_eb *bus; 427 428 inccb = (union ccb *)addr; 429 #if defined(BUF_TRACKING) || defined(FULL_BUF_TRACKING) 430 if (inccb->ccb_h.func_code == XPT_SCSI_IO) 431 inccb->csio.bio = NULL; 432 #endif 433 434 if (inccb->ccb_h.flags & CAM_UNLOCKED) 435 return (EINVAL); 436 437 bus = xpt_find_bus(inccb->ccb_h.path_id); 438 if (bus == NULL) 439 return (EINVAL); 440 441 switch (inccb->ccb_h.func_code) { 442 case XPT_SCAN_BUS: 443 case XPT_RESET_BUS: 444 if (inccb->ccb_h.target_id != CAM_TARGET_WILDCARD || 445 inccb->ccb_h.target_lun != CAM_LUN_WILDCARD) { 446 xpt_release_bus(bus); 447 return (EINVAL); 448 } 449 break; 450 case XPT_SCAN_TGT: 451 if (inccb->ccb_h.target_id == CAM_TARGET_WILDCARD || 452 inccb->ccb_h.target_lun != CAM_LUN_WILDCARD) { 453 xpt_release_bus(bus); 454 return (EINVAL); 455 } 456 break; 457 default: 458 break; 459 } 460 461 switch(inccb->ccb_h.func_code) { 462 case XPT_SCAN_BUS: 463 case XPT_RESET_BUS: 464 case XPT_PATH_INQ: 465 case XPT_ENG_INQ: 466 case XPT_SCAN_LUN: 467 case XPT_SCAN_TGT: 468 469 ccb = xpt_alloc_ccb(); 470 471 /* 472 * Create a path using the bus, target, and lun the 473 * user passed in. 474 */ 475 if (xpt_create_path(&ccb->ccb_h.path, NULL, 476 inccb->ccb_h.path_id, 477 inccb->ccb_h.target_id, 478 inccb->ccb_h.target_lun) != 479 CAM_REQ_CMP){ 480 error = EINVAL; 481 xpt_free_ccb(ccb); 482 break; 483 } 484 /* Ensure all of our fields are correct */ 485 xpt_setup_ccb(&ccb->ccb_h, ccb->ccb_h.path, 486 inccb->ccb_h.pinfo.priority); 487 xpt_merge_ccb(ccb, inccb); 488 xpt_path_lock(ccb->ccb_h.path); 489 cam_periph_runccb(ccb, NULL, 0, 0, NULL); 490 xpt_path_unlock(ccb->ccb_h.path); 491 bcopy(ccb, inccb, sizeof(union ccb)); 492 xpt_free_path(ccb->ccb_h.path); 493 xpt_free_ccb(ccb); 494 break; 495 496 case XPT_DEBUG: { 497 union ccb ccb; 498 499 /* 500 * This is an immediate CCB, so it's okay to 501 * allocate it on the stack. 502 */ 503 504 /* 505 * Create a path using the bus, target, and lun the 506 * user passed in. 507 */ 508 if (xpt_create_path(&ccb.ccb_h.path, NULL, 509 inccb->ccb_h.path_id, 510 inccb->ccb_h.target_id, 511 inccb->ccb_h.target_lun) != 512 CAM_REQ_CMP){ 513 error = EINVAL; 514 break; 515 } 516 /* Ensure all of our fields are correct */ 517 xpt_setup_ccb(&ccb.ccb_h, ccb.ccb_h.path, 518 inccb->ccb_h.pinfo.priority); 519 xpt_merge_ccb(&ccb, inccb); 520 xpt_action(&ccb); 521 bcopy(&ccb, inccb, sizeof(union ccb)); 522 xpt_free_path(ccb.ccb_h.path); 523 break; 524 525 } 526 case XPT_DEV_MATCH: { 527 struct cam_periph_map_info mapinfo; 528 struct cam_path *old_path; 529 530 /* 531 * We can't deal with physical addresses for this 532 * type of transaction. 533 */ 534 if ((inccb->ccb_h.flags & CAM_DATA_MASK) != 535 CAM_DATA_VADDR) { 536 error = EINVAL; 537 break; 538 } 539 540 /* 541 * Save this in case the caller had it set to 542 * something in particular. 543 */ 544 old_path = inccb->ccb_h.path; 545 546 /* 547 * We really don't need a path for the matching 548 * code. The path is needed because of the 549 * debugging statements in xpt_action(). They 550 * assume that the CCB has a valid path. 551 */ 552 inccb->ccb_h.path = xpt_periph->path; 553 554 bzero(&mapinfo, sizeof(mapinfo)); 555 556 /* 557 * Map the pattern and match buffers into kernel 558 * virtual address space. 559 */ 560 error = cam_periph_mapmem(inccb, &mapinfo, MAXPHYS); 561 562 if (error) { 563 inccb->ccb_h.path = old_path; 564 break; 565 } 566 567 /* 568 * This is an immediate CCB, we can send it on directly. 569 */ 570 xpt_action(inccb); 571 572 /* 573 * Map the buffers back into user space. 574 */ 575 cam_periph_unmapmem(inccb, &mapinfo); 576 577 inccb->ccb_h.path = old_path; 578 579 error = 0; 580 break; 581 } 582 default: 583 error = ENOTSUP; 584 break; 585 } 586 xpt_release_bus(bus); 587 break; 588 } 589 /* 590 * This is the getpassthru ioctl. It takes a XPT_GDEVLIST ccb as input, 591 * with the periphal driver name and unit name filled in. The other 592 * fields don't really matter as input. The passthrough driver name 593 * ("pass"), and unit number are passed back in the ccb. The current 594 * device generation number, and the index into the device peripheral 595 * driver list, and the status are also passed back. Note that 596 * since we do everything in one pass, unlike the XPT_GDEVLIST ccb, 597 * we never return a status of CAM_GDEVLIST_LIST_CHANGED. It is 598 * (or rather should be) impossible for the device peripheral driver 599 * list to change since we look at the whole thing in one pass, and 600 * we do it with lock protection. 601 * 602 */ 603 case CAMGETPASSTHRU: { 604 union ccb *ccb; 605 struct cam_periph *periph; 606 struct periph_driver **p_drv; 607 char *name; 608 u_int unit; 609 int base_periph_found; 610 611 ccb = (union ccb *)addr; 612 unit = ccb->cgdl.unit_number; 613 name = ccb->cgdl.periph_name; 614 base_periph_found = 0; 615 #if defined(BUF_TRACKING) || defined(FULL_BUF_TRACKING) 616 if (ccb->ccb_h.func_code == XPT_SCSI_IO) 617 ccb->csio.bio = NULL; 618 #endif 619 620 /* 621 * Sanity check -- make sure we don't get a null peripheral 622 * driver name. 623 */ 624 if (*ccb->cgdl.periph_name == '\0') { 625 error = EINVAL; 626 break; 627 } 628 629 /* Keep the list from changing while we traverse it */ 630 xpt_lock_buses(); 631 632 /* first find our driver in the list of drivers */ 633 for (p_drv = periph_drivers; *p_drv != NULL; p_drv++) 634 if (strcmp((*p_drv)->driver_name, name) == 0) 635 break; 636 637 if (*p_drv == NULL) { 638 xpt_unlock_buses(); 639 ccb->ccb_h.status = CAM_REQ_CMP_ERR; 640 ccb->cgdl.status = CAM_GDEVLIST_ERROR; 641 *ccb->cgdl.periph_name = '\0'; 642 ccb->cgdl.unit_number = 0; 643 error = ENOENT; 644 break; 645 } 646 647 /* 648 * Run through every peripheral instance of this driver 649 * and check to see whether it matches the unit passed 650 * in by the user. If it does, get out of the loops and 651 * find the passthrough driver associated with that 652 * peripheral driver. 653 */ 654 for (periph = TAILQ_FIRST(&(*p_drv)->units); periph != NULL; 655 periph = TAILQ_NEXT(periph, unit_links)) { 656 657 if (periph->unit_number == unit) 658 break; 659 } 660 /* 661 * If we found the peripheral driver that the user passed 662 * in, go through all of the peripheral drivers for that 663 * particular device and look for a passthrough driver. 664 */ 665 if (periph != NULL) { 666 struct cam_ed *device; 667 int i; 668 669 base_periph_found = 1; 670 device = periph->path->device; 671 for (i = 0, periph = SLIST_FIRST(&device->periphs); 672 periph != NULL; 673 periph = SLIST_NEXT(periph, periph_links), i++) { 674 /* 675 * Check to see whether we have a 676 * passthrough device or not. 677 */ 678 if (strcmp(periph->periph_name, "pass") == 0) { 679 /* 680 * Fill in the getdevlist fields. 681 */ 682 strlcpy(ccb->cgdl.periph_name, 683 periph->periph_name, 684 sizeof(ccb->cgdl.periph_name)); 685 ccb->cgdl.unit_number = 686 periph->unit_number; 687 if (SLIST_NEXT(periph, periph_links)) 688 ccb->cgdl.status = 689 CAM_GDEVLIST_MORE_DEVS; 690 else 691 ccb->cgdl.status = 692 CAM_GDEVLIST_LAST_DEVICE; 693 ccb->cgdl.generation = 694 device->generation; 695 ccb->cgdl.index = i; 696 /* 697 * Fill in some CCB header fields 698 * that the user may want. 699 */ 700 ccb->ccb_h.path_id = 701 periph->path->bus->path_id; 702 ccb->ccb_h.target_id = 703 periph->path->target->target_id; 704 ccb->ccb_h.target_lun = 705 periph->path->device->lun_id; 706 ccb->ccb_h.status = CAM_REQ_CMP; 707 break; 708 } 709 } 710 } 711 712 /* 713 * If the periph is null here, one of two things has 714 * happened. The first possibility is that we couldn't 715 * find the unit number of the particular peripheral driver 716 * that the user is asking about. e.g. the user asks for 717 * the passthrough driver for "da11". We find the list of 718 * "da" peripherals all right, but there is no unit 11. 719 * The other possibility is that we went through the list 720 * of peripheral drivers attached to the device structure, 721 * but didn't find one with the name "pass". Either way, 722 * we return ENOENT, since we couldn't find something. 723 */ 724 if (periph == NULL) { 725 ccb->ccb_h.status = CAM_REQ_CMP_ERR; 726 ccb->cgdl.status = CAM_GDEVLIST_ERROR; 727 *ccb->cgdl.periph_name = '\0'; 728 ccb->cgdl.unit_number = 0; 729 error = ENOENT; 730 /* 731 * It is unfortunate that this is even necessary, 732 * but there are many, many clueless users out there. 733 * If this is true, the user is looking for the 734 * passthrough driver, but doesn't have one in his 735 * kernel. 736 */ 737 if (base_periph_found == 1) { 738 printf("xptioctl: pass driver is not in the " 739 "kernel\n"); 740 printf("xptioctl: put \"device pass\" in " 741 "your kernel config file\n"); 742 } 743 } 744 xpt_unlock_buses(); 745 break; 746 } 747 default: 748 error = ENOTTY; 749 break; 750 } 751 752 return(error); 753 } 754 755 static int 756 cam_module_event_handler(module_t mod, int what, void *arg) 757 { 758 int error; 759 760 switch (what) { 761 case MOD_LOAD: 762 if ((error = xpt_init(NULL)) != 0) 763 return (error); 764 break; 765 case MOD_UNLOAD: 766 return EBUSY; 767 default: 768 return EOPNOTSUPP; 769 } 770 771 return 0; 772 } 773 774 static struct xpt_proto * 775 xpt_proto_find(cam_proto proto) 776 { 777 struct xpt_proto **pp; 778 779 SET_FOREACH(pp, cam_xpt_proto_set) { 780 if ((*pp)->proto == proto) 781 return *pp; 782 } 783 784 return NULL; 785 } 786 787 static void 788 xpt_rescan_done(struct cam_periph *periph, union ccb *done_ccb) 789 { 790 791 if (done_ccb->ccb_h.ppriv_ptr1 == NULL) { 792 xpt_free_path(done_ccb->ccb_h.path); 793 xpt_free_ccb(done_ccb); 794 } else { 795 done_ccb->ccb_h.cbfcnp = done_ccb->ccb_h.ppriv_ptr1; 796 (*done_ccb->ccb_h.cbfcnp)(periph, done_ccb); 797 } 798 xpt_release_boot(); 799 } 800 801 /* thread to handle bus rescans */ 802 static void 803 xpt_scanner_thread(void *dummy) 804 { 805 union ccb *ccb; 806 struct cam_path path; 807 808 xpt_lock_buses(); 809 for (;;) { 810 if (TAILQ_EMPTY(&xsoftc.ccb_scanq)) 811 msleep(&xsoftc.ccb_scanq, &xsoftc.xpt_topo_lock, PRIBIO, 812 "-", 0); 813 if ((ccb = (union ccb *)TAILQ_FIRST(&xsoftc.ccb_scanq)) != NULL) { 814 TAILQ_REMOVE(&xsoftc.ccb_scanq, &ccb->ccb_h, sim_links.tqe); 815 xpt_unlock_buses(); 816 817 /* 818 * Since lock can be dropped inside and path freed 819 * by completion callback even before return here, 820 * take our own path copy for reference. 821 */ 822 xpt_copy_path(&path, ccb->ccb_h.path); 823 xpt_path_lock(&path); 824 xpt_action(ccb); 825 xpt_path_unlock(&path); 826 xpt_release_path(&path); 827 828 xpt_lock_buses(); 829 } 830 } 831 } 832 833 void 834 xpt_rescan(union ccb *ccb) 835 { 836 struct ccb_hdr *hdr; 837 838 /* Prepare request */ 839 if (ccb->ccb_h.path->target->target_id == CAM_TARGET_WILDCARD && 840 ccb->ccb_h.path->device->lun_id == CAM_LUN_WILDCARD) 841 ccb->ccb_h.func_code = XPT_SCAN_BUS; 842 else if (ccb->ccb_h.path->target->target_id != CAM_TARGET_WILDCARD && 843 ccb->ccb_h.path->device->lun_id == CAM_LUN_WILDCARD) 844 ccb->ccb_h.func_code = XPT_SCAN_TGT; 845 else if (ccb->ccb_h.path->target->target_id != CAM_TARGET_WILDCARD && 846 ccb->ccb_h.path->device->lun_id != CAM_LUN_WILDCARD) 847 ccb->ccb_h.func_code = XPT_SCAN_LUN; 848 else { 849 xpt_print(ccb->ccb_h.path, "illegal scan path\n"); 850 xpt_free_path(ccb->ccb_h.path); 851 xpt_free_ccb(ccb); 852 return; 853 } 854 CAM_DEBUG(ccb->ccb_h.path, CAM_DEBUG_TRACE, 855 ("xpt_rescan: func %#x %s\n", ccb->ccb_h.func_code, 856 xpt_action_name(ccb->ccb_h.func_code))); 857 858 ccb->ccb_h.ppriv_ptr1 = ccb->ccb_h.cbfcnp; 859 ccb->ccb_h.cbfcnp = xpt_rescan_done; 860 xpt_setup_ccb(&ccb->ccb_h, ccb->ccb_h.path, CAM_PRIORITY_XPT); 861 /* Don't make duplicate entries for the same paths. */ 862 xpt_lock_buses(); 863 if (ccb->ccb_h.ppriv_ptr1 == NULL) { 864 TAILQ_FOREACH(hdr, &xsoftc.ccb_scanq, sim_links.tqe) { 865 if (xpt_path_comp(hdr->path, ccb->ccb_h.path) == 0) { 866 wakeup(&xsoftc.ccb_scanq); 867 xpt_unlock_buses(); 868 xpt_print(ccb->ccb_h.path, "rescan already queued\n"); 869 xpt_free_path(ccb->ccb_h.path); 870 xpt_free_ccb(ccb); 871 return; 872 } 873 } 874 } 875 TAILQ_INSERT_TAIL(&xsoftc.ccb_scanq, &ccb->ccb_h, sim_links.tqe); 876 xpt_hold_boot_locked(); 877 wakeup(&xsoftc.ccb_scanq); 878 xpt_unlock_buses(); 879 } 880 881 /* Functions accessed by the peripheral drivers */ 882 static int 883 xpt_init(void *dummy) 884 { 885 struct cam_sim *xpt_sim; 886 struct cam_path *path; 887 struct cam_devq *devq; 888 cam_status status; 889 int error, i; 890 891 TAILQ_INIT(&xsoftc.xpt_busses); 892 TAILQ_INIT(&xsoftc.ccb_scanq); 893 STAILQ_INIT(&xsoftc.highpowerq); 894 xsoftc.num_highpower = CAM_MAX_HIGHPOWER; 895 896 mtx_init(&xsoftc.xpt_highpower_lock, "XPT highpower lock", NULL, MTX_DEF); 897 xsoftc.xpt_taskq = taskqueue_create("CAM XPT task", M_WAITOK, 898 taskqueue_thread_enqueue, /*context*/&xsoftc.xpt_taskq); 899 900 #ifdef CAM_BOOT_DELAY 901 /* 902 * Override this value at compile time to assist our users 903 * who don't use loader to boot a kernel. 904 */ 905 xsoftc.boot_delay = CAM_BOOT_DELAY; 906 #endif 907 908 /* 909 * The xpt layer is, itself, the equivalent of a SIM. 910 * Allow 16 ccbs in the ccb pool for it. This should 911 * give decent parallelism when we probe buses and 912 * perform other XPT functions. 913 */ 914 devq = cam_simq_alloc(16); 915 xpt_sim = cam_sim_alloc(xptaction, 916 xptpoll, 917 "xpt", 918 /*softc*/NULL, 919 /*unit*/0, 920 /*mtx*/NULL, 921 /*max_dev_transactions*/0, 922 /*max_tagged_dev_transactions*/0, 923 devq); 924 if (xpt_sim == NULL) 925 return (ENOMEM); 926 927 if ((status = xpt_bus_register(xpt_sim, NULL, 0)) != CAM_SUCCESS) { 928 printf("xpt_init: xpt_bus_register failed with status %#x," 929 " failing attach\n", status); 930 return (EINVAL); 931 } 932 933 /* 934 * Looking at the XPT from the SIM layer, the XPT is 935 * the equivalent of a peripheral driver. Allocate 936 * a peripheral driver entry for us. 937 */ 938 if ((status = xpt_create_path(&path, NULL, CAM_XPT_PATH_ID, 939 CAM_TARGET_WILDCARD, 940 CAM_LUN_WILDCARD)) != CAM_REQ_CMP) { 941 printf("xpt_init: xpt_create_path failed with status %#x," 942 " failing attach\n", status); 943 return (EINVAL); 944 } 945 xpt_path_lock(path); 946 cam_periph_alloc(xptregister, NULL, NULL, NULL, "xpt", CAM_PERIPH_BIO, 947 path, NULL, 0, xpt_sim); 948 xpt_path_unlock(path); 949 xpt_free_path(path); 950 951 if (cam_num_doneqs < 1) 952 cam_num_doneqs = 1 + mp_ncpus / 6; 953 else if (cam_num_doneqs > MAXCPU) 954 cam_num_doneqs = MAXCPU; 955 for (i = 0; i < cam_num_doneqs; i++) { 956 mtx_init(&cam_doneqs[i].cam_doneq_mtx, "CAM doneq", NULL, 957 MTX_DEF); 958 STAILQ_INIT(&cam_doneqs[i].cam_doneq); 959 error = kproc_kthread_add(xpt_done_td, &cam_doneqs[i], 960 &cam_proc, NULL, 0, 0, "cam", "doneq%d", i); 961 if (error != 0) { 962 cam_num_doneqs = i; 963 break; 964 } 965 } 966 if (cam_num_doneqs < 1) { 967 printf("xpt_init: Cannot init completion queues " 968 "- failing attach\n"); 969 return (ENOMEM); 970 } 971 972 /* 973 * Register a callback for when interrupts are enabled. 974 */ 975 config_intrhook_oneshot(xpt_config, NULL); 976 977 return (0); 978 } 979 980 static cam_status 981 xptregister(struct cam_periph *periph, void *arg) 982 { 983 struct cam_sim *xpt_sim; 984 985 if (periph == NULL) { 986 printf("xptregister: periph was NULL!!\n"); 987 return(CAM_REQ_CMP_ERR); 988 } 989 990 xpt_sim = (struct cam_sim *)arg; 991 xpt_sim->softc = periph; 992 xpt_periph = periph; 993 periph->softc = NULL; 994 995 return(CAM_REQ_CMP); 996 } 997 998 int32_t 999 xpt_add_periph(struct cam_periph *periph) 1000 { 1001 struct cam_ed *device; 1002 int32_t status; 1003 1004 TASK_INIT(&periph->periph_run_task, 0, xpt_run_allocq_task, periph); 1005 device = periph->path->device; 1006 status = CAM_REQ_CMP; 1007 if (device != NULL) { 1008 mtx_lock(&device->target->bus->eb_mtx); 1009 device->generation++; 1010 SLIST_INSERT_HEAD(&device->periphs, periph, periph_links); 1011 mtx_unlock(&device->target->bus->eb_mtx); 1012 atomic_add_32(&xsoftc.xpt_generation, 1); 1013 } 1014 1015 return (status); 1016 } 1017 1018 void 1019 xpt_remove_periph(struct cam_periph *periph) 1020 { 1021 struct cam_ed *device; 1022 1023 device = periph->path->device; 1024 if (device != NULL) { 1025 mtx_lock(&device->target->bus->eb_mtx); 1026 device->generation++; 1027 SLIST_REMOVE(&device->periphs, periph, cam_periph, periph_links); 1028 mtx_unlock(&device->target->bus->eb_mtx); 1029 atomic_add_32(&xsoftc.xpt_generation, 1); 1030 } 1031 } 1032 1033 1034 void 1035 xpt_announce_periph(struct cam_periph *periph, char *announce_string) 1036 { 1037 struct cam_path *path = periph->path; 1038 struct xpt_proto *proto; 1039 1040 cam_periph_assert(periph, MA_OWNED); 1041 periph->flags |= CAM_PERIPH_ANNOUNCED; 1042 1043 printf("%s%d at %s%d bus %d scbus%d target %d lun %jx\n", 1044 periph->periph_name, periph->unit_number, 1045 path->bus->sim->sim_name, 1046 path->bus->sim->unit_number, 1047 path->bus->sim->bus_id, 1048 path->bus->path_id, 1049 path->target->target_id, 1050 (uintmax_t)path->device->lun_id); 1051 printf("%s%d: ", periph->periph_name, periph->unit_number); 1052 proto = xpt_proto_find(path->device->protocol); 1053 if (proto) 1054 proto->ops->announce(path->device); 1055 else 1056 printf("%s%d: Unknown protocol device %d\n", 1057 periph->periph_name, periph->unit_number, 1058 path->device->protocol); 1059 if (path->device->serial_num_len > 0) { 1060 /* Don't wrap the screen - print only the first 60 chars */ 1061 printf("%s%d: Serial Number %.60s\n", periph->periph_name, 1062 periph->unit_number, path->device->serial_num); 1063 } 1064 /* Announce transport details. */ 1065 path->bus->xport->ops->announce(periph); 1066 /* Announce command queueing. */ 1067 if (path->device->inq_flags & SID_CmdQue 1068 || path->device->flags & CAM_DEV_TAG_AFTER_COUNT) { 1069 printf("%s%d: Command Queueing enabled\n", 1070 periph->periph_name, periph->unit_number); 1071 } 1072 /* Announce caller's details if they've passed in. */ 1073 if (announce_string != NULL) 1074 printf("%s%d: %s\n", periph->periph_name, 1075 periph->unit_number, announce_string); 1076 } 1077 1078 void 1079 xpt_announce_periph_sbuf(struct cam_periph *periph, struct sbuf *sb, 1080 char *announce_string) 1081 { 1082 struct cam_path *path = periph->path; 1083 struct xpt_proto *proto; 1084 1085 cam_periph_assert(periph, MA_OWNED); 1086 periph->flags |= CAM_PERIPH_ANNOUNCED; 1087 1088 /* Fall back to the non-sbuf method if necessary */ 1089 if (xsoftc.announce_nosbuf != 0) { 1090 xpt_announce_periph(periph, announce_string); 1091 return; 1092 } 1093 proto = xpt_proto_find(path->device->protocol); 1094 if (((proto != NULL) && (proto->ops->announce_sbuf == NULL)) || 1095 (path->bus->xport->ops->announce_sbuf == NULL)) { 1096 xpt_announce_periph(periph, announce_string); 1097 return; 1098 } 1099 1100 sbuf_printf(sb, "%s%d at %s%d bus %d scbus%d target %d lun %jx\n", 1101 periph->periph_name, periph->unit_number, 1102 path->bus->sim->sim_name, 1103 path->bus->sim->unit_number, 1104 path->bus->sim->bus_id, 1105 path->bus->path_id, 1106 path->target->target_id, 1107 (uintmax_t)path->device->lun_id); 1108 sbuf_printf(sb, "%s%d: ", periph->periph_name, periph->unit_number); 1109 1110 if (proto) 1111 proto->ops->announce_sbuf(path->device, sb); 1112 else 1113 sbuf_printf(sb, "%s%d: Unknown protocol device %d\n", 1114 periph->periph_name, periph->unit_number, 1115 path->device->protocol); 1116 if (path->device->serial_num_len > 0) { 1117 /* Don't wrap the screen - print only the first 60 chars */ 1118 sbuf_printf(sb, "%s%d: Serial Number %.60s\n", 1119 periph->periph_name, periph->unit_number, 1120 path->device->serial_num); 1121 } 1122 /* Announce transport details. */ 1123 path->bus->xport->ops->announce_sbuf(periph, sb); 1124 /* Announce command queueing. */ 1125 if (path->device->inq_flags & SID_CmdQue 1126 || path->device->flags & CAM_DEV_TAG_AFTER_COUNT) { 1127 sbuf_printf(sb, "%s%d: Command Queueing enabled\n", 1128 periph->periph_name, periph->unit_number); 1129 } 1130 /* Announce caller's details if they've passed in. */ 1131 if (announce_string != NULL) 1132 sbuf_printf(sb, "%s%d: %s\n", periph->periph_name, 1133 periph->unit_number, announce_string); 1134 } 1135 1136 void 1137 xpt_announce_quirks(struct cam_periph *periph, int quirks, char *bit_string) 1138 { 1139 if (quirks != 0) { 1140 printf("%s%d: quirks=0x%b\n", periph->periph_name, 1141 periph->unit_number, quirks, bit_string); 1142 } 1143 } 1144 1145 void 1146 xpt_announce_quirks_sbuf(struct cam_periph *periph, struct sbuf *sb, 1147 int quirks, char *bit_string) 1148 { 1149 if (xsoftc.announce_nosbuf != 0) { 1150 xpt_announce_quirks(periph, quirks, bit_string); 1151 return; 1152 } 1153 1154 if (quirks != 0) { 1155 sbuf_printf(sb, "%s%d: quirks=0x%b\n", periph->periph_name, 1156 periph->unit_number, quirks, bit_string); 1157 } 1158 } 1159 1160 void 1161 xpt_denounce_periph(struct cam_periph *periph) 1162 { 1163 struct cam_path *path = periph->path; 1164 struct xpt_proto *proto; 1165 1166 cam_periph_assert(periph, MA_OWNED); 1167 printf("%s%d at %s%d bus %d scbus%d target %d lun %jx\n", 1168 periph->periph_name, periph->unit_number, 1169 path->bus->sim->sim_name, 1170 path->bus->sim->unit_number, 1171 path->bus->sim->bus_id, 1172 path->bus->path_id, 1173 path->target->target_id, 1174 (uintmax_t)path->device->lun_id); 1175 printf("%s%d: ", periph->periph_name, periph->unit_number); 1176 proto = xpt_proto_find(path->device->protocol); 1177 if (proto) 1178 proto->ops->denounce(path->device); 1179 else 1180 printf("%s%d: Unknown protocol device %d\n", 1181 periph->periph_name, periph->unit_number, 1182 path->device->protocol); 1183 if (path->device->serial_num_len > 0) 1184 printf(" s/n %.60s", path->device->serial_num); 1185 printf(" detached\n"); 1186 } 1187 1188 void 1189 xpt_denounce_periph_sbuf(struct cam_periph *periph, struct sbuf *sb) 1190 { 1191 struct cam_path *path = periph->path; 1192 struct xpt_proto *proto; 1193 1194 cam_periph_assert(periph, MA_OWNED); 1195 1196 /* Fall back to the non-sbuf method if necessary */ 1197 if (xsoftc.announce_nosbuf != 0) { 1198 xpt_denounce_periph(periph); 1199 return; 1200 } 1201 proto = xpt_proto_find(path->device->protocol); 1202 if ((proto != NULL) && (proto->ops->denounce_sbuf == NULL)) { 1203 xpt_denounce_periph(periph); 1204 return; 1205 } 1206 1207 sbuf_printf(sb, "%s%d at %s%d bus %d scbus%d target %d lun %jx\n", 1208 periph->periph_name, periph->unit_number, 1209 path->bus->sim->sim_name, 1210 path->bus->sim->unit_number, 1211 path->bus->sim->bus_id, 1212 path->bus->path_id, 1213 path->target->target_id, 1214 (uintmax_t)path->device->lun_id); 1215 sbuf_printf(sb, "%s%d: ", periph->periph_name, periph->unit_number); 1216 1217 if (proto) 1218 proto->ops->denounce_sbuf(path->device, sb); 1219 else 1220 sbuf_printf(sb, "%s%d: Unknown protocol device %d\n", 1221 periph->periph_name, periph->unit_number, 1222 path->device->protocol); 1223 if (path->device->serial_num_len > 0) 1224 sbuf_printf(sb, " s/n %.60s", path->device->serial_num); 1225 sbuf_printf(sb, " detached\n"); 1226 } 1227 1228 int 1229 xpt_getattr(char *buf, size_t len, const char *attr, struct cam_path *path) 1230 { 1231 int ret = -1, l, o; 1232 struct ccb_dev_advinfo cdai; 1233 struct scsi_vpd_device_id *did; 1234 struct scsi_vpd_id_descriptor *idd; 1235 1236 xpt_path_assert(path, MA_OWNED); 1237 1238 memset(&cdai, 0, sizeof(cdai)); 1239 xpt_setup_ccb(&cdai.ccb_h, path, CAM_PRIORITY_NORMAL); 1240 cdai.ccb_h.func_code = XPT_DEV_ADVINFO; 1241 cdai.flags = CDAI_FLAG_NONE; 1242 cdai.bufsiz = len; 1243 cdai.buf = buf; 1244 1245 if (!strcmp(attr, "GEOM::ident")) 1246 cdai.buftype = CDAI_TYPE_SERIAL_NUM; 1247 else if (!strcmp(attr, "GEOM::physpath")) 1248 cdai.buftype = CDAI_TYPE_PHYS_PATH; 1249 else if (strcmp(attr, "GEOM::lunid") == 0 || 1250 strcmp(attr, "GEOM::lunname") == 0) { 1251 cdai.buftype = CDAI_TYPE_SCSI_DEVID; 1252 cdai.bufsiz = CAM_SCSI_DEVID_MAXLEN; 1253 cdai.buf = malloc(cdai.bufsiz, M_CAMXPT, M_NOWAIT); 1254 if (cdai.buf == NULL) { 1255 ret = ENOMEM; 1256 goto out; 1257 } 1258 } else 1259 goto out; 1260 1261 xpt_action((union ccb *)&cdai); /* can only be synchronous */ 1262 if ((cdai.ccb_h.status & CAM_DEV_QFRZN) != 0) 1263 cam_release_devq(cdai.ccb_h.path, 0, 0, 0, FALSE); 1264 if (cdai.provsiz == 0) 1265 goto out; 1266 switch(cdai.buftype) { 1267 case CDAI_TYPE_SCSI_DEVID: 1268 did = (struct scsi_vpd_device_id *)cdai.buf; 1269 if (strcmp(attr, "GEOM::lunid") == 0) { 1270 idd = scsi_get_devid(did, cdai.provsiz, 1271 scsi_devid_is_lun_naa); 1272 if (idd == NULL) 1273 idd = scsi_get_devid(did, cdai.provsiz, 1274 scsi_devid_is_lun_eui64); 1275 if (idd == NULL) 1276 idd = scsi_get_devid(did, cdai.provsiz, 1277 scsi_devid_is_lun_uuid); 1278 if (idd == NULL) 1279 idd = scsi_get_devid(did, cdai.provsiz, 1280 scsi_devid_is_lun_md5); 1281 } else 1282 idd = NULL; 1283 1284 if (idd == NULL) 1285 idd = scsi_get_devid(did, cdai.provsiz, 1286 scsi_devid_is_lun_t10); 1287 if (idd == NULL) 1288 idd = scsi_get_devid(did, cdai.provsiz, 1289 scsi_devid_is_lun_name); 1290 if (idd == NULL) 1291 break; 1292 1293 ret = 0; 1294 if ((idd->proto_codeset & SVPD_ID_CODESET_MASK) == 1295 SVPD_ID_CODESET_ASCII) { 1296 if (idd->length < len) { 1297 for (l = 0; l < idd->length; l++) 1298 buf[l] = idd->identifier[l] ? 1299 idd->identifier[l] : ' '; 1300 buf[l] = 0; 1301 } else 1302 ret = EFAULT; 1303 break; 1304 } 1305 if ((idd->proto_codeset & SVPD_ID_CODESET_MASK) == 1306 SVPD_ID_CODESET_UTF8) { 1307 l = strnlen(idd->identifier, idd->length); 1308 if (l < len) { 1309 bcopy(idd->identifier, buf, l); 1310 buf[l] = 0; 1311 } else 1312 ret = EFAULT; 1313 break; 1314 } 1315 if ((idd->id_type & SVPD_ID_TYPE_MASK) == 1316 SVPD_ID_TYPE_UUID && idd->identifier[0] == 0x10) { 1317 if ((idd->length - 2) * 2 + 4 >= len) { 1318 ret = EFAULT; 1319 break; 1320 } 1321 for (l = 2, o = 0; l < idd->length; l++) { 1322 if (l == 6 || l == 8 || l == 10 || l == 12) 1323 o += sprintf(buf + o, "-"); 1324 o += sprintf(buf + o, "%02x", 1325 idd->identifier[l]); 1326 } 1327 break; 1328 } 1329 if (idd->length * 2 < len) { 1330 for (l = 0; l < idd->length; l++) 1331 sprintf(buf + l * 2, "%02x", 1332 idd->identifier[l]); 1333 } else 1334 ret = EFAULT; 1335 break; 1336 default: 1337 if (cdai.provsiz < len) { 1338 cdai.buf[cdai.provsiz] = 0; 1339 ret = 0; 1340 } else 1341 ret = EFAULT; 1342 break; 1343 } 1344 1345 out: 1346 if ((char *)cdai.buf != buf) 1347 free(cdai.buf, M_CAMXPT); 1348 return ret; 1349 } 1350 1351 static dev_match_ret 1352 xptbusmatch(struct dev_match_pattern *patterns, u_int num_patterns, 1353 struct cam_eb *bus) 1354 { 1355 dev_match_ret retval; 1356 u_int i; 1357 1358 retval = DM_RET_NONE; 1359 1360 /* 1361 * If we aren't given something to match against, that's an error. 1362 */ 1363 if (bus == NULL) 1364 return(DM_RET_ERROR); 1365 1366 /* 1367 * If there are no match entries, then this bus matches no 1368 * matter what. 1369 */ 1370 if ((patterns == NULL) || (num_patterns == 0)) 1371 return(DM_RET_DESCEND | DM_RET_COPY); 1372 1373 for (i = 0; i < num_patterns; i++) { 1374 struct bus_match_pattern *cur_pattern; 1375 1376 /* 1377 * If the pattern in question isn't for a bus node, we 1378 * aren't interested. However, we do indicate to the 1379 * calling routine that we should continue descending the 1380 * tree, since the user wants to match against lower-level 1381 * EDT elements. 1382 */ 1383 if (patterns[i].type != DEV_MATCH_BUS) { 1384 if ((retval & DM_RET_ACTION_MASK) == DM_RET_NONE) 1385 retval |= DM_RET_DESCEND; 1386 continue; 1387 } 1388 1389 cur_pattern = &patterns[i].pattern.bus_pattern; 1390 1391 /* 1392 * If they want to match any bus node, we give them any 1393 * device node. 1394 */ 1395 if (cur_pattern->flags == BUS_MATCH_ANY) { 1396 /* set the copy flag */ 1397 retval |= DM_RET_COPY; 1398 1399 /* 1400 * If we've already decided on an action, go ahead 1401 * and return. 1402 */ 1403 if ((retval & DM_RET_ACTION_MASK) != DM_RET_NONE) 1404 return(retval); 1405 } 1406 1407 /* 1408 * Not sure why someone would do this... 1409 */ 1410 if (cur_pattern->flags == BUS_MATCH_NONE) 1411 continue; 1412 1413 if (((cur_pattern->flags & BUS_MATCH_PATH) != 0) 1414 && (cur_pattern->path_id != bus->path_id)) 1415 continue; 1416 1417 if (((cur_pattern->flags & BUS_MATCH_BUS_ID) != 0) 1418 && (cur_pattern->bus_id != bus->sim->bus_id)) 1419 continue; 1420 1421 if (((cur_pattern->flags & BUS_MATCH_UNIT) != 0) 1422 && (cur_pattern->unit_number != bus->sim->unit_number)) 1423 continue; 1424 1425 if (((cur_pattern->flags & BUS_MATCH_NAME) != 0) 1426 && (strncmp(cur_pattern->dev_name, bus->sim->sim_name, 1427 DEV_IDLEN) != 0)) 1428 continue; 1429 1430 /* 1431 * If we get to this point, the user definitely wants 1432 * information on this bus. So tell the caller to copy the 1433 * data out. 1434 */ 1435 retval |= DM_RET_COPY; 1436 1437 /* 1438 * If the return action has been set to descend, then we 1439 * know that we've already seen a non-bus matching 1440 * expression, therefore we need to further descend the tree. 1441 * This won't change by continuing around the loop, so we 1442 * go ahead and return. If we haven't seen a non-bus 1443 * matching expression, we keep going around the loop until 1444 * we exhaust the matching expressions. We'll set the stop 1445 * flag once we fall out of the loop. 1446 */ 1447 if ((retval & DM_RET_ACTION_MASK) == DM_RET_DESCEND) 1448 return(retval); 1449 } 1450 1451 /* 1452 * If the return action hasn't been set to descend yet, that means 1453 * we haven't seen anything other than bus matching patterns. So 1454 * tell the caller to stop descending the tree -- the user doesn't 1455 * want to match against lower level tree elements. 1456 */ 1457 if ((retval & DM_RET_ACTION_MASK) == DM_RET_NONE) 1458 retval |= DM_RET_STOP; 1459 1460 return(retval); 1461 } 1462 1463 static dev_match_ret 1464 xptdevicematch(struct dev_match_pattern *patterns, u_int num_patterns, 1465 struct cam_ed *device) 1466 { 1467 dev_match_ret retval; 1468 u_int i; 1469 1470 retval = DM_RET_NONE; 1471 1472 /* 1473 * If we aren't given something to match against, that's an error. 1474 */ 1475 if (device == NULL) 1476 return(DM_RET_ERROR); 1477 1478 /* 1479 * If there are no match entries, then this device matches no 1480 * matter what. 1481 */ 1482 if ((patterns == NULL) || (num_patterns == 0)) 1483 return(DM_RET_DESCEND | DM_RET_COPY); 1484 1485 for (i = 0; i < num_patterns; i++) { 1486 struct device_match_pattern *cur_pattern; 1487 struct scsi_vpd_device_id *device_id_page; 1488 1489 /* 1490 * If the pattern in question isn't for a device node, we 1491 * aren't interested. 1492 */ 1493 if (patterns[i].type != DEV_MATCH_DEVICE) { 1494 if ((patterns[i].type == DEV_MATCH_PERIPH) 1495 && ((retval & DM_RET_ACTION_MASK) == DM_RET_NONE)) 1496 retval |= DM_RET_DESCEND; 1497 continue; 1498 } 1499 1500 cur_pattern = &patterns[i].pattern.device_pattern; 1501 1502 /* Error out if mutually exclusive options are specified. */ 1503 if ((cur_pattern->flags & (DEV_MATCH_INQUIRY|DEV_MATCH_DEVID)) 1504 == (DEV_MATCH_INQUIRY|DEV_MATCH_DEVID)) 1505 return(DM_RET_ERROR); 1506 1507 /* 1508 * If they want to match any device node, we give them any 1509 * device node. 1510 */ 1511 if (cur_pattern->flags == DEV_MATCH_ANY) 1512 goto copy_dev_node; 1513 1514 /* 1515 * Not sure why someone would do this... 1516 */ 1517 if (cur_pattern->flags == DEV_MATCH_NONE) 1518 continue; 1519 1520 if (((cur_pattern->flags & DEV_MATCH_PATH) != 0) 1521 && (cur_pattern->path_id != device->target->bus->path_id)) 1522 continue; 1523 1524 if (((cur_pattern->flags & DEV_MATCH_TARGET) != 0) 1525 && (cur_pattern->target_id != device->target->target_id)) 1526 continue; 1527 1528 if (((cur_pattern->flags & DEV_MATCH_LUN) != 0) 1529 && (cur_pattern->target_lun != device->lun_id)) 1530 continue; 1531 1532 if (((cur_pattern->flags & DEV_MATCH_INQUIRY) != 0) 1533 && (cam_quirkmatch((caddr_t)&device->inq_data, 1534 (caddr_t)&cur_pattern->data.inq_pat, 1535 1, sizeof(cur_pattern->data.inq_pat), 1536 scsi_static_inquiry_match) == NULL)) 1537 continue; 1538 1539 device_id_page = (struct scsi_vpd_device_id *)device->device_id; 1540 if (((cur_pattern->flags & DEV_MATCH_DEVID) != 0) 1541 && (device->device_id_len < SVPD_DEVICE_ID_HDR_LEN 1542 || scsi_devid_match((uint8_t *)device_id_page->desc_list, 1543 device->device_id_len 1544 - SVPD_DEVICE_ID_HDR_LEN, 1545 cur_pattern->data.devid_pat.id, 1546 cur_pattern->data.devid_pat.id_len) != 0)) 1547 continue; 1548 1549 copy_dev_node: 1550 /* 1551 * If we get to this point, the user definitely wants 1552 * information on this device. So tell the caller to copy 1553 * the data out. 1554 */ 1555 retval |= DM_RET_COPY; 1556 1557 /* 1558 * If the return action has been set to descend, then we 1559 * know that we've already seen a peripheral matching 1560 * expression, therefore we need to further descend the tree. 1561 * This won't change by continuing around the loop, so we 1562 * go ahead and return. If we haven't seen a peripheral 1563 * matching expression, we keep going around the loop until 1564 * we exhaust the matching expressions. We'll set the stop 1565 * flag once we fall out of the loop. 1566 */ 1567 if ((retval & DM_RET_ACTION_MASK) == DM_RET_DESCEND) 1568 return(retval); 1569 } 1570 1571 /* 1572 * If the return action hasn't been set to descend yet, that means 1573 * we haven't seen any peripheral matching patterns. So tell the 1574 * caller to stop descending the tree -- the user doesn't want to 1575 * match against lower level tree elements. 1576 */ 1577 if ((retval & DM_RET_ACTION_MASK) == DM_RET_NONE) 1578 retval |= DM_RET_STOP; 1579 1580 return(retval); 1581 } 1582 1583 /* 1584 * Match a single peripheral against any number of match patterns. 1585 */ 1586 static dev_match_ret 1587 xptperiphmatch(struct dev_match_pattern *patterns, u_int num_patterns, 1588 struct cam_periph *periph) 1589 { 1590 dev_match_ret retval; 1591 u_int i; 1592 1593 /* 1594 * If we aren't given something to match against, that's an error. 1595 */ 1596 if (periph == NULL) 1597 return(DM_RET_ERROR); 1598 1599 /* 1600 * If there are no match entries, then this peripheral matches no 1601 * matter what. 1602 */ 1603 if ((patterns == NULL) || (num_patterns == 0)) 1604 return(DM_RET_STOP | DM_RET_COPY); 1605 1606 /* 1607 * There aren't any nodes below a peripheral node, so there's no 1608 * reason to descend the tree any further. 1609 */ 1610 retval = DM_RET_STOP; 1611 1612 for (i = 0; i < num_patterns; i++) { 1613 struct periph_match_pattern *cur_pattern; 1614 1615 /* 1616 * If the pattern in question isn't for a peripheral, we 1617 * aren't interested. 1618 */ 1619 if (patterns[i].type != DEV_MATCH_PERIPH) 1620 continue; 1621 1622 cur_pattern = &patterns[i].pattern.periph_pattern; 1623 1624 /* 1625 * If they want to match on anything, then we will do so. 1626 */ 1627 if (cur_pattern->flags == PERIPH_MATCH_ANY) { 1628 /* set the copy flag */ 1629 retval |= DM_RET_COPY; 1630 1631 /* 1632 * We've already set the return action to stop, 1633 * since there are no nodes below peripherals in 1634 * the tree. 1635 */ 1636 return(retval); 1637 } 1638 1639 /* 1640 * Not sure why someone would do this... 1641 */ 1642 if (cur_pattern->flags == PERIPH_MATCH_NONE) 1643 continue; 1644 1645 if (((cur_pattern->flags & PERIPH_MATCH_PATH) != 0) 1646 && (cur_pattern->path_id != periph->path->bus->path_id)) 1647 continue; 1648 1649 /* 1650 * For the target and lun id's, we have to make sure the 1651 * target and lun pointers aren't NULL. The xpt peripheral 1652 * has a wildcard target and device. 1653 */ 1654 if (((cur_pattern->flags & PERIPH_MATCH_TARGET) != 0) 1655 && ((periph->path->target == NULL) 1656 ||(cur_pattern->target_id != periph->path->target->target_id))) 1657 continue; 1658 1659 if (((cur_pattern->flags & PERIPH_MATCH_LUN) != 0) 1660 && ((periph->path->device == NULL) 1661 || (cur_pattern->target_lun != periph->path->device->lun_id))) 1662 continue; 1663 1664 if (((cur_pattern->flags & PERIPH_MATCH_UNIT) != 0) 1665 && (cur_pattern->unit_number != periph->unit_number)) 1666 continue; 1667 1668 if (((cur_pattern->flags & PERIPH_MATCH_NAME) != 0) 1669 && (strncmp(cur_pattern->periph_name, periph->periph_name, 1670 DEV_IDLEN) != 0)) 1671 continue; 1672 1673 /* 1674 * If we get to this point, the user definitely wants 1675 * information on this peripheral. So tell the caller to 1676 * copy the data out. 1677 */ 1678 retval |= DM_RET_COPY; 1679 1680 /* 1681 * The return action has already been set to stop, since 1682 * peripherals don't have any nodes below them in the EDT. 1683 */ 1684 return(retval); 1685 } 1686 1687 /* 1688 * If we get to this point, the peripheral that was passed in 1689 * doesn't match any of the patterns. 1690 */ 1691 return(retval); 1692 } 1693 1694 static int 1695 xptedtbusfunc(struct cam_eb *bus, void *arg) 1696 { 1697 struct ccb_dev_match *cdm; 1698 struct cam_et *target; 1699 dev_match_ret retval; 1700 1701 cdm = (struct ccb_dev_match *)arg; 1702 1703 /* 1704 * If our position is for something deeper in the tree, that means 1705 * that we've already seen this node. So, we keep going down. 1706 */ 1707 if ((cdm->pos.position_type & CAM_DEV_POS_BUS) 1708 && (cdm->pos.cookie.bus == bus) 1709 && (cdm->pos.position_type & CAM_DEV_POS_TARGET) 1710 && (cdm->pos.cookie.target != NULL)) 1711 retval = DM_RET_DESCEND; 1712 else 1713 retval = xptbusmatch(cdm->patterns, cdm->num_patterns, bus); 1714 1715 /* 1716 * If we got an error, bail out of the search. 1717 */ 1718 if ((retval & DM_RET_ACTION_MASK) == DM_RET_ERROR) { 1719 cdm->status = CAM_DEV_MATCH_ERROR; 1720 return(0); 1721 } 1722 1723 /* 1724 * If the copy flag is set, copy this bus out. 1725 */ 1726 if (retval & DM_RET_COPY) { 1727 int spaceleft, j; 1728 1729 spaceleft = cdm->match_buf_len - (cdm->num_matches * 1730 sizeof(struct dev_match_result)); 1731 1732 /* 1733 * If we don't have enough space to put in another 1734 * match result, save our position and tell the 1735 * user there are more devices to check. 1736 */ 1737 if (spaceleft < sizeof(struct dev_match_result)) { 1738 bzero(&cdm->pos, sizeof(cdm->pos)); 1739 cdm->pos.position_type = 1740 CAM_DEV_POS_EDT | CAM_DEV_POS_BUS; 1741 1742 cdm->pos.cookie.bus = bus; 1743 cdm->pos.generations[CAM_BUS_GENERATION]= 1744 xsoftc.bus_generation; 1745 cdm->status = CAM_DEV_MATCH_MORE; 1746 return(0); 1747 } 1748 j = cdm->num_matches; 1749 cdm->num_matches++; 1750 cdm->matches[j].type = DEV_MATCH_BUS; 1751 cdm->matches[j].result.bus_result.path_id = bus->path_id; 1752 cdm->matches[j].result.bus_result.bus_id = bus->sim->bus_id; 1753 cdm->matches[j].result.bus_result.unit_number = 1754 bus->sim->unit_number; 1755 strlcpy(cdm->matches[j].result.bus_result.dev_name, 1756 bus->sim->sim_name, 1757 sizeof(cdm->matches[j].result.bus_result.dev_name)); 1758 } 1759 1760 /* 1761 * If the user is only interested in buses, there's no 1762 * reason to descend to the next level in the tree. 1763 */ 1764 if ((retval & DM_RET_ACTION_MASK) == DM_RET_STOP) 1765 return(1); 1766 1767 /* 1768 * If there is a target generation recorded, check it to 1769 * make sure the target list hasn't changed. 1770 */ 1771 mtx_lock(&bus->eb_mtx); 1772 if ((cdm->pos.position_type & CAM_DEV_POS_BUS) 1773 && (cdm->pos.cookie.bus == bus) 1774 && (cdm->pos.position_type & CAM_DEV_POS_TARGET) 1775 && (cdm->pos.cookie.target != NULL)) { 1776 if ((cdm->pos.generations[CAM_TARGET_GENERATION] != 1777 bus->generation)) { 1778 mtx_unlock(&bus->eb_mtx); 1779 cdm->status = CAM_DEV_MATCH_LIST_CHANGED; 1780 return (0); 1781 } 1782 target = (struct cam_et *)cdm->pos.cookie.target; 1783 target->refcount++; 1784 } else 1785 target = NULL; 1786 mtx_unlock(&bus->eb_mtx); 1787 1788 return (xpttargettraverse(bus, target, xptedttargetfunc, arg)); 1789 } 1790 1791 static int 1792 xptedttargetfunc(struct cam_et *target, void *arg) 1793 { 1794 struct ccb_dev_match *cdm; 1795 struct cam_eb *bus; 1796 struct cam_ed *device; 1797 1798 cdm = (struct ccb_dev_match *)arg; 1799 bus = target->bus; 1800 1801 /* 1802 * If there is a device list generation recorded, check it to 1803 * make sure the device list hasn't changed. 1804 */ 1805 mtx_lock(&bus->eb_mtx); 1806 if ((cdm->pos.position_type & CAM_DEV_POS_BUS) 1807 && (cdm->pos.cookie.bus == bus) 1808 && (cdm->pos.position_type & CAM_DEV_POS_TARGET) 1809 && (cdm->pos.cookie.target == target) 1810 && (cdm->pos.position_type & CAM_DEV_POS_DEVICE) 1811 && (cdm->pos.cookie.device != NULL)) { 1812 if (cdm->pos.generations[CAM_DEV_GENERATION] != 1813 target->generation) { 1814 mtx_unlock(&bus->eb_mtx); 1815 cdm->status = CAM_DEV_MATCH_LIST_CHANGED; 1816 return(0); 1817 } 1818 device = (struct cam_ed *)cdm->pos.cookie.device; 1819 device->refcount++; 1820 } else 1821 device = NULL; 1822 mtx_unlock(&bus->eb_mtx); 1823 1824 return (xptdevicetraverse(target, device, xptedtdevicefunc, arg)); 1825 } 1826 1827 static int 1828 xptedtdevicefunc(struct cam_ed *device, void *arg) 1829 { 1830 struct cam_eb *bus; 1831 struct cam_periph *periph; 1832 struct ccb_dev_match *cdm; 1833 dev_match_ret retval; 1834 1835 cdm = (struct ccb_dev_match *)arg; 1836 bus = device->target->bus; 1837 1838 /* 1839 * If our position is for something deeper in the tree, that means 1840 * that we've already seen this node. So, we keep going down. 1841 */ 1842 if ((cdm->pos.position_type & CAM_DEV_POS_DEVICE) 1843 && (cdm->pos.cookie.device == device) 1844 && (cdm->pos.position_type & CAM_DEV_POS_PERIPH) 1845 && (cdm->pos.cookie.periph != NULL)) 1846 retval = DM_RET_DESCEND; 1847 else 1848 retval = xptdevicematch(cdm->patterns, cdm->num_patterns, 1849 device); 1850 1851 if ((retval & DM_RET_ACTION_MASK) == DM_RET_ERROR) { 1852 cdm->status = CAM_DEV_MATCH_ERROR; 1853 return(0); 1854 } 1855 1856 /* 1857 * If the copy flag is set, copy this device out. 1858 */ 1859 if (retval & DM_RET_COPY) { 1860 int spaceleft, j; 1861 1862 spaceleft = cdm->match_buf_len - (cdm->num_matches * 1863 sizeof(struct dev_match_result)); 1864 1865 /* 1866 * If we don't have enough space to put in another 1867 * match result, save our position and tell the 1868 * user there are more devices to check. 1869 */ 1870 if (spaceleft < sizeof(struct dev_match_result)) { 1871 bzero(&cdm->pos, sizeof(cdm->pos)); 1872 cdm->pos.position_type = 1873 CAM_DEV_POS_EDT | CAM_DEV_POS_BUS | 1874 CAM_DEV_POS_TARGET | CAM_DEV_POS_DEVICE; 1875 1876 cdm->pos.cookie.bus = device->target->bus; 1877 cdm->pos.generations[CAM_BUS_GENERATION]= 1878 xsoftc.bus_generation; 1879 cdm->pos.cookie.target = device->target; 1880 cdm->pos.generations[CAM_TARGET_GENERATION] = 1881 device->target->bus->generation; 1882 cdm->pos.cookie.device = device; 1883 cdm->pos.generations[CAM_DEV_GENERATION] = 1884 device->target->generation; 1885 cdm->status = CAM_DEV_MATCH_MORE; 1886 return(0); 1887 } 1888 j = cdm->num_matches; 1889 cdm->num_matches++; 1890 cdm->matches[j].type = DEV_MATCH_DEVICE; 1891 cdm->matches[j].result.device_result.path_id = 1892 device->target->bus->path_id; 1893 cdm->matches[j].result.device_result.target_id = 1894 device->target->target_id; 1895 cdm->matches[j].result.device_result.target_lun = 1896 device->lun_id; 1897 cdm->matches[j].result.device_result.protocol = 1898 device->protocol; 1899 bcopy(&device->inq_data, 1900 &cdm->matches[j].result.device_result.inq_data, 1901 sizeof(struct scsi_inquiry_data)); 1902 bcopy(&device->ident_data, 1903 &cdm->matches[j].result.device_result.ident_data, 1904 sizeof(struct ata_params)); 1905 1906 /* Let the user know whether this device is unconfigured */ 1907 if (device->flags & CAM_DEV_UNCONFIGURED) 1908 cdm->matches[j].result.device_result.flags = 1909 DEV_RESULT_UNCONFIGURED; 1910 else 1911 cdm->matches[j].result.device_result.flags = 1912 DEV_RESULT_NOFLAG; 1913 } 1914 1915 /* 1916 * If the user isn't interested in peripherals, don't descend 1917 * the tree any further. 1918 */ 1919 if ((retval & DM_RET_ACTION_MASK) == DM_RET_STOP) 1920 return(1); 1921 1922 /* 1923 * If there is a peripheral list generation recorded, make sure 1924 * it hasn't changed. 1925 */ 1926 xpt_lock_buses(); 1927 mtx_lock(&bus->eb_mtx); 1928 if ((cdm->pos.position_type & CAM_DEV_POS_BUS) 1929 && (cdm->pos.cookie.bus == bus) 1930 && (cdm->pos.position_type & CAM_DEV_POS_TARGET) 1931 && (cdm->pos.cookie.target == device->target) 1932 && (cdm->pos.position_type & CAM_DEV_POS_DEVICE) 1933 && (cdm->pos.cookie.device == device) 1934 && (cdm->pos.position_type & CAM_DEV_POS_PERIPH) 1935 && (cdm->pos.cookie.periph != NULL)) { 1936 if (cdm->pos.generations[CAM_PERIPH_GENERATION] != 1937 device->generation) { 1938 mtx_unlock(&bus->eb_mtx); 1939 xpt_unlock_buses(); 1940 cdm->status = CAM_DEV_MATCH_LIST_CHANGED; 1941 return(0); 1942 } 1943 periph = (struct cam_periph *)cdm->pos.cookie.periph; 1944 periph->refcount++; 1945 } else 1946 periph = NULL; 1947 mtx_unlock(&bus->eb_mtx); 1948 xpt_unlock_buses(); 1949 1950 return (xptperiphtraverse(device, periph, xptedtperiphfunc, arg)); 1951 } 1952 1953 static int 1954 xptedtperiphfunc(struct cam_periph *periph, void *arg) 1955 { 1956 struct ccb_dev_match *cdm; 1957 dev_match_ret retval; 1958 1959 cdm = (struct ccb_dev_match *)arg; 1960 1961 retval = xptperiphmatch(cdm->patterns, cdm->num_patterns, periph); 1962 1963 if ((retval & DM_RET_ACTION_MASK) == DM_RET_ERROR) { 1964 cdm->status = CAM_DEV_MATCH_ERROR; 1965 return(0); 1966 } 1967 1968 /* 1969 * If the copy flag is set, copy this peripheral out. 1970 */ 1971 if (retval & DM_RET_COPY) { 1972 int spaceleft, j; 1973 size_t l; 1974 1975 spaceleft = cdm->match_buf_len - (cdm->num_matches * 1976 sizeof(struct dev_match_result)); 1977 1978 /* 1979 * If we don't have enough space to put in another 1980 * match result, save our position and tell the 1981 * user there are more devices to check. 1982 */ 1983 if (spaceleft < sizeof(struct dev_match_result)) { 1984 bzero(&cdm->pos, sizeof(cdm->pos)); 1985 cdm->pos.position_type = 1986 CAM_DEV_POS_EDT | CAM_DEV_POS_BUS | 1987 CAM_DEV_POS_TARGET | CAM_DEV_POS_DEVICE | 1988 CAM_DEV_POS_PERIPH; 1989 1990 cdm->pos.cookie.bus = periph->path->bus; 1991 cdm->pos.generations[CAM_BUS_GENERATION]= 1992 xsoftc.bus_generation; 1993 cdm->pos.cookie.target = periph->path->target; 1994 cdm->pos.generations[CAM_TARGET_GENERATION] = 1995 periph->path->bus->generation; 1996 cdm->pos.cookie.device = periph->path->device; 1997 cdm->pos.generations[CAM_DEV_GENERATION] = 1998 periph->path->target->generation; 1999 cdm->pos.cookie.periph = periph; 2000 cdm->pos.generations[CAM_PERIPH_GENERATION] = 2001 periph->path->device->generation; 2002 cdm->status = CAM_DEV_MATCH_MORE; 2003 return(0); 2004 } 2005 2006 j = cdm->num_matches; 2007 cdm->num_matches++; 2008 cdm->matches[j].type = DEV_MATCH_PERIPH; 2009 cdm->matches[j].result.periph_result.path_id = 2010 periph->path->bus->path_id; 2011 cdm->matches[j].result.periph_result.target_id = 2012 periph->path->target->target_id; 2013 cdm->matches[j].result.periph_result.target_lun = 2014 periph->path->device->lun_id; 2015 cdm->matches[j].result.periph_result.unit_number = 2016 periph->unit_number; 2017 l = sizeof(cdm->matches[j].result.periph_result.periph_name); 2018 strlcpy(cdm->matches[j].result.periph_result.periph_name, 2019 periph->periph_name, l); 2020 } 2021 2022 return(1); 2023 } 2024 2025 static int 2026 xptedtmatch(struct ccb_dev_match *cdm) 2027 { 2028 struct cam_eb *bus; 2029 int ret; 2030 2031 cdm->num_matches = 0; 2032 2033 /* 2034 * Check the bus list generation. If it has changed, the user 2035 * needs to reset everything and start over. 2036 */ 2037 xpt_lock_buses(); 2038 if ((cdm->pos.position_type & CAM_DEV_POS_BUS) 2039 && (cdm->pos.cookie.bus != NULL)) { 2040 if (cdm->pos.generations[CAM_BUS_GENERATION] != 2041 xsoftc.bus_generation) { 2042 xpt_unlock_buses(); 2043 cdm->status = CAM_DEV_MATCH_LIST_CHANGED; 2044 return(0); 2045 } 2046 bus = (struct cam_eb *)cdm->pos.cookie.bus; 2047 bus->refcount++; 2048 } else 2049 bus = NULL; 2050 xpt_unlock_buses(); 2051 2052 ret = xptbustraverse(bus, xptedtbusfunc, cdm); 2053 2054 /* 2055 * If we get back 0, that means that we had to stop before fully 2056 * traversing the EDT. It also means that one of the subroutines 2057 * has set the status field to the proper value. If we get back 1, 2058 * we've fully traversed the EDT and copied out any matching entries. 2059 */ 2060 if (ret == 1) 2061 cdm->status = CAM_DEV_MATCH_LAST; 2062 2063 return(ret); 2064 } 2065 2066 static int 2067 xptplistpdrvfunc(struct periph_driver **pdrv, void *arg) 2068 { 2069 struct cam_periph *periph; 2070 struct ccb_dev_match *cdm; 2071 2072 cdm = (struct ccb_dev_match *)arg; 2073 2074 xpt_lock_buses(); 2075 if ((cdm->pos.position_type & CAM_DEV_POS_PDPTR) 2076 && (cdm->pos.cookie.pdrv == pdrv) 2077 && (cdm->pos.position_type & CAM_DEV_POS_PERIPH) 2078 && (cdm->pos.cookie.periph != NULL)) { 2079 if (cdm->pos.generations[CAM_PERIPH_GENERATION] != 2080 (*pdrv)->generation) { 2081 xpt_unlock_buses(); 2082 cdm->status = CAM_DEV_MATCH_LIST_CHANGED; 2083 return(0); 2084 } 2085 periph = (struct cam_periph *)cdm->pos.cookie.periph; 2086 periph->refcount++; 2087 } else 2088 periph = NULL; 2089 xpt_unlock_buses(); 2090 2091 return (xptpdperiphtraverse(pdrv, periph, xptplistperiphfunc, arg)); 2092 } 2093 2094 static int 2095 xptplistperiphfunc(struct cam_periph *periph, void *arg) 2096 { 2097 struct ccb_dev_match *cdm; 2098 dev_match_ret retval; 2099 2100 cdm = (struct ccb_dev_match *)arg; 2101 2102 retval = xptperiphmatch(cdm->patterns, cdm->num_patterns, periph); 2103 2104 if ((retval & DM_RET_ACTION_MASK) == DM_RET_ERROR) { 2105 cdm->status = CAM_DEV_MATCH_ERROR; 2106 return(0); 2107 } 2108 2109 /* 2110 * If the copy flag is set, copy this peripheral out. 2111 */ 2112 if (retval & DM_RET_COPY) { 2113 int spaceleft, j; 2114 size_t l; 2115 2116 spaceleft = cdm->match_buf_len - (cdm->num_matches * 2117 sizeof(struct dev_match_result)); 2118 2119 /* 2120 * If we don't have enough space to put in another 2121 * match result, save our position and tell the 2122 * user there are more devices to check. 2123 */ 2124 if (spaceleft < sizeof(struct dev_match_result)) { 2125 struct periph_driver **pdrv; 2126 2127 pdrv = NULL; 2128 bzero(&cdm->pos, sizeof(cdm->pos)); 2129 cdm->pos.position_type = 2130 CAM_DEV_POS_PDRV | CAM_DEV_POS_PDPTR | 2131 CAM_DEV_POS_PERIPH; 2132 2133 /* 2134 * This may look a bit non-sensical, but it is 2135 * actually quite logical. There are very few 2136 * peripheral drivers, and bloating every peripheral 2137 * structure with a pointer back to its parent 2138 * peripheral driver linker set entry would cost 2139 * more in the long run than doing this quick lookup. 2140 */ 2141 for (pdrv = periph_drivers; *pdrv != NULL; pdrv++) { 2142 if (strcmp((*pdrv)->driver_name, 2143 periph->periph_name) == 0) 2144 break; 2145 } 2146 2147 if (*pdrv == NULL) { 2148 cdm->status = CAM_DEV_MATCH_ERROR; 2149 return(0); 2150 } 2151 2152 cdm->pos.cookie.pdrv = pdrv; 2153 /* 2154 * The periph generation slot does double duty, as 2155 * does the periph pointer slot. They are used for 2156 * both edt and pdrv lookups and positioning. 2157 */ 2158 cdm->pos.cookie.periph = periph; 2159 cdm->pos.generations[CAM_PERIPH_GENERATION] = 2160 (*pdrv)->generation; 2161 cdm->status = CAM_DEV_MATCH_MORE; 2162 return(0); 2163 } 2164 2165 j = cdm->num_matches; 2166 cdm->num_matches++; 2167 cdm->matches[j].type = DEV_MATCH_PERIPH; 2168 cdm->matches[j].result.periph_result.path_id = 2169 periph->path->bus->path_id; 2170 2171 /* 2172 * The transport layer peripheral doesn't have a target or 2173 * lun. 2174 */ 2175 if (periph->path->target) 2176 cdm->matches[j].result.periph_result.target_id = 2177 periph->path->target->target_id; 2178 else 2179 cdm->matches[j].result.periph_result.target_id = 2180 CAM_TARGET_WILDCARD; 2181 2182 if (periph->path->device) 2183 cdm->matches[j].result.periph_result.target_lun = 2184 periph->path->device->lun_id; 2185 else 2186 cdm->matches[j].result.periph_result.target_lun = 2187 CAM_LUN_WILDCARD; 2188 2189 cdm->matches[j].result.periph_result.unit_number = 2190 periph->unit_number; 2191 l = sizeof(cdm->matches[j].result.periph_result.periph_name); 2192 strlcpy(cdm->matches[j].result.periph_result.periph_name, 2193 periph->periph_name, l); 2194 } 2195 2196 return(1); 2197 } 2198 2199 static int 2200 xptperiphlistmatch(struct ccb_dev_match *cdm) 2201 { 2202 int ret; 2203 2204 cdm->num_matches = 0; 2205 2206 /* 2207 * At this point in the edt traversal function, we check the bus 2208 * list generation to make sure that no buses have been added or 2209 * removed since the user last sent a XPT_DEV_MATCH ccb through. 2210 * For the peripheral driver list traversal function, however, we 2211 * don't have to worry about new peripheral driver types coming or 2212 * going; they're in a linker set, and therefore can't change 2213 * without a recompile. 2214 */ 2215 2216 if ((cdm->pos.position_type & CAM_DEV_POS_PDPTR) 2217 && (cdm->pos.cookie.pdrv != NULL)) 2218 ret = xptpdrvtraverse( 2219 (struct periph_driver **)cdm->pos.cookie.pdrv, 2220 xptplistpdrvfunc, cdm); 2221 else 2222 ret = xptpdrvtraverse(NULL, xptplistpdrvfunc, cdm); 2223 2224 /* 2225 * If we get back 0, that means that we had to stop before fully 2226 * traversing the peripheral driver tree. It also means that one of 2227 * the subroutines has set the status field to the proper value. If 2228 * we get back 1, we've fully traversed the EDT and copied out any 2229 * matching entries. 2230 */ 2231 if (ret == 1) 2232 cdm->status = CAM_DEV_MATCH_LAST; 2233 2234 return(ret); 2235 } 2236 2237 static int 2238 xptbustraverse(struct cam_eb *start_bus, xpt_busfunc_t *tr_func, void *arg) 2239 { 2240 struct cam_eb *bus, *next_bus; 2241 int retval; 2242 2243 retval = 1; 2244 if (start_bus) 2245 bus = start_bus; 2246 else { 2247 xpt_lock_buses(); 2248 bus = TAILQ_FIRST(&xsoftc.xpt_busses); 2249 if (bus == NULL) { 2250 xpt_unlock_buses(); 2251 return (retval); 2252 } 2253 bus->refcount++; 2254 xpt_unlock_buses(); 2255 } 2256 for (; bus != NULL; bus = next_bus) { 2257 retval = tr_func(bus, arg); 2258 if (retval == 0) { 2259 xpt_release_bus(bus); 2260 break; 2261 } 2262 xpt_lock_buses(); 2263 next_bus = TAILQ_NEXT(bus, links); 2264 if (next_bus) 2265 next_bus->refcount++; 2266 xpt_unlock_buses(); 2267 xpt_release_bus(bus); 2268 } 2269 return(retval); 2270 } 2271 2272 static int 2273 xpttargettraverse(struct cam_eb *bus, struct cam_et *start_target, 2274 xpt_targetfunc_t *tr_func, void *arg) 2275 { 2276 struct cam_et *target, *next_target; 2277 int retval; 2278 2279 retval = 1; 2280 if (start_target) 2281 target = start_target; 2282 else { 2283 mtx_lock(&bus->eb_mtx); 2284 target = TAILQ_FIRST(&bus->et_entries); 2285 if (target == NULL) { 2286 mtx_unlock(&bus->eb_mtx); 2287 return (retval); 2288 } 2289 target->refcount++; 2290 mtx_unlock(&bus->eb_mtx); 2291 } 2292 for (; target != NULL; target = next_target) { 2293 retval = tr_func(target, arg); 2294 if (retval == 0) { 2295 xpt_release_target(target); 2296 break; 2297 } 2298 mtx_lock(&bus->eb_mtx); 2299 next_target = TAILQ_NEXT(target, links); 2300 if (next_target) 2301 next_target->refcount++; 2302 mtx_unlock(&bus->eb_mtx); 2303 xpt_release_target(target); 2304 } 2305 return(retval); 2306 } 2307 2308 static int 2309 xptdevicetraverse(struct cam_et *target, struct cam_ed *start_device, 2310 xpt_devicefunc_t *tr_func, void *arg) 2311 { 2312 struct cam_eb *bus; 2313 struct cam_ed *device, *next_device; 2314 int retval; 2315 2316 retval = 1; 2317 bus = target->bus; 2318 if (start_device) 2319 device = start_device; 2320 else { 2321 mtx_lock(&bus->eb_mtx); 2322 device = TAILQ_FIRST(&target->ed_entries); 2323 if (device == NULL) { 2324 mtx_unlock(&bus->eb_mtx); 2325 return (retval); 2326 } 2327 device->refcount++; 2328 mtx_unlock(&bus->eb_mtx); 2329 } 2330 for (; device != NULL; device = next_device) { 2331 mtx_lock(&device->device_mtx); 2332 retval = tr_func(device, arg); 2333 mtx_unlock(&device->device_mtx); 2334 if (retval == 0) { 2335 xpt_release_device(device); 2336 break; 2337 } 2338 mtx_lock(&bus->eb_mtx); 2339 next_device = TAILQ_NEXT(device, links); 2340 if (next_device) 2341 next_device->refcount++; 2342 mtx_unlock(&bus->eb_mtx); 2343 xpt_release_device(device); 2344 } 2345 return(retval); 2346 } 2347 2348 static int 2349 xptperiphtraverse(struct cam_ed *device, struct cam_periph *start_periph, 2350 xpt_periphfunc_t *tr_func, void *arg) 2351 { 2352 struct cam_eb *bus; 2353 struct cam_periph *periph, *next_periph; 2354 int retval; 2355 2356 retval = 1; 2357 2358 bus = device->target->bus; 2359 if (start_periph) 2360 periph = start_periph; 2361 else { 2362 xpt_lock_buses(); 2363 mtx_lock(&bus->eb_mtx); 2364 periph = SLIST_FIRST(&device->periphs); 2365 while (periph != NULL && (periph->flags & CAM_PERIPH_FREE) != 0) 2366 periph = SLIST_NEXT(periph, periph_links); 2367 if (periph == NULL) { 2368 mtx_unlock(&bus->eb_mtx); 2369 xpt_unlock_buses(); 2370 return (retval); 2371 } 2372 periph->refcount++; 2373 mtx_unlock(&bus->eb_mtx); 2374 xpt_unlock_buses(); 2375 } 2376 for (; periph != NULL; periph = next_periph) { 2377 retval = tr_func(periph, arg); 2378 if (retval == 0) { 2379 cam_periph_release_locked(periph); 2380 break; 2381 } 2382 xpt_lock_buses(); 2383 mtx_lock(&bus->eb_mtx); 2384 next_periph = SLIST_NEXT(periph, periph_links); 2385 while (next_periph != NULL && 2386 (next_periph->flags & CAM_PERIPH_FREE) != 0) 2387 next_periph = SLIST_NEXT(next_periph, periph_links); 2388 if (next_periph) 2389 next_periph->refcount++; 2390 mtx_unlock(&bus->eb_mtx); 2391 xpt_unlock_buses(); 2392 cam_periph_release_locked(periph); 2393 } 2394 return(retval); 2395 } 2396 2397 static int 2398 xptpdrvtraverse(struct periph_driver **start_pdrv, 2399 xpt_pdrvfunc_t *tr_func, void *arg) 2400 { 2401 struct periph_driver **pdrv; 2402 int retval; 2403 2404 retval = 1; 2405 2406 /* 2407 * We don't traverse the peripheral driver list like we do the 2408 * other lists, because it is a linker set, and therefore cannot be 2409 * changed during runtime. If the peripheral driver list is ever 2410 * re-done to be something other than a linker set (i.e. it can 2411 * change while the system is running), the list traversal should 2412 * be modified to work like the other traversal functions. 2413 */ 2414 for (pdrv = (start_pdrv ? start_pdrv : periph_drivers); 2415 *pdrv != NULL; pdrv++) { 2416 retval = tr_func(pdrv, arg); 2417 2418 if (retval == 0) 2419 return(retval); 2420 } 2421 2422 return(retval); 2423 } 2424 2425 static int 2426 xptpdperiphtraverse(struct periph_driver **pdrv, 2427 struct cam_periph *start_periph, 2428 xpt_periphfunc_t *tr_func, void *arg) 2429 { 2430 struct cam_periph *periph, *next_periph; 2431 int retval; 2432 2433 retval = 1; 2434 2435 if (start_periph) 2436 periph = start_periph; 2437 else { 2438 xpt_lock_buses(); 2439 periph = TAILQ_FIRST(&(*pdrv)->units); 2440 while (periph != NULL && (periph->flags & CAM_PERIPH_FREE) != 0) 2441 periph = TAILQ_NEXT(periph, unit_links); 2442 if (periph == NULL) { 2443 xpt_unlock_buses(); 2444 return (retval); 2445 } 2446 periph->refcount++; 2447 xpt_unlock_buses(); 2448 } 2449 for (; periph != NULL; periph = next_periph) { 2450 cam_periph_lock(periph); 2451 retval = tr_func(periph, arg); 2452 cam_periph_unlock(periph); 2453 if (retval == 0) { 2454 cam_periph_release(periph); 2455 break; 2456 } 2457 xpt_lock_buses(); 2458 next_periph = TAILQ_NEXT(periph, unit_links); 2459 while (next_periph != NULL && 2460 (next_periph->flags & CAM_PERIPH_FREE) != 0) 2461 next_periph = TAILQ_NEXT(next_periph, unit_links); 2462 if (next_periph) 2463 next_periph->refcount++; 2464 xpt_unlock_buses(); 2465 cam_periph_release(periph); 2466 } 2467 return(retval); 2468 } 2469 2470 static int 2471 xptdefbusfunc(struct cam_eb *bus, void *arg) 2472 { 2473 struct xpt_traverse_config *tr_config; 2474 2475 tr_config = (struct xpt_traverse_config *)arg; 2476 2477 if (tr_config->depth == XPT_DEPTH_BUS) { 2478 xpt_busfunc_t *tr_func; 2479 2480 tr_func = (xpt_busfunc_t *)tr_config->tr_func; 2481 2482 return(tr_func(bus, tr_config->tr_arg)); 2483 } else 2484 return(xpttargettraverse(bus, NULL, xptdeftargetfunc, arg)); 2485 } 2486 2487 static int 2488 xptdeftargetfunc(struct cam_et *target, void *arg) 2489 { 2490 struct xpt_traverse_config *tr_config; 2491 2492 tr_config = (struct xpt_traverse_config *)arg; 2493 2494 if (tr_config->depth == XPT_DEPTH_TARGET) { 2495 xpt_targetfunc_t *tr_func; 2496 2497 tr_func = (xpt_targetfunc_t *)tr_config->tr_func; 2498 2499 return(tr_func(target, tr_config->tr_arg)); 2500 } else 2501 return(xptdevicetraverse(target, NULL, xptdefdevicefunc, arg)); 2502 } 2503 2504 static int 2505 xptdefdevicefunc(struct cam_ed *device, void *arg) 2506 { 2507 struct xpt_traverse_config *tr_config; 2508 2509 tr_config = (struct xpt_traverse_config *)arg; 2510 2511 if (tr_config->depth == XPT_DEPTH_DEVICE) { 2512 xpt_devicefunc_t *tr_func; 2513 2514 tr_func = (xpt_devicefunc_t *)tr_config->tr_func; 2515 2516 return(tr_func(device, tr_config->tr_arg)); 2517 } else 2518 return(xptperiphtraverse(device, NULL, xptdefperiphfunc, arg)); 2519 } 2520 2521 static int 2522 xptdefperiphfunc(struct cam_periph *periph, void *arg) 2523 { 2524 struct xpt_traverse_config *tr_config; 2525 xpt_periphfunc_t *tr_func; 2526 2527 tr_config = (struct xpt_traverse_config *)arg; 2528 2529 tr_func = (xpt_periphfunc_t *)tr_config->tr_func; 2530 2531 /* 2532 * Unlike the other default functions, we don't check for depth 2533 * here. The peripheral driver level is the last level in the EDT, 2534 * so if we're here, we should execute the function in question. 2535 */ 2536 return(tr_func(periph, tr_config->tr_arg)); 2537 } 2538 2539 /* 2540 * Execute the given function for every bus in the EDT. 2541 */ 2542 static int 2543 xpt_for_all_busses(xpt_busfunc_t *tr_func, void *arg) 2544 { 2545 struct xpt_traverse_config tr_config; 2546 2547 tr_config.depth = XPT_DEPTH_BUS; 2548 tr_config.tr_func = tr_func; 2549 tr_config.tr_arg = arg; 2550 2551 return(xptbustraverse(NULL, xptdefbusfunc, &tr_config)); 2552 } 2553 2554 /* 2555 * Execute the given function for every device in the EDT. 2556 */ 2557 static int 2558 xpt_for_all_devices(xpt_devicefunc_t *tr_func, void *arg) 2559 { 2560 struct xpt_traverse_config tr_config; 2561 2562 tr_config.depth = XPT_DEPTH_DEVICE; 2563 tr_config.tr_func = tr_func; 2564 tr_config.tr_arg = arg; 2565 2566 return(xptbustraverse(NULL, xptdefbusfunc, &tr_config)); 2567 } 2568 2569 static int 2570 xptsetasyncfunc(struct cam_ed *device, void *arg) 2571 { 2572 struct cam_path path; 2573 struct ccb_getdev cgd; 2574 struct ccb_setasync *csa = (struct ccb_setasync *)arg; 2575 2576 /* 2577 * Don't report unconfigured devices (Wildcard devs, 2578 * devices only for target mode, device instances 2579 * that have been invalidated but are waiting for 2580 * their last reference count to be released). 2581 */ 2582 if ((device->flags & CAM_DEV_UNCONFIGURED) != 0) 2583 return (1); 2584 2585 xpt_compile_path(&path, 2586 NULL, 2587 device->target->bus->path_id, 2588 device->target->target_id, 2589 device->lun_id); 2590 xpt_setup_ccb(&cgd.ccb_h, &path, CAM_PRIORITY_NORMAL); 2591 cgd.ccb_h.func_code = XPT_GDEV_TYPE; 2592 xpt_action((union ccb *)&cgd); 2593 csa->callback(csa->callback_arg, 2594 AC_FOUND_DEVICE, 2595 &path, &cgd); 2596 xpt_release_path(&path); 2597 2598 return(1); 2599 } 2600 2601 static int 2602 xptsetasyncbusfunc(struct cam_eb *bus, void *arg) 2603 { 2604 struct cam_path path; 2605 struct ccb_pathinq cpi; 2606 struct ccb_setasync *csa = (struct ccb_setasync *)arg; 2607 2608 xpt_compile_path(&path, /*periph*/NULL, 2609 bus->path_id, 2610 CAM_TARGET_WILDCARD, 2611 CAM_LUN_WILDCARD); 2612 xpt_path_lock(&path); 2613 xpt_path_inq(&cpi, &path); 2614 csa->callback(csa->callback_arg, 2615 AC_PATH_REGISTERED, 2616 &path, &cpi); 2617 xpt_path_unlock(&path); 2618 xpt_release_path(&path); 2619 2620 return(1); 2621 } 2622 2623 void 2624 xpt_action(union ccb *start_ccb) 2625 { 2626 2627 CAM_DEBUG(start_ccb->ccb_h.path, CAM_DEBUG_TRACE, 2628 ("xpt_action: func %#x %s\n", start_ccb->ccb_h.func_code, 2629 xpt_action_name(start_ccb->ccb_h.func_code))); 2630 2631 start_ccb->ccb_h.status = CAM_REQ_INPROG; 2632 (*(start_ccb->ccb_h.path->bus->xport->ops->action))(start_ccb); 2633 } 2634 2635 void 2636 xpt_action_default(union ccb *start_ccb) 2637 { 2638 struct cam_path *path; 2639 struct cam_sim *sim; 2640 struct mtx *mtx; 2641 2642 path = start_ccb->ccb_h.path; 2643 CAM_DEBUG(path, CAM_DEBUG_TRACE, 2644 ("xpt_action_default: func %#x %s\n", start_ccb->ccb_h.func_code, 2645 xpt_action_name(start_ccb->ccb_h.func_code))); 2646 2647 switch (start_ccb->ccb_h.func_code) { 2648 case XPT_SCSI_IO: 2649 { 2650 struct cam_ed *device; 2651 2652 /* 2653 * For the sake of compatibility with SCSI-1 2654 * devices that may not understand the identify 2655 * message, we include lun information in the 2656 * second byte of all commands. SCSI-1 specifies 2657 * that luns are a 3 bit value and reserves only 3 2658 * bits for lun information in the CDB. Later 2659 * revisions of the SCSI spec allow for more than 8 2660 * luns, but have deprecated lun information in the 2661 * CDB. So, if the lun won't fit, we must omit. 2662 * 2663 * Also be aware that during initial probing for devices, 2664 * the inquiry information is unknown but initialized to 0. 2665 * This means that this code will be exercised while probing 2666 * devices with an ANSI revision greater than 2. 2667 */ 2668 device = path->device; 2669 if (device->protocol_version <= SCSI_REV_2 2670 && start_ccb->ccb_h.target_lun < 8 2671 && (start_ccb->ccb_h.flags & CAM_CDB_POINTER) == 0) { 2672 2673 start_ccb->csio.cdb_io.cdb_bytes[1] |= 2674 start_ccb->ccb_h.target_lun << 5; 2675 } 2676 start_ccb->csio.scsi_status = SCSI_STATUS_OK; 2677 } 2678 /* FALLTHROUGH */ 2679 case XPT_TARGET_IO: 2680 case XPT_CONT_TARGET_IO: 2681 start_ccb->csio.sense_resid = 0; 2682 start_ccb->csio.resid = 0; 2683 /* FALLTHROUGH */ 2684 case XPT_ATA_IO: 2685 if (start_ccb->ccb_h.func_code == XPT_ATA_IO) 2686 start_ccb->ataio.resid = 0; 2687 /* FALLTHROUGH */ 2688 case XPT_NVME_IO: 2689 case XPT_NVME_ADMIN: 2690 case XPT_MMC_IO: 2691 case XPT_RESET_DEV: 2692 case XPT_ENG_EXEC: 2693 case XPT_SMP_IO: 2694 { 2695 struct cam_devq *devq; 2696 2697 devq = path->bus->sim->devq; 2698 mtx_lock(&devq->send_mtx); 2699 cam_ccbq_insert_ccb(&path->device->ccbq, start_ccb); 2700 if (xpt_schedule_devq(devq, path->device) != 0) 2701 xpt_run_devq(devq); 2702 mtx_unlock(&devq->send_mtx); 2703 break; 2704 } 2705 case XPT_CALC_GEOMETRY: 2706 /* Filter out garbage */ 2707 if (start_ccb->ccg.block_size == 0 2708 || start_ccb->ccg.volume_size == 0) { 2709 start_ccb->ccg.cylinders = 0; 2710 start_ccb->ccg.heads = 0; 2711 start_ccb->ccg.secs_per_track = 0; 2712 start_ccb->ccb_h.status = CAM_REQ_CMP; 2713 break; 2714 } 2715 goto call_sim; 2716 case XPT_ABORT: 2717 { 2718 union ccb* abort_ccb; 2719 2720 abort_ccb = start_ccb->cab.abort_ccb; 2721 if (XPT_FC_IS_DEV_QUEUED(abort_ccb)) { 2722 struct cam_ed *device; 2723 struct cam_devq *devq; 2724 2725 device = abort_ccb->ccb_h.path->device; 2726 devq = device->sim->devq; 2727 2728 mtx_lock(&devq->send_mtx); 2729 if (abort_ccb->ccb_h.pinfo.index > 0) { 2730 cam_ccbq_remove_ccb(&device->ccbq, abort_ccb); 2731 abort_ccb->ccb_h.status = 2732 CAM_REQ_ABORTED|CAM_DEV_QFRZN; 2733 xpt_freeze_devq_device(device, 1); 2734 mtx_unlock(&devq->send_mtx); 2735 xpt_done(abort_ccb); 2736 start_ccb->ccb_h.status = CAM_REQ_CMP; 2737 break; 2738 } 2739 mtx_unlock(&devq->send_mtx); 2740 2741 if (abort_ccb->ccb_h.pinfo.index == CAM_UNQUEUED_INDEX 2742 && (abort_ccb->ccb_h.status & CAM_SIM_QUEUED) == 0) { 2743 /* 2744 * We've caught this ccb en route to 2745 * the SIM. Flag it for abort and the 2746 * SIM will do so just before starting 2747 * real work on the CCB. 2748 */ 2749 abort_ccb->ccb_h.status = 2750 CAM_REQ_ABORTED|CAM_DEV_QFRZN; 2751 xpt_freeze_devq(abort_ccb->ccb_h.path, 1); 2752 start_ccb->ccb_h.status = CAM_REQ_CMP; 2753 break; 2754 } 2755 } 2756 if (XPT_FC_IS_QUEUED(abort_ccb) 2757 && (abort_ccb->ccb_h.pinfo.index == CAM_DONEQ_INDEX)) { 2758 /* 2759 * It's already completed but waiting 2760 * for our SWI to get to it. 2761 */ 2762 start_ccb->ccb_h.status = CAM_UA_ABORT; 2763 break; 2764 } 2765 /* 2766 * If we weren't able to take care of the abort request 2767 * in the XPT, pass the request down to the SIM for processing. 2768 */ 2769 } 2770 /* FALLTHROUGH */ 2771 case XPT_ACCEPT_TARGET_IO: 2772 case XPT_EN_LUN: 2773 case XPT_IMMED_NOTIFY: 2774 case XPT_NOTIFY_ACK: 2775 case XPT_RESET_BUS: 2776 case XPT_IMMEDIATE_NOTIFY: 2777 case XPT_NOTIFY_ACKNOWLEDGE: 2778 case XPT_GET_SIM_KNOB_OLD: 2779 case XPT_GET_SIM_KNOB: 2780 case XPT_SET_SIM_KNOB: 2781 case XPT_GET_TRAN_SETTINGS: 2782 case XPT_SET_TRAN_SETTINGS: 2783 case XPT_PATH_INQ: 2784 call_sim: 2785 sim = path->bus->sim; 2786 mtx = sim->mtx; 2787 if (mtx && !mtx_owned(mtx)) 2788 mtx_lock(mtx); 2789 else 2790 mtx = NULL; 2791 2792 CAM_DEBUG(path, CAM_DEBUG_TRACE, 2793 ("Calling sim->sim_action(): func=%#x\n", start_ccb->ccb_h.func_code)); 2794 (*(sim->sim_action))(sim, start_ccb); 2795 CAM_DEBUG(path, CAM_DEBUG_TRACE, 2796 ("sim->sim_action returned: status=%#x\n", start_ccb->ccb_h.status)); 2797 if (mtx) 2798 mtx_unlock(mtx); 2799 break; 2800 case XPT_PATH_STATS: 2801 start_ccb->cpis.last_reset = path->bus->last_reset; 2802 start_ccb->ccb_h.status = CAM_REQ_CMP; 2803 break; 2804 case XPT_GDEV_TYPE: 2805 { 2806 struct cam_ed *dev; 2807 2808 dev = path->device; 2809 if ((dev->flags & CAM_DEV_UNCONFIGURED) != 0) { 2810 start_ccb->ccb_h.status = CAM_DEV_NOT_THERE; 2811 } else { 2812 struct ccb_getdev *cgd; 2813 2814 cgd = &start_ccb->cgd; 2815 cgd->protocol = dev->protocol; 2816 cgd->inq_data = dev->inq_data; 2817 cgd->ident_data = dev->ident_data; 2818 cgd->inq_flags = dev->inq_flags; 2819 cgd->ccb_h.status = CAM_REQ_CMP; 2820 cgd->serial_num_len = dev->serial_num_len; 2821 if ((dev->serial_num_len > 0) 2822 && (dev->serial_num != NULL)) 2823 bcopy(dev->serial_num, cgd->serial_num, 2824 dev->serial_num_len); 2825 } 2826 break; 2827 } 2828 case XPT_GDEV_STATS: 2829 { 2830 struct ccb_getdevstats *cgds = &start_ccb->cgds; 2831 struct cam_ed *dev = path->device; 2832 struct cam_eb *bus = path->bus; 2833 struct cam_et *tar = path->target; 2834 struct cam_devq *devq = bus->sim->devq; 2835 2836 mtx_lock(&devq->send_mtx); 2837 cgds->dev_openings = dev->ccbq.dev_openings; 2838 cgds->dev_active = dev->ccbq.dev_active; 2839 cgds->allocated = dev->ccbq.allocated; 2840 cgds->queued = cam_ccbq_pending_ccb_count(&dev->ccbq); 2841 cgds->held = cgds->allocated - cgds->dev_active - cgds->queued; 2842 cgds->last_reset = tar->last_reset; 2843 cgds->maxtags = dev->maxtags; 2844 cgds->mintags = dev->mintags; 2845 if (timevalcmp(&tar->last_reset, &bus->last_reset, <)) 2846 cgds->last_reset = bus->last_reset; 2847 mtx_unlock(&devq->send_mtx); 2848 cgds->ccb_h.status = CAM_REQ_CMP; 2849 break; 2850 } 2851 case XPT_GDEVLIST: 2852 { 2853 struct cam_periph *nperiph; 2854 struct periph_list *periph_head; 2855 struct ccb_getdevlist *cgdl; 2856 u_int i; 2857 struct cam_ed *device; 2858 int found; 2859 2860 2861 found = 0; 2862 2863 /* 2864 * Don't want anyone mucking with our data. 2865 */ 2866 device = path->device; 2867 periph_head = &device->periphs; 2868 cgdl = &start_ccb->cgdl; 2869 2870 /* 2871 * Check and see if the list has changed since the user 2872 * last requested a list member. If so, tell them that the 2873 * list has changed, and therefore they need to start over 2874 * from the beginning. 2875 */ 2876 if ((cgdl->index != 0) && 2877 (cgdl->generation != device->generation)) { 2878 cgdl->status = CAM_GDEVLIST_LIST_CHANGED; 2879 break; 2880 } 2881 2882 /* 2883 * Traverse the list of peripherals and attempt to find 2884 * the requested peripheral. 2885 */ 2886 for (nperiph = SLIST_FIRST(periph_head), i = 0; 2887 (nperiph != NULL) && (i <= cgdl->index); 2888 nperiph = SLIST_NEXT(nperiph, periph_links), i++) { 2889 if (i == cgdl->index) { 2890 strlcpy(cgdl->periph_name, 2891 nperiph->periph_name, 2892 sizeof(cgdl->periph_name)); 2893 cgdl->unit_number = nperiph->unit_number; 2894 found = 1; 2895 } 2896 } 2897 if (found == 0) { 2898 cgdl->status = CAM_GDEVLIST_ERROR; 2899 break; 2900 } 2901 2902 if (nperiph == NULL) 2903 cgdl->status = CAM_GDEVLIST_LAST_DEVICE; 2904 else 2905 cgdl->status = CAM_GDEVLIST_MORE_DEVS; 2906 2907 cgdl->index++; 2908 cgdl->generation = device->generation; 2909 2910 cgdl->ccb_h.status = CAM_REQ_CMP; 2911 break; 2912 } 2913 case XPT_DEV_MATCH: 2914 { 2915 dev_pos_type position_type; 2916 struct ccb_dev_match *cdm; 2917 2918 cdm = &start_ccb->cdm; 2919 2920 /* 2921 * There are two ways of getting at information in the EDT. 2922 * The first way is via the primary EDT tree. It starts 2923 * with a list of buses, then a list of targets on a bus, 2924 * then devices/luns on a target, and then peripherals on a 2925 * device/lun. The "other" way is by the peripheral driver 2926 * lists. The peripheral driver lists are organized by 2927 * peripheral driver. (obviously) So it makes sense to 2928 * use the peripheral driver list if the user is looking 2929 * for something like "da1", or all "da" devices. If the 2930 * user is looking for something on a particular bus/target 2931 * or lun, it's generally better to go through the EDT tree. 2932 */ 2933 2934 if (cdm->pos.position_type != CAM_DEV_POS_NONE) 2935 position_type = cdm->pos.position_type; 2936 else { 2937 u_int i; 2938 2939 position_type = CAM_DEV_POS_NONE; 2940 2941 for (i = 0; i < cdm->num_patterns; i++) { 2942 if ((cdm->patterns[i].type == DEV_MATCH_BUS) 2943 ||(cdm->patterns[i].type == DEV_MATCH_DEVICE)){ 2944 position_type = CAM_DEV_POS_EDT; 2945 break; 2946 } 2947 } 2948 2949 if (cdm->num_patterns == 0) 2950 position_type = CAM_DEV_POS_EDT; 2951 else if (position_type == CAM_DEV_POS_NONE) 2952 position_type = CAM_DEV_POS_PDRV; 2953 } 2954 2955 switch(position_type & CAM_DEV_POS_TYPEMASK) { 2956 case CAM_DEV_POS_EDT: 2957 xptedtmatch(cdm); 2958 break; 2959 case CAM_DEV_POS_PDRV: 2960 xptperiphlistmatch(cdm); 2961 break; 2962 default: 2963 cdm->status = CAM_DEV_MATCH_ERROR; 2964 break; 2965 } 2966 2967 if (cdm->status == CAM_DEV_MATCH_ERROR) 2968 start_ccb->ccb_h.status = CAM_REQ_CMP_ERR; 2969 else 2970 start_ccb->ccb_h.status = CAM_REQ_CMP; 2971 2972 break; 2973 } 2974 case XPT_SASYNC_CB: 2975 { 2976 struct ccb_setasync *csa; 2977 struct async_node *cur_entry; 2978 struct async_list *async_head; 2979 u_int32_t added; 2980 2981 csa = &start_ccb->csa; 2982 added = csa->event_enable; 2983 async_head = &path->device->asyncs; 2984 2985 /* 2986 * If there is already an entry for us, simply 2987 * update it. 2988 */ 2989 cur_entry = SLIST_FIRST(async_head); 2990 while (cur_entry != NULL) { 2991 if ((cur_entry->callback_arg == csa->callback_arg) 2992 && (cur_entry->callback == csa->callback)) 2993 break; 2994 cur_entry = SLIST_NEXT(cur_entry, links); 2995 } 2996 2997 if (cur_entry != NULL) { 2998 /* 2999 * If the request has no flags set, 3000 * remove the entry. 3001 */ 3002 added &= ~cur_entry->event_enable; 3003 if (csa->event_enable == 0) { 3004 SLIST_REMOVE(async_head, cur_entry, 3005 async_node, links); 3006 xpt_release_device(path->device); 3007 free(cur_entry, M_CAMXPT); 3008 } else { 3009 cur_entry->event_enable = csa->event_enable; 3010 } 3011 csa->event_enable = added; 3012 } else { 3013 cur_entry = malloc(sizeof(*cur_entry), M_CAMXPT, 3014 M_NOWAIT); 3015 if (cur_entry == NULL) { 3016 csa->ccb_h.status = CAM_RESRC_UNAVAIL; 3017 break; 3018 } 3019 cur_entry->event_enable = csa->event_enable; 3020 cur_entry->event_lock = (path->bus->sim->mtx && 3021 mtx_owned(path->bus->sim->mtx)) ? 1 : 0; 3022 cur_entry->callback_arg = csa->callback_arg; 3023 cur_entry->callback = csa->callback; 3024 SLIST_INSERT_HEAD(async_head, cur_entry, links); 3025 xpt_acquire_device(path->device); 3026 } 3027 start_ccb->ccb_h.status = CAM_REQ_CMP; 3028 break; 3029 } 3030 case XPT_REL_SIMQ: 3031 { 3032 struct ccb_relsim *crs; 3033 struct cam_ed *dev; 3034 3035 crs = &start_ccb->crs; 3036 dev = path->device; 3037 if (dev == NULL) { 3038 3039 crs->ccb_h.status = CAM_DEV_NOT_THERE; 3040 break; 3041 } 3042 3043 if ((crs->release_flags & RELSIM_ADJUST_OPENINGS) != 0) { 3044 3045 /* Don't ever go below one opening */ 3046 if (crs->openings > 0) { 3047 xpt_dev_ccbq_resize(path, crs->openings); 3048 if (bootverbose) { 3049 xpt_print(path, 3050 "number of openings is now %d\n", 3051 crs->openings); 3052 } 3053 } 3054 } 3055 3056 mtx_lock(&dev->sim->devq->send_mtx); 3057 if ((crs->release_flags & RELSIM_RELEASE_AFTER_TIMEOUT) != 0) { 3058 3059 if ((dev->flags & CAM_DEV_REL_TIMEOUT_PENDING) != 0) { 3060 3061 /* 3062 * Just extend the old timeout and decrement 3063 * the freeze count so that a single timeout 3064 * is sufficient for releasing the queue. 3065 */ 3066 start_ccb->ccb_h.flags &= ~CAM_DEV_QFREEZE; 3067 callout_stop(&dev->callout); 3068 } else { 3069 3070 start_ccb->ccb_h.flags |= CAM_DEV_QFREEZE; 3071 } 3072 3073 callout_reset_sbt(&dev->callout, 3074 SBT_1MS * crs->release_timeout, 0, 3075 xpt_release_devq_timeout, dev, 0); 3076 3077 dev->flags |= CAM_DEV_REL_TIMEOUT_PENDING; 3078 3079 } 3080 3081 if ((crs->release_flags & RELSIM_RELEASE_AFTER_CMDCMPLT) != 0) { 3082 3083 if ((dev->flags & CAM_DEV_REL_ON_COMPLETE) != 0) { 3084 /* 3085 * Decrement the freeze count so that a single 3086 * completion is still sufficient to unfreeze 3087 * the queue. 3088 */ 3089 start_ccb->ccb_h.flags &= ~CAM_DEV_QFREEZE; 3090 } else { 3091 3092 dev->flags |= CAM_DEV_REL_ON_COMPLETE; 3093 start_ccb->ccb_h.flags |= CAM_DEV_QFREEZE; 3094 } 3095 } 3096 3097 if ((crs->release_flags & RELSIM_RELEASE_AFTER_QEMPTY) != 0) { 3098 3099 if ((dev->flags & CAM_DEV_REL_ON_QUEUE_EMPTY) != 0 3100 || (dev->ccbq.dev_active == 0)) { 3101 3102 start_ccb->ccb_h.flags &= ~CAM_DEV_QFREEZE; 3103 } else { 3104 3105 dev->flags |= CAM_DEV_REL_ON_QUEUE_EMPTY; 3106 start_ccb->ccb_h.flags |= CAM_DEV_QFREEZE; 3107 } 3108 } 3109 mtx_unlock(&dev->sim->devq->send_mtx); 3110 3111 if ((start_ccb->ccb_h.flags & CAM_DEV_QFREEZE) == 0) 3112 xpt_release_devq(path, /*count*/1, /*run_queue*/TRUE); 3113 start_ccb->crs.qfrozen_cnt = dev->ccbq.queue.qfrozen_cnt; 3114 start_ccb->ccb_h.status = CAM_REQ_CMP; 3115 break; 3116 } 3117 case XPT_DEBUG: { 3118 struct cam_path *oldpath; 3119 3120 /* Check that all request bits are supported. */ 3121 if (start_ccb->cdbg.flags & ~(CAM_DEBUG_COMPILE)) { 3122 start_ccb->ccb_h.status = CAM_FUNC_NOTAVAIL; 3123 break; 3124 } 3125 3126 cam_dflags = CAM_DEBUG_NONE; 3127 if (cam_dpath != NULL) { 3128 oldpath = cam_dpath; 3129 cam_dpath = NULL; 3130 xpt_free_path(oldpath); 3131 } 3132 if (start_ccb->cdbg.flags != CAM_DEBUG_NONE) { 3133 if (xpt_create_path(&cam_dpath, NULL, 3134 start_ccb->ccb_h.path_id, 3135 start_ccb->ccb_h.target_id, 3136 start_ccb->ccb_h.target_lun) != 3137 CAM_REQ_CMP) { 3138 start_ccb->ccb_h.status = CAM_RESRC_UNAVAIL; 3139 } else { 3140 cam_dflags = start_ccb->cdbg.flags; 3141 start_ccb->ccb_h.status = CAM_REQ_CMP; 3142 xpt_print(cam_dpath, "debugging flags now %x\n", 3143 cam_dflags); 3144 } 3145 } else 3146 start_ccb->ccb_h.status = CAM_REQ_CMP; 3147 break; 3148 } 3149 case XPT_NOOP: 3150 if ((start_ccb->ccb_h.flags & CAM_DEV_QFREEZE) != 0) 3151 xpt_freeze_devq(path, 1); 3152 start_ccb->ccb_h.status = CAM_REQ_CMP; 3153 break; 3154 case XPT_REPROBE_LUN: 3155 xpt_async(AC_INQ_CHANGED, path, NULL); 3156 start_ccb->ccb_h.status = CAM_REQ_CMP; 3157 xpt_done(start_ccb); 3158 break; 3159 case XPT_ASYNC: 3160 start_ccb->ccb_h.status = CAM_REQ_CMP; 3161 xpt_done(start_ccb); 3162 break; 3163 default: 3164 case XPT_SDEV_TYPE: 3165 case XPT_TERM_IO: 3166 case XPT_ENG_INQ: 3167 /* XXX Implement */ 3168 xpt_print(start_ccb->ccb_h.path, 3169 "%s: CCB type %#x %s not supported\n", __func__, 3170 start_ccb->ccb_h.func_code, 3171 xpt_action_name(start_ccb->ccb_h.func_code)); 3172 start_ccb->ccb_h.status = CAM_PROVIDE_FAIL; 3173 if (start_ccb->ccb_h.func_code & XPT_FC_DEV_QUEUED) { 3174 xpt_done(start_ccb); 3175 } 3176 break; 3177 } 3178 CAM_DEBUG(path, CAM_DEBUG_TRACE, 3179 ("xpt_action_default: func= %#x %s status %#x\n", 3180 start_ccb->ccb_h.func_code, 3181 xpt_action_name(start_ccb->ccb_h.func_code), 3182 start_ccb->ccb_h.status)); 3183 } 3184 3185 /* 3186 * Call the sim poll routine to allow the sim to complete 3187 * any inflight requests, then call camisr_runqueue to 3188 * complete any CCB that the polling completed. 3189 */ 3190 void 3191 xpt_sim_poll(struct cam_sim *sim) 3192 { 3193 struct mtx *mtx; 3194 3195 mtx = sim->mtx; 3196 if (mtx) 3197 mtx_lock(mtx); 3198 (*(sim->sim_poll))(sim); 3199 if (mtx) 3200 mtx_unlock(mtx); 3201 camisr_runqueue(); 3202 } 3203 3204 uint32_t 3205 xpt_poll_setup(union ccb *start_ccb) 3206 { 3207 u_int32_t timeout; 3208 struct cam_sim *sim; 3209 struct cam_devq *devq; 3210 struct cam_ed *dev; 3211 3212 timeout = start_ccb->ccb_h.timeout * 10; 3213 sim = start_ccb->ccb_h.path->bus->sim; 3214 devq = sim->devq; 3215 dev = start_ccb->ccb_h.path->device; 3216 3217 /* 3218 * Steal an opening so that no other queued requests 3219 * can get it before us while we simulate interrupts. 3220 */ 3221 mtx_lock(&devq->send_mtx); 3222 dev->ccbq.dev_openings--; 3223 while((devq->send_openings <= 0 || dev->ccbq.dev_openings < 0) && 3224 (--timeout > 0)) { 3225 mtx_unlock(&devq->send_mtx); 3226 DELAY(100); 3227 xpt_sim_poll(sim); 3228 mtx_lock(&devq->send_mtx); 3229 } 3230 dev->ccbq.dev_openings++; 3231 mtx_unlock(&devq->send_mtx); 3232 3233 return (timeout); 3234 } 3235 3236 void 3237 xpt_pollwait(union ccb *start_ccb, uint32_t timeout) 3238 { 3239 3240 while (--timeout > 0) { 3241 xpt_sim_poll(start_ccb->ccb_h.path->bus->sim); 3242 if ((start_ccb->ccb_h.status & CAM_STATUS_MASK) 3243 != CAM_REQ_INPROG) 3244 break; 3245 DELAY(100); 3246 } 3247 3248 if (timeout == 0) { 3249 /* 3250 * XXX Is it worth adding a sim_timeout entry 3251 * point so we can attempt recovery? If 3252 * this is only used for dumps, I don't think 3253 * it is. 3254 */ 3255 start_ccb->ccb_h.status = CAM_CMD_TIMEOUT; 3256 } 3257 } 3258 3259 void 3260 xpt_polled_action(union ccb *start_ccb) 3261 { 3262 uint32_t timeout; 3263 struct cam_ed *dev; 3264 3265 timeout = start_ccb->ccb_h.timeout * 10; 3266 dev = start_ccb->ccb_h.path->device; 3267 3268 mtx_unlock(&dev->device_mtx); 3269 3270 timeout = xpt_poll_setup(start_ccb); 3271 if (timeout > 0) { 3272 xpt_action(start_ccb); 3273 xpt_pollwait(start_ccb, timeout); 3274 } else { 3275 start_ccb->ccb_h.status = CAM_RESRC_UNAVAIL; 3276 } 3277 3278 mtx_lock(&dev->device_mtx); 3279 } 3280 3281 /* 3282 * Schedule a peripheral driver to receive a ccb when its 3283 * target device has space for more transactions. 3284 */ 3285 void 3286 xpt_schedule(struct cam_periph *periph, u_int32_t new_priority) 3287 { 3288 3289 CAM_DEBUG(periph->path, CAM_DEBUG_TRACE, ("xpt_schedule\n")); 3290 cam_periph_assert(periph, MA_OWNED); 3291 if (new_priority < periph->scheduled_priority) { 3292 periph->scheduled_priority = new_priority; 3293 xpt_run_allocq(periph, 0); 3294 } 3295 } 3296 3297 3298 /* 3299 * Schedule a device to run on a given queue. 3300 * If the device was inserted as a new entry on the queue, 3301 * return 1 meaning the device queue should be run. If we 3302 * were already queued, implying someone else has already 3303 * started the queue, return 0 so the caller doesn't attempt 3304 * to run the queue. 3305 */ 3306 static int 3307 xpt_schedule_dev(struct camq *queue, cam_pinfo *pinfo, 3308 u_int32_t new_priority) 3309 { 3310 int retval; 3311 u_int32_t old_priority; 3312 3313 CAM_DEBUG_PRINT(CAM_DEBUG_XPT, ("xpt_schedule_dev\n")); 3314 3315 3316 old_priority = pinfo->priority; 3317 3318 /* 3319 * Are we already queued? 3320 */ 3321 if (pinfo->index != CAM_UNQUEUED_INDEX) { 3322 /* Simply reorder based on new priority */ 3323 if (new_priority < old_priority) { 3324 camq_change_priority(queue, pinfo->index, 3325 new_priority); 3326 CAM_DEBUG_PRINT(CAM_DEBUG_XPT, 3327 ("changed priority to %d\n", 3328 new_priority)); 3329 retval = 1; 3330 } else 3331 retval = 0; 3332 } else { 3333 /* New entry on the queue */ 3334 if (new_priority < old_priority) 3335 pinfo->priority = new_priority; 3336 3337 CAM_DEBUG_PRINT(CAM_DEBUG_XPT, 3338 ("Inserting onto queue\n")); 3339 pinfo->generation = ++queue->generation; 3340 camq_insert(queue, pinfo); 3341 retval = 1; 3342 } 3343 return (retval); 3344 } 3345 3346 static void 3347 xpt_run_allocq_task(void *context, int pending) 3348 { 3349 struct cam_periph *periph = context; 3350 3351 cam_periph_lock(periph); 3352 periph->flags &= ~CAM_PERIPH_RUN_TASK; 3353 xpt_run_allocq(periph, 1); 3354 cam_periph_unlock(periph); 3355 cam_periph_release(periph); 3356 } 3357 3358 static void 3359 xpt_run_allocq(struct cam_periph *periph, int sleep) 3360 { 3361 struct cam_ed *device; 3362 union ccb *ccb; 3363 uint32_t prio; 3364 3365 cam_periph_assert(periph, MA_OWNED); 3366 if (periph->periph_allocating) 3367 return; 3368 cam_periph_doacquire(periph); 3369 periph->periph_allocating = 1; 3370 CAM_DEBUG_PRINT(CAM_DEBUG_XPT, ("xpt_run_allocq(%p)\n", periph)); 3371 device = periph->path->device; 3372 ccb = NULL; 3373 restart: 3374 while ((prio = min(periph->scheduled_priority, 3375 periph->immediate_priority)) != CAM_PRIORITY_NONE && 3376 (periph->periph_allocated - (ccb != NULL ? 1 : 0) < 3377 device->ccbq.total_openings || prio <= CAM_PRIORITY_OOB)) { 3378 3379 if (ccb == NULL && 3380 (ccb = xpt_get_ccb_nowait(periph)) == NULL) { 3381 if (sleep) { 3382 ccb = xpt_get_ccb(periph); 3383 goto restart; 3384 } 3385 if (periph->flags & CAM_PERIPH_RUN_TASK) 3386 break; 3387 cam_periph_doacquire(periph); 3388 periph->flags |= CAM_PERIPH_RUN_TASK; 3389 taskqueue_enqueue(xsoftc.xpt_taskq, 3390 &periph->periph_run_task); 3391 break; 3392 } 3393 xpt_setup_ccb(&ccb->ccb_h, periph->path, prio); 3394 if (prio == periph->immediate_priority) { 3395 periph->immediate_priority = CAM_PRIORITY_NONE; 3396 CAM_DEBUG_PRINT(CAM_DEBUG_XPT, 3397 ("waking cam_periph_getccb()\n")); 3398 SLIST_INSERT_HEAD(&periph->ccb_list, &ccb->ccb_h, 3399 periph_links.sle); 3400 wakeup(&periph->ccb_list); 3401 } else { 3402 periph->scheduled_priority = CAM_PRIORITY_NONE; 3403 CAM_DEBUG_PRINT(CAM_DEBUG_XPT, 3404 ("calling periph_start()\n")); 3405 periph->periph_start(periph, ccb); 3406 } 3407 ccb = NULL; 3408 } 3409 if (ccb != NULL) 3410 xpt_release_ccb(ccb); 3411 periph->periph_allocating = 0; 3412 cam_periph_release_locked(periph); 3413 } 3414 3415 static void 3416 xpt_run_devq(struct cam_devq *devq) 3417 { 3418 struct mtx *mtx; 3419 3420 CAM_DEBUG_PRINT(CAM_DEBUG_XPT, ("xpt_run_devq\n")); 3421 3422 devq->send_queue.qfrozen_cnt++; 3423 while ((devq->send_queue.entries > 0) 3424 && (devq->send_openings > 0) 3425 && (devq->send_queue.qfrozen_cnt <= 1)) { 3426 struct cam_ed *device; 3427 union ccb *work_ccb; 3428 struct cam_sim *sim; 3429 struct xpt_proto *proto; 3430 3431 device = (struct cam_ed *)camq_remove(&devq->send_queue, 3432 CAMQ_HEAD); 3433 CAM_DEBUG_PRINT(CAM_DEBUG_XPT, 3434 ("running device %p\n", device)); 3435 3436 work_ccb = cam_ccbq_peek_ccb(&device->ccbq, CAMQ_HEAD); 3437 if (work_ccb == NULL) { 3438 printf("device on run queue with no ccbs???\n"); 3439 continue; 3440 } 3441 3442 if ((work_ccb->ccb_h.flags & CAM_HIGH_POWER) != 0) { 3443 3444 mtx_lock(&xsoftc.xpt_highpower_lock); 3445 if (xsoftc.num_highpower <= 0) { 3446 /* 3447 * We got a high power command, but we 3448 * don't have any available slots. Freeze 3449 * the device queue until we have a slot 3450 * available. 3451 */ 3452 xpt_freeze_devq_device(device, 1); 3453 STAILQ_INSERT_TAIL(&xsoftc.highpowerq, device, 3454 highpowerq_entry); 3455 3456 mtx_unlock(&xsoftc.xpt_highpower_lock); 3457 continue; 3458 } else { 3459 /* 3460 * Consume a high power slot while 3461 * this ccb runs. 3462 */ 3463 xsoftc.num_highpower--; 3464 } 3465 mtx_unlock(&xsoftc.xpt_highpower_lock); 3466 } 3467 cam_ccbq_remove_ccb(&device->ccbq, work_ccb); 3468 cam_ccbq_send_ccb(&device->ccbq, work_ccb); 3469 devq->send_openings--; 3470 devq->send_active++; 3471 xpt_schedule_devq(devq, device); 3472 mtx_unlock(&devq->send_mtx); 3473 3474 if ((work_ccb->ccb_h.flags & CAM_DEV_QFREEZE) != 0) { 3475 /* 3476 * The client wants to freeze the queue 3477 * after this CCB is sent. 3478 */ 3479 xpt_freeze_devq(work_ccb->ccb_h.path, 1); 3480 } 3481 3482 /* In Target mode, the peripheral driver knows best... */ 3483 if (work_ccb->ccb_h.func_code == XPT_SCSI_IO) { 3484 if ((device->inq_flags & SID_CmdQue) != 0 3485 && work_ccb->csio.tag_action != CAM_TAG_ACTION_NONE) 3486 work_ccb->ccb_h.flags |= CAM_TAG_ACTION_VALID; 3487 else 3488 /* 3489 * Clear this in case of a retried CCB that 3490 * failed due to a rejected tag. 3491 */ 3492 work_ccb->ccb_h.flags &= ~CAM_TAG_ACTION_VALID; 3493 } 3494 3495 KASSERT(device == work_ccb->ccb_h.path->device, 3496 ("device (%p) / path->device (%p) mismatch", 3497 device, work_ccb->ccb_h.path->device)); 3498 proto = xpt_proto_find(device->protocol); 3499 if (proto && proto->ops->debug_out) 3500 proto->ops->debug_out(work_ccb); 3501 3502 /* 3503 * Device queues can be shared among multiple SIM instances 3504 * that reside on different buses. Use the SIM from the 3505 * queued device, rather than the one from the calling bus. 3506 */ 3507 sim = device->sim; 3508 mtx = sim->mtx; 3509 if (mtx && !mtx_owned(mtx)) 3510 mtx_lock(mtx); 3511 else 3512 mtx = NULL; 3513 work_ccb->ccb_h.qos.periph_data = cam_iosched_now(); 3514 (*(sim->sim_action))(sim, work_ccb); 3515 if (mtx) 3516 mtx_unlock(mtx); 3517 mtx_lock(&devq->send_mtx); 3518 } 3519 devq->send_queue.qfrozen_cnt--; 3520 } 3521 3522 /* 3523 * This function merges stuff from the slave ccb into the master ccb, while 3524 * keeping important fields in the master ccb constant. 3525 */ 3526 void 3527 xpt_merge_ccb(union ccb *master_ccb, union ccb *slave_ccb) 3528 { 3529 3530 /* 3531 * Pull fields that are valid for peripheral drivers to set 3532 * into the master CCB along with the CCB "payload". 3533 */ 3534 master_ccb->ccb_h.retry_count = slave_ccb->ccb_h.retry_count; 3535 master_ccb->ccb_h.func_code = slave_ccb->ccb_h.func_code; 3536 master_ccb->ccb_h.timeout = slave_ccb->ccb_h.timeout; 3537 master_ccb->ccb_h.flags = slave_ccb->ccb_h.flags; 3538 bcopy(&(&slave_ccb->ccb_h)[1], &(&master_ccb->ccb_h)[1], 3539 sizeof(union ccb) - sizeof(struct ccb_hdr)); 3540 } 3541 3542 void 3543 xpt_setup_ccb_flags(struct ccb_hdr *ccb_h, struct cam_path *path, 3544 u_int32_t priority, u_int32_t flags) 3545 { 3546 3547 CAM_DEBUG(path, CAM_DEBUG_TRACE, ("xpt_setup_ccb\n")); 3548 ccb_h->pinfo.priority = priority; 3549 ccb_h->path = path; 3550 ccb_h->path_id = path->bus->path_id; 3551 if (path->target) 3552 ccb_h->target_id = path->target->target_id; 3553 else 3554 ccb_h->target_id = CAM_TARGET_WILDCARD; 3555 if (path->device) { 3556 ccb_h->target_lun = path->device->lun_id; 3557 ccb_h->pinfo.generation = ++path->device->ccbq.queue.generation; 3558 } else { 3559 ccb_h->target_lun = CAM_TARGET_WILDCARD; 3560 } 3561 ccb_h->pinfo.index = CAM_UNQUEUED_INDEX; 3562 ccb_h->flags = flags; 3563 ccb_h->xflags = 0; 3564 } 3565 3566 void 3567 xpt_setup_ccb(struct ccb_hdr *ccb_h, struct cam_path *path, u_int32_t priority) 3568 { 3569 xpt_setup_ccb_flags(ccb_h, path, priority, /*flags*/ 0); 3570 } 3571 3572 /* Path manipulation functions */ 3573 cam_status 3574 xpt_create_path(struct cam_path **new_path_ptr, struct cam_periph *perph, 3575 path_id_t path_id, target_id_t target_id, lun_id_t lun_id) 3576 { 3577 struct cam_path *path; 3578 cam_status status; 3579 3580 path = (struct cam_path *)malloc(sizeof(*path), M_CAMPATH, M_NOWAIT); 3581 3582 if (path == NULL) { 3583 status = CAM_RESRC_UNAVAIL; 3584 return(status); 3585 } 3586 status = xpt_compile_path(path, perph, path_id, target_id, lun_id); 3587 if (status != CAM_REQ_CMP) { 3588 free(path, M_CAMPATH); 3589 path = NULL; 3590 } 3591 *new_path_ptr = path; 3592 return (status); 3593 } 3594 3595 cam_status 3596 xpt_create_path_unlocked(struct cam_path **new_path_ptr, 3597 struct cam_periph *periph, path_id_t path_id, 3598 target_id_t target_id, lun_id_t lun_id) 3599 { 3600 3601 return (xpt_create_path(new_path_ptr, periph, path_id, target_id, 3602 lun_id)); 3603 } 3604 3605 cam_status 3606 xpt_compile_path(struct cam_path *new_path, struct cam_periph *perph, 3607 path_id_t path_id, target_id_t target_id, lun_id_t lun_id) 3608 { 3609 struct cam_eb *bus; 3610 struct cam_et *target; 3611 struct cam_ed *device; 3612 cam_status status; 3613 3614 status = CAM_REQ_CMP; /* Completed without error */ 3615 target = NULL; /* Wildcarded */ 3616 device = NULL; /* Wildcarded */ 3617 3618 /* 3619 * We will potentially modify the EDT, so block interrupts 3620 * that may attempt to create cam paths. 3621 */ 3622 bus = xpt_find_bus(path_id); 3623 if (bus == NULL) { 3624 status = CAM_PATH_INVALID; 3625 } else { 3626 xpt_lock_buses(); 3627 mtx_lock(&bus->eb_mtx); 3628 target = xpt_find_target(bus, target_id); 3629 if (target == NULL) { 3630 /* Create one */ 3631 struct cam_et *new_target; 3632 3633 new_target = xpt_alloc_target(bus, target_id); 3634 if (new_target == NULL) { 3635 status = CAM_RESRC_UNAVAIL; 3636 } else { 3637 target = new_target; 3638 } 3639 } 3640 xpt_unlock_buses(); 3641 if (target != NULL) { 3642 device = xpt_find_device(target, lun_id); 3643 if (device == NULL) { 3644 /* Create one */ 3645 struct cam_ed *new_device; 3646 3647 new_device = 3648 (*(bus->xport->ops->alloc_device))(bus, 3649 target, 3650 lun_id); 3651 if (new_device == NULL) { 3652 status = CAM_RESRC_UNAVAIL; 3653 } else { 3654 device = new_device; 3655 } 3656 } 3657 } 3658 mtx_unlock(&bus->eb_mtx); 3659 } 3660 3661 /* 3662 * Only touch the user's data if we are successful. 3663 */ 3664 if (status == CAM_REQ_CMP) { 3665 new_path->periph = perph; 3666 new_path->bus = bus; 3667 new_path->target = target; 3668 new_path->device = device; 3669 CAM_DEBUG(new_path, CAM_DEBUG_TRACE, ("xpt_compile_path\n")); 3670 } else { 3671 if (device != NULL) 3672 xpt_release_device(device); 3673 if (target != NULL) 3674 xpt_release_target(target); 3675 if (bus != NULL) 3676 xpt_release_bus(bus); 3677 } 3678 return (status); 3679 } 3680 3681 cam_status 3682 xpt_clone_path(struct cam_path **new_path_ptr, struct cam_path *path) 3683 { 3684 struct cam_path *new_path; 3685 3686 new_path = (struct cam_path *)malloc(sizeof(*path), M_CAMPATH, M_NOWAIT); 3687 if (new_path == NULL) 3688 return(CAM_RESRC_UNAVAIL); 3689 xpt_copy_path(new_path, path); 3690 *new_path_ptr = new_path; 3691 return (CAM_REQ_CMP); 3692 } 3693 3694 void 3695 xpt_copy_path(struct cam_path *new_path, struct cam_path *path) 3696 { 3697 3698 *new_path = *path; 3699 if (path->bus != NULL) 3700 xpt_acquire_bus(path->bus); 3701 if (path->target != NULL) 3702 xpt_acquire_target(path->target); 3703 if (path->device != NULL) 3704 xpt_acquire_device(path->device); 3705 } 3706 3707 void 3708 xpt_release_path(struct cam_path *path) 3709 { 3710 CAM_DEBUG(path, CAM_DEBUG_TRACE, ("xpt_release_path\n")); 3711 if (path->device != NULL) { 3712 xpt_release_device(path->device); 3713 path->device = NULL; 3714 } 3715 if (path->target != NULL) { 3716 xpt_release_target(path->target); 3717 path->target = NULL; 3718 } 3719 if (path->bus != NULL) { 3720 xpt_release_bus(path->bus); 3721 path->bus = NULL; 3722 } 3723 } 3724 3725 void 3726 xpt_free_path(struct cam_path *path) 3727 { 3728 3729 CAM_DEBUG(path, CAM_DEBUG_TRACE, ("xpt_free_path\n")); 3730 xpt_release_path(path); 3731 free(path, M_CAMPATH); 3732 } 3733 3734 void 3735 xpt_path_counts(struct cam_path *path, uint32_t *bus_ref, 3736 uint32_t *periph_ref, uint32_t *target_ref, uint32_t *device_ref) 3737 { 3738 3739 xpt_lock_buses(); 3740 if (bus_ref) { 3741 if (path->bus) 3742 *bus_ref = path->bus->refcount; 3743 else 3744 *bus_ref = 0; 3745 } 3746 if (periph_ref) { 3747 if (path->periph) 3748 *periph_ref = path->periph->refcount; 3749 else 3750 *periph_ref = 0; 3751 } 3752 xpt_unlock_buses(); 3753 if (target_ref) { 3754 if (path->target) 3755 *target_ref = path->target->refcount; 3756 else 3757 *target_ref = 0; 3758 } 3759 if (device_ref) { 3760 if (path->device) 3761 *device_ref = path->device->refcount; 3762 else 3763 *device_ref = 0; 3764 } 3765 } 3766 3767 /* 3768 * Return -1 for failure, 0 for exact match, 1 for match with wildcards 3769 * in path1, 2 for match with wildcards in path2. 3770 */ 3771 int 3772 xpt_path_comp(struct cam_path *path1, struct cam_path *path2) 3773 { 3774 int retval = 0; 3775 3776 if (path1->bus != path2->bus) { 3777 if (path1->bus->path_id == CAM_BUS_WILDCARD) 3778 retval = 1; 3779 else if (path2->bus->path_id == CAM_BUS_WILDCARD) 3780 retval = 2; 3781 else 3782 return (-1); 3783 } 3784 if (path1->target != path2->target) { 3785 if (path1->target->target_id == CAM_TARGET_WILDCARD) { 3786 if (retval == 0) 3787 retval = 1; 3788 } else if (path2->target->target_id == CAM_TARGET_WILDCARD) 3789 retval = 2; 3790 else 3791 return (-1); 3792 } 3793 if (path1->device != path2->device) { 3794 if (path1->device->lun_id == CAM_LUN_WILDCARD) { 3795 if (retval == 0) 3796 retval = 1; 3797 } else if (path2->device->lun_id == CAM_LUN_WILDCARD) 3798 retval = 2; 3799 else 3800 return (-1); 3801 } 3802 return (retval); 3803 } 3804 3805 int 3806 xpt_path_comp_dev(struct cam_path *path, struct cam_ed *dev) 3807 { 3808 int retval = 0; 3809 3810 if (path->bus != dev->target->bus) { 3811 if (path->bus->path_id == CAM_BUS_WILDCARD) 3812 retval = 1; 3813 else if (dev->target->bus->path_id == CAM_BUS_WILDCARD) 3814 retval = 2; 3815 else 3816 return (-1); 3817 } 3818 if (path->target != dev->target) { 3819 if (path->target->target_id == CAM_TARGET_WILDCARD) { 3820 if (retval == 0) 3821 retval = 1; 3822 } else if (dev->target->target_id == CAM_TARGET_WILDCARD) 3823 retval = 2; 3824 else 3825 return (-1); 3826 } 3827 if (path->device != dev) { 3828 if (path->device->lun_id == CAM_LUN_WILDCARD) { 3829 if (retval == 0) 3830 retval = 1; 3831 } else if (dev->lun_id == CAM_LUN_WILDCARD) 3832 retval = 2; 3833 else 3834 return (-1); 3835 } 3836 return (retval); 3837 } 3838 3839 void 3840 xpt_print_path(struct cam_path *path) 3841 { 3842 struct sbuf sb; 3843 char buffer[XPT_PRINT_LEN]; 3844 3845 sbuf_new(&sb, buffer, XPT_PRINT_LEN, SBUF_FIXEDLEN); 3846 xpt_path_sbuf(path, &sb); 3847 sbuf_finish(&sb); 3848 printf("%s", sbuf_data(&sb)); 3849 sbuf_delete(&sb); 3850 } 3851 3852 void 3853 xpt_print_device(struct cam_ed *device) 3854 { 3855 3856 if (device == NULL) 3857 printf("(nopath): "); 3858 else { 3859 printf("(noperiph:%s%d:%d:%d:%jx): ", device->sim->sim_name, 3860 device->sim->unit_number, 3861 device->sim->bus_id, 3862 device->target->target_id, 3863 (uintmax_t)device->lun_id); 3864 } 3865 } 3866 3867 void 3868 xpt_print(struct cam_path *path, const char *fmt, ...) 3869 { 3870 va_list ap; 3871 struct sbuf sb; 3872 char buffer[XPT_PRINT_LEN]; 3873 3874 sbuf_new(&sb, buffer, XPT_PRINT_LEN, SBUF_FIXEDLEN); 3875 3876 xpt_path_sbuf(path, &sb); 3877 va_start(ap, fmt); 3878 sbuf_vprintf(&sb, fmt, ap); 3879 va_end(ap); 3880 3881 sbuf_finish(&sb); 3882 printf("%s", sbuf_data(&sb)); 3883 sbuf_delete(&sb); 3884 } 3885 3886 int 3887 xpt_path_string(struct cam_path *path, char *str, size_t str_len) 3888 { 3889 struct sbuf sb; 3890 int len; 3891 3892 sbuf_new(&sb, str, str_len, 0); 3893 len = xpt_path_sbuf(path, &sb); 3894 sbuf_finish(&sb); 3895 return (len); 3896 } 3897 3898 int 3899 xpt_path_sbuf(struct cam_path *path, struct sbuf *sb) 3900 { 3901 3902 if (path == NULL) 3903 sbuf_printf(sb, "(nopath): "); 3904 else { 3905 if (path->periph != NULL) 3906 sbuf_printf(sb, "(%s%d:", path->periph->periph_name, 3907 path->periph->unit_number); 3908 else 3909 sbuf_printf(sb, "(noperiph:"); 3910 3911 if (path->bus != NULL) 3912 sbuf_printf(sb, "%s%d:%d:", path->bus->sim->sim_name, 3913 path->bus->sim->unit_number, 3914 path->bus->sim->bus_id); 3915 else 3916 sbuf_printf(sb, "nobus:"); 3917 3918 if (path->target != NULL) 3919 sbuf_printf(sb, "%d:", path->target->target_id); 3920 else 3921 sbuf_printf(sb, "X:"); 3922 3923 if (path->device != NULL) 3924 sbuf_printf(sb, "%jx): ", 3925 (uintmax_t)path->device->lun_id); 3926 else 3927 sbuf_printf(sb, "X): "); 3928 } 3929 3930 return(sbuf_len(sb)); 3931 } 3932 3933 path_id_t 3934 xpt_path_path_id(struct cam_path *path) 3935 { 3936 return(path->bus->path_id); 3937 } 3938 3939 target_id_t 3940 xpt_path_target_id(struct cam_path *path) 3941 { 3942 if (path->target != NULL) 3943 return (path->target->target_id); 3944 else 3945 return (CAM_TARGET_WILDCARD); 3946 } 3947 3948 lun_id_t 3949 xpt_path_lun_id(struct cam_path *path) 3950 { 3951 if (path->device != NULL) 3952 return (path->device->lun_id); 3953 else 3954 return (CAM_LUN_WILDCARD); 3955 } 3956 3957 struct cam_sim * 3958 xpt_path_sim(struct cam_path *path) 3959 { 3960 3961 return (path->bus->sim); 3962 } 3963 3964 struct cam_periph* 3965 xpt_path_periph(struct cam_path *path) 3966 { 3967 3968 return (path->periph); 3969 } 3970 3971 /* 3972 * Release a CAM control block for the caller. Remit the cost of the structure 3973 * to the device referenced by the path. If the this device had no 'credits' 3974 * and peripheral drivers have registered async callbacks for this notification 3975 * call them now. 3976 */ 3977 void 3978 xpt_release_ccb(union ccb *free_ccb) 3979 { 3980 struct cam_ed *device; 3981 struct cam_periph *periph; 3982 3983 CAM_DEBUG_PRINT(CAM_DEBUG_XPT, ("xpt_release_ccb\n")); 3984 xpt_path_assert(free_ccb->ccb_h.path, MA_OWNED); 3985 device = free_ccb->ccb_h.path->device; 3986 periph = free_ccb->ccb_h.path->periph; 3987 3988 xpt_free_ccb(free_ccb); 3989 periph->periph_allocated--; 3990 cam_ccbq_release_opening(&device->ccbq); 3991 xpt_run_allocq(periph, 0); 3992 } 3993 3994 /* Functions accessed by SIM drivers */ 3995 3996 static struct xpt_xport_ops xport_default_ops = { 3997 .alloc_device = xpt_alloc_device_default, 3998 .action = xpt_action_default, 3999 .async = xpt_dev_async_default, 4000 }; 4001 static struct xpt_xport xport_default = { 4002 .xport = XPORT_UNKNOWN, 4003 .name = "unknown", 4004 .ops = &xport_default_ops, 4005 }; 4006 4007 CAM_XPT_XPORT(xport_default); 4008 4009 /* 4010 * A sim structure, listing the SIM entry points and instance 4011 * identification info is passed to xpt_bus_register to hook the SIM 4012 * into the CAM framework. xpt_bus_register creates a cam_eb entry 4013 * for this new bus and places it in the array of buses and assigns 4014 * it a path_id. The path_id may be influenced by "hard wiring" 4015 * information specified by the user. Once interrupt services are 4016 * available, the bus will be probed. 4017 */ 4018 int32_t 4019 xpt_bus_register(struct cam_sim *sim, device_t parent, u_int32_t bus) 4020 { 4021 struct cam_eb *new_bus; 4022 struct cam_eb *old_bus; 4023 struct ccb_pathinq cpi; 4024 struct cam_path *path; 4025 cam_status status; 4026 4027 sim->bus_id = bus; 4028 new_bus = (struct cam_eb *)malloc(sizeof(*new_bus), 4029 M_CAMXPT, M_NOWAIT|M_ZERO); 4030 if (new_bus == NULL) { 4031 /* Couldn't satisfy request */ 4032 return (CAM_RESRC_UNAVAIL); 4033 } 4034 4035 mtx_init(&new_bus->eb_mtx, "CAM bus lock", NULL, MTX_DEF); 4036 TAILQ_INIT(&new_bus->et_entries); 4037 cam_sim_hold(sim); 4038 new_bus->sim = sim; 4039 timevalclear(&new_bus->last_reset); 4040 new_bus->flags = 0; 4041 new_bus->refcount = 1; /* Held until a bus_deregister event */ 4042 new_bus->generation = 0; 4043 4044 xpt_lock_buses(); 4045 sim->path_id = new_bus->path_id = 4046 xptpathid(sim->sim_name, sim->unit_number, sim->bus_id); 4047 old_bus = TAILQ_FIRST(&xsoftc.xpt_busses); 4048 while (old_bus != NULL 4049 && old_bus->path_id < new_bus->path_id) 4050 old_bus = TAILQ_NEXT(old_bus, links); 4051 if (old_bus != NULL) 4052 TAILQ_INSERT_BEFORE(old_bus, new_bus, links); 4053 else 4054 TAILQ_INSERT_TAIL(&xsoftc.xpt_busses, new_bus, links); 4055 xsoftc.bus_generation++; 4056 xpt_unlock_buses(); 4057 4058 /* 4059 * Set a default transport so that a PATH_INQ can be issued to 4060 * the SIM. This will then allow for probing and attaching of 4061 * a more appropriate transport. 4062 */ 4063 new_bus->xport = &xport_default; 4064 4065 status = xpt_create_path(&path, /*periph*/NULL, sim->path_id, 4066 CAM_TARGET_WILDCARD, CAM_LUN_WILDCARD); 4067 if (status != CAM_REQ_CMP) { 4068 xpt_release_bus(new_bus); 4069 return (CAM_RESRC_UNAVAIL); 4070 } 4071 4072 xpt_path_inq(&cpi, path); 4073 4074 if (cpi.ccb_h.status == CAM_REQ_CMP) { 4075 struct xpt_xport **xpt; 4076 4077 SET_FOREACH(xpt, cam_xpt_xport_set) { 4078 if ((*xpt)->xport == cpi.transport) { 4079 new_bus->xport = *xpt; 4080 break; 4081 } 4082 } 4083 if (new_bus->xport == NULL) { 4084 xpt_print(path, 4085 "No transport found for %d\n", cpi.transport); 4086 xpt_release_bus(new_bus); 4087 free(path, M_CAMXPT); 4088 return (CAM_RESRC_UNAVAIL); 4089 } 4090 } 4091 4092 /* Notify interested parties */ 4093 if (sim->path_id != CAM_XPT_PATH_ID) { 4094 4095 xpt_async(AC_PATH_REGISTERED, path, &cpi); 4096 if ((cpi.hba_misc & PIM_NOSCAN) == 0) { 4097 union ccb *scan_ccb; 4098 4099 /* Initiate bus rescan. */ 4100 scan_ccb = xpt_alloc_ccb_nowait(); 4101 if (scan_ccb != NULL) { 4102 scan_ccb->ccb_h.path = path; 4103 scan_ccb->ccb_h.func_code = XPT_SCAN_BUS; 4104 scan_ccb->crcn.flags = 0; 4105 xpt_rescan(scan_ccb); 4106 } else { 4107 xpt_print(path, 4108 "Can't allocate CCB to scan bus\n"); 4109 xpt_free_path(path); 4110 } 4111 } else 4112 xpt_free_path(path); 4113 } else 4114 xpt_free_path(path); 4115 return (CAM_SUCCESS); 4116 } 4117 4118 int32_t 4119 xpt_bus_deregister(path_id_t pathid) 4120 { 4121 struct cam_path bus_path; 4122 cam_status status; 4123 4124 status = xpt_compile_path(&bus_path, NULL, pathid, 4125 CAM_TARGET_WILDCARD, CAM_LUN_WILDCARD); 4126 if (status != CAM_REQ_CMP) 4127 return (status); 4128 4129 xpt_async(AC_LOST_DEVICE, &bus_path, NULL); 4130 xpt_async(AC_PATH_DEREGISTERED, &bus_path, NULL); 4131 4132 /* Release the reference count held while registered. */ 4133 xpt_release_bus(bus_path.bus); 4134 xpt_release_path(&bus_path); 4135 4136 return (CAM_REQ_CMP); 4137 } 4138 4139 static path_id_t 4140 xptnextfreepathid(void) 4141 { 4142 struct cam_eb *bus; 4143 path_id_t pathid; 4144 const char *strval; 4145 4146 mtx_assert(&xsoftc.xpt_topo_lock, MA_OWNED); 4147 pathid = 0; 4148 bus = TAILQ_FIRST(&xsoftc.xpt_busses); 4149 retry: 4150 /* Find an unoccupied pathid */ 4151 while (bus != NULL && bus->path_id <= pathid) { 4152 if (bus->path_id == pathid) 4153 pathid++; 4154 bus = TAILQ_NEXT(bus, links); 4155 } 4156 4157 /* 4158 * Ensure that this pathid is not reserved for 4159 * a bus that may be registered in the future. 4160 */ 4161 if (resource_string_value("scbus", pathid, "at", &strval) == 0) { 4162 ++pathid; 4163 /* Start the search over */ 4164 goto retry; 4165 } 4166 return (pathid); 4167 } 4168 4169 static path_id_t 4170 xptpathid(const char *sim_name, int sim_unit, int sim_bus) 4171 { 4172 path_id_t pathid; 4173 int i, dunit, val; 4174 char buf[32]; 4175 const char *dname; 4176 4177 pathid = CAM_XPT_PATH_ID; 4178 snprintf(buf, sizeof(buf), "%s%d", sim_name, sim_unit); 4179 if (strcmp(buf, "xpt0") == 0 && sim_bus == 0) 4180 return (pathid); 4181 i = 0; 4182 while ((resource_find_match(&i, &dname, &dunit, "at", buf)) == 0) { 4183 if (strcmp(dname, "scbus")) { 4184 /* Avoid a bit of foot shooting. */ 4185 continue; 4186 } 4187 if (dunit < 0) /* unwired?! */ 4188 continue; 4189 if (resource_int_value("scbus", dunit, "bus", &val) == 0) { 4190 if (sim_bus == val) { 4191 pathid = dunit; 4192 break; 4193 } 4194 } else if (sim_bus == 0) { 4195 /* Unspecified matches bus 0 */ 4196 pathid = dunit; 4197 break; 4198 } else { 4199 printf("Ambiguous scbus configuration for %s%d " 4200 "bus %d, cannot wire down. The kernel " 4201 "config entry for scbus%d should " 4202 "specify a controller bus.\n" 4203 "Scbus will be assigned dynamically.\n", 4204 sim_name, sim_unit, sim_bus, dunit); 4205 break; 4206 } 4207 } 4208 4209 if (pathid == CAM_XPT_PATH_ID) 4210 pathid = xptnextfreepathid(); 4211 return (pathid); 4212 } 4213 4214 static const char * 4215 xpt_async_string(u_int32_t async_code) 4216 { 4217 4218 switch (async_code) { 4219 case AC_BUS_RESET: return ("AC_BUS_RESET"); 4220 case AC_UNSOL_RESEL: return ("AC_UNSOL_RESEL"); 4221 case AC_SCSI_AEN: return ("AC_SCSI_AEN"); 4222 case AC_SENT_BDR: return ("AC_SENT_BDR"); 4223 case AC_PATH_REGISTERED: return ("AC_PATH_REGISTERED"); 4224 case AC_PATH_DEREGISTERED: return ("AC_PATH_DEREGISTERED"); 4225 case AC_FOUND_DEVICE: return ("AC_FOUND_DEVICE"); 4226 case AC_LOST_DEVICE: return ("AC_LOST_DEVICE"); 4227 case AC_TRANSFER_NEG: return ("AC_TRANSFER_NEG"); 4228 case AC_INQ_CHANGED: return ("AC_INQ_CHANGED"); 4229 case AC_GETDEV_CHANGED: return ("AC_GETDEV_CHANGED"); 4230 case AC_CONTRACT: return ("AC_CONTRACT"); 4231 case AC_ADVINFO_CHANGED: return ("AC_ADVINFO_CHANGED"); 4232 case AC_UNIT_ATTENTION: return ("AC_UNIT_ATTENTION"); 4233 } 4234 return ("AC_UNKNOWN"); 4235 } 4236 4237 static int 4238 xpt_async_size(u_int32_t async_code) 4239 { 4240 4241 switch (async_code) { 4242 case AC_BUS_RESET: return (0); 4243 case AC_UNSOL_RESEL: return (0); 4244 case AC_SCSI_AEN: return (0); 4245 case AC_SENT_BDR: return (0); 4246 case AC_PATH_REGISTERED: return (sizeof(struct ccb_pathinq)); 4247 case AC_PATH_DEREGISTERED: return (0); 4248 case AC_FOUND_DEVICE: return (sizeof(struct ccb_getdev)); 4249 case AC_LOST_DEVICE: return (0); 4250 case AC_TRANSFER_NEG: return (sizeof(struct ccb_trans_settings)); 4251 case AC_INQ_CHANGED: return (0); 4252 case AC_GETDEV_CHANGED: return (0); 4253 case AC_CONTRACT: return (sizeof(struct ac_contract)); 4254 case AC_ADVINFO_CHANGED: return (-1); 4255 case AC_UNIT_ATTENTION: return (sizeof(struct ccb_scsiio)); 4256 } 4257 return (0); 4258 } 4259 4260 static int 4261 xpt_async_process_dev(struct cam_ed *device, void *arg) 4262 { 4263 union ccb *ccb = arg; 4264 struct cam_path *path = ccb->ccb_h.path; 4265 void *async_arg = ccb->casync.async_arg_ptr; 4266 u_int32_t async_code = ccb->casync.async_code; 4267 int relock; 4268 4269 if (path->device != device 4270 && path->device->lun_id != CAM_LUN_WILDCARD 4271 && device->lun_id != CAM_LUN_WILDCARD) 4272 return (1); 4273 4274 /* 4275 * The async callback could free the device. 4276 * If it is a broadcast async, it doesn't hold 4277 * device reference, so take our own reference. 4278 */ 4279 xpt_acquire_device(device); 4280 4281 /* 4282 * If async for specific device is to be delivered to 4283 * the wildcard client, take the specific device lock. 4284 * XXX: We may need a way for client to specify it. 4285 */ 4286 if ((device->lun_id == CAM_LUN_WILDCARD && 4287 path->device->lun_id != CAM_LUN_WILDCARD) || 4288 (device->target->target_id == CAM_TARGET_WILDCARD && 4289 path->target->target_id != CAM_TARGET_WILDCARD) || 4290 (device->target->bus->path_id == CAM_BUS_WILDCARD && 4291 path->target->bus->path_id != CAM_BUS_WILDCARD)) { 4292 mtx_unlock(&device->device_mtx); 4293 xpt_path_lock(path); 4294 relock = 1; 4295 } else 4296 relock = 0; 4297 4298 (*(device->target->bus->xport->ops->async))(async_code, 4299 device->target->bus, device->target, device, async_arg); 4300 xpt_async_bcast(&device->asyncs, async_code, path, async_arg); 4301 4302 if (relock) { 4303 xpt_path_unlock(path); 4304 mtx_lock(&device->device_mtx); 4305 } 4306 xpt_release_device(device); 4307 return (1); 4308 } 4309 4310 static int 4311 xpt_async_process_tgt(struct cam_et *target, void *arg) 4312 { 4313 union ccb *ccb = arg; 4314 struct cam_path *path = ccb->ccb_h.path; 4315 4316 if (path->target != target 4317 && path->target->target_id != CAM_TARGET_WILDCARD 4318 && target->target_id != CAM_TARGET_WILDCARD) 4319 return (1); 4320 4321 if (ccb->casync.async_code == AC_SENT_BDR) { 4322 /* Update our notion of when the last reset occurred */ 4323 microtime(&target->last_reset); 4324 } 4325 4326 return (xptdevicetraverse(target, NULL, xpt_async_process_dev, ccb)); 4327 } 4328 4329 static void 4330 xpt_async_process(struct cam_periph *periph, union ccb *ccb) 4331 { 4332 struct cam_eb *bus; 4333 struct cam_path *path; 4334 void *async_arg; 4335 u_int32_t async_code; 4336 4337 path = ccb->ccb_h.path; 4338 async_code = ccb->casync.async_code; 4339 async_arg = ccb->casync.async_arg_ptr; 4340 CAM_DEBUG(path, CAM_DEBUG_TRACE | CAM_DEBUG_INFO, 4341 ("xpt_async(%s)\n", xpt_async_string(async_code))); 4342 bus = path->bus; 4343 4344 if (async_code == AC_BUS_RESET) { 4345 /* Update our notion of when the last reset occurred */ 4346 microtime(&bus->last_reset); 4347 } 4348 4349 xpttargettraverse(bus, NULL, xpt_async_process_tgt, ccb); 4350 4351 /* 4352 * If this wasn't a fully wildcarded async, tell all 4353 * clients that want all async events. 4354 */ 4355 if (bus != xpt_periph->path->bus) { 4356 xpt_path_lock(xpt_periph->path); 4357 xpt_async_process_dev(xpt_periph->path->device, ccb); 4358 xpt_path_unlock(xpt_periph->path); 4359 } 4360 4361 if (path->device != NULL && path->device->lun_id != CAM_LUN_WILDCARD) 4362 xpt_release_devq(path, 1, TRUE); 4363 else 4364 xpt_release_simq(path->bus->sim, TRUE); 4365 if (ccb->casync.async_arg_size > 0) 4366 free(async_arg, M_CAMXPT); 4367 xpt_free_path(path); 4368 xpt_free_ccb(ccb); 4369 } 4370 4371 static void 4372 xpt_async_bcast(struct async_list *async_head, 4373 u_int32_t async_code, 4374 struct cam_path *path, void *async_arg) 4375 { 4376 struct async_node *cur_entry; 4377 struct mtx *mtx; 4378 4379 cur_entry = SLIST_FIRST(async_head); 4380 while (cur_entry != NULL) { 4381 struct async_node *next_entry; 4382 /* 4383 * Grab the next list entry before we call the current 4384 * entry's callback. This is because the callback function 4385 * can delete its async callback entry. 4386 */ 4387 next_entry = SLIST_NEXT(cur_entry, links); 4388 if ((cur_entry->event_enable & async_code) != 0) { 4389 mtx = cur_entry->event_lock ? 4390 path->device->sim->mtx : NULL; 4391 if (mtx) 4392 mtx_lock(mtx); 4393 cur_entry->callback(cur_entry->callback_arg, 4394 async_code, path, 4395 async_arg); 4396 if (mtx) 4397 mtx_unlock(mtx); 4398 } 4399 cur_entry = next_entry; 4400 } 4401 } 4402 4403 void 4404 xpt_async(u_int32_t async_code, struct cam_path *path, void *async_arg) 4405 { 4406 union ccb *ccb; 4407 int size; 4408 4409 ccb = xpt_alloc_ccb_nowait(); 4410 if (ccb == NULL) { 4411 xpt_print(path, "Can't allocate CCB to send %s\n", 4412 xpt_async_string(async_code)); 4413 return; 4414 } 4415 4416 if (xpt_clone_path(&ccb->ccb_h.path, path) != CAM_REQ_CMP) { 4417 xpt_print(path, "Can't allocate path to send %s\n", 4418 xpt_async_string(async_code)); 4419 xpt_free_ccb(ccb); 4420 return; 4421 } 4422 ccb->ccb_h.path->periph = NULL; 4423 ccb->ccb_h.func_code = XPT_ASYNC; 4424 ccb->ccb_h.cbfcnp = xpt_async_process; 4425 ccb->ccb_h.flags |= CAM_UNLOCKED; 4426 ccb->casync.async_code = async_code; 4427 ccb->casync.async_arg_size = 0; 4428 size = xpt_async_size(async_code); 4429 CAM_DEBUG(ccb->ccb_h.path, CAM_DEBUG_TRACE, 4430 ("xpt_async: func %#x %s aync_code %d %s\n", 4431 ccb->ccb_h.func_code, 4432 xpt_action_name(ccb->ccb_h.func_code), 4433 async_code, 4434 xpt_async_string(async_code))); 4435 if (size > 0 && async_arg != NULL) { 4436 ccb->casync.async_arg_ptr = malloc(size, M_CAMXPT, M_NOWAIT); 4437 if (ccb->casync.async_arg_ptr == NULL) { 4438 xpt_print(path, "Can't allocate argument to send %s\n", 4439 xpt_async_string(async_code)); 4440 xpt_free_path(ccb->ccb_h.path); 4441 xpt_free_ccb(ccb); 4442 return; 4443 } 4444 memcpy(ccb->casync.async_arg_ptr, async_arg, size); 4445 ccb->casync.async_arg_size = size; 4446 } else if (size < 0) { 4447 ccb->casync.async_arg_ptr = async_arg; 4448 ccb->casync.async_arg_size = size; 4449 } 4450 if (path->device != NULL && path->device->lun_id != CAM_LUN_WILDCARD) 4451 xpt_freeze_devq(path, 1); 4452 else 4453 xpt_freeze_simq(path->bus->sim, 1); 4454 xpt_action(ccb); 4455 } 4456 4457 static void 4458 xpt_dev_async_default(u_int32_t async_code, struct cam_eb *bus, 4459 struct cam_et *target, struct cam_ed *device, 4460 void *async_arg) 4461 { 4462 4463 /* 4464 * We only need to handle events for real devices. 4465 */ 4466 if (target->target_id == CAM_TARGET_WILDCARD 4467 || device->lun_id == CAM_LUN_WILDCARD) 4468 return; 4469 4470 printf("%s called\n", __func__); 4471 } 4472 4473 static uint32_t 4474 xpt_freeze_devq_device(struct cam_ed *dev, u_int count) 4475 { 4476 struct cam_devq *devq; 4477 uint32_t freeze; 4478 4479 devq = dev->sim->devq; 4480 mtx_assert(&devq->send_mtx, MA_OWNED); 4481 CAM_DEBUG_DEV(dev, CAM_DEBUG_TRACE, 4482 ("xpt_freeze_devq_device(%d) %u->%u\n", count, 4483 dev->ccbq.queue.qfrozen_cnt, dev->ccbq.queue.qfrozen_cnt + count)); 4484 freeze = (dev->ccbq.queue.qfrozen_cnt += count); 4485 /* Remove frozen device from sendq. */ 4486 if (device_is_queued(dev)) 4487 camq_remove(&devq->send_queue, dev->devq_entry.index); 4488 return (freeze); 4489 } 4490 4491 u_int32_t 4492 xpt_freeze_devq(struct cam_path *path, u_int count) 4493 { 4494 struct cam_ed *dev = path->device; 4495 struct cam_devq *devq; 4496 uint32_t freeze; 4497 4498 devq = dev->sim->devq; 4499 mtx_lock(&devq->send_mtx); 4500 CAM_DEBUG(path, CAM_DEBUG_TRACE, ("xpt_freeze_devq(%d)\n", count)); 4501 freeze = xpt_freeze_devq_device(dev, count); 4502 mtx_unlock(&devq->send_mtx); 4503 return (freeze); 4504 } 4505 4506 u_int32_t 4507 xpt_freeze_simq(struct cam_sim *sim, u_int count) 4508 { 4509 struct cam_devq *devq; 4510 uint32_t freeze; 4511 4512 devq = sim->devq; 4513 mtx_lock(&devq->send_mtx); 4514 freeze = (devq->send_queue.qfrozen_cnt += count); 4515 mtx_unlock(&devq->send_mtx); 4516 return (freeze); 4517 } 4518 4519 static void 4520 xpt_release_devq_timeout(void *arg) 4521 { 4522 struct cam_ed *dev; 4523 struct cam_devq *devq; 4524 4525 dev = (struct cam_ed *)arg; 4526 CAM_DEBUG_DEV(dev, CAM_DEBUG_TRACE, ("xpt_release_devq_timeout\n")); 4527 devq = dev->sim->devq; 4528 mtx_assert(&devq->send_mtx, MA_OWNED); 4529 if (xpt_release_devq_device(dev, /*count*/1, /*run_queue*/TRUE)) 4530 xpt_run_devq(devq); 4531 } 4532 4533 void 4534 xpt_release_devq(struct cam_path *path, u_int count, int run_queue) 4535 { 4536 struct cam_ed *dev; 4537 struct cam_devq *devq; 4538 4539 CAM_DEBUG(path, CAM_DEBUG_TRACE, ("xpt_release_devq(%d, %d)\n", 4540 count, run_queue)); 4541 dev = path->device; 4542 devq = dev->sim->devq; 4543 mtx_lock(&devq->send_mtx); 4544 if (xpt_release_devq_device(dev, count, run_queue)) 4545 xpt_run_devq(dev->sim->devq); 4546 mtx_unlock(&devq->send_mtx); 4547 } 4548 4549 static int 4550 xpt_release_devq_device(struct cam_ed *dev, u_int count, int run_queue) 4551 { 4552 4553 mtx_assert(&dev->sim->devq->send_mtx, MA_OWNED); 4554 CAM_DEBUG_DEV(dev, CAM_DEBUG_TRACE, 4555 ("xpt_release_devq_device(%d, %d) %u->%u\n", count, run_queue, 4556 dev->ccbq.queue.qfrozen_cnt, dev->ccbq.queue.qfrozen_cnt - count)); 4557 if (count > dev->ccbq.queue.qfrozen_cnt) { 4558 #ifdef INVARIANTS 4559 printf("xpt_release_devq(): requested %u > present %u\n", 4560 count, dev->ccbq.queue.qfrozen_cnt); 4561 #endif 4562 count = dev->ccbq.queue.qfrozen_cnt; 4563 } 4564 dev->ccbq.queue.qfrozen_cnt -= count; 4565 if (dev->ccbq.queue.qfrozen_cnt == 0) { 4566 /* 4567 * No longer need to wait for a successful 4568 * command completion. 4569 */ 4570 dev->flags &= ~CAM_DEV_REL_ON_COMPLETE; 4571 /* 4572 * Remove any timeouts that might be scheduled 4573 * to release this queue. 4574 */ 4575 if ((dev->flags & CAM_DEV_REL_TIMEOUT_PENDING) != 0) { 4576 callout_stop(&dev->callout); 4577 dev->flags &= ~CAM_DEV_REL_TIMEOUT_PENDING; 4578 } 4579 /* 4580 * Now that we are unfrozen schedule the 4581 * device so any pending transactions are 4582 * run. 4583 */ 4584 xpt_schedule_devq(dev->sim->devq, dev); 4585 } else 4586 run_queue = 0; 4587 return (run_queue); 4588 } 4589 4590 void 4591 xpt_release_simq(struct cam_sim *sim, int run_queue) 4592 { 4593 struct cam_devq *devq; 4594 4595 devq = sim->devq; 4596 mtx_lock(&devq->send_mtx); 4597 if (devq->send_queue.qfrozen_cnt <= 0) { 4598 #ifdef INVARIANTS 4599 printf("xpt_release_simq: requested 1 > present %u\n", 4600 devq->send_queue.qfrozen_cnt); 4601 #endif 4602 } else 4603 devq->send_queue.qfrozen_cnt--; 4604 if (devq->send_queue.qfrozen_cnt == 0) { 4605 /* 4606 * If there is a timeout scheduled to release this 4607 * sim queue, remove it. The queue frozen count is 4608 * already at 0. 4609 */ 4610 if ((sim->flags & CAM_SIM_REL_TIMEOUT_PENDING) != 0){ 4611 callout_stop(&sim->callout); 4612 sim->flags &= ~CAM_SIM_REL_TIMEOUT_PENDING; 4613 } 4614 if (run_queue) { 4615 /* 4616 * Now that we are unfrozen run the send queue. 4617 */ 4618 xpt_run_devq(sim->devq); 4619 } 4620 } 4621 mtx_unlock(&devq->send_mtx); 4622 } 4623 4624 void 4625 xpt_done(union ccb *done_ccb) 4626 { 4627 struct cam_doneq *queue; 4628 int run, hash; 4629 4630 #if defined(BUF_TRACKING) || defined(FULL_BUF_TRACKING) 4631 if (done_ccb->ccb_h.func_code == XPT_SCSI_IO && 4632 done_ccb->csio.bio != NULL) 4633 biotrack(done_ccb->csio.bio, __func__); 4634 #endif 4635 4636 CAM_DEBUG(done_ccb->ccb_h.path, CAM_DEBUG_TRACE, 4637 ("xpt_done: func= %#x %s status %#x\n", 4638 done_ccb->ccb_h.func_code, 4639 xpt_action_name(done_ccb->ccb_h.func_code), 4640 done_ccb->ccb_h.status)); 4641 if ((done_ccb->ccb_h.func_code & XPT_FC_QUEUED) == 0) 4642 return; 4643 4644 /* Store the time the ccb was in the sim */ 4645 done_ccb->ccb_h.qos.periph_data = cam_iosched_delta_t(done_ccb->ccb_h.qos.periph_data); 4646 hash = (done_ccb->ccb_h.path_id + done_ccb->ccb_h.target_id + 4647 done_ccb->ccb_h.target_lun) % cam_num_doneqs; 4648 queue = &cam_doneqs[hash]; 4649 mtx_lock(&queue->cam_doneq_mtx); 4650 run = (queue->cam_doneq_sleep && STAILQ_EMPTY(&queue->cam_doneq)); 4651 STAILQ_INSERT_TAIL(&queue->cam_doneq, &done_ccb->ccb_h, sim_links.stqe); 4652 done_ccb->ccb_h.pinfo.index = CAM_DONEQ_INDEX; 4653 mtx_unlock(&queue->cam_doneq_mtx); 4654 if (run) 4655 wakeup(&queue->cam_doneq); 4656 } 4657 4658 void 4659 xpt_done_direct(union ccb *done_ccb) 4660 { 4661 4662 CAM_DEBUG(done_ccb->ccb_h.path, CAM_DEBUG_TRACE, 4663 ("xpt_done_direct: status %#x\n", done_ccb->ccb_h.status)); 4664 if ((done_ccb->ccb_h.func_code & XPT_FC_QUEUED) == 0) 4665 return; 4666 4667 /* Store the time the ccb was in the sim */ 4668 done_ccb->ccb_h.qos.periph_data = cam_iosched_delta_t(done_ccb->ccb_h.qos.periph_data); 4669 xpt_done_process(&done_ccb->ccb_h); 4670 } 4671 4672 union ccb * 4673 xpt_alloc_ccb() 4674 { 4675 union ccb *new_ccb; 4676 4677 new_ccb = malloc(sizeof(*new_ccb), M_CAMCCB, M_ZERO|M_WAITOK); 4678 return (new_ccb); 4679 } 4680 4681 union ccb * 4682 xpt_alloc_ccb_nowait() 4683 { 4684 union ccb *new_ccb; 4685 4686 new_ccb = malloc(sizeof(*new_ccb), M_CAMCCB, M_ZERO|M_NOWAIT); 4687 return (new_ccb); 4688 } 4689 4690 void 4691 xpt_free_ccb(union ccb *free_ccb) 4692 { 4693 free(free_ccb, M_CAMCCB); 4694 } 4695 4696 4697 4698 /* Private XPT functions */ 4699 4700 /* 4701 * Get a CAM control block for the caller. Charge the structure to the device 4702 * referenced by the path. If we don't have sufficient resources to allocate 4703 * more ccbs, we return NULL. 4704 */ 4705 static union ccb * 4706 xpt_get_ccb_nowait(struct cam_periph *periph) 4707 { 4708 union ccb *new_ccb; 4709 4710 new_ccb = malloc(sizeof(*new_ccb), M_CAMCCB, M_ZERO|M_NOWAIT); 4711 if (new_ccb == NULL) 4712 return (NULL); 4713 periph->periph_allocated++; 4714 cam_ccbq_take_opening(&periph->path->device->ccbq); 4715 return (new_ccb); 4716 } 4717 4718 static union ccb * 4719 xpt_get_ccb(struct cam_periph *periph) 4720 { 4721 union ccb *new_ccb; 4722 4723 cam_periph_unlock(periph); 4724 new_ccb = malloc(sizeof(*new_ccb), M_CAMCCB, M_ZERO|M_WAITOK); 4725 cam_periph_lock(periph); 4726 periph->periph_allocated++; 4727 cam_ccbq_take_opening(&periph->path->device->ccbq); 4728 return (new_ccb); 4729 } 4730 4731 union ccb * 4732 cam_periph_getccb(struct cam_periph *periph, u_int32_t priority) 4733 { 4734 struct ccb_hdr *ccb_h; 4735 4736 CAM_DEBUG(periph->path, CAM_DEBUG_TRACE, ("cam_periph_getccb\n")); 4737 cam_periph_assert(periph, MA_OWNED); 4738 while ((ccb_h = SLIST_FIRST(&periph->ccb_list)) == NULL || 4739 ccb_h->pinfo.priority != priority) { 4740 if (priority < periph->immediate_priority) { 4741 periph->immediate_priority = priority; 4742 xpt_run_allocq(periph, 0); 4743 } else 4744 cam_periph_sleep(periph, &periph->ccb_list, PRIBIO, 4745 "cgticb", 0); 4746 } 4747 SLIST_REMOVE_HEAD(&periph->ccb_list, periph_links.sle); 4748 return ((union ccb *)ccb_h); 4749 } 4750 4751 static void 4752 xpt_acquire_bus(struct cam_eb *bus) 4753 { 4754 4755 xpt_lock_buses(); 4756 bus->refcount++; 4757 xpt_unlock_buses(); 4758 } 4759 4760 static void 4761 xpt_release_bus(struct cam_eb *bus) 4762 { 4763 4764 xpt_lock_buses(); 4765 KASSERT(bus->refcount >= 1, ("bus->refcount >= 1")); 4766 if (--bus->refcount > 0) { 4767 xpt_unlock_buses(); 4768 return; 4769 } 4770 TAILQ_REMOVE(&xsoftc.xpt_busses, bus, links); 4771 xsoftc.bus_generation++; 4772 xpt_unlock_buses(); 4773 KASSERT(TAILQ_EMPTY(&bus->et_entries), 4774 ("destroying bus, but target list is not empty")); 4775 cam_sim_release(bus->sim); 4776 mtx_destroy(&bus->eb_mtx); 4777 free(bus, M_CAMXPT); 4778 } 4779 4780 static struct cam_et * 4781 xpt_alloc_target(struct cam_eb *bus, target_id_t target_id) 4782 { 4783 struct cam_et *cur_target, *target; 4784 4785 mtx_assert(&xsoftc.xpt_topo_lock, MA_OWNED); 4786 mtx_assert(&bus->eb_mtx, MA_OWNED); 4787 target = (struct cam_et *)malloc(sizeof(*target), M_CAMXPT, 4788 M_NOWAIT|M_ZERO); 4789 if (target == NULL) 4790 return (NULL); 4791 4792 TAILQ_INIT(&target->ed_entries); 4793 target->bus = bus; 4794 target->target_id = target_id; 4795 target->refcount = 1; 4796 target->generation = 0; 4797 target->luns = NULL; 4798 mtx_init(&target->luns_mtx, "CAM LUNs lock", NULL, MTX_DEF); 4799 timevalclear(&target->last_reset); 4800 /* 4801 * Hold a reference to our parent bus so it 4802 * will not go away before we do. 4803 */ 4804 bus->refcount++; 4805 4806 /* Insertion sort into our bus's target list */ 4807 cur_target = TAILQ_FIRST(&bus->et_entries); 4808 while (cur_target != NULL && cur_target->target_id < target_id) 4809 cur_target = TAILQ_NEXT(cur_target, links); 4810 if (cur_target != NULL) { 4811 TAILQ_INSERT_BEFORE(cur_target, target, links); 4812 } else { 4813 TAILQ_INSERT_TAIL(&bus->et_entries, target, links); 4814 } 4815 bus->generation++; 4816 return (target); 4817 } 4818 4819 static void 4820 xpt_acquire_target(struct cam_et *target) 4821 { 4822 struct cam_eb *bus = target->bus; 4823 4824 mtx_lock(&bus->eb_mtx); 4825 target->refcount++; 4826 mtx_unlock(&bus->eb_mtx); 4827 } 4828 4829 static void 4830 xpt_release_target(struct cam_et *target) 4831 { 4832 struct cam_eb *bus = target->bus; 4833 4834 mtx_lock(&bus->eb_mtx); 4835 if (--target->refcount > 0) { 4836 mtx_unlock(&bus->eb_mtx); 4837 return; 4838 } 4839 TAILQ_REMOVE(&bus->et_entries, target, links); 4840 bus->generation++; 4841 mtx_unlock(&bus->eb_mtx); 4842 KASSERT(TAILQ_EMPTY(&target->ed_entries), 4843 ("destroying target, but device list is not empty")); 4844 xpt_release_bus(bus); 4845 mtx_destroy(&target->luns_mtx); 4846 if (target->luns) 4847 free(target->luns, M_CAMXPT); 4848 free(target, M_CAMXPT); 4849 } 4850 4851 static struct cam_ed * 4852 xpt_alloc_device_default(struct cam_eb *bus, struct cam_et *target, 4853 lun_id_t lun_id) 4854 { 4855 struct cam_ed *device; 4856 4857 device = xpt_alloc_device(bus, target, lun_id); 4858 if (device == NULL) 4859 return (NULL); 4860 4861 device->mintags = 1; 4862 device->maxtags = 1; 4863 return (device); 4864 } 4865 4866 static void 4867 xpt_destroy_device(void *context, int pending) 4868 { 4869 struct cam_ed *device = context; 4870 4871 mtx_lock(&device->device_mtx); 4872 mtx_destroy(&device->device_mtx); 4873 free(device, M_CAMDEV); 4874 } 4875 4876 struct cam_ed * 4877 xpt_alloc_device(struct cam_eb *bus, struct cam_et *target, lun_id_t lun_id) 4878 { 4879 struct cam_ed *cur_device, *device; 4880 struct cam_devq *devq; 4881 cam_status status; 4882 4883 mtx_assert(&bus->eb_mtx, MA_OWNED); 4884 /* Make space for us in the device queue on our bus */ 4885 devq = bus->sim->devq; 4886 mtx_lock(&devq->send_mtx); 4887 status = cam_devq_resize(devq, devq->send_queue.array_size + 1); 4888 mtx_unlock(&devq->send_mtx); 4889 if (status != CAM_REQ_CMP) 4890 return (NULL); 4891 4892 device = (struct cam_ed *)malloc(sizeof(*device), 4893 M_CAMDEV, M_NOWAIT|M_ZERO); 4894 if (device == NULL) 4895 return (NULL); 4896 4897 cam_init_pinfo(&device->devq_entry); 4898 device->target = target; 4899 device->lun_id = lun_id; 4900 device->sim = bus->sim; 4901 if (cam_ccbq_init(&device->ccbq, 4902 bus->sim->max_dev_openings) != 0) { 4903 free(device, M_CAMDEV); 4904 return (NULL); 4905 } 4906 SLIST_INIT(&device->asyncs); 4907 SLIST_INIT(&device->periphs); 4908 device->generation = 0; 4909 device->flags = CAM_DEV_UNCONFIGURED; 4910 device->tag_delay_count = 0; 4911 device->tag_saved_openings = 0; 4912 device->refcount = 1; 4913 mtx_init(&device->device_mtx, "CAM device lock", NULL, MTX_DEF); 4914 callout_init_mtx(&device->callout, &devq->send_mtx, 0); 4915 TASK_INIT(&device->device_destroy_task, 0, xpt_destroy_device, device); 4916 /* 4917 * Hold a reference to our parent bus so it 4918 * will not go away before we do. 4919 */ 4920 target->refcount++; 4921 4922 cur_device = TAILQ_FIRST(&target->ed_entries); 4923 while (cur_device != NULL && cur_device->lun_id < lun_id) 4924 cur_device = TAILQ_NEXT(cur_device, links); 4925 if (cur_device != NULL) 4926 TAILQ_INSERT_BEFORE(cur_device, device, links); 4927 else 4928 TAILQ_INSERT_TAIL(&target->ed_entries, device, links); 4929 target->generation++; 4930 return (device); 4931 } 4932 4933 void 4934 xpt_acquire_device(struct cam_ed *device) 4935 { 4936 struct cam_eb *bus = device->target->bus; 4937 4938 mtx_lock(&bus->eb_mtx); 4939 device->refcount++; 4940 mtx_unlock(&bus->eb_mtx); 4941 } 4942 4943 void 4944 xpt_release_device(struct cam_ed *device) 4945 { 4946 struct cam_eb *bus = device->target->bus; 4947 struct cam_devq *devq; 4948 4949 mtx_lock(&bus->eb_mtx); 4950 if (--device->refcount > 0) { 4951 mtx_unlock(&bus->eb_mtx); 4952 return; 4953 } 4954 4955 TAILQ_REMOVE(&device->target->ed_entries, device,links); 4956 device->target->generation++; 4957 mtx_unlock(&bus->eb_mtx); 4958 4959 /* Release our slot in the devq */ 4960 devq = bus->sim->devq; 4961 mtx_lock(&devq->send_mtx); 4962 cam_devq_resize(devq, devq->send_queue.array_size - 1); 4963 mtx_unlock(&devq->send_mtx); 4964 4965 KASSERT(SLIST_EMPTY(&device->periphs), 4966 ("destroying device, but periphs list is not empty")); 4967 KASSERT(device->devq_entry.index == CAM_UNQUEUED_INDEX, 4968 ("destroying device while still queued for ccbs")); 4969 4970 if ((device->flags & CAM_DEV_REL_TIMEOUT_PENDING) != 0) 4971 callout_stop(&device->callout); 4972 4973 xpt_release_target(device->target); 4974 4975 cam_ccbq_fini(&device->ccbq); 4976 /* 4977 * Free allocated memory. free(9) does nothing if the 4978 * supplied pointer is NULL, so it is safe to call without 4979 * checking. 4980 */ 4981 free(device->supported_vpds, M_CAMXPT); 4982 free(device->device_id, M_CAMXPT); 4983 free(device->ext_inq, M_CAMXPT); 4984 free(device->physpath, M_CAMXPT); 4985 free(device->rcap_buf, M_CAMXPT); 4986 free(device->serial_num, M_CAMXPT); 4987 free(device->nvme_data, M_CAMXPT); 4988 free(device->nvme_cdata, M_CAMXPT); 4989 taskqueue_enqueue(xsoftc.xpt_taskq, &device->device_destroy_task); 4990 } 4991 4992 u_int32_t 4993 xpt_dev_ccbq_resize(struct cam_path *path, int newopenings) 4994 { 4995 int result; 4996 struct cam_ed *dev; 4997 4998 dev = path->device; 4999 mtx_lock(&dev->sim->devq->send_mtx); 5000 result = cam_ccbq_resize(&dev->ccbq, newopenings); 5001 mtx_unlock(&dev->sim->devq->send_mtx); 5002 if ((dev->flags & CAM_DEV_TAG_AFTER_COUNT) != 0 5003 || (dev->inq_flags & SID_CmdQue) != 0) 5004 dev->tag_saved_openings = newopenings; 5005 return (result); 5006 } 5007 5008 static struct cam_eb * 5009 xpt_find_bus(path_id_t path_id) 5010 { 5011 struct cam_eb *bus; 5012 5013 xpt_lock_buses(); 5014 for (bus = TAILQ_FIRST(&xsoftc.xpt_busses); 5015 bus != NULL; 5016 bus = TAILQ_NEXT(bus, links)) { 5017 if (bus->path_id == path_id) { 5018 bus->refcount++; 5019 break; 5020 } 5021 } 5022 xpt_unlock_buses(); 5023 return (bus); 5024 } 5025 5026 static struct cam_et * 5027 xpt_find_target(struct cam_eb *bus, target_id_t target_id) 5028 { 5029 struct cam_et *target; 5030 5031 mtx_assert(&bus->eb_mtx, MA_OWNED); 5032 for (target = TAILQ_FIRST(&bus->et_entries); 5033 target != NULL; 5034 target = TAILQ_NEXT(target, links)) { 5035 if (target->target_id == target_id) { 5036 target->refcount++; 5037 break; 5038 } 5039 } 5040 return (target); 5041 } 5042 5043 static struct cam_ed * 5044 xpt_find_device(struct cam_et *target, lun_id_t lun_id) 5045 { 5046 struct cam_ed *device; 5047 5048 mtx_assert(&target->bus->eb_mtx, MA_OWNED); 5049 for (device = TAILQ_FIRST(&target->ed_entries); 5050 device != NULL; 5051 device = TAILQ_NEXT(device, links)) { 5052 if (device->lun_id == lun_id) { 5053 device->refcount++; 5054 break; 5055 } 5056 } 5057 return (device); 5058 } 5059 5060 void 5061 xpt_start_tags(struct cam_path *path) 5062 { 5063 struct ccb_relsim crs; 5064 struct cam_ed *device; 5065 struct cam_sim *sim; 5066 int newopenings; 5067 5068 device = path->device; 5069 sim = path->bus->sim; 5070 device->flags &= ~CAM_DEV_TAG_AFTER_COUNT; 5071 xpt_freeze_devq(path, /*count*/1); 5072 device->inq_flags |= SID_CmdQue; 5073 if (device->tag_saved_openings != 0) 5074 newopenings = device->tag_saved_openings; 5075 else 5076 newopenings = min(device->maxtags, 5077 sim->max_tagged_dev_openings); 5078 xpt_dev_ccbq_resize(path, newopenings); 5079 xpt_async(AC_GETDEV_CHANGED, path, NULL); 5080 xpt_setup_ccb(&crs.ccb_h, path, CAM_PRIORITY_NORMAL); 5081 crs.ccb_h.func_code = XPT_REL_SIMQ; 5082 crs.release_flags = RELSIM_RELEASE_AFTER_QEMPTY; 5083 crs.openings 5084 = crs.release_timeout 5085 = crs.qfrozen_cnt 5086 = 0; 5087 xpt_action((union ccb *)&crs); 5088 } 5089 5090 void 5091 xpt_stop_tags(struct cam_path *path) 5092 { 5093 struct ccb_relsim crs; 5094 struct cam_ed *device; 5095 struct cam_sim *sim; 5096 5097 device = path->device; 5098 sim = path->bus->sim; 5099 device->flags &= ~CAM_DEV_TAG_AFTER_COUNT; 5100 device->tag_delay_count = 0; 5101 xpt_freeze_devq(path, /*count*/1); 5102 device->inq_flags &= ~SID_CmdQue; 5103 xpt_dev_ccbq_resize(path, sim->max_dev_openings); 5104 xpt_async(AC_GETDEV_CHANGED, path, NULL); 5105 xpt_setup_ccb(&crs.ccb_h, path, CAM_PRIORITY_NORMAL); 5106 crs.ccb_h.func_code = XPT_REL_SIMQ; 5107 crs.release_flags = RELSIM_RELEASE_AFTER_QEMPTY; 5108 crs.openings 5109 = crs.release_timeout 5110 = crs.qfrozen_cnt 5111 = 0; 5112 xpt_action((union ccb *)&crs); 5113 } 5114 5115 /* 5116 * Assume all possible buses are detected by this time, so allow boot 5117 * as soon as they all are scanned. 5118 */ 5119 static void 5120 xpt_boot_delay(void *arg) 5121 { 5122 5123 xpt_release_boot(); 5124 } 5125 5126 /* 5127 * Now that all config hooks have completed, start boot_delay timer, 5128 * waiting for possibly still undetected buses (USB) to appear. 5129 */ 5130 static void 5131 xpt_ch_done(void *arg) 5132 { 5133 5134 callout_init(&xsoftc.boot_callout, 1); 5135 callout_reset_sbt(&xsoftc.boot_callout, SBT_1MS * xsoftc.boot_delay, 0, 5136 xpt_boot_delay, NULL, 0); 5137 } 5138 SYSINIT(xpt_hw_delay, SI_SUB_INT_CONFIG_HOOKS, SI_ORDER_ANY, xpt_ch_done, NULL); 5139 5140 /* 5141 * Now that interrupts are enabled, go find our devices 5142 */ 5143 static void 5144 xpt_config(void *arg) 5145 { 5146 if (taskqueue_start_threads(&xsoftc.xpt_taskq, 1, PRIBIO, "CAM taskq")) 5147 printf("xpt_config: failed to create taskqueue thread.\n"); 5148 5149 /* Setup debugging path */ 5150 if (cam_dflags != CAM_DEBUG_NONE) { 5151 if (xpt_create_path(&cam_dpath, NULL, 5152 CAM_DEBUG_BUS, CAM_DEBUG_TARGET, 5153 CAM_DEBUG_LUN) != CAM_REQ_CMP) { 5154 printf("xpt_config: xpt_create_path() failed for debug" 5155 " target %d:%d:%d, debugging disabled\n", 5156 CAM_DEBUG_BUS, CAM_DEBUG_TARGET, CAM_DEBUG_LUN); 5157 cam_dflags = CAM_DEBUG_NONE; 5158 } 5159 } else 5160 cam_dpath = NULL; 5161 5162 periphdriver_init(1); 5163 xpt_hold_boot(); 5164 5165 /* Fire up rescan thread. */ 5166 if (kproc_kthread_add(xpt_scanner_thread, NULL, &cam_proc, NULL, 0, 0, 5167 "cam", "scanner")) { 5168 printf("xpt_config: failed to create rescan thread.\n"); 5169 } 5170 } 5171 5172 void 5173 xpt_hold_boot_locked(void) 5174 { 5175 5176 if (xsoftc.buses_to_config++ == 0) 5177 root_mount_hold_token("CAM", &xsoftc.xpt_rootmount); 5178 } 5179 5180 void 5181 xpt_hold_boot(void) 5182 { 5183 5184 xpt_lock_buses(); 5185 xpt_hold_boot_locked(); 5186 xpt_unlock_buses(); 5187 } 5188 5189 void 5190 xpt_release_boot(void) 5191 { 5192 5193 xpt_lock_buses(); 5194 if (--xsoftc.buses_to_config == 0) { 5195 if (xsoftc.buses_config_done == 0) { 5196 xsoftc.buses_config_done = 1; 5197 xsoftc.buses_to_config++; 5198 TASK_INIT(&xsoftc.boot_task, 0, xpt_finishconfig_task, 5199 NULL); 5200 taskqueue_enqueue(taskqueue_thread, &xsoftc.boot_task); 5201 } else 5202 root_mount_rel(&xsoftc.xpt_rootmount); 5203 } 5204 xpt_unlock_buses(); 5205 } 5206 5207 /* 5208 * If the given device only has one peripheral attached to it, and if that 5209 * peripheral is the passthrough driver, announce it. This insures that the 5210 * user sees some sort of announcement for every peripheral in their system. 5211 */ 5212 static int 5213 xptpassannouncefunc(struct cam_ed *device, void *arg) 5214 { 5215 struct cam_periph *periph; 5216 int i; 5217 5218 for (periph = SLIST_FIRST(&device->periphs), i = 0; periph != NULL; 5219 periph = SLIST_NEXT(periph, periph_links), i++); 5220 5221 periph = SLIST_FIRST(&device->periphs); 5222 if ((i == 1) 5223 && (strncmp(periph->periph_name, "pass", 4) == 0)) 5224 xpt_announce_periph(periph, NULL); 5225 5226 return(1); 5227 } 5228 5229 static void 5230 xpt_finishconfig_task(void *context, int pending) 5231 { 5232 5233 periphdriver_init(2); 5234 /* 5235 * Check for devices with no "standard" peripheral driver 5236 * attached. For any devices like that, announce the 5237 * passthrough driver so the user will see something. 5238 */ 5239 if (!bootverbose) 5240 xpt_for_all_devices(xptpassannouncefunc, NULL); 5241 5242 xpt_release_boot(); 5243 } 5244 5245 cam_status 5246 xpt_register_async(int event, ac_callback_t *cbfunc, void *cbarg, 5247 struct cam_path *path) 5248 { 5249 struct ccb_setasync csa; 5250 cam_status status; 5251 int xptpath = 0; 5252 5253 if (path == NULL) { 5254 status = xpt_create_path(&path, /*periph*/NULL, CAM_XPT_PATH_ID, 5255 CAM_TARGET_WILDCARD, CAM_LUN_WILDCARD); 5256 if (status != CAM_REQ_CMP) 5257 return (status); 5258 xpt_path_lock(path); 5259 xptpath = 1; 5260 } 5261 5262 xpt_setup_ccb(&csa.ccb_h, path, CAM_PRIORITY_NORMAL); 5263 csa.ccb_h.func_code = XPT_SASYNC_CB; 5264 csa.event_enable = event; 5265 csa.callback = cbfunc; 5266 csa.callback_arg = cbarg; 5267 xpt_action((union ccb *)&csa); 5268 status = csa.ccb_h.status; 5269 5270 CAM_DEBUG(csa.ccb_h.path, CAM_DEBUG_TRACE, 5271 ("xpt_register_async: func %p\n", cbfunc)); 5272 5273 if (xptpath) { 5274 xpt_path_unlock(path); 5275 xpt_free_path(path); 5276 } 5277 5278 if ((status == CAM_REQ_CMP) && 5279 (csa.event_enable & AC_FOUND_DEVICE)) { 5280 /* 5281 * Get this peripheral up to date with all 5282 * the currently existing devices. 5283 */ 5284 xpt_for_all_devices(xptsetasyncfunc, &csa); 5285 } 5286 if ((status == CAM_REQ_CMP) && 5287 (csa.event_enable & AC_PATH_REGISTERED)) { 5288 /* 5289 * Get this peripheral up to date with all 5290 * the currently existing buses. 5291 */ 5292 xpt_for_all_busses(xptsetasyncbusfunc, &csa); 5293 } 5294 5295 return (status); 5296 } 5297 5298 static void 5299 xptaction(struct cam_sim *sim, union ccb *work_ccb) 5300 { 5301 CAM_DEBUG(work_ccb->ccb_h.path, CAM_DEBUG_TRACE, ("xptaction\n")); 5302 5303 switch (work_ccb->ccb_h.func_code) { 5304 /* Common cases first */ 5305 case XPT_PATH_INQ: /* Path routing inquiry */ 5306 { 5307 struct ccb_pathinq *cpi; 5308 5309 cpi = &work_ccb->cpi; 5310 cpi->version_num = 1; /* XXX??? */ 5311 cpi->hba_inquiry = 0; 5312 cpi->target_sprt = 0; 5313 cpi->hba_misc = 0; 5314 cpi->hba_eng_cnt = 0; 5315 cpi->max_target = 0; 5316 cpi->max_lun = 0; 5317 cpi->initiator_id = 0; 5318 strlcpy(cpi->sim_vid, "FreeBSD", SIM_IDLEN); 5319 strlcpy(cpi->hba_vid, "", HBA_IDLEN); 5320 strlcpy(cpi->dev_name, sim->sim_name, DEV_IDLEN); 5321 cpi->unit_number = sim->unit_number; 5322 cpi->bus_id = sim->bus_id; 5323 cpi->base_transfer_speed = 0; 5324 cpi->protocol = PROTO_UNSPECIFIED; 5325 cpi->protocol_version = PROTO_VERSION_UNSPECIFIED; 5326 cpi->transport = XPORT_UNSPECIFIED; 5327 cpi->transport_version = XPORT_VERSION_UNSPECIFIED; 5328 cpi->ccb_h.status = CAM_REQ_CMP; 5329 break; 5330 } 5331 default: 5332 work_ccb->ccb_h.status = CAM_REQ_INVALID; 5333 break; 5334 } 5335 xpt_done(work_ccb); 5336 } 5337 5338 /* 5339 * The xpt as a "controller" has no interrupt sources, so polling 5340 * is a no-op. 5341 */ 5342 static void 5343 xptpoll(struct cam_sim *sim) 5344 { 5345 } 5346 5347 void 5348 xpt_lock_buses(void) 5349 { 5350 mtx_lock(&xsoftc.xpt_topo_lock); 5351 } 5352 5353 void 5354 xpt_unlock_buses(void) 5355 { 5356 mtx_unlock(&xsoftc.xpt_topo_lock); 5357 } 5358 5359 struct mtx * 5360 xpt_path_mtx(struct cam_path *path) 5361 { 5362 5363 return (&path->device->device_mtx); 5364 } 5365 5366 static void 5367 xpt_done_process(struct ccb_hdr *ccb_h) 5368 { 5369 struct cam_sim *sim = NULL; 5370 struct cam_devq *devq = NULL; 5371 struct mtx *mtx = NULL; 5372 5373 #if defined(BUF_TRACKING) || defined(FULL_BUF_TRACKING) 5374 struct ccb_scsiio *csio; 5375 5376 if (ccb_h->func_code == XPT_SCSI_IO) { 5377 csio = &((union ccb *)ccb_h)->csio; 5378 if (csio->bio != NULL) 5379 biotrack(csio->bio, __func__); 5380 } 5381 #endif 5382 5383 if (ccb_h->flags & CAM_HIGH_POWER) { 5384 struct highpowerlist *hphead; 5385 struct cam_ed *device; 5386 5387 mtx_lock(&xsoftc.xpt_highpower_lock); 5388 hphead = &xsoftc.highpowerq; 5389 5390 device = STAILQ_FIRST(hphead); 5391 5392 /* 5393 * Increment the count since this command is done. 5394 */ 5395 xsoftc.num_highpower++; 5396 5397 /* 5398 * Any high powered commands queued up? 5399 */ 5400 if (device != NULL) { 5401 5402 STAILQ_REMOVE_HEAD(hphead, highpowerq_entry); 5403 mtx_unlock(&xsoftc.xpt_highpower_lock); 5404 5405 mtx_lock(&device->sim->devq->send_mtx); 5406 xpt_release_devq_device(device, 5407 /*count*/1, /*runqueue*/TRUE); 5408 mtx_unlock(&device->sim->devq->send_mtx); 5409 } else 5410 mtx_unlock(&xsoftc.xpt_highpower_lock); 5411 } 5412 5413 /* 5414 * Insulate against a race where the periph is destroyed but CCBs are 5415 * still not all processed. This shouldn't happen, but allows us better 5416 * bug diagnostic when it does. 5417 */ 5418 if (ccb_h->path->bus) 5419 sim = ccb_h->path->bus->sim; 5420 5421 if (ccb_h->status & CAM_RELEASE_SIMQ) { 5422 KASSERT(sim, ("sim missing for CAM_RELEASE_SIMQ request")); 5423 xpt_release_simq(sim, /*run_queue*/FALSE); 5424 ccb_h->status &= ~CAM_RELEASE_SIMQ; 5425 } 5426 5427 if ((ccb_h->flags & CAM_DEV_QFRZDIS) 5428 && (ccb_h->status & CAM_DEV_QFRZN)) { 5429 xpt_release_devq(ccb_h->path, /*count*/1, /*run_queue*/TRUE); 5430 ccb_h->status &= ~CAM_DEV_QFRZN; 5431 } 5432 5433 if ((ccb_h->func_code & XPT_FC_USER_CCB) == 0) { 5434 struct cam_ed *dev = ccb_h->path->device; 5435 5436 if (sim) 5437 devq = sim->devq; 5438 KASSERT(devq, ("Periph disappeared with request pending.")); 5439 5440 mtx_lock(&devq->send_mtx); 5441 devq->send_active--; 5442 devq->send_openings++; 5443 cam_ccbq_ccb_done(&dev->ccbq, (union ccb *)ccb_h); 5444 5445 if (((dev->flags & CAM_DEV_REL_ON_QUEUE_EMPTY) != 0 5446 && (dev->ccbq.dev_active == 0))) { 5447 dev->flags &= ~CAM_DEV_REL_ON_QUEUE_EMPTY; 5448 xpt_release_devq_device(dev, /*count*/1, 5449 /*run_queue*/FALSE); 5450 } 5451 5452 if (((dev->flags & CAM_DEV_REL_ON_COMPLETE) != 0 5453 && (ccb_h->status&CAM_STATUS_MASK) != CAM_REQUEUE_REQ)) { 5454 dev->flags &= ~CAM_DEV_REL_ON_COMPLETE; 5455 xpt_release_devq_device(dev, /*count*/1, 5456 /*run_queue*/FALSE); 5457 } 5458 5459 if (!device_is_queued(dev)) 5460 (void)xpt_schedule_devq(devq, dev); 5461 xpt_run_devq(devq); 5462 mtx_unlock(&devq->send_mtx); 5463 5464 if ((dev->flags & CAM_DEV_TAG_AFTER_COUNT) != 0) { 5465 mtx = xpt_path_mtx(ccb_h->path); 5466 mtx_lock(mtx); 5467 5468 if ((dev->flags & CAM_DEV_TAG_AFTER_COUNT) != 0 5469 && (--dev->tag_delay_count == 0)) 5470 xpt_start_tags(ccb_h->path); 5471 } 5472 } 5473 5474 if ((ccb_h->flags & CAM_UNLOCKED) == 0) { 5475 if (mtx == NULL) { 5476 mtx = xpt_path_mtx(ccb_h->path); 5477 mtx_lock(mtx); 5478 } 5479 } else { 5480 if (mtx != NULL) { 5481 mtx_unlock(mtx); 5482 mtx = NULL; 5483 } 5484 } 5485 5486 /* Call the peripheral driver's callback */ 5487 ccb_h->pinfo.index = CAM_UNQUEUED_INDEX; 5488 (*ccb_h->cbfcnp)(ccb_h->path->periph, (union ccb *)ccb_h); 5489 if (mtx != NULL) 5490 mtx_unlock(mtx); 5491 } 5492 5493 void 5494 xpt_done_td(void *arg) 5495 { 5496 struct cam_doneq *queue = arg; 5497 struct ccb_hdr *ccb_h; 5498 STAILQ_HEAD(, ccb_hdr) doneq; 5499 5500 STAILQ_INIT(&doneq); 5501 mtx_lock(&queue->cam_doneq_mtx); 5502 while (1) { 5503 while (STAILQ_EMPTY(&queue->cam_doneq)) { 5504 queue->cam_doneq_sleep = 1; 5505 msleep(&queue->cam_doneq, &queue->cam_doneq_mtx, 5506 PRIBIO, "-", 0); 5507 queue->cam_doneq_sleep = 0; 5508 } 5509 STAILQ_CONCAT(&doneq, &queue->cam_doneq); 5510 mtx_unlock(&queue->cam_doneq_mtx); 5511 5512 THREAD_NO_SLEEPING(); 5513 while ((ccb_h = STAILQ_FIRST(&doneq)) != NULL) { 5514 STAILQ_REMOVE_HEAD(&doneq, sim_links.stqe); 5515 xpt_done_process(ccb_h); 5516 } 5517 THREAD_SLEEPING_OK(); 5518 5519 mtx_lock(&queue->cam_doneq_mtx); 5520 } 5521 } 5522 5523 static void 5524 camisr_runqueue(void) 5525 { 5526 struct ccb_hdr *ccb_h; 5527 struct cam_doneq *queue; 5528 int i; 5529 5530 /* Process global queues. */ 5531 for (i = 0; i < cam_num_doneqs; i++) { 5532 queue = &cam_doneqs[i]; 5533 mtx_lock(&queue->cam_doneq_mtx); 5534 while ((ccb_h = STAILQ_FIRST(&queue->cam_doneq)) != NULL) { 5535 STAILQ_REMOVE_HEAD(&queue->cam_doneq, sim_links.stqe); 5536 mtx_unlock(&queue->cam_doneq_mtx); 5537 xpt_done_process(ccb_h); 5538 mtx_lock(&queue->cam_doneq_mtx); 5539 } 5540 mtx_unlock(&queue->cam_doneq_mtx); 5541 } 5542 } 5543 5544 struct kv 5545 { 5546 uint32_t v; 5547 const char *name; 5548 }; 5549 5550 static struct kv map[] = { 5551 { XPT_NOOP, "XPT_NOOP" }, 5552 { XPT_SCSI_IO, "XPT_SCSI_IO" }, 5553 { XPT_GDEV_TYPE, "XPT_GDEV_TYPE" }, 5554 { XPT_GDEVLIST, "XPT_GDEVLIST" }, 5555 { XPT_PATH_INQ, "XPT_PATH_INQ" }, 5556 { XPT_REL_SIMQ, "XPT_REL_SIMQ" }, 5557 { XPT_SASYNC_CB, "XPT_SASYNC_CB" }, 5558 { XPT_SDEV_TYPE, "XPT_SDEV_TYPE" }, 5559 { XPT_SCAN_BUS, "XPT_SCAN_BUS" }, 5560 { XPT_DEV_MATCH, "XPT_DEV_MATCH" }, 5561 { XPT_DEBUG, "XPT_DEBUG" }, 5562 { XPT_PATH_STATS, "XPT_PATH_STATS" }, 5563 { XPT_GDEV_STATS, "XPT_GDEV_STATS" }, 5564 { XPT_DEV_ADVINFO, "XPT_DEV_ADVINFO" }, 5565 { XPT_ASYNC, "XPT_ASYNC" }, 5566 { XPT_ABORT, "XPT_ABORT" }, 5567 { XPT_RESET_BUS, "XPT_RESET_BUS" }, 5568 { XPT_RESET_DEV, "XPT_RESET_DEV" }, 5569 { XPT_TERM_IO, "XPT_TERM_IO" }, 5570 { XPT_SCAN_LUN, "XPT_SCAN_LUN" }, 5571 { XPT_GET_TRAN_SETTINGS, "XPT_GET_TRAN_SETTINGS" }, 5572 { XPT_SET_TRAN_SETTINGS, "XPT_SET_TRAN_SETTINGS" }, 5573 { XPT_CALC_GEOMETRY, "XPT_CALC_GEOMETRY" }, 5574 { XPT_ATA_IO, "XPT_ATA_IO" }, 5575 { XPT_GET_SIM_KNOB, "XPT_GET_SIM_KNOB" }, 5576 { XPT_SET_SIM_KNOB, "XPT_SET_SIM_KNOB" }, 5577 { XPT_NVME_IO, "XPT_NVME_IO" }, 5578 { XPT_MMC_IO, "XPT_MMC_IO" }, 5579 { XPT_SMP_IO, "XPT_SMP_IO" }, 5580 { XPT_SCAN_TGT, "XPT_SCAN_TGT" }, 5581 { XPT_NVME_ADMIN, "XPT_NVME_ADMIN" }, 5582 { XPT_ENG_INQ, "XPT_ENG_INQ" }, 5583 { XPT_ENG_EXEC, "XPT_ENG_EXEC" }, 5584 { XPT_EN_LUN, "XPT_EN_LUN" }, 5585 { XPT_TARGET_IO, "XPT_TARGET_IO" }, 5586 { XPT_ACCEPT_TARGET_IO, "XPT_ACCEPT_TARGET_IO" }, 5587 { XPT_CONT_TARGET_IO, "XPT_CONT_TARGET_IO" }, 5588 { XPT_IMMED_NOTIFY, "XPT_IMMED_NOTIFY" }, 5589 { XPT_NOTIFY_ACK, "XPT_NOTIFY_ACK" }, 5590 { XPT_IMMEDIATE_NOTIFY, "XPT_IMMEDIATE_NOTIFY" }, 5591 { XPT_NOTIFY_ACKNOWLEDGE, "XPT_NOTIFY_ACKNOWLEDGE" }, 5592 { 0, 0 } 5593 }; 5594 5595 const char * 5596 xpt_action_name(uint32_t action) 5597 { 5598 static char buffer[32]; /* Only for unknown messages -- racy */ 5599 struct kv *walker = map; 5600 5601 while (walker->name != NULL) { 5602 if (walker->v == action) 5603 return (walker->name); 5604 walker++; 5605 } 5606 5607 snprintf(buffer, sizeof(buffer), "%#x", action); 5608 return (buffer); 5609 } 5610