С точки зрения Linux все
С точки зрения Linux все man-страницы в системе являются частью единого руководства. Это руководство состоит из следующих разделов:
1 — исполняемые программы или команды оболочки;
2 — системные функции;
3 — библиотечные функции;
4 — специальные файлы (обычно находящиеся в /dev);
5 — форматы файлов и соглашения;
6 — игры;
7 — разное;
8 — команды системного администрирования;
9 — нестандартные функции ядра;
n — новая документация, которая позднее может быть перемещена;
l — локальная документация, специфическая для вашей системы.
Каждая отдельная программа, утилита или функция представлена в этом руководстве отдельной страницей. Поиск страницы для программы или команды обычно сводится к вводу команды man foo, где foo — имя программы.
Вероятно, вам также попадались нумерованные ссылки на man-страницы вида grep(1). Такая ссылка обозначает страницу man grep из раздела 1. Она вызывается следующим образом:
$ man 1 grep
Некоторые man-страницы входят в несколько секций. Команда man foo отобразит только первую из них. Для получения полного списка следует указать ключ -f:
$ man -f man man (1) an interface to the online reference manuals man (7) macros to format man pages
Каждая man-страница делится на секции. Имена секций бывают разными, но чаще всего встречаются следующие: NAME, SYNOPSIS, DESCRIPTION, OPTIONS, FILES, EXAMPLES, SEE ALSO, BUGS и AUTHOR.
Описание синтаксиса команды находится в секции SYNOPSIS man-страницы и выглядит следующим образом:
имя_команды [необязательные ключи] обязательные_элементы
При описании ключей команды используются следующие обозначения:
- жирный шрифт — вводится точно так, как показано;
- курсив — обозначает аргумент, заменяемый конкретным значением. В зависимости от используемой программы просмотра вместо курсива может использоваться подчеркивание текста или жирный шрифт;
- [-abc] — все ключи в квадратных скобках являются необязательными и их можно комбинировать друг с другом;
Чтобы узнать текущий путь поиска man-страниц, выполните команду manpath без параметров:
$ manpath /usr/local/man:/usr/share/man:/usr/X11R6/man:/usr/man См. также
manpath(1); manpath(5).
