Index: ppapi/api/dev/ppb_trace_event_dev.idl |
diff --git a/ppapi/api/dev/ppb_trace_event_dev.idl b/ppapi/api/dev/ppb_trace_event_dev.idl |
new file mode 100644 |
index 0000000000000000000000000000000000000000..ff01dea32859d6a62fa476a5b4b4b31d6a3556f5 |
--- /dev/null |
+++ b/ppapi/api/dev/ppb_trace_event_dev.idl |
@@ -0,0 +1,50 @@ |
+/* Copyright (c) 2012 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. |
+ */ |
+ |
+/** |
+ * This file defines the <code>PPB_Trace_Event</code> interface. It is meant |
+ * to be used in plugins as the API that trace macros from trace_event.h use. |
+ */ |
+ |
+label Chrome { |
+ M25 = 0.1 |
+}; |
+ |
+interface PPB_Trace_Event_Dev { |
+ /** |
+ * Gets a pointer to a character for identifying a category name in the |
+ * tracing system as well as for being able to early exit in client-side |
+ * tracing code. |
+ * |
+ * NB: This mem_t return value should technically be const, but return values |
+ * for Pepper IDL of mem_t type are not const. The same is true for the arg |
+ * |category_enabled| for AddTraceEvent. |
+ */ |
+ mem_t GetCategoryEnabled([in] cstr_t category_name); |
+ |
+ /** |
+ * Adds a trace event to the platform tracing system. This function call is |
+ * usually the result of a TRACE_* macro from trace_event.h when tracing and |
+ * the category of the particular trace are enabled. It is not advisable to |
+ * call this function on its own; it is really only meant to be used by the |
+ * trace macros. |
+ */ |
+ void AddTraceEvent( |
+ [in] int8_t phase, |
+ [in] mem_t category_enabled, |
+ [in] cstr_t name, |
+ [in] uint64_t id, |
+ [in] uint32_t num_args, |
+ [in, size_as=num_args] str_t[] arg_names, |
+ [in, size_as=num_args] uint8_t[] arg_types, |
+ [in, size_as=num_args] uint64_t[] arg_values, |
+ [in] uint8_t flags); |
+ |
+ /** |
+ * Sets the thread name of the calling thread in the tracing system so it will |
+ * show up properly in chrome://tracing. |
+ */ |
+ void SetThreadName([in] cstr_t thread_name); |
+}; |