DO NOT SUBMIT: In-process tracing for debugging tests

base/debug/in_process_tracing.h

+// Copyright (c) 2013 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 BASE_DEBUG_IN_PROCESS_TRACING_H_
+#define BASE_DEBUG_IN_PROCESS_TRACING_H_
+
+#include <string>
+
+#include "base/compiler_specific.h"
+#include "base/time/time.h"
+
+namespace tracing {
+
+// Begin tracing specified category_patterns on the browser.
+// |category_patterns| is a comma-delimited list of category wildcards.
+// A category pattern can have an optional '-' prefix to make  categories with
+// matching categorys excluded. Either all category_patterns must be included
+// or all must be excluded.
+//
+// Example: BeginTracing("test_MyTest*");
+// Example: BeginTracing("test_MyTest*,test_OtherStuff");
+// Example: BeginTracing("-excluded_category1,-excluded_category2");
+//
+// See base/debug/trace_event.h for documentation of included and excluded
+// category_patterns.
+bool BeginTracing(const std::string& category_patterns);
+
+// End trace and collect the trace output as a json string.
+bool EndTracing(std::string* json_trace_output);
+
+}  // namespace tracing
+
+#endif  // BASE_DEBUG_IN_PROCESS_TRACING_H_