^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) /* SPDX-License-Identifier: GPL-2.0-or-later */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) /* -*- mode: c; c-basic-offset: 8; -*-
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) * vim: noexpandtab sw=8 ts=8 sts=0:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) * uptodate.h
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) * Cluster uptodate tracking
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) * Copyright (C) 2002, 2004, 2005 Oracle. All rights reserved.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) #ifndef OCFS2_UPTODATE_H
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) #define OCFS2_UPTODATE_H
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) /*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) * The caching code relies on locking provided by the user of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) * struct ocfs2_caching_info. These operations connect that up.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) struct ocfs2_caching_operations {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) /*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) * A u64 representing the owning structure. Usually this
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) * is the block number (i_blkno or whatnot). This is used so
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) * that caching log messages can identify the owning structure.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) u64 (*co_owner)(struct ocfs2_caching_info *ci);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) /* The superblock is needed during I/O. */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) struct super_block *(*co_get_super)(struct ocfs2_caching_info *ci);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) /*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) * Lock and unlock the caching data. These will not sleep, and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) * should probably be spinlocks.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) void (*co_cache_lock)(struct ocfs2_caching_info *ci);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) void (*co_cache_unlock)(struct ocfs2_caching_info *ci);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) /*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) * Lock and unlock for disk I/O. These will sleep, and should
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) * be mutexes.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) void (*co_io_lock)(struct ocfs2_caching_info *ci);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) void (*co_io_unlock)(struct ocfs2_caching_info *ci);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) int __init init_ocfs2_uptodate_cache(void);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) void exit_ocfs2_uptodate_cache(void);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) void ocfs2_metadata_cache_init(struct ocfs2_caching_info *ci,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) const struct ocfs2_caching_operations *ops);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) void ocfs2_metadata_cache_purge(struct ocfs2_caching_info *ci);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) void ocfs2_metadata_cache_exit(struct ocfs2_caching_info *ci);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) u64 ocfs2_metadata_cache_owner(struct ocfs2_caching_info *ci);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) void ocfs2_metadata_cache_io_lock(struct ocfs2_caching_info *ci);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) void ocfs2_metadata_cache_io_unlock(struct ocfs2_caching_info *ci);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) int ocfs2_buffer_uptodate(struct ocfs2_caching_info *ci,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) struct buffer_head *bh);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) void ocfs2_set_buffer_uptodate(struct ocfs2_caching_info *ci,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) struct buffer_head *bh);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) void ocfs2_set_new_buffer_uptodate(struct ocfs2_caching_info *ci,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) struct buffer_head *bh);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) void ocfs2_remove_from_cache(struct ocfs2_caching_info *ci,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) struct buffer_head *bh);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) void ocfs2_remove_xattr_clusters_from_cache(struct ocfs2_caching_info *ci,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) sector_t block,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) u32 c_len);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) int ocfs2_buffer_read_ahead(struct ocfs2_caching_info *ci,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) struct buffer_head *bh);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) #endif /* OCFS2_UPTODATE_H */