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)