Cosa fa#
Visualizza la documentazione di riferimento ufficiale per comandi, file di configurazione, chiamate di sistema e librerie C. Usa less come pager — tutti i comandi di navigazione di less funzionano dentro man. La documentazione e' locale, aggiornata alla versione installata sul sistema, disponibile anche senza internet.
Sintassi#
man [sezione] comando
Le 8 sezioni del manuale#
Ogni sezione copre un tipo diverso di documentazione. Lo stesso nome puo' esistere in piu' sezioni con significati diversi.
| Sezione | Contenuto | Esempio |
|---|---|---|
1 | Comandi utente — eseguibili normali | man 1 ls |
2 | System calls — chiamate dirette al kernel | man 2 fork |
3 | Funzioni di libreria C | man 3 printf |
4 | Device files — /dev/ | man 4 tty |
5 | Formati di file e configurazioni | man 5 passwd |
6 | Giochi e screensaver | — |
7 | Miscellanea — concetti, protocolli, standard | man 7 signal |
8 | Comandi di amministrazione sistema (root) | man 8 useradd |
Il motivo per cui esistono le sezioni: passwd e' sia un comando (sezione 1) che un file di configurazione (sezione 5). Senza specificare la sezione, man passwd apre la prima che trova — quasi sempre la sezione 1.
man passwd # apre sezione 1 (comando)
man 5 passwd # apre sezione 5 (struttura del file /etc/passwd)
man 5 crontab # struttura del file crontab
man 5 sshd_config # struttura del file di configurazione SSHComandi essenziali#
| Comando | Flag | Significato flag | Cosa fa |
|---|---|---|---|
man ls | — | — | Apre il manuale di ls (sezione 1 di default) |
man 5 passwd | — | — | Apre la sezione 5 di passwd (il file) |
man -k password | -k | keyword | Cerca "password" in tutte le descrizioni — identico ad apropos |
man -f ls | -f | full | Mostra tutte le sezioni disponibili per ls — identico a whatis |
man -a passwd | -a | all | Apre tutte le sezioni disponibili in sequenza |
man -P less man | -P | pager | Specifica il pager da usare |
Come leggere una pagina man#
LS(1) User Commands LS(1)
^ ^
nome(sezione) ripetuto a destra
NAME
ls - list directory contents ← descrizione in UNA riga
SYNOPSIS
ls [OPTION]... [FILE]... ← sintassi
^ ^ ^
│ [] = opzionale ... = ripetibile
└── nome comando
DESCRIPTION
List information about the FILEs ← spiegazione estesa
OPTIONS
-a, --all
do not ignore entries starting with . ← ogni flag spiegato
EXAMPLES ← non sempre presente ma cercalo!
SEE ALSO
dir(1), vdir(1), ls(1posix) ← comandi correlatiNavigazione interna — identica a less#
Dentro man usi gli stessi comandi di less:
| Tasto | Cosa fa |
|---|---|
/parola | Cerca "parola" verso il basso |
?parola | Cerca "parola" verso l'alto |
n | Prossima occorrenza della ricerca |
N | Occorrenza precedente |
g | Vai all'inizio |
G | Vai alla fine |
Space | Pagina successiva |
b | Pagina precedente |
q | Esci |
h | Help navigazione |
La strategia per non impazzire#
Le pagine man sono dense. Non leggerle dall'inizio — cerca quello che ti serve:
# Apri il manuale
man find
# Cerca subito il flag che vuoi
/-size
# n per scorrere le occorrenze
# q per uscire# Non ricordi il nome del comando? Usa -k (= apropos)
man -k "copy file"
man -k checksum
man -k "change permission"
# Vuoi vedere tutte le sezioni disponibili per un nome?
man -f passwd
# passwd (1) - change user password
# passwd (5) - the password fileman -k vs apropos#
Sono identici — man -k chiama apropos internamente:
man -k password # identico a:
apropos password # stesso risultatoUsa quello che preferisci. man -k e' utile quando sei gia' dentro il workflow di man.
L'alternativa moderna — cheat.sh#
Se il man e' troppo denso e non hai tldr installato, puoi usare cheat.sh via curl. Fornisce solo gli esempi pratici piu' comuni in modo leggibile.
# Sintassi base
curl cheat.sh/comando
# Esempi
curl cheat.sh/unzip # esempi per unzip
curl cheat.sh/tar # esempi per tar
curl cheat.sh/find # esempi per findFunziona senza installare nulla, basta avere curl e una connessione internet. E' l'ideale quando cerchi un esempio "al volo" invece della specifica tecnica completa.
Casi d'uso pratici#
# Su un server sconosciuto — mappa gli strumenti disponibili
man -k "packet capture"
man -k "network-defense monitor"
man -k forensic
# Struttura di file di configurazione che non ricordi
man 5 sshd_config # configurazione SSH server
man 5 crontab # formato file crontab
man 5 sudoers # formato file sudoers
man 5 fstab # formato file /etc/fstab
# Segnali Unix — tutti i SIGTERM, SIGKILL etc
man 7 signal
# Concetti di rete
man 7 tcp
man 7 ip
# Come funziona una chiamata di sistema
man 2 fork
man 2 execScenario Reale#
Sei su un server senza accesso a internet e devi configurare sshd_config per disabilitare il login con password. Non ricordi il nome esatto del parametro:
man 5 sshd_config
# poi dentro:
/PasswordAuth
# trovi: PasswordAuthentication yes|no
# con la spiegazione completa di cosa faQuesto e' piu' affidabile di Google perche' e' la documentazione esatta della versione installata su quel sistema.
Dove l'ho usato#
- bandit-05 — flag di
findper dimensione file
Note personali#
La combinazione piu' utile: apri man comando, poi usa /flag per cercare esattamente il flag che ti serve. Non leggere tutto dall'inizio — e' lento e inutile.
man -k e apropos sono identici. Se sei gia' nel flusso di man, usa -k. Se stai cercando da terminale, usa apropos — e' piu' immediato da ricordare.
