1 /* 2 * Functions related to sysfs handling 3 */ 4 #include <linux/kernel.h> 5 #include <linux/slab.h> 6 #include <linux/module.h> 7 #include <linux/bio.h> 8 #include <linux/blkdev.h> 9 #include <linux/blktrace_api.h> 10 #include <linux/blk-mq.h> 11 12 #include "blk.h" 13 #include "blk-cgroup.h" 14 #include "blk-mq.h" 15 16 struct queue_sysfs_entry { 17 struct attribute attr; 18 ssize_t (*show)(struct request_queue *, char *); 19 ssize_t (*store)(struct request_queue *, const char *, size_t); 20 }; 21 22 static ssize_t 23 queue_var_show(unsigned long var, char *page) 24 { 25 return sprintf(page, "%lu\n", var); 26 } 27 28 static ssize_t 29 queue_var_store(unsigned long *var, const char *page, size_t count) 30 { 31 int err; 32 unsigned long v; 33 34 err = kstrtoul(page, 10, &v); 35 if (err || v > UINT_MAX) 36 return -EINVAL; 37 38 *var = v; 39 40 return count; 41 } 42 43 static ssize_t queue_requests_show(struct request_queue *q, char *page) 44 { 45 return queue_var_show(q->nr_requests, (page)); 46 } 47 48 static ssize_t 49 queue_requests_store(struct request_queue *q, const char *page, size_t count) 50 { 51 unsigned long nr; 52 int ret, err; 53 54 if (!q->request_fn && !q->mq_ops) 55 return -EINVAL; 56 57 ret = queue_var_store(&nr, page, count); 58 if (ret < 0) 59 return ret; 60 61 if (nr < BLKDEV_MIN_RQ) 62 nr = BLKDEV_MIN_RQ; 63 64 if (q->request_fn) 65 err = blk_update_nr_requests(q, nr); 66 else 67 err = blk_mq_update_nr_requests(q, nr); 68 69 if (err) 70 return err; 71 72 return ret; 73 } 74 75 static ssize_t queue_ra_show(struct request_queue *q, char *page) 76 { 77 unsigned long ra_kb = q->backing_dev_info.ra_pages << 78 (PAGE_CACHE_SHIFT - 10); 79 80 return queue_var_show(ra_kb, (page)); 81 } 82 83 static ssize_t 84 queue_ra_store(struct request_queue *q, const char *page, size_t count) 85 { 86 unsigned long ra_kb; 87 ssize_t ret = queue_var_store(&ra_kb, page, count); 88 89 if (ret < 0) 90 return ret; 91 92 q->backing_dev_info.ra_pages = ra_kb >> (PAGE_CACHE_SHIFT - 10); 93 94 return ret; 95 } 96 97 static ssize_t queue_max_sectors_show(struct request_queue *q, char *page) 98 { 99 int max_sectors_kb = queue_max_sectors(q) >> 1; 100 101 return queue_var_show(max_sectors_kb, (page)); 102 } 103 104 static ssize_t queue_max_segments_show(struct request_queue *q, char *page) 105 { 106 return queue_var_show(queue_max_segments(q), (page)); 107 } 108 109 static ssize_t queue_max_integrity_segments_show(struct request_queue *q, char *page) 110 { 111 return queue_var_show(q->limits.max_integrity_segments, (page)); 112 } 113 114 static ssize_t queue_max_segment_size_show(struct request_queue *q, char *page) 115 { 116 if (blk_queue_cluster(q)) 117 return queue_var_show(queue_max_segment_size(q), (page)); 118 119 return queue_var_show(PAGE_CACHE_SIZE, (page)); 120 } 121 122 static ssize_t queue_logical_block_size_show(struct request_queue *q, char *page) 123 { 124 return queue_var_show(queue_logical_block_size(q), page); 125 } 126 127 static ssize_t queue_physical_block_size_show(struct request_queue *q, char *page) 128 { 129 return queue_var_show(queue_physical_block_size(q), page); 130 } 131 132 static ssize_t queue_io_min_show(struct request_queue *q, char *page) 133 { 134 return queue_var_show(queue_io_min(q), page); 135 } 136 137 static ssize_t queue_io_opt_show(struct request_queue *q, char *page) 138 { 139 return queue_var_show(queue_io_opt(q), page); 140 } 141 142 static ssize_t queue_discard_granularity_show(struct request_queue *q, char *page) 143 { 144 return queue_var_show(q->limits.discard_granularity, page); 145 } 146 147 static ssize_t queue_discard_max_show(struct request_queue *q, char *page) 148 { 149 return sprintf(page, "%llu\n", 150 (unsigned long long)q->limits.max_discard_sectors << 9); 151 } 152 153 static ssize_t queue_discard_zeroes_data_show(struct request_queue *q, char *page) 154 { 155 return queue_var_show(queue_discard_zeroes_data(q), page); 156 } 157 158 static ssize_t queue_write_same_max_show(struct request_queue *q, char *page) 159 { 160 return sprintf(page, "%llu\n", 161 (unsigned long long)q->limits.max_write_same_sectors << 9); 162 } 163 164 165 static ssize_t 166 queue_max_sectors_store(struct request_queue *q, const char *page, size_t count) 167 { 168 unsigned long max_sectors_kb, 169 max_hw_sectors_kb = queue_max_hw_sectors(q) >> 1, 170 page_kb = 1 << (PAGE_CACHE_SHIFT - 10); 171 ssize_t ret = queue_var_store(&max_sectors_kb, page, count); 172 173 if (ret < 0) 174 return ret; 175 176 if (max_sectors_kb > max_hw_sectors_kb || max_sectors_kb < page_kb) 177 return -EINVAL; 178 179 spin_lock_irq(q->queue_lock); 180 q->limits.max_sectors = max_sectors_kb << 1; 181 spin_unlock_irq(q->queue_lock); 182 183 return ret; 184 } 185 186 static ssize_t queue_max_hw_sectors_show(struct request_queue *q, char *page) 187 { 188 int max_hw_sectors_kb = queue_max_hw_sectors(q) >> 1; 189 190 return queue_var_show(max_hw_sectors_kb, (page)); 191 } 192 193 #define QUEUE_SYSFS_BIT_FNS(name, flag, neg) \ 194 static ssize_t \ 195 queue_show_##name(struct request_queue *q, char *page) \ 196 { \ 197 int bit; \ 198 bit = test_bit(QUEUE_FLAG_##flag, &q->queue_flags); \ 199 return queue_var_show(neg ? !bit : bit, page); \ 200 } \ 201 static ssize_t \ 202 queue_store_##name(struct request_queue *q, const char *page, size_t count) \ 203 { \ 204 unsigned long val; \ 205 ssize_t ret; \ 206 ret = queue_var_store(&val, page, count); \ 207 if (ret < 0) \ 208 return ret; \ 209 if (neg) \ 210 val = !val; \ 211 \ 212 spin_lock_irq(q->queue_lock); \ 213 if (val) \ 214 queue_flag_set(QUEUE_FLAG_##flag, q); \ 215 else \ 216 queue_flag_clear(QUEUE_FLAG_##flag, q); \ 217 spin_unlock_irq(q->queue_lock); \ 218 return ret; \ 219 } 220 221 QUEUE_SYSFS_BIT_FNS(nonrot, NONROT, 1); 222 QUEUE_SYSFS_BIT_FNS(random, ADD_RANDOM, 0); 223 QUEUE_SYSFS_BIT_FNS(iostats, IO_STAT, 0); 224 #undef QUEUE_SYSFS_BIT_FNS 225 226 static ssize_t queue_nomerges_show(struct request_queue *q, char *page) 227 { 228 return queue_var_show((blk_queue_nomerges(q) << 1) | 229 blk_queue_noxmerges(q), page); 230 } 231 232 static ssize_t queue_nomerges_store(struct request_queue *q, const char *page, 233 size_t count) 234 { 235 unsigned long nm; 236 ssize_t ret = queue_var_store(&nm, page, count); 237 238 if (ret < 0) 239 return ret; 240 241 spin_lock_irq(q->queue_lock); 242 queue_flag_clear(QUEUE_FLAG_NOMERGES, q); 243 queue_flag_clear(QUEUE_FLAG_NOXMERGES, q); 244 if (nm == 2) 245 queue_flag_set(QUEUE_FLAG_NOMERGES, q); 246 else if (nm) 247 queue_flag_set(QUEUE_FLAG_NOXMERGES, q); 248 spin_unlock_irq(q->queue_lock); 249 250 return ret; 251 } 252 253 static ssize_t queue_rq_affinity_show(struct request_queue *q, char *page) 254 { 255 bool set = test_bit(QUEUE_FLAG_SAME_COMP, &q->queue_flags); 256 bool force = test_bit(QUEUE_FLAG_SAME_FORCE, &q->queue_flags); 257 258 return queue_var_show(set << force, page); 259 } 260 261 static ssize_t 262 queue_rq_affinity_store(struct request_queue *q, const char *page, size_t count) 263 { 264 ssize_t ret = -EINVAL; 265 #ifdef CONFIG_SMP 266 unsigned long val; 267 268 ret = queue_var_store(&val, page, count); 269 if (ret < 0) 270 return ret; 271 272 spin_lock_irq(q->queue_lock); 273 if (val == 2) { 274 queue_flag_set(QUEUE_FLAG_SAME_COMP, q); 275 queue_flag_set(QUEUE_FLAG_SAME_FORCE, q); 276 } else if (val == 1) { 277 queue_flag_set(QUEUE_FLAG_SAME_COMP, q); 278 queue_flag_clear(QUEUE_FLAG_SAME_FORCE, q); 279 } else if (val == 0) { 280 queue_flag_clear(QUEUE_FLAG_SAME_COMP, q); 281 queue_flag_clear(QUEUE_FLAG_SAME_FORCE, q); 282 } 283 spin_unlock_irq(q->queue_lock); 284 #endif 285 return ret; 286 } 287 288 static struct queue_sysfs_entry queue_requests_entry = { 289 .attr = {.name = "nr_requests", .mode = S_IRUGO | S_IWUSR }, 290 .show = queue_requests_show, 291 .store = queue_requests_store, 292 }; 293 294 static struct queue_sysfs_entry queue_ra_entry = { 295 .attr = {.name = "read_ahead_kb", .mode = S_IRUGO | S_IWUSR }, 296 .show = queue_ra_show, 297 .store = queue_ra_store, 298 }; 299 300 static struct queue_sysfs_entry queue_max_sectors_entry = { 301 .attr = {.name = "max_sectors_kb", .mode = S_IRUGO | S_IWUSR }, 302 .show = queue_max_sectors_show, 303 .store = queue_max_sectors_store, 304 }; 305 306 static struct queue_sysfs_entry queue_max_hw_sectors_entry = { 307 .attr = {.name = "max_hw_sectors_kb", .mode = S_IRUGO }, 308 .show = queue_max_hw_sectors_show, 309 }; 310 311 static struct queue_sysfs_entry queue_max_segments_entry = { 312 .attr = {.name = "max_segments", .mode = S_IRUGO }, 313 .show = queue_max_segments_show, 314 }; 315 316 static struct queue_sysfs_entry queue_max_integrity_segments_entry = { 317 .attr = {.name = "max_integrity_segments", .mode = S_IRUGO }, 318 .show = queue_max_integrity_segments_show, 319 }; 320 321 static struct queue_sysfs_entry queue_max_segment_size_entry = { 322 .attr = {.name = "max_segment_size", .mode = S_IRUGO }, 323 .show = queue_max_segment_size_show, 324 }; 325 326 static struct queue_sysfs_entry queue_iosched_entry = { 327 .attr = {.name = "scheduler", .mode = S_IRUGO | S_IWUSR }, 328 .show = elv_iosched_show, 329 .store = elv_iosched_store, 330 }; 331 332 static struct queue_sysfs_entry queue_hw_sector_size_entry = { 333 .attr = {.name = "hw_sector_size", .mode = S_IRUGO }, 334 .show = queue_logical_block_size_show, 335 }; 336 337 static struct queue_sysfs_entry queue_logical_block_size_entry = { 338 .attr = {.name = "logical_block_size", .mode = S_IRUGO }, 339 .show = queue_logical_block_size_show, 340 }; 341 342 static struct queue_sysfs_entry queue_physical_block_size_entry = { 343 .attr = {.name = "physical_block_size", .mode = S_IRUGO }, 344 .show = queue_physical_block_size_show, 345 }; 346 347 static struct queue_sysfs_entry queue_io_min_entry = { 348 .attr = {.name = "minimum_io_size", .mode = S_IRUGO }, 349 .show = queue_io_min_show, 350 }; 351 352 static struct queue_sysfs_entry queue_io_opt_entry = { 353 .attr = {.name = "optimal_io_size", .mode = S_IRUGO }, 354 .show = queue_io_opt_show, 355 }; 356 357 static struct queue_sysfs_entry queue_discard_granularity_entry = { 358 .attr = {.name = "discard_granularity", .mode = S_IRUGO }, 359 .show = queue_discard_granularity_show, 360 }; 361 362 static struct queue_sysfs_entry queue_discard_max_entry = { 363 .attr = {.name = "discard_max_bytes", .mode = S_IRUGO }, 364 .show = queue_discard_max_show, 365 }; 366 367 static struct queue_sysfs_entry queue_discard_zeroes_data_entry = { 368 .attr = {.name = "discard_zeroes_data", .mode = S_IRUGO }, 369 .show = queue_discard_zeroes_data_show, 370 }; 371 372 static struct queue_sysfs_entry queue_write_same_max_entry = { 373 .attr = {.name = "write_same_max_bytes", .mode = S_IRUGO }, 374 .show = queue_write_same_max_show, 375 }; 376 377 static struct queue_sysfs_entry queue_nonrot_entry = { 378 .attr = {.name = "rotational", .mode = S_IRUGO | S_IWUSR }, 379 .show = queue_show_nonrot, 380 .store = queue_store_nonrot, 381 }; 382 383 static struct queue_sysfs_entry queue_nomerges_entry = { 384 .attr = {.name = "nomerges", .mode = S_IRUGO | S_IWUSR }, 385 .show = queue_nomerges_show, 386 .store = queue_nomerges_store, 387 }; 388 389 static struct queue_sysfs_entry queue_rq_affinity_entry = { 390 .attr = {.name = "rq_affinity", .mode = S_IRUGO | S_IWUSR }, 391 .show = queue_rq_affinity_show, 392 .store = queue_rq_affinity_store, 393 }; 394 395 static struct queue_sysfs_entry queue_iostats_entry = { 396 .attr = {.name = "iostats", .mode = S_IRUGO | S_IWUSR }, 397 .show = queue_show_iostats, 398 .store = queue_store_iostats, 399 }; 400 401 static struct queue_sysfs_entry queue_random_entry = { 402 .attr = {.name = "add_random", .mode = S_IRUGO | S_IWUSR }, 403 .show = queue_show_random, 404 .store = queue_store_random, 405 }; 406 407 static struct attribute *default_attrs[] = { 408 &queue_requests_entry.attr, 409 &queue_ra_entry.attr, 410 &queue_max_hw_sectors_entry.attr, 411 &queue_max_sectors_entry.attr, 412 &queue_max_segments_entry.attr, 413 &queue_max_integrity_segments_entry.attr, 414 &queue_max_segment_size_entry.attr, 415 &queue_iosched_entry.attr, 416 &queue_hw_sector_size_entry.attr, 417 &queue_logical_block_size_entry.attr, 418 &queue_physical_block_size_entry.attr, 419 &queue_io_min_entry.attr, 420 &queue_io_opt_entry.attr, 421 &queue_discard_granularity_entry.attr, 422 &queue_discard_max_entry.attr, 423 &queue_discard_zeroes_data_entry.attr, 424 &queue_write_same_max_entry.attr, 425 &queue_nonrot_entry.attr, 426 &queue_nomerges_entry.attr, 427 &queue_rq_affinity_entry.attr, 428 &queue_iostats_entry.attr, 429 &queue_random_entry.attr, 430 NULL, 431 }; 432 433 #define to_queue(atr) container_of((atr), struct queue_sysfs_entry, attr) 434 435 static ssize_t 436 queue_attr_show(struct kobject *kobj, struct attribute *attr, char *page) 437 { 438 struct queue_sysfs_entry *entry = to_queue(attr); 439 struct request_queue *q = 440 container_of(kobj, struct request_queue, kobj); 441 ssize_t res; 442 443 if (!entry->show) 444 return -EIO; 445 mutex_lock(&q->sysfs_lock); 446 if (blk_queue_dying(q)) { 447 mutex_unlock(&q->sysfs_lock); 448 return -ENOENT; 449 } 450 res = entry->show(q, page); 451 mutex_unlock(&q->sysfs_lock); 452 return res; 453 } 454 455 static ssize_t 456 queue_attr_store(struct kobject *kobj, struct attribute *attr, 457 const char *page, size_t length) 458 { 459 struct queue_sysfs_entry *entry = to_queue(attr); 460 struct request_queue *q; 461 ssize_t res; 462 463 if (!entry->store) 464 return -EIO; 465 466 q = container_of(kobj, struct request_queue, kobj); 467 mutex_lock(&q->sysfs_lock); 468 if (blk_queue_dying(q)) { 469 mutex_unlock(&q->sysfs_lock); 470 return -ENOENT; 471 } 472 res = entry->store(q, page, length); 473 mutex_unlock(&q->sysfs_lock); 474 return res; 475 } 476 477 static void blk_free_queue_rcu(struct rcu_head *rcu_head) 478 { 479 struct request_queue *q = container_of(rcu_head, struct request_queue, 480 rcu_head); 481 kmem_cache_free(blk_requestq_cachep, q); 482 } 483 484 /** 485 * blk_release_queue: - release a &struct request_queue when it is no longer needed 486 * @kobj: the kobj belonging to the request queue to be released 487 * 488 * Description: 489 * blk_release_queue is the pair to blk_init_queue() or 490 * blk_queue_make_request(). It should be called when a request queue is 491 * being released; typically when a block device is being de-registered. 492 * Currently, its primary task it to free all the &struct request 493 * structures that were allocated to the queue and the queue itself. 494 * 495 * Note: 496 * The low level driver must have finished any outstanding requests first 497 * via blk_cleanup_queue(). 498 **/ 499 static void blk_release_queue(struct kobject *kobj) 500 { 501 struct request_queue *q = 502 container_of(kobj, struct request_queue, kobj); 503 504 blkcg_exit_queue(q); 505 506 if (q->elevator) { 507 spin_lock_irq(q->queue_lock); 508 ioc_clear_queue(q); 509 spin_unlock_irq(q->queue_lock); 510 elevator_exit(q->elevator); 511 } 512 513 blk_exit_rl(&q->root_rl); 514 515 if (q->queue_tags) 516 __blk_queue_free_tags(q); 517 518 if (!q->mq_ops) 519 blk_free_flush_queue(q->fq); 520 else 521 blk_mq_release(q); 522 523 blk_trace_shutdown(q); 524 525 ida_simple_remove(&blk_queue_ida, q->id); 526 call_rcu(&q->rcu_head, blk_free_queue_rcu); 527 } 528 529 static const struct sysfs_ops queue_sysfs_ops = { 530 .show = queue_attr_show, 531 .store = queue_attr_store, 532 }; 533 534 struct kobj_type blk_queue_ktype = { 535 .sysfs_ops = &queue_sysfs_ops, 536 .default_attrs = default_attrs, 537 .release = blk_release_queue, 538 }; 539 540 int blk_register_queue(struct gendisk *disk) 541 { 542 int ret; 543 struct device *dev = disk_to_dev(disk); 544 struct request_queue *q = disk->queue; 545 546 if (WARN_ON(!q)) 547 return -ENXIO; 548 549 /* 550 * SCSI probing may synchronously create and destroy a lot of 551 * request_queues for non-existent devices. Shutting down a fully 552 * functional queue takes measureable wallclock time as RCU grace 553 * periods are involved. To avoid excessive latency in these 554 * cases, a request_queue starts out in a degraded mode which is 555 * faster to shut down and is made fully functional here as 556 * request_queues for non-existent devices never get registered. 557 */ 558 if (!blk_queue_init_done(q)) { 559 queue_flag_set_unlocked(QUEUE_FLAG_INIT_DONE, q); 560 blk_queue_bypass_end(q); 561 if (q->mq_ops) 562 blk_mq_finish_init(q); 563 } 564 565 ret = blk_trace_init_sysfs(dev); 566 if (ret) 567 return ret; 568 569 ret = kobject_add(&q->kobj, kobject_get(&dev->kobj), "%s", "queue"); 570 if (ret < 0) { 571 blk_trace_remove_sysfs(dev); 572 return ret; 573 } 574 575 kobject_uevent(&q->kobj, KOBJ_ADD); 576 577 if (q->mq_ops) 578 blk_mq_register_disk(disk); 579 580 if (!q->request_fn) 581 return 0; 582 583 ret = elv_register_queue(q); 584 if (ret) { 585 kobject_uevent(&q->kobj, KOBJ_REMOVE); 586 kobject_del(&q->kobj); 587 blk_trace_remove_sysfs(dev); 588 kobject_put(&dev->kobj); 589 return ret; 590 } 591 592 return 0; 593 } 594 595 void blk_unregister_queue(struct gendisk *disk) 596 { 597 struct request_queue *q = disk->queue; 598 599 if (WARN_ON(!q)) 600 return; 601 602 if (q->mq_ops) 603 blk_mq_unregister_disk(disk); 604 605 if (q->request_fn) 606 elv_unregister_queue(q); 607 608 kobject_uevent(&q->kobj, KOBJ_REMOVE); 609 kobject_del(&q->kobj); 610 blk_trace_remove_sysfs(disk_to_dev(disk)); 611 kobject_put(&disk_to_dev(disk)->kobj); 612 } 613