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

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

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

40
#include "blk.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);
K
Keith Busch 已提交
46
EXPORT_TRACEPOINT_SYMBOL_GPL(block_split);
N
NeilBrown 已提交
47
EXPORT_TRACEPOINT_SYMBOL_GPL(block_unplug);
48

49 50
DEFINE_IDA(blk_queue_ida);

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

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

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

66 67 68 69 70
static void blk_clear_congested(struct request_list *rl, int sync)
{
#ifdef CONFIG_CGROUP_WRITEBACK
	clear_wb_congested(rl->blkg->wb_congested, sync);
#else
71 72 73 74 75 76
	/*
	 * If !CGROUP_WRITEBACK, all blkg's map to bdi->wb and we shouldn't
	 * flip its congestion state for events on other blkcgs.
	 */
	if (rl == &rl->q->root_rl)
		clear_wb_congested(rl->q->backing_dev_info.wb.congested, sync);
77 78 79 80 81 82 83 84
#endif
}

static void blk_set_congested(struct request_list *rl, int sync)
{
#ifdef CONFIG_CGROUP_WRITEBACK
	set_wb_congested(rl->blkg->wb_congested, sync);
#else
85 86 87
	/* see blk_clear_congested() */
	if (rl == &rl->q->root_rl)
		set_wb_congested(rl->q->backing_dev_info.wb.congested, sync);
88 89 90
#endif
}

91
void blk_queue_congestion_threshold(struct request_queue *q)
L
Linus Torvalds 已提交
92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110
{
	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
111 112
 * backing_dev_info.  This function can only be called if @bdev is opened
 * and the return value is never NULL.
L
Linus Torvalds 已提交
113 114 115
 */
struct backing_dev_info *blk_get_backing_dev_info(struct block_device *bdev)
{
116
	struct request_queue *q = bdev_get_queue(bdev);
L
Linus Torvalds 已提交
117

118
	return &q->backing_dev_info;
L
Linus Torvalds 已提交
119 120 121
}
EXPORT_SYMBOL(blk_get_backing_dev_info);

122
void blk_rq_init(struct request_queue *q, struct request *rq)
L
Linus Torvalds 已提交
123
{
124 125
	memset(rq, 0, sizeof(*rq));

L
Linus Torvalds 已提交
126
	INIT_LIST_HEAD(&rq->queuelist);
J
Jens Axboe 已提交
127
	INIT_LIST_HEAD(&rq->timeout_list);
128
	rq->cpu = -1;
J
Jens Axboe 已提交
129
	rq->q = q;
130
	rq->__sector = (sector_t) -1;
131 132
	INIT_HLIST_NODE(&rq->hash);
	RB_CLEAR_NODE(&rq->rb_node);
133
	rq->cmd = rq->__cmd;
134
	rq->cmd_len = BLK_MAX_CDB;
J
Jens Axboe 已提交
135
	rq->tag = -1;
136
	rq->start_time = jiffies;
137
	set_start_time_ns(rq);
138
	rq->part = NULL;
L
Linus Torvalds 已提交
139
}
140
EXPORT_SYMBOL(blk_rq_init);
L
Linus Torvalds 已提交
141

N
NeilBrown 已提交
142 143
static void req_bio_endio(struct request *rq, struct bio *bio,
			  unsigned int nbytes, int error)
L
Linus Torvalds 已提交
144
{
145
	if (error)
146
		bio->bi_error = error;
147

T
Tejun Heo 已提交
148
	if (unlikely(rq->cmd_flags & REQ_QUIET))
149
		bio_set_flag(bio, BIO_QUIET);
150

151
	bio_advance(bio, nbytes);
152

T
Tejun Heo 已提交
153
	/* don't actually finish bio if it's part of flush sequence */
154
	if (bio->bi_iter.bi_size == 0 && !(rq->cmd_flags & REQ_FLUSH_SEQ))
155
		bio_endio(bio);
L
Linus Torvalds 已提交
156 157 158 159 160 161
}

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

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

166 167 168
	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));
169 170
	printk(KERN_INFO "  bio %p, biotail %p, len %u\n",
	       rq->bio, rq->biotail, blk_rq_bytes(rq));
L
Linus Torvalds 已提交
171

172
	if (rq->cmd_type == REQ_TYPE_BLOCK_PC) {
173
		printk(KERN_INFO "  cdb: ");
174
		for (bit = 0; bit < BLK_MAX_CDB; bit++)
L
Linus Torvalds 已提交
175 176 177 178 179 180
			printk("%02x ", rq->cmd[bit]);
		printk("\n");
	}
}
EXPORT_SYMBOL(blk_dump_rq_flags);

181
static void blk_delay_work(struct work_struct *work)
L
Linus Torvalds 已提交
182
{
183
	struct request_queue *q;
L
Linus Torvalds 已提交
184

185 186
	q = container_of(work, struct request_queue, delay_work.work);
	spin_lock_irq(q->queue_lock);
187
	__blk_run_queue(q);
188
	spin_unlock_irq(q->queue_lock);
L
Linus Torvalds 已提交
189 190 191
}

/**
192 193 194
 * blk_delay_queue - restart queueing after defined interval
 * @q:		The &struct request_queue in question
 * @msecs:	Delay in msecs
L
Linus Torvalds 已提交
195 196
 *
 * Description:
197 198
 *   Sometimes queueing needs to be postponed for a little while, to allow
 *   resources to come back. This function will make sure that queueing is
199
 *   restarted around the specified time. Queue lock must be held.
200 201
 */
void blk_delay_queue(struct request_queue *q, unsigned long msecs)
202
{
203 204 205
	if (likely(!blk_queue_dead(q)))
		queue_delayed_work(kblockd_workqueue, &q->delay_work,
				   msecs_to_jiffies(msecs));
206
}
207
EXPORT_SYMBOL(blk_delay_queue);
208

L
Linus Torvalds 已提交
209 210
/**
 * blk_start_queue - restart a previously stopped queue
211
 * @q:    The &struct request_queue in question
L
Linus Torvalds 已提交
212 213 214 215 216 217
 *
 * 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.
 **/
218
void blk_start_queue(struct request_queue *q)
L
Linus Torvalds 已提交
219
{
220 221
	WARN_ON(!irqs_disabled());

N
Nick Piggin 已提交
222
	queue_flag_clear(QUEUE_FLAG_STOPPED, q);
223
	__blk_run_queue(q);
L
Linus Torvalds 已提交
224 225 226 227 228
}
EXPORT_SYMBOL(blk_start_queue);

/**
 * blk_stop_queue - stop a queue
229
 * @q:    The &struct request_queue in question
L
Linus Torvalds 已提交
230 231 232 233 234 235 236 237 238 239 240
 *
 * 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.
 **/
241
void blk_stop_queue(struct request_queue *q)
L
Linus Torvalds 已提交
242
{
243
	cancel_delayed_work(&q->delay_work);
N
Nick Piggin 已提交
244
	queue_flag_set(QUEUE_FLAG_STOPPED, q);
L
Linus Torvalds 已提交
245 246 247 248 249 250 251 252 253 254 255 256
}
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
257
 *     that the callbacks might use. The caller must already have made sure
L
Linus Torvalds 已提交
258 259 260
 *     that its ->make_request_fn will not re-add plugging prior to calling
 *     this function.
 *
261
 *     This function does not cancel any asynchronous activity arising
262
 *     out of elevator or throttling code. That would require elevator_exit()
263
 *     and blkcg_exit_queue() to be called with queue lock initialized.
264
 *
L
Linus Torvalds 已提交
265 266 267
 */
void blk_sync_queue(struct request_queue *q)
{
268
	del_timer_sync(&q->timeout);
269 270 271 272 273

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

274 275 276 277
		queue_for_each_hw_ctx(q, hctx, i) {
			cancel_delayed_work_sync(&hctx->run_work);
			cancel_delayed_work_sync(&hctx->delay_work);
		}
278 279 280
	} else {
		cancel_delayed_work_sync(&q->delay_work);
	}
L
Linus Torvalds 已提交
281 282 283
}
EXPORT_SYMBOL(blk_sync_queue);

284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299
/**
 * __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;

300 301 302 303 304 305 306 307
	/*
	 * 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++;
308
	q->request_fn(q);
309
	q->request_fn_active--;
310
}
311
EXPORT_SYMBOL_GPL(__blk_run_queue_uncond);
312

L
Linus Torvalds 已提交
313
/**
314
 * __blk_run_queue - run a single device queue
L
Linus Torvalds 已提交
315
 * @q:	The queue to run
316 317 318
 *
 * Description:
 *    See @blk_run_queue. This variant must be called with the queue lock
319
 *    held and interrupts disabled.
L
Linus Torvalds 已提交
320
 */
321
void __blk_run_queue(struct request_queue *q)
L
Linus Torvalds 已提交
322
{
323 324 325
	if (unlikely(blk_queue_stopped(q)))
		return;

326
	__blk_run_queue_uncond(q);
N
Nick Piggin 已提交
327 328
}
EXPORT_SYMBOL(__blk_run_queue);
J
Jens Axboe 已提交
329

330 331 332 333 334 335
/**
 * 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
336
 *    of us. The caller must hold the queue lock.
337 338 339
 */
void blk_run_queue_async(struct request_queue *q)
{
340
	if (likely(!blk_queue_stopped(q) && !blk_queue_dead(q)))
341
		mod_delayed_work(kblockd_workqueue, &q->delay_work, 0);
342
}
343
EXPORT_SYMBOL(blk_run_queue_async);
344

N
Nick Piggin 已提交
345 346 347
/**
 * blk_run_queue - run a single device queue
 * @q: The queue to run
348 349 350
 *
 * Description:
 *    Invoke request handling on this queue, if it has pending work to do.
T
Tejun Heo 已提交
351
 *    May be used to restart queueing when a request has completed.
N
Nick Piggin 已提交
352 353 354 355 356 357
 */
void blk_run_queue(struct request_queue *q)
{
	unsigned long flags;

	spin_lock_irqsave(q->queue_lock, flags);
358
	__blk_run_queue(q);
L
Linus Torvalds 已提交
359 360 361 362
	spin_unlock_irqrestore(q->queue_lock, flags);
}
EXPORT_SYMBOL(blk_run_queue);

363
void blk_put_queue(struct request_queue *q)
364 365 366
{
	kobject_put(&q->kobj);
}
J
Jens Axboe 已提交
367
EXPORT_SYMBOL(blk_put_queue);
368

T
Tejun Heo 已提交
369
/**
370
 * __blk_drain_queue - drain requests from request_queue
T
Tejun Heo 已提交
371
 * @q: queue to drain
372
 * @drain_all: whether to drain all requests or only the ones w/ ELVPRIV
T
Tejun Heo 已提交
373
 *
374 375 376
 * 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 已提交
377
 */
378 379 380
static void __blk_drain_queue(struct request_queue *q, bool drain_all)
	__releases(q->queue_lock)
	__acquires(q->queue_lock)
T
Tejun Heo 已提交
381
{
382 383
	int i;

384 385
	lockdep_assert_held(q->queue_lock);

T
Tejun Heo 已提交
386
	while (true) {
387
		bool drain = false;
T
Tejun Heo 已提交
388

389 390 391 392 393 394 395
		/*
		 * The caller might be trying to drain @q before its
		 * elevator is initialized.
		 */
		if (q->elevator)
			elv_drain_elevator(q);

396
		blkcg_drain_queue(q);
T
Tejun Heo 已提交
397

398 399
		/*
		 * This function might be called on a queue which failed
400 401 402 403
		 * 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.
404
		 */
405
		if (!list_empty(&q->queue_head) && q->request_fn)
406
			__blk_run_queue(q);
407

408
		drain |= q->nr_rqs_elvpriv;
409
		drain |= q->request_fn_active;
410 411 412 413 414 415 416

		/*
		 * 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) {
417
			struct blk_flush_queue *fq = blk_get_flush_queue(q, NULL);
418 419
			drain |= !list_empty(&q->queue_head);
			for (i = 0; i < 2; i++) {
420
				drain |= q->nr_rqs[i];
421
				drain |= q->in_flight[i];
422 423
				if (fq)
				    drain |= !list_empty(&fq->flush_queue[i]);
424 425
			}
		}
T
Tejun Heo 已提交
426

427
		if (!drain)
T
Tejun Heo 已提交
428
			break;
429 430 431

		spin_unlock_irq(q->queue_lock);

T
Tejun Heo 已提交
432
		msleep(10);
433 434

		spin_lock_irq(q->queue_lock);
T
Tejun Heo 已提交
435
	}
436 437 438 439 440 441 442

	/*
	 * 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) {
443 444 445 446 447
		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]);
448
	}
T
Tejun Heo 已提交
449 450
}

451 452 453 454 455 456
/**
 * 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
457
 * throttled or issued before.  On return, it's guaranteed that no request
458 459
 * is being throttled or has ELVPRIV set and blk_queue_bypass() %true
 * inside queue or RCU read lock.
460 461 462 463
 */
void blk_queue_bypass_start(struct request_queue *q)
{
	spin_lock_irq(q->queue_lock);
464
	q->bypass_depth++;
465 466 467
	queue_flag_set(QUEUE_FLAG_BYPASS, q);
	spin_unlock_irq(q->queue_lock);

468 469 470 471 472 473
	/*
	 * Queues start drained.  Skip actual draining till init is
	 * complete.  This avoids lenghty delays during queue init which
	 * can happen many times during boot.
	 */
	if (blk_queue_init_done(q)) {
474 475 476 477
		spin_lock_irq(q->queue_lock);
		__blk_drain_queue(q, false);
		spin_unlock_irq(q->queue_lock);

478 479 480
		/* ensure blk_queue_bypass() is %true inside RCU read lock */
		synchronize_rcu();
	}
481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499
}
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);

500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518
void blk_set_queue_dying(struct request_queue *q)
{
	queue_flag_set_unlocked(QUEUE_FLAG_DYING, q);

	if (q->mq_ops)
		blk_mq_wake_waiters(q);
	else {
		struct request_list *rl;

		blk_queue_for_each_rl(rl, q) {
			if (rl->rq_pool) {
				wake_up(&rl->wait[BLK_RW_SYNC]);
				wake_up(&rl->wait[BLK_RW_ASYNC]);
			}
		}
	}
}
EXPORT_SYMBOL_GPL(blk_set_queue_dying);

519 520 521 522
/**
 * blk_cleanup_queue - shutdown a request queue
 * @q: request queue to shutdown
 *
523 524
 * Mark @q DYING, drain all pending requests, mark @q DEAD, destroy and
 * put it.  All future requests will be failed immediately with -ENODEV.
525
 */
526
void blk_cleanup_queue(struct request_queue *q)
527
{
528
	spinlock_t *lock = q->queue_lock;
529

B
Bart Van Assche 已提交
530
	/* mark @q DYING, no new request or merges will be allowed afterwards */
531
	mutex_lock(&q->sysfs_lock);
532
	blk_set_queue_dying(q);
533
	spin_lock_irq(lock);
534

535
	/*
B
Bart Van Assche 已提交
536
	 * A dying queue is permanently in bypass mode till released.  Note
537 538 539 540 541 542 543
	 * 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.
	 */
544 545 546
	q->bypass_depth++;
	queue_flag_set(QUEUE_FLAG_BYPASS, q);

547 548
	queue_flag_set(QUEUE_FLAG_NOMERGES, q);
	queue_flag_set(QUEUE_FLAG_NOXMERGES, q);
B
Bart Van Assche 已提交
549
	queue_flag_set(QUEUE_FLAG_DYING, q);
550 551 552
	spin_unlock_irq(lock);
	mutex_unlock(&q->sysfs_lock);

553 554 555 556
	/*
	 * Drain all requests queued before DYING marking. Set DEAD flag to
	 * prevent that q->request_fn() gets invoked after draining finished.
	 */
557 558 559
	blk_freeze_queue(q);
	spin_lock_irq(lock);
	if (!q->mq_ops)
560
		__blk_drain_queue(q, true);
561
	queue_flag_set(QUEUE_FLAG_DEAD, q);
562
	spin_unlock_irq(lock);
563

564 565 566
	/* for synchronous bio-based driver finish in-flight integrity i/o */
	blk_flush_integrity();

567 568 569 570
	/* @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);

B
Bart Van Assche 已提交
571 572
	if (q->mq_ops)
		blk_mq_free_queue(q);
573
	percpu_ref_exit(&q->q_usage_counter);
B
Bart Van Assche 已提交
574

575 576 577 578 579
	spin_lock_irq(lock);
	if (q->queue_lock != &q->__queue_lock)
		q->queue_lock = &q->__queue_lock;
	spin_unlock_irq(lock);

580
	bdi_unregister(&q->backing_dev_info);
581

582
	/* @q is and will stay empty, shutdown and put */
583 584
	blk_put_queue(q);
}
L
Linus Torvalds 已提交
585 586
EXPORT_SYMBOL(blk_cleanup_queue);

587 588 589 590 591 592 593 594 595 596 597 598
/* Allocate memory local to the request queue */
static void *alloc_request_struct(gfp_t gfp_mask, void *data)
{
	int nid = (int)(long)data;
	return kmem_cache_alloc_node(request_cachep, gfp_mask, nid);
}

static void free_request_struct(void *element, void *unused)
{
	kmem_cache_free(request_cachep, element);
}

599 600
int blk_init_rl(struct request_list *rl, struct request_queue *q,
		gfp_t gfp_mask)
L
Linus Torvalds 已提交
601
{
602 603 604
	if (unlikely(rl->rq_pool))
		return 0;

605
	rl->q = q;
606 607 608 609
	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 已提交
610

611 612 613 614
	rl->rq_pool = mempool_create_node(BLKDEV_MIN_RQ, alloc_request_struct,
					  free_request_struct,
					  (void *)(long)q->node, gfp_mask,
					  q->node);
L
Linus Torvalds 已提交
615 616 617 618 619 620
	if (!rl->rq_pool)
		return -ENOMEM;

	return 0;
}

621 622 623 624 625 626
void blk_exit_rl(struct request_list *rl)
{
	if (rl->rq_pool)
		mempool_destroy(rl->rq_pool);
}

627
struct request_queue *blk_alloc_queue(gfp_t gfp_mask)
L
Linus Torvalds 已提交
628
{
629
	return blk_alloc_queue_node(gfp_mask, NUMA_NO_NODE);
630 631
}
EXPORT_SYMBOL(blk_alloc_queue);
L
Linus Torvalds 已提交
632

633
int blk_queue_enter(struct request_queue *q, bool nowait)
634 635 636 637 638 639 640
{
	while (true) {
		int ret;

		if (percpu_ref_tryget_live(&q->q_usage_counter))
			return 0;

641
		if (nowait)
642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666
			return -EBUSY;

		ret = wait_event_interruptible(q->mq_freeze_wq,
				!atomic_read(&q->mq_freeze_depth) ||
				blk_queue_dying(q));
		if (blk_queue_dying(q))
			return -ENODEV;
		if (ret)
			return ret;
	}
}

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

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

	wake_up_all(&q->mq_freeze_wq);
}

667
struct request_queue *blk_alloc_queue_node(gfp_t gfp_mask, int node_id)
668
{
669
	struct request_queue *q;
P
Peter Zijlstra 已提交
670
	int err;
671

672
	q = kmem_cache_alloc_node(blk_requestq_cachep,
673
				gfp_mask | __GFP_ZERO, node_id);
L
Linus Torvalds 已提交
674 675 676
	if (!q)
		return NULL;

677
	q->id = ida_simple_get(&blk_queue_ida, 0, 0, gfp_mask);
678
	if (q->id < 0)
679
		goto fail_q;
680

681 682 683 684
	q->bio_split = bioset_create(BIO_POOL_SIZE, 0);
	if (!q->bio_split)
		goto fail_id;

685 686
	q->backing_dev_info.ra_pages =
			(VM_MAX_READAHEAD * 1024) / PAGE_CACHE_SIZE;
687
	q->backing_dev_info.capabilities = BDI_CAP_CGROUP_WRITEBACK;
688
	q->backing_dev_info.name = "block";
689
	q->node = node_id;
690

P
Peter Zijlstra 已提交
691
	err = bdi_init(&q->backing_dev_info);
692
	if (err)
693
		goto fail_split;
P
Peter Zijlstra 已提交
694

695 696
	setup_timer(&q->backing_dev_info.laptop_mode_wb_timer,
		    laptop_mode_timer_fn, (unsigned long) q);
J
Jens Axboe 已提交
697
	setup_timer(&q->timeout, blk_rq_timed_out_timer, (unsigned long) q);
698
	INIT_LIST_HEAD(&q->queue_head);
J
Jens Axboe 已提交
699
	INIT_LIST_HEAD(&q->timeout_list);
700
	INIT_LIST_HEAD(&q->icq_list);
701
#ifdef CONFIG_BLK_CGROUP
702
	INIT_LIST_HEAD(&q->blkg_list);
703
#endif
704
	INIT_DELAYED_WORK(&q->delay_work, blk_delay_work);
705

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

708
	mutex_init(&q->sysfs_lock);
709
	spin_lock_init(&q->__queue_lock);
710

711 712 713 714 715 716
	/*
	 * By default initialize queue_lock to internal lock and driver can
	 * override it later if need be.
	 */
	q->queue_lock = &q->__queue_lock;

717 718 719
	/*
	 * A queue starts its life with bypass turned on to avoid
	 * unnecessary bypass on/off overhead and nasty surprises during
720 721
	 * init.  The initial bypass will be finished when the queue is
	 * registered by blk_register_queue().
722 723 724 725
	 */
	q->bypass_depth = 1;
	__set_bit(QUEUE_FLAG_BYPASS, &q->queue_flags);

726 727
	init_waitqueue_head(&q->mq_freeze_wq);

728 729 730 731 732 733 734
	/*
	 * Init percpu_ref in atomic mode so that it's faster to shutdown.
	 * See blk_register_queue() for details.
	 */
	if (percpu_ref_init(&q->q_usage_counter,
				blk_queue_usage_counter_release,
				PERCPU_REF_INIT_ATOMIC, GFP_KERNEL))
735
		goto fail_bdi;
736

737 738 739
	if (blkcg_init_queue(q))
		goto fail_ref;

L
Linus Torvalds 已提交
740
	return q;
741

742 743
fail_ref:
	percpu_ref_exit(&q->q_usage_counter);
744 745
fail_bdi:
	bdi_destroy(&q->backing_dev_info);
746 747
fail_split:
	bioset_free(q->bio_split);
748 749 750 751 752
fail_id:
	ida_simple_remove(&blk_queue_ida, q->id);
fail_q:
	kmem_cache_free(blk_requestq_cachep, q);
	return NULL;
L
Linus Torvalds 已提交
753
}
754
EXPORT_SYMBOL(blk_alloc_queue_node);
L
Linus Torvalds 已提交
755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777

/**
 * 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
778 779
 *    request queue; this lock will be taken also from interrupt context, so irq
 *    disabling is needed for it.
L
Linus Torvalds 已提交
780
 *
781
 *    Function returns a pointer to the initialized request queue, or %NULL if
L
Linus Torvalds 已提交
782 783 784 785 786 787
 *    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).
 **/
788

789
struct request_queue *blk_init_queue(request_fn_proc *rfn, spinlock_t *lock)
L
Linus Torvalds 已提交
790
{
791
	return blk_init_queue_node(rfn, lock, NUMA_NO_NODE);
792 793 794
}
EXPORT_SYMBOL(blk_init_queue);

795
struct request_queue *
796 797
blk_init_queue_node(request_fn_proc *rfn, spinlock_t *lock, int node_id)
{
798
	struct request_queue *uninit_q, *q;
L
Linus Torvalds 已提交
799

800 801 802 803
	uninit_q = blk_alloc_queue_node(GFP_KERNEL, node_id);
	if (!uninit_q)
		return NULL;

804
	q = blk_init_allocated_queue(uninit_q, rfn, lock);
805
	if (!q)
806
		blk_cleanup_queue(uninit_q);
807

808
	return q;
809 810 811
}
EXPORT_SYMBOL(blk_init_queue_node);

812
static blk_qc_t blk_queue_bio(struct request_queue *q, struct bio *bio);
813

814 815 816 817
struct request_queue *
blk_init_allocated_queue(struct request_queue *q, request_fn_proc *rfn,
			 spinlock_t *lock)
{
L
Linus Torvalds 已提交
818 819 820
	if (!q)
		return NULL;

821
	q->fq = blk_alloc_flush_queue(q, NUMA_NO_NODE, 0);
822
	if (!q->fq)
823 824
		return NULL;

825
	if (blk_init_rl(&q->root_rl, q, GFP_KERNEL))
826
		goto fail;
L
Linus Torvalds 已提交
827 828 829

	q->request_fn		= rfn;
	q->prep_rq_fn		= NULL;
830
	q->unprep_rq_fn		= NULL;
831
	q->queue_flags		|= QUEUE_FLAG_DEFAULT;
832 833 834 835

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

837 838 839
	/*
	 * This also sets hw/phys segments, boundary and size
	 */
840
	blk_queue_make_request(q, blk_queue_bio);
L
Linus Torvalds 已提交
841

842 843
	q->sg_reserved_size = INT_MAX;

844 845 846
	/* Protect q->elevator from elevator_change */
	mutex_lock(&q->sysfs_lock);

847
	/* init elevator */
848 849
	if (elevator_init(q, NULL)) {
		mutex_unlock(&q->sysfs_lock);
850
		goto fail;
851 852 853 854
	}

	mutex_unlock(&q->sysfs_lock);

855
	return q;
856 857

fail:
858
	blk_free_flush_queue(q->fq);
859
	return NULL;
L
Linus Torvalds 已提交
860
}
861
EXPORT_SYMBOL(blk_init_allocated_queue);
L
Linus Torvalds 已提交
862

T
Tejun Heo 已提交
863
bool blk_get_queue(struct request_queue *q)
L
Linus Torvalds 已提交
864
{
B
Bart Van Assche 已提交
865
	if (likely(!blk_queue_dying(q))) {
T
Tejun Heo 已提交
866 867
		__blk_get_queue(q);
		return true;
L
Linus Torvalds 已提交
868 869
	}

T
Tejun Heo 已提交
870
	return false;
L
Linus Torvalds 已提交
871
}
J
Jens Axboe 已提交
872
EXPORT_SYMBOL(blk_get_queue);
L
Linus Torvalds 已提交
873

874
static inline void blk_free_request(struct request_list *rl, struct request *rq)
L
Linus Torvalds 已提交
875
{
876
	if (rq->cmd_flags & REQ_ELVPRIV) {
877
		elv_put_request(rl->q, rq);
878
		if (rq->elv.icq)
879
			put_io_context(rq->elv.icq->ioc);
880 881
	}

882
	mempool_free(rq, rl->rq_pool);
L
Linus Torvalds 已提交
883 884 885 886 887 888
}

/*
 * ioc_batching returns true if the ioc is a valid batching request and
 * should be given priority access to a request.
 */
889
static inline int ioc_batching(struct request_queue *q, struct io_context *ioc)
L
Linus Torvalds 已提交
890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905 906 907 908 909
{
	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.
 */
910
static void ioc_set_batching(struct request_queue *q, struct io_context *ioc)
L
Linus Torvalds 已提交
911 912 913 914 915 916 917 918
{
	if (!ioc || ioc_batching(q, ioc))
		return;

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

919
static void __freed_request(struct request_list *rl, int sync)
L
Linus Torvalds 已提交
920
{
921
	struct request_queue *q = rl->q;
L
Linus Torvalds 已提交
922

923 924
	if (rl->count[sync] < queue_congestion_off_threshold(q))
		blk_clear_congested(rl, sync);
L
Linus Torvalds 已提交
925

926 927 928
	if (rl->count[sync] + 1 <= q->nr_requests) {
		if (waitqueue_active(&rl->wait[sync]))
			wake_up(&rl->wait[sync]);
L
Linus Torvalds 已提交
929

930
		blk_clear_rl_full(rl, sync);
L
Linus Torvalds 已提交
931 932 933 934 935 936 937
	}
}

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

943
	q->nr_rqs[sync]--;
944
	rl->count[sync]--;
945
	if (flags & REQ_ELVPRIV)
946
		q->nr_rqs_elvpriv--;
L
Linus Torvalds 已提交
947

948
	__freed_request(rl, sync);
L
Linus Torvalds 已提交
949

950
	if (unlikely(rl->starved[sync ^ 1]))
951
		__freed_request(rl, sync ^ 1);
L
Linus Torvalds 已提交
952 953
}

954 955 956
int blk_update_nr_requests(struct request_queue *q, unsigned int nr)
{
	struct request_list *rl;
957
	int on_thresh, off_thresh;
958 959 960 961

	spin_lock_irq(q->queue_lock);
	q->nr_requests = nr;
	blk_queue_congestion_threshold(q);
962 963
	on_thresh = queue_congestion_on_threshold(q);
	off_thresh = queue_congestion_off_threshold(q);
964

965 966 967 968 969
	blk_queue_for_each_rl(rl, q) {
		if (rl->count[BLK_RW_SYNC] >= on_thresh)
			blk_set_congested(rl, BLK_RW_SYNC);
		else if (rl->count[BLK_RW_SYNC] < off_thresh)
			blk_clear_congested(rl, BLK_RW_SYNC);
970

971 972 973 974
		if (rl->count[BLK_RW_ASYNC] >= on_thresh)
			blk_set_congested(rl, BLK_RW_ASYNC);
		else if (rl->count[BLK_RW_ASYNC] < off_thresh)
			blk_clear_congested(rl, BLK_RW_ASYNC);
975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994

		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;
}

995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013
/*
 * 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;
}

1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029
/**
 * 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;
}

1030
/**
T
Tejun Heo 已提交
1031
 * __get_request - get a free request
1032
 * @rl: request list to allocate from
1033 1034 1035 1036 1037 1038 1039
 * @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.
 *
1040
 * Must be called with @q->queue_lock held and,
1041 1042
 * Returns ERR_PTR on failure, with @q->queue_lock held.
 * Returns request pointer on success, with @q->queue_lock *not held*.
L
Linus Torvalds 已提交
1043
 */
1044
static struct request *__get_request(struct request_list *rl, int rw_flags,
T
Tejun Heo 已提交
1045
				     struct bio *bio, gfp_t gfp_mask)
L
Linus Torvalds 已提交
1046
{
1047
	struct request_queue *q = rl->q;
T
Tejun Heo 已提交
1048
	struct request *rq;
T
Tejun Heo 已提交
1049 1050
	struct elevator_type *et = q->elevator->type;
	struct io_context *ioc = rq_ioc(bio);
1051
	struct io_cq *icq = NULL;
1052
	const bool is_sync = rw_is_sync(rw_flags) != 0;
1053
	int may_queue;
1054

B
Bart Van Assche 已提交
1055
	if (unlikely(blk_queue_dying(q)))
1056
		return ERR_PTR(-ENODEV);
1057

1058
	may_queue = elv_may_queue(q, rw_flags);
1059 1060 1061
	if (may_queue == ELV_MQUEUE_NO)
		goto rq_starved;

1062 1063
	if (rl->count[is_sync]+1 >= queue_congestion_on_threshold(q)) {
		if (rl->count[is_sync]+1 >= q->nr_requests) {
1064 1065 1066 1067 1068 1069
			/*
			 * 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.
			 */
1070
			if (!blk_rl_full(rl, is_sync)) {
1071
				ioc_set_batching(q, ioc);
1072
				blk_set_rl_full(rl, is_sync);
1073 1074 1075 1076 1077 1078 1079 1080
			} 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
					 */
1081
					return ERR_PTR(-ENOMEM);
1082 1083
				}
			}
L
Linus Torvalds 已提交
1084
		}
1085
		blk_set_congested(rl, is_sync);
L
Linus Torvalds 已提交
1086 1087
	}

1088 1089 1090 1091 1092
	/*
	 * 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
	 */
1093
	if (rl->count[is_sync] >= (3 * q->nr_requests / 2))
1094
		return ERR_PTR(-ENOMEM);
H
Hugh Dickins 已提交
1095

1096
	q->nr_rqs[is_sync]++;
1097 1098
	rl->count[is_sync]++;
	rl->starved[is_sync] = 0;
T
Tejun Heo 已提交
1099

1100 1101 1102 1103 1104 1105 1106 1107 1108 1109
	/*
	 * 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.
	 */
1110
	if (blk_rq_should_init_elevator(bio) && !blk_queue_bypass(q)) {
1111
		rw_flags |= REQ_ELVPRIV;
1112
		q->nr_rqs_elvpriv++;
1113 1114
		if (et->icq_cache && ioc)
			icq = ioc_lookup_icq(ioc, q);
1115
	}
T
Tejun Heo 已提交
1116

1117 1118
	if (blk_queue_io_stat(q))
		rw_flags |= REQ_IO_STAT;
L
Linus Torvalds 已提交
1119 1120
	spin_unlock_irq(q->queue_lock);

1121
	/* allocate and init request */
1122
	rq = mempool_alloc(rl->rq_pool, gfp_mask);
1123
	if (!rq)
T
Tejun Heo 已提交
1124
		goto fail_alloc;
L
Linus Torvalds 已提交
1125

1126
	blk_rq_init(q, rq);
1127
	blk_rq_set_rl(rq, rl);
1128 1129
	rq->cmd_flags = rw_flags | REQ_ALLOCED;

1130
	/* init elvpriv */
1131
	if (rw_flags & REQ_ELVPRIV) {
1132
		if (unlikely(et->icq_cache && !icq)) {
T
Tejun Heo 已提交
1133 1134
			if (ioc)
				icq = ioc_create_icq(ioc, q, gfp_mask);
1135 1136
			if (!icq)
				goto fail_elvpriv;
1137
		}
1138 1139 1140 1141 1142 1143

		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 */
1144 1145 1146
		if (icq)
			get_io_context(icq->ioc);
	}
1147
out:
1148 1149 1150 1151 1152 1153
	/*
	 * 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 已提交
1154 1155
	if (ioc_batching(q, ioc))
		ioc->nr_batch_requests--;
1156

1157
	trace_block_getrq(q, bio, rw_flags & 1);
L
Linus Torvalds 已提交
1158
	return rq;
T
Tejun Heo 已提交
1159

1160 1161 1162 1163 1164 1165 1166
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.
	 */
1167 1168
	printk_ratelimited(KERN_WARNING "%s: dev %s: request aux data allocation failed, iosched may be disturbed\n",
			   __func__, dev_name(q->backing_dev_info.dev));
1169 1170 1171 1172 1173

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

	spin_lock_irq(q->queue_lock);
1174
	q->nr_rqs_elvpriv--;
1175 1176 1177
	spin_unlock_irq(q->queue_lock);
	goto out;

T
Tejun Heo 已提交
1178 1179 1180 1181 1182 1183 1184 1185 1186
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);
1187
	freed_request(rl, rw_flags);
T
Tejun Heo 已提交
1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198

	/*
	 * 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;
1199
	return ERR_PTR(-ENOMEM);
L
Linus Torvalds 已提交
1200 1201
}

1202
/**
T
Tejun Heo 已提交
1203
 * get_request - get a free request
1204 1205 1206
 * @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 已提交
1207
 * @gfp_mask: allocation mask
1208
 *
1209 1210
 * Get a free request from @q.  If %__GFP_DIRECT_RECLAIM is set in @gfp_mask,
 * this function keeps retrying under memory pressure and fails iff @q is dead.
N
Nick Piggin 已提交
1211
 *
1212
 * Must be called with @q->queue_lock held and,
1213 1214
 * Returns ERR_PTR on failure, with @q->queue_lock held.
 * Returns request pointer on success, with @q->queue_lock *not held*.
L
Linus Torvalds 已提交
1215
 */
T
Tejun Heo 已提交
1216 1217
static struct request *get_request(struct request_queue *q, int rw_flags,
				   struct bio *bio, gfp_t gfp_mask)
L
Linus Torvalds 已提交
1218
{
1219
	const bool is_sync = rw_is_sync(rw_flags) != 0;
T
Tejun Heo 已提交
1220
	DEFINE_WAIT(wait);
1221
	struct request_list *rl;
L
Linus Torvalds 已提交
1222
	struct request *rq;
1223 1224

	rl = blk_get_rl(q, bio);	/* transferred to @rq on success */
T
Tejun Heo 已提交
1225
retry:
1226
	rq = __get_request(rl, rw_flags, bio, gfp_mask);
1227
	if (!IS_ERR(rq))
T
Tejun Heo 已提交
1228
		return rq;
L
Linus Torvalds 已提交
1229

1230
	if (!gfpflags_allow_blocking(gfp_mask) || unlikely(blk_queue_dying(q))) {
1231
		blk_put_rl(rl);
1232
		return rq;
1233
	}
L
Linus Torvalds 已提交
1234

T
Tejun Heo 已提交
1235 1236 1237
	/* wait on @rl and retry */
	prepare_to_wait_exclusive(&rl->wait[is_sync], &wait,
				  TASK_UNINTERRUPTIBLE);
L
Linus Torvalds 已提交
1238

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

T
Tejun Heo 已提交
1241 1242
	spin_unlock_irq(q->queue_lock);
	io_schedule();
N
Nick Piggin 已提交
1243

T
Tejun Heo 已提交
1244 1245 1246 1247 1248 1249
	/*
	 * 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);
1250

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

T
Tejun Heo 已提交
1254
	goto retry;
L
Linus Torvalds 已提交
1255 1256
}

1257 1258
static struct request *blk_old_get_request(struct request_queue *q, int rw,
		gfp_t gfp_mask)
L
Linus Torvalds 已提交
1259 1260 1261 1262 1263
{
	struct request *rq;

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

T
Tejun Heo 已提交
1264 1265 1266
	/* create ioc upfront */
	create_io_context(gfp_mask, q->node);

N
Nick Piggin 已提交
1267
	spin_lock_irq(q->queue_lock);
T
Tejun Heo 已提交
1268
	rq = get_request(q, rw, NULL, gfp_mask);
1269
	if (IS_ERR(rq))
1270
		spin_unlock_irq(q->queue_lock);
N
Nick Piggin 已提交
1271
	/* q->queue_lock is unlocked at this point */
L
Linus Torvalds 已提交
1272 1273 1274

	return rq;
}
1275 1276 1277 1278

struct request *blk_get_request(struct request_queue *q, int rw, gfp_t gfp_mask)
{
	if (q->mq_ops)
1279 1280 1281
		return blk_mq_alloc_request(q, rw,
			(gfp_mask & __GFP_DIRECT_RECLAIM) ?
				0 : BLK_MQ_REQ_NOWAIT);
1282 1283 1284
	else
		return blk_old_get_request(q, rw, gfp_mask);
}
L
Linus Torvalds 已提交
1285 1286
EXPORT_SYMBOL(blk_get_request);

1287
/**
1288
 * blk_make_request - given a bio, allocate a corresponding struct request.
1289
 * @q: target request queue
1290 1291
 * @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.
1292
 * @gfp_mask: gfp flags to be used for memory allocation
1293
 *
1294 1295 1296 1297
 * 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.
1298
 *
1299 1300 1301 1302 1303 1304 1305 1306 1307
 * 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.
1308 1309
 *
 * WARNING: When allocating/cloning a bio-chain, careful consideration should be
1310 1311 1312 1313 1314
 * given to how you allocate bios. In particular, you cannot use
 * __GFP_DIRECT_RECLAIM 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.
1315 1316
 * 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.
1317
 */
1318 1319
struct request *blk_make_request(struct request_queue *q, struct bio *bio,
				 gfp_t gfp_mask)
1320
{
1321 1322
	struct request *rq = blk_get_request(q, bio_data_dir(bio), gfp_mask);

1323 1324
	if (IS_ERR(rq))
		return rq;
1325

J
Jens Axboe 已提交
1326 1327
	blk_rq_set_block_pc(rq);

1328 1329 1330 1331 1332 1333 1334 1335 1336 1337 1338 1339 1340
	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;
1341
}
1342
EXPORT_SYMBOL(blk_make_request);
1343

J
Jens Axboe 已提交
1344
/**
1345
 * blk_rq_set_block_pc - initialize a request to type BLOCK_PC
J
Jens Axboe 已提交
1346 1347 1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358
 * @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));
}
EXPORT_SYMBOL(blk_rq_set_block_pc);

L
Linus Torvalds 已提交
1359 1360 1361 1362 1363 1364 1365 1366 1367 1368
/**
 * 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.
 */
1369
void blk_requeue_request(struct request_queue *q, struct request *rq)
L
Linus Torvalds 已提交
1370
{
J
Jens Axboe 已提交
1371 1372
	blk_delete_timer(rq);
	blk_clear_rq_complete(rq);
1373
	trace_block_rq_requeue(q, rq);
1374

1375
	if (rq->cmd_flags & REQ_QUEUED)
L
Linus Torvalds 已提交
1376 1377
		blk_queue_end_tag(q, rq);

1378 1379
	BUG_ON(blk_queued_rq(rq));

L
Linus Torvalds 已提交
1380 1381 1382 1383
	elv_requeue_request(q, rq);
}
EXPORT_SYMBOL(blk_requeue_request);

1384 1385 1386
static void add_acct_request(struct request_queue *q, struct request *rq,
			     int where)
{
1387
	blk_account_io_start(rq, true);
J
Jens Axboe 已提交
1388
	__elv_add_request(q, rq, where);
1389 1390
}

T
Tejun Heo 已提交
1391 1392 1393
static void part_round_stats_single(int cpu, struct hd_struct *part,
				    unsigned long now)
{
1394 1395
	int inflight;

T
Tejun Heo 已提交
1396 1397 1398
	if (now == part->stamp)
		return;

1399 1400
	inflight = part_in_flight(part);
	if (inflight) {
T
Tejun Heo 已提交
1401
		__part_stat_add(cpu, part, time_in_queue,
1402
				inflight * (now - part->stamp));
T
Tejun Heo 已提交
1403 1404 1405 1406 1407 1408
		__part_stat_add(cpu, part, io_ticks, (now - part->stamp));
	}
	part->stamp = now;
}

/**
1409 1410 1411
 * 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 已提交
1412 1413 1414 1415 1416 1417 1418 1419 1420 1421 1422 1423
 *
 * 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 已提交
1424
void part_round_stats(int cpu, struct hd_struct *part)
1425 1426 1427
{
	unsigned long now = jiffies;

T
Tejun Heo 已提交
1428 1429 1430
	if (part->partno)
		part_round_stats_single(cpu, &part_to_disk(part)->part0, now);
	part_round_stats_single(cpu, part, now);
1431
}
T
Tejun Heo 已提交
1432
EXPORT_SYMBOL_GPL(part_round_stats);
1433

1434
#ifdef CONFIG_PM
L
Lin Ming 已提交
1435 1436 1437 1438 1439 1440 1441 1442 1443
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 已提交
1444 1445 1446
/*
 * queue lock must be held
 */
1447
void __blk_put_request(struct request_queue *q, struct request *req)
L
Linus Torvalds 已提交
1448 1449 1450 1451
{
	if (unlikely(!q))
		return;

1452 1453 1454 1455 1456
	if (q->mq_ops) {
		blk_mq_free_request(req);
		return;
	}

L
Lin Ming 已提交
1457 1458
	blk_pm_put_request(req);

1459 1460
	elv_completed_request(q, req);

1461 1462 1463
	/* this is a bio leak */
	WARN_ON(req->bio != NULL);

L
Linus Torvalds 已提交
1464 1465 1466 1467
	/*
	 * Request may not have originated from ll_rw_blk. if not,
	 * it didn't come out of our reserved rq pools
	 */
1468
	if (req->cmd_flags & REQ_ALLOCED) {
1469
		unsigned int flags = req->cmd_flags;
1470
		struct request_list *rl = blk_rq_rl(req);
L
Linus Torvalds 已提交
1471 1472

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

1475 1476 1477
		blk_free_request(rl, req);
		freed_request(rl, flags);
		blk_put_rl(rl);
L
Linus Torvalds 已提交
1478 1479
	}
}
1480 1481
EXPORT_SYMBOL_GPL(__blk_put_request);

L
Linus Torvalds 已提交
1482 1483
void blk_put_request(struct request *req)
{
1484
	struct request_queue *q = req->q;
1485

1486 1487 1488 1489 1490 1491 1492 1493 1494
	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 已提交
1495 1496 1497
}
EXPORT_SYMBOL(blk_put_request);

1498 1499 1500 1501 1502 1503 1504 1505 1506 1507 1508 1509 1510 1511 1512 1513 1514 1515 1516 1517 1518 1519
/**
 * 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;

1520
	bio->bi_iter.bi_size = len;
1521 1522 1523 1524 1525 1526 1527 1528
	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);

1529 1530
bool bio_attempt_back_merge(struct request_queue *q, struct request *req,
			    struct bio *bio)
1531 1532 1533 1534 1535 1536
{
	const int ff = bio->bi_rw & REQ_FAILFAST_MASK;

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

1537
	trace_block_bio_backmerge(q, req, bio);
1538 1539 1540 1541 1542 1543

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

	req->biotail->bi_next = bio;
	req->biotail = bio;
1544
	req->__data_len += bio->bi_iter.bi_size;
1545 1546
	req->ioprio = ioprio_best(req->ioprio, bio_prio(bio));

1547
	blk_account_io_start(req, false);
1548 1549 1550
	return true;
}

1551 1552
bool bio_attempt_front_merge(struct request_queue *q, struct request *req,
			     struct bio *bio)
1553 1554 1555 1556 1557 1558
{
	const int ff = bio->bi_rw & REQ_FAILFAST_MASK;

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

1559
	trace_block_bio_frontmerge(q, req, bio);
1560 1561 1562 1563 1564 1565 1566

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

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

1567 1568
	req->__sector = bio->bi_iter.bi_sector;
	req->__data_len += bio->bi_iter.bi_size;
1569 1570
	req->ioprio = ioprio_best(req->ioprio, bio_prio(bio));

1571
	blk_account_io_start(req, false);
1572 1573 1574
	return true;
}

1575
/**
1576
 * blk_attempt_plug_merge - try to merge with %current's plugged list
1577 1578 1579
 * @q: request_queue new bio is being queued at
 * @bio: new bio being queued
 * @request_count: out parameter for number of traversed plugged requests
1580 1581 1582
 * @same_queue_rq: pointer to &struct request that gets filled in when
 * another request associated with @q is found on the plug list
 * (optional, may be %NULL)
1583 1584 1585 1586 1587
 *
 * 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.
 *
1588 1589 1590 1591 1592 1593
 * 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.
1594 1595
 *
 * Caller must ensure !blk_queue_nomerges(q) beforehand.
1596
 */
1597
bool blk_attempt_plug_merge(struct request_queue *q, struct bio *bio,
1598 1599
			    unsigned int *request_count,
			    struct request **same_queue_rq)
1600 1601 1602 1603
{
	struct blk_plug *plug;
	struct request *rq;
	bool ret = false;
S
Shaohua Li 已提交
1604
	struct list_head *plug_list;
1605

1606
	plug = current->plug;
1607 1608
	if (!plug)
		goto out;
1609
	*request_count = 0;
1610

S
Shaohua Li 已提交
1611 1612 1613 1614 1615 1616
	if (q->mq_ops)
		plug_list = &plug->mq_list;
	else
		plug_list = &plug->list;

	list_for_each_entry_reverse(rq, plug_list, queuelist) {
1617 1618
		int el_ret;

1619
		if (rq->q == q) {
1620
			(*request_count)++;
1621 1622 1623 1624 1625 1626 1627 1628
			/*
			 * Only blk-mq multiple hardware queues case checks the
			 * rq in the same queue, there should be only one such
			 * rq in a queue
			 **/
			if (same_queue_rq)
				*same_queue_rq = rq;
		}
1629

1630
		if (rq->q != q || !blk_rq_merge_ok(rq, bio))
1631 1632
			continue;

1633
		el_ret = blk_try_merge(rq, bio);
1634 1635 1636 1637 1638 1639 1640 1641 1642 1643 1644 1645 1646 1647
		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;
}

1648 1649 1650 1651 1652 1653 1654 1655 1656 1657 1658 1659 1660 1661 1662 1663 1664 1665 1666 1667 1668 1669 1670 1671
unsigned int blk_plug_queued_count(struct request_queue *q)
{
	struct blk_plug *plug;
	struct request *rq;
	struct list_head *plug_list;
	unsigned int ret = 0;

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

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

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

J
Jens Axboe 已提交
1672
void init_request_from_bio(struct request *req, struct bio *bio)
1673
{
1674
	req->cmd_type = REQ_TYPE_FS;
1675

1676 1677
	req->cmd_flags |= bio->bi_rw & REQ_COMMON_MASK;
	if (bio->bi_rw & REQ_RAHEAD)
1678
		req->cmd_flags |= REQ_FAILFAST_MASK;
J
Jens Axboe 已提交
1679

1680
	req->errors = 0;
1681
	req->__sector = bio->bi_iter.bi_sector;
1682
	req->ioprio = bio_prio(bio);
1683
	blk_rq_bio_prep(req->q, req, bio);
1684 1685
}

1686
static blk_qc_t blk_queue_bio(struct request_queue *q, struct bio *bio)
L
Linus Torvalds 已提交
1687
{
J
Jiri Slaby 已提交
1688
	const bool sync = !!(bio->bi_rw & REQ_SYNC);
1689 1690 1691
	struct blk_plug *plug;
	int el_ret, rw_flags, where = ELEVATOR_INSERT_SORT;
	struct request *req;
1692
	unsigned int request_count = 0;
L
Linus Torvalds 已提交
1693

1694 1695
	blk_queue_split(q, &bio, q->bio_split);

L
Linus Torvalds 已提交
1696 1697 1698 1699 1700 1701 1702
	/*
	 * 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);

1703
	if (bio_integrity_enabled(bio) && bio_integrity_prep(bio)) {
1704 1705
		bio->bi_error = -EIO;
		bio_endio(bio);
1706
		return BLK_QC_T_NONE;
1707 1708
	}

1709
	if (bio->bi_rw & (REQ_FLUSH | REQ_FUA)) {
1710
		spin_lock_irq(q->queue_lock);
1711
		where = ELEVATOR_INSERT_FLUSH;
1712 1713 1714
		goto get_rq;
	}

1715 1716 1717 1718
	/*
	 * Check if we can merge with the plugged list before grabbing
	 * any locks.
	 */
1719 1720
	if (!blk_queue_nomerges(q)) {
		if (blk_attempt_plug_merge(q, bio, &request_count, NULL))
1721
			return BLK_QC_T_NONE;
1722 1723
	} else
		request_count = blk_plug_queued_count(q);
L
Linus Torvalds 已提交
1724

1725
	spin_lock_irq(q->queue_lock);
1726

1727 1728 1729
	el_ret = elv_merge(q, &req, bio);
	if (el_ret == ELEVATOR_BACK_MERGE) {
		if (bio_attempt_back_merge(q, req, bio)) {
1730
			elv_bio_merged(q, req, bio);
1731 1732 1733 1734 1735 1736
			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)) {
1737
			elv_bio_merged(q, req, bio);
1738 1739 1740
			if (!attempt_front_merge(q, req))
				elv_merged_request(q, req, el_ret);
			goto out_unlock;
1741
		}
L
Linus Torvalds 已提交
1742 1743
	}

1744
get_rq:
1745 1746 1747 1748 1749 1750 1751
	/*
	 * 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)
1752
		rw_flags |= REQ_SYNC;
1753

L
Linus Torvalds 已提交
1754
	/*
1755
	 * Grab a free request. This is might sleep but can not fail.
N
Nick Piggin 已提交
1756
	 * Returns with the queue unlocked.
1757
	 */
T
Tejun Heo 已提交
1758
	req = get_request(q, rw_flags, bio, GFP_NOIO);
1759
	if (IS_ERR(req)) {
1760 1761
		bio->bi_error = PTR_ERR(req);
		bio_endio(bio);
1762 1763
		goto out_unlock;
	}
N
Nick Piggin 已提交
1764

1765 1766 1767 1768 1769
	/*
	 * 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 已提交
1770
	 */
1771
	init_request_from_bio(req, bio);
L
Linus Torvalds 已提交
1772

1773
	if (test_bit(QUEUE_FLAG_SAME_COMP, &q->queue_flags))
1774
		req->cpu = raw_smp_processor_id();
1775 1776

	plug = current->plug;
J
Jens Axboe 已提交
1777
	if (plug) {
J
Jens Axboe 已提交
1778 1779
		/*
		 * If this is the first request added after a plug, fire
1780
		 * of a plug trace.
J
Jens Axboe 已提交
1781
		 */
1782
		if (!request_count)
J
Jens Axboe 已提交
1783
			trace_block_plug(q);
1784
		else {
S
Shaohua Li 已提交
1785
			if (request_count >= BLK_MAX_REQUEST_COUNT) {
1786
				blk_flush_plug_list(plug, false);
S
Shaohua Li 已提交
1787 1788
				trace_block_plug(q);
			}
1789 1790
		}
		list_add_tail(&req->queuelist, &plug->list);
1791
		blk_account_io_start(req, true);
1792 1793 1794
	} else {
		spin_lock_irq(q->queue_lock);
		add_acct_request(q, req, where);
1795
		__blk_run_queue(q);
1796 1797 1798
out_unlock:
		spin_unlock_irq(q->queue_lock);
	}
1799 1800

	return BLK_QC_T_NONE;
L
Linus Torvalds 已提交
1801 1802 1803 1804 1805 1806 1807 1808 1809
}

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

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

1813
		bio->bi_iter.bi_sector += p->start_sect;
L
Linus Torvalds 已提交
1814
		bio->bi_bdev = bdev->bd_contains;
1815

1816 1817
		trace_block_bio_remap(bdev_get_queue(bio->bi_bdev), bio,
				      bdev->bd_dev,
1818
				      bio->bi_iter.bi_sector - p->start_sect);
L
Linus Torvalds 已提交
1819 1820 1821 1822 1823 1824 1825 1826 1827 1828 1829
	}
}

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 已提交
1830
			(unsigned long long)bio_end_sector(bio),
1831
			(long long)(i_size_read(bio->bi_bdev->bd_inode) >> 9));
L
Linus Torvalds 已提交
1832 1833
}

1834 1835 1836 1837 1838 1839 1840 1841 1842 1843
#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);

1844
static bool should_fail_request(struct hd_struct *part, unsigned int bytes)
1845
{
1846
	return part->make_it_fail && should_fail(&fail_make_request, bytes);
1847 1848 1849 1850
}

static int __init fail_make_request_debugfs(void)
{
1851 1852 1853
	struct dentry *dir = fault_create_debugfs_attr("fail_make_request",
						NULL, &fail_make_request);

1854
	return PTR_ERR_OR_ZERO(dir);
1855 1856 1857 1858 1859 1860
}

late_initcall(fail_make_request_debugfs);

#else /* CONFIG_FAIL_MAKE_REQUEST */

1861 1862
static inline bool should_fail_request(struct hd_struct *part,
					unsigned int bytes)
1863
{
1864
	return false;
1865 1866 1867 1868
}

#endif /* CONFIG_FAIL_MAKE_REQUEST */

J
Jens Axboe 已提交
1869 1870 1871 1872 1873 1874 1875 1876 1877 1878 1879
/*
 * 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. */
1880
	maxsector = i_size_read(bio->bi_bdev->bd_inode) >> 9;
J
Jens Axboe 已提交
1881
	if (maxsector) {
1882
		sector_t sector = bio->bi_iter.bi_sector;
J
Jens Axboe 已提交
1883 1884 1885 1886 1887 1888 1889 1890 1891 1892 1893 1894 1895 1896 1897

		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;
}

1898 1899
static noinline_for_stack bool
generic_make_request_checks(struct bio *bio)
L
Linus Torvalds 已提交
1900
{
1901
	struct request_queue *q;
1902
	int nr_sectors = bio_sectors(bio);
1903
	int err = -EIO;
1904 1905
	char b[BDEVNAME_SIZE];
	struct hd_struct *part;
L
Linus Torvalds 已提交
1906 1907 1908

	might_sleep();

J
Jens Axboe 已提交
1909 1910
	if (bio_check_eod(bio, nr_sectors))
		goto end_io;
L
Linus Torvalds 已提交
1911

1912 1913 1914 1915 1916 1917
	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),
1918
			(long long) bio->bi_iter.bi_sector);
1919 1920
		goto end_io;
	}
1921

1922
	part = bio->bi_bdev->bd_part;
1923
	if (should_fail_request(part, bio->bi_iter.bi_size) ||
1924
	    should_fail_request(&part_to_disk(part)->part0,
1925
				bio->bi_iter.bi_size))
1926
		goto end_io;
1927

1928 1929 1930 1931 1932
	/*
	 * If this device has partitions, remap block n
	 * of partition p to block n+start(p) of the disk.
	 */
	blk_partition_remap(bio);
1933

1934 1935
	if (bio_check_eod(bio, nr_sectors))
		goto end_io;
1936

1937 1938 1939 1940 1941 1942 1943 1944 1945
	/*
	 * 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;
1946 1947
			goto end_io;
		}
1948
	}
1949

1950 1951
	if ((bio->bi_rw & REQ_DISCARD) &&
	    (!blk_queue_discard(q) ||
1952
	     ((bio->bi_rw & REQ_SECURE) && !blk_queue_secdiscard(q)))) {
1953 1954 1955
		err = -EOPNOTSUPP;
		goto end_io;
	}
1956

1957
	if (bio->bi_rw & REQ_WRITE_SAME && !bdev_write_same(bio->bi_bdev)) {
1958 1959 1960
		err = -EOPNOTSUPP;
		goto end_io;
	}
1961

T
Tejun Heo 已提交
1962 1963 1964 1965 1966 1967 1968 1969
	/*
	 * 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);

1970 1971
	if (!blkcg_bio_issue_check(q, bio))
		return false;
1972

1973
	trace_block_bio_queue(q, bio);
1974
	return true;
1975 1976

end_io:
1977 1978
	bio->bi_error = err;
	bio_endio(bio);
1979
	return false;
L
Linus Torvalds 已提交
1980 1981
}

1982 1983 1984 1985 1986 1987 1988 1989 1990 1991 1992 1993 1994 1995 1996 1997 1998 1999 2000 2001 2002 2003 2004
/**
 * 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.
2005
 */
2006
blk_qc_t generic_make_request(struct bio *bio)
2007
{
2008
	struct bio_list bio_list_on_stack;
2009
	blk_qc_t ret = BLK_QC_T_NONE;
2010

2011
	if (!generic_make_request_checks(bio))
2012
		goto out;
2013 2014 2015 2016 2017 2018 2019 2020 2021 2022 2023

	/*
	 * 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
	 */
2024 2025
	if (current->bio_list) {
		bio_list_add(current->bio_list, bio);
2026
		goto out;
2027
	}
2028

2029 2030 2031 2032 2033
	/* 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
2034 2035
	 * we assign bio_list to a pointer to the bio_list_on_stack,
	 * thus initialising the bio_list of new bios to be
2036
	 * added.  ->make_request() may indeed add some more bios
2037 2038 2039
	 * 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
2040
	 * of the top of the list (no pretending) and so remove it from
2041
	 * bio_list, and call into ->make_request() again.
2042 2043
	 */
	BUG_ON(bio->bi_next);
2044 2045
	bio_list_init(&bio_list_on_stack);
	current->bio_list = &bio_list_on_stack;
2046
	do {
2047 2048
		struct request_queue *q = bdev_get_queue(bio->bi_bdev);

2049
		if (likely(blk_queue_enter(q, false) == 0)) {
2050
			ret = q->make_request_fn(q, bio);
2051 2052

			blk_queue_exit(q);
2053

2054 2055 2056 2057 2058 2059 2060
			bio = bio_list_pop(current->bio_list);
		} else {
			struct bio *bio_next = bio_list_pop(current->bio_list);

			bio_io_error(bio);
			bio = bio_next;
		}
2061
	} while (bio);
2062
	current->bio_list = NULL; /* deactivate */
2063 2064 2065

out:
	return ret;
2066
}
L
Linus Torvalds 已提交
2067 2068 2069
EXPORT_SYMBOL(generic_make_request);

/**
2070
 * submit_bio - submit a bio to the block device layer for I/O
L
Linus Torvalds 已提交
2071 2072 2073 2074 2075
 * @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
2076
 * interfaces; @bio must be presetup and ready for I/O.
L
Linus Torvalds 已提交
2077 2078
 *
 */
2079
blk_qc_t submit_bio(int rw, struct bio *bio)
L
Linus Torvalds 已提交
2080
{
2081
	bio->bi_rw |= rw;
L
Linus Torvalds 已提交
2082

2083 2084 2085 2086
	/*
	 * If it's a regular read/write or a barrier with data attached,
	 * go through the normal accounting stuff before submission.
	 */
2087
	if (bio_has_data(bio)) {
2088 2089 2090 2091 2092 2093 2094
		unsigned int count;

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

2095 2096 2097
		if (rw & WRITE) {
			count_vm_events(PGPGOUT, count);
		} else {
2098
			task_io_account_read(bio->bi_iter.bi_size);
2099 2100 2101 2102 2103
			count_vm_events(PGPGIN, count);
		}

		if (unlikely(block_dump)) {
			char b[BDEVNAME_SIZE];
2104
			printk(KERN_DEBUG "%s(%d): %s block %Lu on %s (%u sectors)\n",
2105
			current->comm, task_pid_nr(current),
2106
				(rw & WRITE) ? "WRITE" : "READ",
2107
				(unsigned long long)bio->bi_iter.bi_sector,
2108 2109
				bdevname(bio->bi_bdev, b),
				count);
2110
		}
L
Linus Torvalds 已提交
2111 2112
	}

2113
	return generic_make_request(bio);
L
Linus Torvalds 已提交
2114 2115 2116
}
EXPORT_SYMBOL(submit_bio);

2117 2118 2119 2120 2121 2122 2123 2124 2125 2126 2127 2128 2129
/**
 * 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
2130
 *    in some cases below, so export this function.
2131 2132
 *    Request stacking drivers like request-based dm may change the queue
 *    limits while requests are in the queue (e.g. dm's table swapping).
2133
 *    Such request stacking drivers should check those requests against
2134 2135 2136 2137 2138 2139
 *    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)
{
2140
	if (!rq_mergeable(rq))
2141 2142
		return 0;

2143
	if (blk_rq_sectors(rq) > blk_queue_get_max_sectors(q, rq->cmd_flags)) {
2144 2145 2146 2147 2148 2149 2150 2151 2152 2153 2154
		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);
2155
	if (rq->nr_phys_segments > queue_max_segments(q)) {
2156 2157 2158 2159 2160 2161 2162 2163 2164 2165 2166 2167 2168 2169 2170 2171
		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;
2172
	int where = ELEVATOR_INSERT_BACK;
2173 2174 2175 2176

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

2177 2178
	if (rq->rq_disk &&
	    should_fail_request(&rq->rq_disk->part0, blk_rq_bytes(rq)))
2179 2180
		return -EIO;

2181 2182 2183 2184 2185 2186 2187
	if (q->mq_ops) {
		if (blk_queue_io_stat(q))
			blk_account_io_start(rq, true);
		blk_mq_insert_request(rq, false, true, true);
		return 0;
	}

2188
	spin_lock_irqsave(q->queue_lock, flags);
B
Bart Van Assche 已提交
2189
	if (unlikely(blk_queue_dying(q))) {
2190 2191 2192
		spin_unlock_irqrestore(q->queue_lock, flags);
		return -ENODEV;
	}
2193 2194 2195 2196 2197 2198 2199

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

2200 2201 2202 2203
	if (rq->cmd_flags & (REQ_FLUSH|REQ_FUA))
		where = ELEVATOR_INSERT_FLUSH;

	add_acct_request(q, rq, where);
J
Jeff Moyer 已提交
2204 2205
	if (where == ELEVATOR_INSERT_FLUSH)
		__blk_run_queue(q);
2206 2207 2208 2209 2210 2211
	spin_unlock_irqrestore(q->queue_lock, flags);

	return 0;
}
EXPORT_SYMBOL_GPL(blk_insert_cloned_request);

2212 2213 2214 2215 2216 2217 2218 2219 2220 2221 2222 2223 2224 2225 2226 2227 2228 2229 2230 2231 2232 2233 2234 2235 2236 2237 2238 2239 2240 2241 2242 2243 2244 2245 2246
/**
 * 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;
2247
		bytes += bio->bi_iter.bi_size;
2248 2249 2250 2251 2252 2253 2254 2255
	}

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

2256
void blk_account_io_completion(struct request *req, unsigned int bytes)
2257
{
2258
	if (blk_do_io_stat(req)) {
2259 2260 2261 2262 2263
		const int rw = rq_data_dir(req);
		struct hd_struct *part;
		int cpu;

		cpu = part_stat_lock();
2264
		part = req->part;
2265 2266 2267 2268 2269
		part_stat_add(cpu, part, sectors[rw], bytes >> 9);
		part_stat_unlock();
	}
}

2270
void blk_account_io_done(struct request *req)
2271 2272
{
	/*
2273 2274 2275
	 * Account IO completion.  flush_rq isn't accounted as a
	 * normal IO on queueing nor completion.  Accounting the
	 * containing request is enough.
2276
	 */
T
Tejun Heo 已提交
2277
	if (blk_do_io_stat(req) && !(req->cmd_flags & REQ_FLUSH_SEQ)) {
2278 2279 2280 2281 2282 2283
		unsigned long duration = jiffies - req->start_time;
		const int rw = rq_data_dir(req);
		struct hd_struct *part;
		int cpu;

		cpu = part_stat_lock();
2284
		part = req->part;
2285 2286 2287 2288

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

2291
		hd_struct_put(part);
2292 2293 2294 2295
		part_stat_unlock();
	}
}

2296
#ifdef CONFIG_PM
L
Lin Ming 已提交
2297 2298 2299 2300 2301 2302 2303 2304 2305 2306 2307 2308 2309 2310 2311 2312 2313 2314 2315 2316 2317
/*
 * 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

2318 2319 2320 2321 2322 2323 2324 2325 2326 2327 2328 2329 2330 2331 2332 2333 2334 2335 2336 2337 2338 2339 2340 2341 2342 2343 2344 2345 2346 2347 2348 2349 2350 2351 2352 2353
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();
}

2354
/**
2355 2356 2357 2358 2359 2360 2361 2362 2363 2364 2365 2366 2367 2368 2369 2370
 * 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)
2371 2372 2373 2374 2375
{
	struct request *rq;
	int ret;

	while ((rq = __elv_next_request(q)) != NULL) {
L
Lin Ming 已提交
2376 2377 2378 2379 2380

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

2381 2382 2383 2384 2385 2386
		if (!(rq->cmd_flags & REQ_STARTED)) {
			/*
			 * This is the first time the device driver
			 * sees this request (possibly after
			 * requeueing).  Notify IO scheduler.
			 */
2387
			if (rq->cmd_flags & REQ_SORTED)
2388 2389 2390 2391 2392 2393 2394 2395 2396 2397 2398 2399 2400 2401 2402 2403 2404 2405 2406
				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;

2407
		if (q->dma_drain_size && blk_rq_bytes(rq)) {
2408 2409 2410 2411 2412 2413 2414 2415 2416 2417 2418 2419 2420 2421 2422 2423 2424 2425 2426 2427 2428 2429
			/*
			 * 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.
			 */
2430
			if (q->dma_drain_size && blk_rq_bytes(rq) &&
2431 2432 2433 2434 2435 2436 2437 2438 2439 2440 2441 2442
			    !(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;
2443 2444 2445 2446 2447
			/*
			 * Mark this request as started so we don't trigger
			 * any debug logic in the end I/O path.
			 */
			blk_start_request(rq);
2448
			__blk_end_request_all(rq, -EIO);
2449 2450 2451 2452 2453 2454 2455 2456
		} else {
			printk(KERN_ERR "%s: bad return=%d\n", __func__, ret);
			break;
		}
	}

	return rq;
}
2457
EXPORT_SYMBOL(blk_peek_request);
2458

2459
void blk_dequeue_request(struct request *rq)
2460
{
2461 2462
	struct request_queue *q = rq->q;

2463 2464 2465 2466 2467 2468 2469 2470 2471 2472
	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.
	 */
2473
	if (blk_account_rq(rq)) {
2474
		q->in_flight[rq_is_sync(rq)]++;
2475 2476
		set_io_start_time_ns(rq);
	}
2477 2478
}

2479 2480 2481 2482 2483 2484 2485 2486 2487 2488 2489 2490 2491 2492 2493 2494 2495 2496 2497
/**
 * 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);

	/*
2498 2499
	 * We are now handing the request to the hardware, initialize
	 * resid_len to full count and add the timeout handler.
2500
	 */
2501
	req->resid_len = blk_rq_bytes(req);
2502 2503 2504
	if (unlikely(blk_bidi_rq(req)))
		req->next_rq->resid_len = blk_rq_bytes(req->next_rq);

2505
	BUG_ON(test_bit(REQ_ATOM_COMPLETE, &req->atomic_flags));
2506 2507 2508 2509 2510 2511 2512 2513 2514 2515 2516 2517 2518 2519 2520 2521 2522 2523 2524 2525 2526 2527 2528 2529 2530 2531 2532 2533 2534 2535
	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);

2536
/**
2537
 * blk_update_request - Special helper function for request stacking drivers
2538
 * @req:      the request being processed
2539
 * @error:    %0 for success, < %0 for error
2540
 * @nr_bytes: number of bytes to complete @req
2541 2542
 *
 * Description:
2543 2544 2545
 *     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.
2546 2547 2548 2549 2550 2551 2552
 *
 *     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.
2553 2554
 *
 * Return:
2555 2556
 *     %false - this request doesn't have any more data
 *     %true  - this request has more data
2557
 **/
2558
bool blk_update_request(struct request *req, int error, unsigned int nr_bytes)
L
Linus Torvalds 已提交
2559
{
2560
	int total_bytes;
L
Linus Torvalds 已提交
2561

2562 2563
	trace_block_rq_complete(req->q, req, nr_bytes);

2564 2565 2566
	if (!req->bio)
		return false;

L
Linus Torvalds 已提交
2567
	/*
2568 2569 2570 2571 2572 2573
	 * 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 已提交
2574
	 */
2575
	if (req->cmd_type == REQ_TYPE_FS)
L
Linus Torvalds 已提交
2576 2577
		req->errors = 0;

2578 2579
	if (error && req->cmd_type == REQ_TYPE_FS &&
	    !(req->cmd_flags & REQ_QUIET)) {
2580 2581 2582 2583 2584 2585 2586 2587 2588 2589 2590 2591
		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;
2592 2593 2594
		case -ETIMEDOUT:
			error_type = "timeout";
			break;
2595 2596 2597
		case -ENOSPC:
			error_type = "critical space allocation";
			break;
2598 2599 2600
		case -ENODATA:
			error_type = "critical medium";
			break;
2601 2602 2603 2604 2605
		case -EIO:
		default:
			error_type = "I/O";
			break;
		}
2606 2607
		printk_ratelimited(KERN_ERR "%s: %s error, dev %s, sector %llu\n",
				   __func__, error_type, req->rq_disk ?
2608 2609 2610
				   req->rq_disk->disk_name : "?",
				   (unsigned long long)blk_rq_pos(req));

L
Linus Torvalds 已提交
2611 2612
	}

2613
	blk_account_io_completion(req, nr_bytes);
2614

2615 2616 2617
	total_bytes = 0;
	while (req->bio) {
		struct bio *bio = req->bio;
2618
		unsigned bio_bytes = min(bio->bi_iter.bi_size, nr_bytes);
L
Linus Torvalds 已提交
2619

2620
		if (bio_bytes == bio->bi_iter.bi_size)
L
Linus Torvalds 已提交
2621 2622
			req->bio = bio->bi_next;

2623
		req_bio_endio(req, bio, bio_bytes, error);
L
Linus Torvalds 已提交
2624

2625 2626
		total_bytes += bio_bytes;
		nr_bytes -= bio_bytes;
L
Linus Torvalds 已提交
2627

2628 2629
		if (!nr_bytes)
			break;
L
Linus Torvalds 已提交
2630 2631 2632 2633 2634
	}

	/*
	 * completely done
	 */
2635 2636 2637 2638 2639 2640
	if (!req->bio) {
		/*
		 * Reset counters so that the request stacking driver
		 * can find how many bytes remain in the request
		 * later.
		 */
2641
		req->__data_len = 0;
2642 2643
		return false;
	}
L
Linus Torvalds 已提交
2644

2645
	req->__data_len -= total_bytes;
2646 2647

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

2651 2652 2653 2654 2655 2656
	/* 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;
	}

2657 2658 2659 2660 2661
	/*
	 * 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)) {
2662
		blk_dump_rq_flags(req, "request botched");
2663
		req->__data_len = blk_rq_cur_bytes(req);
2664 2665 2666
	}

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

2669
	return true;
L
Linus Torvalds 已提交
2670
}
2671
EXPORT_SYMBOL_GPL(blk_update_request);
L
Linus Torvalds 已提交
2672

2673 2674 2675
static bool blk_update_bidi_request(struct request *rq, int error,
				    unsigned int nr_bytes,
				    unsigned int bidi_bytes)
2676
{
2677 2678
	if (blk_update_request(rq, error, nr_bytes))
		return true;
2679

2680 2681 2682 2683
	/* 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;
2684

2685 2686
	if (blk_queue_add_random(rq->q))
		add_disk_randomness(rq->rq_disk);
2687 2688

	return false;
L
Linus Torvalds 已提交
2689 2690
}

2691 2692 2693 2694 2695 2696 2697 2698 2699 2700 2701 2702 2703 2704 2705 2706 2707 2708 2709 2710
/**
 * 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 已提交
2711 2712 2713
/*
 * queue lock must be held
 */
2714
void blk_finish_request(struct request *req, int error)
L
Linus Torvalds 已提交
2715
{
2716
	if (req->cmd_flags & REQ_QUEUED)
2717 2718
		blk_queue_end_tag(req->q, req);

2719
	BUG_ON(blk_queued_rq(req));
L
Linus Torvalds 已提交
2720

2721
	if (unlikely(laptop_mode) && req->cmd_type == REQ_TYPE_FS)
2722
		laptop_io_completion(&req->q->backing_dev_info);
L
Linus Torvalds 已提交
2723

2724 2725
	blk_delete_timer(req);

2726 2727 2728
	if (req->cmd_flags & REQ_DONTPREP)
		blk_unprep_request(req);

2729
	blk_account_io_done(req);
2730

L
Linus Torvalds 已提交
2731
	if (req->end_io)
2732
		req->end_io(req, error);
2733 2734 2735 2736
	else {
		if (blk_bidi_rq(req))
			__blk_put_request(req->next_rq->q, req->next_rq);

L
Linus Torvalds 已提交
2737
		__blk_put_request(req->q, req);
2738
	}
L
Linus Torvalds 已提交
2739
}
2740
EXPORT_SYMBOL(blk_finish_request);
L
Linus Torvalds 已提交
2741

2742
/**
2743 2744 2745 2746 2747
 * 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
2748 2749
 *
 * Description:
2750
 *     Ends I/O on a number of bytes attached to @rq and @rq->next_rq.
2751 2752 2753
 *     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.
2754 2755
 *
 * Return:
2756 2757
 *     %false - we are done with this request
 *     %true  - still buffers pending for this request
2758
 **/
2759
static bool blk_end_bidi_request(struct request *rq, int error,
K
Kiyoshi Ueda 已提交
2760 2761
				 unsigned int nr_bytes, unsigned int bidi_bytes)
{
2762
	struct request_queue *q = rq->q;
2763
	unsigned long flags;
K
Kiyoshi Ueda 已提交
2764

2765 2766
	if (blk_update_bidi_request(rq, error, nr_bytes, bidi_bytes))
		return true;
K
Kiyoshi Ueda 已提交
2767

2768
	spin_lock_irqsave(q->queue_lock, flags);
2769
	blk_finish_request(rq, error);
2770 2771
	spin_unlock_irqrestore(q->queue_lock, flags);

2772
	return false;
K
Kiyoshi Ueda 已提交
2773 2774
}

2775
/**
2776 2777
 * __blk_end_bidi_request - Complete a bidi request with queue lock held
 * @rq:         the request to complete
2778
 * @error:      %0 for success, < %0 for error
2779 2780
 * @nr_bytes:   number of bytes to complete @rq
 * @bidi_bytes: number of bytes to complete @rq->next_rq
2781 2782
 *
 * Description:
2783 2784
 *     Identical to blk_end_bidi_request() except that queue lock is
 *     assumed to be locked on entry and remains so on return.
2785 2786
 *
 * Return:
2787 2788
 *     %false - we are done with this request
 *     %true  - still buffers pending for this request
2789
 **/
2790
bool __blk_end_bidi_request(struct request *rq, int error,
2791
				   unsigned int nr_bytes, unsigned int bidi_bytes)
2792
{
2793 2794
	if (blk_update_bidi_request(rq, error, nr_bytes, bidi_bytes))
		return true;
2795

2796
	blk_finish_request(rq, error);
2797

2798
	return false;
2799
}
2800 2801 2802 2803

/**
 * blk_end_request - Helper function for drivers to complete the request.
 * @rq:       the request being processed
2804
 * @error:    %0 for success, < %0 for error
2805 2806 2807 2808 2809 2810 2811
 * @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:
2812 2813
 *     %false - we are done with this request
 *     %true  - still buffers pending for this request
2814
 **/
2815
bool blk_end_request(struct request *rq, int error, unsigned int nr_bytes)
2816
{
2817
	return blk_end_bidi_request(rq, error, nr_bytes, 0);
2818
}
2819
EXPORT_SYMBOL(blk_end_request);
2820 2821

/**
2822 2823
 * blk_end_request_all - Helper function for drives to finish the request.
 * @rq: the request to finish
2824
 * @error: %0 for success, < %0 for error
2825 2826
 *
 * Description:
2827 2828 2829
 *     Completely finish @rq.
 */
void blk_end_request_all(struct request *rq, int error)
2830
{
2831 2832
	bool pending;
	unsigned int bidi_bytes = 0;
2833

2834 2835
	if (unlikely(blk_bidi_rq(rq)))
		bidi_bytes = blk_rq_bytes(rq->next_rq);
2836

2837 2838 2839
	pending = blk_end_bidi_request(rq, error, blk_rq_bytes(rq), bidi_bytes);
	BUG_ON(pending);
}
2840
EXPORT_SYMBOL(blk_end_request_all);
2841

2842 2843 2844
/**
 * blk_end_request_cur - Helper function to finish the current request chunk.
 * @rq: the request to finish the current chunk for
2845
 * @error: %0 for success, < %0 for error
2846 2847 2848 2849 2850 2851 2852 2853 2854 2855 2856
 *
 * 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));
2857
}
2858
EXPORT_SYMBOL(blk_end_request_cur);
2859

2860 2861 2862 2863 2864 2865 2866 2867 2868 2869 2870 2871 2872 2873 2874 2875 2876 2877 2878
/**
 * 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);

2879
/**
2880 2881 2882 2883
 * __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
2884 2885
 *
 * Description:
2886
 *     Must be called with queue lock held unlike blk_end_request().
2887 2888
 *
 * Return:
2889 2890
 *     %false - we are done with this request
 *     %true  - still buffers pending for this request
2891
 **/
2892
bool __blk_end_request(struct request *rq, int error, unsigned int nr_bytes)
2893
{
2894
	return __blk_end_bidi_request(rq, error, nr_bytes, 0);
2895
}
2896
EXPORT_SYMBOL(__blk_end_request);
2897

K
Kiyoshi Ueda 已提交
2898
/**
2899 2900
 * __blk_end_request_all - Helper function for drives to finish the request.
 * @rq: the request to finish
2901
 * @error: %0 for success, < %0 for error
K
Kiyoshi Ueda 已提交
2902 2903
 *
 * Description:
2904
 *     Completely finish @rq.  Must be called with queue lock held.
K
Kiyoshi Ueda 已提交
2905
 */
2906
void __blk_end_request_all(struct request *rq, int error)
K
Kiyoshi Ueda 已提交
2907
{
2908 2909 2910 2911 2912 2913 2914 2915
	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 已提交
2916
}
2917
EXPORT_SYMBOL(__blk_end_request_all);
K
Kiyoshi Ueda 已提交
2918

2919
/**
2920 2921
 * __blk_end_request_cur - Helper function to finish the current request chunk.
 * @rq: the request to finish the current chunk for
2922
 * @error: %0 for success, < %0 for error
2923 2924
 *
 * Description:
2925 2926
 *     Complete the current consecutively mapped chunk from @rq.  Must
 *     be called with queue lock held.
2927 2928
 *
 * Return:
2929 2930 2931 2932
 *     %false - we are done with this request
 *     %true  - still buffers pending for this request
 */
bool __blk_end_request_cur(struct request *rq, int error)
2933
{
2934
	return __blk_end_request(rq, error, blk_rq_cur_bytes(rq));
2935
}
2936
EXPORT_SYMBOL(__blk_end_request_cur);
2937

2938 2939 2940 2941 2942 2943 2944 2945 2946 2947 2948 2949 2950 2951 2952 2953 2954 2955 2956 2957
/**
 * __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 已提交
2958 2959
void blk_rq_bio_prep(struct request_queue *q, struct request *rq,
		     struct bio *bio)
L
Linus Torvalds 已提交
2960
{
2961
	/* Bit 0 (R/W) is identical in rq->cmd_flags and bio->bi_rw */
2962
	rq->cmd_flags |= bio->bi_rw & REQ_WRITE;
L
Linus Torvalds 已提交
2963

2964
	if (bio_has_data(bio))
D
David Woodhouse 已提交
2965
		rq->nr_phys_segments = bio_phys_segments(q, bio);
2966

2967
	rq->__data_len = bio->bi_iter.bi_size;
L
Linus Torvalds 已提交
2968 2969
	rq->bio = rq->biotail = bio;

N
NeilBrown 已提交
2970 2971 2972
	if (bio->bi_bdev)
		rq->rq_disk = bio->bi_bdev->bd_disk;
}
L
Linus Torvalds 已提交
2973

2974 2975 2976 2977 2978 2979 2980 2981 2982 2983 2984
#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;
2985
	struct bio_vec bvec;
2986 2987

	rq_for_each_segment(bvec, rq, iter)
2988
		flush_dcache_page(bvec.bv_page);
2989 2990 2991 2992
}
EXPORT_SYMBOL_GPL(rq_flush_dcache_pages);
#endif

2993 2994 2995 2996 2997 2998 2999 3000 3001 3002 3003 3004 3005 3006 3007 3008 3009 3010 3011 3012 3013 3014 3015 3016 3017 3018 3019 3020
/**
 * 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);

3021 3022 3023 3024 3025 3026 3027 3028 3029 3030 3031 3032 3033 3034 3035 3036 3037 3038 3039 3040 3041 3042 3043 3044
/**
 * blk_rq_unprep_clone - Helper function to free all bios in a cloned request
 * @rq: the clone request to be cleaned up
 *
 * Description:
 *     Free all bios in @rq for a cloned request.
 */
void blk_rq_unprep_clone(struct request *rq)
{
	struct bio *bio;

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

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

/*
 * Copy attributes of the original request to the clone request.
 * The actual data parts (e.g. ->cmd, ->sense) are not copied.
 */
static void __blk_rq_prep_clone(struct request *dst, struct request *src)
3045 3046
{
	dst->cpu = src->cpu;
3047
	dst->cmd_flags |= (src->cmd_flags & REQ_CLONE_MASK) | REQ_NOMERGE;
3048 3049 3050 3051 3052 3053
	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;
3054 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 3084 3085 3086 3087 3088 3089 3090 3091 3092 3093 3094 3095 3096 3097 3098 3099 3100 3101 3102 3103 3104 3105 3106 3107 3108 3109
}

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

	if (!bs)
		bs = fs_bio_set;

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

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

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

	__blk_rq_prep_clone(rq, rq_src);

	return 0;

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

	return -ENOMEM;
3110 3111 3112
}
EXPORT_SYMBOL_GPL(blk_rq_prep_clone);

3113
int kblockd_schedule_work(struct work_struct *work)
L
Linus Torvalds 已提交
3114 3115 3116 3117 3118
{
	return queue_work(kblockd_workqueue, work);
}
EXPORT_SYMBOL(kblockd_schedule_work);

3119 3120
int kblockd_schedule_delayed_work(struct delayed_work *dwork,
				  unsigned long delay)
3121 3122 3123 3124 3125
{
	return queue_delayed_work(kblockd_workqueue, dwork, delay);
}
EXPORT_SYMBOL(kblockd_schedule_delayed_work);

3126 3127 3128 3129 3130 3131 3132
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 已提交
3133 3134 3135 3136 3137 3138 3139 3140 3141 3142 3143 3144 3145 3146
/**
 * 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.
 */
3147 3148 3149 3150
void blk_start_plug(struct blk_plug *plug)
{
	struct task_struct *tsk = current;

S
Shaohua Li 已提交
3151 3152 3153 3154 3155 3156
	/*
	 * If this is a nested plug, don't actually assign it.
	 */
	if (tsk->plug)
		return;

3157
	INIT_LIST_HEAD(&plug->list);
3158
	INIT_LIST_HEAD(&plug->mq_list);
3159
	INIT_LIST_HEAD(&plug->cb_list);
3160
	/*
S
Shaohua Li 已提交
3161 3162
	 * Store ordering should not be needed here, since a potential
	 * preempt will imply a full memory barrier
3163
	 */
S
Shaohua Li 已提交
3164
	tsk->plug = plug;
3165 3166 3167 3168 3169 3170 3171 3172
}
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);

3173 3174
	return !(rqa->q < rqb->q ||
		(rqa->q == rqb->q && blk_rq_pos(rqa) < blk_rq_pos(rqb)));
3175 3176
}

3177 3178 3179 3180 3181 3182
/*
 * 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.
 */
3183
static void queue_unplugged(struct request_queue *q, unsigned int depth,
3184
			    bool from_schedule)
3185
	__releases(q->queue_lock)
3186
{
3187
	trace_block_unplug(q, depth, !from_schedule);
3188

3189
	if (from_schedule)
3190
		blk_run_queue_async(q);
3191
	else
3192
		__blk_run_queue(q);
3193
	spin_unlock(q->queue_lock);
3194 3195
}

3196
static void flush_plug_callbacks(struct blk_plug *plug, bool from_schedule)
3197 3198 3199
{
	LIST_HEAD(callbacks);

S
Shaohua Li 已提交
3200 3201
	while (!list_empty(&plug->cb_list)) {
		list_splice_init(&plug->cb_list, &callbacks);
3202

S
Shaohua Li 已提交
3203 3204
		while (!list_empty(&callbacks)) {
			struct blk_plug_cb *cb = list_first_entry(&callbacks,
3205 3206
							  struct blk_plug_cb,
							  list);
S
Shaohua Li 已提交
3207
			list_del(&cb->list);
3208
			cb->callback(cb, from_schedule);
S
Shaohua Li 已提交
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
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);

3238
void blk_flush_plug_list(struct blk_plug *plug, bool from_schedule)
3239 3240 3241 3242
{
	struct request_queue *q;
	unsigned long flags;
	struct request *rq;
3243
	LIST_HEAD(list);
3244
	unsigned int depth;
3245

3246
	flush_plug_callbacks(plug, from_schedule);
3247 3248 3249 3250

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

3251 3252 3253
	if (list_empty(&plug->list))
		return;

3254 3255
	list_splice_init(&plug->list, &list);

3256
	list_sort(NULL, &list, plug_rq_cmp);
3257 3258

	q = NULL;
3259
	depth = 0;
3260 3261 3262 3263 3264

	/*
	 * Save and disable interrupts here, to avoid doing it for every
	 * queue lock we have to take.
	 */
3265
	local_irq_save(flags);
3266 3267
	while (!list_empty(&list)) {
		rq = list_entry_rq(list.next);
3268 3269 3270
		list_del_init(&rq->queuelist);
		BUG_ON(!rq->q);
		if (rq->q != q) {
3271 3272 3273 3274
			/*
			 * This drops the queue lock
			 */
			if (q)
3275
				queue_unplugged(q, depth, from_schedule);
3276
			q = rq->q;
3277
			depth = 0;
3278 3279
			spin_lock(q->queue_lock);
		}
3280 3281 3282 3283

		/*
		 * Short-circuit if @q is dead
		 */
B
Bart Van Assche 已提交
3284
		if (unlikely(blk_queue_dying(q))) {
3285 3286 3287 3288
			__blk_end_request_all(rq, -ENODEV);
			continue;
		}

3289 3290 3291
		/*
		 * rq is already accounted, so use raw insert
		 */
3292 3293 3294 3295
		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);
3296 3297

		depth++;
3298 3299
	}

3300 3301 3302 3303
	/*
	 * This drops the queue lock
	 */
	if (q)
3304
		queue_unplugged(q, depth, from_schedule);
3305 3306 3307 3308 3309 3310

	local_irq_restore(flags);
}

void blk_finish_plug(struct blk_plug *plug)
{
S
Shaohua Li 已提交
3311 3312
	if (plug != current->plug)
		return;
3313
	blk_flush_plug_list(plug, false);
3314

S
Shaohua Li 已提交
3315
	current->plug = NULL;
3316
}
3317
EXPORT_SYMBOL(blk_finish_plug);
3318

J
Jens Axboe 已提交
3319 3320 3321 3322 3323 3324 3325 3326 3327 3328 3329 3330 3331 3332 3333 3334 3335 3336 3337 3338 3339 3340 3341 3342 3343 3344 3345 3346 3347 3348 3349 3350 3351 3352 3353 3354 3355 3356 3357 3358 3359
bool blk_poll(struct request_queue *q, blk_qc_t cookie)
{
	struct blk_plug *plug;
	long state;

	if (!q->mq_ops || !q->mq_ops->poll || !blk_qc_t_valid(cookie) ||
	    !test_bit(QUEUE_FLAG_POLL, &q->queue_flags))
		return false;

	plug = current->plug;
	if (plug)
		blk_flush_plug_list(plug, false);

	state = current->state;
	while (!need_resched()) {
		unsigned int queue_num = blk_qc_t_to_queue_num(cookie);
		struct blk_mq_hw_ctx *hctx = q->queue_hw_ctx[queue_num];
		int ret;

		hctx->poll_invoked++;

		ret = q->mq_ops->poll(hctx, blk_qc_t_to_tag(cookie));
		if (ret > 0) {
			hctx->poll_success++;
			set_current_state(TASK_RUNNING);
			return true;
		}

		if (signal_pending_state(state, current))
			set_current_state(TASK_RUNNING);

		if (current->state == TASK_RUNNING)
			return true;
		if (ret < 0)
			break;
		cpu_relax();
	}

	return false;
}

3360
#ifdef CONFIG_PM
L
Lin Ming 已提交
3361 3362 3363 3364 3365 3366 3367 3368 3369 3370 3371 3372 3373 3374 3375 3376 3377 3378 3379 3380 3381 3382 3383 3384 3385 3386 3387 3388 3389 3390 3391 3392 3393 3394 3395 3396 3397 3398 3399 3400 3401 3402 3403 3404 3405 3406 3407 3408 3409 3410 3411 3412 3413 3414 3415 3416 3417 3418 3419 3420 3421 3422 3423 3424 3425 3426 3427 3428 3429 3430 3431 3432 3433 3434 3435 3436 3437 3438 3439 3440 3441 3442 3443 3444 3445 3446 3447 3448 3449 3450 3451 3452 3453 3454 3455 3456 3457 3458 3459 3460 3461 3462 3463 3464 3465 3466 3467 3468 3469 3470 3471 3472 3473 3474 3475 3476 3477 3478 3479 3480 3481 3482 3483 3484 3485 3486 3487 3488 3489 3490 3491 3492 3493
/**
 * 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);
3494
		pm_request_autosuspend(q->dev);
L
Lin Ming 已提交
3495 3496 3497 3498 3499 3500 3501 3502
	} else {
		q->rpm_status = RPM_SUSPENDED;
	}
	spin_unlock_irq(q->queue_lock);
}
EXPORT_SYMBOL(blk_post_runtime_resume);
#endif

L
Linus Torvalds 已提交
3503 3504
int __init blk_dev_init(void)
{
3505
	BUILD_BUG_ON(__REQ_NR_BITS > 8 *
3506
			FIELD_SIZEOF(struct request, cmd_flags));
3507

3508 3509
	/* used for unplugging and affects IO latency/throughput - HIGHPRI */
	kblockd_workqueue = alloc_workqueue("kblockd",
3510
					    WQ_MEM_RECLAIM | WQ_HIGHPRI, 0);
L
Linus Torvalds 已提交
3511 3512 3513 3514
	if (!kblockd_workqueue)
		panic("Failed to create kblockd\n");

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

3517
	blk_requestq_cachep = kmem_cache_create("request_queue",
3518
			sizeof(struct request_queue), 0, SLAB_PANIC, NULL);
L
Linus Torvalds 已提交
3519

3520
	return 0;
L
Linus Torvalds 已提交
3521
}