blob: 1378d084c770f6641a911caf8d98d302026fa689 [file] [log] [blame]
Christoph Hellwig3dcf60b2019-04-30 14:42:43 -04001// SPDX-License-Identifier: GPL-2.0
Linus Torvalds1da177e2005-04-16 15:20:36 -07002/*
Linus Torvalds1da177e2005-04-16 15:20:36 -07003 * Copyright (C) 1991, 1992 Linus Torvalds
4 * Copyright (C) 1994, Karl Keyte: Added support for disk statistics
5 * Elevator latency, (C) 2000 Andrea Arcangeli <andrea@suse.de> SuSE
6 * Queue request tables / lock, selectable elevator, Jens Axboe <axboe@suse.de>
Jens Axboe6728cb02008-01-31 13:03:55 +01007 * kernel-doc documentation started by NeilBrown <neilb@cse.unsw.edu.au>
8 * - July2000
Linus Torvalds1da177e2005-04-16 15:20:36 -07009 * bio rewrite, highmem i/o, etc, Jens Axboe <axboe@suse.de> - may 2001
10 */
11
12/*
13 * This handles all read/write requests to block devices
14 */
Linus Torvalds1da177e2005-04-16 15:20:36 -070015#include <linux/kernel.h>
16#include <linux/module.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070017#include <linux/bio.h>
18#include <linux/blkdev.h>
Jens Axboe320ae512013-10-24 09:20:05 +010019#include <linux/blk-mq.h>
Alan Stern52abca62020-12-08 21:29:51 -080020#include <linux/blk-pm.h>
Christoph Hellwigfe45e632021-09-20 14:33:27 +020021#include <linux/blk-integrity.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070022#include <linux/highmem.h>
23#include <linux/mm.h>
Matthew Wilcox (Oracle)cee9a0c2020-06-01 21:46:07 -070024#include <linux/pagemap.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070025#include <linux/kernel_stat.h>
26#include <linux/string.h>
27#include <linux/init.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070028#include <linux/completion.h>
29#include <linux/slab.h>
30#include <linux/swap.h>
31#include <linux/writeback.h>
Andrew Mortonfaccbd4b2006-12-10 02:19:35 -080032#include <linux/task_io_accounting_ops.h>
Akinobu Mitac17bb492006-12-08 02:39:46 -080033#include <linux/fault-inject.h>
Jens Axboe73c10102011-03-08 13:19:51 +010034#include <linux/list_sort.h>
Tejun Heoe3c78ca2011-10-19 14:32:38 +020035#include <linux/delay.h>
Tejun Heoaaf7c682012-04-19 16:29:22 -070036#include <linux/ratelimit.h>
Lin Ming6c954662013-03-23 11:42:26 +080037#include <linux/pm_runtime.h>
Tejun Heoeea8f412015-05-22 17:13:17 -040038#include <linux/blk-cgroup.h>
Max Gurtovoy54d4e6a2019-09-16 18:44:29 +030039#include <linux/t10-pi.h>
Omar Sandoval18fbda92017-01-31 14:53:20 -080040#include <linux/debugfs.h>
Howard McLauchlan30abb3a2018-02-06 14:05:39 -080041#include <linux/bpf.h>
Johannes Weinerb8e24a92019-08-08 15:03:00 -040042#include <linux/psi.h>
Ming Lei71ac8602020-05-14 16:45:09 +080043#include <linux/sched/sysctl.h>
Satya Tangiralaa892c8d2020-05-14 00:37:18 +000044#include <linux/blk-crypto.h>
Li Zefan55782132009-06-09 13:43:05 +080045
46#define CREATE_TRACE_POINTS
47#include <trace/events/block.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070048
Jens Axboe8324aa92008-01-29 14:51:59 +010049#include "blk.h"
Ming Lei43a5e4e2013-12-26 21:31:35 +080050#include "blk-mq.h"
Jens Axboebd166ef2017-01-17 06:03:22 -070051#include "blk-mq-sched.h"
Bart Van Asschebca6b062018-09-26 14:01:03 -070052#include "blk-pm.h"
Jens Axboea7b36ee2021-10-05 09:11:56 -060053#include "blk-throttle.h"
Jens Axboe8324aa92008-01-29 14:51:59 +010054
Omar Sandoval18fbda92017-01-31 14:53:20 -080055struct dentry *blk_debugfs_root;
Omar Sandoval18fbda92017-01-31 14:53:20 -080056
Mike Snitzerd07335e2010-11-16 12:52:38 +010057EXPORT_TRACEPOINT_SYMBOL_GPL(block_bio_remap);
Jun'ichi Nomurab0da3f02009-10-01 21:16:13 +020058EXPORT_TRACEPOINT_SYMBOL_GPL(block_rq_remap);
Linus Torvalds0a82a8d2013-04-18 09:00:26 -070059EXPORT_TRACEPOINT_SYMBOL_GPL(block_bio_complete);
Keith Busch3291fa52014-04-28 12:30:52 -060060EXPORT_TRACEPOINT_SYMBOL_GPL(block_split);
NeilBrowncbae8d42012-12-14 20:49:27 +010061EXPORT_TRACEPOINT_SYMBOL_GPL(block_unplug);
Chaitanya Kulkarnib357e4a2021-02-21 21:29:59 -080062EXPORT_TRACEPOINT_SYMBOL_GPL(block_rq_insert);
Ingo Molnar0bfc2452008-11-26 11:59:56 +010063
Tejun Heoa73f7302011-12-14 00:33:37 +010064DEFINE_IDA(blk_queue_ida);
65
Linus Torvalds1da177e2005-04-16 15:20:36 -070066/*
Linus Torvalds1da177e2005-04-16 15:20:36 -070067 * For queue allocation
68 */
Jens Axboe6728cb02008-01-31 13:03:55 +010069struct kmem_cache *blk_requestq_cachep;
Linus Torvalds1da177e2005-04-16 15:20:36 -070070
71/*
Linus Torvalds1da177e2005-04-16 15:20:36 -070072 * Controlling structure to kblockd
73 */
Jens Axboeff856ba2006-01-09 16:02:34 +010074static struct workqueue_struct *kblockd_workqueue;
Linus Torvalds1da177e2005-04-16 15:20:36 -070075
Bart Van Assche8814ce82018-03-07 17:10:04 -080076/**
77 * blk_queue_flag_set - atomically set a queue flag
78 * @flag: flag to be set
79 * @q: request queue
80 */
81void blk_queue_flag_set(unsigned int flag, struct request_queue *q)
82{
Christoph Hellwig57d74df2018-11-14 17:02:07 +010083 set_bit(flag, &q->queue_flags);
Bart Van Assche8814ce82018-03-07 17:10:04 -080084}
85EXPORT_SYMBOL(blk_queue_flag_set);
86
87/**
88 * blk_queue_flag_clear - atomically clear a queue flag
89 * @flag: flag to be cleared
90 * @q: request queue
91 */
92void blk_queue_flag_clear(unsigned int flag, struct request_queue *q)
93{
Christoph Hellwig57d74df2018-11-14 17:02:07 +010094 clear_bit(flag, &q->queue_flags);
Bart Van Assche8814ce82018-03-07 17:10:04 -080095}
96EXPORT_SYMBOL(blk_queue_flag_clear);
97
98/**
99 * blk_queue_flag_test_and_set - atomically test and set a queue flag
100 * @flag: flag to be set
101 * @q: request queue
102 *
103 * Returns the previous value of @flag - 0 if the flag was not set and 1 if
104 * the flag was already set.
105 */
106bool blk_queue_flag_test_and_set(unsigned int flag, struct request_queue *q)
107{
Christoph Hellwig57d74df2018-11-14 17:02:07 +0100108 return test_and_set_bit(flag, &q->queue_flags);
Bart Van Assche8814ce82018-03-07 17:10:04 -0800109}
110EXPORT_SYMBOL_GPL(blk_queue_flag_test_and_set);
111
FUJITA Tomonori2a4aa302008-04-29 09:54:36 +0200112void blk_rq_init(struct request_queue *q, struct request *rq)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700113{
FUJITA Tomonori1afb20f2008-04-25 12:26:28 +0200114 memset(rq, 0, sizeof(*rq));
115
Linus Torvalds1da177e2005-04-16 15:20:36 -0700116 INIT_LIST_HEAD(&rq->queuelist);
Jens Axboe63a71382008-02-08 12:41:03 +0100117 rq->q = q;
Tejun Heoa2dec7b2009-05-07 22:24:44 +0900118 rq->__sector = (sector_t) -1;
Jens Axboe2e662b62006-07-13 11:55:04 +0200119 INIT_HLIST_NODE(&rq->hash);
120 RB_CLEAR_NODE(&rq->rb_node);
Xianting Tiane44a6a22020-08-27 14:34:17 +0800121 rq->tag = BLK_MQ_NO_TAG;
122 rq->internal_tag = BLK_MQ_NO_TAG;
Omar Sandoval522a7772018-05-09 02:08:53 -0700123 rq->start_time_ns = ktime_get_ns();
Jerome Marchand09e099d2011-01-05 16:57:38 +0100124 rq->part = NULL;
Satya Tangiralaa892c8d2020-05-14 00:37:18 +0000125 blk_crypto_rq_set_defaults(rq);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700126}
FUJITA Tomonori2a4aa302008-04-29 09:54:36 +0200127EXPORT_SYMBOL(blk_rq_init);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700128
Chaitanya Kulkarnie47bc4e2019-06-20 10:59:16 -0700129#define REQ_OP_NAME(name) [REQ_OP_##name] = #name
130static const char *const blk_op_name[] = {
131 REQ_OP_NAME(READ),
132 REQ_OP_NAME(WRITE),
133 REQ_OP_NAME(FLUSH),
134 REQ_OP_NAME(DISCARD),
135 REQ_OP_NAME(SECURE_ERASE),
136 REQ_OP_NAME(ZONE_RESET),
Chaitanya Kulkarni6e33dbf2019-08-01 10:26:36 -0700137 REQ_OP_NAME(ZONE_RESET_ALL),
Ajay Joshi6c1b1da2019-10-27 23:05:45 +0900138 REQ_OP_NAME(ZONE_OPEN),
139 REQ_OP_NAME(ZONE_CLOSE),
140 REQ_OP_NAME(ZONE_FINISH),
Keith Busch0512a752020-05-12 17:55:47 +0900141 REQ_OP_NAME(ZONE_APPEND),
Chaitanya Kulkarnie47bc4e2019-06-20 10:59:16 -0700142 REQ_OP_NAME(WRITE_SAME),
143 REQ_OP_NAME(WRITE_ZEROES),
Chaitanya Kulkarnie47bc4e2019-06-20 10:59:16 -0700144 REQ_OP_NAME(DRV_IN),
145 REQ_OP_NAME(DRV_OUT),
146};
147#undef REQ_OP_NAME
148
149/**
150 * blk_op_str - Return string XXX in the REQ_OP_XXX.
151 * @op: REQ_OP_XXX.
152 *
153 * Description: Centralize block layer function to convert REQ_OP_XXX into
154 * string format. Useful in the debugging and tracing bio or request. For
155 * invalid REQ_OP_XXX it returns string "UNKNOWN".
156 */
157inline const char *blk_op_str(unsigned int op)
158{
159 const char *op_str = "UNKNOWN";
160
161 if (op < ARRAY_SIZE(blk_op_name) && blk_op_name[op])
162 op_str = blk_op_name[op];
163
164 return op_str;
165}
166EXPORT_SYMBOL_GPL(blk_op_str);
167
Christoph Hellwig2a842ac2017-06-03 09:38:04 +0200168static const struct {
169 int errno;
170 const char *name;
171} blk_errors[] = {
172 [BLK_STS_OK] = { 0, "" },
173 [BLK_STS_NOTSUPP] = { -EOPNOTSUPP, "operation not supported" },
174 [BLK_STS_TIMEOUT] = { -ETIMEDOUT, "timeout" },
175 [BLK_STS_NOSPC] = { -ENOSPC, "critical space allocation" },
176 [BLK_STS_TRANSPORT] = { -ENOLINK, "recoverable transport" },
177 [BLK_STS_TARGET] = { -EREMOTEIO, "critical target" },
178 [BLK_STS_NEXUS] = { -EBADE, "critical nexus" },
179 [BLK_STS_MEDIUM] = { -ENODATA, "critical medium" },
180 [BLK_STS_PROTECTION] = { -EILSEQ, "protection" },
181 [BLK_STS_RESOURCE] = { -ENOMEM, "kernel resource" },
Ming Lei86ff7c22018-01-30 22:04:57 -0500182 [BLK_STS_DEV_RESOURCE] = { -EBUSY, "device resource" },
Goldwyn Rodrigues03a07c92017-06-20 07:05:46 -0500183 [BLK_STS_AGAIN] = { -EAGAIN, "nonblocking retry" },
Christoph Hellwig2a842ac2017-06-03 09:38:04 +0200184
Christoph Hellwig4e4cbee2017-06-03 09:38:06 +0200185 /* device mapper special case, should not leak out: */
186 [BLK_STS_DM_REQUEUE] = { -EREMCHG, "dm internal retry" },
187
Keith Busch3b481d92020-09-24 13:53:28 -0700188 /* zone device specific errors */
189 [BLK_STS_ZONE_OPEN_RESOURCE] = { -ETOOMANYREFS, "open zones exceeded" },
190 [BLK_STS_ZONE_ACTIVE_RESOURCE] = { -EOVERFLOW, "active zones exceeded" },
191
Christoph Hellwig2a842ac2017-06-03 09:38:04 +0200192 /* everything else not covered above: */
193 [BLK_STS_IOERR] = { -EIO, "I/O" },
194};
195
196blk_status_t errno_to_blk_status(int errno)
197{
198 int i;
199
200 for (i = 0; i < ARRAY_SIZE(blk_errors); i++) {
201 if (blk_errors[i].errno == errno)
202 return (__force blk_status_t)i;
203 }
204
205 return BLK_STS_IOERR;
206}
207EXPORT_SYMBOL_GPL(errno_to_blk_status);
208
209int blk_status_to_errno(blk_status_t status)
210{
211 int idx = (__force int)status;
212
Bart Van Assche34bd9c12017-06-21 10:55:46 -0700213 if (WARN_ON_ONCE(idx >= ARRAY_SIZE(blk_errors)))
Christoph Hellwig2a842ac2017-06-03 09:38:04 +0200214 return -EIO;
215 return blk_errors[idx].errno;
216}
217EXPORT_SYMBOL_GPL(blk_status_to_errno);
218
Jens Axboe9be3e062021-10-14 09:17:01 -0600219void blk_print_req_error(struct request *req, blk_status_t status)
Christoph Hellwig2a842ac2017-06-03 09:38:04 +0200220{
221 int idx = (__force int)status;
222
Bart Van Assche34bd9c12017-06-21 10:55:46 -0700223 if (WARN_ON_ONCE(idx >= ARRAY_SIZE(blk_errors)))
Christoph Hellwig2a842ac2017-06-03 09:38:04 +0200224 return;
225
Christoph Hellwig178cc592019-06-20 10:59:15 -0700226 printk_ratelimited(KERN_ERR
Jens Axboec477b792021-10-14 09:15:40 -0600227 "%s error, dev %s, sector %llu op 0x%x:(%s) flags 0x%x "
Chaitanya Kulkarnib0e51682019-06-20 10:59:18 -0700228 "phys_seg %u prio class %u\n",
Jens Axboec477b792021-10-14 09:15:40 -0600229 blk_errors[idx].name,
Chaitanya Kulkarnib0e51682019-06-20 10:59:18 -0700230 req->rq_disk ? req->rq_disk->disk_name : "?",
231 blk_rq_pos(req), req_op(req), blk_op_str(req_op(req)),
232 req->cmd_flags & ~REQ_OP_MASK,
233 req->nr_phys_segments,
234 IOPRIO_PRIO_CLASS(req->ioprio));
Christoph Hellwig2a842ac2017-06-03 09:38:04 +0200235}
236
Linus Torvalds1da177e2005-04-16 15:20:36 -0700237void blk_dump_rq_flags(struct request *rq, char *msg)
238{
Christoph Hellwigaebf5262017-01-31 16:57:31 +0100239 printk(KERN_INFO "%s: dev %s: flags=%llx\n", msg,
240 rq->rq_disk ? rq->rq_disk->disk_name : "?",
Jens Axboe59533162013-05-23 12:25:08 +0200241 (unsigned long long) rq->cmd_flags);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700242
Tejun Heo83096eb2009-05-07 22:24:39 +0900243 printk(KERN_INFO " sector %llu, nr/cnr %u/%u\n",
244 (unsigned long long)blk_rq_pos(rq),
245 blk_rq_sectors(rq), blk_rq_cur_sectors(rq));
Jens Axboeb4f42e22014-04-10 09:46:28 -0600246 printk(KERN_INFO " bio %p, biotail %p, len %u\n",
247 rq->bio, rq->biotail, blk_rq_bytes(rq));
Linus Torvalds1da177e2005-04-16 15:20:36 -0700248}
Linus Torvalds1da177e2005-04-16 15:20:36 -0700249EXPORT_SYMBOL(blk_dump_rq_flags);
250
Linus Torvalds1da177e2005-04-16 15:20:36 -0700251/**
252 * blk_sync_queue - cancel any pending callbacks on a queue
253 * @q: the queue
254 *
255 * Description:
256 * The block layer may perform asynchronous callback activity
257 * on a queue, such as calling the unplug function after a timeout.
258 * A block device may call blk_sync_queue to ensure that any
259 * such activity is cancelled, thus allowing it to release resources
Michael Opdenacker59c51592007-05-09 08:57:56 +0200260 * that the callbacks might use. The caller must already have made sure
Christoph Hellwigc62b37d2020-07-01 10:59:43 +0200261 * that its ->submit_bio will not re-add plugging prior to calling
Linus Torvalds1da177e2005-04-16 15:20:36 -0700262 * this function.
263 *
Vivek Goyalda527772011-03-02 19:05:33 -0500264 * This function does not cancel any asynchronous activity arising
Masanari Iidada3dae52014-09-09 01:27:23 +0900265 * out of elevator or throttling code. That would require elevator_exit()
Tejun Heo5efd6112012-03-05 13:15:12 -0800266 * and blkcg_exit_queue() to be called with queue lock initialized.
Vivek Goyalda527772011-03-02 19:05:33 -0500267 *
Linus Torvalds1da177e2005-04-16 15:20:36 -0700268 */
269void blk_sync_queue(struct request_queue *q)
270{
Jens Axboe70ed28b2008-11-19 14:38:39 +0100271 del_timer_sync(&q->timeout);
Bart Van Assche4e9b6f22017-10-19 10:00:48 -0700272 cancel_work_sync(&q->timeout_work);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700273}
274EXPORT_SYMBOL(blk_sync_queue);
275
276/**
Bart Van Asschecd84a622018-09-26 14:01:04 -0700277 * blk_set_pm_only - increment pm_only counter
Bart Van Asschec9254f22017-11-09 10:49:57 -0800278 * @q: request queue pointer
Bart Van Asschec9254f22017-11-09 10:49:57 -0800279 */
Bart Van Asschecd84a622018-09-26 14:01:04 -0700280void blk_set_pm_only(struct request_queue *q)
Bart Van Asschec9254f22017-11-09 10:49:57 -0800281{
Bart Van Asschecd84a622018-09-26 14:01:04 -0700282 atomic_inc(&q->pm_only);
Bart Van Asschec9254f22017-11-09 10:49:57 -0800283}
Bart Van Asschecd84a622018-09-26 14:01:04 -0700284EXPORT_SYMBOL_GPL(blk_set_pm_only);
Bart Van Asschec9254f22017-11-09 10:49:57 -0800285
Bart Van Asschecd84a622018-09-26 14:01:04 -0700286void blk_clear_pm_only(struct request_queue *q)
Bart Van Asschec9254f22017-11-09 10:49:57 -0800287{
Bart Van Asschecd84a622018-09-26 14:01:04 -0700288 int pm_only;
289
290 pm_only = atomic_dec_return(&q->pm_only);
291 WARN_ON_ONCE(pm_only < 0);
292 if (pm_only == 0)
293 wake_up_all(&q->mq_freeze_wq);
Bart Van Asschec9254f22017-11-09 10:49:57 -0800294}
Bart Van Asschecd84a622018-09-26 14:01:04 -0700295EXPORT_SYMBOL_GPL(blk_clear_pm_only);
Bart Van Asschec9254f22017-11-09 10:49:57 -0800296
Luis Chamberlainb5bd3572020-06-19 20:47:23 +0000297/**
298 * blk_put_queue - decrement the request_queue refcount
299 * @q: the request_queue structure to decrement the refcount for
300 *
301 * Decrements the refcount of the request_queue kobject. When this reaches 0
302 * we'll have blk_release_queue() called.
Luis Chamberlaine8c7d142020-06-19 20:47:25 +0000303 *
304 * Context: Any context, but the last reference must not be dropped from
305 * atomic context.
Luis Chamberlainb5bd3572020-06-19 20:47:23 +0000306 */
Jens Axboe165125e2007-07-24 09:28:11 +0200307void blk_put_queue(struct request_queue *q)
Al Viro483f4af2006-03-18 18:34:37 -0500308{
309 kobject_put(&q->kobj);
310}
Jens Axboed86e0e82011-05-27 07:44:43 +0200311EXPORT_SYMBOL(blk_put_queue);
Al Viro483f4af2006-03-18 18:34:37 -0500312
Christoph Hellwig8e141f92021-09-29 09:12:40 +0200313void blk_queue_start_drain(struct request_queue *q)
Jens Axboeaed3ea92014-12-22 14:04:42 -0700314{
Ming Leid3cfb2a2017-03-27 20:06:58 +0800315 /*
316 * When queue DYING flag is set, we need to block new req
317 * entering queue, so we call blk_freeze_queue_start() to
318 * prevent I/O from crossing blk_queue_enter().
319 */
320 blk_freeze_queue_start(q);
Jens Axboe344e9ff2018-11-15 12:22:51 -0700321 if (queue_is_mq(q))
Jens Axboeaed3ea92014-12-22 14:04:42 -0700322 blk_mq_wake_waiters(q);
Ming Lei055f6e12017-11-09 10:49:53 -0800323 /* Make blk_queue_enter() reexamine the DYING flag. */
324 wake_up_all(&q->mq_freeze_wq);
Jens Axboeaed3ea92014-12-22 14:04:42 -0700325}
Christoph Hellwig8e141f92021-09-29 09:12:40 +0200326
327void blk_set_queue_dying(struct request_queue *q)
328{
329 blk_queue_flag_set(QUEUE_FLAG_DYING, q);
330 blk_queue_start_drain(q);
331}
Jens Axboeaed3ea92014-12-22 14:04:42 -0700332EXPORT_SYMBOL_GPL(blk_set_queue_dying);
333
Tejun Heod7325802012-03-05 13:14:58 -0800334/**
Tejun Heoc9a929d2011-10-19 14:42:16 +0200335 * blk_cleanup_queue - shutdown a request queue
336 * @q: request queue to shutdown
337 *
Bart Van Asschec246e802012-12-06 14:32:01 +0100338 * Mark @q DYING, drain all pending requests, mark @q DEAD, destroy and
339 * put it. All future requests will be failed immediately with -ENODEV.
Luis Chamberlaine8c7d142020-06-19 20:47:25 +0000340 *
341 * Context: can sleep
Vivek Goyalc94a96a2011-03-02 19:04:42 -0500342 */
Jens Axboe6728cb02008-01-31 13:03:55 +0100343void blk_cleanup_queue(struct request_queue *q)
Al Viro483f4af2006-03-18 18:34:37 -0500344{
Luis Chamberlaine8c7d142020-06-19 20:47:25 +0000345 /* cannot be called from atomic context */
346 might_sleep();
347
Bart Van Asschebae85c12019-09-30 16:00:43 -0700348 WARN_ON_ONCE(blk_queue_registered(q));
349
Bart Van Assche3f3299d2012-11-28 13:42:38 +0100350 /* mark @q DYING, no new request or merges will be allowed afterwards */
Jens Axboeaed3ea92014-12-22 14:04:42 -0700351 blk_set_queue_dying(q);
Tejun Heo6ecf23a2012-03-05 13:14:59 -0800352
Christoph Hellwig57d74df2018-11-14 17:02:07 +0100353 blk_queue_flag_set(QUEUE_FLAG_NOMERGES, q);
354 blk_queue_flag_set(QUEUE_FLAG_NOXMERGES, q);
Tejun Heoc9a929d2011-10-19 14:42:16 +0200355
Bart Van Asschec246e802012-12-06 14:32:01 +0100356 /*
357 * Drain all requests queued before DYING marking. Set DEAD flag to
Bart Van Assche67ed8b72019-08-01 15:39:55 -0700358 * prevent that blk_mq_run_hw_queues() accesses the hardware queues
359 * after draining finished.
Bart Van Asschec246e802012-12-06 14:32:01 +0100360 */
Dan Williams3ef28e82015-10-21 13:20:12 -0400361 blk_freeze_queue(q);
Ming Leic57cdf72018-10-24 21:18:09 +0800362
Christoph Hellwig57d74df2018-11-14 17:02:07 +0100363 blk_queue_flag_set(QUEUE_FLAG_DEAD, q);
Tejun Heoc9a929d2011-10-19 14:42:16 +0200364
Tejun Heoc9a929d2011-10-19 14:42:16 +0200365 blk_sync_queue(q);
Ming Lei2a19b282021-11-16 09:43:43 +0800366 if (queue_is_mq(q)) {
367 blk_mq_cancel_work_sync(q);
Ming Leic7e2d942019-04-30 09:52:25 +0800368 blk_mq_exit_queue(q);
Ming Lei2a19b282021-11-16 09:43:43 +0800369 }
Jens Axboea1ce35f2018-10-29 10:23:51 -0600370
Ming Leic3e22192019-06-04 21:08:02 +0800371 /*
372 * In theory, request pool of sched_tags belongs to request queue.
373 * However, the current implementation requires tag_set for freeing
374 * requests, so free the pool now.
375 *
376 * Queue has become frozen, there can't be any in-queue requests, so
377 * it is safe to free requests now.
378 */
379 mutex_lock(&q->sysfs_lock);
380 if (q->elevator)
John Garry1820f4f2021-10-05 18:23:31 +0800381 blk_mq_sched_free_rqs(q);
Ming Leic3e22192019-06-04 21:08:02 +0800382 mutex_unlock(&q->sysfs_lock);
383
Dan Williams3ef28e82015-10-21 13:20:12 -0400384 percpu_ref_exit(&q->q_usage_counter);
Bart Van Assche45a9c9d2014-12-09 16:57:48 +0100385
Tejun Heoc9a929d2011-10-19 14:42:16 +0200386 /* @q is and will stay empty, shutdown and put */
Al Viro483f4af2006-03-18 18:34:37 -0500387 blk_put_queue(q);
388}
Linus Torvalds1da177e2005-04-16 15:20:36 -0700389EXPORT_SYMBOL(blk_cleanup_queue);
390
Bart Van Assche3a0a5292017-11-09 10:49:58 -0800391/**
392 * blk_queue_enter() - try to increase q->q_usage_counter
393 * @q: request queue pointer
Bart Van Asschea4d34da2020-12-08 21:29:50 -0800394 * @flags: BLK_MQ_REQ_NOWAIT and/or BLK_MQ_REQ_PM
Bart Van Assche3a0a5292017-11-09 10:49:58 -0800395 */
Bart Van Assche9a95e4e2017-11-09 10:49:59 -0800396int blk_queue_enter(struct request_queue *q, blk_mq_req_flags_t flags)
Dan Williams3ef28e82015-10-21 13:20:12 -0400397{
Bart Van Asschea4d34da2020-12-08 21:29:50 -0800398 const bool pm = flags & BLK_MQ_REQ_PM;
Bart Van Assche3a0a5292017-11-09 10:49:58 -0800399
Christoph Hellwig1f14a092021-09-29 09:12:38 +0200400 while (!blk_try_enter_queue(q, pm)) {
Bart Van Assche3a0a5292017-11-09 10:49:58 -0800401 if (flags & BLK_MQ_REQ_NOWAIT)
Dan Williams3ef28e82015-10-21 13:20:12 -0400402 return -EBUSY;
403
Ming Lei5ed61d32017-03-27 20:06:56 +0800404 /*
Christoph Hellwig1f14a092021-09-29 09:12:38 +0200405 * read pair of barrier in blk_freeze_queue_start(), we need to
406 * order reading __PERCPU_REF_DEAD flag of .q_usage_counter and
407 * reading .mq_freeze_depth or queue dying flag, otherwise the
408 * following wait may never return if the two reads are
409 * reordered.
Ming Lei5ed61d32017-03-27 20:06:56 +0800410 */
411 smp_rmb();
Alan Jenkins1dc30392018-04-12 19:11:58 +0100412 wait_event(q->mq_freeze_wq,
Bob Liu7996a8b2019-05-21 11:25:55 +0800413 (!q->mq_freeze_depth &&
Alan Stern52abca62020-12-08 21:29:51 -0800414 blk_pm_resume_queue(pm, q)) ||
Alan Jenkins1dc30392018-04-12 19:11:58 +0100415 blk_queue_dying(q));
Dan Williams3ef28e82015-10-21 13:20:12 -0400416 if (blk_queue_dying(q))
417 return -ENODEV;
Dan Williams3ef28e82015-10-21 13:20:12 -0400418 }
Christoph Hellwig1f14a092021-09-29 09:12:38 +0200419
420 return 0;
Dan Williams3ef28e82015-10-21 13:20:12 -0400421}
422
Jens Axboec98cb5b2021-11-04 12:45:51 -0600423int __bio_queue_enter(struct request_queue *q, struct bio *bio)
Christoph Hellwigaccea322020-04-28 13:27:56 +0200424{
Christoph Hellwiga6741532021-09-29 09:12:39 +0200425 while (!blk_try_enter_queue(q, false)) {
Pavel Begunkoveab4e022021-10-14 15:03:29 +0100426 struct gendisk *disk = bio->bi_bdev->bd_disk;
427
Christoph Hellwiga6741532021-09-29 09:12:39 +0200428 if (bio->bi_opf & REQ_NOWAIT) {
Christoph Hellwig8e141f92021-09-29 09:12:40 +0200429 if (test_bit(GD_DEAD, &disk->state))
Christoph Hellwiga6741532021-09-29 09:12:39 +0200430 goto dead;
Christoph Hellwigaccea322020-04-28 13:27:56 +0200431 bio_wouldblock_error(bio);
Christoph Hellwiga6741532021-09-29 09:12:39 +0200432 return -EBUSY;
433 }
434
435 /*
436 * read pair of barrier in blk_freeze_queue_start(), we need to
437 * order reading __PERCPU_REF_DEAD flag of .q_usage_counter and
438 * reading .mq_freeze_depth or queue dying flag, otherwise the
439 * following wait may never return if the two reads are
440 * reordered.
441 */
442 smp_rmb();
443 wait_event(q->mq_freeze_wq,
444 (!q->mq_freeze_depth &&
445 blk_pm_resume_queue(false, q)) ||
Christoph Hellwig8e141f92021-09-29 09:12:40 +0200446 test_bit(GD_DEAD, &disk->state));
447 if (test_bit(GD_DEAD, &disk->state))
Christoph Hellwiga6741532021-09-29 09:12:39 +0200448 goto dead;
Christoph Hellwigaccea322020-04-28 13:27:56 +0200449 }
450
Christoph Hellwiga6741532021-09-29 09:12:39 +0200451 return 0;
452dead:
453 bio_io_error(bio);
454 return -ENODEV;
Christoph Hellwigaccea322020-04-28 13:27:56 +0200455}
456
Dan Williams3ef28e82015-10-21 13:20:12 -0400457void blk_queue_exit(struct request_queue *q)
458{
459 percpu_ref_put(&q->q_usage_counter);
460}
461
462static void blk_queue_usage_counter_release(struct percpu_ref *ref)
463{
464 struct request_queue *q =
465 container_of(ref, struct request_queue, q_usage_counter);
466
467 wake_up_all(&q->mq_freeze_wq);
468}
469
Kees Cookbca237a2017-08-28 15:03:41 -0700470static void blk_rq_timed_out_timer(struct timer_list *t)
Christoph Hellwig287922e2015-10-30 20:57:30 +0800471{
Kees Cookbca237a2017-08-28 15:03:41 -0700472 struct request_queue *q = from_timer(q, t, timeout);
Christoph Hellwig287922e2015-10-30 20:57:30 +0800473
474 kblockd_schedule_work(&q->timeout_work);
475}
476
Tetsuo Handa2e3c18d2019-01-30 22:21:45 +0900477static void blk_timeout_work(struct work_struct *work)
478{
479}
480
Christoph Hellwigc62b37d2020-07-01 10:59:43 +0200481struct request_queue *blk_alloc_queue(int node_id)
Christoph Lameter19460892005-06-23 00:08:19 -0700482{
Jens Axboe165125e2007-07-24 09:28:11 +0200483 struct request_queue *q;
Kent Overstreet338aa962018-05-20 18:25:47 -0400484 int ret;
Christoph Lameter19460892005-06-23 00:08:19 -0700485
Jens Axboe8324aa92008-01-29 14:51:59 +0100486 q = kmem_cache_alloc_node(blk_requestq_cachep,
Christoph Hellwig3d745ea2020-03-27 09:30:11 +0100487 GFP_KERNEL | __GFP_ZERO, node_id);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700488 if (!q)
489 return NULL;
490
Christoph Hellwigcbf62af2018-05-31 19:11:36 +0200491 q->last_merge = NULL;
Christoph Hellwigcbf62af2018-05-31 19:11:36 +0200492
Christoph Hellwig3d745ea2020-03-27 09:30:11 +0100493 q->id = ida_simple_get(&blk_queue_ida, 0, 0, GFP_KERNEL);
Tejun Heoa73f7302011-12-14 00:33:37 +0100494 if (q->id < 0)
Ming Lei3d2936f2014-05-27 23:35:14 +0800495 goto fail_q;
Tejun Heoa73f7302011-12-14 00:33:37 +0100496
Ming Leic495a172021-01-11 11:05:53 +0800497 ret = bioset_init(&q->bio_split, BIO_POOL_SIZE, 0, 0);
Kent Overstreet338aa962018-05-20 18:25:47 -0400498 if (ret)
Kent Overstreet54efd502015-04-23 22:37:18 -0700499 goto fail_id;
500
Jens Axboea83b5762017-03-21 17:20:01 -0600501 q->stats = blk_alloc_queue_stats();
502 if (!q->stats)
Christoph Hellwigedb08722021-08-09 16:17:43 +0200503 goto fail_split;
Jens Axboea83b5762017-03-21 17:20:01 -0600504
Mike Snitzer51514122011-11-23 10:59:13 +0100505 q->node = node_id;
Jens Axboe0989a022009-06-12 14:42:56 +0200506
John Garry079a2e32021-10-05 18:23:39 +0800507 atomic_set(&q->nr_active_requests_shared_tags, 0);
John Garrybccf5e22020-08-19 23:20:26 +0800508
Kees Cookbca237a2017-08-28 15:03:41 -0700509 timer_setup(&q->timeout, blk_rq_timed_out_timer, 0);
Tetsuo Handa2e3c18d2019-01-30 22:21:45 +0900510 INIT_WORK(&q->timeout_work, blk_timeout_work);
Tejun Heoa612fdd2011-12-14 00:33:41 +0100511 INIT_LIST_HEAD(&q->icq_list);
Tejun Heo4eef3042012-03-05 13:15:18 -0800512#ifdef CONFIG_BLK_CGROUP
Tejun Heoe8989fa2012-03-05 13:15:20 -0800513 INIT_LIST_HEAD(&q->blkg_list);
Tejun Heo4eef3042012-03-05 13:15:18 -0800514#endif
Al Viro483f4af2006-03-18 18:34:37 -0500515
Jens Axboe8324aa92008-01-29 14:51:59 +0100516 kobject_init(&q->kobj, &blk_queue_ktype);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700517
Luis Chamberlain85e0cbb2020-06-19 20:47:30 +0000518 mutex_init(&q->debugfs_mutex);
Al Viro483f4af2006-03-18 18:34:37 -0500519 mutex_init(&q->sysfs_lock);
Ming Leicecf5d82019-08-27 19:01:48 +0800520 mutex_init(&q->sysfs_dir_lock);
Christoph Hellwig0d945c12018-11-15 12:17:28 -0700521 spin_lock_init(&q->queue_lock);
Vivek Goyalc94a96a2011-03-02 19:04:42 -0500522
Jens Axboe320ae512013-10-24 09:20:05 +0100523 init_waitqueue_head(&q->mq_freeze_wq);
Bob Liu7996a8b2019-05-21 11:25:55 +0800524 mutex_init(&q->mq_freeze_lock);
Jens Axboe320ae512013-10-24 09:20:05 +0100525
Dan Williams3ef28e82015-10-21 13:20:12 -0400526 /*
527 * Init percpu_ref in atomic mode so that it's faster to shutdown.
528 * See blk_register_queue() for details.
529 */
530 if (percpu_ref_init(&q->q_usage_counter,
531 blk_queue_usage_counter_release,
532 PERCPU_REF_INIT_ATOMIC, GFP_KERNEL))
Christoph Hellwigedb08722021-08-09 16:17:43 +0200533 goto fail_stats;
Tejun Heof51b8022012-03-05 13:15:05 -0800534
Dan Williams3ef28e82015-10-21 13:20:12 -0400535 if (blkcg_init_queue(q))
536 goto fail_ref;
537
Christoph Hellwig3d745ea2020-03-27 09:30:11 +0100538 blk_queue_dma_alignment(q, 511);
539 blk_set_default_limits(&q->limits);
John Garryd2a27962021-10-05 18:23:27 +0800540 q->nr_requests = BLKDEV_DEFAULT_RQ;
Christoph Hellwig3d745ea2020-03-27 09:30:11 +0100541
Linus Torvalds1da177e2005-04-16 15:20:36 -0700542 return q;
Tejun Heoa73f7302011-12-14 00:33:37 +0100543
Dan Williams3ef28e82015-10-21 13:20:12 -0400544fail_ref:
545 percpu_ref_exit(&q->q_usage_counter);
Jens Axboea83b5762017-03-21 17:20:01 -0600546fail_stats:
Christoph Hellwigedb08722021-08-09 16:17:43 +0200547 blk_free_queue_stats(q->stats);
Kent Overstreet54efd502015-04-23 22:37:18 -0700548fail_split:
Kent Overstreet338aa962018-05-20 18:25:47 -0400549 bioset_exit(&q->bio_split);
Tejun Heoa73f7302011-12-14 00:33:37 +0100550fail_id:
551 ida_simple_remove(&blk_queue_ida, q->id);
552fail_q:
553 kmem_cache_free(blk_requestq_cachep, q);
554 return NULL;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700555}
Linus Torvalds1da177e2005-04-16 15:20:36 -0700556
Luis Chamberlainb5bd3572020-06-19 20:47:23 +0000557/**
558 * blk_get_queue - increment the request_queue refcount
559 * @q: the request_queue structure to increment the refcount for
560 *
561 * Increment the refcount of the request_queue kobject.
Luis Chamberlain763b5892020-06-19 20:47:24 +0000562 *
563 * Context: Any context.
Luis Chamberlainb5bd3572020-06-19 20:47:23 +0000564 */
Tejun Heo09ac46c2011-12-14 00:33:38 +0100565bool blk_get_queue(struct request_queue *q)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700566{
Bart Van Assche3f3299d2012-11-28 13:42:38 +0100567 if (likely(!blk_queue_dying(q))) {
Tejun Heo09ac46c2011-12-14 00:33:38 +0100568 __blk_get_queue(q);
569 return true;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700570 }
571
Tejun Heo09ac46c2011-12-14 00:33:38 +0100572 return false;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700573}
Jens Axboed86e0e82011-05-27 07:44:43 +0200574EXPORT_SYMBOL(blk_get_queue);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700575
Christoph Hellwig52c5e622018-03-14 16:56:53 +0100576static void handle_bad_sector(struct bio *bio, sector_t maxsector)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700577{
578 char b[BDEVNAME_SIZE];
579
Christoph Hellwig8a3ee672021-09-28 07:27:55 +0200580 pr_info_ratelimited("%s: attempt to access beyond end of device\n"
Tetsuo Handaf4ac7122020-10-08 22:37:23 +0900581 "%s: rw=%d, want=%llu, limit=%llu\n",
Christoph Hellwig8a3ee672021-09-28 07:27:55 +0200582 current->comm,
Tetsuo Handaf4ac7122020-10-08 22:37:23 +0900583 bio_devname(bio, b), bio->bi_opf,
584 bio_end_sector(bio), maxsector);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700585}
586
Akinobu Mitac17bb492006-12-08 02:39:46 -0800587#ifdef CONFIG_FAIL_MAKE_REQUEST
588
589static DECLARE_FAULT_ATTR(fail_make_request);
590
591static int __init setup_fail_make_request(char *str)
592{
593 return setup_fault_attr(&fail_make_request, str);
594}
595__setup("fail_make_request=", setup_fail_make_request);
596
Christoph Hellwig8446fe92020-11-24 09:36:54 +0100597static bool should_fail_request(struct block_device *part, unsigned int bytes)
Akinobu Mitac17bb492006-12-08 02:39:46 -0800598{
Christoph Hellwig8446fe92020-11-24 09:36:54 +0100599 return part->bd_make_it_fail && should_fail(&fail_make_request, bytes);
Akinobu Mitac17bb492006-12-08 02:39:46 -0800600}
601
602static int __init fail_make_request_debugfs(void)
603{
Akinobu Mitadd48c082011-08-03 16:21:01 -0700604 struct dentry *dir = fault_create_debugfs_attr("fail_make_request",
605 NULL, &fail_make_request);
606
Duan Jiong21f9fcd2014-04-11 15:58:56 +0800607 return PTR_ERR_OR_ZERO(dir);
Akinobu Mitac17bb492006-12-08 02:39:46 -0800608}
609
610late_initcall(fail_make_request_debugfs);
611
612#else /* CONFIG_FAIL_MAKE_REQUEST */
613
Christoph Hellwig8446fe92020-11-24 09:36:54 +0100614static inline bool should_fail_request(struct block_device *part,
Akinobu Mitab2c9cd32011-07-26 16:09:03 -0700615 unsigned int bytes)
Akinobu Mitac17bb492006-12-08 02:39:46 -0800616{
Akinobu Mitab2c9cd32011-07-26 16:09:03 -0700617 return false;
Akinobu Mitac17bb492006-12-08 02:39:46 -0800618}
619
620#endif /* CONFIG_FAIL_MAKE_REQUEST */
621
Christoph Hellwig2f9f6222021-01-24 11:02:35 +0100622static inline bool bio_check_ro(struct bio *bio)
Ilya Dryomov721c7fc2018-01-11 14:09:11 +0100623{
Christoph Hellwig2f9f6222021-01-24 11:02:35 +0100624 if (op_is_write(bio_op(bio)) && bdev_read_only(bio->bi_bdev)) {
Ilya Dryomov721c7fc2018-01-11 14:09:11 +0100625 char b[BDEVNAME_SIZE];
626
Mikulas Patocka8b2ded12018-09-05 16:14:36 -0600627 if (op_is_flush(bio->bi_opf) && !bio_sectors(bio))
628 return false;
629
Linus Torvaldsa32e2362018-08-03 12:22:09 -0700630 WARN_ONCE(1,
Christoph Hellwigc8178672020-07-01 10:59:40 +0200631 "Trying to write to read-only block-device %s (partno %d)\n",
Christoph Hellwig2f9f6222021-01-24 11:02:35 +0100632 bio_devname(bio, b), bio->bi_bdev->bd_partno);
Linus Torvaldsa32e2362018-08-03 12:22:09 -0700633 /* Older lvm-tools actually trigger this */
634 return false;
Ilya Dryomov721c7fc2018-01-11 14:09:11 +0100635 }
636
637 return false;
638}
639
Howard McLauchlan30abb3a2018-02-06 14:05:39 -0800640static noinline int should_fail_bio(struct bio *bio)
641{
Christoph Hellwig309dca302021-01-24 11:02:34 +0100642 if (should_fail_request(bdev_whole(bio->bi_bdev), bio->bi_iter.bi_size))
Howard McLauchlan30abb3a2018-02-06 14:05:39 -0800643 return -EIO;
644 return 0;
645}
646ALLOW_ERROR_INJECTION(should_fail_bio, ERRNO);
647
Jens Axboec07e2b42007-07-18 13:27:58 +0200648/*
Christoph Hellwig52c5e622018-03-14 16:56:53 +0100649 * Check whether this bio extends beyond the end of the device or partition.
650 * This may well happen - the kernel calls bread() without checking the size of
651 * the device, e.g., when mounting a file system.
652 */
Christoph Hellwig2f9f6222021-01-24 11:02:35 +0100653static inline int bio_check_eod(struct bio *bio)
Christoph Hellwig52c5e622018-03-14 16:56:53 +0100654{
Christoph Hellwig2f9f6222021-01-24 11:02:35 +0100655 sector_t maxsector = bdev_nr_sectors(bio->bi_bdev);
Christoph Hellwig52c5e622018-03-14 16:56:53 +0100656 unsigned int nr_sectors = bio_sectors(bio);
657
658 if (nr_sectors && maxsector &&
659 (nr_sectors > maxsector ||
660 bio->bi_iter.bi_sector > maxsector - nr_sectors)) {
661 handle_bad_sector(bio, maxsector);
662 return -EIO;
663 }
664 return 0;
665}
666
667/*
Christoph Hellwig74d46992017-08-23 19:10:32 +0200668 * Remap block n of partition p to block n+start(p) of the disk.
669 */
Christoph Hellwig2f9f6222021-01-24 11:02:35 +0100670static int blk_partition_remap(struct bio *bio)
Christoph Hellwig74d46992017-08-23 19:10:32 +0200671{
Christoph Hellwig309dca302021-01-24 11:02:34 +0100672 struct block_device *p = bio->bi_bdev;
Christoph Hellwig74d46992017-08-23 19:10:32 +0200673
Christoph Hellwig52c5e622018-03-14 16:56:53 +0100674 if (unlikely(should_fail_request(p, bio->bi_iter.bi_size)))
Christoph Hellwig2f9f6222021-01-24 11:02:35 +0100675 return -EIO;
Damien Le Moal5eac3eb2019-11-11 11:39:25 +0900676 if (bio_sectors(bio)) {
Christoph Hellwig8446fe92020-11-24 09:36:54 +0100677 bio->bi_iter.bi_sector += p->bd_start_sect;
Christoph Hellwig1c02fca2020-12-03 17:21:38 +0100678 trace_block_bio_remap(bio, p->bd_dev,
Christoph Hellwig29ff57c2020-11-24 09:34:24 +0100679 bio->bi_iter.bi_sector -
Christoph Hellwig8446fe92020-11-24 09:36:54 +0100680 p->bd_start_sect);
Christoph Hellwig52c5e622018-03-14 16:56:53 +0100681 }
Christoph Hellwig30c5d342021-01-24 11:02:36 +0100682 bio_set_flag(bio, BIO_REMAPPED);
Christoph Hellwig2f9f6222021-01-24 11:02:35 +0100683 return 0;
Christoph Hellwig74d46992017-08-23 19:10:32 +0200684}
685
Keith Busch0512a752020-05-12 17:55:47 +0900686/*
687 * Check write append to a zoned block device.
688 */
689static inline blk_status_t blk_check_zone_append(struct request_queue *q,
690 struct bio *bio)
691{
692 sector_t pos = bio->bi_iter.bi_sector;
693 int nr_sectors = bio_sectors(bio);
694
695 /* Only applicable to zoned block devices */
696 if (!blk_queue_is_zoned(q))
697 return BLK_STS_NOTSUPP;
698
699 /* The bio sector must point to the start of a sequential zone */
700 if (pos & (blk_queue_zone_sectors(q) - 1) ||
701 !blk_queue_zone_is_seq(q, pos))
702 return BLK_STS_IOERR;
703
704 /*
705 * Not allowed to cross zone boundaries. Otherwise, the BIO will be
706 * split and could result in non-contiguous sectors being written in
707 * different zones.
708 */
709 if (nr_sectors > q->limits.chunk_sectors)
710 return BLK_STS_IOERR;
711
712 /* Make sure the BIO is small enough and will not get split */
713 if (nr_sectors > q->limits.max_zone_append_sectors)
714 return BLK_STS_IOERR;
715
716 bio->bi_opf |= REQ_NOMERGE;
717
718 return BLK_STS_OK;
719}
720
Jens Axboe900e0802021-11-03 05:47:09 -0600721noinline_for_stack bool submit_bio_checks(struct bio *bio)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700722{
Christoph Hellwig309dca302021-01-24 11:02:34 +0100723 struct block_device *bdev = bio->bi_bdev;
Pavel Begunkoveab4e022021-10-14 15:03:29 +0100724 struct request_queue *q = bdev_get_queue(bdev);
Christoph Hellwig4e4cbee2017-06-03 09:38:06 +0200725 blk_status_t status = BLK_STS_IOERR;
Jens Axboe5a473e82020-06-04 11:23:39 -0600726 struct blk_plug *plug;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700727
728 might_sleep();
Linus Torvalds1da177e2005-04-16 15:20:36 -0700729
Jens Axboe5a473e82020-06-04 11:23:39 -0600730 plug = blk_mq_plug(q, bio);
731 if (plug && plug->nowait)
732 bio->bi_opf |= REQ_NOWAIT;
733
Goldwyn Rodrigues03a07c92017-06-20 07:05:46 -0500734 /*
Jens Axboeb0beb282020-05-28 13:19:29 -0600735 * For a REQ_NOWAIT based request, return -EOPNOTSUPP
Mike Snitzer021a2442020-09-23 16:06:51 -0400736 * if queue does not support NOWAIT.
Goldwyn Rodrigues03a07c92017-06-20 07:05:46 -0500737 */
Mike Snitzer021a2442020-09-23 16:06:51 -0400738 if ((bio->bi_opf & REQ_NOWAIT) && !blk_queue_nowait(q))
Jens Axboeb0beb282020-05-28 13:19:29 -0600739 goto not_supported;
Goldwyn Rodrigues03a07c92017-06-20 07:05:46 -0500740
Howard McLauchlan30abb3a2018-02-06 14:05:39 -0800741 if (should_fail_bio(bio))
Christoph Hellwig5a7bbad2011-09-12 12:12:01 +0200742 goto end_io;
Christoph Hellwig2f9f6222021-01-24 11:02:35 +0100743 if (unlikely(bio_check_ro(bio)))
744 goto end_io;
Christoph Hellwig3a905c32021-01-25 19:39:57 +0100745 if (!bio_flagged(bio, BIO_REMAPPED)) {
746 if (unlikely(bio_check_eod(bio)))
747 goto end_io;
748 if (bdev->bd_partno && unlikely(blk_partition_remap(bio)))
749 goto end_io;
750 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700751
Christoph Hellwig5a7bbad2011-09-12 12:12:01 +0200752 /*
Christoph Hellwiged00aab2020-07-01 10:59:44 +0200753 * Filter flush bio's early so that bio based drivers without flush
754 * support don't have to worry about them.
Christoph Hellwig5a7bbad2011-09-12 12:12:01 +0200755 */
Jens Axboef3a8ab72017-01-27 09:08:23 -0700756 if (op_is_flush(bio->bi_opf) &&
Jens Axboec888a8f2016-04-13 13:33:19 -0600757 !test_bit(QUEUE_FLAG_WC, &q->queue_flags)) {
Jens Axboe1eff9d32016-08-05 15:35:16 -0600758 bio->bi_opf &= ~(REQ_PREFLUSH | REQ_FUA);
Christoph Hellwige439ab72020-07-01 10:59:42 +0200759 if (!bio_sectors(bio)) {
Christoph Hellwig4e4cbee2017-06-03 09:38:06 +0200760 status = BLK_STS_OK;
Tejun Heoa7384672008-11-28 13:32:03 +0900761 goto end_io;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700762 }
Christoph Hellwig5a7bbad2011-09-12 12:12:01 +0200763 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700764
Christoph Hellwigd04c4062018-12-14 17:21:22 +0100765 if (!test_bit(QUEUE_FLAG_POLL, &q->queue_flags))
Christoph Hellwig6ce913f2021-10-12 13:12:21 +0200766 bio_clear_polled(bio);
Christoph Hellwigd04c4062018-12-14 17:21:22 +0100767
Christoph Hellwig288dab82016-06-09 16:00:36 +0200768 switch (bio_op(bio)) {
769 case REQ_OP_DISCARD:
770 if (!blk_queue_discard(q))
771 goto not_supported;
772 break;
773 case REQ_OP_SECURE_ERASE:
774 if (!blk_queue_secure_erase(q))
775 goto not_supported;
776 break;
777 case REQ_OP_WRITE_SAME:
Christoph Hellwig74d46992017-08-23 19:10:32 +0200778 if (!q->limits.max_write_same_sectors)
Christoph Hellwig288dab82016-06-09 16:00:36 +0200779 goto not_supported;
Nicolai Stange58886782016-12-04 14:56:39 +0100780 break;
Keith Busch0512a752020-05-12 17:55:47 +0900781 case REQ_OP_ZONE_APPEND:
782 status = blk_check_zone_append(q, bio);
783 if (status != BLK_STS_OK)
784 goto end_io;
785 break;
Shaun Tancheff2d253442016-10-18 15:40:32 +0900786 case REQ_OP_ZONE_RESET:
Ajay Joshi6c1b1da2019-10-27 23:05:45 +0900787 case REQ_OP_ZONE_OPEN:
788 case REQ_OP_ZONE_CLOSE:
789 case REQ_OP_ZONE_FINISH:
Christoph Hellwig74d46992017-08-23 19:10:32 +0200790 if (!blk_queue_is_zoned(q))
Shaun Tancheff2d253442016-10-18 15:40:32 +0900791 goto not_supported;
Christoph Hellwig288dab82016-06-09 16:00:36 +0200792 break;
Chaitanya Kulkarni6e33dbf2019-08-01 10:26:36 -0700793 case REQ_OP_ZONE_RESET_ALL:
794 if (!blk_queue_is_zoned(q) || !blk_queue_zone_resetall(q))
795 goto not_supported;
796 break;
Chaitanya Kulkarnia6f07882016-11-30 12:28:59 -0800797 case REQ_OP_WRITE_ZEROES:
Christoph Hellwig74d46992017-08-23 19:10:32 +0200798 if (!q->limits.max_write_zeroes_sectors)
Chaitanya Kulkarnia6f07882016-11-30 12:28:59 -0800799 goto not_supported;
800 break;
Christoph Hellwig288dab82016-06-09 16:00:36 +0200801 default:
802 break;
Christoph Hellwig5a7bbad2011-09-12 12:12:01 +0200803 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700804
Tejun Heo7f4b35d2012-06-04 20:40:56 -0700805 /*
Christoph Hellwig3e82c342020-04-25 09:55:51 +0200806 * Various block parts want %current->io_context, so allocate it up
807 * front rather than dealing with lots of pain to allocate it only
808 * where needed. This may fail and the block layer knows how to live
809 * with it.
Tejun Heo7f4b35d2012-06-04 20:40:56 -0700810 */
Christoph Hellwig3e82c342020-04-25 09:55:51 +0200811 if (unlikely(!current->io_context))
812 create_task_io_context(current, GFP_ATOMIC, q->node);
Tejun Heo7f4b35d2012-06-04 20:40:56 -0700813
Laibin Qiub781d8db52021-11-12 17:33:54 +0800814 if (blk_throtl_bio(bio))
Tejun Heoae118892015-08-18 14:55:20 -0700815 return false;
Christoph Hellwigdb18a532020-06-27 09:31:58 +0200816
817 blk_cgroup_bio_start(bio);
818 blkcg_bio_issue_init(bio);
Christoph Hellwig27a84d52011-09-15 14:01:40 +0200819
NeilBrownfbbaf702017-04-07 09:40:52 -0600820 if (!bio_flagged(bio, BIO_TRACE_COMPLETION)) {
Christoph Hellwige8a676d2020-12-03 17:21:36 +0100821 trace_block_bio_queue(bio);
NeilBrownfbbaf702017-04-07 09:40:52 -0600822 /* Now that enqueuing has been traced, we need to trace
823 * completion as well.
824 */
825 bio_set_flag(bio, BIO_TRACE_COMPLETION);
826 }
Christoph Hellwig27a84d52011-09-15 14:01:40 +0200827 return true;
Tejun Heoa7384672008-11-28 13:32:03 +0900828
Christoph Hellwig288dab82016-06-09 16:00:36 +0200829not_supported:
Christoph Hellwig4e4cbee2017-06-03 09:38:06 +0200830 status = BLK_STS_NOTSUPP;
Tejun Heoa7384672008-11-28 13:32:03 +0900831end_io:
Christoph Hellwig4e4cbee2017-06-03 09:38:06 +0200832 bio->bi_status = status;
Christoph Hellwig4246a0b2015-07-20 15:29:37 +0200833 bio_endio(bio);
Christoph Hellwig27a84d52011-09-15 14:01:40 +0200834 return false;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700835}
836
Jens Axboe900e0802021-11-03 05:47:09 -0600837static void __submit_bio_fops(struct gendisk *disk, struct bio *bio)
838{
839 if (unlikely(bio_queue_enter(bio) != 0))
840 return;
841 if (submit_bio_checks(bio) && blk_crypto_bio_prep(&bio))
842 disk->fops->submit_bio(bio);
843 blk_queue_exit(disk->queue);
844}
845
Christoph Hellwig3e087732021-10-12 13:12:24 +0200846static void __submit_bio(struct bio *bio)
Christoph Hellwigac7c5672020-05-16 20:28:01 +0200847{
Christoph Hellwig309dca302021-01-24 11:02:34 +0100848 struct gendisk *disk = bio->bi_bdev->bd_disk;
Christoph Hellwigac7c5672020-05-16 20:28:01 +0200849
Jens Axboe900e0802021-11-03 05:47:09 -0600850 if (!disk->fops->submit_bio)
Christoph Hellwig3e087732021-10-12 13:12:24 +0200851 blk_mq_submit_bio(bio);
Jens Axboe900e0802021-11-03 05:47:09 -0600852 else
853 __submit_bio_fops(disk, bio);
Christoph Hellwigac7c5672020-05-16 20:28:01 +0200854}
855
Christoph Hellwig566acf22020-07-01 10:59:45 +0200856/*
857 * The loop in this function may be a bit non-obvious, and so deserves some
858 * explanation:
859 *
860 * - Before entering the loop, bio->bi_next is NULL (as all callers ensure
861 * that), so we have a list with a single bio.
862 * - We pretend that we have just taken it off a longer list, so we assign
863 * bio_list to a pointer to the bio_list_on_stack, thus initialising the
864 * bio_list of new bios to be added. ->submit_bio() may indeed add some more
865 * bios through a recursive call to submit_bio_noacct. If it did, we find a
866 * non-NULL value in bio_list and re-enter the loop from the top.
867 * - In this case we really did just take the bio of the top of the list (no
868 * pretending) and so remove it from bio_list, and call into ->submit_bio()
869 * again.
870 *
871 * bio_list_on_stack[0] contains bios submitted by the current ->submit_bio.
872 * bio_list_on_stack[1] contains bios that were submitted before the current
873 * ->submit_bio_bio, but that haven't been processed yet.
874 */
Christoph Hellwig3e087732021-10-12 13:12:24 +0200875static void __submit_bio_noacct(struct bio *bio)
Christoph Hellwig566acf22020-07-01 10:59:45 +0200876{
877 struct bio_list bio_list_on_stack[2];
Christoph Hellwig566acf22020-07-01 10:59:45 +0200878
879 BUG_ON(bio->bi_next);
880
881 bio_list_init(&bio_list_on_stack[0]);
882 current->bio_list = bio_list_on_stack;
883
884 do {
Pavel Begunkoveab4e022021-10-14 15:03:29 +0100885 struct request_queue *q = bdev_get_queue(bio->bi_bdev);
Christoph Hellwig566acf22020-07-01 10:59:45 +0200886 struct bio_list lower, same;
887
Christoph Hellwig566acf22020-07-01 10:59:45 +0200888 /*
889 * Create a fresh bio_list for all subordinate requests.
890 */
891 bio_list_on_stack[1] = bio_list_on_stack[0];
892 bio_list_init(&bio_list_on_stack[0]);
893
Christoph Hellwig3e087732021-10-12 13:12:24 +0200894 __submit_bio(bio);
Christoph Hellwig566acf22020-07-01 10:59:45 +0200895
896 /*
897 * Sort new bios into those for a lower level and those for the
898 * same level.
899 */
900 bio_list_init(&lower);
901 bio_list_init(&same);
902 while ((bio = bio_list_pop(&bio_list_on_stack[0])) != NULL)
Pavel Begunkoveab4e022021-10-14 15:03:29 +0100903 if (q == bdev_get_queue(bio->bi_bdev))
Christoph Hellwig566acf22020-07-01 10:59:45 +0200904 bio_list_add(&same, bio);
905 else
906 bio_list_add(&lower, bio);
907
908 /*
909 * Now assemble so we handle the lowest level first.
910 */
911 bio_list_merge(&bio_list_on_stack[0], &lower);
912 bio_list_merge(&bio_list_on_stack[0], &same);
913 bio_list_merge(&bio_list_on_stack[0], &bio_list_on_stack[1]);
914 } while ((bio = bio_list_pop(&bio_list_on_stack[0])));
915
916 current->bio_list = NULL;
Christoph Hellwig566acf22020-07-01 10:59:45 +0200917}
918
Christoph Hellwig3e087732021-10-12 13:12:24 +0200919static void __submit_bio_noacct_mq(struct bio *bio)
Christoph Hellwigff93ea02020-07-01 10:59:46 +0200920{
Christoph Hellwig7c792f32020-07-02 21:21:25 +0200921 struct bio_list bio_list[2] = { };
Christoph Hellwigff93ea02020-07-01 10:59:46 +0200922
Christoph Hellwig7c792f32020-07-02 21:21:25 +0200923 current->bio_list = bio_list;
Christoph Hellwigff93ea02020-07-01 10:59:46 +0200924
925 do {
Christoph Hellwig3e087732021-10-12 13:12:24 +0200926 __submit_bio(bio);
Christoph Hellwig7c792f32020-07-02 21:21:25 +0200927 } while ((bio = bio_list_pop(&bio_list[0])));
Christoph Hellwigff93ea02020-07-01 10:59:46 +0200928
929 current->bio_list = NULL;
Christoph Hellwigff93ea02020-07-01 10:59:46 +0200930}
931
Christoph Hellwig27a84d52011-09-15 14:01:40 +0200932/**
Christoph Hellwiged00aab2020-07-01 10:59:44 +0200933 * submit_bio_noacct - re-submit a bio to the block device layer for I/O
Christoph Hellwig27a84d52011-09-15 14:01:40 +0200934 * @bio: The bio describing the location in memory and on the device.
935 *
Christoph Hellwig3fdd4082020-04-28 13:27:53 +0200936 * This is a version of submit_bio() that shall only be used for I/O that is
937 * resubmitted to lower level drivers by stacking block drivers. All file
938 * systems and other upper level users of the block layer should use
939 * submit_bio() instead.
Neil Brownd89d8792007-05-01 09:53:42 +0200940 */
Christoph Hellwig3e087732021-10-12 13:12:24 +0200941void submit_bio_noacct(struct bio *bio)
Neil Brownd89d8792007-05-01 09:53:42 +0200942{
Christoph Hellwig27a84d52011-09-15 14:01:40 +0200943 /*
Christoph Hellwig566acf22020-07-01 10:59:45 +0200944 * We only want one ->submit_bio to be active at a time, else stack
945 * usage with stacked devices could be a problem. Use current->bio_list
946 * to collect a list of requests submited by a ->submit_bio method while
947 * it is active, and then process them after it returned.
Christoph Hellwig27a84d52011-09-15 14:01:40 +0200948 */
Christoph Hellwig3e087732021-10-12 13:12:24 +0200949 if (current->bio_list)
NeilBrownf5fe1b52017-03-10 17:00:47 +1100950 bio_list_add(&current->bio_list[0], bio);
Christoph Hellwig3e087732021-10-12 13:12:24 +0200951 else if (!bio->bi_bdev->bd_disk->fops->submit_bio)
952 __submit_bio_noacct_mq(bio);
953 else
954 __submit_bio_noacct(bio);
Neil Brownd89d8792007-05-01 09:53:42 +0200955}
Christoph Hellwiged00aab2020-07-01 10:59:44 +0200956EXPORT_SYMBOL(submit_bio_noacct);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700957
958/**
Randy Dunlap710027a2008-08-19 20:13:11 +0200959 * submit_bio - submit a bio to the block device layer for I/O
Linus Torvalds1da177e2005-04-16 15:20:36 -0700960 * @bio: The &struct bio which describes the I/O
961 *
Christoph Hellwig3fdd4082020-04-28 13:27:53 +0200962 * submit_bio() is used to submit I/O requests to block devices. It is passed a
963 * fully set up &struct bio that describes the I/O that needs to be done. The
Christoph Hellwig309dca302021-01-24 11:02:34 +0100964 * bio will be send to the device described by the bi_bdev field.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700965 *
Christoph Hellwig3fdd4082020-04-28 13:27:53 +0200966 * The success/failure status of the request, along with notification of
967 * completion, is delivered asynchronously through the ->bi_end_io() callback
968 * in @bio. The bio must NOT be touched by thecaller until ->bi_end_io() has
969 * been called.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700970 */
Christoph Hellwig3e087732021-10-12 13:12:24 +0200971void submit_bio(struct bio *bio)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700972{
Tejun Heod3f77df2019-06-27 13:39:52 -0700973 if (blkcg_punt_bio_submit(bio))
Christoph Hellwig3e087732021-10-12 13:12:24 +0200974 return;
Tejun Heod3f77df2019-06-27 13:39:52 -0700975
Jens Axboebf2de6f2007-09-27 13:01:25 +0200976 /*
977 * If it's a regular read/write or a barrier with data attached,
978 * go through the normal accounting stuff before submission.
979 */
Martin K. Petersene2a60da2012-09-18 12:19:25 -0400980 if (bio_has_data(bio)) {
Martin K. Petersen4363ac72012-09-18 12:19:27 -0400981 unsigned int count;
982
Mike Christie95fe6c12016-06-05 14:31:48 -0500983 if (unlikely(bio_op(bio) == REQ_OP_WRITE_SAME))
Christoph Hellwig309dca302021-01-24 11:02:34 +0100984 count = queue_logical_block_size(
Pavel Begunkoveab4e022021-10-14 15:03:29 +0100985 bdev_get_queue(bio->bi_bdev)) >> 9;
Martin K. Petersen4363ac72012-09-18 12:19:27 -0400986 else
987 count = bio_sectors(bio);
988
Mike Christiea8ebb052016-06-05 14:31:45 -0500989 if (op_is_write(bio_op(bio))) {
Jens Axboebf2de6f2007-09-27 13:01:25 +0200990 count_vm_events(PGPGOUT, count);
991 } else {
Kent Overstreet4f024f32013-10-11 15:44:27 -0700992 task_io_account_read(bio->bi_iter.bi_size);
Jens Axboebf2de6f2007-09-27 13:01:25 +0200993 count_vm_events(PGPGIN, count);
994 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700995 }
996
Johannes Weinerb8e24a92019-08-08 15:03:00 -0400997 /*
Christoph Hellwig760f83e2020-04-28 13:27:54 +0200998 * If we're reading data that is part of the userspace workingset, count
999 * submission time as memory stall. When the device is congested, or
1000 * the submitting cgroup IO-throttled, submission can be a significant
1001 * part of overall IO time.
Johannes Weinerb8e24a92019-08-08 15:03:00 -04001002 */
Christoph Hellwig760f83e2020-04-28 13:27:54 +02001003 if (unlikely(bio_op(bio) == REQ_OP_READ &&
1004 bio_flagged(bio, BIO_WORKINGSET))) {
1005 unsigned long pflags;
Christoph Hellwig760f83e2020-04-28 13:27:54 +02001006
Johannes Weinerb8e24a92019-08-08 15:03:00 -04001007 psi_memstall_enter(&pflags);
Christoph Hellwig3e087732021-10-12 13:12:24 +02001008 submit_bio_noacct(bio);
Johannes Weinerb8e24a92019-08-08 15:03:00 -04001009 psi_memstall_leave(&pflags);
Christoph Hellwig3e087732021-10-12 13:12:24 +02001010 return;
Christoph Hellwig760f83e2020-04-28 13:27:54 +02001011 }
1012
Christoph Hellwig3e087732021-10-12 13:12:24 +02001013 submit_bio_noacct(bio);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001014}
Linus Torvalds1da177e2005-04-16 15:20:36 -07001015EXPORT_SYMBOL(submit_bio);
1016
Jens Axboe1052b8a2018-11-26 08:21:49 -07001017/**
Christoph Hellwig3e087732021-10-12 13:12:24 +02001018 * bio_poll - poll for BIO completions
1019 * @bio: bio to poll for
Yang Guange30028a2021-11-26 00:20:55 +08001020 * @iob: batches of IO
Christoph Hellwig3e087732021-10-12 13:12:24 +02001021 * @flags: BLK_POLL_* flags that control the behavior
1022 *
1023 * Poll for completions on queue associated with the bio. Returns number of
1024 * completed entries found.
1025 *
1026 * Note: the caller must either be the context that submitted @bio, or
1027 * be in a RCU critical section to prevent freeing of @bio.
1028 */
Jens Axboe5a72e892021-10-12 09:24:29 -06001029int bio_poll(struct bio *bio, struct io_comp_batch *iob, unsigned int flags)
Christoph Hellwig3e087732021-10-12 13:12:24 +02001030{
Pavel Begunkov859897c2021-10-19 22:24:11 +01001031 struct request_queue *q = bdev_get_queue(bio->bi_bdev);
Christoph Hellwig3e087732021-10-12 13:12:24 +02001032 blk_qc_t cookie = READ_ONCE(bio->bi_cookie);
1033 int ret;
1034
1035 if (cookie == BLK_QC_T_NONE ||
1036 !test_bit(QUEUE_FLAG_POLL, &q->queue_flags))
1037 return 0;
1038
1039 if (current->plug)
Christoph Hellwig008f75a2021-10-20 16:41:19 +02001040 blk_flush_plug(current->plug, false);
Christoph Hellwig3e087732021-10-12 13:12:24 +02001041
1042 if (blk_queue_enter(q, BLK_MQ_REQ_NOWAIT))
1043 return 0;
1044 if (WARN_ON_ONCE(!queue_is_mq(q)))
1045 ret = 0; /* not yet implemented, should not happen */
1046 else
Jens Axboe5a72e892021-10-12 09:24:29 -06001047 ret = blk_mq_poll(q, cookie, iob, flags);
Christoph Hellwig3e087732021-10-12 13:12:24 +02001048 blk_queue_exit(q);
1049 return ret;
1050}
1051EXPORT_SYMBOL_GPL(bio_poll);
1052
1053/*
1054 * Helper to implement file_operations.iopoll. Requires the bio to be stored
1055 * in iocb->private, and cleared before freeing the bio.
1056 */
Jens Axboe5a72e892021-10-12 09:24:29 -06001057int iocb_bio_iopoll(struct kiocb *kiocb, struct io_comp_batch *iob,
1058 unsigned int flags)
Christoph Hellwig3e087732021-10-12 13:12:24 +02001059{
1060 struct bio *bio;
1061 int ret = 0;
1062
1063 /*
1064 * Note: the bio cache only uses SLAB_TYPESAFE_BY_RCU, so bio can
1065 * point to a freshly allocated bio at this point. If that happens
1066 * we have a few cases to consider:
1067 *
1068 * 1) the bio is beeing initialized and bi_bdev is NULL. We can just
1069 * simply nothing in this case
1070 * 2) the bio points to a not poll enabled device. bio_poll will catch
1071 * this and return 0
1072 * 3) the bio points to a poll capable device, including but not
1073 * limited to the one that the original bio pointed to. In this
1074 * case we will call into the actual poll method and poll for I/O,
1075 * even if we don't need to, but it won't cause harm either.
1076 *
1077 * For cases 2) and 3) above the RCU grace period ensures that bi_bdev
1078 * is still allocated. Because partitions hold a reference to the whole
1079 * device bdev and thus disk, the disk is also still valid. Grabbing
1080 * a reference to the queue in bio_poll() ensures the hctxs and requests
1081 * are still valid as well.
1082 */
1083 rcu_read_lock();
1084 bio = READ_ONCE(kiocb->private);
1085 if (bio && bio->bi_bdev)
Jens Axboe5a72e892021-10-12 09:24:29 -06001086 ret = bio_poll(bio, iob, flags);
Christoph Hellwig3e087732021-10-12 13:12:24 +02001087 rcu_read_unlock();
1088
1089 return ret;
1090}
1091EXPORT_SYMBOL_GPL(iocb_bio_iopoll);
1092
1093/**
Hannes Reineckebf4e6b42015-11-26 08:46:57 +01001094 * blk_cloned_rq_check_limits - Helper function to check a cloned request
Guoqing Jiang0d720312020-03-09 22:41:33 +01001095 * for the new queue limits
Kiyoshi Ueda82124d62008-09-18 10:45:38 -04001096 * @q: the queue
1097 * @rq: the request being checked
1098 *
1099 * Description:
1100 * @rq may have been made based on weaker limitations of upper-level queues
1101 * in request stacking drivers, and it may violate the limitation of @q.
1102 * Since the block layer and the underlying device driver trust @rq
1103 * after it is inserted to @q, it should be checked against @q before
1104 * the insertion using this generic function.
1105 *
Kiyoshi Ueda82124d62008-09-18 10:45:38 -04001106 * Request stacking drivers like request-based dm may change the queue
Hannes Reineckebf4e6b42015-11-26 08:46:57 +01001107 * limits when retrying requests on other queues. Those requests need
1108 * to be checked against the new queue limits again during dispatch.
Kiyoshi Ueda82124d62008-09-18 10:45:38 -04001109 */
Ritika Srivastava143d2602020-09-01 13:17:30 -07001110static blk_status_t blk_cloned_rq_check_limits(struct request_queue *q,
Hannes Reineckebf4e6b42015-11-26 08:46:57 +01001111 struct request *rq)
Kiyoshi Ueda82124d62008-09-18 10:45:38 -04001112{
Ritika Srivastava8327cce52020-09-01 13:17:31 -07001113 unsigned int max_sectors = blk_queue_get_max_sectors(q, req_op(rq));
1114
1115 if (blk_rq_sectors(rq) > max_sectors) {
1116 /*
1117 * SCSI device does not have a good way to return if
1118 * Write Same/Zero is actually supported. If a device rejects
1119 * a non-read/write command (discard, write same,etc.) the
1120 * low-level device driver will set the relevant queue limit to
1121 * 0 to prevent blk-lib from issuing more of the offending
1122 * operations. Commands queued prior to the queue limit being
1123 * reset need to be completed with BLK_STS_NOTSUPP to avoid I/O
1124 * errors being propagated to upper layers.
1125 */
1126 if (max_sectors == 0)
1127 return BLK_STS_NOTSUPP;
1128
John Pittman61939b12019-05-23 17:49:39 -04001129 printk(KERN_ERR "%s: over max size limit. (%u > %u)\n",
Ritika Srivastava8327cce52020-09-01 13:17:31 -07001130 __func__, blk_rq_sectors(rq), max_sectors);
Ritika Srivastava143d2602020-09-01 13:17:30 -07001131 return BLK_STS_IOERR;
Kiyoshi Ueda82124d62008-09-18 10:45:38 -04001132 }
1133
1134 /*
Christoph Hellwig9bb33f22021-03-31 09:30:00 +02001135 * The queue settings related to segment counting may differ from the
1136 * original queue.
Kiyoshi Ueda82124d62008-09-18 10:45:38 -04001137 */
Christoph Hellwige9cd19c2019-06-06 12:29:02 +02001138 rq->nr_phys_segments = blk_recalc_rq_segments(rq);
Martin K. Petersen8a783622010-02-26 00:20:39 -05001139 if (rq->nr_phys_segments > queue_max_segments(q)) {
John Pittman61939b12019-05-23 17:49:39 -04001140 printk(KERN_ERR "%s: over max segments limit. (%hu > %hu)\n",
1141 __func__, rq->nr_phys_segments, queue_max_segments(q));
Ritika Srivastava143d2602020-09-01 13:17:30 -07001142 return BLK_STS_IOERR;
Kiyoshi Ueda82124d62008-09-18 10:45:38 -04001143 }
1144
Ritika Srivastava143d2602020-09-01 13:17:30 -07001145 return BLK_STS_OK;
Kiyoshi Ueda82124d62008-09-18 10:45:38 -04001146}
Kiyoshi Ueda82124d62008-09-18 10:45:38 -04001147
1148/**
1149 * blk_insert_cloned_request - Helper for stacking drivers to submit a request
1150 * @q: the queue to submit the request
1151 * @rq: the request being queued
1152 */
Christoph Hellwig2a842ac2017-06-03 09:38:04 +02001153blk_status_t blk_insert_cloned_request(struct request_queue *q, struct request *rq)
Kiyoshi Ueda82124d62008-09-18 10:45:38 -04001154{
Ritika Srivastava8327cce52020-09-01 13:17:31 -07001155 blk_status_t ret;
1156
1157 ret = blk_cloned_rq_check_limits(q, rq);
1158 if (ret != BLK_STS_OK)
1159 return ret;
Kiyoshi Ueda82124d62008-09-18 10:45:38 -04001160
Akinobu Mitab2c9cd32011-07-26 16:09:03 -07001161 if (rq->rq_disk &&
Christoph Hellwig8446fe92020-11-24 09:36:54 +01001162 should_fail_request(rq->rq_disk->part0, blk_rq_bytes(rq)))
Christoph Hellwig2a842ac2017-06-03 09:38:04 +02001163 return BLK_STS_IOERR;
Kiyoshi Ueda82124d62008-09-18 10:45:38 -04001164
Satya Tangiralaa892c8d2020-05-14 00:37:18 +00001165 if (blk_crypto_insert_cloned_request(rq))
1166 return BLK_STS_IOERR;
1167
Pavel Begunkovbe6bfe32021-10-09 13:25:41 +01001168 blk_account_io_start(rq);
Kiyoshi Ueda82124d62008-09-18 10:45:38 -04001169
1170 /*
Jens Axboea1ce35f2018-10-29 10:23:51 -06001171 * Since we have a scheduler attached on the top device,
1172 * bypass a potential scheduler on the bottom device for
1173 * insert.
Kiyoshi Ueda82124d62008-09-18 10:45:38 -04001174 */
Bart Van Asschefd9c40f2019-04-04 10:08:43 -07001175 return blk_mq_request_issue_directly(rq, true);
Kiyoshi Ueda82124d62008-09-18 10:45:38 -04001176}
1177EXPORT_SYMBOL_GPL(blk_insert_cloned_request);
1178
Tejun Heo80a761f2009-07-03 17:48:17 +09001179/**
1180 * blk_rq_err_bytes - determine number of bytes till the next failure boundary
1181 * @rq: request to examine
1182 *
1183 * Description:
1184 * A request could be merge of IOs which require different failure
1185 * handling. This function determines the number of bytes which
1186 * can be failed from the beginning of the request without
1187 * crossing into area which need to be retried further.
1188 *
1189 * Return:
1190 * The number of bytes to fail.
Tejun Heo80a761f2009-07-03 17:48:17 +09001191 */
1192unsigned int blk_rq_err_bytes(const struct request *rq)
1193{
1194 unsigned int ff = rq->cmd_flags & REQ_FAILFAST_MASK;
1195 unsigned int bytes = 0;
1196 struct bio *bio;
1197
Christoph Hellwige8064022016-10-20 15:12:13 +02001198 if (!(rq->rq_flags & RQF_MIXED_MERGE))
Tejun Heo80a761f2009-07-03 17:48:17 +09001199 return blk_rq_bytes(rq);
1200
1201 /*
1202 * Currently the only 'mixing' which can happen is between
1203 * different fastfail types. We can safely fail portions
1204 * which have all the failfast bits that the first one has -
1205 * the ones which are at least as eager to fail as the first
1206 * one.
1207 */
1208 for (bio = rq->bio; bio; bio = bio->bi_next) {
Jens Axboe1eff9d32016-08-05 15:35:16 -06001209 if ((bio->bi_opf & ff) != ff)
Tejun Heo80a761f2009-07-03 17:48:17 +09001210 break;
Kent Overstreet4f024f32013-10-11 15:44:27 -07001211 bytes += bio->bi_iter.bi_size;
Tejun Heo80a761f2009-07-03 17:48:17 +09001212 }
1213
1214 /* this could lead to infinite loop */
1215 BUG_ON(blk_rq_bytes(rq) && !bytes);
1216 return bytes;
1217}
1218EXPORT_SYMBOL_GPL(blk_rq_err_bytes);
1219
Christoph Hellwig8446fe92020-11-24 09:36:54 +01001220static void update_io_ticks(struct block_device *part, unsigned long now,
1221 bool end)
Christoph Hellwig9123bf62020-05-27 07:24:13 +02001222{
1223 unsigned long stamp;
1224again:
Christoph Hellwig8446fe92020-11-24 09:36:54 +01001225 stamp = READ_ONCE(part->bd_stamp);
Chunguang Xud80c2282021-07-06 05:47:26 +08001226 if (unlikely(time_after(now, stamp))) {
Christoph Hellwig8446fe92020-11-24 09:36:54 +01001227 if (likely(cmpxchg(&part->bd_stamp, stamp, now) == stamp))
Christoph Hellwig9123bf62020-05-27 07:24:13 +02001228 __part_stat_add(part, io_ticks, end ? now - stamp : 1);
1229 }
Christoph Hellwig8446fe92020-11-24 09:36:54 +01001230 if (part->bd_partno) {
1231 part = bdev_whole(part);
Christoph Hellwig9123bf62020-05-27 07:24:13 +02001232 goto again;
1233 }
1234}
1235
Pavel Begunkovbe6bfe32021-10-09 13:25:41 +01001236void __blk_account_io_done(struct request *req, u64 now)
Jens Axboebc58ba92009-01-23 10:54:44 +01001237{
Pavel Begunkovbe6bfe32021-10-09 13:25:41 +01001238 const int sgrp = op_stat_group(req_op(req));
Jens Axboebc58ba92009-01-23 10:54:44 +01001239
Pavel Begunkovbe6bfe32021-10-09 13:25:41 +01001240 part_stat_lock();
1241 update_io_ticks(req->part, jiffies, true);
1242 part_stat_inc(req->part, ios[sgrp]);
1243 part_stat_add(req->part, nsecs[sgrp], now - req->start_time_ns);
1244 part_stat_unlock();
Jens Axboebc58ba92009-01-23 10:54:44 +01001245}
1246
Pavel Begunkovbe6bfe32021-10-09 13:25:41 +01001247void __blk_account_io_start(struct request *rq)
Jens Axboe320ae512013-10-24 09:20:05 +01001248{
Christoph Hellwig0b6e5222021-01-24 11:02:38 +01001249 /* passthrough requests can hold bios that do not have ->bi_bdev set */
1250 if (rq->bio && rq->bio->bi_bdev)
1251 rq->part = rq->bio->bi_bdev;
1252 else
1253 rq->part = rq->rq_disk->part0;
Christoph Hellwig524f9ff2020-05-27 07:24:19 +02001254
Mike Snitzer112f1582018-12-06 11:41:18 -05001255 part_stat_lock();
Christoph Hellwig76268f32020-05-13 12:49:34 +02001256 update_io_ticks(rq->part, jiffies, false);
Jens Axboe320ae512013-10-24 09:20:05 +01001257 part_stat_unlock();
1258}
1259
Christoph Hellwig8446fe92020-11-24 09:36:54 +01001260static unsigned long __part_start_io_acct(struct block_device *part,
Song Liu7b264102020-08-31 15:27:23 -07001261 unsigned int sectors, unsigned int op)
Christoph Hellwig956d5102020-05-27 07:24:04 +02001262{
Christoph Hellwig956d5102020-05-27 07:24:04 +02001263 const int sgrp = op_stat_group(op);
1264 unsigned long now = READ_ONCE(jiffies);
1265
1266 part_stat_lock();
1267 update_io_ticks(part, now, false);
1268 part_stat_inc(part, ios[sgrp]);
1269 part_stat_add(part, sectors[sgrp], sectors);
1270 part_stat_local_inc(part, in_flight[op_is_write(op)]);
1271 part_stat_unlock();
1272
1273 return now;
1274}
Song Liu7b264102020-08-31 15:27:23 -07001275
Christoph Hellwig99dfc432021-01-24 11:02:37 +01001276/**
1277 * bio_start_io_acct - start I/O accounting for bio based drivers
1278 * @bio: bio to start account for
1279 *
1280 * Returns the start time that should be passed back to bio_end_io_acct().
1281 */
1282unsigned long bio_start_io_acct(struct bio *bio)
Song Liu7b264102020-08-31 15:27:23 -07001283{
Christoph Hellwig99dfc432021-01-24 11:02:37 +01001284 return __part_start_io_acct(bio->bi_bdev, bio_sectors(bio), bio_op(bio));
Song Liu7b264102020-08-31 15:27:23 -07001285}
Christoph Hellwig99dfc432021-01-24 11:02:37 +01001286EXPORT_SYMBOL_GPL(bio_start_io_acct);
Song Liu7b264102020-08-31 15:27:23 -07001287
1288unsigned long disk_start_io_acct(struct gendisk *disk, unsigned int sectors,
1289 unsigned int op)
1290{
Christoph Hellwig8446fe92020-11-24 09:36:54 +01001291 return __part_start_io_acct(disk->part0, sectors, op);
Song Liu7b264102020-08-31 15:27:23 -07001292}
Christoph Hellwig956d5102020-05-27 07:24:04 +02001293EXPORT_SYMBOL(disk_start_io_acct);
1294
Christoph Hellwig8446fe92020-11-24 09:36:54 +01001295static void __part_end_io_acct(struct block_device *part, unsigned int op,
Song Liu7b264102020-08-31 15:27:23 -07001296 unsigned long start_time)
Christoph Hellwig956d5102020-05-27 07:24:04 +02001297{
Christoph Hellwig956d5102020-05-27 07:24:04 +02001298 const int sgrp = op_stat_group(op);
1299 unsigned long now = READ_ONCE(jiffies);
1300 unsigned long duration = now - start_time;
1301
1302 part_stat_lock();
1303 update_io_ticks(part, now, true);
1304 part_stat_add(part, nsecs[sgrp], jiffies_to_nsecs(duration));
1305 part_stat_local_dec(part, in_flight[op_is_write(op)]);
1306 part_stat_unlock();
1307}
Song Liu7b264102020-08-31 15:27:23 -07001308
Christoph Hellwig99dfc432021-01-24 11:02:37 +01001309void bio_end_io_acct_remapped(struct bio *bio, unsigned long start_time,
1310 struct block_device *orig_bdev)
Song Liu7b264102020-08-31 15:27:23 -07001311{
Christoph Hellwig99dfc432021-01-24 11:02:37 +01001312 __part_end_io_acct(orig_bdev, bio_op(bio), start_time);
Song Liu7b264102020-08-31 15:27:23 -07001313}
Christoph Hellwig99dfc432021-01-24 11:02:37 +01001314EXPORT_SYMBOL_GPL(bio_end_io_acct_remapped);
Song Liu7b264102020-08-31 15:27:23 -07001315
1316void disk_end_io_acct(struct gendisk *disk, unsigned int op,
1317 unsigned long start_time)
1318{
Christoph Hellwig8446fe92020-11-24 09:36:54 +01001319 __part_end_io_acct(disk->part0, op, start_time);
Song Liu7b264102020-08-31 15:27:23 -07001320}
Christoph Hellwig956d5102020-05-27 07:24:04 +02001321EXPORT_SYMBOL(disk_end_io_acct);
1322
Christoph Hellwigef71de82017-11-02 21:29:51 +03001323/*
1324 * Steal bios from a request and add them to a bio list.
1325 * The request must not have been partially completed before.
1326 */
1327void blk_steal_bios(struct bio_list *list, struct request *rq)
1328{
1329 if (rq->bio) {
1330 if (list->tail)
1331 list->tail->bi_next = rq->bio;
1332 else
1333 list->head = rq->bio;
1334 list->tail = rq->biotail;
1335
1336 rq->bio = NULL;
1337 rq->biotail = NULL;
1338 }
1339
1340 rq->__data_len = 0;
1341}
1342EXPORT_SYMBOL_GPL(blk_steal_bios);
1343
Ilya Loginov2d4dc892009-11-26 09:16:19 +01001344#if ARCH_IMPLEMENTS_FLUSH_DCACHE_PAGE
1345/**
1346 * rq_flush_dcache_pages - Helper function to flush all pages in a request
1347 * @rq: the request to be flushed
1348 *
1349 * Description:
1350 * Flush all pages in @rq.
1351 */
1352void rq_flush_dcache_pages(struct request *rq)
1353{
1354 struct req_iterator iter;
Kent Overstreet79886132013-11-23 17:19:00 -08001355 struct bio_vec bvec;
Ilya Loginov2d4dc892009-11-26 09:16:19 +01001356
1357 rq_for_each_segment(bvec, rq, iter)
Kent Overstreet79886132013-11-23 17:19:00 -08001358 flush_dcache_page(bvec.bv_page);
Ilya Loginov2d4dc892009-11-26 09:16:19 +01001359}
1360EXPORT_SYMBOL_GPL(rq_flush_dcache_pages);
1361#endif
1362
Kiyoshi Uedaef9e3fa2008-10-01 16:12:15 +02001363/**
1364 * blk_lld_busy - Check if underlying low-level drivers of a device are busy
1365 * @q : the queue of the device being checked
1366 *
1367 * Description:
1368 * Check if underlying low-level drivers of a device are busy.
1369 * If the drivers want to export their busy state, they must set own
1370 * exporting function using blk_queue_lld_busy() first.
1371 *
1372 * Basically, this function is used only by request stacking drivers
1373 * to stop dispatching requests to underlying devices when underlying
1374 * devices are busy. This behavior helps more I/O merging on the queue
1375 * of the request stacking driver and prevents I/O throughput regression
1376 * on burst I/O load.
1377 *
1378 * Return:
1379 * 0 - Not busy (The request stacking driver should dispatch request)
1380 * 1 - Busy (The request stacking driver should stop dispatching request)
1381 */
1382int blk_lld_busy(struct request_queue *q)
1383{
Jens Axboe344e9ff2018-11-15 12:22:51 -07001384 if (queue_is_mq(q) && q->mq_ops->busy)
Jens Axboe9ba20522018-10-29 10:15:10 -06001385 return q->mq_ops->busy(q);
Kiyoshi Uedaef9e3fa2008-10-01 16:12:15 +02001386
1387 return 0;
1388}
1389EXPORT_SYMBOL_GPL(blk_lld_busy);
1390
Mike Snitzer78d8e582015-06-26 10:01:13 -04001391/**
1392 * blk_rq_unprep_clone - Helper function to free all bios in a cloned request
1393 * @rq: the clone request to be cleaned up
1394 *
1395 * Description:
1396 * Free all bios in @rq for a cloned request.
1397 */
1398void blk_rq_unprep_clone(struct request *rq)
1399{
1400 struct bio *bio;
1401
1402 while ((bio = rq->bio) != NULL) {
1403 rq->bio = bio->bi_next;
1404
1405 bio_put(bio);
1406 }
1407}
1408EXPORT_SYMBOL_GPL(blk_rq_unprep_clone);
1409
Mike Snitzer78d8e582015-06-26 10:01:13 -04001410/**
1411 * blk_rq_prep_clone - Helper function to setup clone request
1412 * @rq: the request to be setup
1413 * @rq_src: original request to be cloned
1414 * @bs: bio_set that bios for clone are allocated from
1415 * @gfp_mask: memory allocation mask for bio
1416 * @bio_ctr: setup function to be called for each clone bio.
1417 * Returns %0 for success, non %0 for failure.
1418 * @data: private data to be passed to @bio_ctr
1419 *
1420 * Description:
1421 * Clones bios in @rq_src to @rq, and copies attributes of @rq_src to @rq.
Mike Snitzer78d8e582015-06-26 10:01:13 -04001422 * Also, pages which the original bios are pointing to are not copied
1423 * and the cloned bios just point same pages.
1424 * So cloned bios must be completed before original bios, which means
1425 * the caller must complete @rq before @rq_src.
1426 */
1427int blk_rq_prep_clone(struct request *rq, struct request *rq_src,
1428 struct bio_set *bs, gfp_t gfp_mask,
1429 int (*bio_ctr)(struct bio *, struct bio *, void *),
1430 void *data)
1431{
1432 struct bio *bio, *bio_src;
1433
1434 if (!bs)
Kent Overstreetf4f81542018-05-08 21:33:52 -04001435 bs = &fs_bio_set;
Mike Snitzer78d8e582015-06-26 10:01:13 -04001436
1437 __rq_for_each_bio(bio_src, rq_src) {
1438 bio = bio_clone_fast(bio_src, gfp_mask, bs);
1439 if (!bio)
1440 goto free_and_out;
1441
1442 if (bio_ctr && bio_ctr(bio, bio_src, data))
1443 goto free_and_out;
1444
1445 if (rq->bio) {
1446 rq->biotail->bi_next = bio;
1447 rq->biotail = bio;
Eric Biggers93f221a2020-09-15 20:53:14 -07001448 } else {
Mike Snitzer78d8e582015-06-26 10:01:13 -04001449 rq->bio = rq->biotail = bio;
Eric Biggers93f221a2020-09-15 20:53:14 -07001450 }
1451 bio = NULL;
Mike Snitzer78d8e582015-06-26 10:01:13 -04001452 }
1453
Guoqing Jiang361301a2020-03-09 22:41:36 +01001454 /* Copy attributes of the original request to the clone request. */
1455 rq->__sector = blk_rq_pos(rq_src);
1456 rq->__data_len = blk_rq_bytes(rq_src);
1457 if (rq_src->rq_flags & RQF_SPECIAL_PAYLOAD) {
1458 rq->rq_flags |= RQF_SPECIAL_PAYLOAD;
1459 rq->special_vec = rq_src->special_vec;
1460 }
1461 rq->nr_phys_segments = rq_src->nr_phys_segments;
1462 rq->ioprio = rq_src->ioprio;
Mike Snitzer78d8e582015-06-26 10:01:13 -04001463
Eric Biggers93f221a2020-09-15 20:53:14 -07001464 if (rq->bio && blk_crypto_rq_bio_prep(rq, rq->bio, gfp_mask) < 0)
1465 goto free_and_out;
Mike Snitzer78d8e582015-06-26 10:01:13 -04001466
1467 return 0;
1468
1469free_and_out:
1470 if (bio)
1471 bio_put(bio);
1472 blk_rq_unprep_clone(rq);
1473
1474 return -ENOMEM;
Kiyoshi Uedab0fd2712009-06-11 13:10:16 +02001475}
1476EXPORT_SYMBOL_GPL(blk_rq_prep_clone);
1477
Jens Axboe59c3d452014-04-08 09:15:35 -06001478int kblockd_schedule_work(struct work_struct *work)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001479{
1480 return queue_work(kblockd_workqueue, work);
1481}
Linus Torvalds1da177e2005-04-16 15:20:36 -07001482EXPORT_SYMBOL(kblockd_schedule_work);
1483
Jens Axboe818cd1c2017-04-10 09:54:55 -06001484int kblockd_mod_delayed_work_on(int cpu, struct delayed_work *dwork,
1485 unsigned long delay)
1486{
1487 return mod_delayed_work_on(cpu, kblockd_workqueue, dwork, delay);
1488}
1489EXPORT_SYMBOL(kblockd_mod_delayed_work_on);
1490
Jens Axboe47c122e2021-10-06 06:34:11 -06001491void blk_start_plug_nr_ios(struct blk_plug *plug, unsigned short nr_ios)
1492{
1493 struct task_struct *tsk = current;
1494
1495 /*
1496 * If this is a nested plug, don't actually assign it.
1497 */
1498 if (tsk->plug)
1499 return;
1500
Jens Axboebc490f82021-10-18 10:12:12 -06001501 plug->mq_list = NULL;
Jens Axboe47c122e2021-10-06 06:34:11 -06001502 plug->cached_rq = NULL;
1503 plug->nr_ios = min_t(unsigned short, nr_ios, BLK_MAX_REQUEST_COUNT);
1504 plug->rq_count = 0;
1505 plug->multiple_queues = false;
Jens Axboedc5fc3612021-10-19 06:02:30 -06001506 plug->has_elevator = false;
Jens Axboe47c122e2021-10-06 06:34:11 -06001507 plug->nowait = false;
1508 INIT_LIST_HEAD(&plug->cb_list);
1509
1510 /*
1511 * Store ordering should not be needed here, since a potential
1512 * preempt will imply a full memory barrier
1513 */
1514 tsk->plug = plug;
1515}
1516
Suresh Jayaraman75df7132011-09-21 10:00:16 +02001517/**
1518 * blk_start_plug - initialize blk_plug and track it inside the task_struct
1519 * @plug: The &struct blk_plug that needs to be initialized
1520 *
1521 * Description:
Jeff Moyer40405852019-01-08 16:57:34 -05001522 * blk_start_plug() indicates to the block layer an intent by the caller
1523 * to submit multiple I/O requests in a batch. The block layer may use
1524 * this hint to defer submitting I/Os from the caller until blk_finish_plug()
1525 * is called. However, the block layer may choose to submit requests
1526 * before a call to blk_finish_plug() if the number of queued I/Os
1527 * exceeds %BLK_MAX_REQUEST_COUNT, or if the size of the I/O is larger than
1528 * %BLK_PLUG_FLUSH_SIZE. The queued I/Os may also be submitted early if
1529 * the task schedules (see below).
1530 *
Suresh Jayaraman75df7132011-09-21 10:00:16 +02001531 * Tracking blk_plug inside the task_struct will help with auto-flushing the
1532 * pending I/O should the task end up blocking between blk_start_plug() and
1533 * blk_finish_plug(). This is important from a performance perspective, but
1534 * also ensures that we don't deadlock. For instance, if the task is blocking
1535 * for a memory allocation, memory reclaim could end up wanting to free a
1536 * page belonging to that request that is currently residing in our private
1537 * plug. By flushing the pending I/O when the process goes to sleep, we avoid
1538 * this kind of deadlock.
1539 */
Jens Axboe73c10102011-03-08 13:19:51 +01001540void blk_start_plug(struct blk_plug *plug)
1541{
Jens Axboe47c122e2021-10-06 06:34:11 -06001542 blk_start_plug_nr_ios(plug, 1);
Jens Axboe73c10102011-03-08 13:19:51 +01001543}
1544EXPORT_SYMBOL(blk_start_plug);
1545
NeilBrown74018dc2012-07-31 09:08:15 +02001546static void flush_plug_callbacks(struct blk_plug *plug, bool from_schedule)
NeilBrown048c9372011-04-18 09:52:22 +02001547{
1548 LIST_HEAD(callbacks);
1549
Shaohua Li2a7d5552012-07-31 09:08:15 +02001550 while (!list_empty(&plug->cb_list)) {
1551 list_splice_init(&plug->cb_list, &callbacks);
NeilBrown048c9372011-04-18 09:52:22 +02001552
Shaohua Li2a7d5552012-07-31 09:08:15 +02001553 while (!list_empty(&callbacks)) {
1554 struct blk_plug_cb *cb = list_first_entry(&callbacks,
NeilBrown048c9372011-04-18 09:52:22 +02001555 struct blk_plug_cb,
1556 list);
Shaohua Li2a7d5552012-07-31 09:08:15 +02001557 list_del(&cb->list);
NeilBrown74018dc2012-07-31 09:08:15 +02001558 cb->callback(cb, from_schedule);
Shaohua Li2a7d5552012-07-31 09:08:15 +02001559 }
NeilBrown048c9372011-04-18 09:52:22 +02001560 }
1561}
1562
NeilBrown9cbb1752012-07-31 09:08:14 +02001563struct blk_plug_cb *blk_check_plugged(blk_plug_cb_fn unplug, void *data,
1564 int size)
1565{
1566 struct blk_plug *plug = current->plug;
1567 struct blk_plug_cb *cb;
1568
1569 if (!plug)
1570 return NULL;
1571
1572 list_for_each_entry(cb, &plug->cb_list, list)
1573 if (cb->callback == unplug && cb->data == data)
1574 return cb;
1575
1576 /* Not currently on the callback list */
1577 BUG_ON(size < sizeof(*cb));
1578 cb = kzalloc(size, GFP_ATOMIC);
1579 if (cb) {
1580 cb->data = data;
1581 cb->callback = unplug;
1582 list_add(&cb->list, &plug->cb_list);
1583 }
1584 return cb;
1585}
1586EXPORT_SYMBOL(blk_check_plugged);
1587
Christoph Hellwig008f75a2021-10-20 16:41:19 +02001588void blk_flush_plug(struct blk_plug *plug, bool from_schedule)
Jens Axboe73c10102011-03-08 13:19:51 +01001589{
Pavel Begunkovb6004552021-10-20 16:41:18 +02001590 if (!list_empty(&plug->cb_list))
1591 flush_plug_callbacks(plug, from_schedule);
Jens Axboebc490f82021-10-18 10:12:12 -06001592 if (!rq_list_empty(plug->mq_list))
Jens Axboe320ae512013-10-24 09:20:05 +01001593 blk_mq_flush_plug_list(plug, from_schedule);
Jens Axboec5fc7b92021-11-03 05:49:07 -06001594 /*
1595 * Unconditionally flush out cached requests, even if the unplug
1596 * event came from schedule. Since we know hold references to the
1597 * queue for cached requests, we don't want a blocked task holding
1598 * up a queue freeze/quiesce event.
1599 */
1600 if (unlikely(!rq_list_empty(plug->cached_rq)))
Jens Axboe47c122e2021-10-06 06:34:11 -06001601 blk_mq_free_plug_rqs(plug);
Jens Axboe73c10102011-03-08 13:19:51 +01001602}
Jens Axboe73c10102011-03-08 13:19:51 +01001603
Jeff Moyer40405852019-01-08 16:57:34 -05001604/**
1605 * blk_finish_plug - mark the end of a batch of submitted I/O
1606 * @plug: The &struct blk_plug passed to blk_start_plug()
1607 *
1608 * Description:
1609 * Indicate that a batch of I/O submissions is complete. This function
1610 * must be paired with an initial call to blk_start_plug(). The intent
1611 * is to allow the block layer to optimize I/O submission. See the
1612 * documentation for blk_start_plug() for more information.
1613 */
Jens Axboe73c10102011-03-08 13:19:51 +01001614void blk_finish_plug(struct blk_plug *plug)
1615{
Christoph Hellwig008f75a2021-10-20 16:41:19 +02001616 if (plug == current->plug) {
1617 blk_flush_plug(plug, false);
1618 current->plug = NULL;
1619 }
Jens Axboe73c10102011-03-08 13:19:51 +01001620}
1621EXPORT_SYMBOL(blk_finish_plug);
1622
Ming Lei71ac8602020-05-14 16:45:09 +08001623void blk_io_schedule(void)
1624{
1625 /* Prevent hang_check timer from firing at us during very long I/O */
1626 unsigned long timeout = sysctl_hung_task_timeout_secs * HZ / 2;
1627
1628 if (timeout)
1629 io_schedule_timeout(timeout);
1630 else
1631 io_schedule();
1632}
1633EXPORT_SYMBOL_GPL(blk_io_schedule);
1634
Linus Torvalds1da177e2005-04-16 15:20:36 -07001635int __init blk_dev_init(void)
1636{
Christoph Hellwigef295ec2016-10-28 08:48:16 -06001637 BUILD_BUG_ON(REQ_OP_LAST >= (1 << REQ_OP_BITS));
1638 BUILD_BUG_ON(REQ_OP_BITS + REQ_FLAG_BITS > 8 *
Pankaj Bharadiyac5936422019-12-09 10:31:43 -08001639 sizeof_field(struct request, cmd_flags));
Christoph Hellwigef295ec2016-10-28 08:48:16 -06001640 BUILD_BUG_ON(REQ_OP_BITS + REQ_FLAG_BITS > 8 *
Pankaj Bharadiyac5936422019-12-09 10:31:43 -08001641 sizeof_field(struct bio, bi_opf));
Nikanth Karthikesan9eb55b02009-04-27 14:53:54 +02001642
Tejun Heo89b90be2011-01-03 15:01:47 +01001643 /* used for unplugging and affects IO latency/throughput - HIGHPRI */
1644 kblockd_workqueue = alloc_workqueue("kblockd",
Matias Bjørling28747fc2014-06-11 23:43:54 +02001645 WQ_MEM_RECLAIM | WQ_HIGHPRI, 0);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001646 if (!kblockd_workqueue)
1647 panic("Failed to create kblockd\n");
1648
Ilya Dryomovc2789bd2015-11-20 22:16:46 +01001649 blk_requestq_cachep = kmem_cache_create("request_queue",
Jens Axboe165125e2007-07-24 09:28:11 +02001650 sizeof(struct request_queue), 0, SLAB_PANIC, NULL);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001651
Omar Sandoval18fbda92017-01-31 14:53:20 -08001652 blk_debugfs_root = debugfs_create_dir("block", NULL);
Omar Sandoval18fbda92017-01-31 14:53:20 -08001653
Linus Torvalds1da177e2005-04-16 15:20:36 -07001654 return 0;
1655}