Home | History | Annotate | Download | only in ipc
      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