Comando man di Linux: come leggere e cercare le pagine del manuale

In Linux, usare il comando man permette di visualizzare le pagine del manuale dei comandi installati e delle funzioni di sistema. Ad esempio, eseguire man ls permette di leggere l'utilizzo e le opzioni di ls, e in generale è possibile premere q per uscire dallo schermo.

Apertura di una pagina del manuale

man indica il manuale e aiuta a trovare e visualizzare le pagine del manuale installate sul sistema. Oltre ai programmi, ci sono pagine relative ai formati dei file di configurazione, alle chiamate di sistema e alle funzioni di libreria. Ad esempio, il seguente comando apre il manuale per ls.

man ls

I manuali di solito includono il nome e una breve descrizione in NAME, il formato del comando in SYNOPSIS e le funzioni e opzioni in DESCRIPTION e OPTIONS. I contenuti e i titoli delle sezioni possono variare per ogni programma. La lettura del manuale non esegue i comandi descritti né modifica le impostazioni di sistema.

Navigazione dello Schermo e Ricerca

man utilizza un programma di paginazione per visualizzare contenuti lunghi una pagina alla volta. Le istruzioni seguenti si basano sul comunemente usato less. Se è impostato un programma diverso, i tasti potrebbero differire.

• Freccia Giù/Su: Si sposta di una riga alla volta.
• Spazio o Pagina Giù: Si sposta giù di uno schermo. b o Pagina Su si sposta su di uno schermo.
• / seguito da un termine di ricerca e Invio: Cerca in avanti dalla posizione corrente. n si sposta al risultato successivo nella stessa direzione, N si sposta al risultato nella direzione opposta.
• g e G: Si spostano rispettivamente all'inizio e alla fine del documento. Maiuscole/minuscole rilevanti.
• h e q: h apre la guida all'operazione, e q esce dalla schermata della guida o del manuale.

Ad esempio, se inserisci /sort nella schermata man ls e premi Invio, cerca in avanti quella espressione. Il termine di ricerca viene inserito all'interno della schermata del manuale, non come comando da shell. Per tasti dettagliati e regole di ricerca, fare riferimento al manuale less.

Selezione delle sezioni del manuale con lo stesso nome

I manuali sono divisi in sezioni numerate in base agli argomenti. Se un nome di pagina esiste in più sezioni, puoi specificare un numero per aprire la pagina desiderata. Ad esempio, passwd è utilizzato sia per comandi relativi alla password dell'utente sia per i nomi dei file di informazioni dell'account.

man 1 passwd
man 5 passwd

Il primo comando trova il manuale per il comando, e il secondo trova il manuale per il formato del file. La pagina corrispondente deve essere installata sul sistema per essere visualizzata. Se il numero è omesso, verrà aperta la prima pagina trovata secondo l'ordine di ricerca configurato.

• 1: Comandi generali e programmi eseguibili
• 2: Chiamate di sistema
• 3: Funzioni della libreria
• 5: Formati di file e regole
• 8: Comandi di gestione del sistema

La notazione passwd(5) indica il nome della pagina e il numero di sezione. Le sezioni complete e i metodi di ricerca possono essere trovati nel manuale man.

Trovare una pagina per nome o argomento

Se non conosci il nome esatto del comando, puoi cercare il nome del manuale e una breve descrizione usando man -k. L'esempio seguente trova elementi correlati a password.

man -k password

I risultati mostreranno il nome della pagina, il numero della sezione e una breve descrizione. I termini di ricerca possono essere interpretati come espressioni regolari, e questa ricerca non copre l'intero testo del manuale. Gli elementi trovati possono essere aperti come man 5 passwd usando il nome e il numero della sezione.

Se conosci già il nome e vuoi solo vedere la breve descrizione, eseguilo come segue.

man -f ls

man -k e man -f utilizzano l'indice del manuale, quindi i risultati possono variare a seconda dei documenti installati o dello stato dell'indice.

Quando il manuale non può essere trovato

• Pagina non trovata: Controlla l'ortografia del nome e verifica se il programma e il pacchetto di documenti associato sono installati. Il manuale potrebbe mancare in un ambiente di installazione minima.
• Comandi integrati: I comandi integrati nella shell, come cd, potrebbero non avere pagine separate. In Bash, puoi controllare help cd o man bash.
• Nessun risultato di ricerca: Assicurati che la documentazione sia installata e che l'indice del manuale sia preparato. Per rigenerare l'indice e gestire i permessi, segui la documentazione della distribuzione.
• Lingua diversa: A seconda della traduzione installata e delle impostazioni locali, potrebbe apparire in inglese. Verifica le opzioni e gli esempi basati sulla documentazione per la versione del software installata.

Se hai bisogno di un aiuto semplice fornito dallo stesso comando, puoi anche controllare l'opzione --help di quel programma. L'utilizzo dello stesso man può essere visto in man man.