Linux – Conhecendo o comando man

Um dos comandos mais usados no Linux e que muita gente não o explora ou entende por completo. Por mais simples que parece, o seu uso pode salvar o usuário em uma situação que não existe uma conexão com a internet, e você não precisa de nenhum aplicativo extra para utilizar sendo necessário apenas um terminal shell e digitar man.

Trata-se do manual do sistema operacional, e com ele pode-se encontrar todos ou quase todos os comandos existentes no sistema. Por padrão as páginas do manual Linux encontram-se no diretório /usr/share/man. Para facilitar seu uso e entendimento é dividido em seções que vão de 1 a 9.

Seções do man

 

  1. Programas executáveis ou comandos do Shell.
  2. Chamadas do sistema – Linux System Calls
  3. Funções de bibliotecas – documentação de bibliotecas C padrão do sistema (bastante utilizado por desenvolvedores).
  4. Arquivos especiais – arquivos usados dentro do diretório /dev.
  5. Formato e convenções de arquivos – contém o formato de alguns arquivos como o /etc/passwd.
  6. Jogos – dicas e comandos de jogos existentes no sistema.
  7. Miscelânea de pacotes – documentação relacionada a pacotes, protocolos etc.
  8. Comandos administrativos – comandos do sistema utilizados principalmente pelo root.
  9. Rotinas do Kernel.

 

Alguns parâmetros:

Uso man [opção] comando/arquivo/expressão

  • sem parâmetros – abre a página do manual relacionada ao comando indicado.

Exemplo: Abre a página do manual relacionada ao ls.

-k – mostra referências de acordo com a expressão usada no argumento. Obtém-se um resultado semelhante utilizando o comando whatis.

-f – mostra descrições do comando em suas respectivas seções. Obtém-se um resultado semelhante utilizando o o apropos.

Com estas opções pode-se explorar e entender diversos comandos, rotinas da biblioteca C e exemplos de implementação/uso como por exemplo:

Um exemplo da saída de uma pagina (2) System Calls, que na maioria das vezes segue o mesmo modelo:

Name: Nome da função seguido de uma descrição de uma linha, a mesma utilizada pelo apropos

Synopsis: O protótipo em C da função e bem como os includes dos headers.

Description: Uma descrição do que a função/comando faz.

Return Value: Descrição do intervalo de valores do retorno da função, e o handler para informar estes erros.

Errors: Uma lista detalhada dos possíveis valores errno que são retornados em caso de um erro.

Conforming to: Descrição dos valores padrões UNIX que a função se enquadra. Dará uma visão do quanto portável é a aplicação para outras implementações UNIX.

Bugs: Uma descrição de coisas que estão quebradas ou que não estão funcionando como deveriam.

Notes: Adiciona diversas notas sobre a função.

See also: Lista de páginas de manual para funções e comandos relacionados.

Example: Não presente em todos System Calls, mas é um exemplo de implementação em C utilizando a função.

Use, abuse e explore as Paginas de Manuais do Linux que pode ser seu melhor amigo para administração do sistema ou desenvolvimento para o mesmo.

Até a próxima!

 

Referências

Livro: The Linux Programming Interface – Manual Pages Pag. 1420

Share Button

CC BY-NC-SA 4.0 Linux – Conhecendo o comando man by Cleiton Bueno is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.