[tracing] Expose AddOwnershipEdge and CreateAllocatorDump with guid to blink. (blink-side).

public/platform/WebMemoryAllocatorDump.h

 // Copyright 2015 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef WebMemoryAllocatorDump_h
 #define WebMemoryAllocatorDump_h
 
 #include "WebCommon.h"
 #include "WebString.h"
 
 namespace blink {
 
+// Class which holds the guid of the WebMemoryAllocatorDump.
+class BLINK_PLATFORM_EXPORT WebMemoryAllocatorDumpGuid {
+public:
+    explicit WebMemoryAllocatorDumpGuid(const uint64_t guid)
+        : m_guidInt(guid)
+    {
+    }
+
+    explicit WebMemoryAllocatorDumpGuid(const WebString& guid)
+        : m_guidInt(HashGuidString(guid))
+    {
+    }
+
+private:

[Primiano Tucci (use gerrit), 2015/06/09 20:51:34]

I think this should be protected for sake of clarity.

+    virtual uint64_t HashGuidString(const WebString& guid) const
+    {
+        BLINK_ASSERT_NOT_REACHED();
+        return 0;
+    }
+
+    uint64_t m_guidInt;
+};
+
 // A container which holds all the attributes of a particular dump for a given
 // allocator.
 class BLINK_PLATFORM_EXPORT WebMemoryAllocatorDump {
 public:
+    // TODO(ssid): This constructor should be removed once the usage is
+    // changed in chromium side (ETA: 15/06/2015).
+    WebMemoryAllocatorDump()
+        : m_guid(WebMemoryAllocatorDumpGuid(0))
+    {
+    }
+
+    WebMemoryAllocatorDump(WebMemoryAllocatorDumpGuid guid)
+        : m_guid(guid)
+    {
+    }
+
     virtual ~WebMemoryAllocatorDump();
 
     // Adds a scalar attribute to the dump.
     // Arguments:
     //   name: name of the attribute. Typical names, emitted by most allocators
     //       dump providers are: "outer_size", "inner_size", "objects_count".
     //   units: the units for the attribute. Gives a hint to the trace-viewer UI
     //       about the semantics of the attribute.
     //       Currently supported values are "bytes" and "objects".
     //   value: the value of the attribute.
     virtual void AddScalar(const WebString& name, const char* units, uint64_t value) { BLINK_ASSERT_NOT_REACHED(); }
     virtual void AddScalarF(const WebString& name, const char* units, double value) { BLINK_ASSERT_NOT_REACHED(); }
     virtual void AddString(const WebString& name, const char* units, const WebString& value) { BLINK_ASSERT_NOT_REACHED(); }
+
+    // |guid| is an optional global dump identifier, unique across all processes
+    // within the scope of a global dump. It is only required when using the
+    // graph APIs (see AddOwnershipEdge) to express retention / suballocation or
+    // cross process sharing. See crbug.com/492102 for design docs.
+    // Subsequent MemoryAllocatorDump(s) with the same |absolute_name| are
+    // expected to have the same guid.
+    const WebMemoryAllocatorDumpGuid& guid() const
+    {
+        return m_guid;
+    }
+
+private:
+    WebMemoryAllocatorDumpGuid m_guid;
 };
 
 } // namespace blink
 
 #endif // WebMemoryAllocatorDump_h