[llvm] r230572 - [GC docs] Fill in description of the statepoint-example GC strategy

Philip Reames listmail at philipreames.com
Wed Feb 25 15:22:44 PST 2015


Author: reames
Date: Wed Feb 25 17:22:43 2015
New Revision: 230572

URL: http://llvm.org/viewvc/llvm-project?rev=230572&view=rev
Log:
[GC docs] Fill in description of the statepoint-example GC strategy


Modified:
    llvm/trunk/docs/GarbageCollection.rst
    llvm/trunk/docs/Statepoints.rst

Modified: llvm/trunk/docs/GarbageCollection.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/GarbageCollection.rst?rev=230572&r1=230571&r2=230572&view=diff
==============================================================================
--- llvm/trunk/docs/GarbageCollection.rst (original)
+++ llvm/trunk/docs/GarbageCollection.rst Wed Feb 25 17:22:43 2015
@@ -386,8 +386,8 @@ greater performance impact since pointer
 
 .. _plugin:
 
-Built In Collectors
-====================
+Built In GC Strategies
+======================
 
 LLVM includes built in support for several varieties of garbage collectors.  
 
@@ -501,7 +501,19 @@ The Statepoint Example GC
   F.setGC("statepoint-example");
 
 This GC provides an example of how one might use the infrastructure provided 
-by ``gc.statepoint``.  
+by ``gc.statepoint``. This example GC is compatible with the 
+:ref:`PlaceSafepoints` and :ref:`RewriteStatepointsForGC` utility passes 
+which simplify ``gc.statepoint`` sequence insertion. If you need to build a 
+custom GC strategy around the ``gc.statepoints`` mechanisms, it is recommended
+that you use this one as a starting point.
+
+This GC strategy does not support read or write barriers.  As a result, these 
+intrinsics are lowered to normal loads and stores.
+
+The stack map format generated by this GC strategy can be found in the 
+:ref:`stackmap-section` using a format documented :ref:`here 
+<statepoint-stackmap-format>`. This format is intended to be the standard 
+format supported by LLVM going forward.
 
 
 Custom GC Strategies

Modified: llvm/trunk/docs/Statepoints.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/Statepoints.rst?rev=230572&r1=230571&r2=230572&view=diff
==============================================================================
--- llvm/trunk/docs/Statepoints.rst (original)
+++ llvm/trunk/docs/Statepoints.rst Wed Feb 25 17:22:43 2015
@@ -322,6 +322,7 @@ A ``gc.relocate`` is modeled as a ``read
 side effects since it is just a way to extract information about work
 done during the actual call modeled by the ``gc.statepoint``.
 
+.. _statepoint-stackmap-format:
 
 Stack Map Format
 ================





More information about the llvm-commits mailing list