twisted.internet.interfaces.IReactorSocket

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/6594: AF_UNIX SOCK_DGRAM ports