From: Viacheslav Dubeyko <Slava.Dubeyko@xxxxxxx>
We have a lot of declarations and not enough good
comments on it.
Claude AI generated comments for CephFS metadata structure
declarations in include/linux/ceph/*.h. These comments
have been reviewed, checked, and corrected.
This patch adds comments for struct ceph_object_extent,
struct ceph_file_extent in /include/linux/ceph/striper.h.
Signed-off-by: Viacheslav Dubeyko <Slava.Dubeyko@xxxxxxx>
cc: Alex Markuze <amarkuze@xxxxxxxxxx>
cc: Ilya Dryomov <idryomov@xxxxxxxxx>
cc: Ceph Development <ceph-devel@xxxxxxxxxxxxxxx>
---
include/linux/ceph/striper.h | 16 ++++++++++++++++
1 file changed, 16 insertions(+)
diff --git a/include/linux/ceph/striper.h b/include/linux/ceph/striper.h
index 3486636c0e6e..b59c055ce562 100644
--- a/include/linux/ceph/striper.h
+++ b/include/linux/ceph/striper.h
@@ -11,10 +11,19 @@ void ceph_calc_file_object_mapping(struct ceph_file_layout *l,
u64 off, u64 len,
u64 *objno, u64 *objoff, u32 *xlen);
+/*
+ * Object extent metadata: Represents a contiguous range within a RADOS object
+ * that maps to part of a file. Used by the striping layer to break file I/O
+ * operations into object-level operations distributed across the cluster.
+ */
struct ceph_object_extent {
+ /* Linkage for lists of extents */
struct list_head oe_item;
+ /* RADOS object number containing this extent */
u64 oe_objno;
+ /* Byte offset within the object */
u64 oe_off;
+ /* Length of the extent in bytes */
u64 oe_len;
};
@@ -44,8 +53,15 @@ int ceph_iterate_extents(struct ceph_file_layout *l, u64 off, u64 len,
ceph_object_extent_fn_t action_fn,
void *action_arg);
+/*
+ * File extent metadata: Represents a contiguous range within a file.
+ * Used to describe logical file ranges that correspond to object extents
+ * after stripe mapping calculations.
+ */
struct ceph_file_extent {
+ /* Byte offset within the file */
u64 fe_off;
+ /* Length of the extent in bytes */
u64 fe_len;
};
--
2.51.0
