add ioctl/sysfs to donate file-backed pages
Subsystems (3)
Jaegeuk Kim
maintainerv6 cover add ioctl/sysfs to donate file-backed pages
If users clearly know which file-backed pages to reclaim in system view, they can use this ioctl() to register in advance and reclaim all at once later.
To MM and others,
I'd like to propose this API in F2FS only, since
1) the use-case is quite limited in Android at the moment. Once it's generall accepted with more use-cases, happy to propose a generic API such as fadvise. Please chime in, if there's any needs.
2) it's file-backed pages which requires to maintain the list of inode objects. I'm not sure this fits in MM tho, also happy to listen to any feedback.
Jaegeuk Kim (2):
f2fs: register inodes which is able to donate pages
f2fs: add a sysfs entry to request donate file-backed pages
Documentation/ABI/testing/sysfs-fs-f2fs | 7 +++ fs/f2fs/debug.c | 3 ++ fs/f2fs/f2fs.h | 14 +++++- fs/f2fs/file.c | 65 +++++++++++++++++++++++++ fs/f2fs/inode.c | 14 ++++++ fs/f2fs/shrinker.c | 27 ++++++++++ fs/f2fs/super.c | 1 + fs/f2fs/sysfs.c | 8 +++ include/uapi/linux/f2fs.h | 7 +++ 9 files changed, 145 insertions(+), 1 deletion(-)
Signature · 1 line
2.48.0.rc2.279.g1de40edade-goog
Jaegeuk Kim
maintainerPATCH v6 1/2 f2fs: register inodes which is able to donate pages
This patch introduces an inode list to keep the page cache ranges that users can donate pages together.
#define F2FS_IOC_DONATE_RANGE _IOW(F2FS_IOCTL_MAGIC, 27, \
struct f2fs_donate_range)
struct f2fs_donate_range {
__u64 start;
__u64 len;};
e.g., ioctl(F2FS_IOC_DONATE_RANGE, &range);
--- fs/f2fs/debug.c | 3 ++ fs/f2fs/f2fs.h | 12 +++++++- fs/f2fs/file.c | 65 +++++++++++++++++++++++++++++++++++++++ fs/f2fs/inode.c | 14 +++++++++ fs/f2fs/super.c | 1 + include/uapi/linux/f2fs.h | 7 +++++ 6 files changed, 101 insertions(+), 1 deletion(-)
fs/f2fs/debug.c +3 -0
@@ -164,6 +164,7 @@ static void update_general_status(struct f2fs_sb_info *sbi) si->ndirty_imeta =get_pages (sbi,F2FS_DIRTY_IMETA ); si->ndirty_dirs = sbi->ndirty_inode[DIR_INODE ]; si->ndirty_files = sbi->ndirty_inode[FILE_INODE ]; + si->ndonate_files = sbi->donate_files; si->nquota_files = sbi->nquota_files; si->ndirty_all = sbi->ndirty_inode[DIRTY_META ]; si->aw_cnt =atomic_read (&sbi->atomic_files);
@@ -501,6 +502,8 @@ static int stat_show(struct seq_file *s, void *v) si->compr_inode, si->compr_blocks);seq_printf (s," - Swapfile Inode: %u\n" , si->swapfile_inode); +seq_printf (s," - Donate Inode: %u\n" , + si->ndonate_files);seq_printf (s," - Orphan/Append/Update Inode: %u, %u, %u\n" , si->orphans, si->append, si->update); seq_printf(s, "\nMain area: %d segs, %d secs %d zones\n",
fs/f2fs/f2fs.h +11 -1
@@ -850,6 +850,11 @@ struct f2fs_inode_info {#endif struct list_head dirty_list;/* dirty list for dirs and files */ struct list_head gdirty_list;/* linked in global dirty list */ + +/* linked in global inode list for cache donation */ +struct list_head gdonate_list; +loff_t donate_start, donate_end;/* inclusive */ +struct task_struct *atomic_write_task;/* store atomic write task */ struct extent_tree *extent_tree[NR_EXTENT_CACHES ];/* cached extent_tree entry */
@@ -1274,6 +1279,7 @@ enum inode_type {DIR_INODE ,/* for dirty dir inode */ FILE_INODE ,/* for dirty regular/symlink inode */ DIRTY_META ,/* for all dirtied inode metadata */ +DONATE_INODE ,/* for all inode to donate pages */ NR_INODE_TYPE, };
@@ -1629,6 +1635,9 @@ struct f2fs_sb_info {unsigned int warm_data_age_threshold;unsigned int last_age_weight; +/* control donate caches */ +unsigned int donate_files; +/* basic filesystem units */ unsigned int log_sectors_per_block;/* log2 sectors per block */ unsigned int log_blocksize;/* log2 block size */
@@ -3984,7 +3993,8 @@ struct f2fs_stat_info {unsigned long long allocated_data_blocks;int ndirty_node, ndirty_dent, ndirty_meta, ndirty_imeta;int ndirty_data, ndirty_qdata; -unsigned int ndirty_dirs, ndirty_files, nquota_files, ndirty_all; +unsigned int ndirty_dirs, ndirty_files, ndirty_all; +unsigned int nquota_files, ndonate_files;int nats, dirty_nats, sits, dirty_sits;int free_nids, avail_nids, alloc_nids;int total_count, utilization;
fs/f2fs/file.c +65 -0
83 lines not on this page · raw message
fs/f2fs/inode.c +14 -0
@@ -804,6 +804,19 @@ int f2fs_write_inode(struct inode *inode, struct writeback_control *wbc)return 0 ; } +static void f2fs_remove_donate_inode (struct inode *inode) +{ +struct f2fs_sb_info *sbi =F2FS_I_SB (inode); + +if (list_empty (&F2FS_I (inode)->gdonate_list)) +return ; + +spin_lock (&sbi->inode_lock[DONATE_INODE ]); +list_del_init (&F2FS_I (inode)->gdonate_list); + sbi->donate_files--; +spin_unlock (&sbi->inode_lock[DONATE_INODE ]); +} +/* * Called at the last iput() if i_nlink is zero */
@@ -838,6 +851,7 @@ void f2fs_evict_inode(struct inode *inode)f2fs_bug_on (sbi,get_dirty_pages (inode));f2fs_remove_dirty_inode (inode); +f2fs_remove_donate_inode (inode);if (!IS_DEVICE_ALIASING (inode))f2fs_destroy_extent_tree (inode);
fs/f2fs/super.c +1 -0
@@ -1441,6 +1441,7 @@ static struct inode *f2fs_alloc_inode(struct super_block *sb)spin_lock_init (&fi->i_size_lock);INIT_LIST_HEAD (&fi->dirty_list);INIT_LIST_HEAD (&fi->gdirty_list); +INIT_LIST_HEAD (&fi->gdonate_list);init_f2fs_rwsem (&fi->i_gc_rwsem[READ ]);init_f2fs_rwsem (&fi->i_gc_rwsem[WRITE ]);init_f2fs_rwsem (&fi->i_xattr_sem);
include/uapi/linux/f2fs.h +7 -0
@@ -44,6 +44,8 @@#define F2FS_IOC_COMPRESS_FILE _IO(F2FS_IOCTL_MAGIC, 24)#define F2FS_IOC_START_ATOMIC_REPLACE _IO(F2FS_IOCTL_MAGIC, 25)#define F2FS_IOC_GET_DEV_ALIAS_FILE _IOR(F2FS_IOCTL_MAGIC, 26, __u32) +#define F2FS_IOC_DONATE_RANGE _IOW(F2FS_IOCTL_MAGIC, 27, \ + struct f2fs_donate_range)/* * should be same as XFS_IOC_GOINGDOWN.
@@ -97,4 +99,9 @@ struct f2fs_comp_option { __u8 log_cluster_size; }; +struct f2fs_donate_range { +__u64 start; +__u64 len; +}; +#endif /* _UAPI_LINUX_F2FS_H */
Signature · 1 line
2.48.0.rc2.279.g1de40edade-goog
Chao Yu
maintainerRe: [f2fs-dev] [PATCH 1/2] f2fs: register inodes which is able to donate pages
Quoted 48 lines · On 1/18/25 00:41, Jaegeuk Kim via Linux-f2fs-devel wrote:
This patch introduces an inode list to keep the page cache ranges that users can donate pages together.
#define
F2FS_IOC_DONATE_RANGE_IOW(F2FS_IOCTL_MAGIC, 27, \
structf2fs_donate_range)struct f2fs_donate_range { __u64 start; __u64 len;};
e.g.,
ioctl(F2FS_IOC_DONATE_RANGE, &range);Signed-off-by Jaegeuk Kim <[email protected]>--- fs/f2fs/debug.c | 3 ++ fs/f2fs/f2fs.h | 12 +++++++- fs/f2fs/file.c | 65 +++++++++++++++++++++++++++++++++++++++ fs/f2fs/inode.c | 14 +++++++++ fs/f2fs/super.c | 1 + include/uapi/linux/f2fs.h | 7 +++++ 6 files changed, 101 insertions(+), 1 deletion(-)fs/f2fs/debug.c +3
-0@@ -164,6 +164,7 @@ static void update_general_status(struct f2fs_sb_info *sbi) si->ndirty_imeta =get_pages (sbi,F2FS_DIRTY_IMETA ); si->ndirty_dirs = sbi->ndirty_inode[DIR_INODE ]; si->ndirty_files = sbi->ndirty_inode[FILE_INODE ]; + si->ndonate_files = sbi->donate_files; si->nquota_files = sbi->nquota_files; si->ndirty_all = sbi->ndirty_inode[DIRTY_META ]; si->aw_cnt =atomic_read (&sbi->atomic_files);@@ -501,6 +502,8 @@ static int stat_show(struct seq_file *s, void *v) si->compr_inode, si->compr_blocks);seq_printf (s," - Swapfile Inode: %u\n" , si->swapfile_inode); +seq_printf (s," - Donate Inode: %u\n" , + si->ndonate_files);seq_printf (s," - Orphan/Append/Update Inode: %u, %u, %u\n" , si->orphans, si->append, si->update); seq_printf(s, "\nMain area: %d segs, %d secs %d zones\n",fs/f2fs/f2fs.h +0
-0
fs/f2fs/f2fs.h struct f2fs_inode_info { · line 856
Quoted 7 lines
fs/f2fs/f2fs.h +4
-0@@ -850,6 +850,11 @@ struct f2fs_inode_info {#endif struct list_head dirty_list;/* dirty list for dirs and files */ struct list_head gdirty_list;/* linked in global dirty list */ + +/* linked in global inode list for cache donation */ +struct list_head gdonate_list; +loff_t donate_start, donate_end;/* inclusive */
use block_t instead of loff_t? it can avoid unnecessary memory cost.
Thanks,
Quoted 189 lines
fs/f2fs/f2fs.h +7
-1+struct task_struct *atomic_write_task;/* store atomic write task */ struct extent_tree *extent_tree[NR_EXTENT_CACHES ];/* cached extent_tree entry */ @@ -1274,6 +1279,7 @@ enum inode_type {DIR_INODE ,/* for dirty dir inode */ FILE_INODE ,/* for dirty regular/symlink inode */ DIRTY_META ,/* for all dirtied inode metadata */ +DONATE_INODE ,/* for all inode to donate pages */ NR_INODE_TYPE, };@@ -1629,6 +1635,9 @@ struct f2fs_sb_info {unsigned int warm_data_age_threshold;unsigned int last_age_weight; +/* control donate caches */ +unsigned int donate_files; +/* basic filesystem units */ unsigned int log_sectors_per_block;/* log2 sectors per block */ unsigned int log_blocksize;/* log2 block size */ @@ -3984,7 +3993,8 @@ struct f2fs_stat_info {unsigned long long allocated_data_blocks;int ndirty_node, ndirty_dent, ndirty_meta, ndirty_imeta;int ndirty_data, ndirty_qdata; -unsigned int ndirty_dirs, ndirty_files, nquota_files, ndirty_all; +unsigned int ndirty_dirs, ndirty_files, ndirty_all; +unsigned int nquota_files, ndonate_files;int nats, dirty_nats, sits, dirty_sits;int free_nids, avail_nids, alloc_nids;int total_count, utilization;fs/f2fs/file.c +65
-0@@ -2450,6 +2450,68 @@ static int f2fs_ioc_shutdown(struct file *filp, unsigned long arg)return ret; } +static int f2fs_ioc_donate_range (struct file *filp,unsigned long arg) +{ +struct inode *inode =file_inode (filp); +struct mnt_idmap *idmap =file_mnt_idmap (filp); +struct f2fs_sb_info *sbi =F2FS_I_SB (inode); +struct f2fs_donate_range range; +u64 max_bytes =F2FS_BLK_TO_BYTES (max_file_blocks (inode)); +u64 start, end; +int ret; + +if (copy_from_user (&range, (struct f2fs_donate_range __user *)arg, +sizeof (range))) +return -EFAULT ; + +if (!inode_owner_or_capable (idmap, inode)) +return -EACCES ; + +if (!S_ISREG (inode->i_mode)) +return -EINVAL ; + +if (range.start >= max_bytes || range.len > max_bytes || + (range.start + range.len) > max_bytes) +return -EINVAL ; + + start = range.start >>PAGE_SHIFT ; + end =DIV_ROUND_UP (range.start + range.len,PAGE_SIZE ); + + ret =mnt_want_write_file (filp); +if (ret) +return ret; + +inode_lock (inode); + +if (f2fs_is_atomic_file (inode)) + goto out; + +spin_lock (&sbi->inode_lock[DONATE_INODE ]); +/* let's remove the range, if len = 0 */ +if (!range.len) { +if (!list_empty (&F2FS_I (inode)->gdonate_list)) { +list_del_init (&F2FS_I (inode)->gdonate_list); + sbi->donate_files--; + } + }else { +if (list_empty (&F2FS_I (inode)->gdonate_list)) { +list_add_tail (&F2FS_I (inode)->gdonate_list, + &sbi->inode_list[DONATE_INODE ]); + sbi->donate_files++; + }else { +list_move_tail (&F2FS_I (inode)->gdonate_list, + &sbi->inode_list[DONATE_INODE ]); + } +F2FS_I (inode)->donate_start = start; +F2FS_I (inode)->donate_end = end -1 ; + } +spin_unlock (&sbi->inode_lock[DONATE_INODE ]); +out: +inode_unlock (inode); +mnt_drop_write_file (filp); +return ret; +} +static int f2fs_ioc_fitrim (struct file *filp,unsigned long arg) {struct inode *inode =file_inode (filp);@@ -4479,6 +4541,8 @@ static long __f2fs_ioctl(struct file *filp, unsigned int cmd, unsigned long arg)return -EOPNOTSUPP ;case F2FS_IOC_SHUTDOWN :return f2fs_ioc_shutdown (filp, arg); +case F2FS_IOC_DONATE_RANGE : +return f2fs_ioc_donate_range (filp, arg);case FITRIM :return f2fs_ioc_fitrim (filp, arg);case FS_IOC_SET_ENCRYPTION_POLICY :@@ -5230,6 +5294,7 @@ long f2fs_compat_ioctl(struct file *file, unsigned int cmd, unsigned long arg)case F2FS_IOC_RELEASE_VOLATILE_WRITE :case F2FS_IOC_ABORT_ATOMIC_WRITE :case F2FS_IOC_SHUTDOWN : +case F2FS_IOC_DONATE_RANGE :case FITRIM :case FS_IOC_SET_ENCRYPTION_POLICY :case FS_IOC_GET_ENCRYPTION_PWSALT :fs/f2fs/inode.c +14
-0@@ -804,6 +804,19 @@ int f2fs_write_inode(struct inode *inode, struct writeback_control *wbc)return 0 ; } +static void f2fs_remove_donate_inode (struct inode *inode) +{ +struct f2fs_sb_info *sbi =F2FS_I_SB (inode); + +if (list_empty (&F2FS_I (inode)->gdonate_list)) +return ; + +spin_lock (&sbi->inode_lock[DONATE_INODE ]); +list_del_init (&F2FS_I (inode)->gdonate_list); + sbi->donate_files--; +spin_unlock (&sbi->inode_lock[DONATE_INODE ]); +} +/* * Called at the last iput() if i_nlink is zero */ @@ -838,6 +851,7 @@ void f2fs_evict_inode(struct inode *inode)f2fs_bug_on (sbi,get_dirty_pages (inode));f2fs_remove_dirty_inode (inode); +f2fs_remove_donate_inode (inode);if (!IS_DEVICE_ALIASING (inode))f2fs_destroy_extent_tree (inode);fs/f2fs/super.c +1
-0@@ -1441,6 +1441,7 @@ static struct inode *f2fs_alloc_inode(struct super_block *sb)spin_lock_init (&fi->i_size_lock);INIT_LIST_HEAD (&fi->dirty_list);INIT_LIST_HEAD (&fi->gdirty_list); +INIT_LIST_HEAD (&fi->gdonate_list);init_f2fs_rwsem (&fi->i_gc_rwsem[READ ]);init_f2fs_rwsem (&fi->i_gc_rwsem[WRITE ]);init_f2fs_rwsem (&fi->i_xattr_sem);include/uapi/linux/f2fs.h +7
-0@@ -44,6 +44,8 @@#define F2FS_IOC_COMPRESS_FILE _IO(F2FS_IOCTL_MAGIC, 24)#define F2FS_IOC_START_ATOMIC_REPLACE _IO(F2FS_IOCTL_MAGIC, 25)#define F2FS_IOC_GET_DEV_ALIAS_FILE _IOR(F2FS_IOCTL_MAGIC, 26, __u32) +#define F2FS_IOC_DONATE_RANGE _IOW(F2FS_IOCTL_MAGIC, 27, \ + struct f2fs_donate_range)/* * should be same as XFS_IOC_GOINGDOWN. @@ -97,4 +99,9 @@ struct f2fs_comp_option { __u8 log_cluster_size; }; +struct f2fs_donate_range { +__u64 start; +__u64 len; +}; +#endif /* _UAPI_LINUX_F2FS_H */
Jaegeuk Kim
maintainerRe: [f2fs-dev] [PATCH 1/2] f2fs: register inodes which is able to donate pages
Quoted 50 lines · Chao Yu
Quoted 49 lines · On 1/18/25 00:41, Jaegeuk Kim via Linux-f2fs-devel wrote:
This patch introduces an inode list to keep the page cache ranges that users can donate pages together.
#define
F2FS_IOC_DONATE_RANGE_IOW(F2FS_IOCTL_MAGIC, 27, \
structf2fs_donate_range)struct f2fs_donate_range { __u64 start; __u64 len;};
e.g.,
ioctl(F2FS_IOC_DONATE_RANGE, &range);Signed-off-by Jaegeuk Kim <[email protected]>--- fs/f2fs/debug.c | 3 ++ fs/f2fs/f2fs.h | 12 +++++++- fs/f2fs/file.c | 65 +++++++++++++++++++++++++++++++++++++++ fs/f2fs/inode.c | 14 +++++++++ fs/f2fs/super.c | 1 + include/uapi/linux/f2fs.h | 7 +++++ 6 files changed, 101 insertions(+), 1 deletion(-)fs/f2fs/debug.c +3
-0@@ -164,6 +164,7 @@ static void update_general_status(struct f2fs_sb_info *sbi) si->ndirty_imeta =get_pages (sbi,F2FS_DIRTY_IMETA ); si->ndirty_dirs = sbi->ndirty_inode[DIR_INODE ]; si->ndirty_files = sbi->ndirty_inode[FILE_INODE ]; + si->ndonate_files = sbi->donate_files; si->nquota_files = sbi->nquota_files; si->ndirty_all = sbi->ndirty_inode[DIRTY_META ]; si->aw_cnt =atomic_read (&sbi->atomic_files);@@ -501,6 +502,8 @@ static int stat_show(struct seq_file *s, void *v) si->compr_inode, si->compr_blocks);seq_printf (s," - Swapfile Inode: %u\n" , si->swapfile_inode); +seq_printf (s," - Donate Inode: %u\n" , + si->ndonate_files);seq_printf (s," - Orphan/Append/Update Inode: %u, %u, %u\n" , si->orphans, si->append, si->update); seq_printf(s, "\nMain area: %d segs, %d secs %d zones\n",fs/f2fs/f2fs.h +0
-0@@ -850,6 +850,11 @@ struct f2fs_inode_info {#endif
Quoted 8 lines
fs/f2fs/f2fs.h struct f2fs_inode_info { · line 856
Quoted 6 lines
fs/f2fs/f2fs.h +4
-0struct list_head dirty_list;/* dirty list for dirs and files */ struct list_head gdirty_list;/* linked in global dirty list */ + +/* linked in global inode list for cache donation */ +struct list_head gdonate_list; +loff_t donate_start, donate_end;/* inclusive */ use
block_tinstead ofloff_t? it can avoid unnecessary memory cost.
Changed to pgoff_t, since it's a page offset.
Quoted 184 lines
Thanks,
Quoted 181 lines
fs/f2fs/f2fs.h +7
-1+struct task_struct *atomic_write_task;/* store atomic write task */ struct extent_tree *extent_tree[NR_EXTENT_CACHES ];/* cached extent_tree entry */ @@ -1274,6 +1279,7 @@ enum inode_type {DIR_INODE ,/* for dirty dir inode */ FILE_INODE ,/* for dirty regular/symlink inode */ DIRTY_META ,/* for all dirtied inode metadata */ +DONATE_INODE ,/* for all inode to donate pages */ NR_INODE_TYPE, };@@ -1629,6 +1635,9 @@ struct f2fs_sb_info {unsigned int warm_data_age_threshold;unsigned int last_age_weight; +/* control donate caches */ +unsigned int donate_files; +/* basic filesystem units */ unsigned int log_sectors_per_block;/* log2 sectors per block */ unsigned int log_blocksize;/* log2 block size */ @@ -3984,7 +3993,8 @@ struct f2fs_stat_info {unsigned long long allocated_data_blocks;int ndirty_node, ndirty_dent, ndirty_meta, ndirty_imeta;int ndirty_data, ndirty_qdata; -unsigned int ndirty_dirs, ndirty_files, nquota_files, ndirty_all; +unsigned int ndirty_dirs, ndirty_files, ndirty_all; +unsigned int nquota_files, ndonate_files;int nats, dirty_nats, sits, dirty_sits;int free_nids, avail_nids, alloc_nids;int total_count, utilization;fs/f2fs/file.c +65
-0@@ -2450,6 +2450,68 @@ static int f2fs_ioc_shutdown(struct file *filp, unsigned long arg)return ret; } +static int f2fs_ioc_donate_range (struct file *filp,unsigned long arg) +{ +struct inode *inode =file_inode (filp); +struct mnt_idmap *idmap =file_mnt_idmap (filp); +struct f2fs_sb_info *sbi =F2FS_I_SB (inode); +struct f2fs_donate_range range; +u64 max_bytes =F2FS_BLK_TO_BYTES (max_file_blocks (inode)); +u64 start, end; +int ret; + +if (copy_from_user (&range, (struct f2fs_donate_range __user *)arg, +sizeof (range))) +return -EFAULT ; + +if (!inode_owner_or_capable (idmap, inode)) +return -EACCES ; + +if (!S_ISREG (inode->i_mode)) +return -EINVAL ; + +if (range.start >= max_bytes || range.len > max_bytes || + (range.start + range.len) > max_bytes) +return -EINVAL ; + + start = range.start >>PAGE_SHIFT ; + end =DIV_ROUND_UP (range.start + range.len,PAGE_SIZE ); + + ret =mnt_want_write_file (filp); +if (ret) +return ret; + +inode_lock (inode); + +if (f2fs_is_atomic_file (inode)) + goto out; + +spin_lock (&sbi->inode_lock[DONATE_INODE ]); +/* let's remove the range, if len = 0 */ +if (!range.len) { +if (!list_empty (&F2FS_I (inode)->gdonate_list)) { +list_del_init (&F2FS_I (inode)->gdonate_list); + sbi->donate_files--; + } + }else { +if (list_empty (&F2FS_I (inode)->gdonate_list)) { +list_add_tail (&F2FS_I (inode)->gdonate_list, + &sbi->inode_list[DONATE_INODE ]); + sbi->donate_files++; + }else { +list_move_tail (&F2FS_I (inode)->gdonate_list, + &sbi->inode_list[DONATE_INODE ]); + } +F2FS_I (inode)->donate_start = start; +F2FS_I (inode)->donate_end = end -1 ; + } +spin_unlock (&sbi->inode_lock[DONATE_INODE ]); +out: +inode_unlock (inode); +mnt_drop_write_file (filp); +return ret; +} +static int f2fs_ioc_fitrim (struct file *filp,unsigned long arg) {struct inode *inode =file_inode (filp);@@ -4479,6 +4541,8 @@ static long __f2fs_ioctl(struct file *filp, unsigned int cmd, unsigned long arg)return -EOPNOTSUPP ;case F2FS_IOC_SHUTDOWN :return f2fs_ioc_shutdown (filp, arg); +case F2FS_IOC_DONATE_RANGE : +return f2fs_ioc_donate_range (filp, arg);case FITRIM :return f2fs_ioc_fitrim (filp, arg);case FS_IOC_SET_ENCRYPTION_POLICY :@@ -5230,6 +5294,7 @@ long f2fs_compat_ioctl(struct file *file, unsigned int cmd, unsigned long arg)case F2FS_IOC_RELEASE_VOLATILE_WRITE :case F2FS_IOC_ABORT_ATOMIC_WRITE :case F2FS_IOC_SHUTDOWN : +case F2FS_IOC_DONATE_RANGE :case FITRIM :case FS_IOC_SET_ENCRYPTION_POLICY :case FS_IOC_GET_ENCRYPTION_PWSALT :fs/f2fs/inode.c +14
-0@@ -804,6 +804,19 @@ int f2fs_write_inode(struct inode *inode, struct writeback_control *wbc)return 0 ; } +static void f2fs_remove_donate_inode (struct inode *inode) +{ +struct f2fs_sb_info *sbi =F2FS_I_SB (inode); + +if (list_empty (&F2FS_I (inode)->gdonate_list)) +return ; + +spin_lock (&sbi->inode_lock[DONATE_INODE ]); +list_del_init (&F2FS_I (inode)->gdonate_list); + sbi->donate_files--; +spin_unlock (&sbi->inode_lock[DONATE_INODE ]); +} +/* * Called at the last iput() if i_nlink is zero */ @@ -838,6 +851,7 @@ void f2fs_evict_inode(struct inode *inode)f2fs_bug_on (sbi,get_dirty_pages (inode));f2fs_remove_dirty_inode (inode); +f2fs_remove_donate_inode (inode);if (!IS_DEVICE_ALIASING (inode))f2fs_destroy_extent_tree (inode);fs/f2fs/super.c +1
-0@@ -1441,6 +1441,7 @@ static struct inode *f2fs_alloc_inode(struct super_block *sb)spin_lock_init (&fi->i_size_lock);INIT_LIST_HEAD (&fi->dirty_list);INIT_LIST_HEAD (&fi->gdirty_list); +INIT_LIST_HEAD (&fi->gdonate_list);init_f2fs_rwsem (&fi->i_gc_rwsem[READ ]);init_f2fs_rwsem (&fi->i_gc_rwsem[WRITE ]);init_f2fs_rwsem (&fi->i_xattr_sem);include/uapi/linux/f2fs.h +7
-0@@ -44,6 +44,8 @@#define F2FS_IOC_COMPRESS_FILE _IO(F2FS_IOCTL_MAGIC, 24)#define F2FS_IOC_START_ATOMIC_REPLACE _IO(F2FS_IOCTL_MAGIC, 25)#define F2FS_IOC_GET_DEV_ALIAS_FILE _IOR(F2FS_IOCTL_MAGIC, 26, __u32) +#define F2FS_IOC_DONATE_RANGE _IOW(F2FS_IOCTL_MAGIC, 27, \ + struct f2fs_donate_range)/* * should be same as XFS_IOC_GOINGDOWN. @@ -97,4 +99,9 @@ struct f2fs_comp_option { __u8 log_cluster_size; }; +struct f2fs_donate_range { +__u64 start; +__u64 len; +}; +#endif /* _UAPI_LINUX_F2FS_H */
Jaegeuk Kim
maintainerPATCH v6 2/2 f2fs: add a sysfs entry to request donate file-backed pages
In reply to Jaegeuk Kim1. ioctl(fd1, F2FS_IOC_DONATE_RANGE, {0,3});
2. ioctl(fd2, F2FS_IOC_DONATE_RANGE, {1,2});
3. ioctl(fd3, F2FS_IOC_DONATE_RANGE, {3,1});
4. echo 3 > /sys/fs/f2fs/blk/donate_caches
will reclaim 3 page cache ranges, registered by #1, #2, and #3.
--- Documentation/ABI/testing/sysfs-fs-f2fs | 7 +++++++ fs/f2fs/f2fs.h | 2 ++ fs/f2fs/shrinker.c | 27 +++++++++++++++++++++++++ fs/f2fs/sysfs.c | 8 ++++++++ 4 files changed, 44 insertions(+)
Documentation/ABI/testing/sysfs-fs-f2fs +7 -0
@@ -828,3 +828,10 @@ Date: November 2024 Contact: "Chao Yu" <[email protected]> Description: It controls max read extent count for per-inode, the value of threshold is 10240 by default. + +What: /sys/fs/f2fs/<disk>/donate_caches +Date: December 2024 +Contact: "Jaegeuk Kim" <[email protected]> +Description: It reclaims the certian file-backed pages registered by + ioctl(F2FS_IOC_DONATE_RANGE). + For example, writing N tries to drop N address spaces in LRU.
fs/f2fs/f2fs.h +2 -0
@@ -1637,6 +1637,7 @@ struct f2fs_sb_info {/* control donate caches */ unsigned int donate_files; +unsigned int donate_caches;/* basic filesystem units */ unsigned int log_sectors_per_block;/* log2 sectors per block */
@@ -4259,6 +4260,7 @@ unsigned long f2fs_shrink_count(struct shrinker *shrink, struct shrink_control *sc);unsigned long f2fs_shrink_scan (struct shrinker *shrink,struct shrink_control *sc); +void f2fs_donate_caches (struct f2fs_sb_info *sbi);void f2fs_join_shrinker (struct f2fs_sb_info *sbi);void f2fs_leave_shrinker (struct f2fs_sb_info *sbi);
fs/f2fs/shrinker.c +27 -0
@@ -130,6 +130,33 @@ unsigned long f2fs_shrink_scan(struct shrinker *shrink,return freed; } +void f2fs_donate_caches (struct f2fs_sb_info *sbi) +{ +struct inode *inode; +struct f2fs_inode_info *fi; +int nfiles = sbi->donate_caches; + +while (nfiles--) { +spin_lock (&sbi->inode_lock[DONATE_INODE ]); +if (list_empty (&sbi->inode_list[DONATE_INODE ])) { +spin_unlock (&sbi->inode_lock[DONATE_INODE ]); +break ; + } + fi =list_first_entry (&sbi->inode_list[DONATE_INODE ], + struct f2fs_inode_info, gdonate_list); +list_move_tail (&fi->gdonate_list, &sbi->inode_list[DONATE_INODE ]); + inode =igrab (&fi->vfs_inode); +spin_unlock (&sbi->inode_lock[DONATE_INODE ]); + +if (!inode) +continue ; + +invalidate_inode_pages2_range (inode->i_mapping, + fi->donate_start, fi->donate_end); +iput (inode); + } +} +void f2fs_join_shrinker (struct f2fs_sb_info *sbi) {spin_lock (&f2fs_list_lock);
fs/f2fs/sysfs.c +8 -0
@@ -811,6 +811,12 @@ static ssize_t __sbi_store(struct f2fs_attr *a,return count; } +if (!strcmp (a->attr.name,"donate_caches" )) { + sbi->donate_caches =min (t, sbi->donate_files); +f2fs_donate_caches (sbi); +return count; + } + *ui = (unsigned int )t;return count;
@@ -1030,6 +1036,7 @@ F2FS_SBI_GENERAL_RW_ATTR(max_victim_search);F2FS_SBI_GENERAL_RW_ATTR (migration_granularity);F2FS_SBI_GENERAL_RW_ATTR (migration_window_granularity);F2FS_SBI_GENERAL_RW_ATTR (dir_level); +F2FS_SBI_GENERAL_RW_ATTR (donate_caches);#ifdef CONFIG_F2FS_IOSTAT F2FS_SBI_GENERAL_RW_ATTR (iostat_enable);F2FS_SBI_GENERAL_RW_ATTR (iostat_period_ms);
@@ -1178,6 +1185,7 @@ static struct attribute *f2fs_attrs[] = {ATTR_LIST (migration_granularity),ATTR_LIST (migration_window_granularity),ATTR_LIST (dir_level), +ATTR_LIST (donate_caches),ATTR_LIST (ram_thresh),ATTR_LIST (ra_nid_pages), ATTR_LIST(dirty_nats_ratio),
Signature · 1 line
2.48.0.rc2.279.g1de40edade-goog
Quoted 5 lines · Jaegeuk Kim
If users clearly know which file-backed pages to reclaim in system view, they can use this
ioctl()to register in advance and reclaim all at once later.To MM and others,
Quoted 7 lines
I'd like to propose this API in F2FS only, since
1) the use-case is quite limited in Android at the moment. Once it's generall accepted with more use-cases, happy to propose a generic API such as fadvise. Please chime in, if there's any needs.2) it's file-backed pages which requires to maintain the list of inode objects. I'm not sure this fits in MM tho, also happy to listen to any feedback.
You didn't cc the patches to linux-mm, so that's a bad start.
I don't understand how this is different from MADV_COLD. Please explain.
Jaegeuk Kim
maintainerQuoted 11 lines · Matthew Wilcox
Quoted 10 lines · Jaegeuk Kim
If users clearly know which file-backed pages to reclaim in system view, they can use this
ioctl()to register in advance and reclaim all at once later.To MM and others,
I'd like to propose this API in F2FS only, since
1) the use-case is quite limited in Android at the moment. Once it's generall accepted with more use-cases, happy to propose a generic API such as fadvise. Please chime in, if there's any needs.
Quoted 4 lines
Quoted 2 lines
2) it's file-backed pages which requires to maintain the list of inode objects. I'm not sure this fits in MM tho, also happy to listen to any feedback.
You didn't cc the patches to linux-mm, so that's a bad start.
Because #1.
Quoted 3 lines
I don't understand how this is different from
MADV_COLD. Please explain.
MADV_COLD is a vma range, while this is a file range. So, it's more close to fadvise(POSIX_FADV_DONTNEED) which tries to reclaim the file-backed pages at the time when it's called. The idea is to keep the hints only, and try to reclaim all later when admin expects system memory pressure soon.
Quoted 7 lines · Jaegeuk Kim
Quoted 2 lines
I don't understand how this is different from
MADV_COLD. Please explain.
MADV_COLDis a vma range, while this is a file range. So, it's more close tofadvise(POSIX_FADV_DONTNEED)which tries to reclaim the file-backed pages at the time when it's called. The idea is to keep the hints only, and try to reclaim all later when admin expects system memory pressure soon.
So you're saying you want POSIX_FADV_COLD?
Jaegeuk Kim
maintainerQuoted 10 lines · Matthew Wilcox
Quoted 7 lines · Jaegeuk Kim
Quoted 2 lines
I don't understand how this is different from
MADV_COLD. Please explain.
MADV_COLDis a vma range, while this is a file range. So, it's more close tofadvise(POSIX_FADV_DONTNEED)which tries to reclaim the file-backed pages at the time when it's called. The idea is to keep the hints only, and try to reclaim all later when admin expects system memory pressure soon.So you're saying you want
POSIX_FADV_COLD?
Yeah, the intention looks similar like marking it cold and paging out later.
Jaegeuk Kim
maintainerQuoted 5 lines · Jaegeuk Kim
Quoted 4 lines · Matthew Wilcox
Quoted 3 lines · Jaegeuk Kim
Quoted 2 lines
I don't understand how this is different from
MADV_COLD. Please explain.
Quoted 8 lines
Quoted 6 lines
Quoted 4 lines
MADV_COLDis a vma range, while this is a file range. So, it's more close tofadvise(POSIX_FADV_DONTNEED)which tries to reclaim the file-backed pages at the time when it's called. The idea is to keep the hints only, and try to reclaim all later when admin expects system memory pressure soon.So you're saying you want
POSIX_FADV_COLD?Yeah, the intention looks similar like marking it cold and paging out later.
Kindly ping, for the feedback on the direction. If there's demand for something generalized api, I'm happy to explore.
Jaegeuk Kim
maintainerQuoted 11 lines · Jaegeuk Kim
Quoted 10 lines · Jaegeuk Kim
Quoted 9 lines · Matthew Wilcox
Quoted 7 lines · Jaegeuk Kim
Quoted 2 lines
I don't understand how this is different from
MADV_COLD. Please explain.
MADV_COLDis a vma range, while this is a file range. So, it's more close tofadvise(POSIX_FADV_DONTNEED)which tries to reclaim the file-backed pages at the time when it's called. The idea is to keep the hints only, and try to reclaim all later when admin expects system memory pressure soon.
Quoted 6 lines
Quoted 3 lines
Quoted 1 line
So you're saying you want
POSIX_FADV_COLD?Yeah, the intention looks similar like marking it cold and paging out later.
Kindly ping, for the feedback on the direction. If there's demand for something generalized api, I'm happy to explore.
If there's no objection, let me push the change in f2fs and keep an eye on who more will need this in general.
Quoted 14 lines · Jaegeuk Kim
Quoted 13 lines · Jaegeuk Kim
Quoted 12 lines · Jaegeuk Kim
Quoted 10 lines · Matthew Wilcox
Quoted 7 lines · Jaegeuk Kim
Quoted 2 lines
I don't understand how this is different from
MADV_COLD. Please explain.
MADV_COLDis a vma range, while this is a file range. So, it's more close tofadvise(POSIX_FADV_DONTNEED)which tries to reclaim the file-backed pages at the time when it's called. The idea is to keep the hints only, and try to reclaim all later when admin expects system memory pressure soon.So you're saying you want
POSIX_FADV_COLD?
Quoted 7 lines
Quoted 4 lines
Quoted 1 line
Yeah, the intention looks similar like marking it cold and paging out later.
Kindly ping, for the feedback on the direction. If there's demand for something generalized api, I'm happy to explore.
If there's no objection, let me push the change in f2fs and keep an eye on who more will need this in general.
I don't know why you're asking for direction. I gave my direction: use fadvise().
Putting this directly in f2fs is a horrible idea. NAK.
Jaegeuk Kim
maintainerQuoted 17 lines · Matthew Wilcox
Quoted 16 lines · Jaegeuk Kim
Quoted 15 lines · Jaegeuk Kim
Quoted 13 lines · Jaegeuk Kim
Quoted 10 lines · Matthew Wilcox
Quoted 7 lines · Jaegeuk Kim
Quoted 2 lines
I don't understand how this is different from
MADV_COLD. Please explain.
MADV_COLDis a vma range, while this is a file range. So, it's more close tofadvise(POSIX_FADV_DONTNEED)which tries to reclaim the file-backed pages at the time when it's called. The idea is to keep the hints only, and try to reclaim all later when admin expects system memory pressure soon.So you're saying you want
POSIX_FADV_COLD?Yeah, the intention looks similar like marking it cold and paging out later.
Quoted 8 lines
Quoted 5 lines
Quoted 2 lines
Kindly ping, for the feedback on the direction. If there's demand for something generalized api, I'm happy to explore.
If there's no objection, let me push the change in f2fs and keep an eye on who more will need this in general.
I don't know why you're asking for direction. I gave my direction: use
fadvise().
Funny, that single question didn't mean like this at all. Will take a look how the patch looks like.
Quoted 2 lines
Putting this directly in f2fs is a horrible idea. NAK.
Jaegeuk Kim
maintainerQuoted 21 lines · Jaegeuk Kim
Quoted 20 lines · Matthew Wilcox
Quoted 19 lines · Jaegeuk Kim
Quoted 17 lines · Jaegeuk Kim
Quoted 5 lines · Jaegeuk Kim
Quoted 4 lines · Matthew Wilcox
Quoted 3 lines · Jaegeuk Kim
Quoted 2 lines
I don't understand how this is different from
MADV_COLD. Please explain.Quoted 8 lines
Quoted 6 lines
Quoted 4 lines
MADV_COLDis a vma range, while this is a file range. So, it's more close tofadvise(POSIX_FADV_DONTNEED)which tries to reclaim the file-backed pages at the time when it's called. The idea is to keep the hints only, and try to reclaim all later when admin expects system memory pressure soon.So you're saying you want
POSIX_FADV_COLD?Yeah, the intention looks similar like marking it cold and paging out later.
Kindly ping, for the feedback on the direction. If there's demand for something generalized api, I'm happy to explore.
Quoted 8 lines
Quoted 5 lines
Quoted 2 lines
If there's no objection, let me push the change in f2fs and keep an eye on who more will need this in general.
I don't know why you're asking for direction. I gave my direction: use
fadvise().Funny, that single question didn't mean like this at all. Will take a look how the patch looks like.
Ok, it seems we can get this hint via POSIX_FADV_NOREUSE. I'll take that instead of adding a new API. Thanks.
Quoted 3 lines
Quoted 3 lines
Putting this directly in f2fs is a horrible idea. NAK.