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

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

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

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

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

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

56 57
DEFINE_IDA(blk_queue_ida);

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

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

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

73 74 75 76 77
static void blk_clear_congested(struct request_list *rl, int sync)
{
#ifdef CONFIG_CGROUP_WRITEBACK
	clear_wb_congested(rl->blkg->wb_congested, sync);
#else
78 79 80 81 82
	/*
	 * 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)
83
		clear_wb_congested(rl->q->backing_dev_info->wb.congested, sync);
84 85 86 87 88 89 90 91
#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
92 93
	/* see blk_clear_congested() */
	if (rl == &rl->q->root_rl)
94
		set_wb_congested(rl->q->backing_dev_info->wb.congested, sync);
95 96 97
#endif
}

98
void blk_queue_congestion_threshold(struct request_queue *q)
L
Linus Torvalds 已提交
99 100 101 102 103 104 105 106 107 108 109 110 111 112
{
	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;
}

113
void blk_rq_init(struct request_queue *q, struct request *rq)
L
Linus Torvalds 已提交
114
{
115 116
	memset(rq, 0, sizeof(*rq));

L
Linus Torvalds 已提交
117
	INIT_LIST_HEAD(&rq->queuelist);
J
Jens Axboe 已提交
118
	INIT_LIST_HEAD(&rq->timeout_list);
119
	rq->cpu = -1;
J
Jens Axboe 已提交
120
	rq->q = q;
121
	rq->__sector = (sector_t) -1;
122 123
	INIT_HLIST_NODE(&rq->hash);
	RB_CLEAR_NODE(&rq->rb_node);
J
Jens Axboe 已提交
124
	rq->tag = -1;
125
	rq->internal_tag = -1;
126
	rq->start_time = jiffies;
127
	set_start_time_ns(rq);
128
	rq->part = NULL;
L
Linus Torvalds 已提交
129
}
130
EXPORT_SYMBOL(blk_rq_init);
L
Linus Torvalds 已提交
131

N
NeilBrown 已提交
132 133
static void req_bio_endio(struct request *rq, struct bio *bio,
			  unsigned int nbytes, int error)
L
Linus Torvalds 已提交
134
{
135
	if (error)
136
		bio->bi_error = error;
137

138
	if (unlikely(rq->rq_flags & RQF_QUIET))
139
		bio_set_flag(bio, BIO_QUIET);
140

141
	bio_advance(bio, nbytes);
142

T
Tejun Heo 已提交
143
	/* don't actually finish bio if it's part of flush sequence */
144
	if (bio->bi_iter.bi_size == 0 && !(rq->rq_flags & RQF_FLUSH_SEQ))
145
		bio_endio(bio);
L
Linus Torvalds 已提交
146 147 148 149
}

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

154 155 156
	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));
157 158
	printk(KERN_INFO "  bio %p, biotail %p, len %u\n",
	       rq->bio, rq->biotail, blk_rq_bytes(rq));
L
Linus Torvalds 已提交
159 160 161
}
EXPORT_SYMBOL(blk_dump_rq_flags);

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

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

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

J
Jens Axboe 已提交
190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205
/**
 * blk_start_queue_async - asynchronously restart a previously stopped queue
 * @q:    The &struct request_queue in question
 *
 * Description:
 *   blk_start_queue_async() will clear the stop flag on the queue, and
 *   ensure that the request_fn for the queue is run from an async
 *   context.
 **/
void blk_start_queue_async(struct request_queue *q)
{
	queue_flag_clear(QUEUE_FLAG_STOPPED, q);
	blk_run_queue_async(q);
}
EXPORT_SYMBOL(blk_start_queue_async);

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

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

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

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

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

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

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

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

323
	__blk_run_queue_uncond(q);
N
Nick Piggin 已提交
324 325
}
EXPORT_SYMBOL(__blk_run_queue);
J
Jens Axboe 已提交
326

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

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

	spin_lock_irqsave(q->queue_lock, flags);
355
	__blk_run_queue(q);
L
Linus Torvalds 已提交
356 357 358 359
	spin_unlock_irqrestore(q->queue_lock, flags);
}
EXPORT_SYMBOL(blk_run_queue);

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

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

381 382
	lockdep_assert_held(q->queue_lock);

T
Tejun Heo 已提交
383
	while (true) {
384
		bool drain = false;
T
Tejun Heo 已提交
385

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

393
		blkcg_drain_queue(q);
T
Tejun Heo 已提交
394

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

405
		drain |= q->nr_rqs_elvpriv;
406
		drain |= q->request_fn_active;
407 408 409 410 411 412 413

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

424
		if (!drain)
T
Tejun Heo 已提交
425
			break;
426 427 428

		spin_unlock_irq(q->queue_lock);

T
Tejun Heo 已提交
429
		msleep(10);
430 431

		spin_lock_irq(q->queue_lock);
T
Tejun Heo 已提交
432
	}
433 434 435 436 437 438 439

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

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

465 466 467 468 469 470
	/*
	 * 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)) {
471 472 473 474
		spin_lock_irq(q->queue_lock);
		__blk_drain_queue(q, false);
		spin_unlock_irq(q->queue_lock);

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

497 498
void blk_set_queue_dying(struct request_queue *q)
{
499 500 501
	spin_lock_irq(q->queue_lock);
	queue_flag_set(QUEUE_FLAG_DYING, q);
	spin_unlock_irq(q->queue_lock);
502

503 504 505 506 507 508 509
	/*
	 * When queue DYING flag is set, we need to block new req
	 * entering queue, so we call blk_freeze_queue_start() to
	 * prevent I/O from crossing blk_queue_enter().
	 */
	blk_freeze_queue_start(q);

510 511 512 513 514
	if (q->mq_ops)
		blk_mq_wake_waiters(q);
	else {
		struct request_list *rl;

515
		spin_lock_irq(q->queue_lock);
516 517 518 519 520 521
		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]);
			}
		}
522
		spin_unlock_irq(q->queue_lock);
523 524 525 526
	}
}
EXPORT_SYMBOL_GPL(blk_set_queue_dying);

527 528 529 530
/**
 * blk_cleanup_queue - shutdown a request queue
 * @q: request queue to shutdown
 *
531 532
 * Mark @q DYING, drain all pending requests, mark @q DEAD, destroy and
 * put it.  All future requests will be failed immediately with -ENODEV.
533
 */
534
void blk_cleanup_queue(struct request_queue *q)
535
{
536
	spinlock_t *lock = q->queue_lock;
537

B
Bart Van Assche 已提交
538
	/* mark @q DYING, no new request or merges will be allowed afterwards */
539
	mutex_lock(&q->sysfs_lock);
540
	blk_set_queue_dying(q);
541
	spin_lock_irq(lock);
542

543
	/*
B
Bart Van Assche 已提交
544
	 * A dying queue is permanently in bypass mode till released.  Note
545 546 547 548 549 550 551
	 * 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.
	 */
552 553 554
	q->bypass_depth++;
	queue_flag_set(QUEUE_FLAG_BYPASS, q);

555 556
	queue_flag_set(QUEUE_FLAG_NOMERGES, q);
	queue_flag_set(QUEUE_FLAG_NOXMERGES, q);
B
Bart Van Assche 已提交
557
	queue_flag_set(QUEUE_FLAG_DYING, q);
558 559 560
	spin_unlock_irq(lock);
	mutex_unlock(&q->sysfs_lock);

561 562 563 564
	/*
	 * Drain all requests queued before DYING marking. Set DEAD flag to
	 * prevent that q->request_fn() gets invoked after draining finished.
	 */
565
	blk_freeze_queue(q);
566 567
	if (!q->mq_ops) {
		spin_lock_irq(lock);
568
		__blk_drain_queue(q, true);
569 570 571 572
	} else {
		blk_mq_debugfs_unregister_mq(q);
		spin_lock_irq(lock);
	}
573
	queue_flag_set(QUEUE_FLAG_DEAD, q);
574
	spin_unlock_irq(lock);
575

576 577 578
	/* for synchronous bio-based driver finish in-flight integrity i/o */
	blk_flush_integrity();

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

B
Bart Van Assche 已提交
583 584
	if (q->mq_ops)
		blk_mq_free_queue(q);
585
	percpu_ref_exit(&q->q_usage_counter);
B
Bart Van Assche 已提交
586

587 588 589 590 591
	spin_lock_irq(lock);
	if (q->queue_lock != &q->__queue_lock)
		q->queue_lock = &q->__queue_lock;
	spin_unlock_irq(lock);

592
	/* @q is and will stay empty, shutdown and put */
593 594
	blk_put_queue(q);
}
L
Linus Torvalds 已提交
595 596
EXPORT_SYMBOL(blk_cleanup_queue);

597
/* Allocate memory local to the request queue */
598
static void *alloc_request_simple(gfp_t gfp_mask, void *data)
599
{
600 601 602
	struct request_queue *q = data;

	return kmem_cache_alloc_node(request_cachep, gfp_mask, q->node);
603 604
}

605
static void free_request_simple(void *element, void *data)
606 607 608 609
{
	kmem_cache_free(request_cachep, element);
}

610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632
static void *alloc_request_size(gfp_t gfp_mask, void *data)
{
	struct request_queue *q = data;
	struct request *rq;

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

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

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

633 634
int blk_init_rl(struct request_list *rl, struct request_queue *q,
		gfp_t gfp_mask)
L
Linus Torvalds 已提交
635
{
636 637 638
	if (unlikely(rl->rq_pool))
		return 0;

639
	rl->q = q;
640 641 642 643
	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 已提交
644

645 646 647 648 649 650 651 652 653
	if (q->cmd_size) {
		rl->rq_pool = mempool_create_node(BLKDEV_MIN_RQ,
				alloc_request_size, free_request_size,
				q, gfp_mask, q->node);
	} else {
		rl->rq_pool = mempool_create_node(BLKDEV_MIN_RQ,
				alloc_request_simple, free_request_simple,
				q, gfp_mask, q->node);
	}
L
Linus Torvalds 已提交
654 655 656 657 658 659
	if (!rl->rq_pool)
		return -ENOMEM;

	return 0;
}

660 661 662 663 664 665
void blk_exit_rl(struct request_list *rl)
{
	if (rl->rq_pool)
		mempool_destroy(rl->rq_pool);
}

666
struct request_queue *blk_alloc_queue(gfp_t gfp_mask)
L
Linus Torvalds 已提交
667
{
668
	return blk_alloc_queue_node(gfp_mask, NUMA_NO_NODE);
669 670
}
EXPORT_SYMBOL(blk_alloc_queue);
L
Linus Torvalds 已提交
671

672
int blk_queue_enter(struct request_queue *q, bool nowait)
673 674 675 676 677 678 679
{
	while (true) {
		int ret;

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

680
		if (nowait)
681 682
			return -EBUSY;

683
		/*
684
		 * read pair of barrier in blk_freeze_queue_start(),
685
		 * we need to order reading __PERCPU_REF_DEAD flag of
686 687 688
		 * .q_usage_counter and reading .mq_freeze_depth or
		 * queue dying flag, otherwise the following wait may
		 * never return if the two reads are reordered.
689 690 691
		 */
		smp_rmb();

692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714
		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);
}

715 716 717 718 719 720 721
static void blk_rq_timed_out_timer(unsigned long data)
{
	struct request_queue *q = (struct request_queue *)data;

	kblockd_schedule_work(&q->timeout_work);
}

722
struct request_queue *blk_alloc_queue_node(gfp_t gfp_mask, int node_id)
723
{
724
	struct request_queue *q;
725

726
	q = kmem_cache_alloc_node(blk_requestq_cachep,
727
				gfp_mask | __GFP_ZERO, node_id);
L
Linus Torvalds 已提交
728 729 730
	if (!q)
		return NULL;

731
	q->id = ida_simple_get(&blk_queue_ida, 0, 0, gfp_mask);
732
	if (q->id < 0)
733
		goto fail_q;
734

735 736 737 738
	q->bio_split = bioset_create(BIO_POOL_SIZE, 0);
	if (!q->bio_split)
		goto fail_id;

739 740 741 742
	q->backing_dev_info = bdi_alloc_node(gfp_mask, node_id);
	if (!q->backing_dev_info)
		goto fail_split;

743 744 745 746
	q->stats = blk_alloc_queue_stats();
	if (!q->stats)
		goto fail_stats;

747
	q->backing_dev_info->ra_pages =
748
			(VM_MAX_READAHEAD * 1024) / PAGE_SIZE;
749 750
	q->backing_dev_info->capabilities = BDI_CAP_CGROUP_WRITEBACK;
	q->backing_dev_info->name = "block";
751
	q->node = node_id;
752

753
	setup_timer(&q->backing_dev_info->laptop_mode_wb_timer,
754
		    laptop_mode_timer_fn, (unsigned long) q);
J
Jens Axboe 已提交
755
	setup_timer(&q->timeout, blk_rq_timed_out_timer, (unsigned long) q);
756
	INIT_LIST_HEAD(&q->queue_head);
J
Jens Axboe 已提交
757
	INIT_LIST_HEAD(&q->timeout_list);
758
	INIT_LIST_HEAD(&q->icq_list);
759
#ifdef CONFIG_BLK_CGROUP
760
	INIT_LIST_HEAD(&q->blkg_list);
761
#endif
762
	INIT_DELAYED_WORK(&q->delay_work, blk_delay_work);
763

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

766
	mutex_init(&q->sysfs_lock);
767
	spin_lock_init(&q->__queue_lock);
768

769 770 771 772 773 774
	/*
	 * By default initialize queue_lock to internal lock and driver can
	 * override it later if need be.
	 */
	q->queue_lock = &q->__queue_lock;

775 776 777
	/*
	 * A queue starts its life with bypass turned on to avoid
	 * unnecessary bypass on/off overhead and nasty surprises during
778 779
	 * init.  The initial bypass will be finished when the queue is
	 * registered by blk_register_queue().
780 781 782 783
	 */
	q->bypass_depth = 1;
	__set_bit(QUEUE_FLAG_BYPASS, &q->queue_flags);

784 785
	init_waitqueue_head(&q->mq_freeze_wq);

786 787 788 789 790 791 792
	/*
	 * 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))
793
		goto fail_bdi;
794

795 796 797
	if (blkcg_init_queue(q))
		goto fail_ref;

L
Linus Torvalds 已提交
798
	return q;
799

800 801
fail_ref:
	percpu_ref_exit(&q->q_usage_counter);
802
fail_bdi:
803 804
	blk_free_queue_stats(q->stats);
fail_stats:
805
	bdi_put(q->backing_dev_info);
806 807
fail_split:
	bioset_free(q->bio_split);
808 809 810 811 812
fail_id:
	ida_simple_remove(&blk_queue_ida, q->id);
fail_q:
	kmem_cache_free(blk_requestq_cachep, q);
	return NULL;
L
Linus Torvalds 已提交
813
}
814
EXPORT_SYMBOL(blk_alloc_queue_node);
L
Linus Torvalds 已提交
815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837

/**
 * 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
838 839
 *    request queue; this lock will be taken also from interrupt context, so irq
 *    disabling is needed for it.
L
Linus Torvalds 已提交
840
 *
841
 *    Function returns a pointer to the initialized request queue, or %NULL if
L
Linus Torvalds 已提交
842 843 844 845 846 847
 *    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).
 **/
848

849
struct request_queue *blk_init_queue(request_fn_proc *rfn, spinlock_t *lock)
L
Linus Torvalds 已提交
850
{
851
	return blk_init_queue_node(rfn, lock, NUMA_NO_NODE);
852 853 854
}
EXPORT_SYMBOL(blk_init_queue);

855
struct request_queue *
856 857
blk_init_queue_node(request_fn_proc *rfn, spinlock_t *lock, int node_id)
{
858
	struct request_queue *q;
L
Linus Torvalds 已提交
859

860 861
	q = blk_alloc_queue_node(GFP_KERNEL, node_id);
	if (!q)
862 863
		return NULL;

864 865 866 867 868 869 870
	q->request_fn = rfn;
	if (lock)
		q->queue_lock = lock;
	if (blk_init_allocated_queue(q) < 0) {
		blk_cleanup_queue(q);
		return NULL;
	}
871

872
	return q;
873 874 875
}
EXPORT_SYMBOL(blk_init_queue_node);

876
static blk_qc_t blk_queue_bio(struct request_queue *q, struct bio *bio);
877

L
Linus Torvalds 已提交
878

879 880
int blk_init_allocated_queue(struct request_queue *q)
{
881
	q->fq = blk_alloc_flush_queue(q, NUMA_NO_NODE, q->cmd_size);
882
	if (!q->fq)
883
		return -ENOMEM;
884

885 886
	if (q->init_rq_fn && q->init_rq_fn(q, q->fq->flush_rq, GFP_KERNEL))
		goto out_free_flush_queue;
887

888
	if (blk_init_rl(&q->root_rl, q, GFP_KERNEL))
889
		goto out_exit_flush_rq;
L
Linus Torvalds 已提交
890

891
	INIT_WORK(&q->timeout_work, blk_timeout_work);
892
	q->queue_flags		|= QUEUE_FLAG_DEFAULT;
893

894 895 896
	/*
	 * This also sets hw/phys segments, boundary and size
	 */
897
	blk_queue_make_request(q, blk_queue_bio);
L
Linus Torvalds 已提交
898

899 900
	q->sg_reserved_size = INT_MAX;

901 902 903
	/* Protect q->elevator from elevator_change */
	mutex_lock(&q->sysfs_lock);

904
	/* init elevator */
905 906
	if (elevator_init(q, NULL)) {
		mutex_unlock(&q->sysfs_lock);
907
		goto out_exit_flush_rq;
908 909 910
	}

	mutex_unlock(&q->sysfs_lock);
911
	return 0;
912

913 914 915 916
out_exit_flush_rq:
	if (q->exit_rq_fn)
		q->exit_rq_fn(q, q->fq->flush_rq);
out_free_flush_queue:
917
	blk_free_flush_queue(q->fq);
918
	return -ENOMEM;
L
Linus Torvalds 已提交
919
}
920
EXPORT_SYMBOL(blk_init_allocated_queue);
L
Linus Torvalds 已提交
921

T
Tejun Heo 已提交
922
bool blk_get_queue(struct request_queue *q)
L
Linus Torvalds 已提交
923
{
B
Bart Van Assche 已提交
924
	if (likely(!blk_queue_dying(q))) {
T
Tejun Heo 已提交
925 926
		__blk_get_queue(q);
		return true;
L
Linus Torvalds 已提交
927 928
	}

T
Tejun Heo 已提交
929
	return false;
L
Linus Torvalds 已提交
930
}
J
Jens Axboe 已提交
931
EXPORT_SYMBOL(blk_get_queue);
L
Linus Torvalds 已提交
932

933
static inline void blk_free_request(struct request_list *rl, struct request *rq)
L
Linus Torvalds 已提交
934
{
935
	if (rq->rq_flags & RQF_ELVPRIV) {
936
		elv_put_request(rl->q, rq);
937
		if (rq->elv.icq)
938
			put_io_context(rq->elv.icq->ioc);
939 940
	}

941
	mempool_free(rq, rl->rq_pool);
L
Linus Torvalds 已提交
942 943 944 945 946 947
}

/*
 * ioc_batching returns true if the ioc is a valid batching request and
 * should be given priority access to a request.
 */
948
static inline int ioc_batching(struct request_queue *q, struct io_context *ioc)
L
Linus Torvalds 已提交
949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968
{
	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.
 */
969
static void ioc_set_batching(struct request_queue *q, struct io_context *ioc)
L
Linus Torvalds 已提交
970 971 972 973 974 975 976 977
{
	if (!ioc || ioc_batching(q, ioc))
		return;

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

978
static void __freed_request(struct request_list *rl, int sync)
L
Linus Torvalds 已提交
979
{
980
	struct request_queue *q = rl->q;
L
Linus Torvalds 已提交
981

982 983
	if (rl->count[sync] < queue_congestion_off_threshold(q))
		blk_clear_congested(rl, sync);
L
Linus Torvalds 已提交
984

985 986 987
	if (rl->count[sync] + 1 <= q->nr_requests) {
		if (waitqueue_active(&rl->wait[sync]))
			wake_up(&rl->wait[sync]);
L
Linus Torvalds 已提交
988

989
		blk_clear_rl_full(rl, sync);
L
Linus Torvalds 已提交
990 991 992 993 994 995 996
	}
}

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

1002
	q->nr_rqs[sync]--;
1003
	rl->count[sync]--;
1004
	if (rq_flags & RQF_ELVPRIV)
1005
		q->nr_rqs_elvpriv--;
L
Linus Torvalds 已提交
1006

1007
	__freed_request(rl, sync);
L
Linus Torvalds 已提交
1008

1009
	if (unlikely(rl->starved[sync ^ 1]))
1010
		__freed_request(rl, sync ^ 1);
L
Linus Torvalds 已提交
1011 1012
}

1013 1014 1015
int blk_update_nr_requests(struct request_queue *q, unsigned int nr)
{
	struct request_list *rl;
1016
	int on_thresh, off_thresh;
1017 1018 1019 1020

	spin_lock_irq(q->queue_lock);
	q->nr_requests = nr;
	blk_queue_congestion_threshold(q);
1021 1022
	on_thresh = queue_congestion_on_threshold(q);
	off_thresh = queue_congestion_off_threshold(q);
1023

1024 1025 1026 1027 1028
	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);
1029

1030 1031 1032 1033
		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);
1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053

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

1054
/**
T
Tejun Heo 已提交
1055
 * __get_request - get a free request
1056
 * @rl: request list to allocate from
1057
 * @op: operation and flags
1058 1059 1060 1061 1062 1063
 * @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.
 *
1064
 * Must be called with @q->queue_lock held and,
1065 1066
 * Returns ERR_PTR on failure, with @q->queue_lock held.
 * Returns request pointer on success, with @q->queue_lock *not held*.
L
Linus Torvalds 已提交
1067
 */
1068 1069
static struct request *__get_request(struct request_list *rl, unsigned int op,
		struct bio *bio, gfp_t gfp_mask)
L
Linus Torvalds 已提交
1070
{
1071
	struct request_queue *q = rl->q;
T
Tejun Heo 已提交
1072
	struct request *rq;
T
Tejun Heo 已提交
1073 1074
	struct elevator_type *et = q->elevator->type;
	struct io_context *ioc = rq_ioc(bio);
1075
	struct io_cq *icq = NULL;
1076
	const bool is_sync = op_is_sync(op);
1077
	int may_queue;
1078
	req_flags_t rq_flags = RQF_ALLOCED;
1079

B
Bart Van Assche 已提交
1080
	if (unlikely(blk_queue_dying(q)))
1081
		return ERR_PTR(-ENODEV);
1082

1083
	may_queue = elv_may_queue(q, op);
1084 1085 1086
	if (may_queue == ELV_MQUEUE_NO)
		goto rq_starved;

1087 1088
	if (rl->count[is_sync]+1 >= queue_congestion_on_threshold(q)) {
		if (rl->count[is_sync]+1 >= q->nr_requests) {
1089 1090 1091 1092 1093 1094
			/*
			 * 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.
			 */
1095
			if (!blk_rl_full(rl, is_sync)) {
1096
				ioc_set_batching(q, ioc);
1097
				blk_set_rl_full(rl, is_sync);
1098 1099 1100 1101 1102 1103 1104 1105
			} 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
					 */
1106
					return ERR_PTR(-ENOMEM);
1107 1108
				}
			}
L
Linus Torvalds 已提交
1109
		}
1110
		blk_set_congested(rl, is_sync);
L
Linus Torvalds 已提交
1111 1112
	}

1113 1114 1115 1116 1117
	/*
	 * 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
	 */
1118
	if (rl->count[is_sync] >= (3 * q->nr_requests / 2))
1119
		return ERR_PTR(-ENOMEM);
H
Hugh Dickins 已提交
1120

1121
	q->nr_rqs[is_sync]++;
1122 1123
	rl->count[is_sync]++;
	rl->starved[is_sync] = 0;
T
Tejun Heo 已提交
1124

1125 1126
	/*
	 * Decide whether the new request will be managed by elevator.  If
1127
	 * so, mark @rq_flags and increment elvpriv.  Non-zero elvpriv will
1128 1129 1130 1131
	 * 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.
	 *
1132 1133 1134
	 * Flush requests do not use the elevator so skip initialization.
	 * This allows a request to share the flush and elevator data.
	 *
1135 1136 1137
	 * Also, lookup icq while holding queue_lock.  If it doesn't exist,
	 * it will be created after releasing queue_lock.
	 */
1138
	if (!op_is_flush(op) && !blk_queue_bypass(q)) {
1139
		rq_flags |= RQF_ELVPRIV;
1140
		q->nr_rqs_elvpriv++;
1141 1142
		if (et->icq_cache && ioc)
			icq = ioc_lookup_icq(ioc, q);
1143
	}
T
Tejun Heo 已提交
1144

1145
	if (blk_queue_io_stat(q))
1146
		rq_flags |= RQF_IO_STAT;
L
Linus Torvalds 已提交
1147 1148
	spin_unlock_irq(q->queue_lock);

1149
	/* allocate and init request */
1150
	rq = mempool_alloc(rl->rq_pool, gfp_mask);
1151
	if (!rq)
T
Tejun Heo 已提交
1152
		goto fail_alloc;
L
Linus Torvalds 已提交
1153

1154
	blk_rq_init(q, rq);
1155
	blk_rq_set_rl(rq, rl);
1156
	rq->cmd_flags = op;
1157
	rq->rq_flags = rq_flags;
1158

1159
	/* init elvpriv */
1160
	if (rq_flags & RQF_ELVPRIV) {
1161
		if (unlikely(et->icq_cache && !icq)) {
T
Tejun Heo 已提交
1162 1163
			if (ioc)
				icq = ioc_create_icq(ioc, q, gfp_mask);
1164 1165
			if (!icq)
				goto fail_elvpriv;
1166
		}
1167 1168 1169 1170 1171 1172

		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 */
1173 1174 1175
		if (icq)
			get_io_context(icq->ioc);
	}
1176
out:
1177 1178 1179 1180 1181 1182
	/*
	 * 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 已提交
1183 1184
	if (ioc_batching(q, ioc))
		ioc->nr_batch_requests--;
1185

1186
	trace_block_getrq(q, bio, op);
L
Linus Torvalds 已提交
1187
	return rq;
T
Tejun Heo 已提交
1188

1189 1190 1191 1192 1193 1194 1195
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.
	 */
1196
	printk_ratelimited(KERN_WARNING "%s: dev %s: request aux data allocation failed, iosched may be disturbed\n",
1197
			   __func__, dev_name(q->backing_dev_info->dev));
1198

1199
	rq->rq_flags &= ~RQF_ELVPRIV;
1200 1201 1202
	rq->elv.icq = NULL;

	spin_lock_irq(q->queue_lock);
1203
	q->nr_rqs_elvpriv--;
1204 1205 1206
	spin_unlock_irq(q->queue_lock);
	goto out;

T
Tejun Heo 已提交
1207 1208 1209 1210 1211 1212 1213 1214 1215
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);
1216
	freed_request(rl, is_sync, rq_flags);
T
Tejun Heo 已提交
1217 1218 1219 1220 1221 1222 1223 1224 1225 1226 1227

	/*
	 * 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;
1228
	return ERR_PTR(-ENOMEM);
L
Linus Torvalds 已提交
1229 1230
}

1231
/**
T
Tejun Heo 已提交
1232
 * get_request - get a free request
1233
 * @q: request_queue to allocate request from
1234
 * @op: operation and flags
1235
 * @bio: bio to allocate request for (can be %NULL)
T
Tejun Heo 已提交
1236
 * @gfp_mask: allocation mask
1237
 *
1238 1239
 * 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 已提交
1240
 *
1241
 * Must be called with @q->queue_lock held and,
1242 1243
 * Returns ERR_PTR on failure, with @q->queue_lock held.
 * Returns request pointer on success, with @q->queue_lock *not held*.
L
Linus Torvalds 已提交
1244
 */
1245 1246
static struct request *get_request(struct request_queue *q, unsigned int op,
		struct bio *bio, gfp_t gfp_mask)
L
Linus Torvalds 已提交
1247
{
1248
	const bool is_sync = op_is_sync(op);
T
Tejun Heo 已提交
1249
	DEFINE_WAIT(wait);
1250
	struct request_list *rl;
L
Linus Torvalds 已提交
1251
	struct request *rq;
1252 1253

	rl = blk_get_rl(q, bio);	/* transferred to @rq on success */
T
Tejun Heo 已提交
1254
retry:
1255
	rq = __get_request(rl, op, bio, gfp_mask);
1256
	if (!IS_ERR(rq))
T
Tejun Heo 已提交
1257
		return rq;
L
Linus Torvalds 已提交
1258

1259
	if (!gfpflags_allow_blocking(gfp_mask) || unlikely(blk_queue_dying(q))) {
1260
		blk_put_rl(rl);
1261
		return rq;
1262
	}
L
Linus Torvalds 已提交
1263

T
Tejun Heo 已提交
1264 1265 1266
	/* wait on @rl and retry */
	prepare_to_wait_exclusive(&rl->wait[is_sync], &wait,
				  TASK_UNINTERRUPTIBLE);
L
Linus Torvalds 已提交
1267

1268
	trace_block_sleeprq(q, bio, op);
L
Linus Torvalds 已提交
1269

T
Tejun Heo 已提交
1270 1271
	spin_unlock_irq(q->queue_lock);
	io_schedule();
N
Nick Piggin 已提交
1272

T
Tejun Heo 已提交
1273 1274 1275 1276 1277 1278
	/*
	 * 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);
1279

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

T
Tejun Heo 已提交
1283
	goto retry;
L
Linus Torvalds 已提交
1284 1285
}

1286 1287
static struct request *blk_old_get_request(struct request_queue *q, int rw,
		gfp_t gfp_mask)
L
Linus Torvalds 已提交
1288 1289 1290
{
	struct request *rq;

T
Tejun Heo 已提交
1291 1292 1293
	/* create ioc upfront */
	create_io_context(gfp_mask, q->node);

N
Nick Piggin 已提交
1294
	spin_lock_irq(q->queue_lock);
1295
	rq = get_request(q, rw, NULL, gfp_mask);
1296
	if (IS_ERR(rq)) {
1297
		spin_unlock_irq(q->queue_lock);
1298 1299
		return rq;
	}
L
Linus Torvalds 已提交
1300

1301 1302 1303 1304
	/* q->queue_lock is unlocked at this point */
	rq->__data_len = 0;
	rq->__sector = (sector_t) -1;
	rq->bio = rq->biotail = NULL;
L
Linus Torvalds 已提交
1305 1306
	return rq;
}
1307 1308 1309 1310

struct request *blk_get_request(struct request_queue *q, int rw, gfp_t gfp_mask)
{
	if (q->mq_ops)
1311 1312 1313
		return blk_mq_alloc_request(q, rw,
			(gfp_mask & __GFP_DIRECT_RECLAIM) ?
				0 : BLK_MQ_REQ_NOWAIT);
1314 1315 1316
	else
		return blk_old_get_request(q, rw, gfp_mask);
}
L
Linus Torvalds 已提交
1317 1318 1319 1320 1321 1322 1323 1324 1325 1326 1327 1328
EXPORT_SYMBOL(blk_get_request);

/**
 * blk_requeue_request - put a request back on queue
 * @q:		request queue where request should be inserted
 * @rq:		request to be inserted
 *
 * Description:
 *    Drivers often keep queueing requests until the hardware cannot accept
 *    more, when that condition happens we need to put the request back
 *    on the queue. Must be called with queue lock held.
 */
1329
void blk_requeue_request(struct request_queue *q, struct request *rq)
L
Linus Torvalds 已提交
1330
{
J
Jens Axboe 已提交
1331 1332
	blk_delete_timer(rq);
	blk_clear_rq_complete(rq);
1333
	trace_block_rq_requeue(q, rq);
J
Jens Axboe 已提交
1334
	wbt_requeue(q->rq_wb, &rq->issue_stat);
1335

1336
	if (rq->rq_flags & RQF_QUEUED)
L
Linus Torvalds 已提交
1337 1338
		blk_queue_end_tag(q, rq);

1339 1340
	BUG_ON(blk_queued_rq(rq));

L
Linus Torvalds 已提交
1341 1342 1343 1344
	elv_requeue_request(q, rq);
}
EXPORT_SYMBOL(blk_requeue_request);

1345 1346 1347
static void add_acct_request(struct request_queue *q, struct request *rq,
			     int where)
{
1348
	blk_account_io_start(rq, true);
J
Jens Axboe 已提交
1349
	__elv_add_request(q, rq, where);
1350 1351
}

T
Tejun Heo 已提交
1352 1353 1354
static void part_round_stats_single(int cpu, struct hd_struct *part,
				    unsigned long now)
{
1355 1356
	int inflight;

T
Tejun Heo 已提交
1357 1358 1359
	if (now == part->stamp)
		return;

1360 1361
	inflight = part_in_flight(part);
	if (inflight) {
T
Tejun Heo 已提交
1362
		__part_stat_add(cpu, part, time_in_queue,
1363
				inflight * (now - part->stamp));
T
Tejun Heo 已提交
1364 1365 1366 1367 1368 1369
		__part_stat_add(cpu, part, io_ticks, (now - part->stamp));
	}
	part->stamp = now;
}

/**
1370 1371 1372
 * 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 已提交
1373 1374 1375 1376 1377 1378 1379 1380 1381 1382 1383 1384
 *
 * 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 已提交
1385
void part_round_stats(int cpu, struct hd_struct *part)
1386 1387 1388
{
	unsigned long now = jiffies;

T
Tejun Heo 已提交
1389 1390 1391
	if (part->partno)
		part_round_stats_single(cpu, &part_to_disk(part)->part0, now);
	part_round_stats_single(cpu, part, now);
1392
}
T
Tejun Heo 已提交
1393
EXPORT_SYMBOL_GPL(part_round_stats);
1394

1395
#ifdef CONFIG_PM
L
Lin Ming 已提交
1396 1397
static void blk_pm_put_request(struct request *rq)
{
1398
	if (rq->q->dev && !(rq->rq_flags & RQF_PM) && !--rq->q->nr_pending)
L
Lin Ming 已提交
1399 1400 1401 1402 1403 1404
		pm_runtime_mark_last_busy(rq->q->dev);
}
#else
static inline void blk_pm_put_request(struct request *rq) {}
#endif

L
Linus Torvalds 已提交
1405 1406 1407
/*
 * queue lock must be held
 */
1408
void __blk_put_request(struct request_queue *q, struct request *req)
L
Linus Torvalds 已提交
1409
{
1410 1411
	req_flags_t rq_flags = req->rq_flags;

L
Linus Torvalds 已提交
1412 1413 1414
	if (unlikely(!q))
		return;

1415 1416 1417 1418 1419
	if (q->mq_ops) {
		blk_mq_free_request(req);
		return;
	}

L
Lin Ming 已提交
1420 1421
	blk_pm_put_request(req);

1422 1423
	elv_completed_request(q, req);

1424 1425 1426
	/* this is a bio leak */
	WARN_ON(req->bio != NULL);

J
Jens Axboe 已提交
1427 1428
	wbt_done(q->rq_wb, &req->issue_stat);

L
Linus Torvalds 已提交
1429 1430 1431 1432
	/*
	 * Request may not have originated from ll_rw_blk. if not,
	 * it didn't come out of our reserved rq pools
	 */
1433
	if (rq_flags & RQF_ALLOCED) {
1434
		struct request_list *rl = blk_rq_rl(req);
1435
		bool sync = op_is_sync(req->cmd_flags);
L
Linus Torvalds 已提交
1436 1437

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

1440
		blk_free_request(rl, req);
1441
		freed_request(rl, sync, rq_flags);
1442
		blk_put_rl(rl);
L
Linus Torvalds 已提交
1443 1444
	}
}
1445 1446
EXPORT_SYMBOL_GPL(__blk_put_request);

L
Linus Torvalds 已提交
1447 1448
void blk_put_request(struct request *req)
{
1449
	struct request_queue *q = req->q;
1450

1451 1452 1453 1454 1455 1456 1457 1458 1459
	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 已提交
1460 1461 1462
}
EXPORT_SYMBOL(blk_put_request);

1463 1464
bool bio_attempt_back_merge(struct request_queue *q, struct request *req,
			    struct bio *bio)
1465
{
J
Jens Axboe 已提交
1466
	const int ff = bio->bi_opf & REQ_FAILFAST_MASK;
1467 1468 1469 1470

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

1471
	trace_block_bio_backmerge(q, req, bio);
1472 1473 1474 1475 1476 1477

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

	req->biotail->bi_next = bio;
	req->biotail = bio;
1478
	req->__data_len += bio->bi_iter.bi_size;
1479 1480
	req->ioprio = ioprio_best(req->ioprio, bio_prio(bio));

1481
	blk_account_io_start(req, false);
1482 1483 1484
	return true;
}

1485 1486
bool bio_attempt_front_merge(struct request_queue *q, struct request *req,
			     struct bio *bio)
1487
{
J
Jens Axboe 已提交
1488
	const int ff = bio->bi_opf & REQ_FAILFAST_MASK;
1489 1490 1491 1492

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

1493
	trace_block_bio_frontmerge(q, req, bio);
1494 1495 1496 1497 1498 1499 1500

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

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

1501 1502
	req->__sector = bio->bi_iter.bi_sector;
	req->__data_len += bio->bi_iter.bi_size;
1503 1504
	req->ioprio = ioprio_best(req->ioprio, bio_prio(bio));

1505
	blk_account_io_start(req, false);
1506 1507 1508
	return true;
}

1509 1510 1511 1512 1513 1514 1515 1516 1517 1518 1519 1520 1521 1522 1523 1524 1525 1526 1527 1528 1529 1530 1531 1532
bool bio_attempt_discard_merge(struct request_queue *q, struct request *req,
		struct bio *bio)
{
	unsigned short segments = blk_rq_nr_discard_segments(req);

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

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

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

1533
/**
1534
 * blk_attempt_plug_merge - try to merge with %current's plugged list
1535 1536 1537
 * @q: request_queue new bio is being queued at
 * @bio: new bio being queued
 * @request_count: out parameter for number of traversed plugged requests
1538 1539 1540
 * @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)
1541 1542 1543 1544 1545
 *
 * 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.
 *
1546 1547 1548 1549 1550 1551
 * 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.
1552 1553
 *
 * Caller must ensure !blk_queue_nomerges(q) beforehand.
1554
 */
1555
bool blk_attempt_plug_merge(struct request_queue *q, struct bio *bio,
1556 1557
			    unsigned int *request_count,
			    struct request **same_queue_rq)
1558 1559 1560
{
	struct blk_plug *plug;
	struct request *rq;
S
Shaohua Li 已提交
1561
	struct list_head *plug_list;
1562

1563
	plug = current->plug;
1564
	if (!plug)
1565
		return false;
1566
	*request_count = 0;
1567

S
Shaohua Li 已提交
1568 1569 1570 1571 1572 1573
	if (q->mq_ops)
		plug_list = &plug->mq_list;
	else
		plug_list = &plug->list;

	list_for_each_entry_reverse(rq, plug_list, queuelist) {
1574
		bool merged = false;
1575

1576
		if (rq->q == q) {
1577
			(*request_count)++;
1578 1579 1580 1581 1582 1583 1584 1585
			/*
			 * 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;
		}
1586

1587
		if (rq->q != q || !blk_rq_merge_ok(rq, bio))
1588 1589
			continue;

1590 1591 1592 1593 1594 1595 1596
		switch (blk_try_merge(rq, bio)) {
		case ELEVATOR_BACK_MERGE:
			merged = bio_attempt_back_merge(q, rq, bio);
			break;
		case ELEVATOR_FRONT_MERGE:
			merged = bio_attempt_front_merge(q, rq, bio);
			break;
1597 1598 1599
		case ELEVATOR_DISCARD_MERGE:
			merged = bio_attempt_discard_merge(q, rq, bio);
			break;
1600 1601
		default:
			break;
1602
		}
1603 1604 1605

		if (merged)
			return true;
1606
	}
1607 1608

	return false;
1609 1610
}

1611 1612 1613 1614 1615 1616 1617 1618 1619 1620 1621 1622 1623 1624 1625 1626 1627 1628 1629 1630 1631 1632 1633 1634
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;
}

1635
void blk_init_request_from_bio(struct request *req, struct bio *bio)
1636
{
1637 1638
	struct io_context *ioc = rq_ioc(bio);

J
Jens Axboe 已提交
1639
	if (bio->bi_opf & REQ_RAHEAD)
1640
		req->cmd_flags |= REQ_FAILFAST_MASK;
J
Jens Axboe 已提交
1641

1642
	req->__sector = bio->bi_iter.bi_sector;
1643 1644
	if (ioprio_valid(bio_prio(bio)))
		req->ioprio = bio_prio(bio);
1645 1646 1647 1648
	else if (ioc)
		req->ioprio = ioc->ioprio;
	else
		req->ioprio = IOPRIO_PRIO_VALUE(IOPRIO_CLASS_NONE, 0);
1649
	blk_rq_bio_prep(req->q, req, bio);
1650
}
1651
EXPORT_SYMBOL_GPL(blk_init_request_from_bio);
1652

1653
static blk_qc_t blk_queue_bio(struct request_queue *q, struct bio *bio)
L
Linus Torvalds 已提交
1654
{
1655
	struct blk_plug *plug;
1656
	int where = ELEVATOR_INSERT_SORT;
1657
	struct request *req, *free;
1658
	unsigned int request_count = 0;
J
Jens Axboe 已提交
1659
	unsigned int wb_acct;
L
Linus Torvalds 已提交
1660 1661 1662 1663 1664 1665 1666 1667

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

1668 1669
	blk_queue_split(q, &bio, q->bio_split);

1670
	if (bio_integrity_enabled(bio) && bio_integrity_prep(bio)) {
1671 1672
		bio->bi_error = -EIO;
		bio_endio(bio);
1673
		return BLK_QC_T_NONE;
1674 1675
	}

1676
	if (op_is_flush(bio->bi_opf)) {
1677
		spin_lock_irq(q->queue_lock);
1678
		where = ELEVATOR_INSERT_FLUSH;
1679 1680 1681
		goto get_rq;
	}

1682 1683 1684 1685
	/*
	 * Check if we can merge with the plugged list before grabbing
	 * any locks.
	 */
1686 1687
	if (!blk_queue_nomerges(q)) {
		if (blk_attempt_plug_merge(q, bio, &request_count, NULL))
1688
			return BLK_QC_T_NONE;
1689 1690
	} else
		request_count = blk_plug_queued_count(q);
L
Linus Torvalds 已提交
1691

1692
	spin_lock_irq(q->queue_lock);
1693

1694 1695 1696 1697 1698 1699 1700 1701 1702 1703 1704 1705 1706 1707 1708 1709 1710 1711 1712 1713 1714 1715 1716
	switch (elv_merge(q, &req, bio)) {
	case ELEVATOR_BACK_MERGE:
		if (!bio_attempt_back_merge(q, req, bio))
			break;
		elv_bio_merged(q, req, bio);
		free = attempt_back_merge(q, req);
		if (free)
			__blk_put_request(q, free);
		else
			elv_merged_request(q, req, ELEVATOR_BACK_MERGE);
		goto out_unlock;
	case ELEVATOR_FRONT_MERGE:
		if (!bio_attempt_front_merge(q, req, bio))
			break;
		elv_bio_merged(q, req, bio);
		free = attempt_front_merge(q, req);
		if (free)
			__blk_put_request(q, free);
		else
			elv_merged_request(q, req, ELEVATOR_FRONT_MERGE);
		goto out_unlock;
	default:
		break;
L
Linus Torvalds 已提交
1717 1718
	}

1719
get_rq:
J
Jens Axboe 已提交
1720 1721
	wb_acct = wbt_wait(q->rq_wb, bio, q->queue_lock);

L
Linus Torvalds 已提交
1722
	/*
1723
	 * Grab a free request. This is might sleep but can not fail.
N
Nick Piggin 已提交
1724
	 * Returns with the queue unlocked.
1725
	 */
1726
	req = get_request(q, bio->bi_opf, bio, GFP_NOIO);
1727
	if (IS_ERR(req)) {
J
Jens Axboe 已提交
1728
		__wbt_done(q->rq_wb, wb_acct);
1729 1730
		bio->bi_error = PTR_ERR(req);
		bio_endio(bio);
1731 1732
		goto out_unlock;
	}
N
Nick Piggin 已提交
1733

J
Jens Axboe 已提交
1734 1735
	wbt_track(&req->issue_stat, wb_acct);

1736 1737 1738 1739 1740
	/*
	 * 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 已提交
1741
	 */
1742
	blk_init_request_from_bio(req, bio);
L
Linus Torvalds 已提交
1743

1744
	if (test_bit(QUEUE_FLAG_SAME_COMP, &q->queue_flags))
1745
		req->cpu = raw_smp_processor_id();
1746 1747

	plug = current->plug;
J
Jens Axboe 已提交
1748
	if (plug) {
J
Jens Axboe 已提交
1749 1750
		/*
		 * If this is the first request added after a plug, fire
1751
		 * of a plug trace.
1752 1753 1754
		 *
		 * @request_count may become stale because of schedule
		 * out, so check plug list again.
J
Jens Axboe 已提交
1755
		 */
1756
		if (!request_count || list_empty(&plug->list))
J
Jens Axboe 已提交
1757
			trace_block_plug(q);
1758
		else {
1759 1760 1761
			struct request *last = list_entry_rq(plug->list.prev);
			if (request_count >= BLK_MAX_REQUEST_COUNT ||
			    blk_rq_bytes(last) >= BLK_PLUG_FLUSH_SIZE) {
1762
				blk_flush_plug_list(plug, false);
S
Shaohua Li 已提交
1763 1764
				trace_block_plug(q);
			}
1765 1766
		}
		list_add_tail(&req->queuelist, &plug->list);
1767
		blk_account_io_start(req, true);
1768 1769 1770
	} else {
		spin_lock_irq(q->queue_lock);
		add_acct_request(q, req, where);
1771
		__blk_run_queue(q);
1772 1773 1774
out_unlock:
		spin_unlock_irq(q->queue_lock);
	}
1775 1776

	return BLK_QC_T_NONE;
L
Linus Torvalds 已提交
1777 1778 1779 1780 1781 1782 1783 1784 1785
}

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

1786 1787 1788 1789 1790 1791
	/*
	 * Zone reset does not include bi_size so bio_sectors() is always 0.
	 * Include a test for the reset op code and perform the remap if needed.
	 */
	if (bdev != bdev->bd_contains &&
	    (bio_sectors(bio) || bio_op(bio) == REQ_OP_ZONE_RESET)) {
L
Linus Torvalds 已提交
1792 1793
		struct hd_struct *p = bdev->bd_part;

1794
		bio->bi_iter.bi_sector += p->start_sect;
L
Linus Torvalds 已提交
1795
		bio->bi_bdev = bdev->bd_contains;
1796

1797 1798
		trace_block_bio_remap(bdev_get_queue(bio->bi_bdev), bio,
				      bdev->bd_dev,
1799
				      bio->bi_iter.bi_sector - p->start_sect);
L
Linus Torvalds 已提交
1800 1801 1802 1803 1804 1805 1806 1807
	}
}

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

	printk(KERN_INFO "attempt to access beyond end of device\n");
1808
	printk(KERN_INFO "%s: rw=%d, want=%Lu, limit=%Lu\n",
L
Linus Torvalds 已提交
1809
			bdevname(bio->bi_bdev, b),
J
Jens Axboe 已提交
1810
			bio->bi_opf,
K
Kent Overstreet 已提交
1811
			(unsigned long long)bio_end_sector(bio),
1812
			(long long)(i_size_read(bio->bi_bdev->bd_inode) >> 9));
L
Linus Torvalds 已提交
1813 1814
}

1815 1816 1817 1818 1819 1820 1821 1822 1823 1824
#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);

1825
static bool should_fail_request(struct hd_struct *part, unsigned int bytes)
1826
{
1827
	return part->make_it_fail && should_fail(&fail_make_request, bytes);
1828 1829 1830 1831
}

static int __init fail_make_request_debugfs(void)
{
1832 1833 1834
	struct dentry *dir = fault_create_debugfs_attr("fail_make_request",
						NULL, &fail_make_request);

1835
	return PTR_ERR_OR_ZERO(dir);
1836 1837 1838 1839 1840 1841
}

late_initcall(fail_make_request_debugfs);

#else /* CONFIG_FAIL_MAKE_REQUEST */

1842 1843
static inline bool should_fail_request(struct hd_struct *part,
					unsigned int bytes)
1844
{
1845
	return false;
1846 1847 1848 1849
}

#endif /* CONFIG_FAIL_MAKE_REQUEST */

J
Jens Axboe 已提交
1850 1851 1852 1853 1854 1855 1856 1857 1858 1859 1860
/*
 * 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. */
1861
	maxsector = i_size_read(bio->bi_bdev->bd_inode) >> 9;
J
Jens Axboe 已提交
1862
	if (maxsector) {
1863
		sector_t sector = bio->bi_iter.bi_sector;
J
Jens Axboe 已提交
1864 1865 1866 1867 1868 1869 1870 1871 1872 1873 1874 1875 1876 1877 1878

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

1879 1880
static noinline_for_stack bool
generic_make_request_checks(struct bio *bio)
L
Linus Torvalds 已提交
1881
{
1882
	struct request_queue *q;
1883
	int nr_sectors = bio_sectors(bio);
1884
	int err = -EIO;
1885 1886
	char b[BDEVNAME_SIZE];
	struct hd_struct *part;
L
Linus Torvalds 已提交
1887 1888 1889

	might_sleep();

J
Jens Axboe 已提交
1890 1891
	if (bio_check_eod(bio, nr_sectors))
		goto end_io;
L
Linus Torvalds 已提交
1892

1893 1894 1895 1896 1897 1898
	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),
1899
			(long long) bio->bi_iter.bi_sector);
1900 1901
		goto end_io;
	}
1902

1903
	part = bio->bi_bdev->bd_part;
1904
	if (should_fail_request(part, bio->bi_iter.bi_size) ||
1905
	    should_fail_request(&part_to_disk(part)->part0,
1906
				bio->bi_iter.bi_size))
1907
		goto end_io;
1908

1909 1910 1911 1912 1913
	/*
	 * If this device has partitions, remap block n
	 * of partition p to block n+start(p) of the disk.
	 */
	blk_partition_remap(bio);
1914

1915 1916
	if (bio_check_eod(bio, nr_sectors))
		goto end_io;
1917

1918 1919 1920 1921 1922
	/*
	 * Filter flush bio's early so that make_request based
	 * drivers without flush support don't have to worry
	 * about them.
	 */
1923
	if (op_is_flush(bio->bi_opf) &&
J
Jens Axboe 已提交
1924
	    !test_bit(QUEUE_FLAG_WC, &q->queue_flags)) {
J
Jens Axboe 已提交
1925
		bio->bi_opf &= ~(REQ_PREFLUSH | REQ_FUA);
1926 1927
		if (!nr_sectors) {
			err = 0;
1928 1929
			goto end_io;
		}
1930
	}
1931

1932 1933 1934 1935 1936 1937 1938 1939 1940 1941 1942 1943
	switch (bio_op(bio)) {
	case REQ_OP_DISCARD:
		if (!blk_queue_discard(q))
			goto not_supported;
		break;
	case REQ_OP_SECURE_ERASE:
		if (!blk_queue_secure_erase(q))
			goto not_supported;
		break;
	case REQ_OP_WRITE_SAME:
		if (!bdev_write_same(bio->bi_bdev))
			goto not_supported;
1944
		break;
1945 1946 1947 1948
	case REQ_OP_ZONE_REPORT:
	case REQ_OP_ZONE_RESET:
		if (!bdev_is_zoned(bio->bi_bdev))
			goto not_supported;
1949
		break;
1950 1951 1952 1953
	case REQ_OP_WRITE_ZEROES:
		if (!bdev_write_zeroes_sectors(bio->bi_bdev))
			goto not_supported;
		break;
1954 1955
	default:
		break;
1956
	}
1957

T
Tejun Heo 已提交
1958 1959 1960 1961 1962 1963 1964 1965
	/*
	 * 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);

1966 1967
	if (!blkcg_bio_issue_check(q, bio))
		return false;
1968

N
NeilBrown 已提交
1969 1970 1971 1972 1973 1974 1975
	if (!bio_flagged(bio, BIO_TRACE_COMPLETION)) {
		trace_block_bio_queue(q, bio);
		/* Now that enqueuing has been traced, we need to trace
		 * completion as well.
		 */
		bio_set_flag(bio, BIO_TRACE_COMPLETION);
	}
1976
	return true;
1977

1978 1979
not_supported:
	err = -EOPNOTSUPP;
1980
end_io:
1981 1982
	bio->bi_error = err;
	bio_endio(bio);
1983
	return false;
L
Linus Torvalds 已提交
1984 1985
}

1986 1987 1988 1989 1990 1991 1992 1993 1994 1995 1996 1997 1998 1999 2000 2001 2002 2003 2004 2005 2006 2007 2008
/**
 * 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.
2009
 */
2010
blk_qc_t generic_make_request(struct bio *bio)
2011
{
2012 2013 2014 2015 2016 2017 2018 2019
	/*
	 * bio_list_on_stack[0] contains bios submitted by the current
	 * make_request_fn.
	 * bio_list_on_stack[1] contains bios that were submitted before
	 * the current make_request_fn, but that haven't been processed
	 * yet.
	 */
	struct bio_list bio_list_on_stack[2];
2020
	blk_qc_t ret = BLK_QC_T_NONE;
2021

2022
	if (!generic_make_request_checks(bio))
2023
		goto out;
2024 2025 2026 2027 2028 2029 2030 2031 2032 2033 2034

	/*
	 * 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
	 */
2035
	if (current->bio_list) {
2036
		bio_list_add(&current->bio_list[0], bio);
2037
		goto out;
2038
	}
2039

2040 2041 2042 2043 2044
	/* 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
2045 2046
	 * we assign bio_list to a pointer to the bio_list_on_stack,
	 * thus initialising the bio_list of new bios to be
2047
	 * added.  ->make_request() may indeed add some more bios
2048 2049 2050
	 * 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
2051
	 * of the top of the list (no pretending) and so remove it from
2052
	 * bio_list, and call into ->make_request() again.
2053 2054
	 */
	BUG_ON(bio->bi_next);
2055 2056
	bio_list_init(&bio_list_on_stack[0]);
	current->bio_list = bio_list_on_stack;
2057
	do {
2058 2059
		struct request_queue *q = bdev_get_queue(bio->bi_bdev);

2060
		if (likely(blk_queue_enter(q, false) == 0)) {
2061 2062 2063
			struct bio_list lower, same;

			/* Create a fresh bio_list for all subordinate requests */
2064 2065
			bio_list_on_stack[1] = bio_list_on_stack[0];
			bio_list_init(&bio_list_on_stack[0]);
2066
			ret = q->make_request_fn(q, bio);
2067 2068

			blk_queue_exit(q);
2069

2070 2071 2072 2073 2074
			/* sort new bios into those for a lower level
			 * and those for the same level
			 */
			bio_list_init(&lower);
			bio_list_init(&same);
2075
			while ((bio = bio_list_pop(&bio_list_on_stack[0])) != NULL)
2076 2077 2078 2079 2080
				if (q == bdev_get_queue(bio->bi_bdev))
					bio_list_add(&same, bio);
				else
					bio_list_add(&lower, bio);
			/* now assemble so we handle the lowest level first */
2081 2082 2083
			bio_list_merge(&bio_list_on_stack[0], &lower);
			bio_list_merge(&bio_list_on_stack[0], &same);
			bio_list_merge(&bio_list_on_stack[0], &bio_list_on_stack[1]);
2084 2085 2086
		} else {
			bio_io_error(bio);
		}
2087
		bio = bio_list_pop(&bio_list_on_stack[0]);
2088
	} while (bio);
2089
	current->bio_list = NULL; /* deactivate */
2090 2091 2092

out:
	return ret;
2093
}
L
Linus Torvalds 已提交
2094 2095 2096
EXPORT_SYMBOL(generic_make_request);

/**
2097
 * submit_bio - submit a bio to the block device layer for I/O
L
Linus Torvalds 已提交
2098 2099 2100 2101
 * @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
2102
 * interfaces; @bio must be presetup and ready for I/O.
L
Linus Torvalds 已提交
2103 2104
 *
 */
2105
blk_qc_t submit_bio(struct bio *bio)
L
Linus Torvalds 已提交
2106
{
2107 2108 2109 2110
	/*
	 * If it's a regular read/write or a barrier with data attached,
	 * go through the normal accounting stuff before submission.
	 */
2111
	if (bio_has_data(bio)) {
2112 2113
		unsigned int count;

2114
		if (unlikely(bio_op(bio) == REQ_OP_WRITE_SAME))
2115 2116 2117 2118
			count = bdev_logical_block_size(bio->bi_bdev) >> 9;
		else
			count = bio_sectors(bio);

2119
		if (op_is_write(bio_op(bio))) {
2120 2121
			count_vm_events(PGPGOUT, count);
		} else {
2122
			task_io_account_read(bio->bi_iter.bi_size);
2123 2124 2125 2126 2127
			count_vm_events(PGPGIN, count);
		}

		if (unlikely(block_dump)) {
			char b[BDEVNAME_SIZE];
2128
			printk(KERN_DEBUG "%s(%d): %s block %Lu on %s (%u sectors)\n",
2129
			current->comm, task_pid_nr(current),
2130
				op_is_write(bio_op(bio)) ? "WRITE" : "READ",
2131
				(unsigned long long)bio->bi_iter.bi_sector,
2132 2133
				bdevname(bio->bi_bdev, b),
				count);
2134
		}
L
Linus Torvalds 已提交
2135 2136
	}

2137
	return generic_make_request(bio);
L
Linus Torvalds 已提交
2138 2139 2140
}
EXPORT_SYMBOL(submit_bio);

2141
/**
2142 2143
 * blk_cloned_rq_check_limits - Helper function to check a cloned request
 *                              for new the queue limits
2144 2145 2146 2147 2148 2149 2150 2151 2152 2153 2154
 * @q:  the queue
 * @rq: the request being checked
 *
 * Description:
 *    @rq may have been made based on weaker limitations of upper-level queues
 *    in request stacking drivers, and it may violate the limitation of @q.
 *    Since the block layer and the underlying device driver trust @rq
 *    after it is inserted to @q, it should be checked against @q before
 *    the insertion using this generic function.
 *
 *    Request stacking drivers like request-based dm may change the queue
2155 2156
 *    limits when retrying requests on other queues. Those requests need
 *    to be checked against the new queue limits again during dispatch.
2157
 */
2158 2159
static int blk_cloned_rq_check_limits(struct request_queue *q,
				      struct request *rq)
2160
{
2161
	if (blk_rq_sectors(rq) > blk_queue_get_max_sectors(q, req_op(rq))) {
2162 2163 2164 2165 2166 2167 2168 2169 2170 2171 2172
		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);
2173
	if (rq->nr_phys_segments > queue_max_segments(q)) {
2174 2175 2176 2177 2178 2179 2180 2181 2182 2183 2184 2185 2186 2187 2188
		printk(KERN_ERR "%s: over max segments limit.\n", __func__);
		return -EIO;
	}

	return 0;
}

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

2191
	if (blk_cloned_rq_check_limits(q, rq))
2192 2193
		return -EIO;

2194 2195
	if (rq->rq_disk &&
	    should_fail_request(&rq->rq_disk->part0, blk_rq_bytes(rq)))
2196 2197
		return -EIO;

2198 2199 2200
	if (q->mq_ops) {
		if (blk_queue_io_stat(q))
			blk_account_io_start(rq, true);
2201
		blk_mq_sched_insert_request(rq, false, true, false, false);
2202 2203 2204
		return 0;
	}

2205
	spin_lock_irqsave(q->queue_lock, flags);
B
Bart Van Assche 已提交
2206
	if (unlikely(blk_queue_dying(q))) {
2207 2208 2209
		spin_unlock_irqrestore(q->queue_lock, flags);
		return -ENODEV;
	}
2210 2211 2212 2213 2214 2215 2216

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

2217
	if (op_is_flush(rq->cmd_flags))
2218 2219 2220
		where = ELEVATOR_INSERT_FLUSH;

	add_acct_request(q, rq, where);
J
Jeff Moyer 已提交
2221 2222
	if (where == ELEVATOR_INSERT_FLUSH)
		__blk_run_queue(q);
2223 2224 2225 2226 2227 2228
	spin_unlock_irqrestore(q->queue_lock, flags);

	return 0;
}
EXPORT_SYMBOL_GPL(blk_insert_cloned_request);

2229 2230 2231 2232 2233 2234 2235 2236 2237 2238 2239 2240 2241 2242 2243 2244 2245 2246 2247 2248 2249 2250
/**
 * 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;

2251
	if (!(rq->rq_flags & RQF_MIXED_MERGE))
2252 2253 2254 2255 2256 2257 2258 2259 2260 2261
		return blk_rq_bytes(rq);

	/*
	 * Currently the only 'mixing' which can happen is between
	 * different fastfail types.  We can safely fail portions
	 * which have all the failfast bits that the first one has -
	 * the ones which are at least as eager to fail as the first
	 * one.
	 */
	for (bio = rq->bio; bio; bio = bio->bi_next) {
J
Jens Axboe 已提交
2262
		if ((bio->bi_opf & ff) != ff)
2263
			break;
2264
		bytes += bio->bi_iter.bi_size;
2265 2266 2267 2268 2269 2270 2271 2272
	}

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

2273
void blk_account_io_completion(struct request *req, unsigned int bytes)
2274
{
2275
	if (blk_do_io_stat(req)) {
2276 2277 2278 2279 2280
		const int rw = rq_data_dir(req);
		struct hd_struct *part;
		int cpu;

		cpu = part_stat_lock();
2281
		part = req->part;
2282 2283 2284 2285 2286
		part_stat_add(cpu, part, sectors[rw], bytes >> 9);
		part_stat_unlock();
	}
}

2287
void blk_account_io_done(struct request *req)
2288 2289
{
	/*
2290 2291 2292
	 * Account IO completion.  flush_rq isn't accounted as a
	 * normal IO on queueing nor completion.  Accounting the
	 * containing request is enough.
2293
	 */
2294
	if (blk_do_io_stat(req) && !(req->rq_flags & RQF_FLUSH_SEQ)) {
2295 2296 2297 2298 2299 2300
		unsigned long duration = jiffies - req->start_time;
		const int rw = rq_data_dir(req);
		struct hd_struct *part;
		int cpu;

		cpu = part_stat_lock();
2301
		part = req->part;
2302 2303 2304 2305

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

2308
		hd_struct_put(part);
2309 2310 2311 2312
		part_stat_unlock();
	}
}

2313
#ifdef CONFIG_PM
L
Lin Ming 已提交
2314 2315 2316 2317 2318 2319 2320 2321
/*
 * 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 ||
2322
	    (q->rpm_status != RPM_ACTIVE && !(rq->rq_flags & RQF_PM))))
L
Lin Ming 已提交
2323 2324 2325 2326 2327 2328 2329 2330 2331 2332 2333 2334
		return NULL;
	else
		return rq;
}
#else
static inline struct request *blk_pm_peek_request(struct request_queue *q,
						  struct request *rq)
{
	return rq;
}
#endif

2335 2336 2337 2338 2339 2340 2341 2342 2343 2344 2345 2346 2347 2348 2349 2350 2351 2352 2353 2354 2355 2356 2357 2358 2359 2360 2361 2362 2363 2364 2365 2366 2367 2368 2369 2370
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();
}

2371
/**
2372 2373 2374 2375 2376 2377 2378 2379 2380 2381 2382 2383 2384 2385 2386 2387
 * 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)
2388 2389 2390 2391 2392
{
	struct request *rq;
	int ret;

	while ((rq = __elv_next_request(q)) != NULL) {
L
Lin Ming 已提交
2393 2394 2395 2396 2397

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

2398
		if (!(rq->rq_flags & RQF_STARTED)) {
2399 2400 2401 2402 2403
			/*
			 * This is the first time the device driver
			 * sees this request (possibly after
			 * requeueing).  Notify IO scheduler.
			 */
2404
			if (rq->rq_flags & RQF_SORTED)
2405 2406 2407 2408 2409 2410 2411
				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
			 */
2412
			rq->rq_flags |= RQF_STARTED;
2413 2414 2415 2416 2417 2418 2419 2420
			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;
		}

2421
		if (rq->rq_flags & RQF_DONTPREP)
2422 2423
			break;

2424
		if (q->dma_drain_size && blk_rq_bytes(rq)) {
2425 2426 2427 2428 2429 2430 2431 2432 2433 2434 2435 2436 2437 2438 2439 2440 2441 2442 2443
			/*
			 * 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
2444
			 * avoid resource deadlock.  RQF_STARTED will
2445 2446
			 * prevent other fs requests from passing this one.
			 */
2447
			if (q->dma_drain_size && blk_rq_bytes(rq) &&
2448
			    !(rq->rq_flags & RQF_DONTPREP)) {
2449 2450 2451 2452 2453 2454 2455 2456 2457
				/*
				 * remove the space for the drain we added
				 * so that we don't add it again
				 */
				--rq->nr_phys_segments;
			}

			rq = NULL;
			break;
2458 2459 2460
		} else if (ret == BLKPREP_KILL || ret == BLKPREP_INVALID) {
			int err = (ret == BLKPREP_INVALID) ? -EREMOTEIO : -EIO;

2461
			rq->rq_flags |= RQF_QUIET;
2462 2463 2464 2465 2466
			/*
			 * Mark this request as started so we don't trigger
			 * any debug logic in the end I/O path.
			 */
			blk_start_request(rq);
2467
			__blk_end_request_all(rq, err);
2468 2469 2470 2471 2472 2473 2474 2475
		} else {
			printk(KERN_ERR "%s: bad return=%d\n", __func__, ret);
			break;
		}
	}

	return rq;
}
2476
EXPORT_SYMBOL(blk_peek_request);
2477

2478
void blk_dequeue_request(struct request *rq)
2479
{
2480 2481
	struct request_queue *q = rq->q;

2482 2483 2484 2485 2486 2487 2488 2489 2490 2491
	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.
	 */
2492
	if (blk_account_rq(rq)) {
2493
		q->in_flight[rq_is_sync(rq)]++;
2494 2495
		set_io_start_time_ns(rq);
	}
2496 2497
}

2498 2499 2500 2501 2502 2503 2504 2505 2506 2507 2508 2509 2510 2511 2512 2513 2514 2515
/**
 * 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);

2516
	if (test_bit(QUEUE_FLAG_STATS, &req->q->queue_flags)) {
2517
		blk_stat_set_issue(&req->issue_stat, blk_rq_sectors(req));
2518
		req->rq_flags |= RQF_STATS;
J
Jens Axboe 已提交
2519
		wbt_issue(req->q->rq_wb, &req->issue_stat);
2520 2521
	}

2522
	BUG_ON(test_bit(REQ_ATOM_COMPLETE, &req->atomic_flags));
2523 2524 2525 2526 2527 2528 2529 2530 2531 2532 2533 2534 2535 2536 2537 2538 2539 2540 2541 2542 2543 2544 2545 2546 2547 2548 2549 2550 2551 2552
	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);

2553
/**
2554
 * blk_update_request - Special helper function for request stacking drivers
2555
 * @req:      the request being processed
2556
 * @error:    %0 for success, < %0 for error
2557
 * @nr_bytes: number of bytes to complete @req
2558 2559
 *
 * Description:
2560 2561 2562
 *     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.
2563 2564 2565 2566 2567 2568 2569
 *
 *     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.
2570 2571
 *
 * Return:
2572 2573
 *     %false - this request doesn't have any more data
 *     %true  - this request has more data
2574
 **/
2575
bool blk_update_request(struct request *req, int error, unsigned int nr_bytes)
L
Linus Torvalds 已提交
2576
{
2577
	int total_bytes;
L
Linus Torvalds 已提交
2578

2579
	trace_block_rq_complete(req, error, nr_bytes);
2580

2581 2582 2583
	if (!req->bio)
		return false;

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

L
Linus Torvalds 已提交
2617 2618
	}

2619
	blk_account_io_completion(req, nr_bytes);
2620

2621 2622 2623
	total_bytes = 0;
	while (req->bio) {
		struct bio *bio = req->bio;
2624
		unsigned bio_bytes = min(bio->bi_iter.bi_size, nr_bytes);
L
Linus Torvalds 已提交
2625

2626
		if (bio_bytes == bio->bi_iter.bi_size)
L
Linus Torvalds 已提交
2627 2628
			req->bio = bio->bi_next;

N
NeilBrown 已提交
2629 2630
		/* Completion has already been traced */
		bio_clear_flag(bio, BIO_TRACE_COMPLETION);
2631
		req_bio_endio(req, bio, bio_bytes, error);
L
Linus Torvalds 已提交
2632

2633 2634
		total_bytes += bio_bytes;
		nr_bytes -= bio_bytes;
L
Linus Torvalds 已提交
2635

2636 2637
		if (!nr_bytes)
			break;
L
Linus Torvalds 已提交
2638 2639 2640 2641 2642
	}

	/*
	 * completely done
	 */
2643 2644 2645 2646 2647 2648
	if (!req->bio) {
		/*
		 * Reset counters so that the request stacking driver
		 * can find how many bytes remain in the request
		 * later.
		 */
2649
		req->__data_len = 0;
2650 2651
		return false;
	}
L
Linus Torvalds 已提交
2652

2653 2654
	WARN_ON_ONCE(req->rq_flags & RQF_SPECIAL_PAYLOAD);

2655
	req->__data_len -= total_bytes;
2656 2657

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

2661
	/* mixed attributes always follow the first bio */
2662
	if (req->rq_flags & RQF_MIXED_MERGE) {
2663
		req->cmd_flags &= ~REQ_FAILFAST_MASK;
J
Jens Axboe 已提交
2664
		req->cmd_flags |= req->bio->bi_opf & REQ_FAILFAST_MASK;
2665 2666
	}

2667 2668 2669 2670 2671
	/*
	 * 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)) {
2672
		blk_dump_rq_flags(req, "request botched");
2673
		req->__data_len = blk_rq_cur_bytes(req);
2674 2675 2676
	}

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

2679
	return true;
L
Linus Torvalds 已提交
2680
}
2681
EXPORT_SYMBOL_GPL(blk_update_request);
L
Linus Torvalds 已提交
2682

2683 2684 2685
static bool blk_update_bidi_request(struct request *rq, int error,
				    unsigned int nr_bytes,
				    unsigned int bidi_bytes)
2686
{
2687 2688
	if (blk_update_request(rq, error, nr_bytes))
		return true;
2689

2690 2691 2692 2693
	/* 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;
2694

2695 2696
	if (blk_queue_add_random(rq->q))
		add_disk_randomness(rq->rq_disk);
2697 2698

	return false;
L
Linus Torvalds 已提交
2699 2700
}

2701 2702 2703 2704 2705 2706 2707 2708 2709 2710 2711 2712 2713 2714
/**
 * 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;

2715
	req->rq_flags &= ~RQF_DONTPREP;
2716 2717 2718 2719 2720
	if (q->unprep_rq_fn)
		q->unprep_rq_fn(q, req);
}
EXPORT_SYMBOL_GPL(blk_unprep_request);

L
Linus Torvalds 已提交
2721 2722 2723
/*
 * queue lock must be held
 */
2724
void blk_finish_request(struct request *req, int error)
L
Linus Torvalds 已提交
2725
{
2726 2727 2728
	struct request_queue *q = req->q;

	if (req->rq_flags & RQF_STATS)
2729
		blk_stat_add(req);
2730

2731
	if (req->rq_flags & RQF_QUEUED)
2732
		blk_queue_end_tag(q, req);
2733

2734
	BUG_ON(blk_queued_rq(req));
L
Linus Torvalds 已提交
2735

2736
	if (unlikely(laptop_mode) && !blk_rq_is_passthrough(req))
2737
		laptop_io_completion(req->q->backing_dev_info);
L
Linus Torvalds 已提交
2738

2739 2740
	blk_delete_timer(req);

2741
	if (req->rq_flags & RQF_DONTPREP)
2742 2743
		blk_unprep_request(req);

2744
	blk_account_io_done(req);
2745

J
Jens Axboe 已提交
2746 2747
	if (req->end_io) {
		wbt_done(req->q->rq_wb, &req->issue_stat);
2748
		req->end_io(req, error);
J
Jens Axboe 已提交
2749
	} else {
2750 2751 2752
		if (blk_bidi_rq(req))
			__blk_put_request(req->next_rq->q, req->next_rq);

2753
		__blk_put_request(q, req);
2754
	}
L
Linus Torvalds 已提交
2755
}
2756
EXPORT_SYMBOL(blk_finish_request);
L
Linus Torvalds 已提交
2757

2758
/**
2759 2760 2761 2762 2763
 * 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
2764 2765
 *
 * Description:
2766
 *     Ends I/O on a number of bytes attached to @rq and @rq->next_rq.
2767 2768 2769
 *     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.
2770 2771
 *
 * Return:
2772 2773
 *     %false - we are done with this request
 *     %true  - still buffers pending for this request
2774
 **/
2775
static bool blk_end_bidi_request(struct request *rq, int error,
K
Kiyoshi Ueda 已提交
2776 2777
				 unsigned int nr_bytes, unsigned int bidi_bytes)
{
2778
	struct request_queue *q = rq->q;
2779
	unsigned long flags;
K
Kiyoshi Ueda 已提交
2780

2781 2782
	if (blk_update_bidi_request(rq, error, nr_bytes, bidi_bytes))
		return true;
K
Kiyoshi Ueda 已提交
2783

2784
	spin_lock_irqsave(q->queue_lock, flags);
2785
	blk_finish_request(rq, error);
2786 2787
	spin_unlock_irqrestore(q->queue_lock, flags);

2788
	return false;
K
Kiyoshi Ueda 已提交
2789 2790
}

2791
/**
2792 2793
 * __blk_end_bidi_request - Complete a bidi request with queue lock held
 * @rq:         the request to complete
2794
 * @error:      %0 for success, < %0 for error
2795 2796
 * @nr_bytes:   number of bytes to complete @rq
 * @bidi_bytes: number of bytes to complete @rq->next_rq
2797 2798
 *
 * Description:
2799 2800
 *     Identical to blk_end_bidi_request() except that queue lock is
 *     assumed to be locked on entry and remains so on return.
2801 2802
 *
 * Return:
2803 2804
 *     %false - we are done with this request
 *     %true  - still buffers pending for this request
2805
 **/
2806
static bool __blk_end_bidi_request(struct request *rq, int error,
2807
				   unsigned int nr_bytes, unsigned int bidi_bytes)
2808
{
2809 2810
	if (blk_update_bidi_request(rq, error, nr_bytes, bidi_bytes))
		return true;
2811

2812
	blk_finish_request(rq, error);
2813

2814
	return false;
2815
}
2816 2817 2818 2819

/**
 * blk_end_request - Helper function for drivers to complete the request.
 * @rq:       the request being processed
2820
 * @error:    %0 for success, < %0 for error
2821 2822 2823 2824 2825 2826 2827
 * @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:
2828 2829
 *     %false - we are done with this request
 *     %true  - still buffers pending for this request
2830
 **/
2831
bool blk_end_request(struct request *rq, int error, unsigned int nr_bytes)
2832
{
2833
	return blk_end_bidi_request(rq, error, nr_bytes, 0);
2834
}
2835
EXPORT_SYMBOL(blk_end_request);
2836 2837

/**
2838 2839
 * blk_end_request_all - Helper function for drives to finish the request.
 * @rq: the request to finish
2840
 * @error: %0 for success, < %0 for error
2841 2842
 *
 * Description:
2843 2844 2845
 *     Completely finish @rq.
 */
void blk_end_request_all(struct request *rq, int error)
2846
{
2847 2848
	bool pending;
	unsigned int bidi_bytes = 0;
2849

2850 2851
	if (unlikely(blk_bidi_rq(rq)))
		bidi_bytes = blk_rq_bytes(rq->next_rq);
2852

2853 2854 2855
	pending = blk_end_bidi_request(rq, error, blk_rq_bytes(rq), bidi_bytes);
	BUG_ON(pending);
}
2856
EXPORT_SYMBOL(blk_end_request_all);
2857

2858
/**
2859 2860 2861 2862
 * __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
2863 2864
 *
 * Description:
2865
 *     Must be called with queue lock held unlike blk_end_request().
2866 2867
 *
 * Return:
2868 2869
 *     %false - we are done with this request
 *     %true  - still buffers pending for this request
2870
 **/
2871
bool __blk_end_request(struct request *rq, int error, unsigned int nr_bytes)
2872
{
2873
	return __blk_end_bidi_request(rq, error, nr_bytes, 0);
2874
}
2875
EXPORT_SYMBOL(__blk_end_request);
2876

K
Kiyoshi Ueda 已提交
2877
/**
2878 2879
 * __blk_end_request_all - Helper function for drives to finish the request.
 * @rq: the request to finish
2880
 * @error: %0 for success, < %0 for error
K
Kiyoshi Ueda 已提交
2881 2882
 *
 * Description:
2883
 *     Completely finish @rq.  Must be called with queue lock held.
K
Kiyoshi Ueda 已提交
2884
 */
2885
void __blk_end_request_all(struct request *rq, int error)
K
Kiyoshi Ueda 已提交
2886
{
2887 2888 2889 2890 2891 2892 2893 2894
	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 已提交
2895
}
2896
EXPORT_SYMBOL(__blk_end_request_all);
K
Kiyoshi Ueda 已提交
2897

2898
/**
2899 2900
 * __blk_end_request_cur - Helper function to finish the current request chunk.
 * @rq: the request to finish the current chunk for
2901
 * @error: %0 for success, < %0 for error
2902 2903
 *
 * Description:
2904 2905
 *     Complete the current consecutively mapped chunk from @rq.  Must
 *     be called with queue lock held.
2906 2907
 *
 * Return:
2908 2909 2910 2911
 *     %false - we are done with this request
 *     %true  - still buffers pending for this request
 */
bool __blk_end_request_cur(struct request *rq, int error)
2912
{
2913
	return __blk_end_request(rq, error, blk_rq_cur_bytes(rq));
2914
}
2915
EXPORT_SYMBOL(__blk_end_request_cur);
2916

J
Jens Axboe 已提交
2917 2918
void blk_rq_bio_prep(struct request_queue *q, struct request *rq,
		     struct bio *bio)
L
Linus Torvalds 已提交
2919
{
2920
	if (bio_has_data(bio))
D
David Woodhouse 已提交
2921
		rq->nr_phys_segments = bio_phys_segments(q, bio);
2922

2923
	rq->__data_len = bio->bi_iter.bi_size;
L
Linus Torvalds 已提交
2924 2925
	rq->bio = rq->biotail = bio;

N
NeilBrown 已提交
2926 2927 2928
	if (bio->bi_bdev)
		rq->rq_disk = bio->bi_bdev->bd_disk;
}
L
Linus Torvalds 已提交
2929

2930 2931 2932 2933 2934 2935 2936 2937 2938 2939 2940
#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;
2941
	struct bio_vec bvec;
2942 2943

	rq_for_each_segment(bvec, rq, iter)
2944
		flush_dcache_page(bvec.bv_page);
2945 2946 2947 2948
}
EXPORT_SYMBOL_GPL(rq_flush_dcache_pages);
#endif

2949 2950 2951 2952 2953 2954 2955 2956 2957 2958 2959 2960 2961 2962 2963 2964 2965 2966 2967 2968 2969 2970 2971 2972 2973 2974 2975 2976
/**
 * 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);

2977 2978 2979 2980 2981 2982 2983 2984 2985 2986 2987 2988 2989 2990 2991 2992 2993 2994 2995 2996 2997 2998 2999 3000
/**
 * 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)
3001 3002 3003 3004 3005 3006 3007
{
	dst->cpu = src->cpu;
	dst->__sector = blk_rq_pos(src);
	dst->__data_len = blk_rq_bytes(src);
	dst->nr_phys_segments = src->nr_phys_segments;
	dst->ioprio = src->ioprio;
	dst->extra_len = src->extra_len;
3008 3009 3010 3011 3012 3013 3014 3015 3016 3017 3018 3019 3020 3021 3022 3023 3024 3025 3026 3027 3028 3029 3030 3031 3032 3033 3034 3035 3036 3037 3038 3039 3040 3041 3042 3043 3044 3045 3046 3047 3048 3049 3050 3051 3052 3053 3054 3055 3056 3057 3058 3059 3060 3061 3062 3063
}

/**
 * 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;
3064 3065 3066
}
EXPORT_SYMBOL_GPL(blk_rq_prep_clone);

3067
int kblockd_schedule_work(struct work_struct *work)
L
Linus Torvalds 已提交
3068 3069 3070 3071 3072
{
	return queue_work(kblockd_workqueue, work);
}
EXPORT_SYMBOL(kblockd_schedule_work);

3073 3074 3075 3076 3077 3078
int kblockd_schedule_work_on(int cpu, struct work_struct *work)
{
	return queue_work_on(cpu, kblockd_workqueue, work);
}
EXPORT_SYMBOL(kblockd_schedule_work_on);

3079 3080
int kblockd_schedule_delayed_work(struct delayed_work *dwork,
				  unsigned long delay)
3081 3082 3083 3084 3085
{
	return queue_delayed_work(kblockd_workqueue, dwork, delay);
}
EXPORT_SYMBOL(kblockd_schedule_delayed_work);

3086 3087 3088 3089 3090 3091 3092
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 已提交
3093 3094 3095 3096 3097 3098 3099 3100 3101 3102 3103 3104 3105 3106
/**
 * 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.
 */
3107 3108 3109 3110
void blk_start_plug(struct blk_plug *plug)
{
	struct task_struct *tsk = current;

S
Shaohua Li 已提交
3111 3112 3113 3114 3115 3116
	/*
	 * If this is a nested plug, don't actually assign it.
	 */
	if (tsk->plug)
		return;

3117
	INIT_LIST_HEAD(&plug->list);
3118
	INIT_LIST_HEAD(&plug->mq_list);
3119
	INIT_LIST_HEAD(&plug->cb_list);
3120
	/*
S
Shaohua Li 已提交
3121 3122
	 * Store ordering should not be needed here, since a potential
	 * preempt will imply a full memory barrier
3123
	 */
S
Shaohua Li 已提交
3124
	tsk->plug = plug;
3125 3126 3127 3128 3129 3130 3131 3132
}
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);

3133 3134
	return !(rqa->q < rqb->q ||
		(rqa->q == rqb->q && blk_rq_pos(rqa) < blk_rq_pos(rqb)));
3135 3136
}

3137 3138 3139 3140 3141 3142
/*
 * 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.
 */
3143
static void queue_unplugged(struct request_queue *q, unsigned int depth,
3144
			    bool from_schedule)
3145
	__releases(q->queue_lock)
3146
{
3147
	trace_block_unplug(q, depth, !from_schedule);
3148

3149
	if (from_schedule)
3150
		blk_run_queue_async(q);
3151
	else
3152
		__blk_run_queue(q);
3153
	spin_unlock(q->queue_lock);
3154 3155
}

3156
static void flush_plug_callbacks(struct blk_plug *plug, bool from_schedule)
3157 3158 3159
{
	LIST_HEAD(callbacks);

S
Shaohua Li 已提交
3160 3161
	while (!list_empty(&plug->cb_list)) {
		list_splice_init(&plug->cb_list, &callbacks);
3162

S
Shaohua Li 已提交
3163 3164
		while (!list_empty(&callbacks)) {
			struct blk_plug_cb *cb = list_first_entry(&callbacks,
3165 3166
							  struct blk_plug_cb,
							  list);
S
Shaohua Li 已提交
3167
			list_del(&cb->list);
3168
			cb->callback(cb, from_schedule);
S
Shaohua Li 已提交
3169
		}
3170 3171 3172
	}
}

3173 3174 3175 3176 3177 3178 3179 3180 3181 3182 3183 3184 3185 3186 3187 3188 3189 3190 3191 3192 3193 3194 3195 3196 3197
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);

3198
void blk_flush_plug_list(struct blk_plug *plug, bool from_schedule)
3199 3200 3201 3202
{
	struct request_queue *q;
	unsigned long flags;
	struct request *rq;
3203
	LIST_HEAD(list);
3204
	unsigned int depth;
3205

3206
	flush_plug_callbacks(plug, from_schedule);
3207 3208 3209 3210

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

3211 3212 3213
	if (list_empty(&plug->list))
		return;

3214 3215
	list_splice_init(&plug->list, &list);

3216
	list_sort(NULL, &list, plug_rq_cmp);
3217 3218

	q = NULL;
3219
	depth = 0;
3220 3221 3222 3223 3224

	/*
	 * Save and disable interrupts here, to avoid doing it for every
	 * queue lock we have to take.
	 */
3225
	local_irq_save(flags);
3226 3227
	while (!list_empty(&list)) {
		rq = list_entry_rq(list.next);
3228 3229 3230
		list_del_init(&rq->queuelist);
		BUG_ON(!rq->q);
		if (rq->q != q) {
3231 3232 3233 3234
			/*
			 * This drops the queue lock
			 */
			if (q)
3235
				queue_unplugged(q, depth, from_schedule);
3236
			q = rq->q;
3237
			depth = 0;
3238 3239
			spin_lock(q->queue_lock);
		}
3240 3241 3242 3243

		/*
		 * Short-circuit if @q is dead
		 */
B
Bart Van Assche 已提交
3244
		if (unlikely(blk_queue_dying(q))) {
3245 3246 3247 3248
			__blk_end_request_all(rq, -ENODEV);
			continue;
		}

3249 3250 3251
		/*
		 * rq is already accounted, so use raw insert
		 */
3252
		if (op_is_flush(rq->cmd_flags))
3253 3254 3255
			__elv_add_request(q, rq, ELEVATOR_INSERT_FLUSH);
		else
			__elv_add_request(q, rq, ELEVATOR_INSERT_SORT_MERGE);
3256 3257

		depth++;
3258 3259
	}

3260 3261 3262 3263
	/*
	 * This drops the queue lock
	 */
	if (q)
3264
		queue_unplugged(q, depth, from_schedule);
3265 3266 3267 3268 3269 3270

	local_irq_restore(flags);
}

void blk_finish_plug(struct blk_plug *plug)
{
S
Shaohua Li 已提交
3271 3272
	if (plug != current->plug)
		return;
3273
	blk_flush_plug_list(plug, false);
3274

S
Shaohua Li 已提交
3275
	current->plug = NULL;
3276
}
3277
EXPORT_SYMBOL(blk_finish_plug);
3278

3279
#ifdef CONFIG_PM
L
Lin Ming 已提交
3280 3281 3282 3283 3284 3285 3286 3287 3288 3289 3290 3291 3292 3293 3294 3295 3296 3297 3298 3299 3300 3301 3302 3303 3304 3305 3306 3307 3308 3309 3310 3311 3312 3313 3314 3315 3316 3317 3318 3319 3320 3321 3322 3323 3324 3325 3326 3327 3328 3329 3330 3331 3332 3333 3334
/**
 * 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;

3335 3336 3337
	if (!q->dev)
		return ret;

L
Lin Ming 已提交
3338 3339 3340 3341 3342 3343 3344 3345 3346 3347 3348 3349 3350 3351 3352 3353 3354 3355 3356 3357 3358 3359 3360 3361 3362 3363 3364
	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)
{
3365 3366 3367
	if (!q->dev)
		return;

L
Lin Ming 已提交
3368 3369 3370 3371 3372 3373 3374 3375 3376 3377 3378 3379 3380 3381 3382 3383 3384 3385 3386 3387 3388 3389 3390 3391
	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)
{
3392 3393 3394
	if (!q->dev)
		return;

L
Lin Ming 已提交
3395 3396 3397 3398 3399 3400 3401 3402 3403 3404 3405 3406 3407 3408 3409 3410 3411 3412 3413 3414 3415 3416
	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)
{
3417 3418 3419
	if (!q->dev)
		return;

L
Lin Ming 已提交
3420 3421 3422 3423 3424
	spin_lock_irq(q->queue_lock);
	if (!err) {
		q->rpm_status = RPM_ACTIVE;
		__blk_run_queue(q);
		pm_runtime_mark_last_busy(q->dev);
3425
		pm_request_autosuspend(q->dev);
L
Lin Ming 已提交
3426 3427 3428 3429 3430 3431
	} else {
		q->rpm_status = RPM_SUSPENDED;
	}
	spin_unlock_irq(q->queue_lock);
}
EXPORT_SYMBOL(blk_post_runtime_resume);
3432 3433 3434 3435 3436 3437 3438 3439 3440 3441 3442 3443 3444 3445 3446 3447 3448 3449 3450 3451 3452 3453 3454 3455

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

L
Linus Torvalds 已提交
3458 3459
int __init blk_dev_init(void)
{
3460 3461
	BUILD_BUG_ON(REQ_OP_LAST >= (1 << REQ_OP_BITS));
	BUILD_BUG_ON(REQ_OP_BITS + REQ_FLAG_BITS > 8 *
3462
			FIELD_SIZEOF(struct request, cmd_flags));
3463 3464
	BUILD_BUG_ON(REQ_OP_BITS + REQ_FLAG_BITS > 8 *
			FIELD_SIZEOF(struct bio, bi_opf));
3465

3466 3467
	/* used for unplugging and affects IO latency/throughput - HIGHPRI */
	kblockd_workqueue = alloc_workqueue("kblockd",
3468
					    WQ_MEM_RECLAIM | WQ_HIGHPRI, 0);
L
Linus Torvalds 已提交
3469 3470 3471 3472
	if (!kblockd_workqueue)
		panic("Failed to create kblockd\n");

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

3475
	blk_requestq_cachep = kmem_cache_create("request_queue",
3476
			sizeof(struct request_queue), 0, SLAB_PANIC, NULL);
L
Linus Torvalds 已提交
3477

3478 3479 3480 3481
#ifdef CONFIG_DEBUG_FS
	blk_debugfs_root = debugfs_create_dir("block", NULL);
#endif

3482
	return 0;
L
Linus Torvalds 已提交
3483
}