blk-core.c 104.5 KB
Newer Older
L
Linus Torvalds 已提交
1 2 3 4 5
/*
 * Copyright (C) 1991, 1992 Linus Torvalds
 * Copyright (C) 1994,      Karl Keyte: Added support for disk statistics
 * Elevator latency, (C) 2000  Andrea Arcangeli <andrea@suse.de> SuSE
 * Queue request tables / lock, selectable elevator, Jens Axboe <axboe@suse.de>
6 7
 * kernel-doc documentation started by NeilBrown <neilb@cse.unsw.edu.au>
 *	-  July2000
L
Linus Torvalds 已提交
8 9 10 11 12 13 14 15 16 17 18
 * bio rewrite, highmem i/o, etc, Jens Axboe <axboe@suse.de> - may 2001
 */

/*
 * This handles all read/write requests to block devices
 */
#include <linux/kernel.h>
#include <linux/module.h>
#include <linux/backing-dev.h>
#include <linux/bio.h>
#include <linux/blkdev.h>
19
#include <linux/blk-mq.h>
L
Linus Torvalds 已提交
20 21 22 23 24 25 26 27 28
#include <linux/highmem.h>
#include <linux/mm.h>
#include <linux/kernel_stat.h>
#include <linux/string.h>
#include <linux/init.h>
#include <linux/completion.h>
#include <linux/slab.h>
#include <linux/swap.h>
#include <linux/writeback.h>
29
#include <linux/task_io_accounting_ops.h>
30
#include <linux/fault-inject.h>
31
#include <linux/list_sort.h>
T
Tejun Heo 已提交
32
#include <linux/delay.h>
33
#include <linux/ratelimit.h>
L
Lin Ming 已提交
34
#include <linux/pm_runtime.h>
35
#include <linux/blk-cgroup.h>
36
#include <linux/debugfs.h>
37
#include <linux/bpf.h>
38 39 40

#define CREATE_TRACE_POINTS
#include <trace/events/block.h>
L
Linus Torvalds 已提交
41

42
#include "blk.h"
43
#include "blk-mq.h"
44
#include "blk-mq-sched.h"
J
Jens Axboe 已提交
45
#include "blk-wbt.h"
46

47 48 49 50
#ifdef CONFIG_DEBUG_FS
struct dentry *blk_debugfs_root;
#endif

51
EXPORT_TRACEPOINT_SYMBOL_GPL(block_bio_remap);
52
EXPORT_TRACEPOINT_SYMBOL_GPL(block_rq_remap);
53
EXPORT_TRACEPOINT_SYMBOL_GPL(block_bio_complete);
K
Keith Busch 已提交
54
EXPORT_TRACEPOINT_SYMBOL_GPL(block_split);
N
NeilBrown 已提交
55
EXPORT_TRACEPOINT_SYMBOL_GPL(block_unplug);
56

57 58
DEFINE_IDA(blk_queue_ida);

L
Linus Torvalds 已提交
59 60 61
/*
 * For the allocated request tables
 */
62
struct kmem_cache *request_cachep;
L
Linus Torvalds 已提交
63 64 65 66

/*
 * For queue allocation
 */
67
struct kmem_cache *blk_requestq_cachep;
L
Linus Torvalds 已提交
68 69 70 71

/*
 * Controlling structure to kblockd
 */
72
static struct workqueue_struct *kblockd_workqueue;
L
Linus Torvalds 已提交
73

74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145
/**
 * blk_queue_flag_set - atomically set a queue flag
 * @flag: flag to be set
 * @q: request queue
 */
void blk_queue_flag_set(unsigned int flag, struct request_queue *q)
{
	unsigned long flags;

	spin_lock_irqsave(q->queue_lock, flags);
	queue_flag_set(flag, q);
	spin_unlock_irqrestore(q->queue_lock, flags);
}
EXPORT_SYMBOL(blk_queue_flag_set);

/**
 * blk_queue_flag_clear - atomically clear a queue flag
 * @flag: flag to be cleared
 * @q: request queue
 */
void blk_queue_flag_clear(unsigned int flag, struct request_queue *q)
{
	unsigned long flags;

	spin_lock_irqsave(q->queue_lock, flags);
	queue_flag_clear(flag, q);
	spin_unlock_irqrestore(q->queue_lock, flags);
}
EXPORT_SYMBOL(blk_queue_flag_clear);

/**
 * blk_queue_flag_test_and_set - atomically test and set a queue flag
 * @flag: flag to be set
 * @q: request queue
 *
 * Returns the previous value of @flag - 0 if the flag was not set and 1 if
 * the flag was already set.
 */
bool blk_queue_flag_test_and_set(unsigned int flag, struct request_queue *q)
{
	unsigned long flags;
	bool res;

	spin_lock_irqsave(q->queue_lock, flags);
	res = queue_flag_test_and_set(flag, q);
	spin_unlock_irqrestore(q->queue_lock, flags);

	return res;
}
EXPORT_SYMBOL_GPL(blk_queue_flag_test_and_set);

/**
 * blk_queue_flag_test_and_clear - atomically test and clear a queue flag
 * @flag: flag to be cleared
 * @q: request queue
 *
 * Returns the previous value of @flag - 0 if the flag was not set and 1 if
 * the flag was set.
 */
bool blk_queue_flag_test_and_clear(unsigned int flag, struct request_queue *q)
{
	unsigned long flags;
	bool res;

	spin_lock_irqsave(q->queue_lock, flags);
	res = queue_flag_test_and_clear(flag, q);
	spin_unlock_irqrestore(q->queue_lock, flags);

	return res;
}
EXPORT_SYMBOL_GPL(blk_queue_flag_test_and_clear);

146 147 148 149 150
static void blk_clear_congested(struct request_list *rl, int sync)
{
#ifdef CONFIG_CGROUP_WRITEBACK
	clear_wb_congested(rl->blkg->wb_congested, sync);
#else
151 152 153 154 155
	/*
	 * If !CGROUP_WRITEBACK, all blkg's map to bdi->wb and we shouldn't
	 * flip its congestion state for events on other blkcgs.
	 */
	if (rl == &rl->q->root_rl)
156
		clear_wb_congested(rl->q->backing_dev_info->wb.congested, sync);
157 158 159 160 161 162 163 164
#endif
}

static void blk_set_congested(struct request_list *rl, int sync)
{
#ifdef CONFIG_CGROUP_WRITEBACK
	set_wb_congested(rl->blkg->wb_congested, sync);
#else
165 166
	/* see blk_clear_congested() */
	if (rl == &rl->q->root_rl)
167
		set_wb_congested(rl->q->backing_dev_info->wb.congested, sync);
168 169 170
#endif
}

171
void blk_queue_congestion_threshold(struct request_queue *q)
L
Linus Torvalds 已提交
172 173 174 175 176 177 178 179 180 181 182 183 184 185
{
	int nr;

	nr = q->nr_requests - (q->nr_requests / 8) + 1;
	if (nr > q->nr_requests)
		nr = q->nr_requests;
	q->nr_congestion_on = nr;

	nr = q->nr_requests - (q->nr_requests / 8) - (q->nr_requests / 16) - 1;
	if (nr < 1)
		nr = 1;
	q->nr_congestion_off = nr;
}

186
void blk_rq_init(struct request_queue *q, struct request *rq)
L
Linus Torvalds 已提交
187
{
188 189
	memset(rq, 0, sizeof(*rq));

L
Linus Torvalds 已提交
190
	INIT_LIST_HEAD(&rq->queuelist);
J
Jens Axboe 已提交
191
	INIT_LIST_HEAD(&rq->timeout_list);
192
	rq->cpu = -1;
J
Jens Axboe 已提交
193
	rq->q = q;
194
	rq->__sector = (sector_t) -1;
195 196
	INIT_HLIST_NODE(&rq->hash);
	RB_CLEAR_NODE(&rq->rb_node);
J
Jens Axboe 已提交
197
	rq->tag = -1;
198
	rq->internal_tag = -1;
199
	rq->start_time_ns = ktime_get_ns();
200
	rq->part = NULL;
L
Linus Torvalds 已提交
201
}
202
EXPORT_SYMBOL(blk_rq_init);
L
Linus Torvalds 已提交
203

204 205 206 207 208 209 210 211 212 213 214 215 216 217
static const struct {
	int		errno;
	const char	*name;
} blk_errors[] = {
	[BLK_STS_OK]		= { 0,		"" },
	[BLK_STS_NOTSUPP]	= { -EOPNOTSUPP, "operation not supported" },
	[BLK_STS_TIMEOUT]	= { -ETIMEDOUT,	"timeout" },
	[BLK_STS_NOSPC]		= { -ENOSPC,	"critical space allocation" },
	[BLK_STS_TRANSPORT]	= { -ENOLINK,	"recoverable transport" },
	[BLK_STS_TARGET]	= { -EREMOTEIO,	"critical target" },
	[BLK_STS_NEXUS]		= { -EBADE,	"critical nexus" },
	[BLK_STS_MEDIUM]	= { -ENODATA,	"critical medium" },
	[BLK_STS_PROTECTION]	= { -EILSEQ,	"protection" },
	[BLK_STS_RESOURCE]	= { -ENOMEM,	"kernel resource" },
218
	[BLK_STS_DEV_RESOURCE]	= { -EBUSY,	"device resource" },
219
	[BLK_STS_AGAIN]		= { -EAGAIN,	"nonblocking retry" },
220

221 222 223
	/* device mapper special case, should not leak out: */
	[BLK_STS_DM_REQUEUE]	= { -EREMCHG, "dm internal retry" },

224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244
	/* everything else not covered above: */
	[BLK_STS_IOERR]		= { -EIO,	"I/O" },
};

blk_status_t errno_to_blk_status(int errno)
{
	int i;

	for (i = 0; i < ARRAY_SIZE(blk_errors); i++) {
		if (blk_errors[i].errno == errno)
			return (__force blk_status_t)i;
	}

	return BLK_STS_IOERR;
}
EXPORT_SYMBOL_GPL(errno_to_blk_status);

int blk_status_to_errno(blk_status_t status)
{
	int idx = (__force int)status;

245
	if (WARN_ON_ONCE(idx >= ARRAY_SIZE(blk_errors)))
246 247 248 249 250 251 252 253 254
		return -EIO;
	return blk_errors[idx].errno;
}
EXPORT_SYMBOL_GPL(blk_status_to_errno);

static void print_req_error(struct request *req, blk_status_t status)
{
	int idx = (__force int)status;

255
	if (WARN_ON_ONCE(idx >= ARRAY_SIZE(blk_errors)))
256 257 258 259 260 261 262 263
		return;

	printk_ratelimited(KERN_ERR "%s: %s error, dev %s, sector %llu\n",
			   __func__, blk_errors[idx].name, req->rq_disk ?
			   req->rq_disk->disk_name : "?",
			   (unsigned long long)blk_rq_pos(req));
}

N
NeilBrown 已提交
264
static void req_bio_endio(struct request *rq, struct bio *bio,
265
			  unsigned int nbytes, blk_status_t error)
L
Linus Torvalds 已提交
266
{
267
	if (error)
268
		bio->bi_status = error;
269

270
	if (unlikely(rq->rq_flags & RQF_QUIET))
271
		bio_set_flag(bio, BIO_QUIET);
272

273
	bio_advance(bio, nbytes);
274

T
Tejun Heo 已提交
275
	/* don't actually finish bio if it's part of flush sequence */
276
	if (bio->bi_iter.bi_size == 0 && !(rq->rq_flags & RQF_FLUSH_SEQ))
277
		bio_endio(bio);
L
Linus Torvalds 已提交
278 279 280 281
}

void blk_dump_rq_flags(struct request *rq, char *msg)
{
282 283
	printk(KERN_INFO "%s: dev %s: flags=%llx\n", msg,
		rq->rq_disk ? rq->rq_disk->disk_name : "?",
J
Jens Axboe 已提交
284
		(unsigned long long) rq->cmd_flags);
L
Linus Torvalds 已提交
285

286 287 288
	printk(KERN_INFO "  sector %llu, nr/cnr %u/%u\n",
	       (unsigned long long)blk_rq_pos(rq),
	       blk_rq_sectors(rq), blk_rq_cur_sectors(rq));
289 290
	printk(KERN_INFO "  bio %p, biotail %p, len %u\n",
	       rq->bio, rq->biotail, blk_rq_bytes(rq));
L
Linus Torvalds 已提交
291 292 293
}
EXPORT_SYMBOL(blk_dump_rq_flags);

294
static void blk_delay_work(struct work_struct *work)
L
Linus Torvalds 已提交
295
{
296
	struct request_queue *q;
L
Linus Torvalds 已提交
297

298 299
	q = container_of(work, struct request_queue, delay_work.work);
	spin_lock_irq(q->queue_lock);
300
	__blk_run_queue(q);
301
	spin_unlock_irq(q->queue_lock);
L
Linus Torvalds 已提交
302 303 304
}

/**
305 306 307
 * blk_delay_queue - restart queueing after defined interval
 * @q:		The &struct request_queue in question
 * @msecs:	Delay in msecs
L
Linus Torvalds 已提交
308 309
 *
 * Description:
310 311
 *   Sometimes queueing needs to be postponed for a little while, to allow
 *   resources to come back. This function will make sure that queueing is
312
 *   restarted around the specified time.
313 314
 */
void blk_delay_queue(struct request_queue *q, unsigned long msecs)
315
{
316
	lockdep_assert_held(q->queue_lock);
317
	WARN_ON_ONCE(q->mq_ops);
318

319 320 321
	if (likely(!blk_queue_dead(q)))
		queue_delayed_work(kblockd_workqueue, &q->delay_work,
				   msecs_to_jiffies(msecs));
322
}
323
EXPORT_SYMBOL(blk_delay_queue);
324

J
Jens Axboe 已提交
325 326 327 328 329 330 331 332 333 334 335
/**
 * blk_start_queue_async - asynchronously restart a previously stopped queue
 * @q:    The &struct request_queue in question
 *
 * Description:
 *   blk_start_queue_async() will clear the stop flag on the queue, and
 *   ensure that the request_fn for the queue is run from an async
 *   context.
 **/
void blk_start_queue_async(struct request_queue *q)
{
336
	lockdep_assert_held(q->queue_lock);
337
	WARN_ON_ONCE(q->mq_ops);
338

J
Jens Axboe 已提交
339 340 341 342 343
	queue_flag_clear(QUEUE_FLAG_STOPPED, q);
	blk_run_queue_async(q);
}
EXPORT_SYMBOL(blk_start_queue_async);

L
Linus Torvalds 已提交
344 345
/**
 * blk_start_queue - restart a previously stopped queue
346
 * @q:    The &struct request_queue in question
L
Linus Torvalds 已提交
347 348 349 350
 *
 * Description:
 *   blk_start_queue() will clear the stop flag on the queue, and call
 *   the request_fn for the queue if it was in a stopped state when
351
 *   entered. Also see blk_stop_queue().
L
Linus Torvalds 已提交
352
 **/
353
void blk_start_queue(struct request_queue *q)
L
Linus Torvalds 已提交
354
{
355
	lockdep_assert_held(q->queue_lock);
356
	WARN_ON_ONCE(q->mq_ops);
357

N
Nick Piggin 已提交
358
	queue_flag_clear(QUEUE_FLAG_STOPPED, q);
359
	__blk_run_queue(q);
L
Linus Torvalds 已提交
360 361 362 363 364
}
EXPORT_SYMBOL(blk_start_queue);

/**
 * blk_stop_queue - stop a queue
365
 * @q:    The &struct request_queue in question
L
Linus Torvalds 已提交
366 367 368 369 370 371 372 373 374
 *
 * Description:
 *   The Linux block layer assumes that a block driver will consume all
 *   entries on the request queue when the request_fn strategy is called.
 *   Often this will not happen, because of hardware limitations (queue
 *   depth settings). If a device driver gets a 'queue full' response,
 *   or if it simply chooses not to queue more I/O at one point, it can
 *   call this function to prevent the request_fn from being called until
 *   the driver has signalled it's ready to go again. This happens by calling
375
 *   blk_start_queue() to restart queue operations.
L
Linus Torvalds 已提交
376
 **/
377
void blk_stop_queue(struct request_queue *q)
L
Linus Torvalds 已提交
378
{
379
	lockdep_assert_held(q->queue_lock);
380
	WARN_ON_ONCE(q->mq_ops);
381

382
	cancel_delayed_work(&q->delay_work);
N
Nick Piggin 已提交
383
	queue_flag_set(QUEUE_FLAG_STOPPED, q);
L
Linus Torvalds 已提交
384 385 386 387 388 389 390 391 392 393 394 395
}
EXPORT_SYMBOL(blk_stop_queue);

/**
 * blk_sync_queue - cancel any pending callbacks on a queue
 * @q: the queue
 *
 * Description:
 *     The block layer may perform asynchronous callback activity
 *     on a queue, such as calling the unplug function after a timeout.
 *     A block device may call blk_sync_queue to ensure that any
 *     such activity is cancelled, thus allowing it to release resources
396
 *     that the callbacks might use. The caller must already have made sure
L
Linus Torvalds 已提交
397 398 399
 *     that its ->make_request_fn will not re-add plugging prior to calling
 *     this function.
 *
400
 *     This function does not cancel any asynchronous activity arising
401
 *     out of elevator or throttling code. That would require elevator_exit()
402
 *     and blkcg_exit_queue() to be called with queue lock initialized.
403
 *
L
Linus Torvalds 已提交
404 405 406
 */
void blk_sync_queue(struct request_queue *q)
{
407
	del_timer_sync(&q->timeout);
408
	cancel_work_sync(&q->timeout_work);
409 410 411 412 413

	if (q->mq_ops) {
		struct blk_mq_hw_ctx *hctx;
		int i;

414
		cancel_delayed_work_sync(&q->requeue_work);
415
		queue_for_each_hw_ctx(q, hctx, i)
416
			cancel_delayed_work_sync(&hctx->run_work);
417 418 419
	} else {
		cancel_delayed_work_sync(&q->delay_work);
	}
L
Linus Torvalds 已提交
420 421 422
}
EXPORT_SYMBOL(blk_sync_queue);

423 424 425 426 427 428 429 430 431
/**
 * blk_set_preempt_only - set QUEUE_FLAG_PREEMPT_ONLY
 * @q: request queue pointer
 *
 * Returns the previous value of the PREEMPT_ONLY flag - 0 if the flag was not
 * set and 1 if the flag was already set.
 */
int blk_set_preempt_only(struct request_queue *q)
{
432
	return blk_queue_flag_test_and_set(QUEUE_FLAG_PREEMPT_ONLY, q);
433 434 435 436 437
}
EXPORT_SYMBOL_GPL(blk_set_preempt_only);

void blk_clear_preempt_only(struct request_queue *q)
{
438
	blk_queue_flag_clear(QUEUE_FLAG_PREEMPT_ONLY, q);
439
	wake_up_all(&q->mq_freeze_wq);
440 441 442
}
EXPORT_SYMBOL_GPL(blk_clear_preempt_only);

443 444 445 446 447 448 449 450 451 452 453 454 455
/**
 * __blk_run_queue_uncond - run a queue whether or not it has been stopped
 * @q:	The queue to run
 *
 * Description:
 *    Invoke request handling on a queue if there are any pending requests.
 *    May be used to restart request handling after a request has completed.
 *    This variant runs the queue whether or not the queue has been
 *    stopped. Must be called with the queue lock held and interrupts
 *    disabled. See also @blk_run_queue.
 */
inline void __blk_run_queue_uncond(struct request_queue *q)
{
456
	lockdep_assert_held(q->queue_lock);
457
	WARN_ON_ONCE(q->mq_ops);
458

459 460 461
	if (unlikely(blk_queue_dead(q)))
		return;

462 463 464 465 466 467 468 469
	/*
	 * Some request_fn implementations, e.g. scsi_request_fn(), unlock
	 * the queue lock internally. As a result multiple threads may be
	 * running such a request function concurrently. Keep track of the
	 * number of active request_fn invocations such that blk_drain_queue()
	 * can wait until all these request_fn calls have finished.
	 */
	q->request_fn_active++;
470
	q->request_fn(q);
471
	q->request_fn_active--;
472
}
473
EXPORT_SYMBOL_GPL(__blk_run_queue_uncond);
474

L
Linus Torvalds 已提交
475
/**
476
 * __blk_run_queue - run a single device queue
L
Linus Torvalds 已提交
477
 * @q:	The queue to run
478 479
 *
 * Description:
480
 *    See @blk_run_queue.
L
Linus Torvalds 已提交
481
 */
482
void __blk_run_queue(struct request_queue *q)
L
Linus Torvalds 已提交
483
{
484
	lockdep_assert_held(q->queue_lock);
485
	WARN_ON_ONCE(q->mq_ops);
486

487 488 489
	if (unlikely(blk_queue_stopped(q)))
		return;

490
	__blk_run_queue_uncond(q);
N
Nick Piggin 已提交
491 492
}
EXPORT_SYMBOL(__blk_run_queue);
J
Jens Axboe 已提交
493

494 495 496 497 498 499
/**
 * blk_run_queue_async - run a single device queue in workqueue context
 * @q:	The queue to run
 *
 * Description:
 *    Tells kblockd to perform the equivalent of @blk_run_queue on behalf
500 501 502 503 504 505
 *    of us.
 *
 * Note:
 *    Since it is not allowed to run q->delay_work after blk_cleanup_queue()
 *    has canceled q->delay_work, callers must hold the queue lock to avoid
 *    race conditions between blk_cleanup_queue() and blk_run_queue_async().
506 507 508
 */
void blk_run_queue_async(struct request_queue *q)
{
509
	lockdep_assert_held(q->queue_lock);
510
	WARN_ON_ONCE(q->mq_ops);
511

512
	if (likely(!blk_queue_stopped(q) && !blk_queue_dead(q)))
513
		mod_delayed_work(kblockd_workqueue, &q->delay_work, 0);
514
}
515
EXPORT_SYMBOL(blk_run_queue_async);
516

N
Nick Piggin 已提交
517 518 519
/**
 * blk_run_queue - run a single device queue
 * @q: The queue to run
520 521 522
 *
 * Description:
 *    Invoke request handling on this queue, if it has pending work to do.
T
Tejun Heo 已提交
523
 *    May be used to restart queueing when a request has completed.
N
Nick Piggin 已提交
524 525 526 527 528
 */
void blk_run_queue(struct request_queue *q)
{
	unsigned long flags;

529 530
	WARN_ON_ONCE(q->mq_ops);

N
Nick Piggin 已提交
531
	spin_lock_irqsave(q->queue_lock, flags);
532
	__blk_run_queue(q);
L
Linus Torvalds 已提交
533 534 535 536
	spin_unlock_irqrestore(q->queue_lock, flags);
}
EXPORT_SYMBOL(blk_run_queue);

537
void blk_put_queue(struct request_queue *q)
538 539 540
{
	kobject_put(&q->kobj);
}
J
Jens Axboe 已提交
541
EXPORT_SYMBOL(blk_put_queue);
542

T
Tejun Heo 已提交
543
/**
544
 * __blk_drain_queue - drain requests from request_queue
T
Tejun Heo 已提交
545
 * @q: queue to drain
546
 * @drain_all: whether to drain all requests or only the ones w/ ELVPRIV
T
Tejun Heo 已提交
547
 *
548 549 550
 * Drain requests from @q.  If @drain_all is set, all requests are drained.
 * If not, only ELVPRIV requests are drained.  The caller is responsible
 * for ensuring that no new requests which need to be drained are queued.
T
Tejun Heo 已提交
551
 */
552 553 554
static void __blk_drain_queue(struct request_queue *q, bool drain_all)
	__releases(q->queue_lock)
	__acquires(q->queue_lock)
T
Tejun Heo 已提交
555
{
556 557
	int i;

558
	lockdep_assert_held(q->queue_lock);
559
	WARN_ON_ONCE(q->mq_ops);
560

T
Tejun Heo 已提交
561
	while (true) {
562
		bool drain = false;
T
Tejun Heo 已提交
563

564 565 566 567 568 569 570
		/*
		 * The caller might be trying to drain @q before its
		 * elevator is initialized.
		 */
		if (q->elevator)
			elv_drain_elevator(q);

571
		blkcg_drain_queue(q);
T
Tejun Heo 已提交
572

573 574
		/*
		 * This function might be called on a queue which failed
575 576 577 578
		 * driver init after queue creation or is not yet fully
		 * active yet.  Some drivers (e.g. fd and loop) get unhappy
		 * in such cases.  Kick queue iff dispatch queue has
		 * something on it and @q has request_fn set.
579
		 */
580
		if (!list_empty(&q->queue_head) && q->request_fn)
581
			__blk_run_queue(q);
582

583
		drain |= q->nr_rqs_elvpriv;
584
		drain |= q->request_fn_active;
585 586 587 588 589 590 591

		/*
		 * Unfortunately, requests are queued at and tracked from
		 * multiple places and there's no single counter which can
		 * be drained.  Check all the queues and counters.
		 */
		if (drain_all) {
592
			struct blk_flush_queue *fq = blk_get_flush_queue(q, NULL);
593 594
			drain |= !list_empty(&q->queue_head);
			for (i = 0; i < 2; i++) {
595
				drain |= q->nr_rqs[i];
596
				drain |= q->in_flight[i];
597 598
				if (fq)
				    drain |= !list_empty(&fq->flush_queue[i]);
599 600
			}
		}
T
Tejun Heo 已提交
601

602
		if (!drain)
T
Tejun Heo 已提交
603
			break;
604 605 606

		spin_unlock_irq(q->queue_lock);

T
Tejun Heo 已提交
607
		msleep(10);
608 609

		spin_lock_irq(q->queue_lock);
T
Tejun Heo 已提交
610
	}
611 612 613 614 615 616 617

	/*
	 * With queue marked dead, any woken up waiter will fail the
	 * allocation path, so the wakeup chaining is lost and we're
	 * left with hung waiters. We need to wake up those waiters.
	 */
	if (q->request_fn) {
618 619 620 621 622
		struct request_list *rl;

		blk_queue_for_each_rl(rl, q)
			for (i = 0; i < ARRAY_SIZE(rl->wait); i++)
				wake_up_all(&rl->wait[i]);
623
	}
T
Tejun Heo 已提交
624 625
}

626 627 628 629 630 631 632
void blk_drain_queue(struct request_queue *q)
{
	spin_lock_irq(q->queue_lock);
	__blk_drain_queue(q, true);
	spin_unlock_irq(q->queue_lock);
}

633 634 635 636 637 638
/**
 * blk_queue_bypass_start - enter queue bypass mode
 * @q: queue of interest
 *
 * In bypass mode, only the dispatch FIFO queue of @q is used.  This
 * function makes @q enter bypass mode and drains all requests which were
639
 * throttled or issued before.  On return, it's guaranteed that no request
640 641
 * is being throttled or has ELVPRIV set and blk_queue_bypass() %true
 * inside queue or RCU read lock.
642 643 644
 */
void blk_queue_bypass_start(struct request_queue *q)
{
645 646
	WARN_ON_ONCE(q->mq_ops);

647
	spin_lock_irq(q->queue_lock);
648
	q->bypass_depth++;
649 650 651
	queue_flag_set(QUEUE_FLAG_BYPASS, q);
	spin_unlock_irq(q->queue_lock);

652 653 654 655 656 657
	/*
	 * Queues start drained.  Skip actual draining till init is
	 * complete.  This avoids lenghty delays during queue init which
	 * can happen many times during boot.
	 */
	if (blk_queue_init_done(q)) {
658 659 660 661
		spin_lock_irq(q->queue_lock);
		__blk_drain_queue(q, false);
		spin_unlock_irq(q->queue_lock);

662 663 664
		/* ensure blk_queue_bypass() is %true inside RCU read lock */
		synchronize_rcu();
	}
665 666 667 668 669 670 671 672
}
EXPORT_SYMBOL_GPL(blk_queue_bypass_start);

/**
 * blk_queue_bypass_end - leave queue bypass mode
 * @q: queue of interest
 *
 * Leave bypass mode and restore the normal queueing behavior.
673 674 675
 *
 * Note: although blk_queue_bypass_start() is only called for blk-sq queues,
 * this function is called for both blk-sq and blk-mq queues.
676 677 678 679 680 681 682 683 684 685 686
 */
void blk_queue_bypass_end(struct request_queue *q)
{
	spin_lock_irq(q->queue_lock);
	if (!--q->bypass_depth)
		queue_flag_clear(QUEUE_FLAG_BYPASS, q);
	WARN_ON_ONCE(q->bypass_depth < 0);
	spin_unlock_irq(q->queue_lock);
}
EXPORT_SYMBOL_GPL(blk_queue_bypass_end);

687 688
void blk_set_queue_dying(struct request_queue *q)
{
689
	blk_queue_flag_set(QUEUE_FLAG_DYING, q);
690

691 692 693 694 695 696 697
	/*
	 * When queue DYING flag is set, we need to block new req
	 * entering queue, so we call blk_freeze_queue_start() to
	 * prevent I/O from crossing blk_queue_enter().
	 */
	blk_freeze_queue_start(q);

698 699 700 701 702
	if (q->mq_ops)
		blk_mq_wake_waiters(q);
	else {
		struct request_list *rl;

703
		spin_lock_irq(q->queue_lock);
704 705
		blk_queue_for_each_rl(rl, q) {
			if (rl->rq_pool) {
706 707
				wake_up_all(&rl->wait[BLK_RW_SYNC]);
				wake_up_all(&rl->wait[BLK_RW_ASYNC]);
708 709
			}
		}
710
		spin_unlock_irq(q->queue_lock);
711
	}
712 713 714

	/* Make blk_queue_enter() reexamine the DYING flag. */
	wake_up_all(&q->mq_freeze_wq);
715 716 717
}
EXPORT_SYMBOL_GPL(blk_set_queue_dying);

718 719 720 721
/**
 * blk_cleanup_queue - shutdown a request queue
 * @q: request queue to shutdown
 *
722 723
 * Mark @q DYING, drain all pending requests, mark @q DEAD, destroy and
 * put it.  All future requests will be failed immediately with -ENODEV.
724
 */
725
void blk_cleanup_queue(struct request_queue *q)
726
{
727
	spinlock_t *lock = q->queue_lock;
728

B
Bart Van Assche 已提交
729
	/* mark @q DYING, no new request or merges will be allowed afterwards */
730
	mutex_lock(&q->sysfs_lock);
731
	blk_set_queue_dying(q);
732
	spin_lock_irq(lock);
733

734
	/*
B
Bart Van Assche 已提交
735
	 * A dying queue is permanently in bypass mode till released.  Note
736 737 738 739 740 741 742
	 * that, unlike blk_queue_bypass_start(), we aren't performing
	 * synchronize_rcu() after entering bypass mode to avoid the delay
	 * as some drivers create and destroy a lot of queues while
	 * probing.  This is still safe because blk_release_queue() will be
	 * called only after the queue refcnt drops to zero and nothing,
	 * RCU or not, would be traversing the queue by then.
	 */
743 744 745
	q->bypass_depth++;
	queue_flag_set(QUEUE_FLAG_BYPASS, q);

746 747
	queue_flag_set(QUEUE_FLAG_NOMERGES, q);
	queue_flag_set(QUEUE_FLAG_NOXMERGES, q);
B
Bart Van Assche 已提交
748
	queue_flag_set(QUEUE_FLAG_DYING, q);
749 750 751
	spin_unlock_irq(lock);
	mutex_unlock(&q->sysfs_lock);

752 753 754 755
	/*
	 * Drain all requests queued before DYING marking. Set DEAD flag to
	 * prevent that q->request_fn() gets invoked after draining finished.
	 */
756
	blk_freeze_queue(q);
757
	spin_lock_irq(lock);
758
	queue_flag_set(QUEUE_FLAG_DEAD, q);
759
	spin_unlock_irq(lock);
760

761 762 763 764 765 766 767 768 769
	/*
	 * make sure all in-progress dispatch are completed because
	 * blk_freeze_queue() can only complete all requests, and
	 * dispatch may still be in-progress since we dispatch requests
	 * from more than one contexts
	 */
	if (q->mq_ops)
		blk_mq_quiesce_queue(q);

770 771 772
	/* for synchronous bio-based driver finish in-flight integrity i/o */
	blk_flush_integrity();

773
	/* @q won't process any more request, flush async actions */
774
	del_timer_sync(&q->backing_dev_info->laptop_mode_wb_timer);
775 776
	blk_sync_queue(q);

777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807
	/*
	 * I/O scheduler exit is only safe after the sysfs scheduler attribute
	 * has been removed.
	 */
	WARN_ON_ONCE(q->kobj.state_in_sysfs);

	/*
	 * Since the I/O scheduler exit code may access cgroup information,
	 * perform I/O scheduler exit before disassociating from the block
	 * cgroup controller.
	 */
	if (q->elevator) {
		ioc_clear_queue(q);
		elevator_exit(q, q->elevator);
		q->elevator = NULL;
	}

	/*
	 * Remove all references to @q from the block cgroup controller before
	 * restoring @q->queue_lock to avoid that restoring this pointer causes
	 * e.g. blkcg_print_blkgs() to crash.
	 */
	blkcg_exit_queue(q);

	/*
	 * Since the cgroup code may dereference the @q->backing_dev_info
	 * pointer, only decrease its reference count after having removed the
	 * association with the block cgroup controller.
	 */
	bdi_put(q->backing_dev_info);

B
Bart Van Assche 已提交
808 809
	if (q->mq_ops)
		blk_mq_free_queue(q);
810
	percpu_ref_exit(&q->q_usage_counter);
B
Bart Van Assche 已提交
811

812 813 814 815 816
	spin_lock_irq(lock);
	if (q->queue_lock != &q->__queue_lock)
		q->queue_lock = &q->__queue_lock;
	spin_unlock_irq(lock);

817
	/* @q is and will stay empty, shutdown and put */
818 819
	blk_put_queue(q);
}
L
Linus Torvalds 已提交
820 821
EXPORT_SYMBOL(blk_cleanup_queue);

822
/* Allocate memory local to the request queue */
823
static void *alloc_request_simple(gfp_t gfp_mask, void *data)
824
{
825 826 827
	struct request_queue *q = data;

	return kmem_cache_alloc_node(request_cachep, gfp_mask, q->node);
828 829
}

830
static void free_request_simple(void *element, void *data)
831 832 833 834
{
	kmem_cache_free(request_cachep, element);
}

835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857
static void *alloc_request_size(gfp_t gfp_mask, void *data)
{
	struct request_queue *q = data;
	struct request *rq;

	rq = kmalloc_node(sizeof(struct request) + q->cmd_size, gfp_mask,
			q->node);
	if (rq && q->init_rq_fn && q->init_rq_fn(q, rq, gfp_mask) < 0) {
		kfree(rq);
		rq = NULL;
	}
	return rq;
}

static void free_request_size(void *element, void *data)
{
	struct request_queue *q = data;

	if (q->exit_rq_fn)
		q->exit_rq_fn(q, element);
	kfree(element);
}

858 859
int blk_init_rl(struct request_list *rl, struct request_queue *q,
		gfp_t gfp_mask)
L
Linus Torvalds 已提交
860
{
S
Shaohua Li 已提交
861
	if (unlikely(rl->rq_pool) || q->mq_ops)
862 863
		return 0;

864
	rl->q = q;
865 866 867 868
	rl->count[BLK_RW_SYNC] = rl->count[BLK_RW_ASYNC] = 0;
	rl->starved[BLK_RW_SYNC] = rl->starved[BLK_RW_ASYNC] = 0;
	init_waitqueue_head(&rl->wait[BLK_RW_SYNC]);
	init_waitqueue_head(&rl->wait[BLK_RW_ASYNC]);
L
Linus Torvalds 已提交
869

870 871 872 873 874 875 876 877 878
	if (q->cmd_size) {
		rl->rq_pool = mempool_create_node(BLKDEV_MIN_RQ,
				alloc_request_size, free_request_size,
				q, gfp_mask, q->node);
	} else {
		rl->rq_pool = mempool_create_node(BLKDEV_MIN_RQ,
				alloc_request_simple, free_request_simple,
				q, gfp_mask, q->node);
	}
L
Linus Torvalds 已提交
879 880 881
	if (!rl->rq_pool)
		return -ENOMEM;

882 883 884
	if (rl != &q->root_rl)
		WARN_ON_ONCE(!blk_get_queue(q));

L
Linus Torvalds 已提交
885 886 887
	return 0;
}

888
void blk_exit_rl(struct request_queue *q, struct request_list *rl)
889
{
890
	if (rl->rq_pool) {
891
		mempool_destroy(rl->rq_pool);
892 893 894
		if (rl != &q->root_rl)
			blk_put_queue(q);
	}
895 896
}

897
struct request_queue *blk_alloc_queue(gfp_t gfp_mask)
L
Linus Torvalds 已提交
898
{
899
	return blk_alloc_queue_node(gfp_mask, NUMA_NO_NODE, NULL);
900 901
}
EXPORT_SYMBOL(blk_alloc_queue);
L
Linus Torvalds 已提交
902

903 904 905 906 907
/**
 * blk_queue_enter() - try to increase q->q_usage_counter
 * @q: request queue pointer
 * @flags: BLK_MQ_REQ_NOWAIT and/or BLK_MQ_REQ_PREEMPT
 */
908
int blk_queue_enter(struct request_queue *q, blk_mq_req_flags_t flags)
909
{
910 911
	const bool preempt = flags & BLK_MQ_REQ_PREEMPT;

912
	while (true) {
913
		bool success = false;
914

915
		rcu_read_lock();
916 917 918 919 920 921 922 923 924 925 926 927
		if (percpu_ref_tryget_live(&q->q_usage_counter)) {
			/*
			 * The code that sets the PREEMPT_ONLY flag is
			 * responsible for ensuring that that flag is globally
			 * visible before the queue is unfrozen.
			 */
			if (preempt || !blk_queue_preempt_only(q)) {
				success = true;
			} else {
				percpu_ref_put(&q->q_usage_counter);
			}
		}
928
		rcu_read_unlock();
929 930

		if (success)
931 932
			return 0;

933
		if (flags & BLK_MQ_REQ_NOWAIT)
934 935
			return -EBUSY;

936
		/*
937
		 * read pair of barrier in blk_freeze_queue_start(),
938
		 * we need to order reading __PERCPU_REF_DEAD flag of
939 940 941
		 * .q_usage_counter and reading .mq_freeze_depth or
		 * queue dying flag, otherwise the following wait may
		 * never return if the two reads are reordered.
942 943 944
		 */
		smp_rmb();

945 946 947 948
		wait_event(q->mq_freeze_wq,
			   (atomic_read(&q->mq_freeze_depth) == 0 &&
			    (preempt || !blk_queue_preempt_only(q))) ||
			   blk_queue_dying(q));
949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966
		if (blk_queue_dying(q))
			return -ENODEV;
	}
}

void blk_queue_exit(struct request_queue *q)
{
	percpu_ref_put(&q->q_usage_counter);
}

static void blk_queue_usage_counter_release(struct percpu_ref *ref)
{
	struct request_queue *q =
		container_of(ref, struct request_queue, q_usage_counter);

	wake_up_all(&q->mq_freeze_wq);
}

967
static void blk_rq_timed_out_timer(struct timer_list *t)
968
{
969
	struct request_queue *q = from_timer(q, t, timeout);
970 971 972 973

	kblockd_schedule_work(&q->timeout_work);
}

974 975 976 977 978 979 980 981 982 983 984 985 986
/**
 * blk_alloc_queue_node - allocate a request queue
 * @gfp_mask: memory allocation flags
 * @node_id: NUMA node to allocate memory from
 * @lock: For legacy queues, pointer to a spinlock that will be used to e.g.
 *        serialize calls to the legacy .request_fn() callback. Ignored for
 *	  blk-mq request queues.
 *
 * Note: pass the queue lock as the third argument to this function instead of
 * setting the queue lock pointer explicitly to avoid triggering a sporadic
 * crash in the blkcg code. This function namely calls blkcg_init_queue() and
 * the queue lock pointer must be set before blkcg_init_queue() is called.
 */
987 988
struct request_queue *blk_alloc_queue_node(gfp_t gfp_mask, int node_id,
					   spinlock_t *lock)
989
{
990
	struct request_queue *q;
991
	int ret;
992

993
	q = kmem_cache_alloc_node(blk_requestq_cachep,
994
				gfp_mask | __GFP_ZERO, node_id);
L
Linus Torvalds 已提交
995 996 997
	if (!q)
		return NULL;

998 999 1000 1001 1002
	INIT_LIST_HEAD(&q->queue_head);
	q->last_merge = NULL;
	q->end_sector = 0;
	q->boundary_rq = NULL;

1003
	q->id = ida_simple_get(&blk_queue_ida, 0, 0, gfp_mask);
1004
	if (q->id < 0)
1005
		goto fail_q;
1006

1007 1008
	ret = bioset_init(&q->bio_split, BIO_POOL_SIZE, 0, BIOSET_NEED_BVECS);
	if (ret)
1009 1010
		goto fail_id;

1011 1012 1013 1014
	q->backing_dev_info = bdi_alloc_node(gfp_mask, node_id);
	if (!q->backing_dev_info)
		goto fail_split;

1015 1016 1017 1018
	q->stats = blk_alloc_queue_stats();
	if (!q->stats)
		goto fail_stats;

1019
	q->backing_dev_info->ra_pages =
1020
			(VM_MAX_READAHEAD * 1024) / PAGE_SIZE;
1021 1022
	q->backing_dev_info->capabilities = BDI_CAP_CGROUP_WRITEBACK;
	q->backing_dev_info->name = "block";
1023
	q->node = node_id;
1024

1025 1026 1027
	timer_setup(&q->backing_dev_info->laptop_mode_wb_timer,
		    laptop_mode_timer_fn, 0);
	timer_setup(&q->timeout, blk_rq_timed_out_timer, 0);
1028
	INIT_WORK(&q->timeout_work, NULL);
1029
	INIT_LIST_HEAD(&q->queue_head);
J
Jens Axboe 已提交
1030
	INIT_LIST_HEAD(&q->timeout_list);
1031
	INIT_LIST_HEAD(&q->icq_list);
1032
#ifdef CONFIG_BLK_CGROUP
1033
	INIT_LIST_HEAD(&q->blkg_list);
1034
#endif
1035
	INIT_DELAYED_WORK(&q->delay_work, blk_delay_work);
1036

1037
	kobject_init(&q->kobj, &blk_queue_ktype);
L
Linus Torvalds 已提交
1038

1039 1040 1041
#ifdef CONFIG_BLK_DEV_IO_TRACE
	mutex_init(&q->blk_trace_mutex);
#endif
1042
	mutex_init(&q->sysfs_lock);
1043
	spin_lock_init(&q->__queue_lock);
1044

1045 1046
	if (!q->mq_ops)
		q->queue_lock = lock ? : &q->__queue_lock;
1047

1048 1049 1050
	/*
	 * A queue starts its life with bypass turned on to avoid
	 * unnecessary bypass on/off overhead and nasty surprises during
1051 1052
	 * init.  The initial bypass will be finished when the queue is
	 * registered by blk_register_queue().
1053 1054
	 */
	q->bypass_depth = 1;
1055
	queue_flag_set_unlocked(QUEUE_FLAG_BYPASS, q);
1056

1057 1058
	init_waitqueue_head(&q->mq_freeze_wq);

1059 1060 1061 1062 1063 1064 1065
	/*
	 * Init percpu_ref in atomic mode so that it's faster to shutdown.
	 * See blk_register_queue() for details.
	 */
	if (percpu_ref_init(&q->q_usage_counter,
				blk_queue_usage_counter_release,
				PERCPU_REF_INIT_ATOMIC, GFP_KERNEL))
1066
		goto fail_bdi;
1067

1068 1069 1070
	if (blkcg_init_queue(q))
		goto fail_ref;

L
Linus Torvalds 已提交
1071
	return q;
1072

1073 1074
fail_ref:
	percpu_ref_exit(&q->q_usage_counter);
1075
fail_bdi:
1076 1077
	blk_free_queue_stats(q->stats);
fail_stats:
1078
	bdi_put(q->backing_dev_info);
1079
fail_split:
1080
	bioset_exit(&q->bio_split);
1081 1082 1083 1084 1085
fail_id:
	ida_simple_remove(&blk_queue_ida, q->id);
fail_q:
	kmem_cache_free(blk_requestq_cachep, q);
	return NULL;
L
Linus Torvalds 已提交
1086
}
1087
EXPORT_SYMBOL(blk_alloc_queue_node);
L
Linus Torvalds 已提交
1088 1089 1090 1091 1092 1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110

/**
 * blk_init_queue  - prepare a request queue for use with a block device
 * @rfn:  The function to be called to process requests that have been
 *        placed on the queue.
 * @lock: Request queue spin lock
 *
 * Description:
 *    If a block device wishes to use the standard request handling procedures,
 *    which sorts requests and coalesces adjacent requests, then it must
 *    call blk_init_queue().  The function @rfn will be called when there
 *    are requests on the queue that need to be processed.  If the device
 *    supports plugging, then @rfn may not be called immediately when requests
 *    are available on the queue, but may be called at some time later instead.
 *    Plugged queues are generally unplugged when a buffer belonging to one
 *    of the requests on the queue is needed, or due to memory pressure.
 *
 *    @rfn is not required, or even expected, to remove all requests off the
 *    queue, but only as many as it can handle at a time.  If it does leave
 *    requests on the queue, it is responsible for arranging that the requests
 *    get dealt with eventually.
 *
 *    The queue spin lock must be held while manipulating the requests on the
1111 1112
 *    request queue; this lock will be taken also from interrupt context, so irq
 *    disabling is needed for it.
L
Linus Torvalds 已提交
1113
 *
1114
 *    Function returns a pointer to the initialized request queue, or %NULL if
L
Linus Torvalds 已提交
1115 1116 1117 1118 1119 1120
 *    it didn't succeed.
 *
 * Note:
 *    blk_init_queue() must be paired with a blk_cleanup_queue() call
 *    when the block device is deactivated (such as at module unload).
 **/
1121

1122
struct request_queue *blk_init_queue(request_fn_proc *rfn, spinlock_t *lock)
L
Linus Torvalds 已提交
1123
{
1124
	return blk_init_queue_node(rfn, lock, NUMA_NO_NODE);
1125 1126 1127
}
EXPORT_SYMBOL(blk_init_queue);

1128
struct request_queue *
1129 1130
blk_init_queue_node(request_fn_proc *rfn, spinlock_t *lock, int node_id)
{
1131
	struct request_queue *q;
L
Linus Torvalds 已提交
1132

1133
	q = blk_alloc_queue_node(GFP_KERNEL, node_id, lock);
1134
	if (!q)
1135 1136
		return NULL;

1137 1138 1139 1140 1141
	q->request_fn = rfn;
	if (blk_init_allocated_queue(q) < 0) {
		blk_cleanup_queue(q);
		return NULL;
	}
1142

1143
	return q;
1144 1145 1146
}
EXPORT_SYMBOL(blk_init_queue_node);

1147
static blk_qc_t blk_queue_bio(struct request_queue *q, struct bio *bio);
1148

L
Linus Torvalds 已提交
1149

1150 1151
int blk_init_allocated_queue(struct request_queue *q)
{
1152 1153
	WARN_ON_ONCE(q->mq_ops);

1154
	q->fq = blk_alloc_flush_queue(q, NUMA_NO_NODE, q->cmd_size);
1155
	if (!q->fq)
1156
		return -ENOMEM;
1157

1158 1159
	if (q->init_rq_fn && q->init_rq_fn(q, q->fq->flush_rq, GFP_KERNEL))
		goto out_free_flush_queue;
1160

1161
	if (blk_init_rl(&q->root_rl, q, GFP_KERNEL))
1162
		goto out_exit_flush_rq;
L
Linus Torvalds 已提交
1163

1164
	INIT_WORK(&q->timeout_work, blk_timeout_work);
1165
	q->queue_flags		|= QUEUE_FLAG_DEFAULT;
1166

1167 1168 1169
	/*
	 * This also sets hw/phys segments, boundary and size
	 */
1170
	blk_queue_make_request(q, blk_queue_bio);
L
Linus Torvalds 已提交
1171

1172 1173
	q->sg_reserved_size = INT_MAX;

1174
	if (elevator_init(q))
1175
		goto out_exit_flush_rq;
1176
	return 0;
1177

1178 1179 1180 1181
out_exit_flush_rq:
	if (q->exit_rq_fn)
		q->exit_rq_fn(q, q->fq->flush_rq);
out_free_flush_queue:
1182
	blk_free_flush_queue(q->fq);
1183
	return -ENOMEM;
L
Linus Torvalds 已提交
1184
}
1185
EXPORT_SYMBOL(blk_init_allocated_queue);
L
Linus Torvalds 已提交
1186

T
Tejun Heo 已提交
1187
bool blk_get_queue(struct request_queue *q)
L
Linus Torvalds 已提交
1188
{
B
Bart Van Assche 已提交
1189
	if (likely(!blk_queue_dying(q))) {
T
Tejun Heo 已提交
1190 1191
		__blk_get_queue(q);
		return true;
L
Linus Torvalds 已提交
1192 1193
	}

T
Tejun Heo 已提交
1194
	return false;
L
Linus Torvalds 已提交
1195
}
J
Jens Axboe 已提交
1196
EXPORT_SYMBOL(blk_get_queue);
L
Linus Torvalds 已提交
1197

1198
static inline void blk_free_request(struct request_list *rl, struct request *rq)
L
Linus Torvalds 已提交
1199
{
1200
	if (rq->rq_flags & RQF_ELVPRIV) {
1201
		elv_put_request(rl->q, rq);
1202
		if (rq->elv.icq)
1203
			put_io_context(rq->elv.icq->ioc);
1204 1205
	}

1206
	mempool_free(rq, rl->rq_pool);
L
Linus Torvalds 已提交
1207 1208 1209 1210 1211 1212
}

/*
 * ioc_batching returns true if the ioc is a valid batching request and
 * should be given priority access to a request.
 */
1213
static inline int ioc_batching(struct request_queue *q, struct io_context *ioc)
L
Linus Torvalds 已提交
1214 1215 1216 1217 1218 1219 1220 1221 1222 1223 1224 1225 1226 1227 1228 1229 1230 1231 1232 1233
{
	if (!ioc)
		return 0;

	/*
	 * Make sure the process is able to allocate at least 1 request
	 * even if the batch times out, otherwise we could theoretically
	 * lose wakeups.
	 */
	return ioc->nr_batch_requests == q->nr_batching ||
		(ioc->nr_batch_requests > 0
		&& time_before(jiffies, ioc->last_waited + BLK_BATCH_TIME));
}

/*
 * ioc_set_batching sets ioc to be a new "batcher" if it is not one. This
 * will cause the process to be a "batcher" on all queues in the system. This
 * is the behaviour we want though - once it gets a wakeup it should be given
 * a nice run.
 */
1234
static void ioc_set_batching(struct request_queue *q, struct io_context *ioc)
L
Linus Torvalds 已提交
1235 1236 1237 1238 1239 1240 1241 1242
{
	if (!ioc || ioc_batching(q, ioc))
		return;

	ioc->nr_batch_requests = q->nr_batching;
	ioc->last_waited = jiffies;
}

1243
static void __freed_request(struct request_list *rl, int sync)
L
Linus Torvalds 已提交
1244
{
1245
	struct request_queue *q = rl->q;
L
Linus Torvalds 已提交
1246

1247 1248
	if (rl->count[sync] < queue_congestion_off_threshold(q))
		blk_clear_congested(rl, sync);
L
Linus Torvalds 已提交
1249

1250 1251 1252
	if (rl->count[sync] + 1 <= q->nr_requests) {
		if (waitqueue_active(&rl->wait[sync]))
			wake_up(&rl->wait[sync]);
L
Linus Torvalds 已提交
1253

1254
		blk_clear_rl_full(rl, sync);
L
Linus Torvalds 已提交
1255 1256 1257 1258 1259 1260 1261
	}
}

/*
 * A request has just been released.  Account for it, update the full and
 * congestion status, wake up any waiters.   Called under q->queue_lock.
 */
1262 1263
static void freed_request(struct request_list *rl, bool sync,
		req_flags_t rq_flags)
L
Linus Torvalds 已提交
1264
{
1265
	struct request_queue *q = rl->q;
L
Linus Torvalds 已提交
1266

1267
	q->nr_rqs[sync]--;
1268
	rl->count[sync]--;
1269
	if (rq_flags & RQF_ELVPRIV)
1270
		q->nr_rqs_elvpriv--;
L
Linus Torvalds 已提交
1271

1272
	__freed_request(rl, sync);
L
Linus Torvalds 已提交
1273

1274
	if (unlikely(rl->starved[sync ^ 1]))
1275
		__freed_request(rl, sync ^ 1);
L
Linus Torvalds 已提交
1276 1277
}

1278 1279 1280
int blk_update_nr_requests(struct request_queue *q, unsigned int nr)
{
	struct request_list *rl;
1281
	int on_thresh, off_thresh;
1282

1283 1284
	WARN_ON_ONCE(q->mq_ops);

1285 1286 1287
	spin_lock_irq(q->queue_lock);
	q->nr_requests = nr;
	blk_queue_congestion_threshold(q);
1288 1289
	on_thresh = queue_congestion_on_threshold(q);
	off_thresh = queue_congestion_off_threshold(q);
1290

1291 1292 1293 1294 1295
	blk_queue_for_each_rl(rl, q) {
		if (rl->count[BLK_RW_SYNC] >= on_thresh)
			blk_set_congested(rl, BLK_RW_SYNC);
		else if (rl->count[BLK_RW_SYNC] < off_thresh)
			blk_clear_congested(rl, BLK_RW_SYNC);
1296

1297 1298 1299 1300
		if (rl->count[BLK_RW_ASYNC] >= on_thresh)
			blk_set_congested(rl, BLK_RW_ASYNC);
		else if (rl->count[BLK_RW_ASYNC] < off_thresh)
			blk_clear_congested(rl, BLK_RW_ASYNC);
1301 1302 1303 1304 1305 1306 1307 1308 1309 1310 1311 1312 1313 1314 1315 1316 1317 1318 1319 1320

		if (rl->count[BLK_RW_SYNC] >= q->nr_requests) {
			blk_set_rl_full(rl, BLK_RW_SYNC);
		} else {
			blk_clear_rl_full(rl, BLK_RW_SYNC);
			wake_up(&rl->wait[BLK_RW_SYNC]);
		}

		if (rl->count[BLK_RW_ASYNC] >= q->nr_requests) {
			blk_set_rl_full(rl, BLK_RW_ASYNC);
		} else {
			blk_clear_rl_full(rl, BLK_RW_ASYNC);
			wake_up(&rl->wait[BLK_RW_ASYNC]);
		}
	}

	spin_unlock_irq(q->queue_lock);
	return 0;
}

1321
/**
T
Tejun Heo 已提交
1322
 * __get_request - get a free request
1323
 * @rl: request list to allocate from
1324
 * @op: operation and flags
1325
 * @bio: bio to allocate request for (can be %NULL)
1326
 * @flags: BLQ_MQ_REQ_* flags
1327
 * @gfp_mask: allocator flags
1328 1329 1330 1331
 *
 * Get a free request from @q.  This function may fail under memory
 * pressure or if @q is dead.
 *
1332
 * Must be called with @q->queue_lock held and,
1333 1334
 * Returns ERR_PTR on failure, with @q->queue_lock held.
 * Returns request pointer on success, with @q->queue_lock *not held*.
L
Linus Torvalds 已提交
1335
 */
1336
static struct request *__get_request(struct request_list *rl, unsigned int op,
1337
		struct bio *bio, blk_mq_req_flags_t flags, gfp_t gfp_mask)
L
Linus Torvalds 已提交
1338
{
1339
	struct request_queue *q = rl->q;
T
Tejun Heo 已提交
1340
	struct request *rq;
T
Tejun Heo 已提交
1341 1342
	struct elevator_type *et = q->elevator->type;
	struct io_context *ioc = rq_ioc(bio);
1343
	struct io_cq *icq = NULL;
1344
	const bool is_sync = op_is_sync(op);
1345
	int may_queue;
1346
	req_flags_t rq_flags = RQF_ALLOCED;
1347

1348 1349
	lockdep_assert_held(q->queue_lock);

B
Bart Van Assche 已提交
1350
	if (unlikely(blk_queue_dying(q)))
1351
		return ERR_PTR(-ENODEV);
1352

1353
	may_queue = elv_may_queue(q, op);
1354 1355 1356
	if (may_queue == ELV_MQUEUE_NO)
		goto rq_starved;

1357 1358
	if (rl->count[is_sync]+1 >= queue_congestion_on_threshold(q)) {
		if (rl->count[is_sync]+1 >= q->nr_requests) {
1359 1360 1361 1362 1363 1364
			/*
			 * The queue will fill after this allocation, so set
			 * it as full, and mark this process as "batching".
			 * This process will be allowed to complete a batch of
			 * requests, others will be blocked.
			 */
1365
			if (!blk_rl_full(rl, is_sync)) {
1366
				ioc_set_batching(q, ioc);
1367
				blk_set_rl_full(rl, is_sync);
1368 1369 1370 1371 1372 1373 1374 1375
			} else {
				if (may_queue != ELV_MQUEUE_MUST
						&& !ioc_batching(q, ioc)) {
					/*
					 * The queue is full and the allocating
					 * process is not a "batcher", and not
					 * exempted by the IO scheduler
					 */
1376
					return ERR_PTR(-ENOMEM);
1377 1378
				}
			}
L
Linus Torvalds 已提交
1379
		}
1380
		blk_set_congested(rl, is_sync);
L
Linus Torvalds 已提交
1381 1382
	}

1383 1384 1385 1386 1387
	/*
	 * Only allow batching queuers to allocate up to 50% over the defined
	 * limit of requests, otherwise we could have thousands of requests
	 * allocated with any setting of ->nr_requests
	 */
1388
	if (rl->count[is_sync] >= (3 * q->nr_requests / 2))
1389
		return ERR_PTR(-ENOMEM);
H
Hugh Dickins 已提交
1390

1391
	q->nr_rqs[is_sync]++;
1392 1393
	rl->count[is_sync]++;
	rl->starved[is_sync] = 0;
T
Tejun Heo 已提交
1394

1395 1396
	/*
	 * Decide whether the new request will be managed by elevator.  If
1397
	 * so, mark @rq_flags and increment elvpriv.  Non-zero elvpriv will
1398 1399 1400 1401
	 * prevent the current elevator from being destroyed until the new
	 * request is freed.  This guarantees icq's won't be destroyed and
	 * makes creating new ones safe.
	 *
1402 1403 1404
	 * Flush requests do not use the elevator so skip initialization.
	 * This allows a request to share the flush and elevator data.
	 *
1405 1406 1407
	 * Also, lookup icq while holding queue_lock.  If it doesn't exist,
	 * it will be created after releasing queue_lock.
	 */
1408
	if (!op_is_flush(op) && !blk_queue_bypass(q)) {
1409
		rq_flags |= RQF_ELVPRIV;
1410
		q->nr_rqs_elvpriv++;
1411 1412
		if (et->icq_cache && ioc)
			icq = ioc_lookup_icq(ioc, q);
1413
	}
T
Tejun Heo 已提交
1414

1415
	if (blk_queue_io_stat(q))
1416
		rq_flags |= RQF_IO_STAT;
L
Linus Torvalds 已提交
1417 1418
	spin_unlock_irq(q->queue_lock);

1419
	/* allocate and init request */
1420
	rq = mempool_alloc(rl->rq_pool, gfp_mask);
1421
	if (!rq)
T
Tejun Heo 已提交
1422
		goto fail_alloc;
L
Linus Torvalds 已提交
1423

1424
	blk_rq_init(q, rq);
1425
	blk_rq_set_rl(rq, rl);
1426
	rq->cmd_flags = op;
1427
	rq->rq_flags = rq_flags;
1428 1429
	if (flags & BLK_MQ_REQ_PREEMPT)
		rq->rq_flags |= RQF_PREEMPT;
1430

1431
	/* init elvpriv */
1432
	if (rq_flags & RQF_ELVPRIV) {
1433
		if (unlikely(et->icq_cache && !icq)) {
T
Tejun Heo 已提交
1434 1435
			if (ioc)
				icq = ioc_create_icq(ioc, q, gfp_mask);
1436 1437
			if (!icq)
				goto fail_elvpriv;
1438
		}
1439 1440 1441 1442 1443 1444

		rq->elv.icq = icq;
		if (unlikely(elv_set_request(q, rq, bio, gfp_mask)))
			goto fail_elvpriv;

		/* @rq->elv.icq holds io_context until @rq is freed */
1445 1446 1447
		if (icq)
			get_io_context(icq->ioc);
	}
1448
out:
1449 1450 1451 1452 1453 1454
	/*
	 * ioc may be NULL here, and ioc_batching will be false. That's
	 * OK, if the queue is under the request limit then requests need
	 * not count toward the nr_batch_requests limit. There will always
	 * be some limit enforced by BLK_BATCH_TIME.
	 */
L
Linus Torvalds 已提交
1455 1456
	if (ioc_batching(q, ioc))
		ioc->nr_batch_requests--;
1457

1458
	trace_block_getrq(q, bio, op);
L
Linus Torvalds 已提交
1459
	return rq;
T
Tejun Heo 已提交
1460

1461 1462 1463 1464 1465 1466 1467
fail_elvpriv:
	/*
	 * elvpriv init failed.  ioc, icq and elvpriv aren't mempool backed
	 * and may fail indefinitely under memory pressure and thus
	 * shouldn't stall IO.  Treat this request as !elvpriv.  This will
	 * disturb iosched and blkcg but weird is bettern than dead.
	 */
1468
	printk_ratelimited(KERN_WARNING "%s: dev %s: request aux data allocation failed, iosched may be disturbed\n",
1469
			   __func__, dev_name(q->backing_dev_info->dev));
1470

1471
	rq->rq_flags &= ~RQF_ELVPRIV;
1472 1473 1474
	rq->elv.icq = NULL;

	spin_lock_irq(q->queue_lock);
1475
	q->nr_rqs_elvpriv--;
1476 1477 1478
	spin_unlock_irq(q->queue_lock);
	goto out;

T
Tejun Heo 已提交
1479 1480 1481 1482 1483 1484 1485 1486 1487
fail_alloc:
	/*
	 * Allocation failed presumably due to memory. Undo anything we
	 * might have messed up.
	 *
	 * Allocating task should really be put onto the front of the wait
	 * queue, but this is pretty rare.
	 */
	spin_lock_irq(q->queue_lock);
1488
	freed_request(rl, is_sync, rq_flags);
T
Tejun Heo 已提交
1489 1490 1491 1492 1493 1494 1495 1496 1497 1498 1499

	/*
	 * in the very unlikely event that allocation failed and no
	 * requests for this direction was pending, mark us starved so that
	 * freeing of a request in the other direction will notice
	 * us. another possible fix would be to split the rq mempool into
	 * READ and WRITE
	 */
rq_starved:
	if (unlikely(rl->count[is_sync] == 0))
		rl->starved[is_sync] = 1;
1500
	return ERR_PTR(-ENOMEM);
L
Linus Torvalds 已提交
1501 1502
}

1503
/**
T
Tejun Heo 已提交
1504
 * get_request - get a free request
1505
 * @q: request_queue to allocate request from
1506
 * @op: operation and flags
1507
 * @bio: bio to allocate request for (can be %NULL)
1508
 * @flags: BLK_MQ_REQ_* flags.
1509
 * @gfp: allocator flags
1510
 *
1511
 * Get a free request from @q.  If %BLK_MQ_REQ_NOWAIT is set in @flags,
1512
 * this function keeps retrying under memory pressure and fails iff @q is dead.
N
Nick Piggin 已提交
1513
 *
1514
 * Must be called with @q->queue_lock held and,
1515 1516
 * Returns ERR_PTR on failure, with @q->queue_lock held.
 * Returns request pointer on success, with @q->queue_lock *not held*.
L
Linus Torvalds 已提交
1517
 */
1518
static struct request *get_request(struct request_queue *q, unsigned int op,
1519
		struct bio *bio, blk_mq_req_flags_t flags, gfp_t gfp)
L
Linus Torvalds 已提交
1520
{
1521
	const bool is_sync = op_is_sync(op);
T
Tejun Heo 已提交
1522
	DEFINE_WAIT(wait);
1523
	struct request_list *rl;
L
Linus Torvalds 已提交
1524
	struct request *rq;
1525

1526
	lockdep_assert_held(q->queue_lock);
1527
	WARN_ON_ONCE(q->mq_ops);
1528

1529
	rl = blk_get_rl(q, bio);	/* transferred to @rq on success */
T
Tejun Heo 已提交
1530
retry:
1531
	rq = __get_request(rl, op, bio, flags, gfp);
1532
	if (!IS_ERR(rq))
T
Tejun Heo 已提交
1533
		return rq;
L
Linus Torvalds 已提交
1534

1535 1536 1537 1538 1539
	if (op & REQ_NOWAIT) {
		blk_put_rl(rl);
		return ERR_PTR(-EAGAIN);
	}

1540
	if ((flags & BLK_MQ_REQ_NOWAIT) || unlikely(blk_queue_dying(q))) {
1541
		blk_put_rl(rl);
1542
		return rq;
1543
	}
L
Linus Torvalds 已提交
1544

T
Tejun Heo 已提交
1545 1546 1547
	/* wait on @rl and retry */
	prepare_to_wait_exclusive(&rl->wait[is_sync], &wait,
				  TASK_UNINTERRUPTIBLE);
L
Linus Torvalds 已提交
1548

1549
	trace_block_sleeprq(q, bio, op);
L
Linus Torvalds 已提交
1550

T
Tejun Heo 已提交
1551 1552
	spin_unlock_irq(q->queue_lock);
	io_schedule();
N
Nick Piggin 已提交
1553

T
Tejun Heo 已提交
1554 1555 1556 1557 1558 1559
	/*
	 * After sleeping, we become a "batching" process and will be able
	 * to allocate at least one request, and up to a big batch of them
	 * for a small period time.  See ioc_batching, ioc_set_batching
	 */
	ioc_set_batching(q, current->io_context);
1560

T
Tejun Heo 已提交
1561 1562
	spin_lock_irq(q->queue_lock);
	finish_wait(&rl->wait[is_sync], &wait);
L
Linus Torvalds 已提交
1563

T
Tejun Heo 已提交
1564
	goto retry;
L
Linus Torvalds 已提交
1565 1566
}

1567
/* flags: BLK_MQ_REQ_PREEMPT and/or BLK_MQ_REQ_NOWAIT. */
1568
static struct request *blk_old_get_request(struct request_queue *q,
1569
				unsigned int op, blk_mq_req_flags_t flags)
L
Linus Torvalds 已提交
1570 1571
{
	struct request *rq;
1572
	gfp_t gfp_mask = flags & BLK_MQ_REQ_NOWAIT ? GFP_ATOMIC : GFP_NOIO;
1573
	int ret = 0;
L
Linus Torvalds 已提交
1574

1575 1576
	WARN_ON_ONCE(q->mq_ops);

T
Tejun Heo 已提交
1577 1578 1579
	/* create ioc upfront */
	create_io_context(gfp_mask, q->node);

1580
	ret = blk_queue_enter(q, flags);
1581 1582
	if (ret)
		return ERR_PTR(ret);
N
Nick Piggin 已提交
1583
	spin_lock_irq(q->queue_lock);
1584
	rq = get_request(q, op, NULL, flags, gfp_mask);
1585
	if (IS_ERR(rq)) {
1586
		spin_unlock_irq(q->queue_lock);
1587
		blk_queue_exit(q);
1588 1589
		return rq;
	}
L
Linus Torvalds 已提交
1590

1591 1592 1593 1594
	/* q->queue_lock is unlocked at this point */
	rq->__data_len = 0;
	rq->__sector = (sector_t) -1;
	rq->bio = rq->biotail = NULL;
L
Linus Torvalds 已提交
1595 1596
	return rq;
}
1597

1598
/**
1599
 * blk_get_request - allocate a request
1600 1601 1602 1603
 * @q: request queue to allocate a request for
 * @op: operation (REQ_OP_*) and REQ_* flags, e.g. REQ_SYNC.
 * @flags: BLK_MQ_REQ_* flags, e.g. BLK_MQ_REQ_NOWAIT.
 */
1604 1605
struct request *blk_get_request(struct request_queue *q, unsigned int op,
				blk_mq_req_flags_t flags)
1606
{
1607 1608
	struct request *req;

1609
	WARN_ON_ONCE(op & REQ_NOWAIT);
1610
	WARN_ON_ONCE(flags & ~(BLK_MQ_REQ_NOWAIT | BLK_MQ_REQ_PREEMPT));
1611

1612
	if (q->mq_ops) {
1613
		req = blk_mq_alloc_request(q, op, flags);
1614 1615 1616
		if (!IS_ERR(req) && q->mq_ops->initialize_rq_fn)
			q->mq_ops->initialize_rq_fn(req);
	} else {
1617
		req = blk_old_get_request(q, op, flags);
1618 1619 1620 1621 1622
		if (!IS_ERR(req) && q->initialize_rq_fn)
			q->initialize_rq_fn(req);
	}

	return req;
1623
}
L
Linus Torvalds 已提交
1624 1625 1626 1627 1628 1629 1630 1631 1632 1633 1634 1635
EXPORT_SYMBOL(blk_get_request);

/**
 * blk_requeue_request - put a request back on queue
 * @q:		request queue where request should be inserted
 * @rq:		request to be inserted
 *
 * Description:
 *    Drivers often keep queueing requests until the hardware cannot accept
 *    more, when that condition happens we need to put the request back
 *    on the queue. Must be called with queue lock held.
 */
1636
void blk_requeue_request(struct request_queue *q, struct request *rq)
L
Linus Torvalds 已提交
1637
{
1638
	lockdep_assert_held(q->queue_lock);
1639
	WARN_ON_ONCE(q->mq_ops);
1640

J
Jens Axboe 已提交
1641 1642
	blk_delete_timer(rq);
	blk_clear_rq_complete(rq);
1643
	trace_block_rq_requeue(q, rq);
1644
	wbt_requeue(q->rq_wb, rq);
1645

1646
	if (rq->rq_flags & RQF_QUEUED)
L
Linus Torvalds 已提交
1647 1648
		blk_queue_end_tag(q, rq);

1649 1650
	BUG_ON(blk_queued_rq(rq));

L
Linus Torvalds 已提交
1651 1652 1653 1654
	elv_requeue_request(q, rq);
}
EXPORT_SYMBOL(blk_requeue_request);

1655 1656 1657
static void add_acct_request(struct request_queue *q, struct request *rq,
			     int where)
{
1658
	blk_account_io_start(rq, true);
J
Jens Axboe 已提交
1659
	__elv_add_request(q, rq, where);
1660 1661
}

1662
static void part_round_stats_single(struct request_queue *q, int cpu,
1663 1664
				    struct hd_struct *part, unsigned long now,
				    unsigned int inflight)
T
Tejun Heo 已提交
1665
{
1666
	if (inflight) {
T
Tejun Heo 已提交
1667
		__part_stat_add(cpu, part, time_in_queue,
1668
				inflight * (now - part->stamp));
T
Tejun Heo 已提交
1669 1670 1671 1672 1673 1674
		__part_stat_add(cpu, part, io_ticks, (now - part->stamp));
	}
	part->stamp = now;
}

/**
1675
 * part_round_stats() - Round off the performance stats on a struct disk_stats.
1676
 * @q: target block queue
1677 1678
 * @cpu: cpu number for stats access
 * @part: target partition
L
Linus Torvalds 已提交
1679 1680 1681 1682 1683 1684 1685 1686 1687 1688 1689 1690
 *
 * The average IO queue length and utilisation statistics are maintained
 * by observing the current state of the queue length and the amount of
 * time it has been in this state for.
 *
 * Normally, that accounting is done on IO completion, but that can result
 * in more than a second's worth of IO being accounted for within any one
 * second, leading to >100% utilisation.  To deal with that, we call this
 * function to do a round-off before returning the results when reading
 * /proc/diskstats.  This accounts immediately for all queue usage up to
 * the current jiffies and restarts the counters again.
 */
1691
void part_round_stats(struct request_queue *q, int cpu, struct hd_struct *part)
1692
{
1693
	struct hd_struct *part2 = NULL;
1694
	unsigned long now = jiffies;
1695 1696 1697 1698 1699 1700 1701 1702 1703 1704 1705 1706 1707 1708 1709 1710
	unsigned int inflight[2];
	int stats = 0;

	if (part->stamp != now)
		stats |= 1;

	if (part->partno) {
		part2 = &part_to_disk(part)->part0;
		if (part2->stamp != now)
			stats |= 2;
	}

	if (!stats)
		return;

	part_in_flight(q, part, inflight);
1711

1712 1713 1714 1715
	if (stats & 2)
		part_round_stats_single(q, cpu, part2, now, inflight[1]);
	if (stats & 1)
		part_round_stats_single(q, cpu, part, now, inflight[0]);
1716
}
T
Tejun Heo 已提交
1717
EXPORT_SYMBOL_GPL(part_round_stats);
1718

1719
#ifdef CONFIG_PM
L
Lin Ming 已提交
1720 1721
static void blk_pm_put_request(struct request *rq)
{
1722
	if (rq->q->dev && !(rq->rq_flags & RQF_PM) && !--rq->q->nr_pending)
L
Lin Ming 已提交
1723 1724 1725 1726 1727 1728
		pm_runtime_mark_last_busy(rq->q->dev);
}
#else
static inline void blk_pm_put_request(struct request *rq) {}
#endif

1729
void __blk_put_request(struct request_queue *q, struct request *req)
L
Linus Torvalds 已提交
1730
{
1731 1732
	req_flags_t rq_flags = req->rq_flags;

L
Linus Torvalds 已提交
1733 1734 1735
	if (unlikely(!q))
		return;

1736 1737 1738 1739 1740
	if (q->mq_ops) {
		blk_mq_free_request(req);
		return;
	}

1741 1742
	lockdep_assert_held(q->queue_lock);

1743
	blk_req_zone_write_unlock(req);
L
Lin Ming 已提交
1744 1745
	blk_pm_put_request(req);

1746 1747
	elv_completed_request(q, req);

1748 1749 1750
	/* this is a bio leak */
	WARN_ON(req->bio != NULL);

1751
	wbt_done(q->rq_wb, req);
J
Jens Axboe 已提交
1752

L
Linus Torvalds 已提交
1753 1754 1755 1756
	/*
	 * Request may not have originated from ll_rw_blk. if not,
	 * it didn't come out of our reserved rq pools
	 */
1757
	if (rq_flags & RQF_ALLOCED) {
1758
		struct request_list *rl = blk_rq_rl(req);
1759
		bool sync = op_is_sync(req->cmd_flags);
L
Linus Torvalds 已提交
1760 1761

		BUG_ON(!list_empty(&req->queuelist));
1762
		BUG_ON(ELV_ON_HASH(req));
L
Linus Torvalds 已提交
1763

1764
		blk_free_request(rl, req);
1765
		freed_request(rl, sync, rq_flags);
1766
		blk_put_rl(rl);
1767
		blk_queue_exit(q);
L
Linus Torvalds 已提交
1768 1769
	}
}
1770 1771
EXPORT_SYMBOL_GPL(__blk_put_request);

L
Linus Torvalds 已提交
1772 1773
void blk_put_request(struct request *req)
{
1774
	struct request_queue *q = req->q;
1775

1776 1777 1778 1779 1780 1781 1782 1783 1784
	if (q->mq_ops)
		blk_mq_free_request(req);
	else {
		unsigned long flags;

		spin_lock_irqsave(q->queue_lock, flags);
		__blk_put_request(q, req);
		spin_unlock_irqrestore(q->queue_lock, flags);
	}
L
Linus Torvalds 已提交
1785 1786 1787
}
EXPORT_SYMBOL(blk_put_request);

1788 1789
bool bio_attempt_back_merge(struct request_queue *q, struct request *req,
			    struct bio *bio)
1790
{
J
Jens Axboe 已提交
1791
	const int ff = bio->bi_opf & REQ_FAILFAST_MASK;
1792 1793 1794 1795

	if (!ll_back_merge_fn(q, req, bio))
		return false;

1796
	trace_block_bio_backmerge(q, req, bio);
1797 1798 1799 1800 1801 1802

	if ((req->cmd_flags & REQ_FAILFAST_MASK) != ff)
		blk_rq_set_mixed_merge(req);

	req->biotail->bi_next = bio;
	req->biotail = bio;
1803
	req->__data_len += bio->bi_iter.bi_size;
1804 1805
	req->ioprio = ioprio_best(req->ioprio, bio_prio(bio));

1806
	blk_account_io_start(req, false);
1807 1808 1809
	return true;
}

1810 1811
bool bio_attempt_front_merge(struct request_queue *q, struct request *req,
			     struct bio *bio)
1812
{
J
Jens Axboe 已提交
1813
	const int ff = bio->bi_opf & REQ_FAILFAST_MASK;
1814 1815 1816 1817

	if (!ll_front_merge_fn(q, req, bio))
		return false;

1818
	trace_block_bio_frontmerge(q, req, bio);
1819 1820 1821 1822 1823 1824 1825

	if ((req->cmd_flags & REQ_FAILFAST_MASK) != ff)
		blk_rq_set_mixed_merge(req);

	bio->bi_next = req->bio;
	req->bio = bio;

1826 1827
	req->__sector = bio->bi_iter.bi_sector;
	req->__data_len += bio->bi_iter.bi_size;
1828 1829
	req->ioprio = ioprio_best(req->ioprio, bio_prio(bio));

1830
	blk_account_io_start(req, false);
1831 1832 1833
	return true;
}

1834 1835 1836 1837 1838 1839 1840 1841 1842 1843 1844 1845 1846 1847 1848 1849 1850 1851 1852 1853 1854 1855 1856 1857
bool bio_attempt_discard_merge(struct request_queue *q, struct request *req,
		struct bio *bio)
{
	unsigned short segments = blk_rq_nr_discard_segments(req);

	if (segments >= queue_max_discard_segments(q))
		goto no_merge;
	if (blk_rq_sectors(req) + bio_sectors(bio) >
	    blk_rq_get_max_sectors(req, blk_rq_pos(req)))
		goto no_merge;

	req->biotail->bi_next = bio;
	req->biotail = bio;
	req->__data_len += bio->bi_iter.bi_size;
	req->ioprio = ioprio_best(req->ioprio, bio_prio(bio));
	req->nr_phys_segments = segments + 1;

	blk_account_io_start(req, false);
	return true;
no_merge:
	req_set_nomerge(q, req);
	return false;
}

1858
/**
1859
 * blk_attempt_plug_merge - try to merge with %current's plugged list
1860 1861 1862
 * @q: request_queue new bio is being queued at
 * @bio: new bio being queued
 * @request_count: out parameter for number of traversed plugged requests
1863 1864 1865
 * @same_queue_rq: pointer to &struct request that gets filled in when
 * another request associated with @q is found on the plug list
 * (optional, may be %NULL)
1866 1867 1868 1869 1870
 *
 * Determine whether @bio being queued on @q can be merged with a request
 * on %current's plugged list.  Returns %true if merge was successful,
 * otherwise %false.
 *
1871 1872 1873 1874 1875 1876
 * Plugging coalesces IOs from the same issuer for the same purpose without
 * going through @q->queue_lock.  As such it's more of an issuing mechanism
 * than scheduling, and the request, while may have elvpriv data, is not
 * added on the elevator at this point.  In addition, we don't have
 * reliable access to the elevator outside queue lock.  Only check basic
 * merging parameters without querying the elevator.
1877 1878
 *
 * Caller must ensure !blk_queue_nomerges(q) beforehand.
1879
 */
1880
bool blk_attempt_plug_merge(struct request_queue *q, struct bio *bio,
1881 1882
			    unsigned int *request_count,
			    struct request **same_queue_rq)
1883 1884 1885
{
	struct blk_plug *plug;
	struct request *rq;
S
Shaohua Li 已提交
1886
	struct list_head *plug_list;
1887

1888
	plug = current->plug;
1889
	if (!plug)
1890
		return false;
1891
	*request_count = 0;
1892

S
Shaohua Li 已提交
1893 1894 1895 1896 1897 1898
	if (q->mq_ops)
		plug_list = &plug->mq_list;
	else
		plug_list = &plug->list;

	list_for_each_entry_reverse(rq, plug_list, queuelist) {
1899
		bool merged = false;
1900

1901
		if (rq->q == q) {
1902
			(*request_count)++;
1903 1904 1905 1906 1907 1908 1909 1910
			/*
			 * Only blk-mq multiple hardware queues case checks the
			 * rq in the same queue, there should be only one such
			 * rq in a queue
			 **/
			if (same_queue_rq)
				*same_queue_rq = rq;
		}
1911

1912
		if (rq->q != q || !blk_rq_merge_ok(rq, bio))
1913 1914
			continue;

1915 1916 1917 1918 1919 1920 1921
		switch (blk_try_merge(rq, bio)) {
		case ELEVATOR_BACK_MERGE:
			merged = bio_attempt_back_merge(q, rq, bio);
			break;
		case ELEVATOR_FRONT_MERGE:
			merged = bio_attempt_front_merge(q, rq, bio);
			break;
1922 1923 1924
		case ELEVATOR_DISCARD_MERGE:
			merged = bio_attempt_discard_merge(q, rq, bio);
			break;
1925 1926
		default:
			break;
1927
		}
1928 1929 1930

		if (merged)
			return true;
1931
	}
1932 1933

	return false;
1934 1935
}

1936 1937 1938 1939 1940 1941 1942 1943 1944 1945 1946 1947 1948 1949 1950 1951 1952 1953 1954 1955 1956 1957 1958 1959
unsigned int blk_plug_queued_count(struct request_queue *q)
{
	struct blk_plug *plug;
	struct request *rq;
	struct list_head *plug_list;
	unsigned int ret = 0;

	plug = current->plug;
	if (!plug)
		goto out;

	if (q->mq_ops)
		plug_list = &plug->mq_list;
	else
		plug_list = &plug->list;

	list_for_each_entry(rq, plug_list, queuelist) {
		if (rq->q == q)
			ret++;
	}
out:
	return ret;
}

1960
void blk_init_request_from_bio(struct request *req, struct bio *bio)
1961
{
1962 1963
	struct io_context *ioc = rq_ioc(bio);

J
Jens Axboe 已提交
1964
	if (bio->bi_opf & REQ_RAHEAD)
1965
		req->cmd_flags |= REQ_FAILFAST_MASK;
J
Jens Axboe 已提交
1966

1967
	req->__sector = bio->bi_iter.bi_sector;
1968 1969
	if (ioprio_valid(bio_prio(bio)))
		req->ioprio = bio_prio(bio);
1970 1971 1972 1973
	else if (ioc)
		req->ioprio = ioc->ioprio;
	else
		req->ioprio = IOPRIO_PRIO_VALUE(IOPRIO_CLASS_NONE, 0);
1974
	req->write_hint = bio->bi_write_hint;
1975
	blk_rq_bio_prep(req->q, req, bio);
1976
}
1977
EXPORT_SYMBOL_GPL(blk_init_request_from_bio);
1978

1979
static blk_qc_t blk_queue_bio(struct request_queue *q, struct bio *bio)
L
Linus Torvalds 已提交
1980
{
1981
	struct blk_plug *plug;
1982
	int where = ELEVATOR_INSERT_SORT;
1983
	struct request *req, *free;
1984
	unsigned int request_count = 0;
J
Jens Axboe 已提交
1985
	unsigned int wb_acct;
L
Linus Torvalds 已提交
1986 1987 1988 1989 1990 1991 1992 1993

	/*
	 * low level driver can indicate that it wants pages above a
	 * certain limit bounced to low memory (ie for highmem, or even
	 * ISA dma in theory)
	 */
	blk_queue_bounce(q, &bio);

1994
	blk_queue_split(q, &bio);
1995

1996
	if (!bio_integrity_prep(bio))
1997
		return BLK_QC_T_NONE;
1998

1999
	if (op_is_flush(bio->bi_opf)) {
2000
		spin_lock_irq(q->queue_lock);
2001
		where = ELEVATOR_INSERT_FLUSH;
2002 2003 2004
		goto get_rq;
	}

2005 2006 2007 2008
	/*
	 * Check if we can merge with the plugged list before grabbing
	 * any locks.
	 */
2009 2010
	if (!blk_queue_nomerges(q)) {
		if (blk_attempt_plug_merge(q, bio, &request_count, NULL))
2011
			return BLK_QC_T_NONE;
2012 2013
	} else
		request_count = blk_plug_queued_count(q);
L
Linus Torvalds 已提交
2014

2015
	spin_lock_irq(q->queue_lock);
2016

2017 2018 2019 2020 2021 2022 2023 2024 2025 2026 2027 2028 2029 2030 2031 2032 2033 2034 2035 2036 2037 2038 2039
	switch (elv_merge(q, &req, bio)) {
	case ELEVATOR_BACK_MERGE:
		if (!bio_attempt_back_merge(q, req, bio))
			break;
		elv_bio_merged(q, req, bio);
		free = attempt_back_merge(q, req);
		if (free)
			__blk_put_request(q, free);
		else
			elv_merged_request(q, req, ELEVATOR_BACK_MERGE);
		goto out_unlock;
	case ELEVATOR_FRONT_MERGE:
		if (!bio_attempt_front_merge(q, req, bio))
			break;
		elv_bio_merged(q, req, bio);
		free = attempt_front_merge(q, req);
		if (free)
			__blk_put_request(q, free);
		else
			elv_merged_request(q, req, ELEVATOR_FRONT_MERGE);
		goto out_unlock;
	default:
		break;
L
Linus Torvalds 已提交
2040 2041
	}

2042
get_rq:
J
Jens Axboe 已提交
2043 2044
	wb_acct = wbt_wait(q->rq_wb, bio, q->queue_lock);

L
Linus Torvalds 已提交
2045
	/*
2046
	 * Grab a free request. This is might sleep but can not fail.
N
Nick Piggin 已提交
2047
	 * Returns with the queue unlocked.
2048
	 */
2049
	blk_queue_enter_live(q);
2050
	req = get_request(q, bio->bi_opf, bio, 0, GFP_NOIO);
2051
	if (IS_ERR(req)) {
2052
		blk_queue_exit(q);
J
Jens Axboe 已提交
2053
		__wbt_done(q->rq_wb, wb_acct);
2054 2055 2056 2057
		if (PTR_ERR(req) == -ENOMEM)
			bio->bi_status = BLK_STS_RESOURCE;
		else
			bio->bi_status = BLK_STS_IOERR;
2058
		bio_endio(bio);
2059 2060
		goto out_unlock;
	}
N
Nick Piggin 已提交
2061

2062
	wbt_track(req, wb_acct);
J
Jens Axboe 已提交
2063

2064 2065 2066 2067 2068
	/*
	 * After dropping the lock and possibly sleeping here, our request
	 * may now be mergeable after it had proven unmergeable (above).
	 * We don't worry about that case for efficiency. It won't happen
	 * often, and the elevators are able to handle it.
L
Linus Torvalds 已提交
2069
	 */
2070
	blk_init_request_from_bio(req, bio);
L
Linus Torvalds 已提交
2071

2072
	if (test_bit(QUEUE_FLAG_SAME_COMP, &q->queue_flags))
2073
		req->cpu = raw_smp_processor_id();
2074 2075

	plug = current->plug;
J
Jens Axboe 已提交
2076
	if (plug) {
J
Jens Axboe 已提交
2077 2078
		/*
		 * If this is the first request added after a plug, fire
2079
		 * of a plug trace.
2080 2081 2082
		 *
		 * @request_count may become stale because of schedule
		 * out, so check plug list again.
J
Jens Axboe 已提交
2083
		 */
2084
		if (!request_count || list_empty(&plug->list))
J
Jens Axboe 已提交
2085
			trace_block_plug(q);
2086
		else {
2087 2088 2089
			struct request *last = list_entry_rq(plug->list.prev);
			if (request_count >= BLK_MAX_REQUEST_COUNT ||
			    blk_rq_bytes(last) >= BLK_PLUG_FLUSH_SIZE) {
2090
				blk_flush_plug_list(plug, false);
S
Shaohua Li 已提交
2091 2092
				trace_block_plug(q);
			}
2093 2094
		}
		list_add_tail(&req->queuelist, &plug->list);
2095
		blk_account_io_start(req, true);
2096 2097 2098
	} else {
		spin_lock_irq(q->queue_lock);
		add_acct_request(q, req, where);
2099
		__blk_run_queue(q);
2100 2101 2102
out_unlock:
		spin_unlock_irq(q->queue_lock);
	}
2103 2104

	return BLK_QC_T_NONE;
L
Linus Torvalds 已提交
2105 2106
}

2107
static void handle_bad_sector(struct bio *bio, sector_t maxsector)
L
Linus Torvalds 已提交
2108 2109 2110 2111
{
	char b[BDEVNAME_SIZE];

	printk(KERN_INFO "attempt to access beyond end of device\n");
2112
	printk(KERN_INFO "%s: rw=%d, want=%Lu, limit=%Lu\n",
2113
			bio_devname(bio, b), bio->bi_opf,
K
Kent Overstreet 已提交
2114
			(unsigned long long)bio_end_sector(bio),
2115
			(long long)maxsector);
L
Linus Torvalds 已提交
2116 2117
}

2118 2119 2120 2121 2122 2123 2124 2125 2126 2127
#ifdef CONFIG_FAIL_MAKE_REQUEST

static DECLARE_FAULT_ATTR(fail_make_request);

static int __init setup_fail_make_request(char *str)
{
	return setup_fault_attr(&fail_make_request, str);
}
__setup("fail_make_request=", setup_fail_make_request);

2128
static bool should_fail_request(struct hd_struct *part, unsigned int bytes)
2129
{
2130
	return part->make_it_fail && should_fail(&fail_make_request, bytes);
2131 2132 2133 2134
}

static int __init fail_make_request_debugfs(void)
{
2135 2136 2137
	struct dentry *dir = fault_create_debugfs_attr("fail_make_request",
						NULL, &fail_make_request);

2138
	return PTR_ERR_OR_ZERO(dir);
2139 2140 2141 2142 2143 2144
}

late_initcall(fail_make_request_debugfs);

#else /* CONFIG_FAIL_MAKE_REQUEST */

2145 2146
static inline bool should_fail_request(struct hd_struct *part,
					unsigned int bytes)
2147
{
2148
	return false;
2149 2150 2151 2152
}

#endif /* CONFIG_FAIL_MAKE_REQUEST */

2153 2154 2155 2156 2157 2158 2159 2160 2161 2162 2163 2164 2165 2166 2167
static inline bool bio_check_ro(struct bio *bio, struct hd_struct *part)
{
	if (part->policy && op_is_write(bio_op(bio))) {
		char b[BDEVNAME_SIZE];

		printk(KERN_ERR
		       "generic_make_request: Trying to write "
			"to read-only block-device %s (partno %d)\n",
			bio_devname(bio, b), part->partno);
		return true;
	}

	return false;
}

2168 2169 2170 2171 2172 2173 2174 2175
static noinline int should_fail_bio(struct bio *bio)
{
	if (should_fail_request(&bio->bi_disk->part0, bio->bi_iter.bi_size))
		return -EIO;
	return 0;
}
ALLOW_ERROR_INJECTION(should_fail_bio, ERRNO);

2176 2177 2178 2179 2180 2181 2182 2183 2184 2185 2186 2187 2188 2189 2190 2191 2192 2193
/*
 * Check whether this bio extends beyond the end of the device or partition.
 * This may well happen - the kernel calls bread() without checking the size of
 * the device, e.g., when mounting a file system.
 */
static inline int bio_check_eod(struct bio *bio, sector_t maxsector)
{
	unsigned int nr_sectors = bio_sectors(bio);

	if (nr_sectors && maxsector &&
	    (nr_sectors > maxsector ||
	     bio->bi_iter.bi_sector > maxsector - nr_sectors)) {
		handle_bad_sector(bio, maxsector);
		return -EIO;
	}
	return 0;
}

2194 2195 2196 2197 2198 2199
/*
 * Remap block n of partition p to block n+start(p) of the disk.
 */
static inline int blk_partition_remap(struct bio *bio)
{
	struct hd_struct *p;
2200
	int ret = -EIO;
2201

2202 2203
	rcu_read_lock();
	p = __disk_get_part(bio->bi_disk, bio->bi_partno);
2204 2205 2206 2207 2208
	if (unlikely(!p))
		goto out;
	if (unlikely(should_fail_request(p, bio->bi_iter.bi_size)))
		goto out;
	if (unlikely(bio_check_ro(bio, p)))
2209 2210
		goto out;

2211 2212 2213 2214
	/*
	 * Zone reset does not include bi_size so bio_sectors() is always 0.
	 * Include a test for the reset op code and perform the remap if needed.
	 */
2215 2216 2217 2218 2219 2220 2221
	if (bio_sectors(bio) || bio_op(bio) == REQ_OP_ZONE_RESET) {
		if (bio_check_eod(bio, part_nr_sects_read(p)))
			goto out;
		bio->bi_iter.bi_sector += p->start_sect;
		trace_block_bio_remap(bio->bi_disk->queue, bio, part_devt(p),
				      bio->bi_iter.bi_sector - p->start_sect);
	}
2222
	bio->bi_partno = 0;
2223
	ret = 0;
2224 2225
out:
	rcu_read_unlock();
2226 2227 2228
	return ret;
}

2229 2230
static noinline_for_stack bool
generic_make_request_checks(struct bio *bio)
L
Linus Torvalds 已提交
2231
{
2232
	struct request_queue *q;
2233
	int nr_sectors = bio_sectors(bio);
2234
	blk_status_t status = BLK_STS_IOERR;
2235
	char b[BDEVNAME_SIZE];
L
Linus Torvalds 已提交
2236 2237 2238

	might_sleep();

2239
	q = bio->bi_disk->queue;
2240 2241 2242 2243
	if (unlikely(!q)) {
		printk(KERN_ERR
		       "generic_make_request: Trying to access "
			"nonexistent block-device %s (%Lu)\n",
2244
			bio_devname(bio, b), (long long)bio->bi_iter.bi_sector);
2245 2246
		goto end_io;
	}
2247

2248 2249 2250 2251 2252 2253 2254
	/*
	 * For a REQ_NOWAIT based request, return -EOPNOTSUPP
	 * if queue is not a request based queue.
	 */
	if ((bio->bi_opf & REQ_NOWAIT) && !queue_is_rq_based(q))
		goto not_supported;

2255
	if (should_fail_bio(bio))
2256
		goto end_io;
2257

2258 2259
	if (bio->bi_partno) {
		if (unlikely(blk_partition_remap(bio)))
2260 2261
			goto end_io;
	} else {
2262 2263 2264
		if (unlikely(bio_check_ro(bio, &bio->bi_disk->part0)))
			goto end_io;
		if (unlikely(bio_check_eod(bio, get_capacity(bio->bi_disk))))
2265 2266
			goto end_io;
	}
2267

2268 2269 2270 2271 2272
	/*
	 * Filter flush bio's early so that make_request based
	 * drivers without flush support don't have to worry
	 * about them.
	 */
2273
	if (op_is_flush(bio->bi_opf) &&
J
Jens Axboe 已提交
2274
	    !test_bit(QUEUE_FLAG_WC, &q->queue_flags)) {
J
Jens Axboe 已提交
2275
		bio->bi_opf &= ~(REQ_PREFLUSH | REQ_FUA);
2276
		if (!nr_sectors) {
2277
			status = BLK_STS_OK;
2278 2279
			goto end_io;
		}
2280
	}
2281

2282 2283 2284 2285 2286 2287 2288 2289 2290 2291
	switch (bio_op(bio)) {
	case REQ_OP_DISCARD:
		if (!blk_queue_discard(q))
			goto not_supported;
		break;
	case REQ_OP_SECURE_ERASE:
		if (!blk_queue_secure_erase(q))
			goto not_supported;
		break;
	case REQ_OP_WRITE_SAME:
2292
		if (!q->limits.max_write_same_sectors)
2293
			goto not_supported;
2294
		break;
2295 2296
	case REQ_OP_ZONE_REPORT:
	case REQ_OP_ZONE_RESET:
2297
		if (!blk_queue_is_zoned(q))
2298
			goto not_supported;
2299
		break;
2300
	case REQ_OP_WRITE_ZEROES:
2301
		if (!q->limits.max_write_zeroes_sectors)
2302 2303
			goto not_supported;
		break;
2304 2305
	default:
		break;
2306
	}
2307

T
Tejun Heo 已提交
2308 2309 2310 2311 2312 2313 2314 2315
	/*
	 * Various block parts want %current->io_context and lazy ioc
	 * allocation ends up trading a lot of pain for a small amount of
	 * memory.  Just allocate it upfront.  This may fail and block
	 * layer knows how to live with it.
	 */
	create_io_context(GFP_ATOMIC, q->node);

2316 2317
	if (!blkcg_bio_issue_check(q, bio))
		return false;
2318

N
NeilBrown 已提交
2319 2320 2321 2322 2323 2324 2325
	if (!bio_flagged(bio, BIO_TRACE_COMPLETION)) {
		trace_block_bio_queue(q, bio);
		/* Now that enqueuing has been traced, we need to trace
		 * completion as well.
		 */
		bio_set_flag(bio, BIO_TRACE_COMPLETION);
	}
2326
	return true;
2327

2328
not_supported:
2329
	status = BLK_STS_NOTSUPP;
2330
end_io:
2331
	bio->bi_status = status;
2332
	bio_endio(bio);
2333
	return false;
L
Linus Torvalds 已提交
2334 2335
}

2336 2337 2338 2339 2340 2341 2342 2343 2344 2345 2346 2347 2348 2349 2350 2351 2352 2353 2354 2355 2356 2357 2358
/**
 * generic_make_request - hand a buffer to its device driver for I/O
 * @bio:  The bio describing the location in memory and on the device.
 *
 * generic_make_request() is used to make I/O requests of block
 * devices. It is passed a &struct bio, which describes the I/O that needs
 * to be done.
 *
 * generic_make_request() does not return any status.  The
 * success/failure status of the request, along with notification of
 * completion, is delivered asynchronously through the bio->bi_end_io
 * function described (one day) else where.
 *
 * The caller of generic_make_request must make sure that bi_io_vec
 * are set to describe the memory buffer, and that bi_dev and bi_sector are
 * set to describe the device address, and the
 * bi_end_io and optionally bi_private are set to describe how
 * completion notification should be signaled.
 *
 * generic_make_request and the drivers it calls may use bi_next if this
 * bio happens to be merged with someone else, and may resubmit the bio to
 * a lower device by calling into generic_make_request recursively, which
 * means the bio should NOT be touched after the call to ->make_request_fn.
2359
 */
2360
blk_qc_t generic_make_request(struct bio *bio)
2361
{
2362 2363 2364 2365 2366 2367 2368 2369
	/*
	 * bio_list_on_stack[0] contains bios submitted by the current
	 * make_request_fn.
	 * bio_list_on_stack[1] contains bios that were submitted before
	 * the current make_request_fn, but that haven't been processed
	 * yet.
	 */
	struct bio_list bio_list_on_stack[2];
2370 2371
	blk_mq_req_flags_t flags = 0;
	struct request_queue *q = bio->bi_disk->queue;
2372
	blk_qc_t ret = BLK_QC_T_NONE;
2373

2374 2375
	if (bio->bi_opf & REQ_NOWAIT)
		flags = BLK_MQ_REQ_NOWAIT;
2376 2377 2378
	if (bio_flagged(bio, BIO_QUEUE_ENTERED))
		blk_queue_enter_live(q);
	else if (blk_queue_enter(q, flags) < 0) {
2379 2380 2381 2382 2383 2384 2385
		if (!blk_queue_dying(q) && (bio->bi_opf & REQ_NOWAIT))
			bio_wouldblock_error(bio);
		else
			bio_io_error(bio);
		return ret;
	}

2386
	if (!generic_make_request_checks(bio))
2387
		goto out;
2388 2389 2390 2391 2392 2393 2394 2395 2396 2397 2398

	/*
	 * We only want one ->make_request_fn to be active at a time, else
	 * stack usage with stacked devices could be a problem.  So use
	 * current->bio_list to keep a list of requests submited by a
	 * make_request_fn function.  current->bio_list is also used as a
	 * flag to say if generic_make_request is currently active in this
	 * task or not.  If it is NULL, then no make_request is active.  If
	 * it is non-NULL, then a make_request is active, and new requests
	 * should be added at the tail
	 */
2399
	if (current->bio_list) {
2400
		bio_list_add(&current->bio_list[0], bio);
2401
		goto out;
2402
	}
2403

2404 2405 2406 2407 2408
	/* following loop may be a bit non-obvious, and so deserves some
	 * explanation.
	 * Before entering the loop, bio->bi_next is NULL (as all callers
	 * ensure that) so we have a list with a single bio.
	 * We pretend that we have just taken it off a longer list, so
2409 2410
	 * we assign bio_list to a pointer to the bio_list_on_stack,
	 * thus initialising the bio_list of new bios to be
2411
	 * added.  ->make_request() may indeed add some more bios
2412 2413 2414
	 * through a recursive call to generic_make_request.  If it
	 * did, we find a non-NULL value in bio_list and re-enter the loop
	 * from the top.  In this case we really did just take the bio
2415
	 * of the top of the list (no pretending) and so remove it from
2416
	 * bio_list, and call into ->make_request() again.
2417 2418
	 */
	BUG_ON(bio->bi_next);
2419 2420
	bio_list_init(&bio_list_on_stack[0]);
	current->bio_list = bio_list_on_stack;
2421
	do {
2422 2423 2424 2425 2426 2427 2428 2429 2430 2431 2432 2433 2434 2435
		bool enter_succeeded = true;

		if (unlikely(q != bio->bi_disk->queue)) {
			if (q)
				blk_queue_exit(q);
			q = bio->bi_disk->queue;
			flags = 0;
			if (bio->bi_opf & REQ_NOWAIT)
				flags = BLK_MQ_REQ_NOWAIT;
			if (blk_queue_enter(q, flags) < 0) {
				enter_succeeded = false;
				q = NULL;
			}
		}
2436

2437
		if (enter_succeeded) {
2438 2439 2440
			struct bio_list lower, same;

			/* Create a fresh bio_list for all subordinate requests */
2441 2442
			bio_list_on_stack[1] = bio_list_on_stack[0];
			bio_list_init(&bio_list_on_stack[0]);
2443
			ret = q->make_request_fn(q, bio);
2444

2445 2446 2447 2448 2449
			/* sort new bios into those for a lower level
			 * and those for the same level
			 */
			bio_list_init(&lower);
			bio_list_init(&same);
2450
			while ((bio = bio_list_pop(&bio_list_on_stack[0])) != NULL)
2451
				if (q == bio->bi_disk->queue)
2452 2453 2454 2455
					bio_list_add(&same, bio);
				else
					bio_list_add(&lower, bio);
			/* now assemble so we handle the lowest level first */
2456 2457 2458
			bio_list_merge(&bio_list_on_stack[0], &lower);
			bio_list_merge(&bio_list_on_stack[0], &same);
			bio_list_merge(&bio_list_on_stack[0], &bio_list_on_stack[1]);
2459
		} else {
2460 2461 2462 2463 2464
			if (unlikely(!blk_queue_dying(q) &&
					(bio->bi_opf & REQ_NOWAIT)))
				bio_wouldblock_error(bio);
			else
				bio_io_error(bio);
2465
		}
2466
		bio = bio_list_pop(&bio_list_on_stack[0]);
2467
	} while (bio);
2468
	current->bio_list = NULL; /* deactivate */
2469 2470

out:
2471 2472
	if (q)
		blk_queue_exit(q);
2473
	return ret;
2474
}
L
Linus Torvalds 已提交
2475 2476
EXPORT_SYMBOL(generic_make_request);

2477 2478 2479 2480 2481 2482 2483 2484 2485 2486 2487 2488 2489 2490 2491 2492 2493 2494 2495
/**
 * direct_make_request - hand a buffer directly to its device driver for I/O
 * @bio:  The bio describing the location in memory and on the device.
 *
 * This function behaves like generic_make_request(), but does not protect
 * against recursion.  Must only be used if the called driver is known
 * to not call generic_make_request (or direct_make_request) again from
 * its make_request function.  (Calling direct_make_request again from
 * a workqueue is perfectly fine as that doesn't recurse).
 */
blk_qc_t direct_make_request(struct bio *bio)
{
	struct request_queue *q = bio->bi_disk->queue;
	bool nowait = bio->bi_opf & REQ_NOWAIT;
	blk_qc_t ret;

	if (!generic_make_request_checks(bio))
		return BLK_QC_T_NONE;

2496
	if (unlikely(blk_queue_enter(q, nowait ? BLK_MQ_REQ_NOWAIT : 0))) {
2497 2498 2499 2500 2501 2502 2503 2504 2505 2506 2507 2508 2509 2510
		if (nowait && !blk_queue_dying(q))
			bio->bi_status = BLK_STS_AGAIN;
		else
			bio->bi_status = BLK_STS_IOERR;
		bio_endio(bio);
		return BLK_QC_T_NONE;
	}

	ret = q->make_request_fn(q, bio);
	blk_queue_exit(q);
	return ret;
}
EXPORT_SYMBOL_GPL(direct_make_request);

L
Linus Torvalds 已提交
2511
/**
2512
 * submit_bio - submit a bio to the block device layer for I/O
L
Linus Torvalds 已提交
2513 2514 2515 2516
 * @bio: The &struct bio which describes the I/O
 *
 * submit_bio() is very similar in purpose to generic_make_request(), and
 * uses that function to do most of the work. Both are fairly rough
2517
 * interfaces; @bio must be presetup and ready for I/O.
L
Linus Torvalds 已提交
2518 2519
 *
 */
2520
blk_qc_t submit_bio(struct bio *bio)
L
Linus Torvalds 已提交
2521
{
2522 2523 2524 2525
	/*
	 * If it's a regular read/write or a barrier with data attached,
	 * go through the normal accounting stuff before submission.
	 */
2526
	if (bio_has_data(bio)) {
2527 2528
		unsigned int count;

2529
		if (unlikely(bio_op(bio) == REQ_OP_WRITE_SAME))
2530
			count = queue_logical_block_size(bio->bi_disk->queue) >> 9;
2531 2532 2533
		else
			count = bio_sectors(bio);

2534
		if (op_is_write(bio_op(bio))) {
2535 2536
			count_vm_events(PGPGOUT, count);
		} else {
2537
			task_io_account_read(bio->bi_iter.bi_size);
2538 2539 2540 2541 2542
			count_vm_events(PGPGIN, count);
		}

		if (unlikely(block_dump)) {
			char b[BDEVNAME_SIZE];
2543
			printk(KERN_DEBUG "%s(%d): %s block %Lu on %s (%u sectors)\n",
2544
			current->comm, task_pid_nr(current),
2545
				op_is_write(bio_op(bio)) ? "WRITE" : "READ",
2546
				(unsigned long long)bio->bi_iter.bi_sector,
2547
				bio_devname(bio, b), count);
2548
		}
L
Linus Torvalds 已提交
2549 2550
	}

2551
	return generic_make_request(bio);
L
Linus Torvalds 已提交
2552 2553 2554
}
EXPORT_SYMBOL(submit_bio);

2555 2556 2557 2558 2559 2560 2561 2562 2563 2564 2565
bool blk_poll(struct request_queue *q, blk_qc_t cookie)
{
	if (!q->poll_fn || !blk_qc_t_valid(cookie))
		return false;

	if (current->plug)
		blk_flush_plug_list(current->plug, false);
	return q->poll_fn(q, cookie);
}
EXPORT_SYMBOL_GPL(blk_poll);

2566
/**
2567 2568
 * blk_cloned_rq_check_limits - Helper function to check a cloned request
 *                              for new the queue limits
2569 2570 2571 2572 2573 2574 2575 2576 2577 2578 2579
 * @q:  the queue
 * @rq: the request being checked
 *
 * Description:
 *    @rq may have been made based on weaker limitations of upper-level queues
 *    in request stacking drivers, and it may violate the limitation of @q.
 *    Since the block layer and the underlying device driver trust @rq
 *    after it is inserted to @q, it should be checked against @q before
 *    the insertion using this generic function.
 *
 *    Request stacking drivers like request-based dm may change the queue
2580 2581
 *    limits when retrying requests on other queues. Those requests need
 *    to be checked against the new queue limits again during dispatch.
2582
 */
2583 2584
static int blk_cloned_rq_check_limits(struct request_queue *q,
				      struct request *rq)
2585
{
2586
	if (blk_rq_sectors(rq) > blk_queue_get_max_sectors(q, req_op(rq))) {
2587 2588 2589 2590 2591 2592 2593 2594 2595 2596 2597
		printk(KERN_ERR "%s: over max size limit.\n", __func__);
		return -EIO;
	}

	/*
	 * queue's settings related to segment counting like q->bounce_pfn
	 * may differ from that of other stacking queues.
	 * Recalculate it to check the request correctly on this queue's
	 * limitation.
	 */
	blk_recalc_rq_segments(rq);
2598
	if (rq->nr_phys_segments > queue_max_segments(q)) {
2599 2600 2601 2602 2603 2604 2605 2606 2607 2608 2609 2610
		printk(KERN_ERR "%s: over max segments limit.\n", __func__);
		return -EIO;
	}

	return 0;
}

/**
 * blk_insert_cloned_request - Helper for stacking drivers to submit a request
 * @q:  the queue to submit the request
 * @rq: the request being queued
 */
2611
blk_status_t blk_insert_cloned_request(struct request_queue *q, struct request *rq)
2612 2613
{
	unsigned long flags;
2614
	int where = ELEVATOR_INSERT_BACK;
2615

2616
	if (blk_cloned_rq_check_limits(q, rq))
2617
		return BLK_STS_IOERR;
2618

2619 2620
	if (rq->rq_disk &&
	    should_fail_request(&rq->rq_disk->part0, blk_rq_bytes(rq)))
2621
		return BLK_STS_IOERR;
2622

2623 2624 2625
	if (q->mq_ops) {
		if (blk_queue_io_stat(q))
			blk_account_io_start(rq, true);
2626 2627 2628 2629 2630
		/*
		 * Since we have a scheduler attached on the top device,
		 * bypass a potential scheduler on the bottom device for
		 * insert.
		 */
2631
		return blk_mq_request_issue_directly(rq);
2632 2633
	}

2634
	spin_lock_irqsave(q->queue_lock, flags);
B
Bart Van Assche 已提交
2635
	if (unlikely(blk_queue_dying(q))) {
2636
		spin_unlock_irqrestore(q->queue_lock, flags);
2637
		return BLK_STS_IOERR;
2638
	}
2639 2640 2641 2642 2643 2644 2645

	/*
	 * Submitting request must be dequeued before calling this function
	 * because it will be linked to another request_queue
	 */
	BUG_ON(blk_queued_rq(rq));

2646
	if (op_is_flush(rq->cmd_flags))
2647 2648 2649
		where = ELEVATOR_INSERT_FLUSH;

	add_acct_request(q, rq, where);
J
Jeff Moyer 已提交
2650 2651
	if (where == ELEVATOR_INSERT_FLUSH)
		__blk_run_queue(q);
2652 2653
	spin_unlock_irqrestore(q->queue_lock, flags);

2654
	return BLK_STS_OK;
2655 2656 2657
}
EXPORT_SYMBOL_GPL(blk_insert_cloned_request);

2658 2659 2660 2661 2662 2663 2664 2665 2666 2667 2668 2669 2670 2671 2672 2673 2674 2675 2676
/**
 * blk_rq_err_bytes - determine number of bytes till the next failure boundary
 * @rq: request to examine
 *
 * Description:
 *     A request could be merge of IOs which require different failure
 *     handling.  This function determines the number of bytes which
 *     can be failed from the beginning of the request without
 *     crossing into area which need to be retried further.
 *
 * Return:
 *     The number of bytes to fail.
 */
unsigned int blk_rq_err_bytes(const struct request *rq)
{
	unsigned int ff = rq->cmd_flags & REQ_FAILFAST_MASK;
	unsigned int bytes = 0;
	struct bio *bio;

2677
	if (!(rq->rq_flags & RQF_MIXED_MERGE))
2678 2679 2680 2681 2682 2683 2684 2685 2686 2687
		return blk_rq_bytes(rq);

	/*
	 * Currently the only 'mixing' which can happen is between
	 * different fastfail types.  We can safely fail portions
	 * which have all the failfast bits that the first one has -
	 * the ones which are at least as eager to fail as the first
	 * one.
	 */
	for (bio = rq->bio; bio; bio = bio->bi_next) {
J
Jens Axboe 已提交
2688
		if ((bio->bi_opf & ff) != ff)
2689
			break;
2690
		bytes += bio->bi_iter.bi_size;
2691 2692 2693 2694 2695 2696 2697 2698
	}

	/* this could lead to infinite loop */
	BUG_ON(blk_rq_bytes(rq) && !bytes);
	return bytes;
}
EXPORT_SYMBOL_GPL(blk_rq_err_bytes);

2699
void blk_account_io_completion(struct request *req, unsigned int bytes)
2700
{
2701
	if (blk_do_io_stat(req)) {
2702 2703 2704 2705 2706
		const int rw = rq_data_dir(req);
		struct hd_struct *part;
		int cpu;

		cpu = part_stat_lock();
2707
		part = req->part;
2708 2709 2710 2711 2712
		part_stat_add(cpu, part, sectors[rw], bytes >> 9);
		part_stat_unlock();
	}
}

2713
void blk_account_io_done(struct request *req, u64 now)
2714 2715
{
	/*
2716 2717 2718
	 * Account IO completion.  flush_rq isn't accounted as a
	 * normal IO on queueing nor completion.  Accounting the
	 * containing request is enough.
2719
	 */
2720
	if (blk_do_io_stat(req) && !(req->rq_flags & RQF_FLUSH_SEQ)) {
2721
		unsigned long duration;
2722 2723 2724 2725
		const int rw = rq_data_dir(req);
		struct hd_struct *part;
		int cpu;

2726
		duration = nsecs_to_jiffies(now - req->start_time_ns);
2727
		cpu = part_stat_lock();
2728
		part = req->part;
2729 2730 2731

		part_stat_inc(cpu, part, ios[rw]);
		part_stat_add(cpu, part, ticks[rw], duration);
2732 2733
		part_round_stats(req->q, cpu, part);
		part_dec_in_flight(req->q, part, rw);
2734

2735
		hd_struct_put(part);
2736 2737 2738 2739
		part_stat_unlock();
	}
}

2740
#ifdef CONFIG_PM
L
Lin Ming 已提交
2741 2742 2743 2744
/*
 * Don't process normal requests when queue is suspended
 * or in the process of suspending/resuming
 */
2745
static bool blk_pm_allow_request(struct request *rq)
L
Lin Ming 已提交
2746
{
2747 2748 2749 2750 2751 2752 2753 2754 2755
	switch (rq->q->rpm_status) {
	case RPM_RESUMING:
	case RPM_SUSPENDING:
		return rq->rq_flags & RQF_PM;
	case RPM_SUSPENDED:
		return false;
	}

	return true;
L
Lin Ming 已提交
2756 2757
}
#else
2758
static bool blk_pm_allow_request(struct request *rq)
L
Lin Ming 已提交
2759
{
2760
	return true;
L
Lin Ming 已提交
2761 2762 2763
}
#endif

2764 2765 2766 2767 2768 2769 2770 2771 2772 2773 2774 2775 2776 2777 2778 2779 2780 2781 2782 2783 2784 2785 2786 2787 2788 2789 2790 2791
void blk_account_io_start(struct request *rq, bool new_io)
{
	struct hd_struct *part;
	int rw = rq_data_dir(rq);
	int cpu;

	if (!blk_do_io_stat(rq))
		return;

	cpu = part_stat_lock();

	if (!new_io) {
		part = rq->part;
		part_stat_inc(cpu, part, merges[rw]);
	} else {
		part = disk_map_sector_rcu(rq->rq_disk, blk_rq_pos(rq));
		if (!hd_struct_try_get(part)) {
			/*
			 * The partition is already being removed,
			 * the request will be accounted on the disk only
			 *
			 * We take a reference on disk->part0 although that
			 * partition will never be deleted, so we can treat
			 * it as any other partition.
			 */
			part = &rq->rq_disk->part0;
			hd_struct_get(part);
		}
2792 2793
		part_round_stats(rq->q, cpu, part);
		part_inc_in_flight(rq->q, part, rw);
2794 2795 2796 2797 2798 2799
		rq->part = part;
	}

	part_stat_unlock();
}

2800 2801 2802 2803 2804 2805 2806 2807
static struct request *elv_next_request(struct request_queue *q)
{
	struct request *rq;
	struct blk_flush_queue *fq = blk_get_flush_queue(q, NULL);

	WARN_ON_ONCE(q->mq_ops);

	while (1) {
2808 2809 2810 2811 2812 2813
		list_for_each_entry(rq, &q->queue_head, queuelist) {
			if (blk_pm_allow_request(rq))
				return rq;

			if (rq->rq_flags & RQF_SOFTBARRIER)
				break;
2814 2815 2816 2817 2818 2819 2820 2821 2822 2823 2824 2825 2826 2827 2828 2829 2830 2831 2832 2833 2834 2835 2836 2837 2838 2839 2840 2841
		}

		/*
		 * Flush request is running and flush request isn't queueable
		 * in the drive, we can hold the queue till flush request is
		 * finished. Even we don't do this, driver can't dispatch next
		 * requests and will requeue them. And this can improve
		 * throughput too. For example, we have request flush1, write1,
		 * flush 2. flush1 is dispatched, then queue is hold, write1
		 * isn't inserted to queue. After flush1 is finished, flush2
		 * will be dispatched. Since disk cache is already clean,
		 * flush2 will be finished very soon, so looks like flush2 is
		 * folded to flush1.
		 * Since the queue is hold, a flag is set to indicate the queue
		 * should be restarted later. Please see flush_end_io() for
		 * details.
		 */
		if (fq->flush_pending_idx != fq->flush_running_idx &&
				!queue_flush_queueable(q)) {
			fq->flush_queue_delayed = 1;
			return NULL;
		}
		if (unlikely(blk_queue_bypass(q)) ||
		    !q->elevator->type->ops.sq.elevator_dispatch_fn(q, 0))
			return NULL;
	}
}

2842
/**
2843 2844 2845 2846 2847 2848 2849 2850 2851 2852 2853 2854 2855
 * blk_peek_request - peek at the top of a request queue
 * @q: request queue to peek at
 *
 * Description:
 *     Return the request at the top of @q.  The returned request
 *     should be started using blk_start_request() before LLD starts
 *     processing it.
 *
 * Return:
 *     Pointer to the request at the top of @q if available.  Null
 *     otherwise.
 */
struct request *blk_peek_request(struct request_queue *q)
2856 2857 2858 2859
{
	struct request *rq;
	int ret;

2860
	lockdep_assert_held(q->queue_lock);
2861
	WARN_ON_ONCE(q->mq_ops);
2862

2863
	while ((rq = elv_next_request(q)) != NULL) {
2864
		if (!(rq->rq_flags & RQF_STARTED)) {
2865 2866 2867 2868 2869
			/*
			 * This is the first time the device driver
			 * sees this request (possibly after
			 * requeueing).  Notify IO scheduler.
			 */
2870
			if (rq->rq_flags & RQF_SORTED)
2871 2872 2873 2874 2875 2876 2877
				elv_activate_rq(q, rq);

			/*
			 * just mark as started even if we don't start
			 * it, a request that has been delayed should
			 * not be passed by new incoming requests
			 */
2878
			rq->rq_flags |= RQF_STARTED;
2879 2880 2881 2882 2883 2884 2885 2886
			trace_block_rq_issue(q, rq);
		}

		if (!q->boundary_rq || q->boundary_rq == rq) {
			q->end_sector = rq_end_sector(rq);
			q->boundary_rq = NULL;
		}

2887
		if (rq->rq_flags & RQF_DONTPREP)
2888 2889
			break;

2890
		if (q->dma_drain_size && blk_rq_bytes(rq)) {
2891 2892 2893 2894 2895 2896 2897 2898 2899 2900 2901 2902 2903 2904 2905 2906 2907 2908 2909
			/*
			 * make sure space for the drain appears we
			 * know we can do this because max_hw_segments
			 * has been adjusted to be one fewer than the
			 * device can handle
			 */
			rq->nr_phys_segments++;
		}

		if (!q->prep_rq_fn)
			break;

		ret = q->prep_rq_fn(q, rq);
		if (ret == BLKPREP_OK) {
			break;
		} else if (ret == BLKPREP_DEFER) {
			/*
			 * the request may have been (partially) prepped.
			 * we need to keep this request in the front to
2910
			 * avoid resource deadlock.  RQF_STARTED will
2911 2912
			 * prevent other fs requests from passing this one.
			 */
2913
			if (q->dma_drain_size && blk_rq_bytes(rq) &&
2914
			    !(rq->rq_flags & RQF_DONTPREP)) {
2915 2916 2917 2918 2919 2920 2921 2922 2923
				/*
				 * remove the space for the drain we added
				 * so that we don't add it again
				 */
				--rq->nr_phys_segments;
			}

			rq = NULL;
			break;
2924
		} else if (ret == BLKPREP_KILL || ret == BLKPREP_INVALID) {
2925
			rq->rq_flags |= RQF_QUIET;
2926 2927 2928 2929 2930
			/*
			 * Mark this request as started so we don't trigger
			 * any debug logic in the end I/O path.
			 */
			blk_start_request(rq);
2931 2932
			__blk_end_request_all(rq, ret == BLKPREP_INVALID ?
					BLK_STS_TARGET : BLK_STS_IOERR);
2933 2934 2935 2936 2937 2938 2939 2940
		} else {
			printk(KERN_ERR "%s: bad return=%d\n", __func__, ret);
			break;
		}
	}

	return rq;
}
2941
EXPORT_SYMBOL(blk_peek_request);
2942

2943
static void blk_dequeue_request(struct request *rq)
2944
{
2945 2946
	struct request_queue *q = rq->q;

2947 2948 2949 2950 2951 2952 2953 2954 2955 2956
	BUG_ON(list_empty(&rq->queuelist));
	BUG_ON(ELV_ON_HASH(rq));

	list_del_init(&rq->queuelist);

	/*
	 * the time frame between a request being removed from the lists
	 * and to it is freed is accounted as io that is in progress at
	 * the driver side.
	 */
2957
	if (blk_account_rq(rq))
2958
		q->in_flight[rq_is_sync(rq)]++;
2959 2960
}

2961 2962 2963 2964 2965 2966 2967 2968 2969 2970
/**
 * blk_start_request - start request processing on the driver
 * @req: request to dequeue
 *
 * Description:
 *     Dequeue @req and start timeout timer on it.  This hands off the
 *     request to the driver.
 */
void blk_start_request(struct request *req)
{
2971
	lockdep_assert_held(req->q->queue_lock);
2972
	WARN_ON_ONCE(req->q->mq_ops);
2973

2974 2975
	blk_dequeue_request(req);

2976
	if (test_bit(QUEUE_FLAG_STATS, &req->q->queue_flags)) {
2977 2978 2979 2980
		req->io_start_time_ns = ktime_get_ns();
#ifdef CONFIG_BLK_DEV_THROTTLING_LOW
		req->throtl_size = blk_rq_sectors(req);
#endif
2981
		req->rq_flags |= RQF_STATS;
2982
		wbt_issue(req->q->rq_wb, req);
2983 2984
	}

2985
	BUG_ON(blk_rq_is_complete(req));
2986 2987 2988 2989 2990 2991 2992 2993 2994 2995 2996 2997 2998 2999 3000 3001 3002 3003 3004 3005
	blk_add_timer(req);
}
EXPORT_SYMBOL(blk_start_request);

/**
 * blk_fetch_request - fetch a request from a request queue
 * @q: request queue to fetch a request from
 *
 * Description:
 *     Return the request at the top of @q.  The request is started on
 *     return and LLD can start processing it immediately.
 *
 * Return:
 *     Pointer to the request at the top of @q if available.  Null
 *     otherwise.
 */
struct request *blk_fetch_request(struct request_queue *q)
{
	struct request *rq;

3006
	lockdep_assert_held(q->queue_lock);
3007
	WARN_ON_ONCE(q->mq_ops);
3008

3009 3010 3011 3012 3013 3014 3015
	rq = blk_peek_request(q);
	if (rq)
		blk_start_request(rq);
	return rq;
}
EXPORT_SYMBOL(blk_fetch_request);

3016 3017 3018 3019 3020 3021 3022 3023 3024 3025 3026 3027 3028 3029 3030 3031 3032 3033 3034 3035 3036
/*
 * Steal bios from a request and add them to a bio list.
 * The request must not have been partially completed before.
 */
void blk_steal_bios(struct bio_list *list, struct request *rq)
{
	if (rq->bio) {
		if (list->tail)
			list->tail->bi_next = rq->bio;
		else
			list->head = rq->bio;
		list->tail = rq->biotail;

		rq->bio = NULL;
		rq->biotail = NULL;
	}

	rq->__data_len = 0;
}
EXPORT_SYMBOL_GPL(blk_steal_bios);

3037
/**
3038
 * blk_update_request - Special helper function for request stacking drivers
3039
 * @req:      the request being processed
3040
 * @error:    block status code
3041
 * @nr_bytes: number of bytes to complete @req
3042 3043
 *
 * Description:
3044 3045 3046
 *     Ends I/O on a number of bytes attached to @req, but doesn't complete
 *     the request structure even if @req doesn't have leftover.
 *     If @req has leftover, sets it up for the next range of segments.
3047 3048 3049 3050 3051 3052 3053
 *
 *     This special helper function is only for request stacking drivers
 *     (e.g. request-based dm) so that they can handle partial completion.
 *     Actual device drivers should use blk_end_request instead.
 *
 *     Passing the result of blk_rq_bytes() as @nr_bytes guarantees
 *     %false return from this function.
3054 3055
 *
 * Return:
3056 3057
 *     %false - this request doesn't have any more data
 *     %true  - this request has more data
3058
 **/
3059 3060
bool blk_update_request(struct request *req, blk_status_t error,
		unsigned int nr_bytes)
L
Linus Torvalds 已提交
3061
{
3062
	int total_bytes;
L
Linus Torvalds 已提交
3063

3064
	trace_block_rq_complete(req, blk_status_to_errno(error), nr_bytes);
3065

3066 3067 3068
	if (!req->bio)
		return false;

3069 3070 3071
	if (unlikely(error && !blk_rq_is_passthrough(req) &&
		     !(req->rq_flags & RQF_QUIET)))
		print_req_error(req, error);
L
Linus Torvalds 已提交
3072

3073
	blk_account_io_completion(req, nr_bytes);
3074

3075 3076 3077
	total_bytes = 0;
	while (req->bio) {
		struct bio *bio = req->bio;
3078
		unsigned bio_bytes = min(bio->bi_iter.bi_size, nr_bytes);
L
Linus Torvalds 已提交
3079

3080
		if (bio_bytes == bio->bi_iter.bi_size)
L
Linus Torvalds 已提交
3081 3082
			req->bio = bio->bi_next;

N
NeilBrown 已提交
3083 3084
		/* Completion has already been traced */
		bio_clear_flag(bio, BIO_TRACE_COMPLETION);
3085
		req_bio_endio(req, bio, bio_bytes, error);
L
Linus Torvalds 已提交
3086

3087 3088
		total_bytes += bio_bytes;
		nr_bytes -= bio_bytes;
L
Linus Torvalds 已提交
3089

3090 3091
		if (!nr_bytes)
			break;
L
Linus Torvalds 已提交
3092 3093 3094 3095 3096
	}

	/*
	 * completely done
	 */
3097 3098 3099 3100 3101 3102
	if (!req->bio) {
		/*
		 * Reset counters so that the request stacking driver
		 * can find how many bytes remain in the request
		 * later.
		 */
3103
		req->__data_len = 0;
3104 3105
		return false;
	}
L
Linus Torvalds 已提交
3106

3107
	req->__data_len -= total_bytes;
3108 3109

	/* update sector only for requests with clear definition of sector */
3110
	if (!blk_rq_is_passthrough(req))
3111
		req->__sector += total_bytes >> 9;
3112

3113
	/* mixed attributes always follow the first bio */
3114
	if (req->rq_flags & RQF_MIXED_MERGE) {
3115
		req->cmd_flags &= ~REQ_FAILFAST_MASK;
J
Jens Axboe 已提交
3116
		req->cmd_flags |= req->bio->bi_opf & REQ_FAILFAST_MASK;
3117 3118
	}

3119 3120 3121 3122 3123 3124 3125 3126 3127
	if (!(req->rq_flags & RQF_SPECIAL_PAYLOAD)) {
		/*
		 * If total number of sectors is less than the first segment
		 * size, something has gone terribly wrong.
		 */
		if (blk_rq_bytes(req) < blk_rq_cur_bytes(req)) {
			blk_dump_rq_flags(req, "request botched");
			req->__data_len = blk_rq_cur_bytes(req);
		}
3128

3129 3130 3131
		/* recalculate the number of segments */
		blk_recalc_rq_segments(req);
	}
3132

3133
	return true;
L
Linus Torvalds 已提交
3134
}
3135
EXPORT_SYMBOL_GPL(blk_update_request);
L
Linus Torvalds 已提交
3136

3137
static bool blk_update_bidi_request(struct request *rq, blk_status_t error,
3138 3139
				    unsigned int nr_bytes,
				    unsigned int bidi_bytes)
3140
{
3141 3142
	if (blk_update_request(rq, error, nr_bytes))
		return true;
3143

3144 3145 3146 3147
	/* Bidi request must be completed as a whole */
	if (unlikely(blk_bidi_rq(rq)) &&
	    blk_update_request(rq->next_rq, error, bidi_bytes))
		return true;
3148

3149 3150
	if (blk_queue_add_random(rq->q))
		add_disk_randomness(rq->rq_disk);
3151 3152

	return false;
L
Linus Torvalds 已提交
3153 3154
}

3155 3156 3157 3158 3159 3160 3161 3162 3163 3164 3165 3166 3167 3168
/**
 * blk_unprep_request - unprepare a request
 * @req:	the request
 *
 * This function makes a request ready for complete resubmission (or
 * completion).  It happens only after all error handling is complete,
 * so represents the appropriate moment to deallocate any resources
 * that were allocated to the request in the prep_rq_fn.  The queue
 * lock is held when calling this.
 */
void blk_unprep_request(struct request *req)
{
	struct request_queue *q = req->q;

3169
	req->rq_flags &= ~RQF_DONTPREP;
3170 3171 3172 3173 3174
	if (q->unprep_rq_fn)
		q->unprep_rq_fn(q, req);
}
EXPORT_SYMBOL_GPL(blk_unprep_request);

3175
void blk_finish_request(struct request *req, blk_status_t error)
L
Linus Torvalds 已提交
3176
{
3177
	struct request_queue *q = req->q;
3178
	u64 now = ktime_get_ns();
3179

3180
	lockdep_assert_held(req->q->queue_lock);
3181
	WARN_ON_ONCE(q->mq_ops);
3182

3183
	if (req->rq_flags & RQF_STATS)
3184
		blk_stat_add(req, now);
3185

3186
	if (req->rq_flags & RQF_QUEUED)
3187
		blk_queue_end_tag(q, req);
3188

3189
	BUG_ON(blk_queued_rq(req));
L
Linus Torvalds 已提交
3190

3191
	if (unlikely(laptop_mode) && !blk_rq_is_passthrough(req))
3192
		laptop_io_completion(req->q->backing_dev_info);
L
Linus Torvalds 已提交
3193

3194 3195
	blk_delete_timer(req);

3196
	if (req->rq_flags & RQF_DONTPREP)
3197 3198
		blk_unprep_request(req);

3199
	blk_account_io_done(req, now);
3200

J
Jens Axboe 已提交
3201
	if (req->end_io) {
3202
		wbt_done(req->q->rq_wb, req);
3203
		req->end_io(req, error);
J
Jens Axboe 已提交
3204
	} else {
3205 3206 3207
		if (blk_bidi_rq(req))
			__blk_put_request(req->next_rq->q, req->next_rq);

3208
		__blk_put_request(q, req);
3209
	}
L
Linus Torvalds 已提交
3210
}
3211
EXPORT_SYMBOL(blk_finish_request);
L
Linus Torvalds 已提交
3212

3213
/**
3214 3215
 * blk_end_bidi_request - Complete a bidi request
 * @rq:         the request to complete
3216
 * @error:      block status code
3217 3218
 * @nr_bytes:   number of bytes to complete @rq
 * @bidi_bytes: number of bytes to complete @rq->next_rq
3219 3220
 *
 * Description:
3221
 *     Ends I/O on a number of bytes attached to @rq and @rq->next_rq.
3222 3223 3224
 *     Drivers that supports bidi can safely call this member for any
 *     type of request, bidi or uni.  In the later case @bidi_bytes is
 *     just ignored.
3225 3226
 *
 * Return:
3227 3228
 *     %false - we are done with this request
 *     %true  - still buffers pending for this request
3229
 **/
3230
static bool blk_end_bidi_request(struct request *rq, blk_status_t error,
K
Kiyoshi Ueda 已提交
3231 3232
				 unsigned int nr_bytes, unsigned int bidi_bytes)
{
3233
	struct request_queue *q = rq->q;
3234
	unsigned long flags;
K
Kiyoshi Ueda 已提交
3235

3236 3237
	WARN_ON_ONCE(q->mq_ops);

3238 3239
	if (blk_update_bidi_request(rq, error, nr_bytes, bidi_bytes))
		return true;
K
Kiyoshi Ueda 已提交
3240

3241
	spin_lock_irqsave(q->queue_lock, flags);
3242
	blk_finish_request(rq, error);
3243 3244
	spin_unlock_irqrestore(q->queue_lock, flags);

3245
	return false;
K
Kiyoshi Ueda 已提交
3246 3247
}

3248
/**
3249 3250
 * __blk_end_bidi_request - Complete a bidi request with queue lock held
 * @rq:         the request to complete
3251
 * @error:      block status code
3252 3253
 * @nr_bytes:   number of bytes to complete @rq
 * @bidi_bytes: number of bytes to complete @rq->next_rq
3254 3255
 *
 * Description:
3256 3257
 *     Identical to blk_end_bidi_request() except that queue lock is
 *     assumed to be locked on entry and remains so on return.
3258 3259
 *
 * Return:
3260 3261
 *     %false - we are done with this request
 *     %true  - still buffers pending for this request
3262
 **/
3263
static bool __blk_end_bidi_request(struct request *rq, blk_status_t error,
3264
				   unsigned int nr_bytes, unsigned int bidi_bytes)
3265
{
3266
	lockdep_assert_held(rq->q->queue_lock);
3267
	WARN_ON_ONCE(rq->q->mq_ops);
3268

3269 3270
	if (blk_update_bidi_request(rq, error, nr_bytes, bidi_bytes))
		return true;
3271

3272
	blk_finish_request(rq, error);
3273

3274
	return false;
3275
}
3276 3277 3278 3279

/**
 * blk_end_request - Helper function for drivers to complete the request.
 * @rq:       the request being processed
3280
 * @error:    block status code
3281 3282 3283 3284 3285 3286 3287
 * @nr_bytes: number of bytes to complete
 *
 * Description:
 *     Ends I/O on a number of bytes attached to @rq.
 *     If @rq has leftover, sets it up for the next range of segments.
 *
 * Return:
3288 3289
 *     %false - we are done with this request
 *     %true  - still buffers pending for this request
3290
 **/
3291 3292
bool blk_end_request(struct request *rq, blk_status_t error,
		unsigned int nr_bytes)
3293
{
3294
	WARN_ON_ONCE(rq->q->mq_ops);
3295
	return blk_end_bidi_request(rq, error, nr_bytes, 0);
3296
}
3297
EXPORT_SYMBOL(blk_end_request);
3298 3299

/**
3300 3301
 * blk_end_request_all - Helper function for drives to finish the request.
 * @rq: the request to finish
3302
 * @error: block status code
3303 3304
 *
 * Description:
3305 3306
 *     Completely finish @rq.
 */
3307
void blk_end_request_all(struct request *rq, blk_status_t error)
3308
{
3309 3310
	bool pending;
	unsigned int bidi_bytes = 0;
3311

3312 3313
	if (unlikely(blk_bidi_rq(rq)))
		bidi_bytes = blk_rq_bytes(rq->next_rq);
3314

3315 3316 3317
	pending = blk_end_bidi_request(rq, error, blk_rq_bytes(rq), bidi_bytes);
	BUG_ON(pending);
}
3318
EXPORT_SYMBOL(blk_end_request_all);
3319

3320
/**
3321 3322
 * __blk_end_request - Helper function for drivers to complete the request.
 * @rq:       the request being processed
3323
 * @error:    block status code
3324
 * @nr_bytes: number of bytes to complete
3325 3326
 *
 * Description:
3327
 *     Must be called with queue lock held unlike blk_end_request().
3328 3329
 *
 * Return:
3330 3331
 *     %false - we are done with this request
 *     %true  - still buffers pending for this request
3332
 **/
3333 3334
bool __blk_end_request(struct request *rq, blk_status_t error,
		unsigned int nr_bytes)
3335
{
3336
	lockdep_assert_held(rq->q->queue_lock);
3337
	WARN_ON_ONCE(rq->q->mq_ops);
3338

3339
	return __blk_end_bidi_request(rq, error, nr_bytes, 0);
3340
}
3341
EXPORT_SYMBOL(__blk_end_request);
3342

K
Kiyoshi Ueda 已提交
3343
/**
3344 3345
 * __blk_end_request_all - Helper function for drives to finish the request.
 * @rq: the request to finish
3346
 * @error:    block status code
K
Kiyoshi Ueda 已提交
3347 3348
 *
 * Description:
3349
 *     Completely finish @rq.  Must be called with queue lock held.
K
Kiyoshi Ueda 已提交
3350
 */
3351
void __blk_end_request_all(struct request *rq, blk_status_t error)
K
Kiyoshi Ueda 已提交
3352
{
3353 3354 3355
	bool pending;
	unsigned int bidi_bytes = 0;

3356
	lockdep_assert_held(rq->q->queue_lock);
3357
	WARN_ON_ONCE(rq->q->mq_ops);
3358

3359 3360 3361 3362 3363
	if (unlikely(blk_bidi_rq(rq)))
		bidi_bytes = blk_rq_bytes(rq->next_rq);

	pending = __blk_end_bidi_request(rq, error, blk_rq_bytes(rq), bidi_bytes);
	BUG_ON(pending);
K
Kiyoshi Ueda 已提交
3364
}
3365
EXPORT_SYMBOL(__blk_end_request_all);
K
Kiyoshi Ueda 已提交
3366

3367
/**
3368 3369
 * __blk_end_request_cur - Helper function to finish the current request chunk.
 * @rq: the request to finish the current chunk for
3370
 * @error:    block status code
3371 3372
 *
 * Description:
3373 3374
 *     Complete the current consecutively mapped chunk from @rq.  Must
 *     be called with queue lock held.
3375 3376
 *
 * Return:
3377 3378 3379
 *     %false - we are done with this request
 *     %true  - still buffers pending for this request
 */
3380
bool __blk_end_request_cur(struct request *rq, blk_status_t error)
3381
{
3382
	return __blk_end_request(rq, error, blk_rq_cur_bytes(rq));
3383
}
3384
EXPORT_SYMBOL(__blk_end_request_cur);
3385

J
Jens Axboe 已提交
3386 3387
void blk_rq_bio_prep(struct request_queue *q, struct request *rq,
		     struct bio *bio)
L
Linus Torvalds 已提交
3388
{
3389
	if (bio_has_data(bio))
D
David Woodhouse 已提交
3390
		rq->nr_phys_segments = bio_phys_segments(q, bio);
3391 3392
	else if (bio_op(bio) == REQ_OP_DISCARD)
		rq->nr_phys_segments = 1;
3393

3394
	rq->__data_len = bio->bi_iter.bi_size;
L
Linus Torvalds 已提交
3395 3396
	rq->bio = rq->biotail = bio;

3397 3398
	if (bio->bi_disk)
		rq->rq_disk = bio->bi_disk;
N
NeilBrown 已提交
3399
}
L
Linus Torvalds 已提交
3400

3401 3402 3403 3404 3405 3406 3407 3408 3409 3410 3411
#if ARCH_IMPLEMENTS_FLUSH_DCACHE_PAGE
/**
 * rq_flush_dcache_pages - Helper function to flush all pages in a request
 * @rq: the request to be flushed
 *
 * Description:
 *     Flush all pages in @rq.
 */
void rq_flush_dcache_pages(struct request *rq)
{
	struct req_iterator iter;
3412
	struct bio_vec bvec;
3413 3414

	rq_for_each_segment(bvec, rq, iter)
3415
		flush_dcache_page(bvec.bv_page);
3416 3417 3418 3419
}
EXPORT_SYMBOL_GPL(rq_flush_dcache_pages);
#endif

3420 3421 3422 3423 3424 3425 3426 3427 3428 3429 3430 3431 3432 3433 3434 3435 3436 3437 3438 3439 3440 3441 3442 3443 3444 3445 3446 3447
/**
 * blk_lld_busy - Check if underlying low-level drivers of a device are busy
 * @q : the queue of the device being checked
 *
 * Description:
 *    Check if underlying low-level drivers of a device are busy.
 *    If the drivers want to export their busy state, they must set own
 *    exporting function using blk_queue_lld_busy() first.
 *
 *    Basically, this function is used only by request stacking drivers
 *    to stop dispatching requests to underlying devices when underlying
 *    devices are busy.  This behavior helps more I/O merging on the queue
 *    of the request stacking driver and prevents I/O throughput regression
 *    on burst I/O load.
 *
 * Return:
 *    0 - Not busy (The request stacking driver should dispatch request)
 *    1 - Busy (The request stacking driver should stop dispatching request)
 */
int blk_lld_busy(struct request_queue *q)
{
	if (q->lld_busy_fn)
		return q->lld_busy_fn(q);

	return 0;
}
EXPORT_SYMBOL_GPL(blk_lld_busy);

3448 3449 3450 3451 3452 3453 3454 3455 3456 3457 3458 3459 3460 3461 3462 3463 3464 3465 3466 3467 3468 3469 3470 3471
/**
 * blk_rq_unprep_clone - Helper function to free all bios in a cloned request
 * @rq: the clone request to be cleaned up
 *
 * Description:
 *     Free all bios in @rq for a cloned request.
 */
void blk_rq_unprep_clone(struct request *rq)
{
	struct bio *bio;

	while ((bio = rq->bio) != NULL) {
		rq->bio = bio->bi_next;

		bio_put(bio);
	}
}
EXPORT_SYMBOL_GPL(blk_rq_unprep_clone);

/*
 * Copy attributes of the original request to the clone request.
 * The actual data parts (e.g. ->cmd, ->sense) are not copied.
 */
static void __blk_rq_prep_clone(struct request *dst, struct request *src)
3472 3473 3474 3475 3476 3477 3478
{
	dst->cpu = src->cpu;
	dst->__sector = blk_rq_pos(src);
	dst->__data_len = blk_rq_bytes(src);
	dst->nr_phys_segments = src->nr_phys_segments;
	dst->ioprio = src->ioprio;
	dst->extra_len = src->extra_len;
3479 3480 3481 3482 3483 3484 3485 3486 3487 3488 3489 3490 3491 3492 3493 3494 3495 3496 3497 3498 3499 3500 3501 3502 3503 3504 3505 3506 3507
}

/**
 * blk_rq_prep_clone - Helper function to setup clone request
 * @rq: the request to be setup
 * @rq_src: original request to be cloned
 * @bs: bio_set that bios for clone are allocated from
 * @gfp_mask: memory allocation mask for bio
 * @bio_ctr: setup function to be called for each clone bio.
 *           Returns %0 for success, non %0 for failure.
 * @data: private data to be passed to @bio_ctr
 *
 * Description:
 *     Clones bios in @rq_src to @rq, and copies attributes of @rq_src to @rq.
 *     The actual data parts of @rq_src (e.g. ->cmd, ->sense)
 *     are not copied, and copying such parts is the caller's responsibility.
 *     Also, pages which the original bios are pointing to are not copied
 *     and the cloned bios just point same pages.
 *     So cloned bios must be completed before original bios, which means
 *     the caller must complete @rq before @rq_src.
 */
int blk_rq_prep_clone(struct request *rq, struct request *rq_src,
		      struct bio_set *bs, gfp_t gfp_mask,
		      int (*bio_ctr)(struct bio *, struct bio *, void *),
		      void *data)
{
	struct bio *bio, *bio_src;

	if (!bs)
3508
		bs = &fs_bio_set;
3509 3510 3511 3512 3513 3514 3515 3516 3517 3518 3519 3520 3521 3522 3523 3524 3525 3526 3527 3528 3529 3530 3531 3532 3533 3534

	__rq_for_each_bio(bio_src, rq_src) {
		bio = bio_clone_fast(bio_src, gfp_mask, bs);
		if (!bio)
			goto free_and_out;

		if (bio_ctr && bio_ctr(bio, bio_src, data))
			goto free_and_out;

		if (rq->bio) {
			rq->biotail->bi_next = bio;
			rq->biotail = bio;
		} else
			rq->bio = rq->biotail = bio;
	}

	__blk_rq_prep_clone(rq, rq_src);

	return 0;

free_and_out:
	if (bio)
		bio_put(bio);
	blk_rq_unprep_clone(rq);

	return -ENOMEM;
3535 3536 3537
}
EXPORT_SYMBOL_GPL(blk_rq_prep_clone);

3538
int kblockd_schedule_work(struct work_struct *work)
L
Linus Torvalds 已提交
3539 3540 3541 3542 3543
{
	return queue_work(kblockd_workqueue, work);
}
EXPORT_SYMBOL(kblockd_schedule_work);

3544 3545 3546 3547 3548 3549
int kblockd_schedule_work_on(int cpu, struct work_struct *work)
{
	return queue_work_on(cpu, kblockd_workqueue, work);
}
EXPORT_SYMBOL(kblockd_schedule_work_on);

3550 3551 3552 3553 3554 3555 3556
int kblockd_mod_delayed_work_on(int cpu, struct delayed_work *dwork,
				unsigned long delay)
{
	return mod_delayed_work_on(cpu, kblockd_workqueue, dwork, delay);
}
EXPORT_SYMBOL(kblockd_mod_delayed_work_on);

S
Suresh Jayaraman 已提交
3557 3558 3559 3560 3561 3562 3563 3564 3565 3566 3567 3568 3569 3570
/**
 * blk_start_plug - initialize blk_plug and track it inside the task_struct
 * @plug:	The &struct blk_plug that needs to be initialized
 *
 * Description:
 *   Tracking blk_plug inside the task_struct will help with auto-flushing the
 *   pending I/O should the task end up blocking between blk_start_plug() and
 *   blk_finish_plug(). This is important from a performance perspective, but
 *   also ensures that we don't deadlock. For instance, if the task is blocking
 *   for a memory allocation, memory reclaim could end up wanting to free a
 *   page belonging to that request that is currently residing in our private
 *   plug. By flushing the pending I/O when the process goes to sleep, we avoid
 *   this kind of deadlock.
 */
3571 3572 3573 3574
void blk_start_plug(struct blk_plug *plug)
{
	struct task_struct *tsk = current;

S
Shaohua Li 已提交
3575 3576 3577 3578 3579 3580
	/*
	 * If this is a nested plug, don't actually assign it.
	 */
	if (tsk->plug)
		return;

3581
	INIT_LIST_HEAD(&plug->list);
3582
	INIT_LIST_HEAD(&plug->mq_list);
3583
	INIT_LIST_HEAD(&plug->cb_list);
3584
	/*
S
Shaohua Li 已提交
3585 3586
	 * Store ordering should not be needed here, since a potential
	 * preempt will imply a full memory barrier
3587
	 */
S
Shaohua Li 已提交
3588
	tsk->plug = plug;
3589 3590 3591 3592 3593 3594 3595 3596
}
EXPORT_SYMBOL(blk_start_plug);

static int plug_rq_cmp(void *priv, struct list_head *a, struct list_head *b)
{
	struct request *rqa = container_of(a, struct request, queuelist);
	struct request *rqb = container_of(b, struct request, queuelist);

3597 3598
	return !(rqa->q < rqb->q ||
		(rqa->q == rqb->q && blk_rq_pos(rqa) < blk_rq_pos(rqb)));
3599 3600
}

3601 3602 3603 3604 3605 3606
/*
 * If 'from_schedule' is true, then postpone the dispatch of requests
 * until a safe kblockd context. We due this to avoid accidental big
 * additional stack usage in driver dispatch, in places where the originally
 * plugger did not intend it.
 */
3607
static void queue_unplugged(struct request_queue *q, unsigned int depth,
3608
			    bool from_schedule)
3609
	__releases(q->queue_lock)
3610
{
3611 3612
	lockdep_assert_held(q->queue_lock);

3613
	trace_block_unplug(q, depth, !from_schedule);
3614

3615
	if (from_schedule)
3616
		blk_run_queue_async(q);
3617
	else
3618
		__blk_run_queue(q);
3619
	spin_unlock_irq(q->queue_lock);
3620 3621
}

3622
static void flush_plug_callbacks(struct blk_plug *plug, bool from_schedule)
3623 3624 3625
{
	LIST_HEAD(callbacks);

S
Shaohua Li 已提交
3626 3627
	while (!list_empty(&plug->cb_list)) {
		list_splice_init(&plug->cb_list, &callbacks);
3628

S
Shaohua Li 已提交
3629 3630
		while (!list_empty(&callbacks)) {
			struct blk_plug_cb *cb = list_first_entry(&callbacks,
3631 3632
							  struct blk_plug_cb,
							  list);
S
Shaohua Li 已提交
3633
			list_del(&cb->list);
3634
			cb->callback(cb, from_schedule);
S
Shaohua Li 已提交
3635
		}
3636 3637 3638
	}
}

3639 3640 3641 3642 3643 3644 3645 3646 3647 3648 3649 3650 3651 3652 3653 3654 3655 3656 3657 3658 3659 3660 3661 3662 3663
struct blk_plug_cb *blk_check_plugged(blk_plug_cb_fn unplug, void *data,
				      int size)
{
	struct blk_plug *plug = current->plug;
	struct blk_plug_cb *cb;

	if (!plug)
		return NULL;

	list_for_each_entry(cb, &plug->cb_list, list)
		if (cb->callback == unplug && cb->data == data)
			return cb;

	/* Not currently on the callback list */
	BUG_ON(size < sizeof(*cb));
	cb = kzalloc(size, GFP_ATOMIC);
	if (cb) {
		cb->data = data;
		cb->callback = unplug;
		list_add(&cb->list, &plug->cb_list);
	}
	return cb;
}
EXPORT_SYMBOL(blk_check_plugged);

3664
void blk_flush_plug_list(struct blk_plug *plug, bool from_schedule)
3665 3666 3667
{
	struct request_queue *q;
	struct request *rq;
3668
	LIST_HEAD(list);
3669
	unsigned int depth;
3670

3671
	flush_plug_callbacks(plug, from_schedule);
3672 3673 3674 3675

	if (!list_empty(&plug->mq_list))
		blk_mq_flush_plug_list(plug, from_schedule);

3676 3677 3678
	if (list_empty(&plug->list))
		return;

3679 3680
	list_splice_init(&plug->list, &list);

3681
	list_sort(NULL, &list, plug_rq_cmp);
3682 3683

	q = NULL;
3684
	depth = 0;
3685

3686 3687
	while (!list_empty(&list)) {
		rq = list_entry_rq(list.next);
3688 3689 3690
		list_del_init(&rq->queuelist);
		BUG_ON(!rq->q);
		if (rq->q != q) {
3691 3692 3693 3694
			/*
			 * This drops the queue lock
			 */
			if (q)
3695
				queue_unplugged(q, depth, from_schedule);
3696
			q = rq->q;
3697
			depth = 0;
3698
			spin_lock_irq(q->queue_lock);
3699
		}
3700 3701 3702 3703

		/*
		 * Short-circuit if @q is dead
		 */
B
Bart Van Assche 已提交
3704
		if (unlikely(blk_queue_dying(q))) {
3705
			__blk_end_request_all(rq, BLK_STS_IOERR);
3706 3707 3708
			continue;
		}

3709 3710 3711
		/*
		 * rq is already accounted, so use raw insert
		 */
3712
		if (op_is_flush(rq->cmd_flags))
3713 3714 3715
			__elv_add_request(q, rq, ELEVATOR_INSERT_FLUSH);
		else
			__elv_add_request(q, rq, ELEVATOR_INSERT_SORT_MERGE);
3716 3717

		depth++;
3718 3719
	}

3720 3721 3722 3723
	/*
	 * This drops the queue lock
	 */
	if (q)
3724
		queue_unplugged(q, depth, from_schedule);
3725 3726 3727 3728
}

void blk_finish_plug(struct blk_plug *plug)
{
S
Shaohua Li 已提交
3729 3730
	if (plug != current->plug)
		return;
3731
	blk_flush_plug_list(plug, false);
3732

S
Shaohua Li 已提交
3733
	current->plug = NULL;
3734
}
3735
EXPORT_SYMBOL(blk_finish_plug);
3736

3737
#ifdef CONFIG_PM
L
Lin Ming 已提交
3738 3739 3740 3741 3742 3743 3744 3745 3746 3747 3748 3749 3750 3751 3752 3753 3754 3755 3756 3757 3758 3759 3760
/**
 * blk_pm_runtime_init - Block layer runtime PM initialization routine
 * @q: the queue of the device
 * @dev: the device the queue belongs to
 *
 * Description:
 *    Initialize runtime-PM-related fields for @q and start auto suspend for
 *    @dev. Drivers that want to take advantage of request-based runtime PM
 *    should call this function after @dev has been initialized, and its
 *    request queue @q has been allocated, and runtime PM for it can not happen
 *    yet(either due to disabled/forbidden or its usage_count > 0). In most
 *    cases, driver should call this function before any I/O has taken place.
 *
 *    This function takes care of setting up using auto suspend for the device,
 *    the autosuspend delay is set to -1 to make runtime suspend impossible
 *    until an updated value is either set by user or by driver. Drivers do
 *    not need to touch other autosuspend settings.
 *
 *    The block layer runtime PM is request based, so only works for drivers
 *    that use request as their IO unit instead of those directly use bio's.
 */
void blk_pm_runtime_init(struct request_queue *q, struct device *dev)
{
3761 3762 3763 3764
	/* not support for RQF_PM and ->rpm_status in blk-mq yet */
	if (q->mq_ops)
		return;

L
Lin Ming 已提交
3765 3766 3767 3768 3769 3770 3771 3772 3773 3774 3775 3776 3777 3778 3779 3780 3781 3782 3783 3784 3785 3786 3787 3788 3789 3790 3791 3792 3793 3794 3795 3796
	q->dev = dev;
	q->rpm_status = RPM_ACTIVE;
	pm_runtime_set_autosuspend_delay(q->dev, -1);
	pm_runtime_use_autosuspend(q->dev);
}
EXPORT_SYMBOL(blk_pm_runtime_init);

/**
 * blk_pre_runtime_suspend - Pre runtime suspend check
 * @q: the queue of the device
 *
 * Description:
 *    This function will check if runtime suspend is allowed for the device
 *    by examining if there are any requests pending in the queue. If there
 *    are requests pending, the device can not be runtime suspended; otherwise,
 *    the queue's status will be updated to SUSPENDING and the driver can
 *    proceed to suspend the device.
 *
 *    For the not allowed case, we mark last busy for the device so that
 *    runtime PM core will try to autosuspend it some time later.
 *
 *    This function should be called near the start of the device's
 *    runtime_suspend callback.
 *
 * Return:
 *    0		- OK to runtime suspend the device
 *    -EBUSY	- Device should not be runtime suspended
 */
int blk_pre_runtime_suspend(struct request_queue *q)
{
	int ret = 0;

3797 3798 3799
	if (!q->dev)
		return ret;

L
Lin Ming 已提交
3800 3801 3802 3803 3804 3805 3806 3807 3808 3809 3810 3811 3812 3813 3814 3815 3816 3817 3818 3819 3820 3821 3822 3823 3824 3825 3826
	spin_lock_irq(q->queue_lock);
	if (q->nr_pending) {
		ret = -EBUSY;
		pm_runtime_mark_last_busy(q->dev);
	} else {
		q->rpm_status = RPM_SUSPENDING;
	}
	spin_unlock_irq(q->queue_lock);
	return ret;
}
EXPORT_SYMBOL(blk_pre_runtime_suspend);

/**
 * blk_post_runtime_suspend - Post runtime suspend processing
 * @q: the queue of the device
 * @err: return value of the device's runtime_suspend function
 *
 * Description:
 *    Update the queue's runtime status according to the return value of the
 *    device's runtime suspend function and mark last busy for the device so
 *    that PM core will try to auto suspend the device at a later time.
 *
 *    This function should be called near the end of the device's
 *    runtime_suspend callback.
 */
void blk_post_runtime_suspend(struct request_queue *q, int err)
{
3827 3828 3829
	if (!q->dev)
		return;

L
Lin Ming 已提交
3830 3831 3832 3833 3834 3835 3836 3837 3838 3839 3840 3841 3842 3843 3844 3845 3846 3847 3848 3849 3850 3851 3852 3853
	spin_lock_irq(q->queue_lock);
	if (!err) {
		q->rpm_status = RPM_SUSPENDED;
	} else {
		q->rpm_status = RPM_ACTIVE;
		pm_runtime_mark_last_busy(q->dev);
	}
	spin_unlock_irq(q->queue_lock);
}
EXPORT_SYMBOL(blk_post_runtime_suspend);

/**
 * blk_pre_runtime_resume - Pre runtime resume processing
 * @q: the queue of the device
 *
 * Description:
 *    Update the queue's runtime status to RESUMING in preparation for the
 *    runtime resume of the device.
 *
 *    This function should be called near the start of the device's
 *    runtime_resume callback.
 */
void blk_pre_runtime_resume(struct request_queue *q)
{
3854 3855 3856
	if (!q->dev)
		return;

L
Lin Ming 已提交
3857 3858 3859 3860 3861 3862 3863 3864 3865 3866 3867 3868 3869 3870 3871 3872 3873 3874 3875 3876 3877 3878
	spin_lock_irq(q->queue_lock);
	q->rpm_status = RPM_RESUMING;
	spin_unlock_irq(q->queue_lock);
}
EXPORT_SYMBOL(blk_pre_runtime_resume);

/**
 * blk_post_runtime_resume - Post runtime resume processing
 * @q: the queue of the device
 * @err: return value of the device's runtime_resume function
 *
 * Description:
 *    Update the queue's runtime status according to the return value of the
 *    device's runtime_resume function. If it is successfully resumed, process
 *    the requests that are queued into the device's queue when it is resuming
 *    and then mark last busy and initiate autosuspend for it.
 *
 *    This function should be called near the end of the device's
 *    runtime_resume callback.
 */
void blk_post_runtime_resume(struct request_queue *q, int err)
{
3879 3880 3881
	if (!q->dev)
		return;

L
Lin Ming 已提交
3882 3883 3884 3885 3886
	spin_lock_irq(q->queue_lock);
	if (!err) {
		q->rpm_status = RPM_ACTIVE;
		__blk_run_queue(q);
		pm_runtime_mark_last_busy(q->dev);
3887
		pm_request_autosuspend(q->dev);
L
Lin Ming 已提交
3888 3889 3890 3891 3892 3893
	} else {
		q->rpm_status = RPM_SUSPENDED;
	}
	spin_unlock_irq(q->queue_lock);
}
EXPORT_SYMBOL(blk_post_runtime_resume);
3894 3895 3896 3897 3898 3899 3900 3901 3902 3903 3904 3905 3906 3907 3908 3909 3910 3911 3912 3913 3914 3915 3916 3917

/**
 * blk_set_runtime_active - Force runtime status of the queue to be active
 * @q: the queue of the device
 *
 * If the device is left runtime suspended during system suspend the resume
 * hook typically resumes the device and corrects runtime status
 * accordingly. However, that does not affect the queue runtime PM status
 * which is still "suspended". This prevents processing requests from the
 * queue.
 *
 * This function can be used in driver's resume hook to correct queue
 * runtime PM status and re-enable peeking requests from the queue. It
 * should be called before first request is added to the queue.
 */
void blk_set_runtime_active(struct request_queue *q)
{
	spin_lock_irq(q->queue_lock);
	q->rpm_status = RPM_ACTIVE;
	pm_runtime_mark_last_busy(q->dev);
	pm_request_autosuspend(q->dev);
	spin_unlock_irq(q->queue_lock);
}
EXPORT_SYMBOL(blk_set_runtime_active);
L
Lin Ming 已提交
3918 3919
#endif

L
Linus Torvalds 已提交
3920 3921
int __init blk_dev_init(void)
{
3922 3923
	BUILD_BUG_ON(REQ_OP_LAST >= (1 << REQ_OP_BITS));
	BUILD_BUG_ON(REQ_OP_BITS + REQ_FLAG_BITS > 8 *
3924
			FIELD_SIZEOF(struct request, cmd_flags));
3925 3926
	BUILD_BUG_ON(REQ_OP_BITS + REQ_FLAG_BITS > 8 *
			FIELD_SIZEOF(struct bio, bi_opf));
3927

3928 3929
	/* used for unplugging and affects IO latency/throughput - HIGHPRI */
	kblockd_workqueue = alloc_workqueue("kblockd",
3930
					    WQ_MEM_RECLAIM | WQ_HIGHPRI, 0);
L
Linus Torvalds 已提交
3931 3932 3933 3934
	if (!kblockd_workqueue)
		panic("Failed to create kblockd\n");

	request_cachep = kmem_cache_create("blkdev_requests",
3935
			sizeof(struct request), 0, SLAB_PANIC, NULL);
L
Linus Torvalds 已提交
3936

3937
	blk_requestq_cachep = kmem_cache_create("request_queue",
3938
			sizeof(struct request_queue), 0, SLAB_PANIC, NULL);
L
Linus Torvalds 已提交
3939

3940 3941 3942 3943
#ifdef CONFIG_DEBUG_FS
	blk_debugfs_root = debugfs_create_dir("block", NULL);
#endif

3944
	return 0;
L
Linus Torvalds 已提交
3945
}