NAME

       socklog-check - checks for the availability of a socklog(8) service.

SYNOPSIS

       socklog-check [-v] [unix [address]]

DESCRIPTION

       socklog-check  attempts  to  connect  to a socklog(8) unix service and reports whether the
       connection attempt succeeded or not.

       It connects to the datagram oriented unix  domain  socket  address,  and  reports  success
       through  the  return code.  If address is not specified, socklog-check attempts to connect
       to /dev/log.

       When running services that use the syslog  facility  under  runit's  service  supervision,
       socklog-check  should  be  added  to the top of the service's run script to ensure that no
       syslog messages are generated until a syslog service is up  and  running  to  process  the
       messages, e.g.:

        #!/bin/sh
        socklog-check || exit 1
        exec service_using_syslog

OPTIONS

       -v     verbose.  Print verbose message to standard error.

EXIT CODES

       On success socklog-check returns 0.

       On error, socklog-check prints a message to standard error and exits 111.

SEE ALSO

       socklog(8), socklog-conf(8), svlogd(8), tryto(1), uncat(1), sv(8), runsv(8), runsvdir(8)

        http://smarden.org/socklog/
        http://smarden.org/runit/

AUTHOR

       Gerrit Pape <pape@smarden.org>

                                                                                 socklog-check(8)