diff options
author | David Oberhollenzer <david.oberhollenzer@sigma-star.at> | 2020-03-21 15:21:16 +0100 |
---|---|---|
committer | David Oberhollenzer <david.oberhollenzer@sigma-star.at> | 2020-03-22 23:30:28 +0100 |
commit | 850107807e112a3ddd8cab30d8453a4610245bc4 (patch) | |
tree | da8926a27d4437addadcdcec532d4e90ea26de82 /include | |
parent | 2148ad069d2c91565a82b889fe8443887bc9dc09 (diff) |
doxygen: propperly label generic inode helper functions as members
Signed-off-by: David Oberhollenzer <david.oberhollenzer@sigma-star.at>
Diffstat (limited to 'include')
-rw-r--r-- | include/sqfs/inode.h | 24 |
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 |