Keil Logo Arm Logo
Products Download Events Support Videos

Technical Support

On-Line Manuals

C166 User's Guide

C166 Introduction Compiling Programs Language Extensions Preprocessor Advanced Programming Error Messages Library Reference Library Files Source Code Standard Types jmp_buf ptrdiff_t size_t va_list wchar_t Macros HARRAY HVAR MARRAY MVAR XARRAY XVAR Routines By Category Buffer Manipulation Routines Character Routines Data Conversion Routines Intrinsic Routines Math Routines Memory Allocation Routines Stream I/O Routines String Routines Variable Length Argument Routines Miscellaneous Routines Include Files SFR Definitions absacc.h assert.h ctype.h float.h intrins.h limits.h math.h membox.h setjmp.h stdarg.h stddef.h stdio.h stdlib.h string.h Reference _alloc_boxf _alloc_boxh _alloc_boxn _atomic_ _bfld_ _calloc_boxf _calloc_boxh _calloc_boxn _chkdouble_ _chkfloat_ _crol_ _cror_ _diswdt_ _einit_ _endatomic_ _free_boxf _free_boxh _free_boxn _getkey _idle_ _init_boxf _init_boxh _init_boxn _irol_ _iror_ _lrol_ _lror_ _nop_ _pop_ _prior_ _priord_ _push_ _pwrdn_ _sof_ _srvwdt_ _testclear_ _testset_ _tolower _toupper _trap_ abs acos asin assert atan atan2 atof atoi atol calloc calloc_b ceil cos cosh exp fabs floor fmemccpy fmemchr fmemcmp fmemcpy fmemmove fmemset fmod free free_b fstrcat fstrchr fstrcmp fstrcpy fstrcspn fstrlen fstrncat fstrncmp fstrncpy fstrpbrk fstrpos fstrrchr fstrrpbrk fstrrpos fstrspn getchar gets hmemcmp hmemcpy hstrcmp hstrcpy init_mempool init_mempool_b isalnum isalpha iscntrl isdigit isgraph islower isprint ispunct isspace isupper isxdigit labs log log10 longjmp malloc malloc_b memccpy memchr memcmp memcpy memmove memset modf offsetof pow printf putchar puts rand realloc realloc_b scanf setjmp sin sinh sprintf sqrt srand sscanf strcat strchr strcmp strcpy strcspn strlen strncat strncmp strncpy strpbrk strpos strrchr strrpbrk strrpos strspn strstr strtod strtol strtoul tan tanh toascii toint tolower toupper ungetchar va_arg va_end va_start vprintf vsprintf xcalloc xfree xinit_mempool xmalloc xmemccpy xmemchr xmemcmp xmemcpy xmemmove xmemset xrealloc xstrcmp xstrcpy xstrlen xstrncpy Appendix

C166 User's Guide

init_mempool

Summary 
#include <stdlib.h>

void init_mempool (
  void far *p,    /* start of memory pool */
  size_t size);   /* length of memory pool */

or

void init_mempool (
  void huge *p,   /* start of memory pool */
  size_t size);   /* length of memory pool */

or

void init_mempool (
  void xhuge *p,  /* start of memory pool */
  size_t size);   /* length of memory pool */
Description

The init_mempool function initializes the memory management routines and provides the starting address and size of the memory pool. The p argument points to a memory area in xdata which is managed using the calloc, free, malloc, and realloc library functions. The size argument specifies the number of bytes to use for the memory pool.

Note

  • This function must be used to setup the memory pool before any other memory management functions (calloc, free, malloc, realloc) can be called. Call the init_mempool function only once at the beginning of your program.
  • Source code for this routine is provide in the LIB folder. You may modify the source to customize this function for your particular hardware environment.
  • Pointer arguments and return values are far in Small, Medium, Compact, and Large Memory Models; huge in HCompact and HLarge Memory Models; and xhuge in the XLarge Memory Model. This function is not supported in the Tiny Memory Model.
  • Each memory block needs 6 bytes overhead to handle the allocation information. In addition another 6 bytes are required for init_mempool itself. Therefore, to allocate 2 blocks with 100 bytes each, the memory pool size must be 218 bytes.
Return Value

None.

See Also

calloc, free, malloc, realloc

Example
#include <stdlib.h>


unsigned int malloc_mempool [0x800];  // 4KB memory pool

void tst_init_mempool (void) {
  int i;
  void far *p;

  init_mempool (&malloc_mempool, sizeof(malloc_mempool));

  p = malloc (100);

  for (i = 0; i < 100; i++)
    ((char *) p)[i] = i;

  free (p);
}

Products

Development Tools

 

Hardware & Collateral

Downloads

Support

Buy

Keil logo

Contact Us | Site Feedback | Terms of Use | Privacy Policy

Copyright © 2013 ARM Ltd and ARM Germany GmbH. All rights reserved.

 Arm logo
Important information

This site uses cookies to store information on your computer. By continuing to use our site, you consent to our cookies.