blob: 4d9084a14c1093b1c00d79f079663a643c5d05fe [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
Linus Torvalds1da177e2005-04-16 15:20:36 -07002 * Block device elevator/IO-scheduler.
3 *
4 * Copyright (C) 2000 Andrea Arcangeli <andrea@suse.de> SuSE
5 *
Jens Axboe0fe23472006-09-04 15:41:16 +02006 * 30042000 Jens Axboe <axboe@kernel.dk> :
Linus Torvalds1da177e2005-04-16 15:20:36 -07007 *
8 * Split the elevator a bit so that it is possible to choose a different
9 * one or even write a new "plug in". There are three pieces:
10 * - elevator_fn, inserts a new request in the queue list
11 * - elevator_merge_fn, decides whether a new buffer can be merged with
12 * an existing request
13 * - elevator_dequeue_fn, called when a request is taken off the active list
14 *
15 * 20082000 Dave Jones <davej@suse.de> :
16 * Removed tests for max-bomb-segments, which was breaking elvtune
17 * when run without -bN
18 *
19 * Jens:
20 * - Rework again to work with bio instead of buffer_heads
21 * - loose bi_dev comparisons, partition handling is right now
22 * - completely modularize elevator setup and teardown
23 *
24 */
25#include <linux/kernel.h>
26#include <linux/fs.h>
27#include <linux/blkdev.h>
28#include <linux/elevator.h>
29#include <linux/bio.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070030#include <linux/module.h>
31#include <linux/slab.h>
32#include <linux/init.h>
33#include <linux/compiler.h>
Jens Axboe2056a782006-03-23 20:00:26 +010034#include <linux/blktrace_api.h>
Jens Axboe98170642006-07-28 09:23:08 +020035#include <linux/hash.h>
Jens Axboe0835da62008-08-26 09:15:47 +020036#include <linux/uaccess.h>
Lin Mingc8158812013-03-23 11:42:27 +080037#include <linux/pm_runtime.h>
Tejun Heoeea8f412015-05-22 17:13:17 -040038#include <linux/blk-cgroup.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070039
Li Zefan55782132009-06-09 13:43:05 +080040#include <trace/events/block.h>
41
Jens Axboe242f9dc2008-09-14 05:55:09 -070042#include "blk.h"
Jens Axboebd166ef2017-01-17 06:03:22 -070043#include "blk-mq-sched.h"
Jens Axboe242f9dc2008-09-14 05:55:09 -070044
Linus Torvalds1da177e2005-04-16 15:20:36 -070045static DEFINE_SPINLOCK(elv_list_lock);
46static LIST_HEAD(elv_list);
47
48/*
Jens Axboe98170642006-07-28 09:23:08 +020049 * Merge hash stuff.
50 */
Tejun Heo83096eb2009-05-07 22:24:39 +090051#define rq_hash_key(rq) (blk_rq_pos(rq) + blk_rq_sectors(rq))
Jens Axboe98170642006-07-28 09:23:08 +020052
53/*
Jens Axboeda775262006-12-20 11:04:12 +010054 * Query io scheduler to see if the current process issuing bio may be
55 * merged with rq.
56 */
Tahsin Erdogan72ef7992016-07-07 11:48:22 -070057static int elv_iosched_allow_bio_merge(struct request *rq, struct bio *bio)
Jens Axboeda775262006-12-20 11:04:12 +010058{
Jens Axboe165125e2007-07-24 09:28:11 +020059 struct request_queue *q = rq->q;
Jens Axboeb374d182008-10-31 10:05:07 +010060 struct elevator_queue *e = q->elevator;
Jens Axboeda775262006-12-20 11:04:12 +010061
Jens Axboebd166ef2017-01-17 06:03:22 -070062 if (e->uses_mq && e->type->ops.mq.allow_merge)
63 return e->type->ops.mq.allow_merge(q, rq, bio);
64 else if (!e->uses_mq && e->type->ops.sq.elevator_allow_bio_merge_fn)
Jens Axboec51ca6c2016-12-10 15:13:59 -070065 return e->type->ops.sq.elevator_allow_bio_merge_fn(q, rq, bio);
Jens Axboeda775262006-12-20 11:04:12 +010066
67 return 1;
68}
69
70/*
Linus Torvalds1da177e2005-04-16 15:20:36 -070071 * can we safely merge with this request?
72 */
Tahsin Erdogan72ef7992016-07-07 11:48:22 -070073bool elv_bio_merge_ok(struct request *rq, struct bio *bio)
Linus Torvalds1da177e2005-04-16 15:20:36 -070074{
Tejun Heo050c8ea2012-02-08 09:19:38 +010075 if (!blk_rq_merge_ok(rq, bio))
Tahsin Erdogan72ef7992016-07-07 11:48:22 -070076 return false;
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +020077
Tahsin Erdogan72ef7992016-07-07 11:48:22 -070078 if (!elv_iosched_allow_bio_merge(rq, bio))
79 return false;
Jens Axboeda775262006-12-20 11:04:12 +010080
Tahsin Erdogan72ef7992016-07-07 11:48:22 -070081 return true;
Linus Torvalds1da177e2005-04-16 15:20:36 -070082}
Tahsin Erdogan72ef7992016-07-07 11:48:22 -070083EXPORT_SYMBOL(elv_bio_merge_ok);
Linus Torvalds1da177e2005-04-16 15:20:36 -070084
Linus Torvalds1da177e2005-04-16 15:20:36 -070085static struct elevator_type *elevator_find(const char *name)
86{
Vasily Tarasova22b1692006-10-11 09:24:27 +020087 struct elevator_type *e;
Linus Torvalds1da177e2005-04-16 15:20:36 -070088
Matthias Kaehlcke70cee262007-07-10 12:26:24 +020089 list_for_each_entry(e, &elv_list, list) {
Vasily Tarasova22b1692006-10-11 09:24:27 +020090 if (!strcmp(e->elevator_name, name))
91 return e;
Linus Torvalds1da177e2005-04-16 15:20:36 -070092 }
Linus Torvalds1da177e2005-04-16 15:20:36 -070093
Vasily Tarasova22b1692006-10-11 09:24:27 +020094 return NULL;
Linus Torvalds1da177e2005-04-16 15:20:36 -070095}
96
97static void elevator_put(struct elevator_type *e)
98{
99 module_put(e->elevator_owner);
100}
101
Tejun Heo21c3c5d2013-01-22 16:48:03 -0800102static struct elevator_type *elevator_get(const char *name, bool try_loading)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700103{
Tejun Heo2824bc932005-10-20 10:56:41 +0200104 struct elevator_type *e;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700105
Jens Axboe2a12dcd2007-04-26 14:41:53 +0200106 spin_lock(&elv_list_lock);
Tejun Heo2824bc932005-10-20 10:56:41 +0200107
108 e = elevator_find(name);
Tejun Heo21c3c5d2013-01-22 16:48:03 -0800109 if (!e && try_loading) {
Jens Axboee1640942008-02-19 10:20:37 +0100110 spin_unlock(&elv_list_lock);
Kees Cook490b94b2011-05-05 18:02:12 -0600111 request_module("%s-iosched", name);
Jens Axboee1640942008-02-19 10:20:37 +0100112 spin_lock(&elv_list_lock);
113 e = elevator_find(name);
114 }
115
Tejun Heo2824bc932005-10-20 10:56:41 +0200116 if (e && !try_module_get(e->elevator_owner))
117 e = NULL;
118
Jens Axboe2a12dcd2007-04-26 14:41:53 +0200119 spin_unlock(&elv_list_lock);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700120
121 return e;
122}
123
Wang Sheng-Hui484fc252011-09-08 12:32:14 +0200124static char chosen_elevator[ELV_NAME_MAX];
Linus Torvalds1da177e2005-04-16 15:20:36 -0700125
Nate Diller5f003972006-01-24 10:07:58 +0100126static int __init elevator_setup(char *str)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700127{
Chuck Ebbert752a3b72006-01-16 09:47:37 +0100128 /*
129 * Be backwards-compatible with previous kernels, so users
130 * won't get the wrong elevator.
131 */
Jens Axboe492af632009-10-03 09:37:51 +0200132 strncpy(chosen_elevator, str, sizeof(chosen_elevator) - 1);
OGAWA Hirofumi9b410462006-03-31 02:30:33 -0800133 return 1;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700134}
135
136__setup("elevator=", elevator_setup);
137
Tejun Heobb813f42013-01-18 14:05:56 -0800138/* called during boot to load the elevator chosen by the elevator param */
139void __init load_default_elevator_module(void)
140{
141 struct elevator_type *e;
142
143 if (!chosen_elevator[0])
144 return;
145
146 spin_lock(&elv_list_lock);
147 e = elevator_find(chosen_elevator);
148 spin_unlock(&elv_list_lock);
149
150 if (!e)
151 request_module("%s-iosched", chosen_elevator);
152}
153
Al Viro3d1ab402006-03-18 18:35:43 -0500154static struct kobj_type elv_ktype;
155
Jianpeng Mad50235b2013-07-03 13:25:24 +0200156struct elevator_queue *elevator_alloc(struct request_queue *q,
Jens Axboe165125e2007-07-24 09:28:11 +0200157 struct elevator_type *e)
Al Viro3d1ab402006-03-18 18:35:43 -0500158{
Jens Axboeb374d182008-10-31 10:05:07 +0100159 struct elevator_queue *eq;
Jens Axboe98170642006-07-28 09:23:08 +0200160
Joe Perchesc1b511e2013-08-29 15:21:42 -0700161 eq = kzalloc_node(sizeof(*eq), GFP_KERNEL, q->node);
Jens Axboe98170642006-07-28 09:23:08 +0200162 if (unlikely(!eq))
Chao Yu8406a4d2015-04-23 10:47:44 -0600163 return NULL;
Jens Axboe98170642006-07-28 09:23:08 +0200164
Tejun Heo22f746e2011-12-14 00:33:41 +0100165 eq->type = e;
Greg Kroah-Hartmanf9cb0742007-12-17 23:05:35 -0700166 kobject_init(&eq->kobj, &elv_ktype);
Jens Axboe98170642006-07-28 09:23:08 +0200167 mutex_init(&eq->sysfs_lock);
Sasha Levin242d98f2012-12-17 10:01:27 -0500168 hash_init(eq->hash);
Jens Axboebd166ef2017-01-17 06:03:22 -0700169 eq->uses_mq = e->uses_mq;
Jens Axboe98170642006-07-28 09:23:08 +0200170
Al Viro3d1ab402006-03-18 18:35:43 -0500171 return eq;
172}
Jianpeng Mad50235b2013-07-03 13:25:24 +0200173EXPORT_SYMBOL(elevator_alloc);
Al Viro3d1ab402006-03-18 18:35:43 -0500174
175static void elevator_release(struct kobject *kobj)
176{
Jens Axboeb374d182008-10-31 10:05:07 +0100177 struct elevator_queue *e;
Jens Axboe98170642006-07-28 09:23:08 +0200178
Jens Axboeb374d182008-10-31 10:05:07 +0100179 e = container_of(kobj, struct elevator_queue, kobj);
Tejun Heo22f746e2011-12-14 00:33:41 +0100180 elevator_put(e->type);
Al Viro3d1ab402006-03-18 18:35:43 -0500181 kfree(e);
182}
183
Jens Axboe165125e2007-07-24 09:28:11 +0200184int elevator_init(struct request_queue *q, char *name)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700185{
186 struct elevator_type *e = NULL;
Tejun Heof8fc8772011-12-14 00:33:40 +0100187 int err;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700188
Tomoki Sekiyamaeb1c1602013-10-15 16:42:16 -0600189 /*
190 * q->sysfs_lock must be held to provide mutual exclusion between
191 * elevator_switch() and here.
192 */
193 lockdep_assert_held(&q->sysfs_lock);
194
Mike Snitzer1abec4f2010-05-25 13:15:15 -0400195 if (unlikely(q->elevator))
196 return 0;
197
Tejun Heocb98fc82005-10-28 08:29:39 +0200198 INIT_LIST_HEAD(&q->queue_head);
199 q->last_merge = NULL;
200 q->end_sector = 0;
201 q->boundary_rq = NULL;
Tejun Heocb98fc82005-10-28 08:29:39 +0200202
Jens Axboe4eb166d2008-02-01 00:37:27 +0100203 if (name) {
Tejun Heo21c3c5d2013-01-22 16:48:03 -0800204 e = elevator_get(name, true);
Jens Axboe4eb166d2008-02-01 00:37:27 +0100205 if (!e)
206 return -EINVAL;
207 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700208
Tejun Heo21c3c5d2013-01-22 16:48:03 -0800209 /*
Jens Axboed1a987f2017-02-14 08:16:41 -0700210 * Use the default elevator specified by config boot param for
211 * non-mq devices, or by config option. Don't try to load modules
212 * as we could be running off async and request_module() isn't
213 * allowed from async.
Tejun Heo21c3c5d2013-01-22 16:48:03 -0800214 */
Jens Axboed1a987f2017-02-14 08:16:41 -0700215 if (!e && !q->mq_ops && *chosen_elevator) {
Tejun Heo21c3c5d2013-01-22 16:48:03 -0800216 e = elevator_get(chosen_elevator, false);
Jens Axboe4eb166d2008-02-01 00:37:27 +0100217 if (!e)
218 printk(KERN_ERR "I/O scheduler %s not found\n",
219 chosen_elevator);
220 }
Nate Diller248d5ca2006-01-24 10:09:14 +0100221
Jens Axboe4eb166d2008-02-01 00:37:27 +0100222 if (!e) {
Jens Axboeb86dd812017-02-22 13:19:45 -0700223 /*
224 * For blk-mq devices, we default to using mq-deadline,
225 * if available, for single queue devices. If deadline
226 * isn't available OR we have multiple queues, default
227 * to "none".
228 */
229 if (q->mq_ops) {
230 if (q->nr_hw_queues == 1)
231 e = elevator_get("mq-deadline", false);
232 if (!e)
233 return 0;
234 } else
Jens Axboed3484992017-01-13 14:43:58 -0700235 e = elevator_get(CONFIG_DEFAULT_IOSCHED, false);
236
Jens Axboe4eb166d2008-02-01 00:37:27 +0100237 if (!e) {
238 printk(KERN_ERR
239 "Default I/O scheduler not found. " \
Jens Axboeb86dd812017-02-22 13:19:45 -0700240 "Using noop.\n");
Tejun Heo21c3c5d2013-01-22 16:48:03 -0800241 e = elevator_get("noop", false);
Jens Axboe4eb166d2008-02-01 00:37:27 +0100242 }
Nate Diller5f003972006-01-24 10:07:58 +0100243 }
244
Omar Sandoval6917ff02017-04-05 12:01:30 -0700245 if (e->uses_mq)
246 err = blk_mq_init_sched(q, e);
247 else
Jens Axboebd166ef2017-01-17 06:03:22 -0700248 err = e->ops.sq.elevator_init_fn(q, e);
Omar Sandoval6917ff02017-04-05 12:01:30 -0700249 if (err)
Sudip Mukherjeed32f6b52014-10-23 22:16:48 +0530250 elevator_put(e);
251 return err;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700252}
Jens Axboe2e662b62006-07-13 11:55:04 +0200253EXPORT_SYMBOL(elevator_init);
254
Omar Sandoval54d53292017-04-07 08:52:27 -0600255void elevator_exit(struct request_queue *q, struct elevator_queue *e)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700256{
Al Viro3d1ab402006-03-18 18:35:43 -0500257 mutex_lock(&e->sysfs_lock);
Jens Axboebd166ef2017-01-17 06:03:22 -0700258 if (e->uses_mq && e->type->ops.mq.exit_sched)
Omar Sandoval54d53292017-04-07 08:52:27 -0600259 blk_mq_exit_sched(q, e);
Jens Axboebd166ef2017-01-17 06:03:22 -0700260 else if (!e->uses_mq && e->type->ops.sq.elevator_exit_fn)
Jens Axboec51ca6c2016-12-10 15:13:59 -0700261 e->type->ops.sq.elevator_exit_fn(e);
Al Viro3d1ab402006-03-18 18:35:43 -0500262 mutex_unlock(&e->sysfs_lock);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700263
Al Viro3d1ab402006-03-18 18:35:43 -0500264 kobject_put(&e->kobj);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700265}
Jens Axboe2e662b62006-07-13 11:55:04 +0200266EXPORT_SYMBOL(elevator_exit);
267
Jens Axboe98170642006-07-28 09:23:08 +0200268static inline void __elv_rqhash_del(struct request *rq)
269{
Sasha Levin242d98f2012-12-17 10:01:27 -0500270 hash_del(&rq->hash);
Christoph Hellwige8064022016-10-20 15:12:13 +0200271 rq->rq_flags &= ~RQF_HASHED;
Jens Axboe98170642006-07-28 09:23:08 +0200272}
273
Jens Axboe70b3ea02016-12-07 08:43:31 -0700274void elv_rqhash_del(struct request_queue *q, struct request *rq)
Jens Axboe98170642006-07-28 09:23:08 +0200275{
276 if (ELV_ON_HASH(rq))
277 __elv_rqhash_del(rq);
278}
Jens Axboebd166ef2017-01-17 06:03:22 -0700279EXPORT_SYMBOL_GPL(elv_rqhash_del);
Jens Axboe98170642006-07-28 09:23:08 +0200280
Jens Axboe70b3ea02016-12-07 08:43:31 -0700281void elv_rqhash_add(struct request_queue *q, struct request *rq)
Jens Axboe98170642006-07-28 09:23:08 +0200282{
Jens Axboeb374d182008-10-31 10:05:07 +0100283 struct elevator_queue *e = q->elevator;
Jens Axboe98170642006-07-28 09:23:08 +0200284
285 BUG_ON(ELV_ON_HASH(rq));
Sasha Levin242d98f2012-12-17 10:01:27 -0500286 hash_add(e->hash, &rq->hash, rq_hash_key(rq));
Christoph Hellwige8064022016-10-20 15:12:13 +0200287 rq->rq_flags |= RQF_HASHED;
Jens Axboe98170642006-07-28 09:23:08 +0200288}
Jens Axboebd166ef2017-01-17 06:03:22 -0700289EXPORT_SYMBOL_GPL(elv_rqhash_add);
Jens Axboe98170642006-07-28 09:23:08 +0200290
Jens Axboe70b3ea02016-12-07 08:43:31 -0700291void elv_rqhash_reposition(struct request_queue *q, struct request *rq)
Jens Axboe98170642006-07-28 09:23:08 +0200292{
293 __elv_rqhash_del(rq);
294 elv_rqhash_add(q, rq);
295}
296
Jens Axboe70b3ea02016-12-07 08:43:31 -0700297struct request *elv_rqhash_find(struct request_queue *q, sector_t offset)
Jens Axboe98170642006-07-28 09:23:08 +0200298{
Jens Axboeb374d182008-10-31 10:05:07 +0100299 struct elevator_queue *e = q->elevator;
Sasha Levinb67bfe02013-02-27 17:06:00 -0800300 struct hlist_node *next;
Jens Axboe98170642006-07-28 09:23:08 +0200301 struct request *rq;
302
Linus Torvaldsee89f812013-02-28 12:52:24 -0800303 hash_for_each_possible_safe(e->hash, rq, next, hash, offset) {
Jens Axboe98170642006-07-28 09:23:08 +0200304 BUG_ON(!ELV_ON_HASH(rq));
305
306 if (unlikely(!rq_mergeable(rq))) {
307 __elv_rqhash_del(rq);
308 continue;
309 }
310
311 if (rq_hash_key(rq) == offset)
312 return rq;
313 }
314
315 return NULL;
316}
317
Tejun Heo8922e162005-10-20 16:23:44 +0200318/*
Jens Axboe2e662b62006-07-13 11:55:04 +0200319 * RB-tree support functions for inserting/lookup/removal of requests
320 * in a sorted RB tree.
321 */
Jeff Moyer796d5112011-06-02 21:19:05 +0200322void elv_rb_add(struct rb_root *root, struct request *rq)
Jens Axboe2e662b62006-07-13 11:55:04 +0200323{
324 struct rb_node **p = &root->rb_node;
325 struct rb_node *parent = NULL;
326 struct request *__rq;
327
328 while (*p) {
329 parent = *p;
330 __rq = rb_entry(parent, struct request, rb_node);
331
Tejun Heo83096eb2009-05-07 22:24:39 +0900332 if (blk_rq_pos(rq) < blk_rq_pos(__rq))
Jens Axboe2e662b62006-07-13 11:55:04 +0200333 p = &(*p)->rb_left;
Jeff Moyer796d5112011-06-02 21:19:05 +0200334 else if (blk_rq_pos(rq) >= blk_rq_pos(__rq))
Jens Axboe2e662b62006-07-13 11:55:04 +0200335 p = &(*p)->rb_right;
Jens Axboe2e662b62006-07-13 11:55:04 +0200336 }
337
338 rb_link_node(&rq->rb_node, parent, p);
339 rb_insert_color(&rq->rb_node, root);
Jens Axboe2e662b62006-07-13 11:55:04 +0200340}
Jens Axboe2e662b62006-07-13 11:55:04 +0200341EXPORT_SYMBOL(elv_rb_add);
342
343void elv_rb_del(struct rb_root *root, struct request *rq)
344{
345 BUG_ON(RB_EMPTY_NODE(&rq->rb_node));
346 rb_erase(&rq->rb_node, root);
347 RB_CLEAR_NODE(&rq->rb_node);
348}
Jens Axboe2e662b62006-07-13 11:55:04 +0200349EXPORT_SYMBOL(elv_rb_del);
350
351struct request *elv_rb_find(struct rb_root *root, sector_t sector)
352{
353 struct rb_node *n = root->rb_node;
354 struct request *rq;
355
356 while (n) {
357 rq = rb_entry(n, struct request, rb_node);
358
Tejun Heo83096eb2009-05-07 22:24:39 +0900359 if (sector < blk_rq_pos(rq))
Jens Axboe2e662b62006-07-13 11:55:04 +0200360 n = n->rb_left;
Tejun Heo83096eb2009-05-07 22:24:39 +0900361 else if (sector > blk_rq_pos(rq))
Jens Axboe2e662b62006-07-13 11:55:04 +0200362 n = n->rb_right;
363 else
364 return rq;
365 }
366
367 return NULL;
368}
Jens Axboe2e662b62006-07-13 11:55:04 +0200369EXPORT_SYMBOL(elv_rb_find);
370
371/*
Tejun Heo8922e162005-10-20 16:23:44 +0200372 * Insert rq into dispatch queue of q. Queue lock must be held on
Uwe Kleine-Königdbe7f762007-10-20 01:55:04 +0200373 * entry. rq is sort instead into the dispatch queue. To be used by
Jens Axboe2e662b62006-07-13 11:55:04 +0200374 * specific elevators.
Tejun Heo8922e162005-10-20 16:23:44 +0200375 */
Jens Axboe165125e2007-07-24 09:28:11 +0200376void elv_dispatch_sort(struct request_queue *q, struct request *rq)
Tejun Heo8922e162005-10-20 16:23:44 +0200377{
378 sector_t boundary;
Tejun Heo8922e162005-10-20 16:23:44 +0200379 struct list_head *entry;
380
Tejun Heo06b86242005-10-20 16:46:23 +0200381 if (q->last_merge == rq)
382 q->last_merge = NULL;
Jens Axboe98170642006-07-28 09:23:08 +0200383
384 elv_rqhash_del(q, rq);
385
Tejun Heo15853af2005-11-10 08:52:05 +0100386 q->nr_sorted--;
Tejun Heo06b86242005-10-20 16:46:23 +0200387
Jens Axboe1b47f532005-10-20 16:37:00 +0200388 boundary = q->end_sector;
Tejun Heo8922e162005-10-20 16:23:44 +0200389 list_for_each_prev(entry, &q->queue_head) {
390 struct request *pos = list_entry_rq(entry);
391
Adrian Hunter7afafc82016-08-16 10:59:35 +0300392 if (req_op(rq) != req_op(pos))
David Woodhousee17fc0a2008-08-09 16:42:20 +0100393 break;
Jens Axboe783660b2007-01-19 11:27:47 +1100394 if (rq_data_dir(rq) != rq_data_dir(pos))
395 break;
Christoph Hellwige8064022016-10-20 15:12:13 +0200396 if (pos->rq_flags & (RQF_STARTED | RQF_SOFTBARRIER))
Tejun Heo8922e162005-10-20 16:23:44 +0200397 break;
Tejun Heo83096eb2009-05-07 22:24:39 +0900398 if (blk_rq_pos(rq) >= boundary) {
399 if (blk_rq_pos(pos) < boundary)
Tejun Heo8922e162005-10-20 16:23:44 +0200400 continue;
401 } else {
Tejun Heo83096eb2009-05-07 22:24:39 +0900402 if (blk_rq_pos(pos) >= boundary)
Tejun Heo8922e162005-10-20 16:23:44 +0200403 break;
404 }
Tejun Heo83096eb2009-05-07 22:24:39 +0900405 if (blk_rq_pos(rq) >= blk_rq_pos(pos))
Tejun Heo8922e162005-10-20 16:23:44 +0200406 break;
407 }
408
409 list_add(&rq->queuelist, entry);
410}
Jens Axboe2e662b62006-07-13 11:55:04 +0200411EXPORT_SYMBOL(elv_dispatch_sort);
412
Jens Axboe98170642006-07-28 09:23:08 +0200413/*
Jens Axboe2e662b62006-07-13 11:55:04 +0200414 * Insert rq into dispatch queue of q. Queue lock must be held on
415 * entry. rq is added to the back of the dispatch queue. To be used by
416 * specific elevators.
Jens Axboe98170642006-07-28 09:23:08 +0200417 */
418void elv_dispatch_add_tail(struct request_queue *q, struct request *rq)
419{
420 if (q->last_merge == rq)
421 q->last_merge = NULL;
422
423 elv_rqhash_del(q, rq);
424
425 q->nr_sorted--;
426
427 q->end_sector = rq_end_sector(rq);
428 q->boundary_rq = rq;
429 list_add_tail(&rq->queuelist, &q->queue_head);
430}
Jens Axboe2e662b62006-07-13 11:55:04 +0200431EXPORT_SYMBOL(elv_dispatch_add_tail);
432
Christoph Hellwig34fe7c02017-02-08 14:46:48 +0100433enum elv_merge elv_merge(struct request_queue *q, struct request **req,
434 struct bio *bio)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700435{
Jens Axboeb374d182008-10-31 10:05:07 +0100436 struct elevator_queue *e = q->elevator;
Jens Axboe98170642006-07-28 09:23:08 +0200437 struct request *__rq;
Tejun Heo06b86242005-10-20 16:46:23 +0200438
Jens Axboe98170642006-07-28 09:23:08 +0200439 /*
Alan D. Brunelle488991e2010-01-29 09:04:08 +0100440 * Levels of merges:
441 * nomerges: No merges at all attempted
442 * noxmerges: Only simple one-hit cache try
443 * merges: All merge tries attempted
444 */
Ming Lei7460d382015-10-20 23:13:55 +0800445 if (blk_queue_nomerges(q) || !bio_mergeable(bio))
Alan D. Brunelle488991e2010-01-29 09:04:08 +0100446 return ELEVATOR_NO_MERGE;
447
448 /*
Jens Axboe98170642006-07-28 09:23:08 +0200449 * First try one-hit cache.
450 */
Tahsin Erdogan72ef7992016-07-07 11:48:22 -0700451 if (q->last_merge && elv_bio_merge_ok(q->last_merge, bio)) {
Christoph Hellwig34fe7c02017-02-08 14:46:48 +0100452 enum elv_merge ret = blk_try_merge(q->last_merge, bio);
453
Tejun Heo06b86242005-10-20 16:46:23 +0200454 if (ret != ELEVATOR_NO_MERGE) {
455 *req = q->last_merge;
456 return ret;
457 }
458 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700459
Alan D. Brunelle488991e2010-01-29 09:04:08 +0100460 if (blk_queue_noxmerges(q))
Alan D. Brunelleac9fafa2008-04-29 14:44:19 +0200461 return ELEVATOR_NO_MERGE;
462
Jens Axboe98170642006-07-28 09:23:08 +0200463 /*
464 * See if our hash lookup can find a potential backmerge.
465 */
Kent Overstreet4f024f32013-10-11 15:44:27 -0700466 __rq = elv_rqhash_find(q, bio->bi_iter.bi_sector);
Tahsin Erdogan72ef7992016-07-07 11:48:22 -0700467 if (__rq && elv_bio_merge_ok(__rq, bio)) {
Jens Axboe98170642006-07-28 09:23:08 +0200468 *req = __rq;
469 return ELEVATOR_BACK_MERGE;
470 }
471
Jens Axboebd166ef2017-01-17 06:03:22 -0700472 if (e->uses_mq && e->type->ops.mq.request_merge)
473 return e->type->ops.mq.request_merge(q, req, bio);
474 else if (!e->uses_mq && e->type->ops.sq.elevator_merge_fn)
Jens Axboec51ca6c2016-12-10 15:13:59 -0700475 return e->type->ops.sq.elevator_merge_fn(q, req, bio);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700476
477 return ELEVATOR_NO_MERGE;
478}
479
Jens Axboe5e84ea32011-03-21 10:14:27 +0100480/*
481 * Attempt to do an insertion back merge. Only check for the case where
482 * we can append 'rq' to an existing request, so we can throw 'rq' away
483 * afterwards.
484 *
485 * Returns true if we merged, false otherwise
486 */
Jens Axboebd166ef2017-01-17 06:03:22 -0700487bool elv_attempt_insert_merge(struct request_queue *q, struct request *rq)
Jens Axboe5e84ea32011-03-21 10:14:27 +0100488{
489 struct request *__rq;
Shaohua Libee03932012-11-09 08:44:27 +0100490 bool ret;
Jens Axboe5e84ea32011-03-21 10:14:27 +0100491
492 if (blk_queue_nomerges(q))
493 return false;
494
495 /*
496 * First try one-hit cache.
497 */
498 if (q->last_merge && blk_attempt_req_merge(q, q->last_merge, rq))
499 return true;
500
501 if (blk_queue_noxmerges(q))
502 return false;
503
Shaohua Libee03932012-11-09 08:44:27 +0100504 ret = false;
Jens Axboe5e84ea32011-03-21 10:14:27 +0100505 /*
506 * See if our hash lookup can find a potential backmerge.
507 */
Shaohua Libee03932012-11-09 08:44:27 +0100508 while (1) {
509 __rq = elv_rqhash_find(q, blk_rq_pos(rq));
510 if (!__rq || !blk_attempt_req_merge(q, __rq, rq))
511 break;
Jens Axboe5e84ea32011-03-21 10:14:27 +0100512
Shaohua Libee03932012-11-09 08:44:27 +0100513 /* The merged request could be merged with others, try again */
514 ret = true;
515 rq = __rq;
516 }
517
518 return ret;
Jens Axboe5e84ea32011-03-21 10:14:27 +0100519}
520
Christoph Hellwig34fe7c02017-02-08 14:46:48 +0100521void elv_merged_request(struct request_queue *q, struct request *rq,
522 enum elv_merge type)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700523{
Jens Axboeb374d182008-10-31 10:05:07 +0100524 struct elevator_queue *e = q->elevator;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700525
Jens Axboebd166ef2017-01-17 06:03:22 -0700526 if (e->uses_mq && e->type->ops.mq.request_merged)
527 e->type->ops.mq.request_merged(q, rq, type);
528 else if (!e->uses_mq && e->type->ops.sq.elevator_merged_fn)
Jens Axboec51ca6c2016-12-10 15:13:59 -0700529 e->type->ops.sq.elevator_merged_fn(q, rq, type);
Tejun Heo06b86242005-10-20 16:46:23 +0200530
Jens Axboe2e662b62006-07-13 11:55:04 +0200531 if (type == ELEVATOR_BACK_MERGE)
532 elv_rqhash_reposition(q, rq);
Jens Axboe98170642006-07-28 09:23:08 +0200533
Tejun Heo06b86242005-10-20 16:46:23 +0200534 q->last_merge = rq;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700535}
536
Jens Axboe165125e2007-07-24 09:28:11 +0200537void elv_merge_requests(struct request_queue *q, struct request *rq,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700538 struct request *next)
539{
Jens Axboeb374d182008-10-31 10:05:07 +0100540 struct elevator_queue *e = q->elevator;
Jens Axboebd166ef2017-01-17 06:03:22 -0700541 bool next_sorted = false;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700542
Jens Axboebd166ef2017-01-17 06:03:22 -0700543 if (e->uses_mq && e->type->ops.mq.requests_merged)
544 e->type->ops.mq.requests_merged(q, rq, next);
545 else if (e->type->ops.sq.elevator_merge_req_fn) {
Bart Van Asschea1ae0f72017-02-01 12:22:23 -0700546 next_sorted = (__force bool)(next->rq_flags & RQF_SORTED);
Jens Axboebd166ef2017-01-17 06:03:22 -0700547 if (next_sorted)
548 e->type->ops.sq.elevator_merge_req_fn(q, rq, next);
549 }
Tejun Heo06b86242005-10-20 16:46:23 +0200550
Jens Axboe98170642006-07-28 09:23:08 +0200551 elv_rqhash_reposition(q, rq);
Jens Axboe98170642006-07-28 09:23:08 +0200552
Jens Axboe5e84ea32011-03-21 10:14:27 +0100553 if (next_sorted) {
554 elv_rqhash_del(q, next);
555 q->nr_sorted--;
556 }
557
Tejun Heo06b86242005-10-20 16:46:23 +0200558 q->last_merge = rq;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700559}
560
Divyesh Shah812d4022010-04-08 21:14:23 -0700561void elv_bio_merged(struct request_queue *q, struct request *rq,
562 struct bio *bio)
563{
564 struct elevator_queue *e = q->elevator;
565
Jens Axboebd166ef2017-01-17 06:03:22 -0700566 if (WARN_ON_ONCE(e->uses_mq))
567 return;
568
Jens Axboec51ca6c2016-12-10 15:13:59 -0700569 if (e->type->ops.sq.elevator_bio_merged_fn)
570 e->type->ops.sq.elevator_bio_merged_fn(q, rq, bio);
Divyesh Shah812d4022010-04-08 21:14:23 -0700571}
572
Rafael J. Wysocki47fafbc2014-12-04 01:00:23 +0100573#ifdef CONFIG_PM
Lin Mingc8158812013-03-23 11:42:27 +0800574static void blk_pm_requeue_request(struct request *rq)
575{
Christoph Hellwige8064022016-10-20 15:12:13 +0200576 if (rq->q->dev && !(rq->rq_flags & RQF_PM))
Lin Mingc8158812013-03-23 11:42:27 +0800577 rq->q->nr_pending--;
578}
579
580static void blk_pm_add_request(struct request_queue *q, struct request *rq)
581{
Christoph Hellwige8064022016-10-20 15:12:13 +0200582 if (q->dev && !(rq->rq_flags & RQF_PM) && q->nr_pending++ == 0 &&
Lin Mingc8158812013-03-23 11:42:27 +0800583 (q->rpm_status == RPM_SUSPENDED || q->rpm_status == RPM_SUSPENDING))
584 pm_request_resume(q->dev);
585}
586#else
587static inline void blk_pm_requeue_request(struct request *rq) {}
588static inline void blk_pm_add_request(struct request_queue *q,
589 struct request *rq)
590{
591}
592#endif
593
Jens Axboe165125e2007-07-24 09:28:11 +0200594void elv_requeue_request(struct request_queue *q, struct request *rq)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700595{
Linus Torvalds1da177e2005-04-16 15:20:36 -0700596 /*
597 * it already went through dequeue, we need to decrement the
598 * in_flight count again
599 */
Tejun Heo8922e162005-10-20 16:23:44 +0200600 if (blk_account_rq(rq)) {
Jens Axboe0a7ae2f2009-05-20 08:54:31 +0200601 q->in_flight[rq_is_sync(rq)]--;
Christoph Hellwige8064022016-10-20 15:12:13 +0200602 if (rq->rq_flags & RQF_SORTED)
Jens Axboecad97512007-01-14 22:26:09 +1100603 elv_deactivate_rq(q, rq);
Tejun Heo8922e162005-10-20 16:23:44 +0200604 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700605
Christoph Hellwige8064022016-10-20 15:12:13 +0200606 rq->rq_flags &= ~RQF_STARTED;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700607
Lin Mingc8158812013-03-23 11:42:27 +0800608 blk_pm_requeue_request(rq);
609
Jens Axboeb710a482011-03-30 09:52:30 +0200610 __elv_add_request(q, rq, ELEVATOR_INSERT_REQUEUE);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700611}
612
Jerome Marchand26308ea2009-03-27 10:31:51 +0100613void elv_drain_elevator(struct request_queue *q)
Tejun Heo15853af2005-11-10 08:52:05 +0100614{
Jens Axboebd166ef2017-01-17 06:03:22 -0700615 struct elevator_queue *e = q->elevator;
Tejun Heo15853af2005-11-10 08:52:05 +0100616 static int printed;
Tejun Heoe3c78ca2011-10-19 14:32:38 +0200617
Jens Axboebd166ef2017-01-17 06:03:22 -0700618 if (WARN_ON_ONCE(e->uses_mq))
619 return;
620
Tejun Heoe3c78ca2011-10-19 14:32:38 +0200621 lockdep_assert_held(q->queue_lock);
622
Jens Axboebd166ef2017-01-17 06:03:22 -0700623 while (e->type->ops.sq.elevator_dispatch_fn(q, 1))
Tejun Heo15853af2005-11-10 08:52:05 +0100624 ;
Tejun Heoe3c78ca2011-10-19 14:32:38 +0200625 if (q->nr_sorted && printed++ < 10) {
Tejun Heo15853af2005-11-10 08:52:05 +0100626 printk(KERN_ERR "%s: forced dispatching is broken "
627 "(nr_sorted=%u), please report this\n",
Tejun Heo22f746e2011-12-14 00:33:41 +0100628 q->elevator->type->elevator_name, q->nr_sorted);
Tejun Heo15853af2005-11-10 08:52:05 +0100629 }
630}
631
Jens Axboeb710a482011-03-30 09:52:30 +0200632void __elv_add_request(struct request_queue *q, struct request *rq, int where)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700633{
Arnaldo Carvalho de Melo5f3ea372008-10-30 08:34:33 +0100634 trace_block_rq_insert(q, rq);
Jens Axboe2056a782006-03-23 20:00:26 +0100635
Lin Mingc8158812013-03-23 11:42:27 +0800636 blk_pm_add_request(q, rq);
637
Linus Torvalds1da177e2005-04-16 15:20:36 -0700638 rq->q = q;
639
Christoph Hellwige8064022016-10-20 15:12:13 +0200640 if (rq->rq_flags & RQF_SOFTBARRIER) {
Jens Axboeb710a482011-03-30 09:52:30 +0200641 /* barriers are scheduling boundary, update end_sector */
Christoph Hellwig57292b52017-01-31 16:57:29 +0100642 if (!blk_rq_is_passthrough(rq)) {
Jens Axboeb710a482011-03-30 09:52:30 +0200643 q->end_sector = rq_end_sector(rq);
644 q->boundary_rq = rq;
645 }
Christoph Hellwige8064022016-10-20 15:12:13 +0200646 } else if (!(rq->rq_flags & RQF_ELVPRIV) &&
Jens Axboe3aa72872011-04-21 19:28:35 +0200647 (where == ELEVATOR_INSERT_SORT ||
648 where == ELEVATOR_INSERT_SORT_MERGE))
Jens Axboeb710a482011-03-30 09:52:30 +0200649 where = ELEVATOR_INSERT_BACK;
650
Tejun Heo8922e162005-10-20 16:23:44 +0200651 switch (where) {
Tejun Heo28e7d182010-09-03 11:56:16 +0200652 case ELEVATOR_INSERT_REQUEUE:
Tejun Heo8922e162005-10-20 16:23:44 +0200653 case ELEVATOR_INSERT_FRONT:
Christoph Hellwige8064022016-10-20 15:12:13 +0200654 rq->rq_flags |= RQF_SOFTBARRIER;
Tejun Heo8922e162005-10-20 16:23:44 +0200655 list_add(&rq->queuelist, &q->queue_head);
656 break;
657
658 case ELEVATOR_INSERT_BACK:
Christoph Hellwige8064022016-10-20 15:12:13 +0200659 rq->rq_flags |= RQF_SOFTBARRIER;
Tejun Heo15853af2005-11-10 08:52:05 +0100660 elv_drain_elevator(q);
Tejun Heo8922e162005-10-20 16:23:44 +0200661 list_add_tail(&rq->queuelist, &q->queue_head);
662 /*
663 * We kick the queue here for the following reasons.
664 * - The elevator might have returned NULL previously
665 * to delay requests and returned them now. As the
666 * queue wasn't empty before this request, ll_rw_blk
667 * won't run the queue on return, resulting in hang.
668 * - Usually, back inserted requests won't be merged
669 * with anything. There's no point in delaying queue
670 * processing.
671 */
Christoph Hellwig24ecfbe2011-04-18 11:41:33 +0200672 __blk_run_queue(q);
Tejun Heo8922e162005-10-20 16:23:44 +0200673 break;
674
Jens Axboe5e84ea32011-03-21 10:14:27 +0100675 case ELEVATOR_INSERT_SORT_MERGE:
676 /*
677 * If we succeed in merging this request with one in the
678 * queue already, we are done - rq has now been freed,
679 * so no need to do anything further.
680 */
681 if (elv_attempt_insert_merge(q, rq))
682 break;
Tejun Heo8922e162005-10-20 16:23:44 +0200683 case ELEVATOR_INSERT_SORT:
Christoph Hellwig57292b52017-01-31 16:57:29 +0100684 BUG_ON(blk_rq_is_passthrough(rq));
Christoph Hellwige8064022016-10-20 15:12:13 +0200685 rq->rq_flags |= RQF_SORTED;
Tejun Heo15853af2005-11-10 08:52:05 +0100686 q->nr_sorted++;
Jens Axboe98170642006-07-28 09:23:08 +0200687 if (rq_mergeable(rq)) {
688 elv_rqhash_add(q, rq);
689 if (!q->last_merge)
690 q->last_merge = rq;
691 }
692
Tejun Heoca235092005-11-01 17:23:49 +0900693 /*
694 * Some ioscheds (cfq) run q->request_fn directly, so
695 * rq cannot be accessed after calling
696 * elevator_add_req_fn.
697 */
Jens Axboec51ca6c2016-12-10 15:13:59 -0700698 q->elevator->type->ops.sq.elevator_add_req_fn(q, rq);
Tejun Heo8922e162005-10-20 16:23:44 +0200699 break;
700
Tejun Heoae1b1532011-01-25 12:43:54 +0100701 case ELEVATOR_INSERT_FLUSH:
Christoph Hellwige8064022016-10-20 15:12:13 +0200702 rq->rq_flags |= RQF_SOFTBARRIER;
Tejun Heoae1b1532011-01-25 12:43:54 +0100703 blk_insert_flush(rq);
704 break;
Tejun Heo8922e162005-10-20 16:23:44 +0200705 default:
706 printk(KERN_ERR "%s: bad insertion point %d\n",
Harvey Harrison24c03d42008-05-01 04:35:17 -0700707 __func__, where);
Tejun Heo8922e162005-10-20 16:23:44 +0200708 BUG();
709 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700710}
Jens Axboe2e662b62006-07-13 11:55:04 +0200711EXPORT_SYMBOL(__elv_add_request);
712
Jens Axboe7eaceac2011-03-10 08:52:07 +0100713void elv_add_request(struct request_queue *q, struct request *rq, int where)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700714{
715 unsigned long flags;
716
717 spin_lock_irqsave(q->queue_lock, flags);
Jens Axboe7eaceac2011-03-10 08:52:07 +0100718 __elv_add_request(q, rq, where);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700719 spin_unlock_irqrestore(q->queue_lock, flags);
720}
Jens Axboe2e662b62006-07-13 11:55:04 +0200721EXPORT_SYMBOL(elv_add_request);
722
Jens Axboe165125e2007-07-24 09:28:11 +0200723struct request *elv_latter_request(struct request_queue *q, struct request *rq)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700724{
Jens Axboeb374d182008-10-31 10:05:07 +0100725 struct elevator_queue *e = q->elevator;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700726
Jens Axboebd166ef2017-01-17 06:03:22 -0700727 if (e->uses_mq && e->type->ops.mq.next_request)
728 return e->type->ops.mq.next_request(q, rq);
729 else if (!e->uses_mq && e->type->ops.sq.elevator_latter_req_fn)
Jens Axboec51ca6c2016-12-10 15:13:59 -0700730 return e->type->ops.sq.elevator_latter_req_fn(q, rq);
Jens Axboebd166ef2017-01-17 06:03:22 -0700731
Linus Torvalds1da177e2005-04-16 15:20:36 -0700732 return NULL;
733}
734
Jens Axboe165125e2007-07-24 09:28:11 +0200735struct request *elv_former_request(struct request_queue *q, struct request *rq)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700736{
Jens Axboeb374d182008-10-31 10:05:07 +0100737 struct elevator_queue *e = q->elevator;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700738
Jens Axboebd166ef2017-01-17 06:03:22 -0700739 if (e->uses_mq && e->type->ops.mq.former_request)
740 return e->type->ops.mq.former_request(q, rq);
741 if (!e->uses_mq && e->type->ops.sq.elevator_former_req_fn)
Jens Axboec51ca6c2016-12-10 15:13:59 -0700742 return e->type->ops.sq.elevator_former_req_fn(q, rq);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700743 return NULL;
744}
745
Tejun Heo852c7882012-03-05 13:15:27 -0800746int elv_set_request(struct request_queue *q, struct request *rq,
747 struct bio *bio, gfp_t gfp_mask)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700748{
Jens Axboeb374d182008-10-31 10:05:07 +0100749 struct elevator_queue *e = q->elevator;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700750
Jens Axboebd166ef2017-01-17 06:03:22 -0700751 if (WARN_ON_ONCE(e->uses_mq))
752 return 0;
753
Jens Axboec51ca6c2016-12-10 15:13:59 -0700754 if (e->type->ops.sq.elevator_set_req_fn)
755 return e->type->ops.sq.elevator_set_req_fn(q, rq, bio, gfp_mask);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700756 return 0;
757}
758
Jens Axboe165125e2007-07-24 09:28:11 +0200759void elv_put_request(struct request_queue *q, struct request *rq)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700760{
Jens Axboeb374d182008-10-31 10:05:07 +0100761 struct elevator_queue *e = q->elevator;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700762
Jens Axboebd166ef2017-01-17 06:03:22 -0700763 if (WARN_ON_ONCE(e->uses_mq))
764 return;
765
Jens Axboec51ca6c2016-12-10 15:13:59 -0700766 if (e->type->ops.sq.elevator_put_req_fn)
767 e->type->ops.sq.elevator_put_req_fn(rq);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700768}
769
Christoph Hellwigef295ec2016-10-28 08:48:16 -0600770int elv_may_queue(struct request_queue *q, unsigned int op)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700771{
Jens Axboeb374d182008-10-31 10:05:07 +0100772 struct elevator_queue *e = q->elevator;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700773
Jens Axboebd166ef2017-01-17 06:03:22 -0700774 if (WARN_ON_ONCE(e->uses_mq))
775 return 0;
776
Jens Axboec51ca6c2016-12-10 15:13:59 -0700777 if (e->type->ops.sq.elevator_may_queue_fn)
778 return e->type->ops.sq.elevator_may_queue_fn(q, op);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700779
780 return ELV_MQUEUE_MAY;
781}
782
Jens Axboe165125e2007-07-24 09:28:11 +0200783void elv_completed_request(struct request_queue *q, struct request *rq)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700784{
Jens Axboeb374d182008-10-31 10:05:07 +0100785 struct elevator_queue *e = q->elevator;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700786
Jens Axboebd166ef2017-01-17 06:03:22 -0700787 if (WARN_ON_ONCE(e->uses_mq))
788 return;
789
Linus Torvalds1da177e2005-04-16 15:20:36 -0700790 /*
791 * request is released from the driver, io must be done
792 */
Tejun Heo8922e162005-10-20 16:23:44 +0200793 if (blk_account_rq(rq)) {
Jens Axboe0a7ae2f2009-05-20 08:54:31 +0200794 q->in_flight[rq_is_sync(rq)]--;
Christoph Hellwige8064022016-10-20 15:12:13 +0200795 if ((rq->rq_flags & RQF_SORTED) &&
Jens Axboec51ca6c2016-12-10 15:13:59 -0700796 e->type->ops.sq.elevator_completed_req_fn)
797 e->type->ops.sq.elevator_completed_req_fn(q, rq);
Tejun Heo1bc691d2006-01-12 15:39:26 +0100798 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700799}
800
Al Viro3d1ab402006-03-18 18:35:43 -0500801#define to_elv(atr) container_of((atr), struct elv_fs_entry, attr)
802
803static ssize_t
804elv_attr_show(struct kobject *kobj, struct attribute *attr, char *page)
805{
Al Viro3d1ab402006-03-18 18:35:43 -0500806 struct elv_fs_entry *entry = to_elv(attr);
Jens Axboeb374d182008-10-31 10:05:07 +0100807 struct elevator_queue *e;
Al Viro3d1ab402006-03-18 18:35:43 -0500808 ssize_t error;
809
810 if (!entry->show)
811 return -EIO;
812
Jens Axboeb374d182008-10-31 10:05:07 +0100813 e = container_of(kobj, struct elevator_queue, kobj);
Al Viro3d1ab402006-03-18 18:35:43 -0500814 mutex_lock(&e->sysfs_lock);
Tejun Heo22f746e2011-12-14 00:33:41 +0100815 error = e->type ? entry->show(e, page) : -ENOENT;
Al Viro3d1ab402006-03-18 18:35:43 -0500816 mutex_unlock(&e->sysfs_lock);
817 return error;
818}
819
820static ssize_t
821elv_attr_store(struct kobject *kobj, struct attribute *attr,
822 const char *page, size_t length)
823{
Al Viro3d1ab402006-03-18 18:35:43 -0500824 struct elv_fs_entry *entry = to_elv(attr);
Jens Axboeb374d182008-10-31 10:05:07 +0100825 struct elevator_queue *e;
Al Viro3d1ab402006-03-18 18:35:43 -0500826 ssize_t error;
827
828 if (!entry->store)
829 return -EIO;
830
Jens Axboeb374d182008-10-31 10:05:07 +0100831 e = container_of(kobj, struct elevator_queue, kobj);
Al Viro3d1ab402006-03-18 18:35:43 -0500832 mutex_lock(&e->sysfs_lock);
Tejun Heo22f746e2011-12-14 00:33:41 +0100833 error = e->type ? entry->store(e, page, length) : -ENOENT;
Al Viro3d1ab402006-03-18 18:35:43 -0500834 mutex_unlock(&e->sysfs_lock);
835 return error;
836}
837
Emese Revfy52cf25d2010-01-19 02:58:23 +0100838static const struct sysfs_ops elv_sysfs_ops = {
Al Viro3d1ab402006-03-18 18:35:43 -0500839 .show = elv_attr_show,
840 .store = elv_attr_store,
841};
842
843static struct kobj_type elv_ktype = {
844 .sysfs_ops = &elv_sysfs_ops,
845 .release = elevator_release,
846};
847
Tejun Heo5a5bafd2012-03-05 13:14:56 -0800848int elv_register_queue(struct request_queue *q)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700849{
Tejun Heo5a5bafd2012-03-05 13:14:56 -0800850 struct elevator_queue *e = q->elevator;
Al Viro3d1ab402006-03-18 18:35:43 -0500851 int error;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700852
Greg Kroah-Hartmanb2d6db52007-12-17 23:05:35 -0700853 error = kobject_add(&e->kobj, &q->kobj, "%s", "iosched");
Al Viro3d1ab402006-03-18 18:35:43 -0500854 if (!error) {
Tejun Heo22f746e2011-12-14 00:33:41 +0100855 struct elv_fs_entry *attr = e->type->elevator_attrs;
Al Viro3d1ab402006-03-18 18:35:43 -0500856 if (attr) {
Al Viroe572ec72006-03-18 22:27:18 -0500857 while (attr->attr.name) {
858 if (sysfs_create_file(&e->kobj, &attr->attr))
Al Viro3d1ab402006-03-18 18:35:43 -0500859 break;
Al Viroe572ec72006-03-18 22:27:18 -0500860 attr++;
Al Viro3d1ab402006-03-18 18:35:43 -0500861 }
862 }
863 kobject_uevent(&e->kobj, KOBJ_ADD);
Jens Axboe430c62f2010-10-07 09:35:16 +0200864 e->registered = 1;
Jens Axboebd166ef2017-01-17 06:03:22 -0700865 if (!e->uses_mq && e->type->ops.sq.elevator_registered_fn)
Jens Axboec51ca6c2016-12-10 15:13:59 -0700866 e->type->ops.sq.elevator_registered_fn(q);
Al Viro3d1ab402006-03-18 18:35:43 -0500867 }
868 return error;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700869}
Tejun Heof8fc8772011-12-14 00:33:40 +0100870EXPORT_SYMBOL(elv_register_queue);
Jens Axboebc1c1162006-06-08 08:49:06 +0200871
Linus Torvalds1da177e2005-04-16 15:20:36 -0700872void elv_unregister_queue(struct request_queue *q)
873{
Tejun Heof8fc8772011-12-14 00:33:40 +0100874 if (q) {
875 struct elevator_queue *e = q->elevator;
876
877 kobject_uevent(&e->kobj, KOBJ_REMOVE);
878 kobject_del(&e->kobj);
879 e->registered = 0;
880 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700881}
Mike Snitzer01effb02010-05-11 08:57:42 +0200882EXPORT_SYMBOL(elv_unregister_queue);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700883
Jens Axboee567bf72014-06-22 16:32:48 -0600884int elv_register(struct elevator_type *e)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700885{
Thibaut VARENE1ffb96c2007-03-15 12:59:19 +0100886 char *def = "";
Jens Axboe2a12dcd2007-04-26 14:41:53 +0200887
Tejun Heo3d3c2372011-12-14 00:33:42 +0100888 /* create icq_cache if requested */
889 if (e->icq_size) {
890 if (WARN_ON(e->icq_size < sizeof(struct io_cq)) ||
891 WARN_ON(e->icq_align < __alignof__(struct io_cq)))
892 return -EINVAL;
893
894 snprintf(e->icq_cache_name, sizeof(e->icq_cache_name),
895 "%s_io_cq", e->elevator_name);
896 e->icq_cache = kmem_cache_create(e->icq_cache_name, e->icq_size,
897 e->icq_align, 0, NULL);
898 if (!e->icq_cache)
899 return -ENOMEM;
900 }
901
902 /* register, don't allow duplicate names */
Jens Axboe2a12dcd2007-04-26 14:41:53 +0200903 spin_lock(&elv_list_lock);
Tejun Heo3d3c2372011-12-14 00:33:42 +0100904 if (elevator_find(e->elevator_name)) {
905 spin_unlock(&elv_list_lock);
906 if (e->icq_cache)
907 kmem_cache_destroy(e->icq_cache);
908 return -EBUSY;
909 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700910 list_add_tail(&e->list, &elv_list);
Jens Axboe2a12dcd2007-04-26 14:41:53 +0200911 spin_unlock(&elv_list_lock);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700912
Tejun Heo3d3c2372011-12-14 00:33:42 +0100913 /* print pretty message */
Nate Diller5f003972006-01-24 10:07:58 +0100914 if (!strcmp(e->elevator_name, chosen_elevator) ||
915 (!*chosen_elevator &&
916 !strcmp(e->elevator_name, CONFIG_DEFAULT_IOSCHED)))
Thibaut VARENE1ffb96c2007-03-15 12:59:19 +0100917 def = " (default)";
918
Jens Axboe4eb166d2008-02-01 00:37:27 +0100919 printk(KERN_INFO "io scheduler %s registered%s\n", e->elevator_name,
920 def);
Tejun Heo3d3c2372011-12-14 00:33:42 +0100921 return 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700922}
923EXPORT_SYMBOL_GPL(elv_register);
924
925void elv_unregister(struct elevator_type *e)
926{
Tejun Heo3d3c2372011-12-14 00:33:42 +0100927 /* unregister */
Jens Axboe2a12dcd2007-04-26 14:41:53 +0200928 spin_lock(&elv_list_lock);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700929 list_del_init(&e->list);
Jens Axboe2a12dcd2007-04-26 14:41:53 +0200930 spin_unlock(&elv_list_lock);
Tejun Heo3d3c2372011-12-14 00:33:42 +0100931
932 /*
933 * Destroy icq_cache if it exists. icq's are RCU managed. Make
934 * sure all RCU operations are complete before proceeding.
935 */
936 if (e->icq_cache) {
937 rcu_barrier();
938 kmem_cache_destroy(e->icq_cache);
939 e->icq_cache = NULL;
940 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700941}
942EXPORT_SYMBOL_GPL(elv_unregister);
943
Omar Sandoval54d53292017-04-07 08:52:27 -0600944static int elevator_switch_mq(struct request_queue *q,
945 struct elevator_type *new_e)
946{
947 int ret;
948
949 blk_mq_freeze_queue(q);
950 blk_mq_quiesce_queue(q);
951
952 if (q->elevator) {
953 if (q->elevator->registered)
954 elv_unregister_queue(q);
955 ioc_clear_queue(q);
956 elevator_exit(q, q->elevator);
957 }
958
959 ret = blk_mq_init_sched(q, new_e);
960 if (ret)
961 goto out;
962
963 if (new_e) {
964 ret = elv_register_queue(q);
965 if (ret) {
966 elevator_exit(q, q->elevator);
967 goto out;
968 }
969 }
970
971 if (new_e)
972 blk_add_trace_msg(q, "elv switch: %s", new_e->elevator_name);
973 else
974 blk_add_trace_msg(q, "elv switch: none");
975
976out:
977 blk_mq_unfreeze_queue(q);
978 blk_mq_start_stopped_hw_queues(q, true);
979 return ret;
980
981}
982
Linus Torvalds1da177e2005-04-16 15:20:36 -0700983/*
984 * switch to new_e io scheduler. be careful not to introduce deadlocks -
985 * we don't free the old io scheduler, before we have allocated what we
986 * need for the new one. this way we have a chance of going back to the old
Tejun Heocb98fc82005-10-28 08:29:39 +0200987 * one, if the new one fails init for some reason.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700988 */
Jens Axboe165125e2007-07-24 09:28:11 +0200989static int elevator_switch(struct request_queue *q, struct elevator_type *new_e)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700990{
Tejun Heo5a5bafd2012-03-05 13:14:56 -0800991 struct elevator_queue *old = q->elevator;
Jens Axboebd166ef2017-01-17 06:03:22 -0700992 bool old_registered = false;
Tejun Heoe8989fa2012-03-05 13:15:20 -0800993 int err;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700994
Omar Sandoval54d53292017-04-07 08:52:27 -0600995 if (q->mq_ops)
996 return elevator_switch_mq(q, new_e);
Jens Axboebd166ef2017-01-17 06:03:22 -0700997
Tejun Heo5a5bafd2012-03-05 13:14:56 -0800998 /*
999 * Turn on BYPASS and drain all requests w/ elevator private data.
1000 * Block layer doesn't call into a quiesced elevator - all requests
1001 * are directly put on the dispatch list without elevator data
1002 * using INSERT_BACK. All requests have SOFTBARRIER set and no
1003 * merge happens either.
1004 */
Jens Axboebd166ef2017-01-17 06:03:22 -07001005 if (old) {
1006 old_registered = old->registered;
Tejun Heocb98fc82005-10-28 08:29:39 +02001007
Omar Sandoval54d53292017-04-07 08:52:27 -06001008 blk_queue_bypass_start(q);
Jens Axboebd166ef2017-01-17 06:03:22 -07001009
1010 /* unregister and clear all auxiliary data of the old elevator */
1011 if (old_registered)
1012 elv_unregister_queue(q);
1013
Jens Axboebd166ef2017-01-17 06:03:22 -07001014 ioc_clear_queue(q);
Jens Axboebd166ef2017-01-17 06:03:22 -07001015 }
Tejun Heo5a5bafd2012-03-05 13:14:56 -08001016
1017 /* allocate, init and register new elevator */
Omar Sandoval54d53292017-04-07 08:52:27 -06001018 err = new_e->ops.sq.elevator_init_fn(q, new_e);
Omar Sandoval6917ff02017-04-05 12:01:30 -07001019 if (err)
1020 goto fail_init;
Tejun Heo5a5bafd2012-03-05 13:14:56 -08001021
Omar Sandoval54d53292017-04-07 08:52:27 -06001022 err = elv_register_queue(q);
1023 if (err)
1024 goto fail_register;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001025
Tejun Heo5a5bafd2012-03-05 13:14:56 -08001026 /* done, kill the old one and finish */
Jens Axboebd166ef2017-01-17 06:03:22 -07001027 if (old) {
Omar Sandoval54d53292017-04-07 08:52:27 -06001028 elevator_exit(q, old);
1029 blk_queue_bypass_end(q);
Jens Axboebd166ef2017-01-17 06:03:22 -07001030 }
Nick Piggin75ad23b2008-04-29 14:48:33 +02001031
Omar Sandoval54d53292017-04-07 08:52:27 -06001032 blk_add_trace_msg(q, "elv switch: %s", new_e->elevator_name);
Alan D. Brunelle4722dc52008-05-27 14:55:00 +02001033
Jens Axboe5dd531a2010-08-23 13:52:19 +02001034 return 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001035
1036fail_register:
Omar Sandoval54d53292017-04-07 08:52:27 -06001037 elevator_exit(q, q->elevator);
Tejun Heo5a5bafd2012-03-05 13:14:56 -08001038fail_init:
1039 /* switch failed, restore and re-register old elevator */
Jens Axboebd166ef2017-01-17 06:03:22 -07001040 if (old) {
1041 q->elevator = old;
1042 elv_register_queue(q);
Omar Sandoval54d53292017-04-07 08:52:27 -06001043 blk_queue_bypass_end(q);
Jens Axboebd166ef2017-01-17 06:03:22 -07001044 }
Nick Piggin75ad23b2008-04-29 14:48:33 +02001045
Jens Axboe5dd531a2010-08-23 13:52:19 +02001046 return err;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001047}
1048
Jens Axboe5dd531a2010-08-23 13:52:19 +02001049/*
1050 * Switch this queue to the given IO scheduler.
1051 */
Tomoki Sekiyama7c8a3672013-10-15 16:42:19 -06001052static int __elevator_change(struct request_queue *q, const char *name)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001053{
1054 char elevator_name[ELV_NAME_MAX];
1055 struct elevator_type *e;
1056
Jens Axboebd166ef2017-01-17 06:03:22 -07001057 /*
1058 * Special case for mq, turn off scheduling
1059 */
1060 if (q->mq_ops && !strncmp(name, "none", 4))
1061 return elevator_switch(q, NULL);
Martin K. Petersencd43e262009-05-22 17:17:52 -04001062
Li Zefanee2e9922008-10-14 08:49:56 +02001063 strlcpy(elevator_name, name, sizeof(elevator_name));
Tejun Heo21c3c5d2013-01-22 16:48:03 -08001064 e = elevator_get(strstrip(elevator_name), true);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001065 if (!e) {
1066 printk(KERN_ERR "elevator: type %s not found\n", elevator_name);
1067 return -EINVAL;
1068 }
1069
Jens Axboebd166ef2017-01-17 06:03:22 -07001070 if (q->elevator &&
1071 !strcmp(elevator_name, q->elevator->type->elevator_name)) {
Nate Diller2ca7d932005-10-30 15:02:24 -08001072 elevator_put(e);
Jens Axboe5dd531a2010-08-23 13:52:19 +02001073 return 0;
Nate Diller2ca7d932005-10-30 15:02:24 -08001074 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001075
Jens Axboebd166ef2017-01-17 06:03:22 -07001076 if (!e->uses_mq && q->mq_ops) {
1077 elevator_put(e);
1078 return -EINVAL;
1079 }
1080 if (e->uses_mq && !q->mq_ops) {
1081 elevator_put(e);
1082 return -EINVAL;
1083 }
1084
Jens Axboe5dd531a2010-08-23 13:52:19 +02001085 return elevator_switch(q, e);
1086}
Tomoki Sekiyama7c8a3672013-10-15 16:42:19 -06001087
1088int elevator_change(struct request_queue *q, const char *name)
1089{
1090 int ret;
1091
1092 /* Protect q->elevator from elevator_init() */
1093 mutex_lock(&q->sysfs_lock);
1094 ret = __elevator_change(q, name);
1095 mutex_unlock(&q->sysfs_lock);
1096
1097 return ret;
1098}
Jens Axboe5dd531a2010-08-23 13:52:19 +02001099EXPORT_SYMBOL(elevator_change);
1100
Ming Lei3a5088c2017-04-15 20:38:22 +08001101static inline bool elv_support_iosched(struct request_queue *q)
1102{
1103 if (q->mq_ops && q->tag_set && (q->tag_set->flags &
1104 BLK_MQ_F_NO_SCHED))
1105 return false;
1106 return true;
1107}
1108
Jens Axboe5dd531a2010-08-23 13:52:19 +02001109ssize_t elv_iosched_store(struct request_queue *q, const char *name,
1110 size_t count)
1111{
1112 int ret;
1113
Ming Lei3a5088c2017-04-15 20:38:22 +08001114 if (!(q->mq_ops || q->request_fn) || !elv_support_iosched(q))
Jens Axboe5dd531a2010-08-23 13:52:19 +02001115 return count;
1116
Tomoki Sekiyama7c8a3672013-10-15 16:42:19 -06001117 ret = __elevator_change(q, name);
Jens Axboe5dd531a2010-08-23 13:52:19 +02001118 if (!ret)
1119 return count;
1120
1121 printk(KERN_ERR "elevator: switch to %s failed\n", name);
1122 return ret;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001123}
1124
Jens Axboe165125e2007-07-24 09:28:11 +02001125ssize_t elv_iosched_show(struct request_queue *q, char *name)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001126{
Jens Axboeb374d182008-10-31 10:05:07 +01001127 struct elevator_queue *e = q->elevator;
Jens Axboebd166ef2017-01-17 06:03:22 -07001128 struct elevator_type *elv = NULL;
Matthias Kaehlcke70cee262007-07-10 12:26:24 +02001129 struct elevator_type *__e;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001130 int len = 0;
1131
Jens Axboebd166ef2017-01-17 06:03:22 -07001132 if (!blk_queue_stackable(q))
Martin K. Petersencd43e262009-05-22 17:17:52 -04001133 return sprintf(name, "none\n");
1134
Jens Axboebd166ef2017-01-17 06:03:22 -07001135 if (!q->elevator)
1136 len += sprintf(name+len, "[none] ");
1137 else
1138 elv = e->type;
Martin K. Petersencd43e262009-05-22 17:17:52 -04001139
Jens Axboe2a12dcd2007-04-26 14:41:53 +02001140 spin_lock(&elv_list_lock);
Matthias Kaehlcke70cee262007-07-10 12:26:24 +02001141 list_for_each_entry(__e, &elv_list, list) {
Jens Axboebd166ef2017-01-17 06:03:22 -07001142 if (elv && !strcmp(elv->elevator_name, __e->elevator_name)) {
Linus Torvalds1da177e2005-04-16 15:20:36 -07001143 len += sprintf(name+len, "[%s] ", elv->elevator_name);
Jens Axboebd166ef2017-01-17 06:03:22 -07001144 continue;
1145 }
Ming Lei3a5088c2017-04-15 20:38:22 +08001146 if (__e->uses_mq && q->mq_ops && elv_support_iosched(q))
Jens Axboebd166ef2017-01-17 06:03:22 -07001147 len += sprintf(name+len, "%s ", __e->elevator_name);
1148 else if (!__e->uses_mq && !q->mq_ops)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001149 len += sprintf(name+len, "%s ", __e->elevator_name);
1150 }
Jens Axboe2a12dcd2007-04-26 14:41:53 +02001151 spin_unlock(&elv_list_lock);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001152
Jens Axboebd166ef2017-01-17 06:03:22 -07001153 if (q->mq_ops && q->elevator)
1154 len += sprintf(name+len, "none");
1155
Linus Torvalds1da177e2005-04-16 15:20:36 -07001156 len += sprintf(len+name, "\n");
1157 return len;
1158}
1159
Jens Axboe165125e2007-07-24 09:28:11 +02001160struct request *elv_rb_former_request(struct request_queue *q,
1161 struct request *rq)
Jens Axboe2e662b62006-07-13 11:55:04 +02001162{
1163 struct rb_node *rbprev = rb_prev(&rq->rb_node);
1164
1165 if (rbprev)
1166 return rb_entry_rq(rbprev);
1167
1168 return NULL;
1169}
Jens Axboe2e662b62006-07-13 11:55:04 +02001170EXPORT_SYMBOL(elv_rb_former_request);
1171
Jens Axboe165125e2007-07-24 09:28:11 +02001172struct request *elv_rb_latter_request(struct request_queue *q,
1173 struct request *rq)
Jens Axboe2e662b62006-07-13 11:55:04 +02001174{
1175 struct rb_node *rbnext = rb_next(&rq->rb_node);
1176
1177 if (rbnext)
1178 return rb_entry_rq(rbnext);
1179
1180 return NULL;
1181}
Jens Axboe2e662b62006-07-13 11:55:04 +02001182EXPORT_SYMBOL(elv_rb_latter_request);