=================================================================== RCS file: /home/cvs/OpenXM_contrib2/asir2000/gc/doc/README.environment,v retrieving revision 1.1 retrieving revision 1.2 diff -u -p -r1.1 -r1.2 --- OpenXM_contrib2/asir2000/gc/doc/README.environment 2002/07/24 08:00:16 1.1 +++ OpenXM_contrib2/asir2000/gc/doc/README.environment 2003/06/24 05:11:38 1.2 @@ -5,6 +5,8 @@ platforms. GC_INITIAL_HEAP_SIZE= - Initial heap size in bytes. May speed up process start-up. +GC_MAXIMUM_HEAP_SIZE= - Maximum collected heap size. + GC_LOOP_ON_ABORT - Causes the collector abort routine to enter a tight loop. This may make it easier to debug, such a process, especially for multithreaded platforms that don't produce usable core @@ -19,6 +21,11 @@ GC_PRINT_STATS - Turn on as much logging as is easily by setting GC_quiet. On by default if the collector was built without -DSILENT. +GC_DUMP_REGULARLY - Generate a GC debugging dump GC_dump() on startup + and during every collection. Very verbose. Useful + if you have a bug to report, but please include only the + last complete dump. + GC_PRINT_ADDRESS_MAP - Linux only. Dump /proc/self/maps, i.e. various address maps for the process, to stderr on every GC. Useful for mapping root addresses to source for deciphering leak @@ -69,6 +76,16 @@ GC_PRINT_BACK_HEIGHT - Print max length of chain throu of Conservative Garbage Collectors", POPL 2001, or http://lib.hpl.hp.com/techpubs/2001/HPL-2001-251.html . +GC_RETRY_SIGNALS, GC_NO_RETRY_SIGNALS - Try to compensate for lost + thread suspend signals in linux_threads.c. On by + default for GC_OSF1_THREADS, off otherwise. Note + that this does not work around a possible loss of + thread restart signals. This seems to be necessary for + some versions of Tru64. Since we've previously seen + similar issues on some other operating systems, it + was turned into a runtime flag to enable last-minute + work-arounds. + The following turn on runtime flags that are also program settable. Checked only during initialization. We expect that they will usually be set through other means, but this may help with debugging and testing: @@ -93,7 +110,9 @@ GC_PAUSE_TIME_TARGET - Set the desired garbage collect run on a multiprocessor, incremental collection should only be used with unlimited pause time. -GC_FIND_LEAK - Turns on GC_find_leak and thus leak detection. +GC_FIND_LEAK - Turns on GC_find_leak and thus leak detection. Forces a + collection at program termination to detect leaks that would + otherwise occur after the last GC. GC_ALL_INTERIOR_POINTERS - Turns on GC_all_interior_pointers and thus interior pointer recognition.