blob: 23e0e9193b725198a2d701b51213e0847a291aeb (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
|
// Copyright 2014 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef IPC_MOJO_IPC_MOJO_BOOTSTRAP_H_
#define IPC_MOJO_IPC_MOJO_BOOTSTRAP_H_
#include <stdint.h>
#include "base/macros.h"
#include "base/memory/scoped_ptr.h"
#include "base/process/process_handle.h"
#include "build/build_config.h"
#include "ipc/ipc_channel.h"
#include "ipc/ipc_listener.h"
#include "ipc/mojo/ipc.mojom.h"
#include "mojo/edk/embedder/scoped_platform_handle.h"
#include "mojo/public/cpp/system/message_pipe.h"
namespace IPC {
// MojoBootstrap establishes a pair of associated interfaces between two
// processes in Chrome.
//
// Clients should implement MojoBootstrap::Delegate to get the associated pipes
// from MojoBootstrap object.
//
// This lives on IO thread other than Create(), which can be called from
// UI thread as Channel::Create() can be.
class IPC_MOJO_EXPORT MojoBootstrap {
public:
class Delegate {
public:
virtual void OnPipesAvailable(
mojom::ChannelAssociatedPtrInfo send_channel,
mojom::ChannelAssociatedRequest receive_channel,
int32_t peer_pid) = 0;
virtual void OnBootstrapError() = 0;
};
// Create the MojoBootstrap instance, using |handle| as the message pipe, in
// mode as specified by |mode|. The result is passed to |delegate|.
static scoped_ptr<MojoBootstrap> Create(mojo::ScopedMessagePipeHandle handle,
Channel::Mode mode,
Delegate* delegate);
MojoBootstrap();
virtual ~MojoBootstrap();
// Start the handshake over the underlying message pipe.
virtual void Connect() = 0;
// GetSelfPID returns our PID.
base::ProcessId GetSelfPID() const;
protected:
// On MojoServerBootstrap: INITIALIZED -> WAITING_ACK -> READY
// On MojoClientBootstrap: INITIALIZED -> READY
// STATE_ERROR is a catch-all state that captures any observed error.
enum State { STATE_INITIALIZED, STATE_WAITING_ACK, STATE_READY, STATE_ERROR };
Delegate* delegate() const { return delegate_; }
void Fail();
bool HasFailed() const;
State state() const { return state_; }
void set_state(State state) { state_ = state; }
mojo::ScopedMessagePipeHandle TakeHandle();
private:
void Init(mojo::ScopedMessagePipeHandle, Delegate* delegate);
mojo::ScopedMessagePipeHandle handle_;
Delegate* delegate_;
State state_;
DISALLOW_COPY_AND_ASSIGN(MojoBootstrap);
};
} // namespace IPC
#endif // IPC_MOJO_IPC_MOJO_BOOTSTRAP_H_
|
