blob: bcc0bb25e77c099e91df01a42f7fff37251a7d2d [file] [log] [blame] [edit]
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 receives 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
--------
linknanomsg:nn_pubsub[7]
linknanomsg:nn_pair[7]
linknanomsg:nn_pipeline[7]
linknanomsg:nn_reqrep[7]
linknanomsg:nn_survey[7]
linknanomsg:nn_sync[7]
linknanomsg:nanomsg[7]
AUTHORS
-------
Martin Sustrik <sustrik@250bpm.com>