rocbroker
=========

The ``rocbroker`` is responsible for managing all actors of an acquisition system and to relay messages between them.
Every measurement setup needs one ``rocbroker`` and all actors must know the IP-address or hostname of the broker to connect to.

Every actor will register itself using a commonly known name to the ``rocbroker`` using the `Majordomo Protocol <http://rfc.zeromq.org/spec:7>`_.
After registering, other actors can call methods or access attributes of the registered actor.
Furthermore, it will open one ``ZMQ-SUB`` socket and one ``ZMQ-PUB`` socket which act as a relaying proxy for publish-subscribe messages
(i.e. logging and status updates), see :doc:`../roc` for details.

The ``rocbroker`` can be started by::

    python -m runmacs.roc.rocbroker