1 // SPDX-License-Identifier: GPL-2.0
3 * Primary bucket allocation code
5 * Copyright 2012 Google, Inc.
7 * Allocation in bcache is done in terms of buckets:
9 * Each bucket has associated an 8 bit gen; this gen corresponds to the gen in
10 * btree pointers - they must match for the pointer to be considered valid.
12 * Thus (assuming a bucket has no dirty data or metadata in it) we can reuse a
13 * bucket simply by incrementing its gen.
15 * The gens (along with the priorities; it's really the gens are important but
16 * the code is named as if it's the priorities) are written in an arbitrary list
17 * of buckets on disk, with a pointer to them in the journal header.
19 * When we invalidate a bucket, we have to write its new gen to disk and wait
20 * for that write to complete before we use it - otherwise after a crash we
21 * could have pointers that appeared to be good but pointed to data that had
24 * Since the gens and priorities are all stored contiguously on disk, we can
25 * batch this up: We fill up the free_inc list with freshly invalidated buckets,
26 * call prio_write(), and when prio_write() finishes we pull buckets off the
27 * free_inc list and optionally discard them.
29 * free_inc isn't the only freelist - if it was, we'd often to sleep while
30 * priorities and gens were being written before we could allocate. c->free is a
31 * smaller freelist, and buckets on that list are always ready to be used.
33 * If we've got discards enabled, that happens when a bucket moves from the
34 * free_inc list to the free list.
36 * There is another freelist, because sometimes we have buckets that we know
37 * have nothing pointing into them - these we can reuse without waiting for
38 * priorities to be rewritten. These come from freed btree nodes and buckets
39 * that garbage collection discovered no longer had valid keys pointing into
40 * them (because they were overwritten). That's the unused list - buckets on the
41 * unused list move to the free list, optionally being discarded in the process.
43 * It's also important to ensure that gens don't wrap around - with respect to
44 * either the oldest gen in the btree or the gen on disk. This is quite
45 * difficult to do in practice, but we explicitly guard against it anyways - if
46 * a bucket is in danger of wrapping around we simply skip invalidating it that
47 * time around, and we garbage collect or rewrite the priorities sooner than we
48 * would have otherwise.
50 * bch_bucket_alloc() allocates a single bucket from a specific cache.
52 * bch_bucket_alloc_set() allocates one bucket from different caches
55 * free_some_buckets() drives all the processes described above. It's called
56 * from bch_bucket_alloc() and a few other places that need to make sure free
59 * invalidate_buckets_(lru|fifo)() find buckets that are available to be
60 * invalidated, and then invalidate them and stick them on the free_inc list -
61 * in either lru or fifo order.
67 #include <linux/blkdev.h>
68 #include <linux/kthread.h>
69 #include <linux/random.h>
70 #include <trace/events/bcache.h>
72 #define MAX_OPEN_BUCKETS 128
74 /* Bucket heap / gen */
76 uint8_t bch_inc_gen(struct cache
*ca
, struct bucket
*b
)
78 uint8_t ret
= ++b
->gen
;
80 ca
->set
->need_gc
= max(ca
->set
->need_gc
, bucket_gc_gen(b
));
81 WARN_ON_ONCE(ca
->set
->need_gc
> BUCKET_GC_GEN_MAX
);
86 void bch_rescale_priorities(struct cache_set
*c
, int sectors
)
90 unsigned long next
= c
->nbuckets
* c
->cache
->sb
.bucket_size
/ 1024;
93 atomic_sub(sectors
, &c
->rescale
);
96 r
= atomic_read(&c
->rescale
);
100 } while (atomic_cmpxchg(&c
->rescale
, r
, r
+ next
) != r
);
102 mutex_lock(&c
->bucket_lock
);
104 c
->min_prio
= USHRT_MAX
;
107 for_each_bucket(b
, ca
)
109 b
->prio
!= BTREE_PRIO
&&
110 !atomic_read(&b
->pin
)) {
112 c
->min_prio
= min(c
->min_prio
, b
->prio
);
115 mutex_unlock(&c
->bucket_lock
);
119 * Background allocation thread: scans for buckets to be invalidated,
120 * invalidates them, rewrites prios/gens (marking them as invalidated on disk),
121 * then optionally issues discard commands to the newly free buckets, then puts
122 * them on the various freelists.
125 static inline bool can_inc_bucket_gen(struct bucket
*b
)
127 return bucket_gc_gen(b
) < BUCKET_GC_GEN_MAX
;
130 bool bch_can_invalidate_bucket(struct cache
*ca
, struct bucket
*b
)
132 return (ca
->set
->gc_mark_valid
|| b
->reclaimable_in_gc
) &&
133 ((!GC_MARK(b
) || GC_MARK(b
) == GC_MARK_RECLAIMABLE
) &&
134 !atomic_read(&b
->pin
) && can_inc_bucket_gen(b
));
137 void __bch_invalidate_one_bucket(struct cache
*ca
, struct bucket
*b
)
139 lockdep_assert_held(&ca
->set
->bucket_lock
);
140 BUG_ON(GC_MARK(b
) && GC_MARK(b
) != GC_MARK_RECLAIMABLE
);
142 if (GC_SECTORS_USED(b
))
143 trace_bcache_invalidate(ca
, b
- ca
->buckets
);
146 b
->prio
= INITIAL_PRIO
;
148 b
->reclaimable_in_gc
= 0;
151 static void bch_invalidate_one_bucket(struct cache
*ca
, struct bucket
*b
)
153 __bch_invalidate_one_bucket(ca
, b
);
155 fifo_push(&ca
->free_inc
, b
- ca
->buckets
);
159 * Determines what order we're going to reuse buckets, smallest bucket_prio()
160 * first: we also take into account the number of sectors of live data in that
161 * bucket, and in order for that multiply to make sense we have to scale bucket
163 * Thus, we scale the bucket priorities so that the bucket with the smallest
164 * prio is worth 1/8th of what INITIAL_PRIO is worth.
167 static inline unsigned int new_bucket_prio(struct cache
*ca
, struct bucket
*b
)
169 unsigned int min_prio
= (INITIAL_PRIO
- ca
->set
->min_prio
) / 8;
171 return (b
->prio
- ca
->set
->min_prio
+ min_prio
) * GC_SECTORS_USED(b
);
174 static inline bool new_bucket_max_cmp(const void *l
, const void *r
, void *args
)
176 struct bucket
**lhs
= (struct bucket
**)l
;
177 struct bucket
**rhs
= (struct bucket
**)r
;
178 struct cache
*ca
= args
;
180 return new_bucket_prio(ca
, *lhs
) > new_bucket_prio(ca
, *rhs
);
183 static inline bool new_bucket_min_cmp(const void *l
, const void *r
, void *args
)
185 struct bucket
**lhs
= (struct bucket
**)l
;
186 struct bucket
**rhs
= (struct bucket
**)r
;
187 struct cache
*ca
= args
;
189 return new_bucket_prio(ca
, *lhs
) < new_bucket_prio(ca
, *rhs
);
192 static void invalidate_buckets_lru(struct cache
*ca
)
195 const struct min_heap_callbacks bucket_max_cmp_callback
= {
196 .less
= new_bucket_max_cmp
,
199 const struct min_heap_callbacks bucket_min_cmp_callback
= {
200 .less
= new_bucket_min_cmp
,
206 for_each_bucket(b
, ca
) {
207 if (!bch_can_invalidate_bucket(ca
, b
))
210 if (!min_heap_full(&ca
->heap
))
211 min_heap_push(&ca
->heap
, &b
, &bucket_max_cmp_callback
, ca
);
212 else if (!new_bucket_max_cmp(&b
, min_heap_peek(&ca
->heap
), ca
)) {
213 ca
->heap
.data
[0] = b
;
214 min_heap_sift_down(&ca
->heap
, 0, &bucket_max_cmp_callback
, ca
);
218 min_heapify_all(&ca
->heap
, &bucket_min_cmp_callback
, ca
);
220 while (!fifo_full(&ca
->free_inc
)) {
223 * We don't want to be calling invalidate_buckets()
224 * multiple times when it can't do anything
226 ca
->invalidate_needs_gc
= 1;
230 b
= min_heap_peek(&ca
->heap
)[0];
231 min_heap_pop(&ca
->heap
, &bucket_min_cmp_callback
, ca
);
233 bch_invalidate_one_bucket(ca
, b
);
237 static void invalidate_buckets_fifo(struct cache
*ca
)
242 while (!fifo_full(&ca
->free_inc
)) {
243 if (ca
->fifo_last_bucket
< ca
->sb
.first_bucket
||
244 ca
->fifo_last_bucket
>= ca
->sb
.nbuckets
)
245 ca
->fifo_last_bucket
= ca
->sb
.first_bucket
;
247 b
= ca
->buckets
+ ca
->fifo_last_bucket
++;
249 if (bch_can_invalidate_bucket(ca
, b
))
250 bch_invalidate_one_bucket(ca
, b
);
252 if (++checked
>= ca
->sb
.nbuckets
) {
253 ca
->invalidate_needs_gc
= 1;
260 static void invalidate_buckets_random(struct cache
*ca
)
265 while (!fifo_full(&ca
->free_inc
)) {
268 get_random_bytes(&n
, sizeof(n
));
270 n
%= (size_t) (ca
->sb
.nbuckets
- ca
->sb
.first_bucket
);
271 n
+= ca
->sb
.first_bucket
;
275 if (bch_can_invalidate_bucket(ca
, b
))
276 bch_invalidate_one_bucket(ca
, b
);
278 if (++checked
>= ca
->sb
.nbuckets
/ 2) {
279 ca
->invalidate_needs_gc
= 1;
286 static void invalidate_buckets(struct cache
*ca
)
288 BUG_ON(ca
->invalidate_needs_gc
);
290 switch (CACHE_REPLACEMENT(&ca
->sb
)) {
291 case CACHE_REPLACEMENT_LRU
:
292 invalidate_buckets_lru(ca
);
294 case CACHE_REPLACEMENT_FIFO
:
295 invalidate_buckets_fifo(ca
);
297 case CACHE_REPLACEMENT_RANDOM
:
298 invalidate_buckets_random(ca
);
303 #define allocator_wait(ca, cond) \
306 set_current_state(TASK_INTERRUPTIBLE); \
310 mutex_unlock(&(ca)->set->bucket_lock); \
311 if (kthread_should_stop() || \
312 test_bit(CACHE_SET_IO_DISABLE, &ca->set->flags)) { \
313 set_current_state(TASK_RUNNING); \
318 mutex_lock(&(ca)->set->bucket_lock); \
320 __set_current_state(TASK_RUNNING); \
323 static int bch_allocator_push(struct cache
*ca
, long bucket
)
327 /* Prios/gens are actually the most important reserve */
328 if (fifo_push(&ca
->free
[RESERVE_PRIO
], bucket
))
331 for (i
= 0; i
< RESERVE_NR
; i
++)
332 if (fifo_push(&ca
->free
[i
], bucket
))
338 static int bch_allocator_thread(void *arg
)
340 struct cache
*ca
= arg
;
342 mutex_lock(&ca
->set
->bucket_lock
);
346 * First, we pull buckets off of the unused and free_inc lists,
347 * possibly issue discards to them, then we add the bucket to
353 if (!fifo_pop(&ca
->free_inc
, bucket
))
357 mutex_unlock(&ca
->set
->bucket_lock
);
358 blkdev_issue_discard(ca
->bdev
,
359 bucket_to_sector(ca
->set
, bucket
),
360 ca
->sb
.bucket_size
, GFP_KERNEL
);
361 mutex_lock(&ca
->set
->bucket_lock
);
364 allocator_wait(ca
, bch_allocator_push(ca
, bucket
));
365 wake_up(&ca
->set
->btree_cache_wait
);
366 wake_up(&ca
->set
->bucket_wait
);
370 * We've run out of free buckets, we need to find some buckets
371 * we can invalidate. First, invalidate them in memory and add
372 * them to the free_inc list:
376 allocator_wait(ca
, !ca
->invalidate_needs_gc
);
377 invalidate_buckets(ca
);
380 * Now, we write their new gens to disk so we can start writing
383 allocator_wait(ca
, !atomic_read(&ca
->set
->prio_blocked
));
384 if (CACHE_SYNC(&ca
->sb
)) {
386 * This could deadlock if an allocation with a btree
387 * node locked ever blocked - having the btree node
388 * locked would block garbage collection, but here we're
389 * waiting on garbage collection before we invalidate
392 * But this should be safe since the btree code always
393 * uses btree_check_reserve() before allocating now, and
394 * if it fails it blocks without btree nodes locked.
396 if (!fifo_full(&ca
->free_inc
))
397 goto retry_invalidate
;
399 if (bch_prio_write(ca
, false) < 0) {
400 ca
->invalidate_needs_gc
= 1;
406 wait_for_kthread_stop();
412 long bch_bucket_alloc(struct cache
*ca
, unsigned int reserve
, bool wait
)
419 /* No allocation if CACHE_SET_IO_DISABLE bit is set */
420 if (unlikely(test_bit(CACHE_SET_IO_DISABLE
, &ca
->set
->flags
)))
424 if (fifo_pop(&ca
->free
[RESERVE_NONE
], r
) ||
425 fifo_pop(&ca
->free
[reserve
], r
))
429 trace_bcache_alloc_fail(ca
, reserve
);
434 prepare_to_wait(&ca
->set
->bucket_wait
, &w
,
435 TASK_UNINTERRUPTIBLE
);
437 mutex_unlock(&ca
->set
->bucket_lock
);
439 mutex_lock(&ca
->set
->bucket_lock
);
440 } while (!fifo_pop(&ca
->free
[RESERVE_NONE
], r
) &&
441 !fifo_pop(&ca
->free
[reserve
], r
));
443 finish_wait(&ca
->set
->bucket_wait
, &w
);
445 if (ca
->alloc_thread
)
446 wake_up_process(ca
->alloc_thread
);
448 trace_bcache_alloc(ca
, reserve
);
450 if (expensive_debug_checks(ca
->set
)) {
455 for (iter
= 0; iter
< prio_buckets(ca
) * 2; iter
++)
456 BUG_ON(ca
->prio_buckets
[iter
] == (uint64_t) r
);
458 for (j
= 0; j
< RESERVE_NR
; j
++)
459 fifo_for_each(i
, &ca
->free
[j
], iter
)
461 fifo_for_each(i
, &ca
->free_inc
, iter
)
467 BUG_ON(atomic_read(&b
->pin
) != 1);
469 SET_GC_SECTORS_USED(b
, ca
->sb
.bucket_size
);
471 if (reserve
<= RESERVE_PRIO
) {
472 SET_GC_MARK(b
, GC_MARK_METADATA
);
474 b
->prio
= BTREE_PRIO
;
476 SET_GC_MARK(b
, GC_MARK_RECLAIMABLE
);
478 b
->prio
= INITIAL_PRIO
;
481 if (ca
->set
->avail_nbuckets
> 0) {
482 ca
->set
->avail_nbuckets
--;
483 bch_update_bucket_in_use(ca
->set
, &ca
->set
->gc_stats
);
489 void __bch_bucket_free(struct cache
*ca
, struct bucket
*b
)
492 SET_GC_SECTORS_USED(b
, 0);
494 if (ca
->set
->avail_nbuckets
< ca
->set
->nbuckets
) {
495 ca
->set
->avail_nbuckets
++;
496 bch_update_bucket_in_use(ca
->set
, &ca
->set
->gc_stats
);
500 void bch_bucket_free(struct cache_set
*c
, struct bkey
*k
)
504 for (i
= 0; i
< KEY_PTRS(k
); i
++)
505 __bch_bucket_free(c
->cache
, PTR_BUCKET(c
, k
, i
));
508 int __bch_bucket_alloc_set(struct cache_set
*c
, unsigned int reserve
,
509 struct bkey
*k
, bool wait
)
514 /* No allocation if CACHE_SET_IO_DISABLE bit is set */
515 if (unlikely(test_bit(CACHE_SET_IO_DISABLE
, &c
->flags
)))
518 lockdep_assert_held(&c
->bucket_lock
);
523 b
= bch_bucket_alloc(ca
, reserve
, wait
);
527 k
->ptr
[0] = MAKE_PTR(ca
->buckets
[b
].gen
,
528 bucket_to_sector(c
, b
),
536 int bch_bucket_alloc_set(struct cache_set
*c
, unsigned int reserve
,
537 struct bkey
*k
, bool wait
)
541 mutex_lock(&c
->bucket_lock
);
542 ret
= __bch_bucket_alloc_set(c
, reserve
, k
, wait
);
543 mutex_unlock(&c
->bucket_lock
);
547 /* Sector allocator */
550 struct list_head list
;
551 unsigned int last_write_point
;
552 unsigned int sectors_free
;
557 * We keep multiple buckets open for writes, and try to segregate different
558 * write streams for better cache utilization: first we try to segregate flash
559 * only volume write streams from cached devices, secondly we look for a bucket
560 * where the last write to it was sequential with the current write, and
561 * failing that we look for a bucket that was last used by the same task.
563 * The ideas is if you've got multiple tasks pulling data into the cache at the
564 * same time, you'll get better cache utilization if you try to segregate their
565 * data and preserve locality.
567 * For example, dirty sectors of flash only volume is not reclaimable, if their
568 * dirty sectors mixed with dirty sectors of cached device, such buckets will
569 * be marked as dirty and won't be reclaimed, though the dirty data of cached
570 * device have been written back to backend device.
572 * And say you've starting Firefox at the same time you're copying a
573 * bunch of files. Firefox will likely end up being fairly hot and stay in the
574 * cache awhile, but the data you copied might not be; if you wrote all that
575 * data to the same buckets it'd get invalidated at the same time.
577 * Both of those tasks will be doing fairly random IO so we can't rely on
578 * detecting sequential IO to segregate their data, but going off of the task
579 * should be a sane heuristic.
581 static struct open_bucket
*pick_data_bucket(struct cache_set
*c
,
582 const struct bkey
*search
,
583 unsigned int write_point
,
586 struct open_bucket
*ret
, *ret_task
= NULL
;
588 list_for_each_entry_reverse(ret
, &c
->data_buckets
, list
)
589 if (UUID_FLASH_ONLY(&c
->uuids
[KEY_INODE(&ret
->key
)]) !=
590 UUID_FLASH_ONLY(&c
->uuids
[KEY_INODE(search
)]))
592 else if (!bkey_cmp(&ret
->key
, search
))
594 else if (ret
->last_write_point
== write_point
)
597 ret
= ret_task
?: list_first_entry(&c
->data_buckets
,
598 struct open_bucket
, list
);
600 if (!ret
->sectors_free
&& KEY_PTRS(alloc
)) {
601 ret
->sectors_free
= c
->cache
->sb
.bucket_size
;
602 bkey_copy(&ret
->key
, alloc
);
606 if (!ret
->sectors_free
)
613 * Allocates some space in the cache to write to, and k to point to the newly
614 * allocated space, and updates KEY_SIZE(k) and KEY_OFFSET(k) (to point to the
615 * end of the newly allocated space).
617 * May allocate fewer sectors than @sectors, KEY_SIZE(k) indicates how many
618 * sectors were actually allocated.
620 * If s->writeback is true, will not fail.
622 bool bch_alloc_sectors(struct cache_set
*c
,
624 unsigned int sectors
,
625 unsigned int write_point
,
626 unsigned int write_prio
,
629 struct open_bucket
*b
;
630 BKEY_PADDED(key
) alloc
;
634 * We might have to allocate a new bucket, which we can't do with a
635 * spinlock held. So if we have to allocate, we drop the lock, allocate
636 * and then retry. KEY_PTRS() indicates whether alloc points to
637 * allocated bucket(s).
640 bkey_init(&alloc
.key
);
641 spin_lock(&c
->data_bucket_lock
);
643 while (!(b
= pick_data_bucket(c
, k
, write_point
, &alloc
.key
))) {
644 unsigned int watermark
= write_prio
648 spin_unlock(&c
->data_bucket_lock
);
650 if (bch_bucket_alloc_set(c
, watermark
, &alloc
.key
, wait
))
653 spin_lock(&c
->data_bucket_lock
);
657 * If we had to allocate, we might race and not need to allocate the
658 * second time we call pick_data_bucket(). If we allocated a bucket but
659 * didn't use it, drop the refcount bch_bucket_alloc_set() took:
661 if (KEY_PTRS(&alloc
.key
))
662 bkey_put(c
, &alloc
.key
);
664 for (i
= 0; i
< KEY_PTRS(&b
->key
); i
++)
665 EBUG_ON(ptr_stale(c
, &b
->key
, i
));
667 /* Set up the pointer to the space we're allocating: */
669 for (i
= 0; i
< KEY_PTRS(&b
->key
); i
++)
670 k
->ptr
[i
] = b
->key
.ptr
[i
];
672 sectors
= min(sectors
, b
->sectors_free
);
674 SET_KEY_OFFSET(k
, KEY_OFFSET(k
) + sectors
);
675 SET_KEY_SIZE(k
, sectors
);
676 SET_KEY_PTRS(k
, KEY_PTRS(&b
->key
));
679 * Move b to the end of the lru, and keep track of what this bucket was
682 list_move_tail(&b
->list
, &c
->data_buckets
);
683 bkey_copy_key(&b
->key
, k
);
684 b
->last_write_point
= write_point
;
686 b
->sectors_free
-= sectors
;
688 for (i
= 0; i
< KEY_PTRS(&b
->key
); i
++) {
689 SET_PTR_OFFSET(&b
->key
, i
, PTR_OFFSET(&b
->key
, i
) + sectors
);
691 atomic_long_add(sectors
,
692 &c
->cache
->sectors_written
);
695 if (b
->sectors_free
< c
->cache
->sb
.block_size
)
699 * k takes refcounts on the buckets it points to until it's inserted
700 * into the btree, but if we're done with this bucket we just transfer
701 * get_data_bucket()'s refcount.
704 for (i
= 0; i
< KEY_PTRS(&b
->key
); i
++)
705 atomic_inc(&PTR_BUCKET(c
, &b
->key
, i
)->pin
);
707 spin_unlock(&c
->data_bucket_lock
);
713 void bch_open_buckets_free(struct cache_set
*c
)
715 struct open_bucket
*b
;
717 while (!list_empty(&c
->data_buckets
)) {
718 b
= list_first_entry(&c
->data_buckets
,
719 struct open_bucket
, list
);
725 int bch_open_buckets_alloc(struct cache_set
*c
)
729 spin_lock_init(&c
->data_bucket_lock
);
731 for (i
= 0; i
< MAX_OPEN_BUCKETS
; i
++) {
732 struct open_bucket
*b
= kzalloc(sizeof(*b
), GFP_KERNEL
);
737 list_add(&b
->list
, &c
->data_buckets
);
743 int bch_cache_allocator_start(struct cache
*ca
)
745 struct task_struct
*k
= kthread_run(bch_allocator_thread
,
746 ca
, "bcache_allocator");
750 ca
->alloc_thread
= k
;