Лист 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 сообщил об ошибке соединения. |
Сигналы
| Сигнал | № | Код | Смысл |
|---|---|---|---|
| SIGHUP | 1 | 129 | Разрыв терминала или перечитывание конфигурации службой. |
| SIGINT | 2 | 130 | Прерывание с клавиатуры, Ctrl+C. |
| SIGKILL | 9 | 137 | Принудительное уничтожение, перехватить нельзя. |
| SIGTERM | 15 | 143 | Вежливая остановка, которую процесс может обработать. |
| SIGPIPE | 13 | 141 | Читатель закрыл канал, частая причина в 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 в первой строке.
Коды проверяют на конкретной машине: версия оболочки и настройки ядра влияют на поведение сигналов. Если значение из таблицы не совпало, это повод для письма, а не для догадок. Форма связи открыта на странице связи, а порядок проверки описан в разделе сверки.