Subject: afs/Documentation/filesystems cachefs.txt,1.4,1.5

From: [email-masked]
Date: Tue, 16 Sep 2003 17:49:29 +0100

Update of /home/cvs/afs/Documentation/filesystems
In directory phoenix.infradead.org:/tmp/cvs-serv19856/Documentation/filesystems

Modified Files:
	cachefs.txt 
Log Message:
added unjournalled block alteration and cookie index data update capability

Index: cachefs.txt
===================================================================
RCS file: /home/cvs/afs/Documentation/filesystems/cachefs.txt,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- cachefs.txt	19 Aug 2003 13:37:08 -0000	1.4
+++ cachefs.txt	16 Sep 2003 16:49:26 -0000	1.5
@@ -640,6 +640,20 @@
 operation started by the read/alloc and write functions.

+INDEX AND DATA FILE UPDATE
+--------------------------
+
+To request an update of the index data for an index or data file, the following
+function should be called:
+
+	void cachefs_update_cookie(struct cachefs_cookie *cookie);
+
+This function will refer back to the netfs_data pointer stored in the cookie by
+the acquisition function to obtain the data to write into each revised index
+entry. The update method in the parent index definition will be called to
+transfer the data.
+
+
 INDEX AND DATA FILE UNREGISTRATION
 ----------------------------------
 
@@ -741,3 +755,11 @@
 		}
 		return 0;
 	}
+
+
+INDEX AND DATA FILE INVALIDATION
+--------------------------------
+
+There is no direct way to invalidate an index subtree or a data file. To do
+this, the caller should relinquish and retire the cookie they have, and then
+acquire a new one.