Done some work on task #1549 (function documentation)

This commit is contained in:
goldsimon 2007-06-07 21:36:20 +00:00
parent 1a25062af0
commit 8d6013454c

View File

@ -154,6 +154,9 @@ static u8_t memp_memory[MEM_ALIGNMENT - 1 +
MEMP_TYPE_SIZE(MEMP_NUM_SYS_TIMEOUT, struct sys_timeo)]; MEMP_TYPE_SIZE(MEMP_NUM_SYS_TIMEOUT, struct sys_timeo)];
#if MEMP_SANITY_CHECK #if MEMP_SANITY_CHECK
/**
* Check that memp-lists don't form a circle
*/
static int static int
memp_sanity(void) memp_sanity(void)
{ {
@ -174,6 +177,13 @@ memp_sanity(void)
} }
#endif /* MEMP_SANITY_CHECK*/ #endif /* MEMP_SANITY_CHECK*/
#if MEMP_OVERFLOW_CHECK #if MEMP_OVERFLOW_CHECK
/**
* Check if a memp element was victim of an overflow
* (e.g. the restricted area after it has been altered)
*
* @param p the memp element to check
* @param memp_size the element size of the pool p comes from
*/
static void static void
memp_overflow_check_element(struct memp *p, u16_t memp_size) memp_overflow_check_element(struct memp *p, u16_t memp_size)
{ {
@ -196,6 +206,11 @@ memp_overflow_check_element(struct memp *p, u16_t memp_size)
} }
#endif #endif
} }
/**
* Do an overflow check for all elements in every pool.
*
* @see memp_overflow_check_element for a description of the check
*/
static void static void
memp_overflow_check_all(void) memp_overflow_check_all(void)
{ {
@ -211,6 +226,9 @@ memp_overflow_check_all(void)
} }
} }
} }
/**
* Initialize the restricted areas of all memp elements in every pool.
*/
static void static void
memp_overflow_init(void) memp_overflow_init(void)
{ {
@ -236,6 +254,9 @@ memp_overflow_init(void)
} }
#endif /* MEMP_OVERFLOW_CHECK */ #endif /* MEMP_OVERFLOW_CHECK */
/**
* Initialize this module.
*/
void void
memp_init(void) memp_init(void)
{ {
@ -251,8 +272,10 @@ memp_init(void)
#endif /* MEMP_STATS */ #endif /* MEMP_STATS */
memp = MEM_ALIGN(memp_memory); memp = MEM_ALIGN(memp_memory);
/* for every pool: */
for (i = 0; i < MEMP_MAX; ++i) { for (i = 0; i < MEMP_MAX; ++i) {
memp_tab[i] = NULL; memp_tab[i] = NULL;
/* create a linked list of memp elements */
for (j = 0; j < memp_num[i]; ++j) { for (j = 0; j < memp_num[i]; ++j) {
memp->next = memp_tab[i]; memp->next = memp_tab[i];
memp_tab[i] = memp; memp_tab[i] = memp;
@ -266,6 +289,11 @@ memp_init(void)
#endif /* MEMP_OVERFLOW_CHECK */ #endif /* MEMP_OVERFLOW_CHECK */
} }
/**
* Get an element from a specific pool.
*
* @param type the pool to get an element from
*/
void * void *
#if MEMP_OVERFLOW_CHECK #if MEMP_OVERFLOW_CHECK
memp_malloc_fn(memp_t type, const char* file, const int line) memp_malloc_fn(memp_t type, const char* file, const int line)
@ -312,6 +340,12 @@ memp_malloc(memp_t type)
return (void*)((u8_t*)memp + MEMP_SIZE); return (void*)((u8_t*)memp + MEMP_SIZE);
} }
/**
* Put an element back into its pool.
*
* @param type the pool where to put mem
* @param mem the memp element to free
*/
void void
memp_free(memp_t type, void *mem) memp_free(memp_t type, void *mem)
{ {