memb: update doc string
@@ -104,14 +104,14 @@ struct memb {
/**
* Initialize a memory block that was declared with MEMB().
*
- * \param m A memory block previously declared with MEMB().
+ * \param m A set of memory blocks previously declared with MEMB().
*/
void memb_init(struct memb *m);
/**
* Allocate a memory block from a block of memory declared with MEMB().
*
- * \param m A memory block previously declared with MEMB().
+ * \param m A set of memory blocks previously declared with MEMB().
*/
void *memb_alloc(struct memb *m);
@@ -119,7 +119,7 @@ void *memb_alloc(struct memb *m);
* Deallocate a memory block from a memory block previously declared
* with MEMB().
*
- * \param m m A memory block previously declared with MEMB().
+ * \param m m A set of memory blocks previously declared with MEMB().
*
* \param ptr A pointer to the memory block that is to be deallocated.
*
@@ -128,8 +128,25 @@ void *memb_alloc(struct memb *m);
*/
int memb_free(struct memb *m, void *ptr);
+/**
+ * Check if a given address is within a memory area previously
+ * declared with MEMB().
+ *
+ * \param m m A set of memory blocks previously declared with MEMB().
+ *
+ * \param ptr A pointer to the address to check
+ *
+ * \return 1 if the address is part of the memory block; otherwise 0
+ */
int memb_inmemb(struct memb *m, void *ptr);
+/**
+ * Count free memory blocks
+ *
+ * \param m m A set of memory blocks previously declared with MEMB().
+ *
+ * \return the number of free (available) memory blocks
+ */
int memb_numfree(struct memb *m);
/** @} */
