socklog-conf - sets up a socklog(8) service.
Contents
Description
socklog-conf creates /etc/sv if necessary and a subdirectory that runs the unix, inet, ucspi-tcp or
notify service (see below for each service). Except for the notify service, socklog-conf also creates a
log directory with subdirectories.
acct, logacct and grp must not contain any special characters.
Inet Service
socklog-conf inet acctlogacct
Running socklog-conf with the 1st argument inet, socklog-conf creates the service directory
/etc/sv/socklog-inet and the log directory /var/log/socklog-inet.
socklog-conf arranges for socklog(8) to run under the uid and gid of acct and to listen for syslog
messages on the UDP socket 0.0.0.0:514.
It also creates automatically rotated log directories in /var/log/socklog-inet. The logs are owned by
logacct. The corresponding svlogd(8) process runs under the uid and gid of logacct.
You can add the service to system-wide service supervision through the update-service(8) program:
update-service --add /etc/sv/socklog-inet
Klog Service
socklog-conf klog acctlogacct
Running socklog-conf with the 1st argument klog, socklog-conf creates the service directory
/etc/sv/socklog-klog and the log directory /var/log/socklog-klog.
socklog-conf arranges for socklog(8) to run under the uid and gid of acct and to read kernel messages
from /proc/kmsg on Linux, or /dev/socklog-klog on BSD.
It also creates automatically rotated log directories in /var/log/socklog-klog. The logs are owned by
logacct. The corresponding svlogd(8) process runs under the uid and gid of logacct.
You can add the service to system-wide service supervision through the update-service(8) program:
update-service --add /etc/sv/socklog-klog
Name
socklog-conf - sets up a socklog(8) service.
Notify Service
socklog-conf notify acctgrp
Running socklog-conf with the 1st argument notify, socklog-conf creates the service directory
/etc/sv/socklog-notify.
socklog-conf arranges for uncat(1) to run under the uid and gid of acct and to listen on the named pipe
/var/log/socklog/.notify. The named pipe will have mode 0620, the uid of acct and the gid of grp.
All uids running a log service that is configured to push log events to the socklog-notify service must
be member of the group grp.
You can add the service to system-wide service supervision through the update-service(8) program:
update-service --add /etc/sv/socklog-notify
See Also
socklog(8), svlogd(8), nc(1), tryto(1), uncat(1), socklog-check(8), tcpsvd(8), sv(8), runsv(8), runsvdir(8) http://smarden.org/socklog/http://smarden.org/runit/
Synopsis
socklog-conf unix|inet|klog|ucspi-tcp acctlogacctsocklog-conf notify acctgrp
Ucspi-Tcp Service
socklog-conf ucspi-tcp acctlogacct
Running socklog-conf with the 1st argument ucspi-tcp, socklog-conf creates the service directory
/etc/sv/socklog-ucspi-tcp and the log directory /var/log/socklog-ucspi-tcp.
socklog-conf arranges for tcpsvd(1) to run socklog(8) under the uid and gid of acct and to listen on the
TCP socket 0.0.0.0:10116.
It also creates automatically rotated log directories in /var/log/socklog-ucspi-tcp. The logs are owned
by logacct. The corresponding svlogd(8) process runs under the uid and gid of logacct.
You can add the service to system-wide service supervision through the update-service(8) program:
update-service --add /etc/sv/socklog-ucspi-tcp
Unix Service
socklog-conf unix acctlogacct
Running socklog-conf with the 1st argument unix, socklog-conf creates the service directory
/etc/sv/socklog-unix and the log directory /var/log/socklog.
socklog-conf arranges for socklog(8) to run under the uid and gid of acct and to listen for syslog
messages on /dev/log.
It also creates automatically rotated log directories in /var/log/socklog. The logs are owned by
logacct. The corresponding svlogd(8) process runs under the uid and gid of logacct.
You can add the service to system-wide service supervision through the update-service(8) program:
update-service --add /etc/sv/socklog-unix
