X-Git-Url: https://git.ucc.asn.au/?a=blobdiff_plain;f=Kernel%2Finclude%2Fvfs.h;h=73161a1c857aafc30af0dad831c3da24b4d35976;hb=8657dc5b4f380b2c45e1f54b9843f8a80a0cd49e;hp=988a61120cc1cbfe74532dec6966425c30a3490a;hpb=11e9a26f9aa039eb2b4edcf55c1295e640b5999a;p=tpg%2Facess2.git

diff --git a/Kernel/include/vfs.h b/Kernel/include/vfs.h
index 988a6112..73161a1c 100644
--- a/Kernel/include/vfs.h
+++ b/Kernel/include/vfs.h
@@ -67,6 +67,15 @@ typedef struct sVFS_SelectList	tVFS_SelectList;
  * inherit the GID of the parent.
  */
 #define VFS_FFLAG_SETGID	0x10
+
+/**
+ * \brief "Don't do Write-Back" Flag
+ *
+ * Stops the VFS from calling tVFS_Node.Write on dirty pages when a region
+ * is unmapped. Nice for read-only files and memory-only files (or 
+ * pseudo-readonly filesystems)
+ */
+#define VFS_FFLAG_NOWRITEBACK
 /**
  * \}
  */
@@ -146,6 +155,7 @@ typedef struct sVFS_Node
 	
 	/**
 	 * \name VFS_Select() fields
+	 * \note Used by the VFS internals, drivers should use VFS_Mark*
 	 * \{
 	 */
 	 int	DataAvaliable;
@@ -157,6 +167,15 @@ typedef struct sVFS_Node
 	/**
 	 * \}
 	 */
+
+	/**
+	 * \name VFS_MMap() fields
+	 * \{
+	 */
+	void	*MMapInfo;
+	/**
+	 * \}
+	 */
 	
 	/**
 	 * \name Common Functions
@@ -215,6 +234,17 @@ typedef struct sVFS_Node
 	 * \return Number of bytes read
 	 */
 	Uint64	(*Write)(struct sVFS_Node *Node, Uint64 Offset, Uint64 Length, void *Buffer);
+
+	/**
+	 * \brief Map a region of a file into memory
+	 * \param Node	Pointer to this node
+	 * \param Offset	Start of the region (page aligned)
+	 * \param Length	Length of the region (page aligned)
+	 * \param Dest	Location to which to map
+	 * \return Boolean Failure
+	 * \note If NULL, the VFS implements it using .Read
+	 */
+	 int	(*MMap)(struct sVFS_Node *Node, Uint64 Offset, int Length, void *Dest);
 	
 	/**
 	 * \}
@@ -331,6 +361,20 @@ extern int	VFS_AddDriver(tVFS_Driver *Info);
  * \param Name	Name of filesystem driver to find
  */
 extern tVFS_Driver	*VFS_GetFSByName(const char *Name);
+
+
+/**
+ * \brief Prepare a node for use
+ */
+extern void	VFS_InitNode(tVFS_Node *Node);
+
+/**
+ * \brief Clean up a node, ready for deletion
+ * \note This should ALWAYS be called before a node is freed, as it
+ *       cleans up VFS internal structures.
+ */
+extern void	VFS_CleanupNode(tVFS_Node *Node);
+
 /**
  * \fn tVFS_ACL *VFS_UnixToAcessACL(Uint Mode, Uint Owner, Uint Group)
  * \brief Transforms Unix Permssions into Acess ACLs
@@ -342,23 +386,29 @@ extern tVFS_Driver	*VFS_GetFSByName(const char *Name);
 extern tVFS_ACL	*VFS_UnixToAcessACL(Uint Mode, Uint Owner, Uint Group);
 
 /**
+ * \brief Flags fro \a TypeFlag of VFS_SelectNode
+ * \{
+ */
+#define VFS_SELECT_READ	0x01
+#define VFS_SELECT_WRITE	0x02
+#define VFS_SELECT_ERROR	0x04
+/**
+ * \}
  */
-enum eVFS_SelectTypes
-{
-	VFS_SELECT_READ,
-	VFS_SELECT_WRITE,
-	VFS_SELECT_ERROR
-};
 
 /**
  * \brief Wait for an event on a node
  * \param Node	Node to wait on
  * \param Type	Type of wait
  * \param Timeout	Time to wait (NULL for infinite wait)
+ * \param Name	Name to show in debug output
  * \return Number of nodes that actioned (0 or 1)
  */
-extern int	VFS_SelectNode(tVFS_Node *Node, enum eVFS_SelectTypes Type, tTime *Timeout);
+extern int	VFS_SelectNode(tVFS_Node *Node, int Type, tTime *Timeout, const char *Name);
 
+/**
+ * \brief Change the full flag on a node
+ */
 extern int	VFS_MarkFull(tVFS_Node *Node, BOOL IsBufferFull);
 extern int	VFS_MarkAvaliable(tVFS_Node *Node, BOOL IsDataAvaliable);
 extern int	VFS_MarkError(tVFS_Node *Node, BOOL IsErrorState);