| OLD | NEW |
| 1 // Copyright 2014 The Chromium Authors. All rights reserved. | 1 // Copyright 2014 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 [DartPackage="mojo_services"] |
| 5 module tracing; | 6 module tracing; |
| 6 | 7 |
| 7 // To participate in the tracing ecosystem, implement the TraceController | 8 // To participate in the tracing ecosystem, implement the TraceController |
| 8 // interface and connect to the tracing app. Then, when the controller's Start() | 9 // interface and connect to the tracing app. Then, when the controller's Start() |
| 9 // function is called collect tracing data and pass it back via the provided | 10 // function is called collect tracing data and pass it back via the provided |
| 10 // TraceDataCollector interface up until Stop() is called. | 11 // TraceDataCollector interface up until Stop() is called. |
| 11 | 12 |
| 12 interface TraceController { | 13 interface TraceController { |
| 13 // Categories can either be the empty string to mean the default set of | 14 // Categories can either be the empty string to mean the default set of |
| 14 // categories or a comma-delimited list of categories to trace. | 15 // categories or a comma-delimited list of categories to trace. |
| 15 StartTracing(string categories, TraceDataCollector collector); | 16 StartTracing(string categories, TraceDataCollector collector); |
| 16 StopTracing(); | 17 StopTracing(); |
| 17 }; | 18 }; |
| 18 | 19 |
| 19 interface TraceDataCollector { | 20 interface TraceDataCollector { |
| 20 DataCollected(string json); | 21 DataCollected(string json); |
| 21 }; | 22 }; |
| 22 | 23 |
| 23 interface TraceCoordinator { | 24 interface TraceCoordinator { |
| 24 // Request tracing data from all connected TraceControllers to stream to | 25 // Request tracing data from all connected TraceControllers to stream to |
| 25 // |stream|. | 26 // |stream|. |
| 26 Start(handle<data_pipe_producer> stream, string categories); | 27 Start(handle<data_pipe_producer> stream, string categories); |
| 27 | 28 |
| 28 // Stop tracing and flush results to the |stream| passed in to Start(). | 29 // Stop tracing and flush results to the |stream| passed in to Start(). |
| 29 // Closes |stream| when all data is collected. | 30 // Closes |stream| when all data is collected. |
| 30 StopAndFlush(); | 31 StopAndFlush(); |
| 31 }; | 32 }; |
| OLD | NEW |