xref: /openbmc/linux/drivers/block/ublk_drv.c (revision 54a611b6)
1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*
3  * Userspace block device - block device which IO is handled from userspace
4  *
5  * Take full use of io_uring passthrough command for communicating with
6  * ublk userspace daemon(ublksrvd) for handling basic IO request.
7  *
8  * Copyright 2022 Ming Lei <ming.lei@redhat.com>
9  *
10  * (part of code stolen from loop.c)
11  */
12 #include <linux/module.h>
13 #include <linux/moduleparam.h>
14 #include <linux/sched.h>
15 #include <linux/fs.h>
16 #include <linux/pagemap.h>
17 #include <linux/file.h>
18 #include <linux/stat.h>
19 #include <linux/errno.h>
20 #include <linux/major.h>
21 #include <linux/wait.h>
22 #include <linux/blkdev.h>
23 #include <linux/init.h>
24 #include <linux/swap.h>
25 #include <linux/slab.h>
26 #include <linux/compat.h>
27 #include <linux/mutex.h>
28 #include <linux/writeback.h>
29 #include <linux/completion.h>
30 #include <linux/highmem.h>
31 #include <linux/sysfs.h>
32 #include <linux/miscdevice.h>
33 #include <linux/falloc.h>
34 #include <linux/uio.h>
35 #include <linux/ioprio.h>
36 #include <linux/sched/mm.h>
37 #include <linux/uaccess.h>
38 #include <linux/cdev.h>
39 #include <linux/io_uring.h>
40 #include <linux/blk-mq.h>
41 #include <linux/delay.h>
42 #include <linux/mm.h>
43 #include <asm/page.h>
44 #include <linux/task_work.h>
45 #include <uapi/linux/ublk_cmd.h>
46 
47 #define UBLK_MINORS		(1U << MINORBITS)
48 
49 /* All UBLK_F_* have to be included into UBLK_F_ALL */
50 #define UBLK_F_ALL (UBLK_F_SUPPORT_ZERO_COPY \
51 		| UBLK_F_URING_CMD_COMP_IN_TASK \
52 		| UBLK_F_NEED_GET_DATA)
53 
54 /* All UBLK_PARAM_TYPE_* should be included here */
55 #define UBLK_PARAM_TYPE_ALL (UBLK_PARAM_TYPE_BASIC | UBLK_PARAM_TYPE_DISCARD)
56 
57 struct ublk_rq_data {
58 	struct callback_head work;
59 };
60 
61 struct ublk_uring_cmd_pdu {
62 	struct request *req;
63 };
64 
65 /*
66  * io command is active: sqe cmd is received, and its cqe isn't done
67  *
68  * If the flag is set, the io command is owned by ublk driver, and waited
69  * for incoming blk-mq request from the ublk block device.
70  *
71  * If the flag is cleared, the io command will be completed, and owned by
72  * ublk server.
73  */
74 #define UBLK_IO_FLAG_ACTIVE	0x01
75 
76 /*
77  * IO command is completed via cqe, and it is being handled by ublksrv, and
78  * not committed yet
79  *
80  * Basically exclusively with UBLK_IO_FLAG_ACTIVE, so can be served for
81  * cross verification
82  */
83 #define UBLK_IO_FLAG_OWNED_BY_SRV 0x02
84 
85 /*
86  * IO command is aborted, so this flag is set in case of
87  * !UBLK_IO_FLAG_ACTIVE.
88  *
89  * After this flag is observed, any pending or new incoming request
90  * associated with this io command will be failed immediately
91  */
92 #define UBLK_IO_FLAG_ABORTED 0x04
93 
94 /*
95  * UBLK_IO_FLAG_NEED_GET_DATA is set because IO command requires
96  * get data buffer address from ublksrv.
97  *
98  * Then, bio data could be copied into this data buffer for a WRITE request
99  * after the IO command is issued again and UBLK_IO_FLAG_NEED_GET_DATA is unset.
100  */
101 #define UBLK_IO_FLAG_NEED_GET_DATA 0x08
102 
103 struct ublk_io {
104 	/* userspace buffer address from io cmd */
105 	__u64	addr;
106 	unsigned int flags;
107 	int res;
108 
109 	struct io_uring_cmd *cmd;
110 };
111 
112 struct ublk_queue {
113 	int q_id;
114 	int q_depth;
115 
116 	unsigned long flags;
117 	struct task_struct	*ubq_daemon;
118 	char *io_cmd_buf;
119 
120 	unsigned long io_addr;	/* mapped vm address */
121 	unsigned int max_io_sz;
122 	bool abort_work_pending;
123 	unsigned short nr_io_ready;	/* how many ios setup */
124 	struct ublk_device *dev;
125 	struct ublk_io ios[0];
126 };
127 
128 #define UBLK_DAEMON_MONITOR_PERIOD	(5 * HZ)
129 
130 struct ublk_device {
131 	struct gendisk		*ub_disk;
132 
133 	char	*__queues;
134 
135 	unsigned short  queue_size;
136 	struct ublksrv_ctrl_dev_info	dev_info;
137 
138 	struct blk_mq_tag_set	tag_set;
139 
140 	struct cdev		cdev;
141 	struct device		cdev_dev;
142 
143 #define UB_STATE_OPEN		0
144 #define UB_STATE_USED		1
145 	unsigned long		state;
146 	int			ub_number;
147 
148 	struct mutex		mutex;
149 
150 	spinlock_t		mm_lock;
151 	struct mm_struct	*mm;
152 
153 	struct ublk_params	params;
154 
155 	struct completion	completion;
156 	unsigned int		nr_queues_ready;
157 	atomic_t		nr_aborted_queues;
158 
159 	/*
160 	 * Our ubq->daemon may be killed without any notification, so
161 	 * monitor each queue's daemon periodically
162 	 */
163 	struct delayed_work	monitor_work;
164 	struct work_struct	stop_work;
165 };
166 
167 /* header of ublk_params */
168 struct ublk_params_header {
169 	__u32	len;
170 	__u32	types;
171 };
172 
173 static dev_t ublk_chr_devt;
174 static struct class *ublk_chr_class;
175 
176 static DEFINE_IDR(ublk_index_idr);
177 static DEFINE_SPINLOCK(ublk_idr_lock);
178 static wait_queue_head_t ublk_idr_wq;	/* wait until one idr is freed */
179 
180 static DEFINE_MUTEX(ublk_ctl_mutex);
181 
182 static struct miscdevice ublk_misc;
183 
184 static void ublk_dev_param_basic_apply(struct ublk_device *ub)
185 {
186 	struct request_queue *q = ub->ub_disk->queue;
187 	const struct ublk_param_basic *p = &ub->params.basic;
188 
189 	blk_queue_logical_block_size(q, 1 << p->logical_bs_shift);
190 	blk_queue_physical_block_size(q, 1 << p->physical_bs_shift);
191 	blk_queue_io_min(q, 1 << p->io_min_shift);
192 	blk_queue_io_opt(q, 1 << p->io_opt_shift);
193 
194 	blk_queue_write_cache(q, p->attrs & UBLK_ATTR_VOLATILE_CACHE,
195 			p->attrs & UBLK_ATTR_FUA);
196 	if (p->attrs & UBLK_ATTR_ROTATIONAL)
197 		blk_queue_flag_clear(QUEUE_FLAG_NONROT, q);
198 	else
199 		blk_queue_flag_set(QUEUE_FLAG_NONROT, q);
200 
201 	blk_queue_max_hw_sectors(q, p->max_sectors);
202 	blk_queue_chunk_sectors(q, p->chunk_sectors);
203 	blk_queue_virt_boundary(q, p->virt_boundary_mask);
204 
205 	if (p->attrs & UBLK_ATTR_READ_ONLY)
206 		set_disk_ro(ub->ub_disk, true);
207 
208 	set_capacity(ub->ub_disk, p->dev_sectors);
209 }
210 
211 static void ublk_dev_param_discard_apply(struct ublk_device *ub)
212 {
213 	struct request_queue *q = ub->ub_disk->queue;
214 	const struct ublk_param_discard *p = &ub->params.discard;
215 
216 	q->limits.discard_alignment = p->discard_alignment;
217 	q->limits.discard_granularity = p->discard_granularity;
218 	blk_queue_max_discard_sectors(q, p->max_discard_sectors);
219 	blk_queue_max_write_zeroes_sectors(q,
220 			p->max_write_zeroes_sectors);
221 	blk_queue_max_discard_segments(q, p->max_discard_segments);
222 }
223 
224 static int ublk_validate_params(const struct ublk_device *ub)
225 {
226 	/* basic param is the only one which must be set */
227 	if (ub->params.types & UBLK_PARAM_TYPE_BASIC) {
228 		const struct ublk_param_basic *p = &ub->params.basic;
229 
230 		if (p->logical_bs_shift > PAGE_SHIFT)
231 			return -EINVAL;
232 
233 		if (p->logical_bs_shift > p->physical_bs_shift)
234 			return -EINVAL;
235 
236 		if (p->max_sectors > (ub->dev_info.max_io_buf_bytes >> 9))
237 			return -EINVAL;
238 	} else
239 		return -EINVAL;
240 
241 	if (ub->params.types & UBLK_PARAM_TYPE_DISCARD) {
242 		const struct ublk_param_discard *p = &ub->params.discard;
243 
244 		/* So far, only support single segment discard */
245 		if (p->max_discard_sectors && p->max_discard_segments != 1)
246 			return -EINVAL;
247 
248 		if (!p->discard_granularity)
249 			return -EINVAL;
250 	}
251 
252 	return 0;
253 }
254 
255 static int ublk_apply_params(struct ublk_device *ub)
256 {
257 	if (!(ub->params.types & UBLK_PARAM_TYPE_BASIC))
258 		return -EINVAL;
259 
260 	ublk_dev_param_basic_apply(ub);
261 
262 	if (ub->params.types & UBLK_PARAM_TYPE_DISCARD)
263 		ublk_dev_param_discard_apply(ub);
264 
265 	return 0;
266 }
267 
268 static inline bool ublk_can_use_task_work(const struct ublk_queue *ubq)
269 {
270 	if (IS_BUILTIN(CONFIG_BLK_DEV_UBLK) &&
271 			!(ubq->flags & UBLK_F_URING_CMD_COMP_IN_TASK))
272 		return true;
273 	return false;
274 }
275 
276 static inline bool ublk_need_get_data(const struct ublk_queue *ubq)
277 {
278 	if (ubq->flags & UBLK_F_NEED_GET_DATA)
279 		return true;
280 	return false;
281 }
282 
283 static struct ublk_device *ublk_get_device(struct ublk_device *ub)
284 {
285 	if (kobject_get_unless_zero(&ub->cdev_dev.kobj))
286 		return ub;
287 	return NULL;
288 }
289 
290 static void ublk_put_device(struct ublk_device *ub)
291 {
292 	put_device(&ub->cdev_dev);
293 }
294 
295 static inline struct ublk_queue *ublk_get_queue(struct ublk_device *dev,
296 		int qid)
297 {
298        return (struct ublk_queue *)&(dev->__queues[qid * dev->queue_size]);
299 }
300 
301 static inline bool ublk_rq_has_data(const struct request *rq)
302 {
303 	return rq->bio && bio_has_data(rq->bio);
304 }
305 
306 static inline struct ublksrv_io_desc *ublk_get_iod(struct ublk_queue *ubq,
307 		int tag)
308 {
309 	return (struct ublksrv_io_desc *)
310 		&(ubq->io_cmd_buf[tag * sizeof(struct ublksrv_io_desc)]);
311 }
312 
313 static inline char *ublk_queue_cmd_buf(struct ublk_device *ub, int q_id)
314 {
315 	return ublk_get_queue(ub, q_id)->io_cmd_buf;
316 }
317 
318 static inline int ublk_queue_cmd_buf_size(struct ublk_device *ub, int q_id)
319 {
320 	struct ublk_queue *ubq = ublk_get_queue(ub, q_id);
321 
322 	return round_up(ubq->q_depth * sizeof(struct ublksrv_io_desc),
323 			PAGE_SIZE);
324 }
325 
326 static void ublk_free_disk(struct gendisk *disk)
327 {
328 	struct ublk_device *ub = disk->private_data;
329 
330 	clear_bit(UB_STATE_USED, &ub->state);
331 	put_device(&ub->cdev_dev);
332 }
333 
334 static const struct block_device_operations ub_fops = {
335 	.owner =	THIS_MODULE,
336 	.free_disk =	ublk_free_disk,
337 };
338 
339 #define UBLK_MAX_PIN_PAGES	32
340 
341 struct ublk_map_data {
342 	const struct ublk_queue *ubq;
343 	const struct request *rq;
344 	const struct ublk_io *io;
345 	unsigned max_bytes;
346 };
347 
348 struct ublk_io_iter {
349 	struct page *pages[UBLK_MAX_PIN_PAGES];
350 	unsigned pg_off;	/* offset in the 1st page in pages */
351 	int nr_pages;		/* how many page pointers in pages */
352 	struct bio *bio;
353 	struct bvec_iter iter;
354 };
355 
356 static inline unsigned ublk_copy_io_pages(struct ublk_io_iter *data,
357 		unsigned max_bytes, bool to_vm)
358 {
359 	const unsigned total = min_t(unsigned, max_bytes,
360 			PAGE_SIZE - data->pg_off +
361 			((data->nr_pages - 1) << PAGE_SHIFT));
362 	unsigned done = 0;
363 	unsigned pg_idx = 0;
364 
365 	while (done < total) {
366 		struct bio_vec bv = bio_iter_iovec(data->bio, data->iter);
367 		const unsigned int bytes = min3(bv.bv_len, total - done,
368 				(unsigned)(PAGE_SIZE - data->pg_off));
369 		void *bv_buf = bvec_kmap_local(&bv);
370 		void *pg_buf = kmap_local_page(data->pages[pg_idx]);
371 
372 		if (to_vm)
373 			memcpy(pg_buf + data->pg_off, bv_buf, bytes);
374 		else
375 			memcpy(bv_buf, pg_buf + data->pg_off, bytes);
376 
377 		kunmap_local(pg_buf);
378 		kunmap_local(bv_buf);
379 
380 		/* advance page array */
381 		data->pg_off += bytes;
382 		if (data->pg_off == PAGE_SIZE) {
383 			pg_idx += 1;
384 			data->pg_off = 0;
385 		}
386 
387 		done += bytes;
388 
389 		/* advance bio */
390 		bio_advance_iter_single(data->bio, &data->iter, bytes);
391 		if (!data->iter.bi_size) {
392 			data->bio = data->bio->bi_next;
393 			if (data->bio == NULL)
394 				break;
395 			data->iter = data->bio->bi_iter;
396 		}
397 	}
398 
399 	return done;
400 }
401 
402 static inline int ublk_copy_user_pages(struct ublk_map_data *data,
403 		bool to_vm)
404 {
405 	const unsigned int gup_flags = to_vm ? FOLL_WRITE : 0;
406 	const unsigned long start_vm = data->io->addr;
407 	unsigned int done = 0;
408 	struct ublk_io_iter iter = {
409 		.pg_off	= start_vm & (PAGE_SIZE - 1),
410 		.bio	= data->rq->bio,
411 		.iter	= data->rq->bio->bi_iter,
412 	};
413 	const unsigned int nr_pages = round_up(data->max_bytes +
414 			(start_vm & (PAGE_SIZE - 1)), PAGE_SIZE) >> PAGE_SHIFT;
415 
416 	while (done < nr_pages) {
417 		const unsigned to_pin = min_t(unsigned, UBLK_MAX_PIN_PAGES,
418 				nr_pages - done);
419 		unsigned i, len;
420 
421 		iter.nr_pages = get_user_pages_fast(start_vm +
422 				(done << PAGE_SHIFT), to_pin, gup_flags,
423 				iter.pages);
424 		if (iter.nr_pages <= 0)
425 			return done == 0 ? iter.nr_pages : done;
426 		len = ublk_copy_io_pages(&iter, data->max_bytes, to_vm);
427 		for (i = 0; i < iter.nr_pages; i++) {
428 			if (to_vm)
429 				set_page_dirty(iter.pages[i]);
430 			put_page(iter.pages[i]);
431 		}
432 		data->max_bytes -= len;
433 		done += iter.nr_pages;
434 	}
435 
436 	return done;
437 }
438 
439 static int ublk_map_io(const struct ublk_queue *ubq, const struct request *req,
440 		struct ublk_io *io)
441 {
442 	const unsigned int rq_bytes = blk_rq_bytes(req);
443 	/*
444 	 * no zero copy, we delay copy WRITE request data into ublksrv
445 	 * context and the big benefit is that pinning pages in current
446 	 * context is pretty fast, see ublk_pin_user_pages
447 	 */
448 	if (req_op(req) != REQ_OP_WRITE && req_op(req) != REQ_OP_FLUSH)
449 		return rq_bytes;
450 
451 	if (ublk_rq_has_data(req)) {
452 		struct ublk_map_data data = {
453 			.ubq	=	ubq,
454 			.rq	=	req,
455 			.io	=	io,
456 			.max_bytes =	rq_bytes,
457 		};
458 
459 		ublk_copy_user_pages(&data, true);
460 
461 		return rq_bytes - data.max_bytes;
462 	}
463 	return rq_bytes;
464 }
465 
466 static int ublk_unmap_io(const struct ublk_queue *ubq,
467 		const struct request *req,
468 		struct ublk_io *io)
469 {
470 	const unsigned int rq_bytes = blk_rq_bytes(req);
471 
472 	if (req_op(req) == REQ_OP_READ && ublk_rq_has_data(req)) {
473 		struct ublk_map_data data = {
474 			.ubq	=	ubq,
475 			.rq	=	req,
476 			.io	=	io,
477 			.max_bytes =	io->res,
478 		};
479 
480 		WARN_ON_ONCE(io->res > rq_bytes);
481 
482 		ublk_copy_user_pages(&data, false);
483 
484 		return io->res - data.max_bytes;
485 	}
486 	return rq_bytes;
487 }
488 
489 static inline unsigned int ublk_req_build_flags(struct request *req)
490 {
491 	unsigned flags = 0;
492 
493 	if (req->cmd_flags & REQ_FAILFAST_DEV)
494 		flags |= UBLK_IO_F_FAILFAST_DEV;
495 
496 	if (req->cmd_flags & REQ_FAILFAST_TRANSPORT)
497 		flags |= UBLK_IO_F_FAILFAST_TRANSPORT;
498 
499 	if (req->cmd_flags & REQ_FAILFAST_DRIVER)
500 		flags |= UBLK_IO_F_FAILFAST_DRIVER;
501 
502 	if (req->cmd_flags & REQ_META)
503 		flags |= UBLK_IO_F_META;
504 
505 	if (req->cmd_flags & REQ_FUA)
506 		flags |= UBLK_IO_F_FUA;
507 
508 	if (req->cmd_flags & REQ_NOUNMAP)
509 		flags |= UBLK_IO_F_NOUNMAP;
510 
511 	if (req->cmd_flags & REQ_SWAP)
512 		flags |= UBLK_IO_F_SWAP;
513 
514 	return flags;
515 }
516 
517 static blk_status_t ublk_setup_iod(struct ublk_queue *ubq, struct request *req)
518 {
519 	struct ublksrv_io_desc *iod = ublk_get_iod(ubq, req->tag);
520 	struct ublk_io *io = &ubq->ios[req->tag];
521 	u32 ublk_op;
522 
523 	switch (req_op(req)) {
524 	case REQ_OP_READ:
525 		ublk_op = UBLK_IO_OP_READ;
526 		break;
527 	case REQ_OP_WRITE:
528 		ublk_op = UBLK_IO_OP_WRITE;
529 		break;
530 	case REQ_OP_FLUSH:
531 		ublk_op = UBLK_IO_OP_FLUSH;
532 		break;
533 	case REQ_OP_DISCARD:
534 		ublk_op = UBLK_IO_OP_DISCARD;
535 		break;
536 	case REQ_OP_WRITE_ZEROES:
537 		ublk_op = UBLK_IO_OP_WRITE_ZEROES;
538 		break;
539 	default:
540 		return BLK_STS_IOERR;
541 	}
542 
543 	/* need to translate since kernel may change */
544 	iod->op_flags = ublk_op | ublk_req_build_flags(req);
545 	iod->nr_sectors = blk_rq_sectors(req);
546 	iod->start_sector = blk_rq_pos(req);
547 	iod->addr = io->addr;
548 
549 	return BLK_STS_OK;
550 }
551 
552 static inline struct ublk_uring_cmd_pdu *ublk_get_uring_cmd_pdu(
553 		struct io_uring_cmd *ioucmd)
554 {
555 	return (struct ublk_uring_cmd_pdu *)&ioucmd->pdu;
556 }
557 
558 static inline bool ubq_daemon_is_dying(struct ublk_queue *ubq)
559 {
560 	return ubq->ubq_daemon->flags & PF_EXITING;
561 }
562 
563 /* todo: handle partial completion */
564 static void ublk_complete_rq(struct request *req)
565 {
566 	struct ublk_queue *ubq = req->mq_hctx->driver_data;
567 	struct ublk_io *io = &ubq->ios[req->tag];
568 	unsigned int unmapped_bytes;
569 
570 	/* failed read IO if nothing is read */
571 	if (!io->res && req_op(req) == REQ_OP_READ)
572 		io->res = -EIO;
573 
574 	if (io->res < 0) {
575 		blk_mq_end_request(req, errno_to_blk_status(io->res));
576 		return;
577 	}
578 
579 	/*
580 	 * FLUSH or DISCARD usually won't return bytes returned, so end them
581 	 * directly.
582 	 *
583 	 * Both the two needn't unmap.
584 	 */
585 	if (req_op(req) != REQ_OP_READ && req_op(req) != REQ_OP_WRITE) {
586 		blk_mq_end_request(req, BLK_STS_OK);
587 		return;
588 	}
589 
590 	/* for READ request, writing data in iod->addr to rq buffers */
591 	unmapped_bytes = ublk_unmap_io(ubq, req, io);
592 
593 	/*
594 	 * Extremely impossible since we got data filled in just before
595 	 *
596 	 * Re-read simply for this unlikely case.
597 	 */
598 	if (unlikely(unmapped_bytes < io->res))
599 		io->res = unmapped_bytes;
600 
601 	if (blk_update_request(req, BLK_STS_OK, io->res))
602 		blk_mq_requeue_request(req, true);
603 	else
604 		__blk_mq_end_request(req, BLK_STS_OK);
605 }
606 
607 /*
608  * Since __ublk_rq_task_work always fails requests immediately during
609  * exiting, __ublk_fail_req() is only called from abort context during
610  * exiting. So lock is unnecessary.
611  *
612  * Also aborting may not be started yet, keep in mind that one failed
613  * request may be issued by block layer again.
614  */
615 static void __ublk_fail_req(struct ublk_io *io, struct request *req)
616 {
617 	WARN_ON_ONCE(io->flags & UBLK_IO_FLAG_ACTIVE);
618 
619 	if (!(io->flags & UBLK_IO_FLAG_ABORTED)) {
620 		io->flags |= UBLK_IO_FLAG_ABORTED;
621 		blk_mq_end_request(req, BLK_STS_IOERR);
622 	}
623 }
624 
625 static void ubq_complete_io_cmd(struct ublk_io *io, int res)
626 {
627 	/* mark this cmd owned by ublksrv */
628 	io->flags |= UBLK_IO_FLAG_OWNED_BY_SRV;
629 
630 	/*
631 	 * clear ACTIVE since we are done with this sqe/cmd slot
632 	 * We can only accept io cmd in case of being not active.
633 	 */
634 	io->flags &= ~UBLK_IO_FLAG_ACTIVE;
635 
636 	/* tell ublksrv one io request is coming */
637 	io_uring_cmd_done(io->cmd, res, 0);
638 }
639 
640 #define UBLK_REQUEUE_DELAY_MS	3
641 
642 static inline void __ublk_rq_task_work(struct request *req)
643 {
644 	struct ublk_queue *ubq = req->mq_hctx->driver_data;
645 	struct ublk_device *ub = ubq->dev;
646 	int tag = req->tag;
647 	struct ublk_io *io = &ubq->ios[tag];
648 	bool task_exiting = current != ubq->ubq_daemon || ubq_daemon_is_dying(ubq);
649 	unsigned int mapped_bytes;
650 
651 	pr_devel("%s: complete: op %d, qid %d tag %d io_flags %x addr %llx\n",
652 			__func__, io->cmd->cmd_op, ubq->q_id, req->tag, io->flags,
653 			ublk_get_iod(ubq, req->tag)->addr);
654 
655 	if (unlikely(task_exiting)) {
656 		blk_mq_end_request(req, BLK_STS_IOERR);
657 		mod_delayed_work(system_wq, &ub->monitor_work, 0);
658 		return;
659 	}
660 
661 	if (ublk_need_get_data(ubq) &&
662 			(req_op(req) == REQ_OP_WRITE ||
663 			req_op(req) == REQ_OP_FLUSH)) {
664 		/*
665 		 * We have not handled UBLK_IO_NEED_GET_DATA command yet,
666 		 * so immepdately pass UBLK_IO_RES_NEED_GET_DATA to ublksrv
667 		 * and notify it.
668 		 */
669 		if (!(io->flags & UBLK_IO_FLAG_NEED_GET_DATA)) {
670 			io->flags |= UBLK_IO_FLAG_NEED_GET_DATA;
671 			pr_devel("%s: need get data. op %d, qid %d tag %d io_flags %x\n",
672 					__func__, io->cmd->cmd_op, ubq->q_id,
673 					req->tag, io->flags);
674 			ubq_complete_io_cmd(io, UBLK_IO_RES_NEED_GET_DATA);
675 			return;
676 		}
677 		/*
678 		 * We have handled UBLK_IO_NEED_GET_DATA command,
679 		 * so clear UBLK_IO_FLAG_NEED_GET_DATA now and just
680 		 * do the copy work.
681 		 */
682 		io->flags &= ~UBLK_IO_FLAG_NEED_GET_DATA;
683 		/* update iod->addr because ublksrv may have passed a new io buffer */
684 		ublk_get_iod(ubq, req->tag)->addr = io->addr;
685 		pr_devel("%s: update iod->addr: op %d, qid %d tag %d io_flags %x addr %llx\n",
686 				__func__, io->cmd->cmd_op, ubq->q_id, req->tag, io->flags,
687 				ublk_get_iod(ubq, req->tag)->addr);
688 	}
689 
690 	mapped_bytes = ublk_map_io(ubq, req, io);
691 
692 	/* partially mapped, update io descriptor */
693 	if (unlikely(mapped_bytes != blk_rq_bytes(req))) {
694 		/*
695 		 * Nothing mapped, retry until we succeed.
696 		 *
697 		 * We may never succeed in mapping any bytes here because
698 		 * of OOM. TODO: reserve one buffer with single page pinned
699 		 * for providing forward progress guarantee.
700 		 */
701 		if (unlikely(!mapped_bytes)) {
702 			blk_mq_requeue_request(req, false);
703 			blk_mq_delay_kick_requeue_list(req->q,
704 					UBLK_REQUEUE_DELAY_MS);
705 			return;
706 		}
707 
708 		ublk_get_iod(ubq, req->tag)->nr_sectors =
709 			mapped_bytes >> 9;
710 	}
711 
712 	ubq_complete_io_cmd(io, UBLK_IO_RES_OK);
713 }
714 
715 static void ublk_rq_task_work_cb(struct io_uring_cmd *cmd)
716 {
717 	struct ublk_uring_cmd_pdu *pdu = ublk_get_uring_cmd_pdu(cmd);
718 
719 	__ublk_rq_task_work(pdu->req);
720 }
721 
722 static void ublk_rq_task_work_fn(struct callback_head *work)
723 {
724 	struct ublk_rq_data *data = container_of(work,
725 			struct ublk_rq_data, work);
726 	struct request *req = blk_mq_rq_from_pdu(data);
727 
728 	__ublk_rq_task_work(req);
729 }
730 
731 static blk_status_t ublk_queue_rq(struct blk_mq_hw_ctx *hctx,
732 		const struct blk_mq_queue_data *bd)
733 {
734 	struct ublk_queue *ubq = hctx->driver_data;
735 	struct request *rq = bd->rq;
736 	blk_status_t res;
737 
738 	/* fill iod to slot in io cmd buffer */
739 	res = ublk_setup_iod(ubq, rq);
740 	if (unlikely(res != BLK_STS_OK))
741 		return BLK_STS_IOERR;
742 
743 	blk_mq_start_request(bd->rq);
744 
745 	if (unlikely(ubq_daemon_is_dying(ubq))) {
746  fail:
747 		mod_delayed_work(system_wq, &ubq->dev->monitor_work, 0);
748 		return BLK_STS_IOERR;
749 	}
750 
751 	if (ublk_can_use_task_work(ubq)) {
752 		struct ublk_rq_data *data = blk_mq_rq_to_pdu(rq);
753 		enum task_work_notify_mode notify_mode = bd->last ?
754 			TWA_SIGNAL_NO_IPI : TWA_NONE;
755 
756 		if (task_work_add(ubq->ubq_daemon, &data->work, notify_mode))
757 			goto fail;
758 	} else {
759 		struct ublk_io *io = &ubq->ios[rq->tag];
760 		struct io_uring_cmd *cmd = io->cmd;
761 		struct ublk_uring_cmd_pdu *pdu = ublk_get_uring_cmd_pdu(cmd);
762 
763 		/*
764 		 * If the check pass, we know that this is a re-issued request aborted
765 		 * previously in monitor_work because the ubq_daemon(cmd's task) is
766 		 * PF_EXITING. We cannot call io_uring_cmd_complete_in_task() anymore
767 		 * because this ioucmd's io_uring context may be freed now if no inflight
768 		 * ioucmd exists. Otherwise we may cause null-deref in ctx->fallback_work.
769 		 *
770 		 * Note: monitor_work sets UBLK_IO_FLAG_ABORTED and ends this request(releasing
771 		 * the tag). Then the request is re-started(allocating the tag) and we are here.
772 		 * Since releasing/allocating a tag implies smp_mb(), finding UBLK_IO_FLAG_ABORTED
773 		 * guarantees that here is a re-issued request aborted previously.
774 		 */
775 		if ((io->flags & UBLK_IO_FLAG_ABORTED))
776 			goto fail;
777 
778 		pdu->req = rq;
779 		io_uring_cmd_complete_in_task(cmd, ublk_rq_task_work_cb);
780 	}
781 
782 	return BLK_STS_OK;
783 }
784 
785 static void ublk_commit_rqs(struct blk_mq_hw_ctx *hctx)
786 {
787 	struct ublk_queue *ubq = hctx->driver_data;
788 
789 	if (ublk_can_use_task_work(ubq))
790 		__set_notify_signal(ubq->ubq_daemon);
791 }
792 
793 static int ublk_init_hctx(struct blk_mq_hw_ctx *hctx, void *driver_data,
794 		unsigned int hctx_idx)
795 {
796 	struct ublk_device *ub = driver_data;
797 	struct ublk_queue *ubq = ublk_get_queue(ub, hctx->queue_num);
798 
799 	hctx->driver_data = ubq;
800 	return 0;
801 }
802 
803 static int ublk_init_rq(struct blk_mq_tag_set *set, struct request *req,
804 		unsigned int hctx_idx, unsigned int numa_node)
805 {
806 	struct ublk_rq_data *data = blk_mq_rq_to_pdu(req);
807 
808 	init_task_work(&data->work, ublk_rq_task_work_fn);
809 	return 0;
810 }
811 
812 static const struct blk_mq_ops ublk_mq_ops = {
813 	.queue_rq       = ublk_queue_rq,
814 	.commit_rqs     = ublk_commit_rqs,
815 	.init_hctx	= ublk_init_hctx,
816 	.init_request   = ublk_init_rq,
817 };
818 
819 static int ublk_ch_open(struct inode *inode, struct file *filp)
820 {
821 	struct ublk_device *ub = container_of(inode->i_cdev,
822 			struct ublk_device, cdev);
823 
824 	if (test_and_set_bit(UB_STATE_OPEN, &ub->state))
825 		return -EBUSY;
826 	filp->private_data = ub;
827 	return 0;
828 }
829 
830 static int ublk_ch_release(struct inode *inode, struct file *filp)
831 {
832 	struct ublk_device *ub = filp->private_data;
833 
834 	clear_bit(UB_STATE_OPEN, &ub->state);
835 	return 0;
836 }
837 
838 /* map pre-allocated per-queue cmd buffer to ublksrv daemon */
839 static int ublk_ch_mmap(struct file *filp, struct vm_area_struct *vma)
840 {
841 	struct ublk_device *ub = filp->private_data;
842 	size_t sz = vma->vm_end - vma->vm_start;
843 	unsigned max_sz = UBLK_MAX_QUEUE_DEPTH * sizeof(struct ublksrv_io_desc);
844 	unsigned long pfn, end, phys_off = vma->vm_pgoff << PAGE_SHIFT;
845 	int q_id, ret = 0;
846 
847 	spin_lock(&ub->mm_lock);
848 	if (!ub->mm)
849 		ub->mm = current->mm;
850 	if (current->mm != ub->mm)
851 		ret = -EINVAL;
852 	spin_unlock(&ub->mm_lock);
853 
854 	if (ret)
855 		return ret;
856 
857 	if (vma->vm_flags & VM_WRITE)
858 		return -EPERM;
859 
860 	end = UBLKSRV_CMD_BUF_OFFSET + ub->dev_info.nr_hw_queues * max_sz;
861 	if (phys_off < UBLKSRV_CMD_BUF_OFFSET || phys_off >= end)
862 		return -EINVAL;
863 
864 	q_id = (phys_off - UBLKSRV_CMD_BUF_OFFSET) / max_sz;
865 	pr_devel("%s: qid %d, pid %d, addr %lx pg_off %lx sz %lu\n",
866 			__func__, q_id, current->pid, vma->vm_start,
867 			phys_off, (unsigned long)sz);
868 
869 	if (sz != ublk_queue_cmd_buf_size(ub, q_id))
870 		return -EINVAL;
871 
872 	pfn = virt_to_phys(ublk_queue_cmd_buf(ub, q_id)) >> PAGE_SHIFT;
873 	return remap_pfn_range(vma, vma->vm_start, pfn, sz, vma->vm_page_prot);
874 }
875 
876 static void ublk_commit_completion(struct ublk_device *ub,
877 		struct ublksrv_io_cmd *ub_cmd)
878 {
879 	u32 qid = ub_cmd->q_id, tag = ub_cmd->tag;
880 	struct ublk_queue *ubq = ublk_get_queue(ub, qid);
881 	struct ublk_io *io = &ubq->ios[tag];
882 	struct request *req;
883 
884 	/* now this cmd slot is owned by nbd driver */
885 	io->flags &= ~UBLK_IO_FLAG_OWNED_BY_SRV;
886 	io->res = ub_cmd->result;
887 
888 	/* find the io request and complete */
889 	req = blk_mq_tag_to_rq(ub->tag_set.tags[qid], tag);
890 
891 	if (req && likely(!blk_should_fake_timeout(req->q)))
892 		ublk_complete_rq(req);
893 }
894 
895 /*
896  * When ->ubq_daemon is exiting, either new request is ended immediately,
897  * or any queued io command is drained, so it is safe to abort queue
898  * lockless
899  */
900 static void ublk_abort_queue(struct ublk_device *ub, struct ublk_queue *ubq)
901 {
902 	int i;
903 
904 	if (!ublk_get_device(ub))
905 		return;
906 
907 	for (i = 0; i < ubq->q_depth; i++) {
908 		struct ublk_io *io = &ubq->ios[i];
909 
910 		if (!(io->flags & UBLK_IO_FLAG_ACTIVE)) {
911 			struct request *rq;
912 
913 			/*
914 			 * Either we fail the request or ublk_rq_task_work_fn
915 			 * will do it
916 			 */
917 			rq = blk_mq_tag_to_rq(ub->tag_set.tags[ubq->q_id], i);
918 			if (rq)
919 				__ublk_fail_req(io, rq);
920 		}
921 	}
922 	ublk_put_device(ub);
923 }
924 
925 static void ublk_daemon_monitor_work(struct work_struct *work)
926 {
927 	struct ublk_device *ub =
928 		container_of(work, struct ublk_device, monitor_work.work);
929 	int i;
930 
931 	for (i = 0; i < ub->dev_info.nr_hw_queues; i++) {
932 		struct ublk_queue *ubq = ublk_get_queue(ub, i);
933 
934 		if (ubq_daemon_is_dying(ubq)) {
935 			schedule_work(&ub->stop_work);
936 
937 			/* abort queue is for making forward progress */
938 			ublk_abort_queue(ub, ubq);
939 		}
940 	}
941 
942 	/*
943 	 * We can't schedule monitor work after ublk_remove() is started.
944 	 *
945 	 * No need ub->mutex, monitor work are canceled after state is marked
946 	 * as DEAD, so DEAD state is observed reliably.
947 	 */
948 	if (ub->dev_info.state != UBLK_S_DEV_DEAD)
949 		schedule_delayed_work(&ub->monitor_work,
950 				UBLK_DAEMON_MONITOR_PERIOD);
951 }
952 
953 static inline bool ublk_queue_ready(struct ublk_queue *ubq)
954 {
955 	return ubq->nr_io_ready == ubq->q_depth;
956 }
957 
958 static void ublk_cancel_queue(struct ublk_queue *ubq)
959 {
960 	int i;
961 
962 	if (!ublk_queue_ready(ubq))
963 		return;
964 
965 	for (i = 0; i < ubq->q_depth; i++) {
966 		struct ublk_io *io = &ubq->ios[i];
967 
968 		if (io->flags & UBLK_IO_FLAG_ACTIVE)
969 			io_uring_cmd_done(io->cmd, UBLK_IO_RES_ABORT, 0);
970 	}
971 
972 	/* all io commands are canceled */
973 	ubq->nr_io_ready = 0;
974 }
975 
976 /* Cancel all pending commands, must be called after del_gendisk() returns */
977 static void ublk_cancel_dev(struct ublk_device *ub)
978 {
979 	int i;
980 
981 	for (i = 0; i < ub->dev_info.nr_hw_queues; i++)
982 		ublk_cancel_queue(ublk_get_queue(ub, i));
983 }
984 
985 static void ublk_stop_dev(struct ublk_device *ub)
986 {
987 	mutex_lock(&ub->mutex);
988 	if (ub->dev_info.state != UBLK_S_DEV_LIVE)
989 		goto unlock;
990 
991 	del_gendisk(ub->ub_disk);
992 	ub->dev_info.state = UBLK_S_DEV_DEAD;
993 	ub->dev_info.ublksrv_pid = -1;
994 	put_disk(ub->ub_disk);
995 	ub->ub_disk = NULL;
996  unlock:
997 	ublk_cancel_dev(ub);
998 	mutex_unlock(&ub->mutex);
999 	cancel_delayed_work_sync(&ub->monitor_work);
1000 }
1001 
1002 /* device can only be started after all IOs are ready */
1003 static void ublk_mark_io_ready(struct ublk_device *ub, struct ublk_queue *ubq)
1004 {
1005 	mutex_lock(&ub->mutex);
1006 	ubq->nr_io_ready++;
1007 	if (ublk_queue_ready(ubq)) {
1008 		ubq->ubq_daemon = current;
1009 		get_task_struct(ubq->ubq_daemon);
1010 		ub->nr_queues_ready++;
1011 	}
1012 	if (ub->nr_queues_ready == ub->dev_info.nr_hw_queues)
1013 		complete_all(&ub->completion);
1014 	mutex_unlock(&ub->mutex);
1015 }
1016 
1017 static void ublk_handle_need_get_data(struct ublk_device *ub, int q_id,
1018 		int tag, struct io_uring_cmd *cmd)
1019 {
1020 	struct ublk_queue *ubq = ublk_get_queue(ub, q_id);
1021 	struct request *req = blk_mq_tag_to_rq(ub->tag_set.tags[q_id], tag);
1022 
1023 	if (ublk_can_use_task_work(ubq)) {
1024 		struct ublk_rq_data *data = blk_mq_rq_to_pdu(req);
1025 
1026 		/* should not fail since we call it just in ubq->ubq_daemon */
1027 		task_work_add(ubq->ubq_daemon, &data->work, TWA_SIGNAL_NO_IPI);
1028 	} else {
1029 		struct ublk_uring_cmd_pdu *pdu = ublk_get_uring_cmd_pdu(cmd);
1030 
1031 		pdu->req = req;
1032 		io_uring_cmd_complete_in_task(cmd, ublk_rq_task_work_cb);
1033 	}
1034 }
1035 
1036 static int ublk_ch_uring_cmd(struct io_uring_cmd *cmd, unsigned int issue_flags)
1037 {
1038 	struct ublksrv_io_cmd *ub_cmd = (struct ublksrv_io_cmd *)cmd->cmd;
1039 	struct ublk_device *ub = cmd->file->private_data;
1040 	struct ublk_queue *ubq;
1041 	struct ublk_io *io;
1042 	u32 cmd_op = cmd->cmd_op;
1043 	unsigned tag = ub_cmd->tag;
1044 	int ret = -EINVAL;
1045 
1046 	pr_devel("%s: received: cmd op %d queue %d tag %d result %d\n",
1047 			__func__, cmd->cmd_op, ub_cmd->q_id, tag,
1048 			ub_cmd->result);
1049 
1050 	if (!(issue_flags & IO_URING_F_SQE128))
1051 		goto out;
1052 
1053 	if (ub_cmd->q_id >= ub->dev_info.nr_hw_queues)
1054 		goto out;
1055 
1056 	ubq = ublk_get_queue(ub, ub_cmd->q_id);
1057 	if (!ubq || ub_cmd->q_id != ubq->q_id)
1058 		goto out;
1059 
1060 	if (ubq->ubq_daemon && ubq->ubq_daemon != current)
1061 		goto out;
1062 
1063 	if (tag >= ubq->q_depth)
1064 		goto out;
1065 
1066 	io = &ubq->ios[tag];
1067 
1068 	/* there is pending io cmd, something must be wrong */
1069 	if (io->flags & UBLK_IO_FLAG_ACTIVE) {
1070 		ret = -EBUSY;
1071 		goto out;
1072 	}
1073 
1074 	/*
1075 	 * ensure that the user issues UBLK_IO_NEED_GET_DATA
1076 	 * iff the driver have set the UBLK_IO_FLAG_NEED_GET_DATA.
1077 	 */
1078 	if ((!!(io->flags & UBLK_IO_FLAG_NEED_GET_DATA))
1079 			^ (cmd_op == UBLK_IO_NEED_GET_DATA))
1080 		goto out;
1081 
1082 	switch (cmd_op) {
1083 	case UBLK_IO_FETCH_REQ:
1084 		/* UBLK_IO_FETCH_REQ is only allowed before queue is setup */
1085 		if (ublk_queue_ready(ubq)) {
1086 			ret = -EBUSY;
1087 			goto out;
1088 		}
1089 		/*
1090 		 * The io is being handled by server, so COMMIT_RQ is expected
1091 		 * instead of FETCH_REQ
1092 		 */
1093 		if (io->flags & UBLK_IO_FLAG_OWNED_BY_SRV)
1094 			goto out;
1095 		/* FETCH_RQ has to provide IO buffer */
1096 		if (!ub_cmd->addr)
1097 			goto out;
1098 		io->cmd = cmd;
1099 		io->flags |= UBLK_IO_FLAG_ACTIVE;
1100 		io->addr = ub_cmd->addr;
1101 
1102 		ublk_mark_io_ready(ub, ubq);
1103 		break;
1104 	case UBLK_IO_COMMIT_AND_FETCH_REQ:
1105 		/* FETCH_RQ has to provide IO buffer */
1106 		if (!ub_cmd->addr)
1107 			goto out;
1108 		if (!(io->flags & UBLK_IO_FLAG_OWNED_BY_SRV))
1109 			goto out;
1110 		io->addr = ub_cmd->addr;
1111 		io->flags |= UBLK_IO_FLAG_ACTIVE;
1112 		io->cmd = cmd;
1113 		ublk_commit_completion(ub, ub_cmd);
1114 		break;
1115 	case UBLK_IO_NEED_GET_DATA:
1116 		if (!(io->flags & UBLK_IO_FLAG_OWNED_BY_SRV))
1117 			goto out;
1118 		io->addr = ub_cmd->addr;
1119 		io->cmd = cmd;
1120 		io->flags |= UBLK_IO_FLAG_ACTIVE;
1121 		ublk_handle_need_get_data(ub, ub_cmd->q_id, ub_cmd->tag, cmd);
1122 		break;
1123 	default:
1124 		goto out;
1125 	}
1126 	return -EIOCBQUEUED;
1127 
1128  out:
1129 	io_uring_cmd_done(cmd, ret, 0);
1130 	pr_devel("%s: complete: cmd op %d, tag %d ret %x io_flags %x\n",
1131 			__func__, cmd_op, tag, ret, io->flags);
1132 	return -EIOCBQUEUED;
1133 }
1134 
1135 static const struct file_operations ublk_ch_fops = {
1136 	.owner = THIS_MODULE,
1137 	.open = ublk_ch_open,
1138 	.release = ublk_ch_release,
1139 	.llseek = no_llseek,
1140 	.uring_cmd = ublk_ch_uring_cmd,
1141 	.mmap = ublk_ch_mmap,
1142 };
1143 
1144 static void ublk_deinit_queue(struct ublk_device *ub, int q_id)
1145 {
1146 	int size = ublk_queue_cmd_buf_size(ub, q_id);
1147 	struct ublk_queue *ubq = ublk_get_queue(ub, q_id);
1148 
1149 	if (ubq->ubq_daemon)
1150 		put_task_struct(ubq->ubq_daemon);
1151 	if (ubq->io_cmd_buf)
1152 		free_pages((unsigned long)ubq->io_cmd_buf, get_order(size));
1153 }
1154 
1155 static int ublk_init_queue(struct ublk_device *ub, int q_id)
1156 {
1157 	struct ublk_queue *ubq = ublk_get_queue(ub, q_id);
1158 	gfp_t gfp_flags = GFP_KERNEL | __GFP_ZERO;
1159 	void *ptr;
1160 	int size;
1161 
1162 	ubq->flags = ub->dev_info.flags;
1163 	ubq->q_id = q_id;
1164 	ubq->q_depth = ub->dev_info.queue_depth;
1165 	size = ublk_queue_cmd_buf_size(ub, q_id);
1166 
1167 	ptr = (void *) __get_free_pages(gfp_flags, get_order(size));
1168 	if (!ptr)
1169 		return -ENOMEM;
1170 
1171 	ubq->io_cmd_buf = ptr;
1172 	ubq->dev = ub;
1173 	return 0;
1174 }
1175 
1176 static void ublk_deinit_queues(struct ublk_device *ub)
1177 {
1178 	int nr_queues = ub->dev_info.nr_hw_queues;
1179 	int i;
1180 
1181 	if (!ub->__queues)
1182 		return;
1183 
1184 	for (i = 0; i < nr_queues; i++)
1185 		ublk_deinit_queue(ub, i);
1186 	kfree(ub->__queues);
1187 }
1188 
1189 static int ublk_init_queues(struct ublk_device *ub)
1190 {
1191 	int nr_queues = ub->dev_info.nr_hw_queues;
1192 	int depth = ub->dev_info.queue_depth;
1193 	int ubq_size = sizeof(struct ublk_queue) + depth * sizeof(struct ublk_io);
1194 	int i, ret = -ENOMEM;
1195 
1196 	ub->queue_size = ubq_size;
1197 	ub->__queues = kcalloc(nr_queues, ubq_size, GFP_KERNEL);
1198 	if (!ub->__queues)
1199 		return ret;
1200 
1201 	for (i = 0; i < nr_queues; i++) {
1202 		if (ublk_init_queue(ub, i))
1203 			goto fail;
1204 	}
1205 
1206 	init_completion(&ub->completion);
1207 	return 0;
1208 
1209  fail:
1210 	ublk_deinit_queues(ub);
1211 	return ret;
1212 }
1213 
1214 static int ublk_alloc_dev_number(struct ublk_device *ub, int idx)
1215 {
1216 	int i = idx;
1217 	int err;
1218 
1219 	spin_lock(&ublk_idr_lock);
1220 	/* allocate id, if @id >= 0, we're requesting that specific id */
1221 	if (i >= 0) {
1222 		err = idr_alloc(&ublk_index_idr, ub, i, i + 1, GFP_NOWAIT);
1223 		if (err == -ENOSPC)
1224 			err = -EEXIST;
1225 	} else {
1226 		err = idr_alloc(&ublk_index_idr, ub, 0, 0, GFP_NOWAIT);
1227 	}
1228 	spin_unlock(&ublk_idr_lock);
1229 
1230 	if (err >= 0)
1231 		ub->ub_number = err;
1232 
1233 	return err;
1234 }
1235 
1236 static void ublk_free_dev_number(struct ublk_device *ub)
1237 {
1238 	spin_lock(&ublk_idr_lock);
1239 	idr_remove(&ublk_index_idr, ub->ub_number);
1240 	wake_up_all(&ublk_idr_wq);
1241 	spin_unlock(&ublk_idr_lock);
1242 }
1243 
1244 static void ublk_cdev_rel(struct device *dev)
1245 {
1246 	struct ublk_device *ub = container_of(dev, struct ublk_device, cdev_dev);
1247 
1248 	blk_mq_free_tag_set(&ub->tag_set);
1249 	ublk_deinit_queues(ub);
1250 	ublk_free_dev_number(ub);
1251 	mutex_destroy(&ub->mutex);
1252 	kfree(ub);
1253 }
1254 
1255 static int ublk_add_chdev(struct ublk_device *ub)
1256 {
1257 	struct device *dev = &ub->cdev_dev;
1258 	int minor = ub->ub_number;
1259 	int ret;
1260 
1261 	dev->parent = ublk_misc.this_device;
1262 	dev->devt = MKDEV(MAJOR(ublk_chr_devt), minor);
1263 	dev->class = ublk_chr_class;
1264 	dev->release = ublk_cdev_rel;
1265 	device_initialize(dev);
1266 
1267 	ret = dev_set_name(dev, "ublkc%d", minor);
1268 	if (ret)
1269 		goto fail;
1270 
1271 	cdev_init(&ub->cdev, &ublk_ch_fops);
1272 	ret = cdev_device_add(&ub->cdev, dev);
1273 	if (ret)
1274 		goto fail;
1275 	return 0;
1276  fail:
1277 	put_device(dev);
1278 	return ret;
1279 }
1280 
1281 static void ublk_stop_work_fn(struct work_struct *work)
1282 {
1283 	struct ublk_device *ub =
1284 		container_of(work, struct ublk_device, stop_work);
1285 
1286 	ublk_stop_dev(ub);
1287 }
1288 
1289 /* align max io buffer size with PAGE_SIZE */
1290 static void ublk_align_max_io_size(struct ublk_device *ub)
1291 {
1292 	unsigned int max_io_bytes = ub->dev_info.max_io_buf_bytes;
1293 
1294 	ub->dev_info.max_io_buf_bytes =
1295 		round_down(max_io_bytes, PAGE_SIZE);
1296 }
1297 
1298 static int ublk_add_tag_set(struct ublk_device *ub)
1299 {
1300 	ub->tag_set.ops = &ublk_mq_ops;
1301 	ub->tag_set.nr_hw_queues = ub->dev_info.nr_hw_queues;
1302 	ub->tag_set.queue_depth = ub->dev_info.queue_depth;
1303 	ub->tag_set.numa_node = NUMA_NO_NODE;
1304 	ub->tag_set.cmd_size = sizeof(struct ublk_rq_data);
1305 	ub->tag_set.flags = BLK_MQ_F_SHOULD_MERGE;
1306 	ub->tag_set.driver_data = ub;
1307 	return blk_mq_alloc_tag_set(&ub->tag_set);
1308 }
1309 
1310 static void ublk_remove(struct ublk_device *ub)
1311 {
1312 	ublk_stop_dev(ub);
1313 	cancel_work_sync(&ub->stop_work);
1314 	cdev_device_del(&ub->cdev, &ub->cdev_dev);
1315 	put_device(&ub->cdev_dev);
1316 }
1317 
1318 static struct ublk_device *ublk_get_device_from_id(int idx)
1319 {
1320 	struct ublk_device *ub = NULL;
1321 
1322 	if (idx < 0)
1323 		return NULL;
1324 
1325 	spin_lock(&ublk_idr_lock);
1326 	ub = idr_find(&ublk_index_idr, idx);
1327 	if (ub)
1328 		ub = ublk_get_device(ub);
1329 	spin_unlock(&ublk_idr_lock);
1330 
1331 	return ub;
1332 }
1333 
1334 static int ublk_ctrl_start_dev(struct io_uring_cmd *cmd)
1335 {
1336 	struct ublksrv_ctrl_cmd *header = (struct ublksrv_ctrl_cmd *)cmd->cmd;
1337 	int ublksrv_pid = (int)header->data[0];
1338 	struct ublk_device *ub;
1339 	struct gendisk *disk;
1340 	int ret = -EINVAL;
1341 
1342 	if (ublksrv_pid <= 0)
1343 		return -EINVAL;
1344 
1345 	ub = ublk_get_device_from_id(header->dev_id);
1346 	if (!ub)
1347 		return -EINVAL;
1348 
1349 	wait_for_completion_interruptible(&ub->completion);
1350 
1351 	schedule_delayed_work(&ub->monitor_work, UBLK_DAEMON_MONITOR_PERIOD);
1352 
1353 	mutex_lock(&ub->mutex);
1354 	if (ub->dev_info.state == UBLK_S_DEV_LIVE ||
1355 	    test_bit(UB_STATE_USED, &ub->state)) {
1356 		ret = -EEXIST;
1357 		goto out_unlock;
1358 	}
1359 
1360 	disk = blk_mq_alloc_disk(&ub->tag_set, ub);
1361 	if (IS_ERR(disk)) {
1362 		ret = PTR_ERR(disk);
1363 		goto out_unlock;
1364 	}
1365 	sprintf(disk->disk_name, "ublkb%d", ub->ub_number);
1366 	disk->fops = &ub_fops;
1367 	disk->private_data = ub;
1368 
1369 	ub->dev_info.ublksrv_pid = ublksrv_pid;
1370 	ub->ub_disk = disk;
1371 
1372 	ret = ublk_apply_params(ub);
1373 	if (ret)
1374 		goto out_put_disk;
1375 
1376 	get_device(&ub->cdev_dev);
1377 	ret = add_disk(disk);
1378 	if (ret) {
1379 		/*
1380 		 * Has to drop the reference since ->free_disk won't be
1381 		 * called in case of add_disk failure.
1382 		 */
1383 		ublk_put_device(ub);
1384 		goto out_put_disk;
1385 	}
1386 	set_bit(UB_STATE_USED, &ub->state);
1387 	ub->dev_info.state = UBLK_S_DEV_LIVE;
1388 out_put_disk:
1389 	if (ret)
1390 		put_disk(disk);
1391 out_unlock:
1392 	mutex_unlock(&ub->mutex);
1393 	ublk_put_device(ub);
1394 	return ret;
1395 }
1396 
1397 static int ublk_ctrl_get_queue_affinity(struct io_uring_cmd *cmd)
1398 {
1399 	struct ublksrv_ctrl_cmd *header = (struct ublksrv_ctrl_cmd *)cmd->cmd;
1400 	void __user *argp = (void __user *)(unsigned long)header->addr;
1401 	struct ublk_device *ub;
1402 	cpumask_var_t cpumask;
1403 	unsigned long queue;
1404 	unsigned int retlen;
1405 	unsigned int i;
1406 	int ret = -EINVAL;
1407 
1408 	if (header->len * BITS_PER_BYTE < nr_cpu_ids)
1409 		return -EINVAL;
1410 	if (header->len & (sizeof(unsigned long)-1))
1411 		return -EINVAL;
1412 	if (!header->addr)
1413 		return -EINVAL;
1414 
1415 	ub = ublk_get_device_from_id(header->dev_id);
1416 	if (!ub)
1417 		return -EINVAL;
1418 
1419 	queue = header->data[0];
1420 	if (queue >= ub->dev_info.nr_hw_queues)
1421 		goto out_put_device;
1422 
1423 	ret = -ENOMEM;
1424 	if (!zalloc_cpumask_var(&cpumask, GFP_KERNEL))
1425 		goto out_put_device;
1426 
1427 	for_each_possible_cpu(i) {
1428 		if (ub->tag_set.map[HCTX_TYPE_DEFAULT].mq_map[i] == queue)
1429 			cpumask_set_cpu(i, cpumask);
1430 	}
1431 
1432 	ret = -EFAULT;
1433 	retlen = min_t(unsigned short, header->len, cpumask_size());
1434 	if (copy_to_user(argp, cpumask, retlen))
1435 		goto out_free_cpumask;
1436 	if (retlen != header->len &&
1437 	    clear_user(argp + retlen, header->len - retlen))
1438 		goto out_free_cpumask;
1439 
1440 	ret = 0;
1441 out_free_cpumask:
1442 	free_cpumask_var(cpumask);
1443 out_put_device:
1444 	ublk_put_device(ub);
1445 	return ret;
1446 }
1447 
1448 static inline void ublk_dump_dev_info(struct ublksrv_ctrl_dev_info *info)
1449 {
1450 	pr_devel("%s: dev id %d flags %llx\n", __func__,
1451 			info->dev_id, info->flags);
1452 	pr_devel("\t nr_hw_queues %d queue_depth %d\n",
1453 			info->nr_hw_queues, info->queue_depth);
1454 }
1455 
1456 static int ublk_ctrl_add_dev(struct io_uring_cmd *cmd)
1457 {
1458 	struct ublksrv_ctrl_cmd *header = (struct ublksrv_ctrl_cmd *)cmd->cmd;
1459 	void __user *argp = (void __user *)(unsigned long)header->addr;
1460 	struct ublksrv_ctrl_dev_info info;
1461 	struct ublk_device *ub;
1462 	int ret = -EINVAL;
1463 
1464 	if (header->len < sizeof(info) || !header->addr)
1465 		return -EINVAL;
1466 	if (header->queue_id != (u16)-1) {
1467 		pr_warn("%s: queue_id is wrong %x\n",
1468 			__func__, header->queue_id);
1469 		return -EINVAL;
1470 	}
1471 	if (copy_from_user(&info, argp, sizeof(info)))
1472 		return -EFAULT;
1473 	ublk_dump_dev_info(&info);
1474 	if (header->dev_id != info.dev_id) {
1475 		pr_warn("%s: dev id not match %u %u\n",
1476 			__func__, header->dev_id, info.dev_id);
1477 		return -EINVAL;
1478 	}
1479 
1480 	ret = mutex_lock_killable(&ublk_ctl_mutex);
1481 	if (ret)
1482 		return ret;
1483 
1484 	ret = -ENOMEM;
1485 	ub = kzalloc(sizeof(*ub), GFP_KERNEL);
1486 	if (!ub)
1487 		goto out_unlock;
1488 	mutex_init(&ub->mutex);
1489 	spin_lock_init(&ub->mm_lock);
1490 	INIT_WORK(&ub->stop_work, ublk_stop_work_fn);
1491 	INIT_DELAYED_WORK(&ub->monitor_work, ublk_daemon_monitor_work);
1492 
1493 	ret = ublk_alloc_dev_number(ub, header->dev_id);
1494 	if (ret < 0)
1495 		goto out_free_ub;
1496 
1497 	memcpy(&ub->dev_info, &info, sizeof(info));
1498 
1499 	/* update device id */
1500 	ub->dev_info.dev_id = ub->ub_number;
1501 
1502 	/*
1503 	 * 64bit flags will be copied back to userspace as feature
1504 	 * negotiation result, so have to clear flags which driver
1505 	 * doesn't support yet, then userspace can get correct flags
1506 	 * (features) to handle.
1507 	 */
1508 	ub->dev_info.flags &= UBLK_F_ALL;
1509 
1510 	/* We are not ready to support zero copy */
1511 	ub->dev_info.flags &= ~UBLK_F_SUPPORT_ZERO_COPY;
1512 
1513 	ub->dev_info.nr_hw_queues = min_t(unsigned int,
1514 			ub->dev_info.nr_hw_queues, nr_cpu_ids);
1515 	ublk_align_max_io_size(ub);
1516 
1517 	ret = ublk_init_queues(ub);
1518 	if (ret)
1519 		goto out_free_dev_number;
1520 
1521 	ret = ublk_add_tag_set(ub);
1522 	if (ret)
1523 		goto out_deinit_queues;
1524 
1525 	ret = -EFAULT;
1526 	if (copy_to_user(argp, &ub->dev_info, sizeof(info)))
1527 		goto out_free_tag_set;
1528 
1529 	/*
1530 	 * Add the char dev so that ublksrv daemon can be setup.
1531 	 * ublk_add_chdev() will cleanup everything if it fails.
1532 	 */
1533 	ret = ublk_add_chdev(ub);
1534 	goto out_unlock;
1535 
1536 out_free_tag_set:
1537 	blk_mq_free_tag_set(&ub->tag_set);
1538 out_deinit_queues:
1539 	ublk_deinit_queues(ub);
1540 out_free_dev_number:
1541 	ublk_free_dev_number(ub);
1542 out_free_ub:
1543 	mutex_destroy(&ub->mutex);
1544 	kfree(ub);
1545 out_unlock:
1546 	mutex_unlock(&ublk_ctl_mutex);
1547 	return ret;
1548 }
1549 
1550 static inline bool ublk_idr_freed(int id)
1551 {
1552 	void *ptr;
1553 
1554 	spin_lock(&ublk_idr_lock);
1555 	ptr = idr_find(&ublk_index_idr, id);
1556 	spin_unlock(&ublk_idr_lock);
1557 
1558 	return ptr == NULL;
1559 }
1560 
1561 static int ublk_ctrl_del_dev(int idx)
1562 {
1563 	struct ublk_device *ub;
1564 	int ret;
1565 
1566 	ret = mutex_lock_killable(&ublk_ctl_mutex);
1567 	if (ret)
1568 		return ret;
1569 
1570 	ub = ublk_get_device_from_id(idx);
1571 	if (ub) {
1572 		ublk_remove(ub);
1573 		ublk_put_device(ub);
1574 		ret = 0;
1575 	} else {
1576 		ret = -ENODEV;
1577 	}
1578 
1579 	/*
1580 	 * Wait until the idr is removed, then it can be reused after
1581 	 * DEL_DEV command is returned.
1582 	 */
1583 	if (!ret)
1584 		wait_event(ublk_idr_wq, ublk_idr_freed(idx));
1585 	mutex_unlock(&ublk_ctl_mutex);
1586 
1587 	return ret;
1588 }
1589 
1590 static inline void ublk_ctrl_cmd_dump(struct io_uring_cmd *cmd)
1591 {
1592 	struct ublksrv_ctrl_cmd *header = (struct ublksrv_ctrl_cmd *)cmd->cmd;
1593 
1594 	pr_devel("%s: cmd_op %x, dev id %d qid %d data %llx buf %llx len %u\n",
1595 			__func__, cmd->cmd_op, header->dev_id, header->queue_id,
1596 			header->data[0], header->addr, header->len);
1597 }
1598 
1599 static int ublk_ctrl_stop_dev(struct io_uring_cmd *cmd)
1600 {
1601 	struct ublksrv_ctrl_cmd *header = (struct ublksrv_ctrl_cmd *)cmd->cmd;
1602 	struct ublk_device *ub;
1603 
1604 	ub = ublk_get_device_from_id(header->dev_id);
1605 	if (!ub)
1606 		return -EINVAL;
1607 
1608 	ublk_stop_dev(ub);
1609 	cancel_work_sync(&ub->stop_work);
1610 
1611 	ublk_put_device(ub);
1612 	return 0;
1613 }
1614 
1615 static int ublk_ctrl_get_dev_info(struct io_uring_cmd *cmd)
1616 {
1617 	struct ublksrv_ctrl_cmd *header = (struct ublksrv_ctrl_cmd *)cmd->cmd;
1618 	void __user *argp = (void __user *)(unsigned long)header->addr;
1619 	struct ublk_device *ub;
1620 	int ret = 0;
1621 
1622 	if (header->len < sizeof(struct ublksrv_ctrl_dev_info) || !header->addr)
1623 		return -EINVAL;
1624 
1625 	ub = ublk_get_device_from_id(header->dev_id);
1626 	if (!ub)
1627 		return -EINVAL;
1628 
1629 	if (copy_to_user(argp, &ub->dev_info, sizeof(ub->dev_info)))
1630 		ret = -EFAULT;
1631 	ublk_put_device(ub);
1632 
1633 	return ret;
1634 }
1635 
1636 static int ublk_ctrl_get_params(struct io_uring_cmd *cmd)
1637 {
1638 	struct ublksrv_ctrl_cmd *header = (struct ublksrv_ctrl_cmd *)cmd->cmd;
1639 	void __user *argp = (void __user *)(unsigned long)header->addr;
1640 	struct ublk_params_header ph;
1641 	struct ublk_device *ub;
1642 	int ret;
1643 
1644 	if (header->len <= sizeof(ph) || !header->addr)
1645 		return -EINVAL;
1646 
1647 	if (copy_from_user(&ph, argp, sizeof(ph)))
1648 		return -EFAULT;
1649 
1650 	if (ph.len > header->len || !ph.len)
1651 		return -EINVAL;
1652 
1653 	if (ph.len > sizeof(struct ublk_params))
1654 		ph.len = sizeof(struct ublk_params);
1655 
1656 	ub = ublk_get_device_from_id(header->dev_id);
1657 	if (!ub)
1658 		return -EINVAL;
1659 
1660 	mutex_lock(&ub->mutex);
1661 	if (copy_to_user(argp, &ub->params, ph.len))
1662 		ret = -EFAULT;
1663 	else
1664 		ret = 0;
1665 	mutex_unlock(&ub->mutex);
1666 
1667 	ublk_put_device(ub);
1668 	return ret;
1669 }
1670 
1671 static int ublk_ctrl_set_params(struct io_uring_cmd *cmd)
1672 {
1673 	struct ublksrv_ctrl_cmd *header = (struct ublksrv_ctrl_cmd *)cmd->cmd;
1674 	void __user *argp = (void __user *)(unsigned long)header->addr;
1675 	struct ublk_params_header ph;
1676 	struct ublk_device *ub;
1677 	int ret = -EFAULT;
1678 
1679 	if (header->len <= sizeof(ph) || !header->addr)
1680 		return -EINVAL;
1681 
1682 	if (copy_from_user(&ph, argp, sizeof(ph)))
1683 		return -EFAULT;
1684 
1685 	if (ph.len > header->len || !ph.len || !ph.types)
1686 		return -EINVAL;
1687 
1688 	if (ph.len > sizeof(struct ublk_params))
1689 		ph.len = sizeof(struct ublk_params);
1690 
1691 	ub = ublk_get_device_from_id(header->dev_id);
1692 	if (!ub)
1693 		return -EINVAL;
1694 
1695 	/* parameters can only be changed when device isn't live */
1696 	mutex_lock(&ub->mutex);
1697 	if (ub->dev_info.state == UBLK_S_DEV_LIVE) {
1698 		ret = -EACCES;
1699 	} else if (copy_from_user(&ub->params, argp, ph.len)) {
1700 		ret = -EFAULT;
1701 	} else {
1702 		/* clear all we don't support yet */
1703 		ub->params.types &= UBLK_PARAM_TYPE_ALL;
1704 		ret = ublk_validate_params(ub);
1705 	}
1706 	mutex_unlock(&ub->mutex);
1707 	ublk_put_device(ub);
1708 
1709 	return ret;
1710 }
1711 
1712 static int ublk_ctrl_uring_cmd(struct io_uring_cmd *cmd,
1713 		unsigned int issue_flags)
1714 {
1715 	struct ublksrv_ctrl_cmd *header = (struct ublksrv_ctrl_cmd *)cmd->cmd;
1716 	int ret = -EINVAL;
1717 
1718 	ublk_ctrl_cmd_dump(cmd);
1719 
1720 	if (!(issue_flags & IO_URING_F_SQE128))
1721 		goto out;
1722 
1723 	ret = -EPERM;
1724 	if (!capable(CAP_SYS_ADMIN))
1725 		goto out;
1726 
1727 	ret = -ENODEV;
1728 	switch (cmd->cmd_op) {
1729 	case UBLK_CMD_START_DEV:
1730 		ret = ublk_ctrl_start_dev(cmd);
1731 		break;
1732 	case UBLK_CMD_STOP_DEV:
1733 		ret = ublk_ctrl_stop_dev(cmd);
1734 		break;
1735 	case UBLK_CMD_GET_DEV_INFO:
1736 		ret = ublk_ctrl_get_dev_info(cmd);
1737 		break;
1738 	case UBLK_CMD_ADD_DEV:
1739 		ret = ublk_ctrl_add_dev(cmd);
1740 		break;
1741 	case UBLK_CMD_DEL_DEV:
1742 		ret = ublk_ctrl_del_dev(header->dev_id);
1743 		break;
1744 	case UBLK_CMD_GET_QUEUE_AFFINITY:
1745 		ret = ublk_ctrl_get_queue_affinity(cmd);
1746 		break;
1747 	case UBLK_CMD_GET_PARAMS:
1748 		ret = ublk_ctrl_get_params(cmd);
1749 		break;
1750 	case UBLK_CMD_SET_PARAMS:
1751 		ret = ublk_ctrl_set_params(cmd);
1752 		break;
1753 	default:
1754 		break;
1755 	}
1756  out:
1757 	io_uring_cmd_done(cmd, ret, 0);
1758 	pr_devel("%s: cmd done ret %d cmd_op %x, dev id %d qid %d\n",
1759 			__func__, ret, cmd->cmd_op, header->dev_id, header->queue_id);
1760 	return -EIOCBQUEUED;
1761 }
1762 
1763 static const struct file_operations ublk_ctl_fops = {
1764 	.open		= nonseekable_open,
1765 	.uring_cmd      = ublk_ctrl_uring_cmd,
1766 	.owner		= THIS_MODULE,
1767 	.llseek		= noop_llseek,
1768 };
1769 
1770 static struct miscdevice ublk_misc = {
1771 	.minor		= MISC_DYNAMIC_MINOR,
1772 	.name		= "ublk-control",
1773 	.fops		= &ublk_ctl_fops,
1774 };
1775 
1776 static int __init ublk_init(void)
1777 {
1778 	int ret;
1779 
1780 	init_waitqueue_head(&ublk_idr_wq);
1781 
1782 	ret = misc_register(&ublk_misc);
1783 	if (ret)
1784 		return ret;
1785 
1786 	ret = alloc_chrdev_region(&ublk_chr_devt, 0, UBLK_MINORS, "ublk-char");
1787 	if (ret)
1788 		goto unregister_mis;
1789 
1790 	ublk_chr_class = class_create(THIS_MODULE, "ublk-char");
1791 	if (IS_ERR(ublk_chr_class)) {
1792 		ret = PTR_ERR(ublk_chr_class);
1793 		goto free_chrdev_region;
1794 	}
1795 	return 0;
1796 
1797 free_chrdev_region:
1798 	unregister_chrdev_region(ublk_chr_devt, UBLK_MINORS);
1799 unregister_mis:
1800 	misc_deregister(&ublk_misc);
1801 	return ret;
1802 }
1803 
1804 static void __exit ublk_exit(void)
1805 {
1806 	struct ublk_device *ub;
1807 	int id;
1808 
1809 	class_destroy(ublk_chr_class);
1810 
1811 	misc_deregister(&ublk_misc);
1812 
1813 	idr_for_each_entry(&ublk_index_idr, ub, id)
1814 		ublk_remove(ub);
1815 
1816 	idr_destroy(&ublk_index_idr);
1817 	unregister_chrdev_region(ublk_chr_devt, UBLK_MINORS);
1818 }
1819 
1820 module_init(ublk_init);
1821 module_exit(ublk_exit);
1822 
1823 MODULE_AUTHOR("Ming Lei <ming.lei@redhat.com>");
1824 MODULE_LICENSE("GPL");
1825