From 5c56ae89ea0215a74206a7e9e3b4c5beea5a5fc6 Mon Sep 17 00:00:00 2001 From: Fazle Arefin Date: Thu, 1 Aug 2024 18:48:51 +1000 Subject: [PATCH] timeout: edit page (#13332) Co-authored-by: spageektti Co-authored-by: K.B.Dharun Krishna --- pages/common/timeout.md | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) diff --git a/pages/common/timeout.md b/pages/common/timeout.md index da3852093..0da4ade24 100644 --- a/pages/common/timeout.md +++ b/pages/common/timeout.md @@ -7,6 +7,18 @@ `timeout 3s sleep 10` -- Send a signal to the command after the time limit expires (SIGTERM by default): +- Send a [s]ignal to the command after the time limit expires (`TERM` by default, `kill -l` to list all signals): -`timeout --signal {{INT}} {{5s}} {{sleep 10}}` +`timeout --signal {{INT|HUP|KILL|...}} {{5s}} {{sleep 10}}` + +- Send [v]erbose output to `stderr` showing signal sent upon timeout: + +`timeout --verbose {{0.5s|1m|1h|1d|...}} {{command}}` + +- Preserve the exit status of the command regardless of timing out: + +`timeout --preserve-status {{1s|1m|1h|1d|...}} {{command}}` + +- Send a forceful `KILL` signal after certain duration if the command ignores initial signal upon timeout: + +`timeout --kill-after={{5m}} {{30s}} {{command}}`