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 |