nn_bus.adoc 1.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657
  1. nn_bus(7)
  2. =========
  3. NAME
  4. ----
  5. nn_bus - message bus scalability protocol
  6. SYNOPSIS
  7. --------
  8. *#include <nanomsg/nn.h>*
  9. *#include <nanomsg/bus.h>*
  10. DESCRIPTION
  11. -----------
  12. Broadcasts messages from any node to all other nodes in the topology. The socket
  13. should never receive messages that it sent itself.
  14. This pattern scales only to local level (within a single machine or within
  15. a single LAN). Trying to scale it further can result in overloading individual
  16. nodes with messages.
  17. WARNING: For bus topology to function correctly, user is responsible for
  18. ensuring that path from each node to any other node exists within the topology.
  19. Raw (AF_SP_RAW) BUS socket never sends the message to the peer it was received
  20. from.
  21. Socket Types
  22. ~~~~~~~~~~~~
  23. NN_BUS::
  24. Sent messages are distributed to all nodes in the topology. Incoming
  25. messages from all other nodes in the topology are fair-queued in the
  26. socket.
  27. Socket Options
  28. ~~~~~~~~~~~~~~
  29. There are no options defined at the moment.
  30. SEE ALSO
  31. --------
  32. <<nn_pubsub#,nn_pubsub(7)>>
  33. <<nn_reqrep#,nn_reqrep(7)>>
  34. <<nn_pipeline#,nn_pipeline(7)>>
  35. <<nn_survey#,nn_survey(7)>>
  36. <<nn_pair#,nn_pair(7)>>
  37. <<nanomsg#,nanomsg(7)>>
  38. AUTHORS
  39. -------
  40. link:mailto:sustrik@250bpm.com[Martin Sustrik]