blob: 0420fd4855ece75f8f7d3585d7026112213ace25 [file] [log] [blame]
nn_bus(7)
=========
NAME
----
nn_bus - message bus scalability protocol
SYNOPSIS
--------
*#include <nanomsg/nn.h>*
*#include <nanomsg/bus.h>*
DESCRIPTION
-----------
Broadcasts messages from any node to all other nodes in the topology. The socket
should never receive messages that it sent itself.
This pattern scales only to local level (within a single machine or within
a single LAN). Trying to scale it further can result in overloading individual
nodes with messages.
WARNING: For bus topology to function correctly, user is responsible for
ensuring that path from each node to any other node exists within the topology.
Raw (AF_SP_RAW) BUS socket never sends the message to the peer it was received
from.
Socket Types
~~~~~~~~~~~~
NN_BUS::
Sent messages are distributed to all nodes in the topology. Incoming
messages from all other nodes in the topology are fair-queued in the
socket.
Socket Options
~~~~~~~~~~~~~~
There are no options defined at the moment.
SEE ALSO
--------
<<nn_pubsub.7.txt#,nn_pubsub(7)>>
<<nn_reqrep.7.txt#,nn_reqrep(7)>>
<<nn_pipeline.7.txt#,nn_pipeline(7)>>
<<nn_survey.7.txt#,nn_survey(7)>>
<<nn_pair.7.txt#,nn_pair(7)>>
<<nanomsg.7.txt#,nanomsg(7)>>
AUTHORS
-------
link:mailto:sustrik@250bpm.com[Martin Sustrik]