drivers/block/elevator.c

   1 /*
   2  *  linux/drivers/block/elevator.c
   3  *
   4  *  Block device elevator/IO-scheduler.
   5  *
   6  *  Copyright (C) 2000 Andrea Arcangeli <andrea@suse.de> SuSE
   7  *
   8  * 30042000 Jens Axboe <axboe@suse.de> :
   9  *
  10  * Split the elevator a bit so that it is possible to choose a different
  11  * one or even write a new "plug in". There are three pieces:
  12  * - elevator_fn, inserts a new request in the queue list
  13  * - elevator_merge_fn, decides whether a new buffer can be merged with
  14  *   an existing request
  15  * - elevator_dequeue_fn, called when a request is taken off the active list
  16  *
  17  * 20082000 Dave Jones <davej@suse.de> :
  18  * Removed tests for max-bomb-segments, which was breaking elvtune
  19  *  when run without -bN
  20  *
  21  * Jens:
  22  * - Rework again to work with bio instead of buffer_heads
  23  * - loose bi_dev comparisons, partition handling is right now
  24  * - completely modularize elevator setup and teardown
  25  *
  26  */
  27 #include <linux/kernel.h>
  28 #include <linux/fs.h>
  29 #include <linux/blkdev.h>
  30 #include <linux/elevator.h>
  31 #include <linux/bio.h>
  32 #include <linux/config.h>
  33 #include <linux/module.h>
  34 #include <linux/slab.h>
  35 #include <linux/init.h>
  36 #include <linux/compiler.h>
  37
  38 #include <asm/uaccess.h>
  39
  40 /*
  41  * can we safely merge with this request?
  42  */
  43 inline int elv_rq_merge_ok(struct request *rq, struct bio *bio)
  44 {
  45         if (!rq_mergeable(rq))
  46                 return 0;
  47
  48         /*
  49          * different data direction or already started, don't merge
  50          */
  51         if (bio_data_dir(bio) != rq_data_dir(rq))
  52                 return 0;
  53
  54         /*
  55          * same device and no special stuff set, merge is ok
  56          */
  57         if (rq->rq_disk == bio->bi_bdev->bd_disk &&
  58             !rq->waiting && !rq->special)
  59                 return 1;
  60
  61         return 0;
  62 }
  63
  64 inline int elv_try_merge(struct request *__rq, struct bio *bio)
  65 {
  66         int ret = ELEVATOR_NO_MERGE;
  67
  68         /*
  69          * we can merge and sequence is ok, check if it's possible
  70          */
  71         if (elv_rq_merge_ok(__rq, bio)) {
  72                 if (__rq->sector + __rq->nr_sectors == bio->bi_sector)
  73                         ret = ELEVATOR_BACK_MERGE;
  74                 else if (__rq->sector - bio_sectors(bio) == bio->bi_sector)
  75                         ret = ELEVATOR_FRONT_MERGE;
  76         }
  77
  78         return ret;
  79 }
  80
  81 inline int elv_try_last_merge(request_queue_t *q, struct bio *bio)
  82 {
  83         if (q->last_merge)
  84                 return elv_try_merge(q->last_merge, bio);
  85
  86         return ELEVATOR_NO_MERGE;
  87 }
  88
  89 /*
  90  * general block -> elevator interface starts here
  91  */
  92 int elevator_init(request_queue_t *q, elevator_t *type)
  93 {
  94         elevator_t *e = &q->elevator;
  95
  96         memcpy(e, type, sizeof(*e));
  97
  98         INIT_LIST_HEAD(&q->queue_head);
  99         q->last_merge = NULL;
 100
 101         if (e->elevator_init_fn)
 102                 return e->elevator_init_fn(q, e);
 103
 104         return 0;
 105 }
 106
 107 void elevator_exit(request_queue_t *q)
 108 {
 109         elevator_t *e = &q->elevator;
 110
 111         if (e->elevator_exit_fn)
 112                 e->elevator_exit_fn(q, e);
 113 }
 114
 115 int elevator_global_init(void)
 116 {
 117         return 0;
 118 }
 119
 120 int elv_merge(request_queue_t *q, struct request **req, struct bio *bio)
 121 {
 122         elevator_t *e = &q->elevator;
 123
 124         if (e->elevator_merge_fn)
 125                 return e->elevator_merge_fn(q, req, bio);
 126
 127         return ELEVATOR_NO_MERGE;
 128 }
 129
 130 void elv_merged_request(request_queue_t *q, struct request *rq)
 131 {
 132         elevator_t *e = &q->elevator;
 133
 134         if (e->elevator_merged_fn)
 135                 e->elevator_merged_fn(q, rq);
 136 }
 137
 138 void elv_merge_requests(request_queue_t *q, struct request *rq,
 139                              struct request *next)
 140 {
 141         elevator_t *e = &q->elevator;
 142
 143         if (q->last_merge == next)
 144                 q->last_merge = NULL;
 145
 146         if (e->elevator_merge_req_fn)
 147                 e->elevator_merge_req_fn(q, rq, next);
 148 }
 149
 150 void elv_requeue_request(request_queue_t *q, struct request *rq)
 151 {
 152         /*
 153          * it already went through dequeue, we need to decrement the
 154          * in_flight count again
 155          */
 156         if (blk_account_rq(rq))
 157                 q->in_flight--;
 158
 159         /*
 160          * if iosched has an explicit requeue hook, then use that. otherwise
 161          * just put the request at the front of the queue
 162          */
 163         if (q->elevator.elevator_requeue_req_fn)
 164                 q->elevator.elevator_requeue_req_fn(q, rq);
 165         else
 166                 __elv_add_request(q, rq, ELEVATOR_INSERT_FRONT, 0);
 167 }
 168
 169 void __elv_add_request(request_queue_t *q, struct request *rq, int where,
 170                        int plug)
 171 {
 172         /*
 173          * barriers implicitly indicate back insertion
 174          */
 175         if (rq->flags & (REQ_SOFTBARRIER | REQ_HARDBARRIER) &&
 176             where == ELEVATOR_INSERT_SORT)
 177                 where = ELEVATOR_INSERT_BACK;
 178
 179         if (plug)
 180                 blk_plug_device(q);
 181
 182         rq->q = q;
 183         q->elevator.elevator_add_req_fn(q, rq, where);
 184 }
 185
 186 void elv_add_request(request_queue_t *q, struct request *rq, int where,
 187                      int plug)
 188 {
 189         unsigned long flags;
 190
 191         spin_lock_irqsave(q->queue_lock, flags);
 192         __elv_add_request(q, rq, where, plug);
 193         spin_unlock_irqrestore(q->queue_lock, flags);
 194 }
 195
 196 static inline struct request *__elv_next_request(request_queue_t *q)
 197 {
 198         return q->elevator.elevator_next_req_fn(q);
 199 }
 200
 201 struct request *elv_next_request(request_queue_t *q)
 202 {
 203         struct request *rq;
 204         int ret;
 205
 206         while ((rq = __elv_next_request(q))) {
 207                 /*
 208                  * just mark as started even if we don't start it, a request
 209                  * that has been delayed should not be passed by new incoming
 210                  * requests
 211                  */
 212                 rq->flags |= REQ_STARTED;
 213
 214                 if (rq == q->last_merge)
 215                         q->last_merge = NULL;
 216
 217                 if ((rq->flags & REQ_DONTPREP) || !q->prep_rq_fn)
 218                         break;
 219
 220                 ret = q->prep_rq_fn(q, rq);
 221                 if (ret == BLKPREP_OK) {
 222                         break;
 223                 } else if (ret == BLKPREP_DEFER) {
 224                         rq = NULL;
 225                         break;
 226                 } else if (ret == BLKPREP_KILL) {
 227                         int nr_bytes = rq->hard_nr_sectors << 9;
 228
 229                         if (!nr_bytes)
 230                                 nr_bytes = rq->data_len;
 231
 232                         blkdev_dequeue_request(rq);
 233                         rq->flags |= REQ_QUIET;
 234                         end_that_request_chunk(rq, 0, nr_bytes);
 235                         end_that_request_last(rq);
 236                 } else {
 237                         printk("%s: bad return=%d\n", __FUNCTION__, ret);
 238                         break;
 239                 }
 240         }
 241
 242         return rq;
 243 }
 244
 245 void elv_remove_request(request_queue_t *q, struct request *rq)
 246 {
 247         elevator_t *e = &q->elevator;
 248
 249         /*
 250          * the time frame between a request being removed from the lists
 251          * and to it is freed is accounted as io that is in progress at
 252          * the driver side. note that we only account requests that the
 253          * driver has seen (REQ_STARTED set), to avoid false accounting
 254          * for request-request merges
 255          */
 256         if (blk_account_rq(rq))
 257                 q->in_flight++;
 258
 259         /*
 260          * the main clearing point for q->last_merge is on retrieval of
 261          * request by driver (it calls elv_next_request()), but it _can_
 262          * also happen here if a request is added to the queue but later
 263          * deleted without ever being given to driver (merged with another
 264          * request).
 265          */
 266         if (rq == q->last_merge)
 267                 q->last_merge = NULL;
 268
 269         if (e->elevator_remove_req_fn)
 270                 e->elevator_remove_req_fn(q, rq);
 271 }
 272
 273 int elv_queue_empty(request_queue_t *q)
 274 {
 275         elevator_t *e = &q->elevator;
 276
 277         if (e->elevator_queue_empty_fn)
 278                 return e->elevator_queue_empty_fn(q);
 279
 280         return list_empty(&q->queue_head);
 281 }
 282
 283 struct request *elv_latter_request(request_queue_t *q, struct request *rq)
 284 {
 285         struct list_head *next;
 286
 287         elevator_t *e = &q->elevator;
 288
 289         if (e->elevator_latter_req_fn)
 290                 return e->elevator_latter_req_fn(q, rq);
 291
 292         next = rq->queuelist.next;
 293         if (next != &q->queue_head && next != &rq->queuelist)
 294                 return list_entry_rq(next);
 295
 296         return NULL;
 297 }
 298
 299 struct request *elv_former_request(request_queue_t *q, struct request *rq)
 300 {
 301         struct list_head *prev;
 302
 303         elevator_t *e = &q->elevator;
 304
 305         if (e->elevator_former_req_fn)
 306                 return e->elevator_former_req_fn(q, rq);
 307
 308         prev = rq->queuelist.prev;
 309         if (prev != &q->queue_head && prev != &rq->queuelist)
 310                 return list_entry_rq(prev);
 311
 312         return NULL;
 313 }
 314
 315 int elv_set_request(request_queue_t *q, struct request *rq, int gfp_mask)
 316 {
 317         elevator_t *e = &q->elevator;
 318
 319         if (e->elevator_set_req_fn)
 320                 return e->elevator_set_req_fn(q, rq, gfp_mask);
 321
 322         rq->elevator_private = NULL;
 323         return 0;
 324 }
 325
 326 void elv_put_request(request_queue_t *q, struct request *rq)
 327 {
 328         elevator_t *e = &q->elevator;
 329
 330         if (e->elevator_put_req_fn)
 331                 e->elevator_put_req_fn(q, rq);
 332 }
 333
 334 int elv_may_queue(request_queue_t *q, int rw)
 335 {
 336         elevator_t *e = &q->elevator;
 337
 338         if (e->elevator_may_queue_fn)
 339                 return e->elevator_may_queue_fn(q, rw);
 340
 341         return 0;
 342 }
 343
 344 void elv_completed_request(request_queue_t *q, struct request *rq)
 345 {
 346         elevator_t *e = &q->elevator;
 347
 348         /*
 349          * request is released from the driver, io must be done
 350          */
 351         if (blk_account_rq(rq))
 352                 q->in_flight--;
 353
 354         if (e->elevator_completed_req_fn)
 355                 e->elevator_completed_req_fn(q, rq);
 356 }
 357
 358 int elv_register_queue(struct request_queue *q)
 359 {
 360         elevator_t *e;
 361
 362         e = &q->elevator;
 363
 364         e->kobj.parent = kobject_get(&q->kobj);
 365         if (!e->kobj.parent)
 366                 return -EBUSY;
 367
 368         snprintf(e->kobj.name, KOBJ_NAME_LEN, "%s", "iosched");
 369         e->kobj.ktype = e->elevator_ktype;
 370
 371         return kobject_register(&e->kobj);
 372 }
 373
 374 void elv_unregister_queue(struct request_queue *q)
 375 {
 376         if (q) {
 377                 elevator_t * e = &q->elevator;
 378                 kobject_unregister(&e->kobj);
 379                 kobject_put(&q->kobj);
 380         }
 381 }
 382
 383 module_init(elevator_global_init);
 384
 385 EXPORT_SYMBOL(elv_add_request);
 386 EXPORT_SYMBOL(__elv_add_request);
 387 EXPORT_SYMBOL(elv_requeue_request);
 388 EXPORT_SYMBOL(elv_next_request);
 389 EXPORT_SYMBOL(elv_remove_request);
 390 EXPORT_SYMBOL(elv_queue_empty);
 391 EXPORT_SYMBOL(elv_completed_request);
 392 EXPORT_SYMBOL(elevator_exit);
 393 EXPORT_SYMBOL(elevator_init);