RBULK-NOTIFY(1)

NAME
rbulk-notify - send remote notifications for script execution

SYNOPSIS
rbulk-notify [-h]
rbulk-notify [-u] [-p port] host [message]

DESCRIPTION

rbulk-notify sends a notification to a running rbulk-watchd(1) daemon on host host, specified either as a numeric ip address or a host name. The notification is either the empty message, or the text message if given. By default, a tcp connection is established and the output of the triggered command is printed on standard output. rbulk-notify terminates when the command has finished executing. The -u flag can be specified to use udp instead of tcp. In this case, rbulk-notify leaves immediately after sending the message without confirmation.

rbulk-notify is provided for convenience only. Other standard programs, such as nc(1) or bash(1) or event a web browser can be used to achieve the same effect. See EXAMPLES below.

The following command line options are available:

-h  Print usage summary and exit.

-u  Use udp instead of tcp.

-p port
    Send to port port instead of the default 8869.

EXAMPLES
Send the "hello" notification to a daemon configured to answer hello:

    % rbulk-notify localhost hello
    echo hello
    hello
    exit 0
    0s use, 0s system
    %

Achieve the same with nc(1):

    % echo hello | nc localhost 8869
    hello
    exit 0
    0s use, 0s system
    %

Use bash(1) builtin udp sockets (note the absence of confirmation):

    % bash -c 'echo hello > /dev/udp/localhost/8869'
    %

Use curl(1) without output capture:

    % curl http://localhost:8869/hello
    echo hello
    %

SEE ALSO
rbulk-watchd(1), nc(1), bash(1).