| 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_
|
| -
|
|
|