вкл. 04Командный вкладыш
15 ноября 2026 г.

Лист 4 из 4, коды

Коды возврата и сигналы

Число, которое программа оставляет после себя, это единственный надёжный способ узнать, чем закончилась работа. Текст в выводе меняется между версиями и локалями, а код возврата остаётся договором между программой и оболочкой. Ниже то, что стоит проверять в скриптах и логах.

Основная таблица

КодЗначениеКогда встречается
0УспехЕдинственное значение, которое оболочка считает истиной в if и while.
1Общий отказНе найдено совпадений, неверный аргумент, отказ приложения без уточнения.
2Ошибка вызоваНеверный синтаксис команды или встроенной функции оболочки.
64..78Коды sysexitsСоглашение BSD о причинах: 64 ошибка аргументов, 66 нет файла, 77 нет прав.
126Не исполняетсяФайл есть, но нет права на запуск или формат не распознан ядром.
127Не найденоОпечатка в имени или пустой PATH, типичная причина сбоя в cron.
128+nСигнал nПроцесс убит сигналом. 130 это Ctrl+C, 137 это kill -9, 143 это SIGTERM.
255Выход за диапазонПриложение вернуло отрицательное значение или ssh сообщил об ошибке соединения.

Сигналы

Сигнал№КодСмысл
SIGHUP1129Разрыв терминала или перечитывание конфигурации службой.
SIGINT2130Прерывание с клавиатуры, Ctrl+C.
SIGKILL9137Принудительное уничтожение, перехватить нельзя.
SIGTERM15143Вежливая остановка, которую процесс может обработать.
SIGPIPE13141Читатель закрыл канал, частая причина в head и grep -q.

Конвейер

По умолчанию код возврата конвейера равен коду последней команды. Это значит, что падение первой части остаётся незамеченным, если последняя отработала успешно. Опция pipefail меняет правило и делает конвейер упавшим при любом сбое внутри.

set -o pipefail
cat data.txt | grep -q "итог" || echo "нет строки"

В bash массив PIPESTATUS хранит коды всех участников. В zsh для этого есть pipestatus, и он ведёт себя иначе: индексация начинается с единицы. Скрипт, который читает PIPESTATUS, нельзя переносить между оболочками без правки.

Три привычки, которые снимают половину сбоев

Привычка первая

В начале каждого скрипта ставить set -euo pipefail. Это не панацея: внутри условий и подстановок поведение отличается, но без этих опций ошибка молча проходит дальше и всплывает через десять шагов.

Привычка вторая

Проверять код сразу после команды, а не в конце блока. Переменная $? живёт до следующего вызова, и любая вставленная строка, включая echo для отладки, её затирает.

Привычка третья

Не путать отсутствие вывода с успехом. grep возвращает единицу, когда строк не найдено, и это нормальный результат поиска, а не сбой. В скрипте такое различают явно.

Отдельно про cron

Код 127 в журнале задания почти всегда означает PATH, а не отсутствие программы. В cron окружение короткое, и /usr/local/bin в нём может не быть. Путь прописывают целиком или задают PATH в первой строке.

Коды проверяют на конкретной машине: версия оболочки и настройки ядра влияют на поведение сигналов. Если значение из таблицы не совпало, это повод для письма, а не для догадок. Форма связи открыта на странице связи, а порядок проверки описан в разделе сверки.