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 namespace sandbox {
  20
  21 typedef std::string (*LookUp2GetRequestName)(const mach_msg_header_t*);
  22 typedef void (*LookUp2FillReply)(mach_msg_header_t*, mach_port_t service_port);
  23
  24 typedef bool (*SwapIntegerIsGetOnly)(const mach_msg_header_t*);
  25
  26 struct LaunchdCompatibilityShim {
  27   // The msgh_id for look_up2.
  28   mach_msg_id_t msg_id_look_up2;
  29
  30   // The msgh_id for swap_integer.
  31   mach_msg_id_t msg_id_swap_integer;
  32
  33   // A function to take a look_up2 message and return the string service name
  34   // that was requested via the message.
  35   LookUp2GetRequestName look_up2_get_request_name;
  36
  37   // A function to formulate a reply to a look_up2 message, given the reply
  38   // message and the port to return as the service.
  39   LookUp2FillReply look_up2_fill_reply;
  40
  41   // A function to take a swap_integer message and return true if the message
  42   // is only getting the value of a key, neither setting it directly, nor
  43   // swapping two keys.
  44   SwapIntegerIsGetOnly swap_integer_is_get_only;
  45 };
  46
  47 // Gets the compatibility shim for the launchd job subsystem.
  48 const LaunchdCompatibilityShim GetLaunchdCompatibilityShim();
  49
  50 }  // namespace sandbox
  51
  52 #endif  // SANDBOX_MAC_OS_COMPATIBILITY_H_