• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 // Copyright 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 IPC_IPC_CHANNEL_FACTORY_H_
6 #define IPC_IPC_CHANNEL_FACTORY_H_
7 
8 #include "base/files/file_path.h"
9 #include "base/message_loop/message_loop.h"
10 #include "ipc/ipc_channel_handle.h"
11 #include "ipc/ipc_export.h"
12 
13 namespace IPC {
14 
15 // A ChannelFactory listens on a UNIX domain socket. When a client connects to
16 // the socket, it accept()s the connection and passes the new FD to the
17 // delegate. The delegate is then responsible for creating a new IPC::Channel
18 // for the FD.
19 class IPC_EXPORT ChannelFactory : public base::MessageLoopForIO::Watcher {
20  public:
21   class Delegate {
22    public:
23     // Called when a client connects to the factory. It is the delegate's
24     // responsibility to create an IPC::Channel for the handle, or else close
25     // the file descriptor contained therein.
26     virtual void OnClientConnected(const ChannelHandle& handle) = 0;
27 
28     // Called when an error occurs and the channel is closed.
29     virtual void OnListenError() = 0;
30   };
31 
32   ChannelFactory(const base::FilePath& path, Delegate* delegate);
33 
34   virtual ~ChannelFactory();
35 
36   // Call this to start listening on the socket.
37   bool Listen();
38 
39   // Close and unlink the socket, and stop accepting connections.
40   void Close();
41 
42  private:
43   bool CreateSocket();
44   virtual void OnFileCanReadWithoutBlocking(int fd) OVERRIDE;
45   virtual void OnFileCanWriteWithoutBlocking(int fd) OVERRIDE;
46 
47   base::MessageLoopForIO::FileDescriptorWatcher
48   server_listen_connection_watcher_;
49   base::FilePath path_;
50   Delegate* delegate_;
51   int listen_fd_;
52 
53   DISALLOW_COPY_AND_ASSIGN(ChannelFactory);
54 };
55 
56 }  // namespace IPC
57 
58 #endif  // IPC_IPC_CHANNEL_FACTORY_H_
59