Linux Audio

Check our new training course

In-person Linux kernel drivers training

Jun 16-20, 2025
Register
Loading...
v4.17
  1/* SPDX-License-Identifier: GPL-2.0 */
  2/*
  3 * Copyright (C) 2009 Oracle.  All rights reserved.
  4 */
  5
  6#ifndef BTRFS_FREE_SPACE_CACHE_H
  7#define BTRFS_FREE_SPACE_CACHE_H
  8
 
 
 
 
 
 
 
 
 
 
 
 
 
 
  9struct btrfs_free_space {
 10	struct rb_node offset_index;
 11	u64 offset;
 12	u64 bytes;
 13	u64 max_extent_size;
 14	unsigned long *bitmap;
 15	struct list_head list;
 
 
 16};
 17
 
 
 
 
 
 
 
 
 
 
 
 18struct btrfs_free_space_ctl {
 19	spinlock_t tree_lock;
 20	struct rb_root free_space_offset;
 21	u64 free_space;
 22	int extents_thresh;
 23	int free_extents;
 24	int total_bitmaps;
 25	int unit;
 26	u64 start;
 
 
 27	const struct btrfs_free_space_op *op;
 28	void *private;
 29	struct mutex cache_writeout_mutex;
 30	struct list_head trimming_ranges;
 31};
 32
 33struct btrfs_free_space_op {
 34	void (*recalc_thresholds)(struct btrfs_free_space_ctl *ctl);
 35	bool (*use_bitmap)(struct btrfs_free_space_ctl *ctl,
 36			   struct btrfs_free_space *info);
 37};
 38
 39struct btrfs_io_ctl;
 
 
 
 
 
 
 
 
 
 
 
 
 40
 41struct inode *lookup_free_space_inode(struct btrfs_fs_info *fs_info,
 42				      struct btrfs_block_group_cache
 43				      *block_group, struct btrfs_path *path);
 44int create_free_space_inode(struct btrfs_fs_info *fs_info,
 45			    struct btrfs_trans_handle *trans,
 46			    struct btrfs_block_group_cache *block_group,
 47			    struct btrfs_path *path);
 48
 49int btrfs_check_trunc_cache_free_space(struct btrfs_fs_info *fs_info,
 50				       struct btrfs_block_rsv *rsv);
 51int btrfs_truncate_free_space_cache(struct btrfs_trans_handle *trans,
 52				    struct btrfs_block_group_cache *block_group,
 53				    struct inode *inode);
 54int load_free_space_cache(struct btrfs_fs_info *fs_info,
 55			  struct btrfs_block_group_cache *block_group);
 56int btrfs_wait_cache_io(struct btrfs_trans_handle *trans,
 57			struct btrfs_block_group_cache *block_group,
 58			struct btrfs_path *path);
 59int btrfs_write_out_cache(struct btrfs_fs_info *fs_info,
 60			  struct btrfs_trans_handle *trans,
 61			  struct btrfs_block_group_cache *block_group,
 62			  struct btrfs_path *path);
 63struct inode *lookup_free_ino_inode(struct btrfs_root *root,
 64				    struct btrfs_path *path);
 65int create_free_ino_inode(struct btrfs_root *root,
 66			  struct btrfs_trans_handle *trans,
 67			  struct btrfs_path *path);
 68int load_free_ino_cache(struct btrfs_fs_info *fs_info,
 69			struct btrfs_root *root);
 70int btrfs_write_out_ino_cache(struct btrfs_root *root,
 71			      struct btrfs_trans_handle *trans,
 72			      struct btrfs_path *path,
 73			      struct inode *inode);
 74
 75void btrfs_init_free_space_ctl(struct btrfs_block_group_cache *block_group);
 76int __btrfs_add_free_space(struct btrfs_fs_info *fs_info,
 77			   struct btrfs_free_space_ctl *ctl,
 78			   u64 bytenr, u64 size);
 79static inline int
 80btrfs_add_free_space(struct btrfs_block_group_cache *block_group,
 81		     u64 bytenr, u64 size)
 82{
 83	return __btrfs_add_free_space(block_group->fs_info,
 84				      block_group->free_space_ctl,
 85				      bytenr, size);
 86}
 87int btrfs_remove_free_space(struct btrfs_block_group_cache *block_group,
 88			    u64 bytenr, u64 size);
 89void __btrfs_remove_free_space_cache(struct btrfs_free_space_ctl *ctl);
 90void btrfs_remove_free_space_cache(struct btrfs_block_group_cache
 91				     *block_group);
 92u64 btrfs_find_space_for_alloc(struct btrfs_block_group_cache *block_group,
 93			       u64 offset, u64 bytes, u64 empty_size,
 94			       u64 *max_extent_size);
 95u64 btrfs_find_ino_for_alloc(struct btrfs_root *fs_root);
 96void btrfs_dump_free_space(struct btrfs_block_group_cache *block_group,
 97			   u64 bytes);
 98int btrfs_find_space_cluster(struct btrfs_fs_info *fs_info,
 99			     struct btrfs_block_group_cache *block_group,
100			     struct btrfs_free_cluster *cluster,
101			     u64 offset, u64 bytes, u64 empty_size);
102void btrfs_init_free_cluster(struct btrfs_free_cluster *cluster);
103u64 btrfs_alloc_from_cluster(struct btrfs_block_group_cache *block_group,
104			     struct btrfs_free_cluster *cluster, u64 bytes,
105			     u64 min_start, u64 *max_extent_size);
106int btrfs_return_cluster_to_free_space(
107			       struct btrfs_block_group_cache *block_group,
108			       struct btrfs_free_cluster *cluster);
109int btrfs_trim_block_group(struct btrfs_block_group_cache *block_group,
110			   u64 *trimmed, u64 start, u64 end, u64 minlen);
 
 
 
 
 
 
111
112/* Support functions for running our sanity tests */
113#ifdef CONFIG_BTRFS_FS_RUN_SANITY_TESTS
114int test_add_free_space_entry(struct btrfs_block_group_cache *cache,
115			      u64 offset, u64 bytes, bool bitmap);
116int test_check_exists(struct btrfs_block_group_cache *cache,
117		      u64 offset, u64 bytes);
118#endif
119
120#endif
v5.9
  1/* SPDX-License-Identifier: GPL-2.0 */
  2/*
  3 * Copyright (C) 2009 Oracle.  All rights reserved.
  4 */
  5
  6#ifndef BTRFS_FREE_SPACE_CACHE_H
  7#define BTRFS_FREE_SPACE_CACHE_H
  8
  9/*
 10 * This is the trim state of an extent or bitmap.
 11 *
 12 * BTRFS_TRIM_STATE_TRIMMING is special and used to maintain the state of a
 13 * bitmap as we may need several trims to fully trim a single bitmap entry.
 14 * This is reset should any free space other than trimmed space be added to the
 15 * bitmap.
 16 */
 17enum btrfs_trim_state {
 18	BTRFS_TRIM_STATE_UNTRIMMED,
 19	BTRFS_TRIM_STATE_TRIMMED,
 20	BTRFS_TRIM_STATE_TRIMMING,
 21};
 22
 23struct btrfs_free_space {
 24	struct rb_node offset_index;
 25	u64 offset;
 26	u64 bytes;
 27	u64 max_extent_size;
 28	unsigned long *bitmap;
 29	struct list_head list;
 30	enum btrfs_trim_state trim_state;
 31	s32 bitmap_extents;
 32};
 33
 34static inline bool btrfs_free_space_trimmed(struct btrfs_free_space *info)
 35{
 36	return (info->trim_state == BTRFS_TRIM_STATE_TRIMMED);
 37}
 38
 39static inline bool btrfs_free_space_trimming_bitmap(
 40					    struct btrfs_free_space *info)
 41{
 42	return (info->trim_state == BTRFS_TRIM_STATE_TRIMMING);
 43}
 44
 45struct btrfs_free_space_ctl {
 46	spinlock_t tree_lock;
 47	struct rb_root free_space_offset;
 48	u64 free_space;
 49	int extents_thresh;
 50	int free_extents;
 51	int total_bitmaps;
 52	int unit;
 53	u64 start;
 54	s32 discardable_extents[BTRFS_STAT_NR_ENTRIES];
 55	s64 discardable_bytes[BTRFS_STAT_NR_ENTRIES];
 56	const struct btrfs_free_space_op *op;
 57	void *private;
 58	struct mutex cache_writeout_mutex;
 59	struct list_head trimming_ranges;
 60};
 61
 62struct btrfs_free_space_op {
 63	void (*recalc_thresholds)(struct btrfs_free_space_ctl *ctl);
 64	bool (*use_bitmap)(struct btrfs_free_space_ctl *ctl,
 65			   struct btrfs_free_space *info);
 66};
 67
 68struct btrfs_io_ctl {
 69	void *cur, *orig;
 70	struct page *page;
 71	struct page **pages;
 72	struct btrfs_fs_info *fs_info;
 73	struct inode *inode;
 74	unsigned long size;
 75	int index;
 76	int num_pages;
 77	int entries;
 78	int bitmaps;
 79	unsigned check_crcs:1;
 80};
 81
 82struct inode *lookup_free_space_inode(struct btrfs_block_group *block_group,
 83		struct btrfs_path *path);
 84int create_free_space_inode(struct btrfs_trans_handle *trans,
 85			    struct btrfs_block_group *block_group,
 
 
 86			    struct btrfs_path *path);
 87
 88int btrfs_check_trunc_cache_free_space(struct btrfs_fs_info *fs_info,
 89				       struct btrfs_block_rsv *rsv);
 90int btrfs_truncate_free_space_cache(struct btrfs_trans_handle *trans,
 91				    struct btrfs_block_group *block_group,
 92				    struct inode *inode);
 93int load_free_space_cache(struct btrfs_block_group *block_group);
 
 94int btrfs_wait_cache_io(struct btrfs_trans_handle *trans,
 95			struct btrfs_block_group *block_group,
 96			struct btrfs_path *path);
 97int btrfs_write_out_cache(struct btrfs_trans_handle *trans,
 98			  struct btrfs_block_group *block_group,
 
 99			  struct btrfs_path *path);
100struct inode *lookup_free_ino_inode(struct btrfs_root *root,
101				    struct btrfs_path *path);
102int create_free_ino_inode(struct btrfs_root *root,
103			  struct btrfs_trans_handle *trans,
104			  struct btrfs_path *path);
105int load_free_ino_cache(struct btrfs_fs_info *fs_info,
106			struct btrfs_root *root);
107int btrfs_write_out_ino_cache(struct btrfs_root *root,
108			      struct btrfs_trans_handle *trans,
109			      struct btrfs_path *path,
110			      struct inode *inode);
111
112void btrfs_init_free_space_ctl(struct btrfs_block_group *block_group);
113int __btrfs_add_free_space(struct btrfs_fs_info *fs_info,
114			   struct btrfs_free_space_ctl *ctl,
115			   u64 bytenr, u64 size,
116			   enum btrfs_trim_state trim_state);
117int btrfs_add_free_space(struct btrfs_block_group *block_group,
118			 u64 bytenr, u64 size);
119int btrfs_add_free_space_async_trimmed(struct btrfs_block_group *block_group,
120				       u64 bytenr, u64 size);
121int btrfs_remove_free_space(struct btrfs_block_group *block_group,
 
 
 
122			    u64 bytenr, u64 size);
123void __btrfs_remove_free_space_cache(struct btrfs_free_space_ctl *ctl);
124void btrfs_remove_free_space_cache(struct btrfs_block_group *block_group);
125bool btrfs_is_free_space_trimmed(struct btrfs_block_group *block_group);
126u64 btrfs_find_space_for_alloc(struct btrfs_block_group *block_group,
127			       u64 offset, u64 bytes, u64 empty_size,
128			       u64 *max_extent_size);
129u64 btrfs_find_ino_for_alloc(struct btrfs_root *fs_root);
130void btrfs_dump_free_space(struct btrfs_block_group *block_group,
131			   u64 bytes);
132int btrfs_find_space_cluster(struct btrfs_block_group *block_group,
 
133			     struct btrfs_free_cluster *cluster,
134			     u64 offset, u64 bytes, u64 empty_size);
135void btrfs_init_free_cluster(struct btrfs_free_cluster *cluster);
136u64 btrfs_alloc_from_cluster(struct btrfs_block_group *block_group,
137			     struct btrfs_free_cluster *cluster, u64 bytes,
138			     u64 min_start, u64 *max_extent_size);
139void btrfs_return_cluster_to_free_space(
140			       struct btrfs_block_group *block_group,
141			       struct btrfs_free_cluster *cluster);
142int btrfs_trim_block_group(struct btrfs_block_group *block_group,
143			   u64 *trimmed, u64 start, u64 end, u64 minlen);
144int btrfs_trim_block_group_extents(struct btrfs_block_group *block_group,
145				   u64 *trimmed, u64 start, u64 end, u64 minlen,
146				   bool async);
147int btrfs_trim_block_group_bitmaps(struct btrfs_block_group *block_group,
148				   u64 *trimmed, u64 start, u64 end, u64 minlen,
149				   u64 maxlen, bool async);
150
151/* Support functions for running our sanity tests */
152#ifdef CONFIG_BTRFS_FS_RUN_SANITY_TESTS
153int test_add_free_space_entry(struct btrfs_block_group *cache,
154			      u64 offset, u64 bytes, bool bitmap);
155int test_check_exists(struct btrfs_block_group *cache, u64 offset, u64 bytes);
 
156#endif
157
158#endif