sandbox/mac/os_compatibility.h

   1 // Copyright 2014 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 // This file is used to handle differences in Mach message IDs and structures
   6 // that occur between different OS versions. The Mach messages that the sandbox
   7 // is interested in are decoded using information derived from the open-source
   8 // libraries, i.e. <http://www.opensource.apple.com/source/launchd/>. While
   9 // these messages definitions are open source, they are not considered part of
  10 // the stable OS API, and so differences do exist between OS versions.
  11
  12 #ifndef SANDBOX_MAC_OS_COMPATIBILITY_H_
  13 #define SANDBOX_MAC_OS_COMPATIBILITY_H_
  14
  15 #include <mach/mach.h>
  16
  17 #include <string>
  18
  19 #include "base/memory/scoped_ptr.h"
  20 #include "sandbox/mac/message_server.h"
  21
  22 namespace sandbox {
  23
  24 class OSCompatibility {
  25  public:
  26   // Creates an OSCompatibility instance for the current OS X version.
  27   static scoped_ptr<OSCompatibility> CreateForPlatform();
  28
  29   virtual ~OSCompatibility();
  30
  31   // Gets the message and subsystem ID of an IPC message.
  32   virtual uint64_t GetMessageSubsystem(const IPCMessage message) = 0;
  33   virtual uint64_t GetMessageID(const IPCMessage message) = 0;
  34
  35   // Returns true if the message is a Launchd look up request.
  36   virtual bool IsServiceLookUpRequest(const IPCMessage message) = 0;
  37
  38   // Returns true if the message is a Launchd vproc swap_integer request.
  39   virtual bool IsVprocSwapInteger(const IPCMessage message) = 0;
  40
  41   // Returns true if the message is an XPC domain management message.
  42   virtual bool IsXPCDomainManagement(const IPCMessage message) = 0;
  43
  44   // A function to take a look_up2 message and return the string service name
  45   // that was requested via the message.
  46   virtual std::string GetServiceLookupName(const IPCMessage message) = 0;
  47
  48   // A function to formulate a reply to a look_up2 message, given the reply
  49   // message and the port to return as the service.
  50   virtual void WriteServiceLookUpReply(IPCMessage reply,
  51                                        mach_port_t service_port) = 0;
  52
  53   // A function to take a swap_integer message and return true if the message
  54   // is only getting the value of a key, neither setting it directly, nor
  55   // swapping two keys.
  56   virtual bool IsSwapIntegerReadOnly(const IPCMessage message) = 0;
  57 };
  58
  59 }  // namespace sandbox
  60
  61 #endif  // SANDBOX_MAC_OS_COMPATIBILITY_H_