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

Side by Side Diff: content/common/websocket_messages.h

Issue 22815034: Introduce webkit_glue bridges for the new WebSocket Implementation. (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git@master
Patch Set: Created 7 years, 2 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 | « content/child/websocket_dispatcher.cc ('k') | content/content_child.gypi » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
1 // Copyright 2013 The Chromium Authors. All rights reserved. 1 // Copyright 2013 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 // Multiply-included message file, hence no include guard. 5 // Multiply-included message file, hence no include guard.
6 6
7 // This file defines the IPCs for the browser-side implementation of 7 // This file defines the IPCs for the browser-side implementation of
8 // WebSockets. For the legacy renderer-side implementation, see 8 // WebSockets. For the legacy renderer-side implementation, see
9 // socket_stream_messages.h. 9 // socket_stream_messages.h.
10 // TODO(ricea): Fix this comment when the legacy implementation has been 10 // TODO(ricea): Fix this comment when the legacy implementation has been
(...skipping 20 matching lines...) Expand all
31 // Open new virtual WebSocket connection to |socket_url|. |channel_id| is an 31 // Open new virtual WebSocket connection to |socket_url|. |channel_id| is an
32 // identifier chosen by the renderer for the new channel. It cannot correspond 32 // identifier chosen by the renderer for the new channel. It cannot correspond
33 // to an existing open channel, and must be between 1 and 33 // to an existing open channel, and must be between 1 and
34 // 0x7FFFFFFF. |requested_protocols| is a list of tokens identifying 34 // 0x7FFFFFFF. |requested_protocols| is a list of tokens identifying
35 // sub-protocols the renderer would like to use, as described in RFC6455 35 // sub-protocols the renderer would like to use, as described in RFC6455
36 // "Subprotocols Using the WebSocket Protocol". 36 // "Subprotocols Using the WebSocket Protocol".
37 // 37 //
38 // The browser process will not send |channel_id| as-is to the remote server; it 38 // The browser process will not send |channel_id| as-is to the remote server; it
39 // will try to use a short id on the wire. This saves the renderer from 39 // will try to use a short id on the wire. This saves the renderer from
40 // having to try to choose the ids cleverly. 40 // having to try to choose the ids cleverly.
41 IPC_MESSAGE_CONTROL4(WebSocketHostMsg_AddChannelRequest, 41 IPC_MESSAGE_ROUTED3(WebSocketHostMsg_AddChannelRequest,
42 int /* channel_id */, 42 GURL /* socket_url */,
43 GURL /* socket_url */, 43 std::vector<std::string> /* requested_protocols */,
44 std::vector<std::string> /* requested_protocols */, 44 GURL /* origin */)
45 GURL /* origin */)
46 45
47 // Web Socket messages sent from the browser to the renderer. 46 // Web Socket messages sent from the browser to the renderer.
48 47
49 // Respond to an AddChannelRequest for channel |channel_id|. |channel_id| is 48 // Respond to an AddChannelRequest for channel |channel_id|. |channel_id| is
50 // scoped to the renderer process; while it is unique per-renderer, the browser 49 // scoped to the renderer process; while it is unique per-renderer, the browser
51 // may have multiple renderers using the same id. If |fail| is true, the channel 50 // may have multiple renderers using the same id. If |fail| is true, the channel
52 // could not be established (the cause of the failure is not provided to the 51 // could not be established (the cause of the failure is not provided to the
53 // renderer in order to limit its ability to abuse WebSockets to perform network 52 // renderer in order to limit its ability to abuse WebSockets to perform network
54 // probing, etc.). If |fail| is set then the |channel_id| is available for 53 // probing, etc.). If |fail| is set then the |channel_id| is available for
55 // re-use. |selected_protocol| is the sub-protocol the server selected, 54 // re-use. |selected_protocol| is the sub-protocol the server selected,
56 // or empty if no sub-protocol was selected. |extensions| is the list of 55 // or empty if no sub-protocol was selected. |extensions| is the list of
57 // extensions negotiated for the connection. 56 // extensions negotiated for the connection.
58 IPC_MESSAGE_CONTROL4(WebSocketMsg_AddChannelResponse, 57 IPC_MESSAGE_ROUTED3(WebSocketMsg_AddChannelResponse,
59 int /* channel_id */, 58 bool /* fail */,
60 bool /* fail */, 59 std::string /* selected_protocol */,
61 std::string /* selected_protocol */, 60 std::string /* extensions */)
62 std::string /* extensions */)
63 61
64 // WebSocket messages that can be sent in either direction. 62 // WebSocket messages that can be sent in either direction.
65 63
66 IPC_ENUM_TRAITS(content::WebSocketMessageType) 64 IPC_ENUM_TRAITS(content::WebSocketMessageType)
67 65
68 // Send a non-control frame on |channel_id|. If the sender is the renderer, it 66 // Send a non-control frame on |channel_id|. If the sender is the renderer, it
69 // will be sent to the remote server. If the sender is the browser, it comes 67 // will be sent to the remote server. If the sender is the browser, it comes
70 // from the remote server. |fin| indicates that this frame is the last in the 68 // from the remote server. |fin| indicates that this frame is the last in the
71 // current message. |type| is the type of the message. On the first frame of a 69 // current message. |type| is the type of the message. On the first frame of a
72 // message, it must be set to either WEB_SOCKET_MESSAGE_TYPE_TEXT or 70 // message, it must be set to either WEB_SOCKET_MESSAGE_TYPE_TEXT or
73 // WEB_SOCKET_MESSAGE_TYPE_BINARY. On subsequent frames, it must be set to 71 // WEB_SOCKET_MESSAGE_TYPE_BINARY. On subsequent frames, it must be set to
74 // WEB_SOCKET_MESSAGE_TYPE_CONTINUATION, and the type is the same as that of the 72 // WEB_SOCKET_MESSAGE_TYPE_CONTINUATION, and the type is the same as that of the
75 // first message. If |type| is WEB_SOCKET_MESSAGE_TYPE_TEXT, then the 73 // first message. If |type| is WEB_SOCKET_MESSAGE_TYPE_TEXT, then the
76 // concatenation of the |data| from every frame in the message must be valid 74 // concatenation of the |data| from every frame in the message must be valid
77 // UTF-8. If |fin| is not set, |data| must be non-empty. 75 // UTF-8. If |fin| is not set, |data| must be non-empty.
78 IPC_MESSAGE_CONTROL4(WebSocketMsg_SendFrame, 76 IPC_MESSAGE_ROUTED3(WebSocketMsg_SendFrame,
79 int /* channel_id */, 77 bool /* fin */,
80 bool /* fin */, 78 content::WebSocketMessageType /* type */,
81 content::WebSocketMessageType /* type */, 79 std::vector<char> /* data */)
82 std::vector<char> /* data */)
83 80
84 // Add |quota| tokens of send quota for channel |channel_id|. |quota| must be a 81 // Add |quota| tokens of send quota for channel |channel_id|. |quota| must be a
85 // positive integer. Both the browser and the renderer set send quota for the 82 // positive integer. Both the browser and the renderer set send quota for the
86 // other side, and check that quota has not been exceeded when receiving 83 // other side, and check that quota has not been exceeded when receiving
87 // messages. Both sides start a new channel with a quota of 0, and must wait for 84 // messages. Both sides start a new channel with a quota of 0, and must wait for
88 // a FlowControl message before calling SendFrame. The total available quota on 85 // a FlowControl message before calling SendFrame. The total available quota on
89 // one side must never exceed 0x7FFFFFFFFFFFFFFF tokens. 86 // one side must never exceed 0x7FFFFFFFFFFFFFFF tokens.
90 IPC_MESSAGE_CONTROL2(WebSocketMsg_FlowControl, 87 IPC_MESSAGE_ROUTED1(WebSocketMsg_FlowControl,
91 int /* channel_id */, 88 int64 /* quota */)
92 int64 /* quota */)
93 89
94 // Drop the channel. 90 // Drop the channel.
95 // When sent by the renderer, this will cause a DropChannel message to be sent 91 // When sent by the renderer, this will cause a DropChannel message to be sent
96 // if the multiplex extension is in use, otherwise a Close message will be sent 92 // if the multiplex extension is in use, otherwise a Close message will be sent
97 // and the TCP/IP connection will be closed. 93 // and the TCP/IP connection will be closed.
98 // When sent by the browser, this indicates that a Close or DropChannel has been 94 // When sent by the browser, this indicates that a Close or DropChannel has been
99 // received, the connection was closed, or a network or protocol error 95 // received, the connection was closed, or a network or protocol error
100 // occurred. On receiving DropChannel, the renderer process may consider the 96 // occurred. On receiving DropChannel, the renderer process may consider the
101 // |channel_id| available for reuse by a new AddChannelRequest. 97 // |channel_id| available for reuse by a new AddChannelRequest.
102 // |code| is one of the reason codes specified in RFC6455 or 98 // |code| is one of the reason codes specified in RFC6455 or
103 // draft-ietf-hybi-websocket-multiplexing-09. |reason|, if non-empty, is a 99 // draft-ietf-hybi-websocket-multiplexing-09. |reason|, if non-empty, is a
104 // UTF-8 encoded string which may be useful for debugging but is not necessarily 100 // UTF-8 encoded string which may be useful for debugging but is not necessarily
105 // human-readable, as supplied by the server in the Close or DropChannel 101 // human-readable, as supplied by the server in the Close or DropChannel
106 // message. 102 // message.
107 IPC_MESSAGE_CONTROL3(WebSocketMsg_DropChannel, 103 IPC_MESSAGE_ROUTED2(WebSocketMsg_DropChannel,
108 int /* channel_id */, 104 unsigned short /* code */,
109 unsigned short /* code */, 105 std::string /* reason */)
110 std::string /* reason */)
OLDNEW
« no previous file with comments | « content/child/websocket_dispatcher.cc ('k') | content/content_child.gypi » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698