2 * Common functions for CAM "type" (peripheral) drivers.
4 * Copyright (c) 1997, 1998 Justin T. Gibbs.
5 * Copyright (c) 1997, 1998, 1999, 2000 Kenneth D. Merry.
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
11 * 1. Redistributions of source code must retain the above copyright
12 * notice, this list of conditions, and the following disclaimer,
13 * without modification, immediately at the beginning of the file.
14 * 2. The name of the author may not be used to endorse or promote products
15 * derived from this software without specific prior written permission.
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
18 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR
21 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30 #include <sys/cdefs.h>
31 __FBSDID("$FreeBSD$");
33 #include <sys/param.h>
34 #include <sys/systm.h>
35 #include <sys/types.h>
36 #include <sys/malloc.h>
37 #include <sys/kernel.h>
40 #include <sys/mutex.h>
43 #include <sys/devicestat.h>
47 #include <vm/vm_extern.h>
50 #include <cam/cam_ccb.h>
51 #include <cam/cam_queue.h>
52 #include <cam/cam_xpt_periph.h>
53 #include <cam/cam_periph.h>
54 #include <cam/cam_debug.h>
55 #include <cam/cam_sim.h>
57 #include <cam/scsi/scsi_all.h>
58 #include <cam/scsi/scsi_message.h>
59 #include <cam/scsi/scsi_pass.h>
61 static u_int camperiphnextunit(struct periph_driver *p_drv,
62 u_int newunit, int wired,
63 path_id_t pathid, target_id_t target,
65 static u_int camperiphunit(struct periph_driver *p_drv,
66 path_id_t pathid, target_id_t target,
68 static void camperiphdone(struct cam_periph *periph,
70 static void camperiphfree(struct cam_periph *periph);
71 static int camperiphscsistatuserror(union ccb *ccb,
74 u_int32_t sense_flags,
76 u_int32_t *relsim_flags,
79 const char **action_string);
80 static int camperiphscsisenseerror(union ccb *ccb,
83 u_int32_t sense_flags,
85 u_int32_t *relsim_flags,
88 const char **action_string);
90 static int nperiph_drivers;
91 static int initialized = 0;
92 struct periph_driver **periph_drivers;
94 static MALLOC_DEFINE(M_CAMPERIPH, "CAM periph", "CAM peripheral buffers");
96 static int periph_selto_delay = 1000;
97 TUNABLE_INT("kern.cam.periph_selto_delay", &periph_selto_delay);
98 static int periph_noresrc_delay = 500;
99 TUNABLE_INT("kern.cam.periph_noresrc_delay", &periph_noresrc_delay);
100 static int periph_busy_delay = 500;
101 TUNABLE_INT("kern.cam.periph_busy_delay", &periph_busy_delay);
105 periphdriver_register(void *data)
107 struct periph_driver *drv = (struct periph_driver *)data;
108 struct periph_driver **newdrivers, **old;
111 ndrivers = nperiph_drivers + 2;
112 newdrivers = malloc(sizeof(*newdrivers) * ndrivers, M_CAMPERIPH,
115 bcopy(periph_drivers, newdrivers,
116 sizeof(*newdrivers) * nperiph_drivers);
117 newdrivers[nperiph_drivers] = drv;
118 newdrivers[nperiph_drivers + 1] = NULL;
119 old = periph_drivers;
120 periph_drivers = newdrivers;
122 free(old, M_CAMPERIPH);
124 /* If driver marked as early or it is late now, initialize it. */
125 if (((drv->flags & CAM_PERIPH_DRV_EARLY) != 0 && initialized > 0) ||
131 periphdriver_init(int level)
135 initialized = max(initialized, level);
136 for (i = 0; periph_drivers[i] != NULL; i++) {
137 early = (periph_drivers[i]->flags & CAM_PERIPH_DRV_EARLY) ? 1 : 2;
138 if (early == initialized)
139 (*periph_drivers[i]->init)();
144 cam_periph_alloc(periph_ctor_t *periph_ctor,
145 periph_oninv_t *periph_oninvalidate,
146 periph_dtor_t *periph_dtor, periph_start_t *periph_start,
147 char *name, cam_periph_type type, struct cam_path *path,
148 ac_callback_t *ac_callback, ac_code code, void *arg)
150 struct periph_driver **p_drv;
152 struct cam_periph *periph;
153 struct cam_periph *cur_periph;
155 target_id_t target_id;
162 * Handle Hot-Plug scenarios. If there is already a peripheral
163 * of our type assigned to this path, we are likely waiting for
164 * final close on an old, invalidated, peripheral. If this is
165 * the case, queue up a deferred call to the peripheral's async
166 * handler. If it looks like a mistaken re-allocation, complain.
168 if ((periph = cam_periph_find(path, name)) != NULL) {
170 if ((periph->flags & CAM_PERIPH_INVALID) != 0
171 && (periph->flags & CAM_PERIPH_NEW_DEV_FOUND) == 0) {
172 periph->flags |= CAM_PERIPH_NEW_DEV_FOUND;
173 periph->deferred_callback = ac_callback;
174 periph->deferred_ac = code;
175 return (CAM_REQ_INPROG);
177 printf("cam_periph_alloc: attempt to re-allocate "
178 "valid device %s%d rejected flags %#x "
179 "refcount %d\n", periph->periph_name,
180 periph->unit_number, periph->flags,
183 return (CAM_REQ_INVALID);
186 periph = (struct cam_periph *)malloc(sizeof(*periph), M_CAMPERIPH,
190 return (CAM_RESRC_UNAVAIL);
195 sim = xpt_path_sim(path);
196 path_id = xpt_path_path_id(path);
197 target_id = xpt_path_target_id(path);
198 lun_id = xpt_path_lun_id(path);
199 cam_init_pinfo(&periph->pinfo);
200 periph->periph_start = periph_start;
201 periph->periph_dtor = periph_dtor;
202 periph->periph_oninval = periph_oninvalidate;
204 periph->periph_name = name;
205 periph->immediate_priority = CAM_PRIORITY_NONE;
206 periph->refcount = 1; /* Dropped by invalidation. */
208 SLIST_INIT(&periph->ccb_list);
209 status = xpt_create_path(&path, periph, path_id, target_id, lun_id);
210 if (status != CAM_REQ_CMP)
215 for (p_drv = periph_drivers; *p_drv != NULL; p_drv++) {
216 if (strcmp((*p_drv)->driver_name, name) == 0)
219 if (*p_drv == NULL) {
220 printf("cam_periph_alloc: invalid periph name '%s'\n", name);
222 xpt_free_path(periph->path);
223 free(periph, M_CAMPERIPH);
224 return (CAM_REQ_INVALID);
226 periph->unit_number = camperiphunit(*p_drv, path_id, target_id, lun_id);
227 cur_periph = TAILQ_FIRST(&(*p_drv)->units);
228 while (cur_periph != NULL
229 && cur_periph->unit_number < periph->unit_number)
230 cur_periph = TAILQ_NEXT(cur_periph, unit_links);
231 if (cur_periph != NULL) {
232 KASSERT(cur_periph->unit_number != periph->unit_number, ("duplicate units on periph list"));
233 TAILQ_INSERT_BEFORE(cur_periph, periph, unit_links);
235 TAILQ_INSERT_TAIL(&(*p_drv)->units, periph, unit_links);
236 (*p_drv)->generation++;
242 status = xpt_add_periph(periph);
243 if (status != CAM_REQ_CMP)
247 CAM_DEBUG(periph->path, CAM_DEBUG_INFO, ("Periph created\n"));
249 status = periph_ctor(periph, arg);
251 if (status == CAM_REQ_CMP)
255 switch (init_level) {
257 /* Initialized successfully */
260 CAM_DEBUG(periph->path, CAM_DEBUG_INFO, ("Periph destroyed\n"));
261 xpt_remove_periph(periph, /*topology_lock_held*/ 0);
265 TAILQ_REMOVE(&(*p_drv)->units, periph, unit_links);
267 xpt_free_path(periph->path);
270 free(periph, M_CAMPERIPH);
273 /* No cleanup to perform. */
276 panic("%s: Unknown init level", __func__);
282 * Find a peripheral structure with the specified path, target, lun,
283 * and (optionally) type. If the name is NULL, this function will return
284 * the first peripheral driver that matches the specified path.
287 cam_periph_find(struct cam_path *path, char *name)
289 struct periph_driver **p_drv;
290 struct cam_periph *periph;
293 for (p_drv = periph_drivers; *p_drv != NULL; p_drv++) {
295 if (name != NULL && (strcmp((*p_drv)->driver_name, name) != 0))
298 TAILQ_FOREACH(periph, &(*p_drv)->units, unit_links) {
299 if (xpt_path_comp(periph->path, path) == 0) {
301 mtx_assert(periph->sim->mtx, MA_OWNED);
315 * Find peripheral driver instances attached to the specified path.
318 cam_periph_list(struct cam_path *path, struct sbuf *sb)
320 struct sbuf local_sb;
321 struct periph_driver **p_drv;
322 struct cam_periph *periph;
328 sbuf_new(&local_sb, NULL, sbuf_alloc_len, SBUF_FIXEDLEN);
331 for (p_drv = periph_drivers; *p_drv != NULL; p_drv++) {
333 TAILQ_FOREACH(periph, &(*p_drv)->units, unit_links) {
334 if (xpt_path_comp(periph->path, path) != 0)
337 if (sbuf_len(&local_sb) != 0)
338 sbuf_cat(&local_sb, ",");
340 sbuf_printf(&local_sb, "%s%d", periph->periph_name,
341 periph->unit_number);
343 if (sbuf_error(&local_sb) == ENOMEM) {
346 sbuf_delete(&local_sb);
353 sbuf_finish(&local_sb);
354 sbuf_cpy(sb, sbuf_data(&local_sb));
355 sbuf_delete(&local_sb);
360 cam_periph_acquire(struct cam_periph *periph)
364 status = CAM_REQ_CMP_ERR;
369 if ((periph->flags & CAM_PERIPH_INVALID) == 0) {
371 status = CAM_REQ_CMP;
379 cam_periph_release_locked_buses(struct cam_periph *periph)
382 mtx_assert(periph->sim->mtx, MA_OWNED);
383 KASSERT(periph->refcount >= 1, ("periph->refcount >= 1"));
384 if (--periph->refcount == 0)
385 camperiphfree(periph);
389 cam_periph_release_locked(struct cam_periph *periph)
396 cam_periph_release_locked_buses(periph);
401 cam_periph_release(struct cam_periph *periph)
409 mtx_assert(sim->mtx, MA_NOTOWNED);
411 cam_periph_release_locked(periph);
412 mtx_unlock(sim->mtx);
416 cam_periph_hold(struct cam_periph *periph, int priority)
421 * Increment the reference count on the peripheral
422 * while we wait for our lock attempt to succeed
423 * to ensure the peripheral doesn't disappear out
424 * from user us while we sleep.
427 if (cam_periph_acquire(periph) != CAM_REQ_CMP)
430 mtx_assert(periph->sim->mtx, MA_OWNED);
431 while ((periph->flags & CAM_PERIPH_LOCKED) != 0) {
432 periph->flags |= CAM_PERIPH_LOCK_WANTED;
433 if ((error = mtx_sleep(periph, periph->sim->mtx, priority,
434 "caplck", 0)) != 0) {
435 cam_periph_release_locked(periph);
438 if (periph->flags & CAM_PERIPH_INVALID) {
439 cam_periph_release_locked(periph);
444 periph->flags |= CAM_PERIPH_LOCKED;
449 cam_periph_unhold(struct cam_periph *periph)
452 mtx_assert(periph->sim->mtx, MA_OWNED);
454 periph->flags &= ~CAM_PERIPH_LOCKED;
455 if ((periph->flags & CAM_PERIPH_LOCK_WANTED) != 0) {
456 periph->flags &= ~CAM_PERIPH_LOCK_WANTED;
460 cam_periph_release_locked(periph);
464 * Look for the next unit number that is not currently in use for this
465 * peripheral type starting at "newunit". Also exclude unit numbers that
466 * are reserved by for future "hardwiring" unless we already know that this
467 * is a potential wired device. Only assume that the device is "wired" the
468 * first time through the loop since after that we'll be looking at unit
469 * numbers that did not match a wiring entry.
472 camperiphnextunit(struct periph_driver *p_drv, u_int newunit, int wired,
473 path_id_t pathid, target_id_t target, lun_id_t lun)
475 struct cam_periph *periph;
477 int i, val, dunit, r;
478 const char *dname, *strval;
480 periph_name = p_drv->driver_name;
483 for (periph = TAILQ_FIRST(&p_drv->units);
484 periph != NULL && periph->unit_number != newunit;
485 periph = TAILQ_NEXT(periph, unit_links))
488 if (periph != NULL && periph->unit_number == newunit) {
490 xpt_print(periph->path, "Duplicate Wired "
492 xpt_print(periph->path, "Second device (%s "
493 "device at scbus%d target %d lun %d) will "
494 "not be wired\n", periph_name, pathid,
504 * Don't match entries like "da 4" as a wired down
505 * device, but do match entries like "da 4 target 5"
506 * or even "da 4 scbus 1".
511 r = resource_find_dev(&i, dname, &dunit, NULL, NULL);
514 /* if no "target" and no specific scbus, skip */
515 if (resource_int_value(dname, dunit, "target", &val) &&
516 (resource_string_value(dname, dunit, "at",&strval)||
517 strcmp(strval, "scbus") == 0))
519 if (newunit == dunit)
529 camperiphunit(struct periph_driver *p_drv, path_id_t pathid,
530 target_id_t target, lun_id_t lun)
533 int wired, i, val, dunit;
534 const char *dname, *strval;
535 char pathbuf[32], *periph_name;
537 periph_name = p_drv->driver_name;
538 snprintf(pathbuf, sizeof(pathbuf), "scbus%d", pathid);
542 for (wired = 0; resource_find_dev(&i, dname, &dunit, NULL, NULL) == 0;
544 if (resource_string_value(dname, dunit, "at", &strval) == 0) {
545 if (strcmp(strval, pathbuf) != 0)
549 if (resource_int_value(dname, dunit, "target", &val) == 0) {
554 if (resource_int_value(dname, dunit, "lun", &val) == 0) {
566 * Either start from 0 looking for the next unit or from
567 * the unit number given in the resource config. This way,
568 * if we have wildcard matches, we don't return the same
571 unit = camperiphnextunit(p_drv, unit, wired, pathid, target, lun);
577 cam_periph_invalidate(struct cam_periph *periph)
580 mtx_assert(periph->sim->mtx, MA_OWNED);
582 * We only call this routine the first time a peripheral is
585 if ((periph->flags & CAM_PERIPH_INVALID) != 0)
588 CAM_DEBUG(periph->path, CAM_DEBUG_INFO, ("Periph invalidated\n"));
589 periph->flags |= CAM_PERIPH_INVALID;
590 periph->flags &= ~CAM_PERIPH_NEW_DEV_FOUND;
591 if (periph->periph_oninval != NULL)
592 periph->periph_oninval(periph);
593 cam_periph_release_locked(periph);
597 camperiphfree(struct cam_periph *periph)
599 struct periph_driver **p_drv;
601 mtx_assert(periph->sim->mtx, MA_OWNED);
602 for (p_drv = periph_drivers; *p_drv != NULL; p_drv++) {
603 if (strcmp((*p_drv)->driver_name, periph->periph_name) == 0)
606 if (*p_drv == NULL) {
607 printf("camperiphfree: attempt to free non-existant periph\n");
612 * We need to set this flag before dropping the topology lock, to
613 * let anyone who is traversing the list that this peripheral is
614 * about to be freed, and there will be no more reference count
617 periph->flags |= CAM_PERIPH_FREE;
620 * The peripheral destructor semantics dictate calling with only the
621 * SIM mutex held. Since it might sleep, it should not be called
622 * with the topology lock held.
627 * We need to call the peripheral destructor prior to removing the
628 * peripheral from the list. Otherwise, we risk running into a
629 * scenario where the peripheral unit number may get reused
630 * (because it has been removed from the list), but some resources
631 * used by the peripheral are still hanging around. In particular,
632 * the devfs nodes used by some peripherals like the pass(4) driver
633 * aren't fully cleaned up until the destructor is run. If the
634 * unit number is reused before the devfs instance is fully gone,
637 if (periph->periph_dtor != NULL)
638 periph->periph_dtor(periph);
641 * The peripheral list is protected by the topology lock.
645 TAILQ_REMOVE(&(*p_drv)->units, periph, unit_links);
646 (*p_drv)->generation++;
648 xpt_remove_periph(periph, /*topology_lock_held*/ 1);
651 CAM_DEBUG(periph->path, CAM_DEBUG_INFO, ("Periph destroyed\n"));
653 if (periph->flags & CAM_PERIPH_NEW_DEV_FOUND) {
657 switch (periph->deferred_ac) {
658 case AC_FOUND_DEVICE:
659 ccb.ccb_h.func_code = XPT_GDEV_TYPE;
660 xpt_setup_ccb(&ccb.ccb_h, periph->path, CAM_PRIORITY_NORMAL);
664 case AC_PATH_REGISTERED:
665 ccb.ccb_h.func_code = XPT_PATH_INQ;
666 xpt_setup_ccb(&ccb.ccb_h, periph->path, CAM_PRIORITY_NORMAL);
674 periph->deferred_callback(NULL, periph->deferred_ac,
677 xpt_free_path(periph->path);
678 free(periph, M_CAMPERIPH);
683 * Map user virtual pointers into kernel virtual address space, so we can
684 * access the memory. This is now a generic function that centralizes most
685 * of the sanity checks on the data flags, if any.
686 * This also only works for up to MAXPHYS memory. Since we use
687 * buffers to map stuff in and out, we're limited to the buffer size.
690 cam_periph_mapmem(union ccb *ccb, struct cam_periph_map_info *mapinfo)
693 int flags[CAM_PERIPH_MAXMAPS];
694 u_int8_t **data_ptrs[CAM_PERIPH_MAXMAPS];
695 u_int32_t lengths[CAM_PERIPH_MAXMAPS];
696 u_int32_t dirs[CAM_PERIPH_MAXMAPS];
697 /* Some controllers may not be able to handle more data. */
698 size_t maxmap = DFLTPHYS;
700 switch(ccb->ccb_h.func_code) {
702 if (ccb->cdm.match_buf_len == 0) {
703 printf("cam_periph_mapmem: invalid match buffer "
707 if (ccb->cdm.pattern_buf_len > 0) {
708 data_ptrs[0] = (u_int8_t **)&ccb->cdm.patterns;
709 lengths[0] = ccb->cdm.pattern_buf_len;
710 dirs[0] = CAM_DIR_OUT;
711 data_ptrs[1] = (u_int8_t **)&ccb->cdm.matches;
712 lengths[1] = ccb->cdm.match_buf_len;
713 dirs[1] = CAM_DIR_IN;
716 data_ptrs[0] = (u_int8_t **)&ccb->cdm.matches;
717 lengths[0] = ccb->cdm.match_buf_len;
718 dirs[0] = CAM_DIR_IN;
722 * This request will not go to the hardware, no reason
723 * to be so strict. vmapbuf() is able to map up to MAXPHYS.
728 case XPT_CONT_TARGET_IO:
729 if ((ccb->ccb_h.flags & CAM_DIR_MASK) == CAM_DIR_NONE)
731 if ((ccb->ccb_h.flags & CAM_DATA_MASK) != CAM_DATA_VADDR)
733 data_ptrs[0] = &ccb->csio.data_ptr;
734 lengths[0] = ccb->csio.dxfer_len;
735 dirs[0] = ccb->ccb_h.flags & CAM_DIR_MASK;
739 if ((ccb->ccb_h.flags & CAM_DIR_MASK) == CAM_DIR_NONE)
741 if ((ccb->ccb_h.flags & CAM_DATA_MASK) != CAM_DATA_VADDR)
743 data_ptrs[0] = &ccb->ataio.data_ptr;
744 lengths[0] = ccb->ataio.dxfer_len;
745 dirs[0] = ccb->ccb_h.flags & CAM_DIR_MASK;
749 data_ptrs[0] = &ccb->smpio.smp_request;
750 lengths[0] = ccb->smpio.smp_request_len;
751 dirs[0] = CAM_DIR_OUT;
752 data_ptrs[1] = &ccb->smpio.smp_response;
753 lengths[1] = ccb->smpio.smp_response_len;
754 dirs[1] = CAM_DIR_IN;
757 case XPT_DEV_ADVINFO:
758 if (ccb->cdai.bufsiz == 0)
761 data_ptrs[0] = (uint8_t **)&ccb->cdai.buf;
762 lengths[0] = ccb->cdai.bufsiz;
763 dirs[0] = CAM_DIR_IN;
767 * This request will not go to the hardware, no reason
768 * to be so strict. vmapbuf() is able to map up to MAXPHYS.
774 break; /* NOTREACHED */
778 * Check the transfer length and permissions first, so we don't
779 * have to unmap any previously mapped buffers.
781 for (i = 0; i < numbufs; i++) {
786 * The userland data pointer passed in may not be page
787 * aligned. vmapbuf() truncates the address to a page
788 * boundary, so if the address isn't page aligned, we'll
789 * need enough space for the given transfer length, plus
790 * whatever extra space is necessary to make it to the page
794 (((vm_offset_t)(*data_ptrs[i])) & PAGE_MASK)) > maxmap){
795 printf("cam_periph_mapmem: attempt to map %lu bytes, "
796 "which is greater than %lu\n",
798 (((vm_offset_t)(*data_ptrs[i])) & PAGE_MASK)),
803 if (dirs[i] & CAM_DIR_OUT) {
804 flags[i] = BIO_WRITE;
807 if (dirs[i] & CAM_DIR_IN) {
814 * This keeps the the kernel stack of current thread from getting
815 * swapped. In low-memory situations where the kernel stack might
816 * otherwise get swapped out, this holds it and allows the thread
817 * to make progress and release the kernel mapped pages sooner.
819 * XXX KDM should I use P_NOSWAP instead?
823 for (i = 0; i < numbufs; i++) {
827 mapinfo->bp[i] = getpbuf(NULL);
829 /* save the buffer's data address */
830 mapinfo->bp[i]->b_saveaddr = mapinfo->bp[i]->b_data;
832 /* put our pointer in the data slot */
833 mapinfo->bp[i]->b_data = *data_ptrs[i];
835 /* set the transfer length, we know it's < MAXPHYS */
836 mapinfo->bp[i]->b_bufsize = lengths[i];
838 /* set the direction */
839 mapinfo->bp[i]->b_iocmd = flags[i];
842 * Map the buffer into kernel memory.
844 * Note that useracc() alone is not a sufficient test.
845 * vmapbuf() can still fail due to a smaller file mapped
846 * into a larger area of VM, or if userland races against
847 * vmapbuf() after the useracc() check.
849 if (vmapbuf(mapinfo->bp[i], 1) < 0) {
850 for (j = 0; j < i; ++j) {
851 *data_ptrs[j] = mapinfo->bp[j]->b_saveaddr;
852 vunmapbuf(mapinfo->bp[j]);
853 relpbuf(mapinfo->bp[j], NULL);
855 relpbuf(mapinfo->bp[i], NULL);
860 /* set our pointer to the new mapped area */
861 *data_ptrs[i] = mapinfo->bp[i]->b_data;
863 mapinfo->num_bufs_used++;
867 * Now that we've gotten this far, change ownership to the kernel
868 * of the buffers so that we don't run afoul of returning to user
869 * space with locks (on the buffer) held.
871 for (i = 0; i < numbufs; i++) {
872 BUF_KERNPROC(mapinfo->bp[i]);
880 * Unmap memory segments mapped into kernel virtual address space by
881 * cam_periph_mapmem().
884 cam_periph_unmapmem(union ccb *ccb, struct cam_periph_map_info *mapinfo)
887 u_int8_t **data_ptrs[CAM_PERIPH_MAXMAPS];
889 if (mapinfo->num_bufs_used <= 0) {
890 /* nothing to free and the process wasn't held. */
894 switch (ccb->ccb_h.func_code) {
896 numbufs = min(mapinfo->num_bufs_used, 2);
899 data_ptrs[0] = (u_int8_t **)&ccb->cdm.matches;
901 data_ptrs[0] = (u_int8_t **)&ccb->cdm.patterns;
902 data_ptrs[1] = (u_int8_t **)&ccb->cdm.matches;
906 case XPT_CONT_TARGET_IO:
907 data_ptrs[0] = &ccb->csio.data_ptr;
908 numbufs = min(mapinfo->num_bufs_used, 1);
911 data_ptrs[0] = &ccb->ataio.data_ptr;
912 numbufs = min(mapinfo->num_bufs_used, 1);
915 numbufs = min(mapinfo->num_bufs_used, 2);
916 data_ptrs[0] = &ccb->smpio.smp_request;
917 data_ptrs[1] = &ccb->smpio.smp_response;
919 case XPT_DEV_ADVINFO:
920 numbufs = min(mapinfo->num_bufs_used, 1);
921 data_ptrs[0] = (uint8_t **)&ccb->cdai.buf;
924 /* allow ourselves to be swapped once again */
927 break; /* NOTREACHED */
930 for (i = 0; i < numbufs; i++) {
931 /* Set the user's pointer back to the original value */
932 *data_ptrs[i] = mapinfo->bp[i]->b_saveaddr;
934 /* unmap the buffer */
935 vunmapbuf(mapinfo->bp[i]);
937 /* release the buffer */
938 relpbuf(mapinfo->bp[i], NULL);
941 /* allow ourselves to be swapped once again */
946 cam_periph_getccb(struct cam_periph *periph, u_int32_t priority)
948 struct ccb_hdr *ccb_h;
950 mtx_assert(periph->sim->mtx, MA_OWNED);
951 CAM_DEBUG(periph->path, CAM_DEBUG_TRACE, ("entering cdgetccb\n"));
953 while (SLIST_FIRST(&periph->ccb_list) == NULL) {
954 if (periph->immediate_priority > priority)
955 periph->immediate_priority = priority;
956 xpt_schedule(periph, priority);
957 if ((SLIST_FIRST(&periph->ccb_list) != NULL)
958 && (SLIST_FIRST(&periph->ccb_list)->pinfo.priority == priority))
960 mtx_assert(periph->sim->mtx, MA_OWNED);
961 mtx_sleep(&periph->ccb_list, periph->sim->mtx, PRIBIO, "cgticb",
965 ccb_h = SLIST_FIRST(&periph->ccb_list);
966 SLIST_REMOVE_HEAD(&periph->ccb_list, periph_links.sle);
967 return ((union ccb *)ccb_h);
971 cam_periph_ccbwait(union ccb *ccb)
975 sim = xpt_path_sim(ccb->ccb_h.path);
976 if ((ccb->ccb_h.pinfo.index != CAM_UNQUEUED_INDEX)
977 || ((ccb->ccb_h.status & CAM_STATUS_MASK) == CAM_REQ_INPROG))
978 mtx_sleep(&ccb->ccb_h.cbfcnp, sim->mtx, PRIBIO, "cbwait", 0);
982 cam_periph_ioctl(struct cam_periph *periph, u_long cmd, caddr_t addr,
983 int (*error_routine)(union ccb *ccb,
985 u_int32_t sense_flags))
995 ccb = cam_periph_getccb(periph, CAM_PRIORITY_NORMAL);
996 xpt_setup_ccb(&ccb->ccb_h,
998 CAM_PRIORITY_NORMAL);
999 ccb->ccb_h.func_code = XPT_GDEVLIST;
1002 * Basically, the point of this is that we go through
1003 * getting the list of devices, until we find a passthrough
1004 * device. In the current version of the CAM code, the
1005 * only way to determine what type of device we're dealing
1006 * with is by its name.
1008 while (found == 0) {
1009 ccb->cgdl.index = 0;
1010 ccb->cgdl.status = CAM_GDEVLIST_MORE_DEVS;
1011 while (ccb->cgdl.status == CAM_GDEVLIST_MORE_DEVS) {
1013 /* we want the next device in the list */
1015 if (strncmp(ccb->cgdl.periph_name,
1021 if ((ccb->cgdl.status == CAM_GDEVLIST_LAST_DEVICE) &&
1023 ccb->cgdl.periph_name[0] = '\0';
1024 ccb->cgdl.unit_number = 0;
1029 /* copy the result back out */
1030 bcopy(ccb, addr, sizeof(union ccb));
1032 /* and release the ccb */
1033 xpt_release_ccb(ccb);
1044 cam_periph_runccb(union ccb *ccb,
1045 int (*error_routine)(union ccb *ccb,
1047 u_int32_t sense_flags),
1048 cam_flags camflags, u_int32_t sense_flags,
1051 struct cam_sim *sim;
1055 sim = xpt_path_sim(ccb->ccb_h.path);
1056 mtx_assert(sim->mtx, MA_OWNED);
1059 * If the user has supplied a stats structure, and if we understand
1060 * this particular type of ccb, record the transaction start.
1062 if ((ds != NULL) && (ccb->ccb_h.func_code == XPT_SCSI_IO ||
1063 ccb->ccb_h.func_code == XPT_ATA_IO))
1064 devstat_start_transaction(ds, NULL);
1069 cam_periph_ccbwait(ccb);
1070 if ((ccb->ccb_h.status & CAM_STATUS_MASK) == CAM_REQ_CMP)
1072 else if (error_routine != NULL)
1073 error = (*error_routine)(ccb, camflags, sense_flags);
1077 } while (error == ERESTART);
1079 if ((ccb->ccb_h.status & CAM_DEV_QFRZN) != 0) {
1080 cam_release_devq(ccb->ccb_h.path,
1081 /* relsim_flags */0,
1084 /* getcount_only */ FALSE);
1085 ccb->ccb_h.status &= ~CAM_DEV_QFRZN;
1089 if (ccb->ccb_h.func_code == XPT_SCSI_IO) {
1090 devstat_end_transaction(ds,
1091 ccb->csio.dxfer_len,
1092 ccb->csio.tag_action & 0x3,
1093 ((ccb->ccb_h.flags & CAM_DIR_MASK) ==
1094 CAM_DIR_NONE) ? DEVSTAT_NO_DATA :
1095 (ccb->ccb_h.flags & CAM_DIR_OUT) ?
1097 DEVSTAT_READ, NULL, NULL);
1098 } else if (ccb->ccb_h.func_code == XPT_ATA_IO) {
1099 devstat_end_transaction(ds,
1100 ccb->ataio.dxfer_len,
1101 ccb->ataio.tag_action & 0x3,
1102 ((ccb->ccb_h.flags & CAM_DIR_MASK) ==
1103 CAM_DIR_NONE) ? DEVSTAT_NO_DATA :
1104 (ccb->ccb_h.flags & CAM_DIR_OUT) ?
1106 DEVSTAT_READ, NULL, NULL);
1114 cam_freeze_devq(struct cam_path *path)
1116 struct ccb_hdr ccb_h;
1118 xpt_setup_ccb(&ccb_h, path, /*priority*/1);
1119 ccb_h.func_code = XPT_NOOP;
1120 ccb_h.flags = CAM_DEV_QFREEZE;
1121 xpt_action((union ccb *)&ccb_h);
1125 cam_release_devq(struct cam_path *path, u_int32_t relsim_flags,
1126 u_int32_t openings, u_int32_t arg,
1129 struct ccb_relsim crs;
1131 xpt_setup_ccb(&crs.ccb_h, path, CAM_PRIORITY_NORMAL);
1132 crs.ccb_h.func_code = XPT_REL_SIMQ;
1133 crs.ccb_h.flags = getcount_only ? CAM_DEV_QFREEZE : 0;
1134 crs.release_flags = relsim_flags;
1135 crs.openings = openings;
1136 crs.release_timeout = arg;
1137 xpt_action((union ccb *)&crs);
1138 return (crs.qfrozen_cnt);
1141 #define saved_ccb_ptr ppriv_ptr0
1143 camperiphdone(struct cam_periph *periph, union ccb *done_ccb)
1145 union ccb *saved_ccb;
1147 struct scsi_start_stop_unit *scsi_cmd;
1148 int error_code, sense_key, asc, ascq;
1150 scsi_cmd = (struct scsi_start_stop_unit *)
1151 &done_ccb->csio.cdb_io.cdb_bytes;
1152 status = done_ccb->ccb_h.status;
1154 if ((status & CAM_STATUS_MASK) != CAM_REQ_CMP) {
1155 if (scsi_extract_sense_ccb(done_ccb,
1156 &error_code, &sense_key, &asc, &ascq)) {
1158 * If the error is "invalid field in CDB",
1159 * and the load/eject flag is set, turn the
1160 * flag off and try again. This is just in
1161 * case the drive in question barfs on the
1162 * load eject flag. The CAM code should set
1163 * the load/eject flag by default for
1166 if ((scsi_cmd->opcode == START_STOP_UNIT) &&
1167 ((scsi_cmd->how & SSS_LOEJ) != 0) &&
1168 (asc == 0x24) && (ascq == 0x00)) {
1169 scsi_cmd->how &= ~SSS_LOEJ;
1170 if (status & CAM_DEV_QFRZN) {
1171 cam_release_devq(done_ccb->ccb_h.path,
1173 done_ccb->ccb_h.status &=
1176 xpt_action(done_ccb);
1180 if (cam_periph_error(done_ccb,
1181 0, SF_RETRY_UA | SF_NO_PRINT, NULL) == ERESTART)
1183 if (done_ccb->ccb_h.status & CAM_DEV_QFRZN) {
1184 cam_release_devq(done_ccb->ccb_h.path, 0, 0, 0, 0);
1185 done_ccb->ccb_h.status &= ~CAM_DEV_QFRZN;
1189 * If we have successfully taken a device from the not
1190 * ready to ready state, re-scan the device and re-get
1191 * the inquiry information. Many devices (mostly disks)
1192 * don't properly report their inquiry information unless
1195 if (scsi_cmd->opcode == START_STOP_UNIT)
1196 xpt_async(AC_INQ_CHANGED, done_ccb->ccb_h.path, NULL);
1200 * Perform the final retry with the original CCB so that final
1201 * error processing is performed by the owner of the CCB.
1203 saved_ccb = (union ccb *)done_ccb->ccb_h.saved_ccb_ptr;
1204 bcopy(saved_ccb, done_ccb, sizeof(*done_ccb));
1205 xpt_free_ccb(saved_ccb);
1206 if (done_ccb->ccb_h.cbfcnp != camperiphdone)
1207 periph->flags &= ~CAM_PERIPH_RECOVERY_INPROG;
1208 xpt_action(done_ccb);
1211 /* Drop freeze taken due to CAM_DEV_QFREEZE flag set. */
1212 cam_release_devq(done_ccb->ccb_h.path, 0, 0, 0, 0);
1216 * Generic Async Event handler. Peripheral drivers usually
1217 * filter out the events that require personal attention,
1218 * and leave the rest to this function.
1221 cam_periph_async(struct cam_periph *periph, u_int32_t code,
1222 struct cam_path *path, void *arg)
1225 case AC_LOST_DEVICE:
1226 cam_periph_invalidate(periph);
1234 cam_periph_bus_settle(struct cam_periph *periph, u_int bus_settle)
1236 struct ccb_getdevstats cgds;
1238 xpt_setup_ccb(&cgds.ccb_h, periph->path, CAM_PRIORITY_NORMAL);
1239 cgds.ccb_h.func_code = XPT_GDEV_STATS;
1240 xpt_action((union ccb *)&cgds);
1241 cam_periph_freeze_after_event(periph, &cgds.last_reset, bus_settle);
1245 cam_periph_freeze_after_event(struct cam_periph *periph,
1246 struct timeval* event_time, u_int duration_ms)
1248 struct timeval delta;
1249 struct timeval duration_tv;
1251 if (!timevalisset(event_time))
1255 timevalsub(&delta, event_time);
1256 duration_tv.tv_sec = duration_ms / 1000;
1257 duration_tv.tv_usec = (duration_ms % 1000) * 1000;
1258 if (timevalcmp(&delta, &duration_tv, <)) {
1259 timevalsub(&duration_tv, &delta);
1261 duration_ms = duration_tv.tv_sec * 1000;
1262 duration_ms += duration_tv.tv_usec / 1000;
1263 cam_freeze_devq(periph->path);
1264 cam_release_devq(periph->path,
1265 RELSIM_RELEASE_AFTER_TIMEOUT,
1267 /*timeout*/duration_ms,
1268 /*getcount_only*/0);
1274 camperiphscsistatuserror(union ccb *ccb, union ccb **orig_ccb,
1275 cam_flags camflags, u_int32_t sense_flags,
1276 int *openings, u_int32_t *relsim_flags,
1277 u_int32_t *timeout, u_int32_t *action, const char **action_string)
1281 switch (ccb->csio.scsi_status) {
1282 case SCSI_STATUS_OK:
1283 case SCSI_STATUS_COND_MET:
1284 case SCSI_STATUS_INTERMED:
1285 case SCSI_STATUS_INTERMED_COND_MET:
1288 case SCSI_STATUS_CMD_TERMINATED:
1289 case SCSI_STATUS_CHECK_COND:
1290 error = camperiphscsisenseerror(ccb, orig_ccb,
1299 case SCSI_STATUS_QUEUE_FULL:
1302 struct ccb_getdevstats cgds;
1305 * First off, find out what the current
1306 * transaction counts are.
1308 xpt_setup_ccb(&cgds.ccb_h,
1310 CAM_PRIORITY_NORMAL);
1311 cgds.ccb_h.func_code = XPT_GDEV_STATS;
1312 xpt_action((union ccb *)&cgds);
1315 * If we were the only transaction active, treat
1316 * the QUEUE FULL as if it were a BUSY condition.
1318 if (cgds.dev_active != 0) {
1322 * Reduce the number of openings to
1323 * be 1 less than the amount it took
1324 * to get a queue full bounded by the
1325 * minimum allowed tag count for this
1328 total_openings = cgds.dev_active + cgds.dev_openings;
1329 *openings = cgds.dev_active;
1330 if (*openings < cgds.mintags)
1331 *openings = cgds.mintags;
1332 if (*openings < total_openings)
1333 *relsim_flags = RELSIM_ADJUST_OPENINGS;
1336 * Some devices report queue full for
1337 * temporary resource shortages. For
1338 * this reason, we allow a minimum
1339 * tag count to be entered via a
1340 * quirk entry to prevent the queue
1341 * count on these devices from falling
1342 * to a pessimisticly low value. We
1343 * still wait for the next successful
1344 * completion, however, before queueing
1345 * more transactions to the device.
1347 *relsim_flags = RELSIM_RELEASE_AFTER_CMDCMPLT;
1351 *action &= ~SSQ_PRINT_SENSE;
1356 case SCSI_STATUS_BUSY:
1358 * Restart the queue after either another
1359 * command completes or a 1 second timeout.
1361 if (ccb->ccb_h.retry_count > 0) {
1362 ccb->ccb_h.retry_count--;
1364 *relsim_flags = RELSIM_RELEASE_AFTER_TIMEOUT
1365 | RELSIM_RELEASE_AFTER_CMDCMPLT;
1371 case SCSI_STATUS_RESERV_CONFLICT:
1380 camperiphscsisenseerror(union ccb *ccb, union ccb **orig,
1381 cam_flags camflags, u_int32_t sense_flags,
1382 int *openings, u_int32_t *relsim_flags,
1383 u_int32_t *timeout, u_int32_t *action, const char **action_string)
1385 struct cam_periph *periph;
1386 union ccb *orig_ccb = ccb;
1387 int error, recoveryccb;
1389 periph = xpt_path_periph(ccb->ccb_h.path);
1390 recoveryccb = (ccb->ccb_h.cbfcnp == camperiphdone);
1391 if ((periph->flags & CAM_PERIPH_RECOVERY_INPROG) && !recoveryccb) {
1393 * If error recovery is already in progress, don't attempt
1394 * to process this error, but requeue it unconditionally
1395 * and attempt to process it once error recovery has
1396 * completed. This failed command is probably related to
1397 * the error that caused the currently active error recovery
1398 * action so our current recovery efforts should also
1399 * address this command. Be aware that the error recovery
1400 * code assumes that only one recovery action is in progress
1401 * on a particular peripheral instance at any given time
1402 * (e.g. only one saved CCB for error recovery) so it is
1403 * imperitive that we don't violate this assumption.
1406 *action &= ~SSQ_PRINT_SENSE;
1408 scsi_sense_action err_action;
1409 struct ccb_getdev cgd;
1412 * Grab the inquiry data for this device.
1414 xpt_setup_ccb(&cgd.ccb_h, ccb->ccb_h.path, CAM_PRIORITY_NORMAL);
1415 cgd.ccb_h.func_code = XPT_GDEV_TYPE;
1416 xpt_action((union ccb *)&cgd);
1418 err_action = scsi_error_action(&ccb->csio, &cgd.inq_data,
1420 error = err_action & SS_ERRMASK;
1423 * Do not autostart sequential access devices
1424 * to avoid unexpected tape loading.
1426 if ((err_action & SS_MASK) == SS_START &&
1427 SID_TYPE(&cgd.inq_data) == T_SEQUENTIAL) {
1428 *action_string = "Will not autostart a "
1429 "sequential access device";
1430 goto sense_error_done;
1434 * Avoid recovery recursion if recovery action is the same.
1436 if ((err_action & SS_MASK) >= SS_START && recoveryccb) {
1437 if (((err_action & SS_MASK) == SS_START &&
1438 ccb->csio.cdb_io.cdb_bytes[0] == START_STOP_UNIT) ||
1439 ((err_action & SS_MASK) == SS_TUR &&
1440 (ccb->csio.cdb_io.cdb_bytes[0] == TEST_UNIT_READY))) {
1441 err_action = SS_RETRY|SSQ_DECREMENT_COUNT|EIO;
1442 *relsim_flags = RELSIM_RELEASE_AFTER_TIMEOUT;
1448 * If the recovery action will consume a retry,
1449 * make sure we actually have retries available.
1451 if ((err_action & SSQ_DECREMENT_COUNT) != 0) {
1452 if (ccb->ccb_h.retry_count > 0 &&
1453 (periph->flags & CAM_PERIPH_INVALID) == 0)
1454 ccb->ccb_h.retry_count--;
1456 *action_string = "Retries exhausted";
1457 goto sense_error_done;
1461 if ((err_action & SS_MASK) >= SS_START) {
1463 * Do common portions of commands that
1464 * use recovery CCBs.
1466 orig_ccb = xpt_alloc_ccb_nowait();
1467 if (orig_ccb == NULL) {
1468 *action_string = "Can't allocate recovery CCB";
1469 goto sense_error_done;
1472 * Clear freeze flag for original request here, as
1473 * this freeze will be dropped as part of ERESTART.
1475 ccb->ccb_h.status &= ~CAM_DEV_QFRZN;
1476 bcopy(ccb, orig_ccb, sizeof(*orig_ccb));
1479 switch (err_action & SS_MASK) {
1481 *action_string = "No recovery action needed";
1485 *action_string = "Retrying command (per sense data)";
1489 *action_string = "Unretryable error";
1496 * Send a start unit command to the device, and
1497 * then retry the command.
1499 *action_string = "Attempting to start unit";
1500 periph->flags |= CAM_PERIPH_RECOVERY_INPROG;
1503 * Check for removable media and set
1504 * load/eject flag appropriately.
1506 if (SID_IS_REMOVABLE(&cgd.inq_data))
1511 scsi_start_stop(&ccb->csio,
1525 * Send a Test Unit Ready to the device.
1526 * If the 'many' flag is set, we send 120
1527 * test unit ready commands, one every half
1528 * second. Otherwise, we just send one TUR.
1529 * We only want to do this if the retry
1530 * count has not been exhausted.
1534 if ((err_action & SSQ_MANY) != 0) {
1535 *action_string = "Polling device for readiness";
1538 *action_string = "Testing device for readiness";
1541 periph->flags |= CAM_PERIPH_RECOVERY_INPROG;
1542 scsi_test_unit_ready(&ccb->csio,
1550 * Accomplish our 500ms delay by deferring
1551 * the release of our device queue appropriately.
1553 *relsim_flags = RELSIM_RELEASE_AFTER_TIMEOUT;
1558 panic("Unhandled error action %x", err_action);
1561 if ((err_action & SS_MASK) >= SS_START) {
1563 * Drop the priority, so that the recovery
1564 * CCB is the first to execute. Freeze the queue
1565 * after this command is sent so that we can
1566 * restore the old csio and have it queued in
1567 * the proper order before we release normal
1568 * transactions to the device.
1570 ccb->ccb_h.pinfo.priority--;
1571 ccb->ccb_h.flags |= CAM_DEV_QFREEZE;
1572 ccb->ccb_h.saved_ccb_ptr = orig_ccb;
1578 *action = err_action;
1584 * Generic error handler. Peripheral drivers usually filter
1585 * out the errors that they handle in a unique mannor, then
1586 * call this function.
1589 cam_periph_error(union ccb *ccb, cam_flags camflags,
1590 u_int32_t sense_flags, union ccb *save_ccb)
1592 struct cam_path *newpath;
1593 union ccb *orig_ccb, *scan_ccb;
1594 struct cam_periph *periph;
1595 const char *action_string;
1597 int frozen, error, openings;
1598 u_int32_t action, relsim_flags, timeout;
1600 action = SSQ_PRINT_SENSE;
1601 periph = xpt_path_periph(ccb->ccb_h.path);
1602 action_string = NULL;
1603 status = ccb->ccb_h.status;
1604 frozen = (status & CAM_DEV_QFRZN) != 0;
1605 status &= CAM_STATUS_MASK;
1606 openings = relsim_flags = timeout = 0;
1612 action &= ~SSQ_PRINT_SENSE;
1614 case CAM_SCSI_STATUS_ERROR:
1615 error = camperiphscsistatuserror(ccb, &orig_ccb,
1616 camflags, sense_flags, &openings, &relsim_flags,
1617 &timeout, &action, &action_string);
1619 case CAM_AUTOSENSE_FAIL:
1620 error = EIO; /* we have to kill the command */
1624 case CAM_MSG_REJECT_REC:
1625 /* XXX Don't know that these are correct */
1628 case CAM_SEL_TIMEOUT:
1629 if ((camflags & CAM_RETRY_SELTO) != 0) {
1630 if (ccb->ccb_h.retry_count > 0 &&
1631 (periph->flags & CAM_PERIPH_INVALID) == 0) {
1632 ccb->ccb_h.retry_count--;
1636 * Wait a bit to give the device
1637 * time to recover before we try again.
1639 relsim_flags = RELSIM_RELEASE_AFTER_TIMEOUT;
1640 timeout = periph_selto_delay;
1643 action_string = "Retries exhausted";
1646 case CAM_DEV_NOT_THERE:
1650 case CAM_REQ_INVALID:
1651 case CAM_PATH_INVALID:
1653 case CAM_PROVIDE_FAIL:
1654 case CAM_REQ_TOO_BIG:
1655 case CAM_LUN_INVALID:
1656 case CAM_TID_INVALID:
1659 case CAM_SCSI_BUS_RESET:
1662 * Commands that repeatedly timeout and cause these
1663 * kinds of error recovery actions, should return
1664 * CAM_CMD_TIMEOUT, which allows us to safely assume
1665 * that this command was an innocent bystander to
1666 * these events and should be unconditionally
1669 case CAM_REQUEUE_REQ:
1670 /* Unconditional requeue if device is still there */
1671 if (periph->flags & CAM_PERIPH_INVALID) {
1672 action_string = "Periph was invalidated";
1674 } else if (sense_flags & SF_NO_RETRY) {
1676 action_string = "Retry was blocked";
1679 action &= ~SSQ_PRINT_SENSE;
1682 case CAM_RESRC_UNAVAIL:
1683 /* Wait a bit for the resource shortage to abate. */
1684 timeout = periph_noresrc_delay;
1688 /* Wait a bit for the busy condition to abate. */
1689 timeout = periph_busy_delay;
1691 relsim_flags = RELSIM_RELEASE_AFTER_TIMEOUT;
1693 case CAM_ATA_STATUS_ERROR:
1694 case CAM_REQ_CMP_ERR:
1695 case CAM_CMD_TIMEOUT:
1696 case CAM_UNEXP_BUSFREE:
1697 case CAM_UNCOR_PARITY:
1698 case CAM_DATA_RUN_ERR:
1700 if (periph->flags & CAM_PERIPH_INVALID) {
1702 action_string = "Periph was invalidated";
1703 } else if (ccb->ccb_h.retry_count == 0) {
1705 action_string = "Retries exhausted";
1706 } else if (sense_flags & SF_NO_RETRY) {
1708 action_string = "Retry was blocked";
1710 ccb->ccb_h.retry_count--;
1716 if ((sense_flags & SF_PRINT_ALWAYS) ||
1717 CAM_DEBUGGED(ccb->ccb_h.path, CAM_DEBUG_INFO))
1718 action |= SSQ_PRINT_SENSE;
1719 else if (sense_flags & SF_NO_PRINT)
1720 action &= ~SSQ_PRINT_SENSE;
1721 if ((action & SSQ_PRINT_SENSE) != 0)
1722 cam_error_print(orig_ccb, CAM_ESF_ALL, CAM_EPF_ALL);
1723 if (error != 0 && (action & SSQ_PRINT_SENSE) != 0) {
1724 if (error != ERESTART) {
1725 if (action_string == NULL)
1726 action_string = "Unretryable error";
1727 xpt_print(ccb->ccb_h.path, "Error %d, %s\n",
1728 error, action_string);
1729 } else if (action_string != NULL)
1730 xpt_print(ccb->ccb_h.path, "%s\n", action_string);
1732 xpt_print(ccb->ccb_h.path, "Retrying command\n");
1735 if ((action & SSQ_LOST) != 0) {
1739 * For a selection timeout, we consider all of the LUNs on
1740 * the target to be gone. If the status is CAM_DEV_NOT_THERE,
1741 * then we only get rid of the device(s) specified by the
1742 * path in the original CCB.
1744 if (status == CAM_SEL_TIMEOUT)
1745 lun_id = CAM_LUN_WILDCARD;
1747 lun_id = xpt_path_lun_id(ccb->ccb_h.path);
1749 /* Should we do more if we can't create the path?? */
1750 if (xpt_create_path(&newpath, periph,
1751 xpt_path_path_id(ccb->ccb_h.path),
1752 xpt_path_target_id(ccb->ccb_h.path),
1753 lun_id) == CAM_REQ_CMP) {
1756 * Let peripheral drivers know that this
1757 * device has gone away.
1759 xpt_async(AC_LOST_DEVICE, newpath, NULL);
1760 xpt_free_path(newpath);
1764 /* Broadcast UNIT ATTENTIONs to all periphs. */
1765 if ((action & SSQ_UA) != 0)
1766 xpt_async(AC_UNIT_ATTENTION, orig_ccb->ccb_h.path, orig_ccb);
1768 /* Rescan target on "Reported LUNs data has changed" */
1769 if ((action & SSQ_RESCAN) != 0) {
1770 if (xpt_create_path(&newpath, NULL,
1771 xpt_path_path_id(ccb->ccb_h.path),
1772 xpt_path_target_id(ccb->ccb_h.path),
1773 CAM_LUN_WILDCARD) == CAM_REQ_CMP) {
1775 scan_ccb = xpt_alloc_ccb_nowait();
1776 if (scan_ccb != NULL) {
1777 scan_ccb->ccb_h.path = newpath;
1778 scan_ccb->ccb_h.func_code = XPT_SCAN_TGT;
1779 scan_ccb->crcn.flags = 0;
1780 xpt_rescan(scan_ccb);
1783 "Can't allocate CCB to rescan target\n");
1787 /* Attempt a retry */
1788 if (error == ERESTART || error == 0) {
1790 ccb->ccb_h.status &= ~CAM_DEV_QFRZN;
1791 if (error == ERESTART)
1794 cam_release_devq(ccb->ccb_h.path,
1798 /*getcount_only*/0);