---

   rsyslog.conf    ( 5 )

---

OUTPUT CHANNELS

Output Channels are a new concept first introduced in rsyslog
       0.9.0. As of this writing, it is most likely that they will be
       replaced by something different in the future.  So if you use
       them, be prepared to change you configuration file syntax when
       you upgrade to a later release.

       Output channels are defined via an $outchannel directive. It's
       syntax is as follows:

              $outchannel name,file-name,max-size,action-on-max-size

       name is the name of the output channel (not the file), file-name
       is the file name to be written to, max-size the maximum allowed
       size and action-on-max-size a command to be issued when the max
       size is reached. This command always has exactly one parameter.
       The binary is that part of action-on-max-size before the first
       space, its parameter is everything behind that space.

       Keep in mind that $outchannel just defines a channel with "name".
       It does not activate it.  To do so, you must use a selector line
       (see below). That selector line includes the channel name plus
       ":omfile:$" in front of it. A sample might be:

              *.* :omfile:$mychannel