Man - команда Linux

человек-acdfFhkKtwW --дорожка -m система -п строка -С config_file -М pathlist -П пейджер -S section_list раздел название …

Опции

-C config_file

Укажите файл конфигурации для использования; по умолчанию используется/etc/man.config, (Увидетьman.conf(5).)

-M путь

Укажите список каталогов для поиска справочных страниц. Отделите каталоги двоеточиями. Пустой список такой же, как не указывать-М совсем. УвидетьПУТЬ ПОИСКА ДЛЯ РУЧНОЙ СТРАНИЦЫ.

-P пейджер

Укажите, какой пейджер использовать. Этот параметр переопределяетMANPAGER переменная среды, которая, в свою очередь, переопределяетПЕЙДЖЕР переменная. По умолчанию,человек использования/ usr / bin / less -isr.

-S section_list

Список представляет собой список разделов, разделенных двоеточиями, для поиска. Этот параметр переопределяетMANSECTпеременная среды.

-a

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

-с

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

-d

На самом деле не отображайте страницы руководства, но печатайте графы отладочной информации.

-D

Оба отображают и распечатывают информацию об отладке.

-f

Эквивалентночто такое.

-F или же--preformat

Только формат - не отображается.

-час

Распечатайте однострочное справочное сообщение и выйдите из него.

-k

Эквивалентнопо поводу.

-К

Найдите указанную строку в * all * man-страницах. Предупреждение: это, вероятно, очень медленно! Это помогает указать раздел. (Чтобы дать приблизительную идею, на моей машине это занимает около минуты на 500 страниц).

-m-система

Укажите альтернативный набор справочных страниц для поиска на основе заданного имени системы.

-p строка

Укажите последовательность препроцессоров для запуска доNroff или жеTROFF, Не все установки будут иметь полный набор препроцессоров. Некоторые из препроцессоров и буквы, используемые для их обозначения, следующие: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). Этот параметр переопределяетMANROFFSEQ переменная среды.

-t

использование/ usr / bin / groff -Tps -mandoc для форматирования страницы руководства, передачи вывода настандартный вывод. Выход из/ usr / bin / groff -Tps -mandoc может потребоваться передать через какой-либо фильтр или другой документ перед печатью.

-wили --path

На самом деле не отображайте страницы руководства, но распечатывайте местоположение (и) файлов, которые будут отформатированы или отображены. Если аргумент не задан: display (on stdout) список каталогов, поиск по которымчеловек для справочных страниц. ЕслиMANPATH является ссылкой на человека, тогда «manpath» эквивалентен «man -path».

-W

Как -w, но печатайте имена файлов по одному в строке без дополнительной информации. Это полезно в командах оболочки, таких какмужчина -aW человек | xargs ls -l

CAT-страницы

Человек попытается сохранить отформатированные man-страницы, чтобы сохранить время форматирования в следующий раз, когда эти страницы понадобятся. Традиционно форматированные версии страниц в DIR / manX сохраняются в DIR / catX, но другие сопоставления из каталога dir в cat dir могут быть указаны в/etc/man.config, Никакие страницы cat не сохраняются, если требуемый каталог cat не существует. Никакие страницы cat не сохраняются, если они отформатированы для длины строки, отличной от 80. Никакие страницы cat не сохраняются, когда man.conf содержит строку NOCACHE.

Можно сделатьчеловек для человека. Затем, если каталог cat имеет владельца и режим 0755 (доступен только для записи человеком), а файлы cat имеют владельца и режим 0644 или 0444 (только для записи человеком или вообще не доступны для записи), обычный пользователь не может изменять cat или поместить другие файлы в каталог cat. Есличеловек не делается suid, тогда каталог cat должен иметь режим 0777, если все пользователи смогут оставлять там страницы кота.

Опция-с принудительно переформатирует страницу, даже если существует последняя страница кошки.

Путь поиска для страниц руководства

человек использует сложный метод поиска файлов справочных страниц на основе опций вызова и переменных среды,/etc/man.configконфигурационный файл и некоторые встроенные соглашения и эвристики.

Прежде всего, когда название аргументчеловек содержит косую черту (/), человек предполагает, что это сама спецификация файла, и нет никакого поиска.

Но в нормальном случае, когда название не содержит косой черты,человек ищет различные каталоги для файла, который может быть страницей руководства для названной темы.

Если вы укажете-М pathlist вариант, pathlist представляет собой список каталогов, разделенных двоеточиямичеловекпоиск.

Если вы не указали-М но установитеMANPATH переменная среды, значение этой переменной - список каталогов, которыечеловек поиск.

Если вы не укажете явный список путей с-М или жеMANPATH, человек разрабатывает собственный список путей на основе содержимого конфигурационного файла/etc/man.config,MANPATH операторы в файле конфигурации идентифицируют определенные каталоги для включения в путь поиска.

Кроме того,MANPATH_MAPоператоры добавляют к пути поиска в зависимости от пути поиска команды (т. е. вашегоДОРОЖКАпеременная среды). Для каждого каталога, который может находиться в пути поиска команд,MANPATH_MAP statement указывает каталог, который должен быть добавлен в путь поиска для файлов страниц вручную.человек смотрит наДОРОЖКА переменная и добавляет соответствующие каталоги в путь поиска файла вручную. Таким образом, при правильном использованииMANPATH_MAP, когда вы выдаете командучеловек xyz, вы получите страницу руководства для программы, которая будет работать, если вы выдали командухуг.

Кроме того, для каждого каталога в пути поиска команд (мы будем называть его «командный каталог»), для которого вы не иметьMANPATH_MAPзаявление,человек автоматически ищет каталог справочной страницы «рядом», а именно в качестве подкаталога в самом каталоге команд или в родительском каталоге каталога команд.

Вы можете отключить автоматический поиск «поблизости», включивNOAUTOPATH заявление в/etc/man.config.

В каждом каталоге пути поиска, как описано выше,человек ищет файл с именем тема . раздел , с необязательным суффиксом на номер раздела и, возможно, суффикс сжатия. Если он не найдет такой файл, он будет выглядеть в любых подкаталогах, названныхчеловек N или жекошка N где N номер ручного раздела. Если файл находится вкошка N подкаталог,человек предполагает, что это форматированный файл справочной страницы (страница кота). Иначе,человек предполагает, что он неформатирован. В любом случае, если имя файла имеет известный суффикс сжатия (например,.gz), человек предполагает, что он gzipped.

Если вы хотите увидеть, где (или если)человек найдет страницу руководства для определенной темы, используйте--дорожка(-w).

Важный: Использовать человек команда ( % человек ), чтобы увидеть, как команда используется на вашем конкретном компьютере.