Поиск по сайту:

Учебное пособие по командам Linux manpath для начинающих (5 примеров)


На этой странице

  1. Учебник manpath для Linux
  2. Q1. Как работает команда manpath?
  3. Вопрос 2. Как иметь на выходе catpath вместо manpath?
  4. Вопрос 3. Как заставить manpath печатать отладочную информацию?
  5. Q4. Как сделать так, чтобы manpath обращался к другим ручным иерархиям ОС?
  6. В5. Как заставить manpath использовать собственный файл конфигурации?
  7. Заключение

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. Для получения дополнительной информации об инструменте перейдите на его справочную страницу.