twisted.internet.interfaces.IReactorSocket(Interface) interface documentation

Methods which allow a reactor to use externally created sockets.

For example, to use adoptStreamPort to implement behavior equivalent to that of IReactorTCP.listenTCP, you might write code like this:

   from socket import SOMAXCONN, AF_INET, SOCK_STREAM, socket
   portSocket = socket(AF_INET, SOCK_STREAM)
   # Set FD_CLOEXEC on port, left as an exercise.  Then make it into a
   # non-blocking listening port:
   portSocket.setblocking(False)
   portSocket.bind(('192.168.1.2', 12345))
   portSocket.listen(SOMAXCONN)

   # Now have the reactor use it as a TCP port
   port = reactor.adoptStreamPort(
       portSocket.fileno(), AF_INET, YourFactory())

   # portSocket itself is no longer necessary, and needs to be cleaned
   # up by us.
   portSocket.close()

   # Whenever the server is no longer needed, stop it as usual.
   stoppedDeferred = port.stopListening()

Another potential use is to inherit a listening descriptor from a parent process (for example, systemd or launchd), or to receive one over a UNIX domain socket.

Some plans for extending this interface exist. See:

• http://twistedmatrix.com/trac/ticket/5573: AF_UNIX SOCK_STREAM ports
• http://twistedmatrix.com/trac/ticket/6594: AF_UNIX SOCK_DGRAM ports