Nelle distribuzioni UNIX e Linux, i programmi a riga di comando vengono forniti con la propria documentazione chiamata pagine di manuale o pagine di manuale.
Le pagine man sono generalmente scritte dallo sviluppatore del programma corrispondente. Generalmente le pagine man sono suddivise in numero di sezioni.
Quello che segue è l'elenco di tutte le sezioni man disponibili. Ogni sezione ha un numero univoco e contiene solo un tipo specifico di pagine man. Ad esempio, la sezione man numero 3 contiene solo pagine man delle chiamate alla libreria.
- 1 – Programmi o comandi eseguibili
- 2 – Chiamate di sistema (funzioni fornite dal kernel)
- 3 – Chiamate in biblioteca (funzioni fornite dalla biblioteca)
- 4 – File speciali
- 5 – Formati e convenzioni dei file (file di configurazione)
- 6 – Giochi
- 7 – Varie
- 8 – Comandi di amministrazione del sistema
Sintassi:
man <TOPICNAME>
1. Visualizza la pagina man di un comando UNIX
Per leggere la pagina man di un comando UNIX, passare il nome del comando come argomento al man. Di seguito verrà visualizzata la pagina man per il comando passwd.
$ man passwd
PASSWD(1) User Commands PASSWD(1)
NAME
passwd - change user password
... Alcuni argomenti possono anche avere pagine man in più di una sezione. In tal caso, il comando man visualizzerà la pagina con il numero di sezione inferiore.
In questo esempio, il comando passwd ha pagine di manuale in più sezioni. Ma, per impostazione predefinita, mostra la pagina man dalla sezione 1.
Il "PASSWD(1)" mostrato nella prima riga dell'output del comando man indica che sta visualizzando la pagina man della sezione 1. L'output della pagina man mostra il nome del comando, la sintassi dei comandi, la descrizione di ciò che fa il comando, opzioni fornite dal comando, ecc...
2. Visualizza la pagina man da una sezione specifica
Per leggere la pagina man da una particolare sezione, fornire il numero della sezione come segue. Il comando passwd ha la pagina man sia nella sezione 1 che nella sezione 5. Per impostazione predefinita, se non specifichi il numero della sezione, verrà visualizzata la pagina man della sezione 1.
Per visualizzare la pagina man dalla sezione 5, specificare il numero della sezione come mostrato di seguito.
$ man 5 passwd
Ora visualizzerà la pagina di manuale per il file di configurazione /etc/passwd, poiché la sezione numero 5 è per i formati e le conversioni di file.
3. Elenca le sezioni uomo disponibili per un comando
Puoi anche elencare tutte le sezioni disponibili su un argomento particolare usando l'opzione -aw.
$ man -aw printf /usr/share/man/man1/printf.1.gz /usr/share/man/man3/printf.3.gz
Dall'output di cui sopra, possiamo sapere che ci sono 2 manuali printf, uno nella sezione "Comandi" e un altro in "Chiamate alla libreria". Quindi, puoi eseguire il seguente comando man per visualizzare entrambe le pagine man.
$ man printf $ man 3 printf
4. Visualizza tutte le pagine man per un comando – Visualizza tutte le sezioni
Per visualizzare tutte le pagine man per un particolare argomento, utilizzare l'opzione "-a". Vedrai prima la pagina man con il numero più basso. Quando esci da quella pagina e premi "Invio" apparirà la pagina man successiva.
$ man -a printf
Il comando precedente visualizzerà prima la pagina man del comando printf(1). Quando si preme "q" e si preme "Invio", verrà visualizzata la pagina man della funzione della libreria printf(3).
5. Visualizza la pagina man in formato HTML in un browser
Puoi anche visualizzare la pagina man in formato HTML usando qualsiasi browser che desideri utilizzando l'argomento "-H". Questo aprirà la pagina man per il comando printf in Firefox come pagina HTML.
$ export BROWSER=/usr/bin/firefox $ man -H printf
6. Modifica il cercapersone predefinito utilizzato da Man Command
Per impostazione predefinita, il comando man utilizzerà la variabile di ambiente $PAGER per identificare quale pager utilizzare per mostrare l'output. L'utente può cambiare il pager in cui preferisce vedere la pagina man usando l'opzione '-P'.
Il comando seguente visualizzerà la pagina man usando più pager di comandi.
$ man -P more printf
7. Cerca nella pagina man rispetto alla sezione NAME
Per cercare la pagina man rispetto alla sezione NAME, usa l'opzione "-f" come mostrato di seguito.
$ man -f printf printf (3) - formatted output conversion printf (1) - format and print data
Questo equivale a usare il comando della shell whatis.
Il comando precedente cerca i nomi delle pagine di manuale e visualizza la descrizione per l'argomento specificato se i nomi delle pagine di manuale corrispondono all'argomento specificato. Puoi anche passare più argomenti nella stessa riga di comando.
8. Cerca nella pagina man rispetto alla sezione NOME e DESCRIZIONE
Per cercare la pagina man rispetto alla sezione NOME &DESCRIZIONE, utilizzare l'opzione "-k". Equivale a usare il comando shell "apropos".
$ man -k printf asprintf (3) - print to allocated string dprintf (3) - print to a file descriptor fprintf (3) - formatted output conversion fwprintf (3) - formatted wide-character output conversion printf (1) - format and print data printf (3) - formatted output conversion snprintf (3) - formatted output conversion sprintf (3) - formatted output conversion ... ...
Il comando precedente cercherà la parola chiave "printf" come espressione regolare e visualizzerà tutte le pagine man che corrispondono alla parola chiave.