[linux-block.git] / fs / btrfs / block-rsv.h

/* SPDX-License-Identifier: GPL-2.0 */

#ifndef BTRFS_BLOCK_RSV_H
#define BTRFS_BLOCK_RSV_H

struct btrfs_trans_handle;
struct btrfs_root;
enum btrfs_reserve_flush_enum;

/*
 * Types of block reserves
 */
enum btrfs_rsv_type {
	BTRFS_BLOCK_RSV_GLOBAL,
	BTRFS_BLOCK_RSV_DELALLOC,
	BTRFS_BLOCK_RSV_TRANS,
	BTRFS_BLOCK_RSV_CHUNK,
	BTRFS_BLOCK_RSV_DELOPS,
	BTRFS_BLOCK_RSV_DELREFS,
	BTRFS_BLOCK_RSV_EMPTY,
	BTRFS_BLOCK_RSV_TEMP,
};

struct btrfs_block_rsv {
	u64 size;
	u64 reserved;
	struct btrfs_space_info *space_info;
	spinlock_t lock;
	bool full;
	bool failfast;
	/* Block reserve type, one of BTRFS_BLOCK_RSV_* */
	enum btrfs_rsv_type type:8;

	/*
	 * Qgroup equivalent for @size @reserved
	 *
	 * Unlike normal @size/@reserved for inode rsv, qgroup doesn't care
	 * about things like csum size nor how many tree blocks it will need to
	 * reserve.
	 *
	 * Qgroup cares more about net change of the extent usage.
	 *
	 * So for one newly inserted file extent, in worst case it will cause
	 * leaf split and level increase, nodesize for each file extent is
	 * already too much.
	 *
	 * In short, qgroup_size/reserved is the upper limit of possible needed
	 * qgroup metadata reservation.
	 */
	u64 qgroup_rsv_size;
	u64 qgroup_rsv_reserved;
};

void btrfs_init_block_rsv(struct btrfs_block_rsv *rsv, enum btrfs_rsv_type type);
void btrfs_init_root_block_rsv(struct btrfs_root *root);
struct btrfs_block_rsv *btrfs_alloc_block_rsv(struct btrfs_fs_info *fs_info,
					      enum btrfs_rsv_type type);
void btrfs_init_metadata_block_rsv(struct btrfs_fs_info *fs_info,
				   struct btrfs_block_rsv *rsv,
				   enum btrfs_rsv_type type);
void btrfs_free_block_rsv(struct btrfs_fs_info *fs_info,
			  struct btrfs_block_rsv *rsv);
int btrfs_block_rsv_add(struct btrfs_fs_info *fs_info,
			struct btrfs_block_rsv *block_rsv, u64 num_bytes,
			enum btrfs_reserve_flush_enum flush);
int btrfs_block_rsv_check(struct btrfs_block_rsv *block_rsv, int min_percent);
int btrfs_block_rsv_refill(struct btrfs_fs_info *fs_info,
			   struct btrfs_block_rsv *block_rsv, u64 min_reserved,
			   enum btrfs_reserve_flush_enum flush);
int btrfs_block_rsv_migrate(struct btrfs_block_rsv *src_rsv,
			    struct btrfs_block_rsv *dst_rsv, u64 num_bytes,
			    bool update_size);
int btrfs_block_rsv_use_bytes(struct btrfs_block_rsv *block_rsv, u64 num_bytes);
void btrfs_block_rsv_add_bytes(struct btrfs_block_rsv *block_rsv,
			       u64 num_bytes, bool update_size);
u64 btrfs_block_rsv_release(struct btrfs_fs_info *fs_info,
			      struct btrfs_block_rsv *block_rsv,
			      u64 num_bytes, u64 *qgroup_to_release);
void btrfs_update_global_block_rsv(struct btrfs_fs_info *fs_info);
void btrfs_init_global_block_rsv(struct btrfs_fs_info *fs_info);
void btrfs_release_global_block_rsv(struct btrfs_fs_info *fs_info);
struct btrfs_block_rsv *btrfs_use_block_rsv(struct btrfs_trans_handle *trans,
					    struct btrfs_root *root,
					    u32 blocksize);
static inline void btrfs_unuse_block_rsv(struct btrfs_fs_info *fs_info,
					 struct btrfs_block_rsv *block_rsv,
					 u32 blocksize)
{
	btrfs_block_rsv_add_bytes(block_rsv, blocksize, false);
	btrfs_block_rsv_release(fs_info, block_rsv, 0, NULL);
}

/*
 * Fast path to check if the reserve is full, may be carefully used outside of
 * locks.
 */
static inline bool btrfs_block_rsv_full(const struct btrfs_block_rsv *rsv)
{
	return data_race(rsv->full);
}

#endif /* BTRFS_BLOCK_RSV_H */
Commit	Line	Data
d12ffdd1 JB	1	/* SPDX-License-Identifier: GPL-2.0 */
	2
	3	#ifndef BTRFS_BLOCK_RSV_H
	4	#define BTRFS_BLOCK_RSV_H
	5
67f9c220	6	struct btrfs_trans_handle;
3683fbbc	7	struct btrfs_root;
d12ffdd1 JB	8	enum btrfs_reserve_flush_enum;
	9
	10	/*
	11	* Types of block reserves
	12	*/
8bfc9b2c	13	enum btrfs_rsv_type {
d12ffdd1 JB	14	BTRFS_BLOCK_RSV_GLOBAL,
	15	BTRFS_BLOCK_RSV_DELALLOC,
	16	BTRFS_BLOCK_RSV_TRANS,
	17	BTRFS_BLOCK_RSV_CHUNK,
	18	BTRFS_BLOCK_RSV_DELOPS,
	19	BTRFS_BLOCK_RSV_DELREFS,
	20	BTRFS_BLOCK_RSV_EMPTY,
	21	BTRFS_BLOCK_RSV_TEMP,
	22	};
	23
	24	struct btrfs_block_rsv {
	25	u64 size;
	26	u64 reserved;
	27	struct btrfs_space_info *space_info;
	28	spinlock_t lock;
c70c2c5b	29	bool full;
710d5921	30	bool failfast;
8bfc9b2c DS	31	/* Block reserve type, one of BTRFS_BLOCK_RSV_* */
8bfc9b2c DS	32	enum btrfs_rsv_type type:8;
d12ffdd1 JB	33
	34	/*
	35	* Qgroup equivalent for @size @reserved
	36	*
	37	* Unlike normal @size/@reserved for inode rsv, qgroup doesn't care
	38	* about things like csum size nor how many tree blocks it will need to
	39	* reserve.
	40	*
	41	* Qgroup cares more about net change of the extent usage.
	42	*
	43	* So for one newly inserted file extent, in worst case it will cause
	44	* leaf split and level increase, nodesize for each file extent is
	45	* already too much.
	46	*
	47	* In short, qgroup_size/reserved is the upper limit of possible needed
	48	* qgroup metadata reservation.
	49	*/
	50	u64 qgroup_rsv_size;
	51	u64 qgroup_rsv_reserved;
	52	};
	53
8bfc9b2c	54	void btrfs_init_block_rsv(struct btrfs_block_rsv *rsv, enum btrfs_rsv_type type);
2e608bd1	55	void btrfs_init_root_block_rsv(struct btrfs_root *root);
d12ffdd1	56	struct btrfs_block_rsv btrfs_alloc_block_rsv(struct btrfs_fs_info fs_info,
8bfc9b2c	57	enum btrfs_rsv_type type);
d12ffdd1 JB	58	void btrfs_init_metadata_block_rsv(struct btrfs_fs_info *fs_info,
d12ffdd1 JB	59	struct btrfs_block_rsv *rsv,
8bfc9b2c	60	enum btrfs_rsv_type type);
d12ffdd1 JB	61	void btrfs_free_block_rsv(struct btrfs_fs_info *fs_info,
d12ffdd1 JB	62	struct btrfs_block_rsv *rsv);
9270501c	63	int btrfs_block_rsv_add(struct btrfs_fs_info *fs_info,
d12ffdd1 JB	64	struct btrfs_block_rsv *block_rsv, u64 num_bytes,
d12ffdd1 JB	65	enum btrfs_reserve_flush_enum flush);
428c8e03	66	int btrfs_block_rsv_check(struct btrfs_block_rsv *block_rsv, int min_percent);
9270501c	67	int btrfs_block_rsv_refill(struct btrfs_fs_info *fs_info,
d12ffdd1 JB	68	struct btrfs_block_rsv *block_rsv, u64 min_reserved,
	69	enum btrfs_reserve_flush_enum flush);
	70	int btrfs_block_rsv_migrate(struct btrfs_block_rsv *src_rsv,
	71	struct btrfs_block_rsv *dst_rsv, u64 num_bytes,
	72	bool update_size);
	73	int btrfs_block_rsv_use_bytes(struct btrfs_block_rsv *block_rsv, u64 num_bytes);
0b50174a JB	74	void btrfs_block_rsv_add_bytes(struct btrfs_block_rsv *block_rsv,
0b50174a JB	75	u64 num_bytes, bool update_size);
63f018be	76	u64 btrfs_block_rsv_release(struct btrfs_fs_info *fs_info,
fed14b32 JB	77	struct btrfs_block_rsv *block_rsv,
fed14b32 JB	78	u64 num_bytes, u64 *qgroup_to_release);
67f9c220 JB	79	void btrfs_update_global_block_rsv(struct btrfs_fs_info *fs_info);
	80	void btrfs_init_global_block_rsv(struct btrfs_fs_info *fs_info);
	81	void btrfs_release_global_block_rsv(struct btrfs_fs_info *fs_info);
	82	struct btrfs_block_rsv btrfs_use_block_rsv(struct btrfs_trans_handle trans,
	83	struct btrfs_root *root,
	84	u32 blocksize);
67f9c220 JB	85	static inline void btrfs_unuse_block_rsv(struct btrfs_fs_info *fs_info,
	86	struct btrfs_block_rsv *block_rsv,
	87	u32 blocksize)
	88	{
	89	btrfs_block_rsv_add_bytes(block_rsv, blocksize, false);
63f018be	90	btrfs_block_rsv_release(fs_info, block_rsv, 0, NULL);
67f9c220 JB	91	}
67f9c220 JB	92
748f553c DS	93	/*
	94	* Fast path to check if the reserve is full, may be carefully used outside of
	95	* locks.
	96	*/
	97	static inline bool btrfs_block_rsv_full(const struct btrfs_block_rsv *rsv)
	98	{
	99	return data_race(rsv->full);
	100	}
	101
d12ffdd1	102	#endif /* BTRFS_BLOCK_RSV_H */