socklog - small and secure syslogd replacement for use with runit
[-rRU] [unix] [path]
[-rR] inet [ip]
[-rR] ucspi [args]
is run under runit's runsv
(8), writing syslog messages it
receives from unix domain socket path
or an inet udp socket
through a pipe provided by runsv
(8) to a
can be run as an ucspi application to listen to an unix domain
stream socket and for more flexible distributed logging.
If the environment variables $UID and/or $GID are present, socklog
permissions to those ids after creating and binding the socket (not in
converts syslog facility and priority information to names (
:) as found in /usr/include/syslog.h
compile time if present.
On solaris socklog
also accepts sun_stream
as first argument.
Please see the web page for details.
[ unix ] [ path
with the 1st argument unix
listen to the unix domain socket path
. If path
is omitted, the
The 1st argument may be omitted, default is unix
inet [ ip
] [ port
with the 1st argument inet
listen to the inet udp socket ip:port.
starts with 0, socklog
will bind to all local interfaces.
is less or equal 1024, socklog
must be run by root.
may be omitted, default is 514. ip
may be omitted, default is
to each syslog message it receives,
is the ip address of the connecting system.
ucspi [ args
with the 1st argument ucspi
run as an ucspi application. Normally socklog
will only be started in
mode by an ucspi server tool, such as tcpsvd
(1) or unixserver
For each arg
will prepend $ arg
: to each syslog
message, if the environment variable $arg
is present (maximum is 8).
- raw. Write the raw syslog messages (no conversion of
facility and priority) to the pipe, additionally to the log messages with
syslog facility and priority converted to names.
- raw only. Same as -r above, but write the raw syslog
- respect umask. Don't set umask to 0 before creating a unix
domain socket, but respect the current setting of umask(2). This
option only takes effect in unix mode.
sv(8), runsvdir(8), runsv(8), svlogd(8), tryto(1), uncat(1), socklog-check(8),
Gerrit Pape <email@example.com>