Changeset 603 for trunk/kernel/libk/grdxt.h

Timestamp:

Dec 3, 2018, 12:17:35 PM (6 years ago)

Author:

alain

Message:

Improve the FAT32 file system to support cat, rm, cp commands.

File:

• trunk/kernel/libk/grdxt.h (modified) (3 diffs)

trunk/kernel/libk/grdxt.h

@@ -36 +36 @@
  * Memory for the second and third levels arrays is dynamically allocated by the
  * grdxt_insert() function and is only released by grdxt_destroy().
- * It is used by the MAPPER to implement the file cache: key is the page index in file.
+ * - This structure is entirely contained in one single cluster.
+ * - All modifications (insert / remove) must be done by a thread running in local cluster.
+ * - Lookup can be done by a thread running in any cluster (local or remote).
+ ******************************************************************************************
+ * It is used by the mapper implementing the file cache:
+ * - the key is the page index in file.
+ * - the registered value is a local pointer on the page descriptor.
  ******************************************************************************************/
 
@@ -96 +102 @@
 
 /*******************************************************************************************
- * This function returns the pointer on the item identified by its key.
+ * This function returns to a local client, a local pointer on the item identified 
+ * by the <key> argument, from the radix tree identified by the <rt> local pointer.
  *******************************************************************************************
- * @ rt      : pointer on the radix-tree descriptor.
+ * @ rt      : local pointer on the radix-tree descriptor.
  * @ key     : key value.
- * @ returns pointer on found item if success / returns NULL if failure.
+ * @ returns a local pointer on found item if success / returns NULL if failure.
  ******************************************************************************************/
 void * grdxt_lookup( grdxt_t  * rt, 
                      uint32_t   key );
+
+/*******************************************************************************************
+ * This function returns to a - possibly remote - remote client, an extended pointer
+ * on the item identified by the <key> argument, from the radix tree identified by
+ * the <rt_xp> remote pointer.
+ *******************************************************************************************
+ * @ rt_xp   : extended pointer on the radix-tree descriptor.
+ * @ key     : key value.
+ * @ returns an extended pointer on found item if success / returns XPTR_NULL if failure.
+ ******************************************************************************************/
+xptr_t grdxt_remote_lookup( xptr_t     rt_xp, 
+                            uint32_t   key );
 
 /*******************************************************************************************
@@ -120 +139 @@
 
 /*******************************************************************************************
- * This function displays the current content of a radix_tree.
+ * This function displays the current content of a possibly remote radix_tree.
  *******************************************************************************************
- * @ rt      : pointer on the radix-tree descriptor.
+ * @ rt      : extended pointer on the radix-tree descriptor.
  * @ string  : radix tree identifier. 
  ******************************************************************************************/
-void grdxt_print( grdxt_t * rt,
-                  char    * string );
+void grdxt_display( xptr_t    rt_xp,
+                    char    * string );