DONNA-TRIGGER(1)

NAME
donna-trigger - command-line arguments

SYNOPSIS

donna-trigger [--log-level LEVEL] [--verbose] [--quiet] [--socket SOCKET] [--no-wait] [--failed-on-err] [--debug] [--version]

DESCRIPTION

donna-trigger is a small helper that allows to trigger nodes in donnatella from command line (useful e.g. to write scripts). The specified full location will asked to be triggered by donnatella, and the return value (or error message), if any, will be printed on stdout.

OPTIONS

-L, --log-level=LEVEL
    Set the log level to LEVEL, defining which messages will be shown by the log handler.

    Valid log levels are (in order) :

        • error : only show fatal error messages

        • critical : also show critical warnings

        • warning : also show warnings (default log level)

        • message : also show messages

        • info : also show informative messages

        • debug : also show main debug messages

        • debug2 : show more debug messages

        • debug3 : show even more debug messages

        • debug4 : show all possible debug messages

-v, --verbose
    Increase verbosity of log; Can be repeated multiple times.

-q, --quiet
    Turns off verbosity;Same as --log-level=error

-s, --socket=SOCKET
    Use SOCKET as socket to communicate with donnatella If not specified, the value on environment variable DONNATELLA_SOCKET will be used. It is automatically set on anything executed from donnatella, so you should usually not need to use this option.

-n, --no-wait
    Do not wait for the triggered task to be completed (either done (success), cancelled or failed). You obviously don't get any return value/error message in such case.

    Note that if more than one full locations were specified, this option is automatically enabled.

-e, --failed-on-err
    By default on errors from donna-trigger are printed on stderr, while the error message from a failed trigger is printed (like return value on success) on stdout.

    With this option, only return value goes to stdout, while error message goes to stderr.

-d, --debug
    Set log level to show debug messages; Same as --log-level=debug

-V, --version
    Show version info & exit

RETURN VALUE

The return value can be :

0
    Success (including trigger completed successfully)

1
    Failed to parse command line

2
    No socket path specified

3
    Failed to connect to socket

4
    No full location specified

5
    Command to trigger full location failed

6
    Trigger failed

7
    Trigger was cancelled

AUTHOR

Olivier Brunel
    Developer