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 [DartPackage="mojo_services"] |
6 module tracing; | 6 module tracing; |
7 | 7 |
8 // To participate in the tracing ecosystem, implement the TraceController | 8 // To participate in the tracing ecosystem, implement the TraceProvider |
9 // interface and connect to the tracing app. Then, when the controller's Start() | 9 // interface and connect to the tracing app. Then, when the provider's Start() |
10 // 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 |
11 // TraceDataCollector interface up until Stop() is called. | 11 // TraceRecorder interface up until Stop() is called. |
12 | 12 |
13 interface TraceController { | 13 interface TraceProvider { |
14 // 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 |
15 // categories or a comma-delimited list of categories to trace. | 15 // categories or a comma-delimited list of categories to trace. |
16 StartTracing(string categories, TraceDataCollector collector); | 16 StartTracing(string categories, TraceRecorder recorder); |
17 StopTracing(); | 17 StopTracing(); |
18 }; | 18 }; |
19 | 19 |
20 interface TraceDataCollector { | 20 interface TraceRecorder { |
21 DataCollected(string json); | 21 Record(string json); |
22 }; | 22 }; |
23 | 23 |
24 interface TraceCoordinator { | 24 interface TraceCollector { |
25 // Request tracing data from all connected TraceControllers to stream to | 25 // Request tracing data from all connected providers to stream to |
26 // |stream|. | 26 // |stream|. |
27 Start(handle<data_pipe_producer> stream, string categories); | 27 Start(handle<data_pipe_producer> stream, string categories); |
28 | 28 |
29 // 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(). |
30 // Closes |stream| when all data is collected. | 30 // Closes |stream| when all data is collected. |
31 StopAndFlush(); | 31 StopAndFlush(); |
32 }; | 32 }; |
OLD | NEW |