next | previous | forward | backward | up | top | index | toc | Macaulay2 website
Macaulay2Doc :: GCstats

GCstats -- information about the status of the garbage collector

Description

Macaulay2 uses the Hans Boehm garbage collector to reclaim unused memory. The function GCstats provides information about its status.

i1 : s = GCstats()

o1 = HashTable{don't expand => false            }
               finalize on demand => false
               full freq => 19
               GC_ALL_INTERIOR_POINTERS => 
               GC_all_interior_pointers => 1
               GC_BACKTRACES => 
               GC_DISABLE_INCREMENTAL => 
               GC_DONT_GC => 
               GC_DUMP_REGULARLY => 
               GC_ENABLE_INCREMENTAL => 
               GC_FIND_LEAK => 
               GC_FORCE_UNMAP_ON_GCOLLECT => 
               GC_FREE_SPACE_DIVISOR => 
               GC_free_space_divisor => 12
               GC_FULL_FREQUENCY => 
               GC_IGNORE_GCJ_INFO => 
               GC_INITIAL_HEAP_SIZE => 
               GC_LARGE_ALLOC_WARN_INTERVAL => 1
               GC_LOG_FILE => 
               GC_LOOP_ON_ABORT => 
               GC_MARKERS => 
               GC_MAXIMUM_HEAP_SIZE => 
               GC_NO_BLACKLIST_WARNING => 
               GC_NPROCS => 
               GC_PAUSE_TIME_TARGET => 
               GC_PRINT_ADDRESS_MAP => 
               GC_PRINT_BACK_HEIGHT => 
               GC_PRINT_STATS => 
               GC_PRINT_VERBOSE_STATS => 
               GC_RETRY_SIGNALS, => 
               GC_TRACE => 
               GC_UNMAP_THRESHOLD => 
               GC_USE_GETWRITEWATCH => 
               heap size => 114536448
               java finalization => false
               max retries => 0
               number of collections => 1043
               parallel => false
               time limit => 50

o1 : HashTable

The value returned is a hash table, from which individual bits of information can be easily extracted, as follows.

i2 : s#"heap size"

o2 = 114536448

The entries whose keys are upper case give the values of environment variables affecting the operation of the garbage collector that have been specified by the user.

For further information about the individual items in the table, we refer the user to the source code and documentation of the garbage collector.

See also

For the programmer

The object GCstats is a compiled function.