Mike Gerwitz

Activist for User Freedom

path: root/bin
diff options
authorMike Gerwitz <mike.gerwitz@rtspecialty.com>2018-10-19 09:51:41 -0400
committerMike Gerwitz <mike.gerwitz@rtspecialty.com>2018-10-19 10:15:14 -0400
commit8fa7d9ece6c546595a0f2f2ea4c79c6688c2fa0c (patch)
treed3e9b258eee917a4e26ae8612d9a6160cad5a510 /bin
parent81432079039cfbaa98078d8f33046c2b1b9933e3 (diff)
bin/tame: Inherit TAME_CMD_WAITTIME from environment
* bin/tame (TAME_CMD_WAITTIME): Renamed from `RUNNER_CMD_WAITTIME'. Inherit from environment, default 3. (command-runner): Sleep for an additional TAME_CMD_WAITTIME seconds after requesting runner reload to give more time in case of high load. (verify-runner-ack): Rename variable. (usage): Document env var. * build-aux/Makefile.am: Export TAME_CMD_WAITTIME.
Diffstat (limited to 'bin')
1 files changed, 16 insertions, 5 deletions
diff --git a/bin/tame b/bin/tame
index 17775f4..17b2483 100755
--- a/bin/tame
+++ b/bin/tame
@@ -27,7 +27,7 @@ declare -ri EX_USAGE=64 # incorrect usage; sysexits.h
# maximum amount of time in seconds to wait for runner to ack
# before forcibly restarting it
-declare -ri RUNNER_CMD_WAITTIME=3
# propagate to daemon
@@ -64,6 +64,9 @@ command-runner()
echo "warning: failed runner $id ack; requesting reload" >&2
kill -HUP "$pid"
+ # give some extra time in case the host is under high load
# try one last time
echo "$*" > "$base/0"
verify-runner-ack "$*" < "$base/1" || {
@@ -109,14 +112,14 @@ verify-runner()
# Wait for command acknowledgment from runner
-# The runner must respond within RUNNER_CMD_WAITTIME seconds
+# The runner must respond within TAME_CMD_WAITTIME seconds
# and must echo back the command that was given. Otherwise,
# this function returns with a non-zero status.
local -r cmd="${1?Missing command}"
- read -t"$RUNNER_CMD_WAITTIME" -r ack || return
+ read -t"$TAME_CMD_WAITTIME" -r ack || return
test "COMMAND $cmd" == "$ack" || {
# TODO check for ack mismatch once output race condition is fixed
@@ -233,14 +236,22 @@ Or: $0 --kill
Send command line CMDLINE to a tamed runner. Start tamed if
not already running.
+If a runner does not acknlowedge a request in TAME_CMD_WAITTIME
+seconds, it will be reloaded and given TAME_CMD_WAITTIME seconds
+to come online. After that time has elapsed, the command will
+be re-attempted, timing out again after TAME_CMD_WAITTIME and
+and at that point giving up.
--help show this message
--kill kill tamed
-v, --verbose show runner logs
Environment Variables:
- TAME_VERBOSE when greater than zero, show runner logs
- (see also --verbose)
+ TAME_VERBOSE when greater than zero, show runner logs
+ (see also --verbose)
+ TAME_CMD_WAITTIME number of seconds to wait for ack from
+ runner (default 3)
exit $EX_USAGE