summaryrefslogtreecommitdiff
path: root/include/sqfs/dir_reader.h
diff options
context:
space:
mode:
authorDavid Oberhollenzer <david.oberhollenzer@sigma-star.at>2020-01-12 08:22:28 +0100
committerDavid Oberhollenzer <david.oberhollenzer@sigma-star.at>2020-01-12 08:22:28 +0100
commit90d0b5eead05174cea371788cc4766bc7739e982 (patch)
tree50615ee3109df01af43ec37a7c381c374676f544 /include/sqfs/dir_reader.h
parentc92faad51817c10570de3680e95a3fd18bb21204 (diff)
Add a start anchor parameter to sqfs_dir_reader_find_by_path
It optionally allows code that does tree traversal to start at an inode that it obtained previously and makes it easier to keep state externally. Signed-off-by: David Oberhollenzer <david.oberhollenzer@sigma-star.at>
Diffstat (limited to 'include/sqfs/dir_reader.h')
-rw-r--r--include/sqfs/dir_reader.h6
1 files changed, 5 insertions, 1 deletions
diff --git a/include/sqfs/dir_reader.h b/include/sqfs/dir_reader.h
index 8071ef4..82121ed 100644
--- a/include/sqfs/dir_reader.h
+++ b/include/sqfs/dir_reader.h
@@ -269,11 +269,14 @@ SQFS_API int sqfs_dir_reader_get_root_inode(sqfs_dir_reader_t *rd,
sqfs_inode_generic_t **inode);
/**
- * @brief Find an inode through path traversal from the root node downwards.
+ * @brief Find an inode through path traversal starting from the root or a
+ * given node downwards.
*
* @memberof sqfs_dir_reader_t
*
* @param rd A pointer to a directory reader.
+ * @param start If not NULL, path traversal starts at this node downwards. If
+ * set to NULL, start at the root node.
* @param path A path to resolve into an inode. Forward or backward slashes can
* be used to separate path components. Resolving '.' or '..' is
* not supported.
@@ -283,6 +286,7 @@ SQFS_API int sqfs_dir_reader_get_root_inode(sqfs_dir_reader_t *rd,
* @return Zero on success, an @ref E_SQFS_ERROR value on failure.
*/
SQFS_API int sqfs_dir_reader_find_by_path(sqfs_dir_reader_t *rd,
+ const sqfs_inode_generic_t *start,
const char *path,
sqfs_inode_generic_t **out);