DEFINITION - SUB
    DumpGPMem file$, flags& -- create a dump of current memory contents

OPERATION
    For debugging purposes you may call this SUB to create a memory dump,
    which contains header information, a list of free areas and a complete
    printout of the array used by the GPM system.

ARGUMENTS
    file$  -- the name of the dump file, if required inlusive a full path
    flags& -- a bit field with any special characteristics (see below)

NOTES
    The contents in the GP memory is hold in big-endian notation, hence you
    find all numbers in its mathematical correct bit order just as you would
    get it using HEX$.

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 GP Memory region
                        will be filled with the word "free".  This gives a
                        better overview in the memory dump.
    gpmF_NoFreeList& -- This flag will supress the output of the free
                        areas list, which may become very long sometimes.

SEE ALSO
    Debugging Support

                                                 Back to Function Reference