Initial prototype of vmstats support, based on Dart VM Stats draft design doc.

runtime/bin/vmstats.h

+// Copyright (c) 2013, the Dart project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+#ifndef BIN_VMSTATS_H_
+#define BIN_VMSTATS_H_
+
+#include "include/dart_api.h"
+
+/**
+ * A VM status callback. Status plug-ins implement and register this
+ * function using Dart_RegisterStatusPlugin. When Dart_GetVMStatus is

[siva, 2013/02/15 05:59:10]

The comment seems a bit out dated (Dart_GetVMStatus is not involved anymore for
this right).

[Tom Ball, 2013/02/16 00:57:19]

Updated.

+ * called with the plug-in's status type, the callback is invoked to
+ * provide the requested information.
+ *
+ * Note: status requests execute outside of an isolate (which is why
+ * handles aren't used).
+ *
+ * \param parameters an optional string that defines REST-like parameters
+ *     to define what information is requested.
+ *
+ * \return Returns a valid JSON string, allocated from C heap. The caller
+ *     is responsible for releasing this string.
+ */
+typedef char* (*Dart_VmStatusCallback)(const char* parameters);
+
+
+/**
+ * Register a VM status plug-in. The specified status type must not already
+ * have a registered plug-in.
+ *
+ * \return 0 if the plug-in was registered, or -1 if there is an error.
+ */
+DART_EXPORT int Dart_RegisterVmStatusPlugin(
+    const char* status_type, Dart_VmStatusCallback callback);
+
+#endif  // BIN_VMSTATS_H_