herd command is a generic client program to control a
running instance of
shepherd (see Invoking shepherd). It has the
herd [option…] action [service [arg…]]
It causes the action of the service to be invoked. When
service is omitted and action is
root service is used3 (see The root and unknown services, for
more information on the
For each action, you should pass the appropriate args. Actions
that are available for every service are
If you pass a file name as an arg, it will be passed as-is to
the Shepherd, thus if it is not an absolute name, it is local to the current
working directory of
shepherd, not to herd.
herd command understands the following option:
Send commands to the socket special file file. If this option is not specified, localstatedir/run/shepherd/socket is taken.
herd command returns zero on success, and a non-zero exit
code on failure. In particular, it returns a non-zero exit code when
action or service does not exist and when the given action
shorthand does not work for other actions such as
herd stop would stop all the services, which
could be pretty annoying.