summaryrefslogtreecommitdiffstats
path: root/source/configuration/modules/omuxsock.rst
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--source/configuration/modules/omuxsock.rst61
1 files changed, 61 insertions, 0 deletions
diff --git a/source/configuration/modules/omuxsock.rst b/source/configuration/modules/omuxsock.rst
new file mode 100644
index 0000000..a9ba8cd
--- /dev/null
+++ b/source/configuration/modules/omuxsock.rst
@@ -0,0 +1,61 @@
+************************************
+omuxsock: Unix sockets Output Module
+************************************
+
+=========================== ===========================================================================
+**Module Name:**  **omuxsock**
+**Author:** `Rainer Gerhards <https://rainer.gerhards.net/>`_ <rgerhards@adiscon.com>
+**Available since:** 4.7.3, 5.5.7
+=========================== ===========================================================================
+
+
+Purpose
+=======
+
+This module supports sending syslog messages to local Unix sockets. Thus
+it provided a fast message-passing interface between different rsyslog
+instances. The counterpart to omuxsock is `imuxsock <imuxsock.html>`_.
+Note that the template used together with omuxsock must be suitable to
+be processed by the receiver.
+
+
+Configuration Parameters
+========================
+
+.. note::
+
+ Parameter names are case-insensitive.
+
+|FmtObsoleteName| directives
+----------------------------
+
+- **$OMUxSockSocket**
+ Name of the socket to send data to. This has no default and **must**
+ be set.
+- **$OMUxSockDefaultTemplate**
+ This can be used to override the default template to be used
+ together with omuxsock. This is primarily useful if there are many
+ forwarding actions and each of them should use the same template.
+
+
+Caveats/Known Bugs
+==================
+
+Currently, only datagram sockets are supported.
+
+
+Examples
+========
+
+Write all messages to socket
+----------------------------
+
+The following sample writes all messages to the "/tmp/socksample"
+socket.
+
+.. code-block:: none
+
+ $ModLoad omuxsock
+ $OMUxSockSocket /tmp/socksample
+ *.* :omuxsock:
+