мужчина форматирует и отображает онлайновые справочные страницы. Если вы укажете раздел, человек выглядит только в этом разделе руководства. Имя — это обычно имя страницы справочника, обычно это имя команды, функции или файла. Однако, если имя содержит косую черту (/) тогда человек интерпретирует это как спецификацию файла, так что вы можете сделать человек ./foo.5 или даже man /cd/foo/bar.1.gz. Смотрите ниже описание где человек ищет файлы справочных руководств.
имя
man — форматировать и отображать онлайновые справочные страницы
manpath — определить путь поиска пользователя для страниц man
конспект
человек [-acdfFhkKtwW] [—дорожка] [-м система] [-пстрока] [-С config_file] [-M список путей] [-п пейджер] [-Ssection_list] [раздел] имя …
Параметры
-C config_file
Укажите файл конфигурации для использования; по умолчанию /etc/man.config. (Видеть man.conf(5).)
-М путь
Укажите список каталогов для поиска справочных страниц. Разделите каталоги двоеточиями. Пустой список — это то же самое, что не указывать -M вообще. Видеть ПОИСК ПУТИ ДЛЯ РУЧНЫХ СТРАНИЦ.
-Пейджер
Укажите, какой пейджер использовать. Эта опция переопределяет MANPAGER переменная окружения, которая, в свою очередь, переопределяет ПЕЙДЖЕР переменная. По умолчанию, человек использования / usr / bin / less -isr.
-S section_list
Список — это список разделов, разделенных двоеточиями, для ручного поиска. Эта опция переопределяет MANSECTпеременная окружения.
—
По умолчанию, человек выйдет после отображения первой найденной страницы справочника. Использование этой опции заставляет человек отображать все справочные страницы, которые соответствуют имя, не только первый.
-с
Переформатируйте исходную справочную страницу, даже если существует обновленная страница cat. Это может иметь смысл, если страница cat была отформатирована для экрана с другим количеством столбцов, или если предварительно отформатированная страница повреждена.
-d
На самом деле не отображайте справочные страницы, а печатайте множество отладочной информации.
-D
Отобразить и распечатать отладочную информацию.
-е
Эквивалентно что такое.
-F или же —предварительно отформатированные
Только формат — не отображать.
-час
Распечатать однострочное справочное сообщение и выйти.
-К
Эквивалентно по поводу.
-К
Поиск указанной строки в * всех * справочных страницах. Предупреждение: это наверное очень медленно! Это помогает указать раздел. (Просто, чтобы дать общее представление, на моей машине это занимает около минуты на 500 страниц man.)
-м система
Укажите альтернативный набор справочных страниц для поиска на основе заданного имени системы.
-р строка
Укажите последовательность препроцессоров для запуска до 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 может потребоваться пройти через какой-то фильтр или другой перед печатью.
-вес или —path
На самом деле не отображайте справочные страницы, а распечатывайте расположение файлов, которые будут отформатированы или отображены. Если аргумент не указан: отобразить (в stdout) список каталогов, в которых выполняется поиск человек для справочных страниц. Если MANPATH это ссылка на man, тогда «manpath» эквивалентен «man —path».
-W
Как и -w, но печатать имена файлов по одному в строке без дополнительной информации. Это полезно в таких командах оболочки, как мужчина-мужчина | xargs ls -l
CAT страницы
Man попытается сохранить отформатированные страницы руководства, чтобы сэкономить время форматирования в следующий раз, когда понадобятся эти страницы. Традиционно отформатированные версии страниц в DIR / manX сохраняются в DIR / catX, но другие отображения от man dir к cat dir можно указать в /etc/man.config. Страницы cat не сохраняются, если требуемый каталог cat не существует. Страницы cat не сохраняются, если они отформатированы для длины строки, отличной от 80. Страницы cat не сохраняются, когда man.conf содержит строку NOCACHE.
Можно сделать человек Подходит пользователю. Затем, если каталог cat имеет владельца man и режим 0755 (доступен только для записи пользователем), а файлы cat имеют владельца man и режим 0644 или 0444 (доступен только для записи человеком или вообще не доступен для записи), ни один обычный пользователь не может изменить страницы кошки или поместите другие файлы в каталог кошки. Если человек не сделан suid, то каталог cat должен иметь режим 0777, если все пользователи должны иметь возможность оставлять там страницы cat.
Опция -с вызывает переформатирование страницы, даже если существует недавняя страница cat.
Путь поиска для справочных страниц
человек использует сложный метод поиска файлов страниц руководства, основанный на параметрах вызова и переменных среды, /etc/man.config файл конфигурации, а также некоторые встроенные соглашения и эвристики.
Прежде всего, когда имя аргумента человек содержит косую черту (/), человек Предполагается, что это сама спецификация файла, и в ней нет поиска.
Но в обычном случае, когда имя не содержит косую черту, человек ищет в различных каталогах файл, который может быть страницей руководства по названной теме.
Если вы укажете -M опция pathlist, pathlist — это разделенный двоеточиями список каталогов, которые человекпоиск.
Если вы не укажете -M но установить MANPATH переменная окружения, значение этой переменной представляет собой список каталогов, которые человек поиск.
Если вы не указали явный список путей с -M или же MANPATH, человек разрабатывает свой собственный список путей на основе содержимого файла конфигурации /etc/man.config. MANPATH операторы в файле конфигурации определяют конкретные каталоги для включения в путь поиска.
Кроме того, MANPATH_MAP операторы добавляют к пути поиска в зависимости от пути поиска команды (т. е. вашего ДОРОЖКА переменная окружения). Для каждого каталога, который может быть в пути поиска команд, MANPATH_MAP оператор указывает каталог, который должен быть добавлен к пути поиска файлов справочной документации. человек смотрит на ДОРОЖКА переменная и добавляет соответствующие каталоги к пути поиска файла справочной страницы. Таким образом, при правильном использованииMANPATH_MAP, когда вы даете команду человек XYZ, вы получаете страницу руководства для программы, которая будет работать, если вы введете команду хуг.
Кроме того, для каждого каталога в пути поиска команд (назовем его «каталогом команд»), для которого у вас нет MANPATH_MAP заявление, человек автоматически ищет каталог справочной страницы «рядом», а именно как подкаталог в самом каталоге команд или в родительском каталоге каталога команд.
Вы можете отключить автоматический поиск рядом, включив NOAUTOPATH заявление в/etc/man.config.
В каждом каталоге в пути поиска, как описано выше, человек ищет файл с именем темы.section, с необязательным суффиксом номера раздела и, возможно, с суффиксом сжатия. Если он не находит такой файл, он просматривает любые подкаталоги с именем человекN или кошкаN, где N — это номер секции в ручном режиме. Если файл находится в кошкаN подкаталога, человек Предполагается, что это отформатированный файл справочной страницы (страница cat). В противном случае, человек предполагает, что это не отформатировано. В любом случае, если имя файла имеет известный суффикс сжатия (например, .GZ), человек предполагает, что это сжато.
Если вы хотите увидеть, где (или если) человек найти страницу руководства для конкретной темы, используйте —дорожка (-вес) вариант.
Используйте команду man (% man), чтобы увидеть, как команда используется на вашем компьютере.
