AcornSearch - Acorn and RISC OS information searching
RISC OS Search
containing
"Nutty quip goes here!"
Home  |  About  |  Filebase Archive  |  StrongHelp Manuals  |  Newsgroups  |  Module Database
Initialise a client with MAlloc
=>     r0 = pointer to a null terminated string
     r1 = flags:
bit     0 =     OK to use top of WimpSlot instead of a dynamic area
bit     1 =     If using top of WimpSlot, r2 points to top of program
bits     2-31     reserved
     r2 = top of program, if bit 1 of r1 set
     r3 = initial size of heap
<=     r0 = address of heap

MAlloc claims a heap and sets it up.  On a dynamic area enabled machine, a dynamic area will be created, using the name pointed to by r0.  If dynamic areas are not available, then bit 0 of r1 is checked.  If it is clear, an error is returned.  If set, then MAlloc will use the memory above the top of the program as the heap.  If bit 1 of r1 is set, then the value in r2 is used as the beginning of the heap, else OS_GetEnv is used to find the top of RAM.

[sh-index] Back to list of manuals