LibAllocPooled

Allocate memory with the pool manager (V33)

This function is a copy of the pool functions in V39 and up of EXEC. In fact, if you are running in V39, this function will notice and call the EXEC function. This function works in V33 and up (1.2) Amiga system.

The C code interface is _LibAllocPooled() and takes its arguments from the stack just like the C code interface for AllocPooled() in amiga.lib. The assembly code interface is with the symbol _AsmAllocPooled: and takes the parameters in registers with the additional parameter of ExecBase being in a6 which can be used from SAS/C 6 by a prototype of:

void * __asm AsmAllocPooled(register __a0 void *,

Allocate memSize bytes of memory, and return a pointer. NULL is returned if the allocation fails.

Doing a LibDeletePool() on the pool will free all of the puddles and thus all of the allocations done with LibAllocPooled() in that pool. (No need to LibFreePooled() each allocation)

poolHeader

A specific private pool header.

memSize

The number of bytes to allocate

memory

A pointer to the memory, or NULL. The memory block returned is long word aligned.

The pool functions do not protect an individual pool from multiple accesses. The reason is that in most cases the pools will be used by a single task. If your pool is going to be used by more than one task you must Semaphore protect the pool from having more than one task trying to allocate within the same pool at the same time. Warning: Forbid() protection *will not work* in the future. *Do NOT* assume that we will be able to make it work in the future. LibAllocPooled() may well break a Forbid() and as such can only be protected by a semaphore.

To track sizes yourself, the following code can be used: *Assumes a6=ExecBase*

Allocations should not exceed 4294967288 (0xFFFFFFF8) bytes because this may trigger a side-effect leading to far less memory to be allocated.

FreePooled(), CreatePool(), DeletePool(), LibFreePooled(), LibCreatePool(), LibDeletePool()