Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(52)

Side by Side Diff: runtime/vm/service/service.md

Issue 1756393002: Fix some service protocol isolate lifecycle races (Closed) Base URL: git@github.com:dart-lang/sdk.git@master
Patch Set: Created 4 years, 9 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
« no previous file with comments | « runtime/vm/service.cc ('k') | runtime/vm/service_event.h » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
1 # Dart VM Service Protocol 3.3 1 # Dart VM Service Protocol 3.3
2 2
3 > Please post feedback to the [observatory-discuss group][discuss-list] 3 > Please post feedback to the [observatory-discuss group][discuss-list]
4 4
5 This document describes of _version 3.3_ of the Dart VM Service Protocol. This 5 This document describes of _version 3.3_ of the Dart VM Service Protocol. This
6 protocol is used to communicate with a running Dart Virtual Machine. 6 protocol is used to communicate with a running Dart Virtual Machine.
7 7
8 To use the Service Protocol, start the VM with the *--observe* flag. 8 To use the Service Protocol, start the VM with the *--observe* flag.
9 The VM will start a webserver which services protocol requests via WebSocket. 9 The VM will start a webserver which services protocol requests via WebSocket.
10 It is possible to make HTTP (non-WebSocket) requests, 10 It is possible to make HTTP (non-WebSocket) requests,
(...skipping 751 matching lines...) Expand 10 before | Expand all | Expand 10 after
762 762
763 If the client is not subscribed to the stream, the _103_ (Stream already 763 If the client is not subscribed to the stream, the _103_ (Stream already
764 subscribed) error code is returned. 764 subscribed) error code is returned.
765 765
766 The _streamId_ parameter may have the following published values: 766 The _streamId_ parameter may have the following published values:
767 767
768 streamId | event types provided 768 streamId | event types provided
769 -------- | ----------- 769 -------- | -----------
770 VM | VMUpdate 770 VM | VMUpdate
771 Isolate | IsolateStart, IsolateRunnable, IsolateExit, IsolateUpdate, ServiceExte nsionAdded 771 Isolate | IsolateStart, IsolateRunnable, IsolateExit, IsolateUpdate, ServiceExte nsionAdded
772 Debug | PauseStart, PauseExit, PauseBreakpoint, PauseInterrupted, PauseException , Resume, BreakpointAdded, BreakpointResolved, BreakpointRemoved, Inspect 772 Debug | PauseStart, PauseExit, PauseBreakpoint, PauseInterrupted, PauseException , Resume, BreakpointAdded, BreakpointResolved, BreakpointRemoved, Inspect, None
773 GC | GC 773 GC | GC
774 Extension | Extension 774 Extension | Extension
775 775
776 Additionally, some embedders provide the _Stdout_ and _Stderr_ 776 Additionally, some embedders provide the _Stdout_ and _Stderr_
777 streams. These streams allow the client to subscribe to writes to 777 streams. These streams allow the client to subscribe to writes to
778 stdout and stderr. 778 stdout and stderr.
779 779
780 streamId | event types provided 780 streamId | event types provided
781 -------- | ----------- 781 -------- | -----------
782 Stdout | WriteEvent 782 Stdout | WriteEvent
(...skipping 481 matching lines...) Expand 10 before | Expand all | Expand 10 after
1264 1264
1265 // An isolate has paused due to interruption via pause. 1265 // An isolate has paused due to interruption via pause.
1266 PauseInterrupted, 1266 PauseInterrupted,
1267 1267
1268 // An isolate has paused due to an exception. 1268 // An isolate has paused due to an exception.
1269 PauseException, 1269 PauseException,
1270 1270
1271 // An isolate has started or resumed execution. 1271 // An isolate has started or resumed execution.
1272 Resume, 1272 Resume,
1273 1273
1274 // Indicates an isolate is not yet runnable. Only appears in an Isolate's
1275 // pauseEvent. Never sent over a stream.
1276 None,
1277
1274 // A breakpoint has been added for an isolate. 1278 // A breakpoint has been added for an isolate.
1275 BreakpointAdded, 1279 BreakpointAdded,
1276 1280
1277 // An unresolved breakpoint has been resolved for an isolate. 1281 // An unresolved breakpoint has been resolved for an isolate.
1278 BreakpointResolved, 1282 BreakpointResolved,
1279 1283
1280 // A breakpoint has been removed. 1284 // A breakpoint has been removed.
1281 BreakpointRemoved, 1285 BreakpointRemoved,
1282 1286
1283 // A garbage collection event. 1287 // A garbage collection event.
(...skipping 1200 matching lines...) Expand 10 before | Expand all | Expand 10 after
2484 version | comments 2488 version | comments
2485 ------- | -------- 2489 ------- | --------
2486 1.0 | initial revision 2490 1.0 | initial revision
2487 2.0 | Describe protocol version 2.0. 2491 2.0 | Describe protocol version 2.0.
2488 3.0 | Describe protocol version 3.0. Added UnresolvedSourceLocation. Added Sen tinel return to getIsolate. Add AddedBreakpointWithScriptUri. Removed Isolate. entry. The type of VM.pid was changed from string to int. Added VMUpdate events . Add offset and count parameters to getObject() and offset and count fields to Instance. Added ServiceExtensionAdded event. 2492 3.0 | Describe protocol version 3.0. Added UnresolvedSourceLocation. Added Sen tinel return to getIsolate. Add AddedBreakpointWithScriptUri. Removed Isolate. entry. The type of VM.pid was changed from string to int. Added VMUpdate events . Add offset and count parameters to getObject() and offset and count fields to Instance. Added ServiceExtensionAdded event.
2489 3.1 | Add the getSourceReport RPC. The getObject RPC now accepts offset and cou nt for string objects. String objects now contain length, offset, and count pro perties. 2493 3.1 | Add the getSourceReport RPC. The getObject RPC now accepts offset and cou nt for string objects. String objects now contain length, offset, and count pro perties.
2490 3.2 | Isolate objects now include the runnable bit and many debugger related RPC s will return an error if executed on an isolate before it is runnable. 2494 3.2 | Isolate objects now include the runnable bit and many debugger related RPC s will return an error if executed on an isolate before it is runnable.
2491 3.3 | Pause event now indicates if the isolate is paused at an await, yield, or yield* suspension point via the 'atAsyncSuspension' field. Resume command now su pports the step parameter 'OverAsyncSuspension'. A Breakpoint added syntheticall y by an 'OverAsyncSuspension' resume command identifies itself as such via the ' isSyntheticAsyncContinuation' field. 2495 3.3 | Pause event now indicates if the isolate is paused at an await, yield, or yield* suspension point via the 'atAsyncSuspension' field. Resume command now su pports the step parameter 'OverAsyncSuspension'. A Breakpoint added syntheticall y by an 'OverAsyncSuspension' resume command identifies itself as such via the ' isSyntheticAsyncContinuation' field.
2492 2496
2493 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato ry-discuss 2497 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato ry-discuss
OLDNEW
« no previous file with comments | « runtime/vm/service.cc ('k') | runtime/vm/service_event.h » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698