2 * bsg.c - block layer implementation of the sg v3 interface
7 * This file is subject to the terms and conditions of the GNU General Public
8 * License version 2. See the file "COPYING" in the main directory of this
9 * archive for more details.
14 * - Should this get merged, block/scsi_ioctl.c will be migrated into
15 * this file. To keep maintenance down, it's easier to have them
16 * seperated right now.
19 #include <linux/module.h>
20 #include <linux/init.h>
21 #include <linux/file.h>
22 #include <linux/blkdev.h>
23 #include <linux/poll.h>
24 #include <linux/cdev.h>
25 #include <linux/percpu.h>
26 #include <linux/uio.h>
27 #include <linux/bsg.h>
29 #include <scsi/scsi.h>
30 #include <scsi/scsi_ioctl.h>
31 #include <scsi/scsi_cmnd.h>
32 #include <scsi/scsi_device.h>
33 #include <scsi/scsi_driver.h>
36 static char bsg_version[] = "block layer sg (bsg) 0.4";
39 request_queue_t *queue;
41 struct list_head busy_list;
42 struct list_head done_list;
43 struct hlist_node dev_list;
48 wait_queue_head_t wq_done;
49 wait_queue_head_t wq_free;
50 char name[BUS_ID_SIZE];
60 #define BSG_DEFAULT_CMDS 64
65 #define dprintk(fmt, args...) printk(KERN_ERR "%s: " fmt, __FUNCTION__, ##args)
67 #define dprintk(fmt, args...)
70 #define list_entry_bc(entry) list_entry((entry), struct bsg_command, list)
75 #define BSG_MAJOR (240)
77 static DEFINE_MUTEX(bsg_mutex);
78 static int bsg_device_nr;
80 #define BSG_LIST_SIZE (8)
81 #define bsg_list_idx(minor) ((minor) & (BSG_LIST_SIZE - 1))
82 static struct hlist_head bsg_device_list[BSG_LIST_SIZE];
84 static struct class *bsg_class;
85 static LIST_HEAD(bsg_class_list);
87 static struct kmem_cache *bsg_cmd_cachep;
90 * our internal command type
93 struct bsg_device *bd;
94 struct list_head list;
99 struct sg_io_v4 __user *uhdr;
100 char sense[SCSI_SENSE_BUFFERSIZE];
103 static void bsg_free_command(struct bsg_command *bc)
105 struct bsg_device *bd = bc->bd;
108 kmem_cache_free(bsg_cmd_cachep, bc);
110 spin_lock_irqsave(&bd->lock, flags);
112 spin_unlock_irqrestore(&bd->lock, flags);
114 wake_up(&bd->wq_free);
117 static struct bsg_command *__bsg_alloc_command(struct bsg_device *bd)
119 struct bsg_command *bc = NULL;
121 spin_lock_irq(&bd->lock);
123 if (bd->queued_cmds >= bd->max_queue)
127 spin_unlock_irq(&bd->lock);
129 bc = kmem_cache_alloc(bsg_cmd_cachep, GFP_USER);
131 spin_lock_irq(&bd->lock);
136 memset(bc, 0, sizeof(*bc));
138 INIT_LIST_HEAD(&bc->list);
139 dprintk("%s: returning free cmd %p\n", bd->name, bc);
142 spin_unlock_irq(&bd->lock);
147 bsg_del_done_cmd(struct bsg_device *bd, struct bsg_command *bc)
154 bsg_add_done_cmd(struct bsg_device *bd, struct bsg_command *bc)
157 list_add_tail(&bc->list, &bd->done_list);
158 wake_up(&bd->wq_done);
161 static inline int bsg_io_schedule(struct bsg_device *bd, int state)
166 spin_lock_irq(&bd->lock);
168 BUG_ON(bd->done_cmds > bd->queued_cmds);
171 * -ENOSPC or -ENODATA? I'm going for -ENODATA, meaning "I have no
172 * work to do", even though we return -ENOSPC after this same test
173 * during bsg_write() -- there, it means our buffer can't have more
174 * bsg_commands added to it, thus has no space left.
176 if (bd->done_cmds == bd->queued_cmds) {
181 if (!test_bit(BSG_F_BLOCK, &bd->flags)) {
186 prepare_to_wait(&bd->wq_done, &wait, state);
187 spin_unlock_irq(&bd->lock);
189 finish_wait(&bd->wq_done, &wait);
191 if ((state == TASK_INTERRUPTIBLE) && signal_pending(current))
196 spin_unlock_irq(&bd->lock);
201 * get a new free command, blocking if needed and specified
203 static struct bsg_command *bsg_get_command(struct bsg_device *bd)
205 struct bsg_command *bc;
209 bc = __bsg_alloc_command(bd);
213 ret = bsg_io_schedule(bd, TASK_INTERRUPTIBLE);
224 static int blk_fill_sgv4_hdr_rq(request_queue_t *q, struct request *rq,
225 struct sg_io_v4 *hdr, int has_write_perm)
227 memset(rq->cmd, 0, BLK_MAX_CDB); /* ATAPI hates garbage after CDB */
229 if (copy_from_user(rq->cmd, (void *)(unsigned long)hdr->request,
232 if (blk_verify_command(rq->cmd, has_write_perm))
236 * fill in request structure
238 rq->cmd_len = hdr->request_len;
239 rq->cmd_type = REQ_TYPE_BLOCK_PC;
241 rq->timeout = (hdr->timeout * HZ) / 1000;
243 rq->timeout = q->sg_timeout;
245 rq->timeout = BLK_DEFAULT_SG_TIMEOUT;
251 * Check if sg_io_v4 from user is allowed and valid
254 bsg_validate_sgv4_hdr(request_queue_t *q, struct sg_io_v4 *hdr, int *rw)
256 if (hdr->guard != 'Q')
258 if (hdr->request_len > BLK_MAX_CDB)
260 if (hdr->dout_xfer_len > (q->max_sectors << 9) ||
261 hdr->din_xfer_len > (q->max_sectors << 9))
264 /* not supported currently */
265 if (hdr->protocol || hdr->subprotocol)
269 * looks sane, if no data then it should be fine from our POV
271 if (!hdr->dout_xfer_len && !hdr->din_xfer_len)
274 /* not supported currently */
275 if (hdr->dout_xfer_len && hdr->din_xfer_len)
278 *rw = hdr->dout_xfer_len ? WRITE : READ;
284 * map sg_io_v4 to a request.
286 static struct request *
287 bsg_map_hdr(struct bsg_device *bd, struct sg_io_v4 *hdr)
289 request_queue_t *q = bd->queue;
291 int ret, rw = 0; /* shut up gcc */
292 unsigned int dxfer_len;
295 dprintk("map hdr %llx/%u %llx/%u\n", (unsigned long long) hdr->dout_xferp,
296 hdr->dout_xfer_len, (unsigned long long) hdr->din_xferp,
299 ret = bsg_validate_sgv4_hdr(q, hdr, &rw);
304 * map scatter-gather elements seperately and string them to request
306 rq = blk_get_request(q, rw, GFP_KERNEL);
307 ret = blk_fill_sgv4_hdr_rq(q, rq, hdr, test_bit(BSG_F_WRITE_PERM,
314 if (hdr->dout_xfer_len) {
315 dxfer_len = hdr->dout_xfer_len;
316 dxferp = (void*)(unsigned long)hdr->dout_xferp;
317 } else if (hdr->din_xfer_len) {
318 dxfer_len = hdr->din_xfer_len;
319 dxferp = (void*)(unsigned long)hdr->din_xferp;
324 ret = blk_rq_map_user(q, rq, dxferp, dxfer_len);
326 dprintk("failed map at %d\n", ret);
336 * async completion call-back from the block layer, when scsi/ide/whatever
337 * calls end_that_request_last() on a request
339 static void bsg_rq_end_io(struct request *rq, int uptodate)
341 struct bsg_command *bc = rq->end_io_data;
342 struct bsg_device *bd = bc->bd;
345 dprintk("%s: finished rq %p bc %p, bio %p stat %d\n",
346 bd->name, rq, bc, bc->bio, uptodate);
348 bc->hdr.duration = jiffies_to_msecs(jiffies - bc->hdr.duration);
350 spin_lock_irqsave(&bd->lock, flags);
352 bsg_add_done_cmd(bd, bc);
353 spin_unlock_irqrestore(&bd->lock, flags);
357 * do final setup of a 'bc' and submit the matching 'rq' to the block
360 static void bsg_add_command(struct bsg_device *bd, request_queue_t *q,
361 struct bsg_command *bc, struct request *rq)
363 rq->sense = bc->sense;
367 * add bc command to busy queue and submit rq for io
371 bc->hdr.duration = jiffies;
372 spin_lock_irq(&bd->lock);
373 list_add_tail(&bc->list, &bd->busy_list);
374 spin_unlock_irq(&bd->lock);
376 dprintk("%s: queueing rq %p, bc %p\n", bd->name, rq, bc);
378 rq->end_io_data = bc;
379 blk_execute_rq_nowait(q, NULL, rq, 1, bsg_rq_end_io);
382 static inline struct bsg_command *bsg_next_done_cmd(struct bsg_device *bd)
384 struct bsg_command *bc = NULL;
386 spin_lock_irq(&bd->lock);
388 bc = list_entry_bc(bd->done_list.next);
389 bsg_del_done_cmd(bd, bc);
391 spin_unlock_irq(&bd->lock);
397 * Get a finished command from the done list
399 static struct bsg_command *__bsg_get_done_cmd(struct bsg_device *bd, int state)
401 struct bsg_command *bc;
405 bc = bsg_next_done_cmd(bd);
409 ret = bsg_io_schedule(bd, state);
416 dprintk("%s: returning done %p\n", bd->name, bc);
421 static struct bsg_command *
422 bsg_get_done_cmd(struct bsg_device *bd, const struct iovec *iov)
424 return __bsg_get_done_cmd(bd, TASK_INTERRUPTIBLE);
427 static struct bsg_command *
428 bsg_get_done_cmd_nosignals(struct bsg_device *bd)
430 return __bsg_get_done_cmd(bd, TASK_UNINTERRUPTIBLE);
433 static int blk_complete_sgv4_hdr_rq(struct request *rq, struct sg_io_v4 *hdr,
438 dprintk("rq %p bio %p %u\n", rq, bio, rq->errors);
440 * fill in all the output members
442 hdr->device_status = status_byte(rq->errors);
443 hdr->transport_status = host_byte(rq->errors);
444 hdr->driver_status = driver_byte(rq->errors);
446 if (hdr->device_status || hdr->transport_status || hdr->driver_status)
447 hdr->info |= SG_INFO_CHECK;
448 hdr->din_resid = rq->data_len;
449 hdr->response_len = 0;
451 if (rq->sense_len && hdr->response) {
452 int len = min((unsigned int) hdr->max_response_len,
455 ret = copy_to_user((void*)(unsigned long)hdr->response,
458 hdr->response_len = len;
463 blk_rq_unmap_user(bio);
469 static int bsg_complete_all_commands(struct bsg_device *bd)
471 struct bsg_command *bc;
474 dprintk("%s: entered\n", bd->name);
476 set_bit(BSG_F_BLOCK, &bd->flags);
479 * wait for all commands to complete
483 ret = bsg_io_schedule(bd, TASK_UNINTERRUPTIBLE);
485 * look for -ENODATA specifically -- we'll sometimes get
486 * -ERESTARTSYS when we've taken a signal, but we can't
487 * return until we're done freeing the queue, so ignore
488 * it. The signal will get handled when we're done freeing
491 } while (ret != -ENODATA);
494 * discard done commands
498 bc = bsg_get_done_cmd_nosignals(bd);
501 * we _must_ complete before restarting, because
502 * bsg_release can't handle this failing.
504 if (PTR_ERR(bc) == -ERESTARTSYS)
511 tret = blk_complete_sgv4_hdr_rq(bc->rq, &bc->hdr, bc->bio);
515 bsg_free_command(bc);
521 typedef struct bsg_command *(*bsg_command_callback)(struct bsg_device *bd, const struct iovec *iov);
524 __bsg_read(char __user *buf, size_t count, bsg_command_callback get_bc,
525 struct bsg_device *bd, const struct iovec *iov, ssize_t *bytes_read)
527 struct bsg_command *bc;
528 int nr_commands, ret;
530 if (count % sizeof(struct sg_io_v4))
534 nr_commands = count / sizeof(struct sg_io_v4);
535 while (nr_commands) {
536 bc = get_bc(bd, iov);
543 * this is the only case where we need to copy data back
544 * after completing the request. so do that here,
545 * bsg_complete_work() cannot do that for us
547 ret = blk_complete_sgv4_hdr_rq(bc->rq, &bc->hdr, bc->bio);
549 if (copy_to_user(buf, (char *) &bc->hdr, sizeof(bc->hdr)))
552 bsg_free_command(bc);
557 buf += sizeof(struct sg_io_v4);
558 *bytes_read += sizeof(struct sg_io_v4);
565 static inline void bsg_set_block(struct bsg_device *bd, struct file *file)
567 if (file->f_flags & O_NONBLOCK)
568 clear_bit(BSG_F_BLOCK, &bd->flags);
570 set_bit(BSG_F_BLOCK, &bd->flags);
573 static inline void bsg_set_write_perm(struct bsg_device *bd, struct file *file)
575 if (file->f_mode & FMODE_WRITE)
576 set_bit(BSG_F_WRITE_PERM, &bd->flags);
578 clear_bit(BSG_F_WRITE_PERM, &bd->flags);
581 static inline int err_block_err(int ret)
583 if (ret && ret != -ENOSPC && ret != -ENODATA && ret != -EAGAIN)
590 bsg_read(struct file *file, char __user *buf, size_t count, loff_t *ppos)
592 struct bsg_device *bd = file->private_data;
596 dprintk("%s: read %Zd bytes\n", bd->name, count);
598 bsg_set_block(bd, file);
600 ret = __bsg_read(buf, count, bsg_get_done_cmd,
601 bd, NULL, &bytes_read);
604 if (!bytes_read || (bytes_read && err_block_err(ret)))
610 static ssize_t __bsg_write(struct bsg_device *bd, const char __user *buf,
611 size_t count, ssize_t *bytes_read)
613 struct bsg_command *bc;
615 int ret, nr_commands;
617 if (count % sizeof(struct sg_io_v4))
620 nr_commands = count / sizeof(struct sg_io_v4);
624 while (nr_commands) {
625 request_queue_t *q = bd->queue;
627 bc = bsg_get_command(bd);
636 bc->uhdr = (struct sg_io_v4 __user *) buf;
637 if (copy_from_user(&bc->hdr, buf, sizeof(bc->hdr))) {
643 * get a request, fill in the blanks, and add to request queue
645 rq = bsg_map_hdr(bd, &bc->hdr);
652 bsg_add_command(bd, q, bc, rq);
656 buf += sizeof(struct sg_io_v4);
657 *bytes_read += sizeof(struct sg_io_v4);
661 bsg_free_command(bc);
667 bsg_write(struct file *file, const char __user *buf, size_t count, loff_t *ppos)
669 struct bsg_device *bd = file->private_data;
673 dprintk("%s: write %Zd bytes\n", bd->name, count);
675 bsg_set_block(bd, file);
676 bsg_set_write_perm(bd, file);
679 ret = __bsg_write(bd, buf, count, &bytes_read);
683 * return bytes written on non-fatal errors
685 if (!bytes_read || (bytes_read && err_block_err(ret)))
688 dprintk("%s: returning %Zd\n", bd->name, bytes_read);
692 static struct bsg_device *bsg_alloc_device(void)
694 struct bsg_device *bd;
696 bd = kzalloc(sizeof(struct bsg_device), GFP_KERNEL);
700 spin_lock_init(&bd->lock);
702 bd->max_queue = BSG_DEFAULT_CMDS;
704 INIT_LIST_HEAD(&bd->busy_list);
705 INIT_LIST_HEAD(&bd->done_list);
706 INIT_HLIST_NODE(&bd->dev_list);
708 init_waitqueue_head(&bd->wq_free);
709 init_waitqueue_head(&bd->wq_done);
713 static int bsg_put_device(struct bsg_device *bd)
717 mutex_lock(&bsg_mutex);
719 if (!atomic_dec_and_test(&bd->ref_count))
722 dprintk("%s: tearing down\n", bd->name);
725 * close can always block
727 set_bit(BSG_F_BLOCK, &bd->flags);
730 * correct error detection baddies here again. it's the responsibility
731 * of the app to properly reap commands before close() if it wants
732 * fool-proof error detection
734 ret = bsg_complete_all_commands(bd);
736 blk_put_queue(bd->queue);
737 hlist_del(&bd->dev_list);
740 mutex_unlock(&bsg_mutex);
744 static struct bsg_device *bsg_add_device(struct inode *inode,
745 struct request_queue *rq,
748 struct bsg_device *bd = NULL;
750 unsigned char buf[32];
753 bd = bsg_alloc_device();
755 return ERR_PTR(-ENOMEM);
758 kobject_get(&rq->kobj);
759 bsg_set_block(bd, file);
761 atomic_set(&bd->ref_count, 1);
762 bd->minor = iminor(inode);
763 mutex_lock(&bsg_mutex);
764 hlist_add_head(&bd->dev_list, &bsg_device_list[bsg_list_idx(bd->minor)]);
766 strncpy(bd->name, rq->bsg_dev.class_dev->class_id, sizeof(bd->name) - 1);
767 dprintk("bound to <%s>, max queue %d\n",
768 format_dev_t(buf, inode->i_rdev), bd->max_queue);
770 mutex_unlock(&bsg_mutex);
774 static struct bsg_device *__bsg_get_device(int minor)
776 struct hlist_head *list = &bsg_device_list[bsg_list_idx(minor)];
777 struct bsg_device *bd = NULL;
778 struct hlist_node *entry;
780 mutex_lock(&bsg_mutex);
782 hlist_for_each(entry, list) {
783 bd = hlist_entry(entry, struct bsg_device, dev_list);
784 if (bd->minor == minor) {
785 atomic_inc(&bd->ref_count);
792 mutex_unlock(&bsg_mutex);
796 static struct bsg_device *bsg_get_device(struct inode *inode, struct file *file)
798 struct bsg_device *bd = __bsg_get_device(iminor(inode));
799 struct bsg_class_device *bcd, *__bcd;
805 * find the class device
808 mutex_lock(&bsg_mutex);
809 list_for_each_entry(__bcd, &bsg_class_list, list) {
810 if (__bcd->minor == iminor(inode)) {
815 mutex_unlock(&bsg_mutex);
818 return ERR_PTR(-ENODEV);
820 return bsg_add_device(inode, bcd->queue, file);
823 static int bsg_open(struct inode *inode, struct file *file)
825 struct bsg_device *bd = bsg_get_device(inode, file);
830 file->private_data = bd;
834 static int bsg_release(struct inode *inode, struct file *file)
836 struct bsg_device *bd = file->private_data;
838 file->private_data = NULL;
839 return bsg_put_device(bd);
842 static unsigned int bsg_poll(struct file *file, poll_table *wait)
844 struct bsg_device *bd = file->private_data;
845 unsigned int mask = 0;
847 poll_wait(file, &bd->wq_done, wait);
848 poll_wait(file, &bd->wq_free, wait);
850 spin_lock_irq(&bd->lock);
851 if (!list_empty(&bd->done_list))
852 mask |= POLLIN | POLLRDNORM;
853 if (bd->queued_cmds >= bd->max_queue)
855 spin_unlock_irq(&bd->lock);
861 bsg_ioctl(struct inode *inode, struct file *file, unsigned int cmd,
864 struct bsg_device *bd = file->private_data;
865 int __user *uarg = (int __user *) arg;
874 case SG_GET_COMMAND_Q:
875 return put_user(bd->max_queue, uarg);
876 case SG_SET_COMMAND_Q: {
879 if (get_user(queue, uarg))
884 spin_lock_irq(&bd->lock);
885 bd->max_queue = queue;
886 spin_unlock_irq(&bd->lock);
893 case SG_GET_VERSION_NUM:
894 case SCSI_IOCTL_GET_IDLUN:
895 case SCSI_IOCTL_GET_BUS_NUMBER:
898 case SG_GET_RESERVED_SIZE:
899 case SG_SET_RESERVED_SIZE:
900 case SG_EMULATED_HOST:
901 case SCSI_IOCTL_SEND_COMMAND: {
902 void __user *uarg = (void __user *) arg;
903 return scsi_cmd_ioctl(file, bd->queue, NULL, cmd, uarg);
910 if (copy_from_user(&hdr, uarg, sizeof(hdr)))
913 rq = bsg_map_hdr(bd, &hdr);
918 blk_execute_rq(bd->queue, NULL, rq, 0);
919 blk_complete_sgv4_hdr_rq(rq, &hdr, bio);
921 if (copy_to_user(uarg, &hdr, sizeof(hdr)))
927 * block device ioctls
931 return ioctl_by_bdev(bd->bdev, cmd, arg);
938 static struct file_operations bsg_fops = {
943 .release = bsg_release,
945 .owner = THIS_MODULE,
948 void bsg_unregister_queue(struct request_queue *q)
950 struct bsg_class_device *bcd = &q->bsg_dev;
955 mutex_lock(&bsg_mutex);
956 sysfs_remove_link(&q->kobj, "bsg");
957 class_device_destroy(bsg_class, MKDEV(BSG_MAJOR, bcd->minor));
958 bcd->class_dev = NULL;
959 list_del_init(&bcd->list);
960 mutex_unlock(&bsg_mutex);
963 int bsg_register_queue(struct request_queue *q, char *name)
965 struct bsg_class_device *bcd;
968 struct class_device *class_dev = NULL;
971 * we need a proper transport to send commands, not a stacked device
977 memset(bcd, 0, sizeof(*bcd));
978 INIT_LIST_HEAD(&bcd->list);
980 mutex_lock(&bsg_mutex);
981 dev = MKDEV(BSG_MAJOR, bsg_device_nr);
982 bcd->minor = bsg_device_nr;
985 class_dev = class_device_create(bsg_class, NULL, dev, bcd->dev, "%s", name);
986 if (IS_ERR(class_dev)) {
987 ret = PTR_ERR(class_dev);
990 bcd->class_dev = class_dev;
992 if (q->kobj.dentry) {
993 ret = sysfs_create_link(&q->kobj, &bcd->class_dev->kobj, "bsg");
998 list_add_tail(&bcd->list, &bsg_class_list);
1000 mutex_unlock(&bsg_mutex);
1005 class_device_destroy(bsg_class, MKDEV(BSG_MAJOR, bcd->minor));
1006 mutex_unlock(&bsg_mutex);
1010 static int bsg_add(struct class_device *cl_dev, struct class_interface *cl_intf)
1013 struct scsi_device *sdp = to_scsi_device(cl_dev->dev);
1014 struct request_queue *rq = sdp->request_queue;
1016 if (rq->kobj.parent)
1017 ret = bsg_register_queue(rq, kobject_name(rq->kobj.parent));
1019 ret = bsg_register_queue(rq, kobject_name(&sdp->sdev_gendev.kobj));
1023 static void bsg_remove(struct class_device *cl_dev, struct class_interface *cl_intf)
1025 bsg_unregister_queue(to_scsi_device(cl_dev->dev)->request_queue);
1028 static struct class_interface bsg_intf = {
1030 .remove = bsg_remove,
1033 static int __init bsg_init(void)
1037 bsg_cmd_cachep = kmem_cache_create("bsg_cmd",
1038 sizeof(struct bsg_command), 0, 0, NULL, NULL);
1039 if (!bsg_cmd_cachep) {
1040 printk(KERN_ERR "bsg: failed creating slab cache\n");
1044 for (i = 0; i < BSG_LIST_SIZE; i++)
1045 INIT_HLIST_HEAD(&bsg_device_list[i]);
1047 bsg_class = class_create(THIS_MODULE, "bsg");
1048 if (IS_ERR(bsg_class)) {
1049 kmem_cache_destroy(bsg_cmd_cachep);
1050 return PTR_ERR(bsg_class);
1053 ret = register_chrdev(BSG_MAJOR, "bsg", &bsg_fops);
1055 kmem_cache_destroy(bsg_cmd_cachep);
1056 class_destroy(bsg_class);
1060 ret = scsi_register_interface(&bsg_intf);
1062 printk(KERN_ERR "bsg: failed register scsi interface %d\n", ret);
1063 kmem_cache_destroy(bsg_cmd_cachep);
1064 class_destroy(bsg_class);
1065 unregister_chrdev(BSG_MAJOR, "bsg");
1069 printk(KERN_INFO "%s loaded\n", bsg_version);
1073 MODULE_AUTHOR("Jens Axboe");
1074 MODULE_DESCRIPTION("Block layer SGSI generic (sg) driver");
1075 MODULE_LICENSE("GPL");
1077 device_initcall(bsg_init);