aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDavid Oberhollenzer <david.oberhollenzer@sigma-star.at>2020-03-21 15:21:16 +0100
committerDavid Oberhollenzer <david.oberhollenzer@sigma-star.at>2020-03-22 23:30:28 +0100
commit850107807e112a3ddd8cab30d8453a4610245bc4 (patch)
treeda8926a27d4437addadcdcec532d4e90ea26de82
parent2148ad069d2c91565a82b889fe8443887bc9dc09 (diff)
doxygen: propperly label generic inode helper functions as members
Signed-off-by: David Oberhollenzer <david.oberhollenzer@sigma-star.at>
-rw-r--r--include/sqfs/inode.h24
1 files changed, 24 insertions, 0 deletions
diff --git a/include/sqfs/inode.h b/include/sqfs/inode.h
index c87f965..5359b54 100644
--- a/include/sqfs/inode.h
+++ b/include/sqfs/inode.h
@@ -533,6 +533,8 @@ extern "C" {
/**
* @brief Get the number of file blocks in a regular file inode.
*
+ * @memberof sqfs_inode_generic_t
+ *
* @param inode A pointer to an inode.
*
* @return The number of blocks.
@@ -546,6 +548,8 @@ size_t sqfs_inode_get_file_block_count(const sqfs_inode_generic_t *inode)
/**
* @brief Get the extended attribute index of an inode
*
+ * @memberof sqfs_inode_generic_t
+ *
* For basic inodes, this returns the inode index 0xFFFFFFFF, i.e. the
* sentinel value indicating that there are no xattrs.
*
@@ -561,6 +565,8 @@ SQFS_API int sqfs_inode_get_xattr_index(const sqfs_inode_generic_t *inode,
/**
* @brief Set the extended attribute index of an inode.
*
+ * @memberof sqfs_inode_generic_t
+ *
* For basic inodes, this function promes the inodes to extended inodes if the
* index is not 0xFFFFFFFF. If the index is 0xFFFFFFFF, the function tries to
* demote extended inode to a basic inode after setting the index.
@@ -577,6 +583,8 @@ SQFS_API int sqfs_inode_set_xattr_index(sqfs_inode_generic_t *inode,
/**
* @brief Convert a basic inode to an extended inode.
*
+ * @memberof sqfs_inode_generic_t
+ *
* For inodes that already have an extended type, this is a no-op.
*
* @param inode A pointer to an inode.
@@ -589,6 +597,8 @@ SQFS_API int sqfs_inode_make_extended(sqfs_inode_generic_t *inode);
/**
* @brief Convert an extended inode to a basic inode if possible.
*
+ * @memberof sqfs_inode_generic_t
+ *
* For inodes that already have a basic type, this is a no-op. If the inode
* has values set that the coresponding basic type doesn't support (e.g. it
* has an xattr index set or a regular file which requires 64 bit size
@@ -604,6 +614,8 @@ SQFS_API int sqfs_inode_make_basic(sqfs_inode_generic_t *inode);
/**
* @brief Update the file size of a regular file inode.
*
+ * @memberof sqfs_inode_generic_t
+ *
* If the new size is wider than 32 bit, a basic file inode is transparently
* promoted to an extended file inode. For extended inodes, if the new size
* is small enough and was the only requirement for the extended type, the
@@ -621,6 +633,8 @@ SQFS_API int sqfs_inode_set_file_size(sqfs_inode_generic_t *inode,
/**
* @brief Update the location of the first data block of a regular file inode.
*
+ * @memberof sqfs_inode_generic_t
+ *
* If the new location is wider than 32 bit, a basic file inode is
* transparently promoted to an extended file inode. For extended inodes,
* if the new size is small enough and was the only requirement for the
@@ -638,6 +652,8 @@ SQFS_API int sqfs_inode_set_file_block_start(sqfs_inode_generic_t *inode,
/**
* @brief Update the file fragment location of a regular file inode.
*
+ * @memberof sqfs_inode_generic_t
+ *
* @param inode A pointer to an inode.
* @param index The new fragment index to set.
* @param offset The new fragment offset to set.
@@ -651,6 +667,8 @@ SQFS_API int sqfs_inode_set_frag_location(sqfs_inode_generic_t *inode,
/**
* @brief Get the file size of a regular file inode.
*
+ * @memberof sqfs_inode_generic_t
+ *
* @param inode A pointer to an inode.
* @param size Returns the file size.
*
@@ -663,6 +681,8 @@ SQFS_API int sqfs_inode_get_file_size(const sqfs_inode_generic_t *inode,
/**
* @brief Get the file fragment location of a regular file inode.
*
+ * @memberof sqfs_inode_generic_t
+ *
* @param inode A pointer to an inode.
* @param index Returns the fragment index.
* @param offset Returns the fragment offset.
@@ -676,6 +696,8 @@ SQFS_API int sqfs_inode_get_frag_location(const sqfs_inode_generic_t *inode,
/**
* @brief Get the location of the first data block of a regular file inode.
*
+ * @memberof sqfs_inode_generic_t
+ *
* @param inode A pointer to an inode.
* @param location Returns the location.
*
@@ -688,6 +710,8 @@ SQFS_API int sqfs_inode_get_file_block_start(const sqfs_inode_generic_t *inode,
/**
* @brief Unpack the a directory index structure from an inode.
*
+ * @memberof sqfs_inode_generic_t
+ *
* The generic inode contains in its payload the raw directory index (with
* bytes swapped to host enian), but still with single byte alignment. This
* function seeks through the blob using an integer index (not offset) and