X-Git-Url: https://review.fuel-infra.org/gitweb?a=blobdiff_plain;f=eventlet%2Fdoc%2Fzeromq.rst;fp=eventlet%2Fdoc%2Fzeromq.rst;h=0000000000000000000000000000000000000000;hb=358bd9258c2b6d2ee74de4dfd07a5123107abad4;hp=96db4b956a7f3a824df3f0d5efd946ee7ae11c52;hpb=376ff3bfe7071cc0793184a378c4e74508fb0d97;p=packages%2Ftrusty%2Fpython-eventlet.git diff --git a/eventlet/doc/zeromq.rst b/eventlet/doc/zeromq.rst deleted file mode 100644 index 96db4b9..0000000 --- a/eventlet/doc/zeromq.rst +++ /dev/null @@ -1,29 +0,0 @@ -Zeromq -###### - -What is ØMQ? -============ - -"A ØMQ socket is what you get when you take a normal TCP socket, inject it with a mix of radioactive isotopes stolen -from a secret Soviet atomic research project, bombard it with 1950-era cosmic rays, and put it into the hands of a drug-addled -comic book author with a badly-disguised fetish for bulging muscles clad in spandex." - -Key differences to conventional sockets -Generally speaking, conventional sockets present a synchronous interface to either connection-oriented reliable byte streams (SOCK_STREAM), -or connection-less unreliable datagrams (SOCK_DGRAM). In comparison, 0MQ sockets present an abstraction of an asynchronous message queue, -with the exact queueing semantics depending on the socket type in use. Where conventional sockets transfer streams of bytes or discrete datagrams, -0MQ sockets transfer discrete messages. - -0MQ sockets being asynchronous means that the timings of the physical connection setup and teardown, -reconnect and effective delivery are transparent to the user and organized by 0MQ itself. -Further, messages may be queued in the event that a peer is unavailable to receive them. - -Conventional sockets allow only strict one-to-one (two peers), many-to-one (many clients, one server), -or in some cases one-to-many (multicast) relationships. With the exception of ZMQ::PAIR, -0MQ sockets may be connected to multiple endpoints using connect(), -while simultaneously accepting incoming connections from multiple endpoints bound to the socket using bind(), thus allowing many-to-many relationships. - -API documentation -================= - -ØMQ support is provided in the :mod:`eventlet.green.zmq` module \ No newline at end of file