README.sgi 1.7 KB

123456789101112131415161718192021222324252627282930313233343536373839
  1. Performance of the incremental collector can be greatly enhanced with
  2. -DNO_EXECUTE_PERMISSION.
  3. The collector should run with all of the -32, -n32 and -64 ABIs. Remember to
  4. define the AS macro in the Makefile.direct to be "as -64", or "as -n32".
  5. If you use -DREDIRECT_MALLOC=GC_malloc with C++ code, your code should make
  6. at least one explicit call to malloc instead of new to ensure that the proper
  7. version of malloc is linked in.
  8. Sproc threads are not supported.
  9. Pthreads support is provided. This requires that:
  10. 1) You compile the collector with -DGC_THREADS specified in Makefile.direct.
  11. 2) You have the latest pthreads patches installed.
  12. (Though the collector makes only documented pthread calls,
  13. it relies on signal/threads interactions working just right in ways
  14. that are not required by the standard. It is unlikely that this code
  15. will run on other pthreads platforms. But please tell me if it does.)
  16. 3) Every file that makes thread calls should define GC_THREADS and then
  17. include gc.h. Gc.h redefines some of the pthread primitives as macros which
  18. also provide the collector with information it requires.
  19. 4) pthread_cond_wait and pthread_cond_timedwait should be prepared for
  20. premature wakeups. (I believe the pthreads and related standards require this
  21. anyway. Irix pthreads often terminate a wait if a signal arrives.
  22. The garbage collector uses signals to stop threads.)
  23. 5) It is expensive to stop a thread waiting in IO at the time the request is
  24. initiated. Applications with many such threads may not exhibit acceptable
  25. performance with the collector. (Increasing the heap size may help.)
  26. 6) The collector should not be compiled with -DREDIRECT_MALLOC. This
  27. confuses some library calls made by the pthreads implementation, which
  28. expect the standard malloc.