Index: content/public/browser/trace_controller.h |
diff --git a/content/public/browser/trace_controller.h b/content/public/browser/trace_controller.h |
deleted file mode 100644 |
index ebcff7faf41a73fb80b5b732d9bebe9f9716e946..0000000000000000000000000000000000000000 |
--- a/content/public/browser/trace_controller.h |
+++ /dev/null |
@@ -1,107 +0,0 @@ |
-// 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. |
- |
-#ifndef CONTENT_PUBLIC_BROWSER_TRACE_CONTROLLER_H_ |
-#define CONTENT_PUBLIC_BROWSER_TRACE_CONTROLLER_H_ |
- |
-#include "base/debug/trace_event.h" |
-#include "content/common/content_export.h" |
- |
-namespace content { |
- |
-class TraceSubscriber; |
- |
-// Note: TraceController is going to be deprecated and replaced with |
-// TracingController. |
-// |
-// TraceController is used on the browser processes to enable/disable |
-// trace status and collect trace data. Only the browser UI thread is allowed |
-// to interact with the TraceController object. All calls on the TraceSubscriber |
-// happen on the UI thread. |
-class TraceController { |
- public: |
- CONTENT_EXPORT static TraceController* GetInstance(); |
- |
- // Called by browser process to start tracing events on all processes. |
- // |
- // Currently only one subscriber is allowed at a time. |
- // Tracing begins immediately locally, and asynchronously on child processes |
- // as soon as they receive the BeginTracing request. |
- // |
- // If BeginTracing was already called previously, |
- // or if an EndTracingAsync is pending, |
- // or if another subscriber is tracing, |
- // BeginTracing will return false meaning it failed. |
- // |
- // |category_patterns| is a comma-delimited list of category wildcards. |
- // A category pattern can have an optional '-' prefix to exclude category |
- // groups that contain a matching category. |
- // All the same rules apply above, so for example, having both included and |
- // excluded category patterns in the same list would not be supported. |
- // |
- // |mode| is the tracing mode being used. |
- // |
- // Example: BeginTracing("test_MyTest*"); |
- // Example: BeginTracing("test_MyTest*,test_OtherStuff"); |
- // Example: BeginTracing("-excluded_category1,-excluded_category2"); |
- virtual bool BeginTracing(TraceSubscriber* subscriber, |
- const std::string& category_patterns, |
- base::debug::TraceLog::Options options) = 0; |
- |
- // Called by browser process to stop tracing events on all processes. |
- // |
- // Child processes typically are caching trace data and only rarely flush |
- // and send trace data back to the browser process. That is because it may be |
- // an expensive operation to send the trace data over IPC, and we would like |
- // to avoid much runtime overhead of tracing. So, to end tracing, we must |
- // asynchronously ask all child processes to flush any pending trace data. |
- // |
- // Once all child processes have acked the EndTracing request, |
- // TraceSubscriber will be called with OnEndTracingComplete. |
- // |
- // If a previous call to EndTracingAsync is already pending, |
- // or if another subscriber is tracing, |
- // EndTracingAsync will return false meaning it failed. |
- virtual bool EndTracingAsync(TraceSubscriber* subscriber) = 0; |
- |
- // Get the maximum across processes of trace buffer percent full state. |
- // When the TraceBufferPercentFull value is determined, |
- // subscriber->OnTraceBufferPercentFullReply is called. |
- // When any child process reaches 100% full, the TraceController will end |
- // tracing, and call TraceSubscriber::OnEndTracingComplete. |
- // GetTraceBufferPercentFullAsync fails in the following conditions: |
- // trace is ending or disabled; |
- // a previous call to GetTraceBufferPercentFullAsync is pending; or |
- // the caller is not the current subscriber. |
- virtual bool GetTraceBufferPercentFullAsync(TraceSubscriber* subscriber) = 0; |
- |
- // |subscriber->OnEventWatchNotification()| will be called every time the |
- // given event occurs on any process. |
- virtual bool SetWatchEvent(TraceSubscriber* subscriber, |
- const std::string& category_name, |
- const std::string& event_name) = 0; |
- |
- // Cancel the watch event. If tracing is enabled, this may race with the |
- // watch event notification firing. |
- virtual bool CancelWatchEvent(TraceSubscriber* subscriber) = 0; |
- |
- // Cancel the subscriber so that it will not be called when EndTracingAsync is |
- // acked by all child processes. This will also call EndTracingAsync |
- // internally if necessary. |
- // Safe to call even if caller is not the current subscriber. |
- virtual void CancelSubscriber(TraceSubscriber* subscriber) = 0; |
- |
- // Get set of known category groups. This can change as new code paths are |
- // reached. If true is returned, subscriber->OnKnownCategoriesCollected will |
- // be called once the categories are retrieved from child processes. |
- virtual bool GetKnownCategoryGroupsAsync(TraceSubscriber* subscriber) = 0; |
- |
- protected: |
- virtual ~TraceController() {} |
-}; |
- |
-} // namespace content |
- |
-#endif // CONTENT_PUBLIC_BROWSER_TRACE_CONTROLLER_H_ |
- |