[WIP] New GC related APIs.

include/v8.h

Index: include/v8.h
diff --git a/include/v8.h b/include/v8.h
index 8dabef0d5885448bfdd590c37f88ab4dfe8218a0..a7ede84ba5f38cd08f59d936948a9604e09f3453 100644
--- a/include/v8.h
+++ b/include/v8.h
@@ -3440,6 +3440,8 @@ class V8EXPORT V8 {
    * for partially dependent handles only.
    * See v8-profiler.h for RetainedObjectInfo interface description.
    */
+  // TODO(marja): deprecate AddObjectGroup. Use SetObjectGroupID and
+  // SetRetainedObjectInfo instead.
   static void AddObjectGroup(Persistent<Value>* objects,
                              size_t length,
                              RetainedObjectInfo* info = NULL);
@@ -3448,6 +3450,14 @@ class V8EXPORT V8 {
                              size_t length,
                              RetainedObjectInfo* info = NULL);
 
+  static void SetObjectGroupId(Isolate* isolate,
+                               const Persistent<Value>& object,
+                               void* id);

[Michael Starzinger, 2013/04/09 14:18:40]

Is void* the right type for this "color", would it be possible to use either
intptr_t or uintptr_t instead?

[marja, 2013/04/09 16:46:51]

Didn't change this yet... svenpanne@, what's your take (void* vs. intptr_t)?
Would it help if I rename "id" to color?

[Sven Panne, 2013/04/10 08:31:46]

Any "foo*" has an implicit connotation of "I can be dereferenced somehow", OTOH
void* is the traditional way of passing "something I don't know" around. I'm a
bit torn here... We talked about another API change where we will need some kind
of unique identifier. Perhaps the cleanest way might be a separate class
"UniqueId", wrapping an intptr_t, with only some operators like == and < on it.
(Perhaps something like HashCode might be good, too, I don't know all use
cases.) Using such a class at least removes the need to comment the signature
here, just a "void* id" is a bit opaque.

+
+  static void SetRetainedObjectInfo(Isolate* isolate,
+                                    void* id,
+                                    RetainedObjectInfo* info);
+
   /**
    * Allows the host application to declare implicit references between
    * the objects: if |parent| is alive, all |children| are alive too.