# ompipe: Pipe Output Module

Module Name: ompipe

Author:Rainer Gerhards <rgerhards@adiscon.com>

Description:

The ompipe plug-in provides the core functionality for logging output to named pipes (fifos). It is a built-in module that does not need to be loaded.

Global Configuration Parameters:

Note: parameter names are case-insensitive.

- Template: [templateName] sets a new default template for file actions.

Action specific Configuration Parameters:

Note: parameter names are case-insensitive.

- Pipe: string a fifo or named pipe can be used as a destination for log messages.

- tryResumeReopen: Sometimes we need to reopen a pipe after an ompipe action gets suspended. Sending an HUP signal does the job but requires an interaction with rsyslog. When set to “on” and a resume action fails, the file descriptor is closed, causing a new open in the next resume. Default: “off” to preserve existing behavior before introduction of this option.

Caveats/Known Bugs: None

Sample: The following command sends all syslog messages to a pipe named “NameofPipe”.

    Module (path="builtin:ompipe")
    *.* action(type="ompipe" Pipe="NameofPipe")

Legacy Configuration Parameters:

rsyslog has support for logging output to named pipes (fifos). A fifo or named pipe can be used as a destination for log messages by prepending a pipe symbol (“|”) to the name of the file. This is handy for debugging. Note that the fifo must be created with the mkfifo(1) command before rsyslogd is started.

Legacy Sample:

The following command sends all syslog messages to a pipe named /var/log/pipe.

    $ModLoad ompipe
    *.* |/var/log/pipe

See also

Help with configuring/using `Rsyslog`:

- Mailing list - best route for general questions

- GitHub: rsyslog source project - detailed questions, reporting issues that are believed to be bugs with `Rsyslog`

- Stack Exchange (View, Ask) - experimental support from rsyslog community

See also

Contributing to `Rsyslog`:

- Source project: rsyslog project README.

- Documentation: rsyslog-doc project README

Copyright 2008-2020 Rainer Gerhards (Großrinderfeld), and Others.