Update with new details on the logger tool

Signed-off-by: Joachim Wiberg <troglobit@gmail.com>
This commit is contained in:
Joachim Wiberg 2022-07-31 17:32:36 +02:00
parent c095131ff9
commit 3969dbb8a6

View File

@ -19,8 +19,8 @@ Table of Contents
* [Building from GIT](#building-from-git) * [Building from GIT](#building-from-git)
* [Origin & References](#origin--references) * [Origin & References](#origin--references)
> **Tip:** the Gentoo project has a very nice article detailing how to > **Tip:** the Gentoo project has a very nice article detailing sysklogd
> use and set up sysklogd <https://wiki.gentoo.org/wiki/Sysklogd> > ➤ <https://wiki.gentoo.org/wiki/Sysklogd>
Introduction Introduction
@ -48,9 +48,14 @@ with standard C-library implementations of the `syslog()` API (GLIBC,
musl libc, uClibc), `libsyslog` must be used in your application to musl libc, uClibc), `libsyslog` must be used in your application to
unlock the new [RFC5424][] `syslogp()` API. unlock the new [RFC5424][] `syslogp()` API.
The included `logger` tool can be used from the command line, or script, The included `logger` tool is primarily made for use with sysklogd, but
to send RFC5424 formatted messages using `libsyslog` to `syslogd` for can be used stand-alone too. It is not command line compatible with the
local or remote logging. "standard" Linux logger tool from the bsdutils project. Instead it is
compatible with the actual BSD logger tool(s) -- only major difference
is its support for `-I PID`, similar to the bsdutils `--id=PID`. The
`logger` tool can be used from the command line, or script, to send both
RFC5424 (default) and old-style (BSD) RFC3164 formatted messages using
`libsyslog` to `syslogd` for local processing, or to a remote server.
Main differences from the original sysklogd package are: Main differences from the original sysklogd package are:
@ -69,7 +74,8 @@ Main differences from the original sysklogd package are:
- Support for remote peer filtering, from FreeBSD - Support for remote peer filtering, from FreeBSD
- Support for disabling DNS reverse lookups for each remote log message - Support for disabling DNS reverse lookups for each remote log message
- Support for FreeBSD Secure Mode, remote logging enabled by default(!) - Support for FreeBSD Secure Mode, remote logging enabled by default(!)
- Includes a `logger` tool with RFC5424 capabilities (`msgid` etc.) - Includes a fit for purpose `logger` tool, compatible with `syslogd`,
leveraging the full RFC5424 capabilities (`msgid` etc.)
- Includes a syslog library and system header replacement for logging - Includes a syslog library and system header replacement for logging
- FreeBSD socket receive buffer size patch - FreeBSD socket receive buffer size patch
- Avoid blocking `syslogd` if console is backed up - Avoid blocking `syslogd` if console is backed up