home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / sa104os2.zip / SATHR104.ZIP / SATHER / SYSTEM / GC / README.W32 < prev    next >
Text File  |  1994-12-21  |  2KB  |  40 lines

  1. The collector currently does not handle multiple threads.  There
  2. is good reason to believe this is fixable.  (SRC M3 works with
  3. NT threads.)
  4.  
  5. The collector has only been compiled under Windows NT, with the
  6. original Microsoft SDK and Visual C++ 2.0.
  7.  
  8. It runs under both win32s and win32, but with different semantics.
  9. Under win32, all writable pages outside of the heaps and stack are
  10. scanned for roots.  Thus the collector sees pointers in DLL data
  11. segments.  Under win32s, only the main data segment is scanned.
  12. Thus all accessible objects should be excessible from local variables
  13. or variables in the main data segment.  Alternatively, other data
  14. segments (e.g. in DLLs) may be registered with the collector by
  15. calling GC_init() and then GC_register_root_section(a), where
  16. a is the address of some variable inside the data segment.  (Duplicate
  17. registrations are ignored, but not terribly quickly.)
  18.  
  19. (There are two reasons for this.  We didn't want to see many 16:16
  20. pointers.  And the VirtualQuery call has different semantics under
  21. the two systems.)
  22.  
  23. The collector test program "gctest" is linked as a GUI application,
  24. but does not open any windows.  Its output appears in the file
  25. "gc.log".  It may be started from the file manager.  The hour glass
  26. cursor will appear as long as it's running.
  27.  
  28. The cord test program has not been ported (but should port
  29. easily).  A toy editor (cord/de.exe) based on cords (heavyweight
  30. strings represented as trees) has been ported and is included.
  31. It runs fine under either win32 or win32S.  It serves as an example
  32. of a true Windows application, except that it was written by a
  33. nonexpert Windows programmer.  (There are some peculiarities
  34. in the way files are displayed.  The <cr> is displayed explicitly
  35. for standard DOS text files.  As in the UNIX version, control
  36. characters are displayed explicitly, but in this case as red text.
  37. This may be suboptimal for some tastes and/or sets of default
  38. window colors.)
  39.  
  40.