2 * Copyright (c) 2007 Scott Long
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions, and the following disclaimer,
10 * without modification, immediately at the beginning of the file.
11 * 2. The name of the author may not be used to endorse or promote products
12 * derived from this software without specific prior written permission.
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR
18 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28 * scsi_sg peripheral driver. This driver is meant to implement the Linux
29 * SG passthrough interface for SCSI.
32 #include <sys/cdefs.h>
33 __FBSDID("$FreeBSD$");
35 #include <sys/param.h>
36 #include <sys/systm.h>
37 #include <sys/kernel.h>
38 #include <sys/types.h>
40 #include <sys/malloc.h>
41 #include <sys/fcntl.h>
42 #include <sys/ioccom.h>
44 #include <sys/errno.h>
45 #include <sys/devicestat.h>
50 #include <cam/cam_ccb.h>
51 #include <cam/cam_periph.h>
52 #include <cam/cam_queue.h>
53 #include <cam/cam_xpt_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_sg.h>
61 #include <compat/linux/linux_ioctl.h>
64 SG_FLAG_LOCKED = 0x01,
65 SG_FLAG_INVALID = 0x02
82 #define ccb_type ppriv_field0
83 #define ccb_rdwr ppriv_ptr1
86 TAILQ_ENTRY(sg_rdwr) rdwr_link;
94 struct sg_io_hdr io_hdr;
102 struct devstat *device_stats;
103 TAILQ_HEAD(, sg_rdwr) rdwr_done;
111 static d_open_t sgopen;
112 static d_close_t sgclose;
113 static d_ioctl_t sgioctl;
114 static d_write_t sgwrite;
115 static d_read_t sgread;
117 static periph_init_t sginit;
118 static periph_ctor_t sgregister;
119 static periph_oninv_t sgoninvalidate;
120 static periph_dtor_t sgcleanup;
121 static void sgasync(void *callback_arg, uint32_t code,
122 struct cam_path *path, void *arg);
123 static void sgdone(struct cam_periph *periph, union ccb *done_ccb);
124 static int sgsendccb(struct cam_periph *periph, union ccb *ccb);
125 static int sgsendrdwr(struct cam_periph *periph, union ccb *ccb);
126 static int sgerror(union ccb *ccb, uint32_t cam_flags,
127 uint32_t sense_flags);
128 static void sg_scsiio_status(struct ccb_scsiio *csio,
129 u_short *hoststat, u_short *drvstat);
131 static int scsi_group_len(u_char cmd);
133 static struct periph_driver sgdriver =
136 TAILQ_HEAD_INITIALIZER(sgdriver.units), /* gen */ 0
138 PERIPHDRIVER_DECLARE(sg, sgdriver);
140 static struct cdevsw sg_cdevsw = {
141 .d_version = D_VERSION,
142 .d_flags = D_NEEDGIANT | D_TRACKCLOSE,
151 static int sg_version = 30125;
159 * Install a global async callback. This callback will receive aync
160 * callbacks like "new device found".
162 status = xpt_register_async(AC_FOUND_DEVICE, sgasync, NULL, NULL);
164 if (status != CAM_REQ_CMP) {
165 printf("sg: Failed to attach master async callbac "
166 "due to status 0x%x!\n", status);
171 sgdevgonecb(void *arg)
173 struct cam_periph *periph;
174 struct sg_softc *softc;
178 periph = (struct cam_periph *)arg;
179 mtx = cam_periph_mtx(periph);
182 softc = (struct sg_softc *)periph->softc;
183 KASSERT(softc->open_count >= 0, ("Negative open count %d",
187 * When we get this callback, we will get no more close calls from
188 * devfs. So if we have any dangling opens, we need to release the
189 * reference held for that particular context.
191 for (i = 0; i < softc->open_count; i++)
192 cam_periph_release_locked(periph);
194 softc->open_count = 0;
197 * Release the reference held for the device node, it is gone now.
199 cam_periph_release_locked(periph);
202 * We reference the lock directly here, instead of using
203 * cam_periph_unlock(). The reason is that the final call to
204 * cam_periph_release_locked() above could result in the periph
205 * getting freed. If that is the case, dereferencing the periph
206 * with a cam_periph_unlock() call would cause a page fault.
213 sgoninvalidate(struct cam_periph *periph)
215 struct sg_softc *softc;
217 softc = (struct sg_softc *)periph->softc;
220 * Deregister any async callbacks.
222 xpt_register_async(0, sgasync, periph, periph->path);
224 softc->flags |= SG_FLAG_INVALID;
227 * Tell devfs this device has gone away, and ask for a callback
228 * when it has cleaned up its state.
230 destroy_dev_sched_cb(softc->dev, sgdevgonecb, periph);
233 * XXX Return all queued I/O with ENXIO.
234 * XXX Handle any transactions queued to the card
235 * with XPT_ABORT_CCB.
241 sgcleanup(struct cam_periph *periph)
243 struct sg_softc *softc;
245 softc = (struct sg_softc *)periph->softc;
247 devstat_remove_entry(softc->device_stats);
249 free(softc, M_DEVBUF);
253 sgasync(void *callback_arg, uint32_t code, struct cam_path *path, void *arg)
255 struct cam_periph *periph;
257 periph = (struct cam_periph *)callback_arg;
260 case AC_FOUND_DEVICE:
262 struct ccb_getdev *cgd;
265 cgd = (struct ccb_getdev *)arg;
269 if (cgd->protocol != PROTO_SCSI)
273 * Allocate a peripheral instance for this device and
274 * start the probe process.
276 status = cam_periph_alloc(sgregister, sgoninvalidate,
277 sgcleanup, NULL, "sg",
278 CAM_PERIPH_BIO, path,
279 sgasync, AC_FOUND_DEVICE, cgd);
280 if ((status != CAM_REQ_CMP) && (status != CAM_REQ_INPROG)) {
281 const struct cam_status_entry *entry;
283 entry = cam_fetch_status_entry(status);
284 printf("sgasync: Unable to attach new device "
285 "due to status %#x: %s\n", status, entry ?
286 entry->status_text : "Unknown");
291 cam_periph_async(periph, code, path, arg);
297 sgregister(struct cam_periph *periph, void *arg)
299 struct sg_softc *softc;
300 struct ccb_getdev *cgd;
301 struct ccb_pathinq cpi;
304 cgd = (struct ccb_getdev *)arg;
306 printf("sgregister: no getdev CCB, can't register device\n");
307 return (CAM_REQ_CMP_ERR);
310 softc = malloc(sizeof(*softc), M_DEVBUF, M_ZERO | M_NOWAIT);
312 printf("sgregister: Unable to allocate softc\n");
313 return (CAM_REQ_CMP_ERR);
316 softc->state = SG_STATE_NORMAL;
317 softc->pd_type = SID_TYPE(&cgd->inq_data);
318 softc->sg_timeout = SG_DEFAULT_TIMEOUT / SG_DEFAULT_HZ * hz;
319 softc->sg_user_timeout = SG_DEFAULT_TIMEOUT;
320 TAILQ_INIT(&softc->rdwr_done);
321 periph->softc = softc;
323 bzero(&cpi, sizeof(cpi));
324 xpt_setup_ccb(&cpi.ccb_h, periph->path, CAM_PRIORITY_NORMAL);
325 cpi.ccb_h.func_code = XPT_PATH_INQ;
326 xpt_action((union ccb *)&cpi);
329 * We pass in 0 for all blocksize, since we don't know what the
330 * blocksize of the device is, if it even has a blocksize.
332 cam_periph_unlock(periph);
333 no_tags = (cgd->inq_data.flags & SID_CmdQue) == 0;
334 softc->device_stats = devstat_new_entry("sg",
335 periph->unit_number, 0,
337 | (no_tags ? DEVSTAT_NO_ORDERED_TAGS : 0),
339 XPORT_DEVSTAT_TYPE(cpi.transport) |
341 DEVSTAT_PRIORITY_PASS);
344 * Acquire a reference to the periph before we create the devfs
345 * instance for it. We'll release this reference once the devfs
346 * instance has been freed.
348 if (cam_periph_acquire(periph) != CAM_REQ_CMP) {
349 xpt_print(periph->path, "%s: lost periph during "
350 "registration!\n", __func__);
351 cam_periph_lock(periph);
352 return (CAM_REQ_CMP_ERR);
355 /* Register the device */
356 softc->dev = make_dev(&sg_cdevsw, periph->unit_number,
357 UID_ROOT, GID_OPERATOR, 0600, "%s%d",
358 periph->periph_name, periph->unit_number);
359 if (periph->unit_number < 26) {
360 (void)make_dev_alias(softc->dev, "sg%c",
361 periph->unit_number + 'a');
363 (void)make_dev_alias(softc->dev, "sg%c%c",
364 ((periph->unit_number / 26) - 1) + 'a',
365 (periph->unit_number % 26) + 'a');
367 cam_periph_lock(periph);
368 softc->dev->si_drv1 = periph;
371 * Add as async callback so that we get
372 * notified if this device goes away.
374 xpt_register_async(AC_LOST_DEVICE, sgasync, periph, periph->path);
377 xpt_announce_periph(periph, NULL);
379 return (CAM_REQ_CMP);
383 sgdone(struct cam_periph *periph, union ccb *done_ccb)
385 struct sg_softc *softc;
386 struct ccb_scsiio *csio;
388 softc = (struct sg_softc *)periph->softc;
389 csio = &done_ccb->csio;
390 switch (csio->ccb_h.ccb_type) {
393 struct sg_rdwr *rdwr;
396 devstat_end_transaction(softc->device_stats,
398 csio->tag_action & 0xf,
399 ((csio->ccb_h.flags & CAM_DIR_MASK) ==
400 CAM_DIR_NONE) ? DEVSTAT_NO_DATA :
401 (csio->ccb_h.flags & CAM_DIR_OUT) ?
402 DEVSTAT_WRITE : DEVSTAT_READ,
405 rdwr = done_ccb->ccb_h.ccb_rdwr;
407 rdwr->state = SG_RDWR_DONE;
412 panic("unknown sg CCB type");
417 sgopen(struct cdev *dev, int flags, int fmt, struct thread *td)
419 struct cam_periph *periph;
420 struct sg_softc *softc;
423 periph = (struct cam_periph *)dev->si_drv1;
427 if (cam_periph_acquire(periph) != CAM_REQ_CMP)
431 * Don't allow access when we're running at a high securelevel.
433 error = securelevel_gt(td->td_ucred, 1);
435 cam_periph_release(periph);
439 cam_periph_lock(periph);
441 softc = (struct sg_softc *)periph->softc;
442 if (softc->flags & SG_FLAG_INVALID) {
443 cam_periph_release_locked(periph);
444 cam_periph_unlock(periph);
450 cam_periph_unlock(periph);
456 sgclose(struct cdev *dev, int flag, int fmt, struct thread *td)
458 struct cam_periph *periph;
459 struct sg_softc *softc;
462 periph = (struct cam_periph *)dev->si_drv1;
465 mtx = cam_periph_mtx(periph);
468 softc = periph->softc;
471 cam_periph_release_locked(periph);
474 * We reference the lock directly here, instead of using
475 * cam_periph_unlock(). The reason is that the call to
476 * cam_periph_release_locked() above could result in the periph
477 * getting freed. If that is the case, dereferencing the periph
478 * with a cam_periph_unlock() call would cause a page fault.
480 * cam_periph_release() avoids this problem using the same method,
481 * but we're manually acquiring and dropping the lock here to
482 * protect the open count and avoid another lock acquisition and
491 sgioctl(struct cdev *dev, u_long cmd, caddr_t arg, int flag, struct thread *td)
494 struct ccb_scsiio *csio;
495 struct cam_periph *periph;
496 struct sg_softc *softc;
497 struct sg_io_hdr *req;
500 periph = (struct cam_periph *)dev->si_drv1;
504 cam_periph_lock(periph);
506 softc = (struct sg_softc *)periph->softc;
510 case SG_GET_VERSION_NUM:
512 int *version = (int *)arg;
514 *version = sg_version;
519 u_int user_timeout = *(u_int *)arg;
521 softc->sg_user_timeout = user_timeout;
522 softc->sg_timeout = user_timeout / SG_DEFAULT_HZ * hz;
527 * The value is returned directly to the syscall.
529 td->td_retval[0] = softc->sg_user_timeout;
533 req = (struct sg_io_hdr *)arg;
535 if (req->cmd_len > IOCDBLEN) {
540 if (req->iovec_count != 0) {
545 ccb = cam_periph_getccb(periph, CAM_PRIORITY_NORMAL);
548 error = copyin(req->cmdp, &csio->cdb_io.cdb_bytes,
551 xpt_release_ccb(ccb);
555 switch(req->dxfer_direction) {
556 case SG_DXFER_TO_DEV:
559 case SG_DXFER_FROM_DEV:
562 case SG_DXFER_TO_FROM_DEV:
563 dir = CAM_DIR_IN | CAM_DIR_OUT;
582 error = sgsendccb(periph, ccb);
584 req->host_status = DID_ERROR;
585 req->driver_status = DRIVER_INVALID;
586 xpt_release_ccb(ccb);
590 req->status = csio->scsi_status;
591 req->masked_status = (csio->scsi_status >> 1) & 0x7f;
592 sg_scsiio_status(csio, &req->host_status, &req->driver_status);
593 req->resid = csio->resid;
594 req->duration = csio->ccb_h.timeout;
597 if ((csio->ccb_h.status & CAM_AUTOSNS_VALID)
598 && (req->sbp != NULL)) {
599 req->sb_len_wr = req->mx_sb_len - csio->sense_resid;
600 error = copyout(&csio->sense_data, req->sbp,
604 xpt_release_ccb(ccb);
607 case SG_GET_RESERVED_SIZE:
609 int *size = (int *)arg;
616 struct sg_scsi_id *id = (struct sg_scsi_id *)arg;
618 id->host_no = cam_sim_path(xpt_path_sim(periph->path));
619 id->channel = xpt_path_path_id(periph->path);
620 id->scsi_id = xpt_path_target_id(periph->path);
621 id->lun = xpt_path_lun_id(periph->path);
622 id->scsi_type = softc->pd_type;
623 id->h_cmd_per_lun = 1;
624 id->d_queue_depth = 1;
630 case SG_GET_SG_TABLESIZE:
632 int *size = (int *)arg;
637 case SG_EMULATED_HOST:
638 case SG_SET_TRANSFORM:
639 case SG_GET_TRANSFORM:
640 case SG_GET_NUM_WAITING:
642 case SG_GET_REQUEST_TABLE:
643 case SG_SET_KEEP_ORPHAN:
644 case SG_GET_KEEP_ORPHAN:
645 case SG_GET_ACCESS_COUNT:
646 case SG_SET_FORCE_LOW_DMA:
648 case SG_SET_FORCE_PACK_ID:
650 case SG_SET_RESERVED_SIZE:
651 case SG_GET_COMMAND_Q:
652 case SG_SET_COMMAND_Q:
654 case SG_NEXT_CMD_LEN:
657 printf("sgioctl: rejecting cmd 0x%lx\n", cmd);
663 cam_periph_unlock(periph);
668 sgwrite(struct cdev *dev, struct uio *uio, int ioflag)
671 struct cam_periph *periph;
672 struct ccb_scsiio *csio;
674 struct sg_header *hdr;
675 struct sg_rdwr *rdwr;
678 int error = 0, cdb_len, buf_len, dir;
680 periph = dev->si_drv1;
681 rdwr = malloc(sizeof(*rdwr), M_DEVBUF, M_WAITOK | M_ZERO);
682 hdr = &rdwr->hdr.hdr;
684 /* Copy in the header block and sanity check it */
685 if (uio->uio_resid < sizeof(*hdr)) {
689 error = uiomove(hdr, sizeof(*hdr), uio);
693 /* XXX: We don't support SG 3.x read/write API. */
694 if (hdr->reply_len < 0) {
699 ccb = xpt_alloc_ccb();
707 * Copy in the CDB block. The designers of the interface didn't
708 * bother to provide a size for this in the header, so we have to
709 * figure it out ourselves.
711 if (uio->uio_resid < 1)
713 error = uiomove(&cdb_cmd, 1, uio);
716 if (hdr->twelve_byte)
719 cdb_len = scsi_group_len(cdb_cmd);
721 * We've already read the first byte of the CDB and advanced the uio
722 * pointer. Just read the rest.
724 csio->cdb_io.cdb_bytes[0] = cdb_cmd;
725 error = uiomove(&csio->cdb_io.cdb_bytes[1], cdb_len - 1, uio);
730 * Now set up the data block. Again, the designers didn't bother
731 * to make this reliable.
733 buf_len = uio->uio_resid;
735 buf = malloc(buf_len, M_DEVBUF, M_WAITOK | M_ZERO);
736 error = uiomove(buf, buf_len, uio);
740 } else if (hdr->reply_len != 0) {
741 buf = malloc(hdr->reply_len, M_DEVBUF, M_WAITOK | M_ZERO);
742 buf_len = hdr->reply_len;
750 cam_periph_lock(periph);
752 xpt_setup_ccb(&ccb->ccb_h, periph->path, CAM_PRIORITY_NORMAL);
765 * Send off the command and hope that it works. This path does not
766 * go through sgstart because the I/O is supposed to be asynchronous.
769 rdwr->buf_len = buf_len;
770 rdwr->tag = hdr->pack_id;
772 rdwr->state = SG_RDWR_INPROG;
773 ccb->ccb_h.ccb_rdwr = rdwr;
774 ccb->ccb_h.ccb_type = SG_CCB_RDWR_IO;
775 TAILQ_INSERT_TAIL(&sc->rdwr_done, rdwr, rdwr_link);
776 error = sgsendrdwr(periph, ccb);
777 cam_periph_unlock(periph);
785 free(rdwr, M_DEVBUF);
790 sgread(struct cdev *dev, struct uio *uio, int ioflag)
792 struct ccb_scsiio *csio;
793 struct cam_periph *periph;
795 struct sg_header *hdr;
796 struct sg_rdwr *rdwr;
797 u_short hstat, dstat;
798 int error, pack_len, reply_len, pack_id;
800 periph = dev->si_drv1;
802 /* XXX The pack len field needs to be updated and written out instead
803 * of discarded. Not sure how to do that.
805 uio->uio_rw = UIO_WRITE;
806 if ((error = uiomove(&pack_len, 4, uio)) != 0)
808 if ((error = uiomove(&reply_len, 4, uio)) != 0)
810 if ((error = uiomove(&pack_id, 4, uio)) != 0)
812 uio->uio_rw = UIO_READ;
814 cam_periph_lock(periph);
817 TAILQ_FOREACH(rdwr, &sc->rdwr_done, rdwr_link) {
818 if (rdwr->tag == pack_id)
821 if ((rdwr == NULL) || (rdwr->state != SG_RDWR_DONE)) {
822 if (cam_periph_sleep(periph, rdwr, PCATCH, "sgread", 0) == ERESTART)
826 TAILQ_REMOVE(&sc->rdwr_done, rdwr, rdwr_link);
827 cam_periph_unlock(periph);
829 hdr = &rdwr->hdr.hdr;
830 csio = &rdwr->ccb->csio;
831 sg_scsiio_status(csio, &hstat, &dstat);
832 hdr->host_status = hstat;
833 hdr->driver_status = dstat;
834 hdr->target_status = csio->scsi_status >> 1;
838 case DID_PASSTHROUGH:
858 if (dstat == DRIVER_SENSE) {
859 bcopy(&csio->sense_data, hdr->sense_buffer,
860 min(csio->sense_len, SG_MAX_SENSE));
862 scsi_sense_print(csio);
866 error = uiomove(&hdr->result, sizeof(*hdr) -
867 offsetof(struct sg_header, result), uio);
868 if ((error == 0) && (hdr->result == 0))
869 error = uiomove(rdwr->buf, rdwr->buf_len, uio);
871 cam_periph_lock(periph);
872 xpt_free_ccb(rdwr->ccb);
873 cam_periph_unlock(periph);
874 free(rdwr->buf, M_DEVBUF);
875 free(rdwr, M_DEVBUF);
880 sgsendccb(struct cam_periph *periph, union ccb *ccb)
882 struct sg_softc *softc;
883 struct cam_periph_map_info mapinfo;
886 softc = periph->softc;
887 bzero(&mapinfo, sizeof(mapinfo));
890 * cam_periph_mapmem calls into proc and vm functions that can
891 * sleep as well as trigger I/O, so we can't hold the lock.
892 * Dropping it here is reasonably safe.
893 * The only CCB opcode that is possible here is XPT_SCSI_IO, no
894 * need for additional checks.
896 cam_periph_unlock(periph);
897 error = cam_periph_mapmem(ccb, &mapinfo);
898 cam_periph_lock(periph);
902 error = cam_periph_runccb(ccb,
906 softc->device_stats);
908 cam_periph_unmapmem(ccb, &mapinfo);
914 sgsendrdwr(struct cam_periph *periph, union ccb *ccb)
916 struct sg_softc *softc;
918 softc = periph->softc;
919 devstat_start_transaction(softc->device_stats, NULL);
925 sgerror(union ccb *ccb, uint32_t cam_flags, uint32_t sense_flags)
927 struct cam_periph *periph;
928 struct sg_softc *softc;
930 periph = xpt_path_periph(ccb->ccb_h.path);
931 softc = (struct sg_softc *)periph->softc;
933 return (cam_periph_error(ccb, cam_flags, sense_flags,
938 sg_scsiio_status(struct ccb_scsiio *csio, u_short *hoststat, u_short *drvstat)
942 status = csio->ccb_h.status;
944 switch (status & CAM_STATUS_MASK) {
949 case CAM_REQ_CMP_ERR:
950 *hoststat = DID_ERROR;
953 case CAM_REQ_ABORTED:
954 *hoststat = DID_ABORT;
957 case CAM_REQ_INVALID:
958 *hoststat = DID_ERROR;
959 *drvstat = DRIVER_INVALID;
961 case CAM_DEV_NOT_THERE:
962 *hoststat = DID_BAD_TARGET;
965 case CAM_SEL_TIMEOUT:
966 *hoststat = DID_NO_CONNECT;
969 case CAM_CMD_TIMEOUT:
970 *hoststat = DID_TIME_OUT;
973 case CAM_SCSI_STATUS_ERROR:
974 *hoststat = DID_ERROR;
977 case CAM_SCSI_BUS_RESET:
978 *hoststat = DID_RESET;
981 case CAM_UNCOR_PARITY:
982 *hoststat = DID_PARITY;
986 *hoststat = DID_BUS_BUSY;
990 *hoststat = DID_ERROR;
991 *drvstat = DRIVER_ERROR;
994 if (status & CAM_AUTOSNS_VALID)
995 *drvstat = DRIVER_SENSE;
999 scsi_group_len(u_char cmd)
1001 int len[] = {6, 10, 10, 12, 12, 12, 10, 10};
1004 group = (cmd >> 5) & 0x7;
1005 return (len[group]);