fs/bcachefs/buckets.h - linux - Git at Google

 /* SPDX-License-Identifier: GPL-2.0 */
 /*
  * Code for manipulating bucket marks for garbage collection.
  *
  * Copyright 2014 Datera, Inc.
  */

 #ifndef _BUCKETS_H
 #define _BUCKETS_H

 #include "buckets_types.h"
 #include "extents.h"
 #include "sb-members.h"

 static inline u64 sector_to_bucket(const struct bch_dev *ca, sector_t s)
 {
 	return div_u64(s, ca->mi.bucket_size);
 }

 static inline sector_t bucket_to_sector(const struct bch_dev *ca, size_t b)
 {
 	return ((sector_t) b) * ca->mi.bucket_size;
 }

 static inline sector_t bucket_remainder(const struct bch_dev *ca, sector_t s)
 {
 	u32 remainder;

 	div_u64_rem(s, ca->mi.bucket_size, &remainder);
 	return remainder;
 }

 static inline u64 sector_to_bucket_and_offset(const struct bch_dev *ca, sector_t s, u32 *offset)
 {
 	return div_u64_rem(s, ca->mi.bucket_size, offset);
 }

 #define for_each_bucket(_b, _buckets)				\
 	for (_b = (_buckets)->b + (_buckets)->first_bucket;	\
 	     _b < (_buckets)->b + (_buckets)->nbuckets; _b++)

 /*
  * Ugly hack alert:
  *
  * We need to cram a spinlock in a single byte, because that's what we have left
  * in struct bucket, and we care about the size of these - during fsck, we need
  * in memory state for every single bucket on every device.
  *
  * We used to do
  *   while (xchg(&b->lock, 1) cpu_relax();
  * but, it turns out not all architectures support xchg on a single byte.
  *
  * So now we use bit_spin_lock(), with fun games since we can't burn a whole
  * ulong for this - we just need to make sure the lock bit always ends up in the
  * first byte.
  */

 #if __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__
 #define BUCKET_LOCK_BITNR	0
 #else
 #define BUCKET_LOCK_BITNR	(BITS_PER_LONG - 1)
 #endif

 union ulong_byte_assert {
 	ulong	ulong;
 	u8	byte;
 };

 static inline void bucket_unlock(struct bucket *b)
 {
 	BUILD_BUG_ON(!((union ulong_byte_assert) { .ulong = 1UL << BUCKET_LOCK_BITNR }).byte);

 	clear_bit_unlock(BUCKET_LOCK_BITNR, (void *) &b->lock);
 	wake_up_bit((void *) &b->lock, BUCKET_LOCK_BITNR);
 }

 static inline void bucket_lock(struct bucket *b)
 {
 	wait_on_bit_lock((void *) &b->lock, BUCKET_LOCK_BITNR,
 			 TASK_UNINTERRUPTIBLE);
 }

 static inline struct bucket_array *gc_bucket_array(struct bch_dev *ca)
 {
 	return rcu_dereference_check(ca->buckets_gc,
 				     !ca->fs ||
 				     percpu_rwsem_is_held(&ca->fs->mark_lock) ||
 				     lockdep_is_held(&ca->fs->state_lock) ||
 				     lockdep_is_held(&ca->bucket_lock));
 }

 static inline struct bucket *gc_bucket(struct bch_dev *ca, size_t b)
 {
 	struct bucket_array *buckets = gc_bucket_array(ca);

 	if (b - buckets->first_bucket >= buckets->nbuckets_minus_first)
 		return NULL;
 	return buckets->b + b;
 }

 static inline struct bucket_gens *bucket_gens(struct bch_dev *ca)
 {
 	return rcu_dereference_check(ca->bucket_gens,
 				     !ca->fs ||
 				     percpu_rwsem_is_held(&ca->fs->mark_lock) ||
 				     lockdep_is_held(&ca->fs->state_lock) ||
 				     lockdep_is_held(&ca->bucket_lock));
 }

 static inline u8 *bucket_gen(struct bch_dev *ca, size_t b)
 {
 	struct bucket_gens *gens = bucket_gens(ca);

 	if (b - gens->first_bucket >= gens->nbuckets_minus_first)
 		return NULL;
 	return gens->b + b;
 }

 static inline u8 bucket_gen_get(struct bch_dev *ca, size_t b)
 {
 	rcu_read_lock();
 	u8 gen = *bucket_gen(ca, b);
 	rcu_read_unlock();
 	return gen;
 }

 static inline size_t PTR_BUCKET_NR(const struct bch_dev *ca,
 				   const struct bch_extent_ptr *ptr)
 {
 	return sector_to_bucket(ca, ptr->offset);
 }

 static inline struct bpos PTR_BUCKET_POS(const struct bch_dev *ca,
 					 const struct bch_extent_ptr *ptr)
 {
 	return POS(ptr->dev, PTR_BUCKET_NR(ca, ptr));
 }

 static inline struct bpos PTR_BUCKET_POS_OFFSET(const struct bch_dev *ca,
 						const struct bch_extent_ptr *ptr,
 						u32 *bucket_offset)
 {
 	return POS(ptr->dev, sector_to_bucket_and_offset(ca, ptr->offset, bucket_offset));
 }

 static inline struct bucket *PTR_GC_BUCKET(struct bch_dev *ca,
 					   const struct bch_extent_ptr *ptr)
 {
 	return gc_bucket(ca, PTR_BUCKET_NR(ca, ptr));
 }

 static inline enum bch_data_type ptr_data_type(const struct bkey *k,
 					       const struct bch_extent_ptr *ptr)
 {
 	if (bkey_is_btree_ptr(k))
 		return BCH_DATA_btree;

 	return ptr->cached ? BCH_DATA_cached : BCH_DATA_user;
 }

 static inline s64 ptr_disk_sectors(s64 sectors, struct extent_ptr_decoded p)
 {
 	EBUG_ON(sectors < 0);

 	return crc_is_compressed(p.crc)
 		? DIV_ROUND_UP_ULL(sectors * p.crc.compressed_size,
 				   p.crc.uncompressed_size)
 		: sectors;
 }

 static inline int gen_cmp(u8 a, u8 b)
 {
 	return (s8) (a - b);
 }

 static inline int gen_after(u8 a, u8 b)
 {
 	int r = gen_cmp(a, b);

 	return r > 0 ? r : 0;
 }

 static inline int dev_ptr_stale_rcu(struct bch_dev *ca, const struct bch_extent_ptr *ptr)
 {
 	u8 *gen = bucket_gen(ca, PTR_BUCKET_NR(ca, ptr));
 	if (!gen)
 		return -1;
 	return gen_after(*gen, ptr->gen);
 }

 /**
  * dev_ptr_stale() - check if a pointer points into a bucket that has been
  * invalidated.
  */
 static inline int dev_ptr_stale(struct bch_dev *ca, const struct bch_extent_ptr *ptr)
 {
 	rcu_read_lock();
 	int ret = dev_ptr_stale_rcu(ca, ptr);
 	rcu_read_unlock();

 	return ret;
 }

 /* Device usage: */

 void bch2_dev_usage_read_fast(struct bch_dev *, struct bch_dev_usage *);
 static inline struct bch_dev_usage bch2_dev_usage_read(struct bch_dev *ca)
 {
 	struct bch_dev_usage ret;

 	bch2_dev_usage_read_fast(ca, &ret);
 	return ret;
 }

 void bch2_dev_usage_to_text(struct printbuf *, struct bch_dev *, struct bch_dev_usage *);

 static inline u64 bch2_dev_buckets_reserved(struct bch_dev *ca, enum bch_watermark watermark)
 {
 	s64 reserved = 0;

 	switch (watermark) {
 	case BCH_WATERMARK_NR:
 		BUG();
 	case BCH_WATERMARK_stripe:
 		reserved += ca->mi.nbuckets >> 6;
 		fallthrough;
 	case BCH_WATERMARK_normal:
 		reserved += ca->mi.nbuckets >> 6;
 		fallthrough;
 	case BCH_WATERMARK_copygc:
 		reserved += ca->nr_btree_reserve;
 		fallthrough;
 	case BCH_WATERMARK_btree:
 		reserved += ca->nr_btree_reserve;
 		fallthrough;
 	case BCH_WATERMARK_btree_copygc:
 	case BCH_WATERMARK_reclaim:
 	case BCH_WATERMARK_interior_updates:
 		break;
 	}

 	return reserved;
 }

 static inline u64 dev_buckets_free(struct bch_dev *ca,
 				   struct bch_dev_usage usage,
 				   enum bch_watermark watermark)
 {
 	return max_t(s64, 0,
 		     usage.d[BCH_DATA_free].buckets -
 		     ca->nr_open_buckets -
 		     bch2_dev_buckets_reserved(ca, watermark));
 }

 static inline u64 __dev_buckets_available(struct bch_dev *ca,
 					  struct bch_dev_usage usage,
 					  enum bch_watermark watermark)
 {
 	return max_t(s64, 0,
 		       usage.d[BCH_DATA_free].buckets
 		     + usage.d[BCH_DATA_cached].buckets
 		     + usage.d[BCH_DATA_need_gc_gens].buckets
 		     + usage.d[BCH_DATA_need_discard].buckets
 		     - ca->nr_open_buckets
 		     - bch2_dev_buckets_reserved(ca, watermark));
 }

 static inline u64 dev_buckets_available(struct bch_dev *ca,
 					enum bch_watermark watermark)
 {
 	return __dev_buckets_available(ca, bch2_dev_usage_read(ca), watermark);
 }

 /* Filesystem usage: */

 static inline unsigned dev_usage_u64s(void)
 {
 	return sizeof(struct bch_dev_usage) / sizeof(u64);
 }

 struct bch_fs_usage_short
 bch2_fs_usage_read_short(struct bch_fs *);

 int bch2_bucket_ref_update(struct btree_trans *, struct bch_dev *,
 			   struct bkey_s_c, const struct bch_extent_ptr *,
 			   s64, enum bch_data_type, u8, u8, u32 *);

 int bch2_check_fix_ptrs(struct btree_trans *,
 			enum btree_id, unsigned, struct bkey_s_c,
 			enum btree_iter_update_trigger_flags);

 int bch2_trigger_extent(struct btree_trans *, enum btree_id, unsigned,
 			struct bkey_s_c, struct bkey_s,
 			enum btree_iter_update_trigger_flags);
 int bch2_trigger_reservation(struct btree_trans *, enum btree_id, unsigned,
 			  struct bkey_s_c, struct bkey_s,
 			  enum btree_iter_update_trigger_flags);

 #define trigger_run_overwrite_then_insert(_fn, _trans, _btree_id, _level, _old, _new, _flags)\
 ({												\
 	int ret = 0;										\
 												\
 	if (_old.k->type)									\
 		ret = _fn(_trans, _btree_id, _level, _old, _flags & ~BTREE_TRIGGER_insert);	\
 	if (!ret && _new.k->type)								\
 		ret = _fn(_trans, _btree_id, _level, _new.s_c, _flags & ~BTREE_TRIGGER_overwrite);\
 	ret;											\
 })

 void bch2_trans_account_disk_usage_change(struct btree_trans *);

 int bch2_trans_mark_metadata_bucket(struct btree_trans *, struct bch_dev *, u64,
 				    enum bch_data_type, unsigned,
 				    enum btree_iter_update_trigger_flags);
 int bch2_trans_mark_dev_sb(struct bch_fs *, struct bch_dev *,
 				    enum btree_iter_update_trigger_flags);
 int bch2_trans_mark_dev_sbs_flags(struct bch_fs *,
 				    enum btree_iter_update_trigger_flags);
 int bch2_trans_mark_dev_sbs(struct bch_fs *);

 static inline bool is_superblock_bucket(struct bch_dev *ca, u64 b)
 {
 	struct bch_sb_layout *layout = &ca->disk_sb.sb->layout;
 	u64 b_offset	= bucket_to_sector(ca, b);
 	u64 b_end	= bucket_to_sector(ca, b + 1);
 	unsigned i;

 	if (!b)
 		return true;

 	for (i = 0; i < layout->nr_superblocks; i++) {
 		u64 offset = le64_to_cpu(layout->sb_offset[i]);
 		u64 end = offset + (1 << layout->sb_max_size_bits);

 		if (!(offset >= b_end || end <= b_offset))
 			return true;
 	}

 	return false;
 }

 static inline const char *bch2_data_type_str(enum bch_data_type type)
 {
 	return type < BCH_DATA_NR
 		? __bch2_data_types[type]
 		: "(invalid data type)";
 }

 /* disk reservations: */

 static inline void bch2_disk_reservation_put(struct bch_fs *c,
 					     struct disk_reservation *res)
 {
 	if (res->sectors) {
 		this_cpu_sub(*c->online_reserved, res->sectors);
 		res->sectors = 0;
 	}
 }

 #define BCH_DISK_RESERVATION_NOFAIL		(1 << 0)

 int __bch2_disk_reservation_add(struct bch_fs *,
 				struct disk_reservation *,
 				u64, int);

 static inline int bch2_disk_reservation_add(struct bch_fs *c, struct disk_reservation *res,
 					    u64 sectors, int flags)
 {
 #ifdef __KERNEL__
 	u64 old, new;

 	old = this_cpu_read(c->pcpu->sectors_available);
 	do {
 		if (sectors > old)
 			return __bch2_disk_reservation_add(c, res, sectors, flags);

 		new = old - sectors;
 	} while (!this_cpu_try_cmpxchg(c->pcpu->sectors_available, &old, new));

 	this_cpu_add(*c->online_reserved, sectors);
 	res->sectors			+= sectors;
 	return 0;
 #else
 	return __bch2_disk_reservation_add(c, res, sectors, flags);
 #endif
 }

 static inline struct disk_reservation
 bch2_disk_reservation_init(struct bch_fs *c, unsigned nr_replicas)
 {
 	return (struct disk_reservation) {
 		.sectors	= 0,
 #if 0
 		/* not used yet: */
 		.gen		= c->capacity_gen,
 #endif
 		.nr_replicas	= nr_replicas,
 	};
 }

 static inline int bch2_disk_reservation_get(struct bch_fs *c,
 					    struct disk_reservation *res,
 					    u64 sectors, unsigned nr_replicas,
 					    int flags)
 {
 	*res = bch2_disk_reservation_init(c, nr_replicas);

 	return bch2_disk_reservation_add(c, res, sectors * nr_replicas, flags);
 }

 #define RESERVE_FACTOR	6

 static inline u64 avail_factor(u64 r)
 {
 	return div_u64(r << RESERVE_FACTOR, (1 << RESERVE_FACTOR) + 1);
 }

 void bch2_buckets_nouse_free(struct bch_fs *);
 int bch2_buckets_nouse_alloc(struct bch_fs *);

 int bch2_dev_buckets_resize(struct bch_fs *, struct bch_dev *, u64);
 void bch2_dev_buckets_free(struct bch_dev *);
 int bch2_dev_buckets_alloc(struct bch_fs *, struct bch_dev *);

 #endif /* _BUCKETS_H */
	/* SPDX-License-Identifier: GPL-2.0 */
	/*
	* Code for manipulating bucket marks for garbage collection.
	*
	* Copyright 2014 Datera, Inc.
	*/

	#ifndef _BUCKETS_H
	#define _BUCKETS_H

	#include "buckets_types.h"
	#include "extents.h"
	#include "sb-members.h"

	static inline u64 sector_to_bucket(const struct bch_dev *ca, sector_t s)
	{
	return div_u64(s, ca->mi.bucket_size);
	}

	static inline sector_t bucket_to_sector(const struct bch_dev *ca, size_t b)
	{
	return ((sector_t) b) * ca->mi.bucket_size;
	}

	static inline sector_t bucket_remainder(const struct bch_dev *ca, sector_t s)
	{
	u32 remainder;

	div_u64_rem(s, ca->mi.bucket_size, &remainder);
	return remainder;
	}

	static inline u64 sector_to_bucket_and_offset(const struct bch_dev ca, sector_t s, u32 offset)
	{
	return div_u64_rem(s, ca->mi.bucket_size, offset);
	}

	#define for_each_bucket(_b, _buckets) \
	for (_b = (_buckets)->b + (_buckets)->first_bucket; \
	_b < (_buckets)->b + (_buckets)->nbuckets; _b++)

	/*
	* Ugly hack alert:
	*
	* We need to cram a spinlock in a single byte, because that's what we have left
	* in struct bucket, and we care about the size of these - during fsck, we need
	* in memory state for every single bucket on every device.
	*
	* We used to do
	* while (xchg(&b->lock, 1) cpu_relax();
	* but, it turns out not all architectures support xchg on a single byte.
	*
	* So now we use bit_spin_lock(), with fun games since we can't burn a whole
	* ulong for this - we just need to make sure the lock bit always ends up in the
	* first byte.
	*/

	#if __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__
	#define BUCKET_LOCK_BITNR 0
	#else
	#define BUCKET_LOCK_BITNR (BITS_PER_LONG - 1)
	#endif

	union ulong_byte_assert {
	ulong ulong;
	u8 byte;
	};

	static inline void bucket_unlock(struct bucket *b)
	{
	BUILD_BUG_ON(!((union ulong_byte_assert) { .ulong = 1UL << BUCKET_LOCK_BITNR }).byte);

	clear_bit_unlock(BUCKET_LOCK_BITNR, (void *) &b->lock);
	wake_up_bit((void *) &b->lock, BUCKET_LOCK_BITNR);
	}

	static inline void bucket_lock(struct bucket *b)
	{
	wait_on_bit_lock((void *) &b->lock, BUCKET_LOCK_BITNR,
	TASK_UNINTERRUPTIBLE);
	}

	static inline struct bucket_array gc_bucket_array(struct bch_dev ca)
	{
	return rcu_dereference_check(ca->buckets_gc,
	!ca->fs \|\|
	percpu_rwsem_is_held(&ca->fs->mark_lock) \|\|
	lockdep_is_held(&ca->fs->state_lock) \|\|
	lockdep_is_held(&ca->bucket_lock));
	}

	static inline struct bucket gc_bucket(struct bch_dev ca, size_t b)
	{
	struct bucket_array *buckets = gc_bucket_array(ca);

	if (b - buckets->first_bucket >= buckets->nbuckets_minus_first)
	return NULL;
	return buckets->b + b;
	}

	static inline struct bucket_gens bucket_gens(struct bch_dev ca)
	{
	return rcu_dereference_check(ca->bucket_gens,
	!ca->fs \|\|
	percpu_rwsem_is_held(&ca->fs->mark_lock) \|\|
	lockdep_is_held(&ca->fs->state_lock) \|\|
	lockdep_is_held(&ca->bucket_lock));
	}

	static inline u8 bucket_gen(struct bch_dev ca, size_t b)
	{
	struct bucket_gens *gens = bucket_gens(ca);

	if (b - gens->first_bucket >= gens->nbuckets_minus_first)
	return NULL;
	return gens->b + b;
	}

	static inline u8 bucket_gen_get(struct bch_dev *ca, size_t b)
	{
	rcu_read_lock();
	u8 gen = *bucket_gen(ca, b);
	rcu_read_unlock();
	return gen;
	}

	static inline size_t PTR_BUCKET_NR(const struct bch_dev *ca,
	const struct bch_extent_ptr *ptr)
	{
	return sector_to_bucket(ca, ptr->offset);
	}

	static inline struct bpos PTR_BUCKET_POS(const struct bch_dev *ca,
	const struct bch_extent_ptr *ptr)
	{
	return POS(ptr->dev, PTR_BUCKET_NR(ca, ptr));
	}

	static inline struct bpos PTR_BUCKET_POS_OFFSET(const struct bch_dev *ca,
	const struct bch_extent_ptr *ptr,
	u32 *bucket_offset)
	{
	return POS(ptr->dev, sector_to_bucket_and_offset(ca, ptr->offset, bucket_offset));
	}

	static inline struct bucket PTR_GC_BUCKET(struct bch_dev ca,
	const struct bch_extent_ptr *ptr)
	{
	return gc_bucket(ca, PTR_BUCKET_NR(ca, ptr));
	}

	static inline enum bch_data_type ptr_data_type(const struct bkey *k,
	const struct bch_extent_ptr *ptr)
	{
	if (bkey_is_btree_ptr(k))
	return BCH_DATA_btree;

	return ptr->cached ? BCH_DATA_cached : BCH_DATA_user;
	}

	static inline s64 ptr_disk_sectors(s64 sectors, struct extent_ptr_decoded p)
	{
	EBUG_ON(sectors < 0);

	return crc_is_compressed(p.crc)
	? DIV_ROUND_UP_ULL(sectors * p.crc.compressed_size,
	p.crc.uncompressed_size)
	: sectors;
	}

	static inline int gen_cmp(u8 a, u8 b)
	{
	return (s8) (a - b);
	}

	static inline int gen_after(u8 a, u8 b)
	{
	int r = gen_cmp(a, b);

	return r > 0 ? r : 0;
	}

	static inline int dev_ptr_stale_rcu(struct bch_dev ca, const struct bch_extent_ptr ptr)
	{
	u8 *gen = bucket_gen(ca, PTR_BUCKET_NR(ca, ptr));
	if (!gen)
	return -1;
	return gen_after(*gen, ptr->gen);
	}

	/**
	* dev_ptr_stale() - check if a pointer points into a bucket that has been
	* invalidated.
	*/
	static inline int dev_ptr_stale(struct bch_dev ca, const struct bch_extent_ptr ptr)
	{
	rcu_read_lock();
	int ret = dev_ptr_stale_rcu(ca, ptr);
	rcu_read_unlock();

	return ret;
	}

	/* Device usage: */

	void bch2_dev_usage_read_fast(struct bch_dev , struct bch_dev_usage );
	static inline struct bch_dev_usage bch2_dev_usage_read(struct bch_dev *ca)
	{
	struct bch_dev_usage ret;

	bch2_dev_usage_read_fast(ca, &ret);
	return ret;
	}

	void bch2_dev_usage_to_text(struct printbuf , struct bch_dev , struct bch_dev_usage *);

	static inline u64 bch2_dev_buckets_reserved(struct bch_dev *ca, enum bch_watermark watermark)
	{
	s64 reserved = 0;

	switch (watermark) {
	case BCH_WATERMARK_NR:
	BUG();
	case BCH_WATERMARK_stripe:
	reserved += ca->mi.nbuckets >> 6;
	fallthrough;
	case BCH_WATERMARK_normal:
	reserved += ca->mi.nbuckets >> 6;
	fallthrough;
	case BCH_WATERMARK_copygc:
	reserved += ca->nr_btree_reserve;
	fallthrough;
	case BCH_WATERMARK_btree:
	reserved += ca->nr_btree_reserve;
	fallthrough;
	case BCH_WATERMARK_btree_copygc:
	case BCH_WATERMARK_reclaim:
	case BCH_WATERMARK_interior_updates:
	break;
	}

	return reserved;
	}

	static inline u64 dev_buckets_free(struct bch_dev *ca,
	struct bch_dev_usage usage,
	enum bch_watermark watermark)
	{
	return max_t(s64, 0,
	usage.d[BCH_DATA_free].buckets -
	ca->nr_open_buckets -
	bch2_dev_buckets_reserved(ca, watermark));
	}

	static inline u64 __dev_buckets_available(struct bch_dev *ca,
	struct bch_dev_usage usage,
	enum bch_watermark watermark)
	{
	return max_t(s64, 0,
	usage.d[BCH_DATA_free].buckets
	+ usage.d[BCH_DATA_cached].buckets
	+ usage.d[BCH_DATA_need_gc_gens].buckets
	+ usage.d[BCH_DATA_need_discard].buckets
	- ca->nr_open_buckets
	- bch2_dev_buckets_reserved(ca, watermark));
	}

	static inline u64 dev_buckets_available(struct bch_dev *ca,
	enum bch_watermark watermark)
	{
	return __dev_buckets_available(ca, bch2_dev_usage_read(ca), watermark);
	}

	/* Filesystem usage: */

	static inline unsigned dev_usage_u64s(void)
	{
	return sizeof(struct bch_dev_usage) / sizeof(u64);
	}

	struct bch_fs_usage_short
	bch2_fs_usage_read_short(struct bch_fs *);

	int bch2_bucket_ref_update(struct btree_trans , struct bch_dev ,
	struct bkey_s_c, const struct bch_extent_ptr *,
	s64, enum bch_data_type, u8, u8, u32 *);

	int bch2_check_fix_ptrs(struct btree_trans *,
	enum btree_id, unsigned, struct bkey_s_c,
	enum btree_iter_update_trigger_flags);

	int bch2_trigger_extent(struct btree_trans *, enum btree_id, unsigned,
	struct bkey_s_c, struct bkey_s,
	enum btree_iter_update_trigger_flags);
	int bch2_trigger_reservation(struct btree_trans *, enum btree_id, unsigned,
	struct bkey_s_c, struct bkey_s,
	enum btree_iter_update_trigger_flags);

	#define trigger_run_overwrite_then_insert(_fn, _trans, _btree_id, _level, _old, _new, _flags)\
	({ \
	int ret = 0; \
	\
	if (_old.k->type) \
	ret = _fn(_trans, _btree_id, _level, _old, _flags & ~BTREE_TRIGGER_insert); \
	if (!ret && _new.k->type) \
	ret = _fn(_trans, _btree_id, _level, _new.s_c, _flags & ~BTREE_TRIGGER_overwrite);\
	ret; \
	})

	void bch2_trans_account_disk_usage_change(struct btree_trans *);

	int bch2_trans_mark_metadata_bucket(struct btree_trans , struct bch_dev , u64,
	enum bch_data_type, unsigned,
	enum btree_iter_update_trigger_flags);
	int bch2_trans_mark_dev_sb(struct bch_fs , struct bch_dev ,
	enum btree_iter_update_trigger_flags);
	int bch2_trans_mark_dev_sbs_flags(struct bch_fs *,
	enum btree_iter_update_trigger_flags);
	int bch2_trans_mark_dev_sbs(struct bch_fs *);

	static inline bool is_superblock_bucket(struct bch_dev *ca, u64 b)
	{
	struct bch_sb_layout *layout = &ca->disk_sb.sb->layout;
	u64 b_offset = bucket_to_sector(ca, b);
	u64 b_end = bucket_to_sector(ca, b + 1);
	unsigned i;

	if (!b)
	return true;

	for (i = 0; i < layout->nr_superblocks; i++) {
	u64 offset = le64_to_cpu(layout->sb_offset[i]);
	u64 end = offset + (1 << layout->sb_max_size_bits);

	if (!(offset >= b_end \|\| end <= b_offset))
	return true;
	}

	return false;
	}

	static inline const char *bch2_data_type_str(enum bch_data_type type)
	{
	return type < BCH_DATA_NR
	? __bch2_data_types[type]
	: "(invalid data type)";
	}

	/* disk reservations: */

	static inline void bch2_disk_reservation_put(struct bch_fs *c,
	struct disk_reservation *res)
	{
	if (res->sectors) {
	this_cpu_sub(*c->online_reserved, res->sectors);
	res->sectors = 0;
	}
	}

	#define BCH_DISK_RESERVATION_NOFAIL (1 << 0)

	int __bch2_disk_reservation_add(struct bch_fs *,
	struct disk_reservation *,
	u64, int);

	static inline int bch2_disk_reservation_add(struct bch_fs c, struct disk_reservation res,
	u64 sectors, int flags)
	{
	#ifdef __KERNEL__
	u64 old, new;

	old = this_cpu_read(c->pcpu->sectors_available);
	do {
	if (sectors > old)
	return __bch2_disk_reservation_add(c, res, sectors, flags);

	new = old - sectors;
	} while (!this_cpu_try_cmpxchg(c->pcpu->sectors_available, &old, new));

	this_cpu_add(*c->online_reserved, sectors);
	res->sectors += sectors;
	return 0;
	#else
	return __bch2_disk_reservation_add(c, res, sectors, flags);
	#endif
	}

	static inline struct disk_reservation
	bch2_disk_reservation_init(struct bch_fs *c, unsigned nr_replicas)
	{
	return (struct disk_reservation) {
	.sectors = 0,
	#if 0
	/* not used yet: */
	.gen = c->capacity_gen,
	#endif
	.nr_replicas = nr_replicas,
	};
	}

	static inline int bch2_disk_reservation_get(struct bch_fs *c,
	struct disk_reservation *res,
	u64 sectors, unsigned nr_replicas,
	int flags)
	{
	*res = bch2_disk_reservation_init(c, nr_replicas);

	return bch2_disk_reservation_add(c, res, sectors * nr_replicas, flags);
	}

	#define RESERVE_FACTOR 6

	static inline u64 avail_factor(u64 r)
	{
	return div_u64(r << RESERVE_FACTOR, (1 << RESERVE_FACTOR) + 1);
	}

	void bch2_buckets_nouse_free(struct bch_fs *);
	int bch2_buckets_nouse_alloc(struct bch_fs *);

	int bch2_dev_buckets_resize(struct bch_fs , struct bch_dev , u64);
	void bch2_dev_buckets_free(struct bch_dev *);
	int bch2_dev_buckets_alloc(struct bch_fs , struct bch_dev );

	#endif /* _BUCKETS_H */