Guia do Linux/Iniciante+Intermediário/Como obter ajuda no sistema/Páginas de Manual

Páginas de Manual

editar

As páginas de manual acompanham quase todos os programas GNU/Linux. Elas trazem uma descrição básica do comando/programa e detalhes sobre o funcionamento de opção. Uma página de manual é visualizada na forma de texto único com rolagem vertical. Também documenta parâmetros usados em alguns arquivos de configuração.

A utilização da página de manual é simples, digite:

man [seção] [comando/arquivo]

onde:

seção
É a seção de manual que será aberta, se omitido, mostra a primeira seção sobre o comando encontrada (em ordem crescente).
comando/arquivo
Comando/arquivo que deseja pesquisar.

A navegação dentro das páginas de manual é feita usando-se as teclas:

  • q - Sai da página de manual
  • PageDown ou f - Rola 25 linhas abaixo
  • PageUP ou w - Rola 25 linhas acima
  • SetaAcima ou k - Rola 1 linha acima
  • SetaAbaixo ou e - Rola 1 linha abaixo
  • r - Redesenha a tela (refresh)
  • p ou g - Inicio da página
  • h - Ajuda sobre as opções da página de manual
  • s - Salva a página de manual em formato texto no arquivo especificado (por exemplo: /tmp/ls).

Cada seção da página de manual contém explicações sobre uma determinada parte do sistema. As seções são organizadas em diretórios separados e localizadas no diretório /usr/man. Os programas/arquivos são classificados nas seguintes seções:

  1. Programas executáveis ou comandos internos
  1. Chamadas do sistema (funções oferecidas pelo kernel)
  1. Chamadas de Bibliotecas (funções dentro de bibliotecas do sistema)
  1. Arquivos especiais (normalmente encontrados no diretório /dev)
  1. Formatos de arquivos e convenções (/etc/inittab por exemplo).
  1. Jogos
  1. Pacotes de macros e convenções (por exemplo man)
  1. Comandos de Administração do sistema (normalmente usados pelo root)
  1. Rotinas do kernel (não padrões)

A documentação de um programa também pode ser encontrada em 2 ou mais categorias, como é o caso do arquivo host_access que é documentado na seção 3 (bibliotecas) e 5 (formatos de arquivo). Por este motivo é necessário digitar man 5 hosts_access para ler a página sobre o formato do arquivo, porque o comando man procura a página de manual nas seções em ordem crescente e a digitação do comando man hosts_access abriria a seção 3.

As páginas de manual contém algumas regras para facilitar a compreensão do comando:

  • Texto Negrito - Deve ser digitado exatamente como é mostrado
  • [bla bla bla] - Qualquer coisa dentro de [] são opcionais

Exemplo, man ls, man 5 hosts_access.