Command Explainer: как читать man-страницы и понимать Unix

Запустить команду легко. Понять, что она делает со всеми флагами — искусство. Command Explainer переводит с man на человеческий.

История man: как документировали UNIX (1971)

Когда Кен Томпсон и Деннис Ритчи писали первую версию UNIX, им нужен был способ документировать 60+ команд. Они использовали troff (наборный процессор) и создали формат man — сокращение от «manual page».

Первая man-страница была написана для команды stat в 1971 году. К 3rd Edition UNIX (1973) у каждой команды была своя страница. Формат оказался настолько удачным, что его переняли все UNIX-подобные системы, включая Linux.

Секции man — гениально простая навигация: 8 разделов покрывают всё от пользовательских команд до форматов файлов и системных вызовов. man 7 socket — не страница о команде socket, а документация о сокетах как концепции.

Философия Unix: маленькие инструменты в конвейере (1973)

Man-страницы обретают смысл только рядом с идеей, которую они документируют. Дуг Макилрой (Doug McIlroy), руководивший в Bell Labs группой, стоявшей за UNIX, сформулировал её так: «Пишите программы, которые делают одну вещь и делают её хорошо. Пишите программы, которые работают вместе». В 1973 году он протолкнул в UNIX пайпы — тот самый |, который направляет вывод одной команды прямо на вход следующей.

Именно поэтому команды выглядят так, как выглядят. grep фильтрует, sort сортирует, awk перекраивает, tar упаковывает — каждая маленькая и однозадачная, а сила рождается из их сцепления: ps aux | grep node | awk '{print $2}'. Прочитать длинную команду — это на самом деле прочитать маленький конвейер из однозадачных инструментов, что этот разборщик и раскрывает.

Как работает разбор команд

У Command Explainer две вкладки, и всё работает локально в браузере — никакие man-серверы не запрашиваются.

Explain a command — вставьте любую команду и получите разбор по флагам:

• Умный токенизатор — учитывает 'одинарные' и "двойные" кавычки, поэтому -name "*.log" остаётся одним аргументом
• Пайпы и операторы — разбивает по |, &&, ||, ; и редиректам вроде >, объясняя каждую команду и что делает оператор
• Каждая часть подписана — сама команда, склеенные короткие флаги (-xzvf → -x -z -v -f), опции со значением (-name, -mtime, -C) и каждый операнд, с цветовой маркировкой по роли
• Неизвестные флаги помечаются — то, чего нет в базе, обозначается, а не додумывается

Command cheatsheet — поисковый справочник по десяткам повседневных команд в восьми категориях (файлы, поиск, права и пользователи, архивы, удалённый доступ и передача, сеть, процессы, текст). У каждой команды — назначение, частые опции и реальные примеры; кнопка Explain у любого примера отправляет его прямо в разборщик.

Быстрый старт: откройте инструмент → введите find . -name "*.log" -mtime +7 -delete → увидите find = поиск по дереву каталогов, -name "*.log" = совпадение по шаблону, -mtime +7 = изменён более 7 дней назад, -delete = удалить каждое совпадение → проверьте, что хотели именно этого, перед запуском.

Похожие инструменты

Разбор команд LinuxПофлаговый разбор команд Linux с учётом пайпов и редиректов, а также поисковая шпаргалка по частым консольным командам с примерами.Калькулятор ChmodРасчёт прав доступа файлов Linux в восьмеричном коде (755, 644) и символьной записи (rwxr-xr-x) с SUID, SGID и пресетами.Cron Expression ParserПревращайте cron-выражение в понятное описание, смотрите разбор каждого поля и ближайшие запланированные запуски с пресетами и справкой.Калькулятор подсетейПроверяйте сеть, broadcast, host range, маски и бинарный вид для IPv4 или границы блока IPv6 по CIDR.