summaryrefslogtreecommitdiffstats
path: root/source/configuration/modules/omuxsock.rst
blob: a9ba8cd369024ae28598e92f44095dcd0bcfdd0f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
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: