PPAPI: Introduce PPB_NetworkProxy_Dev

ppapi/proxy/ppapi_messages.h

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 // Multiply-included message header, no traditional include guard.
 #include <string>
 #include <vector>
 
 #include "base/basictypes.h"
 #include "base/files/file_path.h"
@@ skipping 1307 matching lines @@
 // Starts an extension API request which expects a response sent back using a
 // PpapiPluginMsg_ExtensionsCommon_CallReply message.
 // |request_name| is an API function name. |args| is a list of input arguments.
 // |output| is a list of output results.
 IPC_MESSAGE_CONTROL2(PpapiHostMsg_ExtensionsCommon_Call,
                      std::string /* request_name */,
                      base::ListValue /* args */)
 IPC_MESSAGE_CONTROL1(PpapiPluginMsg_ExtensionsCommon_CallReply,
                      base::ListValue /* output */)
 
-// Ext_CrxFileSystem
+// Ext_CrxFileSystem -----------------------------------------------------------
 IPC_MESSAGE_CONTROL0(PpapiHostMsg_Ext_CrxFileSystem_Create)
 IPC_MESSAGE_CONTROL0(PpapiHostMsg_Ext_CrxFileSystem_BrowserOpen)
 IPC_MESSAGE_CONTROL1(PpapiPluginMsg_Ext_CrxFileSystem_BrowserOpenReply,
                      std::string /* fsid */)
 
-// File chooser.
+// FileChooser -----------------------------------------------------------------
 IPC_MESSAGE_CONTROL0(PpapiHostMsg_FileChooser_Create)
 IPC_MESSAGE_CONTROL4(PpapiHostMsg_FileChooser_Show,
                      bool /* save_as */,
                      bool /* open_multiple */,
                      std::string /* suggested_file_name */,
                      std::vector<std::string> /* accept_mime_types */)
 IPC_MESSAGE_CONTROL1(PpapiPluginMsg_FileChooser_ShowReply,
                      std::vector<ppapi::PPB_FileRef_CreateInfo> /* files */)
 
-// FileIO
+// FileIO ----------------------------------------------------------------------
 IPC_MESSAGE_CONTROL0(PpapiHostMsg_FileIO_Create)
 IPC_MESSAGE_CONTROL2(PpapiHostMsg_FileIO_Open,
                      PP_Resource /* file_ref_resource */,
                      int32_t /* open_flags */)
 IPC_MESSAGE_CONTROL0(PpapiPluginMsg_FileIO_OpenReply)
 IPC_MESSAGE_CONTROL0(PpapiHostMsg_FileIO_Close)
 IPC_MESSAGE_CONTROL0(PpapiHostMsg_FileIO_Query)
 IPC_MESSAGE_CONTROL1(PpapiPluginMsg_FileIO_QueryReply, PP_FileInfo /* info */)
 IPC_MESSAGE_CONTROL2(PpapiHostMsg_FileIO_Touch,
                      PP_Time /* last_access_time */,
@@ skipping 13 matching lines @@
                      int32_t /* bytes_to_write */)
 IPC_MESSAGE_CONTROL1(PpapiHostMsg_FileIO_WillSetLength,
                      int64_t /* length */)
 IPC_MESSAGE_CONTROL0(PpapiHostMsg_FileIO_GetOSFileDescriptor)
 IPC_MESSAGE_CONTROL1(PpapiPluginMsg_FileIO_GetOSFileDescriptorReply,
                      int32_t /* file descriptor */)
 IPC_MESSAGE_CONTROL0(PpapiHostMsg_FileIO_RequestOSFileHandle)
 IPC_MESSAGE_CONTROL0(PpapiPluginMsg_FileIO_RequestOSFileHandleReply)
 IPC_MESSAGE_CONTROL0(PpapiPluginMsg_FileIO_GeneralReply)
 
-// FileSystem
+// FileSystem ------------------------------------------------------------------
 IPC_MESSAGE_CONTROL1(PpapiHostMsg_FileSystem_Create,
                      PP_FileSystemType /* type */)
 IPC_MESSAGE_CONTROL1(PpapiHostMsg_FileSystem_Open,
                      int64_t /* expected_size */)
 IPC_MESSAGE_CONTROL0(PpapiPluginMsg_FileSystem_OpenReply)
 IPC_MESSAGE_CONTROL1(PpapiHostMsg_FileSystem_InitIsolatedFileSystem,
                      std::string /* fsid */)
 
 // Flash DRM ------------------------------------------------------------------
 IPC_MESSAGE_CONTROL0(PpapiHostMsg_FlashDRM_Create)
 
 // Requests the device ID.
 IPC_MESSAGE_CONTROL0(PpapiHostMsg_FlashDRM_GetDeviceID)
 // Reply for GetDeviceID which includes the device ID as a string.
 IPC_MESSAGE_CONTROL1(PpapiPluginMsg_FlashDRM_GetDeviceIDReply,
                      std::string /* id */)
 
-// Gamepad.
+// Gamepad ---------------------------------------------------------------------
 IPC_MESSAGE_CONTROL0(PpapiHostMsg_Gamepad_Create)
 
 // Requests that the gamepad host send the shared memory handle to the plugin
 // process.
 IPC_MESSAGE_CONTROL0(PpapiHostMsg_Gamepad_RequestMemory)
 
 // Reply to a RequestMemory call. This supplies the shared memory handle. The
 // actual handle is passed in the ReplyParams struct.
 IPC_MESSAGE_CONTROL0(PpapiPluginMsg_Gamepad_SendMemory)
 
 
-// Graphics2D, plugin -> host
+// Graphics2D ------------------------------------------------------------------
 IPC_MESSAGE_CONTROL2(PpapiHostMsg_Graphics2D_Create,
                      PP_Size /* size */,
                      PP_Bool /* is_always_opaque */)
 IPC_MESSAGE_CONTROL4(PpapiHostMsg_Graphics2D_PaintImageData,
                      ppapi::HostResource /* image_data */,
                      PP_Point /* top_left */,
                      bool /* src_rect_specified */,
                      PP_Rect /* src_rect */)
 IPC_MESSAGE_CONTROL3(PpapiHostMsg_Graphics2D_Scroll,
                      bool /* clip_specified */,
                      PP_Rect /* clip */,
                      PP_Point /* amount */)
 IPC_MESSAGE_CONTROL1(PpapiHostMsg_Graphics2D_ReplaceContents,
                      ppapi::HostResource /* image_data */)
 IPC_MESSAGE_CONTROL1(PpapiHostMsg_Graphics2D_Dev_SetScale,
                      float /* scale */)
 
-// Graphics2D, plugin -> host -> plugin
 IPC_MESSAGE_CONTROL0(PpapiHostMsg_Graphics2D_Flush)
 IPC_MESSAGE_CONTROL0(PpapiPluginMsg_Graphics2D_FlushAck)
 
 IPC_MESSAGE_CONTROL2(PpapiHostMsg_Graphics2D_ReadImageData,
                      PP_Resource /* image */,
                      PP_Point /* top_left */)
 IPC_MESSAGE_CONTROL0(PpapiPluginMsg_Graphics2D_ReadImageDataAck)
 
-// TrueTypeFont.
+// HostResolverPrivate ---------------------------------------------------------

[yzshen1, 2013/06/16 23:49:53]

nit, optional: Maybe put the style&order fix in a separate CL will be easier to
review for the message file OWNER. And moving messages around may cause
unnecessary conflicts because we are both changing them in a rush.
(But it is not a big issue. I am fine if you would like to make the changes in
this CL.)

[dmichael (off chromium), 2013/06/17 21:48:28]

Good point, done.

+IPC_MESSAGE_CONTROL0(PpapiHostMsg_HostResolverPrivate_Create)
+IPC_MESSAGE_CONTROL2(PpapiHostMsg_HostResolverPrivate_Resolve,
+                     ppapi::HostPortPair /* host_port */,
+                     PP_HostResolver_Private_Hint /* hint */)
+IPC_MESSAGE_CONTROL2(PpapiPluginMsg_HostResolverPrivate_ResolveReply,
+                     std::string /* canonical_name */,
+                     std::vector<PP_NetAddress_Private> /* net_address_list */)
+
+// NetworkProxy ----------------------------------------------------------------
+IPC_MESSAGE_CONTROL0(PpapiHostMsg_NetworkProxy_Create)
+
+// Query the browser for the proxy server to use for the given URL.
+IPC_MESSAGE_CONTROL1(PpapiHostMsg_NetworkProxy_GetProxyForURL,
+                     std::string /* url */);
+
+// Reply message for GetProxyForURL containing the proxy server. 
+IPC_MESSAGE_CONTROL1(PpapiPluginMsg_NetworkProxy_GetProxyForURLReply,
+                     std::string /* proxy */)
+
+// Printing --------------------------------------------------------------------
+IPC_MESSAGE_CONTROL0(PpapiHostMsg_Printing_Create)
+IPC_MESSAGE_CONTROL0(PpapiHostMsg_Printing_GetDefaultPrintSettings)
+IPC_MESSAGE_CONTROL1(PpapiPluginMsg_Printing_GetDefaultPrintSettingsReply,
+                     PP_PrintSettings_Dev /* print_settings */)
+
+// Shared memory ---------------------------------------------------------------
+
+// Creates shared memory on the host side, returning a handle to the shared
+// memory on the plugin and keeping the memory mapped in on the host.
+// We return a "host handle_id" that can be mapped back to the
+// handle on the host side by PpapiGlobals::UntrackSharedMemoryHandle().
+IPC_SYNC_MESSAGE_CONTROL2_2(PpapiHostMsg_SharedMemory_CreateSharedMemory,
+                            PP_Instance /* instance */,
+                            uint32_t /* size */,
+                            int /* host_handle_id */,
+                            ppapi::proxy::SerializedHandle /* plugin_handle */)
+
+// TrueTypeFont ----------------------------------------------------------------
 IPC_MESSAGE_CONTROL0(PpapiHostMsg_TrueTypeFontSingleton_Create)
 IPC_MESSAGE_CONTROL0(PpapiHostMsg_TrueTypeFontSingleton_GetFontFamilies)
 IPC_MESSAGE_CONTROL1(PpapiPluginMsg_TrueTypeFontSingleton_GetFontFamiliesReply,
                      std::vector<std::string> /* font_families */)
 IPC_MESSAGE_CONTROL1(PpapiHostMsg_TrueTypeFontSingleton_GetFontsInFamily,
                      std::string /* family */)
 IPC_MESSAGE_CONTROL1(PpapiPluginMsg_TrueTypeFontSingleton_GetFontsInFamilyReply,
                      std::vector<ppapi::proxy::SerializedTrueTypeFontDesc>
                          /* fonts */)
 IPC_MESSAGE_CONTROL1(PpapiHostMsg_TrueTypeFont_Create,
                      ppapi::proxy::SerializedTrueTypeFontDesc /* desc */)
 IPC_MESSAGE_CONTROL0(PpapiHostMsg_TrueTypeFont_Describe)
 IPC_MESSAGE_CONTROL1(PpapiPluginMsg_TrueTypeFont_DescribeReply,
                      ppapi::proxy::SerializedTrueTypeFontDesc /* desc */)
 IPC_MESSAGE_CONTROL0(PpapiHostMsg_TrueTypeFont_GetTableTags)
 IPC_MESSAGE_CONTROL1(PpapiPluginMsg_TrueTypeFont_GetTableTagsReply,
                      std::vector<uint32_t> /* tags */)
 IPC_MESSAGE_CONTROL3(PpapiHostMsg_TrueTypeFont_GetTable,
                      uint32_t /* table */,
                      int32_t /* offset */,
                      int32_t /* max_data_length */)
 IPC_MESSAGE_CONTROL1(PpapiPluginMsg_TrueTypeFont_GetTableReply,
                      std::string /* data */)
 
-// HostResolverPrivate, plugin -> host -> plugin
-IPC_MESSAGE_CONTROL0(PpapiHostMsg_HostResolverPrivate_Create)
-IPC_MESSAGE_CONTROL2(PpapiHostMsg_HostResolverPrivate_Resolve,
-                     ppapi::HostPortPair /* host_port */,
-                     PP_HostResolver_Private_Hint /* hint */)
-IPC_MESSAGE_CONTROL2(PpapiPluginMsg_HostResolverPrivate_ResolveReply,
-                     std::string /* canonical_name */,
-                     std::vector<PP_NetAddress_Private> /* net_address_list */)
-
-// Printing.
-IPC_MESSAGE_CONTROL0(PpapiHostMsg_Printing_Create)
-IPC_MESSAGE_CONTROL0(PpapiHostMsg_Printing_GetDefaultPrintSettings)
-IPC_MESSAGE_CONTROL1(PpapiPluginMsg_Printing_GetDefaultPrintSettingsReply,
-                     PP_PrintSettings_Dev /* print_settings */)
-
 // URLLoader ------------------------------------------------------------------
-
 IPC_MESSAGE_CONTROL0(PpapiHostMsg_URLLoader_Create)
 
 // These messages correspond to PPAPI calls and all should get a
 // CallbackComplete message.
 IPC_MESSAGE_CONTROL1(PpapiHostMsg_URLLoader_Open,
                      ppapi::URLRequestInfoData /* request_data */)
 
 // The plugin can tell the host to defer a load to hold off on sending more
 // data because the buffer in the plugin is full. When defers_loading is set to
 // false, data streaming will resume.
@@ skipping 33 matching lines @@
 // Push notification from the renderer to the plugin to tell it about download
 // and upload progress. This will only be sent if the plugin has requested
 // progress updates, and only the fields requested by the plugin will be
 // valid.
 IPC_MESSAGE_CONTROL4(PpapiPluginMsg_URLLoader_UpdateProgress,
                      int64_t /* bytes_sent */,
                      int64_t /* total_bytes_to_be_sent */,
                      int64_t /* bytes_received */,
                      int64_t /* total_bytes_to_be_received */)
 
-// Shared memory ---------------------------------------------------------------
-
-// Creates shared memory on the host side, returning a handle to the shared
-// memory on the plugin and keeping the memory mapped in on the host.
-// We return a "host handle_id" that can be mapped back to the
-// handle on the host side by PpapiGlobals::UntrackSharedMemoryHandle().
-IPC_SYNC_MESSAGE_CONTROL2_2(PpapiHostMsg_SharedMemory_CreateSharedMemory,
-                            PP_Instance /* instance */,
-                            uint32_t /* size */,
-                            int /* host_handle_id */,
-                            ppapi::proxy::SerializedHandle /* plugin_handle */)
-
 // WebSocket -------------------------------------------------------------------
-
 IPC_MESSAGE_CONTROL0(PpapiHostMsg_WebSocket_Create)
 
 // Establishes the connection to a server. This message requires
 // WebSocket_ConnectReply as a reply message.
 IPC_MESSAGE_CONTROL2(PpapiHostMsg_WebSocket_Connect,
                      std::string /* url */,
                      std::vector<std::string> /* protocols */)
 
 // Closes established connection with graceful closing handshake. This message
 // requires WebSocket_CloseReply as a reply message.
@@ skipping 60 matching lines @@
 // any WebSocket_Close request. Server initiated closing handshake or
 // unexpected network errors will invoke this message.
 IPC_MESSAGE_CONTROL4(PpapiPluginMsg_WebSocket_ClosedReply,
                      uint64_t /* buffered_amount */,
                      bool /* was_clean */,
                      uint16_t /* code */,
                      std::string /* reason */)
 
 #if !defined(OS_NACL) && !defined(NACL_WIN64)
 
-// Audio input.
+// Audio input ----------------------------------------------------------------
 IPC_MESSAGE_CONTROL0(PpapiHostMsg_AudioInput_Create)
 IPC_MESSAGE_CONTROL3(PpapiHostMsg_AudioInput_Open,
                      std::string /* device_id */,
                      PP_AudioSampleRate /* sample_rate */,
                      uint32_t /* sample_frame_count */)
 // Reply to an Open call. This supplies a socket handle and a shared memory
 // handle. Both handles are passed in the ReplyParams struct.
 IPC_MESSAGE_CONTROL0(PpapiPluginMsg_AudioInput_OpenReply)
 IPC_MESSAGE_CONTROL1(PpapiHostMsg_AudioInput_StartOrStop, bool /* capture */)
 IPC_MESSAGE_CONTROL0(PpapiHostMsg_AudioInput_Close)
@@ skipping 261 matching lines @@
 IPC_MESSAGE_CONTROL0(PpapiPluginMsg_VideoSource_OpenReply)
 IPC_MESSAGE_CONTROL0(PpapiHostMsg_VideoSource_GetFrame)
 IPC_MESSAGE_CONTROL4(PpapiPluginMsg_VideoSource_GetFrameReply,
                      ppapi::HostResource /* resource_id */,
                      PP_ImageDataDesc /* image_data_desc */,
                      int /* fd */,
                      PP_TimeTicks /* timestamp */)
 IPC_MESSAGE_CONTROL0(PpapiHostMsg_VideoSource_Close)
 
 #endif  // !defined(OS_NACL) && !defined(NACL_WIN64)