text: // 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.
  
  // IPC messages for page rendering.
  // Multiply-included message file, hence no include guard.
  
  #include "base/memory/shared_memory.h"
  #include "base/process/process.h"
  #include "base/strings/string16.h"
  #include "cc/output/begin_frame_args.h"
  #include "cc/output/compositor_frame.h"
  #include "cc/output/compositor_frame_ack.h"
  #include "content/common/browser_rendering_stats.h"
  #include "content/common/content_export.h"
  #include "content/common/content_param_traits.h"
  #include "content/common/cookie_data.h"
  #include "content/common/navigation_gesture.h"
  #include "content/common/pepper_renderer_instance_data.h"
  #include "content/common/view_message_enums.h"
  #include "content/common/webplugin_geometry.h"
  #include "content/port/common/input_event_ack_state.h"
  #include "content/public/common/common_param_traits.h"
  #include "content/public/common/context_menu_params.h"
  #include "content/public/common/favicon_url.h"
  #include "content/public/common/file_chooser_params.h"
  #include "content/public/common/frame_navigate_params.h"
  #include "content/public/common/javascript_message_type.h"
  #include "content/public/common/menu_item.h"
  #include "content/public/common/page_state.h"
  #include "content/public/common/page_zoom.h"
  #include "content/public/common/referrer.h"
  #include "content/public/common/renderer_preferences.h"
  #include "content/public/common/stop_find_action.h"
  #include "content/public/common/three_d_api_types.h"
  #include "content/public/common/window_container_type.h"
  #include "ipc/ipc_channel_handle.h"
  #include "ipc/ipc_message_macros.h"
  #include "ipc/ipc_platform_file.h"
  #include "media/audio/audio_parameters.h"
  #include "media/base/channel_layout.h"
  #include "media/base/media_log_event.h"
  #include "third_party/WebKit/public/platform/WebFloatPoint.h"
  #include "third_party/WebKit/public/platform/WebFloatRect.h"
  #include "third_party/WebKit/public/web/WebCompositionUnderline.h"
  #include "third_party/WebKit/public/web/WebFindOptions.h"
  #include "third_party/WebKit/public/web/WebMediaPlayerAction.h"
  #include "third_party/WebKit/public/web/WebPluginAction.h"
  #include "third_party/WebKit/public/web/WebPopupType.h"
  #include "third_party/WebKit/public/web/WebScreenInfo.h"
  #include "third_party/WebKit/public/web/WebTextDirection.h"
  #include "third_party/skia/include/core/SkBitmap.h"
  #include "ui/base/ime/text_input_mode.h"
  #include "ui/base/ime/text_input_type.h"
  #include "ui/base/ui_base_types.h"
  #include "ui/gfx/point.h"
  #include "ui/gfx/range/range.h"
  #include "ui/gfx/rect.h"
  #include "ui/gfx/rect_f.h"
  #include "ui/gfx/vector2d.h"
  #include "ui/gfx/vector2d_f.h"
  #include "ui/shell_dialogs/selected_file_info.h"
  
  #if defined(OS_MACOSX)
  #include "content/common/mac/font_descriptor.h"
  #endif
  
  #undef IPC_MESSAGE_EXPORT
  #define IPC_MESSAGE_EXPORT CONTENT_EXPORT
  
  #define IPC_MESSAGE_START ViewMsgStart
  
  IPC_ENUM_TRAITS(AccessibilityMode)
  IPC_ENUM_TRAITS(ViewMsg_Navigate_Type::Value)
  IPC_ENUM_TRAITS(WebKit::WebContextMenuData::MediaType)
  IPC_ENUM_TRAITS(WebKit::WebMediaPlayerAction::Type)
  IPC_ENUM_TRAITS(WebKit::WebPluginAction::Type)
  IPC_ENUM_TRAITS(WebKit::WebPopupType)
  IPC_ENUM_TRAITS(WebKit::WebTextDirection)
  IPC_ENUM_TRAITS(WindowContainerType)
  IPC_ENUM_TRAITS(content::FaviconURL::IconType)
  IPC_ENUM_TRAITS(content::FileChooserParams::Mode)
  IPC_ENUM_TRAITS(content::JavaScriptMessageType)
  IPC_ENUM_TRAITS(content::MenuItem::Type)
  IPC_ENUM_TRAITS(content::NavigationGesture)
  IPC_ENUM_TRAITS(content::PageZoom)
  IPC_ENUM_TRAITS(content::RendererPreferencesHintingEnum)
  IPC_ENUM_TRAITS(content::RendererPreferencesSubpixelRenderingEnum)
  IPC_ENUM_TRAITS_MAX_VALUE(content::TapMultipleTargetsStrategy,
                            content::TAP_MULTIPLE_TARGETS_STRATEGY_MAX)
  IPC_ENUM_TRAITS(content::StopFindAction)
  IPC_ENUM_TRAITS(content::ThreeDAPIType)
  IPC_ENUM_TRAITS(media::ChannelLayout)
  IPC_ENUM_TRAITS(media::MediaLogEvent::Type)
  IPC_ENUM_TRAITS(ui::MenuSourceType)
  IPC_ENUM_TRAITS_MAX_VALUE(ui::TextInputMode, ui::TEXT_INPUT_MODE_MAX)
  IPC_ENUM_TRAITS(ui::TextInputType)
  
  #if defined(OS_MACOSX)
  IPC_STRUCT_TRAITS_BEGIN(FontDescriptor)
    IPC_STRUCT_TRAITS_MEMBER(font_name)
    IPC_STRUCT_TRAITS_MEMBER(font_point_size)
  IPC_STRUCT_TRAITS_END()
  #endif
  
  IPC_STRUCT_TRAITS_BEGIN(WebKit::WebCompositionUnderline)
    IPC_STRUCT_TRAITS_MEMBER(startOffset)
    IPC_STRUCT_TRAITS_MEMBER(endOffset)
    IPC_STRUCT_TRAITS_MEMBER(color)
    IPC_STRUCT_TRAITS_MEMBER(thick)
  IPC_STRUCT_TRAITS_END()
  
  IPC_STRUCT_TRAITS_BEGIN(WebKit::WebFindOptions)
    IPC_STRUCT_TRAITS_MEMBER(forward)
    IPC_STRUCT_TRAITS_MEMBER(matchCase)
    IPC_STRUCT_TRAITS_MEMBER(findNext)
  IPC_STRUCT_TRAITS_END()
  
  IPC_STRUCT_TRAITS_BEGIN(WebKit::WebMediaPlayerAction)
    IPC_STRUCT_TRAITS_MEMBER(type)
    IPC_STRUCT_TRAITS_MEMBER(enable)
  IPC_STRUCT_TRAITS_END()
  
  IPC_STRUCT_TRAITS_BEGIN(WebKit::WebPluginAction)
    IPC_STRUCT_TRAITS_MEMBER(type)
    IPC_STRUCT_TRAITS_MEMBER(enable)
  IPC_STRUCT_TRAITS_END()
  
  IPC_STRUCT_TRAITS_BEGIN(WebKit::WebFloatPoint)
    IPC_STRUCT_TRAITS_MEMBER(x)
    IPC_STRUCT_TRAITS_MEMBER(y)
  IPC_STRUCT_TRAITS_END()
  
  IPC_STRUCT_TRAITS_BEGIN(WebKit::WebFloatRect)
    IPC_STRUCT_TRAITS_MEMBER(x)
    IPC_STRUCT_TRAITS_MEMBER(y)
    IPC_STRUCT_TRAITS_MEMBER(width)
    IPC_STRUCT_TRAITS_MEMBER(height)
  IPC_STRUCT_TRAITS_END()
  
  IPC_STRUCT_TRAITS_BEGIN(WebKit::WebScreenInfo)
    IPC_STRUCT_TRAITS_MEMBER(deviceScaleFactor)
    IPC_STRUCT_TRAITS_MEMBER(depth)
    IPC_STRUCT_TRAITS_MEMBER(depthPerComponent)
    IPC_STRUCT_TRAITS_MEMBER(isMonochrome)
    IPC_STRUCT_TRAITS_MEMBER(rect)
    IPC_STRUCT_TRAITS_MEMBER(availableRect)
  IPC_STRUCT_TRAITS_END()
  
  IPC_STRUCT_TRAITS_BEGIN(content::MenuItem)
    IPC_STRUCT_TRAITS_MEMBER(label)
    IPC_STRUCT_TRAITS_MEMBER(tool_tip)
    IPC_STRUCT_TRAITS_MEMBER(type)
    IPC_STRUCT_TRAITS_MEMBER(action)
    IPC_STRUCT_TRAITS_MEMBER(rtl)
    IPC_STRUCT_TRAITS_MEMBER(has_directional_override)
    IPC_STRUCT_TRAITS_MEMBER(enabled)
    IPC_STRUCT_TRAITS_MEMBER(checked)
    IPC_STRUCT_TRAITS_MEMBER(submenu)
  IPC_STRUCT_TRAITS_END()
  
  IPC_STRUCT_TRAITS_BEGIN(content::ContextMenuParams)
    IPC_STRUCT_TRAITS_MEMBER(media_type)
    IPC_STRUCT_TRAITS_MEMBER(x)
    IPC_STRUCT_TRAITS_MEMBER(y)
    IPC_STRUCT_TRAITS_MEMBER(link_url)
    IPC_STRUCT_TRAITS_MEMBER(link_text)
    IPC_STRUCT_TRAITS_MEMBER(unfiltered_link_url)
    IPC_STRUCT_TRAITS_MEMBER(src_url)
    IPC_STRUCT_TRAITS_MEMBER(has_image_contents)
    IPC_STRUCT_TRAITS_MEMBER(page_url)
    IPC_STRUCT_TRAITS_MEMBER(keyword_url)
    IPC_STRUCT_TRAITS_MEMBER(frame_url)
    IPC_STRUCT_TRAITS_MEMBER(frame_page_state)
    IPC_STRUCT_TRAITS_MEMBER(media_flags)
    IPC_STRUCT_TRAITS_MEMBER(selection_text)
    IPC_STRUCT_TRAITS_MEMBER(misspelled_word)
    IPC_STRUCT_TRAITS_MEMBER(misspelling_hash)
    IPC_STRUCT_TRAITS_MEMBER(dictionary_suggestions)
    IPC_STRUCT_TRAITS_MEMBER(speech_input_enabled)
    IPC_STRUCT_TRAITS_MEMBER(spellcheck_enabled)
    IPC_STRUCT_TRAITS_MEMBER(is_editable)
  #if defined(OS_MACOSX)
    IPC_STRUCT_TRAITS_MEMBER(writing_direction_default)
    IPC_STRUCT_TRAITS_MEMBER(writing_direction_left_to_right)
    IPC_STRUCT_TRAITS_MEMBER(writing_direction_right_to_left)
  #endif  // OS_MACOSX
    IPC_STRUCT_TRAITS_MEMBER(edit_flags)
    IPC_STRUCT_TRAITS_MEMBER(security_info)
    IPC_STRUCT_TRAITS_MEMBER(frame_charset)
    IPC_STRUCT_TRAITS_MEMBER(referrer_policy)
    IPC_STRUCT_TRAITS_MEMBER(custom_context)
    IPC_STRUCT_TRAITS_MEMBER(custom_items)
    IPC_STRUCT_TRAITS_MEMBER(source_type)
  #if defined(OS_ANDROID)
    IPC_STRUCT_TRAITS_MEMBER(selection_start)
    IPC_STRUCT_TRAITS_MEMBER(selection_end)
  #endif
  IPC_STRUCT_TRAITS_END()
  
  IPC_STRUCT_TRAITS_BEGIN(content::CustomContextMenuContext)
    IPC_STRUCT_TRAITS_MEMBER(is_pepper_menu)
    IPC_STRUCT_TRAITS_MEMBER(request_id)
    IPC_STRUCT_TRAITS_MEMBER(render_widget_id)
  IPC_STRUCT_TRAITS_END()
  
  IPC_STRUCT_TRAITS_BEGIN(content::FaviconURL)
    IPC_STRUCT_TRAITS_MEMBER(icon_url)
    IPC_STRUCT_TRAITS_MEMBER(icon_type)
  IPC_STRUCT_TRAITS_END()
  
  IPC_STRUCT_TRAITS_BEGIN(content::FileChooserParams)
    IPC_STRUCT_TRAITS_MEMBER(mode)
    IPC_STRUCT_TRAITS_MEMBER(title)
    IPC_STRUCT_TRAITS_MEMBER(default_file_name)
    IPC_STRUCT_TRAITS_MEMBER(accept_types)
  #if defined(OS_ANDROID)
    IPC_STRUCT_TRAITS_MEMBER(capture)
  #endif
  IPC_STRUCT_TRAITS_END()
  
  IPC_STRUCT_TRAITS_BEGIN(content::FrameNavigateParams)
    IPC_STRUCT_TRAITS_MEMBER(page_id)
    IPC_STRUCT_TRAITS_MEMBER(url)
    IPC_STRUCT_TRAITS_MEMBER(base_url)
    IPC_STRUCT_TRAITS_MEMBER(referrer)
    IPC_STRUCT_TRAITS_MEMBER(transition)
    IPC_STRUCT_TRAITS_MEMBER(redirects)
    IPC_STRUCT_TRAITS_MEMBER(should_update_history)
    IPC_STRUCT_TRAITS_MEMBER(searchable_form_url)
    IPC_STRUCT_TRAITS_MEMBER(searchable_form_encoding)
    IPC_STRUCT_TRAITS_MEMBER(contents_mime_type)
    IPC_STRUCT_TRAITS_MEMBER(socket_address)
  IPC_STRUCT_TRAITS_END()
  
  IPC_STRUCT_TRAITS_BEGIN(content::PepperRendererInstanceData)
    IPC_STRUCT_TRAITS_MEMBER(render_process_id)
    IPC_STRUCT_TRAITS_MEMBER(render_view_id)
    IPC_STRUCT_TRAITS_MEMBER(document_url)
    IPC_STRUCT_TRAITS_MEMBER(plugin_url)
  IPC_STRUCT_TRAITS_END()
  
  IPC_STRUCT_TRAITS_BEGIN(content::RendererPreferences)
    IPC_STRUCT_TRAITS_MEMBER(can_accept_load_drops)
    IPC_STRUCT_TRAITS_MEMBER(should_antialias_text)
    IPC_STRUCT_TRAITS_MEMBER(hinting)
    IPC_STRUCT_TRAITS_MEMBER(use_autohinter)
    IPC_STRUCT_TRAITS_MEMBER(use_bitmaps)
    IPC_STRUCT_TRAITS_MEMBER(subpixel_rendering)
    IPC_STRUCT_TRAITS_MEMBER(use_subpixel_positioning)
    IPC_STRUCT_TRAITS_MEMBER(focus_ring_color)
    IPC_STRUCT_TRAITS_MEMBER(thumb_active_color)
    IPC_STRUCT_TRAITS_MEMBER(thumb_inactive_color)
    IPC_STRUCT_TRAITS_MEMBER(track_color)
    IPC_STRUCT_TRAITS_MEMBER(active_selection_bg_color)
    IPC_STRUCT_TRAITS_MEMBER(active_selection_fg_color)
    IPC_STRUCT_TRAITS_MEMBER(inactive_selection_bg_color)
    IPC_STRUCT_TRAITS_MEMBER(inactive_selection_fg_color)
    IPC_STRUCT_TRAITS_MEMBER(browser_handles_non_local_top_level_requests)
    IPC_STRUCT_TRAITS_MEMBER(browser_handles_all_top_level_requests)
    IPC_STRUCT_TRAITS_MEMBER(caret_blink_interval)
    IPC_STRUCT_TRAITS_MEMBER(use_custom_colors)
    IPC_STRUCT_TRAITS_MEMBER(enable_referrers)
    IPC_STRUCT_TRAITS_MEMBER(enable_do_not_track)
    IPC_STRUCT_TRAITS_MEMBER(default_zoom_level)
    IPC_STRUCT_TRAITS_MEMBER(user_agent_override)
    IPC_STRUCT_TRAITS_MEMBER(accept_languages)
    IPC_STRUCT_TRAITS_MEMBER(report_frame_name_changes)
    IPC_STRUCT_TRAITS_MEMBER(touchpad_fling_profile)
    IPC_STRUCT_TRAITS_MEMBER(touchscreen_fling_profile)
    IPC_STRUCT_TRAITS_MEMBER(tap_multiple_targets_strategy)
    IPC_STRUCT_TRAITS_MEMBER(disable_client_blocked_error_page)
    IPC_STRUCT_TRAITS_MEMBER(plugin_fullscreen_allowed)
  IPC_STRUCT_TRAITS_END()
  
  IPC_STRUCT_TRAITS_BEGIN(content::CookieData)
    IPC_STRUCT_TRAITS_MEMBER(name)
    IPC_STRUCT_TRAITS_MEMBER(value)
    IPC_STRUCT_TRAITS_MEMBER(domain)
    IPC_STRUCT_TRAITS_MEMBER(path)
    IPC_STRUCT_TRAITS_MEMBER(expires)
    IPC_STRUCT_TRAITS_MEMBER(http_only)
    IPC_STRUCT_TRAITS_MEMBER(secure)
    IPC_STRUCT_TRAITS_MEMBER(session)
  IPC_STRUCT_TRAITS_END()
  
  IPC_STRUCT_TRAITS_BEGIN(content::WebPluginGeometry)
    IPC_STRUCT_TRAITS_MEMBER(window)
    IPC_STRUCT_TRAITS_MEMBER(window_rect)
    IPC_STRUCT_TRAITS_MEMBER(clip_rect)
    IPC_STRUCT_TRAITS_MEMBER(cutout_rects)
    IPC_STRUCT_TRAITS_MEMBER(rects_valid)
    IPC_STRUCT_TRAITS_MEMBER(visible)
  IPC_STRUCT_TRAITS_END()
  
  IPC_STRUCT_TRAITS_BEGIN(media::MediaLogEvent)
    IPC_STRUCT_TRAITS_MEMBER(id)
    IPC_STRUCT_TRAITS_MEMBER(type)
    IPC_STRUCT_TRAITS_MEMBER(params)
    IPC_STRUCT_TRAITS_MEMBER(time)
  IPC_STRUCT_TRAITS_END()
  
  IPC_STRUCT_TRAITS_BEGIN(ui::SelectedFileInfo)
    IPC_STRUCT_TRAITS_MEMBER(file_path)
    IPC_STRUCT_TRAITS_MEMBER(local_path)
    IPC_STRUCT_TRAITS_MEMBER(display_name)
  IPC_STRUCT_TRAITS_END()
  
  IPC_STRUCT_TRAITS_BEGIN(content::BrowserRenderingStats)
    IPC_STRUCT_TRAITS_MEMBER(input_event_count)
    IPC_STRUCT_TRAITS_MEMBER(total_input_latency)
    IPC_STRUCT_TRAITS_MEMBER(touch_ui_count)
    IPC_STRUCT_TRAITS_MEMBER(total_touch_ui_latency)
    IPC_STRUCT_TRAITS_MEMBER(touch_acked_count)
    IPC_STRUCT_TRAITS_MEMBER(total_touch_acked_latency)
    IPC_STRUCT_TRAITS_MEMBER(scroll_update_count)
    IPC_STRUCT_TRAITS_MEMBER(total_scroll_update_latency)
  IPC_STRUCT_TRAITS_END()
  
  IPC_STRUCT_BEGIN(ViewHostMsg_CreateWindow_Params)
    // Routing ID of the view initiating the open.
    IPC_STRUCT_MEMBER(int, opener_id)
  
    // True if this open request came in the context of a user gesture.
    IPC_STRUCT_MEMBER(bool, user_gesture)
  
    // Type of window requested.
    IPC_STRUCT_MEMBER(WindowContainerType, window_container_type)
  
    // The session storage namespace ID this view should use.
    IPC_STRUCT_MEMBER(int64, session_storage_namespace_id)
  
    // The name of the resulting frame that should be created (empty if none
    // has been specified).
    IPC_STRUCT_MEMBER(string16, frame_name)
  
    // The frame identifier of the frame initiating the open.
    IPC_STRUCT_MEMBER(int64, opener_frame_id)
  
    // The URL of the frame initiating the open.
    IPC_STRUCT_MEMBER(GURL, opener_url)
  
    // The URL of the top frame containing the opener.
    IPC_STRUCT_MEMBER(GURL, opener_top_level_frame_url)
  
    // The security origin of the frame initiating the open.
    IPC_STRUCT_MEMBER(GURL, opener_security_origin)
  
    // Whether the opener will be suppressed in the new window, in which case
    // scripting the new window is not allowed.
    IPC_STRUCT_MEMBER(bool, opener_suppressed)
  
    // Whether the window should be opened in the foreground, background, etc.
    IPC_STRUCT_MEMBER(WindowOpenDisposition, disposition)
  
    // The URL that will be loaded in the new window (empty if none has been
    // sepcified).
    IPC_STRUCT_MEMBER(GURL, target_url)
  
    // The referrer that will be used to load |target_url| (empty if none has
    // been specified).
    IPC_STRUCT_MEMBER(content::Referrer, referrer)
  
    // The window features to use for the new view.
    IPC_STRUCT_MEMBER(WebKit::WebWindowFeatures, features)
  IPC_STRUCT_END()
  
  IPC_STRUCT_BEGIN(ViewHostMsg_CreateWorker_Params)
    // URL for the worker script.
    IPC_STRUCT_MEMBER(GURL, url)
  
    // Name for a SharedWorker, otherwise empty string.
    IPC_STRUCT_MEMBER(string16, name)
  
    // The ID of the parent document (unique within parent renderer).
    IPC_STRUCT_MEMBER(unsigned long long, document_id)
  
    // RenderView routing id used to send messages back to the parent.
    IPC_STRUCT_MEMBER(int, render_view_route_id)
  
    // The route ID to associate with the worker. If MSG_ROUTING_NONE is passed,
    // a new unique ID is created and assigned to the worker.
    IPC_STRUCT_MEMBER(int, route_id)
  
    // The ID of the appcache the main shared worker script resource was loaded
    // from, only valid for shared workers.
    IPC_STRUCT_MEMBER(int64, script_resource_appcache_id)
  IPC_STRUCT_END()
  
  IPC_STRUCT_BEGIN(ViewHostMsg_DateTimeDialogValue_Params)
    IPC_STRUCT_MEMBER(int, dialog_type)
    IPC_STRUCT_MEMBER(int, year)
    IPC_STRUCT_MEMBER(int, month)
    IPC_STRUCT_MEMBER(int, day)
    IPC_STRUCT_MEMBER(int, hour)
    IPC_STRUCT_MEMBER(int, minute)
    IPC_STRUCT_MEMBER(int, second)
    IPC_STRUCT_MEMBER(int, milli)
    IPC_STRUCT_MEMBER(int, week)
    IPC_STRUCT_MEMBER(double, minimum)
    IPC_STRUCT_MEMBER(double, maximum)
    IPC_STRUCT_MEMBER(double, step)
  IPC_STRUCT_END()
  
  IPC_STRUCT_BEGIN(ViewHostMsg_DidFailProvisionalLoadWithError_Params)
    // The frame ID for the failure report.
    IPC_STRUCT_MEMBER(int64, frame_id)
    // The WebFrame's uniqueName().
    IPC_STRUCT_MEMBER(string16, frame_unique_name)
    // True if this is the top-most frame.
    IPC_STRUCT_MEMBER(bool, is_main_frame)
    // Error code as reported in the DidFailProvisionalLoad callback.
    IPC_STRUCT_MEMBER(int, error_code)
    // An error message generated from the error_code. This can be an empty
    // string if we were unable to find a meaningful description.
    IPC_STRUCT_MEMBER(string16, error_description)
    // The URL that the error is reported for.
    IPC_STRUCT_MEMBER(GURL, url)
    // True if the failure is the result of navigating to a POST again
    // and we're going to show the POST interstitial.
    IPC_STRUCT_MEMBER(bool, showing_repost_interstitial)
  IPC_STRUCT_END()
  
  // Parameters structure for ViewHostMsg_FrameNavigate, which has too many data
  // parameters to be reasonably put in a predefined IPC message.
  IPC_STRUCT_BEGIN_WITH_PARENT(ViewHostMsg_FrameNavigate_Params,
                               content::FrameNavigateParams)
    IPC_STRUCT_TRAITS_PARENT(content::FrameNavigateParams)
    // The frame ID for this navigation. The frame ID uniquely identifies the
    // frame the navigation happened in for a given renderer.
    IPC_STRUCT_MEMBER(int64, frame_id)
  
    // The WebFrame's uniqueName().
    IPC_STRUCT_MEMBER(string16, frame_unique_name)
  
    // Information regarding the security of the connection (empty if the
    // connection was not secure).
    IPC_STRUCT_MEMBER(std::string, security_info)
  
    // The gesture that initiated this navigation.
    IPC_STRUCT_MEMBER(content::NavigationGesture, gesture)
  
    // True if this was a post request.
    IPC_STRUCT_MEMBER(bool, is_post)
  
    // The POST body identifier. -1 if it doesn't exist.
    IPC_STRUCT_MEMBER(int64, post_id)
  
    // Whether the frame navigation resulted in no change to the documents within
    // the page. For example, the navigation may have just resulted in scrolling
    // to a named anchor.
    IPC_STRUCT_MEMBER(bool, was_within_same_page)
  
    // The status code of the HTTP request.
    IPC_STRUCT_MEMBER(int, http_status_code)
  
    // True if the connection was proxied.  In this case, socket_address
    // will represent the address of the proxy, rather than the remote host.
    IPC_STRUCT_MEMBER(bool, was_fetched_via_proxy)
  
    // Serialized history item state to store in the navigation entry.
    IPC_STRUCT_MEMBER(content::PageState, page_state)
  
    // Original request's URL.
    IPC_STRUCT_MEMBER(GURL, original_request_url)
  
    // User agent override used to navigate.
    IPC_STRUCT_MEMBER(bool, is_overriding_user_agent)
  
    // Notifies the browser that for this navigation, the session history was
    // successfully cleared.
    IPC_STRUCT_MEMBER(bool, history_list_was_cleared)
  IPC_STRUCT_END()
  
  IPC_STRUCT_BEGIN(ViewHostMsg_OpenURL_Params)
    IPC_STRUCT_MEMBER(GURL, url)
    IPC_STRUCT_MEMBER(content::Referrer, referrer)
    IPC_STRUCT_MEMBER(WindowOpenDisposition, disposition)
    IPC_STRUCT_MEMBER(int64, frame_id)
    IPC_STRUCT_MEMBER(bool, should_replace_current_entry)
    IPC_STRUCT_MEMBER(bool, user_gesture)
  IPC_STRUCT_END()
  
  IPC_STRUCT_BEGIN(ViewHostMsg_SelectionBounds_Params)
    IPC_STRUCT_MEMBER(gfx::Rect, anchor_rect)
    IPC_STRUCT_MEMBER(WebKit::WebTextDirection, anchor_dir)
    IPC_STRUCT_MEMBER(gfx::Rect, focus_rect)
    IPC_STRUCT_MEMBER(WebKit::WebTextDirection, focus_dir)
    IPC_STRUCT_MEMBER(bool, is_anchor_first)
  IPC_STRUCT_END()
  
  // This message is used for supporting popup menus on Mac OS X using native
  // Cocoa controls. The renderer sends us this message which we use to populate
  // the popup menu.
  IPC_STRUCT_BEGIN(ViewHostMsg_ShowPopup_Params)
    // Position on the screen.
    IPC_STRUCT_MEMBER(gfx::Rect, bounds)
  
    // The height of each item in the menu.
    IPC_STRUCT_MEMBER(int, item_height)
  
    // The size of the font to use for those items.
    IPC_STRUCT_MEMBER(double, item_font_size)
  
    // The currently selected (displayed) item in the menu.
    IPC_STRUCT_MEMBER(int, selected_item)
  
    // The entire list of items in the popup menu.
    IPC_STRUCT_MEMBER(std::vector<content::MenuItem>, popup_items)
  
    // Whether items should be right-aligned.
    IPC_STRUCT_MEMBER(bool, right_aligned)
  
    // Whether this is a multi-select popup.
    IPC_STRUCT_MEMBER(bool, allow_multiple_selection)
  IPC_STRUCT_END()
  
  IPC_STRUCT_BEGIN(ViewHostMsg_TextInputState_Params)
    // The type of input field
    IPC_STRUCT_MEMBER(ui::TextInputType, type)
  
    // The value of the input field
    IPC_STRUCT_MEMBER(std::string, value)
  
    // The cursor position of the current selection start, or the caret position
    // if nothing is selected
    IPC_STRUCT_MEMBER(int, selection_start)
  
    // The cursor position of the current selection end, or the caret position
    // if nothing is selected
    IPC_STRUCT_MEMBER(int, selection_end)
  
    // The start position of the current composition, or -1 if there is none
    IPC_STRUCT_MEMBER(int, composition_start)
  
    // The end position of the current composition, or -1 if there is none
    IPC_STRUCT_MEMBER(int, composition_end)
  
    // Whether or not inline composition can be performed for the current input.
    IPC_STRUCT_MEMBER(bool, can_compose_inline)
  
    // Whether or not the IME should be shown as a result of this update. Even if
    // true, the IME will only be shown if the type is appropriate (e.g. not
    // TEXT_INPUT_TYPE_NONE).
    IPC_STRUCT_MEMBER(bool, show_ime_if_needed)
  
    // Whether an acknowledgement is required for this update.
    IPC_STRUCT_MEMBER(bool, require_ack)
  IPC_STRUCT_END()
  
  IPC_STRUCT_BEGIN(ViewHostMsg_UpdateRect_Params)
    // The bitmap to be painted into the view at the locations specified by
    // update_rects.
    IPC_STRUCT_MEMBER(TransportDIB::Id, bitmap)
  
    // The position and size of the bitmap.
    IPC_STRUCT_MEMBER(gfx::Rect, bitmap_rect)
  
    // The scroll delta.  Only one of the delta components can be non-zero, and if
    // they are both zero, then it means there is no scrolling and the scroll_rect
    // is ignored.
    IPC_STRUCT_MEMBER(gfx::Vector2d, scroll_delta)
  
    // The rectangular region to scroll.
    IPC_STRUCT_MEMBER(gfx::Rect, scroll_rect)
  
    // The scroll offset of the render view.
    IPC_STRUCT_MEMBER(gfx::Vector2d, scroll_offset)
  
    // The regions of the bitmap (in view coords) that contain updated pixels.
    // In the case of scrolling, this includes the scroll damage rect.
    IPC_STRUCT_MEMBER(std::vector<gfx::Rect>, copy_rects)
  
    // The size of the RenderView when this message was generated.  This is
    // included so the host knows how large the view is from the perspective of
    // the renderer process.  This is necessary in case a resize operation is in
    // progress. If auto-resize is enabled, this should update the corresponding
    // view size.
    IPC_STRUCT_MEMBER(gfx::Size, view_size)
  
    // New window locations for plugin child windows.
    IPC_STRUCT_MEMBER(std::vector<content::WebPluginGeometry>,
                      plugin_window_moves)
  
    // The following describes the various bits that may be set in flags:
    //
    //   ViewHostMsg_UpdateRect_Flags::IS_RESIZE_ACK
    //     Indicates that this is a response to a ViewMsg_Resize message.
    //
    //   ViewHostMsg_UpdateRect_Flags::IS_RESTORE_ACK
    //     Indicates that this is a response to a ViewMsg_WasShown message.
    //
    //   ViewHostMsg_UpdateRect_Flags::IS_REPAINT_ACK
    //     Indicates that this is a response to a ViewMsg_Repaint message.
    //
    // If flags is zero, then this message corresponds to an unsolicited paint
    // request by the render view.  Any of the above bits may be set in flags,
    // which would indicate that this paint message is an ACK for multiple
    // request messages.
    IPC_STRUCT_MEMBER(int, flags)
  
    // Whether or not the renderer expects a ViewMsg_UpdateRect_ACK for this
    // update. True for 2D painting, but false for accelerated compositing.
    IPC_STRUCT_MEMBER(bool, needs_ack)
  
    // All the above coordinates are in DIP. This is the scale factor needed
    // to convert them to pixels.
    IPC_STRUCT_MEMBER(float, scale_factor)
  
    // The latency information for the frame. Only valid when accelerated
    // compositing is disabled.
    IPC_STRUCT_MEMBER(ui::LatencyInfo, latency_info)
  IPC_STRUCT_END()
  
  IPC_STRUCT_BEGIN(ViewMsg_Navigate_Params)
    // The page_id for this navigation, or -1 if it is a new navigation.  Back,
    // Forward, and Reload navigations should have a valid page_id.  If the load
    // succeeds, then this page_id will be reflected in the resultant
    // ViewHostMsg_FrameNavigate message.
    IPC_STRUCT_MEMBER(int32, page_id)
  
    // If page_id is -1, then pending_history_list_offset will also be -1.
    // Otherwise, it contains the offset into the history list corresponding to
    // the current navigation.
    IPC_STRUCT_MEMBER(int, pending_history_list_offset)
  
    // Informs the RenderView of where its current page contents reside in
    // session history and the total size of the session history list.
    IPC_STRUCT_MEMBER(int, current_history_list_offset)
    IPC_STRUCT_MEMBER(int, current_history_list_length)
  
    // Informs the RenderView the session history should be cleared. In that
    // case, the RenderView needs to notify the browser that the clearing was
    // succesful when the navigation commits.
    IPC_STRUCT_MEMBER(bool, should_clear_history_list)
  
    // The URL to load.
    IPC_STRUCT_MEMBER(GURL, url)
  
    // Base URL for use in WebKit's SubstituteData.
    // Is only used with data: URLs.
    IPC_STRUCT_MEMBER(GURL, base_url_for_data_url)
  
    // History URL for use in WebKit's SubstituteData.
    // Is only used with data: URLs.
    IPC_STRUCT_MEMBER(GURL, history_url_for_data_url)
  
    // The URL to send in the "Referer" header field. Can be empty if there is
    // no referrer.
    IPC_STRUCT_MEMBER(content::Referrer, referrer)
  
    // Any redirect URLs that occurred before |url|. Useful for cross-process
    // navigations; defaults to empty.
    IPC_STRUCT_MEMBER(std::vector<GURL>, redirects)
  
    // The type of transition.
    IPC_STRUCT_MEMBER(content::PageTransition, transition)
  
    // Opaque history state (received by ViewHostMsg_UpdateState).
    IPC_STRUCT_MEMBER(content::PageState, page_state)
  
    // Type of navigation.
    IPC_STRUCT_MEMBER(ViewMsg_Navigate_Type::Value, navigation_type)
  
    // The time the request was created
    IPC_STRUCT_MEMBER(base::Time, request_time)
  
    // Extra headers (separated by \n) to send during the request.
    IPC_STRUCT_MEMBER(std::string, extra_headers)
  
    // The following two members identify a previous request that has been
    // created before this navigation is being transferred to a new render view.
    // This serves the purpose of recycling the old request.
    // Unless this refers to a transferred navigation, these values are -1 and -1.
    IPC_STRUCT_MEMBER(int, transferred_request_child_id)
    IPC_STRUCT_MEMBER(int, transferred_request_request_id)
  
    // Whether or not we should allow the url to download.
    IPC_STRUCT_MEMBER(bool, allow_download)
  
    // Whether or not the user agent override string should be used.
    IPC_STRUCT_MEMBER(bool, is_overriding_user_agent)
  
    // True if this was a post request.
    IPC_STRUCT_MEMBER(bool, is_post)
  
    // If is_post is true, holds the post_data information from browser. Empty
    // otherwise.
    IPC_STRUCT_MEMBER(std::vector<unsigned char>, browser_initiated_post_data)
  
    // Whether or not this url should be allowed to access local file://
    // resources.
    IPC_STRUCT_MEMBER(bool, can_load_local_resources)
  
    // If not empty, which frame to navigate.
    IPC_STRUCT_MEMBER(std::string, frame_to_navigate)
  
    // The navigationStart time to expose to JS for this navigation.
    IPC_STRUCT_MEMBER(base::TimeTicks, browser_navigation_start)
  IPC_STRUCT_END()
  
  IPC_STRUCT_BEGIN(ViewMsg_New_Params)
    // Renderer-wide preferences.
    IPC_STRUCT_MEMBER(content::RendererPreferences, renderer_preferences)
  
    // Preferences for this view.
    IPC_STRUCT_MEMBER(WebPreferences, web_preferences)
  
    // The ID of the view to be created.
    IPC_STRUCT_MEMBER(int32, view_id)
  
    // The ID of the main frame hosted in the view.
    IPC_STRUCT_MEMBER(int32, main_frame_routing_id)
  
    // The ID of the rendering surface.
    IPC_STRUCT_MEMBER(int32, surface_id)
  
    // The session storage namespace ID this view should use.
    IPC_STRUCT_MEMBER(int64, session_storage_namespace_id)
  
    // The name of the frame associated with this view (or empty if none).
    IPC_STRUCT_MEMBER(string16, frame_name)
  
    // The route ID of the opener RenderView if we need to set one
    // (MSG_ROUTING_NONE otherwise).
    IPC_STRUCT_MEMBER(int, opener_route_id)
  
    // Whether the RenderView should initially be swapped out.
    IPC_STRUCT_MEMBER(bool, swapped_out)
  
    // Whether the RenderView should initially be hidden.
    IPC_STRUCT_MEMBER(bool, hidden)
  
    // The initial page ID to use for this view, which must be larger than any
    // existing navigation that might be loaded in the view.  Page IDs are unique
    // to a view and are only updated by the renderer after this initial value.
    IPC_STRUCT_MEMBER(int32, next_page_id)
  
    // The properties of the screen associated with the view.
    IPC_STRUCT_MEMBER(WebKit::WebScreenInfo, screen_info)
  
    // The accessibility mode of the renderer.
    IPC_STRUCT_MEMBER(AccessibilityMode, accessibility_mode)
  
    // Specifies whether partially swapping composited buffers is
    // allowed for a renderer. Partial swaps will be used if they are both
    // allowed and supported.
    IPC_STRUCT_MEMBER(bool, allow_partial_swap)
  IPC_STRUCT_END()
  
  IPC_STRUCT_BEGIN(ViewMsg_PostMessage_Params)
    // The serialized script value.
    IPC_STRUCT_MEMBER(string16, data)
  
    // When sent to the browser, this is the routing ID of the source frame in
    // the source process.  The browser replaces it with the routing ID of the
    // equivalent (swapped out) frame in the destination process.
    IPC_STRUCT_MEMBER(int, source_routing_id)
  
    // The origin of the source frame.
    IPC_STRUCT_MEMBER(string16, source_origin)
  
    // The origin for the message's target.
    IPC_STRUCT_MEMBER(string16, target_origin)
  
    // Information about the MessagePorts this message contains.
    IPC_STRUCT_MEMBER(std::vector<int>, message_port_ids)
    IPC_STRUCT_MEMBER(std::vector<int>, new_routing_ids)
  IPC_STRUCT_END()
  
  // Messages sent from the browser to the renderer.
  
  // Tells the renderer to cancel an opened date/time dialog.
  IPC_MESSAGE_ROUTED0(ViewMsg_CancelDateTimeDialog)
  
  // Get all savable resource links from current webpage, include main
  // frame and sub-frame.
  IPC_MESSAGE_ROUTED1(ViewMsg_GetAllSavableResourceLinksForCurrentPage,
                      GURL /* url of page which is needed to save */)
  
  // Get html data by serializing all frames of current page with lists
  // which contain all resource links that have local copy.
  IPC_MESSAGE_ROUTED3(ViewMsg_GetSerializedHtmlDataForCurrentPageWithLocalLinks,
                      std::vector<GURL> /* urls that have local copy */,
                      std::vector<base::FilePath> /* paths of local copy */,
                      base::FilePath /* local directory path */)
  
  // Tells the render side that a ViewHostMsg_LockMouse message has been
  // processed. |succeeded| indicates whether the mouse has been successfully
  // locked or not.
  IPC_MESSAGE_ROUTED1(ViewMsg_LockMouse_ACK,
                      bool /* succeeded */)
  // Tells the render side that the mouse has been unlocked.
  IPC_MESSAGE_ROUTED0(ViewMsg_MouseLockLost)
  
  // Screen was rotated. Dispatched to the onorientationchange javascript API.
  IPC_MESSAGE_ROUTED1(ViewMsg_OrientationChangeEvent,
                      int /* orientation */)
  
  // Sent by the browser when the parameters for vsync alignment have changed.
  IPC_MESSAGE_ROUTED2(ViewMsg_UpdateVSyncParameters,
                      base::TimeTicks /* timebase */,
                      base::TimeDelta /* interval */)
  
  // Set the top-level frame to the provided name.
  IPC_MESSAGE_ROUTED1(ViewMsg_SetName,
                      std::string /* frame_name */)
  
  // Sent to the RenderView when a new tab is swapped into an existing
  // tab and the histories need to be merged. The existing tab has a history of
  // |merged_history_length| which precedes the history of the new tab. All
  // page_ids >= |minimum_page_id| in the new tab are appended to the history.
  //
  // For example, suppose the history of page_ids in the new tab's RenderView
  // is [4 7 8]. This is merged into an existing tab with 3 history items, and
  // all pages in the new tab with page_id >= 7 are to be preserved.
  // The resulting page history is [-1 -1 -1 7 8].
  IPC_MESSAGE_ROUTED2(ViewMsg_SetHistoryLengthAndPrune,
                      int, /* merge_history_length */
                      int32 /* minimum_page_id */)
  
  // Tells the renderer the browser's notion of its process ID.
  // Some subsystems, like LatencyInfo, require this to be known to the renderer.
  IPC_MESSAGE_CONTROL1(ViewMsg_SetRendererProcessID,
                       base::ProcessId /* process_id */)
  
  // Tells the renderer to create a new view.
  // This message is slightly different, the view it takes (via
  // ViewMsg_New_Params) is the view to create, the message itself is sent as a
  // non-view control message.
  IPC_MESSAGE_CONTROL1(ViewMsg_New,
                       ViewMsg_New_Params)
  
  // Reply in response to ViewHostMsg_ShowView or ViewHostMsg_ShowWidget.
  // similar to the new command, but used when the renderer created a view
  // first, and we need to update it.
  IPC_MESSAGE_ROUTED0(ViewMsg_CreatingNew_ACK)
  
  // Sends updated preferences to the renderer.
  IPC_MESSAGE_ROUTED1(ViewMsg_SetRendererPrefs,
                      content::RendererPreferences)
  
  // This passes a set of webkit preferences down to the renderer.
  IPC_MESSAGE_ROUTED1(ViewMsg_UpdateWebPreferences,
                      WebPreferences)
  
  // Informs the renderer that the timezone has changed.
  IPC_MESSAGE_ROUTED0(ViewMsg_TimezoneChange)
  
  // Tells the render view to close.
  IPC_MESSAGE_ROUTED0(ViewMsg_Close)
  
  IPC_STRUCT_BEGIN(ViewMsg_Resize_Params)
    IPC_STRUCT_MEMBER(WebKit::WebScreenInfo, screen_info)
    IPC_STRUCT_MEMBER(gfx::Size, new_size)
    IPC_STRUCT_MEMBER(gfx::Size, physical_backing_size)
    IPC_STRUCT_MEMBER(float, overdraw_bottom_height)
    IPC_STRUCT_MEMBER(gfx::Rect, resizer_rect)
    IPC_STRUCT_MEMBER(bool, is_fullscreen)
  IPC_STRUCT_END()
  
  // Tells the render view to change its size.  A ViewHostMsg_UpdateRect message
  // is generated in response provided new_size is not empty and not equal to
  // the view's current size.  The generated ViewHostMsg_UpdateRect message will
  // have the IS_RESIZE_ACK flag set. It also receives the resizer rect so that
  // we don't have to fetch it every time WebKit asks for it.
  IPC_MESSAGE_ROUTED1(ViewMsg_Resize,
                      ViewMsg_Resize_Params /* params */)
  
  // Tells the render view that the resize rect has changed.
  IPC_MESSAGE_ROUTED1(ViewMsg_ChangeResizeRect,
                      gfx::Rect /* resizer_rect */)
  
  // Sent to inform the view that it was hidden.  This allows it to reduce its
  // resource utilization.
  IPC_MESSAGE_ROUTED0(ViewMsg_WasHidden)
  
  // Tells the render view that it is no longer hidden (see WasHidden), and the
  // render view is expected to respond with a full repaint if needs_repainting
  // is true.  In that case, the generated ViewHostMsg_UpdateRect message will
  // have the IS_RESTORE_ACK flag set.  If needs_repainting is false, then this
  // message does not trigger a message in response.
  IPC_MESSAGE_ROUTED1(ViewMsg_WasShown,
                      bool /* needs_repainting */)
  
  // Sent to inform the view that it was swapped out.  This allows the process to
  // exit if no other views are using it.
  IPC_MESSAGE_ROUTED0(ViewMsg_WasSwappedOut)
  
  // Sent to render the view into the supplied transport DIB, resize
  // the web widget to match the |page_size|, scale it by the
  // appropriate scale to make it fit the |desired_size|, and return
  // it.  In response to this message, the host generates a
  // ViewHostMsg_PaintAtSize_ACK message.  Note that the DIB *must* be
  // the right size to receive an RGBA image at the |desired_size|.
  // |tag| is sent along with ViewHostMsg_PaintAtSize_ACK unmodified to
  // identify the PaintAtSize message the ACK belongs to.
  IPC_MESSAGE_ROUTED4(ViewMsg_PaintAtSize,
                      TransportDIB::Handle /* dib_handle */,
                      int /* tag */,
                      gfx::Size /* page_size */,
                      gfx::Size /* desired_size */)
  
  // Tells the render view that a ViewHostMsg_UpdateRect message was processed.
  // This signals the render view that it can send another UpdateRect message.
  IPC_MESSAGE_ROUTED0(ViewMsg_UpdateRect_ACK)
  
  // Tells the render view that a SwapBuffers was completed. Typically,
  // SwapBuffers requests go from renderer -> GPU process -> browser. Most
  // platforms still use the GfxCxt3D Echo for receiving the SwapBuffers Ack.
  // Using Echo routes the ack from browser -> GPU process -> renderer, while this
  // Ack goes directly from browser -> renderer. This is not used for the threaded
  // compositor path.
  IPC_MESSAGE_ROUTED0(ViewMsg_SwapBuffers_ACK)
  
  // Tells the render widget that a smooth scroll completed.
  IPC_MESSAGE_ROUTED0(ViewMsg_SyntheticGestureCompleted)
  
  // Tells the renderer to focus the first (last if reverse is true) focusable
  // node.
  IPC_MESSAGE_ROUTED1(ViewMsg_SetInitialFocus,
                      bool /* reverse */)
  
  // Executes custom context menu action that was provided from WebKit.
  IPC_MESSAGE_ROUTED2(ViewMsg_CustomContextMenuAction,
                      content::CustomContextMenuContext /* custom_context */,
                      unsigned /* action */)
  
  // Sent in response to a ViewHostMsg_ContextMenu to let the renderer know that
  // the menu has been closed.
  IPC_MESSAGE_ROUTED1(ViewMsg_ContextMenuClosed,
                      content::CustomContextMenuContext /* custom_context */)
  
  // Sent to inform the renderer to invoke a context menu.
  // The parameter specifies the location in the render view's coordinates.
  IPC_MESSAGE_ROUTED1(ViewMsg_ShowContextMenu,
                      gfx::Point /* location where menu should be shown */)
  
  // Tells the renderer to perform the specified navigation, interrupting any
  // existing navigation.
  IPC_MESSAGE_ROUTED1(ViewMsg_Navigate, ViewMsg_Navigate_Params)
  
  IPC_MESSAGE_ROUTED0(ViewMsg_Stop)
  
  // Tells the renderer to reload the current focused frame
  IPC_MESSAGE_ROUTED0(ViewMsg_ReloadFrame)
  
  // Sent when the user wants to search for a word on the page (find in page).
  IPC_MESSAGE_ROUTED3(ViewMsg_Find,
                      int /* request_id */,
                      string16 /* search_text */,
                      WebKit::WebFindOptions)
  
  // This message notifies the renderer that the user has closed the FindInPage
  // window (and what action to take regarding the selection).
  IPC_MESSAGE_ROUTED1(ViewMsg_StopFinding,
                      content::StopFindAction /* action */)
  
  // Informs the renderer about various statistics the browser has (e.g.
  // latency) regarding the frames that have been displayed.
  IPC_MESSAGE_ROUTED1(ViewMsg_SetBrowserRenderingStats,
                      content::BrowserRenderingStats /* stats */)
  
  // Replaces a date time input field.
  IPC_MESSAGE_ROUTED1(ViewMsg_ReplaceDateTime,
                      ViewHostMsg_DateTimeDialogValue_Params /* value */)
  
  // Copies the image at location x, y to the clipboard (if there indeed is an
  // image at that location).
  IPC_MESSAGE_ROUTED2(ViewMsg_CopyImageAt,
                      int /* x */,
                      int /* y */)
  
  // Tells the renderer to perform the given action on the media player
  // located at the given point.
  IPC_MESSAGE_ROUTED2(ViewMsg_MediaPlayerActionAt,
                      gfx::Point, /* location */
                      WebKit::WebMediaPlayerAction)
  
  // Tells the renderer to perform the given action on the plugin located at
  // the given point.
  IPC_MESSAGE_ROUTED2(ViewMsg_PluginActionAt,
                      gfx::Point, /* location */
                      WebKit::WebPluginAction)
  
  // Request for the renderer to evaluate an xpath to a frame and execute a
  // javascript: url in that frame's context. The message is completely
  // asynchronous and no corresponding response message is sent back.
  //
  // frame_xpath contains the modified xpath notation to identify an inner
  // subframe (starting from the root frame). It is a concatenation of
  // number of smaller xpaths delimited by '\n'. Each chunk in the string can
  // be evaluated to a frame in its parent-frame's context.
  //
  // Example: /html/body/iframe/\n/html/body/div/iframe/\n/frameset/frame[0]
  // can be broken into 3 xpaths
  // /html/body/iframe evaluates to an iframe within the root frame
  // /html/body/div/iframe evaluates to an iframe within the level-1 iframe
  // /frameset/frame[0] evaluates to first frame within the level-2 iframe
  //
  // jscript_url is the string containing the javascript: url to be executed
  // in the target frame's context. The string should start with "javascript:"
  // and continue with a valid JS text.
  //
  // If the fourth parameter is true the result is sent back to the renderer
  // using the message ViewHostMsg_ScriptEvalResponse.
  // ViewHostMsg_ScriptEvalResponse is passed the ID parameter so that the
  // client can uniquely identify the request.
  IPC_MESSAGE_ROUTED4(ViewMsg_ScriptEvalRequest,
                      string16,  /* frame_xpath */
                      string16,  /* jscript_url */
                      int,  /* ID */
                      bool  /* If true, result is sent back. */)
  
  // Posts a message from a frame in another process to the current renderer.
  IPC_MESSAGE_ROUTED1(ViewMsg_PostMessageEvent,
                      ViewMsg_PostMessage_Params)
  
  // Requests that the RenderView's main frame sets its opener to null.
  IPC_MESSAGE_ROUTED0(ViewMsg_DisownOpener)
  
  // Request for the renderer to evaluate an xpath to a frame and insert css
  // into that frame's document. See ViewMsg_ScriptEvalRequest for details on
  // allowed xpath expressions.
  IPC_MESSAGE_ROUTED2(ViewMsg_CSSInsertRequest,
                      string16,  /* frame_xpath */
                      std::string  /* css string */)
  
  // Change the zoom level for the current main frame.  If the level actually
  // changes, a ViewHostMsg_DidZoomURL message will be sent back to the browser
  // telling it what url got zoomed and what its current zoom level is.
  IPC_MESSAGE_ROUTED1(ViewMsg_Zoom,
                      content::PageZoom /* function */)
  
  // Set the zoom level for the current main frame.  If the level actually
  // changes, a ViewHostMsg_DidZoomURL message will be sent back to the browser
  // telling it what url got zoomed and what its current zoom level is.
  IPC_MESSAGE_ROUTED1(ViewMsg_SetZoomLevel,
                      double /* zoom_level */)
  
  // Zooms the page by the factor defined in the renderer.
  IPC_MESSAGE_ROUTED3(ViewMsg_ZoomFactor,
                      content::PageZoom,
                      int /* zoom center_x */,
                      int /* zoom center_y */)
  
  // Set the zoom level for a particular url that the renderer is in the
  // process of loading.  This will be stored, to be used if the load commits
  // and ignored otherwise.
  IPC_MESSAGE_ROUTED2(ViewMsg_SetZoomLevelForLoadingURL,
                      GURL /* url */,
                      double /* zoom_level */)
  
  // Set the zoom level for a particular url, so all render views
  // displaying this url can update their zoom levels to match.
  // If scheme is empty, then only host is used for matching.
  IPC_MESSAGE_CONTROL3(ViewMsg_SetZoomLevelForCurrentURL,
                       std::string /* scheme */,
                       std::string /* host */,
                       double /* zoom_level */)
  
  // Change encoding of page in the renderer.
  IPC_MESSAGE_ROUTED1(ViewMsg_SetPageEncoding,
                      std::string /*new encoding name*/)
  
  // Reset encoding of page in the renderer back to default.
  IPC_MESSAGE_ROUTED0(ViewMsg_ResetPageEncodingToDefault)
  
  // Used to tell a render view whether it should expose various bindings
  // that allow JS content extended privileges.  See BindingsPolicy for valid
  // flag values.
  IPC_MESSAGE_ROUTED1(ViewMsg_AllowBindings,
                      int /* enabled_bindings_flags */)
  
  // Tell the renderer to add a property to the WebUI binding object.  This
  // only works if we allowed WebUI bindings.
  IPC_MESSAGE_ROUTED2(ViewMsg_SetWebUIProperty,
                      std::string /* property_name */,
                      std::string /* property_value_json */)
  
  // This message starts/stop monitoring the input method status of the focused
  // edit control of a renderer process.
  // Parameters
  // * is_active (bool)
  //   Indicates if an input method is active in the browser process.
  //   The possible actions when a renderer process receives this message are
  //   listed below:
  //     Value Action
  //     true  Start sending IPC message ViewHostMsg_ImeUpdateTextInputState
  //           to notify the input method status of the focused edit control.
  //     false Stop sending IPC message ViewHostMsg_ImeUpdateTextInputState.
  IPC_MESSAGE_ROUTED1(ViewMsg_SetInputMethodActive,
                      bool /* is_active */)
  
  // This message sends a string being composed with an input method.
  IPC_MESSAGE_ROUTED4(
      ViewMsg_ImeSetComposition,
      string16, /* text */
      std::vector<WebKit::WebCompositionUnderline>, /* underlines */
      int, /* selectiont_start */
      int /* selection_end */)
  
  // This message confirms an ongoing composition.
  IPC_MESSAGE_ROUTED3(ViewMsg_ImeConfirmComposition,
                      string16 /* text */,
                      gfx::Range /* replacement_range */,
                      bool /* keep_selection */)
  
  // Sets the text composition to be between the given start and end offsets
  // in the currently focused editable field.
  IPC_MESSAGE_ROUTED3(ViewMsg_SetCompositionFromExistingText,
      int /* start */,
      int /* end */,
      std::vector<WebKit::WebCompositionUnderline> /* underlines */)
  
  // Selects between the given start and end offsets in the currently focused
  // editable field.
  IPC_MESSAGE_ROUTED2(ViewMsg_SetEditableSelectionOffsets,
                      int /* start */,
                      int /* end */)
  
  // Deletes the current selection plus the specified number of characters before
  // and after the selection or caret.
  IPC_MESSAGE_ROUTED2(ViewMsg_ExtendSelectionAndDelete,
                      int /* before */,
                      int /* after */)
  
  // Used to notify the render-view that we have received a target URL. Used
  // to prevent target URLs spamming the browser.
  IPC_MESSAGE_ROUTED0(ViewMsg_UpdateTargetURL_ACK)
  
  
  // Sets the alternate error page URL (link doctor) for the renderer process.
  IPC_MESSAGE_ROUTED1(ViewMsg_SetAltErrorPageURL,
                      GURL)
  
  // Notifies the color chooser client that the user selected a color.
  IPC_MESSAGE_ROUTED2(ViewMsg_DidChooseColorResponse, unsigned, SkColor)
  
  // Notifies the color chooser client that the color chooser has ended.
  IPC_MESSAGE_ROUTED1(ViewMsg_DidEndColorChooser, unsigned)
  
  IPC_MESSAGE_ROUTED1(ViewMsg_RunFileChooserResponse,
                      std::vector<ui::SelectedFileInfo>)
  
  // Provides the results of directory enumeration.
  IPC_MESSAGE_ROUTED2(ViewMsg_EnumerateDirectoryResponse,
                      int /* request_id */,
                      std::vector<base::FilePath> /* files_in_directory */)
  
  // When a renderer sends a ViewHostMsg_Focus to the browser process,
  // the browser has the option of sending a ViewMsg_CantFocus back to
  // the renderer.
  IPC_MESSAGE_ROUTED0(ViewMsg_CantFocus)
  
  // Instructs the renderer to invoke the frame's shouldClose method, which
  // runs the onbeforeunload event handler.  Expects the result to be returned
  // via ViewHostMsg_ShouldClose.
  IPC_MESSAGE_ROUTED0(ViewMsg_ShouldClose)
  
  // Instructs the renderer to swap out for a cross-site transition, including
  // running the unload event handler. Expects a SwapOut_ACK message when
  // finished.
  IPC_MESSAGE_ROUTED0(ViewMsg_SwapOut)
  
  // Instructs the renderer to close the current page, including running the
  // onunload event handler.
  //
  // Expects a ClosePage_ACK message when finished.
  IPC_MESSAGE_ROUTED0(ViewMsg_ClosePage)
  
  // Notifies the renderer about ui theme changes
  IPC_MESSAGE_ROUTED0(ViewMsg_ThemeChanged)
  
  // Notifies the renderer that a paint is to be generated for the rectangle
  // passed in.
  IPC_MESSAGE_ROUTED1(ViewMsg_Repaint,
                      gfx::Size /* The view size to be repainted */)
  
  // Notification that a move or resize renderer's containing window has
  // started.
  IPC_MESSAGE_ROUTED0(ViewMsg_MoveOrResizeStarted)
  
  IPC_MESSAGE_ROUTED2(ViewMsg_UpdateScreenRects,
                      gfx::Rect /* view_screen_rect */,
                      gfx::Rect /* window_screen_rect */)
  
  // Reply to ViewHostMsg_RequestMove, ViewHostMsg_ShowView, and
  // ViewHostMsg_ShowWidget to inform the renderer that the browser has
  // processed the move.  The browser may have ignored the move, but it finished
  // processing.  This is used because the renderer keeps a temporary cache of
  // the widget position while these asynchronous operations are in progress.
  IPC_MESSAGE_ROUTED0(ViewMsg_Move_ACK)
  
  // Used to instruct the RenderView to send back updates to the preferred size.
  IPC_MESSAGE_ROUTED0(ViewMsg_EnablePreferredSizeChangedMode)
  
  // Used to instruct the RenderView to automatically resize and send back
  // updates for the new size.
  IPC_MESSAGE_ROUTED2(ViewMsg_EnableAutoResize,
                      gfx::Size /* min_size */,
                      gfx::Size /* max_size */)
  
  // Used to instruct the RenderView to disalbe automatically resize.
  IPC_MESSAGE_ROUTED1(ViewMsg_DisableAutoResize,
                      gfx::Size /* new_size */)
  
  // Changes the text direction of the currently selected input field (if any).
  IPC_MESSAGE_ROUTED1(ViewMsg_SetTextDirection,
                      WebKit::WebTextDirection /* direction */)
  
  // Tells the renderer to clear the focused node (if any).
  IPC_MESSAGE_ROUTED0(ViewMsg_ClearFocusedNode)
  
  // Make the RenderView transparent and render it onto a custom background. The
  // background will be tiled in both directions if it is not large enough.
  IPC_MESSAGE_ROUTED1(ViewMsg_SetBackground,
                      SkBitmap /* background */)
  
  // Used to tell the renderer not to add scrollbars with height and
  // width below a threshold.
  IPC_MESSAGE_ROUTED1(ViewMsg_DisableScrollbarsForSmallWindows,
                      gfx::Size /* disable_scrollbar_size_limit */)
  
  // Activate/deactivate the RenderView (i.e., set its controls' tint
  // accordingly, etc.).
  IPC_MESSAGE_ROUTED1(ViewMsg_SetActive,
                      bool /* active */)
  
  // Response message to ViewHostMsg_CreateShared/DedicatedWorker.
  // Sent when the worker has started.
  IPC_MESSAGE_ROUTED0(ViewMsg_WorkerCreated)
  
  // The response to ViewHostMsg_AsyncOpenPepperFile.
  IPC_MESSAGE_ROUTED2(ViewMsg_AsyncOpenPepperFile_ACK,
                      base::PlatformFileError /* error_code */,
                      IPC::PlatformFileForTransit /* file descriptor */)
  
  // Tells the renderer that the network state has changed and that
  // window.navigator.onLine should be updated for all WebViews.
  IPC_MESSAGE_CONTROL1(ViewMsg_NetworkStateChanged,
                       bool /* online */)
  
  // Reply to ViewHostMsg_OpenChannelToPpapiBroker
  // Tells the renderer that the channel to the broker has been created.
  IPC_MESSAGE_ROUTED2(ViewMsg_PpapiBrokerChannelCreated,
                      base::ProcessId /* broker_pid */,
                      IPC::ChannelHandle /* handle */)
  
  // Reply to ViewHostMsg_RequestPpapiBrokerPermission.
  // Tells the renderer whether permission to access to PPAPI broker was granted
  // or not.
  IPC_MESSAGE_ROUTED1(ViewMsg_PpapiBrokerPermissionResult,
                      bool /* result */)
  
  // Tells the renderer to empty its plugin list cache, optional reloading
  // pages containing plugins.
  IPC_MESSAGE_CONTROL1(ViewMsg_PurgePluginListCache,
                       bool /* reload_pages */)
  
  // Used to instruct the RenderView to go into "view source" mode.
  IPC_MESSAGE_ROUTED0(ViewMsg_EnableViewSourceMode)
  
  // Instructs the renderer to save the current page to MHTML.
  IPC_MESSAGE_ROUTED2(ViewMsg_SavePageAsMHTML,
                      int /* job_id */,
                      IPC::PlatformFileForTransit /* file handle */)
  
  // Temporary message to diagnose an unexpected condition in WebContentsImpl.
  IPC_MESSAGE_CONTROL1(ViewMsg_TempCrashWithData,
                       GURL /* data */)
  
  // Change the accessibility mode in the renderer process.
  IPC_MESSAGE_ROUTED1(ViewMsg_SetAccessibilityMode,
                      AccessibilityMode)
  
  // An acknowledge to ViewHostMsg_MultipleTargetsTouched to notify the renderer
  // process to release the magnified image.
  IPC_MESSAGE_ROUTED1(ViewMsg_ReleaseDisambiguationPopupDIB,
                      TransportDIB::Handle /* DIB handle */)
  
  // Notifies the renderer that a snapshot has been retrieved.
  IPC_MESSAGE_ROUTED3(ViewMsg_WindowSnapshotCompleted,
                      int /* snapshot_id */,
                      gfx::Size /* size */,
                      std::vector<unsigned char> /* png */)
  
  // Tells the renderer to suspend/resume the webkit timers.
  IPC_MESSAGE_CONTROL1(ViewMsg_SetWebKitSharedTimersSuspended,
                       bool /* suspend */)
  
  #if defined(OS_ANDROID)
  // Sent when the browser wants the bounding boxes of the current find matches.
  //
  // If match rects are already cached on the browser side, |current_version|
  // should be the version number from the ViewHostMsg_FindMatchRects_Reply
  // they came in, so the renderer can tell if it needs to send updated rects.
  // Otherwise just pass -1 to always receive the list of rects.
  //
  // There must be an active search string (it is probably most useful to call
  // this immediately after a ViewHostMsg_Find_Reply message arrives with
  // final_update set to true).
  IPC_MESSAGE_ROUTED1(ViewMsg_FindMatchRects,
                      int /* current_version */)
  
  // External popup menus.
  IPC_MESSAGE_ROUTED2(ViewMsg_SelectPopupMenuItems,
                      bool /* user canceled the popup */,
                      std::vector<int> /* selected indices */)
  
  // Tells the renderer to try to revert to the zoom level we were at before
  // ViewMsg_ScrollFocusedEditableNodeIntoView was called.
  IPC_MESSAGE_ROUTED0(ViewMsg_UndoScrollFocusedEditableNodeIntoView)
  
  // Notifies the renderer whether hiding/showing the top controls is enabled
  // and whether or not to animate to the proper state.
  IPC_MESSAGE_ROUTED3(ViewMsg_UpdateTopControlsState,
                      bool /* enable_hiding */,
                      bool /* enable_showing */,
                      bool /* animate */)
  
  IPC_MESSAGE_ROUTED0(ViewMsg_ShowImeIfNeeded)
  
  // Sent by the browser when the renderer should generate a new frame.
  IPC_MESSAGE_ROUTED1(ViewMsg_BeginFrame,
                      cc::BeginFrameArgs /* args */)
  
  // Sent by the browser when an IME update that requires acknowledgement has been
  // processed on the browser side.
  IPC_MESSAGE_ROUTED0(ViewMsg_ImeEventAck)
  
  // Sent by the browser when we should pause video playback.
  IPC_MESSAGE_ROUTED0(ViewMsg_PauseVideo);
  
  #elif defined(OS_MACOSX)
  // Let the RenderView know its window has changed visibility.
  IPC_MESSAGE_ROUTED1(ViewMsg_SetWindowVisibility,
                      bool /* visibile */)
  
  // Let the RenderView know its window's frame has changed.
  IPC_MESSAGE_ROUTED2(ViewMsg_WindowFrameChanged,
                      gfx::Rect /* window frame */,
                      gfx::Rect /* content view frame */)
  
  // Message sent from the browser to the renderer when the user starts or stops
  // resizing the view.
  IPC_MESSAGE_ROUTED1(ViewMsg_SetInLiveResize,
                      bool /* enable */)
  
  // Tell the renderer that plugin IME has completed.
  IPC_MESSAGE_ROUTED2(ViewMsg_PluginImeCompositionCompleted,
                      string16 /* text */,
                      int /* plugin_id */)
  
  // External popup menus.
  IPC_MESSAGE_ROUTED1(ViewMsg_SelectPopupMenuItem,
                      int /* selected index, -1 means no selection */)
  #endif
  
  // Sent by the browser as a reply to ViewHostMsg_SwapCompositorFrame.
  IPC_MESSAGE_ROUTED2(ViewMsg_SwapCompositorFrameAck,
                      uint32 /* output_surface_id */,
                      cc::CompositorFrameAck /* ack */)
  
  // Sent by browser to tell renderer compositor that some resources that were
  // given to the browser in a swap are not being used anymore.
  IPC_MESSAGE_ROUTED2(ViewMsg_ReclaimCompositorResources,
                      uint32 /* output_surface_id */,
                      cc::CompositorFrameAck /* ack */)
  
  // Sent by the browser to ask the renderer for a snapshot of the current view.
  IPC_MESSAGE_ROUTED1(ViewMsg_Snapshot,
                      gfx::Rect /* src_subrect */)
  
  // -----------------------------------------------------------------------------
  // Messages sent from the renderer to the browser.
  
  // Sent by the renderer when it is creating a new window.  The browser creates
  // a tab for it and responds with a ViewMsg_CreatingNew_ACK.  If route_id is
  // MSG_ROUTING_NONE, the view couldn't be created.
  IPC_SYNC_MESSAGE_CONTROL1_4(ViewHostMsg_CreateWindow,
                              ViewHostMsg_CreateWindow_Params,
                              int /* route_id */,
                              int /* main_frame_route_id */,
                              int32 /* surface_id */,
                              int64 /* cloned_session_storage_namespace_id */)
  
  // Similar to ViewHostMsg_CreateWindow, except used for sub-widgets, like
  // <select> dropdowns.  This message is sent to the WebContentsImpl that
  // contains the widget being created.
  IPC_SYNC_MESSAGE_CONTROL2_2(ViewHostMsg_CreateWidget,
                              int /* opener_id */,
                              WebKit::WebPopupType /* popup type */,
                              int /* route_id */,
                              int32 /* surface_id */)
  
  // Similar to ViewHostMsg_CreateWidget except the widget is a full screen
  // window.
  IPC_SYNC_MESSAGE_CONTROL1_2(ViewHostMsg_CreateFullscreenWidget,
                              int /* opener_id */,
                              int /* route_id */,
                              int32 /* surface_id */)
  
  // Asks the browser for a unique routing ID.
  IPC_SYNC_MESSAGE_CONTROL0_1(ViewHostMsg_GenerateRoutingID,
                              int /* routing_id */)
  
  // Asks the browser for the default audio hardware configuration.
  IPC_SYNC_MESSAGE_CONTROL0_2(ViewHostMsg_GetAudioHardwareConfig,
                              media::AudioParameters /* input parameters */,
                              media::AudioParameters /* output parameters */)
  
  // Asks the browser for CPU usage of the renderer process in percents.
  IPC_SYNC_MESSAGE_CONTROL0_1(ViewHostMsg_GetCPUUsage,
                              int /* CPU usage in percents */)
  
  // Asks the browser for the user's monitor profile.
  IPC_SYNC_MESSAGE_CONTROL0_1(ViewHostMsg_GetMonitorColorProfile,
                              std::vector<char> /* profile */)
  
  // Asks the browser for the renderer process memory size stats.
  IPC_SYNC_MESSAGE_CONTROL0_2(ViewHostMsg_GetProcessMemorySizes,
                              size_t /* private_bytes */,
                              size_t /* shared_bytes */)
  
  // These three messages are sent to the parent RenderViewHost to display the
  // page/widget that was created by
  // CreateWindow/CreateWidget/CreateFullscreenWidget. routing_id
  // refers to the id that was returned from the Create message above.
  // The initial_position parameter is a rectangle in screen coordinates.
  //
  // FUTURE: there will probably be flags here to control if the result is
  // in a new window.
  IPC_MESSAGE_ROUTED4(ViewHostMsg_ShowView,
                      int /* route_id */,
                      WindowOpenDisposition /* disposition */,
                      gfx::Rect /* initial_pos */,
                      bool /* opened_by_user_gesture */)
  
  IPC_MESSAGE_ROUTED2(ViewHostMsg_ShowWidget,
                      int /* route_id */,
                      gfx::Rect /* initial_pos */)
  
  // Message to show a full screen widget.
  IPC_MESSAGE_ROUTED1(ViewHostMsg_ShowFullscreenWidget,
                      int /* route_id */)
  
  // This message is sent after ViewHostMsg_ShowView to cause the RenderView
  // to run in a modal fashion until it is closed.
  IPC_SYNC_MESSAGE_ROUTED1_0(ViewHostMsg_RunModal,
                             int /* opener_id */)
  
  // Indicates the renderer is ready in response to a ViewMsg_New or
  // a ViewMsg_CreatingNew_ACK.
  IPC_MESSAGE_ROUTED0(ViewHostMsg_RenderViewReady)
  
  // Indicates the renderer process is gone.  This actually is sent by the
  // browser process to itself, but keeps the interface cleaner.
  IPC_MESSAGE_ROUTED2(ViewHostMsg_RenderProcessGone,
                      int, /* this really is base::TerminationStatus */
                      int /* exit_code */)
  
  // Sent by the renderer process to request that the browser close the view.
  // This corresponds to the window.close() API, and the browser may ignore
  // this message.  Otherwise, the browser will generates a ViewMsg_Close
  // message to close the view.
  IPC_MESSAGE_ROUTED0(ViewHostMsg_Close)
  
  // Send in response to a ViewMsg_UpdateScreenRects so that the renderer can
  // throttle these messages.
  IPC_MESSAGE_ROUTED0(ViewHostMsg_UpdateScreenRects_ACK)
  
  // Sent by the renderer process to request that the browser move the view.
  // This corresponds to the window.resizeTo() and window.moveTo() APIs, and
  // the browser may ignore this message.
  IPC_MESSAGE_ROUTED1(ViewHostMsg_RequestMove,
                      gfx::Rect /* position */)
  
  // Notifies the browser that a frame in the view has changed. This message
  // has a lot of parameters and is packed/unpacked by functions defined in
  // render_messages.h.
  IPC_MESSAGE_ROUTED1(ViewHostMsg_FrameNavigate,
                      ViewHostMsg_FrameNavigate_Params)
  
  // Used to tell the parent that the user right clicked on an area of the
  // content area, and a context menu should be shown for it. The params
  // object contains information about the node(s) that were selected when the
  // user right clicked.
  IPC_MESSAGE_ROUTED1(ViewHostMsg_ContextMenu, content::ContextMenuParams)
  
  // Message to show a popup menu using native cocoa controls (Mac only).
  IPC_MESSAGE_ROUTED1(ViewHostMsg_ShowPopup,
                      ViewHostMsg_ShowPopup_Params)
  
  // Response from ViewMsg_ScriptEvalRequest. The ID is the parameter supplied
  // to ViewMsg_ScriptEvalRequest. The result has the value returned by the
  // script as its only element, one of Null, Boolean, Integer, Real, Date, or
  // String.
  IPC_MESSAGE_ROUTED2(ViewHostMsg_ScriptEvalResponse,
                      int  /* id */,
                      base::ListValue  /* result */)
  
  // Result of string search in the page.
  // Response to ViewMsg_Find with the results of the requested find-in-page
  // search, the number of matches found and the selection rect (in screen
  // coordinates) for the string found. If |final_update| is false, it signals
  // that this is not the last Find_Reply message - more will be sent as the
  // scoping effort continues.
  IPC_MESSAGE_ROUTED5(ViewHostMsg_Find_Reply,
                      int /* request_id */,
                      int /* number of matches */,
                      gfx::Rect /* selection_rect */,
                      int /* active_match_ordinal */,
                      bool /* final_update */)
  
  // Provides the result from running OnMsgShouldClose.  |proceed| matches the
  // return value of the the frame's shouldClose method (which includes the
  // onbeforeunload handler): true if the user decided to proceed with leaving
  // the page.
  IPC_MESSAGE_ROUTED3(ViewHostMsg_ShouldClose_ACK,
                      bool /* proceed */,
                      base::TimeTicks /* before_unload_start_time */,
                      base::TimeTicks /* before_unload_end_time */)
  
  // Indicates that the current renderer has swapped out, after a SwapOut
  // message.
  IPC_MESSAGE_ROUTED0(ViewHostMsg_SwapOut_ACK)
  
  // Indicates that the current page has been closed, after a ClosePage
  // message.
  IPC_MESSAGE_ROUTED0(ViewHostMsg_ClosePage_ACK)
  
  // Notifies the browser that media has started/stopped playing.
  IPC_MESSAGE_ROUTED4(ViewHostMsg_MediaNotification,
                      int64 /* player_cookie, distinguishes instances */,
                      bool /* has_video */,
                      bool /* has_audio */,
                      bool /* is_playing */)
  
  // Notifies the browser that we have session history information.
  // page_id: unique ID that allows us to distinguish between history entries.
  IPC_MESSAGE_ROUTED2(ViewHostMsg_UpdateState,
                      int32 /* page_id */,
                      content::PageState /* state */)
  
  // Notifies the browser that a document has been loaded in a frame.
  IPC_MESSAGE_ROUTED1(ViewHostMsg_DocumentLoadedInFrame,
                      int64 /* frame_id */)
  
  // Notifies the browser that a frame finished loading.
  IPC_MESSAGE_ROUTED3(ViewHostMsg_DidFinishLoad,
                      int64 /* frame_id */,
                      GURL /* validated_url */,
                      bool /* is_main_frame */)
  
  // Changes the title for the page in the UI when the page is navigated or the
  // title changes.
  IPC_MESSAGE_ROUTED3(ViewHostMsg_UpdateTitle,
                      int32 /* page_id */,
                      string16 /* title */,
                      WebKit::WebTextDirection /* title direction */)
  
  // Change the encoding name of the page in UI when the page has detected
  // proper encoding name.
  IPC_MESSAGE_ROUTED1(ViewHostMsg_UpdateEncoding,
                      std::string /* new encoding name */)
  
  // Notifies the browser that we want to show a destination url for a potential
  // action (e.g. when the user is hovering over a link).
  IPC_MESSAGE_ROUTED2(ViewHostMsg_UpdateTargetURL,
                      int32,
                      GURL)
  
  // Sent when the renderer starts loading the page. This corresponds to
  // WebKit's notion of the throbber starting. Note that sometimes you may get
  // duplicates of these during a single load.
  IPC_MESSAGE_ROUTED0(ViewHostMsg_DidStartLoading)
  
  // Sent when the renderer is done loading a page. This corresponds to WebKit's
  // notion of the throbber stopping.
  IPC_MESSAGE_ROUTED0(ViewHostMsg_DidStopLoading)
  
  // Sent when the renderer main frame has made progress loading.
  IPC_MESSAGE_ROUTED1(ViewHostMsg_DidChangeLoadProgress,
                      double /* load_progress */)
  
  // Sent when the renderer main frame sets its opener to null, disowning it for
  // the lifetime of the window.
  IPC_MESSAGE_ROUTED0(ViewHostMsg_DidDisownOpener)
  
  // Sent when the document element is available for the top-level frame.  This
  // happens after the page starts loading, but before all resources are
  // finished.
  IPC_MESSAGE_ROUTED0(ViewHostMsg_DocumentAvailableInMainFrame)
  
  // Sent when after the onload handler has been invoked for the document
  // in the top-level frame.
  IPC_MESSAGE_ROUTED1(ViewHostMsg_DocumentOnLoadCompletedInMainFrame,
                      int32 /* page_id */)
  
  // Sent when the renderer loads a resource from its memory cache.
  // The security info is non empty if the resource was originally loaded over
  // a secure connection.
  // Note: May only be sent once per URL per frame per committed load.
  IPC_MESSAGE_ROUTED5(ViewHostMsg_DidLoadResourceFromMemoryCache,
                      GURL /* url */,
                      std::string  /* security info */,
                      std::string  /* http method */,
                      std::string  /* mime type */,
                      ResourceType::Type /* resource type */)
  
  // Sent when the renderer displays insecure content in a secure page.
  IPC_MESSAGE_ROUTED0(ViewHostMsg_DidDisplayInsecureContent)
  
  // Sent when the renderer runs insecure content in a secure origin.
  IPC_MESSAGE_ROUTED2(ViewHostMsg_DidRunInsecureContent,
                      std::string  /* security_origin */,
                      GURL         /* target URL */)
  
  IPC_MESSAGE_ROUTED5(ViewHostMsg_DidFailLoadWithError,
                      int64 /* frame_id */,
                      GURL /* validated_url */,
                      bool /* is_main_frame */,
                      int /* error_code */,
                      string16 /* error_description */)
  
  // Sent when the renderer fails a provisional load with an error.
  IPC_MESSAGE_ROUTED1(ViewHostMsg_DidFailProvisionalLoadWithError,
                      ViewHostMsg_DidFailProvisionalLoadWithError_Params)
  
  // Tells the render view that a ViewHostMsg_PaintAtSize message was
  // processed, and the DIB is ready for use. |tag| has the same value that
  // the tag sent along with ViewMsg_PaintAtSize.
  IPC_MESSAGE_ROUTED2(ViewHostMsg_PaintAtSize_ACK,
                      int /* tag */,
                      gfx::Size /* size */)
  
  // Sent to update part of the view.  In response to this message, the host
  // generates a ViewMsg_UpdateRect_ACK message.
  IPC_MESSAGE_ROUTED1(ViewHostMsg_UpdateRect,
                      ViewHostMsg_UpdateRect_Params)
  
  // Sent to unblock the browser's UI thread if it is waiting on an UpdateRect,
  // which may get delayed until the browser's UI unblocks.
  IPC_MESSAGE_ROUTED0(ViewHostMsg_UpdateIsDelayed)
  
  // Sent by the renderer when accelerated compositing is enabled or disabled to
  // notify the browser whether or not is should do painting.
  IPC_MESSAGE_ROUTED1(ViewHostMsg_DidActivateAcceleratedCompositing,
                      bool /* true if the accelerated compositor is actve */)
  
  IPC_STRUCT_BEGIN(ViewHostMsg_BeginSmoothScroll_Params)
    IPC_STRUCT_MEMBER(bool, scroll_down)
    IPC_STRUCT_MEMBER(int32, pixels_to_scroll)
    IPC_STRUCT_MEMBER(int32, mouse_event_x)
    IPC_STRUCT_MEMBER(int32, mouse_event_y)
  IPC_STRUCT_END()
  
  IPC_MESSAGE_ROUTED1(ViewHostMsg_BeginSmoothScroll,
                      ViewHostMsg_BeginSmoothScroll_Params /* params */)
  
  IPC_STRUCT_BEGIN(ViewHostMsg_BeginPinch_Params)
    IPC_STRUCT_MEMBER(bool, zoom_in)
    IPC_STRUCT_MEMBER(int32, pixels_to_move)
    IPC_STRUCT_MEMBER(int32, anchor_x)
    IPC_STRUCT_MEMBER(int32, anchor_y)
  IPC_STRUCT_END()
  
  IPC_MESSAGE_ROUTED1(ViewHostMsg_BeginPinch,
                      ViewHostMsg_BeginPinch_Params /* params */)
  
  IPC_MESSAGE_ROUTED0(ViewHostMsg_Focus)
  IPC_MESSAGE_ROUTED0(ViewHostMsg_Blur)
  
  // Message sent from renderer to the browser when focus changes inside the
  // webpage. The parameter says whether the newly focused element needs
  // keyboard input (true for textfields, text areas and content editable divs).
  IPC_MESSAGE_ROUTED1(ViewHostMsg_FocusedNodeChanged,
      bool /* is_editable_node */)
  
  IPC_MESSAGE_ROUTED1(ViewHostMsg_SetCursor,
                      WebCursor)
  
  // Used to set a cookie. The cookie is set asynchronously, but will be
  // available to a subsequent ViewHostMsg_GetCookies request.
  IPC_MESSAGE_ROUTED3(ViewHostMsg_SetCookie,
                      GURL /* url */,
                      GURL /* first_party_for_cookies */,
                      std::string /* cookie */)
  
  // Used to get cookies for the given URL. This may block waiting for a
  // previous SetCookie message to be processed.
  IPC_SYNC_MESSAGE_ROUTED2_1(ViewHostMsg_GetCookies,
                             GURL /* url */,
                             GURL /* first_party_for_cookies */,
                             std::string /* cookies */)
  
  // Used to get raw cookie information for the given URL. This may block
  // waiting for a previous SetCookie message to be processed.
  IPC_SYNC_MESSAGE_CONTROL2_1(ViewHostMsg_GetRawCookies,
                              GURL /* url */,
                              GURL /* first_party_for_cookies */,
                              std::vector<content::CookieData>
                                  /* raw_cookies */)
  
  // Used to delete cookie for the given URL and name
  IPC_SYNC_MESSAGE_CONTROL2_0(ViewHostMsg_DeleteCookie,
                              GURL /* url */,
                              std::string /* cookie_name */)
  
  // Used to check if cookies are enabled for the given URL. This may block
  // waiting for a previous SetCookie message to be processed.
  IPC_SYNC_MESSAGE_CONTROL2_1(ViewHostMsg_CookiesEnabled,
                              GURL /* url */,
                              GURL /* first_party_for_cookies */,
                              bool /* cookies_enabled */)
  
  // Used to get the list of plugins
  IPC_SYNC_MESSAGE_CONTROL1_1(ViewHostMsg_GetPlugins,
      bool /* refresh*/,
      std::vector<content::WebPluginInfo> /* plugins */)
  
  // Return information about a plugin for the given URL and MIME
  // type. If there is no matching plugin, |found| is false.
  // |actual_mime_type| is the actual mime type supported by the
  // found plugin.
  IPC_SYNC_MESSAGE_CONTROL4_3(ViewHostMsg_GetPluginInfo,
                              int /* routing_id */,
                              GURL /* url */,
                              GURL /* page_url */,
                              std::string /* mime_type */,
                              bool /* found */,
                              content::WebPluginInfo /* plugin info */,
                              std::string /* actual_mime_type */)
  
  // A renderer sends this to the browser process when it wants to
  // create a plugin.  The browser will create the plugin process if
  // necessary, and will return a handle to the channel on success.
  // On error an empty string is returned.
  IPC_SYNC_MESSAGE_CONTROL4_2(ViewHostMsg_OpenChannelToPlugin,
                              int /* routing_id */,
                              GURL /* url */,
                              GURL /* page_url */,
                              std::string /* mime_type */,
                              IPC::ChannelHandle /* channel_handle */,
                              content::WebPluginInfo /* info */)
  
  #if defined(OS_WIN)
  IPC_MESSAGE_ROUTED1(ViewHostMsg_WindowlessPluginDummyWindowCreated,
                      gfx::NativeViewId /* dummy_activation_window */)
  
  IPC_MESSAGE_ROUTED1(ViewHostMsg_WindowlessPluginDummyWindowDestroyed,
                      gfx::NativeViewId /* dummy_activation_window */)
  #endif
  
  // Get the list of proxies to use for |url|, as a semicolon delimited list
  // of "<TYPE> <HOST>:<PORT>" | "DIRECT".
  IPC_SYNC_MESSAGE_CONTROL1_2(ViewHostMsg_ResolveProxy,
                              GURL /* url */,
                              bool /* result */,
                              std::string /* proxy list */)
  
  // A renderer sends this to the browser process when it wants to create a
  // worker.  The browser will create the worker process if necessary, and
  // will return the route id on success.  On error returns MSG_ROUTING_NONE.
  IPC_SYNC_MESSAGE_CONTROL1_1(ViewHostMsg_CreateWorker,
                              ViewHostMsg_CreateWorker_Params,
                              int /* route_id */)
  
  // This message is sent to the browser to see if an instance of this shared
  // worker already exists. If so, it returns exists == true. If a
  // non-empty name is passed, also validates that the url matches the url of
  // the existing worker. If a matching worker is found, the passed-in
  // document_id is associated with that worker, to ensure that the worker
  // stays alive until the document is detached.
  // The route_id returned can be used to forward messages to the worker via
  // ForwardToWorker if it exists, otherwise it should be passed in to any
  // future call to CreateWorker to avoid creating duplicate workers.
  IPC_SYNC_MESSAGE_CONTROL1_3(ViewHostMsg_LookupSharedWorker,
                              ViewHostMsg_CreateWorker_Params,
                              bool /* exists */,
                              int /* route_id */,
                              bool /* url_mismatch */)
  
  // A renderer sends this to the browser process when a document has been
  // detached. The browser will use this to constrain the lifecycle of worker
  // processes (SharedWorkers are shut down when their last associated document
  // is detached).
  IPC_MESSAGE_CONTROL1(ViewHostMsg_DocumentDetached,
                       uint64 /* document_id */)
  
  // Wraps an IPC message that's destined to the worker on the renderer->browser
  // hop.
  IPC_MESSAGE_CONTROL1(ViewHostMsg_ForwardToWorker,
                       IPC::Message /* message */)
  
  // Tells the browser that a specific Appcache manifest in the current page
  // was accessed.
  IPC_MESSAGE_ROUTED2(ViewHostMsg_AppCacheAccessed,
                      GURL /* manifest url */,
                      bool /* blocked by policy */)
  
  // Initiates a download based on user actions like 'ALT+click'.
  IPC_MESSAGE_ROUTED3(ViewHostMsg_DownloadUrl,
                      GURL     /* url */,
                      content::Referrer /* referrer */,
                      string16 /* suggested_name */)
  
  // Used to go to the session history entry at the given offset (ie, -1 will
  // return the "back" item).
  IPC_MESSAGE_ROUTED1(ViewHostMsg_GoToEntryAtOffset,
                      int /* offset (from current) of history item to get */)
  
  // Sent from an inactive renderer for the browser to route to the active
  // renderer, instructing it to close.
  IPC_MESSAGE_ROUTED0(ViewHostMsg_RouteCloseEvent)
  
  // Sent to the browser from an inactive renderer to post a message to the
  // active renderer.
  IPC_MESSAGE_ROUTED1(ViewHostMsg_RouteMessageEvent,
                      ViewMsg_PostMessage_Params)
  
  IPC_SYNC_MESSAGE_ROUTED4_2(ViewHostMsg_RunJavaScriptMessage,
                             string16     /* in - alert message */,
                             string16     /* in - default prompt */,
                             GURL         /* in - originating page URL */,
                             content::JavaScriptMessageType /* in - type */,
                             bool         /* out - success */,
                             string16     /* out - user_input field */)
  
  // Requests that the given URL be opened in the specified manner.
  IPC_MESSAGE_ROUTED1(ViewHostMsg_OpenURL, ViewHostMsg_OpenURL_Params)
  
  // Notifies that the preferred size of the content changed.
  IPC_MESSAGE_ROUTED1(ViewHostMsg_DidContentsPreferredSizeChange,
                      gfx::Size /* pref_size */)
  
  // Notifies that the scroll offset changed.
  // This is different from ViewHostMsg_UpdateRect in that ViewHostMsg_UpdateRect
  // is not sent at all when threaded compositing is enabled while
  // ViewHostMsg_DidChangeScrollOffset works properly in this case.
  IPC_MESSAGE_ROUTED0(ViewHostMsg_DidChangeScrollOffset)
  
  // Notifies that the pinned-to-side state of the content changed.
  IPC_MESSAGE_ROUTED2(ViewHostMsg_DidChangeScrollOffsetPinningForMainFrame,
                      bool /* pinned_to_left */,
                      bool /* pinned_to_right */)
  
  // Notifies that the scrollbars-visible state of the content changed.
  IPC_MESSAGE_ROUTED2(ViewHostMsg_DidChangeScrollbarsForMainFrame,
                      bool /* has_horizontal_scrollbar */,
                      bool /* has_vertical_scrollbar */)
  
  // Notifies that the number of JavaScript scroll handlers changed.
  IPC_MESSAGE_ROUTED1(ViewHostMsg_DidChangeNumWheelEvents,
                      int /* count */)
  
  // Notifies whether there are JavaScript touch event handlers or not.
  IPC_MESSAGE_ROUTED1(ViewHostMsg_HasTouchEventHandlers,
                      bool /* has_handlers */)
  
  // A message from HTML-based UI.  When (trusted) Javascript calls
  // send(message, args), this message is sent to the browser.
  IPC_MESSAGE_ROUTED3(ViewHostMsg_WebUISend,
                      GURL /* source_url */,
                      std::string  /* message */,
                      base::ListValue /* args */)
  
  // A renderer sends this to the browser process when it wants to create a ppapi
  // plugin.  The browser will create the plugin process if necessary, and will
  // return a handle to the channel on success.
  //
  // The plugin_child_id is the ChildProcessHost ID assigned in the browser
  // process. This ID is valid only in the context of the browser process and is
  // used to identify the proper process when the renderer notifies it that the
  // plugin is hung.
  //
  // On error an empty string and null handles are returned.
  IPC_SYNC_MESSAGE_CONTROL1_3(ViewHostMsg_OpenChannelToPepperPlugin,
                              base::FilePath /* path */,
                              IPC::ChannelHandle /* handle to channel */,
                              base::ProcessId /* plugin_pid */,
                              int /* plugin_child_id */)
  
  // Notification that a plugin has created a new plugin instance. The parameters
  // indicate:
  // -The plugin process ID that we're creating the instance for.
  // -The instance ID of the instance being created.
  // -A PepperRendererInstanceData struct which contains properties from the
  // renderer which are associated with the plugin instance. This includes the
  // routing ID of the associated render view and the URL of plugin.
  // -Whether the plugin we're creating an instance for is external or internal.
  //
  // This message must be sync even though it returns no parameters to avoid
  // a race condition with the plugin process. The plugin process sends messages
  // to the browser that assume the browser knows about the instance. We need to
  // make sure that the browser actually knows about the instance before we tell
  // the plugin to run.
  IPC_SYNC_MESSAGE_CONTROL4_0(
      ViewHostMsg_DidCreateOutOfProcessPepperInstance,
      int /* plugin_child_id */,
      int32 /* pp_instance */,
      content::PepperRendererInstanceData /* creation_data */,
      bool /* is_external */)
  
  // Notification that a plugin has destroyed an instance. This is the opposite of
  // the "DidCreate" message above.
  IPC_MESSAGE_CONTROL3(ViewHostMsg_DidDeleteOutOfProcessPepperInstance,
                       int /* plugin_child_id */,
                       int32 /* pp_instance */,
                       bool /* is_external */)
  
  // Message from the renderer to the browser indicating the in-process instance
  // has been created.
  IPC_MESSAGE_CONTROL2(ViewHostMsg_DidCreateInProcessInstance,
                       int32 /* instance */,
                       content::PepperRendererInstanceData /* instance_data */)
  
  // Message from the renderer to the browser indicating the in-process instance
  // has been destroyed.
  IPC_MESSAGE_CONTROL1(ViewHostMsg_DidDeleteInProcessInstance,
                       int32 /* instance */)
  
  // A renderer sends this to the browser process when it wants to
  // create a ppapi broker.  The browser will create the broker process
  // if necessary, and will return a handle to the channel on success.
  // On error an empty string is returned.
  // The browser will respond with ViewMsg_PpapiBrokerChannelCreated.
  IPC_MESSAGE_CONTROL2(ViewHostMsg_OpenChannelToPpapiBroker,
                       int /* routing_id */,
                       base::FilePath /* path */)
  
  // Opens a Pepper file asynchronously. The response returns a file descriptor
  // and an error code from base/platform_file.h.
  IPC_MESSAGE_CONTROL3(ViewHostMsg_AsyncOpenPepperFile,
                       int /* routing_id */,
                       base::FilePath /* file path */,
                       int /* pp_open_flags */)
  
  // A renderer sends this to the browser process when it wants to access a PPAPI
  // broker. In contrast to ViewHostMsg_OpenChannelToPpapiBroker, this is called
  // for every connection.
  // The browser will respond with ViewMsg_PpapiBrokerPermissionResult.
  IPC_MESSAGE_ROUTED3(ViewHostMsg_RequestPpapiBrokerPermission,
                      int /* routing_id */,
                      GURL /* document_url */,
                      base::FilePath /* plugin_path */)
  
  #if defined(USE_X11)
  // A renderer sends this when it needs a browser-side widget for
  // hosting a windowed plugin. id is the XID of the plugin window, for which
  // the container is created.
  IPC_SYNC_MESSAGE_ROUTED1_0(ViewHostMsg_CreatePluginContainer,
                             gfx::PluginWindowHandle /* id */)
  
  // Destroy a plugin container previously created using CreatePluginContainer.
  // id is the XID of the plugin window corresponding to the container that is
  // to be destroyed.
  IPC_SYNC_MESSAGE_ROUTED1_0(ViewHostMsg_DestroyPluginContainer,
                             gfx::PluginWindowHandle /* id */)
  #endif
  
  // Send the tooltip text for the current mouse position to the browser.
  IPC_MESSAGE_ROUTED2(ViewHostMsg_SetTooltipText,
                      string16 /* tooltip text string */,
                      WebKit::WebTextDirection /* text direction hint */)
  
  IPC_MESSAGE_ROUTED0(ViewHostMsg_SelectRange_ACK)
  IPC_MESSAGE_ROUTED0(ViewHostMsg_MoveCaret_ACK)
  
  // Notification that the text selection has changed.
  // Note: The secound parameter is the character based offset of the string16
  // text in the document.
  IPC_MESSAGE_ROUTED3(ViewHostMsg_SelectionChanged,
                      string16 /* text covers the selection range */,
                      size_t /* the offset of the text in the document */,
                      gfx::Range /* selection range in the document */)
  
  // Notification that the selection bounds have changed.
  IPC_MESSAGE_ROUTED1(ViewHostMsg_SelectionBoundsChanged,
                      ViewHostMsg_SelectionBounds_Params)
  
  // Asks the browser to open the color chooser.
  IPC_MESSAGE_ROUTED2(ViewHostMsg_OpenColorChooser,
                      int /* id */,
                      SkColor /* color */)
  
  // Asks the browser to end the color chooser.
  IPC_MESSAGE_ROUTED1(ViewHostMsg_EndColorChooser, int /* id */)
  
  // Change the selected color in the color chooser.
  IPC_MESSAGE_ROUTED2(ViewHostMsg_SetSelectedColorInColorChooser,
                      int /* id */,
                      SkColor /* color */)
  
  // Asks the browser to display the file chooser.  The result is returned in a
  // ViewHost_RunFileChooserResponse message.
  IPC_MESSAGE_ROUTED1(ViewHostMsg_RunFileChooser,
                      content::FileChooserParams)
  
  // Asks the browser to enumerate a directory.  This is equivalent to running
  // the file chooser in directory-enumeration mode and having the user select
  // the given directory.  The result is returned in a
  // ViewMsg_EnumerateDirectoryResponse message.
  IPC_MESSAGE_ROUTED2(ViewHostMsg_EnumerateDirectory,
                      int /* request_id */,
                      base::FilePath /* file_path */)
  
  // Tells the browser to move the focus to the next (previous if reverse is
  // true) focusable element.
  IPC_MESSAGE_ROUTED1(ViewHostMsg_TakeFocus,
                      bool /* reverse */)
  
  // Required for opening a date/time dialog
  IPC_MESSAGE_ROUTED1(ViewHostMsg_OpenDateTimeDialog,
                      ViewHostMsg_DateTimeDialogValue_Params /* value */)
  
  IPC_MESSAGE_ROUTED3(ViewHostMsg_TextInputTypeChanged,
                      ui::TextInputType /* TextInputType of the focused node */,
                      ui::TextInputMode /* TextInputMode of the focused node */,
                      bool /* can_compose_inline in the focused node */)
  
  // Required for updating text input state.
  IPC_MESSAGE_ROUTED1(ViewHostMsg_TextInputStateChanged,
                      ViewHostMsg_TextInputState_Params /* input state params */)
  
  // Required for cancelling an ongoing input method composition.
  IPC_MESSAGE_ROUTED0(ViewHostMsg_ImeCancelComposition)
  
  // WebKit and JavaScript error messages to log to the console
  // or debugger UI.
  IPC_MESSAGE_ROUTED4(ViewHostMsg_AddMessageToConsole,
                      int32, /* log level */
                      string16, /* msg */
                      int32, /* line number */
                      string16 /* source id */ )
  
  // Sent by the renderer process to indicate that a plugin instance has crashed.
  // Note: |plugin_pid| should not be trusted. The corresponding process has
  // probably died. Moreover, the ID may have been reused by a new process. Any
  // usage other than displaying it in a prompt to the user is very likely to be
  // wrong.
  IPC_MESSAGE_ROUTED2(ViewHostMsg_CrashedPlugin,
                      base::FilePath /* plugin_path */,
                      base::ProcessId /* plugin_pid */)
  
  // Displays a box to confirm that the user wants to navigate away from the
  // page. Replies true if yes, false otherwise, the reply string is ignored,
  // but is included so that we can use OnJavaScriptMessageBoxClosed.
  IPC_SYNC_MESSAGE_ROUTED3_2(ViewHostMsg_RunBeforeUnloadConfirm,
                             GURL,     /* in - originating frame URL */
                             string16  /* in - alert message */,
                             bool      /* in - is a reload */,
                             bool      /* out - success */,
                             string16  /* out - This is ignored.*/)
  
  // Sent when a provisional load on the main frame redirects.
  IPC_MESSAGE_ROUTED3(ViewHostMsg_DidRedirectProvisionalLoad,
                      int /* page_id */,
                      GURL /* last url */,
                      GURL /* url redirected to */)
  
  // Sent when the renderer changes the zoom level for a particular url, so the
  // browser can update its records.  If remember is true, then url is used to
  // update the zoom level for all pages in that site.  Otherwise, the render
  // view's id is used so that only the menu is updated.
  IPC_MESSAGE_ROUTED3(ViewHostMsg_DidZoomURL,
                      double /* zoom_level */,
                      bool /* remember */,
                      GURL /* url */)
  
  // Updates the minimum/maximum allowed zoom percent for this tab from the
  // default values.  If |remember| is true, then the zoom setting is applied to
  // other pages in the site and is saved, otherwise it only applies to this
  // tab.
  IPC_MESSAGE_ROUTED3(ViewHostMsg_UpdateZoomLimits,
                      int /* minimum_percent */,
                      int /* maximum_percent */,
                      bool /* remember */)
  
  // Notify the browser that this render process can or can't be suddenly
  // terminated.
  IPC_MESSAGE_CONTROL1(ViewHostMsg_SuddenTerminationChanged,
                       bool /* enabled */)
  
  // Informs the browser of updated frame names.
  IPC_MESSAGE_ROUTED3(ViewHostMsg_UpdateFrameName,
                      int /* frame_id */,
                      bool /* is_top_level */,
                      std::string /* name */)
  
  
  IPC_STRUCT_BEGIN(ViewHostMsg_CompositorSurfaceBuffersSwapped_Params)
    IPC_STRUCT_MEMBER(int32, surface_id)
    IPC_STRUCT_MEMBER(uint64, surface_handle)
    IPC_STRUCT_MEMBER(int32, route_id)
    IPC_STRUCT_MEMBER(gfx::Size, size)
    IPC_STRUCT_MEMBER(float, scale_factor)
    IPC_STRUCT_MEMBER(int32, gpu_process_host_id)
    IPC_STRUCT_MEMBER(ui::LatencyInfo, latency_info)
  IPC_STRUCT_END()
  
  // This message is synthesized by GpuProcessHost to pass through a swap message
  // to the RenderWidgetHelper. This allows GetBackingStore to block for either a
  // software or GPU frame.
  IPC_MESSAGE_ROUTED1(
      ViewHostMsg_CompositorSurfaceBuffersSwapped,
      ViewHostMsg_CompositorSurfaceBuffersSwapped_Params /* params */)
  
  IPC_MESSAGE_ROUTED2(ViewHostMsg_SwapCompositorFrame,
                      uint32 /* output_surface_id */,
                      cc::CompositorFrame /* frame */)
  
  // Sent by the compositor when input scroll events are dropped due to bounds
  // restricions on the root scroll offset.
  IPC_MESSAGE_ROUTED2(ViewHostMsg_DidOverscroll,
                      gfx::Vector2dF /* accumulated_overscroll */,
                      gfx::Vector2dF /* current_fling_velocity */)
  
  // Reply to a snapshot request containing whether snapshotting succeeded and the
  // SkBitmap if it succeeded.
  IPC_MESSAGE_ROUTED2(ViewHostMsg_Snapshot,
                      bool, /* success */
                      SkBitmap /* bitmap */)
  
  //---------------------------------------------------------------------------
  // Request for cryptographic operation messages:
  // These are messages from the renderer to the browser to perform a
  // cryptographic operation.
  
  // Asks the browser process to generate a keypair for grabbing a client
  // certificate from a CA (<keygen> tag), and returns the signed public
  // key and challenge string.
  IPC_SYNC_MESSAGE_CONTROL3_1(ViewHostMsg_Keygen,
                              uint32 /* key size index */,
                              std::string /* challenge string */,
                              GURL /* URL of requestor */,
                              std::string /* signed public key and challenge */)
  
  // Message sent from the renderer to the browser to request that the browser
  // cache |data| associated with |url|.
  IPC_MESSAGE_CONTROL3(ViewHostMsg_DidGenerateCacheableMetadata,
                       GURL /* url */,
                       double /* expected_response_time */,
                       std::vector<char> /* data */)
  
  // Displays a JavaScript out-of-memory message in the infobar.
  IPC_MESSAGE_ROUTED0(ViewHostMsg_JSOutOfMemory)
  
  // Register a new handler for URL requests with the given scheme.
  IPC_MESSAGE_ROUTED4(ViewHostMsg_RegisterProtocolHandler,
                      std::string /* scheme */,
                      GURL /* url */,
                      string16 /* title */,
                      bool /* user_gesture */)
  
  // Stores new inspector setting in the profile.
  // TODO(jam): this should be in the chrome module
  IPC_MESSAGE_ROUTED2(ViewHostMsg_UpdateInspectorSetting,
                      std::string,  /* key */
                      std::string /* value */)
  
  // Puts the browser into "tab fullscreen" mode for the sending renderer.
  // See the comment in chrome/browser/ui/browser.h for more details.
  IPC_MESSAGE_ROUTED1(ViewHostMsg_ToggleFullscreen,
                      bool /* enter_fullscreen */)
  
  // Send back a string to be recorded by UserMetrics.
  IPC_MESSAGE_CONTROL1(ViewHostMsg_UserMetricsRecordAction,
                       std::string /* action */)
  
  // Notifies the browser that the page was or was not saved as MHTML.
  IPC_MESSAGE_CONTROL2(ViewHostMsg_SavedPageAsMHTML,
                       int /* job_id */,
                       int64 /* size of the MHTML file, -1 if error */)
  
  IPC_MESSAGE_ROUTED3(ViewHostMsg_SendCurrentPageAllSavableResourceLinks,
                      std::vector<GURL> /* all savable resource links */,
                      std::vector<content::Referrer> /* all referrers */,
                      std::vector<GURL> /* all frame links */)
  
  IPC_MESSAGE_ROUTED3(ViewHostMsg_SendSerializedHtmlData,
                      GURL /* frame's url */,
                      std::string /* data buffer */,
                      int32 /* complete status */)
  
  // Notifies the browser of an event occurring in the media pipeline.
  IPC_MESSAGE_CONTROL1(ViewHostMsg_MediaLogEvents,
                       std::vector<media::MediaLogEvent> /* events */)
  
  // Requests to lock the mouse. Will result in a ViewMsg_LockMouse_ACK message
  // being sent back.
  // |privileged| is used by Pepper Flash. If this flag is set to true, we won't
  // pop up a bubble to ask for user permission or take mouse lock content into
  // account.
  IPC_MESSAGE_ROUTED3(ViewHostMsg_LockMouse,
                      bool /* user_gesture */,
                      bool /* last_unlocked_by_target */,
                      bool /* privileged */)
  
  // Requests to unlock the mouse. A ViewMsg_MouseLockLost message will be sent
  // whenever the mouse is unlocked (which may or may not be caused by
  // ViewHostMsg_UnlockMouse).
  IPC_MESSAGE_ROUTED0(ViewHostMsg_UnlockMouse)
  
  // Notifies that the initial empty document of a view has been accessed.
  // After this, it is no longer safe to show a pending navigation's URL without
  // making a URL spoof possible.
  IPC_MESSAGE_ROUTED0(ViewHostMsg_DidAccessInitialDocument)
  
  // Following message is used to communicate the values received by the
  // callback binding the JS to Cpp.
  // An instance of browser that has an automation host listening to it can
  // have a javascript send a native value (string, number, boolean) to the
  // listener in Cpp. (DomAutomationController)
  IPC_MESSAGE_ROUTED2(ViewHostMsg_DomOperationResponse,
                      std::string  /* json_string */,
                      int  /* automation_id */)
  
  // Sent to the browser when the renderer detects it is blocked on a pepper
  // plugin message for too long. This is also sent when it becomes unhung
  // (according to the value of is_hung). The browser can give the user the
  // option of killing the plugin.
  IPC_MESSAGE_ROUTED3(ViewHostMsg_PepperPluginHung,
                      int /* plugin_child_id */,
                      base::FilePath /* path */,
                      bool /* is_hung */)
  
  // Notifies that multiple touch targets may have been pressed, and to show
  // the disambiguation popup.
  IPC_MESSAGE_ROUTED3(ViewHostMsg_ShowDisambiguationPopup,
                      gfx::Rect, /* Border of touched targets */
                      gfx::Size, /* Size of zoomed image */
                      TransportDIB::Id /* DIB of zoomed image */)
  
  // Sent by the renderer process to check whether client 3D APIs
  // (Pepper 3D, WebGL) are explicitly blocked.
  IPC_SYNC_MESSAGE_CONTROL3_1(ViewHostMsg_Are3DAPIsBlocked,
                              int /* render_view_id */,
                              GURL /* top_origin_url */,
                              content::ThreeDAPIType /* requester */,
                              bool /* blocked */)
  
  // Sent by the renderer process to indicate that a context was lost by
  // client 3D content (Pepper 3D, WebGL) running on the page at the
  // given URL.
  IPC_MESSAGE_CONTROL3(ViewHostMsg_DidLose3DContext,
                       GURL /* top_origin_url */,
                       content::ThreeDAPIType /* context_type */,
                       int /* arb_robustness_status_code */)
  
  // Notifies the browser that document has parsed the body. This is used by the
  // ResourceScheduler as an indication that bandwidth contention won't block
  // first paint.
  IPC_MESSAGE_ROUTED0(ViewHostMsg_WillInsertBody)
  
  // Notification that the urls for the favicon of a site has been determined.
  IPC_MESSAGE_ROUTED2(ViewHostMsg_UpdateFaviconURL,
                      int32 /* page_id */,
                      std::vector<content::FaviconURL> /* candidates */)
  
  // Sent once a paint happens after the first non empty layout. In other words
  // after the page has painted something.
  IPC_MESSAGE_ROUTED1(ViewHostMsg_DidFirstVisuallyNonEmptyPaint,
                      int /* page_id */)
  
  #if defined(OS_ANDROID)
  // Response to ViewMsg_FindMatchRects.
  //
  // |version| will contain the current version number of the renderer's find
  // match list (incremented whenever they change), which should be passed in the
  // next call to ViewMsg_FindMatchRects.
  //
  // |rects| will either contain a list of the enclosing rects of all matches
  // found by the most recent Find operation, or will be empty if |version| is not
  // greater than the |current_version| passed to ViewMsg_FindMatchRects (hence
  // your locally cached rects should still be valid). The rect coords will be
  // custom normalized fractions of the document size. The rects will be sorted by
  // frame traversal order starting in the main frame, then by dom order.
  //
  // |active_rect| will contain the bounding box of the active find-in-page match
  // marker, in similarly normalized coords (or an empty rect if there isn't one).
  IPC_MESSAGE_ROUTED3(ViewHostMsg_FindMatchRects_Reply,
                      int /* version */,
                      std::vector<gfx::RectF> /* rects */,
                      gfx::RectF /* active_rect */)
  
  // Start an android intent with the given URI.
  IPC_MESSAGE_ROUTED1(ViewHostMsg_StartContentIntent,
                      GURL /* content_url */)
  
  // Message sent when the renderer changed the background color for the view.
  IPC_MESSAGE_ROUTED1(ViewHostMsg_DidChangeBodyBackgroundColor,
                      uint32  /* bg_color */)
  
  // This message runs the MediaCodec for decoding audio for webaudio.
  IPC_MESSAGE_CONTROL3(ViewHostMsg_RunWebAudioMediaCodec,
                       base::SharedMemoryHandle /* encoded_data_handle */,
                       base::FileDescriptor /* pcm_output */,
                       uint32_t /* data_size*/)
  
  // Sent by renderer to request a ViewMsg_BeginFrame message for upcoming
  // display events. If |enabled| is true, the BeginFrame message will continue
  // to be be delivered until the notification is disabled.
  IPC_MESSAGE_ROUTED1(ViewHostMsg_SetNeedsBeginFrame,
                      bool /* enabled */)
  
  // Sent by the renderer to the browser to start a vibration with the given
  // duration.
  IPC_MESSAGE_CONTROL1(ViewHostMsg_Vibrate,
                       int64 /* milliseconds */)
  
  // Sent by the renderer to the browser to cancel the currently running
  // vibration, if there is one.
  IPC_MESSAGE_CONTROL0(ViewHostMsg_CancelVibration)
  
  #elif defined(OS_MACOSX)
  // Request that the browser load a font into shared memory for us.
  IPC_SYNC_MESSAGE_CONTROL1_3(ViewHostMsg_LoadFont,
                             FontDescriptor /* font to load */,
                             uint32 /* buffer size */,
                             base::SharedMemoryHandle /* font data */,
                             uint32 /* font id */)
  
  // Informs the browser that a plugin has gained or lost focus.
  IPC_MESSAGE_ROUTED2(ViewHostMsg_PluginFocusChanged,
                      bool, /* focused */
                      int /* plugin_id */)
  
  // Instructs the browser to start plugin IME.
  IPC_MESSAGE_ROUTED0(ViewHostMsg_StartPluginIme)
  
  #elif defined(OS_WIN)
  // Request that the given font characters be loaded by the browser so it's
  // cached by the OS. Please see RenderMessageFilter::OnPreCacheFontCharacters
  // for details.
  IPC_SYNC_MESSAGE_CONTROL2_0(ViewHostMsg_PreCacheFontCharacters,
                              LOGFONT /* font_data */,
                              string16 /* characters */)
  #endif
  
  #if defined(OS_POSIX)
  // On POSIX, we cannot allocated shared memory from within the sandbox, so
  // this call exists for the renderer to ask the browser to allocate memory
  // on its behalf. We return a file descriptor to the POSIX shared memory.
  // If the |cache_in_browser| flag is |true|, then a copy of the shmem is kept
  // by the browser, and it is the caller's repsonsibility to send a
  // ViewHostMsg_FreeTransportDIB message in order to release the cached shmem.
  // In all cases, the caller is responsible for deleting the resulting
  // TransportDIB.
  IPC_SYNC_MESSAGE_CONTROL2_1(ViewHostMsg_AllocTransportDIB,
                              uint32_t, /* bytes requested */
                              bool, /* cache in the browser */
                              TransportDIB::Handle /* DIB */)
  
  // Since the browser keeps handles to the allocated transport DIBs, this
  // message is sent to tell the browser that it may release them when the
  // renderer is finished with them.
  IPC_MESSAGE_CONTROL1(ViewHostMsg_FreeTransportDIB,
                       TransportDIB::Id /* DIB id */)
  #endif
  
  #if defined(OS_MACOSX) || defined(OS_WIN) || defined(USE_AURA)
  // On MACOSX, WIN and AURA IME can request composition character bounds
  // synchronously (see crbug.com/120597). This IPC message sends the character
  // bounds after every composition change to always have correct bound info.
  IPC_MESSAGE_ROUTED2(ViewHostMsg_ImeCompositionRangeChanged,
                      gfx::Range /* composition range */,
                      std::vector<gfx::Rect> /* character bounds */)
  #endif
  
  // Adding a new message? Stick to the sort order above: first platform
  // independent ViewMsg, then ifdefs for platform specific ViewMsg, then platform
  // independent ViewHostMsg, then ifdefs for platform specific ViewHostMsg.
  