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

Код ВК-04, лист 1 из 4

Командный вкладыш

Раскладной лист к паспорту машины, на которой вы работаете. Двадцать четыре позиции, у каждой: что команда делает, как выглядит вызов и где она кусается на русской локали. Лист читают с середины, когда что-то сломалось, и с начала, когда машина новая.

Отметка о выпуске

Действует с 20 ноября 2026 г.

Сверка: GNU coreutils и BSD

Сверено

Раскладной технический вкладыш с таблицей команд, снятый на копировальном стекле
Фото 1. Лист перед сгибанием: три панели, поле для отметок справа.лист ВК-04

Зачем нужен лист

Справочники команд обычно пишут для тех, кто уже помнит синтаксис. Здесь наоборот: позиция считается полезной, если по ней можно восстановить вызов через месяц после того, как вы последний раз открывали терминал. Поэтому в каждой строке есть номер, назначение и отдельная графа с ловушкой.

Нумерация не украшение. По номеру позицию называют вслух: «посмотри шестую», и этого достаточно, чтобы коллега открыл тот же пункт. Номера сквозные по всему листу, включая страницы с ловушками и кодами возврата, поэтому ссылка на позицию остаётся рабочей, даже если текст вокруг переписали.

Английская редакция справочника живёт на отдельном домене и описывает команды для нейтральной локали. Здесь описан тот же инструмент, но в условиях, где в именах файлов кириллица, в выводе программ cp1251, а в cron пустое окружение. Это не перевод: половина ловушек в английском справочнике просто не встречается.

Как читать позицию

06sort -k2,2
Назначение
Сортировка строк по второму полю, устойчиво к пробелам.
Ловушка
Коллация берётся из LC_COLLATE. Для машинного сравнения ставят LC_ALL=C, для человеческого чтения оставляют ru_RU.UTF-8.
Проверка
Две сортировки одного файла с разными локалями дают разный порядок строк. Если порядок совпал, локаль не применилась.

Графа «Проверка» описывает опыт, который повторяют на своей машине, а не обещание, которое нужно принять на веру.

№ВызовНазначениеЛовушка
01grep -rnПоиск строки по дереву каталогов с номерами строк.Без -P юникодные классы не работают, шаблон трактуется как BRE.
02sed -iПравка файла на месте по регулярному выражению.BSD sed требует пустой суффикс: sed -i '' -e ...; GNU принимает -i без него.
03awkПоля, суммы, отчёты по колонкам.Порядок сортировки и десятичная запятая зависят от LC_NUMERIC.
04find -nameОбход дерева по маске имени.Маску берут в кавычки, иначе оболочка раскроет её по текущему каталогу.
05xargs -0Передача списка файлов в одну команду.Без -0 имена с пробелами и переводами строк рвутся на части.
06sortСортировка строк и полей.В локали ru_RU.UTF-8 «ё» встаёт после «е», а не там, где ждёт читатель.
07cut -d: -f1Выбор колонки по разделителю.cut -c в BSD режет байты, поэтому кириллица выходит обрубленной.
08iconvПерекодировка из cp1251, koi8-r, cp866 в UTF-8.На невалидном байте команда обрывается, если не добавлен //TRANSLIT или //IGNORE.
09localeПроверка доступных локалей и текущих значений.В cron и ssh переменные LANG и LC_ALL не наследуются от интерактивной сессии.
10printfФорматированный вывод без сюрпризов эха.Ширина %5s считается в байтах, если локаль не UTF-8.
11rsync -aКопирование дерева с сохранением прав и времени.Косая черта в конце источника меняет смысл: каталог или его содержимое.
12tar -czfАрхив каталога для переноса.Кодировка имён внутри архива зависит от локали отправителя и получателя.

Меры безопасности

Читать до запуска

Четыре ситуации, в которых команда ведёт себя не так, как написано в англоязычной справке. Каждая проверена на Debian с локалью ru_RU.UTF-8 и на macOS с локалью по умолчанию.

13

Локаль задаёт поведение, а не только язык сообщений

LC_ALL перекрывает LANG и все остальные категории. Если поставить LC_ALL=C, сортировка станет байтовой, а сообщения об ошибках английскими. Это полезно в скриптах и вредно в интерактивной работе: grep перестаёт понимать классы символов, printf считает ширину в байтах.

14

Кодировка файла не равна кодировке терминала

Терминал может быть в UTF-8, а файл из базы в cp1251. Проверяют через file -i и смотрят на charset. Если файл объявлен как unknown-8bit, перекодировку делают iconv с явным указанием источника, иначе получают двойное преобразование и ромбики вместо букв.

15

Путь с кириллицей ломается там, где нет кавычек

Пробел в имени каталога разрывает аргумент, а кириллица ломается, если оболочка или утилита работает в другой кодировке. В скриптах имена передают через find -print0 и xargs -0, а в цикле используют while IFS= read -r -d "".

16

Окружение cron и ssh не совпадает с вашим

В cron нет LANG, поэтому программа может вывести cp1251 или отказаться читать UTF-8. В ssh переменные передаются только при SendEnv и AcceptEnv. Явная строка LANG=ru_RU.UTF-8 в начале скрипта снимает большую часть загадочных расхождений.

Каждая из четырёх ситуаций проверяется одной командой, поэтому спор решается опытом, а не ссылкой на документацию. Если опыт не воспроизводится, значит дело в версии утилиты или в окружении, которое вы не видите.

Коды возврата

Оболочка считает успехом только ноль. Всё остальное это число от одного до двухсот пятидесяти пяти, и по нему скрипт решает, продолжать или падать. Коды выше 128 означают, что процесс убит сигналом: из значения вычитают 128 и получают номер сигнала.

0Успех. В shell это единственный код, который считается истиной.
1Общая ошибка команды: не найдено совпадений, неверный аргумент.
2Ошибка разбора аргументов или встроенной команды оболочки.
126Файл найден, но не исполняется: нет права x или неверный формат.
127Команда не найдена: опечатка или пустой PATH в cron.
128+nПроцесс убит сигналом n. 130 это Ctrl+C, 143 это SIGTERM.

В конвейере код возврата по умолчанию берётся у последней команды. Строка set -o pipefail меняет правило: конвейер считается упавшим, если упал хотя бы один участник.

Оттиск штампа и ведомость кодов возврата на листе с машинописным текстом
Фото 2. Ведомость кодов возврата: ноль, единица, двойка и диапазон сигналов.

Куда идти дальше

Полный перечень из двадцати четырёх позиций занимает отдельный лист. Ловушки собраны на одном развороте, чтобы их можно было распечатать и держать рядом с клавиатурой. Порядок сверки описывает, как этот лист проверяют перед выпуском и что считается достаточным доказательством.

Если позиция расходится с вашей машиной, напишите через форму связи: укажите систему, версию утилиты и локаль. Такие письма попадают в очередь сверки, и лист правится вместе с номером выпуска.