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

Страницы man в Linux — это первое место, куда стоит обратиться за поддержкой, когда речь идет о командных утилитах. Как большинство из вас знает, достаточно написать ‘man [имя-команды]’, и соответствующая страница man появится. Но знаете ли вы путь, по которому эти страницы man ищутся?

В этом учебнике мы обсудим manpath, утилиту, которая показывает вам эту информацию. Но прежде чем мы начнем объяснение, стоит упомянуть, что все примеры здесь были протестированы на машине с Ubuntu 18.04 LTS.

Учебник по manpath в Linux

Команда manpath в Linux помогает вам определить путь поиска для страниц руководства. Вот ее синтаксис:

manpath [-qgdc?V] [-m system[,...]] [-C file]

А вот как страница man инструмента описывает это:

       Если  $MANPATH установлено, manpath просто отобразит его содержимое и выдаст
       предупреждение.  Если нет, manpath определит подходящий путь поиска для
       иерархии страниц руководства и отобразит результаты.

       Путь, разделенный двоеточиями, определяется с использованием информации, полученной из
       конфигурационного файла man-db - (/etc/manpath.config) и окружения пользователя.

Следующие примеры в формате вопросов и ответов должны дать вам хорошее представление о том, как работает команда manpath.

Вопрос 1. Как работает команда manpath?

Основное использование довольно простое — просто выполните ‘manpath’ без каких-либо опций.

manpath

Например, вот что выдало вышеуказанная команда на моей системе:

/usr/local/man:/usr/local/share/man:/usr/share/man

Таким образом, вы можете видеть, что manpath выдает список путей для страниц руководства, разделенный двоеточиями.

Обратите внимание, что вы можете использовать командную опцию -g, если хотите получить manpath, состоящий из всех путей, названных ‘глобальными’ в конфигурационном файле man-db.

Вопрос 2. Как получить catpath в выводе вместо manpath?

Для этого используйте командную опцию -c.

manpath -c

Вот как страница man инструмента объясняет эту операцию:

Как только manpath определен, каждый элемент пути преобразуется в его относительный catpath.

Например, вот вывод, полученный на моей системе:

/var/cache/man/oldlocal:/var/cache/man/local:/var/cache/man

Вопрос 3. Как заставить manpath выводить отладочную информацию?

Для этого используйте командную опцию -d.

manpath -d

Например, вот вывод, который эта команда выдала на моей системе:

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

Вопрос 4. Как заставить manpath получать доступ к иерархиям руководств других ОС?

Для этого используйте командную опцию -m. Вот как страница man инструмента объясняет эту опцию:

-m system[,...], --systems=system[,...]  
              
              Если  эта  система  имеет доступ к иерархиям руководств других операционных систем,
              эта опция может быть использована для их включения в вывод manpath. Чтобы включить
              иерархии страниц руководства NewOS, используйте опцию -m NewOS.
              
              Указанная система может быть комбинацией имен операционных систем, разделенных запятыми.
              Чтобы включить иерархии страниц руководства родной операционной системы,
              имя системы man должно быть включено в строку аргументов.
              Эта опция переопределит переменную окружения $SYSTEM.

Вопрос 5. Как заставить manpath использовать пользовательский конфигурационный файл?

По умолчанию manpath получает информацию из следующего файла:

/etc/manpath.config

Однако, если вы хотите, вы можете заставить manpath читать любой другой файл. Это можно сделать с помощью командной опции -C.

manpath -C NEWFILE-PATH

Заключение

Если ваша работа в командной строке Linux связана с работой со страницами man, команда manpath — полезный инструмент для вас. Здесь, в этом учебнике, мы обсудили большинство опций командной строки manpath. Для получения дополнительной информации об инструменте перейдите на его страницу man.