Home / Autodocs / exec.library
NAME
- Allocate
-
allocate a block of memory
SYNOPSIS
memoryBlock = Allocate(memHeader, byteSize)
D0 A0 D0
void *Allocate(struct MemHeader *, ULONG);
D0 A0 D0
void *Allocate(struct MemHeader *, ULONG);
FUNCTION
This function is used to allocate blocks of memory from a given private free memory pool (as specified by a MemHeader and its memory chunk list). Allocate will return the first free block that is greater than or equal to the requested size.
All blocks, whether free or allocated, will be block aligned; hence, all allocation sizes are rounded up to the next block even value (e.g. the minimum allocation resolution is currently 8 bytes. A request for 8 bytes will use up exactly 8 bytes. A request for 7 bytes will also use up exactly 8 bytes.).
This function can be used to manage an application's internal data memory. Note that no arbitration of the MemHeader and associated free chunk list is done. You must be the owner before calling Allocate.
All blocks, whether free or allocated, will be block aligned; hence, all allocation sizes are rounded up to the next block even value (e.g. the minimum allocation resolution is currently 8 bytes. A request for 8 bytes will use up exactly 8 bytes. A request for 7 bytes will also use up exactly 8 bytes.).
This function can be used to manage an application's internal data memory. Note that no arbitration of the MemHeader and associated free chunk list is done. You must be the owner before calling Allocate.
INPUTS
- memHeader
-
points to the local memory list header.
- byteSize
-
the size of the desired block in bytes.
RESULT
- memoryBlock
-
a pointer to the just allocated free block. If there are no free regions large enough to satisfy the request, return zero.
EXAMPLE
#include <proto/exec.h>
#include <exec/memory.h>
#define BLOCKSIZE 4096 /* Or whatever you want */
void main()
{
}
#include <exec/memory.h>
#define BLOCKSIZE 4096 /* Or whatever you want */
void main()
{
struct MemHeader *mh;
struct MemChunk *mc;
APTR block1;
APTR block2;
/* Get the MemHeader needed to keep track of our new block */
mh = (struct MemHeader *)
if( mh == NULL )
/* Get the actual block the above MemHeader will manage */
mc = (struct MemChunk *)AllocMem( BLOCKSIZE, MEMF_ANY );
if( mc == NULL )
{
}
mh->mh_Node.ln_Type = NT_MEMORY;
mh->mh_Node.ln_Name = "myname";
mh->mh_First = mc;
mh->mh_Lower = (APTR) mc;
mh->mh_Upper = (APTR) ( BLOCKSIZE + (BYTE *)mc );
mh->mh_Free = BLOCKSIZE;
/* Set up first chunk in the freelist */
mc->mc_Next = NULL;
mc->mc_Bytes = BLOCKSIZE;
block1 = (APTR) Allocate( mh, 20 );
block2 = (APTR) Allocate( mh, 314 );
printf("mh=$%lx mc=$%lx\n",mh,mc);
printf("Block1=$%lx, Block2=$%lx\n",block1,block2);
FreeMem( mh, sizeof(struct MemHeader) );
FreeMem( mc, BLOCKSIZE );
struct MemChunk *mc;
APTR block1;
APTR block2;
/* Get the MemHeader needed to keep track of our new block */
mh = (struct MemHeader *)
AllocMem(sizeof(struct MemHeader), MEMF_CLEAR );
exit(10);
mc = (struct MemChunk *)AllocMem( BLOCKSIZE, MEMF_ANY );
if( mc == NULL )
{
mh->mh_Node.ln_Type = NT_MEMORY;
mh->mh_Node.ln_Name = "myname";
mh->mh_First = mc;
mh->mh_Lower = (APTR) mc;
mh->mh_Upper = (APTR) ( BLOCKSIZE + (BYTE *)mc );
mh->mh_Free = BLOCKSIZE;
/* Set up first chunk in the freelist */
mc->mc_Next = NULL;
mc->mc_Bytes = BLOCKSIZE;
block1 = (APTR) Allocate( mh, 20 );
block2 = (APTR) Allocate( mh, 314 );
printf("mh=$%lx mc=$%lx\n",mh,mc);
printf("Block1=$%lx, Block2=$%lx\n",block1,block2);
FreeMem( mh, sizeof(struct MemHeader) );
FreeMem( mc, BLOCKSIZE );
WARNING
The result of any memory allocation MUST be checked, and a viable error handling path taken. ANY allocation may fail if memory has been filled.
Memory allocation and deallocation as well as querying how much memory is available requires a Task or, by extension, a Process. None of the exec kernel memory management operations is safe to call from interrupt code!
Memory allocation and deallocation as well as querying how much memory is available requires a Task or, by extension, a Process. None of the exec kernel memory management operations is safe to call from interrupt code!
NOTES
If the free list is corrupt, the system will panic with alert AN_MemCorrupt, $01000005.