Version 2.2

Item posted by Sergey Poznyakoff <gray> on Sat Dec 24 13:54:07 2022.

Version 2.2 is available for download.

New in this version:

Handling of control characters in syslog messages

If the message text contains ASCII control characters (ASCII 0 to 31), these are replaced with their "caret notation", i.e. a caret
character followed by the character value XORed with 0100. Thus, horizontal tabulation (ASCII 9) becomes ^I, carriage return
(ASCII 13) becomes ^M, etc. By default the newline character is exempt from this translation. Instead, it is substituted with
horizontal space (ASCII 32).

The "-Wcontrol_chars=MODE" option can be used to alter this processing. Possible values for MODE are:

• caret

Replace all control characters with their caret notation. The newline
character is represented as ^J.

• caretnl

The default algorithm as described above.

• octal

Replace control characters with their octal representation.

• raw

Reproduce control characters verbatim.

New option -s: set input buffer size

The -s option changes the default input buffer size. Its argument is the desired size in bytes. For UDP input, values of up to 4096 are
allowed. The default is 1024.

New output channel: pri:///DIR

Distributes messages to two disk files located in directory DIR. The name of the file to write to is selected depending on the message severity. Messages with severity greater than LOG_ERR are directed to file "1" ("out" file), messages with severity less than or equal
to LOG_ERR are directed to file "2" ("err" file).

This channel understands the following parameters:

• severity=SEVERITY

Gives name of the delimiter severity. Messages with severity
less than or equal to that value will be directed to "err" file.
(DIR/2, by default).

• errfile=NAME

Sets the name of the "err" file.

• outfile=NAME

Sets the name of the "out" file.

• prio=none|keep|decode

Controls whether and how the message priority is reflected on
the output. See the channel "file:" for details.

Default settings correspond to:

-Wseverity=err -Werrfile=2 -Woutfile=1 -Wprio=none