Tutorial do Comando manpath do Linux para Iniciantes (5 Exemplos)

As páginas man no Linux são o local ideal para suporte de primeiro nível quando se trata de utilitários de linha de comando. Como a maioria de vocês deve saber, você apenas escreve ‘man [nome-do-comando]’ e a página man correspondente aparece. Mas você sabe o caminho onde essas páginas man são procuradas?

Neste tutorial, discutiremos manpath, uma ferramenta que mostra essa informação. Mas antes de começarmos com a explicação, vale a pena mencionar que todos os exemplos aqui foram testados em uma máquina Ubuntu 18.04 LTS.

Tutorial do manpath no Linux

O comando manpath no Linux ajuda você a determinar o caminho de busca para as páginas manuais. A seguir está sua sintaxe:

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

E aqui está como a página man da ferramenta a descreve:

       Se  $MANPATH estiver definido, manpath simplesmente exibirá seu conteúdo e emitirá
       um aviso.  Se não, manpath determinará um caminho de busca hierárquico de página
       manual adequado e exibirá os resultados.

       O  caminho  delimitado por dois pontos  é determinado usando informações obtidas do
       arquivo de configuração do man-db - (/etc/manpath.config)  e  do  ambiente do
       usuário.

A seguir estão alguns exemplos em estilo de perguntas e respostas que devem lhe dar uma boa ideia de como o comando manpath funciona.

Q1. Como o comando manpath funciona?

O uso básico é bastante simples - basta executar ‘manpath’ sem nenhuma opção.

manpath

Por exemplo, aqui está o que o comando acima produziu como saída no meu sistema:

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

Então você pode ver, manpath produz uma lista de caminhos separados por dois pontos para páginas manuais.

Note que você pode usar a opção de linha de comando -g caso queira produzir um manpath consistindo de todos os caminhos nomeados como ‘global’ dentro do arquivo de configuração do man-db.

Q2. Como ter catpath na saída em vez de manpath?

Para isso, use a opção de linha de comando -c.

manpath -c

Aqui está como a página man da ferramenta explica essa operação:

Uma vez que o manpath é determinado, cada elemento do caminho é convertido em seu catpath relativo.

Por exemplo, aqui está a saída produzida no meu sistema:

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

Q3. Como fazer o manpath imprimir informações de depuração?

Para isso, use a opção de linha de comando -d.

manpath -d

Por exemplo, aqui está a saída que este comando produziu no meu sistema:

Concordo, você pode não usar essa opção com muita frequência, mas deve pelo menos estar ciente dela caso precise depurar a saída da ferramenta.

Q4. Como fazer o manpath acessar hierarquias manuais de outros sistemas operacionais?

Para isso, use a opção de linha de comando -m. Aqui está como a página man da ferramenta explica essa opção:

-m system[,...], --systems=system[,...]  
                
              Se  este  sistema  tiver acesso a outras hierarquias manuais de sistemas
              operacionais, esta opção pode ser usada para incluí-las na saída do manpath.
              Para incluir as hierarquias de páginas manuais do NewOS, use a opção -m
              NewOS.

              O  sistema  especificado pode ser uma combinação de nomes de sistemas
              operacionais delimitados por vírgulas.   Para  incluir  as  hierarquias  de
              páginas manuais do sistema operacional nativo, o nome do sistema man deve
              ser incluído na string de argumento.  Esta opção substituirá a variável de
              ambiente $SYSTEM.

Q5. Como fazer o manpath usar um arquivo de configuração personalizado?

Por padrão, o manpath busca informações no seguinte arquivo:

/etc/manpath.config

No entanto, se você quiser, pode forçar o manpath a ler qualquer outro arquivo. Isso pode ser feito usando a opção de linha de comando -C.

manpath -C CAMINHO-DO-NOVO-ARQUIVO

Conclusão

Se o seu trabalho na linha de comando do Linux envolve lidar com páginas manuais, o comando manpath é uma ferramenta útil para você. Aqui, neste tutorial, discutimos a maioria das opções de linha de comando do manpath. Para mais informações sobre a ferramenta, acesse sua página man.