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_msgpool
in /include/linux/ceph/msgpool.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/msgpool.h | 15 +++++++++++----
1 file changed, 11 insertions(+), 4 deletions(-)
diff --git a/include/linux/ceph/msgpool.h b/include/linux/ceph/msgpool.h
index 729cdf700eae..27e6a53a014d 100644
--- a/include/linux/ceph/msgpool.h
+++ b/include/linux/ceph/msgpool.h
@@ -5,14 +5,21 @@
#include <linux/mempool.h>
/*
- * we use memory pools for preallocating messages we may receive, to
- * avoid unexpected OOM conditions.
+ * Ceph message pool metadata: Memory pool for preallocating network messages
+ * to avoid out-of-memory conditions during critical operations. Maintains
+ * a reserve of messages with specific types and sizes for reliable operation
+ * under memory pressure.
*/
struct ceph_msgpool {
+ /* Descriptive name for debugging and identification */
const char *name;
+ /* Underlying kernel memory pool */
mempool_t *pool;
- int type; /* preallocated message type */
- int front_len; /* preallocated payload size */
+ /* Message type for preallocated messages */
+ int type;
+ /* Size of preallocated front payload */
+ int front_len;
+ /* Maximum number of data items in preallocated messages */
int max_data_items;
};
--
2.51.0
