DEFINITION - SUB
    InitGPMem maxSize&, flags& -- init the general purpose memory system

OPERATION
    This routine will setup the GPM system for use.  It will DIM the
    required array and prepare the administrative structures to keep
    track of the available memory.  You must call this once before any
    other GP Memory functions can be used.

ARGUMENTS
    maxSize& -- the maximum size (in bytes) which you wanna allow the GP
                memory region to grow  (The GPM system will automatically
                round this number to a multiple of the minimum supported
                memory block size)
    flags&   -- a bit field with any special characteristics (see below)

NOTES
    If any invalid maxSize& was given (ie. less/equal zero), then this
    routine will fallback to the default size of 512KiB (524288& bytes).

FLAGS
    The flags& defined in the include file memory.bi are bit-coded values,
    hence they can easily combined by ORing or adding them:

    gpmF_MarkFree& -- If given, then all free LONGs in the new initialized
                      GP Memory region will be filled with the word "free".
                      This is for better overview in a memory dump.

SEE ALSO
    Initializing GP Memory

                                                 Back to Function Reference