NAME

       al_get_ram_size - Allegro 5 API

SYNOPSIS

              #include <allegro5/allegro.h>

              int al_get_ram_size(void)

DESCRIPTION

       Returns  the  size in MB of the random access memory that the system Allegro is running on
       has and which could be detected, or a negative number if  detection  failed.   Even  if  a
       positive  number  is  returned,  it might be that it is not correct.  For example, Allegro
       running on a virtual machine will return the amount of RAM of the VM, and not that of  the
       underlying system.

       Furthermore even if the number is correct, this only gives you information about the total
       physical memory of the system Allegro runs on.  The memory available to your  program  may
       be  less  or  more  than  what  this function returns due to circumstances such as virtual
       memory, and other programs that are currently running.

       Therefore, it's best to use this for advisory purposes only.  It is certainly a  bad  idea
       to  make  your  program  exclusive  to  systems  for which this function returns a certain
       "desirable" number.

       This function may be called prior to al_install_system(3alleg5) or al_init(3alleg5).

SINCE

       5.1.12