ipc/ipc_channel_factory.h

   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_