xref: /openbmc/linux/block/bsg.c (revision 1ac731c529cd4d6adbce134754b51ff7d822b145)
1 8c16567dSChristoph Hellwig // SPDX-License-Identifier: GPL-2.0
2 3d6392cfSJens Axboe /*
3 0c6a89baSFUJITA Tomonori  * bsg.c - block layer implementation of the sg v4 interface
4 3d6392cfSJens Axboe  */
5 3d6392cfSJens Axboe #include <linux/module.h>
6 3d6392cfSJens Axboe #include <linux/init.h>
7 3d6392cfSJens Axboe #include <linux/file.h>
8 3d6392cfSJens Axboe #include <linux/blkdev.h>
9 3d6392cfSJens Axboe #include <linux/cdev.h>
10 ad5ebd2fSRandy Dunlap #include <linux/jiffies.h>
11 3d6392cfSJens Axboe #include <linux/percpu.h>
12 598443a2SFUJITA Tomonori #include <linux/idr.h>
13 3d6392cfSJens Axboe #include <linux/bsg.h>
14 5a0e3ad6STejun Heo #include <linux/slab.h>
15 3d6392cfSJens Axboe 
16 3d6392cfSJens Axboe #include <scsi/scsi.h>
17 3d6392cfSJens Axboe #include <scsi/scsi_ioctl.h>
18 3d6392cfSJens Axboe #include <scsi/sg.h>
19 3d6392cfSJens Axboe 
20 0ed081ceSFUJITA Tomonori #define BSG_DESCRIPTION	"Block layer SCSI generic (bsg) driver"
21 0ed081ceSFUJITA Tomonori #define BSG_VERSION	"0.4"
22 3d6392cfSJens Axboe 
23 3d6392cfSJens Axboe struct bsg_device {
24 165125e1SJens Axboe 	struct request_queue *queue;
25 ead09dd3SChristoph Hellwig 	struct device device;
26 ead09dd3SChristoph Hellwig 	struct cdev cdev;
27 3d6392cfSJens Axboe 	int max_queue;
28 1e61c1a8SChristoph Hellwig 	unsigned int timeout;
29 1e61c1a8SChristoph Hellwig 	unsigned int reserved_size;
30 75ca5640SChristoph Hellwig 	bsg_sg_io_fn *sg_io_fn;
31 3d6392cfSJens Axboe };
32 3d6392cfSJens Axboe 
to_bsg_device(struct inode * inode)33 ead09dd3SChristoph Hellwig static inline struct bsg_device *to_bsg_device(struct inode *inode)
34 ead09dd3SChristoph Hellwig {
35 ead09dd3SChristoph Hellwig 	return container_of(inode->i_cdev, struct bsg_device, cdev);
36 ead09dd3SChristoph Hellwig }
37 ead09dd3SChristoph Hellwig 
38 5309cb38SJens Axboe #define BSG_DEFAULT_CMDS	64
39 292b7f27SFUJITA Tomonori #define BSG_MAX_DEVS		(1 << MINORBITS)
40 3d6392cfSJens Axboe 
41 ead09dd3SChristoph Hellwig static DEFINE_IDA(bsg_minor_ida);
42 3d6392cfSJens Axboe static const struct class bsg_class;
43 46f6ef4aSJens Axboe static int bsg_major;
44 3d6392cfSJens Axboe 
bsg_timeout(struct bsg_device * bd,struct sg_io_v4 * hdr)45 75ca5640SChristoph Hellwig static unsigned int bsg_timeout(struct bsg_device *bd, struct sg_io_v4 *hdr)
46 75ca5640SChristoph Hellwig {
47 75ca5640SChristoph Hellwig 	unsigned int timeout = BLK_DEFAULT_SG_TIMEOUT;
48 75ca5640SChristoph Hellwig 
49 75ca5640SChristoph Hellwig 	if (hdr->timeout)
50 75ca5640SChristoph Hellwig 		timeout = msecs_to_jiffies(hdr->timeout);
51 75ca5640SChristoph Hellwig 	else if (bd->timeout)
52 75ca5640SChristoph Hellwig 		timeout = bd->timeout;
53 75ca5640SChristoph Hellwig 
54 75ca5640SChristoph Hellwig 	return max_t(unsigned int, timeout, BLK_MIN_SG_TIMEOUT);
55 75ca5640SChristoph Hellwig }
56 17cb960fSChristoph Hellwig 
bsg_sg_io(struct bsg_device * bd,bool open_for_write,void __user * uarg)57 ead09dd3SChristoph Hellwig static int bsg_sg_io(struct bsg_device *bd, bool open_for_write,
58 17cb960fSChristoph Hellwig 		     void __user *uarg)
59 ccf3209fSChristoph Hellwig {
60 17cb960fSChristoph Hellwig 	struct sg_io_v4 hdr;
61 17cb960fSChristoph Hellwig 	int ret;
62 ccf3209fSChristoph Hellwig 
63 ccf3209fSChristoph Hellwig 	if (copy_from_user(&hdr, uarg, sizeof(hdr)))
64 ccf3209fSChristoph Hellwig 		return -EFAULT;
65 ccf3209fSChristoph Hellwig 	if (hdr.guard != 'Q')
66 75ca5640SChristoph Hellwig 		return -EINVAL;
67 972248e9SChristoph Hellwig 	ret = bd->sg_io_fn(bd->queue, &hdr, open_for_write,
68 ccf3209fSChristoph Hellwig 			   bsg_timeout(bd, &hdr));
69 ccf3209fSChristoph Hellwig 	if (!ret && copy_to_user(uarg, &hdr, sizeof(hdr)))
70 70e36eceSFUJITA Tomonori 		return -EFAULT;
71 70e36eceSFUJITA Tomonori 	return ret;
72 3d6392cfSJens Axboe }
73 3d6392cfSJens Axboe 
bsg_open(struct inode * inode,struct file * file)74 ead09dd3SChristoph Hellwig static int bsg_open(struct inode *inode, struct file *file)
75 ead09dd3SChristoph Hellwig {
76 3d6392cfSJens Axboe 	if (!blk_get_queue(to_bsg_device(inode)->queue))
77 3d6392cfSJens Axboe 		return -ENXIO;
78 3d6392cfSJens Axboe 	return 0;
79 3d6392cfSJens Axboe }
80 3d6392cfSJens Axboe 
bsg_release(struct inode * inode,struct file * file)81 ead09dd3SChristoph Hellwig static int bsg_release(struct inode *inode, struct file *file)
82 ead09dd3SChristoph Hellwig {
83 3d6392cfSJens Axboe 	blk_put_queue(to_bsg_device(inode)->queue);
84 3d6392cfSJens Axboe 	return 0;
85 ccf3209fSChristoph Hellwig }
86 3d6392cfSJens Axboe 
bsg_get_command_q(struct bsg_device * bd,int __user * uarg)87 ead09dd3SChristoph Hellwig static int bsg_get_command_q(struct bsg_device *bd, int __user *uarg)
88 ccf3209fSChristoph Hellwig {
89 ccf3209fSChristoph Hellwig 	return put_user(READ_ONCE(bd->max_queue), uarg);
90 ccf3209fSChristoph Hellwig }
91 ccf3209fSChristoph Hellwig 
bsg_set_command_q(struct bsg_device * bd,int __user * uarg)92 ead09dd3SChristoph Hellwig static int bsg_set_command_q(struct bsg_device *bd, int __user *uarg)
93 3d6392cfSJens Axboe {
94 ead09dd3SChristoph Hellwig 	int max_queue;
95 3d6392cfSJens Axboe 
96 ead09dd3SChristoph Hellwig 	if (get_user(max_queue, uarg))
97 3d6392cfSJens Axboe 		return -EFAULT;
98 ead09dd3SChristoph Hellwig 	if (max_queue < 1)
99 3d6392cfSJens Axboe 		return -EINVAL;
100 3d6392cfSJens Axboe 	WRITE_ONCE(bd->max_queue, max_queue);
101 3d6392cfSJens Axboe 	return 0;
102 ccf3209fSChristoph Hellwig }
103 ccf3209fSChristoph Hellwig 
bsg_ioctl(struct file * file,unsigned int cmd,unsigned long arg)104 ead09dd3SChristoph Hellwig static long bsg_ioctl(struct file *file, unsigned int cmd, unsigned long arg)
105 d52fe8f4SChristoph Hellwig {
106 ccf3209fSChristoph Hellwig 	struct bsg_device *bd = to_bsg_device(file_inode(file));
107 d52fe8f4SChristoph Hellwig 	struct request_queue *q = bd->queue;
108 d52fe8f4SChristoph Hellwig 	void __user *uarg = (void __user *) arg;
109 ccf3209fSChristoph Hellwig 	int __user *intp = uarg;
110 ccf3209fSChristoph Hellwig 	int val;
111 ccf3209fSChristoph Hellwig 
112 ccf3209fSChristoph Hellwig 	switch (cmd) {
113 ccf3209fSChristoph Hellwig 	/*
114 ccf3209fSChristoph Hellwig 	 * Our own ioctls
115 ccf3209fSChristoph Hellwig 	 */
116 ccf3209fSChristoph Hellwig 	case SG_GET_COMMAND_Q:
117 ccf3209fSChristoph Hellwig 		return bsg_get_command_q(bd, uarg);
118 ccf3209fSChristoph Hellwig 	case SG_SET_COMMAND_Q:
119 3d6392cfSJens Axboe 		return bsg_set_command_q(bd, uarg);
120 3d6392cfSJens Axboe 
121 3d6392cfSJens Axboe 	/*
122 3d6392cfSJens Axboe 	 * SCSI/sg ioctls
123 d52fe8f4SChristoph Hellwig 	 */
124 3d6392cfSJens Axboe 	case SG_GET_VERSION_NUM:
125 d52fe8f4SChristoph Hellwig 		return put_user(30527, intp);
126 3d6392cfSJens Axboe 	case SCSI_IOCTL_GET_IDLUN:
127 d52fe8f4SChristoph Hellwig 		return put_user(0, intp);
128 3d6392cfSJens Axboe 	case SCSI_IOCTL_GET_BUS_NUMBER:
129 d52fe8f4SChristoph Hellwig 		return put_user(0, intp);
130 d52fe8f4SChristoph Hellwig 	case SG_SET_TIMEOUT:
131 1e61c1a8SChristoph Hellwig 		if (get_user(val, intp))
132 d52fe8f4SChristoph Hellwig 			return -EFAULT;
133 3d6392cfSJens Axboe 		bd->timeout = clock_t_to_jiffies(val);
134 1e61c1a8SChristoph Hellwig 		return 0;
135 3d6392cfSJens Axboe 	case SG_GET_TIMEOUT:
136 1e61c1a8SChristoph Hellwig 		return jiffies_to_clock_t(bd->timeout);
137 d52fe8f4SChristoph Hellwig 	case SG_GET_RESERVED_SIZE:
138 3d6392cfSJens Axboe 		return put_user(min(bd->reserved_size, queue_max_bytes(q)),
139 d52fe8f4SChristoph Hellwig 				intp);
140 d52fe8f4SChristoph Hellwig 	case SG_SET_RESERVED_SIZE:
141 d52fe8f4SChristoph Hellwig 		if (get_user(val, intp))
142 d52fe8f4SChristoph Hellwig 			return -EFAULT;
143 1e61c1a8SChristoph Hellwig 		if (val < 0)
144 d52fe8f4SChristoph Hellwig 			return -EINVAL;
145 d52fe8f4SChristoph Hellwig 		bd->reserved_size =
146 3d6392cfSJens Axboe 			min_t(unsigned int, val, queue_max_bytes(q));
147 d52fe8f4SChristoph Hellwig 		return 0;
148 ccf3209fSChristoph Hellwig 	case SG_EMULATED_HOST:
149 ead09dd3SChristoph Hellwig 		return put_user(1, intp);
150 beec64d0SChristoph Hellwig 	case SG_IO:
151 beec64d0SChristoph Hellwig 		return bsg_sg_io(bd, file->f_mode & FMODE_WRITE, uarg);
152 beec64d0SChristoph Hellwig 	case SCSI_IOCTL_SEND_COMMAND:
153 beec64d0SChristoph Hellwig 		pr_warn_ratelimited("%s: calling unsupported SCSI_IOCTL_SEND_COMMAND\n",
154 3d6392cfSJens Axboe 				current->comm);
155 3d6392cfSJens Axboe 		return -EINVAL;
156 3d6392cfSJens Axboe 	default:
157 3d6392cfSJens Axboe 		return -ENOTTY;
158 3d6392cfSJens Axboe 	}
159 7344be05SArjan van de Ven }
160 3d6392cfSJens Axboe 
161 3d6392cfSJens Axboe static const struct file_operations bsg_fops = {
162 25fd1643SJens Axboe 	.open		=	bsg_open,
163 fe0da4e5SArnd Bergmann 	.release	=	bsg_release,
164 3d6392cfSJens Axboe 	.unlocked_ioctl	=	bsg_ioctl,
165 6038f373SArnd Bergmann 	.compat_ioctl	=	compat_ptr_ioctl,
166 3d6392cfSJens Axboe 	.owner		=	THIS_MODULE,
167 3d6392cfSJens Axboe 	.llseek		=	default_llseek,
168 1a0db774SZenghui Yu };
169 1a0db774SZenghui Yu 
bsg_device_release(struct device * dev)170 1a0db774SZenghui Yu static void bsg_device_release(struct device *dev)
171 1a0db774SZenghui Yu {
172 873cdda1SBo Liu 	struct bsg_device *bd = container_of(dev, struct bsg_device, device);
173 1a0db774SZenghui Yu 
174 1a0db774SZenghui Yu 	ida_free(&bsg_minor_ida, MINOR(bd->device.devt));
175 1a0db774SZenghui Yu 	kfree(bd);
176 ead09dd3SChristoph Hellwig }
177 3d6392cfSJens Axboe 
bsg_unregister_queue(struct bsg_device * bd)178 2bd85221SChristoph Hellwig void bsg_unregister_queue(struct bsg_device *bd)
179 2bd85221SChristoph Hellwig {
180 2bd85221SChristoph Hellwig 	struct gendisk *disk = bd->queue->disk;
181 2bd85221SChristoph Hellwig 
182 ead09dd3SChristoph Hellwig 	if (disk && disk->queue_kobj.sd)
183 1a0db774SZenghui Yu 		sysfs_remove_link(&disk->queue_kobj, "bsg");
184 3d6392cfSJens Axboe 	cdev_device_del(&bd->cdev, &bd->device);
185 4cf0723aSFUJITA Tomonori 	put_device(&bd->device);
186 3d6392cfSJens Axboe }
187 ead09dd3SChristoph Hellwig EXPORT_SYMBOL_GPL(bsg_unregister_queue);
188 75ca5640SChristoph Hellwig 
bsg_register_queue(struct request_queue * q,struct device * parent,const char * name,bsg_sg_io_fn * sg_io_fn)189 3d6392cfSJens Axboe struct bsg_device *bsg_register_queue(struct request_queue *q,
190 ead09dd3SChristoph Hellwig 		struct device *parent, const char *name, bsg_sg_io_fn *sg_io_fn)
191 bab998d6STejun Heo {
192 3d6392cfSJens Axboe 	struct bsg_device *bd;
193 ead09dd3SChristoph Hellwig 	int ret;
194 ead09dd3SChristoph Hellwig 
195 ead09dd3SChristoph Hellwig 	bd = kzalloc(sizeof(*bd), GFP_KERNEL);
196 ead09dd3SChristoph Hellwig 	if (!bd)
197 1e61c1a8SChristoph Hellwig 		return ERR_PTR(-ENOMEM);
198 ead09dd3SChristoph Hellwig 	bd->max_queue = BSG_DEFAULT_CMDS;
199 75ca5640SChristoph Hellwig 	bd->reserved_size = INT_MAX;
200 3d6392cfSJens Axboe 	bd->queue = q;
201 873cdda1SBo Liu 	bd->sg_io_fn = sg_io_fn;
202 bab998d6STejun Heo 
203 ead09dd3SChristoph Hellwig 	ret = ida_alloc_max(&bsg_minor_ida, BSG_MAX_DEVS - 1, GFP_KERNEL);
204 ead09dd3SChristoph Hellwig 	if (ret < 0) {
205 1a0db774SZenghui Yu 		if (ret == -ENOSPC)
206 1a0db774SZenghui Yu 			dev_err(parent, "bsg: too many bsg devices\n");
207 bab998d6STejun Heo 		kfree(bd);
208 ead09dd3SChristoph Hellwig 		return ERR_PTR(ret);
209 ead09dd3SChristoph Hellwig 	}
210 ead09dd3SChristoph Hellwig 	bd->device.devt = MKDEV(bsg_major, ret);
211 1a0db774SZenghui Yu 	bd->device.class = &bsg_class;
212 ead09dd3SChristoph Hellwig 	bd->device.parent = parent;
213 ead09dd3SChristoph Hellwig 	bd->device.release = bsg_device_release;
214 292b7f27SFUJITA Tomonori 	dev_set_name(&bd->device, "%s", name);
215 ead09dd3SChristoph Hellwig 	device_initialize(&bd->device);
216 ead09dd3SChristoph Hellwig 
217 ead09dd3SChristoph Hellwig 	cdev_init(&bd->cdev, &bsg_fops);
218 ead09dd3SChristoph Hellwig 	bd->cdev.owner = THIS_MODULE;
219 1a0db774SZenghui Yu 	ret = cdev_device_add(&bd->cdev, &bd->device);
220 4e2872d6SFUJITA Tomonori 	if (ret)
221 2bd85221SChristoph Hellwig 		goto out_put_device;
222 2bd85221SChristoph Hellwig 
223 2bd85221SChristoph Hellwig 	if (q->disk && q->disk->queue_kobj.sd) {
224 4e2872d6SFUJITA Tomonori 		ret = sysfs_create_link(&q->disk->queue_kobj, &bd->device.kobj,
225 ead09dd3SChristoph Hellwig 					"bsg");
226 4e2872d6SFUJITA Tomonori 		if (ret)
227 4e2872d6SFUJITA Tomonori 			goto out_device_del;
228 ead09dd3SChristoph Hellwig 	}
229 6826ee4fSJames Bottomley 
230 ead09dd3SChristoph Hellwig 	return bd;
231 ead09dd3SChristoph Hellwig 
232 1a0db774SZenghui Yu out_device_del:
233 1a0db774SZenghui Yu 	cdev_device_del(&bd->cdev, &bd->device);
234 ead09dd3SChristoph Hellwig out_put_device:
235 3d6392cfSJens Axboe 	put_device(&bd->device);
236 78011042SChristoph Hellwig 	return ERR_PTR(ret);
237 3d6392cfSJens Axboe }
238 ff62b8e6SGreg Kroah-Hartman EXPORT_SYMBOL_GPL(bsg_register_queue);
239 2bdf9149SKay Sievers 
bsg_devnode(const struct device * dev,umode_t * mode)240 2bdf9149SKay Sievers static char *bsg_devnode(const struct device *dev, umode_t *mode)
241 2bdf9149SKay Sievers {
242 2bdf9149SKay Sievers 	return kasprintf(GFP_KERNEL, "bsg/%s", dev_name(dev));
243 3d6392cfSJens Axboe }
244 3d6392cfSJens Axboe 
245 46f6ef4aSJens Axboe static const struct class bsg_class = {
246 ead09dd3SChristoph Hellwig 	.name		= "bsg",
247 3d6392cfSJens Axboe 	.devnode	= bsg_devnode,
248 *1aaba11dSGreg Kroah-Hartman };
249 28519c89SChristoph Hellwig 
bsg_init(void)250 28519c89SChristoph Hellwig static int __init bsg_init(void)
251 e454cea2SKay Sievers {
252 3d6392cfSJens Axboe 	dev_t devid;
253 46f6ef4aSJens Axboe 	int ret;
254 9b9f770cSFUJITA Tomonori 
255 9b9f770cSFUJITA Tomonori 	ret = class_register(&bsg_class);
256 46f6ef4aSJens Axboe 	if (ret)
257 46f6ef4aSJens Axboe 		return ret;
258 0ed081ceSFUJITA Tomonori 
259 0ed081ceSFUJITA Tomonori 	ret = alloc_chrdev_region(&devid, 0, BSG_MAX_DEVS, "bsg");
260 3d6392cfSJens Axboe 	if (ret)
261 ead09dd3SChristoph Hellwig 		goto destroy_bsg_class;
262 9b9f770cSFUJITA Tomonori 	bsg_major = MAJOR(devid);
263 9b9f770cSFUJITA Tomonori 
264 9b9f770cSFUJITA Tomonori 	printk(KERN_INFO BSG_DESCRIPTION " version " BSG_VERSION
265 3d6392cfSJens Axboe 	       " loaded (major %d)\n", bsg_major);
266 3d6392cfSJens Axboe 	return 0;
267 3d6392cfSJens Axboe 
268 0ed081ceSFUJITA Tomonori destroy_bsg_class:
269 3d6392cfSJens Axboe 	class_unregister(&bsg_class);
270 3d6392cfSJens Axboe 	return ret;
271 4e2872d6SFUJITA Tomonori }
272  
273  MODULE_AUTHOR("Jens Axboe");
274  MODULE_DESCRIPTION(BSG_DESCRIPTION);
275  MODULE_LICENSE("GPL");
276  
277  device_initcall(bsg_init);
278