Команда man в Linux: как читать справку и правильно выходить

Понимание нюансов каждой команды в Linux может быть сложной задачей как для новичков, так и для опытных пользователей. Одним из основных инструментов справки является команда man. Ниже — полное руководство: как пользоваться man, что искать в странице руководства и как корректно выйти из просмотра.

Что такое команда man в Linux

man (от «manual») — это стандартный просмотрщик и система локальной документации в Unix-подобных системах. man показывает «man-страницы» (manual pages) — структурированные документы с описанием команд, их опций, формата файлов и примеров использования.

Man-страницы обычно организованы в разделы (sections). Короткое объяснение разделов:

• 1 — пользовательские команды (bin).
• 2 — системные вызовы ядра.
• 3 — библиотечные функции (C-библиотеки).
• 4 — устройства и драйверы.
• 5 — форматы файлов и конфига.
• 6 — игры и демонстрационные программы.
• 7 — разнообразная информация и макросы.
• 8 — системные утилиты и администрирование.

Когда вы указываете только имя команды, man по умолчанию ищет в разделе 1. Чтобы открыть конкретный раздел, укажите его перед именем, например:

man 5 passwd

Это покажет документацию формата файла /etc/passwd в разделе 5.

Быстрый пример: открыть man для ls

Откройте терминал и введите:

man ls

Вы увидите заголовок, SYNOPSIS, описание и список опций. Навигация выполняется через ваш pager (обычно less). Для поиска используйте символ /, для перехода к следующему совпадению — n.

Важно: имена файлов изображений сохранены без изменений; мы обновили только текст описания (ALT) для доступности.

Как выйти из просмотра man

Самый прямой и надёжный способ выйти — нажать q (lowercase): это закроет pager и вернёт вас в приглашение shell. Дополнительные варианты:

• q — стандартно закрыть less и выйти из man.
• Ctrl+Z — приостановить процесс man и вернуть control в shell; затем bg отправит задачу в фон, fg вернёт в передний план.
• Ctrl+C — принудительно прервёт процесс (не рекомендуется, но работает).

Мини‑плейбук для выхода:

1. Нажмите q.
2. Если q не срабатывает (редко), нажмите Ctrl+C.
3. Если вы хотите временно приостановить и вернуть позже — Ctrl+Z, затем fg для возобновления и q для выхода.

Навигация и полезные клавиши pager (less)

• q — выйти.
• Space — страница вперёд.
• b — страница назад.
• /pattern — найти pattern вперёд.
• ?pattern — искать назад.
• n — следующее совпадение.
• N — предыдущее совпадение.
• g — перейти в начало.
• G — перейти в конец.
• h — справка для less.

Как быстро найти нужную man-страницу

• man -k pattern — ищет ключевые слова в базах man (аналог apropos).
• apropos pattern — похож на man -k.
• whatis command — краткое описание команды (из базы man).
• man -f command — эквивалент whatis.

Примеры:

man -k archive
apropos ssh
whatis ls
man -f printf

Альтернативы и доп. инструменты

• –help / -h: краткая встроенная справка команды, например ls –help.
• tldr: короткие практические подсказки и примеры (нужно установить npm/pkgs).
• explainshell: веб‑сервис, разбирающий сложные команды на части с объяснениями.
• info: GNU info — альтернативная система документации с другой структурой (иногда содержит более подробные руководства).

Когда использовать что:

• Нужны длинные формальные описания, разделы и стандарты — man.
• Нужен быстрый пример или краткая подсказка — tldr или –help.
• Понять сложную командную строку — explainshell.

Практическая методика чтения man-страницы

1. Быстро смотрите раздел NAME — короткое описание команды.
2. SYNOPSIS — структура вызова и параметры.
3. OPTIONS — список опций и флагов.
4. DESCRIPTION и EXAMPLES — подробности и примеры.
5. SEE ALSO — связанные команды и документы.

Эта последовательность экономит время: сначала понять «что она делает», затем «как её вызывать», и только потом — детали.

Хак: менять pager и формат вывода

• PAGER и MANPAGER — переменные окружения, которые определяют, какой pager используется:

export PAGER=less
export MANPAGER="less -R"

• man -P “less -S” command — временно использовать другой pager.
• man -t command | ps2pdf - output.pdf — сгенерировать PDF (если установлены необходимые утилиты).

Роли и чек‑листы

Новичок — чеклист:

• Открыть man для команды: man <команда>
• Найти SYNOPSIS и OPTIONS
• Использовать / для поиска нужной опции
• Выйти нажатием q

Системный администратор — чеклист:

• Проверить нужный раздел (man 5, man 8 и т. п.)
• Использовать man -k или apropos для поиска связанных утилит
• Настроить MANPATH или MANPAGER при необходимости
• Создать локальные man-страницы для внутренних утилит, если требуется

Когда man не помогает или вводит в заблуждение

• Старые/локальные системы могут иметь устаревшие man‑страницы.
• Не все опции отображаются в однострочном формате –help; иногда man даёт более официальную информацию.
• Некоторые пакеты не устанавливают man-страницы (в минимальных контейнерах). В таких случаях пользуйтесь онлайн‑документацией или –help.

Краткая шпаргалка (cheat sheet)

• Открыть: man command
• Раздел: man 5 filename
• Найти по ключевым словам: man -k pattern
• Кратко: command –help или man -f command
• Выйти: q

Решение проблем: если man не открывается

1. Убедитесь, что пакет man установлен (например, package man-db или man).
2. Проверьте MANPATH: echo $MANPATH или manpath.
3. В контейнере/минимальной системе установите нужные man-страницы или используйте online docs.

Короткий глоссарий

• man — утилита просмотра man-страниц.
• pager — программа для постраничного отображения (обычно less).
• SYNOPSIS — демонстрация синтаксиса команды.
• SECTION — разделы man-страниц (1–8).
• MANPAGER/PAGER — переменные окружения для выбора pager.

FAQ

Как быстро выйти из man?

Нажмите q. Если не помогает — Ctrl+C или Ctrl+Z затем fg и q.

Чем отличается man от –help?

–help даёт краткую встроенную справку; man даёт формальную и структурированную документацию.

Как искать команды по смыслу?

Используйте man -k или apropos, например man -k compress.

Итог

man — это мощный и стандартный способ узнать о командах, их опциях и форматах файлов в Linux. Освойте базовую навигацию (q, /, n), научитесь искать через man -k и настраивать MANPAGER — и работа в терминале станет быстрее и надёжнее.

Примечание: если вы часто используете короткие примеры — установите и используйте tldr для быстрых подсказок.