#ifndef _BCACHE_BTREE_INSERT_H #define _BCACHE_BTREE_INSERT_H #include "btree_cache.h" #include "btree_iter.h" #include "buckets.h" #include "journal.h" struct cache_set; struct bkey_format_state; struct bkey_format; struct btree; struct btree_reserve { struct disk_reservation disk_res; unsigned nr; struct btree *b[BTREE_RESERVE_MAX]; }; void __bch_btree_calc_format(struct bkey_format_state *, struct btree *); bool bch_btree_node_format_fits(struct btree *, struct bkey_format *); /* Btree node freeing/allocation: */ /* * Tracks a btree node that has been (or is about to be) freed in memory, but * has _not_ yet been freed on disk (because the write that makes the new * node(s) visible and frees the old hasn't completed yet) */ struct pending_btree_node_free { bool index_update_done; __le64 seq; enum btree_id btree_id; unsigned level; __BKEY_PADDED(key, BKEY_BTREE_PTR_VAL_U64s_MAX); }; /* * Tracks an in progress split/rewrite of a btree node and the update to the * parent node: * * When we split/rewrite a node, we do all the updates in memory without * waiting for any writes to complete - we allocate the new node(s) and update * the parent node, possibly recursively up to the root. * * The end result is that we have one or more new nodes being written - * possibly several, if there were multiple splits - and then a write (updating * an interior node) which will make all these new nodes visible. * * Additionally, as we split/rewrite nodes we free the old nodes - but the old * nodes can't be freed (their space on disk can't be reclaimed) until the * update to the interior node that makes the new node visible completes - * until then, the old nodes are still reachable on disk. * */ struct btree_interior_update { struct closure cl; struct cache_set *c; struct list_head list; /* What kind of update are we doing? */ enum { BTREE_INTERIOR_NO_UPDATE, BTREE_INTERIOR_UPDATING_NODE, BTREE_INTERIOR_UPDATING_ROOT, BTREE_INTERIOR_UPDATING_AS, } mode; /* * BTREE_INTERIOR_UPDATING_NODE: * The update that made the new nodes visible was a regular update to an * existing interior node - @b. We can't write out the update to @b * until the new nodes we created are finished writing, so we block @b * from writing by putting this btree_interior update on the * @b->write_blocked list with @write_blocked_list: */ struct btree *b; struct list_head write_blocked_list; /* * BTREE_INTERIOR_UPDATING_AS: btree node we updated was freed, so now * we're now blocking another btree_interior_update * @parent_as - btree_interior_update that's waiting on our nodes to finish * writing, before it can make new nodes visible on disk * @wait - list of child btree_interior_updates that are waiting on this * btree_interior_update to make all the new nodes visible before they can free * their old btree nodes */ struct btree_interior_update *parent_as; struct closure_waitlist wait; struct journal_entry_pin journal; /* * Nodes being freed: * Protected by c->btree_node_pending_free_lock */ struct pending_btree_node_free pending[BTREE_MAX_DEPTH + GC_MERGE_NODES]; unsigned nr_pending; /* Only here to reduce stack usage on recursive splits: */ struct keylist parent_keys; /* * Enough room for btree_split's keys without realloc - btree node * pointers never have crc/compression info, so we only need to acount * for the pointers for three keys */ u64 inline_keys[BKEY_BTREE_PTR_U64s_MAX * 3]; }; #define for_each_pending_btree_node_free(c, as, p) \ list_for_each_entry(as, &c->btree_interior_update_list, list) \ for (p = as->pending; p < as->pending + as->nr_pending; p++) void bch_btree_node_free_start(struct cache_set *, struct btree_interior_update *, struct btree *); void bch_btree_node_free_inmem(struct btree_iter *, struct btree *); void bch_btree_node_free_never_inserted(struct cache_set *, struct btree *); void btree_open_bucket_put(struct cache_set *c, struct btree *); struct btree *__btree_node_alloc_replacement(struct cache_set *, struct btree *, struct bkey_format, struct btree_reserve *); struct btree *btree_node_alloc_replacement(struct cache_set *, struct btree *, struct btree_reserve *); struct btree_interior_update *__bch_btree_interior_update_alloc(struct btree *[], unsigned, struct btree_iter *); struct btree_interior_update *bch_btree_interior_update_alloc(struct btree *, struct btree_iter *); void bch_btree_interior_update_will_free_node(struct btree_interior_update *, struct btree *); void bch_btree_set_root_initial(struct cache_set *, struct btree *, struct btree_reserve *); void bch_btree_reserve_put(struct cache_set *, struct btree_reserve *); struct btree_reserve *bch_btree_reserve_get(struct cache_set *, struct btree *, unsigned, bool, struct closure *); int bch_btree_root_alloc(struct cache_set *, enum btree_id, struct closure *); /* Inserting into a given leaf node (last stage of insert): */ void bch_btree_bset_insert(struct btree_iter *, struct btree *, struct btree_node_iter *, struct bkey_i *); void bch_btree_bset_insert_key(struct btree_iter *, struct btree *, struct btree_node_iter *, struct bkey_i *); void bch_btree_journal_key(struct btree_iter *, struct bkey_i *, struct journal_res *); static inline struct btree_node_entry *write_block(struct btree *b) { EBUG_ON(!b->written); return (void *) b->data + (b->written << 9); } static inline size_t bch_btree_keys_u64s_remaining(struct cache_set *c, struct btree *b) { struct bset *i = btree_bset_last(b); size_t bytes_used = bset_byte_offset(b, i) + __set_bytes(i, le16_to_cpu(i->u64s)); if (b->written == c->sb.btree_node_size) return 0; EBUG_ON(bytes_used > btree_bytes(c)); EBUG_ON(i != (b->written ? &write_block(b)->keys : &b->data->keys)); return (btree_bytes(c) - bytes_used) / sizeof(u64); } /* * write lock must be held on @b (else the dirty bset that we were going to * insert into could be written out from under us) */ static inline bool bch_btree_node_insert_fits(struct cache_set *c, struct btree *b, unsigned u64s) { if (b->keys.ops->is_extents) { /* The insert key might split an existing key * (bch_insert_fixup_extent() -> BCH_EXTENT_OVERLAP_MIDDLE case: */ u64s += BKEY_EXTENT_U64s_MAX; } return u64s <= bch_btree_keys_u64s_remaining(c, b); } void bch_btree_insert_node(struct btree *, struct btree_iter *, struct keylist *, struct btree_reserve *, struct btree_interior_update *as); /* Normal update interface: */ struct btree_insert { struct cache_set *c; struct disk_reservation *disk_res; struct extent_insert_hook *hook; unsigned flags; bool did_work; unsigned short nr; struct btree_insert_entry { struct btree_iter *iter; struct bkey_i *k; /* * true if entire key was inserted - can only be false for * extents */ bool done; } *entries; }; int __bch_btree_insert_at(struct btree_insert *, u64 *); #define _TENTH_ARG(_1, _2, _3, _4, _5, _6, _7, _8, _9, N, ...) N #define COUNT_ARGS(...) _TENTH_ARG(__VA_ARGS__, 9, 8, 7, 6, 5, 4, 3, 2, 1) #define BTREE_INSERT_ENTRY(_iter, _k) \ ((struct btree_insert_entry) { \ .iter = (_iter), \ .k = (_k), \ .done = false, \ }) /** * bch_btree_insert_at - insert one or more keys at iterator positions * @iter: btree iterator * @insert_key: key to insert * @disk_res: disk reservation * @hook: extent insert callback * * Return values: * -EINTR: locking changed, this function should be called again. Only returned * if passed BTREE_INSERT_ATOMIC. * -EROFS: cache set read only * -EIO: journal or btree node IO error */ #define bch_btree_insert_at(_c, _disk_res, _hook, \ _journal_seq, _flags, ...) \ __bch_btree_insert_at(&(struct btree_insert) { \ .c = (_c), \ .disk_res = (_disk_res), \ .hook = (_hook), \ .flags = (_flags), \ .nr = COUNT_ARGS(__VA_ARGS__), \ .entries = (struct btree_insert_entry[]) { \ __VA_ARGS__ \ }}, \ _journal_seq) /* * Don't drop/retake locks: instead return -EINTR if need to upgrade to intent * locks, -EAGAIN if need to wait on btree reserve */ #define BTREE_INSERT_ATOMIC (1 << 0) /* Don't check for -ENOSPC: */ #define BTREE_INSERT_NOFAIL (1 << 1) /* * Don't account key being insert (bch_mark_key) - only for journal replay, * where we've already marked the new keys: */ #define BTREE_INSERT_NO_MARK_KEY (1 << 2) int bch_btree_insert_list_at(struct btree_iter *, struct keylist *, struct disk_reservation *, struct extent_insert_hook *, u64 *, unsigned); static inline bool journal_res_insert_fits(struct btree_insert *trans, struct btree_insert_entry *insert, struct journal_res *res) { struct cache_set *c = insert->iter->c; unsigned u64s = 0; struct btree_insert_entry *i; /* If we're in journal replay we're not getting journal reservations: */ if (!test_bit(JOURNAL_REPLAY_DONE, &c->journal.flags)) return true; for (i = insert; i < trans->entries + trans->nr; i++) u64s += jset_u64s(i->k->k.u64s); return u64s <= res->u64s; } int bch_btree_insert_check_key(struct btree_iter *, struct bkey_i *); int bch_btree_insert(struct cache_set *, enum btree_id, struct bkey_i *, struct disk_reservation *, struct extent_insert_hook *, u64 *, int flags); int bch_btree_update(struct cache_set *, enum btree_id, struct bkey_i *, u64 *); int bch_btree_delete_range(struct cache_set *, enum btree_id, struct bpos, struct bpos, u64, struct disk_reservation *, struct extent_insert_hook *, u64 *); int bch_btree_node_rewrite(struct btree_iter *, struct btree *, struct closure *); #endif /* _BCACHE_BTREE_INSERT_H */