Команда timeout: как ограничить время работы команды
timeout запускает команду и следит за временем. Если команда не закончила работу за отведённый срок, timeout посылает ей сигнал остановки. Так зависшая загрузка или проверка не задержит скрипт и не будет часами висеть в cron.
Содержание 11
Что сделать прямо сейчас
- Подключитесь к серверу — инструкция.
- Выполните
timeout 3 sleep 10; echo $?. Через 3 секунды команда остановится, а ответ будет124— так timeout сообщает, что время вышло. - Выполните
timeout 10 sleep 2; echo $?. Ответ —0: sleep успела закончить работу, и timeout передала её код.
Как записать срок
| Запись | Срок |
|---|---|
timeout 30 команда | 30 секунд |
timeout 30s команда | 30 секунд |
timeout 5m команда | 5 минут |
timeout 2h команда | 2 часа |
timeout 1d команда | одни сутки |
timeout 0.5 команда | полсекунды |
timeout 0 команда | без ограничения |
Дробную часть пишите через точку. Суффикс у срока один и стоит сразу после числа: запись 1h30m timeout не примет — пишите 90m.
Что происходит, когда время вышло
timeout посылает команде сигнал TERM — просьбу завершиться. Программа может закрыть файлы и выйти сама. Если она не отвечает на TERM, добавьте -k: через указанное время после TERM timeout пошлёт KILL, а его программа перехватить не может.
timeout -k 10s 5m ./backup.shСкрипт работает не больше 5 минут. Потом он получает TERM, а если через 10 секунд ещё жив — KILL.
Другой сигнал задаёт ключ -s: timeout -s INT 30s команда пошлёт INT, как при нажатии Ctrl+C. Что такое сигналы — Процессы: ps, top и kill.
Коды выхода
| Код | Что значит |
|---|---|
124 | время вышло, команда остановлена |
125 | ошибка самой команды timeout, например неверно записан срок |
126 | команда найдена, но запустить её нельзя, например нет права на запуск |
127 | команда не найдена |
137 | команда остановлена сигналом KILL |
| другой | код, с которым закончила работу сама команда |
С ключом --preserve-status timeout возвращает код самой команды, даже когда время вышло.
timeout в скрипте
#!/bin/bash
timeout 60s ./check.sh
code=$?
if [ "$code" -eq 124 ]; then
echo "check.sh не уложился в минуту"
fiКод сохраняют в переменную сразу: следующая команда заменит $? своим кодом. Подробно о кодах — Код возврата.
timeout в cron
*/10 * * * * timeout 9m /home/ivan/sync.shЗадача запускается раз в 10 минут, а timeout не даёт скрипту работать дольше 9 минут. Если скрипт завис, он не наложится на следующий запуск. Как устроены строки расписания — Планировщик cron.
Функции и alias не запускаются
timeout запускает отдельную программу. Функцию из скрипта или alias она не найдёт и вернёт код 127. Если нужна функция или цикл, запустите внутри timeout отдельный bash:
timeout 30s bash -c 'while ! test -f /tmp/ready; do sleep 1; done'Команда ждёт появления файла /tmp/ready, но не дольше 30 секунд. Как работает цикл — Цикл while.
Ключи timeout
| Ключ | Что делает |
|---|---|
-k 10s | послать KILL через 10 секунд после первого сигнала |
-s INT | послать другой сигнал вместо TERM — имя или номер |
-v | сообщить в поток ошибок, какой сигнал послан |
--preserve-status | вернуть код команды, даже если время вышло |
--foreground | дать команде читать ввод с клавиатуры, когда timeout запущена из скрипта; дочерние процессы команды тогда по сроку не останавливаются |
Ошибки и как их исправить
| Что видно | Что значит | Что сделать |
|---|---|---|
код 124 | команда не уложилась в срок | увеличьте срок или найдите, где команда зависает |
код 127 у функции или alias | timeout ищет программу, а не команду bash | запустите timeout 30s bash -c '…' |
код 125 и ошибка про срок | срок записан неверно, например 1h30m | одно число и один суффикс: 90m |
| программа не остановилась после срока | она перехватывает TERM | добавьте -k 10s |
Источники
- Справка timeout для Ubuntu 24.04 — ключи -k, -s, -v, --preserve-status и --foreground, коды выхода.
- Исходный код coreutils 9.4: timeout.c — разбор срока и суффиксов s, m, h, d, код
137после KILL. - Справка crontab для Ubuntu 24.04 — строки расписания.
Сверено 20 октября 2026 года.
Что почитать дальше
- Команда sleepпауза в скрипте.
- Процессы: ps, top и killсигналы и остановка процессов.
- Планировщик cronзапуск по расписанию.
- Как запустить команду в фонедолгие команды без открытого терминала.