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

Timestamp:

Dec 6, 2019, 12:07:51 PM (4 years ago)

Author:

alain

Message:

Fix several bugs in the FATFS and in the VFS,
related to the creation of big files requiring
more than 4 Kbytes (one cluster) on device.

File:

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

trunk/kernel/libk/grdxt.h

@@ -61 +61 @@
 /*******************************************************************************************
  * This function initialises the radix-tree descriptor,
+ * and allocates memory for the first level array of pointers.
  * It must be called by a local thread.
- * and allocates memory for the first level array of pointers.
  *******************************************************************************************
  * @ rt        : pointer on the radix-tree descriptor.
@@ -77 +77 @@
 /*******************************************************************************************
  * This function releases all memory allocated to the radix-tree infrastructure.
+ * A warning message is printed on the kernel TXT0 if the radix tree is not empty.
  * It must be called by a local thread.
- * A warning message is printed on the kernel TXT0 if the radix tree is not empty.
  *******************************************************************************************
  * @ rt      : pointer on the radix-tree descriptor.
@@ -86 +86 @@
 /*******************************************************************************************
  * This function insert a new item in the radix-tree.
+ * It dynamically allocates memory for new second and third level arrays if required.
  * It must be called by a local thread.
- * It dynamically allocates memory for new second and third level arrays if required.
  *******************************************************************************************
  * @ rt      : pointer on the radix-tree descriptor.
@@ -100 +100 @@
 /*******************************************************************************************
  * This function removes an item identified by its key from the radix tree,
+ * and returns a pointer on the removed item. No memory is released.
  * It must be called by a local thread.
- * and returns a pointer on the removed item. No memory is released.
  *******************************************************************************************
  * @ rt      : pointer on the radix-tree descriptor.
@@ -124 +124 @@
 /*******************************************************************************************
  * This function scan all radix-tree entries in increasing key order, starting from
+ * the value defined by the <start_key> argument, and return a pointer on the first valid
+ * registered item, and the found item key value.
  * It must be called by a local thread.
- * the value defined by the <key> argument, and return a pointer on the first valid
- * registered item, and the found item key value.
  *******************************************************************************************
  * @ rt         : pointer on the radix-tree descriptor.
  * @ start_key  : key starting value for the scan.
  * @ found_key  : [out] buffer for found key value.
- * @ return pointer on first valid item if found / return NULL if not found.
+ * @ return pointer on first valid item if found / return NULL if no item found.
  ******************************************************************************************/
 void * grdxt_get_first( grdxt_t  * rt,