The Tor Browser: dom/ipc/PTabContext.ipdlh@6474c204b198

Cloned upstream origin tor-browser at tor-browser-31.3.0esr-4.5-1-build1
revision ID fc1c9ff7c1b2defdbc039f12214767608f46423f for hacking purpose.

     1 /* -*- Mode: C++; c-basic-offset: 4; indent-tabs-mode: nil; tab-width: 8 -*- */

     2 /* vim: set sw=4 ts=8 et tw=80 ft=cpp : */

     3 /* This Source Code Form is subject to the terms of the Mozilla Public

     4  * License, v. 2.0. If a copy of the MPL was not distributed with this

     5  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

     7 include protocol PBrowser;

    10 using mozilla::layout::ScrollingBehavior from "mozilla/layout/RenderFrameUtils.h";

    12 namespace mozilla {

    13 namespace dom {

    15 // An IPCTabContext which corresponds to a PBrowser opened by a child when it

    16 // receives window.open().

    17 //

    18 // If isBrowserElement is false, this PopupIPCTabContext corresponds to an app

    19 // frame, and the frame's app-id and app-frame-owner-app-id will be equal to the

    20 // opener's values.

    21 //

    22 // If isBrowserElement is true, the frame's browserFrameOwnerAppId will be equal

    23 // to the opener's app-id.

    24 //

    25 // It's an error to set isBrowserElement == false if opener is a browser

    26 // element.  Such a PopupIPCTabContext should be rejected by code which receives

    27 // it.

    28 struct PopupIPCTabContext

    29 {

    30   PBrowser opener;

    31   bool isBrowserElement;

    32 };

    34 // An IPCTabContext which corresponds to an app frame.

    35 struct AppFrameIPCTabContext

    36 {

    37   // The ID of the app this frame corresponds to.  May be NO_APP_ID.

    38   uint32_t ownAppId;

    40   // The ID of the app containing this frame.  May be NO_APP_ID.

    41   uint32_t appFrameOwnerAppId;

    42 };

    44 // An IPCTabContext which corresponds to a browser frame.

    45 struct BrowserFrameIPCTabContext

    46 {

    47   // The ID of the app which contains this browser frame.  May be NO_APP_ID.

    48   uint32_t browserFrameOwnerAppId;

    49 };

    51 // This is equivalent to AppFrameIPCTabContext with all fields set to NO_APP_ID.

    52 struct VanillaFrameIPCTabContext

    53 {};

    55 // IPCTabContext is an analog to mozilla::dom::TabContext.  Both specify an

    56 // iframe/PBrowser's own and containing app-ids and tell you whether the

    57 // iframe/PBrowser is a browser frame.  But only IPCTabContext is allowed to

    58 // travel over IPC.

    59 //

    60 // We need IPCTabContext (specifically, PopupIPCTabContext) to prevent a

    61 // privilege escalation attack by a compromised child process.  See the comment

    62 // on AllocPBrowser for details.

    63 union IPCTabAppBrowserContext

    64 {

    65   PopupIPCTabContext;

    66   AppFrameIPCTabContext;

    67   BrowserFrameIPCTabContext;

    68   VanillaFrameIPCTabContext;

    69 };

    71 struct IPCTabContext {

    72   IPCTabAppBrowserContext appBrowserContext;

    73   ScrollingBehavior scrollingBehavior;

    74 };

    76 }

    77 }

The Tor Browser / file revision