Учебное пособие по командам Linux manpath для начинающих (5 примеров)
На этой странице
- Учебник manpath для Linux
- Q1. Как работает команда manpath?
- Вопрос 2. Как иметь на выходе catpath вместо manpath?
- Вопрос 3. Как заставить manpath печатать отладочную информацию?
- Q4. Как сделать так, чтобы manpath обращался к другим ручным иерархиям ОС?
- В5. Как заставить manpath использовать собственный файл конфигурации?
- Заключение
Man-страницы в Linux — это место для поддержки первого уровня, когда речь идет об утилитах командной строки. Как известно большинству из вас, вы просто пишете man [имя-команды], и открывается соответствующая справочная страница. Но знаете ли вы путь, по которому ищутся эти справочные страницы?
В этом уроке мы обсудим manpath, утилиту, которая показывает вам эту информацию. Но прежде чем мы начнем с объяснения, стоит упомянуть, что все приведенные здесь примеры были протестированы на компьютере с Ubuntu 18.04 LTS.
Учебник по manpath для Linux
Команда manpath в Linux помогает определить путь поиска справочных страниц. Ниже приведен его синтаксис:
manpath [-qgdc?V] [-m system[,...]] [-C file]
А вот как это описывает справочная страница инструментов:
If $MANPATH is set, manpath will simply display its contents and issue
a warning. If not, manpath will determine a suitable manual page hier?
archy search path and display the results.
The colon-delimited path is determined using information gained from
the man-db configuration file - (/etc/manpath.config) and the user's
environment.
Ниже приведены несколько примеров в стиле вопросов и ответов, которые должны дать вам хорошее представление о том, как работает команда manpath.
Q1. Как работает команда manpath?
Основное использование довольно простое — просто выполните manpath без каких-либо опций.
manpath
Например, вот что вышеприведенная команда вывела на выходе в моей системе:
/usr/local/man:/usr/local/share/man:/usr/share/man
Как видите, manpath создает список путей для справочных страниц, разделенных двоеточиями.
Обратите внимание, что вы можете использовать параметр командной строки -g, если хотите создать manpath, состоящий из всех путей, названных глобальными в файле конфигурации man-db.
Q2. Как иметь на выходе catpath вместо manpath?
Для этого используйте параметр командной строки -c.
manpath -c
Вот как справочная страница инструментов объясняет эту операцию:
Once the manpath is determined, each path element is converted to its relative catpath.
Например, вот результат, полученный в моей системе:
/var/cache/man/oldlocal:/var/cache/man/local:/var/cache/man
Q3. Как заставить manpath печатать отладочную информацию?
Для этого используйте параметр командной строки -d.
manpath -d
Например, вот вывод этой команды в моей системе:
Согласен, вы не можете использовать эту опцию очень часто, но вы должны, по крайней мере, знать о ней на случай, если вам понадобится отладить вывод инструментов.
Q4. Как сделать так, чтобы manpath обращался к другим ручным иерархиям ОС?
Для этого используйте параметр командной строки -m. Вот как справочная страница инструментов объясняет эту опцию:
-m system[,...], --systems=system[,...]
If this system has access to other operating sys?
tem's manual hierarchies, this option can be used to
include them in the output of manpath. To include
NewOS's manual page hierarchies use the option -m
NewOS.
The system specified can be a combination of comma
delimited operating system names. To include the
native operating system's manual page hierarchies,
the system name man must be included in the argument
string. This option will override the $SYSTEM envi?
ronment variable.
Q5. Как заставить manpath использовать собственный файл конфигурации?
По умолчанию manpath извлекает информацию из следующего файла:
/etc/manpath.config
Однако, если вы хотите, вы можете заставить manpath читать любой другой файл. Это можно сделать с помощью параметра командной строки -C.
manpath -C NEWFILE-PATH
Заключение
Если ваша работа с командной строкой Linux связана с работой с справочными страницами, команда manpath будет для вас полезным инструментом. Здесь, в этом руководстве, мы обсудили большинство параметров командной строки manpath. Для получения дополнительной информации об инструменте перейдите на его справочную страницу.