1 // SPDX-License-Identifier: GPL-2.0
3 * Functions related to sysfs handling
5 #include <linux/kernel.h>
6 #include <linux/slab.h>
7 #include <linux/module.h>
9 #include <linux/blkdev.h>
10 #include <linux/backing-dev.h>
11 #include <linux/blktrace_api.h>
12 #include <linux/blk-mq.h>
13 #include <linux/blk-cgroup.h>
17 #include "blk-mq-debugfs.h"
20 struct queue_sysfs_entry
{
21 struct attribute attr
;
22 ssize_t (*show
)(struct request_queue
*, char *);
23 ssize_t (*store
)(struct request_queue
*, const char *, size_t);
27 queue_var_show(unsigned long var
, char *page
)
29 return sprintf(page
, "%lu\n", var
);
33 queue_var_store(unsigned long *var
, const char *page
, size_t count
)
38 err
= kstrtoul(page
, 10, &v
);
39 if (err
|| v
> UINT_MAX
)
47 static ssize_t
queue_var_store64(s64
*var
, const char *page
)
52 err
= kstrtos64(page
, 10, &v
);
60 static ssize_t
queue_requests_show(struct request_queue
*q
, char *page
)
62 return queue_var_show(q
->nr_requests
, (page
));
66 queue_requests_store(struct request_queue
*q
, const char *page
, size_t count
)
74 ret
= queue_var_store(&nr
, page
, count
);
78 if (nr
< BLKDEV_MIN_RQ
)
81 err
= blk_mq_update_nr_requests(q
, nr
);
88 static ssize_t
queue_ra_show(struct request_queue
*q
, char *page
)
90 unsigned long ra_kb
= q
->backing_dev_info
->ra_pages
<<
93 return queue_var_show(ra_kb
, (page
));
97 queue_ra_store(struct request_queue
*q
, const char *page
, size_t count
)
100 ssize_t ret
= queue_var_store(&ra_kb
, page
, count
);
105 q
->backing_dev_info
->ra_pages
= ra_kb
>> (PAGE_SHIFT
- 10);
110 static ssize_t
queue_max_sectors_show(struct request_queue
*q
, char *page
)
112 int max_sectors_kb
= queue_max_sectors(q
) >> 1;
114 return queue_var_show(max_sectors_kb
, (page
));
117 static ssize_t
queue_max_segments_show(struct request_queue
*q
, char *page
)
119 return queue_var_show(queue_max_segments(q
), (page
));
122 static ssize_t
queue_max_discard_segments_show(struct request_queue
*q
,
125 return queue_var_show(queue_max_discard_segments(q
), (page
));
128 static ssize_t
queue_max_integrity_segments_show(struct request_queue
*q
, char *page
)
130 return queue_var_show(q
->limits
.max_integrity_segments
, (page
));
133 static ssize_t
queue_max_segment_size_show(struct request_queue
*q
, char *page
)
135 return queue_var_show(queue_max_segment_size(q
), (page
));
138 static ssize_t
queue_logical_block_size_show(struct request_queue
*q
, char *page
)
140 return queue_var_show(queue_logical_block_size(q
), page
);
143 static ssize_t
queue_physical_block_size_show(struct request_queue
*q
, char *page
)
145 return queue_var_show(queue_physical_block_size(q
), page
);
148 static ssize_t
queue_chunk_sectors_show(struct request_queue
*q
, char *page
)
150 return queue_var_show(q
->limits
.chunk_sectors
, page
);
153 static ssize_t
queue_io_min_show(struct request_queue
*q
, char *page
)
155 return queue_var_show(queue_io_min(q
), page
);
158 static ssize_t
queue_io_opt_show(struct request_queue
*q
, char *page
)
160 return queue_var_show(queue_io_opt(q
), page
);
163 static ssize_t
queue_discard_granularity_show(struct request_queue
*q
, char *page
)
165 return queue_var_show(q
->limits
.discard_granularity
, page
);
168 static ssize_t
queue_discard_max_hw_show(struct request_queue
*q
, char *page
)
171 return sprintf(page
, "%llu\n",
172 (unsigned long long)q
->limits
.max_hw_discard_sectors
<< 9);
175 static ssize_t
queue_discard_max_show(struct request_queue
*q
, char *page
)
177 return sprintf(page
, "%llu\n",
178 (unsigned long long)q
->limits
.max_discard_sectors
<< 9);
181 static ssize_t
queue_discard_max_store(struct request_queue
*q
,
182 const char *page
, size_t count
)
184 unsigned long max_discard
;
185 ssize_t ret
= queue_var_store(&max_discard
, page
, count
);
190 if (max_discard
& (q
->limits
.discard_granularity
- 1))
194 if (max_discard
> UINT_MAX
)
197 if (max_discard
> q
->limits
.max_hw_discard_sectors
)
198 max_discard
= q
->limits
.max_hw_discard_sectors
;
200 q
->limits
.max_discard_sectors
= max_discard
;
204 static ssize_t
queue_discard_zeroes_data_show(struct request_queue
*q
, char *page
)
206 return queue_var_show(0, page
);
209 static ssize_t
queue_write_same_max_show(struct request_queue
*q
, char *page
)
211 return sprintf(page
, "%llu\n",
212 (unsigned long long)q
->limits
.max_write_same_sectors
<< 9);
215 static ssize_t
queue_write_zeroes_max_show(struct request_queue
*q
, char *page
)
217 return sprintf(page
, "%llu\n",
218 (unsigned long long)q
->limits
.max_write_zeroes_sectors
<< 9);
222 queue_max_sectors_store(struct request_queue
*q
, const char *page
, size_t count
)
224 unsigned long max_sectors_kb
,
225 max_hw_sectors_kb
= queue_max_hw_sectors(q
) >> 1,
226 page_kb
= 1 << (PAGE_SHIFT
- 10);
227 ssize_t ret
= queue_var_store(&max_sectors_kb
, page
, count
);
232 max_hw_sectors_kb
= min_not_zero(max_hw_sectors_kb
, (unsigned long)
233 q
->limits
.max_dev_sectors
>> 1);
235 if (max_sectors_kb
> max_hw_sectors_kb
|| max_sectors_kb
< page_kb
)
238 spin_lock_irq(&q
->queue_lock
);
239 q
->limits
.max_sectors
= max_sectors_kb
<< 1;
240 q
->backing_dev_info
->io_pages
= max_sectors_kb
>> (PAGE_SHIFT
- 10);
241 spin_unlock_irq(&q
->queue_lock
);
246 static ssize_t
queue_max_hw_sectors_show(struct request_queue
*q
, char *page
)
248 int max_hw_sectors_kb
= queue_max_hw_sectors(q
) >> 1;
250 return queue_var_show(max_hw_sectors_kb
, (page
));
253 #define QUEUE_SYSFS_BIT_FNS(name, flag, neg) \
255 queue_show_##name(struct request_queue *q, char *page) \
258 bit = test_bit(QUEUE_FLAG_##flag, &q->queue_flags); \
259 return queue_var_show(neg ? !bit : bit, page); \
262 queue_store_##name(struct request_queue *q, const char *page, size_t count) \
266 ret = queue_var_store(&val, page, count); \
273 blk_queue_flag_set(QUEUE_FLAG_##flag, q); \
275 blk_queue_flag_clear(QUEUE_FLAG_##flag, q); \
279 QUEUE_SYSFS_BIT_FNS(nonrot
, NONROT
, 1);
280 QUEUE_SYSFS_BIT_FNS(random
, ADD_RANDOM
, 0);
281 QUEUE_SYSFS_BIT_FNS(iostats
, IO_STAT
, 0);
282 #undef QUEUE_SYSFS_BIT_FNS
284 static ssize_t
queue_zoned_show(struct request_queue
*q
, char *page
)
286 switch (blk_queue_zoned_model(q
)) {
288 return sprintf(page
, "host-aware\n");
290 return sprintf(page
, "host-managed\n");
292 return sprintf(page
, "none\n");
296 static ssize_t
queue_nr_zones_show(struct request_queue
*q
, char *page
)
298 return queue_var_show(blk_queue_nr_zones(q
), page
);
301 static ssize_t
queue_nomerges_show(struct request_queue
*q
, char *page
)
303 return queue_var_show((blk_queue_nomerges(q
) << 1) |
304 blk_queue_noxmerges(q
), page
);
307 static ssize_t
queue_nomerges_store(struct request_queue
*q
, const char *page
,
311 ssize_t ret
= queue_var_store(&nm
, page
, count
);
316 blk_queue_flag_clear(QUEUE_FLAG_NOMERGES
, q
);
317 blk_queue_flag_clear(QUEUE_FLAG_NOXMERGES
, q
);
319 blk_queue_flag_set(QUEUE_FLAG_NOMERGES
, q
);
321 blk_queue_flag_set(QUEUE_FLAG_NOXMERGES
, q
);
326 static ssize_t
queue_rq_affinity_show(struct request_queue
*q
, char *page
)
328 bool set
= test_bit(QUEUE_FLAG_SAME_COMP
, &q
->queue_flags
);
329 bool force
= test_bit(QUEUE_FLAG_SAME_FORCE
, &q
->queue_flags
);
331 return queue_var_show(set
<< force
, page
);
335 queue_rq_affinity_store(struct request_queue
*q
, const char *page
, size_t count
)
337 ssize_t ret
= -EINVAL
;
341 ret
= queue_var_store(&val
, page
, count
);
346 blk_queue_flag_set(QUEUE_FLAG_SAME_COMP
, q
);
347 blk_queue_flag_set(QUEUE_FLAG_SAME_FORCE
, q
);
348 } else if (val
== 1) {
349 blk_queue_flag_set(QUEUE_FLAG_SAME_COMP
, q
);
350 blk_queue_flag_clear(QUEUE_FLAG_SAME_FORCE
, q
);
351 } else if (val
== 0) {
352 blk_queue_flag_clear(QUEUE_FLAG_SAME_COMP
, q
);
353 blk_queue_flag_clear(QUEUE_FLAG_SAME_FORCE
, q
);
359 static ssize_t
queue_poll_delay_show(struct request_queue
*q
, char *page
)
363 if (q
->poll_nsec
== BLK_MQ_POLL_CLASSIC
)
364 val
= BLK_MQ_POLL_CLASSIC
;
366 val
= q
->poll_nsec
/ 1000;
368 return sprintf(page
, "%d\n", val
);
371 static ssize_t
queue_poll_delay_store(struct request_queue
*q
, const char *page
,
376 if (!q
->mq_ops
|| !q
->mq_ops
->poll
)
379 err
= kstrtoint(page
, 10, &val
);
383 if (val
== BLK_MQ_POLL_CLASSIC
)
384 q
->poll_nsec
= BLK_MQ_POLL_CLASSIC
;
386 q
->poll_nsec
= val
* 1000;
393 static ssize_t
queue_poll_show(struct request_queue
*q
, char *page
)
395 return queue_var_show(test_bit(QUEUE_FLAG_POLL
, &q
->queue_flags
), page
);
398 static ssize_t
queue_poll_store(struct request_queue
*q
, const char *page
,
401 unsigned long poll_on
;
404 if (!q
->tag_set
|| q
->tag_set
->nr_maps
<= HCTX_TYPE_POLL
||
405 !q
->tag_set
->map
[HCTX_TYPE_POLL
].nr_queues
)
408 ret
= queue_var_store(&poll_on
, page
, count
);
413 blk_queue_flag_set(QUEUE_FLAG_POLL
, q
);
415 blk_queue_flag_clear(QUEUE_FLAG_POLL
, q
);
420 static ssize_t
queue_io_timeout_show(struct request_queue
*q
, char *page
)
422 return sprintf(page
, "%u\n", jiffies_to_msecs(q
->rq_timeout
));
425 static ssize_t
queue_io_timeout_store(struct request_queue
*q
, const char *page
,
431 err
= kstrtou32(page
, 10, &val
);
435 blk_queue_rq_timeout(q
, msecs_to_jiffies(val
));
440 static ssize_t
queue_wb_lat_show(struct request_queue
*q
, char *page
)
445 return sprintf(page
, "%llu\n", div_u64(wbt_get_min_lat(q
), 1000));
448 static ssize_t
queue_wb_lat_store(struct request_queue
*q
, const char *page
,
455 ret
= queue_var_store64(&val
, page
);
461 rqos
= wbt_rq_qos(q
);
469 val
= wbt_default_latency_nsec(q
);
473 if (wbt_get_min_lat(q
) == val
)
477 * Ensure that the queue is idled, in case the latency update
478 * ends up either enabling or disabling wbt completely. We can't
479 * have IO inflight if that happens.
481 blk_mq_freeze_queue(q
);
482 blk_mq_quiesce_queue(q
);
484 wbt_set_min_lat(q
, val
);
485 wbt_update_limits(q
);
487 blk_mq_unquiesce_queue(q
);
488 blk_mq_unfreeze_queue(q
);
493 static ssize_t
queue_wc_show(struct request_queue
*q
, char *page
)
495 if (test_bit(QUEUE_FLAG_WC
, &q
->queue_flags
))
496 return sprintf(page
, "write back\n");
498 return sprintf(page
, "write through\n");
501 static ssize_t
queue_wc_store(struct request_queue
*q
, const char *page
,
506 if (!strncmp(page
, "write back", 10))
508 else if (!strncmp(page
, "write through", 13) ||
509 !strncmp(page
, "none", 4))
516 blk_queue_flag_set(QUEUE_FLAG_WC
, q
);
518 blk_queue_flag_clear(QUEUE_FLAG_WC
, q
);
523 static ssize_t
queue_fua_show(struct request_queue
*q
, char *page
)
525 return sprintf(page
, "%u\n", test_bit(QUEUE_FLAG_FUA
, &q
->queue_flags
));
528 static ssize_t
queue_dax_show(struct request_queue
*q
, char *page
)
530 return queue_var_show(blk_queue_dax(q
), page
);
533 static struct queue_sysfs_entry queue_requests_entry
= {
534 .attr
= {.name
= "nr_requests", .mode
= 0644 },
535 .show
= queue_requests_show
,
536 .store
= queue_requests_store
,
539 static struct queue_sysfs_entry queue_ra_entry
= {
540 .attr
= {.name
= "read_ahead_kb", .mode
= 0644 },
541 .show
= queue_ra_show
,
542 .store
= queue_ra_store
,
545 static struct queue_sysfs_entry queue_max_sectors_entry
= {
546 .attr
= {.name
= "max_sectors_kb", .mode
= 0644 },
547 .show
= queue_max_sectors_show
,
548 .store
= queue_max_sectors_store
,
551 static struct queue_sysfs_entry queue_max_hw_sectors_entry
= {
552 .attr
= {.name
= "max_hw_sectors_kb", .mode
= 0444 },
553 .show
= queue_max_hw_sectors_show
,
556 static struct queue_sysfs_entry queue_max_segments_entry
= {
557 .attr
= {.name
= "max_segments", .mode
= 0444 },
558 .show
= queue_max_segments_show
,
561 static struct queue_sysfs_entry queue_max_discard_segments_entry
= {
562 .attr
= {.name
= "max_discard_segments", .mode
= 0444 },
563 .show
= queue_max_discard_segments_show
,
566 static struct queue_sysfs_entry queue_max_integrity_segments_entry
= {
567 .attr
= {.name
= "max_integrity_segments", .mode
= 0444 },
568 .show
= queue_max_integrity_segments_show
,
571 static struct queue_sysfs_entry queue_max_segment_size_entry
= {
572 .attr
= {.name
= "max_segment_size", .mode
= 0444 },
573 .show
= queue_max_segment_size_show
,
576 static struct queue_sysfs_entry queue_iosched_entry
= {
577 .attr
= {.name
= "scheduler", .mode
= 0644 },
578 .show
= elv_iosched_show
,
579 .store
= elv_iosched_store
,
582 static struct queue_sysfs_entry queue_hw_sector_size_entry
= {
583 .attr
= {.name
= "hw_sector_size", .mode
= 0444 },
584 .show
= queue_logical_block_size_show
,
587 static struct queue_sysfs_entry queue_logical_block_size_entry
= {
588 .attr
= {.name
= "logical_block_size", .mode
= 0444 },
589 .show
= queue_logical_block_size_show
,
592 static struct queue_sysfs_entry queue_physical_block_size_entry
= {
593 .attr
= {.name
= "physical_block_size", .mode
= 0444 },
594 .show
= queue_physical_block_size_show
,
597 static struct queue_sysfs_entry queue_chunk_sectors_entry
= {
598 .attr
= {.name
= "chunk_sectors", .mode
= 0444 },
599 .show
= queue_chunk_sectors_show
,
602 static struct queue_sysfs_entry queue_io_min_entry
= {
603 .attr
= {.name
= "minimum_io_size", .mode
= 0444 },
604 .show
= queue_io_min_show
,
607 static struct queue_sysfs_entry queue_io_opt_entry
= {
608 .attr
= {.name
= "optimal_io_size", .mode
= 0444 },
609 .show
= queue_io_opt_show
,
612 static struct queue_sysfs_entry queue_discard_granularity_entry
= {
613 .attr
= {.name
= "discard_granularity", .mode
= 0444 },
614 .show
= queue_discard_granularity_show
,
617 static struct queue_sysfs_entry queue_discard_max_hw_entry
= {
618 .attr
= {.name
= "discard_max_hw_bytes", .mode
= 0444 },
619 .show
= queue_discard_max_hw_show
,
622 static struct queue_sysfs_entry queue_discard_max_entry
= {
623 .attr
= {.name
= "discard_max_bytes", .mode
= 0644 },
624 .show
= queue_discard_max_show
,
625 .store
= queue_discard_max_store
,
628 static struct queue_sysfs_entry queue_discard_zeroes_data_entry
= {
629 .attr
= {.name
= "discard_zeroes_data", .mode
= 0444 },
630 .show
= queue_discard_zeroes_data_show
,
633 static struct queue_sysfs_entry queue_write_same_max_entry
= {
634 .attr
= {.name
= "write_same_max_bytes", .mode
= 0444 },
635 .show
= queue_write_same_max_show
,
638 static struct queue_sysfs_entry queue_write_zeroes_max_entry
= {
639 .attr
= {.name
= "write_zeroes_max_bytes", .mode
= 0444 },
640 .show
= queue_write_zeroes_max_show
,
643 static struct queue_sysfs_entry queue_nonrot_entry
= {
644 .attr
= {.name
= "rotational", .mode
= 0644 },
645 .show
= queue_show_nonrot
,
646 .store
= queue_store_nonrot
,
649 static struct queue_sysfs_entry queue_zoned_entry
= {
650 .attr
= {.name
= "zoned", .mode
= 0444 },
651 .show
= queue_zoned_show
,
654 static struct queue_sysfs_entry queue_nr_zones_entry
= {
655 .attr
= {.name
= "nr_zones", .mode
= 0444 },
656 .show
= queue_nr_zones_show
,
659 static struct queue_sysfs_entry queue_nomerges_entry
= {
660 .attr
= {.name
= "nomerges", .mode
= 0644 },
661 .show
= queue_nomerges_show
,
662 .store
= queue_nomerges_store
,
665 static struct queue_sysfs_entry queue_rq_affinity_entry
= {
666 .attr
= {.name
= "rq_affinity", .mode
= 0644 },
667 .show
= queue_rq_affinity_show
,
668 .store
= queue_rq_affinity_store
,
671 static struct queue_sysfs_entry queue_iostats_entry
= {
672 .attr
= {.name
= "iostats", .mode
= 0644 },
673 .show
= queue_show_iostats
,
674 .store
= queue_store_iostats
,
677 static struct queue_sysfs_entry queue_random_entry
= {
678 .attr
= {.name
= "add_random", .mode
= 0644 },
679 .show
= queue_show_random
,
680 .store
= queue_store_random
,
683 static struct queue_sysfs_entry queue_poll_entry
= {
684 .attr
= {.name
= "io_poll", .mode
= 0644 },
685 .show
= queue_poll_show
,
686 .store
= queue_poll_store
,
689 static struct queue_sysfs_entry queue_poll_delay_entry
= {
690 .attr
= {.name
= "io_poll_delay", .mode
= 0644 },
691 .show
= queue_poll_delay_show
,
692 .store
= queue_poll_delay_store
,
695 static struct queue_sysfs_entry queue_wc_entry
= {
696 .attr
= {.name
= "write_cache", .mode
= 0644 },
697 .show
= queue_wc_show
,
698 .store
= queue_wc_store
,
701 static struct queue_sysfs_entry queue_fua_entry
= {
702 .attr
= {.name
= "fua", .mode
= 0444 },
703 .show
= queue_fua_show
,
706 static struct queue_sysfs_entry queue_dax_entry
= {
707 .attr
= {.name
= "dax", .mode
= 0444 },
708 .show
= queue_dax_show
,
711 static struct queue_sysfs_entry queue_io_timeout_entry
= {
712 .attr
= {.name
= "io_timeout", .mode
= 0644 },
713 .show
= queue_io_timeout_show
,
714 .store
= queue_io_timeout_store
,
717 static struct queue_sysfs_entry queue_wb_lat_entry
= {
718 .attr
= {.name
= "wbt_lat_usec", .mode
= 0644 },
719 .show
= queue_wb_lat_show
,
720 .store
= queue_wb_lat_store
,
723 #ifdef CONFIG_BLK_DEV_THROTTLING_LOW
724 static struct queue_sysfs_entry throtl_sample_time_entry
= {
725 .attr
= {.name
= "throttle_sample_time", .mode
= 0644 },
726 .show
= blk_throtl_sample_time_show
,
727 .store
= blk_throtl_sample_time_store
,
731 static struct attribute
*default_attrs
[] = {
732 &queue_requests_entry
.attr
,
733 &queue_ra_entry
.attr
,
734 &queue_max_hw_sectors_entry
.attr
,
735 &queue_max_sectors_entry
.attr
,
736 &queue_max_segments_entry
.attr
,
737 &queue_max_discard_segments_entry
.attr
,
738 &queue_max_integrity_segments_entry
.attr
,
739 &queue_max_segment_size_entry
.attr
,
740 &queue_iosched_entry
.attr
,
741 &queue_hw_sector_size_entry
.attr
,
742 &queue_logical_block_size_entry
.attr
,
743 &queue_physical_block_size_entry
.attr
,
744 &queue_chunk_sectors_entry
.attr
,
745 &queue_io_min_entry
.attr
,
746 &queue_io_opt_entry
.attr
,
747 &queue_discard_granularity_entry
.attr
,
748 &queue_discard_max_entry
.attr
,
749 &queue_discard_max_hw_entry
.attr
,
750 &queue_discard_zeroes_data_entry
.attr
,
751 &queue_write_same_max_entry
.attr
,
752 &queue_write_zeroes_max_entry
.attr
,
753 &queue_nonrot_entry
.attr
,
754 &queue_zoned_entry
.attr
,
755 &queue_nr_zones_entry
.attr
,
756 &queue_nomerges_entry
.attr
,
757 &queue_rq_affinity_entry
.attr
,
758 &queue_iostats_entry
.attr
,
759 &queue_random_entry
.attr
,
760 &queue_poll_entry
.attr
,
761 &queue_wc_entry
.attr
,
762 &queue_fua_entry
.attr
,
763 &queue_dax_entry
.attr
,
764 &queue_wb_lat_entry
.attr
,
765 &queue_poll_delay_entry
.attr
,
766 &queue_io_timeout_entry
.attr
,
767 #ifdef CONFIG_BLK_DEV_THROTTLING_LOW
768 &throtl_sample_time_entry
.attr
,
773 #define to_queue(atr) container_of((atr), struct queue_sysfs_entry, attr)
776 queue_attr_show(struct kobject
*kobj
, struct attribute
*attr
, char *page
)
778 struct queue_sysfs_entry
*entry
= to_queue(attr
);
779 struct request_queue
*q
=
780 container_of(kobj
, struct request_queue
, kobj
);
785 mutex_lock(&q
->sysfs_lock
);
786 if (blk_queue_dying(q
)) {
787 mutex_unlock(&q
->sysfs_lock
);
790 res
= entry
->show(q
, page
);
791 mutex_unlock(&q
->sysfs_lock
);
796 queue_attr_store(struct kobject
*kobj
, struct attribute
*attr
,
797 const char *page
, size_t length
)
799 struct queue_sysfs_entry
*entry
= to_queue(attr
);
800 struct request_queue
*q
;
806 q
= container_of(kobj
, struct request_queue
, kobj
);
807 mutex_lock(&q
->sysfs_lock
);
808 if (blk_queue_dying(q
)) {
809 mutex_unlock(&q
->sysfs_lock
);
812 res
= entry
->store(q
, page
, length
);
813 mutex_unlock(&q
->sysfs_lock
);
817 static void blk_free_queue_rcu(struct rcu_head
*rcu_head
)
819 struct request_queue
*q
= container_of(rcu_head
, struct request_queue
,
821 kmem_cache_free(blk_requestq_cachep
, q
);
825 * __blk_release_queue - release a request queue
826 * @work: pointer to the release_work member of the request queue to be released
829 * This function is called when a block device is being unregistered. The
830 * process of releasing a request queue starts with blk_cleanup_queue, which
831 * set the appropriate flags and then calls blk_put_queue, that decrements
832 * the reference counter of the request queue. Once the reference counter
833 * of the request queue reaches zero, blk_release_queue is called to release
834 * all allocated resources of the request queue.
836 static void __blk_release_queue(struct work_struct
*work
)
838 struct request_queue
*q
= container_of(work
, typeof(*q
), release_work
);
840 if (test_bit(QUEUE_FLAG_POLL_STATS
, &q
->queue_flags
))
841 blk_stat_remove_callback(q
, q
->poll_cb
);
842 blk_stat_free_callback(q
->poll_cb
);
844 if (!blk_queue_dead(q
)) {
846 * Last reference was dropped without having called
847 * blk_cleanup_queue().
849 WARN_ONCE(blk_queue_init_done(q
),
850 "request queue %p has been registered but blk_cleanup_queue() has not been called for that queue\n",
855 WARN(blk_queue_root_blkg(q
),
856 "request queue %p is being released but it has not yet been removed from the blkcg controller\n",
859 blk_free_queue_stats(q
->stats
);
861 blk_queue_free_zone_bitmaps(q
);
866 blk_trace_shutdown(q
);
869 blk_mq_debugfs_unregister(q
);
871 bioset_exit(&q
->bio_split
);
873 ida_simple_remove(&blk_queue_ida
, q
->id
);
874 call_rcu(&q
->rcu_head
, blk_free_queue_rcu
);
877 static void blk_release_queue(struct kobject
*kobj
)
879 struct request_queue
*q
=
880 container_of(kobj
, struct request_queue
, kobj
);
882 INIT_WORK(&q
->release_work
, __blk_release_queue
);
883 schedule_work(&q
->release_work
);
886 static const struct sysfs_ops queue_sysfs_ops
= {
887 .show
= queue_attr_show
,
888 .store
= queue_attr_store
,
891 struct kobj_type blk_queue_ktype
= {
892 .sysfs_ops
= &queue_sysfs_ops
,
893 .default_attrs
= default_attrs
,
894 .release
= blk_release_queue
,
898 * blk_register_queue - register a block layer queue with sysfs
899 * @disk: Disk of which the request queue should be registered with sysfs.
901 int blk_register_queue(struct gendisk
*disk
)
904 struct device
*dev
= disk_to_dev(disk
);
905 struct request_queue
*q
= disk
->queue
;
910 WARN_ONCE(test_bit(QUEUE_FLAG_REGISTERED
, &q
->queue_flags
),
911 "%s is registering an already registered queue\n",
912 kobject_name(&dev
->kobj
));
913 blk_queue_flag_set(QUEUE_FLAG_REGISTERED
, q
);
916 * SCSI probing may synchronously create and destroy a lot of
917 * request_queues for non-existent devices. Shutting down a fully
918 * functional queue takes measureable wallclock time as RCU grace
919 * periods are involved. To avoid excessive latency in these
920 * cases, a request_queue starts out in a degraded mode which is
921 * faster to shut down and is made fully functional here as
922 * request_queues for non-existent devices never get registered.
924 if (!blk_queue_init_done(q
)) {
925 blk_queue_flag_set(QUEUE_FLAG_INIT_DONE
, q
);
926 percpu_ref_switch_to_percpu(&q
->q_usage_counter
);
929 ret
= blk_trace_init_sysfs(dev
);
933 /* Prevent changes through sysfs until registration is completed. */
934 mutex_lock(&q
->sysfs_lock
);
936 ret
= kobject_add(&q
->kobj
, kobject_get(&dev
->kobj
), "%s", "queue");
938 blk_trace_remove_sysfs(dev
);
942 if (queue_is_mq(q
)) {
943 __blk_mq_register_dev(dev
, q
);
944 blk_mq_debugfs_register(q
);
947 kobject_uevent(&q
->kobj
, KOBJ_ADD
);
949 wbt_enable_default(q
);
951 blk_throtl_register_queue(q
);
954 ret
= elv_register_queue(q
);
956 mutex_unlock(&q
->sysfs_lock
);
957 kobject_uevent(&q
->kobj
, KOBJ_REMOVE
);
958 kobject_del(&q
->kobj
);
959 blk_trace_remove_sysfs(dev
);
960 kobject_put(&dev
->kobj
);
966 mutex_unlock(&q
->sysfs_lock
);
969 EXPORT_SYMBOL_GPL(blk_register_queue
);
972 * blk_unregister_queue - counterpart of blk_register_queue()
973 * @disk: Disk of which the request queue should be unregistered from sysfs.
975 * Note: the caller is responsible for guaranteeing that this function is called
976 * after blk_register_queue() has finished.
978 void blk_unregister_queue(struct gendisk
*disk
)
980 struct request_queue
*q
= disk
->queue
;
985 /* Return early if disk->queue was never registered. */
986 if (!test_bit(QUEUE_FLAG_REGISTERED
, &q
->queue_flags
))
990 * Since sysfs_remove_dir() prevents adding new directory entries
991 * before removal of existing entries starts, protect against
992 * concurrent elv_iosched_store() calls.
994 mutex_lock(&q
->sysfs_lock
);
996 blk_queue_flag_clear(QUEUE_FLAG_REGISTERED
, q
);
999 * Remove the sysfs attributes before unregistering the queue data
1000 * structures that can be modified through sysfs.
1003 blk_mq_unregister_dev(disk_to_dev(disk
), q
);
1004 mutex_unlock(&q
->sysfs_lock
);
1006 kobject_uevent(&q
->kobj
, KOBJ_REMOVE
);
1007 kobject_del(&q
->kobj
);
1008 blk_trace_remove_sysfs(disk_to_dev(disk
));
1010 mutex_lock(&q
->sysfs_lock
);
1012 elv_unregister_queue(q
);
1013 mutex_unlock(&q
->sysfs_lock
);
1015 kobject_put(&disk_to_dev(disk
)->kobj
);