Add a mode flag to the tracing framework.

content/public/browser/trace_controller.h

 // 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;
 
 // 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.
@@ skipping 10 matching lines @@
   // 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.
   //
   // |categories| is a comma-delimited list of category wildcards.
   // A category can have an optional '-' prefix to make it an excluded category.
   // All the same rules apply above, so for example, having both included and
   // excluded categories in the same list would not be supported.
   //
+  // |mode| is the tracing mode begin used.

[Jói, 2013/02/22 15:11:30]

begin -> being

[dsinclair, 2013/02/22 15:16:00]

Done.

+  //
   // Example: BeginTracing("test_MyTest*");
   // Example: BeginTracing("test_MyTest*,test_OtherStuff");
   // Example: BeginTracing("-excluded_category1,-excluded_category2");
   virtual bool BeginTracing(TraceSubscriber* subscriber,
-                            const std::string& categories) = 0;
+                            const std::string& categories,
+                            int 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,
@@ skipping 32 matching lines @@
   virtual void CancelSubscriber(TraceSubscriber* subscriber) = 0;
 
  protected:
   virtual ~TraceController() {}
 };
 
 }  // namespace content
 
 #endif  // CONTENT_PUBLIC_BROWSER_TRACE_CONTROLLER_H_