O comando man no Linux
Percebe a finalidade, lê a sintaxe e explora os exemplos antes de adaptares o comando ao teu sistema.
O que faz e quando utilizar
O comando man abre páginas de manual. É uma forma de aprender a sintaxe, as opções e os estados de saída que correspondem à versão da ferramenta instalada no computador.
Abre a página de manual do programa. Dentro do paginador, / procura texto e q sai.
O manual local corresponde à versão instalada e pode diferir de exemplos na Internet. man nome abre a documentação, apropos procura pela tarefa e whatis mostra o resumo. Para descobrir como a shell resolve um nome, usa type nome ou command -v nome.
Como escrever o comando
man [secção] nome
Os elementos entre [ ] são opcionais e as reticências indicam que um argumento pode repetir-se. Estes sinais explicam a estrutura: não são texto para escrever literalmente. Na secção seguinte encontras exemplos completos.
O nome man identifica a ferramenta ou o interno da shell. As opções ajustam o comportamento; os restantes argumentos indicam os dados, nomes ou caminhos usados na operação.
Opções e elementos importantes
| Opção ou elemento | Significado |
|---|---|
secção | Um número como 1 ou 5 distingue comandos de formatos de ficheiro. |
-k palavra | Pesquisa nomes e descrições dos manuais. |
/texto | Dentro do paginador, procura uma palavra. |
q | Sai do paginador habitual. |
Exemplos explicados
Começa pelos exemplos de consulta. Quando uma operação altera dados ou configurações, lê o aviso e confirma os argumentos antes de a executar.
1. Abre a página de manual do programa
Abre a página de manual do programa. Dentro do paginador, / procura texto e q sai.
man comando2. Abre o manual de ping
Abre o manual de ping; o manual local corresponde à versão instalada na tua máquina.
man pingErros frequentes e como os evitar
- Nomes de contas, pacotes, dispositivos e caminhos são ilustrativos: têm de corresponder ao sistema onde vais trabalhar.
- A distribuição e a versão instalada podem ter opções diferentes. Uma opção com o mesmo nome noutro programa pode ter outro significado.
Uma forma de praticar
Escolhe um dos exemplos acima e identifica o programa, cada opção e os argumentos. Explica por palavras tuas qual deverá ser o resultado. Se faltar um ficheiro, pacote ou dispositivo, resolve primeiro esse requisito; não acrescentes privilégios apenas para tentar eliminar uma mensagem de erro.
Testa primeiro uma variante de consulta, usando ficheiros de ensaio quando fizer sentido. Compara o resultado com a explicação e só depois acrescenta outra opção, para perceberes o efeito de cada alteração.