Blog

O comando man no Linux oferece um manual de vários comandos do GNU Linux, bem como manual de outros programas de terceiros. O man oferece uma interface simplificada para os programadores oferecerem um manual de seus programas.

As páginas de manual acompanham quase todos os programas GNU/Linux e podem ser instaladas de acordo com a língua escolhida, se estiver disponível na distribuição.

As informações do man são chamadas de "Páginas do Man"  e elas trazem uma descrição básica de comandos e detalhes sobre o funcionamento de suas opções. 

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. 

Os documentos do manual são divididos em sessões de acordo com o assunto abordado. As sessões são numeradas de 1 a 9, a seguir:

1. Programas executáveis ou comandos de shell;
2. Chamadas do Sistema (funções fornecidas pelo Kernel);
3. Chamadas de Biblioteca (funções fornecidas pelas bibliotecas);
4. Arquivos especiais, especialmente aqueles localizados em /dev;
5. Formatos de arquivos e convenções;
6. Jogos;
7. Pacotes Macro;
8. Comandos administrativos;
9. Rotinas do kernel.

É possível que uma mesma palavra possa referenciar a uma função de programação, comando ou arquivo de configuração. Desta maneira é importante saber em qual sessão iremos encontrar a documentação desejada.

Cada página do manual é dividida em partes:

• NAME: Nome do item procurado com uma descrição curta;
• SYNOPSIS: Descrição completa do uso e sintaxe;
• DESCRIPTION: Descrição breve das funcionalidades;
• OPTIONS: Descrição de cada opção e argumentos;
• FILES: Uma lista de arquivos importantes;
• SEE ALSO: Uma lista de itens relacionados ao procurado;
• BUGS: Descrição de possíveis problemas com o item;
• AUTHOR: Lista de pessoas responsáveis pelo item.

Para acessar o manual, o comando é o man seguido do item procurado. Como opção, o número da sessão pode ser passada como parâmetro.

$ man passwd

Neste exemplo o man visualiza o manual do comando passwd, pertencente à sessão 1.

$ man 5 passwd

Já neste exemplo o man exibirá o manual do arquivo /etc/passwd.

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 Início 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.

Aprenda muito mais sobre Linux em nosso curso online. Você pode efetuar a matrícula aqui. Se você já tem uma conta, ou quer criar uma, basta entrar ou criar seu usuário aqui.

Gostou? Compartilhe