2 * bcache sysfs interfaces
4 * Copyright 2010, 2011 Kent Overstreet <kent.overstreet@gmail.com>
5 * Copyright 2012 Google, Inc.
12 #include "writeback.h"
14 #include <linux/blkdev.h>
15 #include <linux/sort.h>
17 static const char * const cache_replacement_policies[] = {
24 write_attribute(attach);
25 write_attribute(detach);
26 write_attribute(unregister);
27 write_attribute(stop);
28 write_attribute(clear_stats);
29 write_attribute(trigger_gc);
30 write_attribute(prune_cache);
31 write_attribute(flash_vol_create);
33 read_attribute(bucket_size);
34 read_attribute(block_size);
35 read_attribute(nbuckets);
36 read_attribute(tree_depth);
37 read_attribute(root_usage_percent);
38 read_attribute(priority_stats);
39 read_attribute(btree_cache_size);
40 read_attribute(btree_cache_max_chain);
41 read_attribute(cache_available_percent);
42 read_attribute(written);
43 read_attribute(btree_written);
44 read_attribute(metadata_written);
45 read_attribute(active_journal_entries);
47 sysfs_time_stats_attribute(btree_gc, sec, ms);
48 sysfs_time_stats_attribute(btree_split, sec, us);
49 sysfs_time_stats_attribute(btree_sort, ms, us);
50 sysfs_time_stats_attribute(btree_read, ms, us);
51 sysfs_time_stats_attribute(try_harder, ms, us);
53 read_attribute(btree_nodes);
54 read_attribute(btree_used_percent);
55 read_attribute(average_key_size);
56 read_attribute(dirty_data);
57 read_attribute(bset_tree_stats);
59 read_attribute(state);
60 read_attribute(cache_read_races);
61 read_attribute(writeback_keys_done);
62 read_attribute(writeback_keys_failed);
63 read_attribute(io_errors);
64 read_attribute(congested);
65 rw_attribute(congested_read_threshold_us);
66 rw_attribute(congested_write_threshold_us);
68 rw_attribute(sequential_cutoff);
69 rw_attribute(sequential_merge);
70 rw_attribute(data_csum);
71 rw_attribute(cache_mode);
72 rw_attribute(writeback_metadata);
73 rw_attribute(writeback_running);
74 rw_attribute(writeback_percent);
75 rw_attribute(writeback_delay);
76 rw_attribute(writeback_rate);
78 rw_attribute(writeback_rate_update_seconds);
79 rw_attribute(writeback_rate_d_term);
80 rw_attribute(writeback_rate_p_term_inverse);
81 rw_attribute(writeback_rate_d_smooth);
82 read_attribute(writeback_rate_debug);
84 read_attribute(stripe_size);
85 read_attribute(partial_stripes_expensive);
87 rw_attribute(synchronous);
88 rw_attribute(journal_delay_ms);
89 rw_attribute(discard);
90 rw_attribute(running);
92 rw_attribute(readahead);
93 rw_attribute(io_error_limit);
94 rw_attribute(io_error_halflife);
96 rw_attribute(key_merging_disabled);
97 rw_attribute(gc_always_rewrite);
98 rw_attribute(freelist_percent);
99 rw_attribute(cache_replacement_policy);
100 rw_attribute(btree_shrinker_disabled);
101 rw_attribute(copy_gc_enabled);
104 SHOW(__bch_cached_dev)
106 struct cached_dev *dc = container_of(kobj, struct cached_dev,
108 const char *states[] = { "no cache", "clean", "dirty", "inconsistent" };
110 #define var(stat) (dc->stat)
112 if (attr == &sysfs_cache_mode)
113 return bch_snprint_string_list(buf, PAGE_SIZE,
115 BDEV_CACHE_MODE(&dc->sb));
117 sysfs_printf(data_csum, "%i", dc->disk.data_csum);
118 var_printf(verify, "%i");
119 var_printf(writeback_metadata, "%i");
120 var_printf(writeback_running, "%i");
121 var_print(writeback_delay);
122 var_print(writeback_percent);
123 sysfs_print(writeback_rate, dc->writeback_rate.rate);
125 var_print(writeback_rate_update_seconds);
126 var_print(writeback_rate_d_term);
127 var_print(writeback_rate_p_term_inverse);
128 var_print(writeback_rate_d_smooth);
130 if (attr == &sysfs_writeback_rate_debug) {
135 bcache_dev_sectors_dirty(&dc->disk) << 9);
136 bch_hprint(derivative, dc->writeback_rate_derivative << 9);
137 bch_hprint(target, dc->writeback_rate_target << 9);
145 dc->writeback_rate.rate,
146 dc->writeback_rate_change,
147 dirty, derivative, target);
150 sysfs_hprint(dirty_data,
151 bcache_dev_sectors_dirty(&dc->disk) << 9);
153 sysfs_hprint(stripe_size, (1 << dc->disk.stripe_size_bits) << 9);
154 var_printf(partial_stripes_expensive, "%u");
156 var_printf(sequential_merge, "%i");
157 var_hprint(sequential_cutoff);
158 var_hprint(readahead);
160 sysfs_print(running, atomic_read(&dc->running));
161 sysfs_print(state, states[BDEV_STATE(&dc->sb)]);
163 if (attr == &sysfs_label) {
164 memcpy(buf, dc->sb.label, SB_LABEL_SIZE);
165 buf[SB_LABEL_SIZE + 1] = '\0';
173 SHOW_LOCKED(bch_cached_dev)
177 struct cached_dev *dc = container_of(kobj, struct cached_dev,
181 struct kobj_uevent_env *env;
183 #define d_strtoul(var) sysfs_strtoul(var, dc->var)
184 #define d_strtoi_h(var) sysfs_hatoi(var, dc->var)
186 sysfs_strtoul(data_csum, dc->disk.data_csum);
188 d_strtoul(writeback_metadata);
189 d_strtoul(writeback_running);
190 d_strtoul(writeback_delay);
191 sysfs_strtoul_clamp(writeback_rate,
192 dc->writeback_rate.rate, 1, 1000000);
193 sysfs_strtoul_clamp(writeback_percent, dc->writeback_percent, 0, 40);
195 d_strtoul(writeback_rate_update_seconds);
196 d_strtoul(writeback_rate_d_term);
197 d_strtoul(writeback_rate_p_term_inverse);
198 sysfs_strtoul_clamp(writeback_rate_p_term_inverse,
199 dc->writeback_rate_p_term_inverse, 1, INT_MAX);
200 d_strtoul(writeback_rate_d_smooth);
202 d_strtoul(sequential_merge);
203 d_strtoi_h(sequential_cutoff);
204 d_strtoi_h(readahead);
206 if (attr == &sysfs_clear_stats)
207 bch_cache_accounting_clear(&dc->accounting);
209 if (attr == &sysfs_running &&
210 strtoul_or_return(buf))
211 bch_cached_dev_run(dc);
213 if (attr == &sysfs_cache_mode) {
214 ssize_t v = bch_read_string_list(buf, bch_cache_modes + 1);
219 if ((unsigned) v != BDEV_CACHE_MODE(&dc->sb)) {
220 SET_BDEV_CACHE_MODE(&dc->sb, v);
221 bch_write_bdev_super(dc, NULL);
225 if (attr == &sysfs_label) {
226 /* note: endlines are preserved */
227 memcpy(dc->sb.label, buf, SB_LABEL_SIZE);
228 bch_write_bdev_super(dc, NULL);
230 memcpy(dc->disk.c->uuids[dc->disk.id].label,
232 bch_uuid_write(dc->disk.c);
234 env = kzalloc(sizeof(struct kobj_uevent_env), GFP_KERNEL);
235 add_uevent_var(env, "DRIVER=bcache");
236 add_uevent_var(env, "CACHED_UUID=%pU", dc->sb.uuid),
237 add_uevent_var(env, "CACHED_LABEL=%s", buf);
239 &disk_to_dev(dc->disk.disk)->kobj, KOBJ_CHANGE, env->envp);
243 if (attr == &sysfs_attach) {
244 if (bch_parse_uuid(buf, dc->sb.set_uuid) < 16)
247 list_for_each_entry(c, &bch_cache_sets, list) {
248 v = bch_cached_dev_attach(dc, c);
253 pr_err("Can't attach %s: cache set not found", buf);
257 if (attr == &sysfs_detach && dc->disk.c)
258 bch_cached_dev_detach(dc);
260 if (attr == &sysfs_stop)
261 bcache_device_stop(&dc->disk);
266 STORE(bch_cached_dev)
268 struct cached_dev *dc = container_of(kobj, struct cached_dev,
271 mutex_lock(&bch_register_lock);
272 size = __cached_dev_store(kobj, attr, buf, size);
274 if (attr == &sysfs_writeback_running)
275 bch_writeback_queue(dc);
277 if (attr == &sysfs_writeback_percent)
278 schedule_delayed_work(&dc->writeback_rate_update,
279 dc->writeback_rate_update_seconds * HZ);
281 mutex_unlock(&bch_register_lock);
285 static struct attribute *bch_cached_dev_files[] = {
293 &sysfs_writeback_metadata,
294 &sysfs_writeback_running,
295 &sysfs_writeback_delay,
296 &sysfs_writeback_percent,
297 &sysfs_writeback_rate,
298 &sysfs_writeback_rate_update_seconds,
299 &sysfs_writeback_rate_d_term,
300 &sysfs_writeback_rate_p_term_inverse,
301 &sysfs_writeback_rate_d_smooth,
302 &sysfs_writeback_rate_debug,
305 &sysfs_partial_stripes_expensive,
306 &sysfs_sequential_cutoff,
307 &sysfs_sequential_merge,
313 #ifdef CONFIG_BCACHE_DEBUG
318 KTYPE(bch_cached_dev);
322 struct bcache_device *d = container_of(kobj, struct bcache_device,
324 struct uuid_entry *u = &d->c->uuids[d->id];
326 sysfs_printf(data_csum, "%i", d->data_csum);
327 sysfs_hprint(size, u->sectors << 9);
329 if (attr == &sysfs_label) {
330 memcpy(buf, u->label, SB_LABEL_SIZE);
331 buf[SB_LABEL_SIZE + 1] = '\0';
339 STORE(__bch_flash_dev)
341 struct bcache_device *d = container_of(kobj, struct bcache_device,
343 struct uuid_entry *u = &d->c->uuids[d->id];
345 sysfs_strtoul(data_csum, d->data_csum);
347 if (attr == &sysfs_size) {
349 strtoi_h_or_return(buf, v);
352 bch_uuid_write(d->c);
353 set_capacity(d->disk, u->sectors);
356 if (attr == &sysfs_label) {
357 memcpy(u->label, buf, SB_LABEL_SIZE);
358 bch_uuid_write(d->c);
361 if (attr == &sysfs_unregister) {
362 atomic_set(&d->detaching, 1);
363 bcache_device_stop(d);
368 STORE_LOCKED(bch_flash_dev)
370 static struct attribute *bch_flash_dev_files[] = {
379 KTYPE(bch_flash_dev);
381 SHOW(__bch_cache_set)
383 unsigned root_usage(struct cache_set *c)
388 struct btree_iter iter;
396 rw_lock(false, b, b->level);
397 } while (b != c->root);
399 for_each_key_filter(b, k, &iter, bch_ptr_bad)
400 bytes += bkey_bytes(k);
404 return (bytes * 100) / btree_bytes(c);
407 size_t cache_size(struct cache_set *c)
412 mutex_lock(&c->bucket_lock);
413 list_for_each_entry(b, &c->btree_cache, list)
414 ret += 1 << (b->page_order + PAGE_SHIFT);
416 mutex_unlock(&c->bucket_lock);
420 unsigned cache_max_chain(struct cache_set *c)
423 struct hlist_head *h;
425 mutex_lock(&c->bucket_lock);
427 for (h = c->bucket_hash;
428 h < c->bucket_hash + (1 << BUCKET_HASH_BITS);
431 struct hlist_node *p;
439 mutex_unlock(&c->bucket_lock);
443 unsigned btree_used(struct cache_set *c)
445 return div64_u64(c->gc_stats.key_bytes * 100,
446 (c->gc_stats.nodes ?: 1) * btree_bytes(c));
449 unsigned average_key_size(struct cache_set *c)
451 return c->gc_stats.nkeys
452 ? div64_u64(c->gc_stats.data, c->gc_stats.nkeys)
456 struct cache_set *c = container_of(kobj, struct cache_set, kobj);
458 sysfs_print(synchronous, CACHE_SYNC(&c->sb));
459 sysfs_print(journal_delay_ms, c->journal_delay_ms);
460 sysfs_hprint(bucket_size, bucket_bytes(c));
461 sysfs_hprint(block_size, block_bytes(c));
462 sysfs_print(tree_depth, c->root->level);
463 sysfs_print(root_usage_percent, root_usage(c));
465 sysfs_hprint(btree_cache_size, cache_size(c));
466 sysfs_print(btree_cache_max_chain, cache_max_chain(c));
467 sysfs_print(cache_available_percent, 100 - c->gc_stats.in_use);
469 sysfs_print_time_stats(&c->btree_gc_time, btree_gc, sec, ms);
470 sysfs_print_time_stats(&c->btree_split_time, btree_split, sec, us);
471 sysfs_print_time_stats(&c->sort_time, btree_sort, ms, us);
472 sysfs_print_time_stats(&c->btree_read_time, btree_read, ms, us);
473 sysfs_print_time_stats(&c->try_harder_time, try_harder, ms, us);
475 sysfs_print(btree_used_percent, btree_used(c));
476 sysfs_print(btree_nodes, c->gc_stats.nodes);
477 sysfs_hprint(dirty_data, c->gc_stats.dirty);
478 sysfs_hprint(average_key_size, average_key_size(c));
480 sysfs_print(cache_read_races,
481 atomic_long_read(&c->cache_read_races));
483 sysfs_print(writeback_keys_done,
484 atomic_long_read(&c->writeback_keys_done));
485 sysfs_print(writeback_keys_failed,
486 atomic_long_read(&c->writeback_keys_failed));
488 /* See count_io_errors for why 88 */
489 sysfs_print(io_error_halflife, c->error_decay * 88);
490 sysfs_print(io_error_limit, c->error_limit >> IO_ERROR_SHIFT);
492 sysfs_hprint(congested,
493 ((uint64_t) bch_get_congested(c)) << 9);
494 sysfs_print(congested_read_threshold_us,
495 c->congested_read_threshold_us);
496 sysfs_print(congested_write_threshold_us,
497 c->congested_write_threshold_us);
499 sysfs_print(active_journal_entries, fifo_used(&c->journal.pin));
500 sysfs_printf(verify, "%i", c->verify);
501 sysfs_printf(key_merging_disabled, "%i", c->key_merging_disabled);
502 sysfs_printf(gc_always_rewrite, "%i", c->gc_always_rewrite);
503 sysfs_printf(btree_shrinker_disabled, "%i", c->shrinker_disabled);
504 sysfs_printf(copy_gc_enabled, "%i", c->copy_gc_enabled);
506 if (attr == &sysfs_bset_tree_stats)
507 return bch_bset_print_stats(c, buf);
511 SHOW_LOCKED(bch_cache_set)
513 STORE(__bch_cache_set)
515 struct cache_set *c = container_of(kobj, struct cache_set, kobj);
517 if (attr == &sysfs_unregister)
518 bch_cache_set_unregister(c);
520 if (attr == &sysfs_stop)
521 bch_cache_set_stop(c);
523 if (attr == &sysfs_synchronous) {
524 bool sync = strtoul_or_return(buf);
526 if (sync != CACHE_SYNC(&c->sb)) {
527 SET_CACHE_SYNC(&c->sb, sync);
528 bcache_write_super(c);
532 if (attr == &sysfs_flash_vol_create) {
535 strtoi_h_or_return(buf, v);
537 r = bch_flash_dev_create(c, v);
542 if (attr == &sysfs_clear_stats) {
543 atomic_long_set(&c->writeback_keys_done, 0);
544 atomic_long_set(&c->writeback_keys_failed, 0);
546 memset(&c->gc_stats, 0, sizeof(struct gc_stat));
547 bch_cache_accounting_clear(&c->accounting);
550 if (attr == &sysfs_trigger_gc)
553 if (attr == &sysfs_prune_cache) {
554 struct shrink_control sc;
555 sc.gfp_mask = GFP_KERNEL;
556 sc.nr_to_scan = strtoul_or_return(buf);
557 c->shrink.shrink(&c->shrink, &sc);
560 sysfs_strtoul(congested_read_threshold_us,
561 c->congested_read_threshold_us);
562 sysfs_strtoul(congested_write_threshold_us,
563 c->congested_write_threshold_us);
565 if (attr == &sysfs_io_error_limit)
566 c->error_limit = strtoul_or_return(buf) << IO_ERROR_SHIFT;
568 /* See count_io_errors() for why 88 */
569 if (attr == &sysfs_io_error_halflife)
570 c->error_decay = strtoul_or_return(buf) / 88;
572 sysfs_strtoul(journal_delay_ms, c->journal_delay_ms);
573 sysfs_strtoul(verify, c->verify);
574 sysfs_strtoul(key_merging_disabled, c->key_merging_disabled);
575 sysfs_strtoul(gc_always_rewrite, c->gc_always_rewrite);
576 sysfs_strtoul(btree_shrinker_disabled, c->shrinker_disabled);
577 sysfs_strtoul(copy_gc_enabled, c->copy_gc_enabled);
581 STORE_LOCKED(bch_cache_set)
583 SHOW(bch_cache_set_internal)
585 struct cache_set *c = container_of(kobj, struct cache_set, internal);
586 return bch_cache_set_show(&c->kobj, attr, buf);
589 STORE(bch_cache_set_internal)
591 struct cache_set *c = container_of(kobj, struct cache_set, internal);
592 return bch_cache_set_store(&c->kobj, attr, buf, size);
595 static void bch_cache_set_internal_release(struct kobject *k)
599 static struct attribute *bch_cache_set_files[] = {
603 &sysfs_journal_delay_ms,
604 &sysfs_flash_vol_create,
609 &sysfs_root_usage_percent,
610 &sysfs_btree_cache_size,
611 &sysfs_cache_available_percent,
613 &sysfs_average_key_size,
616 &sysfs_io_error_limit,
617 &sysfs_io_error_halflife,
619 &sysfs_congested_read_threshold_us,
620 &sysfs_congested_write_threshold_us,
624 KTYPE(bch_cache_set);
626 static struct attribute *bch_cache_set_internal_files[] = {
627 &sysfs_active_journal_entries,
629 sysfs_time_stats_attribute_list(btree_gc, sec, ms)
630 sysfs_time_stats_attribute_list(btree_split, sec, us)
631 sysfs_time_stats_attribute_list(btree_sort, ms, us)
632 sysfs_time_stats_attribute_list(btree_read, ms, us)
633 sysfs_time_stats_attribute_list(try_harder, ms, us)
636 &sysfs_btree_used_percent,
637 &sysfs_btree_cache_max_chain,
639 &sysfs_bset_tree_stats,
640 &sysfs_cache_read_races,
641 &sysfs_writeback_keys_done,
642 &sysfs_writeback_keys_failed,
646 #ifdef CONFIG_BCACHE_DEBUG
648 &sysfs_key_merging_disabled,
650 &sysfs_gc_always_rewrite,
651 &sysfs_btree_shrinker_disabled,
652 &sysfs_copy_gc_enabled,
655 KTYPE(bch_cache_set_internal);
659 struct cache *ca = container_of(kobj, struct cache, kobj);
661 sysfs_hprint(bucket_size, bucket_bytes(ca));
662 sysfs_hprint(block_size, block_bytes(ca));
663 sysfs_print(nbuckets, ca->sb.nbuckets);
664 sysfs_print(discard, ca->discard);
665 sysfs_hprint(written, atomic_long_read(&ca->sectors_written) << 9);
666 sysfs_hprint(btree_written,
667 atomic_long_read(&ca->btree_sectors_written) << 9);
668 sysfs_hprint(metadata_written,
669 (atomic_long_read(&ca->meta_sectors_written) +
670 atomic_long_read(&ca->btree_sectors_written)) << 9);
672 sysfs_print(io_errors,
673 atomic_read(&ca->io_errors) >> IO_ERROR_SHIFT);
675 sysfs_print(freelist_percent, ca->free.size * 100 /
676 ((size_t) ca->sb.nbuckets));
678 if (attr == &sysfs_cache_replacement_policy)
679 return bch_snprint_string_list(buf, PAGE_SIZE,
680 cache_replacement_policies,
681 CACHE_REPLACEMENT(&ca->sb));
683 if (attr == &sysfs_priority_stats) {
684 int cmp(const void *l, const void *r)
685 { return *((uint16_t *) r) - *((uint16_t *) l); }
687 size_t n = ca->sb.nbuckets, i, unused, btree;
689 /* Compute 31 quantiles */
690 uint16_t q[31], *p, *cached;
693 cached = p = vmalloc(ca->sb.nbuckets * sizeof(uint16_t));
697 mutex_lock(&ca->set->bucket_lock);
698 for (i = ca->sb.first_bucket; i < n; i++)
699 p[i] = ca->buckets[i].prio;
700 mutex_unlock(&ca->set->bucket_lock);
702 sort(p, n, sizeof(uint16_t), cmp, NULL);
708 unused = ca->sb.nbuckets - n;
710 while (cached < p + n &&
711 *cached == BTREE_PRIO)
717 for (i = 0; i < n; i++)
718 sum += INITIAL_PRIO - cached[i];
723 for (i = 0; i < ARRAY_SIZE(q); i++)
724 q[i] = INITIAL_PRIO - cached[n * (i + 1) /
725 (ARRAY_SIZE(q) + 1)];
729 ret = scnprintf(buf, PAGE_SIZE,
733 "Sectors per Q: %zu\n"
735 unused * 100 / (size_t) ca->sb.nbuckets,
736 btree * 100 / (size_t) ca->sb.nbuckets, sum,
737 n * ca->sb.bucket_size / (ARRAY_SIZE(q) + 1));
739 for (i = 0; i < ARRAY_SIZE(q); i++)
740 ret += scnprintf(buf + ret, PAGE_SIZE - ret,
744 ret += scnprintf(buf + ret, PAGE_SIZE - ret, "]\n");
751 SHOW_LOCKED(bch_cache)
755 struct cache *ca = container_of(kobj, struct cache, kobj);
757 if (attr == &sysfs_discard) {
758 bool v = strtoul_or_return(buf);
760 if (blk_queue_discard(bdev_get_queue(ca->bdev)))
763 if (v != CACHE_DISCARD(&ca->sb)) {
764 SET_CACHE_DISCARD(&ca->sb, v);
765 bcache_write_super(ca->set);
769 if (attr == &sysfs_cache_replacement_policy) {
770 ssize_t v = bch_read_string_list(buf, cache_replacement_policies);
775 if ((unsigned) v != CACHE_REPLACEMENT(&ca->sb)) {
776 mutex_lock(&ca->set->bucket_lock);
777 SET_CACHE_REPLACEMENT(&ca->sb, v);
778 mutex_unlock(&ca->set->bucket_lock);
780 bcache_write_super(ca->set);
784 if (attr == &sysfs_freelist_percent) {
785 DECLARE_FIFO(long, free);
787 size_t p = strtoul_or_return(buf);
790 ((size_t) ca->sb.nbuckets * p) / 100,
791 roundup_pow_of_two(ca->sb.nbuckets) >> 9,
792 ca->sb.nbuckets / 2);
794 if (!init_fifo_exact(&free, p, GFP_KERNEL))
797 mutex_lock(&ca->set->bucket_lock);
799 fifo_move(&free, &ca->free);
800 fifo_swap(&free, &ca->free);
802 mutex_unlock(&ca->set->bucket_lock);
804 while (fifo_pop(&free, i))
805 atomic_dec(&ca->buckets[i].pin);
810 if (attr == &sysfs_clear_stats) {
811 atomic_long_set(&ca->sectors_written, 0);
812 atomic_long_set(&ca->btree_sectors_written, 0);
813 atomic_long_set(&ca->meta_sectors_written, 0);
814 atomic_set(&ca->io_count, 0);
815 atomic_set(&ca->io_errors, 0);
820 STORE_LOCKED(bch_cache)
822 static struct attribute *bch_cache_files[] = {
826 &sysfs_priority_stats,
829 &sysfs_btree_written,
830 &sysfs_metadata_written,
833 &sysfs_freelist_percent,
834 &sysfs_cache_replacement_policy,