blk-core.c 89.1 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 36 37

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

39
#include "blk.h"
40
#include "blk-cgroup.h"
41
#include "blk-mq.h"
42

43
EXPORT_TRACEPOINT_SYMBOL_GPL(block_bio_remap);
44
EXPORT_TRACEPOINT_SYMBOL_GPL(block_rq_remap);
45
EXPORT_TRACEPOINT_SYMBOL_GPL(block_bio_complete);
N
NeilBrown 已提交
46
EXPORT_TRACEPOINT_SYMBOL_GPL(block_unplug);
47

48 49
DEFINE_IDA(blk_queue_ida);

L
Linus Torvalds 已提交
50 51 52
/*
 * For the allocated request tables
 */
53
struct kmem_cache *request_cachep = NULL;
L
Linus Torvalds 已提交
54 55 56 57

/*
 * For queue allocation
 */
58
struct kmem_cache *blk_requestq_cachep;
L
Linus Torvalds 已提交
59 60 61 62

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

65
void blk_queue_congestion_threshold(struct request_queue *q)
L
Linus Torvalds 已提交
66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91
{
	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;
}

/**
 * blk_get_backing_dev_info - get the address of a queue's backing_dev_info
 * @bdev:	device
 *
 * Locates the passed device's request queue and returns the address of its
 * backing_dev_info
 *
 * Will return NULL if the request queue cannot be located.
 */
struct backing_dev_info *blk_get_backing_dev_info(struct block_device *bdev)
{
	struct backing_dev_info *ret = NULL;
92
	struct request_queue *q = bdev_get_queue(bdev);
L
Linus Torvalds 已提交
93 94 95 96 97 98 99

	if (q)
		ret = &q->backing_dev_info;
	return ret;
}
EXPORT_SYMBOL(blk_get_backing_dev_info);

100
void blk_rq_init(struct request_queue *q, struct request *rq)
L
Linus Torvalds 已提交
101
{
102 103
	memset(rq, 0, sizeof(*rq));

L
Linus Torvalds 已提交
104
	INIT_LIST_HEAD(&rq->queuelist);
J
Jens Axboe 已提交
105
	INIT_LIST_HEAD(&rq->timeout_list);
106
	rq->cpu = -1;
J
Jens Axboe 已提交
107
	rq->q = q;
108
	rq->__sector = (sector_t) -1;
109 110
	INIT_HLIST_NODE(&rq->hash);
	RB_CLEAR_NODE(&rq->rb_node);
111
	rq->cmd = rq->__cmd;
112
	rq->cmd_len = BLK_MAX_CDB;
J
Jens Axboe 已提交
113
	rq->tag = -1;
114
	rq->start_time = jiffies;
115
	set_start_time_ns(rq);
116
	rq->part = NULL;
L
Linus Torvalds 已提交
117
}
118
EXPORT_SYMBOL(blk_rq_init);
L
Linus Torvalds 已提交
119

N
NeilBrown 已提交
120 121
static void req_bio_endio(struct request *rq, struct bio *bio,
			  unsigned int nbytes, int error)
L
Linus Torvalds 已提交
122
{
T
Tejun Heo 已提交
123 124 125 126
	if (error)
		clear_bit(BIO_UPTODATE, &bio->bi_flags);
	else if (!test_bit(BIO_UPTODATE, &bio->bi_flags))
		error = -EIO;
127

T
Tejun Heo 已提交
128 129
	if (unlikely(rq->cmd_flags & REQ_QUIET))
		set_bit(BIO_QUIET, &bio->bi_flags);
130

131
	bio_advance(bio, nbytes);
132

T
Tejun Heo 已提交
133
	/* don't actually finish bio if it's part of flush sequence */
134
	if (bio->bi_iter.bi_size == 0 && !(rq->cmd_flags & REQ_FLUSH_SEQ))
T
Tejun Heo 已提交
135
		bio_endio(bio, error);
L
Linus Torvalds 已提交
136 137 138 139 140 141
}

void blk_dump_rq_flags(struct request *rq, char *msg)
{
	int bit;

J
Jens Axboe 已提交
142
	printk(KERN_INFO "%s: dev %s: type=%x, flags=%llx\n", msg,
143
		rq->rq_disk ? rq->rq_disk->disk_name : "?", rq->cmd_type,
J
Jens Axboe 已提交
144
		(unsigned long long) rq->cmd_flags);
L
Linus Torvalds 已提交
145

146 147 148
	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));
149 150
	printk(KERN_INFO "  bio %p, biotail %p, len %u\n",
	       rq->bio, rq->biotail, blk_rq_bytes(rq));
L
Linus Torvalds 已提交
151

152
	if (rq->cmd_type == REQ_TYPE_BLOCK_PC) {
153
		printk(KERN_INFO "  cdb: ");
154
		for (bit = 0; bit < BLK_MAX_CDB; bit++)
L
Linus Torvalds 已提交
155 156 157 158 159 160
			printk("%02x ", rq->cmd[bit]);
		printk("\n");
	}
}
EXPORT_SYMBOL(blk_dump_rq_flags);

161
static void blk_delay_work(struct work_struct *work)
L
Linus Torvalds 已提交
162
{
163
	struct request_queue *q;
L
Linus Torvalds 已提交
164

165 166
	q = container_of(work, struct request_queue, delay_work.work);
	spin_lock_irq(q->queue_lock);
167
	__blk_run_queue(q);
168
	spin_unlock_irq(q->queue_lock);
L
Linus Torvalds 已提交
169 170 171
}

/**
172 173 174
 * blk_delay_queue - restart queueing after defined interval
 * @q:		The &struct request_queue in question
 * @msecs:	Delay in msecs
L
Linus Torvalds 已提交
175 176
 *
 * Description:
177 178
 *   Sometimes queueing needs to be postponed for a little while, to allow
 *   resources to come back. This function will make sure that queueing is
179
 *   restarted around the specified time. Queue lock must be held.
180 181
 */
void blk_delay_queue(struct request_queue *q, unsigned long msecs)
182
{
183 184 185
	if (likely(!blk_queue_dead(q)))
		queue_delayed_work(kblockd_workqueue, &q->delay_work,
				   msecs_to_jiffies(msecs));
186
}
187
EXPORT_SYMBOL(blk_delay_queue);
188

L
Linus Torvalds 已提交
189 190
/**
 * blk_start_queue - restart a previously stopped queue
191
 * @q:    The &struct request_queue in question
L
Linus Torvalds 已提交
192 193 194 195 196 197
 *
 * 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
 *   entered. Also see blk_stop_queue(). Queue lock must be held.
 **/
198
void blk_start_queue(struct request_queue *q)
L
Linus Torvalds 已提交
199
{
200 201
	WARN_ON(!irqs_disabled());

N
Nick Piggin 已提交
202
	queue_flag_clear(QUEUE_FLAG_STOPPED, q);
203
	__blk_run_queue(q);
L
Linus Torvalds 已提交
204 205 206 207 208
}
EXPORT_SYMBOL(blk_start_queue);

/**
 * blk_stop_queue - stop a queue
209
 * @q:    The &struct request_queue in question
L
Linus Torvalds 已提交
210 211 212 213 214 215 216 217 218 219 220
 *
 * 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
 *   blk_start_queue() to restart queue operations. Queue lock must be held.
 **/
221
void blk_stop_queue(struct request_queue *q)
L
Linus Torvalds 已提交
222
{
223
	cancel_delayed_work(&q->delay_work);
N
Nick Piggin 已提交
224
	queue_flag_set(QUEUE_FLAG_STOPPED, q);
L
Linus Torvalds 已提交
225 226 227 228 229 230 231 232 233 234 235 236
}
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
237
 *     that the callbacks might use. The caller must already have made sure
L
Linus Torvalds 已提交
238 239 240
 *     that its ->make_request_fn will not re-add plugging prior to calling
 *     this function.
 *
241 242
 *     This function does not cancel any asynchronous activity arising
 *     out of elevator or throttling code. That would require elevaotor_exit()
243
 *     and blkcg_exit_queue() to be called with queue lock initialized.
244
 *
L
Linus Torvalds 已提交
245 246 247
 */
void blk_sync_queue(struct request_queue *q)
{
248
	del_timer_sync(&q->timeout);
249 250 251 252 253

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

254 255 256 257
		queue_for_each_hw_ctx(q, hctx, i) {
			cancel_delayed_work_sync(&hctx->run_work);
			cancel_delayed_work_sync(&hctx->delay_work);
		}
258 259 260
	} else {
		cancel_delayed_work_sync(&q->delay_work);
	}
L
Linus Torvalds 已提交
261 262 263
}
EXPORT_SYMBOL(blk_sync_queue);

264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279
/**
 * __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)
{
	if (unlikely(blk_queue_dead(q)))
		return;

280 281 282 283 284 285 286 287
	/*
	 * 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++;
288
	q->request_fn(q);
289
	q->request_fn_active--;
290 291
}

L
Linus Torvalds 已提交
292
/**
293
 * __blk_run_queue - run a single device queue
L
Linus Torvalds 已提交
294
 * @q:	The queue to run
295 296 297
 *
 * Description:
 *    See @blk_run_queue. This variant must be called with the queue lock
298
 *    held and interrupts disabled.
L
Linus Torvalds 已提交
299
 */
300
void __blk_run_queue(struct request_queue *q)
L
Linus Torvalds 已提交
301
{
302 303 304
	if (unlikely(blk_queue_stopped(q)))
		return;

305
	__blk_run_queue_uncond(q);
N
Nick Piggin 已提交
306 307
}
EXPORT_SYMBOL(__blk_run_queue);
J
Jens Axboe 已提交
308

309 310 311 312 313 314
/**
 * 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
315
 *    of us. The caller must hold the queue lock.
316 317 318
 */
void blk_run_queue_async(struct request_queue *q)
{
319
	if (likely(!blk_queue_stopped(q) && !blk_queue_dead(q)))
320
		mod_delayed_work(kblockd_workqueue, &q->delay_work, 0);
321
}
322
EXPORT_SYMBOL(blk_run_queue_async);
323

N
Nick Piggin 已提交
324 325 326
/**
 * blk_run_queue - run a single device queue
 * @q: The queue to run
327 328 329
 *
 * Description:
 *    Invoke request handling on this queue, if it has pending work to do.
T
Tejun Heo 已提交
330
 *    May be used to restart queueing when a request has completed.
N
Nick Piggin 已提交
331 332 333 334 335 336
 */
void blk_run_queue(struct request_queue *q)
{
	unsigned long flags;

	spin_lock_irqsave(q->queue_lock, flags);
337
	__blk_run_queue(q);
L
Linus Torvalds 已提交
338 339 340 341
	spin_unlock_irqrestore(q->queue_lock, flags);
}
EXPORT_SYMBOL(blk_run_queue);

342
void blk_put_queue(struct request_queue *q)
343 344 345
{
	kobject_put(&q->kobj);
}
J
Jens Axboe 已提交
346
EXPORT_SYMBOL(blk_put_queue);
347

T
Tejun Heo 已提交
348
/**
349
 * __blk_drain_queue - drain requests from request_queue
T
Tejun Heo 已提交
350
 * @q: queue to drain
351
 * @drain_all: whether to drain all requests or only the ones w/ ELVPRIV
T
Tejun Heo 已提交
352
 *
353 354 355
 * 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 已提交
356
 */
357 358 359
static void __blk_drain_queue(struct request_queue *q, bool drain_all)
	__releases(q->queue_lock)
	__acquires(q->queue_lock)
T
Tejun Heo 已提交
360
{
361 362
	int i;

363 364
	lockdep_assert_held(q->queue_lock);

T
Tejun Heo 已提交
365
	while (true) {
366
		bool drain = false;
T
Tejun Heo 已提交
367

368 369 370 371 372 373 374
		/*
		 * The caller might be trying to drain @q before its
		 * elevator is initialized.
		 */
		if (q->elevator)
			elv_drain_elevator(q);

375
		blkcg_drain_queue(q);
T
Tejun Heo 已提交
376

377 378
		/*
		 * This function might be called on a queue which failed
379 380 381 382
		 * 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.
383
		 */
384
		if (!list_empty(&q->queue_head) && q->request_fn)
385
			__blk_run_queue(q);
386

387
		drain |= q->nr_rqs_elvpriv;
388
		drain |= q->request_fn_active;
389 390 391 392 393 394 395 396 397

		/*
		 * 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) {
			drain |= !list_empty(&q->queue_head);
			for (i = 0; i < 2; i++) {
398
				drain |= q->nr_rqs[i];
399 400 401 402
				drain |= q->in_flight[i];
				drain |= !list_empty(&q->flush_queue[i]);
			}
		}
T
Tejun Heo 已提交
403

404
		if (!drain)
T
Tejun Heo 已提交
405
			break;
406 407 408

		spin_unlock_irq(q->queue_lock);

T
Tejun Heo 已提交
409
		msleep(10);
410 411

		spin_lock_irq(q->queue_lock);
T
Tejun Heo 已提交
412
	}
413 414 415 416 417 418 419

	/*
	 * 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) {
420 421 422 423 424
		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]);
425
	}
T
Tejun Heo 已提交
426 427
}

428 429 430 431 432 433
/**
 * 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
434
 * throttled or issued before.  On return, it's guaranteed that no request
435 436
 * is being throttled or has ELVPRIV set and blk_queue_bypass() %true
 * inside queue or RCU read lock.
437 438 439
 */
void blk_queue_bypass_start(struct request_queue *q)
{
440 441
	bool drain;

442
	spin_lock_irq(q->queue_lock);
443
	drain = !q->bypass_depth++;
444 445 446
	queue_flag_set(QUEUE_FLAG_BYPASS, q);
	spin_unlock_irq(q->queue_lock);

447
	if (drain) {
448 449 450 451
		spin_lock_irq(q->queue_lock);
		__blk_drain_queue(q, false);
		spin_unlock_irq(q->queue_lock);

452 453 454
		/* ensure blk_queue_bypass() is %true inside RCU read lock */
		synchronize_rcu();
	}
455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473
}
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.
 */
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);

474 475 476 477
/**
 * blk_cleanup_queue - shutdown a request queue
 * @q: request queue to shutdown
 *
478 479
 * Mark @q DYING, drain all pending requests, mark @q DEAD, destroy and
 * put it.  All future requests will be failed immediately with -ENODEV.
480
 */
481
void blk_cleanup_queue(struct request_queue *q)
482
{
483
	spinlock_t *lock = q->queue_lock;
484

B
Bart Van Assche 已提交
485
	/* mark @q DYING, no new request or merges will be allowed afterwards */
486
	mutex_lock(&q->sysfs_lock);
B
Bart Van Assche 已提交
487
	queue_flag_set_unlocked(QUEUE_FLAG_DYING, q);
488
	spin_lock_irq(lock);
489

490
	/*
B
Bart Van Assche 已提交
491
	 * A dying queue is permanently in bypass mode till released.  Note
492 493 494 495 496 497 498
	 * 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.
	 */
499 500 501
	q->bypass_depth++;
	queue_flag_set(QUEUE_FLAG_BYPASS, q);

502 503
	queue_flag_set(QUEUE_FLAG_NOMERGES, q);
	queue_flag_set(QUEUE_FLAG_NOXMERGES, q);
B
Bart Van Assche 已提交
504
	queue_flag_set(QUEUE_FLAG_DYING, q);
505 506 507
	spin_unlock_irq(lock);
	mutex_unlock(&q->sysfs_lock);

508 509 510 511
	/*
	 * Drain all requests queued before DYING marking. Set DEAD flag to
	 * prevent that q->request_fn() gets invoked after draining finished.
	 */
512 513 514 515 516 517 518
	if (q->mq_ops) {
		blk_mq_drain_queue(q);
		spin_lock_irq(lock);
	} else {
		spin_lock_irq(lock);
		__blk_drain_queue(q, true);
	}
519
	queue_flag_set(QUEUE_FLAG_DEAD, q);
520
	spin_unlock_irq(lock);
521 522 523 524 525

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

526 527 528 529 530
	spin_lock_irq(lock);
	if (q->queue_lock != &q->__queue_lock)
		q->queue_lock = &q->__queue_lock;
	spin_unlock_irq(lock);

531
	/* @q is and will stay empty, shutdown and put */
532 533
	blk_put_queue(q);
}
L
Linus Torvalds 已提交
534 535
EXPORT_SYMBOL(blk_cleanup_queue);

536 537
int blk_init_rl(struct request_list *rl, struct request_queue *q,
		gfp_t gfp_mask)
L
Linus Torvalds 已提交
538
{
539 540 541
	if (unlikely(rl->rq_pool))
		return 0;

542
	rl->q = q;
543 544 545 546
	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 已提交
547

548
	rl->rq_pool = mempool_create_node(BLKDEV_MIN_RQ, mempool_alloc_slab,
549
					  mempool_free_slab, request_cachep,
550
					  gfp_mask, q->node);
L
Linus Torvalds 已提交
551 552 553 554 555 556
	if (!rl->rq_pool)
		return -ENOMEM;

	return 0;
}

557 558 559 560 561 562
void blk_exit_rl(struct request_list *rl)
{
	if (rl->rq_pool)
		mempool_destroy(rl->rq_pool);
}

563
struct request_queue *blk_alloc_queue(gfp_t gfp_mask)
L
Linus Torvalds 已提交
564
{
565
	return blk_alloc_queue_node(gfp_mask, NUMA_NO_NODE);
566 567
}
EXPORT_SYMBOL(blk_alloc_queue);
L
Linus Torvalds 已提交
568

569
struct request_queue *blk_alloc_queue_node(gfp_t gfp_mask, int node_id)
570
{
571
	struct request_queue *q;
P
Peter Zijlstra 已提交
572
	int err;
573

574
	q = kmem_cache_alloc_node(blk_requestq_cachep,
575
				gfp_mask | __GFP_ZERO, node_id);
L
Linus Torvalds 已提交
576 577 578
	if (!q)
		return NULL;

579
	q->id = ida_simple_get(&blk_queue_ida, 0, 0, gfp_mask);
580
	if (q->id < 0)
581
		goto fail_q;
582

583 584 585 586
	q->backing_dev_info.ra_pages =
			(VM_MAX_READAHEAD * 1024) / PAGE_CACHE_SIZE;
	q->backing_dev_info.state = 0;
	q->backing_dev_info.capabilities = BDI_CAP_MAP_COPY;
587
	q->backing_dev_info.name = "block";
588
	q->node = node_id;
589

P
Peter Zijlstra 已提交
590
	err = bdi_init(&q->backing_dev_info);
591 592
	if (err)
		goto fail_id;
P
Peter Zijlstra 已提交
593

594 595
	setup_timer(&q->backing_dev_info.laptop_mode_wb_timer,
		    laptop_mode_timer_fn, (unsigned long) q);
J
Jens Axboe 已提交
596
	setup_timer(&q->timeout, blk_rq_timed_out_timer, (unsigned long) q);
597
	INIT_LIST_HEAD(&q->queue_head);
J
Jens Axboe 已提交
598
	INIT_LIST_HEAD(&q->timeout_list);
599
	INIT_LIST_HEAD(&q->icq_list);
600
#ifdef CONFIG_BLK_CGROUP
601
	INIT_LIST_HEAD(&q->blkg_list);
602
#endif
603 604 605
	INIT_LIST_HEAD(&q->flush_queue[0]);
	INIT_LIST_HEAD(&q->flush_queue[1]);
	INIT_LIST_HEAD(&q->flush_data_in_flight);
606
	INIT_DELAYED_WORK(&q->delay_work, blk_delay_work);
607

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

610
	mutex_init(&q->sysfs_lock);
611
	spin_lock_init(&q->__queue_lock);
612

613 614 615 616 617 618
	/*
	 * By default initialize queue_lock to internal lock and driver can
	 * override it later if need be.
	 */
	q->queue_lock = &q->__queue_lock;

619 620 621
	/*
	 * A queue starts its life with bypass turned on to avoid
	 * unnecessary bypass on/off overhead and nasty surprises during
622 623
	 * init.  The initial bypass will be finished when the queue is
	 * registered by blk_register_queue().
624 625 626 627
	 */
	q->bypass_depth = 1;
	__set_bit(QUEUE_FLAG_BYPASS, &q->queue_flags);

628 629
	init_waitqueue_head(&q->mq_freeze_wq);

630
	if (blkcg_init_queue(q))
631
		goto fail_bdi;
632

L
Linus Torvalds 已提交
633
	return q;
634

635 636
fail_bdi:
	bdi_destroy(&q->backing_dev_info);
637 638 639 640 641
fail_id:
	ida_simple_remove(&blk_queue_ida, q->id);
fail_q:
	kmem_cache_free(blk_requestq_cachep, q);
	return NULL;
L
Linus Torvalds 已提交
642
}
643
EXPORT_SYMBOL(blk_alloc_queue_node);
L
Linus Torvalds 已提交
644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666

/**
 * 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
667 668
 *    request queue; this lock will be taken also from interrupt context, so irq
 *    disabling is needed for it.
L
Linus Torvalds 已提交
669
 *
670
 *    Function returns a pointer to the initialized request queue, or %NULL if
L
Linus Torvalds 已提交
671 672 673 674 675 676
 *    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).
 **/
677

678
struct request_queue *blk_init_queue(request_fn_proc *rfn, spinlock_t *lock)
L
Linus Torvalds 已提交
679
{
680
	return blk_init_queue_node(rfn, lock, NUMA_NO_NODE);
681 682 683
}
EXPORT_SYMBOL(blk_init_queue);

684
struct request_queue *
685 686
blk_init_queue_node(request_fn_proc *rfn, spinlock_t *lock, int node_id)
{
687
	struct request_queue *uninit_q, *q;
L
Linus Torvalds 已提交
688

689 690 691 692
	uninit_q = blk_alloc_queue_node(GFP_KERNEL, node_id);
	if (!uninit_q)
		return NULL;

693
	q = blk_init_allocated_queue(uninit_q, rfn, lock);
694
	if (!q)
695
		blk_cleanup_queue(uninit_q);
696

697
	return q;
698 699 700 701 702 703 704
}
EXPORT_SYMBOL(blk_init_queue_node);

struct request_queue *
blk_init_allocated_queue(struct request_queue *q, request_fn_proc *rfn,
			 spinlock_t *lock)
{
L
Linus Torvalds 已提交
705 706 707
	if (!q)
		return NULL;

708 709 710 711
	q->flush_rq = kzalloc(sizeof(struct request), GFP_KERNEL);
	if (!q->flush_rq)
		return NULL;

712
	if (blk_init_rl(&q->root_rl, q, GFP_KERNEL))
713
		goto fail;
L
Linus Torvalds 已提交
714 715 716

	q->request_fn		= rfn;
	q->prep_rq_fn		= NULL;
717
	q->unprep_rq_fn		= NULL;
718
	q->queue_flags		|= QUEUE_FLAG_DEFAULT;
719 720 721 722

	/* Override internal queue lock with supplied lock pointer */
	if (lock)
		q->queue_lock		= lock;
L
Linus Torvalds 已提交
723

724 725 726
	/*
	 * This also sets hw/phys segments, boundary and size
	 */
727
	blk_queue_make_request(q, blk_queue_bio);
L
Linus Torvalds 已提交
728

729 730
	q->sg_reserved_size = INT_MAX;

731 732 733
	/* Protect q->elevator from elevator_change */
	mutex_lock(&q->sysfs_lock);

734
	/* init elevator */
735 736
	if (elevator_init(q, NULL)) {
		mutex_unlock(&q->sysfs_lock);
737
		goto fail;
738 739 740 741
	}

	mutex_unlock(&q->sysfs_lock);

742
	return q;
743 744 745 746

fail:
	kfree(q->flush_rq);
	return NULL;
L
Linus Torvalds 已提交
747
}
748
EXPORT_SYMBOL(blk_init_allocated_queue);
L
Linus Torvalds 已提交
749

T
Tejun Heo 已提交
750
bool blk_get_queue(struct request_queue *q)
L
Linus Torvalds 已提交
751
{
B
Bart Van Assche 已提交
752
	if (likely(!blk_queue_dying(q))) {
T
Tejun Heo 已提交
753 754
		__blk_get_queue(q);
		return true;
L
Linus Torvalds 已提交
755 756
	}

T
Tejun Heo 已提交
757
	return false;
L
Linus Torvalds 已提交
758
}
J
Jens Axboe 已提交
759
EXPORT_SYMBOL(blk_get_queue);
L
Linus Torvalds 已提交
760

761
static inline void blk_free_request(struct request_list *rl, struct request *rq)
L
Linus Torvalds 已提交
762
{
763
	if (rq->cmd_flags & REQ_ELVPRIV) {
764
		elv_put_request(rl->q, rq);
765
		if (rq->elv.icq)
766
			put_io_context(rq->elv.icq->ioc);
767 768
	}

769
	mempool_free(rq, rl->rq_pool);
L
Linus Torvalds 已提交
770 771 772 773 774 775
}

/*
 * ioc_batching returns true if the ioc is a valid batching request and
 * should be given priority access to a request.
 */
776
static inline int ioc_batching(struct request_queue *q, struct io_context *ioc)
L
Linus Torvalds 已提交
777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796
{
	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.
 */
797
static void ioc_set_batching(struct request_queue *q, struct io_context *ioc)
L
Linus Torvalds 已提交
798 799 800 801 802 803 804 805
{
	if (!ioc || ioc_batching(q, ioc))
		return;

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

806
static void __freed_request(struct request_list *rl, int sync)
L
Linus Torvalds 已提交
807
{
808
	struct request_queue *q = rl->q;
L
Linus Torvalds 已提交
809

810 811 812 813 814 815
	/*
	 * bdi isn't aware of blkcg yet.  As all async IOs end up root
	 * blkcg anyway, just use root blkcg state.
	 */
	if (rl == &q->root_rl &&
	    rl->count[sync] < queue_congestion_off_threshold(q))
816
		blk_clear_queue_congested(q, sync);
L
Linus Torvalds 已提交
817

818 819 820
	if (rl->count[sync] + 1 <= q->nr_requests) {
		if (waitqueue_active(&rl->wait[sync]))
			wake_up(&rl->wait[sync]);
L
Linus Torvalds 已提交
821

822
		blk_clear_rl_full(rl, sync);
L
Linus Torvalds 已提交
823 824 825 826 827 828 829
	}
}

/*
 * A request has just been released.  Account for it, update the full and
 * congestion status, wake up any waiters.   Called under q->queue_lock.
 */
830
static void freed_request(struct request_list *rl, unsigned int flags)
L
Linus Torvalds 已提交
831
{
832
	struct request_queue *q = rl->q;
833
	int sync = rw_is_sync(flags);
L
Linus Torvalds 已提交
834

835
	q->nr_rqs[sync]--;
836
	rl->count[sync]--;
837
	if (flags & REQ_ELVPRIV)
838
		q->nr_rqs_elvpriv--;
L
Linus Torvalds 已提交
839

840
	__freed_request(rl, sync);
L
Linus Torvalds 已提交
841

842
	if (unlikely(rl->starved[sync ^ 1]))
843
		__freed_request(rl, sync ^ 1);
L
Linus Torvalds 已提交
844 845
}

846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886
int blk_update_nr_requests(struct request_queue *q, unsigned int nr)
{
	struct request_list *rl;

	spin_lock_irq(q->queue_lock);
	q->nr_requests = nr;
	blk_queue_congestion_threshold(q);

	/* congestion isn't cgroup aware and follows root blkcg for now */
	rl = &q->root_rl;

	if (rl->count[BLK_RW_SYNC] >= queue_congestion_on_threshold(q))
		blk_set_queue_congested(q, BLK_RW_SYNC);
	else if (rl->count[BLK_RW_SYNC] < queue_congestion_off_threshold(q))
		blk_clear_queue_congested(q, BLK_RW_SYNC);

	if (rl->count[BLK_RW_ASYNC] >= queue_congestion_on_threshold(q))
		blk_set_queue_congested(q, BLK_RW_ASYNC);
	else if (rl->count[BLK_RW_ASYNC] < queue_congestion_off_threshold(q))
		blk_clear_queue_congested(q, BLK_RW_ASYNC);

	blk_queue_for_each_rl(rl, q) {
		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;
}

887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905
/*
 * Determine if elevator data should be initialized when allocating the
 * request associated with @bio.
 */
static bool blk_rq_should_init_elevator(struct bio *bio)
{
	if (!bio)
		return true;

	/*
	 * Flush requests do not use the elevator so skip initialization.
	 * This allows a request to share the flush and elevator data.
	 */
	if (bio->bi_rw & (REQ_FLUSH | REQ_FUA))
		return false;

	return true;
}

906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921
/**
 * rq_ioc - determine io_context for request allocation
 * @bio: request being allocated is for this bio (can be %NULL)
 *
 * Determine io_context to use for request allocation for @bio.  May return
 * %NULL if %current->io_context doesn't exist.
 */
static struct io_context *rq_ioc(struct bio *bio)
{
#ifdef CONFIG_BLK_CGROUP
	if (bio && bio->bi_ioc)
		return bio->bi_ioc;
#endif
	return current->io_context;
}

922
/**
T
Tejun Heo 已提交
923
 * __get_request - get a free request
924
 * @rl: request list to allocate from
925 926 927 928 929 930 931 932 933 934
 * @rw_flags: RW and SYNC flags
 * @bio: bio to allocate request for (can be %NULL)
 * @gfp_mask: allocation mask
 *
 * Get a free request from @q.  This function may fail under memory
 * pressure or if @q is dead.
 *
 * Must be callled with @q->queue_lock held and,
 * Returns %NULL on failure, with @q->queue_lock held.
 * Returns !%NULL on success, with @q->queue_lock *not held*.
L
Linus Torvalds 已提交
935
 */
936
static struct request *__get_request(struct request_list *rl, int rw_flags,
T
Tejun Heo 已提交
937
				     struct bio *bio, gfp_t gfp_mask)
L
Linus Torvalds 已提交
938
{
939
	struct request_queue *q = rl->q;
T
Tejun Heo 已提交
940
	struct request *rq;
T
Tejun Heo 已提交
941 942
	struct elevator_type *et = q->elevator->type;
	struct io_context *ioc = rq_ioc(bio);
943
	struct io_cq *icq = NULL;
944
	const bool is_sync = rw_is_sync(rw_flags) != 0;
945
	int may_queue;
946

B
Bart Van Assche 已提交
947
	if (unlikely(blk_queue_dying(q)))
948 949
		return NULL;

950
	may_queue = elv_may_queue(q, rw_flags);
951 952 953
	if (may_queue == ELV_MQUEUE_NO)
		goto rq_starved;

954 955
	if (rl->count[is_sync]+1 >= queue_congestion_on_threshold(q)) {
		if (rl->count[is_sync]+1 >= q->nr_requests) {
956 957 958 959 960 961
			/*
			 * 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.
			 */
962
			if (!blk_rl_full(rl, is_sync)) {
963
				ioc_set_batching(q, ioc);
964
				blk_set_rl_full(rl, is_sync);
965 966 967 968 969 970 971 972
			} 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
					 */
T
Tejun Heo 已提交
973
					return NULL;
974 975
				}
			}
L
Linus Torvalds 已提交
976
		}
977 978 979 980 981 982
		/*
		 * bdi isn't aware of blkcg yet.  As all async IOs end up
		 * root blkcg anyway, just use root blkcg state.
		 */
		if (rl == &q->root_rl)
			blk_set_queue_congested(q, is_sync);
L
Linus Torvalds 已提交
983 984
	}

985 986 987 988 989
	/*
	 * 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
	 */
990
	if (rl->count[is_sync] >= (3 * q->nr_requests / 2))
T
Tejun Heo 已提交
991
		return NULL;
H
Hugh Dickins 已提交
992

993
	q->nr_rqs[is_sync]++;
994 995
	rl->count[is_sync]++;
	rl->starved[is_sync] = 0;
T
Tejun Heo 已提交
996

997 998 999 1000 1001 1002 1003 1004 1005 1006
	/*
	 * Decide whether the new request will be managed by elevator.  If
	 * so, mark @rw_flags and increment elvpriv.  Non-zero elvpriv will
	 * 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.
	 *
	 * Also, lookup icq while holding queue_lock.  If it doesn't exist,
	 * it will be created after releasing queue_lock.
	 */
1007
	if (blk_rq_should_init_elevator(bio) && !blk_queue_bypass(q)) {
1008
		rw_flags |= REQ_ELVPRIV;
1009
		q->nr_rqs_elvpriv++;
1010 1011
		if (et->icq_cache && ioc)
			icq = ioc_lookup_icq(ioc, q);
1012
	}
T
Tejun Heo 已提交
1013

1014 1015
	if (blk_queue_io_stat(q))
		rw_flags |= REQ_IO_STAT;
L
Linus Torvalds 已提交
1016 1017
	spin_unlock_irq(q->queue_lock);

1018
	/* allocate and init request */
1019
	rq = mempool_alloc(rl->rq_pool, gfp_mask);
1020
	if (!rq)
T
Tejun Heo 已提交
1021
		goto fail_alloc;
L
Linus Torvalds 已提交
1022

1023
	blk_rq_init(q, rq);
1024
	blk_rq_set_rl(rq, rl);
1025 1026
	rq->cmd_flags = rw_flags | REQ_ALLOCED;

1027
	/* init elvpriv */
1028
	if (rw_flags & REQ_ELVPRIV) {
1029
		if (unlikely(et->icq_cache && !icq)) {
T
Tejun Heo 已提交
1030 1031
			if (ioc)
				icq = ioc_create_icq(ioc, q, gfp_mask);
1032 1033
			if (!icq)
				goto fail_elvpriv;
1034
		}
1035 1036 1037 1038 1039 1040

		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 */
1041 1042 1043
		if (icq)
			get_io_context(icq->ioc);
	}
1044
out:
1045 1046 1047 1048 1049 1050
	/*
	 * 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 已提交
1051 1052
	if (ioc_batching(q, ioc))
		ioc->nr_batch_requests--;
1053

1054
	trace_block_getrq(q, bio, rw_flags & 1);
L
Linus Torvalds 已提交
1055
	return rq;
T
Tejun Heo 已提交
1056

1057 1058 1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070
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.
	 */
	printk_ratelimited(KERN_WARNING "%s: request aux data allocation failed, iosched may be disturbed\n",
			   dev_name(q->backing_dev_info.dev));

	rq->cmd_flags &= ~REQ_ELVPRIV;
	rq->elv.icq = NULL;

	spin_lock_irq(q->queue_lock);
1071
	q->nr_rqs_elvpriv--;
1072 1073 1074
	spin_unlock_irq(q->queue_lock);
	goto out;

T
Tejun Heo 已提交
1075 1076 1077 1078 1079 1080 1081 1082 1083
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);
1084
	freed_request(rl, rw_flags);
T
Tejun Heo 已提交
1085 1086 1087 1088 1089 1090 1091 1092 1093 1094 1095 1096

	/*
	 * 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;
	return NULL;
L
Linus Torvalds 已提交
1097 1098
}

1099
/**
T
Tejun Heo 已提交
1100
 * get_request - get a free request
1101 1102 1103
 * @q: request_queue to allocate request from
 * @rw_flags: RW and SYNC flags
 * @bio: bio to allocate request for (can be %NULL)
T
Tejun Heo 已提交
1104
 * @gfp_mask: allocation mask
1105
 *
T
Tejun Heo 已提交
1106 1107
 * Get a free request from @q.  If %__GFP_WAIT is set in @gfp_mask, this
 * function keeps retrying under memory pressure and fails iff @q is dead.
N
Nick Piggin 已提交
1108
 *
1109 1110 1111
 * Must be callled with @q->queue_lock held and,
 * Returns %NULL on failure, with @q->queue_lock held.
 * Returns !%NULL on success, with @q->queue_lock *not held*.
L
Linus Torvalds 已提交
1112
 */
T
Tejun Heo 已提交
1113 1114
static struct request *get_request(struct request_queue *q, int rw_flags,
				   struct bio *bio, gfp_t gfp_mask)
L
Linus Torvalds 已提交
1115
{
1116
	const bool is_sync = rw_is_sync(rw_flags) != 0;
T
Tejun Heo 已提交
1117
	DEFINE_WAIT(wait);
1118
	struct request_list *rl;
L
Linus Torvalds 已提交
1119
	struct request *rq;
1120 1121

	rl = blk_get_rl(q, bio);	/* transferred to @rq on success */
T
Tejun Heo 已提交
1122
retry:
1123
	rq = __get_request(rl, rw_flags, bio, gfp_mask);
T
Tejun Heo 已提交
1124 1125
	if (rq)
		return rq;
L
Linus Torvalds 已提交
1126

B
Bart Van Assche 已提交
1127
	if (!(gfp_mask & __GFP_WAIT) || unlikely(blk_queue_dying(q))) {
1128
		blk_put_rl(rl);
T
Tejun Heo 已提交
1129
		return NULL;
1130
	}
L
Linus Torvalds 已提交
1131

T
Tejun Heo 已提交
1132 1133 1134
	/* wait on @rl and retry */
	prepare_to_wait_exclusive(&rl->wait[is_sync], &wait,
				  TASK_UNINTERRUPTIBLE);
L
Linus Torvalds 已提交
1135

T
Tejun Heo 已提交
1136
	trace_block_sleeprq(q, bio, rw_flags & 1);
L
Linus Torvalds 已提交
1137

T
Tejun Heo 已提交
1138 1139
	spin_unlock_irq(q->queue_lock);
	io_schedule();
N
Nick Piggin 已提交
1140

T
Tejun Heo 已提交
1141 1142 1143 1144 1145 1146
	/*
	 * 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);
1147

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

T
Tejun Heo 已提交
1151
	goto retry;
L
Linus Torvalds 已提交
1152 1153
}

1154 1155
static struct request *blk_old_get_request(struct request_queue *q, int rw,
		gfp_t gfp_mask)
L
Linus Torvalds 已提交
1156 1157 1158 1159 1160
{
	struct request *rq;

	BUG_ON(rw != READ && rw != WRITE);

T
Tejun Heo 已提交
1161 1162 1163
	/* create ioc upfront */
	create_io_context(gfp_mask, q->node);

N
Nick Piggin 已提交
1164
	spin_lock_irq(q->queue_lock);
T
Tejun Heo 已提交
1165
	rq = get_request(q, rw, NULL, gfp_mask);
1166 1167
	if (!rq)
		spin_unlock_irq(q->queue_lock);
N
Nick Piggin 已提交
1168
	/* q->queue_lock is unlocked at this point */
L
Linus Torvalds 已提交
1169 1170 1171

	return rq;
}
1172 1173 1174 1175

struct request *blk_get_request(struct request_queue *q, int rw, gfp_t gfp_mask)
{
	if (q->mq_ops)
1176
		return blk_mq_alloc_request(q, rw, gfp_mask, false);
1177 1178 1179
	else
		return blk_old_get_request(q, rw, gfp_mask);
}
L
Linus Torvalds 已提交
1180 1181
EXPORT_SYMBOL(blk_get_request);

1182
/**
1183
 * blk_make_request - given a bio, allocate a corresponding struct request.
1184
 * @q: target request queue
1185 1186
 * @bio:  The bio describing the memory mappings that will be submitted for IO.
 *        It may be a chained-bio properly constructed by block/bio layer.
1187
 * @gfp_mask: gfp flags to be used for memory allocation
1188
 *
1189 1190 1191 1192
 * blk_make_request is the parallel of generic_make_request for BLOCK_PC
 * type commands. Where the struct request needs to be farther initialized by
 * the caller. It is passed a &struct bio, which describes the memory info of
 * the I/O transfer.
1193
 *
1194 1195 1196 1197 1198 1199 1200 1201 1202
 * The caller of blk_make_request must make sure that bi_io_vec
 * are set to describe the memory buffers. That bio_data_dir() will return
 * the needed direction of the request. (And all bio's in the passed bio-chain
 * are properly set accordingly)
 *
 * If called under none-sleepable conditions, mapped bio buffers must not
 * need bouncing, by calling the appropriate masked or flagged allocator,
 * suitable for the target device. Otherwise the call to blk_queue_bounce will
 * BUG.
1203 1204 1205 1206 1207 1208 1209 1210 1211
 *
 * WARNING: When allocating/cloning a bio-chain, careful consideration should be
 * given to how you allocate bios. In particular, you cannot use __GFP_WAIT for
 * anything but the first bio in the chain. Otherwise you risk waiting for IO
 * completion of a bio that hasn't been submitted yet, thus resulting in a
 * deadlock. Alternatively bios should be allocated using bio_kmalloc() instead
 * of bio_alloc(), as that avoids the mempool deadlock.
 * If possible a big IO should be split into smaller parts when allocation
 * fails. Partial allocation should not be an error, or you risk a live-lock.
1212
 */
1213 1214
struct request *blk_make_request(struct request_queue *q, struct bio *bio,
				 gfp_t gfp_mask)
1215
{
1216 1217 1218 1219 1220
	struct request *rq = blk_get_request(q, bio_data_dir(bio), gfp_mask);

	if (unlikely(!rq))
		return ERR_PTR(-ENOMEM);

J
Jens Axboe 已提交
1221 1222
	blk_rq_set_block_pc(rq);

1223 1224 1225 1226 1227 1228 1229 1230 1231 1232 1233 1234 1235
	for_each_bio(bio) {
		struct bio *bounce_bio = bio;
		int ret;

		blk_queue_bounce(q, &bounce_bio);
		ret = blk_rq_append_bio(q, rq, bounce_bio);
		if (unlikely(ret)) {
			blk_put_request(rq);
			return ERR_PTR(ret);
		}
	}

	return rq;
1236
}
1237
EXPORT_SYMBOL(blk_make_request);
1238

J
Jens Axboe 已提交
1239 1240 1241 1242 1243 1244 1245 1246 1247 1248 1249 1250 1251 1252 1253 1254
/**
 * blk_rq_set_block_pc - initialize a requeest to type BLOCK_PC
 * @rq:		request to be initialized
 *
 */
void blk_rq_set_block_pc(struct request *rq)
{
	rq->cmd_type = REQ_TYPE_BLOCK_PC;
	rq->__data_len = 0;
	rq->__sector = (sector_t) -1;
	rq->bio = rq->biotail = NULL;
	memset(rq->__cmd, 0, sizeof(rq->__cmd));
	rq->cmd = rq->__cmd;
}
EXPORT_SYMBOL(blk_rq_set_block_pc);

L
Linus Torvalds 已提交
1255 1256 1257 1258 1259 1260 1261 1262 1263 1264
/**
 * 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.
 */
1265
void blk_requeue_request(struct request_queue *q, struct request *rq)
L
Linus Torvalds 已提交
1266
{
J
Jens Axboe 已提交
1267 1268
	blk_delete_timer(rq);
	blk_clear_rq_complete(rq);
1269
	trace_block_rq_requeue(q, rq);
1270

L
Linus Torvalds 已提交
1271 1272 1273
	if (blk_rq_tagged(rq))
		blk_queue_end_tag(q, rq);

1274 1275
	BUG_ON(blk_queued_rq(rq));

L
Linus Torvalds 已提交
1276 1277 1278 1279
	elv_requeue_request(q, rq);
}
EXPORT_SYMBOL(blk_requeue_request);

1280 1281 1282
static void add_acct_request(struct request_queue *q, struct request *rq,
			     int where)
{
1283
	blk_account_io_start(rq, true);
J
Jens Axboe 已提交
1284
	__elv_add_request(q, rq, where);
1285 1286
}

T
Tejun Heo 已提交
1287 1288 1289
static void part_round_stats_single(int cpu, struct hd_struct *part,
				    unsigned long now)
{
1290 1291
	int inflight;

T
Tejun Heo 已提交
1292 1293 1294
	if (now == part->stamp)
		return;

1295 1296
	inflight = part_in_flight(part);
	if (inflight) {
T
Tejun Heo 已提交
1297
		__part_stat_add(cpu, part, time_in_queue,
1298
				inflight * (now - part->stamp));
T
Tejun Heo 已提交
1299 1300 1301 1302 1303 1304
		__part_stat_add(cpu, part, io_ticks, (now - part->stamp));
	}
	part->stamp = now;
}

/**
1305 1306 1307
 * part_round_stats() - Round off the performance stats on a struct disk_stats.
 * @cpu: cpu number for stats access
 * @part: target partition
L
Linus Torvalds 已提交
1308 1309 1310 1311 1312 1313 1314 1315 1316 1317 1318 1319
 *
 * 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.
 */
T
Tejun Heo 已提交
1320
void part_round_stats(int cpu, struct hd_struct *part)
1321 1322 1323
{
	unsigned long now = jiffies;

T
Tejun Heo 已提交
1324 1325 1326
	if (part->partno)
		part_round_stats_single(cpu, &part_to_disk(part)->part0, now);
	part_round_stats_single(cpu, part, now);
1327
}
T
Tejun Heo 已提交
1328
EXPORT_SYMBOL_GPL(part_round_stats);
1329

L
Lin Ming 已提交
1330 1331 1332 1333 1334 1335 1336 1337 1338 1339
#ifdef CONFIG_PM_RUNTIME
static void blk_pm_put_request(struct request *rq)
{
	if (rq->q->dev && !(rq->cmd_flags & REQ_PM) && !--rq->q->nr_pending)
		pm_runtime_mark_last_busy(rq->q->dev);
}
#else
static inline void blk_pm_put_request(struct request *rq) {}
#endif

L
Linus Torvalds 已提交
1340 1341 1342
/*
 * queue lock must be held
 */
1343
void __blk_put_request(struct request_queue *q, struct request *req)
L
Linus Torvalds 已提交
1344 1345 1346 1347
{
	if (unlikely(!q))
		return;

1348 1349 1350 1351 1352
	if (q->mq_ops) {
		blk_mq_free_request(req);
		return;
	}

L
Lin Ming 已提交
1353 1354
	blk_pm_put_request(req);

1355 1356
	elv_completed_request(q, req);

1357 1358 1359
	/* this is a bio leak */
	WARN_ON(req->bio != NULL);

L
Linus Torvalds 已提交
1360 1361 1362 1363
	/*
	 * Request may not have originated from ll_rw_blk. if not,
	 * it didn't come out of our reserved rq pools
	 */
1364
	if (req->cmd_flags & REQ_ALLOCED) {
1365
		unsigned int flags = req->cmd_flags;
1366
		struct request_list *rl = blk_rq_rl(req);
L
Linus Torvalds 已提交
1367 1368

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

1371 1372 1373
		blk_free_request(rl, req);
		freed_request(rl, flags);
		blk_put_rl(rl);
L
Linus Torvalds 已提交
1374 1375
	}
}
1376 1377
EXPORT_SYMBOL_GPL(__blk_put_request);

L
Linus Torvalds 已提交
1378 1379
void blk_put_request(struct request *req)
{
1380
	struct request_queue *q = req->q;
1381

1382 1383 1384 1385 1386 1387 1388 1389 1390
	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 已提交
1391 1392 1393
}
EXPORT_SYMBOL(blk_put_request);

1394 1395 1396 1397 1398 1399 1400 1401 1402 1403 1404 1405 1406 1407 1408 1409 1410 1411 1412 1413 1414 1415
/**
 * blk_add_request_payload - add a payload to a request
 * @rq: request to update
 * @page: page backing the payload
 * @len: length of the payload.
 *
 * This allows to later add a payload to an already submitted request by
 * a block driver.  The driver needs to take care of freeing the payload
 * itself.
 *
 * Note that this is a quite horrible hack and nothing but handling of
 * discard requests should ever use it.
 */
void blk_add_request_payload(struct request *rq, struct page *page,
		unsigned int len)
{
	struct bio *bio = rq->bio;

	bio->bi_io_vec->bv_page = page;
	bio->bi_io_vec->bv_offset = 0;
	bio->bi_io_vec->bv_len = len;

1416
	bio->bi_iter.bi_size = len;
1417 1418 1419 1420 1421 1422 1423 1424
	bio->bi_vcnt = 1;
	bio->bi_phys_segments = 1;

	rq->__data_len = rq->resid_len = len;
	rq->nr_phys_segments = 1;
}
EXPORT_SYMBOL_GPL(blk_add_request_payload);

1425 1426
bool bio_attempt_back_merge(struct request_queue *q, struct request *req,
			    struct bio *bio)
1427 1428 1429 1430 1431 1432
{
	const int ff = bio->bi_rw & REQ_FAILFAST_MASK;

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

1433
	trace_block_bio_backmerge(q, req, bio);
1434 1435 1436 1437 1438 1439

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

	req->biotail->bi_next = bio;
	req->biotail = bio;
1440
	req->__data_len += bio->bi_iter.bi_size;
1441 1442
	req->ioprio = ioprio_best(req->ioprio, bio_prio(bio));

1443
	blk_account_io_start(req, false);
1444 1445 1446
	return true;
}

1447 1448
bool bio_attempt_front_merge(struct request_queue *q, struct request *req,
			     struct bio *bio)
1449 1450 1451 1452 1453 1454
{
	const int ff = bio->bi_rw & REQ_FAILFAST_MASK;

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

1455
	trace_block_bio_frontmerge(q, req, bio);
1456 1457 1458 1459 1460 1461 1462

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

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

1463 1464
	req->__sector = bio->bi_iter.bi_sector;
	req->__data_len += bio->bi_iter.bi_size;
1465 1466
	req->ioprio = ioprio_best(req->ioprio, bio_prio(bio));

1467
	blk_account_io_start(req, false);
1468 1469 1470
	return true;
}

1471
/**
1472
 * blk_attempt_plug_merge - try to merge with %current's plugged list
1473 1474 1475 1476 1477 1478 1479 1480
 * @q: request_queue new bio is being queued at
 * @bio: new bio being queued
 * @request_count: out parameter for number of traversed plugged requests
 *
 * 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.
 *
1481 1482 1483 1484 1485 1486
 * 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.
1487 1488
 *
 * Caller must ensure !blk_queue_nomerges(q) beforehand.
1489
 */
1490 1491
bool blk_attempt_plug_merge(struct request_queue *q, struct bio *bio,
			    unsigned int *request_count)
1492 1493 1494 1495
{
	struct blk_plug *plug;
	struct request *rq;
	bool ret = false;
S
Shaohua Li 已提交
1496
	struct list_head *plug_list;
1497

1498
	plug = current->plug;
1499 1500
	if (!plug)
		goto out;
1501
	*request_count = 0;
1502

S
Shaohua Li 已提交
1503 1504 1505 1506 1507 1508
	if (q->mq_ops)
		plug_list = &plug->mq_list;
	else
		plug_list = &plug->list;

	list_for_each_entry_reverse(rq, plug_list, queuelist) {
1509 1510
		int el_ret;

1511 1512
		if (rq->q == q)
			(*request_count)++;
1513

1514
		if (rq->q != q || !blk_rq_merge_ok(rq, bio))
1515 1516
			continue;

1517
		el_ret = blk_try_merge(rq, bio);
1518 1519 1520 1521 1522 1523 1524 1525 1526 1527 1528 1529 1530 1531
		if (el_ret == ELEVATOR_BACK_MERGE) {
			ret = bio_attempt_back_merge(q, rq, bio);
			if (ret)
				break;
		} else if (el_ret == ELEVATOR_FRONT_MERGE) {
			ret = bio_attempt_front_merge(q, rq, bio);
			if (ret)
				break;
		}
	}
out:
	return ret;
}

J
Jens Axboe 已提交
1532
void init_request_from_bio(struct request *req, struct bio *bio)
1533
{
1534
	req->cmd_type = REQ_TYPE_FS;
1535

1536 1537
	req->cmd_flags |= bio->bi_rw & REQ_COMMON_MASK;
	if (bio->bi_rw & REQ_RAHEAD)
1538
		req->cmd_flags |= REQ_FAILFAST_MASK;
J
Jens Axboe 已提交
1539

1540
	req->errors = 0;
1541
	req->__sector = bio->bi_iter.bi_sector;
1542
	req->ioprio = bio_prio(bio);
1543
	blk_rq_bio_prep(req->q, req, bio);
1544 1545
}

1546
void blk_queue_bio(struct request_queue *q, struct bio *bio)
L
Linus Torvalds 已提交
1547
{
J
Jiri Slaby 已提交
1548
	const bool sync = !!(bio->bi_rw & REQ_SYNC);
1549 1550 1551
	struct blk_plug *plug;
	int el_ret, rw_flags, where = ELEVATOR_INSERT_SORT;
	struct request *req;
1552
	unsigned int request_count = 0;
L
Linus Torvalds 已提交
1553 1554 1555 1556 1557 1558 1559 1560

	/*
	 * 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);

1561 1562 1563 1564 1565
	if (bio_integrity_enabled(bio) && bio_integrity_prep(bio)) {
		bio_endio(bio, -EIO);
		return;
	}

1566
	if (bio->bi_rw & (REQ_FLUSH | REQ_FUA)) {
1567
		spin_lock_irq(q->queue_lock);
1568
		where = ELEVATOR_INSERT_FLUSH;
1569 1570 1571
		goto get_rq;
	}

1572 1573 1574 1575
	/*
	 * Check if we can merge with the plugged list before grabbing
	 * any locks.
	 */
1576 1577
	if (!blk_queue_nomerges(q) &&
	    blk_attempt_plug_merge(q, bio, &request_count))
1578
		return;
L
Linus Torvalds 已提交
1579

1580
	spin_lock_irq(q->queue_lock);
1581

1582 1583 1584
	el_ret = elv_merge(q, &req, bio);
	if (el_ret == ELEVATOR_BACK_MERGE) {
		if (bio_attempt_back_merge(q, req, bio)) {
1585
			elv_bio_merged(q, req, bio);
1586 1587 1588 1589 1590 1591
			if (!attempt_back_merge(q, req))
				elv_merged_request(q, req, el_ret);
			goto out_unlock;
		}
	} else if (el_ret == ELEVATOR_FRONT_MERGE) {
		if (bio_attempt_front_merge(q, req, bio)) {
1592
			elv_bio_merged(q, req, bio);
1593 1594 1595
			if (!attempt_front_merge(q, req))
				elv_merged_request(q, req, el_ret);
			goto out_unlock;
1596
		}
L
Linus Torvalds 已提交
1597 1598
	}

1599
get_rq:
1600 1601 1602 1603 1604 1605 1606
	/*
	 * This sync check and mask will be re-done in init_request_from_bio(),
	 * but we need to set it earlier to expose the sync flag to the
	 * rq allocator and io schedulers.
	 */
	rw_flags = bio_data_dir(bio);
	if (sync)
1607
		rw_flags |= REQ_SYNC;
1608

L
Linus Torvalds 已提交
1609
	/*
1610
	 * Grab a free request. This is might sleep but can not fail.
N
Nick Piggin 已提交
1611
	 * Returns with the queue unlocked.
1612
	 */
T
Tejun Heo 已提交
1613
	req = get_request(q, rw_flags, bio, GFP_NOIO);
1614 1615 1616 1617
	if (unlikely(!req)) {
		bio_endio(bio, -ENODEV);	/* @q is dead */
		goto out_unlock;
	}
N
Nick Piggin 已提交
1618

1619 1620 1621 1622 1623
	/*
	 * 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 已提交
1624
	 */
1625
	init_request_from_bio(req, bio);
L
Linus Torvalds 已提交
1626

1627
	if (test_bit(QUEUE_FLAG_SAME_COMP, &q->queue_flags))
1628
		req->cpu = raw_smp_processor_id();
1629 1630

	plug = current->plug;
J
Jens Axboe 已提交
1631
	if (plug) {
J
Jens Axboe 已提交
1632 1633
		/*
		 * If this is the first request added after a plug, fire
1634
		 * of a plug trace.
J
Jens Axboe 已提交
1635
		 */
1636
		if (!request_count)
J
Jens Axboe 已提交
1637
			trace_block_plug(q);
1638
		else {
S
Shaohua Li 已提交
1639
			if (request_count >= BLK_MAX_REQUEST_COUNT) {
1640
				blk_flush_plug_list(plug, false);
S
Shaohua Li 已提交
1641 1642
				trace_block_plug(q);
			}
1643 1644
		}
		list_add_tail(&req->queuelist, &plug->list);
1645
		blk_account_io_start(req, true);
1646 1647 1648
	} else {
		spin_lock_irq(q->queue_lock);
		add_acct_request(q, req, where);
1649
		__blk_run_queue(q);
1650 1651 1652
out_unlock:
		spin_unlock_irq(q->queue_lock);
	}
L
Linus Torvalds 已提交
1653
}
1654
EXPORT_SYMBOL_GPL(blk_queue_bio);	/* for device mapper only */
L
Linus Torvalds 已提交
1655 1656 1657 1658 1659 1660 1661 1662

/*
 * If bio->bi_dev is a partition, remap the location
 */
static inline void blk_partition_remap(struct bio *bio)
{
	struct block_device *bdev = bio->bi_bdev;

1663
	if (bio_sectors(bio) && bdev != bdev->bd_contains) {
L
Linus Torvalds 已提交
1664 1665
		struct hd_struct *p = bdev->bd_part;

1666
		bio->bi_iter.bi_sector += p->start_sect;
L
Linus Torvalds 已提交
1667
		bio->bi_bdev = bdev->bd_contains;
1668

1669 1670
		trace_block_bio_remap(bdev_get_queue(bio->bi_bdev), bio,
				      bdev->bd_dev,
1671
				      bio->bi_iter.bi_sector - p->start_sect);
L
Linus Torvalds 已提交
1672 1673 1674 1675 1676 1677 1678 1679 1680 1681 1682
	}
}

static void handle_bad_sector(struct bio *bio)
{
	char b[BDEVNAME_SIZE];

	printk(KERN_INFO "attempt to access beyond end of device\n");
	printk(KERN_INFO "%s: rw=%ld, want=%Lu, limit=%Lu\n",
			bdevname(bio->bi_bdev, b),
			bio->bi_rw,
K
Kent Overstreet 已提交
1683
			(unsigned long long)bio_end_sector(bio),
1684
			(long long)(i_size_read(bio->bi_bdev->bd_inode) >> 9));
L
Linus Torvalds 已提交
1685 1686 1687 1688

	set_bit(BIO_EOF, &bio->bi_flags);
}

1689 1690 1691 1692 1693 1694 1695 1696 1697 1698
#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);

1699
static bool should_fail_request(struct hd_struct *part, unsigned int bytes)
1700
{
1701
	return part->make_it_fail && should_fail(&fail_make_request, bytes);
1702 1703 1704 1705
}

static int __init fail_make_request_debugfs(void)
{
1706 1707 1708
	struct dentry *dir = fault_create_debugfs_attr("fail_make_request",
						NULL, &fail_make_request);

1709
	return PTR_ERR_OR_ZERO(dir);
1710 1711 1712 1713 1714 1715
}

late_initcall(fail_make_request_debugfs);

#else /* CONFIG_FAIL_MAKE_REQUEST */

1716 1717
static inline bool should_fail_request(struct hd_struct *part,
					unsigned int bytes)
1718
{
1719
	return false;
1720 1721 1722 1723
}

#endif /* CONFIG_FAIL_MAKE_REQUEST */

J
Jens Axboe 已提交
1724 1725 1726 1727 1728 1729 1730 1731 1732 1733 1734
/*
 * Check whether this bio extends beyond the end of the device.
 */
static inline int bio_check_eod(struct bio *bio, unsigned int nr_sectors)
{
	sector_t maxsector;

	if (!nr_sectors)
		return 0;

	/* Test device or partition size, when known. */
1735
	maxsector = i_size_read(bio->bi_bdev->bd_inode) >> 9;
J
Jens Axboe 已提交
1736
	if (maxsector) {
1737
		sector_t sector = bio->bi_iter.bi_sector;
J
Jens Axboe 已提交
1738 1739 1740 1741 1742 1743 1744 1745 1746 1747 1748 1749 1750 1751 1752

		if (maxsector < nr_sectors || maxsector - nr_sectors < sector) {
			/*
			 * This may well happen - the kernel calls bread()
			 * without checking the size of the device, e.g., when
			 * mounting a device.
			 */
			handle_bad_sector(bio);
			return 1;
		}
	}

	return 0;
}

1753 1754
static noinline_for_stack bool
generic_make_request_checks(struct bio *bio)
L
Linus Torvalds 已提交
1755
{
1756
	struct request_queue *q;
1757
	int nr_sectors = bio_sectors(bio);
1758
	int err = -EIO;
1759 1760
	char b[BDEVNAME_SIZE];
	struct hd_struct *part;
L
Linus Torvalds 已提交
1761 1762 1763

	might_sleep();

J
Jens Axboe 已提交
1764 1765
	if (bio_check_eod(bio, nr_sectors))
		goto end_io;
L
Linus Torvalds 已提交
1766

1767 1768 1769 1770 1771 1772
	q = bdev_get_queue(bio->bi_bdev);
	if (unlikely(!q)) {
		printk(KERN_ERR
		       "generic_make_request: Trying to access "
			"nonexistent block-device %s (%Lu)\n",
			bdevname(bio->bi_bdev, b),
1773
			(long long) bio->bi_iter.bi_sector);
1774 1775
		goto end_io;
	}
1776

1777 1778
	if (likely(bio_is_rw(bio) &&
		   nr_sectors > queue_max_hw_sectors(q))) {
1779 1780 1781 1782 1783 1784
		printk(KERN_ERR "bio too big device %s (%u > %u)\n",
		       bdevname(bio->bi_bdev, b),
		       bio_sectors(bio),
		       queue_max_hw_sectors(q));
		goto end_io;
	}
L
Linus Torvalds 已提交
1785

1786
	part = bio->bi_bdev->bd_part;
1787
	if (should_fail_request(part, bio->bi_iter.bi_size) ||
1788
	    should_fail_request(&part_to_disk(part)->part0,
1789
				bio->bi_iter.bi_size))
1790
		goto end_io;
1791

1792 1793 1794 1795 1796
	/*
	 * If this device has partitions, remap block n
	 * of partition p to block n+start(p) of the disk.
	 */
	blk_partition_remap(bio);
1797

1798 1799
	if (bio_check_eod(bio, nr_sectors))
		goto end_io;
1800

1801 1802 1803 1804 1805 1806 1807 1808 1809
	/*
	 * Filter flush bio's early so that make_request based
	 * drivers without flush support don't have to worry
	 * about them.
	 */
	if ((bio->bi_rw & (REQ_FLUSH | REQ_FUA)) && !q->flush_flags) {
		bio->bi_rw &= ~(REQ_FLUSH | REQ_FUA);
		if (!nr_sectors) {
			err = 0;
1810 1811
			goto end_io;
		}
1812
	}
1813

1814 1815
	if ((bio->bi_rw & REQ_DISCARD) &&
	    (!blk_queue_discard(q) ||
1816
	     ((bio->bi_rw & REQ_SECURE) && !blk_queue_secdiscard(q)))) {
1817 1818 1819
		err = -EOPNOTSUPP;
		goto end_io;
	}
1820

1821
	if (bio->bi_rw & REQ_WRITE_SAME && !bdev_write_same(bio->bi_bdev)) {
1822 1823 1824
		err = -EOPNOTSUPP;
		goto end_io;
	}
1825

T
Tejun Heo 已提交
1826 1827 1828 1829 1830 1831 1832 1833
	/*
	 * 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);

1834 1835
	if (blk_throtl_bio(q, bio))
		return false;	/* throttled, will be resubmitted later */
1836

1837
	trace_block_bio_queue(q, bio);
1838
	return true;
1839 1840 1841

end_io:
	bio_endio(bio, err);
1842
	return false;
L
Linus Torvalds 已提交
1843 1844
}

1845 1846 1847 1848 1849 1850 1851 1852 1853 1854 1855 1856 1857 1858 1859 1860 1861 1862 1863 1864 1865 1866 1867
/**
 * 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.
1868 1869 1870
 */
void generic_make_request(struct bio *bio)
{
1871 1872
	struct bio_list bio_list_on_stack;

1873 1874 1875 1876 1877 1878 1879 1880 1881 1882 1883 1884 1885
	if (!generic_make_request_checks(bio))
		return;

	/*
	 * 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
	 */
1886 1887
	if (current->bio_list) {
		bio_list_add(current->bio_list, bio);
1888 1889
		return;
	}
1890

1891 1892 1893 1894 1895
	/* 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
1896 1897
	 * we assign bio_list to a pointer to the bio_list_on_stack,
	 * thus initialising the bio_list of new bios to be
1898
	 * added.  ->make_request() may indeed add some more bios
1899 1900 1901
	 * 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
1902
	 * of the top of the list (no pretending) and so remove it from
1903
	 * bio_list, and call into ->make_request() again.
1904 1905
	 */
	BUG_ON(bio->bi_next);
1906 1907
	bio_list_init(&bio_list_on_stack);
	current->bio_list = &bio_list_on_stack;
1908
	do {
1909 1910 1911 1912
		struct request_queue *q = bdev_get_queue(bio->bi_bdev);

		q->make_request_fn(q, bio);

1913
		bio = bio_list_pop(current->bio_list);
1914
	} while (bio);
1915
	current->bio_list = NULL; /* deactivate */
1916
}
L
Linus Torvalds 已提交
1917 1918 1919
EXPORT_SYMBOL(generic_make_request);

/**
1920
 * submit_bio - submit a bio to the block device layer for I/O
L
Linus Torvalds 已提交
1921 1922 1923 1924 1925
 * @rw: whether to %READ or %WRITE, or maybe to %READA (read ahead)
 * @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
1926
 * interfaces; @bio must be presetup and ready for I/O.
L
Linus Torvalds 已提交
1927 1928 1929 1930
 *
 */
void submit_bio(int rw, struct bio *bio)
{
1931
	bio->bi_rw |= rw;
L
Linus Torvalds 已提交
1932

1933 1934 1935 1936
	/*
	 * If it's a regular read/write or a barrier with data attached,
	 * go through the normal accounting stuff before submission.
	 */
1937
	if (bio_has_data(bio)) {
1938 1939 1940 1941 1942 1943 1944
		unsigned int count;

		if (unlikely(rw & REQ_WRITE_SAME))
			count = bdev_logical_block_size(bio->bi_bdev) >> 9;
		else
			count = bio_sectors(bio);

1945 1946 1947
		if (rw & WRITE) {
			count_vm_events(PGPGOUT, count);
		} else {
1948
			task_io_account_read(bio->bi_iter.bi_size);
1949 1950 1951 1952 1953
			count_vm_events(PGPGIN, count);
		}

		if (unlikely(block_dump)) {
			char b[BDEVNAME_SIZE];
1954
			printk(KERN_DEBUG "%s(%d): %s block %Lu on %s (%u sectors)\n",
1955
			current->comm, task_pid_nr(current),
1956
				(rw & WRITE) ? "WRITE" : "READ",
1957
				(unsigned long long)bio->bi_iter.bi_sector,
1958 1959
				bdevname(bio->bi_bdev, b),
				count);
1960
		}
L
Linus Torvalds 已提交
1961 1962 1963 1964 1965 1966
	}

	generic_make_request(bio);
}
EXPORT_SYMBOL(submit_bio);

1967 1968 1969 1970 1971 1972 1973 1974 1975 1976 1977 1978 1979
/**
 * blk_rq_check_limits - Helper function to check a request for the queue limit
 * @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.
 *
 *    This function should also be useful for request stacking drivers
1980
 *    in some cases below, so export this function.
1981 1982
 *    Request stacking drivers like request-based dm may change the queue
 *    limits while requests are in the queue (e.g. dm's table swapping).
1983
 *    Such request stacking drivers should check those requests against
1984 1985 1986 1987 1988 1989
 *    the new queue limits again when they dispatch those requests,
 *    although such checkings are also done against the old queue limits
 *    when submitting requests.
 */
int blk_rq_check_limits(struct request_queue *q, struct request *rq)
{
1990
	if (!rq_mergeable(rq))
1991 1992
		return 0;

1993
	if (blk_rq_sectors(rq) > blk_queue_get_max_sectors(q, rq->cmd_flags)) {
1994 1995 1996 1997 1998 1999 2000 2001 2002 2003 2004
		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);
2005
	if (rq->nr_phys_segments > queue_max_segments(q)) {
2006 2007 2008 2009 2010 2011 2012 2013 2014 2015 2016 2017 2018 2019 2020 2021
		printk(KERN_ERR "%s: over max segments limit.\n", __func__);
		return -EIO;
	}

	return 0;
}
EXPORT_SYMBOL_GPL(blk_rq_check_limits);

/**
 * blk_insert_cloned_request - Helper for stacking drivers to submit a request
 * @q:  the queue to submit the request
 * @rq: the request being queued
 */
int blk_insert_cloned_request(struct request_queue *q, struct request *rq)
{
	unsigned long flags;
2022
	int where = ELEVATOR_INSERT_BACK;
2023 2024 2025 2026

	if (blk_rq_check_limits(q, rq))
		return -EIO;

2027 2028
	if (rq->rq_disk &&
	    should_fail_request(&rq->rq_disk->part0, blk_rq_bytes(rq)))
2029 2030 2031
		return -EIO;

	spin_lock_irqsave(q->queue_lock, flags);
B
Bart Van Assche 已提交
2032
	if (unlikely(blk_queue_dying(q))) {
2033 2034 2035
		spin_unlock_irqrestore(q->queue_lock, flags);
		return -ENODEV;
	}
2036 2037 2038 2039 2040 2041 2042

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

2043 2044 2045 2046
	if (rq->cmd_flags & (REQ_FLUSH|REQ_FUA))
		where = ELEVATOR_INSERT_FLUSH;

	add_acct_request(q, rq, where);
J
Jeff Moyer 已提交
2047 2048
	if (where == ELEVATOR_INSERT_FLUSH)
		__blk_run_queue(q);
2049 2050 2051 2052 2053 2054
	spin_unlock_irqrestore(q->queue_lock, flags);

	return 0;
}
EXPORT_SYMBOL_GPL(blk_insert_cloned_request);

2055 2056 2057 2058 2059 2060 2061 2062 2063 2064 2065 2066 2067 2068 2069 2070 2071 2072 2073 2074 2075 2076 2077 2078 2079 2080 2081 2082 2083 2084 2085 2086 2087 2088 2089
/**
 * 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.
 *
 * Context:
 *     queue_lock must be held.
 */
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;

	if (!(rq->cmd_flags & REQ_MIXED_MERGE))
		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) {
		if ((bio->bi_rw & ff) != ff)
			break;
2090
		bytes += bio->bi_iter.bi_size;
2091 2092 2093 2094 2095 2096 2097 2098
	}

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

2099
void blk_account_io_completion(struct request *req, unsigned int bytes)
2100
{
2101
	if (blk_do_io_stat(req)) {
2102 2103 2104 2105 2106
		const int rw = rq_data_dir(req);
		struct hd_struct *part;
		int cpu;

		cpu = part_stat_lock();
2107
		part = req->part;
2108 2109 2110 2111 2112
		part_stat_add(cpu, part, sectors[rw], bytes >> 9);
		part_stat_unlock();
	}
}

2113
void blk_account_io_done(struct request *req)
2114 2115
{
	/*
2116 2117 2118
	 * Account IO completion.  flush_rq isn't accounted as a
	 * normal IO on queueing nor completion.  Accounting the
	 * containing request is enough.
2119
	 */
T
Tejun Heo 已提交
2120
	if (blk_do_io_stat(req) && !(req->cmd_flags & REQ_FLUSH_SEQ)) {
2121 2122 2123 2124 2125 2126
		unsigned long duration = jiffies - req->start_time;
		const int rw = rq_data_dir(req);
		struct hd_struct *part;
		int cpu;

		cpu = part_stat_lock();
2127
		part = req->part;
2128 2129 2130 2131

		part_stat_inc(cpu, part, ios[rw]);
		part_stat_add(cpu, part, ticks[rw], duration);
		part_round_stats(cpu, part);
2132
		part_dec_in_flight(part, rw);
2133

2134
		hd_struct_put(part);
2135 2136 2137 2138
		part_stat_unlock();
	}
}

L
Lin Ming 已提交
2139 2140 2141 2142 2143 2144 2145 2146 2147 2148 2149 2150 2151 2152 2153 2154 2155 2156 2157 2158 2159 2160
#ifdef CONFIG_PM_RUNTIME
/*
 * Don't process normal requests when queue is suspended
 * or in the process of suspending/resuming
 */
static struct request *blk_pm_peek_request(struct request_queue *q,
					   struct request *rq)
{
	if (q->dev && (q->rpm_status == RPM_SUSPENDED ||
	    (q->rpm_status != RPM_ACTIVE && !(rq->cmd_flags & REQ_PM))))
		return NULL;
	else
		return rq;
}
#else
static inline struct request *blk_pm_peek_request(struct request_queue *q,
						  struct request *rq)
{
	return rq;
}
#endif

2161 2162 2163 2164 2165 2166 2167 2168 2169 2170 2171 2172 2173 2174 2175 2176 2177 2178 2179 2180 2181 2182 2183 2184 2185 2186 2187 2188 2189 2190 2191 2192 2193 2194 2195 2196
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);
		}
		part_round_stats(cpu, part);
		part_inc_in_flight(part, rw);
		rq->part = part;
	}

	part_stat_unlock();
}

2197
/**
2198 2199 2200 2201 2202 2203 2204 2205 2206 2207 2208 2209 2210 2211 2212 2213
 * 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.
 *
 * Context:
 *     queue_lock must be held.
 */
struct request *blk_peek_request(struct request_queue *q)
2214 2215 2216 2217 2218
{
	struct request *rq;
	int ret;

	while ((rq = __elv_next_request(q)) != NULL) {
L
Lin Ming 已提交
2219 2220 2221 2222 2223

		rq = blk_pm_peek_request(q, rq);
		if (!rq)
			break;

2224 2225 2226 2227 2228 2229
		if (!(rq->cmd_flags & REQ_STARTED)) {
			/*
			 * This is the first time the device driver
			 * sees this request (possibly after
			 * requeueing).  Notify IO scheduler.
			 */
2230
			if (rq->cmd_flags & REQ_SORTED)
2231 2232 2233 2234 2235 2236 2237 2238 2239 2240 2241 2242 2243 2244 2245 2246 2247 2248 2249
				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
			 */
			rq->cmd_flags |= REQ_STARTED;
			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;
		}

		if (rq->cmd_flags & REQ_DONTPREP)
			break;

2250
		if (q->dma_drain_size && blk_rq_bytes(rq)) {
2251 2252 2253 2254 2255 2256 2257 2258 2259 2260 2261 2262 2263 2264 2265 2266 2267 2268 2269 2270 2271 2272
			/*
			 * 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
			 * avoid resource deadlock.  REQ_STARTED will
			 * prevent other fs requests from passing this one.
			 */
2273
			if (q->dma_drain_size && blk_rq_bytes(rq) &&
2274 2275 2276 2277 2278 2279 2280 2281 2282 2283 2284 2285
			    !(rq->cmd_flags & REQ_DONTPREP)) {
				/*
				 * remove the space for the drain we added
				 * so that we don't add it again
				 */
				--rq->nr_phys_segments;
			}

			rq = NULL;
			break;
		} else if (ret == BLKPREP_KILL) {
			rq->cmd_flags |= REQ_QUIET;
2286 2287 2288 2289 2290
			/*
			 * Mark this request as started so we don't trigger
			 * any debug logic in the end I/O path.
			 */
			blk_start_request(rq);
2291
			__blk_end_request_all(rq, -EIO);
2292 2293 2294 2295 2296 2297 2298 2299
		} else {
			printk(KERN_ERR "%s: bad return=%d\n", __func__, ret);
			break;
		}
	}

	return rq;
}
2300
EXPORT_SYMBOL(blk_peek_request);
2301

2302
void blk_dequeue_request(struct request *rq)
2303
{
2304 2305
	struct request_queue *q = rq->q;

2306 2307 2308 2309 2310 2311 2312 2313 2314 2315
	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.
	 */
2316
	if (blk_account_rq(rq)) {
2317
		q->in_flight[rq_is_sync(rq)]++;
2318 2319
		set_io_start_time_ns(rq);
	}
2320 2321
}

2322 2323 2324 2325 2326 2327 2328 2329 2330 2331 2332 2333 2334 2335 2336 2337 2338 2339 2340
/**
 * 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.
 *
 *     Block internal functions which don't want to start timer should
 *     call blk_dequeue_request().
 *
 * Context:
 *     queue_lock must be held.
 */
void blk_start_request(struct request *req)
{
	blk_dequeue_request(req);

	/*
2341 2342
	 * We are now handing the request to the hardware, initialize
	 * resid_len to full count and add the timeout handler.
2343
	 */
2344
	req->resid_len = blk_rq_bytes(req);
2345 2346 2347
	if (unlikely(blk_bidi_rq(req)))
		req->next_rq->resid_len = blk_rq_bytes(req->next_rq);

2348
	BUG_ON(test_bit(REQ_ATOM_COMPLETE, &req->atomic_flags));
2349 2350 2351 2352 2353 2354 2355 2356 2357 2358 2359 2360 2361 2362 2363 2364 2365 2366 2367 2368 2369 2370 2371 2372 2373 2374 2375 2376 2377 2378
	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.
 *
 * Context:
 *     queue_lock must be held.
 */
struct request *blk_fetch_request(struct request_queue *q)
{
	struct request *rq;

	rq = blk_peek_request(q);
	if (rq)
		blk_start_request(rq);
	return rq;
}
EXPORT_SYMBOL(blk_fetch_request);

2379
/**
2380
 * blk_update_request - Special helper function for request stacking drivers
2381
 * @req:      the request being processed
2382
 * @error:    %0 for success, < %0 for error
2383
 * @nr_bytes: number of bytes to complete @req
2384 2385
 *
 * Description:
2386 2387 2388
 *     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.
2389 2390 2391 2392 2393 2394 2395
 *
 *     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.
2396 2397
 *
 * Return:
2398 2399
 *     %false - this request doesn't have any more data
 *     %true  - this request has more data
2400
 **/
2401
bool blk_update_request(struct request *req, int error, unsigned int nr_bytes)
L
Linus Torvalds 已提交
2402
{
2403
	int total_bytes;
L
Linus Torvalds 已提交
2404

2405 2406 2407
	if (!req->bio)
		return false;

2408
	trace_block_rq_complete(req->q, req, nr_bytes);
2409

L
Linus Torvalds 已提交
2410
	/*
2411 2412 2413 2414 2415 2416
	 * For fs requests, rq is just carrier of independent bio's
	 * and each partial completion should be handled separately.
	 * Reset per-request error on each partial completion.
	 *
	 * TODO: tj: This is too subtle.  It would be better to let
	 * low level drivers do what they see fit.
L
Linus Torvalds 已提交
2417
	 */
2418
	if (req->cmd_type == REQ_TYPE_FS)
L
Linus Torvalds 已提交
2419 2420
		req->errors = 0;

2421 2422
	if (error && req->cmd_type == REQ_TYPE_FS &&
	    !(req->cmd_flags & REQ_QUIET)) {
2423 2424 2425 2426 2427 2428 2429 2430 2431 2432 2433 2434
		char *error_type;

		switch (error) {
		case -ENOLINK:
			error_type = "recoverable transport";
			break;
		case -EREMOTEIO:
			error_type = "critical target";
			break;
		case -EBADE:
			error_type = "critical nexus";
			break;
2435 2436 2437
		case -ETIMEDOUT:
			error_type = "timeout";
			break;
2438 2439 2440
		case -ENOSPC:
			error_type = "critical space allocation";
			break;
2441 2442 2443
		case -ENODATA:
			error_type = "critical medium";
			break;
2444 2445 2446 2447 2448
		case -EIO:
		default:
			error_type = "I/O";
			break;
		}
2449 2450 2451 2452 2453
		printk_ratelimited(KERN_ERR "end_request: %s error, dev %s, sector %llu\n",
				   error_type, req->rq_disk ?
				   req->rq_disk->disk_name : "?",
				   (unsigned long long)blk_rq_pos(req));

L
Linus Torvalds 已提交
2454 2455
	}

2456
	blk_account_io_completion(req, nr_bytes);
2457

2458 2459 2460
	total_bytes = 0;
	while (req->bio) {
		struct bio *bio = req->bio;
2461
		unsigned bio_bytes = min(bio->bi_iter.bi_size, nr_bytes);
L
Linus Torvalds 已提交
2462

2463
		if (bio_bytes == bio->bi_iter.bi_size)
L
Linus Torvalds 已提交
2464 2465
			req->bio = bio->bi_next;

2466
		req_bio_endio(req, bio, bio_bytes, error);
L
Linus Torvalds 已提交
2467

2468 2469
		total_bytes += bio_bytes;
		nr_bytes -= bio_bytes;
L
Linus Torvalds 已提交
2470

2471 2472
		if (!nr_bytes)
			break;
L
Linus Torvalds 已提交
2473 2474 2475 2476 2477
	}

	/*
	 * completely done
	 */
2478 2479 2480 2481 2482 2483
	if (!req->bio) {
		/*
		 * Reset counters so that the request stacking driver
		 * can find how many bytes remain in the request
		 * later.
		 */
2484
		req->__data_len = 0;
2485 2486
		return false;
	}
L
Linus Torvalds 已提交
2487

2488
	req->__data_len -= total_bytes;
2489 2490

	/* update sector only for requests with clear definition of sector */
2491
	if (req->cmd_type == REQ_TYPE_FS)
2492
		req->__sector += total_bytes >> 9;
2493

2494 2495 2496 2497 2498 2499
	/* mixed attributes always follow the first bio */
	if (req->cmd_flags & REQ_MIXED_MERGE) {
		req->cmd_flags &= ~REQ_FAILFAST_MASK;
		req->cmd_flags |= req->bio->bi_rw & REQ_FAILFAST_MASK;
	}

2500 2501 2502 2503 2504
	/*
	 * 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)) {
2505
		blk_dump_rq_flags(req, "request botched");
2506
		req->__data_len = blk_rq_cur_bytes(req);
2507 2508 2509
	}

	/* recalculate the number of segments */
L
Linus Torvalds 已提交
2510
	blk_recalc_rq_segments(req);
2511

2512
	return true;
L
Linus Torvalds 已提交
2513
}
2514
EXPORT_SYMBOL_GPL(blk_update_request);
L
Linus Torvalds 已提交
2515

2516 2517 2518
static bool blk_update_bidi_request(struct request *rq, int error,
				    unsigned int nr_bytes,
				    unsigned int bidi_bytes)
2519
{
2520 2521
	if (blk_update_request(rq, error, nr_bytes))
		return true;
2522

2523 2524 2525 2526
	/* 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;
2527

2528 2529
	if (blk_queue_add_random(rq->q))
		add_disk_randomness(rq->rq_disk);
2530 2531

	return false;
L
Linus Torvalds 已提交
2532 2533
}

2534 2535 2536 2537 2538 2539 2540 2541 2542 2543 2544 2545 2546 2547 2548 2549 2550 2551 2552 2553
/**
 * 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;

	req->cmd_flags &= ~REQ_DONTPREP;
	if (q->unprep_rq_fn)
		q->unprep_rq_fn(q, req);
}
EXPORT_SYMBOL_GPL(blk_unprep_request);

L
Linus Torvalds 已提交
2554 2555 2556
/*
 * queue lock must be held
 */
2557
void blk_finish_request(struct request *req, int error)
L
Linus Torvalds 已提交
2558
{
2559 2560 2561
	if (blk_rq_tagged(req))
		blk_queue_end_tag(req->q, req);

2562
	BUG_ON(blk_queued_rq(req));
L
Linus Torvalds 已提交
2563

2564
	if (unlikely(laptop_mode) && req->cmd_type == REQ_TYPE_FS)
2565
		laptop_io_completion(&req->q->backing_dev_info);
L
Linus Torvalds 已提交
2566

2567 2568
	blk_delete_timer(req);

2569 2570 2571
	if (req->cmd_flags & REQ_DONTPREP)
		blk_unprep_request(req);

2572
	blk_account_io_done(req);
2573

L
Linus Torvalds 已提交
2574
	if (req->end_io)
2575
		req->end_io(req, error);
2576 2577 2578 2579
	else {
		if (blk_bidi_rq(req))
			__blk_put_request(req->next_rq->q, req->next_rq);

L
Linus Torvalds 已提交
2580
		__blk_put_request(req->q, req);
2581
	}
L
Linus Torvalds 已提交
2582
}
2583
EXPORT_SYMBOL(blk_finish_request);
L
Linus Torvalds 已提交
2584

2585
/**
2586 2587 2588 2589 2590
 * blk_end_bidi_request - Complete a bidi request
 * @rq:         the request to complete
 * @error:      %0 for success, < %0 for error
 * @nr_bytes:   number of bytes to complete @rq
 * @bidi_bytes: number of bytes to complete @rq->next_rq
2591 2592
 *
 * Description:
2593
 *     Ends I/O on a number of bytes attached to @rq and @rq->next_rq.
2594 2595 2596
 *     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.
2597 2598
 *
 * Return:
2599 2600
 *     %false - we are done with this request
 *     %true  - still buffers pending for this request
2601
 **/
2602
static bool blk_end_bidi_request(struct request *rq, int error,
K
Kiyoshi Ueda 已提交
2603 2604
				 unsigned int nr_bytes, unsigned int bidi_bytes)
{
2605
	struct request_queue *q = rq->q;
2606
	unsigned long flags;
K
Kiyoshi Ueda 已提交
2607

2608 2609
	if (blk_update_bidi_request(rq, error, nr_bytes, bidi_bytes))
		return true;
K
Kiyoshi Ueda 已提交
2610

2611
	spin_lock_irqsave(q->queue_lock, flags);
2612
	blk_finish_request(rq, error);
2613 2614
	spin_unlock_irqrestore(q->queue_lock, flags);

2615
	return false;
K
Kiyoshi Ueda 已提交
2616 2617
}

2618
/**
2619 2620
 * __blk_end_bidi_request - Complete a bidi request with queue lock held
 * @rq:         the request to complete
2621
 * @error:      %0 for success, < %0 for error
2622 2623
 * @nr_bytes:   number of bytes to complete @rq
 * @bidi_bytes: number of bytes to complete @rq->next_rq
2624 2625
 *
 * Description:
2626 2627
 *     Identical to blk_end_bidi_request() except that queue lock is
 *     assumed to be locked on entry and remains so on return.
2628 2629
 *
 * Return:
2630 2631
 *     %false - we are done with this request
 *     %true  - still buffers pending for this request
2632
 **/
2633
bool __blk_end_bidi_request(struct request *rq, int error,
2634
				   unsigned int nr_bytes, unsigned int bidi_bytes)
2635
{
2636 2637
	if (blk_update_bidi_request(rq, error, nr_bytes, bidi_bytes))
		return true;
2638

2639
	blk_finish_request(rq, error);
2640

2641
	return false;
2642
}
2643 2644 2645 2646

/**
 * blk_end_request - Helper function for drivers to complete the request.
 * @rq:       the request being processed
2647
 * @error:    %0 for success, < %0 for error
2648 2649 2650 2651 2652 2653 2654
 * @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:
2655 2656
 *     %false - we are done with this request
 *     %true  - still buffers pending for this request
2657
 **/
2658
bool blk_end_request(struct request *rq, int error, unsigned int nr_bytes)
2659
{
2660
	return blk_end_bidi_request(rq, error, nr_bytes, 0);
2661
}
2662
EXPORT_SYMBOL(blk_end_request);
2663 2664

/**
2665 2666
 * blk_end_request_all - Helper function for drives to finish the request.
 * @rq: the request to finish
2667
 * @error: %0 for success, < %0 for error
2668 2669
 *
 * Description:
2670 2671 2672
 *     Completely finish @rq.
 */
void blk_end_request_all(struct request *rq, int error)
2673
{
2674 2675
	bool pending;
	unsigned int bidi_bytes = 0;
2676

2677 2678
	if (unlikely(blk_bidi_rq(rq)))
		bidi_bytes = blk_rq_bytes(rq->next_rq);
2679

2680 2681 2682
	pending = blk_end_bidi_request(rq, error, blk_rq_bytes(rq), bidi_bytes);
	BUG_ON(pending);
}
2683
EXPORT_SYMBOL(blk_end_request_all);
2684

2685 2686 2687
/**
 * blk_end_request_cur - Helper function to finish the current request chunk.
 * @rq: the request to finish the current chunk for
2688
 * @error: %0 for success, < %0 for error
2689 2690 2691 2692 2693 2694 2695 2696 2697 2698 2699
 *
 * Description:
 *     Complete the current consecutively mapped chunk from @rq.
 *
 * Return:
 *     %false - we are done with this request
 *     %true  - still buffers pending for this request
 */
bool blk_end_request_cur(struct request *rq, int error)
{
	return blk_end_request(rq, error, blk_rq_cur_bytes(rq));
2700
}
2701
EXPORT_SYMBOL(blk_end_request_cur);
2702

2703 2704 2705 2706 2707 2708 2709 2710 2711 2712 2713 2714 2715 2716 2717 2718 2719 2720 2721
/**
 * blk_end_request_err - Finish a request till the next failure boundary.
 * @rq: the request to finish till the next failure boundary for
 * @error: must be negative errno
 *
 * Description:
 *     Complete @rq till the next failure boundary.
 *
 * Return:
 *     %false - we are done with this request
 *     %true  - still buffers pending for this request
 */
bool blk_end_request_err(struct request *rq, int error)
{
	WARN_ON(error >= 0);
	return blk_end_request(rq, error, blk_rq_err_bytes(rq));
}
EXPORT_SYMBOL_GPL(blk_end_request_err);

2722
/**
2723 2724 2725 2726
 * __blk_end_request - Helper function for drivers to complete the request.
 * @rq:       the request being processed
 * @error:    %0 for success, < %0 for error
 * @nr_bytes: number of bytes to complete
2727 2728
 *
 * Description:
2729
 *     Must be called with queue lock held unlike blk_end_request().
2730 2731
 *
 * Return:
2732 2733
 *     %false - we are done with this request
 *     %true  - still buffers pending for this request
2734
 **/
2735
bool __blk_end_request(struct request *rq, int error, unsigned int nr_bytes)
2736
{
2737
	return __blk_end_bidi_request(rq, error, nr_bytes, 0);
2738
}
2739
EXPORT_SYMBOL(__blk_end_request);
2740

K
Kiyoshi Ueda 已提交
2741
/**
2742 2743
 * __blk_end_request_all - Helper function for drives to finish the request.
 * @rq: the request to finish
2744
 * @error: %0 for success, < %0 for error
K
Kiyoshi Ueda 已提交
2745 2746
 *
 * Description:
2747
 *     Completely finish @rq.  Must be called with queue lock held.
K
Kiyoshi Ueda 已提交
2748
 */
2749
void __blk_end_request_all(struct request *rq, int error)
K
Kiyoshi Ueda 已提交
2750
{
2751 2752 2753 2754 2755 2756 2757 2758
	bool pending;
	unsigned int bidi_bytes = 0;

	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 已提交
2759
}
2760
EXPORT_SYMBOL(__blk_end_request_all);
K
Kiyoshi Ueda 已提交
2761

2762
/**
2763 2764
 * __blk_end_request_cur - Helper function to finish the current request chunk.
 * @rq: the request to finish the current chunk for
2765
 * @error: %0 for success, < %0 for error
2766 2767
 *
 * Description:
2768 2769
 *     Complete the current consecutively mapped chunk from @rq.  Must
 *     be called with queue lock held.
2770 2771
 *
 * Return:
2772 2773 2774 2775
 *     %false - we are done with this request
 *     %true  - still buffers pending for this request
 */
bool __blk_end_request_cur(struct request *rq, int error)
2776
{
2777
	return __blk_end_request(rq, error, blk_rq_cur_bytes(rq));
2778
}
2779
EXPORT_SYMBOL(__blk_end_request_cur);
2780

2781 2782 2783 2784 2785 2786 2787 2788 2789 2790 2791 2792 2793 2794 2795 2796 2797 2798 2799 2800
/**
 * __blk_end_request_err - Finish a request till the next failure boundary.
 * @rq: the request to finish till the next failure boundary for
 * @error: must be negative errno
 *
 * Description:
 *     Complete @rq till the next failure boundary.  Must be called
 *     with queue lock held.
 *
 * Return:
 *     %false - we are done with this request
 *     %true  - still buffers pending for this request
 */
bool __blk_end_request_err(struct request *rq, int error)
{
	WARN_ON(error >= 0);
	return __blk_end_request(rq, error, blk_rq_err_bytes(rq));
}
EXPORT_SYMBOL_GPL(__blk_end_request_err);

J
Jens Axboe 已提交
2801 2802
void blk_rq_bio_prep(struct request_queue *q, struct request *rq,
		     struct bio *bio)
L
Linus Torvalds 已提交
2803
{
2804
	/* Bit 0 (R/W) is identical in rq->cmd_flags and bio->bi_rw */
2805
	rq->cmd_flags |= bio->bi_rw & REQ_WRITE;
L
Linus Torvalds 已提交
2806

2807
	if (bio_has_data(bio))
D
David Woodhouse 已提交
2808
		rq->nr_phys_segments = bio_phys_segments(q, bio);
2809

2810
	rq->__data_len = bio->bi_iter.bi_size;
L
Linus Torvalds 已提交
2811 2812
	rq->bio = rq->biotail = bio;

N
NeilBrown 已提交
2813 2814 2815
	if (bio->bi_bdev)
		rq->rq_disk = bio->bi_bdev->bd_disk;
}
L
Linus Torvalds 已提交
2816

2817 2818 2819 2820 2821 2822 2823 2824 2825 2826 2827
#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;
2828
	struct bio_vec bvec;
2829 2830

	rq_for_each_segment(bvec, rq, iter)
2831
		flush_dcache_page(bvec.bv_page);
2832 2833 2834 2835
}
EXPORT_SYMBOL_GPL(rq_flush_dcache_pages);
#endif

2836 2837 2838 2839 2840 2841 2842 2843 2844 2845 2846 2847 2848 2849 2850 2851 2852 2853 2854 2855 2856 2857 2858 2859 2860 2861 2862 2863
/**
 * 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);

2864 2865 2866 2867 2868 2869 2870 2871 2872 2873 2874 2875 2876 2877 2878 2879 2880 2881 2882 2883 2884
/**
 * 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.
2885
 * The actual data parts (e.g. ->cmd, ->sense) are not copied.
2886 2887 2888 2889
 */
static void __blk_rq_prep_clone(struct request *dst, struct request *src)
{
	dst->cpu = src->cpu;
2890
	dst->cmd_flags = (src->cmd_flags & REQ_CLONE_MASK) | REQ_NOMERGE;
2891 2892 2893 2894 2895 2896 2897 2898 2899 2900 2901 2902 2903 2904 2905 2906 2907 2908 2909 2910
	dst->cmd_type = src->cmd_type;
	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;
}

/**
 * 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.
2911
 *     The actual data parts of @rq_src (e.g. ->cmd, ->sense)
2912 2913 2914 2915 2916 2917 2918 2919 2920 2921 2922 2923 2924 2925 2926 2927 2928 2929 2930
 *     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)
		bs = fs_bio_set;

	blk_rq_init(NULL, rq);

	__rq_for_each_bio(bio_src, rq_src) {
2931
		bio = bio_clone_bioset(bio_src, gfp_mask, bs);
2932 2933 2934 2935 2936 2937 2938 2939 2940 2941 2942 2943 2944 2945 2946 2947 2948 2949 2950
		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)
K
Kent Overstreet 已提交
2951
		bio_put(bio);
2952 2953 2954 2955 2956 2957
	blk_rq_unprep_clone(rq);

	return -ENOMEM;
}
EXPORT_SYMBOL_GPL(blk_rq_prep_clone);

2958
int kblockd_schedule_work(struct work_struct *work)
L
Linus Torvalds 已提交
2959 2960 2961 2962 2963
{
	return queue_work(kblockd_workqueue, work);
}
EXPORT_SYMBOL(kblockd_schedule_work);

2964 2965
int kblockd_schedule_delayed_work(struct delayed_work *dwork,
				  unsigned long delay)
2966 2967 2968 2969 2970
{
	return queue_delayed_work(kblockd_workqueue, dwork, delay);
}
EXPORT_SYMBOL(kblockd_schedule_delayed_work);

2971 2972 2973 2974 2975 2976 2977
int kblockd_schedule_delayed_work_on(int cpu, struct delayed_work *dwork,
				     unsigned long delay)
{
	return queue_delayed_work_on(cpu, kblockd_workqueue, dwork, delay);
}
EXPORT_SYMBOL(kblockd_schedule_delayed_work_on);

S
Suresh Jayaraman 已提交
2978 2979 2980 2981 2982 2983 2984 2985 2986 2987 2988 2989 2990 2991
/**
 * 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.
 */
2992 2993 2994 2995 2996
void blk_start_plug(struct blk_plug *plug)
{
	struct task_struct *tsk = current;

	INIT_LIST_HEAD(&plug->list);
2997
	INIT_LIST_HEAD(&plug->mq_list);
2998
	INIT_LIST_HEAD(&plug->cb_list);
2999 3000 3001 3002 3003 3004 3005 3006 3007 3008 3009 3010 3011 3012 3013 3014 3015 3016 3017 3018

	/*
	 * If this is a nested plug, don't actually assign it. It will be
	 * flushed on its own.
	 */
	if (!tsk->plug) {
		/*
		 * Store ordering should not be needed here, since a potential
		 * preempt will imply a full memory barrier
		 */
		tsk->plug = plug;
	}
}
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);

3019 3020
	return !(rqa->q < rqb->q ||
		(rqa->q == rqb->q && blk_rq_pos(rqa) < blk_rq_pos(rqb)));
3021 3022
}

3023 3024 3025 3026 3027 3028
/*
 * 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.
 */
3029
static void queue_unplugged(struct request_queue *q, unsigned int depth,
3030
			    bool from_schedule)
3031
	__releases(q->queue_lock)
3032
{
3033
	trace_block_unplug(q, depth, !from_schedule);
3034

3035
	if (from_schedule)
3036
		blk_run_queue_async(q);
3037
	else
3038
		__blk_run_queue(q);
3039
	spin_unlock(q->queue_lock);
3040 3041
}

3042
static void flush_plug_callbacks(struct blk_plug *plug, bool from_schedule)
3043 3044 3045
{
	LIST_HEAD(callbacks);

S
Shaohua Li 已提交
3046 3047
	while (!list_empty(&plug->cb_list)) {
		list_splice_init(&plug->cb_list, &callbacks);
3048

S
Shaohua Li 已提交
3049 3050
		while (!list_empty(&callbacks)) {
			struct blk_plug_cb *cb = list_first_entry(&callbacks,
3051 3052
							  struct blk_plug_cb,
							  list);
S
Shaohua Li 已提交
3053
			list_del(&cb->list);
3054
			cb->callback(cb, from_schedule);
S
Shaohua Li 已提交
3055
		}
3056 3057 3058
	}
}

3059 3060 3061 3062 3063 3064 3065 3066 3067 3068 3069 3070 3071 3072 3073 3074 3075 3076 3077 3078 3079 3080 3081 3082 3083
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);

3084
void blk_flush_plug_list(struct blk_plug *plug, bool from_schedule)
3085 3086 3087 3088
{
	struct request_queue *q;
	unsigned long flags;
	struct request *rq;
3089
	LIST_HEAD(list);
3090
	unsigned int depth;
3091

3092
	flush_plug_callbacks(plug, from_schedule);
3093 3094 3095 3096

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

3097 3098 3099
	if (list_empty(&plug->list))
		return;

3100 3101
	list_splice_init(&plug->list, &list);

3102
	list_sort(NULL, &list, plug_rq_cmp);
3103 3104

	q = NULL;
3105
	depth = 0;
3106 3107 3108 3109 3110

	/*
	 * Save and disable interrupts here, to avoid doing it for every
	 * queue lock we have to take.
	 */
3111
	local_irq_save(flags);
3112 3113
	while (!list_empty(&list)) {
		rq = list_entry_rq(list.next);
3114 3115 3116
		list_del_init(&rq->queuelist);
		BUG_ON(!rq->q);
		if (rq->q != q) {
3117 3118 3119 3120
			/*
			 * This drops the queue lock
			 */
			if (q)
3121
				queue_unplugged(q, depth, from_schedule);
3122
			q = rq->q;
3123
			depth = 0;
3124 3125
			spin_lock(q->queue_lock);
		}
3126 3127 3128 3129

		/*
		 * Short-circuit if @q is dead
		 */
B
Bart Van Assche 已提交
3130
		if (unlikely(blk_queue_dying(q))) {
3131 3132 3133 3134
			__blk_end_request_all(rq, -ENODEV);
			continue;
		}

3135 3136 3137
		/*
		 * rq is already accounted, so use raw insert
		 */
3138 3139 3140 3141
		if (rq->cmd_flags & (REQ_FLUSH | REQ_FUA))
			__elv_add_request(q, rq, ELEVATOR_INSERT_FLUSH);
		else
			__elv_add_request(q, rq, ELEVATOR_INSERT_SORT_MERGE);
3142 3143

		depth++;
3144 3145
	}

3146 3147 3148 3149
	/*
	 * This drops the queue lock
	 */
	if (q)
3150
		queue_unplugged(q, depth, from_schedule);
3151 3152 3153 3154 3155 3156

	local_irq_restore(flags);
}

void blk_finish_plug(struct blk_plug *plug)
{
3157
	blk_flush_plug_list(plug, false);
3158

3159 3160
	if (plug == current->plug)
		current->plug = NULL;
3161
}
3162
EXPORT_SYMBOL(blk_finish_plug);
3163

L
Lin Ming 已提交
3164 3165 3166 3167 3168 3169 3170 3171 3172 3173 3174 3175 3176 3177 3178 3179 3180 3181 3182 3183 3184 3185 3186 3187 3188 3189 3190 3191 3192 3193 3194 3195 3196 3197 3198 3199 3200 3201 3202 3203 3204 3205 3206 3207 3208 3209 3210 3211 3212 3213 3214 3215 3216 3217 3218 3219 3220 3221 3222 3223 3224 3225 3226 3227 3228 3229 3230 3231 3232 3233 3234 3235 3236 3237 3238 3239 3240 3241 3242 3243 3244 3245 3246 3247 3248 3249 3250 3251 3252 3253 3254 3255 3256 3257 3258 3259 3260 3261 3262 3263 3264 3265 3266 3267 3268 3269 3270 3271 3272 3273 3274 3275 3276 3277 3278 3279 3280 3281 3282 3283 3284 3285 3286 3287 3288 3289 3290 3291 3292 3293 3294 3295 3296 3297
#ifdef CONFIG_PM_RUNTIME
/**
 * 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)
{
	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;

	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)
{
	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)
{
	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)
{
	spin_lock_irq(q->queue_lock);
	if (!err) {
		q->rpm_status = RPM_ACTIVE;
		__blk_run_queue(q);
		pm_runtime_mark_last_busy(q->dev);
3298
		pm_request_autosuspend(q->dev);
L
Lin Ming 已提交
3299 3300 3301 3302 3303 3304 3305 3306
	} else {
		q->rpm_status = RPM_SUSPENDED;
	}
	spin_unlock_irq(q->queue_lock);
}
EXPORT_SYMBOL(blk_post_runtime_resume);
#endif

L
Linus Torvalds 已提交
3307 3308
int __init blk_dev_init(void)
{
3309 3310 3311
	BUILD_BUG_ON(__REQ_NR_BITS > 8 *
			sizeof(((struct request *)0)->cmd_flags));

3312 3313
	/* used for unplugging and affects IO latency/throughput - HIGHPRI */
	kblockd_workqueue = alloc_workqueue("kblockd",
3314 3315
					    WQ_MEM_RECLAIM | WQ_HIGHPRI |
					    WQ_POWER_EFFICIENT, 0);
L
Linus Torvalds 已提交
3316 3317 3318 3319
	if (!kblockd_workqueue)
		panic("Failed to create kblockd\n");

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

3322
	blk_requestq_cachep = kmem_cache_create("blkdev_queue",
3323
			sizeof(struct request_queue), 0, SLAB_PANIC, NULL);
L
Linus Torvalds 已提交
3324

3325
	return 0;
L
Linus Torvalds 已提交
3326
}