2 * Copyright (c) 2003, 2008 Silicon Graphics International Corp.
3 * Copyright (c) 2012 The FreeBSD Foundation
6 * Portions of this software were developed by Edward Tomasz Napierala
7 * under sponsorship from the FreeBSD Foundation.
9 * Redistribution and use in source and binary forms, with or without
10 * modification, are permitted provided that the following conditions
12 * 1. Redistributions of source code must retain the above copyright
13 * notice, this list of conditions, and the following disclaimer,
14 * without modification.
15 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
16 * substantially similar to the "NO WARRANTY" disclaimer below
17 * ("Disclaimer") and any redistribution must be conditioned upon
18 * including a substantially similar Disclaimer requirement for further
19 * binary redistribution.
22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
23 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
24 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
25 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
26 * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
30 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
31 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
32 * POSSIBILITY OF SUCH DAMAGES.
34 * $Id: //depot/users/kenm/FreeBSD-test2/sys/cam/ctl/ctl_backend_ramdisk.c#3 $
37 * CAM Target Layer backend for a "fake" ramdisk.
39 * Author: Ken Merry <ken@FreeBSD.org>
42 #include <sys/cdefs.h>
43 __FBSDID("$FreeBSD$");
45 #include <sys/param.h>
46 #include <sys/systm.h>
47 #include <sys/kernel.h>
48 #include <sys/condvar.h>
49 #include <sys/types.h>
51 #include <sys/mutex.h>
52 #include <sys/malloc.h>
53 #include <sys/taskqueue.h>
55 #include <sys/queue.h>
57 #include <sys/ioccom.h>
58 #include <sys/module.h>
60 #include <cam/scsi/scsi_all.h>
61 #include <cam/ctl/ctl_io.h>
62 #include <cam/ctl/ctl.h>
63 #include <cam/ctl/ctl_util.h>
64 #include <cam/ctl/ctl_backend.h>
65 #include <cam/ctl/ctl_debug.h>
66 #include <cam/ctl/ctl_ioctl.h>
67 #include <cam/ctl/ctl_error.h>
70 CTL_BE_RAMDISK_LUN_UNCONFIGURED = 0x01,
71 CTL_BE_RAMDISK_LUN_CONFIG_ERR = 0x02,
72 CTL_BE_RAMDISK_LUN_WAITING = 0x04
73 } ctl_be_ramdisk_lun_flags;
75 struct ctl_be_ramdisk_lun {
76 struct ctl_lun_create_params params;
80 struct ctl_be_ramdisk_softc *softc;
81 ctl_be_ramdisk_lun_flags flags;
82 STAILQ_ENTRY(ctl_be_ramdisk_lun) links;
83 struct ctl_be_lun cbe_lun;
84 struct taskqueue *io_taskqueue;
86 STAILQ_HEAD(, ctl_io_hdr) cont_queue;
87 struct mtx_padalign queue_lock;
90 struct ctl_be_ramdisk_softc {
93 #ifdef CTL_RAMDISK_PAGES
94 uint8_t **ramdisk_pages;
97 uint8_t *ramdisk_buffer;
100 STAILQ_HEAD(, ctl_be_ramdisk_lun) lun_list;
103 static struct ctl_be_ramdisk_softc rd_softc;
105 int ctl_backend_ramdisk_init(void);
106 void ctl_backend_ramdisk_shutdown(void);
107 static int ctl_backend_ramdisk_move_done(union ctl_io *io);
108 static int ctl_backend_ramdisk_submit(union ctl_io *io);
109 static void ctl_backend_ramdisk_continue(union ctl_io *io);
110 static int ctl_backend_ramdisk_ioctl(struct cdev *dev, u_long cmd,
111 caddr_t addr, int flag, struct thread *td);
112 static int ctl_backend_ramdisk_rm(struct ctl_be_ramdisk_softc *softc,
113 struct ctl_lun_req *req);
114 static int ctl_backend_ramdisk_create(struct ctl_be_ramdisk_softc *softc,
115 struct ctl_lun_req *req);
116 static int ctl_backend_ramdisk_modify(struct ctl_be_ramdisk_softc *softc,
117 struct ctl_lun_req *req);
118 static void ctl_backend_ramdisk_worker(void *context, int pending);
119 static void ctl_backend_ramdisk_lun_shutdown(void *be_lun);
120 static void ctl_backend_ramdisk_lun_config_status(void *be_lun,
121 ctl_lun_config_status status);
122 static int ctl_backend_ramdisk_config_write(union ctl_io *io);
123 static int ctl_backend_ramdisk_config_read(union ctl_io *io);
125 static struct ctl_backend_driver ctl_be_ramdisk_driver =
128 .flags = CTL_BE_FLAG_HAS_CONFIG,
129 .init = ctl_backend_ramdisk_init,
130 .data_submit = ctl_backend_ramdisk_submit,
131 .data_move_done = ctl_backend_ramdisk_move_done,
132 .config_read = ctl_backend_ramdisk_config_read,
133 .config_write = ctl_backend_ramdisk_config_write,
134 .ioctl = ctl_backend_ramdisk_ioctl
137 MALLOC_DEFINE(M_RAMDISK, "ramdisk", "Memory used for CTL RAMdisk");
138 CTL_BACKEND_DECLARE(cbr, ctl_be_ramdisk_driver);
141 ctl_backend_ramdisk_init(void)
143 struct ctl_be_ramdisk_softc *softc;
144 #ifdef CTL_RAMDISK_PAGES
151 memset(softc, 0, sizeof(*softc));
153 mtx_init(&softc->lock, "ctlramdisk", NULL, MTX_DEF);
155 STAILQ_INIT(&softc->lun_list);
156 softc->rd_size = 1024 * 1024;
157 #ifdef CTL_RAMDISK_PAGES
158 softc->num_pages = softc->rd_size / PAGE_SIZE;
159 softc->ramdisk_pages = (uint8_t **)malloc(sizeof(uint8_t *) *
160 softc->num_pages, M_RAMDISK,
162 for (i = 0; i < softc->num_pages; i++)
163 softc->ramdisk_pages[i] = malloc(PAGE_SIZE, M_RAMDISK,M_WAITOK);
165 softc->ramdisk_buffer = (uint8_t *)malloc(softc->rd_size, M_RAMDISK,
173 ctl_backend_ramdisk_shutdown(void)
175 struct ctl_be_ramdisk_softc *softc;
176 struct ctl_be_ramdisk_lun *lun, *next_lun;
177 #ifdef CTL_RAMDISK_PAGES
183 mtx_lock(&softc->lock);
184 for (lun = STAILQ_FIRST(&softc->lun_list); lun != NULL; lun = next_lun){
186 * Grab the next LUN. The current LUN may get removed by
187 * ctl_invalidate_lun(), which will call our LUN shutdown
188 * routine, if there is no outstanding I/O for this LUN.
190 next_lun = STAILQ_NEXT(lun, links);
193 * Drop our lock here. Since ctl_invalidate_lun() can call
194 * back into us, this could potentially lead to a recursive
195 * lock of the same mutex, which would cause a hang.
197 mtx_unlock(&softc->lock);
198 ctl_disable_lun(&lun->cbe_lun);
199 ctl_invalidate_lun(&lun->cbe_lun);
200 mtx_lock(&softc->lock);
202 mtx_unlock(&softc->lock);
204 #ifdef CTL_RAMDISK_PAGES
205 for (i = 0; i < softc->num_pages; i++)
206 free(softc->ramdisk_pages[i], M_RAMDISK);
208 free(softc->ramdisk_pages, M_RAMDISK);
210 free(softc->ramdisk_buffer, M_RAMDISK);
213 if (ctl_backend_deregister(&ctl_be_ramdisk_driver) != 0) {
214 printf("ctl_backend_ramdisk_shutdown: "
215 "ctl_backend_deregister() failed!\n");
220 ctl_backend_ramdisk_move_done(union ctl_io *io)
222 struct ctl_be_lun *cbe_lun;
223 struct ctl_be_ramdisk_lun *be_lun;
225 struct bintime cur_bt;
228 CTL_DEBUG_PRINT(("ctl_backend_ramdisk_move_done\n"));
229 cbe_lun = (struct ctl_be_lun *)io->io_hdr.ctl_private[
230 CTL_PRIV_BACKEND_LUN].ptr;
231 be_lun = (struct ctl_be_ramdisk_lun *)cbe_lun->be_lun;
234 bintime_sub(&cur_bt, &io->io_hdr.dma_start_bt);
235 bintime_add(&io->io_hdr.dma_bt, &cur_bt);
236 io->io_hdr.num_dmas++;
238 if (io->scsiio.kern_sg_entries > 0)
239 free(io->scsiio.kern_data_ptr, M_RAMDISK);
240 io->scsiio.kern_rel_offset += io->scsiio.kern_data_len;
241 if (io->io_hdr.flags & CTL_FLAG_ABORT) {
243 } else if ((io->io_hdr.port_status == 0) &&
244 ((io->io_hdr.status & CTL_STATUS_MASK) == CTL_STATUS_NONE)) {
245 if (io->io_hdr.ctl_private[CTL_PRIV_BACKEND].integer > 0) {
246 mtx_lock(&be_lun->queue_lock);
247 STAILQ_INSERT_TAIL(&be_lun->cont_queue,
249 mtx_unlock(&be_lun->queue_lock);
250 taskqueue_enqueue(be_lun->io_taskqueue,
254 ctl_set_success(&io->scsiio);
255 } else if ((io->io_hdr.port_status != 0) &&
256 ((io->io_hdr.status & CTL_STATUS_MASK) == CTL_STATUS_NONE ||
257 (io->io_hdr.status & CTL_STATUS_MASK) == CTL_SUCCESS)) {
259 * For hardware error sense keys, the sense key
260 * specific value is defined to be a retry count,
261 * but we use it to pass back an internal FETD
262 * error code. XXX KDM Hopefully the FETD is only
263 * using 16 bits for an error code, since that's
264 * all the space we have in the sks field.
266 ctl_set_internal_failure(&io->scsiio,
269 io->io_hdr.port_status);
271 ctl_data_submit_done(io);
276 ctl_backend_ramdisk_submit(union ctl_io *io)
278 struct ctl_be_lun *cbe_lun;
279 struct ctl_lba_len_flags *lbalen;
281 cbe_lun = (struct ctl_be_lun *)io->io_hdr.ctl_private[
282 CTL_PRIV_BACKEND_LUN].ptr;
283 lbalen = (struct ctl_lba_len_flags *)&io->io_hdr.ctl_private[CTL_PRIV_LBA_LEN];
284 if (lbalen->flags & CTL_LLF_VERIFY) {
285 ctl_set_success(&io->scsiio);
286 ctl_data_submit_done(io);
287 return (CTL_RETVAL_COMPLETE);
289 io->io_hdr.ctl_private[CTL_PRIV_BACKEND].integer =
290 lbalen->len * cbe_lun->blocksize;
291 ctl_backend_ramdisk_continue(io);
292 return (CTL_RETVAL_COMPLETE);
296 ctl_backend_ramdisk_continue(union ctl_io *io)
298 struct ctl_be_ramdisk_softc *softc;
299 int len, len_filled, sg_filled;
300 #ifdef CTL_RAMDISK_PAGES
301 struct ctl_sg_entry *sg_entries;
306 len = io->io_hdr.ctl_private[CTL_PRIV_BACKEND].integer;
307 #ifdef CTL_RAMDISK_PAGES
308 sg_filled = min(btoc(len), softc->num_pages);
310 io->scsiio.kern_data_ptr = malloc(sizeof(struct ctl_sg_entry) *
311 sg_filled, M_RAMDISK,
313 sg_entries = (struct ctl_sg_entry *)io->scsiio.kern_data_ptr;
314 for (i = 0, len_filled = 0; i < sg_filled; i++) {
315 sg_entries[i].addr = softc->ramdisk_pages[i];
316 sg_entries[i].len = MIN(PAGE_SIZE, len - len_filled);
317 len_filled += sg_entries[i].len;
319 io->io_hdr.flags |= CTL_FLAG_KDPTR_SGLIST;
323 io->scsiio.kern_data_ptr = softc->ramdisk_pages[0];
327 len_filled = min(len, softc->rd_size);
328 io->scsiio.kern_data_ptr = softc->ramdisk_buffer;
329 #endif /* CTL_RAMDISK_PAGES */
331 io->scsiio.be_move_done = ctl_backend_ramdisk_move_done;
332 io->scsiio.kern_data_resid = 0;
333 io->scsiio.kern_data_len = len_filled;
334 io->scsiio.kern_sg_entries = sg_filled;
335 io->io_hdr.flags |= CTL_FLAG_ALLOCATED;
336 io->io_hdr.ctl_private[CTL_PRIV_BACKEND].integer -= len_filled;
338 getbintime(&io->io_hdr.dma_start_bt);
344 ctl_backend_ramdisk_worker(void *context, int pending)
346 struct ctl_be_ramdisk_softc *softc;
347 struct ctl_be_ramdisk_lun *be_lun;
350 be_lun = (struct ctl_be_ramdisk_lun *)context;
351 softc = be_lun->softc;
353 mtx_lock(&be_lun->queue_lock);
355 io = (union ctl_io *)STAILQ_FIRST(&be_lun->cont_queue);
357 STAILQ_REMOVE(&be_lun->cont_queue, &io->io_hdr,
360 mtx_unlock(&be_lun->queue_lock);
362 ctl_backend_ramdisk_continue(io);
364 mtx_lock(&be_lun->queue_lock);
369 * If we get here, there is no work left in the queues, so
370 * just break out and let the task queue go to sleep.
374 mtx_unlock(&be_lun->queue_lock);
378 ctl_backend_ramdisk_ioctl(struct cdev *dev, u_long cmd, caddr_t addr,
379 int flag, struct thread *td)
381 struct ctl_be_ramdisk_softc *softc;
389 struct ctl_lun_req *lun_req;
391 lun_req = (struct ctl_lun_req *)addr;
393 switch (lun_req->reqtype) {
394 case CTL_LUNREQ_CREATE:
395 retval = ctl_backend_ramdisk_create(softc, lun_req);
398 retval = ctl_backend_ramdisk_rm(softc, lun_req);
400 case CTL_LUNREQ_MODIFY:
401 retval = ctl_backend_ramdisk_modify(softc, lun_req);
404 lun_req->status = CTL_LUN_ERROR;
405 snprintf(lun_req->error_str, sizeof(lun_req->error_str),
406 "%s: invalid LUN request type %d", __func__,
421 ctl_backend_ramdisk_rm(struct ctl_be_ramdisk_softc *softc,
422 struct ctl_lun_req *req)
424 struct ctl_be_ramdisk_lun *be_lun;
425 struct ctl_lun_rm_params *params;
430 params = &req->reqdata.rm;
434 mtx_lock(&softc->lock);
436 STAILQ_FOREACH(be_lun, &softc->lun_list, links) {
437 if (be_lun->cbe_lun.lun_id == params->lun_id)
440 mtx_unlock(&softc->lock);
442 if (be_lun == NULL) {
443 snprintf(req->error_str, sizeof(req->error_str),
444 "%s: LUN %u is not managed by the ramdisk backend",
445 __func__, params->lun_id);
449 retval = ctl_disable_lun(&be_lun->cbe_lun);
452 snprintf(req->error_str, sizeof(req->error_str),
453 "%s: error %d returned from ctl_disable_lun() for "
454 "LUN %d", __func__, retval, params->lun_id);
459 * Set the waiting flag before we invalidate the LUN. Our shutdown
460 * routine can be called any time after we invalidate the LUN,
461 * and can be called from our context.
463 * This tells the shutdown routine that we're waiting, or we're
464 * going to wait for the shutdown to happen.
466 mtx_lock(&softc->lock);
467 be_lun->flags |= CTL_BE_RAMDISK_LUN_WAITING;
468 mtx_unlock(&softc->lock);
470 retval = ctl_invalidate_lun(&be_lun->cbe_lun);
472 snprintf(req->error_str, sizeof(req->error_str),
473 "%s: error %d returned from ctl_invalidate_lun() for "
474 "LUN %d", __func__, retval, params->lun_id);
475 mtx_lock(&softc->lock);
476 be_lun->flags &= ~CTL_BE_RAMDISK_LUN_WAITING;
477 mtx_unlock(&softc->lock);
481 mtx_lock(&softc->lock);
483 while ((be_lun->flags & CTL_BE_RAMDISK_LUN_UNCONFIGURED) == 0) {
484 retval = msleep(be_lun, &softc->lock, PCATCH, "ctlram", 0);
488 be_lun->flags &= ~CTL_BE_RAMDISK_LUN_WAITING;
491 * We only remove this LUN from the list and free it (below) if
492 * retval == 0. If the user interrupted the wait, we just bail out
493 * without actually freeing the LUN. We let the shutdown routine
494 * free the LUN if that happens.
497 STAILQ_REMOVE(&softc->lun_list, be_lun, ctl_be_ramdisk_lun,
502 mtx_unlock(&softc->lock);
505 taskqueue_drain(be_lun->io_taskqueue, &be_lun->io_task);
506 taskqueue_free(be_lun->io_taskqueue);
507 ctl_free_opts(&be_lun->cbe_lun.options);
508 mtx_destroy(&be_lun->queue_lock);
509 free(be_lun, M_RAMDISK);
512 req->status = CTL_LUN_OK;
517 req->status = CTL_LUN_ERROR;
523 ctl_backend_ramdisk_create(struct ctl_be_ramdisk_softc *softc,
524 struct ctl_lun_req *req)
526 struct ctl_be_ramdisk_lun *be_lun;
527 struct ctl_be_lun *cbe_lun;
528 struct ctl_lun_create_params *params;
534 params = &req->reqdata.create;
536 be_lun = malloc(sizeof(*be_lun), M_RAMDISK, M_ZERO | M_WAITOK);
537 cbe_lun = &be_lun->cbe_lun;
538 cbe_lun->be_lun = be_lun;
539 be_lun->params = req->reqdata.create;
540 be_lun->softc = softc;
541 sprintf(be_lun->lunname, "cram%d", softc->num_luns);
542 ctl_init_opts(&cbe_lun->options, req->num_be_args, req->kern_be_args);
544 if (params->flags & CTL_LUN_FLAG_DEV_TYPE)
545 cbe_lun->lun_type = params->device_type;
547 cbe_lun->lun_type = T_DIRECT;
548 be_lun->flags = CTL_BE_RAMDISK_LUN_UNCONFIGURED;
549 cbe_lun->flags = CTL_LUN_FLAG_PRIMARY;
551 if (cbe_lun->lun_type == T_DIRECT) {
552 if (params->blocksize_bytes != 0)
553 cbe_lun->blocksize = params->blocksize_bytes;
555 cbe_lun->blocksize = 512;
556 if (params->lun_size_bytes < cbe_lun->blocksize) {
557 snprintf(req->error_str, sizeof(req->error_str),
558 "%s: LUN size %ju < blocksize %u", __func__,
559 params->lun_size_bytes, cbe_lun->blocksize);
562 be_lun->size_blocks = params->lun_size_bytes / cbe_lun->blocksize;
563 be_lun->size_bytes = be_lun->size_blocks * cbe_lun->blocksize;
564 cbe_lun->maxlba = be_lun->size_blocks - 1;
565 cbe_lun->atomicblock = UINT32_MAX;
566 cbe_lun->opttxferlen = softc->rd_size / cbe_lun->blocksize;
569 /* Tell the user the blocksize we ended up using */
570 params->blocksize_bytes = cbe_lun->blocksize;
571 params->lun_size_bytes = be_lun->size_bytes;
573 value = ctl_get_opt(&cbe_lun->options, "unmap");
574 if (value != NULL && strcmp(value, "on") == 0)
575 cbe_lun->flags |= CTL_LUN_FLAG_UNMAP;
576 value = ctl_get_opt(&cbe_lun->options, "readonly");
577 if (value != NULL && strcmp(value, "on") == 0)
578 cbe_lun->flags |= CTL_LUN_FLAG_READONLY;
579 cbe_lun->serseq = CTL_LUN_SERSEQ_OFF;
580 value = ctl_get_opt(&cbe_lun->options, "serseq");
581 if (value != NULL && strcmp(value, "on") == 0)
582 cbe_lun->serseq = CTL_LUN_SERSEQ_ON;
583 else if (value != NULL && strcmp(value, "read") == 0)
584 cbe_lun->serseq = CTL_LUN_SERSEQ_READ;
585 else if (value != NULL && strcmp(value, "off") == 0)
586 cbe_lun->serseq = CTL_LUN_SERSEQ_OFF;
588 if (params->flags & CTL_LUN_FLAG_ID_REQ) {
589 cbe_lun->req_lun_id = params->req_lun_id;
590 cbe_lun->flags |= CTL_LUN_FLAG_ID_REQ;
592 cbe_lun->req_lun_id = 0;
594 cbe_lun->lun_shutdown = ctl_backend_ramdisk_lun_shutdown;
595 cbe_lun->lun_config_status = ctl_backend_ramdisk_lun_config_status;
596 cbe_lun->be = &ctl_be_ramdisk_driver;
597 if ((params->flags & CTL_LUN_FLAG_SERIAL_NUM) == 0) {
598 snprintf(tmpstr, sizeof(tmpstr), "MYSERIAL%4d",
600 strncpy((char *)cbe_lun->serial_num, tmpstr,
601 MIN(sizeof(cbe_lun->serial_num), sizeof(tmpstr)));
603 /* Tell the user what we used for a serial number */
604 strncpy((char *)params->serial_num, tmpstr,
605 MIN(sizeof(params->serial_num), sizeof(tmpstr)));
607 strncpy((char *)cbe_lun->serial_num, params->serial_num,
608 MIN(sizeof(cbe_lun->serial_num),
609 sizeof(params->serial_num)));
611 if ((params->flags & CTL_LUN_FLAG_DEVID) == 0) {
612 snprintf(tmpstr, sizeof(tmpstr), "MYDEVID%4d", softc->num_luns);
613 strncpy((char *)cbe_lun->device_id, tmpstr,
614 MIN(sizeof(cbe_lun->device_id), sizeof(tmpstr)));
616 /* Tell the user what we used for a device ID */
617 strncpy((char *)params->device_id, tmpstr,
618 MIN(sizeof(params->device_id), sizeof(tmpstr)));
620 strncpy((char *)cbe_lun->device_id, params->device_id,
621 MIN(sizeof(cbe_lun->device_id),
622 sizeof(params->device_id)));
625 STAILQ_INIT(&be_lun->cont_queue);
626 mtx_init(&be_lun->queue_lock, "cram queue lock", NULL, MTX_DEF);
627 TASK_INIT(&be_lun->io_task, /*priority*/0, ctl_backend_ramdisk_worker,
630 be_lun->io_taskqueue = taskqueue_create(be_lun->lunname, M_WAITOK,
631 taskqueue_thread_enqueue, /*context*/&be_lun->io_taskqueue);
632 if (be_lun->io_taskqueue == NULL) {
633 snprintf(req->error_str, sizeof(req->error_str),
634 "%s: Unable to create taskqueue", __func__);
638 retval = taskqueue_start_threads(&be_lun->io_taskqueue,
642 "%s taskq", be_lun->lunname);
646 mtx_lock(&softc->lock);
648 STAILQ_INSERT_TAIL(&softc->lun_list, be_lun, links);
650 mtx_unlock(&softc->lock);
652 retval = ctl_add_lun(&be_lun->cbe_lun);
654 mtx_lock(&softc->lock);
655 STAILQ_REMOVE(&softc->lun_list, be_lun, ctl_be_ramdisk_lun,
658 mtx_unlock(&softc->lock);
659 snprintf(req->error_str, sizeof(req->error_str),
660 "%s: ctl_add_lun() returned error %d, see dmesg for "
661 "details", __func__, retval);
666 mtx_lock(&softc->lock);
669 * Tell the config_status routine that we're waiting so it won't
670 * clean up the LUN in the event of an error.
672 be_lun->flags |= CTL_BE_RAMDISK_LUN_WAITING;
674 while (be_lun->flags & CTL_BE_RAMDISK_LUN_UNCONFIGURED) {
675 retval = msleep(be_lun, &softc->lock, PCATCH, "ctlram", 0);
679 be_lun->flags &= ~CTL_BE_RAMDISK_LUN_WAITING;
681 if (be_lun->flags & CTL_BE_RAMDISK_LUN_CONFIG_ERR) {
682 snprintf(req->error_str, sizeof(req->error_str),
683 "%s: LUN configuration error, see dmesg for details",
685 STAILQ_REMOVE(&softc->lun_list, be_lun, ctl_be_ramdisk_lun,
688 mtx_unlock(&softc->lock);
691 params->req_lun_id = cbe_lun->lun_id;
693 mtx_unlock(&softc->lock);
695 req->status = CTL_LUN_OK;
700 req->status = CTL_LUN_ERROR;
701 if (be_lun != NULL) {
702 if (be_lun->io_taskqueue != NULL) {
703 taskqueue_free(be_lun->io_taskqueue);
705 ctl_free_opts(&cbe_lun->options);
706 mtx_destroy(&be_lun->queue_lock);
707 free(be_lun, M_RAMDISK);
714 ctl_backend_ramdisk_modify(struct ctl_be_ramdisk_softc *softc,
715 struct ctl_lun_req *req)
717 struct ctl_be_ramdisk_lun *be_lun;
718 struct ctl_be_lun *cbe_lun;
719 struct ctl_lun_modify_params *params;
722 params = &req->reqdata.modify;
724 mtx_lock(&softc->lock);
725 STAILQ_FOREACH(be_lun, &softc->lun_list, links) {
726 if (be_lun->cbe_lun.lun_id == params->lun_id)
729 mtx_unlock(&softc->lock);
731 if (be_lun == NULL) {
732 snprintf(req->error_str, sizeof(req->error_str),
733 "%s: LUN %u is not managed by the ramdisk backend",
734 __func__, params->lun_id);
737 cbe_lun = &be_lun->cbe_lun;
739 if (params->lun_size_bytes != 0)
740 be_lun->params.lun_size_bytes = params->lun_size_bytes;
741 ctl_update_opts(&cbe_lun->options, req->num_be_args, req->kern_be_args);
742 blocksize = be_lun->cbe_lun.blocksize;
744 if (be_lun->params.lun_size_bytes < blocksize) {
745 snprintf(req->error_str, sizeof(req->error_str),
746 "%s: LUN size %ju < blocksize %u", __func__,
747 be_lun->params.lun_size_bytes, blocksize);
751 be_lun->size_blocks = be_lun->params.lun_size_bytes / blocksize;
752 be_lun->size_bytes = be_lun->size_blocks * blocksize;
753 be_lun->cbe_lun.maxlba = be_lun->size_blocks - 1;
754 ctl_lun_capacity_changed(&be_lun->cbe_lun);
756 /* Tell the user the exact size we ended up using */
757 params->lun_size_bytes = be_lun->size_bytes;
759 req->status = CTL_LUN_OK;
764 req->status = CTL_LUN_ERROR;
770 ctl_backend_ramdisk_lun_shutdown(void *be_lun)
772 struct ctl_be_ramdisk_lun *lun;
773 struct ctl_be_ramdisk_softc *softc;
776 lun = (struct ctl_be_ramdisk_lun *)be_lun;
780 mtx_lock(&softc->lock);
782 lun->flags |= CTL_BE_RAMDISK_LUN_UNCONFIGURED;
784 if (lun->flags & CTL_BE_RAMDISK_LUN_WAITING) {
787 STAILQ_REMOVE(&softc->lun_list, lun, ctl_be_ramdisk_lun,
793 mtx_unlock(&softc->lock);
796 free(be_lun, M_RAMDISK);
800 ctl_backend_ramdisk_lun_config_status(void *be_lun,
801 ctl_lun_config_status status)
803 struct ctl_be_ramdisk_lun *lun;
804 struct ctl_be_ramdisk_softc *softc;
806 lun = (struct ctl_be_ramdisk_lun *)be_lun;
809 if (status == CTL_LUN_CONFIG_OK) {
810 mtx_lock(&softc->lock);
811 lun->flags &= ~CTL_BE_RAMDISK_LUN_UNCONFIGURED;
812 if (lun->flags & CTL_BE_RAMDISK_LUN_WAITING)
814 mtx_unlock(&softc->lock);
817 * We successfully added the LUN, attempt to enable it.
819 if (ctl_enable_lun(&lun->cbe_lun) != 0) {
820 printf("%s: ctl_enable_lun() failed!\n", __func__);
821 if (ctl_invalidate_lun(&lun->cbe_lun) != 0) {
822 printf("%s: ctl_invalidate_lun() failed!\n",
831 mtx_lock(&softc->lock);
832 lun->flags &= ~CTL_BE_RAMDISK_LUN_UNCONFIGURED;
835 * If we have a user waiting, let him handle the cleanup. If not,
836 * clean things up here.
838 if (lun->flags & CTL_BE_RAMDISK_LUN_WAITING) {
839 lun->flags |= CTL_BE_RAMDISK_LUN_CONFIG_ERR;
842 STAILQ_REMOVE(&softc->lun_list, lun, ctl_be_ramdisk_lun,
845 free(lun, M_RAMDISK);
847 mtx_unlock(&softc->lock);
851 ctl_backend_ramdisk_config_write(union ctl_io *io)
853 struct ctl_be_ramdisk_softc *softc;
859 switch (io->scsiio.cdb[0]) {
860 case SYNCHRONIZE_CACHE:
861 case SYNCHRONIZE_CACHE_16:
863 * The upper level CTL code will filter out any CDBs with
864 * the immediate bit set and return the proper error. It
865 * will also not allow a sync cache command to go to a LUN
866 * that is powered down.
868 * We don't really need to worry about what LBA range the
869 * user asked to be synced out. When they issue a sync
870 * cache command, we'll sync out the whole thing.
872 * This is obviously just a stubbed out implementation.
873 * The real implementation will be in the RAIDCore/CTL
874 * interface, and can only really happen when RAIDCore
875 * implements a per-array cache sync.
877 ctl_set_success(&io->scsiio);
878 ctl_config_write_done(io);
880 case START_STOP_UNIT: {
881 struct scsi_start_stop_unit *cdb;
882 struct ctl_be_lun *cbe_lun;
883 struct ctl_be_ramdisk_lun *be_lun;
885 cdb = (struct scsi_start_stop_unit *)io->scsiio.cdb;
887 cbe_lun = (struct ctl_be_lun *)io->io_hdr.ctl_private[
888 CTL_PRIV_BACKEND_LUN].ptr;
889 be_lun = (struct ctl_be_ramdisk_lun *)cbe_lun->be_lun;
891 if (cdb->how & SSS_START)
892 retval = ctl_start_lun(cbe_lun);
894 retval = ctl_stop_lun(cbe_lun);
897 && (cdb->byte2 & SSS_ONOFFLINE))
898 retval = ctl_lun_offline(cbe_lun);
903 * In general, the above routines should not fail. They
904 * just set state for the LUN. So we've got something
905 * pretty wrong here if we can't start or stop the LUN.
908 ctl_set_internal_failure(&io->scsiio,
910 /*retry_count*/ 0xf051);
911 retval = CTL_RETVAL_COMPLETE;
913 ctl_set_success(&io->scsiio);
915 ctl_config_write_done(io);
921 ctl_set_success(&io->scsiio);
922 ctl_config_write_done(io);
925 ctl_set_invalid_opcode(&io->scsiio);
926 ctl_config_write_done(io);
927 retval = CTL_RETVAL_COMPLETE;
935 ctl_backend_ramdisk_config_read(union ctl_io *io)
939 switch (io->scsiio.cdb[0]) {
940 case SERVICE_ACTION_IN:
941 if (io->scsiio.cdb[1] == SGLS_SERVICE_ACTION) {
942 /* We have nothing to tell, leave default data. */
943 ctl_config_read_done(io);
944 retval = CTL_RETVAL_COMPLETE;
947 ctl_set_invalid_field(&io->scsiio,
953 ctl_config_read_done(io);
954 retval = CTL_RETVAL_COMPLETE;
957 ctl_set_invalid_opcode(&io->scsiio);
958 ctl_config_read_done(io);
959 retval = CTL_RETVAL_COMPLETE;