
\begin{DoxyItemize}
\item infos = Information about the zeromqrecv plugin is in keys below
\item infos/author = Thomas Wahringer \href{mailto:waht@libelektra.org}{\tt waht@libelektra.\+org}
\item infos/licence = B\+SD
\item infos/provides = notification
\item infos/needs =
\item infos/recommends =
\item infos/placements = postgetstorage
\item infos/status = maintained unittest libc global experimental
\item infos/description = Receives notifications using a Zero\+Mq subscriber socket
\end{DoxyItemize}

This plugin is a notification plugin, which receives notifications using Zero\+Mq subscribe ({\ttfamily Z\+M\+Q\+\_\+\+S\+UB}) sockets from the compatible zeromqsend plugin.


\begin{DoxyItemize}
\item {\ttfamily libzmq3-\/dev} (Zero\+MQ C bindings $>$ 3.\+2)
\end{DoxyItemize}

The recommended way is to globally mount the plugin together with the zeromqsend plugin\+: \begin{DoxyVerb}kdb global-mount zeromqsend zeromqrecv
\end{DoxyVerb}


This plugin is designed to be used as a transport plugin for Elektra\textquotesingle{}s notification feature. If notification is not enabled (i.\+e. in the tool {\ttfamily kdb} or in any other application that does not use {\ttfamily \hyperlink{group__kdbnotification_gaeae96154abdb5fdbf1b34a01e2b23e44}{elektra\+Notification\+Open()}}) this plugin does performs no operations.

Since Zero\+MQ sockets only provide a 1\+:n mapping (i.\+e. one publisher with many subscribers or one subscriber and many publishers) the {\ttfamily zeromqsend} and {\ttfamily zeromqrecv} plugins require a X\+P\+U\+B/\+X\+S\+UB endpoint. The kdb tool \href{https://www.libelektra.org/tools/hub-zeromq}{\tt \char`\"{}hub-\/zeromq\char`\"{}} provides these endpoints.\hypertarget{autotoc_md903_autotoc_md906}{}\section{Transport Plugin}\label{autotoc_md903_autotoc_md906}
Mount this plugin globally with default settings to use it as {\itshape receiving} transport plugin for Elektra\textquotesingle{}s notification feature\+:

\begin{quote}
kdb global-\/mount zeromqrecv \end{quote}
\hypertarget{autotoc_md903_autotoc_md907}{}\section{Configuration}\label{autotoc_md903_autotoc_md907}
This plugin supports the following configuration options when mounting\+:


\begin{DoxyItemize}
\item {\bfseries endpoint}\+: Zero\+MQ X\+P\+UB or P\+UB socket to connect to. The \href{http://api.zeromq.org/4-2:zmq-ipc}{\tt {\ttfamily ipc}} and \href{http://api.zeromq.org/4-2:zmq-tcp}{\tt {\ttfamily tcp}} Zero\+MQ transports are recommended. The default value is \char`\"{}tcp\+://localhost\+:6001\char`\"{}.
\end{DoxyItemize}\hypertarget{autotoc_md903_autotoc_md908}{}\section{Notification Format}\label{autotoc_md903_autotoc_md908}
For the notification format please see \href{https://www.libelektra.org/plugins/zeromqsend#notification-format}{\tt the {\ttfamily zeromqsend} plugin documentation}. 