bionic (8) socklog-conf.8.gz

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>

                                                                                                 socklog-conf(8)