Guia do Linux/Iniciante+Intermediário/Como obter ajuda no sistema/Páginas de Manual
Páginas de Manual
[editar | editar código-fonte]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:
- Programas executáveis ou comandos internos
- Chamadas do sistema (funções oferecidas pelo kernel)
- Chamadas de Bibliotecas (funções dentro de bibliotecas do sistema)
- Arquivos especiais (normalmente encontrados no diretório
/dev
)
- Formatos de arquivos e convenções (
/etc/inittab
por exemplo).
- Jogos
- Pacotes de macros e convenções (por exemplo
man
)
- Comandos de Administração do sistema (normalmente usados pelo root)
- 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.