man în Linux / Bash

man [secțiune] pagină
man -k cuvânt
whatis comandă
comandă --help

Ce face man

man afișează paginile de manual instalate pe sistem, cu descrierea completă a opțiunilor. Pagina se deschide în less: derulezi cu săgețile sau Spațiu, cauți cu /text (apoi n pentru următoarea potrivire) și ieși cu q.

Paginile sunt împărțite pe secțiuni: 1 comenzi pentru utilizatori, 5 formate de fișiere (de exemplu /etc/passwd), 8 comenzi de administrare și altele. Același nume poate exista în mai multe secțiuni, de aceea man 5 passwd diferă de man passwd.

Când nu știi numele comenzii, man -k (echivalent cu apropos) caută în descrierile scurte. whatis dă descrierea de o linie, iar majoritatea programelor GNU afișează un rezumat rapid cu --help.

Opțiuni și argumente

Opțiune / Parametru	Descriere
man SECȚIUNE pagină	Deschide pagina din secțiunea dată (de exemplu man 5 crontab).
man -k cuvânt	Caută cuvântul în numele și descrierile paginilor (la fel ca apropos).
man -f comandă	Descrierea de o linie (la fel ca whatis).
/text, n, q	În pagina deschisă: caută text, mergi la următoarea potrivire, ieși.
comandă --help	Rezumatul opțiunilor afișat de programul însuși.

Exemple

Exemplul 1: Descrierea scurtă și secțiunile unui nume

whatis arată că passwd există ca și comandă (secțiunea 1) și ca format de fișier (secțiunea 5).

whatis passwd

Ieșire în terminal

passwd (1)           - change user password
passwd (5)           - the password file

Exemplul 2: Căutarea unei comenzi după ce face

Nu știi cum se numește comanda care listează discurile? Cauți după cuvinte din descriere.

man -k "block devices"

Ieșire în terminal

lsblk (8)            - list block devices

Exemplul 3: Formatul unui fișier de configurare și rezumatul rapid

man 5 crontab descrie formatul liniilor din crontab, nu comanda. --help dă o listă scurtă de opțiuni; cu head păstrăm doar începutul.

man 5 crontab
ls --help | head -n 3

Ieșire în terminal

Usage: ls [OPTION]... [FILE]...
List information about the FILEs (the current directory by default).
Sort entries alphabetically if none of -cftuvSUX nor --sort is specified.

Greșeli frecvente

• Confuzia între secțiuni: man crontab deschide comanda (secțiunea 1), iar sintaxa liniilor este în man 5 crontab.
• Pe imaginile minimale (containere, unele servere cloud) paginile de manual lipsesc; pe Ubuntu se readuc cu unminimize sau prin instalarea pachetelor man-db și manpages.
• man -k nu găsește nimic după instalarea unui pachet nou: indexul se actualizează cu sudo mandb.

Comenzi înrudite

• which, whereis și type: Află ce program rulează de fapt când scrii o comandă: fișierul din PATH, o comandă internă, un alias sau o funcție.
• less: Vizualizează conținutul fișierelor pagină cu pagină, permițând navigarea înainte și înapoi.
• history: Afișează și refolosește comenzile scrise anterior în Bash: repetare cu !!, căutare cu Ctrl+R și setări cu HISTSIZE.
• locate: Găsește fișiere după nume aproape instantaneu, căutând într-o bază de date actualizată periodic cu updatedb.