Documentație Linux: localizare, accesare și utilizare

De multe ori suntem nevoiți să aflăm repede soluția la o problemă în Linux - ori nu avem acces la internet (cazul unui examen RHCSA), ori trebuie să rezolvăm într-un timp foarte scurt neregula apărută.

Să presupunem că tocmai v-ați hotărât să renunțați la găzduirea shared și v-ați luat primul VPS, v-ați conectat prin ssh și ați început configurarea sa. Mai jos sunt descrise posibilitățile prin care puteți să accesați întreaga documentație de care dispune distribuția voastră Linux.

Comanda man

Probabil este cea mai cunoscută metodă prin intermediul căreia putem să citim manualul unei comenzi în Linux; indiferent de distribuție, comanda man nume_comandă ne afișează modul de utilizare a comenzii în cauză. Iar dacă doriți să știți ce poate man, rulați:

$ man man

Pentru a afla mai repede ce pagină de manual căutăm, rulăm comanda apropos însoțită de cuvântul dorit; să presupunem că vrem să aflăm mai multe despre passwd, precum și ce pagină de manual să deschidem:

$ apropos passwd

Rezultatul este mai jos (fiecare pagină de manual este însoțită de o scurtă descriere):

Putem rula man 5 passwd pentru a afla informații despre fișierul /etc/passwd,  man 1 passwd pentru a afla cum se folosește comanda passwd pentru a schimba parola, etc.

De multe ori dorim să citim manualul unei comenzi proaspăt instalate, dar comanda man nu ne afișează nimic în afară de No manual entry for ....  Trebuie doar să actualizăm baza de date cu pagini man rulând comanda:

$ mandb

Într-o distribuție Linux, toate paginile de manual sunt stocate în directorul /usr/share/man/.

Comanda info

Utilitarul info este folosit pentru a afla informații despre o anumită resursă Linux - pentru documentația GNU/Linux; de fapt, multă documentație a migrat de la man la info.

Pentru a afla informații despre o comandă:

$ info nume_comandă

Info caută în directorul /usr/share/info:

$ ls /usr/share/info

Nu toate comenzile au informație aferentă în /usr/share/info; dacă, de exemplu, rulăm comanda info passwd, ni se va deschide automat pagina man a comenzii passwd. Totuși, multă lume preferă man - pentru mine, aflat în lumea Linux de foarte mulți ani, rularea man a devenit o obișnuință.

Info are informație diferită față de man. Navigarea în interiorul Info se face cu ajutorul nodurilor (sau secțiuni). Într- anumită secțiune Info, pentru a ne muta mai jos cu un rând, ori înainte, ori cu o linie, vom folosi tasta cu săgeata jos; pentru a merge în sus, ori înapoi, vom folosi tasta cu săgeata în sus. dacă am ajuns la finalul unei anumite secțiuni, cursorul se oprește.

Dacă dorim să merge cu un ecran în sus sau în jos, vom folosi tastele PageDown sau PageUp. În locul acestor taste, putem folosi Backspace sau Delete - acestea oferă, în plus față de PageUp și PageDown, avantajul că, ajunși la finalul unui nod, trece mai departe la nodul următor. pentru a ajunge sus, la primul nod, apăsăm tasta T. Info are multe scurtături de tatse și este aproape imposibil pentru cineva care interacționează ocazional cu această uinealtă să lețină minte pe toate. Din fericire, simpla apăsare a tastei H (SHIFT + h) ne arată toate scurtăturile disponibile.

Dacă scriem doar simpla comandă info, ne va apărea directorul principal info, care conținea toate nodurile disponibile.

Cu tasta Q ieșim din instrumentul info:

Info este un instrument deosebit de util atunci când am uitat ce face, cum s ecomportă sau cum se folosește o resursă Linux.

Parametrul --help

Aproape fiecare program poate apela câteva informații ajutătoare prin intermediul parametrului --help sau -h:

$ passwd --help
Usage: passwd [OPTION...] <accountName>
-k, --keep-tokens keep non-expired authentication tokens
-d, --delete delete the password for the named account (root only); also removes password
lock if any
-l, --lock lock the password for the named account (root only)
-u, --unlock unlock the password for the named account (root only)
-e, --expire expire the password for the named account (root only)
-f, --force force operation
-x, --maximum=DAYS maximum password lifetime (root only)
-n, --minimum=DAYS minimum password lifetime (root only)
-w, --warning=DAYS number of days warning users receives before password expiration (root only)
-i, --inactive=DAYS number of days after password expiration when an account becomes disabled
(root only)
-S, --status report password status on the named account (root only)
--stdin read new tokens from stdin (root only)

Directorul /usr/share/doc

Aproape fiecare program din Linux vine cu documentația sa proprie; aceasta se instalează, de regulă, în directorul /usr/share/doc.

Alte metode de a căuta ajutor

Comanda locate - cu ajutorul ei, putem afla nu numai unde se află un anumit program, ci și unde este documentația sa. Nu uitați că, dacă programul este proaspăt instalat, trebuie rulată comanmda de actualizare a bazei de date updatedb.

Comanda which - afișează calea absolută către executabilul unui anumit program.

Comanda whatis - afișează pe o singură linie descrierea paginii man:

$ whatis passwd
passwd (1) - update user's authentication tokens
openssl-passwd (1ssl) - compute password hashes
passwd (5) - password file

Comanda whereis - localizează pe disc binarul, sursa, dar și calea către pagina de manual a programului căutat

$ whereis passwd
passwd: /usr/bin/passwd /etc/passwd /usr/share/man/man1/passwd.1.gz /usr/share/man/man5/passwd.5.gz

Să presupunem că ne aflăm într-o distribuție rpm (Red Hat, Fedora, CentOS...). Cum majoritatea programelor au fost instalate din pachete rpm, putem folosi această comandă pentru a afla în câteva secunde calea către documentația aferentă unei comenzi (q - query, d - documentation):

$ rpm -qd nume_comandă

Exemplu:

$ rpm -qd passwd
/usr/share/doc/passwd/AUTHORS
/usr/share/doc/passwd/ChangeLog
/usr/share/doc/passwd/NEWS
/usr/share/man/ja/man1/passwd.1.gz
/usr/share/man/man1/passwd.1.gz

Să recapitulăm:

• Linux ține documentația în directoarele /usr/share/man, /usr/share/doc și /usr/share/info
• comenzile principale cu care putem obține ajutor sunt: man [...], info [...] sau cu parametrii [...] -h, [...] --help
• comenzi ajutătoare: apropos, which, whatis, whereis, rpm -qd

Cu atâtea informații la îndemână, cred că nimeni nu mai poate spune că se pierde într-un sistem Linux, nu-i așa? 🙂