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
13namespace 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.
19class 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