Changeset 4d21cf8 in mainline for uspace/srv/vfs/vfs.h

Timestamp:

2007-11-03T14:23:57Z (18 years ago)

Author:

Jakub Jermar <jakub@…>

Branches:

lfn, master, serial, ticket/834-toolchain-update, topic/msim-upgrade, topic/simplify-dev-export

Children:

20614d0

Parents:

fa23560

Message:

VFS work.
Introduce the notion of VFS_PAIR which corresponds to a file system instance,
and VFS_TRIPLET, which corresponds to a file system node. Separate vfs_triplet_t
and vfs_node_t as the former one is the stateless counterpart of the latter.

File:

• uspace/srv/vfs/vfs.h (modified) (3 diffs)

uspace/srv/vfs/vfs.h

@@ -100 +100 @@
 
 /**
- * Instances of this type represent a file system node (e.g. directory, file).
- * They are abstracted away from any file system implementation and contain just
- * enough bits to uniquely identify the object in its file system instance.
+ * VFS_PAIR uniquely represents a file system instance.
+ */
+#define VFS_PAIR        \
+        int fs_handle;  \
+        int dev_handle; 
+
+/**
+ * VFS_TRIPLET uniquely identifies a file system node (e.g. directory, file) but
+ * doesn't contain any state. For a stateful structure, see vfs_node_t.
  *
  * @note        fs_handle, dev_handle and index are meant to be returned in one
  *              IPC reply.
  */
+#define VFS_TRIPLET     \
+        VFS_PAIR;       \
+        uint64_t index;
+
 typedef struct {
-        int fs_handle;          /**< Global file system ID. */
-        int dev_handle;         /**< Global mount device devno. */
-        uint64_t index;         /**< Index of the node on its file system. */
+        VFS_PAIR;
+} vfs_pair_t;
+
+typedef struct {
+        VFS_TRIPLET;
+} vfs_triplet_t;
+
+/**
+ * Instances of this type represent an active, in-memory VFS node and any state
+ * which may be associated with it.
+ */
+typedef struct {
+        VFS_TRIPLET;            /**< Identity of the node. */
+        atomic_t refcnt;        /**< Usage counter. */
 } vfs_node_t;
 
@@ -129 +150 @@
 extern link_t fs_head;          /**< List of registered file systems. */
 
-extern vfs_node_t rootfs;       /**< Root node of the root file system. */
+extern vfs_triplet_t rootfs;    /**< Root node of the root file system. */
 
 #define MAX_PATH_LEN            (64 * 1024)
@@ -151 +172 @@
 extern int fs_name_to_handle(char *, bool);
 
-extern int vfs_lookup_internal(char *, size_t, vfs_node_t *, vfs_node_t *);
+extern int vfs_lookup_internal(char *, size_t, vfs_triplet_t *, vfs_pair_t *);
 
 #define MAX_OPEN_FILES  128