From 8d7ac5375423816d5765b799746adaee6f32ca7d Mon Sep 17 00:00:00 2001
From: ligr <liguorui1213@163.com>
Date: Wed, 30 Jul 2025 12:16:05 +0800
Subject: [PATCH 1/2] [components/dfs]add doxygen comments for dfs_vnode.c in
 dfs_v2.

---
 components/dfs/dfs_v2/src/dfs_vnode.c | 35 ++++++++++++++++++++++++++-
 1 file changed, 34 insertions(+), 1 deletion(-)

diff --git a/components/dfs/dfs_v2/src/dfs_vnode.c b/components/dfs/dfs_v2/src/dfs_vnode.c
index 21778e683c3..313a857ef43 100644
--- a/components/dfs/dfs_v2/src/dfs_vnode.c
+++ b/components/dfs/dfs_v2/src/dfs_vnode.c
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2006-2023, RT-Thread Development Team
+ * Copyright (c) 2006-2025 RT-Thread Development Team
  *
  * SPDX-License-Identifier: Apache-2.0
  *
@@ -18,6 +18,15 @@
 #define DBG_LVL    DBG_WARNING
 #include <rtdbg.h>
 
+/**
+ * @brief Initialize a virtual node (vnode) structure
+ *
+ * @param[in,out] vnode Pointer to the vnode to be initialized
+ * @param[in] type Type of the vnode
+ * @param[in] fops Pointer to file operations structure
+ *
+ * @return int Always returns 0 indicating success
+ */
 int dfs_vnode_init(struct dfs_vnode *vnode, int type, const struct dfs_file_ops *fops)
 {
     if (vnode)
@@ -33,6 +42,11 @@ int dfs_vnode_init(struct dfs_vnode *vnode, int type, const struct dfs_file_ops
     return 0;
 }
 
+/**
+ * @brief Create and initialize a new virtual node (vnode)
+ *
+ * @return struct dfs_vnode* Pointer to the newly created vnode, or NULL if creation failed
+ */
 struct dfs_vnode *dfs_vnode_create(void)
 {
     struct dfs_vnode *vnode = rt_calloc(1, sizeof(struct dfs_vnode));
@@ -49,6 +63,13 @@ struct dfs_vnode *dfs_vnode_create(void)
     return vnode;
 }
 
+/**
+ * @brief Destroy a virtual node (vnode) and free its resources
+ *
+ * @param[in] vnode Pointer to the vnode to be destroyed
+ *
+ * @return int Always returns 0 indicating success
+ */
 int dfs_vnode_destroy(struct dfs_vnode* vnode)
 {
     rt_err_t ret = RT_EOK;
@@ -91,6 +112,13 @@ int dfs_vnode_destroy(struct dfs_vnode* vnode)
     return 0;
 }
 
+/**
+ * @brief Increase reference count of a virtual node (vnode)
+ *
+ * @param[in,out] vnode Pointer to the vnode to be referenced
+ *
+ * @return struct dfs_vnode* The same vnode pointer that was passed in
+ */
 struct dfs_vnode *dfs_vnode_ref(struct dfs_vnode *vnode)
 {
     if (vnode)
@@ -103,6 +131,11 @@ struct dfs_vnode *dfs_vnode_ref(struct dfs_vnode *vnode)
     return vnode;
 }
 
+/**
+ * @brief Decrease reference count of a virtual node (vnode) and potentially free it
+ *
+ * @param[in,out] vnode Pointer to the vnode to be unreferenced
+ */
 void dfs_vnode_unref(struct dfs_vnode *vnode)
 {
     rt_err_t ret = RT_EOK;

From a5e92009ec483719d34eb7f539fe2c933a41a937 Mon Sep 17 00:00:00 2001
From: Guorui Li <liguorui1213@163.com>
Date: Wed, 30 Jul 2025 20:53:03 +0800
Subject: [PATCH 2/2] Update components/dfs/dfs_v2/src/dfs_vnode.c

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 components/dfs/dfs_v2/src/dfs_vnode.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/dfs/dfs_v2/src/dfs_vnode.c b/components/dfs/dfs_v2/src/dfs_vnode.c
index 313a857ef43..d46885e0b31 100644
--- a/components/dfs/dfs_v2/src/dfs_vnode.c
+++ b/components/dfs/dfs_v2/src/dfs_vnode.c
@@ -68,7 +68,7 @@ struct dfs_vnode *dfs_vnode_create(void)
  *
  * @param[in] vnode Pointer to the vnode to be destroyed
  *
- * @return int Always returns 0 indicating success
+ * @return int Always returns 0. Note that this does not guarantee success, as errors may occur internally.
  */
 int dfs_vnode_destroy(struct dfs_vnode* vnode)
 {