ipc/glue/BackgroundParent.h

   1 /* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
   2 /* vim: set ts=8 sts=2 et sw=2 tw=80: */
   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 file,
   5  * You can obtain one at http://mozilla.org/MPL/2.0/. */
   6
   7 #ifndef mozilla_ipc_backgroundparent_h__
   8 #define mozilla_ipc_backgroundparent_h__
   9
  10 #include "base/process.h"
  11 #include "mozilla/Attributes.h"
  12 #include "mozilla/dom/ContentParent.h"
  13 #include "nsStringFwd.h"
  14 #include "nsTArrayForwardDeclare.h"
  15
  16 #ifdef DEBUG
  17 #  include "nsXULAppAPI.h"
  18 #endif
  19
  20 template <class>
  21 struct already_AddRefed;
  22
  23 namespace mozilla {
  24
  25 namespace net {
  26
  27 class SocketProcessBridgeParent;
  28 class SocketProcessParent;
  29
  30 }  // namespace net
  31
  32 namespace dom {
  33
  34 class BlobImpl;
  35 class ContentParent;
  36
  37 }  // namespace dom
  38
  39 namespace ipc {
  40
  41 class BackgroundStarterParent;
  42 class PBackgroundParent;
  43 class PBackgroundStarterParent;
  44
  45 template <class PFooSide>
  46 class Endpoint;
  47
  48 // This class is not designed for public consumption beyond the few static
  49 // member functions.
  50 class BackgroundParent final {
  51   friend class mozilla::ipc::BackgroundStarterParent;
  52   friend class mozilla::dom::ContentParent;
  53   friend class mozilla::net::SocketProcessBridgeParent;
  54   friend class mozilla::net::SocketProcessParent;
  55
  56   using ProcessId = base::ProcessId;
  57   using BlobImpl = mozilla::dom::BlobImpl;
  58   using ContentParent = mozilla::dom::ContentParent;
  59   using ThreadsafeContentParentHandle =
  60       mozilla::dom::ThreadsafeContentParentHandle;
  61
  62  public:
  63   // This function allows the caller to determine if the given parent actor
  64   // corresponds to a child actor from another process or a child actor from a
  65   // different thread in the same process.
  66   // This function may only be called on the background thread.
  67   static bool IsOtherProcessActor(PBackgroundParent* aBackgroundActor);
  68
  69   // This function returns a handle to the ContentParent associated with the
  70   // parent actor if the parent actor corresponds to a child actor from another
  71   // content process. If the parent actor corresponds to a child actor from a
  72   // different thread in the same process then this function returns null.
  73   //
  74   // This function may only be called on the background thread.
  75   static ThreadsafeContentParentHandle* GetContentParentHandle(
  76       PBackgroundParent* aBackgroundActor);
  77
  78   static uint64_t GetChildID(PBackgroundParent* aBackgroundActor);
  79
  80   static void KillHardAsync(PBackgroundParent* aBackgroundActor,
  81                             const nsACString& aReason);
  82
  83  private:
  84   // Only called by ContentParent for cross-process actors.
  85   static bool AllocStarter(ContentParent* aContent,
  86                            Endpoint<PBackgroundStarterParent>&& aEndpoint);
  87
  88   // Called by SocketProcessBridgeParent and SocketProcessParent for
  89   // cross-process actors.
  90   static bool AllocStarter(Endpoint<PBackgroundStarterParent>&& aEndpoint);
  91 };
  92
  93 // Implemented in BackgroundImpl.cpp.
  94 bool IsOnBackgroundThread();
  95
  96 #ifdef DEBUG
  97
  98 // Implemented in BackgroundImpl.cpp.
  99 void AssertIsOnBackgroundThread();
 100
 101 #else
 102
 103 inline void AssertIsOnBackgroundThread() {}
 104
 105 #endif  // DEBUG
 106
 107 inline void AssertIsInMainProcess() { MOZ_ASSERT(XRE_IsParentProcess()); }
 108
 109 }  // namespace ipc
 110 }  // namespace mozilla
 111
 112 #endif  // mozilla_ipc_backgroundparent_h__