Tutorial do Comando man do Linux para Iniciantes (8 Exemplos)

Um aspecto muito útil da linha de comando do Linux é que a documentação para quase todas as ferramentas de linha de comando é facilmente acessível. Esses documentos são conhecidos como páginas man, e você pode acessá-los facilmente através da linha de comando usando o comando man.

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

Comando man do Linux

O comando man dá aos usuários acesso às páginas manuais para utilitários e ferramentas de linha de comando. A seguir está a sintaxe deste comando:

man [nome do comando/ferramenta]

E aqui está como a própria página manual do man o descreve:

 man - uma interface para os manuais de referência on-line  
  man é o pager manual do sistema. Cada argumento de página dado ao man é  
 normalmente o nome de um programa, utilitário ou função. A página manual  
 associada a cada um desses argumentos é então encontrada e exibida. Uma  
 seção, se fornecida, direcionará o man a olhar apenas naquela seção do  
 manual. A ação padrão é pesquisar em todas as seções disponíveis  
 seguindo uma ordem predefinida ("1 n l 8 3 2 3posix 3pm 3perl 5  
 4 9 6 7" por padrão, a menos que substituída pela diretiva SECTION em  
 /etc/manpath.config), e mostrar apenas a primeira página encontrada, mesmo que  
 a página exista em várias seções.  
  
 A tabela abaixo mostra os números das seções do manual seguidos dos  
 tipos de páginas que elas contêm.  
  
 1 Programas executáveis ou comandos de shell  
 2 Chamadas de sistema (funções fornecidas pelo kernel)  
 3 Chamadas de biblioteca (funções dentro de bibliotecas de programas)  
 4 Arquivos especiais (geralmente encontrados em /dev)  
 5 Formatos de arquivo e convenções, por exemplo, /etc/passwd  
 6 Jogos  
 7 Diversos (incluindo pacotes de macro e convenções), por exemplo,  
 man(7), groff(7)  
 8 Comandos de administração do sistema (geralmente apenas para root)  
 9 Rotinas do kernel [Não padrão]  
  
 Uma página manual consiste em várias seções.  
  
 Nomes de seções convencionais incluem NOME, SINOPSE, CONFIGURAÇÃO,  
 DESCRIÇÃO, OPÇÕES, STATUS DE SAÍDA, VALOR DE RETORNO, ERROS, AMBIENTE,  
 ARQUIVOS, VERSÕES, CONFORMIDADE, NOTAS, ERROS, EXEMPLO, AUTORES, e  
 VEJA TAMBÉM.

A seguir estão alguns exemplos no estilo Q&A que devem lhe dar uma boa ideia de como o comando man funciona.

Q1. Como usar o comando man?

O uso básico do man é muito simples - basta executar o comando com o nome da ferramenta cujo manual de referência você deseja acessar.

man [nome do comando/ferramenta]

Por exemplo:

man ls

Q2. Como fazer o man exibir a página manual de seções específicas?

Como já mencionado no início, todas as páginas manuais disponíveis estão segregadas em seções, e existem seções que contêm entradas de páginas man com o mesmo nome. Para facilitar as coisas para você, o comando man permite que você acesse diretamente as páginas manuais de seções específicas, algo que você pode fazer apenas especificando o número da seção antes do nome do comando/ferramenta.

man [número-da-seção] [nome do comando/ferramenta]

Por exemplo:

man 3 printf 

Q3. Como procurar páginas manuais e imprimir descrições curtas também?

Ao passar pela Q&A 2, alguém pode perguntar como lembrar os números das seções para entradas manuais com o mesmo nome. Bem, você não precisa fazer isso, pois existe uma opção de linha de comando ‘f’ que permite que o man exiba todas as páginas manuais que correspondem ao nome na entrada.

Por exemplo:

man -f printf

Aqui está a saída que o comando acima produziu no meu sistema:

Então você pode ver todas as entradas com o nome ‘printf’ - junto com os números das seções - foram exibidas na saída.

Q4. Como fazer o man exibir todas as páginas manuais para uma entrada dada?

Agora, e se você quiser que o man exiba uma a uma todas as páginas manuais correspondentes a uma entrada dada? Bem, isso é possível, e você terá que usar a opção de linha de comando -a para isso.

Por exemplo, se você quiser visualizar sequencialmente todas as páginas manuais para ‘printf’, você pode fazer isso da seguinte maneira:

man -a printf

O comando acima abrirá primeiro a página man do printf da seção 1, e quando você sair dela, o comando perguntará se você deseja visualizar a próxima página man do ‘printf’.

Q5. Como fazer o man pesquisar considerando a entrada como uma expressão regular?

Caso você queira que o comando man pesquise e liste páginas manuais considerando a entrada como uma expressão regular, você pode fazer isso usando a opção de linha de comando -k.

man -k [nome do comando/ferramenta]

Por exemplo:

man -k printf

Aqui está a saída que o comando acima produziu no meu sistema:

Q6. Como fazer o man exibir a localização das páginas manuais?

Caso a necessidade seja apenas saber a localização das páginas manuais, você pode forçar o man a fazer isso usando a opção de linha de comando -w.

man -w [nome do comando/ferramenta]

Por exemplo:

man -w printf

A seguir está a saída que este comando produziu no meu sistema:

/usr/share/man/man1/printf.1.gz

Q7. Como fazer o man exibir páginas manuais no navegador da Web?

Use a opção de linha de comando -H para isso.

man -H[comando-do-navegador] [nome do comando/ferramenta]

Por exemplo:

man -Hfirefox printf

Q8. Como fazer o comando man diferenciar maiúsculas de minúsculas?

Por padrão, o comando man ignora maiúsculas e minúsculas ao pesquisar páginas manuais. No entanto, se você quiser, pode habilitar a diferenciação de maiúsculas e minúsculas usando a opção de linha de comando -I.

man -I [nome do comando/ferramenta]

Conclusão

Então você pode ver que o man é um comando extremamente importante que os usuários - tanto novatos quanto profissionais - devem saber como usar. Nós apenas arranhamos a superfície aqui, pois a ferramenta oferece muitos recursos. Pratique esses primeiros, e quando terminar, dirija-se à página man do man para mais informações.