Skip to content

Latest commit

 

History

History
50 lines (33 loc) · 1.13 KB

AvailMem.md

File metadata and controls

50 lines (33 loc) · 1.13 KB
Raw

NAME

AvailMem -- memory available given certain requirements

SYNOPSIS

    size = AvailMem(attributes)
    D0              D1

    ULONG AvailMem(ULONG);

FUNCTION

This function returns the amount of free memory given certain attributes.

To find out what the largest block of a particular type is, add MEMF_LARGEST into the requirements argument. Returning the largest block is a slow operation.

WARNING

Due to the effect of multitasking, the value returned may not actually be the amount of free memory available at that instant.

INPUTS

requirements - a requirements mask as specified in AllocMem. Any of the AllocMem bits are valid, as is MEMF_LARGEST which returns the size of the largest block matching the requirements.

RESULT size - total free space remaining (or the largest free block).

NOTE For V36 Exec, AvailMem(MEMF_LARGEST) does a consistency check on the memory list. Alert AN_MemoryInsane will be pulled if any mismatch is noted.

EXAMPLE AvailMem(MEMF_CHIP|MEMF_LARGEST); /* return size of largest available chip memory chunk */

SEE ALSO

exec/memory.h