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

No Linux, se você precisar de ajuda em relação a um comando, tudo o que você precisa fazer é abrir sua página man. Mas e se surgir uma situação em que a necessidade é pesquisar rapidamente os nomes e descrições de todas as páginas man disponíveis? Bem, o Linux tem a solução, pois existe um comando chamado apropos que faz exatamente isso por você.

Neste tutorial, discutiremos os fundamentos do apropos usando alguns exemplos fáceis de entender. Mas antes de fazermos isso, vale a pena mencionar que todos os exemplos aqui foram testados em uma máquina Ubuntu 16.04 LTS.

O comando apropos pesquisa nomes e descrições de páginas man para uma palavra-chave fornecida pelo usuário. A seguir está sua sintaxe:

apropos [OPTIONS] keyword ...

E aqui está o que a página man da ferramenta diz sobre isso:

       Cada página manual tem uma descrição curta disponível dentro dela.   apropos  
       pesquisa as descrições em busca de instâncias da palavra-chave.

       palavra-chave  é  geralmente  uma expressão regular, como se (-r) fosse usada, ou pode  
       conter curingas (-w), ou corresponder à palavra-chave exata (-e).   Usando  
       essas  opções,  pode  ser  necessário  colocar a palavra-chave entre aspas ou escapar (
) os  
       caracteres especiais para impedir que o shell os interprete.

       As regras de correspondência padrão permitem que correspondências sejam feitas contra  
       o nome da página e limites de palavras na descrição.

       O banco de dados pesquisado pelo apropos é atualizado pelo programa mandb.  
       Dependendo da sua instalação, isso pode ser executado por um trabalho cron periódico,  
       ou pode precisar ser executado manualmente após novas páginas man terem sido  
       instaladas.

A seguir estão alguns exemplos no formato de perguntas e respostas que devem lhe dar uma boa ideia de como o comando apropos funciona.

Q1. Como usar apropos?

O uso básico é simples. Basta passar a palavra-chave que você deseja pesquisar como entrada para o comando apropos.

Por exemplo:

apropos dmesg

produziu o seguinte resultado:

dmesg (1)            - imprime ou controla o buffer de anel do kernel

Claro, você pode passar várias palavras-chave também.

Por exemplo:

apropos dmesg whereis

A seguir está a saída neste caso:

dmesg (1)            - imprime ou controla o buffer de anel do kernel  
whereis (1)          - localiza os arquivos binários, fonte e página manual para um...

Q2. Como fazer o apropos pesquisar palavras-chave exatas?

Por padrão, a entrada que você passa para o comando apropos não é pesquisada exatamente. Por exemplo, se você passar ‘who’ como entrada, você também verá a ferramenta produzindo resultados contendo palavras como ‘whoami’.

Então, isso não é uma pesquisa exata. No entanto, você pode forçar o apropos a pesquisar palavras-chave exatas usando as opções de linha de comando -e ou –exact.

Assim, agora você vê que apenas aquelas entradas que correspondem exatamente a ‘who’ foram exibidas na saída.

Q3. Como fazer o apropos exibir entradas que correspondem a todas as palavras-chave?

Se você passar várias palavras-chave como entrada para o comando apropos, a ferramenta irá gerar entradas que correspondem/contêm pelo menos uma das palavras-chave. No entanto, se você quiser que o apropos produza apenas aquelas entradas que correspondem/contêm todas as palavras-chave, então use a opção de linha de comando -a.

Por exemplo, aqui está a saída de um comando apropos sem a opção -a:

E aqui está a saída com a opção -a ativada:

Q4. Como forçar o apropos a não truncar a saída?

Como você teria visto na saída nas perguntas e respostas anteriores, a ferramenta trunca entradas se elas forem muito longas. Por exemplo, veja a linha destacada na seguinte saída:

No entanto, se você quiser, pode forçar o apropos a produzir linhas completas na saída, algo que você pode fazer usando a opção de linha de comando -l.

Q5. Como interpretar o status de saída do apropos?

O comando apropos produz quatro status de saída diferentes: 0, 1, 2 e 16. Aqui está o que cada um deles representa:

       0      Execução do programa bem-sucedida.

       1      Erro de uso, sintaxe ou arquivo de configuração.

       2      Erro operacional.

       16     Nada foi encontrado que correspondesse aos critérios especificados

Conclusão

Dependendo do seu perfil de trabalho, você pode não precisar do comando apropos diariamente, mas como você deve ter entendido até agora, ele pode ser um salvador em certas situações. Discutimos algumas opções de linha de comando aqui. Para saber mais sobre a ferramenta, acesse sua página man.