.. _memory:

  

##  memory

These commands report the current state of LaGriT's dynamic memory allocation.
LaGriT arrays are referenced by memory management by a two part name, block
name and partition name. It is allocated in integer or real blocks(real is
implemented as real*8). Each memory block is preceeded by a header and
terminated by a trailer. Different platforms will have different values for
integer and real word lengths. LaGriT developers read more on LaGriT memory
management at **[Memory Manager](../memmang.html)**

  
  
The following memory keywords are recognized:

> &nbsp_place_holder;

**memory / verify &nbsp_place_holder;**   
verify the integerity of LaGriT memory manager storage by checking that the
known blocks have not been overwritten. If corruption is detected, an array
map will be printed. Nothing is printed if there memory is successfully
verified.

  
  
**memory / print &nbsp_place_holder;**   
print an address map of the LaGriT managed arrays. For each array the
following is printed; index, length, type, memory address, associated name,
and partition. The partition is the grouping of arrays by usage. Common
partitions include the mesh object (by name), global memory, and temporary
memory for work arrays.

>

>

>     MEMORY SIZES :

>      Sizeof char    (type 3) =  1 bytes      Sizeof long        =   4 bytes

>      Sizeof real*8  (type 2) =  8 bytes      Sizeof pointer     =   4 bytes

>      Sizeof integer (type 1) =  4 bytes      Sizeof INT_PTRSIZE =   4 bytes

>

>     INDEX         LENGTH    TYPE     ADDRESS     NAME
PARTITION

>       29          40000000   2     -1894248416 xic
cmo1

>        1                10   3       143632720 global_name
global_lg

>       31          40000000   2      1760710688 zic
cmo1

>       30          40000000   2      2080714784 yic
cmo1

>

>     Total BYTES =    2.400E+09   Total MEGABYTES =    2.400E+03

>

>

>

>

  
**memory / maxmalloc &nbsp_place_holder;**   
Report estimate of possible amount of memory available for allocation by
LaGriT. This test will make incremental calls to internal LaGriT memory
allocation (mmgetblk) until failure. The report will include the total
Megabytes where allocation succeeded, and amount at which allocation failed.
This command will also print a map of the memory manager storage.

>

>

>      ....

>

>      MMGETBLK ERROR: value exceeds sizeof:            4

>      MAX ALLOC SIZE:    4294967296.0000000

>      ATTEMPTED SIZE:    6553600048.0000000

>      MMGETBLK: return early with error flag:          -21

>

>      Succeeded at     819.20000000000005       MEGABYTES

>      Failed at        1638.4000000000001       MEGABYTES

>

>

>

>

>

The 64 bit version for memory routines will look slightly different:

>

>

>     MEMORY SIZES :

>      Sizeof char    (type 3) =  1 bytes      Sizeof long        =   8 bytes

>      Sizeof real*8  (type 2) =  8 bytes      Sizeof pointer     =   8 bytes

>      Sizeof integer (type 1) =  4 bytes      Sizeof INT_PTRSIZE =   8 bytes

>

>     ....

>

>     util_malloc_: Out of memory, malloc return: (nil)

>        Requested value: 104857600000.000000 =    8 bit unsigned int

>      MMGETBLK FAILED: Array array_01 with bytes:          104857600096

>      MMGETBLK: return ending with error flag:                    -1

>

>      Succeeded at     52428.800000000003       MEGABYTES

>      Failed at        104857.60000000001       MEGABYTES

>

>

>

  
  
EXAMPLES:

**memory / verify **   
**memory / print **   
**memory / maxmalloc ** &nbsp_place_holder;