Man page - socklog-conf(8)

Packages contains this manual

Manual

socklog-conf

NAME
SYNOPSIS
DESCRIPTION
UNIX SERVICE
INET SERVICE
KLOG SERVICE
UCSPI-TCP SERVICE
NOTIFY SERVICE
SEE ALSO
AUTHOR

NAME

socklog-conf - sets up a socklog(8) service.

SYNOPSIS

socklog-conf unix|inet|klog|ucspi-tcp acct logacct
socklog-conf notify acct grp

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.

UNIX SERVICE

socklog-conf unix acct logacct

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

INET SERVICE

socklog-conf inet acct logacct

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 acct logacct

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

UCSPI-TCP SERVICE

socklog-conf ucspi-tcp acct logacct

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

NOTIFY SERVICE

socklog-conf notify acct grp

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/

AUTHOR

Gerrit Pape <pape@smarden.org>