ppapi/proxy/handle_converter.h

   1 // Copyright (c) 2013 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 #ifndef PPAPI_PROXY_HANDLE_CONVERTER_H_
   6 #define PPAPI_PROXY_HANDLE_CONVERTER_H_
   7
   8 #include <map>
   9 #include <vector>
  10
  11 #include "base/basictypes.h"
  12 #include "base/memory/scoped_ptr.h"
  13 #include "ppapi/proxy/ppapi_proxy_export.h"
  14
  15 namespace IPC {
  16 class Message;
  17 }
  18
  19 namespace ppapi {
  20 namespace proxy {
  21
  22 class SerializedHandle;
  23
  24 class PPAPI_PROXY_EXPORT HandleConverter {
  25  public:
  26   HandleConverter();
  27
  28   // Convert the native handles in |msg| to NaCl style.
  29   // In some cases (e.g., Windows), we need to re-write the contents of the
  30   // message; in those cases, |new_msg_ptr| will be set to the new message.
  31   // If |msg| is already in a good form for NaCl, |new_msg_ptr| is left NULL.
  32   // See the explanation in the body of the method.
  33   //
  34   // In either case, all the handles in |msg| are extracted into |handles| so
  35   // that they can be converted to NaClDesc handles.
  36   // See chrome/nacl/nacl_ipc_adapter.cc for where this gets used.
  37   bool ConvertNativeHandlesToPosix(const IPC::Message& msg,
  38                                    std::vector<SerializedHandle>* handles,
  39                                    scoped_ptr<IPC::Message>* new_msg_ptr);
  40
  41   // This method informs HandleConverter that a sync message is being sent so
  42   // that it can associate reply messages with their type.
  43   //
  44   // Users of HandleConverter must call this when they send a synchronous
  45   // message, otherwise HandleConverter won't be able to convert handles in
  46   // replies.
  47   void RegisterSyncMessageForReply(const IPC::Message& msg);
  48
  49  private:
  50   // When we send a synchronous message (from untrusted to trusted), we store
  51   // its type here, so that later we can associate the reply with its type
  52   // and potentially translate handles in the message.
  53   typedef std::map<int, uint32> PendingSyncMsgMap;
  54   PendingSyncMsgMap pending_sync_msgs_;
  55
  56   DISALLOW_COPY_AND_ASSIGN(HandleConverter);
  57 };
  58
  59 }  // namespace proxy
  60 }  // namespace ppapi
  61
  62 #endif  // PPAPI_PROXY_HANDLE_CONVERTER_H_