При работе в Linux иногда требуется чтение документации, руководств или help’ов. В Linux есть отличная документация, которая размещена в Man-страницах.
Что такое Man-страницы
Man-страницы (от слова manual — руководство) — это целая библиотека в системе Linux, содержащая руководства по командам, утилитам, программированию и другим областям системы и не только.
Как открыть Man-страницы
Для чтения Man-страниц предназначена команда man.
Чтобы получить руководство по использованию какой-либо команды нужно выполнить команду:
Например, чтобы вывести руководство по команде wget, нужно выполнить команду:
man wget
Синтаксис команды man
В общем виде синтаксис команды man следующий:
Разделы
Man-страницы разделены по тематикам на разделы (на секции). Каждый раздел имеет свой номер. Всего существует 8 основных разделов.
Если вы не указали раздел, при выполнении команды man, то сначала будет выполнен поиск руководства в первом разделе, если его там нет, то во втором и так далее.
Например, откроем руководство по команде sleep. В данном случае будет использоваться первый раздел.
man sleep
А теперь получим справку по библиотечному вызову sleep языка программирования C (раздел 3):
man 3 sleep
Ниже представлена таблица с номерами разделов и их назначением (тематикой).
Номер раздела | Описание |
---|---|
1 | Основные команды. |
2 | Системные вызовы. |
3 | Библиотечные функции, включая стандартную библиотеку языка C. |
4 | Специальные файлы (обычно устройства из /dev) и драйвера. |
5 | Форматы файлов и соглашения. |
6 | Игры и скринсейверы. |
7 | Разное. |
8 | Команды системного администрирования и демоны. |
Для указания ссылок на Man-страницы часто используют следующую запись: имя(раздел). Например, aporopos(1), less(1), exit(3).
Поиск Man-страниц
Самая полезная опция команды man, это опция -k.
-k — поиск Man-страниц. Выводит список Man-страниц, в которых встречается искомый запрос.
man -k kill
Горячие клавиши и поиск внутри Man-страницы
Вверх, Вниз, Enter — просмотр (прокрутка) Man-страницы.
PgUb, PgDn, Пробел — постраничное пролистывание.
/ - поиск внутри страницы. Нажимаете клавишу /, при этом внизу появляется строка для ввода текста. Вводите текст, который вы хотите найти, и нажимаете Enter.
? — поиск в обратном направлении (снизу вверх). Аналогично нужно ввести текст для поиска и нажать Enter.
n — переход к следующему вхождению.
Shift+n — переход к предыдущему вхождению.
& — поиск внутри страницы, но вместо подсвечивания результатов, вывести только строки, где было найдено искомое слово.
h — открыть справку по командам и горячим клавишам. Чтобы закрыть справку, используется клавиша q.
q — закрыть Man-страницу.
Установка Man-страниц
Как правило, базовые man-страницы обычно всегда установлены в дистрибутивах Linux, но иногда их нужно устанавливать самостоятельно. Для установки Man-страниц выполните следующие команды.
Для Ubuntu:
sudo apt install man-db manpages
Для Fedora, CentOS:
yum install man man-pages man-db
Для установки Man-страниц, содержащих описание библиотечных функций языка программирования C, выполните следующие команды.
Для Ubuntu:
sudo apt install manpages-dev manpages-posix-dev
Для Fedora:
yum install libstdc++-docs
Комментарии
15:33
https://sourceforge.net/projects/man-pages-ru/
Кроме Убунты/Дебиана и их *.деб модов почти у всех есть его пакеты (судя по pkgs.org), есть ППА но там совсем старая версия. Можно самому собрать, в хелпе написано как, но я думаю что лучше с помощью alien из Росы *.рпм пакет конвертнуть, он в ней самый свежий, там чуть больше 2300 манов на русском (версия от ноября 2018).
Кстати, в файл ~/.bashrc желательно добавить строку:
export MANOPT="-L ru"
Она указывает что вначале надо искать маны на русском, ну а если отсутствует то выводить на английском.
13:39
В README самого пакет не очевидно решение. * для меня.
00:16