Abordagem dos manuais dentro do Linux

[Ironmaniaco]

Pessoal.

Gostaria de neste tópico, abordar um pouco sobre o “melhor amigo” do operador Linux: O Manual – man.
Há uma antiga sigla, dentro do mundo UNIX, que era muito utilizada, para usuários que entravam em grupo de discussões e faziam perguntas “primárias”: RTFM. “Read The Fuc***** Manual”.
Esta expressão ainda é muuuuuuuito utilizada em grupos de estudo onde pessoas postam este tipo de coisas(primárias), ou fazem perguntas fora do contexto, e quer saber de uma coisa...
....por incrível que pareça, em alguns momentos eles estão certos.

Ninguém nasce sabendo isto é óbvio, por isto dentro do Linux a maioria dos programas que é desenvolvido possui seu manual. Não apenas programas, mas arquivos de configuração do sistema, arquivos de configuração de alguns programas, mas Porque? Porque seria realmente chato você, como programador de uma ferramenta para o Linux, ainda ter de aturar e-mails perguntando sobre o funcionamento do programa, cada função do código fonte, o que cada “header” do programa faz, quais bibliotecas que o mesmo utiliza e tudo mais. Por isto, creio eu que, uma das bases dentro do Linux é saber utilizar o man.

O man é um utilitário de organização dos manuais de todos os programas dentro do linux, que utiliza o comando less para efetuar a leitura dos mesmos. Os manuais, não passam de arquivos “texto puro” que contém informações sobre um programa específico, e são armazenados dentro de diretórios.

Todo programa quando é instalado(através de compilação ou pacote), possui um “mandir”, ou seja, um diretório para onde é encaminhado o seu manual e geralmente este diretório fica dentro da estrutura: /usr/man/share . Dentro destes diretórios estão os manuais dos seus programas divididos por programas e seções.

Para você acessar um manual, basta utilizar o comando man
Exemplo:

[nicolas@hell ~]$ man man

man(1)                                                         man(1)

NAME
 man - format and display the on-line manual pages
 manpath - determine user's search path for man pages

SYNOPSIS
 man [-acdfFhkKtwW] [--path] [-m system] [-p string] [-C config_file]
 [-M pathlist] [-P pager] [-S section_list] [section] name ...


DESCRIPTION
 man formats and displays the on-line manual pages.  If you specify
 section, man only looks in that section of the manual.  
 name is normally the name of the manual page, which is typically the 
 name of a  command, function, or file.  However, if name contains a 
 slash (/) then man interprets it as a file specification, so that you
 can do man ./foo.5 or even man /cd/foo/bar.1.gz.

.
.
.

Dentro do manual, possuímos a descrição completa da Sintaxe do comando, e de suas respectivas opções detalhadas(no exemplo acima entrei no manual do comando man, e postei apenas o “cabeçalho” do mesmo).

Caso você não saiba a sintaxe do comando ls, por exemplo?

[nicolas@hell ~]$ man ls

Mas, e de que forma os manuais são organizados, se eles podem ter qualquer tipo de informação?
Pois bem, os manuais no Linux são separados em Seções, e cada seção corresponde a uma funcionalidade. São 8 seções diferentes que guardam tipos diferentes de informações:

Seção 1 – Informações pertinentes a usuários(como vocês podem ver no manual acima, existe a informação “man (1)” no cabeçalho do manual....isto quer dizer que estou no manual do utilitário man, na seção 1. Ela é acessada geralmente apenas digitando man [programa/comando]).

Seção 2 – Chamadas de sistema utilizadas pelo Kernel.

Seção 3 – Bibliotecas e sub-rotinas do programa. Descreve bibliotecas que não são chamadas de sistema vindas diretamente do Kernel.

Seção 4 – Arquivos especiais, dispositivos e rede. Inclui geralmente informações sobre algum dispositivo que é acessado em /dev

Seção 5 – Arquivos de configuração, includes, e arquivos de “output” de um determinado programa são abordados nesta seção.

Seção 6 – Jogos e programas triviais. Cada pessoa possui uma opinião diferente sobre esta seção...hehehheh

Seção 7 – Misc: Tudo aquilo que não se encaixar dentro das outras seções definidas.

Seção 8 – Administração de sistema. Qualquer documento sobre manutenção do sistema é alocado aqui. Alguns programas possuem esta seção “aberta” para o usuário, por possuir informações úteis.

Como eu acesso determinada seção de um programa?

[nicolas@hell ~]$ man [seção] [programa]

Exemplos:

[root@hell ~]# man 8 ifconfig
[root@hell ~]# man 5 passwd

E caso eu queira acessar todos os manuais de um determinado programa

[nicolas@hell ~]$ man -a [programa]

Para foleá-los(trocar de seção) basta apertar Barra de espaço.
Para sair, pressione q

==========================================
O man é meu único amigo dentro do Linux para esclarecimento de dúvidas?
Não. Existem muitos sites de documentação oficial e de ajuda como por exemplo:

The Linux Documentation Project: http://www.tldp.org
Kernel Newbies: http://kernelnewbies.org/
Br-Linux: http://br-linux.org/
VivaOLinux: http://vivaolinux.com.br/

Ou ainda, você lembra da antiga “Usenet”, que foi adquirida pelo google?
Pois é, entre no Google, e busque por grupos que comecem com “comp.os.linux”. São uma seqüência de grupos que tratam de diferentes assuntos, com mailist, e você pode remeter e-mails com dúvidas(desde que coerentes )
Exemplos:

comp.os.linux.network = Redes e Linux
comp.os.linux.hardware = Hardware e Linux
comp.os.linux.advocacy = Linux e leis(advocacia)
comp.os.linux.redhat = Questões e dúvidas sobre o redhat Linux

e por aí vai!
Espero ter ajudado...

[sorackalves]

Muito bom ^^

[Pl4c3b0_]

Olí!

Excelente Ironmaniaco, utilizar o man é indispensível não só para iniciantes no mundo Linux, mas para todos de um modo geral, como deixa claro sua matéria.

Vou deixar fixo e espero que todos leiam, sendo assim muitos chingamentos em grupos de estudo serão evitados rss

[Ironmaniaco]

Justamente...
Claro que, por exemplo, todo mundo pode ter dúvidas de como o "apropos" funciona, ou o que o "rm" faz, mas para evitar "vexames" em grupos de discussão, pelo menos a sintaxe deve ser entendida

(Mudar MAC address com o ifconfig, eu "deduzi" lendo o manual :P) :mrgreen:

[j0el]

Ta show de bola seu tutorial!

Realmente o uso das paginas de manuais é essencial para qualquer um, existe ate um projeto de tradução do man.

http://br.tldp.org/projetos/man/man.html

[Ironmaniaco]

Algumas distros possuem rasa documentação em Português....mas jí dí uma ajuda :mrgreen:

[MaRKauM]

Exelente tópico!

Podemos lembrar também de outra ferramenta muito eficaz na solução de problemas:
www.google.com

Não custa nada fazer uma busca simples antes de postar uma dúvida!
A maioria das dúvidas que encontro em fóruns eu encontro a resposta entre os 5 primeiros links no google. Basta não ficar sentado esperando que a resposta caia no colo... :roll:

P.S.: Sim, estou voltando a ativa no fórum. Não que eu tenha feito muita falta no fórum, não a paciência do Iron para escrever artigos... 8)

[Pl4c3b0_]

Olí!
Bom vê-lo de volta no fórum, MaRKauM!

]['s
placebo.

[Fcanlogger]

Para sair, pressione q

Essa era a parte mais confusa pra mim no man, juro, eu não sabia como fechar ele XD.

[4L3X]

tem tb o comando --help que as vezes é util